hyperhive/docs
Repository files (latest commit first)
Filename Latest commit message Latest commit date
atlas ed3b9d853e nix/hive-network: bridge + dnsmasq resolver, opt-in (#805 v1)
Stand up the host-side bridge interface + per-agent DNS resolver
ahead of #14 (netns isolation). Mara on #805#11541: "we need it
before #14 so nothing breaks when we switch over". v1 ships the
endpoint live but containers stay on shared host netns — when #14
flips them to private netns the DNS contract is already there.

Shape:

- new `nix/modules/hive-network.nix` with `services.hyperhive.network.*`
  options (enable + bridgeName + bridgeIp + bridgePrefixLength +
  upstreamDns). Default off. Imported from `hive-c0re.nix`.
- bridge interface via `networking.bridges` (no slave NICs at v1;
  per-agent veth pairs attach once #14 lands).
- bridge IP assigned via `networking.interfaces`.
- `networking.firewall.interfaces.<bridge>.allowed{UDP,TCP}Ports =
  [ 53 ]` opens the resolver on the bridge interface only —
  other interfaces stay closed.
- dnsmasq config added to the existing `hive-gateway` container
  (mara on #805:10957: "put the resolver into the gateway container").
  Listens only on `bridgeName` + `lo`; authoritative for
  `<hive-domain>`, `forge.<hive>`, `matrix.<hive>` answering with
  the bridge IP; forwards everything else to upstream.
  `resolveLocalQueries = false` keeps the gateway container's own
  resolver untouched.

Asserts `services.hyperhive.domain != null` + `gateway.enable =
true` — both required for the resolver to be meaningful.

Docs: new `docs/network.md` covering v1 vs v2 split, container shape
rationale, default addressing, resolver behaviour, firewall posture.

`nix flake check` clean.
2026-05-31 16:56:59 +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 docs/approvals.md: split sha vs tag scoping per argus on #833 2026-05-31 16:25:03 +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
gateway.md docs/gateway.md: drop duplicate 'Per-agent UDS upstream' section 2026-05-31 16:35:26 +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 prompt-rendering prose (#716 batch 3) 2026-05-31 16:46:00 +02:00
web-ui.md docs/web-ui.md: scrub self-ref cookies (#719 batch 1) 2026-05-31 15:38:28 +02:00