📖 docs: sync Hive documentation map

docs/content/hive/adr/readme.md

@@ -55,3 +55,4 @@ What becomes easier, harder, safer, or riskier because of this decision?
 - [ADR-0015: Scope `style-src` as two directives and accept inline style attributes](/docs/hive/adr/0015-csp-style-src-scope)
 - [ADR-0016: Scope `script-src` as two directives, close the element half with hashes](/docs/hive/adr/0016-csp-script-src-scope)
 - [ADR-0017: Quadlet `.container`/`.pod` units as the Podman persistent lifecycle](/docs/hive/adr/0017-podman-quadlet-lifecycle)
+- [ADR-0018: Shared dashboard design tokens and component layer](https://github.com/hivecommons/hive/blob/v5/src/docs/adr/0018-dashboard-design-tokens.md)

docs/content/hive/agent-configuration.md

@@ -830,7 +830,7 @@ A stage receipt includes the normal report envelope (`lane`, `kind`, `findings`,
 ## What to read next
 
 - **[Supervisor agent](https://github.com/hivecommons/hive/blob/v5/src/docs/supervisor.md)** — what the supervisor does, how it differs from the governor, when to enable it, `bead_role` semantics, and policy modes.
-- **[Documentation index](/docs/hive/readme)** — what hive is, setup, and the full topic-guide surface.
+- **[Documentation map](/docs/hive/documentation-map)** — setup and the full topic-guide surface.
 - **[Architecture](/docs/hive/architecture)** — process model, deterministic pipeline, governor loop, guardrails, and hub/spoke design.
 - **[Portable AgentDefinition format](https://github.com/hivecommons/hive/blob/v5/src/AGENT-DEFINITION.md)** — standalone YAML schema for agent imports, exports, and overlays.
 - **[AGENTS.md repo instructions](https://github.com/hivecommons/hive/blob/v5/src/docs/agents-md.md)** — the per-repo instruction file format Hive's parser understands. Injected into kicks once `project.checkouts_dir` gives Hive a checkout to read it from — see the page.

docs/content/hive/architecture.md

@@ -186,10 +186,11 @@ flowchart LR
 
 ## Archetypes for long-running work
 
-Long-running runs use a provisional vocabulary while the stage handoff receipt
-schema and proof contract settle ([#8295](https://github.com/hivecommons/hive/issues/8295)).
-The names describe roles in the existing architecture, not new machinery, and
-remain provisional until the adapter, effect, and proof contract lands.
+Long-running runs use the settled archetype vocabulary recorded in
+[#7620](https://github.com/hivecommons/hive/issues/7620) and implemented through
+the #8290 runs work. The names describe roles in the existing architecture, not
+new machinery: the receipt schema, adapter, effect, and proof contract have
+landed, so these terms are now the design record rather than provisional labels.
 
 **Oracle** is the source-of-truth observer for actionable work. In Hive that is
 the `pkg/worksource` seam: it normalizes GitHub issues, Linear/Jira items, and

docs/content/hive/hivectl.md

@@ -174,6 +174,29 @@ hivectl governor agent-add ux-discovery --backend copilot --model claude-sonnet-
 hivectl governor agent-remove ux-discovery --yes
 ```
 
+### claim / unclaim / claims — issue claims
+
+```bash
+hivectl claim hivecommons/hive#8380              # "mine" — contributors and agents back off
+hivectl claim hivecommons/hive#8380 --until 6h   # hold longer than the hive default (4h)
+hivectl claim hivecommons/hive#8380              # run again to renew
+hivectl takeover hivecommons/hive#8380           # = claim --force: take over another person's claim
+hivectl unclaim hivecommons/hive#8380            # release yours (or a lower-ranked holder's)
+hivectl unclaim hivecommons/hive#8380 --force    # owner override: release regardless of holder
+hivectl claims -o json                           # every live claim on this hive
+```
+
+A claim records who is working an issue *right now* ([#8380](https://github.com/hivecommons/hive/issues/8380)).
+Holders are ranked **human > agent > contributor > external**: a human's claim takes an issue over from a hive
+agent or a relay contributor (the "clanker") and the displaced holder is told to stop — a relay session is
+yanked off the item and handed different work immediately; an agent or an external bot sees the takeover
+comment and the `preempted:<login>` label on the issue. At the same rank the command warns (`held`, exit 3
+with the holder named) unless `--force`. A lower rank can never displace a higher one. Claims lapse on their
+own (default 4h for a person, 2h for an agent kick, 30m for a relay task — configurable under `claims:` in
+`hive.yaml`) and a relay's claim is released the moment its task finishes or is revoked. The hive mirrors each
+transition onto the GitHub issue as a `🔒`/`🔁`/`🔓` comment with a machine-readable `<!-- hive:claim … -->`
+marker and a `claimed` label, so a human, a script or another hive can see the hold without asking the API.
+
 ### observe — read-only metrics
 
 ```bash

docs/content/hive/troubleshooting.md

@@ -206,6 +206,8 @@ If an agent returns to "needs login" immediately after resuming, the credentials
 
 On the containerized runtime you normally do **not** need to configure an auto-approve phrase. Claude Code agents launch with `--dangerously-skip-permissions` (`src/pkg/agent/manager.go`), and the manager's `dismissInferencePrompts` routine polls the pane and auto-dismisses the startup consent screens (the "Bypass Permissions mode" dialog, the custom-API-key prompt, and generic "Enter to confirm" menus) dynamically, without a hardcoded phrase list.
 
+Inference backends (`litellm`, `vllm`, `llm-d`) run Claude Code with an isolated per-agent `HOME`. Hive pre-seeds that HOME's `.claude.json` with onboarding complete and workspace trust entries for `/data/agents/<agent>` and any repo/worktree directories already present below it, then repairs those entries before each Claude launch. This keeps fresh pods from stopping on Claude Code's "Quick safety check: Is this a project you created or one you trust?" dialog.
+
 If an agent still looks wedged on a prompt, capture the pane (`tmux capture-pane -t hive-<agent> -p -S -80`) and check the `hive` logs. A prompt whose selected default is negative (for example "No, exit") is navigated away from before Enter is sent; a genuinely novel prompt that the routine does not recognize is the case to report, along with the captured pane text.
 
 ## Notifications (ntfy / Slack / Discord) never arrive

scripts/sync-hive-docs.ts

@@ -14,6 +14,7 @@ const canonicalBase = `https://github.com/${owner}/${repo}/blob/${branch}/src/do
 
 const files: Array<{ source: string; target?: string }> = [
   { source: "README.md", target: "readme.md" },
+  { source: "documentation-map.md" },
   { source: "architecture.md" },
   { source: "security-threat-model.md" },
   { source: "roadmap.md" },

src/app/docs/page-map.ts

@@ -95,6 +95,7 @@ const NAV_STRUCTURE_HIVE: Array<{ title: string; items: NavItem[] }> = [
     items: [
       { 'Introduction': 'readme.md' },
       { 'Getting Started': 'getting-started.md' },
+      { 'Documentation Map': 'documentation-map.md' },
       { 'Architecture': 'architecture.md' },
       { 'Roadmap': 'roadmap.md' },
       { 'Landscape': 'landscape.md' },