manual_slop/conductor/tracks/beads_mode_20260309/plan.md

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)