refactor: align ADRs with the code and delete unreachable command-runtime families
Merged
TH
12h ago+102+102+012345678901234567890123456789-4146-4146-0123456789012345678901234567890123456789
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 andUsageRecordstay 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.mddoes 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 fromgh 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-journaldependency 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
AgentDeviceBackendmembers 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 2smoke-daemon-cleantests. They fail the same way on unchanged base093341ain this container, and they pass on CI for other PRs.- Head
9f1ba11: an ADR text-only fix.check:adr-citationsandcheck:doc-linkspass. - CI obligations: full unit, integration and coverage.
š¤ Generated with Claude Code