Repository navigation
docs: phase 10 design and implementation plan (cross-cutting invariants and conformance) - #100
Conversation
Phase 10, cross-cutting invariants and conformance: XCUT-1..24, NFR-1..17 and appendix B. One phase built as four stacked PRs (42 tasks); the kit gains the invariant, codec and packaging suites, with an appendix-B gate and an appendix-C coverage script. Rulings P10-1..P10-30 are open for the lead. The roadmap's phase 10 row links the design. Closes #99
Review recordThe design was written first, the plan against it, then the plan was validated against the design read-only, with every finding reproduced (a scratch build, a command run or a grep against the tree) before it was reported. The confirmed findings were then resolved in both documents; design changes are recorded in its Validation resolution (2026-10-13) section. Confirmed findings (13, all resolved)
Rejected candidatesAppendix-B evidence paths (all 55 exist); the 60+ cited test names (all exist); the coverage, appendix-B and license-header counts (all reproduced); worktree packs breaking reproducibility (they were byte-identical); the Plan readingsR1–R5, R8–R12 and R14–R16 accepted; R6, R7 and R13 fixed (F7, F1, F5); R17 added for ChecksHousekeeping probe: no drift ( |
What and why
The design and implementation plan for phase 10 of the v1 roadmap (Cross-Cutting Invariants and Conformance), filed under
docs/work/mvp/phase10/. The roadmap's phase 10 row links the design. Implementation is out of scope and follows in a separate issue.Closes #99
docs/work/mvp/phase10/2026-10-13-phase10-cross-cutting-invariants-design.mddocs/work/mvp/phase10/2026-10-13-phase10-cross-cutting-invariants.mdShape
RS0030bans; (2) the codec suite; (3) the packaging suite and theNFRgates; (4) the appendix-B map and gate,scripts/ci/requirement-coverage.cs, the AOT smoke'sCheckPhase10Asyncand close-out.NFR-16⏳ (phase 12),NFR-17conditional on an admin adding required status checks (P10-16). No 🚫, no N/A, no new §10 entry.suite, 8restated, 36by reference, 0scoped out.Requirements
XCUT-1–XCUT-24,NFR-1–NFR-17, appendix B. No code changes.Verification
links,citations, full probe)housekeeping apply --delivery mvp --phase 10Lead rulings
P10-1 to P10-30 at recommended defaults. Most worth a look: P10-1 (no sub-phases), P10-5 (the SEAM-2 allow-list admits the kit), P10-7 (
TransportFace.NoneandConformanceReport.Combineon the kit's public surface), P10-16 (required status checks onmain, an admin action:main's ruleset has none today, so a red PR can merge), P10-21/-22 (Stryker.NET andbenchmarks/declined; Stryker refuses Microsoft.Testing.Platform projects), P10-23 to P10-25 (oversize error bodies truncated without a marker,HttpResponseException's public constructor accepting a 200, the never-thrownServiceResponseException: routed, not fixed here).