FABRIC (moved from ex44; canonical on git.ardenone.com, mirrors to github.com/jedarden)
1a331eafaa
Add ConversationEvent types and parsing functions to extract conversation events from NEEDLE log entries: Types added to types.ts: - ConversationRole: system, user, assistant, tool - ConversationEventType: prompt, response, thinking, tool_call, tool_result - PromptEvent: User input/prompt - ResponseEvent: Assistant response text - ThinkingEvent: Internal reasoning/thinking block - ToolCallEvent: Tool being called with arguments - ToolResultEvent: Result from a tool call - ConversationSession: Complete conversation session - ConversationParseOptions: Options for parsing Functions added to parser.ts: - isConversationEvent(): Check if log event contains conversation content - parseConversationEvent(): Parse single log event to conversation event - parseConversationEvents(): Parse multiple log events - parseConversationLine(): Parse single log line - parseConversationContent(): Parse multi-line log content - formatConversationEvent(): Format for display Features: - Supports explicit conversation fields (conversation_role, conversation_type) - Supports content fields (prompt, response, thinking, tool_result) - Supports tool call parsing with arguments normalization - Content truncation for large responses - Human-readable tool summaries (e.g., "Read /src/main.ts") - Filtering options for thinking blocks and tool results Comprehensive unit tests added for all conversation parsing functions. 🤖 Generated with [Claude Code](https://claude.ai/code) Co-Authored-By: Claude Worker <noreply@anthropic.com> |
||
|---|---|---|
| .beads | ||
| bin | ||
| docs | ||
| scripts | ||
| src | ||
| .gitignore | ||
| core.1898266 | ||
| core.1902831 | ||
| package-lock.json | ||
| package.json | ||
| README.md | ||
| ROADMAP.md | ||
| SESSION_REPLAY_SUMMARY.md | ||
| tsconfig.json | ||
| tsconfig.tsbuildinfo | ||
| vite.config.ts | ||
| vitest.config.ts | ||
FABRIC
Flow Analysis & Bead Reporting Interface Console
A live display for NEEDLE worker activity, available as TUI or web dashboard.
Purpose
FABRIC tails NEEDLE's logging output and renders it in real-time. It answers:
- What is each worker doing right now?
- What events are happening across all workers?
- Which workers are active, idle, or erroring?
- Is any worker stuck or looping?
- Are workers colliding on the same files?
- How much is this costing?
Display Modes
TUI (fabric tui)
Live terminal dashboard:
- Worker status grid
- Scrolling log stream
- Worker detail panel
- Keyboard navigation and filtering
Web (fabric web)
Live browser dashboard at localhost:3000:
- Worker overview cards
- Real-time activity feed
- Timeline visualization
- WebSocket-powered updates
Quick Start
# Terminal dashboard
fabric tui
# Web dashboard
fabric web
FABRIC reads from ~/.needle/logs/ by default.
Intelligence Features
Beyond simple log display, FABRIC provides:
| Feature | Description |
|---|---|
| Stuck & Loop Detection | Automatic alerts when workers spin their wheels |
| Inline Diff View | See actual code changes, not just "Edit was called" |
| Cross-Reference Links | Click any bead, file, or worker to navigate |
| Collision Detection | Know when workers edit the same files |
| Session Replay | Scrub through past sessions like a video |
| Smart Error Grouping | Errors with context, not scattered through logs |
| Command Palette | Ctrl+K for universal search and commands |
| Cost Tracking | Real-time token usage and budget alerts |
| Task Dependency DAG | Visual graph of task relationships |
| File Heatmap | See where all the action is at a glance |
| Conversation Transcript | See the full Claude conversation, not just tool calls |
| Semantic Narrative | Natural language summary of what workers are doing |
| AI Session Digest | Auto-generated session summaries for stakeholders |
| File Context Panel | See file contents alongside activity stream |
| Git Integration | Live git status, diff preview, conflict detection |
| Worker Analytics | Compare worker performance over time |
| Recovery Playbook | Suggestions based on similar past errors |
| Focus Mode | Pin workers/tasks, hide everything else |
Relationship to NEEDLE
NEEDLE (orchestrates workers) → logs → FABRIC (displays + analyzes)
NEEDLE does the work. FABRIC shows you what's happening and helps you understand it.
Status
🚧 In Development - See docs/plan.md for implementation roadmap.