rename(162): drop HIVE_PORT fallback; sweep remaining hm1nd in docs

This commit is contained in:
damocles 2026-06-01 17:35:19 +02:00 committed by mara
commit 008609d0e7
7 changed files with 26 additions and 31 deletions

View file

@ -2,7 +2,7 @@
The approval queue is hyperhive's pivot: nothing that changes the
shape of an agent (its config, whether it exists) happens without an
operator click. The manager (`hm1nd`) is the policy gate in front of
operator click. The manager (`root`) is the policy gate in front of
that queue; helper events are how it stays informed about what
happens after a decision lands.
@ -114,7 +114,7 @@ kind-specific payload carrier.
operator approval. Step 1 of the two-step spawn flow above.
- `UpdateMetaInputs``commit_ref` stores the JSON-encoded inputs
array (`"[]"` = all inputs, `"[\"nixpkgs\"]"` = just nixpkgs,
etc.). `agent` field is set to `hm1nd` (the requesting manager).
etc.). `agent` field is set to `root` (the requesting manager).
On approve hive-c0re runs `nix flake update [inputs...]` on the
meta flake and commits the resulting lock changes.
- `SchedulePrompt``commit_ref` stores the JSON-encoded
@ -438,23 +438,23 @@ notes, the events DB, proposed history, and applied history
all survive. The manager keeps its session; sub-agents stay
logged in.
## Manager (`hm1nd`) is hive-c0re-managed
## Manager (`root`) is hive-c0re-managed
The manager container runs through the **same lifecycle as
sub-agents**. On `hive-c0re serve` startup, if `hm1nd` is missing,
sub-agents**. On `hive-c0re serve` startup, if `root` is missing,
hive-c0re creates it. The manager's flake lives at
`/var/lib/hyperhive/applied/hm1nd/`; its proposed config at
`/var/lib/hyperhive/agents/hm1nd/config/`. Manager can edit its own
`agent.nix` (visible inside the container at `/agents/hm1nd/config/`)
and submit `request_apply_commit("hm1nd", <sha>)` for operator
`/var/lib/hyperhive/applied/root/`; its proposed config at
`/var/lib/hyperhive/agents/root/config/`. Manager can edit its own
`agent.nix` (visible inside the container at `/agents/root/config/`)
and submit `request_apply_commit("root", <sha>)` for operator
approval.
Differences from sub-agents:
- `flake.nix` extends `hyperhive.nixosConfigurations.manager`
(vs `agent-base`).
- Container name is `hm1nd` (no `h-` prefix).
- Web UI port via `lifecycle::agent_web_port("hm1nd")` — same
- Container name is `root` (no `h-` prefix).
- Web UI port via `lifecycle::agent_web_port("root")` — same
FNV-1a hash as every other agent (8100..8999 range).
- `set_nspawn_flags` adds two extra binds: `/var/lib/hyperhive/agents`
`/agents` (RW) so the manager can edit per-agent proposed repos,
@ -466,7 +466,7 @@ Differences from sub-agents:
- Per-agent socket lives at `/run/hyperhive/manager/`, owned by
`manager_server::start`.
**Migration note** (for older hosts): drop any `containers.hm1nd =
**Migration note** (for older hosts): drop any `containers.root =
{ ... }` block from your host NixOS config. hyperhive creates and
updates the manager itself.