docs: scrub #NNN self-references (closes #719)
Last pass of the docs-from-code → docs/ epic (#708). Drops every attribution cookie from docs/ + README.md + CLAUDE.md so the source-tree files no longer reference the issue tracker. Issue threads + commit history retain the references — those are the canonical record. - README.md: drop #701 / #660×2 / #551 from matrix + display-name sections, rephrase to convey the semantics directly - CLAUDE.md: scrub 18 cookies from the file map (#655, #15, #784, #832, #444, #425, #361, #548, #598, #539, #544, #589, #701, #658, #280, #660, #551, #764, #772, #793, #14, #805) - docs/agent-hierarchy.md: drop #658 ×3 (per-agent user is the current shape, not a transition) - docs/conventions.md: drop #571 (replaced with a docs xref to persistence.md::matrix-avatar-sync) - docs/gateway.md: scrub vhost-map table cookies + Sub-domain rationale + Per-agent unix-socket upstream + Self-signed TLS + Firewall posture + HIVE_FORGE_URL + Per-agent error pages sections; drop the trailing 'Sequencing history' issue list + the 'Next-up' issue-link footnote - docs/matrix.md: scrub serverName/gatewayHost + Default-closed firewall + Provisioning flow + Initial rollout + Assertion rationale + fluffychat-web build fixes; drop the trailing 'Sequencing history' issue list - docs/network.md: drop 'Why ship before #14' #805 quote + Container shape #805 attribution + trailing 'Sequencing history' + Cross-references issue links; rename v2 column to 'after netns isolation' - docs/web-ui.md: drop #784 from Container row, replace with a docs xref to docs/gateway.md::Per-agent unix-socket upstream Only remaining #NNN in docs/ is the literal markdown-heading example in docs/forge.md (`#tag`, `#123`, `#!/bin/bash`) which demonstrates the renderer's behaviour — not an attribution cookie.
This commit is contained in:
iris
parent
2a2d76d733
commit
6bdfe52386
8 changed files with 142 additions and 187 deletions
52
CLAUDE.md
52
CLAUDE.md
|
|
@ -25,9 +25,9 @@ hive-c0re/ host daemon + sibling operator CLI (lib + 2 bins)
|
|||
deny / destroy [--purge] / request-spawn /
|
||||
set-parent (--parent / --root); periodic
|
||||
vacuum tasks.
|
||||
src/bin/hivectl.rs `hivectl` binary (#655): operator-facing host
|
||||
CLI for ad-hoc administration that doesn't
|
||||
go through the broker. v0 verbs: `forge
|
||||
src/bin/hivectl.rs `hivectl` binary: operator-facing host CLI
|
||||
for ad-hoc administration that doesn't go
|
||||
through the broker. v0 verbs: `forge
|
||||
create-user <name>`, `matrix create-user
|
||||
<name>` — wrap the same idempotent
|
||||
`forge::ensure_user_for` /
|
||||
|
|
@ -39,15 +39,15 @@ hive-c0re/ host daemon + sibling operator CLI (lib + 2 bins)
|
|||
src/manager_server.rs manager-privileged socket (ManagerRequest)
|
||||
src/agent_ports.rs writes `/var/lib/hyperhive/agent-ports.json` on
|
||||
meta sync; gateway reads name→port map for
|
||||
per-agent `/agent/<name>/` routing (#15).
|
||||
per-agent `/agent/<name>/` routing.
|
||||
src/agent_sockets.rs writes `/var/lib/hyperhive/agent-sockets.json` on
|
||||
meta sync; gateway reads name→socket-path
|
||||
map for unix-domain per-agent UI binding (#784).
|
||||
map for unix-domain per-agent UI binding.
|
||||
Entries are filtered by a `.bound` marker file
|
||||
the harness drops next to its socket after a
|
||||
successful `bind()` (#832) — pre-bind agents
|
||||
stay out of the map so the gateway never races
|
||||
a missing-socket upstream. A 10s poll loop
|
||||
successful `bind()` — pre-bind agents stay out
|
||||
of the map so the gateway never races a
|
||||
missing-socket upstream. A 10s poll loop
|
||||
(`spawn_poll`) re-fires the writer so the map
|
||||
reconverges if a marker appears between
|
||||
meta-sync ticks.
|
||||
|
|
@ -76,7 +76,7 @@ hive-c0re/ host daemon + sibling operator CLI (lib + 2 bins)
|
|||
src/scheduled_prompts.rs sqlite layer for scheduled prompts —
|
||||
schema, CRUD helpers (`cancel_all`,
|
||||
`cancel_targets`, `reap_cancelled`), catch-up
|
||||
clamp on resume (#444)
|
||||
clamp on resume
|
||||
src/scheduled_prompts_worker.rs 5s poll loop: fires due rows,
|
||||
fans out one Message per active target,
|
||||
re-arms recurring rows, deletes fired one-shots
|
||||
|
|
@ -86,7 +86,7 @@ hive-c0re/ host daemon + sibling operator CLI (lib + 2 bins)
|
|||
when a previously-running container disappears
|
||||
without an operator-initiated transient (or a
|
||||
RECENT_TRANSIENT_GRACE tombstone within the
|
||||
last 30s, closes #425)
|
||||
last 30s)
|
||||
src/container_view.rs ContainerView struct + build_all helper;
|
||||
shared between dashboard.rs (cold-load via
|
||||
/api/state) and coordinator.rs's
|
||||
|
|
@ -128,7 +128,7 @@ hive-c0re/ host daemon + sibling operator CLI (lib + 2 bins)
|
|||
and the eventual cap-enforcement plumbing all
|
||||
read). Reconciled by `meta::sync_agents`;
|
||||
operator/manager edits land via the
|
||||
eventual write API (#361 follow-ups).
|
||||
eventual write API.
|
||||
src/forge.rs optional Forgejo wiring: per-agent users +
|
||||
tokens, the `agent-configs` org (`push_config`),
|
||||
and meta read access; mirrors each applied repo
|
||||
|
|
@ -142,7 +142,7 @@ hive-c0re/ host daemon + sibling operator CLI (lib + 2 bins)
|
|||
persists each agent's access_token to
|
||||
`<state>/matrix-token`. Idempotent — skips
|
||||
registration when token file already exists.
|
||||
No-op when `hive-matrix` container absent (#548).
|
||||
No-op when `hive-matrix` container absent.
|
||||
src/dashboard.rs axum HTTP: /api/state JSON + actions
|
||||
+ journald viewer + bind-with-retry (SO_REUSEADDR)
|
||||
+ deployed_sha chip per container +
|
||||
|
|
@ -169,7 +169,7 @@ frontend/ npm workspaces (esbuild → static dist). Built
|
|||
+ agent.css → dist/{*.html, static/*}.
|
||||
|
||||
hive-ag3nt/ in-container harness crate; produces ONE `hive`
|
||||
binary (post-#598) picking role from `HIVE_ROLE` env
|
||||
binary picking role from `HIVE_ROLE` env
|
||||
src/lib.rs re-exports + DEFAULT_SOCKET, DEFAULT_WEB_PORT
|
||||
src/client.rs generic JSON-line request/response over unix socket
|
||||
src/web_ui.rs per-container axum HTTP page (incl /api/cancel,
|
||||
|
|
@ -194,15 +194,15 @@ hive-ag3nt/ in-container harness crate; produces ONE `hive`
|
|||
escaped) and surfaces any @mention lines that
|
||||
fell outside the truncation window in a
|
||||
trailing `mentions (truncated from body):`
|
||||
block (#539 / #544).
|
||||
src/identity.rs hive-qualified agent label (#589 phase A):
|
||||
`label()` / `qualified_label()` / `qualify(label)`.
|
||||
Reads `HYPERHIVE_HIVE_DOMAIN`; falls back to short
|
||||
name when unset. Display-name accessors (#701):
|
||||
block.
|
||||
src/identity.rs hive-qualified agent label: `label()` /
|
||||
`qualified_label()` / `qualify(label)`. Reads
|
||||
`HYPERHIVE_HIVE_DOMAIN`; falls back to short
|
||||
name when unset. Display-name accessors:
|
||||
`hive_name()` / `swarm_name()` read
|
||||
`HYPERHIVE_HIVE_NAME` / `HYPERHIVE_SWARM_NAME`,
|
||||
both `Option<String>`.
|
||||
src/login.rs probe $HOME/.claude/ (post-#658 `/home/<agent>/.claude`)
|
||||
src/login.rs probe $HOME/.claude/ (= `/home/<agent>/.claude`)
|
||||
for a valid session
|
||||
src/login_session.rs drives `claude auth login` over stdio pipes
|
||||
src/prompt.rs system prompt renderer: filters the unified
|
||||
|
|
@ -234,9 +234,9 @@ hive-forge/ Forgejo CLI wrapper (`hive-forge` binary)
|
|||
close, labels, list, milestone, branches,
|
||||
tree-sha, diff, subscription, attach-issue,
|
||||
attach-comment, lint). Replaces the 600-line
|
||||
hive-forge-tools.nix bash script (closes #280).
|
||||
hive-forge-tools.nix bash script.
|
||||
|
||||
hive-matrix-mcp/ per-agent matrix-sdk integration (#548 phase 3).
|
||||
hive-matrix-mcp/ per-agent matrix-sdk integration.
|
||||
src/main.rs `hive-matrix-daemon` binary entry — long-running
|
||||
matrix-sdk Client + sync per agent; serves the
|
||||
MCP bridge over /run/hive-matrix/socket; emits
|
||||
|
|
@ -277,9 +277,9 @@ nix/
|
|||
modules/hive-matrix.nix optional in-container matrix-tuwunel
|
||||
homeserver (`services.hyperhive.matrix.enable`,
|
||||
default off); server_name defaults to bare
|
||||
`services.hyperhive.domain` (#660); gateway serves
|
||||
`services.hyperhive.domain`; gateway serves
|
||||
`.well-known/matrix/{client,server}` for
|
||||
auto-discovery; federation on, e2ee deferred (#551)
|
||||
auto-discovery; federation on, e2ee deferred
|
||||
templates/harness-base.nix shared harness for all containers; `hyperhive.role`
|
||||
(`"agent"` | `"manager"`) drives service unit + forge
|
||||
defaults; `hyperhive.model` option (HIVE_DEFAULT_MODEL)
|
||||
|
|
@ -304,10 +304,10 @@ docs/
|
|||
persistence.md sqlite dbs, retention, state dir layout
|
||||
terminal-rendering.md per-agent terminal row taxonomy (as built)
|
||||
boundary.md operator/agent trust model rationale
|
||||
agent-hierarchy.md tree-shape topology design + manager-privilege audit (#361)
|
||||
agent-hierarchy.md tree-shape topology design + manager-privilege audit
|
||||
damocles-migration.md future migration plan for damocles → hyperhive
|
||||
gateway.md nginx vhost map, matrix discovery flow, firewall posture,
|
||||
HIVE_FORGE_URL loopback rationale (#764, #772, #793)
|
||||
HIVE_FORGE_URL loopback rationale
|
||||
forge.md per-agent forge accounts + agent-configs mirror;
|
||||
forge_notify poller (gates, self-filter, body excerpt
|
||||
pipeline, wrapper formats, reason drop-list,
|
||||
|
|
@ -315,7 +315,7 @@ docs/
|
|||
matrix.md matrix container shape, serverName/gatewayHost split,
|
||||
firewall + federation, provisioning flow, fluffychat-web build
|
||||
network.md host-side bridge + dnsmasq resolver, v1/v2 roadmap,
|
||||
foundation for #14 netns isolation (#805)
|
||||
foundation for netns isolation
|
||||
```
|
||||
|
||||
## Reading paths
|
||||
|
|
|
|||
Loading…
Reference in a new issue