FABRIC/docs/gap-analysis.md

# FABRIC Gap Analysis

**Generated:** 2026-03-07
**Original Bead:** bd-muv

This document compares the FABRIC implementation against docs/plan.md to identify missing features.

## Implementation Status Summary

### Phase 1: Core Infrastructure ✅ COMPLETE
| Feature | File | Status |
|---------|------|--------|
| Log Tailer | src/tailer.ts | ✅ |
| JSON Parser | src/parser.ts | ✅ |
| Event Store | src/store.ts | ✅ |
| Type Definitions | src/types.ts | ✅ |

### Phase 2: TUI Display ✅ COMPLETE
| Feature | File | Status |
|---------|------|--------|
| Worker Grid | src/tui/components/WorkerGrid.ts | ✅ |
| Activity Stream | src/tui/components/ActivityStream.ts | ✅ |
| Worker Detail | src/tui/components/WorkerDetail.ts | ✅ |
| Command Palette | src/tui/components/CommandPalette.ts | ✅ |
| Keyboard Navigation | src/tui/utils/keyboard.ts | ✅ |
| Focus Mode | src/tui/app.ts | ✅ |

### Phase 3: Web Display ✅ COMPLETE
| Feature | File | Status |
|---------|------|--------|
| HTTP Server | src/web/server.ts | ✅ |
| WebSocket Streaming | src/web/server.ts | ✅ |
| React Frontend | src/web/frontend/src/App.tsx | ✅ |
| Worker Cards | src/web/frontend/src/components/WorkerGrid.tsx | ✅ |
| Activity Feed | src/web/frontend/src/components/ActivityStream.tsx | ✅ |
| Focus Mode | src/web/frontend/src/App.tsx | ✅ |

### Phase 4: Intelligence Features (Core) ✅ COMPLETE
| Feature | File | Status |
|---------|------|--------|
| Cross-Reference Hyperlinking | src/tui/components/CrossReferencePanel.ts | ✅ |
| Inline Diff View | src/tui/components/DiffView.ts | ✅ |
| File Activity Heatmap | src/tui/components/FileHeatmap.ts | ✅ |
| Cost & Token Tracking | src/tui/utils/costTracking.ts | ✅ |
| Conversation Transcript | src/tui/components/ConversationTranscript.ts | ✅ |

### Phase 5: Intelligence Features (Detection) ✅ COMPLETE
| Feature | File | Status |
|---------|------|--------|
| Stuck Detection | src/tui/utils/stuckDetection.ts | ✅ |
| Loop Detection | src/tui/utils/stuckDetection.ts | ✅ |
| Worker Collision Detection | src/tui/components/CollisionAlert.ts | ✅ |
| Smart Error Grouping | src/tui/components/ErrorGroupPanel.ts | ✅ |
| Semantic Narrative | src/tui/components/SemanticNarrativePanel.ts | ✅ |

### Phase 6: Context & Integration ✅ COMPLETE
| Feature | File | Status |
|---------|------|--------|
| Git Integration | src/tui/components/GitIntegration.ts | ✅ |
| Session Digest | src/tui/components/SessionDigest.ts | ✅ |
| Worker Analytics | src/tui/components/WorkerAnalyticsPanel.ts | ✅ |

### Phase 7: Advanced Features ✅ COMPLETE
| Feature | File | Status |
|---------|------|--------|
| Session Replay | src/tui/components/SessionReplay.ts | ✅ |
| Task Dependency DAG | src/tui/components/DependencyDag.ts | ✅ |
| Recovery Playbook | src/tui/components/RecoveryPanel.ts | ✅ |

---

## Identified Gaps

The following features from plan.md are missing or incomplete:

### P1 - Critical

| Bead ID | Feature | Description |
|---------|---------|-------------|
| bd-art | SQLite Historical Analytics | Persistent storage for worker metrics and error history |
| bd-hn5 | Budget Alerts & Projections | Real-time budget alerts at 80%/95% thresholds |
| bd-257 | Web Auto-Reconnect | Robust WebSocket reconnection with exponential backoff |

### P2 - High Priority

| Bead ID | Feature | Description |
|---------|---------|-------------|
| bd-40a | Web Timeline Visualization | Horizontal timeline showing worker activity over time |
| bd-iyz | Anomaly Detection | Detect unexpected file activity patterns |
| bd-1o0 | Command Palette Fuzzy Search | Fuzzy matching with recent commands history |
| bd-3o4 | Git PR Preview | Generate PR title/description preview from commits |
| bd-2u6 | File Context Panel | Split view showing file contents alongside activity |

### P3 - Nice to Have

| Bead ID | Feature | Description |
|---------|---------|-------------|
| bd-2r0 | Focus Mode Presets | Save/load pin configurations |
| bd-2ot | Theme Support | Dark/light theme switching |
| bd-1dq | Export Session Replay | Export replay as shareable link or file |

---

## Cross-Repo Dependencies

None identified. All FABRIC features are self-contained within this workspace.

---

## Dependency Graph

```
bd-muv (Gap Analysis - Original Task)
├── bd-40a (Web Timeline Visualization)
├── bd-hn5 (Budget Alerts & Projections)
├── bd-iyz (Anomaly Detection)
├── bd-257 (Web Auto-Reconnect)
├── bd-2r0 (Focus Mode Presets)
├── bd-1o0 (Command Palette Fuzzy Search)
├── bd-2ot (Theme Support)
├── bd-1dq (Export Session Replay)
├── bd-3o4 (Git PR Preview)
├── bd-art (SQLite Historical Analytics)
└── bd-2u6 (File Context Panel)
```

---

## Recommendations

1. **Priority Order:** Implement P1 items first (SQLite, Budget Alerts, Auto-Reconnect) as they are foundational for other features.

2. **SQLite First:** The SQLite storage (bd-art) is a blocker for:
   - Historical worker analytics comparisons
   - Recovery playbook pattern matching
   - Budget projections over time

3. **Web Parity:** The web frontend is missing several TUI features:
   - Timeline visualization (bd-40a)
   - File context panel (bd-2u6)
   - PR preview (bd-3o4)

4. **User Experience:** Fuzzy search (bd-1o0) and presets (bd-2r0) significantly improve daily usage.

---

## Files Reviewed

- docs/plan.md (1435 lines)
- src/types.ts (core types)
- src/cli.ts (commands)
- src/tui/app.ts (TUI main)
- src/web/server.ts (web backend)
- src/web/frontend/src/App.tsx (web frontend)
- src/tui/utils/stuckDetection.ts
- src/tui/utils/recoveryPlaybook.ts
- src/web/frontend/src/components/RecoveryPanel.tsx

---

## Conclusion

FABRIC is approximately **90% complete** against the plan.md specification. The core architecture and most intelligence features are fully implemented. The main gaps are:

1. **Persistence layer** - SQLite for historical analytics
2. **Alerting system** - Budget alerts and anomaly detection
3. **Web UX polish** - Timeline, auto-reconnect, file context panel
4. **Convenience features** - Presets, themes, fuzzy search

All identified gaps have corresponding beads created and linked to this analysis via dependencies.