feat(framework): P6 — docs + compliance matrix + resident-budget CI #607

jason.woltje · 2026-06-22T02:08:14Z

jason.woltje commented

2026-06-22 02:08:14 +00:00

P6 — Docs, compliance matrix, resident-budget CI (constitution capstone)

Implements R9 (resident line-count ceiling) + R10 (docs/compliance/aiguide) — the in-repo half of the alpha capstone. Closes #606 (lineage #542).

Delivered

framework/CONTRIBUTING.md — layer model (L0–L4); operator-hygiene / PII-secrets prohibition; dedup rule (one L0 source); resident-budget rule; dual-installer parity rule (install.sh ↔ file-adapter.ts + shared fixtures); adding-a-harness; re-contamination rule; harness × gate compliance matrix (Claude/Codex/OpenCode/Pi) with the hook-parity gap marked as tracked-v2; known-limitations (DESIGN §9 accepted residuals); PR checklist.
check-resident-budget.sh — line-count ceiling over framework-owned resident files (CONSTITUTION.md + AGENTS.md + each runtime/*/RUNTIME.md), with --self-test. Replaces the crude inline ci.yml loop; wired blocking in .woodpecker/ci.yml (self-test + real run).

Already satisfied (no-op here)

Composer unit test (R9) runs via pnpm test. verify-sanitized.sh (P1) already wired blocking.

Verification

Sanitization gate green (CONTRIBUTING is operator-neutral — no PII/paths). Resident-budget self-test + real run green (current: CONSTITUTION 96, AGENTS 83, RUNTIME max 75 — all < ceiling). prettier clean.

aiguide reconcile (companion, separate repo)

mosaicstack/aiguide PR #8 — adds a canonical-Constitution pointer to operating-contract.md (gates already align 1:1; no content change).

Note for reviewer

Commit adc7df2 is the same pre-existing format:check fix as P5's 9f6da92 (cherry-picked so P6 is pushable off main). When P5 merges first, the rebase auto-drops the duplicate.

Remaining for mission close (not in this PR)

Alpha tag mosaic-vX.Y.Z-alpha — yours to cut after the full DoD §8 is CI-green and all phases (P0–P6, incl. P5 #605) are merged. Proposed: tag the first release where main contains P5+P6. Version is your call (next after the 0.0.38 wave).

🤖 Generated with Claude Code

## P6 — Docs, compliance matrix, resident-budget CI (constitution capstone) Implements **R9 (resident line-count ceiling) + R10 (docs/compliance/aiguide)** — the in-repo half of the alpha capstone. Closes #606 (lineage #542). ### Delivered - **`framework/CONTRIBUTING.md`** — layer model (L0–L4); operator-hygiene / PII-secrets prohibition; dedup rule (one L0 source); resident-budget rule; **dual-installer parity rule** (install.sh ↔ file-adapter.ts + shared fixtures); adding-a-harness; re-contamination rule; **harness × gate compliance matrix** (Claude/Codex/OpenCode/Pi) with the **hook-parity gap marked as tracked-v2**; known-limitations (DESIGN §9 accepted residuals); PR checklist. - **`check-resident-budget.sh`** — line-count ceiling over framework-owned resident files (`CONSTITUTION.md` + `AGENTS.md` + each `runtime/*/RUNTIME.md`), with `--self-test`. Replaces the crude inline `ci.yml` loop; wired **blocking** in `.woodpecker/ci.yml` (self-test + real run). ### Already satisfied (no-op here) - Composer unit test (R9) runs via `pnpm test`. `verify-sanitized.sh` (P1) already wired blocking. ### Verification - Sanitization gate green (CONTRIBUTING is operator-neutral — no PII/paths). Resident-budget self-test + real run green (current: CONSTITUTION 96, AGENTS 83, RUNTIME max 75 — all < ceiling). prettier clean. ### aiguide reconcile (companion, separate repo) `mosaicstack/aiguide` PR **#8** — adds a canonical-Constitution pointer to `operating-contract.md` (gates already align 1:1; no content change). ### Note for reviewer Commit `adc7df2` is the same pre-existing `format:check` fix as P5's `9f6da92` (cherry-picked so P6 is pushable off main). When P5 merges first, the rebase auto-drops the duplicate. ### Remaining for mission close (not in this PR) **Alpha tag `mosaic-vX.Y.Z-alpha`** — yours to cut after the full DoD §8 is CI-green and all phases (P0–P6, incl. P5 #605) are merged. Proposed: tag the first release where main contains P5+P6. Version is your call (next after the 0.0.38 wave). 🤖 Generated with [Claude Code](https://claude.com/claude-code)

jason.woltje added 2 commits 2026-06-22 02:08:14 +00:00

feat(framework): P6 docs + compliance matrix + resident-budget CI (#606 ) 65c4de99cd

R9 + R10 of the Constitution alpha (in-repo deliverables):

- framework/CONTRIBUTING.md: layer model, operator-hygiene/PII prohibition,
  dedup rule, resident budget, dual-installer parity rule, adding-a-harness,
  re-contamination rule, harness x gate compliance matrix (hook-parity gap
  marked as tracked-v2), known-limitations (DESIGN §9 residuals), PR checklist.
- check-resident-budget.sh: line-count ceiling over framework-owned resident
  files (CONSTITUTION + AGENTS + each runtime/*/RUNTIME.md), with --self-test;
  replaces the crude inline ci.yml loop. Wired blocking in .woodpecker/ci.yml.

Composer unit test (R9) already runs via pnpm test; verify-sanitized.sh (P1)
already wired. Sanitization + budget + prettier all green.

Remaining for the mission close: aiguide reconcile (separate repo) + the alpha
tag (Lead cuts after full DoD §8 green + all phases merged; P5 #605 pending).

Refs #606, #542

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01EsgTQzV5YUGk1JtCLP4B83

chore(format): prettier docs/fleet/PRD-fleet-suite.md (pre-existing main violation)

ci/woodpecker/push/ci Pipeline is pending

Details

ci/woodpecker/pr/ci Pipeline is pending

Details

adc7df2404

Pre-existing repo-wide format:check failure on origin/main (markdown table
alignment only — no content change). Picked up to unblock the pre-push gate;
flagged to the Lead. Not part of the P5 composer change.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01EsgTQzV5YUGk1JtCLP4B83

jason.woltje added 1 commit 2026-06-22 02:13:50 +00:00

docs(framework): alpha DoD §8 green-checklist + v0.0.39-alpha release notes

ci/woodpecker/pr/ci Pipeline was canceled

Details

ci/woodpecker/push/ci Pipeline was canceled

Details

e0a16281b4

Maps every Constitution-alpha acceptance criterion (DESIGN §8) to its merged
PR, and drafts the Gitea release notes for the v0.0.39-alpha tag. For the Lead
to use when cutting the tag after P5 #605 -> P6 #607 -> aiguide #8 merge.

Refs #606, #542

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01EsgTQzV5YUGk1JtCLP4B83