iris
94c110fd5f
hive-ag3nt + docs: extract harness binary shape prose (#716 batch 5)
`bin/hive.rs` carries ~15 attribution cookies (#598, #676, #692,
#693, #778, #788, #682, #688) plus structural prose about the
single-binary architecture (role-from-env), the `Surface` trait
pattern (zero-sized type tags + generic dispatch), boot wiring
(label fallback, plugin install → send_to_parent failure routing),
and turn-outcome branching (ack / requeue / wait_for_login / parent
notify).
Migrated to a new `docs/turn-loop.md::Harness binary shape`
subsection covering:
- Single-binary rationale (server-side privilege boundary on the
broker socket means no escalation risk in shipping both wire
surfaces in the same process).
- Three subcommands (`serve` / `mcp` / `wake`).
- Surface trait + zero-sized type tags (AgentSurface,
ManagerSurface) — picks per-role FLAVOR / FORGE_IS_MANAGER and
exposes the broker wire ops behind trait methods so the turn
loop is written once.
- Boot wiring (HIVE_PORT, HIVE_LABEL fallback, plugin failures
routed via send_to_parent, web_ui + forge_notify spawn).
- Turn outcomes table (Ok/Compacted/RateLimited/AuthFailed/Failed)
+ continue-sentinel pickup.
In-code rustdocs reduced to 1-line summaries + doc pointers;
inline cookies stripped from boot wiring + plugin install +
sentinel cleanup paths.
15 → 0 cookies in bin/hive.rs; cargo check -p hive-ag3nt passes.
|
2026-05-31 17:18:22 +02:00 |