Skip to content

docs: amend ADR 0019 with broader-migration governance - #1738

Merged
thymikee merged 1 commit into
mainfrom
claude/daemon-generalization-exploration-6a1a88
Aug 11, 2026
Merged

docs: amend ADR 0019 with broader-migration governance#1738
thymikee merged 1 commit into
mainfrom
claude/daemon-generalization-exploration-6a1a88

Conversation

@thymikee

@thymikee thymikee commented Aug 11, 2026

Copy link
Copy Markdown
Member

Summary

Amends ADR 0019 with the governance for migration beyond the adoption checkpoint, so the successor tracker (to #1696) has authoritative text to build on. The amendment re-authorizes nothing by itself; command units still migrate one at a time under sections 2-6.

  • Status: records the recordings command unit as completed on the durable-capture substrate (section 7 already carried its bounds); states explicitly that no further command unit is authorized by Status — subsequent units are planned, budgeted, and authorized individually through the successor tracking issue.
  • Section 6: explicit none platform-execution mode with invariants (never binds a device, no capability bucket, no platform adapter); the cutover gate applies to platform-executing descriptors only and rejects a false none; silent registry-entry mode defaults prohibited.
  • Section 8: move-dominated size accounting (units relocate mechanics, net growth exceptional and itemized), deprecated surfaces die on legacy at the next major, two evidence tiers (request-scoped vs durable-resource), one parametrized cutover gate, capability buckets deleted per unit.
  • Section 9: one bind per handler, side-effect-free facts inspection for admission/capabilities/doctor, single defineUse, preferred operations require a recorded measurement.
  • Section 10: cross-cutting facets land with their first consuming unit under one contract owner; evidence-gated startup recovery (no per-platform startup entrypoints); two-phase gateway shutdown (detach/handoff before session teardown, stop after); teardown steps ride their owning domain's unit; end-state all-edge-kinds layering rule over production src/daemon/** modules (test files excluded, matching the layering scanner's scope).

Review provenance

Drafted alongside the successor migration tracker and taken through five rounds of external review; approved, with the final docs feedback (Status recordings tense, title scope) folded in. The successor tracking issue will be opened against the merged text.

Validation

Docs-only change. pnpm format:check green across the repo (2,552 files).

Amends ADR 0019 for migration beyond the adoption checkpoint:

- status: recordings command unit recorded as completed; no further
  command unit is authorized by Status — subsequent units are planned,
  budgeted, and authorized through the successor tracking issue
- section 6: explicit none platform-execution mode with invariants; the
  cutover gate applies to platform-executing descriptors only and rejects
  a false none declaration; silent registry-entry mode defaults prohibited
- section 8: move-dominated size accounting, deprecated surfaces die on
  legacy at the next major, two evidence tiers, one parametrized cutover
  gate, capability buckets deleted per unit
- section 9: one bind per handler, side-effect-free facts inspection,
  single defineUse, preferred operations require a recorded measurement
- section 10: cross-cutting facets land with their first consuming unit,
  evidence-gated startup recovery, two-phase gateway shutdown, teardown
  steps ride their owning domain, all-edge-kinds end-state layering rule
  over production daemon modules
@thymikee
thymikee force-pushed the claude/daemon-generalization-exploration-6a1a88 branch from 1a714d0 to d591e92 Compare August 11, 2026 13:52
@thymikee thymikee changed the title docs: amend ADR 0019 with broader-migration governance (sections 8-10) docs: amend ADR 0019 with broader-migration governance Aug 11, 2026
@thymikee
thymikee merged commit 73b54c1 into main Aug 11, 2026
8 checks passed
@thymikee
thymikee deleted the claude/daemon-generalization-exploration-6a1a88 branch August 11, 2026 14:24
@github-actions

Copy link
Copy Markdown
PR Preview Action v1.8.1
Preview removed because the pull request was closed.
2026-08-11 14:25 UTC

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant