Skip to content

chore(cognition): dead-wire + doc hygiene from the citizenship audit (#428) - #2300

Merged
joelteply merged 1 commit into
canaryfrom
chore/428-cognition-doc-dead-wire-hygiene
Aug 14, 2026
Merged

chore(cognition): dead-wire + doc hygiene from the citizenship audit (#428)#2300
joelteply merged 1 commit into
canaryfrom
chore/428-cognition-doc-dead-wire-hygiene

Conversation

@joelteply

Copy link
Copy Markdown
Contributor

What

Three hygiene fixes from the 2026-08-14 citizenship audit (AXIS 3, drift items). No behavior change on any live path.

  1. Orphan event deleted: agent:solve:complete (solve.rs) had zero subscribers tree-wide. The bench board reads run ledgers via scan_run_cards (and now reaches citizen perception via the ViewState pipe, feat(cognition): bind the benchmark board to citizen eyes — BenchViewState via the ViewState pipe (#426) #2298); the event was dead wire on the detached-runner path that Gap analysis: 49 open issues, 20 closed #425 will retire.

  2. Stale comment corrected (service_loop.rs): claimed the turn is serviced through persona::response::respond(RespondInput). That verb's only caller, PersonaServiceModule, is declared UNWIRED/shadowed by the module-wiring audit (runtime/registry.rs). The comment now names the real live path — the WorkspaceCycle (admit → build_workspace_turns → Burst → faculties → act→observe).

  3. PERSONA-COGNITION-PIPELINE.md §2 gets a Status column: the 13-verb table previously presented all verbs as the live per-turn cycle. Verified per-verb (grep for production callers): live = admit, compose_for_turn, ToolExecutor, state updates (partial), say. Dormant (diagnostic-command-only / dead respond path / test-only) = full_evaluate, analyze, score_persona, activate_skill, evaluate_response, clean_and_validate, audit, check_redundancy. "Dormant" is explicitly defined as reuse-don't-parallel.

Why

The doc drift is how the respond bypass kept getting rebuilt under amnesia — the doc said those verbs run per-turn, so new code kept wiring against them. Task #428.

Validation

cargo check -p continuum-core --features metal,accelerate clean (1m18s). The only code changes are a 5-line dead publish removal and a comment.

🤖 Generated with Claude Code

https://claude.ai/code/session_01LoTjvf5j3Ez13g6k8mRkFo

…428)

Three fixes, no behavior change on any live path:

1. Delete the orphan agent:solve:complete publish (solve.rs). Zero
   subscribers tree-wide; the bench board reads run ledgers via
   scan_run_cards, not this event. Dead wire on the detached-runner
   path #425 will retire.

2. Correct the stale service_loop.rs turn-servicing comment. It claimed
   persona::response::respond(RespondInput) runs the turn; that verb's
   only caller (PersonaServiceModule) is declared UNWIRED/shadowed by
   the module-wiring audit (runtime/registry.rs). The live path is the
   WorkspaceCycle (admit -> build_workspace_turns -> Burst -> faculties
   -> act->observe), which the comment now names.

3. PERSONA-COGNITION-PIPELINE.md paragraph 2: add a per-verb Status column.
   Verified callers per verb: live = admit, compose_for_turn,
   ToolExecutor, state updates (partial), say. Dormant (diagnostic
   command / dead respond path / test-only) = full_evaluate, analyze,
   score_persona, activate_skill, evaluate_response, clean_and_validate,
   audit, check_redundancy. The doc previously presented all 13 as the
   per-turn cycle, which is how the respond bypass kept getting rebuilt.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01LoTjvf5j3Ez13g6k8mRkFo
@joelteply
joelteply merged commit bb5e6a3 into canary Aug 14, 2026
5 checks passed
@joelteply
joelteply deleted the chore/428-cognition-doc-dead-wire-hygiene branch August 14, 2026 21:57
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant