Watch

iris 15890f9d5b docs: fix genuine Microsoft.Contractions/Negative errors

16 of the 23 error-level hits from a full-repo vale run were real:
'is/are/does/do NOT' and bold 'not' expanded per Microsoft.Contractions,
one hyphen-as-negative-number fixed to an en dash per Microsoft.Negative
(docs/web-ui/dashboard.md's -45 deg column-header tilt).

Where the caps/bold was there for emphasis (contrasting X does this,
Y does not), kept the emphasis by bolding the contraction rather than
dropping it silently -- 'is not' -> 'isn't', 'does NOT' -> '**doesn't**',
etc.

docs/tools/swarmctl-cli.md's one genuine hit is generated -- fixed the
source doc comment in swarmctl/src/main.rs and regenerated via
'cargo run --bin swarmctl -- markdown-docs', diffed against the old
copy first to confirm only the intended line changed.

Left 7 hits unfixed, false positives from the rule matching a
substring rather than the actual pattern it names:
- 4x 'that's instead of that is': every one is the explanatory 'that
  is' idiom (~= i.e.), not a contractible subject+verb -- 'that's'
  would misparse as a demonstrative-pronoun contraction and change the
  sentence's meaning. docs/integrations/forge.md:282,
  docs/tools/forge.md:260, docs/tools/hivectl.md:243,
  docs/web-ui/dashboard.md:457 (and the swarmctl-cli.md generated
  twin of the same category, source left alone for the same reason).
- docs/agent-lifecycle/persistence.md:482 -- 'is not' matched inside
  'is nothing' (the same has-not/has-nothing substring trap noted
  before in this doc's own git history).
- docs/swarm/ca.md:182 -- 'it is' matched inside the already-correct
  'it isn't'.

Per #4128. Remaining errors on main after this: Microsoft.Avoid's 26
hits, already tracked + awaiting a house-style ruling on #4041.

2026-09-09 01:48:46 +02:00

3.1 KiB

Raw Blame History

Lifecycle and approvals tools

Two tool groups govern agent lifecycle management and config changes. The server scopes both to direct children only (topology-enforced: it rejects any name that's not a direct child of the calling agent per topology.json). Privileged agents (for example ruth) may operate on any sub-agent — the topology scope applies to all others.

`lifecycle` tool group

No operator approval required. Direct children only.

`kill(name)`

Graceful stop. Container state is preserved; recreating the agent reuses prior config and credentials.

`start(name)`

Start a stopped sub-agent.

`restart(name)`

Stop + start in one call.

`update(name)`

Rebuild: re-applies the current hyperhive flake + agent.nix, then restarts. Idempotent — safe to call repeatedly. Used in response to needs_update system events.

`list_containers()`

List all descendant containers (children + their subtrees) with running status. Topology-scoped to descendants only.

`approvals` tool group

Config changes and new-agent spawns route through the operator approval queue. Direct children only (topology-enforced).

`request_init_config(name, description?)`

Step 1 of spawning a new direct child agent. Queues an InitConfig approval; on operator approve, hive-c0re seeds the proposed config repo at /agents/<name>/config/agent.nix with a default template and delivers a config_ready system event. Then edit agent.nix, commit, and the operator spawns the agent (the dashboard ◆ R3QU3ST SP4WN button / Spawn approval, routed via HostRequest::RequestSpawn), which creates the container from that config.

Subsequent config changes go through a forge PR on the agent's agent-configs/<name> repo (queues a MergeConfigPr approval on open/update — no MCP tool involved), not a tool call. See docs/agent-lifecycle/approvals.md.

Fails if a proposed config repo for name already exists. name is ≤ 9 characters.

`request_update_meta_inputs(inputs?, description?)`

Queue an approval to run nix flake update [inputs...] on the meta flake. Pass specific input names (for example ["bitburner-agent"]) or omit / pass [] for all inputs. Returns immediately; the lock update runs on operator approval.

Doesn't trigger container rebuilds — call update(name) on affected agents after the approval resolves.

Boundary summary

Operation	Requires approval?	Scope
`kill` / `start` / `restart` / `update`	No	Direct children
`list_containers`	No	All descendants
`request_init_config`	Yes (InitConfig)	New direct child only
`request_update_meta_inputs`	Yes (MetaUpdate)	Meta flake (global)

3.1 KiB Raw Blame History

Lifecycle and approvals tools

lifecycle tool group

kill(name)

start(name)

restart(name)

update(name)

list_containers()

approvals tool group

request_init_config(name, description?)

request_update_meta_inputs(inputs?, description?)