# Implementation Plan: Beads Mode Integration ## Phase 1: Environment & Core Configuration - [ ] Task: Audit existing `AppController` and `project_manager.py` for project mode handling. - [ ] Task: Write Tests: Verify `manual_slop.toml` can parse and store the `execution_mode` (native/beads). - [ ] Task: Implement: Add `execution_mode` toggle to `AppController` state and persistence logic. - [ ] Task: Conductor - User Manual Verification 'Phase 1: Environment & Core Configuration' (Protocol in workflow.md) ## Phase 2: Beads Backend & Tooling - [ ] Task: Write Tests: Verify a basic Beads/Dolt repository can be initialized and queried via a Python wrapper. - [ ] Task: Implement: Create `src/beads_client.py` to interface with the `bd` CLI or direct Dolt SQL backend. - [ ] Task: Write Tests: Verify agents can create and update Beads using a mock Beads environment. - [ ] Task: Implement: Add a suite of MCP tools (`bd_create`, `bd_update`, `bd_ready`, `bd_list`) to `src/mcp_client.py`. - [ ] Task: Conductor - User Manual Verification 'Phase 2: Beads Backend & Tooling' (Protocol in workflow.md) ## Phase 3: GUI Integration & Visual DAG - [ ] Task: Write Tests: Verify the Visual DAG can load node data from a non-markdown source (Beads graph). - [ ] Task: Implement: Refactor `_render_mma_dashboard` and the DAG renderer to pull from the active mode's backend. - [ ] Task: Implement: Add a "Beads" tab to the MMA Dashboard for browsing the raw Dolt-backed issue graph. - [ ] Task: Implement: Update Tier Streams to include metadata for Beads-specific status changes. - [ ] Task: Conductor - User Manual Verification 'Phase 3: GUI Integration & Visual DAG' (Protocol in workflow.md) ## Phase 4: Context Optimization & Polish - [ ] Task: Write Tests: Verify that "Compaction" correctly summarizes completed Beads into a concise text block. - [ ] Task: Implement: Add Compaction logic to the context aggregation pipeline for Beads Mode. - [ ] Task: Implement: Final UI polish, icons for Bead nodes, and robust error handling for missing `dolt`/`bd` binaries. - [ ] Task: Conductor - User Manual Verification 'Phase 4: Context Optimization & Polish' (Protocol in workflow.md)