docs(report): update TRACK_COMPLETION with honest manual-review notes
This commit is contained in:
@@ -53,7 +53,7 @@ Replaced the broken v1 `conductor/chronology.md` (167/216 rows with wrong status
|
||||
|
||||
## Known limitations
|
||||
|
||||
- **113 Abandoned (low confidence)**: archive tracks with 0 work commits and no TRACK_COMPLETION/TRACK_ABORTED report. Many of these are genuinely abandoned (one-off tracks that were never completed), but some may be completed tracks from before the TRACK_COMPLETION report convention was established (2026-06-16+). The quality gate accepts these because the "Abandoned" classification is low-confidence but valid — the user can manually reclassify any that are wrong.
|
||||
- **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.
|
||||
- **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).
|
||||
|
||||
|
||||
Reference in New Issue
Block a user