chore(conductor): Initialize Phase 5 and curation tracks

This commit is contained in:
2026-05-07 21:49:06 -04:00
parent 89736ebf5a
commit e2dea144bc
9 changed files with 179 additions and 129 deletions
+54 -129
View File
@@ -4,230 +4,155 @@ This file tracks all major tracks for the project. Each track has its own detail
--- ---
## Phase 4: High-Fidelity UX & Tools ## Phase 5: Codebase Curation
*Initialized: 2026-03-08* *Initialized: 2026-05-07*
### Architecture & Backend ### Analysis & Structural Review
1. [ ] **Track: Code Path & Data Pipeline Analysis**
*Link: [./tracks/code_path_analysis_20260507/](./tracks/code_path_analysis_20260507/)*
*Goal: Comprehensive analysis of major processing routes in `./src` and `./simulation`. Identify data pipelines and responsibilities. Map core execution flows to inform curation efforts.*
2. [ ] **Track: Comprehensive Codebase Curation & Style Alignment**
*Link: [./tracks/codebase_curation_20260507/](./tracks/codebase_curation_20260507/)*
*Goal: Exhaustive review of all `.py` files. Remove redundancies, eliminate unnecessary code/data/processing, and strictly align with `product-guidelines.md` and the Python style guide. Focus on performance and maintainability.*
--- ---
### GUI Overhauls & Visualizations ## Remaining Backlog (Phases 3 & 4)
--- 1. [ ] **Track: Bootstrap gencpp Python Bindings**
### Additional Language Support
2. [ ] **Track: Bootstrap gencpp Python Bindings**
*Link: [./tracks/gencpp_python_bindings_20260308/](./tracks/gencpp_python_bindings_20260308/)* *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** 2. [ ] **Track: Tree-Sitter Lua MCP Tools**
*Link: [./tracks/tree_sitter_lua_mcp_tools_20260310/](./tracks/tree_sitter_lua_mcp_tools_20260310/)* *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** 3. [ ] **Track: GDScript Language Support Tools**
*Link: [./tracks/gdscript_godot_script_language_support_tools_20260310/](./tracks/gdscript_godot_script_language_support_tools_20260310/)* *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** 4. [ ] **Track: C# Language Support Tools**
*Link: [./tracks/csharp_language_support_tools_20260310/](./tracks/csharp_language_support_tools_20260310/)* *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.*
--- 5. [ ] **Track: OpenAI Provider Integration**
### Manual UX Controls
5. [x] **Track: OpenCode Configuration Overhaul** (Archived 2026-03-10)
---
### Model Providers
1. [ ] **Track: OpenAI Provider Integration**
*Link: [./tracks/openai_integration_20260308/](./tracks/openai_integration_20260308/)* *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** 6. [ ] **Track: Zhipu AI (GLM) Provider Integration**
*Link: [./tracks/zhipu_integration_20260308/](./tracks/zhipu_integration_20260308/)* *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** 7. [ ] **Track: AI Provider Caching Optimization**
*Link: [./tracks/caching_optimization_20260308/](./tracks/caching_optimization_20260308/)* *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.*
### Testing & Quality 8. [ ] **Track: Manual UX Validation & Review**
---
## 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/)* *Link: [./tracks/manual_ux_validation_20260302/](./tracks/manual_ux_validation_20260302/)*
--- ---
### Completed / Archived
-. [ ] ~~**Track: Frosted Glass Background Effect**~~ ***NOT WORTH THE PAIN***
*Link: [./archive/frosted_glass_20260313/](./archive/frosted_glass_20260313/)*
---
- [x] **Track: Test Regression Verification**
---
## Phase 4 Archive ## 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) 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/)* *Link: [./archive/session_context_snapshots_20260311/](./archive/session_context_snapshots_20260311/)*
*Goal: Session-scoped context management, saving Context Presets, MMA assignment, and agent-focused session filtering in the UI.*
2. [x] ~~**Track: Discussion Takes & Timeline Branching**~~ (Archived 2026-03-22 - Replaced by discussion_hub_panel_reorganization) 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/)* *Link: [./archive/discussion_takes_branching_20260311/](./archive/discussion_takes_branching_20260311/)*
*Goal: Non-linear discussion timelines via tabbed "takes", message branching, and synthesis generation workflows.*
3. [x] **Track: RAG Support** 3. [x] **Track: RAG Support**
*Link: [./archive/rag_support_20260308/](./archive/rag_support_20260308/)* *Link: [./archive/rag_support_20260308/](./archive/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.*
4. [x] **Track: Agent Tool Preference & Bias Tuning**
2. [x] **Track: Agent Tool Preference & Bias Tuning**
*Link: [./archive/tool_bias_tuning_20260308/](./archive/tool_bias_tuning_20260308/)* *Link: [./archive/tool_bias_tuning_20260308/](./archive/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.*
5. [x] **Track: Expanded Hook API & Headless Orchestration**
3. [x] **Track: Expanded Hook API & Headless Orchestration**
*Link: [./archive/hook_api_expansion_20260308/](./archive/hook_api_expansion_20260308/)* *Link: [./archive/hook_api_expansion_20260308/](./archive/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.*
6. [x] **Track: Codebase Audit and Cleanup**
4. [x] **Track: Codebase Audit and Cleanup**
*Link: [./archive/codebase_audit_20260308/](./archive/codebase_audit_20260308/)* *Link: [./archive/codebase_audit_20260308/](./archive/codebase_audit_20260308/)*
7. [x] **Track: Expanded Test Coverage and Stress Testing**
5. [x] **Track: Expanded Test Coverage and Stress Testing**
*Link: [./archive/test_coverage_expansion_20260309/](./archive/test_coverage_expansion_20260309/)* *Link: [./archive/test_coverage_expansion_20260309/](./archive/test_coverage_expansion_20260309/)*
8. [x] **Track: Beads Mode Integration**
6. [x] **Track: Beads Mode Integration**
*Link: [./archive/beads_mode_20260309/](./archive/beads_mode_20260309/)* *Link: [./archive/beads_mode_20260309/](./archive/beads_mode_20260309/)*
*Goal: Integrate Beads (git-backed graph issue tracker) as an alternative backend for MMA implementation tracks and tickets.*
9. [x] **Track: Optimization pass for Data-Oriented Python heuristics**
7. [x] **Track: Optimization pass for Data-Oriented Python heuristics**
*Link: [./archive/data_oriented_optimization_20260312/](./archive/data_oriented_optimization_20260312/)* *Link: [./archive/data_oriented_optimization_20260312/](./archive/data_oriented_optimization_20260312/)*
10. [x] **Track: Rich Thinking Trace Handling**
8. [x] **Track: Rich Thinking Trace Handling** - *Parse and display AI thinking/reasoning traces*
*Link: [./archive/thinking_trace_handling_20260313/](./archive/thinking_trace_handling_20260313/)* *Link: [./archive/thinking_trace_handling_20260313/](./archive/thinking_trace_handling_20260313/)*
11. [x] **Track: Smarter Aggregation with Sub-Agent Summarization**
9. [x] **Track: Smarter Aggregation with Sub-Agent Summarization**
*Link: [./archive/aggregation_smarter_summaries_20260322/](./archive/aggregation_smarter_summaries_20260322/)* *Link: [./archive/aggregation_smarter_summaries_20260322/](./archive/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.*
12. [x] **Track: System Context Exposure**
10. [x] **Track: System Context Exposure**
*Link: [./archive/system_context_exposure_20260322/](./archive/system_context_exposure_20260322/)* *Link: [./archive/system_context_exposure_20260322/](./archive/system_context_exposure_20260322/)*
*Goal: Expose hidden _SYSTEM_PROMPT from ai_client.py to users for customization via AI Settings.*
13. [x] **Track: Advanced Log Management and Session Restoration**
1. [x] **Track: Advanced Log Management and Session Restoration**
*Link: [./archive/log_session_overhaul_20260308/](./archive/log_session_overhaul_20260308/)* *Link: [./archive/log_session_overhaul_20260308/](./archive/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.*
14. [x] **Track: UI Theme Overhaul & Style System**
2. [x] **Track: UI Theme Overhaul & Style System**
*Link: [./archive/ui_theme_overhaul_20260308/](./archive/ui_theme_overhaul_20260308/)* *Link: [./archive/ui_theme_overhaul_20260308/](./archive/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.*
15. [x] **Track: Selectable GUI Text & UX Improvements**
3. [x] **Track: Selectable GUI Text & UX Improvements**
*Link: [./archive/selectable_ui_text_20260308/](./archive/selectable_ui_text_20260308/)* *Link: [./archive/selectable_ui_text_20260308/](./archive/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.*
16. [x] **Track: Markdown Support & Syntax Highlighting**
4. [x] **Track: Markdown Support & Syntax Highlighting**
*Link: [./archive/markdown_highlighting_20260308/](./archive/markdown_highlighting_20260308/)* *Link: [./archive/markdown_highlighting_20260308/](./archive/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.*
17. [X] **Track: Custom Shader and Window Frame Support**
6. [X] **Track: Custom Shader and Window Frame Support**
*Link: [./archive/custom_shaders_20260309/](./archive/custom_shaders_20260309/)* *Link: [./archive/custom_shaders_20260309/](./archive/custom_shaders_20260309/)*
18. [x] **Track: UI/UX Improvements - Presets and AI Settings**
7. [x] **Track: UI/UX Improvements - Presets and AI Settings**
*Link: [./archive/presets_ai_settings_ux_20260311/](./archive/presets_ai_settings_ux_20260311/)* *Link: [./archive/presets_ai_settings_ux_20260311/](./archive/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.*
19. [x] **Track: Discussion Hub Panel Reorganization**
12. [x] **Track: Discussion Hub Panel Reorganization**
*Link: [./archive/discussion_hub_panel_reorganization_20260322/](./archive/discussion_hub_panel_reorganization_20260322/)* *Link: [./archive/discussion_hub_panel_reorganization_20260322/](./archive/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.*
20. [x] **Track: Undo/Redo History Support**
10. [x] **Track: Undo/Redo History Support**
*Link: [./archive/undo_redo_history_20260311/](./archive/undo_redo_history_20260311/)* *Link: [./archive/undo_redo_history_20260311/](./archive/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.*
21. [x] **Track: Advanced Text Viewer with Syntax Highlighting**
11. [x] **Track: Advanced Text Viewer with Syntax Highlighting**
*Link: [./archive/text_viewer_rich_rendering_20260313/](./archive/text_viewer_rich_rendering_20260313/)* *Link: [./archive/text_viewer_rich_rendering_20260313/](./archive/text_viewer_rich_rendering_20260313/)*
22. [x] **Track: Tree-Sitter C/C++ MCP Tools**
1. [x] **Track: Tree-Sitter C/C++ MCP Tools**
*Link: [./archive/ts_cpp_tree_sitter_20260308/](./archive/ts_cpp_tree_sitter_20260308/)* *Link: [./archive/ts_cpp_tree_sitter_20260308/](./archive/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. (Extended: definitions, signatures, and surgical updates).*
23. [x] **Track: Saved System Prompt Presets**
1. [x] **Track: Saved System Prompt Presets**
*Link: [./archive/saved_presets_20260308/](./archive/saved_presets_20260308/)* *Link: [./archive/saved_presets_20260308/](./archive/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.*
24. [x] **Track: Saved Tool Presets**
2. [x] **Track: Saved Tool Presets**
*Link: [./archive/saved_tool_presets_20260308/](./archive/saved_tool_presets_20260308/)* *Link: [./archive/saved_tool_presets_20260308/](./archive/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.*
25. [x] **Track: External Text Editor Integration for Approvals**
3. [x] **Track: External Text Editor Integration for Approvals**
*Link: [./archive/external_editor_integration_20260308/](./archive/external_editor_integration_20260308/)* *Link: [./archive/external_editor_integration_20260308/](./archive/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.*
26. [x] **Track: Agent Personas: Unified Profiles & Tool Presets**
4. [x] **Track: Agent Personas: Unified Profiles & Tool Presets**
*Link: [./archive/agent_personas_20260309/](./archive/agent_personas_20260309/)* *Link: [./archive/agent_personas_20260309/](./archive/agent_personas_20260309/)*
*Goal: Consolidate model settings, prompts, and tool presets into a unified "Persona" model with granular MMA assignment.*
27. [x] **Track: Advanced Workspace Docking & Layout Profiles**
6. [x] **Track: Advanced Workspace Docking & Layout Profiles**
*Link: [./archive/workspace_profiles_20260310/](./archive/workspace_profiles_20260310/)* *Link: [./archive/workspace_profiles_20260310/](./archive/workspace_profiles_20260310/)*
*Goal: Expand layout preset logic to allow users to save and switch between named workspace configurations.*
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/)*
- [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.** 29. [x] **Track: Test Regression Verification**
*Link: [./archive/cull_hidden_prompts_20260502/](./archive/cull_hidden_prompts_20260502/)* *Link: [./archive/test_regression_verification_20260307/](./archive/test_regression_verification_20260307/)*
---
### Phase 2: Strict Execution Queue (Completed 2026-03-06) ### Phase 2: Strict Execution Queue (Completed 2026-03-06)
*See: [./archive/strict_execution_queue_completed_20260306/](./archive/strict_execution_queue_completed_20260306/)* *See: [./archive/strict_execution_queue_completed_20260306/](./archive/strict_execution_queue_completed_20260306/)*
- [x] **Track: Simulation Fidelity Enhancement** ---
### Phase 0: Infrastructure (Critical) ### Phase 0: Infrastructure (Critical)
- [x] **Track: Conductor Path Configuration** - [x] **Track: Conductor Path Configuration**
---
### Earlier Archives ### Earlier Archives
- [x] **Track: Robust Live Simulation Verification** - [x] **Track: Robust Live Simulation Verification**
---
@@ -0,0 +1,5 @@
# Track code_path_analysis_20260507 Context
- [Specification](./spec.md)
- [Implementation Plan](./plan.md)
- [Metadata](./metadata.json)
@@ -0,0 +1,8 @@
{
"track_id": "code_path_analysis_20260507",
"type": "chore",
"status": "new",
"created_at": "2026-05-07T15:00:00Z",
"updated_at": "2026-05-07T15:00:00Z",
"description": "Comprehensive analysis of major processing routes in ./src and ./simulation. Identify data pipelines and responsibilities."
}
@@ -0,0 +1,26 @@
# Implementation Plan: Code Path & Data Pipeline Analysis (code_path_analysis_20260507)
## Phase 1: Structural Exploration & Tooling Setup
- [ ] Task: Initialize `PIPELINE_ANALYSIS.md` template.
- [ ] Task: Deploy `codebase_investigator` subagents to identify top-level entry points in `gui_2.py` and `simulation/`.
- [ ] Task: Verify usage of existing tree-sitter tools to generate initial call-graph skeletons for `./src`.
- [ ] Task: Conductor - User Manual Verification 'Phase 1' (Protocol in workflow.md)
## Phase 2: Mapping Core Source Pipelines (`./src`)
- [ ] Task: Map the **Context Aggregation Pipeline** (`aggregate.py`, `models.py`).
- [ ] Task: Map the **AI Interaction Loop** (`ai_client.py`, `mcp_client.py`, `shell_runner.py`).
- [ ] Task: Map the **GUI Event & State Pipeline** (`gui_2.py`, `app_controller.py`).
- [ ] Task: Document data responsibilities and state boundaries for each route.
- [ ] Task: Conductor - User Manual Verification 'Phase 2' (Protocol in workflow.md)
## Phase 3: Mapping Simulation Pipelines (`./simulation`)
- [ ] Task: Map the **Simulation Lifecycle** (`sim_base.py`, `sim_context.py`, `workflow_sim.py`).
- [ ] Task: Analyze data flow between `sim_ai_settings.py` and the execution engine.
- [ ] Task: Document the "Verification & Checkpointing" route in simulations.
- [ ] Task: Conductor - User Manual Verification 'Phase 3' (Protocol in workflow.md)
## Phase 4: Synthesis & Reporting
- [ ] Task: Consolidate all findings into Mermaid diagrams within `PIPELINE_ANALYSIS.md`.
- [ ] Task: Identify specific "Curation Targets" (redundancies, style violations) for the next track.
- [ ] Task: Final review and hand-off to Track 2 (Codebase Curation).
- [ ] Task: Conductor - User Manual Verification 'Phase 4' (Protocol in workflow.md)
@@ -0,0 +1,27 @@
# Specification: Code Path & Data Pipeline Analysis (code_path_analysis_20260507)
## Overview
A deep architectural audit focused on mapping the "processing routes" and "data pipelines" of the Manual Slop codebase. This analysis will treat the program as a series of data-driven pipelines (similar to Ryan Fleury's model), identifying exactly how data flows through `./src` and `./simulation`.
## Scope
- **Core Codebase:** `./src`
- **Simulation Infrastructure:** `./simulation`
- **Granularity:** Both high-level module interactions and detailed function-to-function execution flows.
## Functional Requirements
1. **Pipeline Mapping:**
- Identify major execution "routes" (e.g., UI Event Loop, AI Tool-Call Loop, Context Aggregation Pipeline).
- Map these routes from entry point to terminal state.
2. **Data Responsibility Audit:**
- For every major path, define which data structures it owns, modifies, or depends upon.
- Identify state boundaries and potential "data leaks" or redundant processing.
3. **Simulation Pipeline Audit:**
- Fully map the lifecycle of a simulation: State Setup -> Agent Injection -> Execution Loop -> Verification -> Cleanup.
4. **Automated Extraction:**
- Utilize MCP tools and potentially custom `tree-sitter` scripts to verify call graphs and data dependencies.
## Acceptance Criteria
- [ ] Comprehensive `PIPELINE_ANALYSIS.md` report created in the root.
- [ ] Mermaid flowcharts documenting every major processing route.
- [ ] Data responsibility table for all mapped paths.
- [ ] Full mapping of the `./simulation` pipeline.
@@ -0,0 +1,5 @@
# Track codebase_curation_20260507 Context
- [Specification](./spec.md)
- [Implementation Plan](./plan.md)
- [Metadata](./metadata.json)
@@ -0,0 +1,8 @@
{
"track_id": "codebase_curation_20260507",
"type": "chore",
"status": "new",
"created_at": "2026-05-07T15:00:00Z",
"updated_at": "2026-05-07T15:00:00Z",
"description": "Exhaustive review of all .py files. Remove redundancies, eliminate unnecessary code/data/processing, and strictly align with project standards."
}
@@ -0,0 +1,23 @@
# Implementation Plan: Comprehensive Codebase Curation & Style Alignment (codebase_curation_20260507)
## Phase 1: Automated Standardization & Audit
- [ ] Task: Run `scripts/ai_style_formatter.py` and `scripts/force_1space.py` on all files in `./src` and `./simulation`.
- [ ] Task: Conduct an automated entropy audit to identify potential redundancy "hotspots".
- [ ] Task: Conductor - User Manual Verification 'Standardization' (Protocol in workflow.md)
## Phase 2: Surgical Curation of `./src`
- [ ] Task: Review and trim `gui_2.py` and `app_controller.py` based on pipeline maps.
- [ ] Task: Consolidate data models in `models.py` and remove redundant state in `aggregate.py`.
- [ ] Task: Refactor `ai_client.py` to ensure lean processing of provider responses.
- [ ] Task: Conductor - User Manual Verification 'Source Curation' (Protocol in workflow.md)
## Phase 3: Surgical Curation of `./simulation`
- [ ] Task: Review and trim `./simulation/` base classes and utility scripts.
- [ ] Task: Eliminate redundant setup logic in `sim_context.py` and `workflow_sim.py`.
- [ ] Task: Conductor - User Manual Verification 'Simulation Curation' (Protocol in workflow.md)
## Phase 4: Final Integrity Pass
- [ ] Task: Verify all tests pass with the trimmed codebase.
- [ ] Task: Final comparison against `product-guidelines.md` for architectural purity.
- [ ] Task: Final performance baseline check to ensure no regressions.
- [ ] Task: Conductor - User Manual Verification 'Final Review' (Protocol in workflow.md)
@@ -0,0 +1,23 @@
# Specification: Comprehensive Codebase Curation & Style Alignment (codebase_curation_20260507)
## Overview
Aggressive pruning, optimization, and standardization of the codebase. This track uses the findings from the Code Path Analysis to trim away non-essential logic, data, and processing while strictly enforcing the project's technical integrity standards.
## Scope
- **Target Files:** All `.py` files in `./src` and `./simulation`.
- **Primary Goal:** Trimming the "slop" (redundancies, dead code, excessive complexity).
## Functional Requirements
1. **Redundancy Pruning:** Eliminate duplicate logic across different data pipelines.
2. **Dead Code Removal:** Strip out legacy "just-in-case" code and unused processing paths.
3. **Strict Style Enforcement:**
- Universal 1-space indentation.
- CRLF line endings.
- Standardized type hinting.
4. **Guideline Alignment:** Refactor any code that deviates from `product-guidelines.md` (e.g., ensuring explicit composition over complex inheritance).
5. **Validation:** Ensure no loss of functionality or performance degradation.
## Acceptance Criteria
- [ ] Significant reduction in total codebase line count (where applicable).
- [ ] 100% pass on style audit (`scripts/ai_style_formatter.py`).
- [ ] All remaining code is mapped to a necessary functional requirement or performance goal.