docs(report): update quality + completion reports with honest Needs Review status for 43 ambiguous archive tracks

This commit is contained in:
ed
2026-07-02 08:25:12 -04:00
parent 792dd7d430
commit 2d5ce12c7b
2 changed files with 33 additions and 68 deletions
@@ -53,7 +53,7 @@ Replaced the broken v1 `conductor/chronology.md` (167/216 rows with wrong status
## Known limitations
- **113→43 Abandoned (low confidence)**: initially 113 archive tracks were wrongly marked Abandoned because the classifier wasn't reading `state.toml` status as an override and wasn't detecting plan-progression/"mark as completed" commit patterns. After manual review and 3 classifier fixes (state.toml override, `_parse_state_status` quote-stripping bug, plan-progression + "mark as completed" heuristics), 70 of those were reclassified to Completed. The remaining 43 are genuinely ambiguous archive tracks with no state.toml, no report, and no evidence of completion — they may be completed tracks from early 2026 where the work was done in `src/` files. The user can manually reclassify any that are known to be completed.
- **43 Needs Review (low confidence)**: archive tracks with no state.toml, no report, and no evidence of completion on the track folder. Manual spot-checking confirmed several are actually completed features in the codebase (e.g., `kill_abort_workers``kill_worker()` exists in `multi_agent_conductor.py`; `tool_bias_tuning``src/tool_bias.py` exists; `workspace_profiles``src/workspace_manager.py` exists). The classifier cannot detect these because the work commits touched `src/` files, not the track folder. These 43 require manual review by the user to reclassify as Completed or Abandoned.
- **Generator speed**: the `walk_track_folders` function makes 1-2 `git log` subprocess calls per folder (244 folders × ~1.5 calls = ~366 subprocess calls). This takes ~60-120 seconds. The `--rows-json` option on the quality gate allows fast re-verification without re-walking.
- **The `--draft` flag** on the generator is a legacy name; it outputs the markdown table (the canonical output). The non-`--draft` mode outputs JSON (useful for piping to the quality gate).