checkpoint on mma overhaul

conductor/product.md

@@ -10,7 +10,13 @@ To serve as an expert-level utility for personal developer use on small projects
 
 ## Key Features
 - **Multi-Provider Integration:** Supports both Gemini and Anthropic with seamless switching.
-- **4-Tier Hierarchical Multi-Model Architecture:** Orchestrates an intelligent cascade of specialized models (Product Manager, Tech Lead, Contributor, QA) to isolate cognitive loads and minimize token burn.
+- **4-Tier Hierarchical Multi-Model Architecture:** Orchestrates an intelligent cascade of specialized models to isolate cognitive loads and minimize token burn.
+  - **Tier 1 (Orchestrator):** Product alignment and high-level strategy using `gemini-3.1-pro-preview`.
+  - **Tier 2 (Tech Lead):** Architectural design and technical planning using `gemini-3-flash-preview`.
+  - **Tier 3 (Worker):** Focused implementation and surgical code changes using `gemini-2.5-flash-lite`.
+  - **Tier 4 (QA):** Bug reproduction, test analysis, and error translation using `gemini-2.5-flash-lite`.
+  - **MMA Delegation Engine:** Utilizes the `mma-exec` CLI and `mma.ps1` helper to route tasks, ensuring each tier receives role-scoped context (e.g., Orchestrators get Product docs; Workers get Workflow specs).
+  - **Role-Scoped Documentation:** Automated mapping of foundational documents to specific tiers to prevent token bloat and maintain high-signal context.
 - **Strict Memory Siloing:** Employs AST-based interface extraction and "Context Amnesia" to provide workers only with the absolute minimum context required, preventing hallucination loops.
 - **Explicit Execution Control:** All AI-generated PowerShell scripts require explicit human confirmation via interactive UI dialogs before execution, supported by a global "Linear Execution Clutch" for deterministic debugging.
 - **Detailed History Management:** Rich discussion history with branching, timestamping, and specific git commit linkage per conversation.

conductor/tech-stack.md

@@ -19,6 +19,9 @@
 - **google-genai:** For Google Gemini API interaction and explicit context caching.
 - **anthropic:** For Anthropic Claude API interaction, supporting ephemeral prompt caching.
 - **Gemini CLI:** Integrated as a headless backend provider, utilizing a custom subprocess adapter and bridge script for tool execution control.
+- **Gemini 3.1 Pro Preview:** Tier 1 Orchestrator model for complex reasoning.
+- **Gemini 3 Flash Preview:** Tier 2 Tech Lead model for rapid architectural planning.
+- **Gemini 2.5 Flash Lite:** High-performance, low-latency model for Tier 3 Workers and Tier 4 QA.
 
 ## Configuration & Tooling
 
@@ -29,6 +32,7 @@
 - **uv:** An extremely fast Python package and project manager.
 - **pytest:** For unit and integration testing, leveraging custom fixtures for live GUI verification.
 - **ApiHookClient:** A dedicated IPC client for automated GUI interaction and state inspection.
+- **mma-exec / mma.ps1:** Python-based execution engine and PowerShell wrapper for managing the 4-Tier MMA hierarchy and automated documentation mapping.
 
 ## Architectural Patterns
 

hello.ps1

@@ -1 +1 @@
-Write-Host "Simulation Test"
+Write-Host "Simulation Test"

project.toml

@@ -15,6 +15,9 @@ paths = []
 base_dir = "."
 paths = []
 
+[gemini_cli]
+binary_path = "gemini"
+
 [agent.tools]
 run_powershell = true
 read_file = true

project_history.toml

@@ -8,5 +8,5 @@ active = "main"
 
 [discussions.main]
 git_commit = ""
-last_updated = "2026-02-25T13:21:57"
+last_updated = "2026-02-25T19:22:00"
 history = []

tests/temp_liveaisettingssim.toml

@@ -19,6 +19,9 @@ paths = []
 base_dir = "."
 paths = []
 
+[gemini_cli]
+binary_path = "gemini"
+
 [agent.tools]
 run_powershell = true
 read_file = true

tests/temp_liveaisettingssim_history.toml

@@ -9,5 +9,5 @@ auto_add = true
 
 [discussions.main]
 git_commit = ""
-last_updated = "2026-02-25T11:18:59"
+last_updated = "2026-02-25T19:20:18"
 history = []

tests/temp_livecontextsim.toml

@@ -19,6 +19,9 @@ paths = []
 base_dir = "."
 paths = []
 
+[gemini_cli]
+binary_path = "gemini"
+
 [agent.tools]
 run_powershell = true
 read_file = true

tests/temp_livecontextsim_history.toml

@@ -5,10 +5,10 @@ roles = [
     "System",
 ]
 history = []
-active = "TestDisc_1772036318"
+active = "TestDisc_1772065200"
 auto_add = true
 
-[discussions.TestDisc_1772036318]
+[discussions.TestDisc_1772065200]
 git_commit = ""
-last_updated = "2026-02-25T11:18:52"
+last_updated = "2026-02-25T19:20:11"
 history = []

tests/temp_liveexecutionsim.toml

@@ -19,6 +19,9 @@ paths = []
 base_dir = "."
 paths = []
 
+[gemini_cli]
+binary_path = "\"C:\\projects\\manual_slop\\.venv\\Scripts\\python.exe\" \"C:\\projects\\manual_slop\\tests\\mock_gemini_cli.py\""
+
 [agent.tools]
 run_powershell = true
 read_file = true

tests/temp_liveexecutionsim_history.toml

@@ -9,5 +9,5 @@ auto_add = true
 
 [discussions.main]
 git_commit = ""
-last_updated = "2026-02-25T11:19:46"
+last_updated = "2026-02-25T19:22:03"
 history = []

tests/temp_livetoolssim.toml

@@ -19,6 +19,9 @@ paths = []
 base_dir = "."
 paths = []
 
+[gemini_cli]
+binary_path = "gemini"
+
 [agent.tools]
 run_powershell = true
 read_file = true

tests/temp_livetoolssim_history.toml

@@ -9,5 +9,5 @@ auto_add = true
 
 [discussions.main]
 git_commit = ""
-last_updated = "2026-02-25T11:19:16"
+last_updated = "2026-02-25T19:20:35"
 history = []

tests/temp_project.toml

@@ -19,6 +19,9 @@ paths = []
 base_dir = "."
 paths = []
 
+[gemini_cli]
+binary_path = "gemini"
+
 [agent.tools]
 run_powershell = true
 read_file = true
@@ -27,6 +30,3 @@ search_files = true
 get_file_summary = true
 web_search = true
 fetch_url = true
-
-[gemini_cli]
-binary_path = "\"C:\\projects\\manual_slop\\.venv\\Scripts\\python.exe\" \"C:\\projects\\manual_slop\\tests\\mock_gemini_cli.py\""

tests/temp_project_history.toml

@@ -4,85 +4,10 @@ roles = [
     "Vendor API",
     "System",
 ]
-active = "testing gemini cli 2"
+active = "main"
 auto_add = true
 
 [discussions.main]
 git_commit = ""
-last_updated = "2026-02-25T18:29:54"
+last_updated = "2026-02-25T19:22:56"
-history = [
+history = []
-    "@1772042443.1159382\nUser:\nStress test entry 0 Stress test entry 0 Stress test entry 0 Stress test entry 0 Stress test entry 0",
-    "@1772042443.1159382\nUser:\nStress test entry 1 Stress test entry 1 Stress test entry 1 Stress test entry 1 Stress test entry 1",
-    "@1772042443.1159382\nUser:\nStress test entry 2 Stress test entry 2 Stress test entry 2 Stress test entry 2 Stress test entry 2",
-    "@1772042443.1159382\nUser:\nStress test entry 3 Stress test entry 3 Stress test entry 3 Stress test entry 3 Stress test entry 3",
-    "@1772042443.1159382\nUser:\nStress test entry 4 Stress test entry 4 Stress test entry 4 Stress test entry 4 Stress test entry 4",
-    "@1772042443.1159382\nUser:\nStress test entry 5 Stress test entry 5 Stress test entry 5 Stress test entry 5 Stress test entry 5",
-    "@1772042443.1159382\nUser:\nStress test entry 6 Stress test entry 6 Stress test entry 6 Stress test entry 6 Stress test entry 6",
-    "@1772042443.1159382\nUser:\nStress test entry 7 Stress test entry 7 Stress test entry 7 Stress test entry 7 Stress test entry 7",
-    "@1772042443.1159382\nUser:\nStress test entry 8 Stress test entry 8 Stress test entry 8 Stress test entry 8 Stress test entry 8",
-    "@1772042443.1159382\nUser:\nStress test entry 9 Stress test entry 9 Stress test entry 9 Stress test entry 9 Stress test entry 9",
-    "@1772042443.1159382\nUser:\nStress test entry 10 Stress test entry 10 Stress test entry 10 Stress test entry 10 Stress test entry 10",
-    "@1772042443.1159382\nUser:\nStress test entry 11 Stress test entry 11 Stress test entry 11 Stress test entry 11 Stress test entry 11",
-    "@1772042443.1159382\nUser:\nStress test entry 12 Stress test entry 12 Stress test entry 12 Stress test entry 12 Stress test entry 12",
-    "@1772042443.1159382\nUser:\nStress test entry 13 Stress test entry 13 Stress test entry 13 Stress test entry 13 Stress test entry 13",
-    "@1772042443.1159382\nUser:\nStress test entry 14 Stress test entry 14 Stress test entry 14 Stress test entry 14 Stress test entry 14",
-    "@1772042443.1159382\nUser:\nStress test entry 15 Stress test entry 15 Stress test entry 15 Stress test entry 15 Stress test entry 15",
-    "@1772042443.1159382\nUser:\nStress test entry 16 Stress test entry 16 Stress test entry 16 Stress test entry 16 Stress test entry 16",
-    "@1772042443.1159382\nUser:\nStress test entry 17 Stress test entry 17 Stress test entry 17 Stress test entry 17 Stress test entry 17",
-    "@1772042443.1159382\nUser:\nStress test entry 18 Stress test entry 18 Stress test entry 18 Stress test entry 18 Stress test entry 18",
-    "@1772042443.1159382\nUser:\nStress test entry 19 Stress test entry 19 Stress test entry 19 Stress test entry 19 Stress test entry 19",
-    "@1772042443.1159382\nUser:\nStress test entry 20 Stress test entry 20 Stress test entry 20 Stress test entry 20 Stress test entry 20",
-    "@1772042443.1159382\nUser:\nStress test entry 21 Stress test entry 21 Stress test entry 21 Stress test entry 21 Stress test entry 21",
-    "@1772042443.1159382\nUser:\nStress test entry 22 Stress test entry 22 Stress test entry 22 Stress test entry 22 Stress test entry 22",
-    "@1772042443.1159382\nUser:\nStress test entry 23 Stress test entry 23 Stress test entry 23 Stress test entry 23 Stress test entry 23",
-    "@1772042443.1159382\nUser:\nStress test entry 24 Stress test entry 24 Stress test entry 24 Stress test entry 24 Stress test entry 24",
-    "@1772042443.1159382\nUser:\nStress test entry 25 Stress test entry 25 Stress test entry 25 Stress test entry 25 Stress test entry 25",
-    "@1772042443.1159382\nUser:\nStress test entry 26 Stress test entry 26 Stress test entry 26 Stress test entry 26 Stress test entry 26",
-    "@1772042443.1159382\nUser:\nStress test entry 27 Stress test entry 27 Stress test entry 27 Stress test entry 27 Stress test entry 27",
-    "@1772042443.1159382\nUser:\nStress test entry 28 Stress test entry 28 Stress test entry 28 Stress test entry 28 Stress test entry 28",
-    "@1772042443.1159382\nUser:\nStress test entry 29 Stress test entry 29 Stress test entry 29 Stress test entry 29 Stress test entry 29",
-    "@1772042443.1159382\nUser:\nStress test entry 30 Stress test entry 30 Stress test entry 30 Stress test entry 30 Stress test entry 30",
-    "@1772042443.1159382\nUser:\nStress test entry 31 Stress test entry 31 Stress test entry 31 Stress test entry 31 Stress test entry 31",
-    "@1772042443.1159382\nUser:\nStress test entry 32 Stress test entry 32 Stress test entry 32 Stress test entry 32 Stress test entry 32",
-    "@1772042443.1159382\nUser:\nStress test entry 33 Stress test entry 33 Stress test entry 33 Stress test entry 33 Stress test entry 33",
-    "@1772042443.1159382\nUser:\nStress test entry 34 Stress test entry 34 Stress test entry 34 Stress test entry 34 Stress test entry 34",
-    "@1772042443.1159382\nUser:\nStress test entry 35 Stress test entry 35 Stress test entry 35 Stress test entry 35 Stress test entry 35",
-    "@1772042443.1159382\nUser:\nStress test entry 36 Stress test entry 36 Stress test entry 36 Stress test entry 36 Stress test entry 36",
-    "@1772042443.1159382\nUser:\nStress test entry 37 Stress test entry 37 Stress test entry 37 Stress test entry 37 Stress test entry 37",
-    "@1772042443.1159382\nUser:\nStress test entry 38 Stress test entry 38 Stress test entry 38 Stress test entry 38 Stress test entry 38",
-    "@1772042443.1159382\nUser:\nStress test entry 39 Stress test entry 39 Stress test entry 39 Stress test entry 39 Stress test entry 39",
-    "@1772042443.1159382\nUser:\nStress test entry 40 Stress test entry 40 Stress test entry 40 Stress test entry 40 Stress test entry 40",
-    "@1772042443.1159382\nUser:\nStress test entry 41 Stress test entry 41 Stress test entry 41 Stress test entry 41 Stress test entry 41",
-    "@1772042443.1159382\nUser:\nStress test entry 42 Stress test entry 42 Stress test entry 42 Stress test entry 42 Stress test entry 42",
-    "@1772042443.1159382\nUser:\nStress test entry 43 Stress test entry 43 Stress test entry 43 Stress test entry 43 Stress test entry 43",
-    "@1772042443.1159382\nUser:\nStress test entry 44 Stress test entry 44 Stress test entry 44 Stress test entry 44 Stress test entry 44",
-    "@1772042443.1159382\nUser:\nStress test entry 45 Stress test entry 45 Stress test entry 45 Stress test entry 45 Stress test entry 45",
-    "@1772042443.1159382\nUser:\nStress test entry 46 Stress test entry 46 Stress test entry 46 Stress test entry 46 Stress test entry 46",
-    "@1772042443.1159382\nUser:\nStress test entry 47 Stress test entry 47 Stress test entry 47 Stress test entry 47 Stress test entry 47",
-    "@1772042443.1159382\nUser:\nStress test entry 48 Stress test entry 48 Stress test entry 48 Stress test entry 48 Stress test entry 48",
-    "@1772042443.1159382\nUser:\nStress test entry 49 Stress test entry 49 Stress test entry 49 Stress test entry 49 Stress test entry 49",
-]
-
-[discussions."testing gemini cli"]
-git_commit = ""
-last_updated = "2026-02-25T18:29:49"
-history = [
-    "@2026-02-25T14:38:14\nUser:\nyo gemini cli you there?",
-    "@2026-02-25T14:38:21\nAI:\nTool execution was denied. Decision: deny",
-    "@2026-02-25T14:39:03\nSystem:\n[PERFORMANCE ALERT] Frame time high: 7956.5ms. Please consider optimizing recent changes or reducing load.",
-    "@2026-02-25T14:39:42\nSystem:\n[PERFORMANCE ALERT] Frame time high: 9193.6ms. Please consider optimizing recent changes or reducing load.",
-    "@2026-02-25T14:41:03\nSystem:\n[PERFORMANCE ALERT] Frame time high: 6645.0ms. Please consider optimizing recent changes or reducing load.",
-    "@2026-02-25T14:41:37\nSystem:\n[PERFORMANCE ALERT] Frame time high: 10553.5ms. Please consider optimizing recent changes or reducing load.",
-]
-
-[discussions."testing gemini cli 2"]
-git_commit = ""
-last_updated = "2026-02-25T18:38:17"
-history = [
-    "@2026-02-25T18:35:22\nAI:\nTool execution was denied. Decision: deny",
-    "@2026-02-25T18:35:44\nUser:\nPlease read test.txt",
-    "@2026-02-25T18:35:45\nAI:\nI read the file. It contains: 'Hello from mock!'",
-    "@2026-02-25T18:35:46\nUser:\nDeny me",
-    "@2026-02-25T18:35:46\nAI:\nTool execution was denied. Decision: deny",
-    "@2026-02-25T18:38:17\nUser:\nDeny me",
-]