hyperhive/docs
Repository files (latest commit first)
Filename Latest commit message Latest commit date
iris 76d3267b55 hive-ag3nt + docs: extract forge_notify prose (#716 batch 4)
forge_notify.rs is the biggest remaining #716 hotspot: ~22 attribution
cookies (#110 #230 #231 #253 #256 #455 #518 #539 #544) plus a thick
module-level docstring + per-function rationale blocks for the
notification pipeline. The substantive prose lives in a new
`docs/forge.md` covering the wider forge integration story:

- Per-agent forge accounts + agent-configs mirror (was implicit
  across `hive-c0re/src/forge.rs` rustdocs).
- Notification poller: activation gates, self-notification filtering,
  body excerpt + truncation + ATX heading escape pipeline, wrapper
  formats (comment / review / new-item / state-change) with shape
  table, meta suffix shape, review-request override, reason
  drop-list rationale (drop vs allow), auto-unsubscribe on broad
  watches.

In-code rustdocs reduced to 1-line semantic summaries + doc
pointers; inline cookie comments scrubbed. Net diff is ~150 lines
removed from the .rs file. All 16 forge_notify unit tests pass.

CLAUDE.md gets a new `docs/forge.md` file-map entry + reading-path
question entry. The existing `src/forge_notify.rs` file-map blurb
keeps its `(#539 / #544)` cookie — consistent with the rest of
CLAUDE.md's lineage attributions.
2026-05-31 17:17:24 +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
forge.md hive-ag3nt + docs: extract forge_notify prose (#716 batch 4) 2026-05-31 17:17:24 +02:00
gateway.md dashboard: build same-origin /agent/<name>/ links when gateway is up (closes #842) 2026-05-31 17:16:53 +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 dashboard: build same-origin /agent/<name>/ links when gateway is up (closes #842) 2026-05-31 17:16:53 +02:00