# Project Tracks

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

---

## Phase 4: High-Fidelity UX & Tools

*Initialized: 2026-03-08*

### Architecture & Backend

1. [ ] **Track: RAG Support**
   *Link: [./tracks/rag_support_20260308/](./tracks/rag_support_20260308/)*
   *Goal: Add support for RAG (Retrieval-Augmented Generation) using local vector stores (Chroma/Qdrant), native vendor retrieval, and external RAG APIs. Implement indexing pipeline and retrieval UI.*

2. [x] **Track: Agent Tool Preference & Bias Tuning**
   *Link: [./tracks/tool_bias_tuning_20260308/](./tracks/tool_bias_tuning_20260308/)*
   *Goal: Influence agent tool selection via a weighting system. Implement semantic nudges in tool descriptions and a dynamic "Tooling Strategy" section in the system prompt. Includes GUI badges and sliders for weight adjustment.*

3. [x] **Track: Expanded Hook API & Headless Orchestration**
   *Link: [./tracks/hook_api_expansion_20260308/](./tracks/hook_api_expansion_20260308/)*
   *Goal: Maximize internal state exposure and provide comprehensive control endpoints (worker spawn/kill, pipeline pause/resume, DAG mutation) via the Hook API. Implement WebSocket-based real-time event streaming.*

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

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

6. [ ] **Track: Beads Mode Integration**
   *Link: [./tracks/beads_mode_20260309/](./tracks/beads_mode_20260309/)*
   *Goal: Integrate Beads (git-backed graph issue tracker) as an alternative backend for MMA implementation tracks and tickets.*

7. [ ] **Track: Optimization pass for Data-Oriented Python heuristics**
    *Link: [./tracks/data_oriented_optimization_20260312/](./tracks/data_oriented_optimization_20260312/)*

 8. [x] **Track: Rich Thinking Trace Handling** - *Parse and display AI thinking/reasoning traces*
   *Link: [./tracks/thinking_trace_handling_20260313/](./tracks/thinking_trace_handling_20260313/)*

 9. [ ] **Track: Smarter Aggregation with Sub-Agent Summarization**
    *Link: [./tracks/aggregation_smarter_summaries_20260322/](./tracks/aggregation_smarter_summaries_20260322/)*
    *Goal: Sub-agent summarization during aggregation pass, hash-based caching for file summaries, smart outline generation for code vs text files.*

 10. [ ] **Track: System Context Exposure**
     *Link: [./tracks/system_context_exposure_20260322/](./tracks/system_context_exposure_20260322/)*
     *Goal: Expose hidden _SYSTEM_PROMPT from ai_client.py to users for customization via AI Settings.*

---

### GUI Overhauls & Visualizations

1. [x] **Track: Advanced Log Management and Session Restoration**
   *Link: [./tracks/log_session_overhaul_20260308/](./tracks/log_session_overhaul_20260308/)*
   *Goal: Centralize log management, improve session restoration reliability with full-UI replay mode, and optimize log size via external script/output referencing. Implement transient diagnostic logging for system warnings.*

2. [x] **Track: UI Theme Overhaul & Style System**
   *Link: [./tracks/ui_theme_overhaul_20260308/](./tracks/ui_theme_overhaul_20260308/)*
   *Goal: Modernize UI with Inter/Maple Mono fonts, a professional subtle rounded theme, custom shadesrs (corners, blur, AA), multi-viewport support, and layout presets.*

3. [x] **Track: Selectable GUI Text & UX Improvements**
   *Link: [./tracks/selectable_ui_text_20260308/](./tracks/selectable_ui_text_20260308/)*
   *Goal: Address UI inconveniences by making critical text across the GUI selectable and copyable. Covers discussion history, comms logs, tool outputs, and key metrics.*

4. [x] **Track: Markdown Support & Syntax Highlighting**
   *Link: [./tracks/markdown_highlighting_20260308/](./tracks/markdown_highlighting_20260308/)*
   *Goal: Add rich text rendering with GFM support and syntax highlighting for PowerShell, Python, and JSON/TOML in read-only message and log views.*

5. [x] **Track: NERV UI Theme Integration** (Archived 2026-03-09)

6. [X] **Track: Custom Shader and Window Frame Support** 
   *Link: [./tracks/custom_shaders_20260309/](./tracks/custom_shaders_20260309/)*

7. [x] **Track: UI/UX Improvements - Presets and AI Settings**
   *Link: [./tracks/presets_ai_settings_ux_20260311/](./tracks/presets_ai_settings_ux_20260311/)*
   *Goal: Improve the layout, scaling, and control ergonomics of the Preset windows (Personas, Prompts, Tools) and AI Settings panel. Includes dual-control sliders and categorized tool management.*

8. [x] ~~**Track: Session Context Snapshots & Visibility**~~ (Archived 2026-03-22 - Replaced by discussion_hub_panel_reorganization)
   *Link: [./tracks/session_context_snapshots_20260311/](./tracks/session_context_snapshots_20260311/)*
   *Goal: Session-scoped context management, saving Context Presets, MMA assignment, and agent-focused session filtering in the UI.*

9. [x] ~~**Track: Discussion Takes & Timeline Branching**~~ (Archived 2026-03-22 - Replaced by discussion_hub_panel_reorganization)
   *Link: [./tracks/discussion_takes_branching_20260311/](./tracks/discussion_takes_branching_20260311/)*
   *Goal: Non-linear discussion timelines via tabbed "takes", message branching, and synthesis generation workflows.*

12. [x] **Track: Discussion Hub Panel Reorganization**
    *Link: [./tracks/discussion_hub_panel_reorganization_20260322/](./tracks/discussion_hub_panel_reorganization_20260322/)*
    *Goal: Properly merge Session Hub into Discussion Hub (4 tabs: Discussion | Context Composition | Snapshot | Takes), establish Files & Media as project-level inventory, deprecate ui_summary_only, implement Context Composition and DAW-style Takes.*

10. [ ] **Track: Undo/Redo History Support**
    *Link: [./tracks/undo_redo_history_20260311/](./tracks/undo_redo_history_20260311/)*
    *Goal: Robust, non-provider based undo/redo for text inputs, UI controls, discussion mutations, and context management. Includes hotkey support and a history list view.*

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

---

### Additional Language Support

1. [ ] **Track: Tree-Sitter C/C++ MCP Tools**
   *Link: [./tracks/ts_cpp_tree_sitter_20260308/](./tracks/ts_cpp_tree_sitter_20260308/)*
   *Goal: Add tree-sitter C and C++ grammars. Extend ASTParser to support C/C++ skeleton and outline extraction. Add MCP tools ts_c_get_skeleton, ts_cpp_get_skeleton, ts_c_get_code_outline, ts_cpp_get_code_outline.*

2. [ ] **Track: Bootstrap gencpp Python Bindings**
   *Link: [./tracks/gencpp_python_bindings_20260308/](./tracks/gencpp_python_bindings_20260308/)*
   *Goal: Bootstrap standalone Python project with CFFI bindings for gencpp C library. Provides foundation for richer C++ AST parsing in future (beyond tree-sitter syntax).*

3. [ ] **Track: Tree-Sitter Lua MCP Tools**
   *Link: [./tracks/tree_sitter_lua_mcp_tools_20260310/](./tracks/tree_sitter_lua_mcp_tools_20260310/)*
   *Goal: Add Tree-Sitter Lua MCP tools for structural parsing, documentation extraction, and surgical editing.*

4. [ ] **Track: GDScript Language Support Tools**
   *Link: [./tracks/gdscript_godot_script_language_support_tools_20260310/](./tracks/gdscript_godot_script_language_support_tools_20260310/)*
   *Goal: Add Tree-Sitter GDScript MCP tools for structural parsing, documentation extraction, and surgical editing.*

5. [ ] **Track: C# Language Support Tools**
   *Link: [./tracks/csharp_language_support_tools_20260310/](./tracks/csharp_language_support_tools_20260310/)*
   *Goal: Add Tree-Sitter C# MCP tools for structural parsing, documentation extraction, and surgical editing.*

---

### Manual UX Controls

1. [x] **Track: Saved System Prompt Presets**
   *Link: [./tracks/saved_presets_20260308/](./tracks/saved_presets_20260308/)*
   *Goal: Ability to have saved presets for global and project system prompts. Includes full AI profiles with temperature and top_p settings, managed via a dedicated GUI modal.*

2. [x] **Track: Saved Tool Presets**
   *Link: [./tracks/saved_tool_presets_20260308/](./tracks/saved_tool_presets_20260308/)*
   *Goal: Make agent tools have presets. Add flags for tools related to their level of approval (auto, ask). Move tools to ai settings. Put tools in dynamic TOML-defined categories (Python, General, etc.). Tool Presets added to mma agent role options.*

3. [ ] **Track: External Text Editor Integration for Approvals**
   *Link: [./tracks/external_editor_integration_20260308/](./tracks/external_editor_integration_20260308/)*
   *Goal: Add support to open files modified by agents in external editors (10xNotepad/VSCode) for native diffing and manual editing during the tool approval flow.*

4. [x] **Track: Agent Personas: Unified Profiles & Tool Presets**
   *Link: [./tracks/agent_personas_20260309/](./tracks/agent_personas_20260309/)*
   *Goal: Consolidate model settings, prompts, and tool presets into a unified "Persona" model with granular MMA assignment.*

5. [x] **Track: OpenCode Configuration Overhaul** (Archived 2026-03-10)

6. [ ] **Track: Advanced Workspace Docking & Layout Profiles**
   *Link: [./tracks/workspace_profiles_20260310/](./tracks/workspace_profiles_20260310/)*
   *Goal: Expand layout preset logic to allow users to save and switch between named workspace configurations.*

- [x] **Track: Review investigation of codebase and expose/cull any hidden invisible prompting either from the system or directly that the user cannot handle for any discussion/session.**
*Link: [./tracks/cull_hidden_prompts_20260502/](./tracks/cull_hidden_prompts_20260502/)*

---

### Model Providers

1. [ ] **Track: OpenAI Provider Integration**
    *Link: [./tracks/openai_integration_20260308/](./tracks/openai_integration_20260308/)*
    *Goal: Add support for OpenAI as a first-class model provider (GPT-4o, GPT-4o-mini, o1, o3-mini). Achieve functional parity with Gemini/Anthropic, including Vision, Structured Output, and response streaming.*

2. [ ] **Track: Zhipu AI (GLM) Provider Integration**
    *Link: [./tracks/zhipu_integration_20260308/](./tracks/zhipu_integration_20260308/)*
    *Goal: Add support for Zhipu AI (z.ai) as a first-class model provider (GLM-4, GLM-4-Flash, GLM-4V). Implement core client, vision support, and cost tracking.*

3. [ ] **Track: AI Provider Caching Optimization**
    *Link: [./tracks/caching_optimization_20260308/](./tracks/caching_optimization_20260308/)*
    *Goal: Verify and optimize caching strategies across all providers. Implement 4-breakpoint hierarchy for Anthropic, prefix stabilization for OpenAI/DeepSeek, and hybrid explicit/implicit caching for Gemini. Add GUI hit rate metrics.*

---

## Phase 3: Future Horizons
*Initialized: 2026-03-06*
*Updated: 2026-03-08*

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

---

### Completed / Archived

-. [ ] ~~**Track: Frosted Glass Background Effect**~~ ***NOT WORTH THE PAIN***
    *Link: [./tracks/frosted_glass_20260313/](./tracks/frosted_glass_20260313/)*


- [x] **Track: External MCP Server Support** (Archived 2026-03-12)
- [x] **Track: Project-Specific Conductor Directory** (Archived 2026-03-12)
- [x] **Track: GUI Path Configuration in Context Hub** (Archived 2026-03-12)
- [x] **Track: True Parallel Worker Execution (The DAG Realization)**
- [x] **Track: Deep AST-Driven Context Pruning (RAG for Code)**
- [x] **Track: Visual DAG & Interactive Ticket Editing**
- [x] **Track: Advanced Tier 4 QA Auto-Patching**
- [x] **Track: Transitioning to Native Orchestrator**
- [x] **Track: MiniMax Provider Integration**
- [x] **Track: Cost & Token Analytics Panel**
- [x] **Track: MMA Multi-Worker Visualization**
- [x] **Track: Cache Analytics Display**
- [x] **Track: Tool Usage Analytics**
- [x] **Track: Track Progress Visualization**
- [x] **Track: Manual Skeleton Context Injection**
- [x] **Track: On-Demand Definition Lookup**
- [x] **Track: Manual Ticket Queue Management**
- [x] **Track: Kill/Abort Running Workers**
- [x] **Track: Manual Block/Unblock Control**
- [x] **Track: Pipeline Pause/Resume**
- [x] **Track: Per-Ticket Model Override**
- [x] **Track: Enhanced Context Control & Cache Awareness**
- [x] **Track: GUI Performance Profiling & Optimization**
- [x] **Track: Test Integrity Audit & Intent Documentation**
- [x] **Track: Test Regression Verification**

### Phase 2: Strict Execution Queue (Completed 2026-03-06)

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

- [x] **Track: Hook API UI State Verification**
- [x] **Track: Asyncio Decoupling & Queue Refactor**
- [x] **Track: Mock Provider Hardening**
- [x] **Track: Robust JSON Parsing for Tech Lead**
- [x] **Track: Concurrent Tier Source Isolation**
- [x] **Track: Asynchronous Tool Execution Engine**
- [x] **Track: Simulation Fidelity Enhancement**

### Phase 0: Infrastructure (Critical)

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

### Earlier Archives

- [x] **Track: Test Architecture Integrity Audit**
- [x] **Track: Codebase Migration to src & Cleanup**
- [x] **Track: GUI Decoupling & Controller Architecture**
- [x] **Track: Strict Static Analysis & Type Safety**
- [x] **Track: Test Suite Stabilization & Consolidation**
- [x] **Track: Tech Debt & Test Discipline Cleanup**
- [x] **Track: Conductor Workflow Improvements**
- [x] **Track: MMA Agent Focus UX**
- [x] **Track: Architecture Boundary Hardening**
- [x] **Track: Feature Bleed Cleanup**
- [x] **Track: Context & Token Visualization**
- [x] **Track: Comprehensive Conductor & MMA GUI UX**
- [x] **Track: MMA Pipeline Fix & Worker Stream Verification**
- [x] **Track: Simulation Hardening**
- [x] **Track: Deep Architectural Documentation Refresh**
- [x] **Track: Robust Live Simulation Verification**

---
