hyperhive/docs
Repository files (latest commit first)
Filename Latest commit message Latest commit date
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
..
agent-hierarchy.md docs/agent-hierarchy.md: scrub self-ref cookies (#719 batch 5) 2026-05-31 15:49:37 +02:00
approvals.md scheduled_prompts: address argus 🟡 on #849 — submit paths section + persistence.md anchor fix 2026-05-31 17:18:15 +02:00
boundary.md docs: move backlog to forge issue tracker, extract boundary doc 2026-05-20 12:19:16 +02:00
conventions.md hive-ag3nt + docs: extract identity prose (#716 batch 1) 2026-05-31 16:41:24 +02:00
damocles-migration.md Phase 7e: damocles migration plan; CLAUDE.md phase status 2026-05-15 00:32:26 +02:00
forge.md hive-ag3nt + docs: extract forge_notify prose (#716 batch 4) 2026-05-31 17:17:24 +02:00
gateway.md hive-gateway: self-signed TLS for matrix-client well-known fetch (closes #837) 2026-05-31 17:17:58 +02:00
gotchas.md docs/gotchas.md: scrub self-ref cookies (#719 batch 3) 2026-05-31 15:46:02 +02:00
matrix.md docs/matrix.md: extract hive-matrix prose (#718 batch 5) 2026-05-31 15:38:43 +02:00
network.md nix/hive-network: bridge + dnsmasq resolver, opt-in (#805 v1) 2026-05-31 16:56:59 +02:00
persistence.md docs: extract best-effort oneshot service contract + matrix-avatar (#718 batch 6) 2026-05-31 16:14:38 +02:00
security.md docs: scrub self-ref cookies across 5 files (#719 batch 2) 2026-05-31 15:39:09 +02:00
terminal-rendering.md docs: scrub self-ref cookies across 5 files (#719 batch 2) 2026-05-31 15:39:09 +02:00
turn-loop.md hive-ag3nt + docs: extract harness binary shape prose (#716 batch 5) 2026-05-31 17:18:22 +02:00
web-ui.md dashboard: build same-origin /agent/<name>/ links when gateway is up (closes #842) 2026-05-31 17:16:53 +02:00