feat(beads): integrate Beads Mode backend, MCP tools, and GUI support

This commit is contained in:
2026-05-06 13:48:47 -04:00
parent b1ddaa50f4
commit 2b66f3569b
17 changed files with 525 additions and 77 deletions
+3
View File
@@ -65,6 +65,9 @@ For deep implementation details when planning or implementing tracks, consult `d
- **Tactile Hotkeys:** Supports industry-standard shortcuts (`Ctrl+Z`, `Ctrl+Y`, `Ctrl+Shift+Z`) for fast, intuitive state navigation.
- **High-Fidelity Selectable UI:** Most read-only labels and logs across the interface (including discussion history, comms payloads, tool outputs, and telemetry metrics) are now implemented as selectable text fields. This enables standard OS-level text selection and copying (Ctrl+C) while maintaining a high-density, non-editable aesthetic.
- **High-Fidelity UI Rendering:** Employs advanced 3x font oversampling and sub-pixel positioning to ensure crisp, high-clarity text rendering across all resolutions, enhancing readability for dense logs and complex code fragments.
- **Workspace Docking & Layout Profiles:** Expands layout management to support named workspace profiles, capturing multi-viewport docking arrangements, window visibility, and internal panel states.
- **Scope Inheritance:** Profiles follow a Global and Project inheritance model, allowing for both universal defaults and project-specific layouts.
- **Contextual Auto-Switch (Experimental):** An opt-in mechanism that automatically binds and loads specific workspace profiles based on the active MMA Tier or task context, dynamically reshaping the UI for the current cognitive load.
- **Enhanced MMA Observability:** Worker streams and ticket previews now support direct text selection, allowing for easy extraction of specific logs or reasoning fragments during parallel execution.
- **Transparent Context Visibility:** A dedicated **Session Hub** exposes the exact aggregated markdown and resolved system prompt sent to the AI.
- **Injection Timeline:** Discussion history visually indicates the precise moments when files or screenshots were injected into the session context.
+2
View File
@@ -50,6 +50,8 @@
- **src/history.py:** Implements the core `HistoryManager` and `UISnapshot` logic for the non-provider undo/redo system. Manages state stacks with a fixed capacity and provides jumping capabilities.
- **src/workspace_manager.py:** Implements the `WorkspaceManager` and `WorkspaceProfile` data models for saving, loading, and merging ImGui docking layouts and window states across global and project-specific configurations.
- **src/paths.py:** Centralized module for path resolution.
- **tree-sitter / AST Parsing:** For deterministic AST parsing and automated generation of curated "Skeleton Views" and "Targeted Views" (extracting specific functions and their dependencies). Supports Python, C, and C++. Features an integrated AST cache with mtime-based invalidation to minimize re-parsing overhead. Supplemented by `SummaryCache` which provides persistent, hash-based (SHA256) caching with LRU eviction for AI-generated file summaries.
- **pydantic / dataclasses:** For defining strict state schemas (Tracks, Tickets) used in linear orchestration.
+1 -1
View File
@@ -28,7 +28,7 @@ This file tracks all major tracks for the project. Each track has its own detail
5. [x] **Track: Expanded Test Coverage and Stress Testing**
*Link: [./tracks/test_coverage_expansion_20260309/](./tracks/test_coverage_expansion_20260309/)*
6. [ ] **Track: Beads Mode Integration**
6. [x] **Track: Beads Mode Integration**
*Link: [./tracks/beads_mode_20260309/](./tracks/beads_mode_20260309/)*
*Goal: Integrate Beads (git-backed graph issue tracker) as an alternative backend for MMA implementation tracks and tickets.*
+18 -18
View File
@@ -1,27 +1,27 @@
# 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)
- [x] Task: Audit existing `AppController` and `project_manager.py` for project mode handling.
- [x] Task: Write Tests: Verify `manual_slop.toml` can parse and store the `execution_mode` (native/beads).
- [x] Task: Implement: Add `execution_mode` toggle to `AppController` state and persistence logic.
- [x] 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)
- [x] Task: Write Tests: Verify a basic Beads/Dolt repository can be initialized and queried via a Python wrapper.
- [x] Task: Implement: Create `src/beads_client.py` to interface with the `bd` CLI or direct Dolt SQL backend.
- [x] Task: Write Tests: Verify agents can create and update Beads using a mock Beads environment.
- [x] Task: Implement: Add a suite of MCP tools (`bd_create`, `bd_update`, `bd_ready`, `bd_list`) to `src/mcp_client.py`.
- [x] 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)
- [x] Task: Write Tests: Verify the Visual DAG can load node data from a non-markdown source (Beads graph).
- [x] Task: Implement: Refactor `_render_mma_dashboard` and the DAG renderer to pull from the active mode's backend.
- [x] Task: Implement: Add a "Beads" tab to the MMA Dashboard for browsing the raw Dolt-backed issue graph.
- [x] Task: Implement: Update Tier Streams to include metadata for Beads-specific status changes.
- [x] 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)
- [x] Task: Write Tests: Verify that "Compaction" correctly summarizes completed Beads into a concise text block.
- [x] Task: Implement: Add Compaction logic to the context aggregation pipeline for Beads Mode.
- [x] 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)