Addresses CPS-PRD-REV1-REREVIEW findings on PR #1491 head 13968e9a:
F1 (blocker; the CI test failure): docs/PRD.md is now the permanent shim, so
heading-fragment links into the former PRD body no longer resolve —
fleet-documentation.spec.ts failed on docs/fleet/README.md's FCM anchor. The
Part II workstream contracts live in
docs/PRDs/2026-08-31_PRD_rev1/GOV.4-workstream-contracts.md; all five anchored
links in the tree are repointed there (fleet/README.md, TASKS.md,
release-integrity/TASKS.md, ADMIN-GUIDE mos-connector-lease-operations.md,
DEVELOPER-GUIDE mos-runtime-portability-m1.md). Each anchor verified against
the GOV.4 headings with the spec's slug rule. Bundle content unchanged.
F2 (minor): the rev0 archive README's ./ROADMAP.md row now cites all three
source lines (18, 177, 249).
Addresses CPS-PRD-REV1-REVIEW-Q90 findings F1 and F3 on PR #1491:
F1 (format gate): `prettier --write` on the 18 rev1 bundle documents.
Whitespace, table padding, list markers and emphasis delimiters only — a
normalized token comparison of every file before/after shows zero content
difference, so the ratified text is unchanged and no re-ratification applies.
F3 (rev0 relative links): the archived rev0 PRD stays byte-identical
(sha256 60cc2f98...36afdf verified) per GOV.1 archive-never-edit. A sibling
docs/PRDs/2026-08-26_PRD_rev0/README.md records the digest, the original
location, the owner disposition that the in-file links are intentionally
historical, and a resolution table for all 9 targets (11 occurrences), each
verified to exist. Future relocated archives ship the same README instead of
edited bytes.
F2 (test step) is investigated separately against the CI log.
Ratifies the Mosaic Stack PRD rev1 (Jason Woltje, 2026-09-01) as project
source of truth and installs the GOV.1 lifecycle model:
- docs/PRD.md becomes a permanent shim (kind: shim, current_rev ->
docs/PRDs/2026-08-31_PRD_rev1/). Its path never changes again.
- docs/PRDs/2026-08-26_PRD_rev0/PRD.md archives the 2026-08-26 North Star
verbatim (sha256 60cc2f98...36afdf unchanged). Archive, never delete.
- docs/PRDs/2026-08-31_PRD_rev1/ is the frozen rev1 bundle: 18 sectioned
documents (VIS, DATA, AUTHN, AUTHZ, SEAT, ROLE, HARN, PROV, SESS, UI, CLI,
GOV.1-5) consolidating rev0 D1-D15, the fleet north star, the agent-runtime
L1/L2 contracts and the control-plane-surfaces lane findings, with a single
decision map (GOV.3) and a closed open-questions frontier (GOV.5, grill
rounds 1-8). Drafting inputs (_source-* snapshots) are not shipped.
Consequences of the ratified rulings carried in the same change:
- Q-T1 (ruling B, "shipped but frozen"): D3 amended in GOV.3/VIS.1;
federation M1-M3 acknowledged as shipped behind tier === 'federated',
excluded from the v1 bar and frozen, with a security re-audit gate before
any resumption. docs/MISSION-MANIFEST.md, docs/federation/MISSION-MANIFEST.md
and docs/scratchpads/mvp-20260312.md get status: superseded + banners
(content preserved verbatim); docs/guides/deployment.md gains a
"Relationship to the PRD (D15)" section. NORTH_STAR.yaml adds dormant
workstream M (projects no goals by design); NORTH_STAR.md regenerated.
- Q-G2 (distinct registry prefixes): every citation of the operator
DECISION-REGISTER in the bundle reads OD-nn; the stack registry stays
D1-D15; L1-Dnn/L2-Dnn untouched. Prefix rule recorded in GOV.1.
Follow-ups (not in this PR): CI parity drift-gate witness (Q-C1); brain-side
DECISION-REGISTER rename to OD- with redirect table on its next touch.
- docs/PRD.md: Part I product north star authored from ratified decisions
D1-D14; Part II preserves all active workstream contracts verbatim
(KBN-101, FCM #758, FCOM #766, TESS, #756, MOS-PORT, #1150, #1174, #1194,
RI #1275, M1). Referenced anchors unchanged.
- docs/archive/PRD-v0.1.md: v0.1.0 beta PRD body archived verbatim with
supersession header.
- docs/ROADMAP.md: all phases P0-P5 present from day one per D11
(P2-P5 as explicit placeholders).
- docs/requirements/native-kanban-sot.md: Amendment A1 (D13) - hierarchy
parentage + RBAC chain above workspaces; sections 1-7 untouched.
jason.woltje
marcieandorch-01
fredandmarcie
fred