# Project Tracks

This file tracks all major tracks for the project. Each track has its own detailed plan in its respective folder (or in `../archive/<track_name>/` for completed tracks).

**Structure:**
- **Active Tracks (Current Queue):** In-flight and unblocked work the implementer can pick up today.
- **Phase 0 - 9 (Chronological):** The full project history in chronological order. Each phase has three sub-sections: **Active** (work in progress), **Completed** (work shipped but track not yet archived), **Archived** (track folder moved to `archive/`).

Archive directories live at `../archive/<track_name>/` (from this file's location at `conductor/tracks.md`); the `./archive/...` links in this file are relative to that location and resolve correctly.

---

## Active Tracks (Current Queue)

Tracks that are unblocked and ready to start. Ordered by **dependency** (blocked-by first) and **priority** (A foundational → D forward-looking).

| # | Priority | Track | Status | Blocked By |
|---|---|---|---|---|
| 2 | A | [Qwen, Llama & Grok Vendor Integration + Capability Matrix](#track-qwen-llama-grok-vendor-integration--capability-matrix) | spec ✓, plan ✓, 50/79 tasks done; **Phase 6 in progress (docs); NOT archiving — has follow-up track** | **test_infrastructure_hardening_20260609 (merged)** |
| 3 | A | [Data-Oriented Error Handling (Fleury Pattern)](#track-data-oriented-error-handling-fleury-pattern) | spec ✓, plan ✓, ready to start | startup_speedup, test_batching_refactor, **test_infrastructure_hardening_20260609 (merged)**, qwen_llama_grok |
| 4 | A | [Data Structure Strengthening (Type Aliases + NamedTuples)](#track-data-structure-strengthening-type-aliases--namedtuples) | spec ✓, plan pending | **test_infrastructure_hardening_20260609 (merged)** |
| 5 | A | [MCP Architecture Refactor (Sub-MCP Extraction)](#track-mcp-architecture-refactor-sub-mcp-extraction) | spec ✓, plan pending | test_infrastructure_hardening_20260609 (merged), data_oriented_error_handling, data_structure_strengthening |
| 6 | D | [Public API Result Migration](#track-public-api-result-migration-followup) | placeholder; not yet specced | data_oriented_error_handling (deprecated `send()`) |
| 7 | — | [UI Polish (Five Issues)](#track-ui-polish-five-issues) | spec ✓, plan ✓, ready to start | (none — independent) |
| 7a | B | [SQLite-Granularity Inline Docs for gui_2.py](#track-sqlite-granularity-inline-docs-for-gui_2py) | spec ✓, plan ✓, complete | (none — independent) |
| 7b | B | [Continued SQLite-Granularity Inline Docs for gui_2.py](#track-continued-sqlite-granularity-inline-docs-for-gui_2py) | spec ✓, plan ✓, complete | (none — independent) |
| 7c | B | [SQLite-Granularity Inline Docs for ai_client.py](#track-sqlite-granularity-inline-docs-for-ai_clientpy) | spec ✓, plan ✓, ready to start | (none — independent) |
| 8 | — | [Bootstrap gencpp Python Bindings](#track-bootstrap-gencpp-python-bindings) | spec TBD | (none — independent) |
| 9 | — | [Tree-Sitter Lua MCP Tools](#track-tree-sitter-lua-mcp-tools) | spec TBD | (none — independent) |
| 10 | — | [GDScript Language Support Tools](#track-gdscript-language-support-tools) | spec TBD | (none — independent) |
| 11 | — | [C# Language Support Tools](#track-c-language-support-tools) | spec TBD | (none — independent) |
| 12 | — | [OpenAI Provider Integration](#track-openai-provider-integration) | spec TBD | (none — independent) |
| 13 | — | [Zhipu AI (GLM) Provider Integration](#track-zhipu-ai-glm-provider-integration) | spec TBD | (none — independent) |
| 14 | — | [AI Provider Caching Optimization](#track-ai-provider-caching-optimization) | spec TBD | (none — independent) |
| 15 | — | [Manual UX Validation & Review](#track-manual-ux-validation--review) | spec TBD | (none — independent) |
| 15a | — | [Manual UX Validation — ASCII-Sketch Workflow](#track-manual-ux-validation--ascii-sketch-workflow-new-2026-06-08) | spec ✓, plan ✓, ready to start | (none — independent; NEW 2026-06-08) |
| 15b | — | [Chunkification Optimization (Contingency)](#track-chunkification-optimization-new-2026-06-08-contingency) | spec ✓ (contingency), no plan | hard constraint surface (deferred) |
| 16 | — | [GenCpp Dogfood Feedback Loop](#track-gencpp-dogfood-feedback-loop) | spec TBD | (none — independent; oldest pending track) |
| 17 | — | [Code Path Audit](#track-code-path-audit) | spec TBD | test_infrastructure_hardening_20260609 (merged) |
| 23 | A (research) | [Intent-Based Scripting Languages Survey](#track-intent-based-scripting-languages-survey-new-2026-06-12) | spec ✓, plan pending | (none — independent; NEW 2026-06-12; **non-impl research track**, **time-sensitive: report must complete before nagent v2.2**) |
| 24 | A (bugfix) | [AI Loop Regressions (MiniMax, Gemini, Gemini CLI, DeepSeek)](#track-ai-loop-regressions-minimax-gemini-gemini-cli-deepseek-new-2026-06-14) | spec ✓, plan ✓, shipped 2026-06-15 (with 1 critical `_api_generate` regression + 2 deferred bugs — see `doeh_test_thinking_cleanup_20260615`) | (none — independent; **NEW 2026-06-14**; user-blocking; 3 bugs from `data_oriented_error_handling_20260606`) |
| 18 | — | [GUI Architecture Refinement](#track-gui-architecture-refinement) | (no spec.md) | (TBD) |
| 19 | — | [Context First Message Fix](#track-context-first-message-fix) | spec TBD | (none — independent) |
| ~~19~~ | — | ~~[Fix Remaining Tests](#track-fix-remaining-tests)~~ | ~~SUPERSEDED by track 1~~ | — |
| ~~20~~ | — | ~~[Test Harness Hardening](#track-test-harness-hardening)~~ | ~~SUPERSEDED by track 1~~ | — |
| ~~21~~ | — | ~~[Test Patch Fixes](#track-test-patch-fixes)~~ | ~~SUPERSEDED by track 1~~ | — |
| ~~22~~ | — | ~~[Test Batching Post-Refactor Polish](#track-test-batching-post-refactor-polish)~~ | ~~SUPERSEDED by track 1 (FR1 + FR2)~~ | — |
| 20 | — | [Prior Session Test Harden (20260605)](#track-prior-session-test-harden-20260605-superseded) | superseded; no action needed | — |

**Note on numbering:** the legacy file used `0a`, `0b`, `0c`... and `0d`, `0e`, `0f`, `0g` for tracks created 2026-06-06+. This is the **git-blame sort order**, not a logical execution order. The new structure re-orders by dependency.

---

## Phase 0: Infrastructure (Critical)

*Initialized: 2026-02 (project foundation)*

### Completed

- [x] **Track: Conductor Path Configuration**
  *Note: One-line entry; full details in [./tracks/conductor_path_configurable_20260306/](./tracks/conductor_path_configurable_20260306/) (still in `tracks/`; not yet archived).*

---

## Phase 1: Pre-Track Foundation (2026-02 - 2026-03)

*No tracks were added under explicit Phase 1; this section is reserved for the early architectural groundwork that preceded the formal track system.*

### Completed

- [x] Various one-off refactors; full details in `conductor/archive/` by track name prefix.

---

## Phase 2: Strict Execution Queue

*Completed 2026-03-06*

### Completed

- [x] **Track: Strict Execution Queue (Phase 2)**
  *See: [./archive/strict_execution_queue_completed_20260306/](./archive/strict_execution_queue_completed_20260306/)*

---

## Phase 3 - Phase 4: Foundational Tracks (March 2026)

*Multiple sub-tracks under the initial feature-development push. All archived.*

### Archived

Tracks 1 - 29 of the original Phase 4 archive (preserved with original numbers for cross-reference continuity):

1. [x] ~~**Track: Session Context Snapshots & Visibility**~~ (Archived 2026-03-22 - Replaced by discussion_hub_panel_reorganization)
   *Link: [./archive/session_context_snapshots_20260311/](./archive/session_context_snapshots_20260311/)*

2. [x] ~~**Track: Discussion Takes & Timeline Branching**~~ (Archived 2026-03-22 - Replaced by discussion_hub_panel_reorganization)
   *Link: [./archive/discussion_takes_branching_20260311/](./archive/discussion_takes_branching_20260311/)*

3. [x] **Track: RAG Support**
   *Link: [./archive/rag_support_20260308/](./archive/rag_support_20260308/)*

4. [x] **Track: Agent Tool Preference & Bias Tuning**
   *Link: [./archive/tool_bias_tuning_20260308/](./archive/tool_bias_tuning_20260308/)*

5. [x] **Track: Expanded Hook API & Headless Orchestration**
   *Link: [./archive/hook_api_expansion_20260308/](./archive/hook_api_expansion_20260308/)*

6. [x] **Track: Codebase Audit and Cleanup**
   *Link: [./archive/codebase_audit_20260308/](./archive/codebase_audit_20260308/)*

7. [x] **Track: Expanded Test Coverage and Stress Testing**
   *Link: [./archive/test_coverage_expansion_20260309/](./archive/test_coverage_expansion_20260309/)*

8. [x] **Track: Beads Mode Integration**
   *Link: [./archive/beads_mode_20260309/](./archive/beads_mode_20260309/)*

9. [x] **Track: Optimization pass for Data-Oriented Python heuristics**
   *Link: [./archive/data_oriented_optimization_20260312/](./archive/data_oriented_optimization_20260312/)*

10. [x] **Track: Rich Thinking Trace Handling**
    *Link: [./archive/thinking_trace_handling_20260313/](./archive/thinking_trace_handling_20260313/)*

11. [x] **Track: Smarter Aggregation with Sub-Agent Summarization**
    *Link: [./archive/aggregation_smarter_summaries_20260322/](./archive/aggregation_smarter_summaries_20260322/)*

12. [x] **Track: System Context Exposure**
    *Link: [./archive/system_context_exposure_20260322/](./archive/system_context_exposure_20260322/)*

13. [x] **Track: Advanced Log Management and Session Restoration**
    *Link: [./archive/log_session_overhaul_20260308/](./archive/log_session_overhaul_20260308/)*

14. [x] **Track: UI Theme Overhaul & Style System**
    *Link: [./archive/ui_theme_overhaul_20260308/](./archive/ui_theme_overhaul_20260308/)*

15. [x] **Track: Selectable GUI Text & UX Improvements**
    *Link: [./archive/selectable_ui_text_20260308/](./archive/selectable_ui_text_20260308/)*

16. [x] **Track: Markdown Support & Syntax Highlighting**
    *Link: [./archive/markdown_highlighting_20260308/](./archive/markdown_highlighting_20260308/)*

17. [x] **Track: Custom Shader and Window Frame Support**
    *Link: [./archive/custom_shaders_20260309/](./archive/custom_shaders_20260309/)*

18. [x] **Track: UI/UX Improvements - Presets and AI Settings**
    *Link: [./archive/presets_ai_settings_ux_20260311/](./archive/presets_ai_settings_ux_20260311/)*

19. [x] **Track: Discussion Hub Panel Reorganization**
    *Link: [./archive/discussion_hub_panel_reorganization_20260322/](./archive/discussion_hub_panel_reorganization_20260322/)*

20. [x] **Track: Undo/Redo History Support**
    *Link: [./archive/undo_redo_history_20260311/](./archive/undo_redo_history_20260311/)*

21. [x] **Track: Advanced Text Viewer with Syntax Highlighting**
    *Link: [./archive/text_viewer_rich_rendering_20260313/](./archive/text_viewer_rich_rendering_20260313/)*

22. [x] **Track: Tree-Sitter C/C++ MCP Tools**
    *Link: [./archive/ts_cpp_tree_sitter_20260308/](./archive/ts_cpp_tree_sitter_20260308/)*

23. [x] **Track: Saved System Prompt Presets**
    *Link: [./archive/saved_presets_20260308/](./archive/saved_presets_20260308/)*

24. [x] **Track: Saved Tool Presets**
    *Link: [./archive/saved_tool_presets_20260308/](./archive/saved_tool_presets_20260308/)*

25. [x] **Track: External Text Editor Integration for Approvals**
    *Link: [./archive/external_editor_integration_20260308/](./archive/external_editor_integration_20260308/)*

26. [x] **Track: Agent Personas: Unified Profiles & Tool Presets**
    *Link: [./archive/agent_personas_20260309/](./archive/agent_personas_20260309/)*

27. [x] **Track: Advanced Workspace Docking & Layout Profiles**
    *Link: [./archive/workspace_profiles_20260310/](./archive/workspace_profiles_20260310/)*

28. [x] **Track: Review investigation of codebase and expose/cull any hidden invisible prompting**
    *Link: [./archive/cull_hidden_prompts_20260502/](./archive/cull_hidden_prompts_20260502/)*

29. [x] **Track: Test Regression Verification**
    *Link: [./archive/test_regression_verification_20260307/](./archive/test_regression_verification_20260307/)*

---

## Phase 5: Codebase Curation

*Initialized: 2026-05-07*

### Completed (all archived)

#### Analysis & Structural Review

1. [x] **Track: Comprehensive Path Mapping & Tooling**
   *Link: [./archive/ai_interaction_call_graph_20260507/](./archive/ai_interaction_call_graph_20260507/)*
   *Goal: Automated and manual derivation of all major code paths and pipelines in the system.*

2. [x] **Track: Controller State Mutation Matrix**
   *Link: [./archive/controller_state_mutation_matrix_20260507/](./archive/controller_state_mutation_matrix_20260507/)*
   *Goal: Comprehensive map of all methods that modify the `AppController` and `App` state.*

3. [x] **Track: Source-Wide Redundancy Audit**
   *Link: [./archive/source_wide_redundancy_audit_20260507/](./archive/source_wide_redundancy_audit_20260507/)*
   *Goal: Deep file-by-file audit to identify unused methods, duplicate logic, and dead code.*

4. [x] **Track: Curate Provider Registries**
   *Link: [./archive/curate_provider_registries_20260507/](./archive/curate_provider_registries_20260507/)*
   *Goal: Move the PROVIDERS list to models.py and update all references to use this single source of truth.*

5. [x] **Track: Encapsulate AppController Status**
   *Link: [./archive/encapsulate_appcontroller_status_20260507/](./archive/encapsulate_appcontroller_status_20260507/)*
   *Goal: Convert ai_status and mma_status to properties with thread-safe setters.*

6. [x] **Track: Decouple GUI Log Loading**
   *Link: [./archive/decouple_gui_log_loading_20260507/](./archive/decouple_gui_log_loading_20260507/)*
   *Goal: Move Tkinter directory selection out of AppController and into gui_2.py.*

7. [x] **Track: Refactor Context Aggregation Pipeline**
   *Link: [./archive/refactor_context_aggregation_pipeline_20260507/](./archive/refactor_context_aggregation_pipeline_20260507/)*
   *Goal: Modernize src/aggregate.py and consolidate legacy tier builders.*

8. [x] **Track: Cull Unused Symbols**
   *Link: [./archive/cull_unused_symbols_20260507/](./archive/cull_unused_symbols_20260507/)*
   *Goal: Safely remove the 27 dead symbols identified in the redundancy audit.*

9. [x] **Track: Structural Dependency Mapping (SDM) Docstrings**
   *Link: [./archive/sdm_docstrings_20260509/](./archive/sdm_docstrings_20260509/)*

10. [x] **Track: AppController Curation & Structural Alignment**
    *Link: [./archive/app_controller_curation_20260513/](./archive/app_controller_curation_20260513/)*
    *Goal: Curate src/app_controller.py to match gui_2.py organization and enforce Python style conventions.*

11. [x] **Track: Fix 45 failing test files across 12 batches**
    *Link: [./archive/fix_test_suite_failures_20260514/](./archive/fix_test_suite_failures_20260514/)*

12. [x] **Track: Fix Indentation 1-Space Convention**
    *Link: [./archive/fix_indentation_1space_20260516/](./archive/fix_indentation_1space_20260516/)*
    *Goal: Standardize all Python files to 1-space indentation per AI-Optimized Python Style Guide. Audit and correct indentation in src/, tests/, scripts/, and conductor/ directories.*

---

## Phase 6: Context Composition Redesign

*Initialized: 2026-05-10*

### Completed (all archived)

#### Context Control & Workflow Enhancements

1. [x] **Track: Granular AST Control (Signatures vs. Definitions)**
   *Link: [./archive/granular_ast_control_20260510/](./archive/granular_ast_control_20260510/)*
   *Goal: Introduce 'AST Signatures' and 'AST Definitions' states in the Context Panel for C/C++ files.*

2. [x] **Track: Context Snapshotting per "Take"**
   *Link: [./archive/context_snapshotting_takes_20260510/](./archive/context_snapshotting_takes_20260510/)*
   *Goal: Snapshot and visually restore the Context Panel state when switching between Takes.*

3. [x] **Track: Interactive Text Slice Highlighting**
   *Link: [./archive/interactive_text_slice_highlighting_20260510/](./archive/interactive_text_slice_highlighting_20260510/)*
   *Goal: Allow highlighting text ranges to create fuzzy-anchored slices (Def, Sig, Hide) that survive file modifications.*

4. [x] **Track: Context Batch Operations UX**
   *Link: [./archive/context_batch_operations_ux_20260510/](./archive/context_batch_operations_ux_20260510/)*
   *Goal: Add multi-select and batch state modification capabilities to the Context Panel for rapid wrangling.*

5. [x] **Track: GenCpp Project Initialization**
   *Link: [./archive/gencpp_project_init_20260510/](./archive/gencpp_project_init_20260510/)*
   *Goal: Configure manual_slop.toml in the gencpp repo to isolate conductor tracks, logs, and history.*

6. [x] **Track: Interactive AST Tree Masking**
   *Link: [./archive/interactive_ast_tree_masking_20260510/](./archive/interactive_ast_tree_masking_20260510/)*
   *Goal: Inspect C/C++ ASTs in the GUI and mask individual classes/functions as Def, Sig, or Hide.*

7. [x] **Track: Phase 6 Review and Regression Verification**
   *Link: [./archive/phase6_review_20260510/](./archive/phase6_review_20260510/)*
   *Goal: Review Phase 6 implementation, perform full-suite batch regression testing, and expand test coverage for new context curation features.*

9. [x] **Track: Context Composition Decoupling**
   *Link: [./archive/context_comp_decouple_20260510/](./archive/context_comp_decouple_20260510/)*
   *Goal: Decouple Files & Media from Context Composition, add directory grouping, file stats, and view mode selection per file.*

10. [x] **Track: Context Composition Slice Visualization**
    *Link: [./archive/context_comp_slices_20260510/](./archive/context_comp_slices_20260510/)*
    *Goal: Enhance slice visualization with visual editor, annotation support (tags/comments), and view presets.*

11. [x] **Track: GUI Refactor & Stabilization**
    *Link: [./archive/gui_refactor_stabilization_20260512/](./archive/gui_refactor_stabilization_20260512/)*
    *Goal: Refactor gui_2.py to fix regressions and enforce better imgui scoping patterns.*

12. [x] **Track: GUI 2 Large Cleanup** (originally listed as "I started to do a large cleanup to ./src/gui_2.py..." — the long user message was the track description)
    *Link: [./archive/gui_2_cleanup_20260513/](./archive/gui_2_cleanup_20260513/)*
    *Goal: Study gui_2.py and derive more information on how to maintain and write code for the Python codebase. Update product guidelines or the python code_styleguidelines based on what is discovered. May also need changes to the mcp_tools for better structural awareness of annotations or other conventions with these python files.*

13. [x] **Track: Add Python structural MCP tools (py_remove_def, py_add_def, py_move_def, py_region_wrap)**
    *Link: [./archive/python_structural_mcp_tools_20260513/](./archive/python_structural_mcp_tools_20260513/)*

14. [~] **Track: Context Preview & Slice Editor Fixes**
    *Link: [./tracks/context_preview_fixes_20260516/](./tracks/context_preview_fixes_20260516/)*
    *Goal: Fix Preview button generating empty content, and Inspect/Slices buttons failing to open their respective editor panels.*
    *Status: in progress; track folder still in `tracks/` (not yet archived).*

### Active

8. [ ] **Track: GenCpp Dogfood Feedback Loop**
   *Link: [./tracks/gencpp_dogfood_feedback_20260510/](./tracks/gencpp_dogfood_feedback_20260510/)*
   *Goal: Verify Manual Slop can target gencpp at C:/projects/gencpp and establish a feedback mechanism for issues found during dogfooding.*
   *Status: oldest pending track (2026-05-10). Track folder still in `tracks/`.*

---

## Hot Reload Feature (2026-05-16)

*Single-track feature, not part of a numbered Phase.*

### Archived

1. [x] **Track: Hot Reload Python Codebase (Phase 2)**
   *Link: [./archive/hot_reload_python_20260516/](./archive/hot_reload_python_20260516/)*
   *Goal: Implement selective, state-preserving hot-reload for src/gui_2.py with delegation pattern refactor, manual trigger via Ctrl+Alt+R and GUI button, and visual error tint feedback on failure.*

---

## Phase 7: Stabilization & Polishing (2026-05-13 to 2026-06-02)

*Two archival phases under the same "Phase 7" umbrella. Both completed; tracks moved to `archive/`.*

### Archived

- [x] **Track: Phase 7 Stabilization and Polishing (Regressions Fix)**
  *Link: [./archive/phase7_stabilization_and_polishing_20260601/](./archive/phase7_stabilization_and_polishing_20260601/)*

- [x] **Track: Phase 7 Monolithic Stabilization (Final Cleanup)**
  *Link: [./archive/phase7_monolithic_stabilization_20260602/](./archive/phase7_monolithic_stabilization_20260602/)*

---

## Late May 2026 - Early June 2026: One-Off Fixes and Polish

*One-off bug fixes and UX polish that landed in the days leading up to the major track work. All archived.*

### Archived

- [x] **Track: Robust Live Simulation Verification**

- [x] **Track: Fix GUI Crashes in Tool Preset Manager and Discussion Hub**
  *Link: [./archive/gui_crash_fixes_20260531/](./archive/gui_crash_fixes_20260531/)*

- [x] **Track: Fix `keys_down` AttributeError in ImGui IO**
  *Link: [./archive/fix_imgui_keys_down_20260601/](./archive/fix_imgui_keys_down_20260601/)*

- [x] **Track: Selectable Thinking Monologs**
  *Link: [./archive/selectable_thinking_monologs_20260601/](./archive/selectable_thinking_monologs_20260601/)*

- [x] **Track: Fix MiniMax history sequencing and truncation**
  *Link: [./archive/minimax_history_fix_20260601/](./archive/minimax_history_fix_20260601/)*

- [x] **Track: Preserve context selection on discussion switch and add empty context warning**
  *Link: [./archive/context_preservation_and_warnings_20260601/](./archive/context_preservation_and_warnings_20260601/)*

- [x] **Track: Fix Text Viewer docking conflicts and Tool Call row click interactivity**
  *Link: [./archive/text_viewer_and_tool_call_fixes_20260601/](./archive/text_viewer_and_tool_call_fixes_20260601/)*

- [x] **Track: UX Refinements for Context Composition and Discussion Entries**
  *Link: [./archive/context_composition_ux_20260601/](./archive/context_composition_ux_20260601/)*

- [x] **Track: Combine AST Inspector and Slices Editor into a unified Structural File Editor**
  *Link: [./archive/structural_file_editor_20260601/](./archive/structural_file_editor_20260601/)*

- [x] **Track: Add per-response token metrics and AI-assisted history compression**
  *Link: [./archive/discussion_metrics_and_compression_20260601/](./archive/discussion_metrics_and_compression_20260601/)*

- [x] **Track: Fix Approve Modal sizing and inline full preview**
  *Link: [./archive/approve_modal_ux_20260601/](./archive/approve_modal_ux_20260601/)*

- [x] **Track: Implement Async Context Preview to fix UI hangs and add an 'Everything' Command Palette.**
  *Link: [./archive/command_palette_and_performance_20260602/](./archive/command_palette_and_performance_20260602/)*
  *Goal: Async context preview offload (background thread, state lock) + Command Palette (32 commands, fuzzy search, Ctrl+Shift+P, Up/Down/Enter nav, 13 unit + 7 live_gui tests). Phases 1-3 complete.*

- [x] **Track: Comprehensive Documentation Refresh**
  *Link: [./archive/documentation_refresh_comprehensive_20260602/](./archive/documentation_refresh_comprehensive_20260602/)*
  *Goal: Refresh stale documentation across `docs/`. Completed: ASCII file tree updates (`docs/Readme.md` + `Readme.md` 5→14 guides, 22→53 src modules), `docs/guide_testing.md` (new, comprehensive 251-file test suite reference), 7 per-source-file guides (`guide_gui_2.md`, `guide_ai_client.md`, `guide_api_hooks.md`, `guide_mcp_client.md`, `guide_app_controller.md`, `guide_multi_agent_conductor.md`, `guide_models.md`). All 14 guides cross-linked. Gap analysis: [./archive/documentation_refresh_comprehensive_20260602/gap_analysis.md](./archive/documentation_refresh_comprehensive_20260602/gap_analysis.md).*

  Sub-tracks (all checkpointed):
  - [x] **Sub-Track 1: Docs Layer Refresh** `[checkpoint: 20225c8]` — 18 per-file atomic commits. 15 guides (8 refreshed + 7 new), Subsystem Index (24 entries), 106 cross-links all resolve, symbol parity fixed (`apply_nerv_theme` -> `apply_nerv`).
  - [x] **Sub-Track 2: Conductor Docs Refresh** `[checkpoint: ef4efab2]` — 4 per-file atomic commits: `product.md` (14 guides, MiniMax, Command Palette), `tech-stack.md` (MiniMax, Gemini Embedding 001), `workflow.md` (2026-06-02 doc refresh, 45-tool count), `index.md` (active track links).
  - [x] **Sub-Track 3: Agent Config Refresh** `[checkpoint: 87f668a6]` — 3 per-file atomic commits: `AGENTS.md` (5.4K -> 0.7K thin pointer), `CLAUDE.md` (6.7K -> 0.2K deprecation stub), `GEMINI.md` (5 providers, sloppy.py entry, 12 key modules). Drift check: 0 issues in 9 mirrored skill files.

- [x] **Track: Test Consolidation & TOML Sandboxing** `[checkpoint: cb91006c]`
  *Spec: [./../../docs/superpowers/specs/2026-06-02-test-consolidation-design.md](./../../docs/superpowers/specs/2026-06-02-test-consolidation-design.md), Plan: [./../../docs/superpowers/plans/2026-06-02-test-consolidation.md](./../../docs/superpowers/plans/2026-06-02-test-consolidation.md)*
  *Goal: Audit tests for real-TOML usage, migrate offenders to sandboxed patterns. Added `scripts/check_test_toml_paths.py` audit script (CI gate). Migrated `test_mcp_client_whitelist_enforcement` to `tmp_path` (was the only offender). Skipped redundant `enforce_no_real_toml` fixture — existing `isolate_workspace` autouse + audit script provide equivalent coverage.*

---

## Phase 8: UI Polish (2026-06-03)

*Initialized: 2026-06-03*

User review surfaced five outstanding UI issues, each previously attempted without success. This track addresses them as five independent phases with their own TDD cycles and atomic commits.

### Active

1. [ ] **Track: UI Polish (Five Issues)**
   *Spec: [./../../docs/superpowers/specs/2026-06-03-ui-polish-design.md](./../../docs/superpowers/specs/2026-06-03-ui-polish-design.md)*
   *Plan: [./../../docs/superpowers/plans/2026-06-03-ui-polish.md](./../../docs/superpowers/plans/2026-06-03-ui-polish.md)*
   *Goal: Resolve five long-standing UI issues:
   - Phase 1: GFM markdown table rendering (pre-processor into `src/markdown_table.py`, wire into `MarkdownRenderer.render`).
   - Phase 2: Widen the `Keep Pairs` numeric input next to `Truncate` in the discussion panel (`gui_2.py:3829`, width 80 -> 140, switch to `drag_int`).
   - Phase 3: Fix `Refresh Registry` button in Log Management — currently instantiates `LogRegistry` without calling `load_registry()` so the displayed table never reflects on-disk state (`gui_2.py:1675`).
   - Phase 4: Add `Vendor State` tab to Operations Hub — at-a-glance provider/model, context-window utilization, cache hit rate, last error class, vendor quota (new `src/vendor_state.py` aggregator + `controller.vendor_quota` field + `ai_client` wire-up).
   - Phase 5: Files & Media > Files directory-grouped tree (re-use `aggregate.group_files_by_dir`, mirror `render_context_files_table` collapsible-node style).*

### Recently Archived (post-Phase 8)

- [x] **Track: Clean Install Test** `[checkpoint: d14ae3b]`
  *Link: [./tracks/clean_install_test_20260603/](./tracks/clean_install_test_20260603/), Spec: [./../../docs/superpowers/specs/2026-06-02-clean-install-test-design.md](./../../docs/superpowers/specs/2026-06-02-clean-install-test-design.md), Plan: [./../../docs/superpowers/plans/2026-06-02-clean-install-test.md](./../../docs/superpowers/plans/2026-06-02-clean-install-test.md)*
  *Goal: Add opt-in pytest test (`RUN_CLEAN_INSTALL_TEST=1`) that clones the repo to tmp_path, runs `uv sync`, launches `sloppy.py --enable-test-hooks`, verifies Hook API responds. Catches "works on my machine" failures. Added `clean_install` marker to `pyproject.toml`. Created `tests/test_clean_install.py` (114 lines, uses `urllib.request` from stdlib per tech-stack.md dependency minimalism rule - deviation from plan). Skipped by default. Marked with `@pytest.mark.clean_install`.*

- [x] **Track: Fix markdown_helper.py for imgui-bundle >=1.92.801** `[checkpoint: 7a34edf]`
  *Link: [./tracks/markdown_helper_language_api_compat_20260603/](./tracks/markdown_helper_language_api_compat_20260603/)*
  *Goal: First thing the clean install test caught. `ed.TextEditor.LanguageDefinitionId` enum was removed in `imgui-bundle>=1.92.801`. Replaced with version-compat shim helpers `_get_language_id(name)` and `_set_editor_language(editor, lang_obj)` that detect the API at runtime (1.92.5 enum vs 1.92.801+ factory). Also added parallel `_editor_lang_cache` to track current language tag per editor (robust to API name differences like "C++" vs "cpp"). Verified: test passes in opt-in mode (1.92.801), shim still works in local 1.92.5 env, follow-up commit `b306f8f` corrected test URL `/api/mma_status` -> `/api/gui/mma_status` (actual endpoint per `src/api_hooks.py:181`).*

- [x] **Track: Multi-Theme TOML System (Multi-Themes Mod)** `[checkpoint: 38abf231]`
  *Link: [./tracks/multi_themes_20260604/](./tracks/multi_themes_20260604/), Plan: [./../../docs/superpowers/plans/2026-06-04-theme-syntax-modularization.md](./../../docs/superpowers/plans/2026-06-04-theme-syntax-modularization.md)*
  *Goal: TOML-based theming: per-theme file layout (`themes/<name>.toml` global + `<project>/project_themes.toml` overrides), schema (`syntax_palette` + `[colors]` table of `imgui.Col_` snake_case keys), public API (`load_themes_from_disk`, `get_syntax_palette_for_theme`, `apply_syntax_palette`), `MarkdownRenderer` calls `apply_syntax_palette` on init, color-callable convention (`C_LBL()` / `C_VAL()` so theme switches take effect at use site), upstream 4-syntax-palette limit documented in [./../../docs/guide_themes.md](./../../docs/guide_themes.md) (new guide). 8 new theme files shipped. Theme-caused production bug fixed at `src/gui_2.py:3705-3707` (commit `1469ecac`): `DIR_COLORS` dict stored `C_VAL` not `C_VAL()`, so `imgui.text_colored(d_col, ...)` was being passed a function. Fixed by calling the function at the use site.*

- [~] **Track: Test Regression Fixes (post multi-themes ship)** `[checkpoint: d7487af4]`
  *Link: [./tracks/regression_fixes_20260605/](./tracks/regression_fixes_20260605/), Plan: [./../../docs/superpowers/plans/2026-06-05-regression-fixes.md](./../../docs/superpowers/plans/2026-06-05-regression-fixes.md)*
  *Goal: Resolve 21 failing tests surfaced after the multi-themes ship. 11 of 21 fixed across 10 atomic commits: theme regression (`test_gui_progress` C_LBL/C_VAL API change, `38abf231`), pre-existing non-live_gui (`test_gui_phase4` markdown_helper mocks, `df43f158`; `test_view_presets` persona_manager mock, `970f198c`), GUI production bug (`DIR_COLORS` callable, `1469ecac`), live_gui `LogPruner` busy loop (`ac08ee87`), RAG NoneType guard (`c96bdb06`). **Root cause of remaining 10 live_gui failures identified (commit `d7487af4`)**: `imgui.save_ini_settings_to_memory()` at `src/gui_2.py:601` crashes C-level (`0xc0000005`) when called in the first few render frames because ImGui's internal state (Fonts, DisplaySize, Settings) isn't ready. Crash is uncatchable from Python. Fixed with `_ini_capture_ready` flag (defer-not-catch pattern): first call returns `b""` and sets the flag, subsequent calls invoke the C function. Bisect anchors: `7df65dff` (pre-existing failures start), `7ea52cbb` (theme-caused failures start). Deferred follow-up track needed for ~5 remaining live_gui tests (MMA engine state transitions, RAG status timing, one test needing substantial render path mocks).*

- [x] **Track: Live-GUI Fragility Fixes (post regression_fixes ship)** `[checkpoint: 1488e715]` [superseded by live_gui_test_hardening_v2]
  *Link: Plan: [./../../docs/superpowers/plans/2026-06-05-live-gui-fragility-fixes.md](./../../docs/superpowers/plans/2026-06-05-live-gui-fragility-fixes.md), Spec: [./../../docs/superpowers/specs/2026-06-05-live-gui-fragility-fixes-design.md](./../../docs/superpowers/specs/2026-06-05-live-gui-fragility-fixes-design.md)*
  *Goal: Resolve the 3 remaining live_gui failures (269/272 → 271/272 plus 1 new regression unit test). 1-line src fix in `_capture_workspace_profile` (change `ini=b""` to `ini=""` to satisfy `WorkspaceProfile.ini_content: str` contract that `tomli_w` enforces); the `b""` sentinel was a regression from `d7487af4` that caused `save_workspace_profile` to raise `TypeError`, profile never saved, `load_workspace_profile` became a no-op. 1 new unit test (`tests/test_workspace_profile_serialization.py`) encoding the str/bytes contract. `test_prior_session_no_pop_imbalance` is **deferred to a separate follow-up track** — the test was more under-mocked than the spec assumed; fixing imscope.window tuple-return only revealed the next un-mocked dependency (imgui.begin returning bool where 2-tuple expected at line 4496). `render_main_interface` is a kitchen-sink function requiring 50+ mocks; a follow-up track will either add the missing mocks or refactor the test to exercise a narrow prior-session render path. Change 4 (doc hardening of defer-not-catch sections) deferred to track end; not done due to scope focus.*

- [x] **Track: Live-GUI Test Hardening v2 (post v1 ship)** `[complete: 26e0ced4]`
  *Note: No standalone track directory was created; the v2 work was completed as commit 26e0ced4 within the live_gui_fragility_fixes_20260605 lineage. The "v1" track directory [./archive/hot_reload_python_20260516/](./archive/hot_reload_python_20260516/) is unrelated; this is a logical successor track with no folder of its own.*
  *Goal: Resolve the 4 remaining live_gui failures (was 3 in v1; 1 new regression). v1 fixed the str/bytes sentinel bug but exposed a deeper issue. Decomposed into 4 sub-tracks, 3 active:*
  *Sub-track 1: live_gui_state_sync_20260605 - Spec: [./../../docs/superpowers/specs/2026-06-05-live-gui-state-sync-design.md](./../../docs/superpowers/specs/2026-06-05-live-gui-state-sync.md), Plan: [./../../docs/superpowers/plans/2026-06-05-live-gui-state-sync.md](./../../docs/superpowers/plans/2026-06-05-live-gui-state-sync.md). **REAL root cause was bad indentation in src/gui_2.py:607** (user fixed). The App class had _capture_workspace_profile being parsed as nested inside _apply_snapshot due to indentation. Once fixed, 3 tests (test_auto_switch_sim, test_workspace_profiles_restoration, test_undo_redo_lifecycle) immediately passed. App/Controller state sync is already correctly handled by __getattr__/__setattr__ at lines 478-487.*
  *Sub-track 2: prior_session_test_harden_20260605 - Spec: [./../../docs/superpowers/specs/2026-06-05-prior-session-test-harden-design.md](./../../docs/superpowers/specs/2026-06-05-prior-session-test-harden.md), Plan: [./../../docs/superpowers/plans/2026-06-05-prior-session-test-harden.md](./../../docs/superpowers/plans/2026-06-05-prior-session-test-harden.md). Test refactored to call narrow render_prior_session_view (50+ mocks -> 20, runtime 5.79s -> 0.08s). Commit 26e0ced4.*
  *Sub-track 3: wait_for_ready_test_pattern_20260605 - **SKIPPED**. Tests already pass without polling. The flake hypothesis (time.sleep not enough) was wrong; the real cause was the indent. Polling can be a follow-up hardening pass if tests become flaky in CI.*
  *Sub-track 4: undo_redo_lifecycle_fix_20260605 - **RESOLVED by Sub-track 1 indent fix**. test_undo_redo_lifecycle now passes; no separate investigation needed.*
  *Net result: 4 originally-failing live_gui tests all pass. User can run the full batched suite to confirm.*

---

## Phase 6+ (Active Sprint): Performance, Vendor Coverage, Error Handling, MCP Refactor (2026-06-06+)

*Initialized: 2026-06-06 — the current major sprint. Four foundational tracks launched in this sprint, plus one follow-up. **As of 2026-06-10: 3 recently completed (startup_speedup, test_batching_refactor, test_infrastructure_hardening); 4 in plan state (qwen, error_handling, data_structure, mcp_arch).** The 4 in-plan tracks are now unblocked (the upstream test_infrastructure_hardening track is shipped).*

### Recently Completed (2026-06-06 to 2026-06-10)

Lightweight chronology; full spec/plan/state per track is in the linked folder.

#### Track: Sloppy.py Startup Speedup `[COMPLETE 2026-06-07]`
*Link: [./tracks/startup_speedup_20260606/](./tracks/startup_speedup_20260606/) (full spec/plan/state in folder)*

`[track-created: cd4fb045] [phase-1-2-done: f9a01258] [phase-3-done: 51c054ec] [phase-4-done: 3849d304] [phase-5-done: 515a3029] [sub-track-1-done: 253e1798] [sub-track-2e+f-done: 2e3a6385] [audit-CLEAN: 2e3a6385] [conftest-atexit-fix: 8957c9a5] [post-shipping-fix-1: 8c4791d0] [post-shipping-fix-2: 88fc42bb] [post-shipping-fix-3: 52ea2693]`

*9 phases, 57 tasks. 44 TDD tests added. Main Thread Purity Invariant enforced via `scripts/audit_main_thread_imports.py` CI gate. Final measured: import src.ai_client 161ms (was 1800ms; 91% reduction); import src.gui_2 341ms (was 1770ms; 81% reduction); total ~3067ms saved. 62 audit violations remain (large refactors deferred).*

#### Track: Test Batching Refactor `[COMPLETE 2026-06-08] [archived]`
*Link: [./tracks/archive_completed_tracks_20260603/test_batching_refactor_20260606/](./tracks/archive_completed_tracks_20260603/test_batching_refactor_20260606/)*

`[track-created: b7a97374] [COMPLETE 2026-06-08] [phase-1-done: 57285d04] [phase-3-done: 5252b6d7] [phase-4-done: 50bd894f] [archived: 50bd894f]`

*4 phases, fixture-class-isolated tiers (0-3 + H + P) replacing alphabetical 4-at-a-time batching. Hand-curated `tests/test_categories.toml` overrides for cross-cutting files. Phase 2 (CI shadow run) skipped (no CI in repo).*

#### Track: Test Infrastructure Hardening (2026-06-09) `[COMPLETE 2026-06-10] [archived]`
*Link: [./archive/test_infrastructure_hardening_20260609/](./archive/test_infrastructure_hardening_20260609/)*

`[track-created: 566cf08c] [phase-1-done: 5df22fa8] [phase-2-done: 67d0211e] [phase-3-done: 006bb114] [phase-4-done: b8fcd9d6] [phase-5-done: 33d5cac] [phase-6-done: 7b87bbf5] [phase-7-done: 84edb200] [phase-8-done: 719fe9a]`

*8 phases, ~60 surgical tasks, 6.5 days. Fixes 3 root causes of test regression churn: FR1 subprocess health autouse, FR2 `live_gui_workspace` fixture (per-run timestamped under `tests/artifacts/`), FR3 `_sync_rag_engine` token+dirty coalescing. Plus FR4 `set_value` hook + FR5 `clean_baseline` marker. 314/314 tests green across all 11 tier batches. Closing report: `docs/reports/test_infrastructure_hardening_batch_green_20260610.md`. Lineage: `workspace_path_finalize_20260609` + `mma_tier_usage_reset_fix_20260610` + `rag_phase4_sync_fix_20260610` (all also archived).*

### In Plan (or Pending Spec)

#### Track: Qwen, Llama & Grok Vendor Integration + Capability Matrix `[track-created: 7c1d597e]`
*Link: [./tracks/qwen_llama_grok_integration_20260606/](./tracks/qwen_llama_grok_integration_20260606/), Spec: [./tracks/qwen_llama_grok_integration_20260606/spec.md](./tracks/qwen_llama_grok_integration_20260606/spec.md), Plan: [./tracks/qwen_llama_grok_integration_20260606/plan.md](./tracks/qwen_llama_grok_integration_20260606/plan.md) (to be authored by writing-plans skill)*

*Goal: Add first-class support for Qwen (DashScope native SDK), Llama (Ollama local + OpenRouter cloud + custom URL), and Grok (xAI OpenAI-compatible). Introduce a **Vendor Capability Matrix** (7 v1 capabilities: vision, tool_calling, caching, streaming, model_discovery, context_window, cost_tracking; audio and server-side code_execution deferred) declared per-(vendor, model) in `src/vendor_capabilities.py`. GUI reads the matrix to enable/disable 9 UI elements (screenshot button, tools toggle, cache panel, stream progress, fetch models, token budget, cost panel) instead of hard-coding per-vendor branches. Extract a shared `send_openai_compatible()` helper in `src/openai_compatible.py` that operates on a normalized request/response data structure; each `_send_<vendor>()` is a thin boundary adapter (data-oriented design per Fleury/Acton/Lottes). Refactor `_send_minimax()` to use the helper (~250 lines → ~50). **Out of scope** (separate follow-up track): Anthropic/Gemini/DeepSeek migration to the matrix. 6 phases: matrix+helper, Qwen, Grok+Llama, MiniMax refactor, UX adaptation, docs+archive. **Now blocked by** test_infrastructure_hardening_20260609 (was: none).*

*Status (2026-06-11): Phases 1-5 done; Phase 6 (docs) in progress. **NOT ARCHIVING** — has a follow-up track. See [./tracks/qwen_llama_grok_followup_20260611/](./tracks/qwen_llama_grok_followup_20260611/) for the 5-phase follow-up. Audit report: [../docs/reports/qwen_llama_grok_followup_audit_20260611.md](../docs/reports/qwen_llama_grok_followup_audit_20260611.md). 50/79 tasks done. Known gaps: tool-call loop only on MiniMax; 1 of 9 UX adaptations shipped; PROVIDERS in models.py is sprawl; src/ai_client.py needs codepath consolidation; local models need first-class priority; 12 v2 matrix fields documented but not implemented; Anthropic/Gemini/DeepSeek still not on the matrix.*

#### Track: Data-Oriented Error Handling (Fleury Pattern) `[track-created: 494f68f9]`
*Link: [./tracks/data_oriented_error_handling_20260606/](./tracks/data_oriented_error_handling_20260606/), Spec: [./tracks/data_oriented_error_handling_20260606/spec.md](./tracks/data_oriented_error_handling_20260606/spec.md), Plan: [./tracks/data_oriented_error_handling_20260606/plan.md](./tracks/data_oriented_error_handling_20260606/plan.md)*

*Goal: Introduce Ryan Fleury's "errors are just cases" framework as a project convention. New `src/result_types.py` (ErrorKind enum, ErrorInfo dataclass, `Result[T]` with data + side-channel errors list, NilPath + NilRAGState sentinel singletons) and new `conductor/code_styleguides/error_handling.md` canonical reference. Refactor `src/mcp_client.py` ((p, err) tuples → Result; 30+ `assert p is not None` → nil-sentinel paths), `src/ai_client.py` (ProviderError exception → ErrorInfo dataclass; `_send_<vendor>()` → `_send_<vendor>_result()` returning `Result[str]`; `send()` marked `@deprecated`; new `send_result()` public API), and `src/rag_engine.py` (RAGEngine methods → Result returns). Update `conductor/product-guidelines.md` + `workflow.md` + `docs/guide_*.md` so the convention is documented and future plans can incrementally migrate the remaining `src/` files. **Blocked by** startup_speedup, test_batching_refactor, test_infrastructure_hardening_20260609, and qwen_llama_grok tracks. 5 phases: foundation+styleguide, mcp_client refactor, ai_client refactor (highest risk; ProviderError removal), rag_engine refactor, deprecation+docs+archive.*
*Follow-up: **`public_api_migration_20260606`** (planned; not yet specced; no directory yet) — removes the deprecated `ai_client.send()` and migrates all callers. Detailed in the parent track's spec §12.1.*

*Status (2026-06-12): **SHIPPED.** Phases 1-5 complete on branch `doeh-ai_client`. Path C was used for `src/mcp_client.py` (additive `*_result` variants; the 30+ tool-function refactor deferred to follow-up). Full refactor was used for `src/ai_client.py` (ProviderError removed, 9 `_send_*()` renamed, `send()` marked `@deprecated`, `send_result()` public API added) and `src/rag_engine.py` (`_init_vector_store_result`, `_validate_collection_dim_result`, `_get_state` with `NilRAGState`). 28 new tests pass; 4 existing tests updated; 13 test regressions in test_llama_provider.py (3) + test_llama_ollama_native.py (4) + test_grok_provider.py (3) + test_minimax_provider.py (2) + test_live_gui_integration_v2.py (1) — all from the Phase 3 renames + ProviderError removal. Regressions are documented in `state.toml` `[regressions_20260612]` and are the intended work of `public_api_migration_20260606`. Archive status: directory remains in place (matches repo convention; `archive` is conceptual, not physical).*

#### Track: Data Structure Strengthening (Type Aliases + NamedTuples) `[track-created: ed42a97a]`
*Link: [./tracks/data_structure_strengthening_20260606/](./tracks/data_structure_strengthening_20260606/), Spec: [./tracks/data_structure_strengthening_20260606/spec.md](./tracks/data_structure_strengthening_20260606/spec.md), Plan: [./tracks/data_structure_strengthening_20260606/plan.md](./tracks/data_structure_strengthening_20260606/plan.md) (to be authored by writing-plans skill)*

*Goal: Improve AI-readability by naming 430 currently-anonymous `dict[str, Any]` / `list[dict[...]]` / `Tuple[...]` types. New `src/type_aliases.py` with 10 `TypeAlias` definitions (`Metadata`, `CommsLogEntry`, `CommsLog`, `HistoryMessage`, `History`, `FileItem`, `FileItems`, `ToolDefinition`, `ToolCall`, `CommsLogCallback`) and 1 `NamedTuple` (`FileItemsDiff`). Mechanical replacement of 345 weak sites across 6 high-traffic files: `src/ai_client.py` (139), `src/app_controller.py` (86), `src/models.py` (51), `src/api_hook_client.py` (32), `src/project_manager.py` (20), `src/aggregate.py` (17). Add `--strict` mode to the existing `scripts/audit_weak_types.py` (committed in 84fd9ac9; found the 430 sites) so it becomes a permanent CI gate that fails when new weak types are introduced. Generate `scripts/audit_weak_types.baseline.json` with the post-refactor count. 2 phases: aliases + 6-file replacement + audit baseline; NamedTuples + docs + archive. **Data-grounded**: the audit script is the source of truth; the count drops from 430 to ~60 (86% reduction) in the 6 high-traffic files. **Honest about what's missing**: 23 lower-impact files remain; TypedDict/dataclass migration is deferred to a follow-up track. 2-3 days work, 1-2 phases, low risk. **Now blocked by** test_infrastructure_hardening_20260609 (was: none).*

#### Track: AI Loop Regressions (MiniMax, Gemini, Gemini CLI, DeepSeek) `[track-created: 2026-06-14]` `[shipped: 2026-06-15]`
*Link: [./tracks/ai_loop_regressions_20260614/](./tracks/ai_loop_regressions_20260614/), Spec: [./tracks/ai_loop_regressions_20260614/spec.md](./tracks/ai_loop_regressions_20260614/spec.md), Plan: [./tracks/ai_loop_regressions_20260614/plan.md](./tracks/ai_loop_regressions_20260614/plan.md), Metadata: [./tracks/ai_loop_regressions_20260614/metadata.json](./tracks/ai_loop_regressions_20260614/metadata.json), Report: [../../docs/reports/TRACK_COMPLETION_ai_loop_regressions_20260615.md](../../docs/reports/TRACK_COMPLETION_ai_loop_regressions_20260615.md)*

*Status: 2026-06-15 — **SHIPPED with 1 known production regression + 2 deferred bugs** (both flagged for follow-up). 3 documented bugs (Bug #1 dead `except ai_client.ProviderError`, Bug #2 error → no discussion entry, Bug #3 MiniMax thinking mono) are fixed. 7 new regression tests pass; 2 pre-existing tests in `test_live_gui_integration_v2.py` were adapted (not skipped). 12 commits.*

*Goal: Diagnose and fix the user-blocking AI loop regressions for the 4 providers (MiniMax, Gemini, Gemini CLI, DeepSeek) most heavily touched by the `data_oriented_error_handling_20260606` track (shipped 2026-06-12) and the subsequent `ai client pass` commit `5030bd84` (2026-06-13, 503-line `src/ai_client.py` refactor). 3 distinct bugs: **Bug #1** (3 dead `except ai_client.ProviderError` clauses in `src/app_controller.py:305, 313, 3692` — the class was removed in commit `64b787b8`). **Bug #2** (`_handle_request_event` calls the deprecated `ai_client.send()` which now returns `""` on error; `_on_comms_entry` filters empty text). **Bug #3** (`_send_minimax` doesn't wrap reasoning in `<thinking>` tags in returned text).*

*5 phases: Phase 1 (TDD red), Phase 2 (FR1 fix), Phase 3 (FR2 fix), Phase 4 (FR3 fix), Phase 5 (regression sweep + docs). 17 tasks, 12 atomic commits, ~1.5 days of Tier 2 work.*

*Deferred to follow-up tracks (per user direction 2026-06-14): (1) Gemini / Gemini CLI thinking-format compatibility (Bug #4) — see `doeh_test_thinking_cleanup_20260615` Phase 3. (2) `<think>` (half-width) marker support in `thinking_parser.py` (Bug #5) — see `doeh_test_thinking_cleanup_20260615` Phase 4.*

*`blocks: public_api_migration_20260606` (this track migrates 3 broken sites; the public_api track picks up the remaining 5 production + 63 test call sites).*

#### Track: Data-Oriented Error Handling Test & Thinking-Parser Cleanup `[track-created: 2026-06-15]`
*Link: [./tracks/doeh_test_thinking_cleanup_20260615/](./tracks/doeh_test_thinking_cleanup_20260615/), Spec: [./tracks/doeh_test_thinking_cleanup_20260615/spec.md](./tracks/doeh_test_thinking_cleanup_20260615/spec.md), Plan: [./tracks/doeh_test_thinking_cleanup_20260615/plan.md](./tracks/doeh_test_thinking_cleanup_20260615/plan.md), Metadata: [./tracks/doeh_test_thinking_cleanup_20260615/metadata.json](./tracks/doeh_test_thinking_cleanup_20260615/metadata.json)*

*Status: 2026-06-15 — Active, ready for Tier 2 implementation. User-blocking cleanup track. 1 critical production regression + 10 pre-existing test mock bugs + 2 deferred bugs (from `ai_loop_regressions_20260614`) + 2 housekeeping items.*

*Goal: Consolidate the cleanup work that didn't fit in `data_oriented_error_handling_20260606` (the parent refactor) and `ai_loop_regressions_20260614` (the immediate fix track). 5 phases: Phase 1 (CRITICAL: fix `_api_generate` `NameError` regression introduced by `ai_loop_regressions_20260614` commit `2b7b571a` — the FR2 fix accidentally removed the `context_to_send` variable definition while preserving its usage at line 278), Phase 2 (fix 11 pre-existing test mock bugs: 3 in test_grok_provider, 3 in test_llama_provider, 4 in test_llama_ollama_native, 1 in test_ai_client_tool_loop_builder, 1 in test_headless_service), Phase 3 (Bug #4 deferred: Gemini / Gemini CLI thinking-format compatibility), Phase 4 (Bug #5 deferred: `<think>` half-width marker support in thinking_parser), Phase 5 (housekeeping: state.toml duplicate-key fix, tracks.md row 24 update, full suite sweep, doc updates). 16 tasks, ~15 atomic commits, 5-8 hours of Tier 2 work (0.5-1 day).*

*Out of scope (documented in spec.md §7 + §12): `public_api_migration_20260606` (planned; the broader migration of 5 production + ~50 test call sites not touched here), `live_gui_mock_injection_20260615` (recommended; infrastructure for proper e2e live_gui + AI client tests), `test_rag_phase4_final_verify` (separate RAG concern), UI Polish Five Issues track phases 2/3 (separate track).*

#### Track: MCP Architecture Refactor (Sub-MCP Extraction) `[track-created: 2720a894]`
*Link: [./tracks/mcp_architecture_refactor_20260606/](./tracks/mcp_architecture_refactor_20260606/), Spec: [./tracks/mcp_architecture_refactor_20260606/spec.md](./tracks/mcp_architecture_refactor_20260606/spec.md), Plan: [./tracks/mcp_architecture_refactor_20260606/plan.md](./tracks/mcp_architecture_refactor_20260606/plan.md) (to be authored by writing-plans skill)*

*Goal: Split the 2,205-line monolithic `src/mcp_client.py` (45 module-level functions) into a slim controller + 6 native sub-MCPs + 1 external sub-MCP. Naming convention `mcp_<type>.py` for native MCPs: `mcp_file_io.py` (9 tools), `mcp_python.py` (14), `mcp_c.py` (5), `mcp_cpp.py` (5), `mcp_web.py` (2), `mcp_analysis.py` (2). The existing `ExternalMCPManager` is extracted to `mcp_external.py` (class name preserved). New `MCPController` class in `src/mcp_client.py` holds the 3-layer security model (extracted to `src/mcp_client_security.py`), the `ALL_SUB_MCPS` registration list, and the inverted-dict dispatch lookup. New `src/mcp_client_legacy.py` re-exports all 45+ old symbols for backward compat (the 4 existing test files + `src/app_controller.py:61` continue to work). Each sub-MCP's `invoke()` returns `Result[str, ErrorInfo]` (Fleury pattern). Path parameters use the `Metadata` family aliases. **Blocked by** test_infrastructure_hardening_20260609, `data_oriented_error_handling_20260606` (for `Result`/`ErrorInfo`), and `data_structure_strengthening_20260606` (for `Metadata` aliases). 7 phases: foundation (security + controller), move-to-legacy, extract File I/O, extract Python, extract C/C++/Web/Analysis, extract External, dispatch update + docs + archive. **Out of scope** (per user): a per-MCP DSL (APL/K/Cosy-inspired) for compact tool calls — deferred to `mcp_dsl_20260606` follow-up. JSON-only for now.*

#### Track: RAG Phase 4 Stress Test Fix `[x] — fixed 16412ad5`
*Status: 2026-06-06 — Surfaced during post-v2 verification. Resolved: real bug, NOT a test flake. Root cause: ChromaDB collection dimension mismatch across test runs. The persistent on-disk collection (`tests/artifacts/live_gui_workspace/.slop_cache/chroma_test_stress/`) was created by a previous run with Gemini embeddings (3072-dim); the current run uses local SentenceTransformers (384-dim). `index_file()` upserts silently corrupt the collection, then `search()` fails with `Collection expecting embedding with dimension of 3072, got 384` and the AI request never reaches 'done' status, timing out the 50*0.5s = 25s poll loop. Fix: `RAGEngine._init_vector_store` now calls `_validate_collection_dim` which inspects the first existing vector's dim, compares to the current provider's output, and recreates the collection on mismatch (with a stderr warning). Regression tests added: `test_rag_collection_dim_mismatch_recreates_collection` and `test_rag_collection_dim_match_preserves_collection` in `tests/test_rag_engine.py`. This also fixes a real user-facing bug: switching embedding providers in the GUI previously caused silent corruption. Commit 16412ad5.*

#### Track: SQLite-Granularity Inline Docs for gui_2.py `[COMPLETE: sqlite_docs_gui_2_20260612]`
*Link: [./tracks/sqlite_docs_gui_2_20260612/](./tracks/sqlite_docs_gui_2_20260612/), Spec: [./tracks/sqlite_docs_gui_2_20260612/spec.md](./tracks/sqlite_docs_gui_2_20260612/spec.md), Plan: [./tracks/sqlite_docs_gui_2_20260612/plan.md](./tracks/sqlite_docs_gui_2_20260612/plan.md)*

*Status: 2026-06-12 — COMPLETE. SQLite-style docstrings with embedded ASCII layouts and DAG context have been added to key modules representing App lifecycle, discussion panels, context panels, settings hubs, and diagnostics panels.*

*Goal: Add SQLite-granularity docstrings with embedded ASCII layouts and DAG relationships for `src/gui_2.py` panel-by-panel. Ensure zero functional regression. 5 phases: app lifecycle & setup, discussion panel, context panel, settings/hubs, and diagnostics/modals.*

#### Track: Continued SQLite-Granularity Inline Docs for gui_2.py `[COMPLETE: sqlite_docs_gui_2_continued_20260613]`
*Link: [./tracks/sqlite_docs_gui_2_continued_20260613/](./tracks/sqlite_docs_gui_2_continued_20260613/), Spec: [./tracks/sqlite_docs_gui_2_continued_20260613/spec.md](./tracks/sqlite_docs_gui_2_continued_20260613/spec.md), Plan: [./tracks/sqlite_docs_gui_2_continued_20260613/plan.md](./tracks/sqlite_docs_gui_2_continued_20260613/plan.md)*

*Status: 2026-06-13 — COMPLETE. Completed the SQLite-style docstring initiative for preset managers, editors, persona selectors, and the command palette modal.*

*Goal: Document preset managers/editors, persona selectors/editors, provider panel, and command palette in `src/gui_2.py` and `src/command_palette.py` with embedded SSDL and ASCII layouts.*

#### Track: SQLite-Granularity Inline Docs for ai_client.py `[COMPLETE: ai_client_docs_20260613]`
*Link: [./tracks/ai_client_docs_20260613/](./tracks/ai_client_docs_20260613/), Spec: [./tracks/ai_client_docs_20260613/spec.md](./tracks/ai_client_docs_20260613/spec.md), Plan: [./tracks/ai_client_docs_20260613/plan.md](./tracks/ai_client_docs_20260613/plan.md)*

*Status: 2026-06-13 — COMPLETE. Added SQLite-granularity docstrings with SSDL traces, parameters, functional scopes, and thread boundaries for the primary entry points, providers, and helper functions in src/ai_client.py.*

*Goal: Add SQLite-granularity docstrings with SSDL traces, parameters, functional scopes, and thread boundaries for the primary entry points, providers, and helper functions in `src/ai_client.py`.*

#### Track: Intent-Based Scripting Languages Survey `[COMPLETE: 213e4994]`
*Link: [./tracks/intent_dsl_survey_20260612/](./tracks/intent_dsl_survey_20260612/), Spec: [./tracks/intent_dsl_survey_20260612/spec.md](./tracks/intent_dsl_survey_20260612/spec.md), Plan: [./tracks/intent_dsl_survey_20260612/plan.md](./tracks/intent_dsl_survey_20260612/plan.md), Report: [./tracks/intent_dsl_survey_20260612/report_v1.2.md](./tracks/intent_dsl_survey_20260612/report_v1.2.md), v1.1: [./tracks/intent_dsl_survey_20260612/report_v1.1.md](./tracks/intent_dsl_survey_20260612/report_v1.1.md), v1.0: [./tracks/intent_dsl_survey_20260612/report.md](./tracks/intent_dsl_survey_20260612/report.md), Review: [./tracks/intent_dsl_survey_20260612/reportreview.md](./tracks/intent_dsl_survey_20260612/reportreview.md)*

*Status: 2026-06-12 — COMPLETE. Research-only track (non-impl). Final deliverable: `report_v1.2.md` (1343 lines, 168KB+, 7 sections + 9-subsection expanded Appendix). 4-tier vocab with 42 verbs (T1 math 12, T2 pipeline 12, T3 shell 10, T4 AI-fuzzing 8); **10 prior-art clusters** (0: O'Donnell philosophical anchor; 1: Concatenative; 2: Array; 3: Intent-mapping; 4: Meta-Tooling DSLs; 5: SSDL; 6: Command Palette; 7: Result convention; 8: Metadesk Self-Describing Data + Tag Dispatch; 9: Verse Multi-Paradigm Calculi with Transactional Semantics); 14-primitive grammar from user's math pseudocode; 4 hardware anchor claims; 10 AI-agent properties tying to existing project architecture; 8 open questions for the follow-up interpreter prototype. Version history: v1.0 (418 lines) → v1.1 (1301 lines, +883): XML/JSON rejection citation fix, OCR-restored Lottes quote, softened Wasm streaming-parse inference, expanded Appendix A.1-A.9. → **v1.2** (1343 lines): (1) Renamed `arena { }` → `tape { }` (46 occurrences); (2) **Mixed postfix/infix notation** for math; (3) nagent attribution corrected (Jody Bruchon → Mike Acton); (4) **Added Cluster 8 (Metadesk) and Cluster 9 (Verse)** — survey now covers 10 clusters (sub-agents at `research/cluster_8_metadesk.md` and `research/cluster_9_verse.md`). Time-sensitive goal met: completed before nagent v2.2 hard boundary. Will be consumed by nagent v2.2 (Future-Track Candidate #4) and the future interpreter prototype (follow-up B track, separate). Appendix A.3/A.4 retain v1.1 form pending a sync pass; noted in v1.2 changelog at the top of the report.*

*Goal: Survey intent-based scripting languages as a design philosophy and propose a Meta-Tooling-facing intent DSL vocabulary. **Research-only** (non-impl): produces 1 markdown file at `conductor/tracks/intent_dsl_survey_20260612/report.md`. No new `src/` code, no new tests, no `pyproject.toml` changes. The report is the *foundation document* for the user's nagent v2.2 (its "Future-Track Candidate #4: Intent-based DSL" section), the placeholder `intent_dsl_for_meta_tooling_20260608_PLACEHOLDER` (per `mcp_architecture_refactor_20260606/spec.md` §12.1 and `nagent_review_20260608/metadata.json:28`), and a future interpreter prototype (follow-up B track, separate). 7 sections: (1) the "intent-based" design philosophy (O'Donnell immediate-mode as the anchor); (2) prior art across **10 clusters** (0: John O'Donnell IMGUI/MVC at johno.se/book/*; 1: Forth family — Forth, ColorForth, KYRA/Onat, x68/Lottes, Joy, CoSy/Bob Armstrong; 2: Array — APL, K, BQN, Uiua; 3: Intent-mapping — Jofito/Jody, jq, nagent tag protocol [rejected as model], Wasm; 4: Meta-Tooling DSLs — `mcp_dsl_20260606` placeholder, nagent's Bridge DSL, OpenAI/Anthropic tool-use; 5: SSDL shape primitives per `computational_shapes_ssdl_digest_20260608.md`; 6: Project's own Command Palette 33 commands; 7: `Result[T]` + `ErrorInfo` convention per `data_oriented_error_handling_20260606`); (3) the 14-primitive grammar formalized from the user's math pseudocode (`determinate`/`minor`/`matrix-transpose` snippets), with explicit ambiguity flags; (4) the 4-tier vocab (~40 verbs: T1 math ~10, T2 data pipeline ~12, T3 shell ~10, T4 AI-fuzzing tolerance ~8 — T4 is the novel contribution); (5) hardware mapping with 4 anchor claims (Onat/Lottes 2-register stack + magenta pipe + basic blocks + lambdas + preemptive scatter; O'Donnell "widgets are method invocations"; Forth/CoSy concatenative syntax; APL/K array data); (6) AI-agent properties (10 claims tying to existing project architecture: Meta-Tooling domain per `guide_meta_boundary.md`, runtime path through `cli_tool_bridge.py`, 3-layer security per `guide_tools.md`, 4 memory dimensions per nagent v2.1 §2.1, stable-to-volatile cache ordering, `Result[T]` envelope, Command Palette 33 commands, Hook API state fields, O'Donnell IEventTarget = `sandbox` verb, O'Donnell "reads are free" = cheap Tier 2 verbs); (7) ≥6 open questions for follow-up B (interpreter prototype) + connection block to `intent_dsl_for_meta_tooling_20260608_PLACEHOLDER`. 4 phases: source gathering + outline (checkpoint commit), write sections 1-3, write sections 4-7, self-review + user review + commit + register in tracks.md. **Time-sensitive**: report must complete before nagent v2.2 ships.*

*Spec approved 2026-06-12 (commit `b389f1be`). 789 lines; modeled on `data_oriented_error_handling_20260606/spec.md`.*

#### Track: Prior Session Test Harden (20260605) `[superseded by live_gui_test_hardening_v2_20260605]`
*Status: 2026-05-05 — Surfaced during live_gui_fragility_fixes_20260605 execution. `test_prior_session_no_pop_imbalance::test_no_extraneous_pop_when_prior_session_renders` is more under-mocked than expected. Completed as part of live_gui_test_hardening_v2_20260605: test refactored to call narrow render_prior_session_view (50+ mocks -> 20, runtime 5.79s -> 0.08s). Commit 26e0ced4.*

### Backlog (Provider + Language + Investigation)

#### Track: Bootstrap gencpp Python Bindings
*Link: [./tracks/gencpp_python_bindings_20260308/](./tracks/gencpp_python_bindings_20260308/)*

#### Track: Tree-Sitter Lua MCP Tools
*Link: [./tracks/tree_sitter_lua_mcp_tools_20260310/](./tracks/tree_sitter_lua_mcp_tools_20260310/)*

#### Track: GDScript Language Support Tools
*Link: [./tracks/gdscript_godot_script_language_support_tools_20260310/](./tracks/gdscript_godot_script_language_support_tools_20260310/)*

#### Track: C# Language Support Tools
*Link: [./tracks/csharp_language_support_tools_20260310/](./tracks/csharp_language_support_tools_20260310/)*

#### Track: OpenAI Provider Integration
*Link: [./tracks/openai_integration_20260308/](./tracks/openai_integration_20260308/)*

#### Track: Zhipu AI (GLM) Provider Integration
*Link: [./tracks/zhipu_integration_20260308/](./tracks/zhipu_integration_20260308/)*

#### Track: AI Provider Caching Optimization
*Link: [./tracks/caching_optimization_20260308/](./tracks/caching_optimization_20260308/)*

#### Track: Manual UX Validation & Review
*Link: [./tracks/manual_ux_validation_20260302/](./tracks/manual_ux_validation_20260302/)*

#### Track: Manual UX Validation — ASCII-Sketch Workflow (NEW 2026-06-08)
*Link: [./tracks/manual_ux_validation_20260608_PLACEHOLDER/](./tracks/manual_ux_validation_20260608_PLACEHOLDER/), Spec: [./tracks/manual_ux_validation_20260608_PLACEHOLDER/spec.md](./tracks/manual_ux_validation_20260608_PLACEHOLDER/spec.md), Plan: [./tracks/manual_ux_validation_20260608_PLACEHOLDER/plan.md](./tracks/manual_ux_validation_20260608_PLACEHOLDER/plan.md)*
*Goal: Promote the ASCII-sketch UX ideation workflow (`docs/reports/ascii_sketch_ux_workflow_20260608.md`, 340 lines) to a real track. Resolves 5 open questions (vocabulary preference, comparison policy, storage location, tooling, frequency), then executes the workflow on the first target: the per-entry rendering of the Discussion Hub at `src/gui_2.py:3770 render_discussion_entry`. The 23-op matrix A1-A7 in `docs/guide_discussions.md` is the source of truth; the SSDL digest (`docs/reports/computational_shapes_ssdl_digest_20260608.md`, 504 lines) informs the *internal refactoring* decisions. Complements the broader 20260302 track. 4 phases, 21 tasks, TDD-style for Phase 3. User-confirmed worth doing.*
*Status: Active; Phase 1 (5 open questions to the user) is the current phase.*

#### Track: Chunkification Optimization (NEW 2026-06-08, CONTINGENCY)
*Link: [./tracks/chunkification_optimization_20260608_PLACEHOLDER/](./tracks/chunkification_optimization_20260608_PLACEHOLDER/), Spec: [./tracks/chunkification_optimization_20260608_PLACEHOLDER/spec.md](./tracks/chunkification_optimization_20260608_PLACEHOLDER/spec.md)*
*Goal: Contingency document only. Activates ONLY when a hard constraint surfaces that no existing Python package can solve AND the target is hot enough to justify the C11 build cost. Per user (verbatim): "only worth it if I reach a hard constraint that I cannot solve with an existing python package." The 2 cited candidates (markdown parsing into aggregate markdown, context snapshot processing) are NOT currently bottlenecks per `src/aggregate.py:380-454` (pure-Python string concat, zero third-party markdown deps in `pyproject.toml:6-27`) and `src/history.py:1-141` (bounded ~500KB at 100-snapshot capacity, debounced). First fix if they become bottlenecks: add `markdown-it-py` OR switch to `pickle`/`msgspec` — NOT C11. The shape when activated: subprocess-launch C11 binary with request/response blob wire format (NOT stateful C extension). The SSDL digest's Technique 5 "Assume-away (Xar)" in §2.2 + "Xar-style chunked arrays" recommendation in §5.2 pre-support this track.*
*Status: Deferred. Promotes to active track when (if) the first hard constraint surfaces.*

#### Track: Context First Message Fix
*Link: [./tracks/context_first_message_fix_20260604/](./tracks/context_first_message_fix_20260604/)*

#### Track: Fix Remaining Tests
*Link: [./tracks/fix_remaining_tests_20260513/](./tracks/fix_remaining_tests_20260513/)*

#### Track: Test Harness Hardening
*Link: [./tracks/test_harness_hardening_20260310/](./tracks/test_harness_hardening_20260310/)*

#### Track: Test Patch Fixes
*Link: [./tracks/test_patch_fixes_20260513/](./tracks/test_patch_fixes_20260513/)*

#### Track: Test Batching Post-Refactor Polish
*Link: [./tracks/test_batching_post_refactor_polish_20260607/](./tracks/test_batching_post_refactor_polish_20260607/)*

#### Track: Code Path Audit
*Link: [./tracks/code_path_audit_20260607/](./tracks/code_path_audit_20260607/), Spec: [./tracks/code_path_audit_20260607/spec.md](./tracks/code_path_audit_20260607/spec.md), Plan: [./tracks/code_path_audit_20260607/plan.md](./tracks/code_path_audit_20260607/plan.md) (to be authored by writing-plans skill)*
*Goal: Build `src/code_path_audit.py` — a static-analysis tool that audits the 3 major actions (AI message lifecycle, discussion save/load, GUI startup) for expensive operations, redundant calls, and pipelining candidates. Output: custom postfix `.dsl` data + markdown + Mermaid + prefix tree text under `docs/reports/code_path_audit/<date>/`. The follow-up `pipeline_pruning_20260607` consumes the `.dsl` files; the markdown + tree are for human review. MMA worker spawn is **cold per user**. **Timing (revised 2026-06-08):** the audit must run *after* the 4 foundational tracks ship (`qwen_llama_grok`, `data_oriented_error_handling`, `data_structure_strengthening`, `mcp_architecture_refactor`); pre-4-tracks code is too stale to ground optimization decisions.*

#### Track: GUI Architecture Refinement
*Link: [./tracks/gui_architecture_refinement_20260512/](./tracks/gui_architecture_refinement_20260512/) (no spec.md; needs scoping before planning)*

### Follow-up (Planned, Not Yet Specced)

#### Track: Public API Result Migration (follow-up to data_oriented_error_handling_20260606)
*Plan to be authored when data_oriented_error_handling_20260606 is complete; not started yet.*
*Goal: Remove the deprecated `ai_client.send()` and migrate all callers to `send_result()`. Affects 5 production call sites in `src/` (`src/app_controller.py:290` + `:3692`, `src/multi_agent_conductor.py:591`, `src/orchestrator_pm.py:86`, `src/conductor_tech_lead.py:68`, plus `src/mcp_client.py:2274` in the tool-result dispatch path) and 63 test files. The enumeration + baseline counts are recorded in the parent track's spec §12.1 and verified in this track's `state.toml` `[baseline_post_qwen_track]`.*

*`send_result(...)` mirrors the `send(...)` signature (13+ parameters including 8 callbacks); see `docs/guide_ai_client.md` "Data-Oriented Error Handling (Fleury Pattern) > Public API" for the call shape.*

---

## Phase 9: Chore Tracks

*Initialized: 2026-06-07*

### Completed (recently archived or in `tracks/`)

- [x] **Track: Unused Scripts Cleanup** `[checkpoint: 46ce3cd]`
   *Link: [./tracks/unused_scripts_cleanup_20260607/](./tracks/unused_scripts_cleanup_20260607/), Spec: [./tracks/unused_scripts_cleanup_20260607/spec.md](./tracks/unused_scripts_cleanup_20260607/spec.md), Plan: [./tracks/unused_scripts_cleanup_20260607/plan.md](./tracks/unused_scripts_cleanup_20260607/plan.md)*
   *Goal: Remove 30 confirmed-unused one-off scripts from `scripts/` (56 → 26 files, 54% reduction). 5 atomic per-category commits; no new CI gate; follow-up `unused_scripts_audit_20260607` recorded. All non-GUI test batches still pass; 2 audit scripts (main_thread_imports, weak_types) report no new violations.*

- [x] **Track: License & CVE Audit (Dependency Compliance)** `[checkpoint: a7ab994f]`
   *Link: [./tracks/license_cve_audit_20260607/](./tracks/license_cve_audit_20260607/), Spec: [./tracks/license_cve_audit_20260607/spec.md](./tracks/license_cve_audit_20260607/spec.md), Plan: [./tracks/license_cve_audit_20260607/plan.md](./tracks/license_cve_audit_20260607/plan.md)*
   *Goal: Build `scripts/audit_license_cve.py` — single audit script that checks third-party deps (pyproject.toml + uv.lock transitive) for license compliance + known CVEs + version-pinning + SPDX source-headers. Tilde-pin all deps, delete requirements.txt, regenerate uv.lock (gitignored per project policy), add --strict mode + baseline file (CI gate). Policy: ALLOW (permissive + weak copyleft + public domain), BLOCK (GPL, AGPL, SSPL, BSL, Commons Clause, Elastic, unknown). Track is scope-limited to third-party deps; the project's own LICENSE and SPDX headers are explicitly OUT of scope (the user reserves all rights to the repo). 28 unit + integration tests passing; --strict mode wired as CI gate; baseline file committed at scripts/audit_license_cve.baseline.json. 4 atomic commits: audit script + initial report, tilde-pin + lock regen + delete requirements.txt, --strict + baseline, tracks.md update.*

- [x] **Track: Qwen, Llama & Grok Vendor Integration + Capability Matrix** `[COMPLETE 2026-06-11] [archived]`
   *Link: [./archive/qwen_llama_grok_integration_20260606/](./archive/qwen_llama_grok_integration_20260606/), Spec: [./archive/qwen_llama_grok_integration_20260606/spec.md](./archive/qwen_llama_grok_integration_20260606/spec.md), Plan: [./archive/qwen_llama_grok_integration_20260606/plan.md](./archive/qwen_llama_grok_integration_20260606/plan.md)*
   *Goal: Add first-class support for Qwen (DashScope native SDK), Llama (Ollama local + OpenRouter cloud + custom URL), and Grok (xAI OpenAI-compatible). Vendor Capability Matrix (7 v1 + 12 v2 = 19 capabilities total) in `src/vendor_capabilities.py`. Shared `send_openai_compatible()` helper in `src/openai_compatible.py`. MiniMax refactored to use the helper. 6 phases: matrix+helper, Qwen, Grok+Llama, MiniMax refactor, UX adaptation, docs+archive. **Follow-up track**: `qwen_llama_grok_followup_20260611` (also archived).*

- [x] **Track: Qwen/Llama/Grok Follow-Up (tool loop, PROVIDERS move, UX, local-first, matrix v2, old-vendor wiring)** `[COMPLETE 2026-06-11] [archived]`
   *Link: [./archive/qwen_llama_grok_followup_20260611/](./archive/qwen_llama_grok_followup_20260611/), Spec: [./archive/qwen_llama_grok_followup_20260611/spec.md](./archive/qwen_llama_grok_followup_20260611/spec.md), Plan: [./archive/qwen_llama_grok_followup_20260611/plan.md](./archive/qwen_llama_grok_followup_20260611/plan.md)*
   *Goal: Close the gaps from the parent track. 6 phases: (1) `run_with_tool_loop` shared helper + apply to 4 vendors; (2) `PROVIDERS` move to `src/ai_client.py` (HARD RULE compliance) + 4 import sites; (3) UX adaptations 2-9; (4) local-first + matrix v2 expansion (12 new fields, native Ollama adapter, GUI "Local Model" badge, runtime `local` override); (5) Anthropic/Gemini/DeepSeek matrix entries + old-vendor matrix wiring (grok + minimax consult the v2 fields); (6) archive. Reports: [../docs/reports/qwen_llama_grok_followup_phase5_final_20260611.md](../docs/reports/qwen_llama_grok_followup_phase5_final_20260611.md), [../docs/reports/qwen_llama_grok_followup_session_end_20260611.md](../docs/reports/qwen_llama_grok_followup_session_end_20260611.md), [../docs/reports/qwen_llama_grok_followup_deferred_work_20260611.md](../docs/reports/qwen_llama_grok_followup_deferred_work_20260611.md), [../docs/reports/meta_llama_api_verification_20260611.md](../docs/reports/meta_llama_api_verification_20260611.md).*

---

## Notes

**Archive link convention:** `./archive/...` paths in this file resolve to `conductor/archive/...` (this file is at `conductor/tracks.md`). The 71 archive links in this file are all valid as of 2026-06-08.

**Status legend:**
- `[ ]` not started
- `[~]` in progress
- `[x]` completed (track may still be in `tracks/` or may have been moved to `archive/`)
- `~~**...**~~` struck-through (renamed/replaced/superseded)

**Naming convention:** Each track's `spec.md` and `plan.md` (where present) follow the project's standard format: `spec.md` for design intent (the "why"), `plan.md` for executable tasks (the "how"). See `conductor/tracks/data_oriented_error_handling_20260606/` for the canonical example.

**Editing this file:** When you mark a track as `[x]` and move its folder to `archive/`, also move it to the appropriate Archived sub-section. When you start a new track, create the folder under `tracks/` first, then add the entry to the Active Tracks table at the top. The git-blame sort order (`0a`, `0b`, `0c`...) is no longer used; this file is now organized by phase + dependency.
