Skip to content

docs: ADR 0008 (command descriptor) + ADR 0009 (Apple consolidation)#905

Merged
thymikee merged 1 commit into
mainfrom
docs/adr-command-descriptor-apple
Jun 27, 2026
Merged

docs: ADR 0008 (command descriptor) + ADR 0009 (Apple consolidation)#905
thymikee merged 1 commit into
mainfrom
docs/adr-command-descriptor-apple

Conversation

@thymikee

Copy link
Copy Markdown
Member

Locks the two axis decisions from the perfect-shape roadmap and starts retiring plans/ into ADRs.

  • ADR 0008 (Proposed) — the command-descriptor registry: one descriptor per command composing domain-owned facets (surface@commands, capability@core, daemon@src/daemon per ADR 0003), from which the ~10 tables derive. Bound by ADR 0003's four invariants (compose, don't collapse). Migration is strangler-fig: invert the import graph, derive each table behind a byte-for-byte parity test, delete the hand table only when its test is green.
  • ADR 0009 (Accepted) — Apple platform consolidation via an AppleOS discriminant under one apple Platform (not six literals). Groundwork shipped in feat: add AppleOS discriminant to the device model (additive) #896.
  • perfect-shape.md links both and marks Phase 0 + the Tier-A dedup sweep as merged.

Docs-only. Next gateway: the command-descriptor spine (ADR 0008).

Locks the two axis decisions and starts retiring plans/ into ADRs. ADR 0008
(Proposed) records the command-descriptor registry composing domain-owned facets
and deriving the ~10 tables, bound by ADR 0003's four invariants; ADR 0009
(Accepted, groundwork shipped in #896) records the AppleOS leaf axis under one
'apple' Platform. perfect-shape.md links both and marks Phase 0 + Tier-A dedup as
merged.
@github-actions

Copy link
Copy Markdown

Size Report

Metric Base Current Diff
JS raw 1.4 MB 1.4 MB 0 B
JS gzip 445.7 kB 445.7 kB 0 B
npm tarball 584.6 kB 584.6 kB 0 B
npm unpacked 2.0 MB 2.0 MB 0 B

Startup median (7 runs, lower is better):

Scenario Base Current Diff
CLI --version 26.1 ms 26.5 ms +0.4 ms
CLI --help 46.9 ms 47.0 ms +0.1 ms

Top changed chunks: no changes in the largest emitted chunks.

@thymikee

Copy link
Copy Markdown
Member Author

Reviewed against plans/perfect-shape.md and ADR 0003. No findings.

ADR 0008 captures the command-descriptor direction without collapsing daemon policy into the public command surface, and ADR 0009 matches the AppleOS-under-Apple-plugin decision from plans/apple-platform-consolidation.md. Links resolve, the PR is docs-only, and GitHub shows all 20 checks green.

@thymikee thymikee merged commit 29e19b8 into main Jun 27, 2026
20 checks passed
@thymikee thymikee deleted the docs/adr-command-descriptor-apple branch June 27, 2026 15:09
@github-actions

Copy link
Copy Markdown
PR Preview Action v1.8.1
Preview removed because the pull request was closed.
2026-06-27 15:09 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