refactor: align ADRs with the code and delete unreachable command-runtime families

Merged
TH
12h ago
+102-4146

Summary

Fixes 2026-11-10 audit findings DOCS-3, DOCS-4, DOCS-6, DOCS-7, DOCS-8, TOOL-3, CMD-1 and CMD2-3.

ADRs and docs

  • ADR 0018 (DOCS-3): now "Partly accepted". The session event log is implemented in packages/session-journal; the catalog, journal, sinks, forks and UsageRecord stay proposed. Out-of-request work runs in the daemon-level diagnostics scope.
  • ADR 0024 (DOCS-4): now Accepted, with rollout steps 2–7 stated as still open. ADR 0019's pointer follows. The owner made this call: FORMAT.md does not allow standing proposed ADRs, and 39 files already implement and cite its rules.
  • ADRs 0011, 0016 and 0025 (DOCS-7): now name code that exists. ADR 0025 also records that the recording E2E (iOS simulator and Android emulator) is gated by an env var that no CI lane sets.
  • docs/dependency-graph-findings.md (DOCS-8): deleted as a stale snapshot.

Cleanup

  • Fake agent-browser fixture (DOCS-6): test-kit is now its single owner; the copy in platform-web is removed.
  • .changeset/ (TOOL-3): deleted. Nothing reads it: no changesets dependency or config, nothing in the release scripts or workflows, and release notes come from gh release create --generate-notes. Commits up to 2026-11-07 still add these files, so authors should stop adding them.
  • Dead command-runtime code (CMD-1, CMD2-3): removes the system, app/admin, observability and record/trace families, plus six bound selector and focus commands. Only their own tests called them. The unused @agent-device/session-journal dependency of command-runtime is removed too.

85 files changed, about +105/āˆ’4146. The dead-code removal is in its own two commits.

Deferred

  • ADR 0020: delete it or move it to its closed issue.
  • About 28 AgentDeviceBackend members that have no caller after this change.

Validation

  • Tested SHA 1a4a1aa (check:affected, exactCommit=true): format, lint, typecheck, layering, fallow, build and package pass.
  • integration-node: fails on 2 smoke-daemon-clean tests. They fail the same way on unchanged base 093341a in this container, and they pass on CI for other PRs.
  • Head 9f1ba11: an ADR text-only fix. check:adr-citations and check:doc-links pass.
  • CI obligations: full unit, integration and coverage.

šŸ¤– Generated with Claude Code

https://claude.ai/code/session_016qAu53rMak1bXMuR5U2gF4