# Project Tracks

This file tracks all major tracks for the project. Each track has its own detailed plan in its respective folder.

---

## Phase 5: Codebase Curation

*Initialized: 2026-05-07*

### Analysis & Structural Review

1. [x] **Track: Comprehensive Path Mapping & Tooling**
   *Link: [./tracks/ai_interaction_call_graph_20260507/](./tracks/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: [./tracks/controller_state_mutation_matrix_20260507/](./tracks/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: [./tracks/source_wide_redundancy_audit_20260507/](./tracks/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: [./tracks/curate_provider_registries_20260507/](./tracks/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: [./tracks/encapsulate_appcontroller_status_20260507/](./tracks/encapsulate_appcontroller_status_20260507/)*
   *Goal: Convert ai_status and mma_status to properties with thread-safe setters.*

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

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

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

---

## Remaining Backlog (Phases 3 & 4)

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

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

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

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

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

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

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

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

---

## Phase 4 Archive

*See below for completed Phase 4 tracks.*

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 2: Strict Execution Queue (Completed 2026-03-06)

*See: [./archive/strict_execution_queue_completed_20260306/](./archive/strict_execution_queue_completed_20260306/)*

---

### Phase 0: Infrastructure (Critical)

- [x] **Track: Conductor Path Configuration**

---

### Earlier Archives

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