docs(M295): professional README + mdBook companion at paiml.github.io/claude-code-parity-apr

[noahgift]

Summary

• book/ — full mdBook source, 28 chapters covering methodology, gates, empirical findings, CLI reference, and academic basis. Hosted at paiml.github.io/claude-code-parity-apr via GitHub Pages.
• .github/workflows/book.yml — auto-build + auto-deploy on every push to main touching book/**.
• README.md — restructured: clear badges row, book callout, empirical highlight section (the V1_004 chain table), clean architecture diagram, gates with deep-links to book chapters.

Book structure

Introduction
├── 01-overview/        what-is-ccpa, methodology, two-paths, architecture
├── 02-static-path/     trace-schema, differ, fixtures, bidirectional-sensitivity
├── 03-arena/           overview, phase-5, phase-6, outcomes
├── 04-gates/           gates (20), source-of-truth, behavioral-parity, status-flow
├── 05-findings/        v1004-chain, m286-m32d, m287-greedy, m291-pattern-shift,
│                       m292-text-loop, m294-finetune-ab
├── 06-reference/       cli, trace-schema, contract-yaml, gate-ids
└── 99-appendix/        academic-basis, milestone-history, glossary

What the book captures that the spec doesn't

• Sequenced narrative: the V1_004 chain (M286 → M294) reads as one empirical story instead of 9 separate evidence files
• Cross-references at the prose level (not just paper trail): "see Status flow" links inline
• Glossary for fast onboarding
• Single shareable URL: paiml.github.io/claude-code-parity-apr for reference in PRs, issues, talks

Test plan

• mdbook build book/ — builds clean, no broken links
• bash scripts/test-doc-drift.sh — 17/17 drift classes pass
• bash scripts/check-doc-drift.sh — clean
• .gitignore excludes book/book/ (generated)
• CI builds book on this PR
• On merge, GitHub Pages deploys the book

Cross-references

• evidence/phase-6/v1004-*.md — sourced into book/src/05-findings/
• CCPA#259 M291, feat(M292): Agent-Text-Loop detector — closes M291 Gap 3 #260 M292, feat(M293): wire PHASE6_MAX_CONSECUTIVE_TEXT_TURNS env var into phase-6-bench.sh #261 M293, spec(M294): V1_004 follow-up — Qwen3-30B-A3B-Instruct-2507 (non-Coder) A/B scope #262 M294 scope

🤖 Generated with Claude Code