hyperhive/docs
Repository files (latest commit first)
Filename Latest commit message Latest commit date
atlas ea90814809 docs/gateway.md: extract hive-c0re + hive-forge prose blocks (#718 batch 2)
Continues #718 docs-extraction. Three more blocks moved to
`docs/gateway.md` (which already houses the gateway architecture
story from #775):

1. **Firewall posture (gateway on vs off)** — was a 22-line block
   above `networking.firewall = lib.mkIf ...` in hive-c0re.nix.
   Trimmed to 3-line ref. New `docs/gateway.md::Firewall posture
   (host-level)` section covers the gateway-on / gateway-off
   trade-off + why dashboard port stays loopback-only.

2. **`HIVE_FORGE_URL` loopback rationale** — was a 14-line block
   above the env-var assignment. Trimmed to 5-line ref. New
   `docs/gateway.md::HIVE_FORGE_URL: loopback for in-cluster,
   sub-domain for the operator` section covers the in-cluster vs
   external split + why agent containers can't use the sub-domain.

3. **hive-forge container shape** — was a 15-line top-of-`config`
   block in hive-forge.nix explaining the nixos-container + host
   netns choices. Trimmed to 4-line ref. New
   `docs/gateway.md::hive-forge container shape` section captures
   the same content with state-dir + wipe-via-destroy notes.

Net: hive-c0re.nix -29 lines, hive-forge.nix -11 lines, gateway.md
+44 lines. Same pattern as #782 (first pass) per iris's #10114
guidance — substantive WHY moves to docs as named sub-paragraphs,
in-code shrinks to `// see docs/<file>::<section>` refs.

Verified: `nix eval` on agent-base toplevel still resolves
cleanly; firewall posture unchanged (still 0 ports opened in the
gateway-on case + the same 8100..8999 range in the gateway-off
case).

Continues #718. Follow-up batches: remaining harness-base.nix
blocks, nix/docs/default.nix, nix/assets.nix, nix/templates/weston-vnc.nix.
2026-05-31 14:57:50 +02:00
..
agent-hierarchy.md docs(agent-hierarchy): drop missed manager-root mention from apply_set_parent refuses list (argus on #758) 2026-05-31 13:27:30 +02:00
approvals.md lifecycle: drop manager port special case (#753) — manager hashes into 8100..8999 like every other agent 2026-05-31 13:25:13 +02:00
boundary.md docs: move backlog to forge issue tracker, extract boundary doc 2026-05-20 12:19:16 +02:00
conventions.md lifecycle: drop manager port special case (#753) — manager hashes into 8100..8999 like every other agent 2026-05-31 13:25:13 +02:00
damocles-migration.md Phase 7e: damocles migration plan; CLAUDE.md phase status 2026-05-15 00:32:26 +02:00
gateway.md docs/gateway.md: extract hive-c0re + hive-forge prose blocks (#718 batch 2) 2026-05-31 14:57:50 +02:00
gotchas.md docs: extract 3 substantive harness-base.nix prose blocks (#718, first pass) 2026-05-31 14:44:12 +02:00
persistence.md docs: extract 3 substantive harness-base.nix prose blocks (#718, first pass) 2026-05-31 14:44:12 +02:00
security.md docs: catch up post-#658/#604/#660 + add operator hivectl section (#124) 2026-05-31 10:13:33 +02:00
terminal-rendering.md agent/terminal: neutral [resolved] label for closed asks (argus #668) 2026-05-30 21:45:33 +02:00
turn-loop.md docs: get_agent_meta response gains hive_name + swarm_name (follow-up to #741) 2026-05-31 13:03:12 +02:00
web-ui.md dashboard.css + docs: migrate topology indent + icon/pending prose (#712 batch 12) 2026-05-31 14:48:46 +02:00