vinzenz/hyperhive
vinzenz/hyperhive
Watch
0
0
Fork
You've already forked hyperhive
 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions

docs(approvals): drop tracker-tag refs; add topology.rs pointer for role

Browse source 
Remove three bare #NNN tracker-tag references in docs/approvals.md
(hive-rules: no #NNN in code/comments/docs):

- Step 6 of end-to-end flow: "tracked in #1953" → "a known limitation
  under active development"
- InitConfig paragraph: same rewrite
- Helper events section: same rewrite

Also add a code pointer for `can_manage_top_level_agents`: the role is
defined as ROLE_CAN_MANAGE_TOP_LEVEL_AGENTS in hive-c0re/src/topology.rs,
now noted inline so reviewers can verify the name is real.
This commit is contained in:
iris 2026-06-23 22:10:08 +02:00 • committed by mara
commit 60403fd27c
1 changed files with 8 additions and 6 deletions
Download patch file Download diff file Expand all files Collapse all files

14
docs/approvals.md
View file

@ -69,8 +69,8 @@ informed about what happens after a decision lands.
ApplyCommit kind) land in the root agent's inbox, carrying both ApplyCommit kind) land in the root agent's inbox, carrying both
the canonical sha and the terminal tag. (Helper events currently route the canonical sha and the terminal tag. (Helper events currently route
to the root agent via `notify_manager` regardless of which agent to the root agent via `notify_manager` regardless of which agent
submitted the approval; routing them to the submitting agent is tracked submitted the approval; routing them to the submitting agent is a
in #1953.) known limitation under active development.)
### Withdrawing a pending approval ### Withdrawing a pending approval
@ -93,7 +93,8 @@ flow. On approve, hive-c0re seeds the proposed config repo with
a default `agent.nix` template and sends `HelperEvent::ConfigReady { agent }` a default `agent.nix` template and sends `HelperEvent::ConfigReady { agent }`
to the root agent's inbox (current limitation — all helper events route to the root agent's inbox (current limitation — all helper events route
to the root agent via `notify_manager` regardless of which agent to the root agent via `notify_manager` regardless of which agent
submitted; tracked in #1953). The submitting agent then reviews, submitted; routing to the submitting agent is under active development).
The submitting agent then reviews,
edits, and commits the template before calling `request_apply_commit` edits, and commits the template before calling `request_apply_commit`
to proceed to an `ApplyCommit` approval. The first `ApplyCommit` to proceed to an `ApplyCommit` approval. The first `ApplyCommit`
creates the container; subsequent ones rebuild it with new config. creates the container; subsequent ones rebuild it with new config.
@ -414,8 +415,9 @@ calls `bind_child_agent_dirs` for each entry in
tool group can therefore edit, commit, and submit changes for any of tool group can therefore edit, commit, and submit changes for any of
its direct children directly inside its container at `/agents/<child>/config/`. its direct children directly inside its container at `/agents/<child>/config/`.
Agents holding the `can_manage_top_level_agents` topology role get Agents holding the `can_manage_top_level_agents` topology role
additional host-side bind mounts via `set_nspawn_flags`: (defined as `ROLE_CAN_MANAGE_TOP_LEVEL_AGENTS` in `hive-c0re/src/topology.rs`)
get additional host-side bind mounts via `set_nspawn_flags`:
- `/var/lib/hyperhive/agents/` → `/agents/` (RW) — all top-level - `/var/lib/hyperhive/agents/` → `/agents/` (RW) — all top-level
agents' proposed repos (not just direct children). agents' proposed repos (not just direct children).
@ -550,7 +552,7 @@ message from sender `system` with the event JSON in the body. The
root agent's harness no longer short-circuits these — they drive a root agent's harness no longer short-circuits these — they drive a
regular claude turn so the root agent can react. (Today these go to the regular claude turn so the root agent can react. (Today these go to the
root agent regardless of which agent submitted the approval — routing to root agent regardless of which agent submitted the approval — routing to
the submitting agent is tracked in #1953.) Variants the submitting agent is a known limitation under active development.) Variants
(`hive_sh4re::HelperEvent`): (`hive_sh4re::HelperEvent`):
- `ApprovalResolved { id, agent, commit_ref, status, note }` — - `ApprovalResolved { id, agent, commit_ref, status, note }` —