[futurepaul]

The bridge's and the chat records' docs restated the code: tables of runtime commands and events, every bound, test lists, history. This keeps what other parties depend on and the code doesn't say, and deletes the rest. docs/hermes-relay.md merges into bridge.md as "Hermes' Relay" and is deleted.

Kept (docs/bridge.md):

• which runtime runs an agent (Bridge: a runtime per agent, named in its agent.json (hermes by default) #810), the routes the bridge calls, and what an image sets;
• one life per turn and its records; restarts, the cut-turn note (now naming each call no step ended, Durability phase 4: record each tool call's intent before it runs #823) and rollback notes;
• a card outliving its turn (P6: bounded, restart-safe approval recovery #660);
• the activity socket's frames: a call's intent (Durability phase 4: record each tool call's intent before it runs #823's called), its end (Hard-cut Hermes tool steps to supported observations #664), children's work;
• hand-offs, the hop count, the chat budget, and agents asking each other and being answered back (Asks answered back: the asked turn owes its answer to the asker's tasks #717, Hermes route A: fragment_ask, teammates told, Bot Mode protocol off #726, Remove Bot Mode's keeper and hook #728);
• commands; SimpleX's contract; Hermes' Relay frames and the bridge's choices.

Kept (docs/chat-records.md):

• every record shape on chat, work and tasks and what it means: relayed messages through any door (Honor an owner's relayed message through any door, with no SimpleX core #803, A connector its owner alone edits, bound by them as their agent's door #804), asks and answers, history (the session archive), observed steps, a call's intent (turn.call, Durability phase 4: record each tool call's intent before it runs #823), and late card closures;
• attachments;
• what the page and push rely on beyond the shapes.

Removed: narration of mechanics that engine.rs, relay/, cards.rs, note.rs, simplex/ and hermes-boot already state; "Proven in …" test lists; dated history; the page's UI behaviour (templates/chat/site is its source); Hermes' settings (hermes-boot's managed_config and gateway_env are the source).

Corrected to the code: the chat's listed fields are asks and outcome (templates/chat/fragment.json), as the shell reads them (cell/shell/chat-list.js). The "A card keeps its computer awake" references (a dead link on master) now point at "A card outlives its turn".

References: images/bridge and images/hermes comments are repointed, or a dead pointer is dropped. One-line edits elsewhere:

• AGENTS.md: the hermes-relay bullet goes.
• docs/cloudflare-v1.md (two), docs/computers.md (three) and docs/MODEL.md (one).
• templates/chat/README.md: one clause.

A trial merge of this PR with the other open docs PRs (#825, #838, #839) leaves no unresolved section references and no mention of a deleted doc.

file	before	after
docs/bridge.md	1,084	403
docs/chat-records.md	1,031	480
docs/hermes-relay.md	230	deleted

cargo xtask check passes; images' clippy and tests pass.

Decision for Paul: images/bridge/src/simplex/door.rs says the agent's tools run as root. They run as hermes, with passwordless sudo (images/hermes/boot/src/main.rs, images/hermes/Dockerfile), as simplex/run.rs and the debt ledger's SimpleX entry say. Correct the comment to "a process as root (the bridge's user, and the agent's through its passwordless sudo) can read the key's file", or leave it to the ledger entry?

🤖 Generated with Claude Code

[alexlwn123]

Pass at 7fa67aaf63c7d8bbc6f07a73c332005371cfa362.

This consolidates the bridge, chat-record and Hermes Relay contracts while removing implementation narration. The retained claim/restart, late-card-answer and wire-record contracts agree with the surrounding implementation; the corrected listed fields match the chat template and shell. Source edits are comments only, and no references to the deleted Hermes Relay document remain. The reduction is appropriate to the stated purpose; I found no blocking regression.

Validation: git diff --check passed; CI check and e2e jobs passed. Images check and real-Hermes Docker checks are still pending. Runtime tests were not rerun locally for this documentation/comment-only change. The external engineering-style file named by AGENTS.md was unavailable at its prescribed path.

[alexlwn123]

Pass at 79d811ad74d124fba6395e027af66db5be066034.

The prior head passed with no blockers. This rereview checks the merge's changes to the previously accepted documentation consolidation: the cut-turn continuation contract matches posted, continue_turn, the continuation ID and start notice, and the durability contract. Relative to the merged base, source changes remain comments only. The documentation reduction remains appropriate; no blocking regression found.

Non-blocking: the merge restored stale references in docs/cloudflare-v1.md:679 and docs/computers.md:1874 to the deleted docs/hermes-relay.md, and in docs/cloudflare-v1.md:854 and docs/computers.md:828 to the removed “A card keeps its computer awake” section. Repoint these to the surviving Relay/settings source and “A card outlives its turn.”

Validation: git diff --check HEAD^2 HEAD passed. CI e2e gate passed (its build/shards were skipped); check, images check and real-Hermes Docker are pending. Runtime tests were not rerun locally for this documentation/comment-only delta. The external engineering-style file remains unavailable at its prescribed path.

[alexlwn123]

Pass at 88854f8e910a806a5abe8a811d713a32a8d63a6d.

The prior head passed with no blockers. Its non-blocking stale references are now resolved. This rereview checks the newly merged Claude runtime and session-history contracts: the condensed text agrees with the runtime's session, environment, card and interrupt handling, and with historyOf's summary/message selection. Relative to the merged base, executable behavior is unchanged; source edits remain comments only. The documentation reduction remains appropriate, with no blocking regression found.

Validation: git diff --check HEAD^2 HEAD passed. CI e2e gate passed (build/shards skipped); check, images check and real-Hermes Docker are pending. Runtime tests were not rerun locally for this documentation/comment-only delta. The external engineering-style file remains unavailable at its prescribed path.