conductor(followup): post_module_taxonomy_de_cruft_20260627 - track artifacts (5 files, ~900 lines)
TIER-1 READ AGENTS.md + conductor/workflow.md + conductor/edit_workflow.md
+ conductor/code_styleguides/data_oriented_design.md + conductor/code_styleguides/error_handling.md
+ conductor/code_styleguides/type_aliases.md + conductor/code_styleguides/code_path_audit.md
+ conductor/tracks/post_module_taxonomy_de_cruft_20260627/spec.md
+ conductor/tracks/post_module_taxonomy_de_cruft_20260627/plan.md
+ conductor/tracks/module_taxonomy_refactor_20260627/spec.md
+ docs/reports/FOLLOWUP_module_taxonomy_v2_review.md
+ docs/reports/FOLLOWUP_module_taxonomy_refactor_20260627_recoverable.md
before this commit.
This is a followup TRACK (not a report) to module_taxonomy_refactor_20260627.
After the taxonomy is settled, clean up the remaining cruft that v2 was
explicitly out-of-scope for.
Two critical bugs from v2 must be fixed first:
1. NameError: LEGACY_NAMES in scripts/generate_type_registry.py
(Tier 2 introduced this bug)
2. Missing docs/reports/code_path_audit/latest symlink
(required by audit_code_path_audit_coverage.py)
Then 4 de-cruft tasks:
1. Remove the __getattr__ shim from src/models.py
(30+ consumer sites migrate to direct imports)
2. Move DEFAULT_TOOL_CATEGORIES to src/ai_client.py
3. Move Pydantic proxies to src/api_hooks.py
4. Standardize ImGui usage in markdown_helper.py, theme_2.py,
theme_nerv.py, theme_nerv_fx.py to use imgui_scopes.py context managers
13 VCs:
- VC1: generate_type_registry.py --check exits 0 (LEGACY_NAMES fix)
- VC2: audit_code_path_audit_coverage.py exits 0 (latest symlink)
- VC3: All 7 audit gates pass --strict
- VC4: 10/11 batched test tiers pass (RAG flake acceptable)
- VC5: __getattr__ shim removed from src/models.py
- VC6: DEFAULT_TOOL_CATEGORIES moved to src/ai_client.py
- VC7: Pydantic proxies moved to src/api_hooks.py
- VC8: ImGui usage standardized in markdown_helper.py, theme_*.py
- VC9: src/models.py reduced to <= 20 lines
- VC10: All consumer sites updated to direct imports
- VC11: v2 spec updated to reflect VC2 + VC10 corrections
- VC12: All 7 audit gates pass --strict (re-verify)
- VC13: 10/11 batched test tiers pass (re-verify)
6 phases, 14 tasks, ~12 atomic commits.
Phase 0: fix critical bugs (Tier 3, 2 commits)
Phase 1: update v2 spec (Tier 1, 1 commit)
Phase 2: remove __getattr__ shim (Tier 3, 1-2 commits)
Phase 3: move DEFAULT_TOOL_CATEGORIES (Tier 3, 1 commit)
Phase 4: move Pydantic proxies (Tier 3, 1 commit)
Phase 5: standardize ImGui usage (Tier 3, 4 commits: 1 per file)
Phase 6: verification + end-of-track report (Tier 2, 1-2 commits)
The v2 spec update in Phase 1 is the explicit acceptance of the
trade-offs the user agreed to: patch_modal.py is a data module (not
a LEAK); 162-line models.py is the backward-compat trade-off (the
30-line target was unrealistic for 30+ legacy imports).
blocked_by: module_taxonomy_refactor_20260627 (shipped; this is the
followup)
ed
05647d94b5