# 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: External MCP Server Support**
   *Link: [./tracks/external_mcp_support_20260308/](./tracks/external_mcp_support_20260308/)*
   *Goal: Add support for external MCP servers (Local Stdio and Remote SSE/WS) with flexible configuration and lifecycle management (including auto-start on project load).*

2. [ ] **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.*

3. [ ] **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.*

4. [ ] **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.*

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

---

### GUI Overhauls & Visualizations

3. [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. [ ] **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 shaders (corners, blur, AA), multi-viewport support, and layout presets.*

3. [ ] **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. [ ] **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.*

---

### C/C++ 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).*

---

### Path Configuration

1. [ ] **Track: Project-Specific Conductor Directory**
   *Link: [./tracks/project_conductor_dir_20260308/](./tracks/project_conductor_dir_20260308/)*
   *Goal: Make conductor directory per-project. Each project TOML can specify custom conductor dir for isolated track/state management.*

2. [ ] **Track: GUI Path Configuration in Context Hub**
   *Link: [./tracks/gui_path_config_20260308/](./tracks/gui_path_config_20260308/)*
   *Goal: Add path configuration UI to Context Hub. Allow users to view and edit configurable paths directly from the GUI.*
---

### Manual UX Controls

1. [ ] **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. [ ] **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.*

---

### 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

### Phase 3: Early Tracks (Archived 2026-03-08)

- [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**

---