351 lines
19 KiB
Markdown
351 lines
19 KiB
Markdown
# Project Tracks
|
|
|
|
This file tracks all major tracks for the project. Each track has its own detailed plan in its respective folder.
|
|
|
|
---
|
|
|
|
## Phase 6: Context Composition Redesign
|
|
|
|
*Initialized: 2026-05-10*
|
|
|
|
### 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.*
|
|
|
|
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.*
|
|
|
|
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.*
|
|
|
|
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.*
|
|
|
|
13. [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.*
|
|
|
|
14. [x] **Track: I started to do a large cleanup to ./src/gui_2.py. I want you to study it and derive more information on how to maintain and write code for the python codebase. Please update product guidlines or the python code_styleguidleines based on what you discover. Also we may need to make some changes the mcp_tools for better structural awareness of annotations or other conventions with these python files. There is still more orgnaizatoin to be done like annotation/organizing the __init__ method's declarations, among other nitpicks.**
|
|
*Link: [./archive/gui_2_cleanup_20260513/](./archive/gui_2_cleanup_20260513/)*
|
|
---
|
|
|
|
15. [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/)*
|
|
|
|
---
|
|
|
|
## Hot Reload Feature
|
|
|
|
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 5: Codebase Curation
|
|
|
|
*Initialized: 2026-05-07*
|
|
|
|
### 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.*
|
|
|
|
- [x] **Track: Fix 45 failing test files across 12 batches**
|
|
*Link: [./archive/fix_test_suite_failures_20260514/](./archive/fix_test_suite_failures_20260514/)*
|
|
|
|
- [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.*
|
|
|
|
---
|
|
|
|
## 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**
|
|
|
|
---
|
|
|
|
### Recent Completed Tracks (2026-05+)
|
|
|
|
*Archived 2026-06-03 via `archive_completed_tracks_20260603`. All directories moved from `tracks/` to `archive/`.*
|
|
|
|
- [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: 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/)*
|
|
|
|
---
|
|
|
|
- [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.*
|