ed
e90167494e
Sub-track 5 of the 5-sub-track result_migration_20260616 umbrella.
Migrates the 3 baseline files (the convention reference) to be 100%
compliant with the data-oriented Result[T] convention. Completes the
campaign.
Scope: 88 migration-target sites across 3 source files (mcp_client.py
46 + ai_client.py 33 + rag_engine.py 9; total 231KB / 5917 lines).
41 sites stay as-is: 4 BOUNDARY_SDK (vendor SDK boundaries in ai_client),
9 INTERNAL_PROGRAMMER_RAISE (5 rag_engine + 4 ai_client, per sub-track 4
Phase 11 dunder-method heuristic), 28 INTERNAL_COMPLIANT.
Per the user directive (2026-06-20), this track uses the same anti-sliming
template as sub-track 4 (which was 'the first to ship without error
correction'). 14 phases cap each phase at <=9 migration sites with
explicit per-phase audit gates. The sliming-prone phases (Phase 8
mcp_client silent-swallow, Phase 11 ai_client silent-swallow, Phase 12
ai_client rethrow) explicitly forbid narrowing+logging and classify-
as-suspicious laundering.
The 14 phases:
0. Setup + styleguide re-read (Tier 2 reads error_handling.md)
1. 3-file inventory + classification (88 sites in 3 inventory docs)
2. Audit gate baseline (3 baseline invariant tests)
3-7. mcp_client Batches A-E (40 broad-catches, 5 batches of <=8 each)
8. mcp_client silent-swallow + UNCLEAR (5 + 1 = 6 sites; anti-sliming)
9-10. ai_client Batches A-B (17 broad-catches, 2 batches)
11. ai_client silent-swallow (9 sites; anti-sliming)
12. ai_client rethrow classification (7 sites; Pattern 1/2/3 or migrate)
13. rag_engine migration (1 SS + 5 BC + 3 RETHROW = 9 sites)
14. Audit gate + end-of-track report (campaign 100% complete)
Anti-sliming protocol per phase (same as sub-track 4):
- Styleguide re-read at start of each phase (commit msg acknowledgment)
- Per-site audit pre-check (capture before migration)
- Red -> Green (1 commit per site)
- Per-site audit post-check (capture after migration)
- Phase invariant test (1 commit per phase)
- 'If a site resists migration: DO NOT invent a heuristic. Report.'
The 3 baseline files are the convention reference; after this track,
the data-oriented Result[T] convention is fully applied to all 65
src/ files.
Files:
- spec.md (263 lines, 11 sections; 22 VCs; 6 risks)
- plan.md (562 lines, 14 phases, 121 tasks, 110+ atomic commits,
anti-sliming protocol identical to sub-track 4)
- metadata.json (22 VCs, 6 risks, scope)
- state.toml (15 phases, 121 tasks, 29 verification entries)
- tracks.md (new row 6d-5 in Active Tracks table)
Total: 5 files, ~2400 lines added (excluding tracks.md).
Next: Tier 2 picks up Phase 0 (setup + styleguide re-read) per the
task list in state.toml. Campaign 100% ready once this track ships.