ed/manual_slop
Private
Public Access
0
0
Fork 0
Code Activity

docs(spec_v2): add Revision History section documenting MVP pivot

Browse Source 
Added a '## Revision History' section at the end of spec_v2.md (just before
'End of spec_v2.md.') documenting the 2026-06-24 MVP pivot:

- MVP output is a single AUDIT_REPORT.md (6797 lines, 311KB) + per-aggregate
  markdowns + summary.md TOC pointer
- v2 DSL format (to_dsl_v2/parse_dsl_v2/DSL_WORD_ARITY_V2/_atom) was
  implemented but never produced and was deprecated in Task 2.2
- compute_result_coverage was dead code with a latent 100% bug, removed in Task 2.3
- Test count: 125 (was 131 pre-polish; -6 tests deleted)
- audit_weak_types.py --strict and generate_type_registry.py --check now pass

No changes to the v2 spec's overall design intent, 13 aggregates, 4-direction
decomposition cost, or cross-audit integration. The MVP pivot is purely about
the OUTPUT format and code-smell cleanup.
This commit is contained in:
Edward R. Gonzalez
2026-06-24 10:11:36 -04:00
parent 7d977f4d36
commit f14962e84d
1 changed files with 14 additions and 0 deletions
Download Patch File Download Diff File Expand all files Collapse all files
conductor/tracks/code_path_audit_20260607/spec_v2.md
+14
View File
@@ -633,4 +633,18 @@ The Tier 2 Tech Lead + user review the `docs/reports/code_path_audit/<date>/summ
---
## Revision History
**2026-06-24 — MVP pivot (follow-up: code_path_audit_polish_20260622).** The v2 spec described a 14-phase DSL implementation that never reached production. The actual shipped implementation is:
- **MVP output:** A single `AUDIT_REPORT.md` (6797 lines, 311KB) with `summary.md` as a TOC pointer. Per-aggregate markdowns via `to_markdown` + `to_tree` are produced.
- **DSL deprecated:** The v2 postfix DSL format (`to_dsl_v2` + `parse_dsl_v2`, `DSL_WORD_ARITY_V2`, `_atom`) was implemented but never produced. `run_audit()` writes `.md` files only. The DSL parser carried latent arity bugs (e.g. `DSL_WORD_ARITY_V2["result-coverage"] = 5` but `to_dsl_v2` emits 4 args). Removed in `code_path_audit_polish_20260622` Task 2.2 (commit `b385cd44`).
- **`compute_result_coverage` removed:** The function had a latent bug (`result_producers = total_producers` hardcoded to 100%). `synthesize_aggregate_profile` inlines its own `ResultCoverage(...)` construction. Removed in `code_path_audit_polish_20260622` Task 2.3 (commit `2561e4ea`).
- **Test count:** 125 (was 131 in the v2 spec; -6 tests deleted across polish Tasks 2.2 and 2.3).
- **Audit-gate state:** `audit_weak_types.py --strict` and `generate_type_registry.py --check` now pass (fixed in polish Phase 1). The 2 pre-existing violations (4 exception-handling + 7 Optional[T]) are documented as NG1/NG2 in the polish track's spec and explicitly out of scope.
**No changes** to the v2 spec's overall design intent, the 13 aggregates, the 4-direction decomposition cost, or the cross-audit integration. The MVP pivot is purely about the OUTPUT format (markdown instead of DSL) and code-smell cleanup; the analytical core (PCG, MemoryDim, APD, CFE, cross-audit) is unchanged.
---
**End of spec_v2.md.**