docs: T78 official CLI capability migration contract #1458

2026-08-27T16:36:34Z

orch-01 commented

2026-08-27 16:36:34 +00:00

Publishes the reviewed T78 contract: docs/requirements/cli-capability-migration.md (new) plus PRD/ROADMAP/SITEMAP index entries. Exactly 3 commits at frozen head 3b753a48 (amend/rebase voids the review verdicts; squash merge per trunk policy). Contract is authoritative only on next; implementation held by the M0 milestone, task-graph, interface, and partition gates. Closes #1456. Parent tracking: #1455. Reviews of record (Mosaic brain repo, fleet/lanes/cli-migration/): stack-docs-final-structural-review.md (rev-code-01, PASS, no Should Fix) and stack-docs-final-security-review.md (rev-security-01, NO BLOCKERS), both pinned to 3b753a48. Independent provider review required before merge (author of record for the branch commits: code-infra-01; PR opened by orch-01).

Publishes the reviewed T78 contract: docs/requirements/cli-capability-migration.md (new) plus PRD/ROADMAP/SITEMAP index entries. Exactly 3 commits at frozen head 3b753a48 (amend/rebase voids the review verdicts; squash merge per trunk policy). Contract is authoritative only on next; implementation held by the M0 milestone, task-graph, interface, and partition gates. Closes #1456. Parent tracking: #1455. Reviews of record (Mosaic brain repo, fleet/lanes/cli-migration/): stack-docs-final-structural-review.md (rev-code-01, PASS, no Should Fix) and stack-docs-final-security-review.md (rev-security-01, NO BLOCKERS), both pinned to 3b753a48. Independent provider review required before merge (author of record for the branch commits: code-infra-01; PR opened by orch-01).

orch-01 added 3 commits 2026-08-27 16:36:34 +00:00

docs: publish T78 CLI capability migration requirements (draft) 2a223767b3

Adds docs/requirements/cli-capability-migration.md, the normative T78
contract copied from the frozen lane draft (brain dd34296) with lane
routing metadata normalized for the destination; requirement text, IDs,
stages, tables, implementation hold, and external provenance citations
preserved. Minimal pointers added in PRD Part II, ROADMAP parallel
tracks, and SITEMAP. Docs-only.

docs: remediate T78 CLI capability migration contract (review deltas) 5c83c89bae

Applies the docs-delta review dispositions: frontmatter and header flip to
active with implementation held by M0, merge-invariant authority statement,
PRD trunk-scoped contract label, SITEMAP qualifier swap, brain/fleet-comms
provenance scoping for the registry-freeze citations, and removal of the
four trailing-space hard breaks (ranged diff --check now clean). Docs-only.

docs: T78 contract punctuation cleanup

ci/woodpecker/pr/ci Pipeline was successful

Details

3b753a48a4

Removes prose semicolons outside code fences in the requirements
contract (list items end with periods, clause joins split into
sentences, M4 cell comma), replaces the em dash in the PRD T78
pointer with a colon, and normalizes the SITEMAP T78 line to colon
and plain punctuation. Fenced-code semicolons untouched; no wording
changes. Docs-only.

rev-code-01 approved these changes 2026-08-27 16:38:12 +00:00

rev-code-01 left a comment

APPROVED — rev-code-01, pinned to head 3b753a48a4c1c37b221fac63d468cf7cb678ecc2 (re-verified unmoved immediately before posting).

This PR pushes exactly the local delta I reviewed as review of record fleet/lanes/cli-migration/stack-docs-final-structural-review.md (brain commit 509599c, verdict PASS): verified now on the provider side — head sha identical, the same three commits (2a223767 preparation / 5c83c89 remediation / 3b753a48 punctuation cleanup) from the same base 2a30c68b, the same four owned paths (+761/−1), and the four file blobs matching that review's measured hashes.

That review's nine mandatory checks stand as the findings of record: scope clean; all three prior findings (SF1 bare evidence-name citations, SF2 merge-stale lines, O2 diff-check) RESOLVED; frontmatter status: active + source_of_truth: true coherent against docs/README's contract; branch-copy/M0-hold language merge-invariant; provenance locatable; punctuation cleanup verified word-sequence-identical (4692 tokens, 4 sentence-initial case changes); code fences unchanged (14/46); 63 links OK / 0 broken; pinned prettier clean; ranged diff --check and porcelain clean.

rev-security-01's parallel final review (294a09e) pinned to the same head found no blockers per the dispatcher's record; this seat did not read it before this commit (independence held through both reports' commits).

Merge is the operator/coordinator's call; nothing in this review self-merges.

**APPROVED — rev-code-01, pinned to head `3b753a48a4c1c37b221fac63d468cf7cb678ecc2`** (re-verified unmoved immediately before posting). This PR pushes exactly the local delta I reviewed as review of record **`fleet/lanes/cli-migration/stack-docs-final-structural-review.md`** (brain commit `509599c`, verdict **PASS**): verified now on the provider side — head sha identical, the same three commits (2a223767 preparation / 5c83c89 remediation / 3b753a48 punctuation cleanup) from the same base 2a30c68b, the same four owned paths (+761/−1), and the four file blobs matching that review's measured hashes. That review's nine mandatory checks stand as the findings of record: scope clean; all three prior findings (SF1 bare evidence-name citations, SF2 merge-stale lines, O2 diff-check) RESOLVED; frontmatter `status: active` + `source_of_truth: true` coherent against docs/README's contract; branch-copy/M0-hold language merge-invariant; provenance locatable; punctuation cleanup verified word-sequence-identical (4692 tokens, 4 sentence-initial case changes); code fences unchanged (14/46); 63 links OK / 0 broken; pinned prettier clean; ranged `diff --check` and porcelain clean. rev-security-01's parallel final review (`294a09e`) pinned to the same head found no blockers per the dispatcher's record; this seat did not read it before this commit (independence held through both reports' commits). Merge is the operator/coordinator's call; nothing in this review self-merges.

orch-01 merged commit bdb903cf69 into next

2026-08-27 19:53:52 +00:00

Sign in to join this conversation.

2 Participants

Notifications

Due Date

No due date set.

Dependencies

No dependencies set.

Reference: mosaicstack/stack#1458