mirror of
https://github.com/harvard-edge/cs249r_book.git
synced 2026-05-06 17:49:07 -05:00
20ea20005c
Closes the release-readiness push. All 8 gates green: vault check,
lint, doctor, codegen, validate-vault, render, tsc, Playwright.
Bundle: 9,775 → 9,781 published.
E.2 — Auto-emit vault-manifest.json from `vault build --legacy-json`:
Added `emit_manifest()` to `legacy_export.py` and wired it into
`commands/build.py` after the legacy corpus emission. The manifest
is now derived deterministically from the same `loaded` set that
produced corpus.json — track + level distributions, contentHash,
counts. Eliminates the recurring stale-manifest pre-commit failure
that had to be patched by hand twice during this push.
E.3 — `--include-areas` flag in analyze_coverage_gaps.py:
Injects forced area-targeted cells into the recommended_plan for
each listed competency_area (parallelism, networking, etc.). For
each (track, area) where area is in the include list, adds 1 cell
per (canonical-topic × {L4, L5, L6+}) zone. Closes the structural
mismatch where topic-priority ranking misses area-level gaps.
Tested with `--include-areas parallelism`: plan now includes 21
parallelism-topic cells (was 0 in stock plan).
F.4 — Third-pass fix-agent on 10 residuals (4 NEEDS_FIX + 6 DROP from
F.1). Substantial rewrites; 0 archived. Major math corrections:
- mobile-1948: KV cache reconstructed (96 MB / 2048 = 48 KB/token)
- tinyml-1681: cycle-model with proper register spill (5912 → 7912)
- tinyml-1716: serialization on single-core M4 (12 ms not 10 ms)
- tinyml-1634: Young/Daly hours-conversion (139 s, not 2.31 s)
- tinyml-1723: triple-buffer SRAM (43.5 KB → 19.5 KB)
- edge-2401: log2(18) = 4.17 (was 3.6)
F.5 — Re-judge: 6 PASS / 2 NEEDS_FIX / 2 DROP (60% pass rate). 6 more
promoted. The 2 still-NEEDS_FIX + 2 DROP after THREE rewrite
passes are documented as genuinely-stubborn carry-forwards.
G.1 — Cloud parallelism spot-check: 12 stratified items reviewed,
0 issues. Cloud's 326 parallelism items are still high-quality.
G.2 — CHANGELOG.md updated with comprehensive [0.1.2-dev] entry:
schema changes, new validators, tooling additions, content
additions, three documented lessons (validate-at-data-boundary,
prompt-specificity-beats-budget, topic-priority-misses-area-gaps).
Cumulative recovery rate of NEEDS_FIX/DROP items via layered fix-
agents (Phase C + F.2 + F.4): 63 of 120 = 53%. The remaining 57 split
between DROP (genuinely unrecoverable) and items still in NEEDS_FIX
state (deferred to future passes).
Final cumulative state of branch:
- Bundle: 9,224 → 9,781 published (+557 net)
- Lint warnings: 1,308+ → 0
- Doctor fails: 1 → 0
- Pydantic validators: 1 → 4
- Playwright tests: 8 → 9
- Repair scripts: 0 → 5
- Generator features: basic → bloom-aware + topic-area mapping +
parallelism prompt + retry-on-validate-fail + targets-from +
validate-at-write
- Build pipeline: manual manifest → auto-emit
- Analyzer: topic-priority only → topic-priority + area-include flag
- Parallelism gap (the original mission): closed across all tracks