2292087ea8
## Issue Worker starvation alert triggered despite 18 open beads existing. ## Root Cause Ready queue was stale (last updated 2026-03-04T14:03:40) while new frankentui migration epic (bd-2gy) and child tasks were created on 2026-03-05. Worker couldn't find work because queue wasn't regenerated. ## Resolution 1. Closed bd-yxm as FALSE POSITIVE - work exists 2. Regenerated ready-queue.json (now shows 11 ready beads) 3. Updated ROADMAP.md to reflect Phase 5: Frankentui Migration ## Key Metrics - Open beads: 17 (11 ready with no blockers) - Closed beads: 165 - Project completion: ~91% (Phase 5 in progress) 🤖 Generated with [Claude Code](https://claude.ai/code) Co-Authored-By: Claude <noreply@anthropic.com>
175 lines
6.4 KiB
Markdown
175 lines
6.4 KiB
Markdown
# FABRIC Implementation Roadmap
|
|
|
|
## Overview
|
|
|
|
This roadmap outlines the implementation plan for FABRIC (Flow Analysis & Bead Reporting Interface Console). Features are organized into phases with clear priorities.
|
|
|
|
## Current Status (Updated: 2026-03-05)
|
|
|
|
| Metric | Count |
|
|
|--------|-------|
|
|
| **Open beads** | 17 |
|
|
| **Closed beads** | 165 |
|
|
| **Completion** | ~91% (Phase 5 in progress) |
|
|
|
|
### Completion by Priority
|
|
| Priority | Open | Description |
|
|
|----------|------|-------------|
|
|
| P0 | 1 | TUI color verification |
|
|
| P1 | 15 | Frankentui migration tasks |
|
|
| P2 | 1 | Epic tracking |
|
|
|
|
**Completed:**
|
|
- Phase 1: Core Infrastructure ✅ COMPLETE
|
|
- types.ts - Core type definitions
|
|
- parser.ts - Log line parsing
|
|
- store.ts - In-memory event store
|
|
- tailer.ts - Log file tailing
|
|
- cli.ts - Command-line interface
|
|
- index.ts - Main exports
|
|
- Basic test coverage
|
|
|
|
- Phase 2: TUI Implementation ✅ COMPLETE
|
|
- P0: Setup blessed TUI framework
|
|
- P1: Worker Grid Panel
|
|
- P1: Activity Stream Panel
|
|
- P2: Worker Detail View
|
|
- P2: Keyboard Navigation
|
|
- P3: Stuck Detection (src/tui/utils/stuckDetection.ts)
|
|
- P3: Inline Diff View (src/tui/components/DiffView.ts)
|
|
- P4: Command Palette
|
|
- P4: Cost Tracking (src/tui/utils/costTracking.ts)
|
|
|
|
- Phase 3: Web Dashboard ✅ COMPLETE (2026-03-03)
|
|
- P1: Express HTTP server with static file serving (src/web/server.ts)
|
|
- P1: WebSocket server for real-time updates
|
|
- P1: React frontend scaffold with Vite (src/web/frontend/)
|
|
- P1: WorkerGrid component for web
|
|
- P1: ActivityStream component for web
|
|
- P1: Web command added to CLI
|
|
- Dark theme styling
|
|
|
|
- Phase 3.5: Intelligence Features ✅ COMPLETE
|
|
- ✅ DependencyDag TUI component
|
|
- ✅ GitIntegration TUI panel
|
|
- ✅ SessionDigest TUI component
|
|
- ✅ CollisionAlert integration
|
|
- ✅ Semantic narrative summarization
|
|
- ✅ Conversation parsing
|
|
- ✅ Git status and diff parsing
|
|
|
|
**In Progress:**
|
|
- Phase 5: Frankentui Migration (Rust Rewrite) 🔄 IN PROGRESS
|
|
- Epic: bd-2gy - Migrate FABRIC TUI from blessed.js to frankentui
|
|
- P0: bd-2b3 - Verify TUI renders colors correctly in tmux session
|
|
- P1: bd-3a1 - Set up Rust workspace for fabric-tui crate
|
|
- P1: bd-1h9 - Define FABRIC data types in Rust
|
|
- P1: bd-21r - Implement log parser in Rust (NEEDLE JSON format)
|
|
- P1: bd-2dr - Create WorkerGrid widget using frankentui
|
|
- P1: bd-2kq - Create ActivityStream widget using frankentui
|
|
- P1: bd-3p3 - Create WorkerDetail panel using frankentui
|
|
- P1: bd-1q7 - Implement keyboard navigation
|
|
- P1: bd-2xf - Add file tailing with async log ingestion
|
|
- P1: bd-2zy - Build and package fabric-tui binary
|
|
- E2E Tests: bd-129, bd-1j9, bd-29t, bd-2wk, bd-2x9, bd-v4r, bd-3rf
|
|
|
|
**Remaining (Untracked):**
|
|
- Phase 4+ Intelligence Features are nice-to-have and not tracked as beads
|
|
|
|
## Phase 2: TUI Implementation
|
|
|
|
### Priority Order
|
|
|
|
| Priority | Feature | Description | Effort |
|
|
|----------|---------|-------------|--------|
|
|
| P0 | **Setup blessed** | Add blessed library for TUI framework | Low |
|
|
| P1 | **Worker Grid Panel** | Display all active workers with status | Medium |
|
|
| P1 | **Activity Stream Panel** | Scrolling log output with filtering | Medium |
|
|
| P2 | **Worker Detail View** | Detailed view for single worker | Medium |
|
|
| P2 | **Keyboard Navigation** | j/k scroll, / search, Tab switch, q quit | Low |
|
|
| P3 | **Stuck Detection** | Detect workers spinning their wheels | Medium |
|
|
| P3 | **Inline Diff View** | Show diffs in Edit tool calls | Medium |
|
|
| P4 | **Command Palette** | Ctrl+K universal search | Medium |
|
|
| P4 | **Cost Tracking** | Token usage and budget alerts | Medium |
|
|
|
|
### Implementation Approach
|
|
|
|
1. Use [blessed](https://github.com/chjj2000/blessed) for terminal UI
|
|
2. Create modular components in `src/tui/` directory
|
|
3. Each feature gets its own file
|
|
4. Shared state management via store
|
|
|
|
### TUI Architecture
|
|
|
|
```
|
|
src/
|
|
├── tui/
|
|
│ ├── index.ts # TUI entry point
|
|
│ ├── app.ts # Main application class
|
|
│ ├── components/
|
|
│ │ ├── WorkerGrid.ts # Worker status grid
|
|
│ │ ├── ActivityStream.ts # Log stream panel
|
|
│ │ ├── WorkerDetail.ts # Worker detail view
|
|
│ │ ├── CommandPalette.ts # Ctrl+K search
|
|
│ │ └── DiffView.ts # Inline diff display
|
|
│ ├── screens/
|
|
│ │ ├── MainScreen.ts # Main dashboard view
|
|
│ │ └── DetailScreen.ts # Worker detail screen
|
|
│ └── utils/
|
|
│ ├── colors.ts # Color scheme
|
|
│ └── keyboard.ts # Key bindings
|
|
└── ...
|
|
```
|
|
|
|
## Phase 3: Web Dashboard ✅ COMPLETE
|
|
|
|
| Priority | Feature | Description | Status |
|
|
|----------|---------|-------------|--------|
|
|
| P1 | **HTTP Server** | Express server with static file serving | ✅ Done |
|
|
| P1 | **WebSocket** | Real-time updates via ws | ✅ Done |
|
|
| P1 | **React Frontend** | Browser UI with Vite build | ✅ Done |
|
|
| P1 | **Worker Grid** | Worker cards with status | ✅ Done |
|
|
| P1 | **Activity Stream** | Real-time event feed | ✅ Done |
|
|
| P1 | **CLI Web Command** | `fabric web` starts server | ✅ Done |
|
|
|
|
**Implementation Files:**
|
|
- `src/web/server.ts` - Express + WebSocket server
|
|
- `src/web/frontend/src/App.tsx` - Main React app with WebSocket
|
|
- `src/web/frontend/src/components/WorkerGrid.tsx` - Worker cards
|
|
- `src/web/frontend/src/components/ActivityStream.tsx` - Event stream
|
|
- `src/web/frontend/src/index.css` - Dark theme styling
|
|
- `vite.config.ts` - Build configuration
|
|
|
|
## Phase 3.5: Web Frontend Parity ✅ COMPLETE
|
|
|
|
| Priority | Feature | Description | Bead | Status |
|
|
|----------|---------|-------------|------|--------|
|
|
| P2 | Parser Tests | Unit tests for parser.ts | bd-1a2 | ✅ Closed |
|
|
| P2 | Store Tests | Unit tests for store.ts | bd-2en | ✅ Closed |
|
|
| P2 | Worker Overview Cards | Enhanced worker cards component | bd-31n | ✅ Closed |
|
|
| P2 | Activity Feed Filtering | Filter activity feed by worker/type | bd-1wo | ✅ Closed |
|
|
|
|
## Intelligence Features (Phase 4+)
|
|
|
|
These can be added incrementally after core UI is working:
|
|
|
|
- Cross-Reference Hyperlinking
|
|
- Worker Collision Detection
|
|
- Session Replay
|
|
- Smart Error Grouping
|
|
- Task Dependency DAG
|
|
- File Heatmap
|
|
- Recovery Playbook
|
|
|
|
## Quick Start for Workers
|
|
|
|
1. Start with P0: Setup blessed
|
|
2. Then P1: Worker Grid Panel
|
|
3. Then P1: Activity Stream Panel
|
|
4. Continue through priority order
|
|
|
|
## Testing Strategy
|
|
|
|
- Unit tests for each component
|
|
- Integration tests for TUI workflows
|
|
- Visual testing with sample log files
|