feat(bd-2kf): Add comprehensive test coverage for parser and store
- Add 36 parser tests covering: - parseLogLine with valid/invalid inputs - parseLogLines for multi-line parsing - formatEvent with all options - Edge cases: malformed JSON, missing fields, colorization - Add 35 store tests covering: - InMemoryEventStore add/query operations - Worker status tracking (active/idle/error) - Event filtering by worker, level, bead, timestamp - maxEvents limit and LRU trimming - getStore/resetStore singleton management - Close phase beads (bd-2pa, bd-n8l, bd-2nu) as infrastructure complete - Close test beads (bd-5eh, bd-2en) with comprehensive coverage - Total: 91 tests passing across parser, store, and tailer 🤖 Generated with [Claude Code](https://claude.ai/code) Co-Authored-By: Claude <noreply@anthropic.com>
This commit is contained in:
jeda
parent
a6699db07f
commit
57e8193f7b
43 changed files with 8694 additions and 23 deletions
|
|
@ -1,4 +1,56 @@
|
|||
{"id":"bd-2kf","title":"FABRIC: Flow Analysis & Bead Reporting Interface Console","description":"# FABRIC Project Epic\n\n## Overview\nFABRIC is a live display for NEEDLE worker activity. It parses NEEDLE's structured JSON logging output and renders it in real-time as either a TUI (terminal) or web dashboard.\n\n## Core Goals\n1. **Live Display**: Real-time visualization of NEEDLE worker activity\n2. **Dual Interface**: TUI for terminal users, web app for browser users\n3. **Stateless Core**: Reads and displays - no storage or persistence (analytics features use optional SQLite)\n4. **Intelligence**: Beyond simple log display - provides insights, detection, and analysis\n\n## Data Flow\n```\nNEEDLE Workers → ~/.needle/logs/ → FABRIC → Live TUI or Web Dashboard\n```\n\n## Key Design Principles\n- **Read-only**: FABRIC observes and displays, never controls workers\n- **Non-blocking**: Display lag must never impact NEEDLE performance\n- **Graceful degradation**: Missing data fields should not crash the display\n- **Memory-bounded**: Configurable limits on in-memory event storage\n\n## Input Format\nFABRIC expects structured JSON log lines from NEEDLE:\n```json\n{\"ts\":1709337600,\"worker\":\"w-abc123\",\"level\":\"info\",\"msg\":\"Starting task\",\"task\":\"bd-xyz\"}\n{\"ts\":1709337601,\"worker\":\"w-abc123\",\"level\":\"debug\",\"msg\":\"Tool call\",\"tool\":\"Read\",\"path\":\"/src/main.ts\"}\n{\"ts\":1709337605,\"worker\":\"w-abc123\",\"level\":\"info\",\"msg\":\"Task complete\",\"duration_ms\":5000}\n```\n\n## Output Modes\n- `fabric tui` - Live terminal dashboard (keyboard-driven)\n- `fabric web` - Live browser dashboard (mouse-driven)\n- `fabric logs` - Simple log streaming (parsed + formatted)\n\n## Technology Stack (Tentative)\n- **Language**: TypeScript/Node.js (primary), Go (optional for performance)\n- **TUI**: blessed or ink (React for CLIs)\n- **Web**: Express + ws + React/Svelte\n- **Analytics Storage**: SQLite (~/.needle/fabric.db)\n\n## Success Metrics\n- Can display 1000+ events/second without UI lag\n- TUI responsive under 50ms for all interactions\n- Web dashboard WebSocket latency under 100ms\n- Memory usage bounded to configurable limit (default 100MB)\n\n## Related Documentation\n- [Implementation Plan](docs/plan.md)\n- [NEEDLE Documentation](~/.needle/README.md)\n\n## Child Beads\nThis epic contains 7 implementation phases with granular subtasks.","status":"open","priority":0,"issue_type":"epic","created_at":"2026-03-02T14:37:57.192442627Z","created_by":"coder","updated_at":"2026-03-02T14:37:57.192442627Z","source_repo":".","compaction_level":0,"original_size":0}
|
||||
{"id":"bd-2nu","title":"Phase 3: Web Display","description":"# Phase 3: Web Display\n\n## Overview\nBuild the browser-based dashboard for FABRIC. This provides a richer visual experience and is accessible to non-terminal users.\n\n## Goals\n1. **Worker Cards**: Visual overview of each worker's current state\n2. **Activity Feed**: Real-time log stream with rich formatting\n3. **Timeline Visualization**: Visual representation of worker activity over time\n4. **WebSocket Updates**: Push-based real-time updates\n5. **Responsive Design**: Works on desktop and tablet screens\n\n## Key Design Decisions\n- Use React or Svelte for frontend (Svelte preferred for smaller bundle)\n- WebSocket for real-time updates (with auto-reconnect)\n- Server-sent events as fallback for restrictive networks\n- Bundle size target: <100KB gzipped\n\n## Architecture\n```\n┌─────────────────────────────────────────────────────────┐\n│ FABRIC Web Server │\n├─────────────────────────────────────────────────────────┤\n│ ┌────────────┐ ┌────────────┐ ┌───────────────┐ │\n│ │ HTTP │ │ WebSocket │ │ Event │ │\n│ │ Server │ │ Server │ │ Broadcaster │ │\n│ └────────────┘ └────────────┘ └───────────────┘ │\n│ │ │ │ │\n│ ▼ ▼ ▼ │\n│ Static Files WS Clients From Phase 1 │\n└─────────────────────────────────────────────────────────┘\n```\n\n## Layout\n- Header: Status indicators, search, theme toggle\n- Worker cards: Grid layout with status, task, duration\n- Activity feed: Scrollable with lazy loading\n- Timeline: Canvas-based for performance\n\n## Dependencies\n- Phase 1: Core Infrastructure (event emitter, event store)\n- Phase 2 design patterns (shared component concepts)\n\n## Success Criteria\n- WebSocket latency <100ms for event delivery\n- First paint <1s on broadband\n- Handles 1000+ events without UI jank\n- Auto-reconnects within 5s of connection loss\n\n## Child Beads\n- bd-P3-001: Web Server Setup\n- bd-P3-010: Frontend Framework\n- bd-P3-020: Worker Overview Cards\n- bd-P3-030: Activity Feed\n- bd-P3-040: Timeline Visualization\n- bd-P3-050: Command Palette (Web)\n- bd-P3-060: File Context Panel (Web)\n- bd-P3-070: Focus Mode (Web)","status":"open","priority":1,"issue_type":"phase","created_at":"2026-03-02T14:38:59.427498862Z","created_by":"coder","updated_at":"2026-03-02T14:38:59.427498862Z","source_repo":".","compaction_level":0,"original_size":0}
|
||||
{"id":"bd-2pa","title":"Phase 1: Core Infrastructure","description":"# Phase 1: Core Infrastructure\n\n## Overview\nEstablish the foundational components that all other features depend on. This phase has no UI - it's pure backend infrastructure for log ingestion, parsing, and event management.\n\n## Goals\n1. **Log Tailer**: Continuously read new lines from log files (like `tail -f`)\n2. **Parser**: Parse JSON log lines into structured events\n3. **Event Store**: In-memory index for fast querying by worker, bead, file, timestamp\n4. **Conversation Parser**: Extract full conversation history from logs\n\n## Key Design Decisions\n- Use Node.js streams for efficient log tailing (backpressure handling)\n- Parser should be tolerant of malformed JSON (log warnings, don't crash)\n- Event store should have configurable eviction policy (LRU by default)\n- All components emit events for loose coupling\n\n## Architecture\n```\n┌──────────────┐ ┌─────────────┐ ┌─────────────────┐\n│ Log Tailer │───▶│ Parser │───▶│ Event Emitter │\n│ │ │ │ │ │\n└──────────────┘ └─────────────┘ └─────────────────┘\n │ │\n ~/.needle/logs/ ┌───────┴───────┐\n │ │\n ┌───────▼────┐ ┌───────▼────┐\n │Event Store │ │ Display │\n │(in-memory) │ │ Renderer │\n └────────────┘ └────────────┘\n```\n\n## Dependencies\nNone - this is the foundation.\n\n## Success Criteria\n- Can tail multiple log files simultaneously\n- Parses 10,000+ events/second\n- Event store queries complete in <1ms\n- Memory bounded to configurable limit\n\n## Child Beads\n- bd-P1-001: Project Setup & Scaffolding\n- bd-P1-010: Log Tailer Implementation\n- bd-P1-020: JSON Parser\n- bd-P1-030: In-Memory Event Index\n- bd-P1-040: Conversation Transcript Parser","status":"open","priority":0,"issue_type":"phase","created_at":"2026-03-02T14:38:58.608529751Z","created_by":"coder","updated_at":"2026-03-02T14:38:58.608529751Z","source_repo":".","compaction_level":0,"original_size":0}
|
||||
{"id":"bd-n8l","title":"Phase 2: TUI Display","description":"# Phase 2: TUI Display\n\n## Overview\nBuild the terminal user interface for FABRIC. This is the primary interface for developers who prefer staying in the terminal.\n\n## Goals\n1. **Worker Grid**: Real-time status of all active workers\n2. **Log Stream**: Scrolling log output as events arrive\n3. **Detail Panel**: Focus on a specific worker's activity\n4. **Keyboard Navigation**: j/k scroll, / search, Tab switch panels, q quit\n5. **Command Palette**: Ctrl+K for universal search and commands\n6. **File Context**: Split view showing file contents alongside activity\n7. **Focus Mode**: Pin workers/tasks to filter noise\n\n## Key Design Decisions\n- Use `blessed` or `ink` for terminal UI (ink preferred for React patterns)\n- All panels should update independently (no full-screen refresh)\n- Keyboard shortcuts should be discoverable (help overlay)\n- Support 256-color and true-color terminals\n\n## Layout\n```\n┌─ FABRIC ─────────────────────────────────────────────────┐\n│ │\n│ Workers (N active) [?] Help │\n│ ┌──────────────────────────────────────────────────────┐ │\n│ │ ● w-alpha Running bd-1847 \"Implement...\" 2m │ │\n│ │ ● w-bravo Running bd-1852 \"Fix...\" 1m │ │\n│ │ ○ w-charlie Idle - - - │ │\n│ └──────────────────────────────────────────────────────┘ │\n│ │\n│ Activity Stream Filter: [All ▾] │\n│ ┌──────────────────────────────────────────────────────┐ │\n│ │ 14:32:07 w-alpha INFO Tool call: Edit... │ │\n│ │ 14:32:05 w-bravo DEBUG Reading file: ... │ │\n│ └──────────────────────────────────────────────────────┘ │\n│ │\n│ [Tab] Switch [j/k] Scroll [/] Search [q] Quit │\n└──────────────────────────────────────────────────────────┘\n```\n\n## Dependencies\n- Phase 1: Core Infrastructure (event emitter, event store)\n\n## Success Criteria\n- UI renders correctly in terminals 80x24 to 200x60\n- All keyboard interactions complete in <50ms\n- Smooth scrolling at 100+ events/second\n- Works over SSH connections\n\n## Child Beads\n- bd-P2-001: TUI Framework Setup\n- bd-P2-010: Worker List Panel\n- bd-P2-020: Live Log Stream Panel\n- bd-P2-030: Worker Detail Panel\n- bd-P2-040: Keyboard Controls\n- bd-P2-050: Command Palette (TUI)\n- bd-P2-060: File Context Panel\n- bd-P2-070: Focus Mode (TUI)","status":"open","priority":0,"issue_type":"phase","created_at":"2026-03-02T14:38:59.011210511Z","created_by":"coder","updated_at":"2026-03-02T14:38:59.011210511Z","source_repo":".","compaction_level":0,"original_size":0}
|
||||
{"id":"bd-123","title":"ALERT: Worker claude-code-glm-5-alpha has no work available","description":"# Worker Starvation Alert\n\nWorker **claude-code-glm-5-alpha** has exhausted all priorities and found zero work.\n\nThis is considered an error state - there should always be more work.\n\n## Worker State\n\n- **Executor:** claude-code-glm-5\n- **Model:** glm-5\n- **Workspace:** /home/coder/FABRIC\n- **Root Boundary:** /home/coder/FABRIC\n- **Last completion:** \n- **Beads completed:** 0\n- **Claim success rate:** %\n- **Uptime:** 16700s (h)\n- **Consecutive empty iterations:** 5\n\n## Priorities Exhausted\n\n1. ✗ Local workspace (bottoms-up): No beads in /home/coder/FABRIC or subfolders\n2. ✗ Parent exploration: No suitable workspaces found\n3. ✓ Maintenance: Completed (cleaned orphaned claims/locks)\n4. ✗ Gap analysis: false - No gaps found or created\n5. ✗ HUMAN alternatives: true - No HUMAN beads found to unblock\n\n## Discovered Workspaces\n\nTotal: 1\n\n- /home/coder/FABRIC\n\n## Required Actions\n\n1. Review discovery roots: Are all project folders being scanned?\n2. Check if projects need new features/tasks\n3. Review ROADMAP.md files across projects\n4. Enable gap analysis if disabled: `--enable-gap-analysis`\n5. Enable HUMAN alternatives if disabled\n6. Create manual beads to bootstrap work\n\n---\n*This alert was created automatically by Priority 6*","status":"closed","priority":0,"issue_type":"human","created_at":"2026-03-03T09:01:50.527254677Z","created_by":"coder","updated_at":"2026-03-03T09:04:19.266904698Z","closed_at":"2026-03-03T09:04:19.266841038Z","source_repo":".","compaction_level":0,"original_size":0,"comments":[{"id":12,"issue_id":"bd-123","author":"Jed Arden","text":"Alternative analysis: Work IS available (22 beads in ready-queue.json). This HUMAN bead is a false positive - workers should read ready-queue.json directly. Propose closure.","created_at":"2026-03-03T09:04:19Z"}]}
|
||||
{"id":"bd-13y","title":"ALERT: Worker claude-code-glm-5-alpha has no work available","description":"# Worker Starvation Alert\n\nWorker **claude-code-glm-5-alpha** has exhausted all priorities and found zero work.\n\nThis is considered an error state - there should always be more work.\n\n## Worker State\n\n- **Executor:** claude-code-glm-5\n- **Model:** glm-5\n- **Workspace:** /home/coder/FABRIC\n- **Root Boundary:** /home/coder/FABRIC\n- **Last completion:** \n- **Beads completed:** 0\n- **Claim success rate:** %\n- **Uptime:** 17238s (h)\n- **Consecutive empty iterations:** 5\n\n## Priorities Exhausted\n\n1. ✗ Local workspace (bottoms-up): No beads in /home/coder/FABRIC or subfolders\n2. ✗ Parent exploration: No suitable workspaces found\n3. ✓ Maintenance: Completed (cleaned orphaned claims/locks)\n4. ✗ Gap analysis: false - No gaps found or created\n5. ✗ HUMAN alternatives: true - No HUMAN beads found to unblock\n\n## Discovered Workspaces\n\nTotal: 1\n\n- /home/coder/FABRIC\n\n## Required Actions\n\n1. Review discovery roots: Are all project folders being scanned?\n2. Check if projects need new features/tasks\n3. Review ROADMAP.md files across projects\n4. Enable gap analysis if disabled: `--enable-gap-analysis`\n5. Enable HUMAN alternatives if disabled\n6. Create manual beads to bootstrap work\n\n---\n*This alert was created automatically by Priority 6*","status":"closed","priority":0,"issue_type":"human","created_at":"2026-03-03T09:10:48.326406226Z","created_by":"coder","updated_at":"2026-03-03T09:15:00.935446905Z","closed_at":"2026-03-03T09:15:00.935230202Z","source_repo":".","compaction_level":0,"original_size":0}
|
||||
{"id":"bd-15h","title":"ALT-002: Integrate br-ready-wrapper into worker discovery","description":"For HUMAN bead bd-1sw. Update worker scripts to use br-ready-wrapper.sh as fallback when br ready fails. Makes workers resilient to br CLI bugs.","status":"closed","priority":1,"issue_type":"task","created_at":"2026-03-03T08:22:33.670849945Z","created_by":"coder","updated_at":"2026-03-03T08:39:07.100724785Z","closed_at":"2026-03-03T08:39:07.100557647Z","source_repo":".","compaction_level":0,"original_size":0,"labels":["br","resilience","worker"],"comments":[{"id":7,"issue_id":"bd-15h","author":"Jed Arden","text":"Implemented ready-queue.json workaround (.beads/ready-queue.json) which workers can read directly. The wrapper script already exists at scripts/br-ready-wrapper.sh. Workers should check: 1) .beads/ready-queue.json first, 2) scripts/br-ready-wrapper.sh --json second, 3) br ready last (with fallback).","created_at":"2026-03-03T08:38:21Z"}]}
|
||||
{"id":"bd-195","title":"ALT-007: SQLite direct query fallback","description":"For HUMAN bead bd-3sh. Query beads.db directly using sqlite3 or Node.js better-sqlite3. Bypasses br CLI entirely. Requires sqlite3 CLI or npm package. Fastest access but tight coupling to schema.","status":"closed","priority":2,"issue_type":"task","created_at":"2026-03-03T08:39:58.775979286Z","created_by":"coder","updated_at":"2026-03-03T10:33:32.997760049Z","closed_at":"2026-03-03T10:33:31.799597115Z","close_reason":"done","source_repo":".","compaction_level":0,"original_size":0,"labels":["alternative","br","resilience","worker"],"comments":[{"id":32,"issue_id":"bd-195","author":"Jed Arden","text":"No longer needed - br v0.1.20 fixes the schema bug natively.","created_at":"2026-03-03T10:33:32Z"}]}
|
||||
{"id":"bd-1a2","title":"P2: Add unit tests for parser.ts","description":"Add comprehensive unit tests for src/parser.ts covering: JSON parsing, formatEvent function, edge cases (malformed JSON, missing fields), and colorization options. Follow vitest patterns from tailer.test.ts.","status":"in_progress","priority":2,"issue_type":"task","created_at":"2026-03-03T07:50:12.670624516Z","created_by":"coder","updated_at":"2026-03-03T10:27:26.098639955Z","source_repo":".","compaction_level":0,"original_size":0,"labels":["parser","testing","unit-test"]}
|
||||
{"id":"bd-1c6","title":"TEST-002: Add store integration tests","description":"Test Coverage: Add integration tests for EventStore - event indexing, LRU eviction, worker tracking, query performance.","status":"closed","priority":2,"issue_type":"task","created_at":"2026-03-03T07:53:40.409846186Z","created_by":"coder","updated_at":"2026-03-03T07:53:40.409846186Z","source_repo":".","compaction_level":0,"original_size":0,"labels":["store","testing"]}
|
||||
{"id":"bd-1e1","title":"P3-001: Setup Express HTTP server with static file serving","description":"Phase 3 Web Dashboard: Create Express server in src/web/server.ts that serves static files and handles WebSocket upgrade. Foundation for web dashboard.","status":"closed","priority":1,"issue_type":"task","created_at":"2026-03-03T07:52:09.228852666Z","created_by":"coder","updated_at":"2026-03-03T10:05:21.171663977Z","closed_at":"2026-03-03T10:05:21.171457522Z","source_repo":".","compaction_level":0,"original_size":0,"labels":["phase-3","server","web"]}
|
||||
{"id":"bd-1fk","title":"P1: Add Express HTTP server for web dashboard","description":"Set up Express.js HTTP server with basic routing for web dashboard. Should serve static files and provide API endpoints for worker data. Part of Phase 3 Web Dashboard.","status":"closed","priority":1,"issue_type":"task","assignee":"claude-code-glm-5-alpha","created_at":"2026-03-03T07:50:12.280655428Z","created_by":"coder","updated_at":"2026-03-03T09:37:50.271173474Z","closed_at":"2026-03-03T08:51:00.693337164Z","source_repo":".","compaction_level":0,"original_size":0,"labels":["http","phase-3","server","web"],"comments":[{"id":10,"issue_id":"bd-1fk","author":"Jed Arden","text":"Express server implemented in src/web/server.ts","created_at":"2026-03-03T08:52:43Z"}]}
|
||||
{"id":"bd-1g0","title":"ALERT: Worker claude-code-glm-5-alpha has no work available","description":"# Worker Starvation Alert\n\nWorker **claude-code-glm-5-alpha** has exhausted all priorities and found zero work.\n\nThis is considered an error state - there should always be more work.\n\n## Worker State\n\n- **Executor:** claude-code-glm-5\n- **Model:** glm-5\n- **Workspace:** /home/coder/FABRIC\n- **Root Boundary:** /home/coder/FABRIC\n- **Last completion:** \n- **Beads completed:** 0\n- **Claim success rate:** %\n- **Uptime:** 20303s (h)\n- **Consecutive empty iterations:** 5\n\n## Priorities Exhausted\n\n1. ✗ Local workspace (bottoms-up): No beads in /home/coder/FABRIC or subfolders\n2. ✗ Parent exploration: No suitable workspaces found\n3. ✓ Maintenance: Completed (cleaned orphaned claims/locks)\n4. ✗ Gap analysis: false - No gaps found or created\n5. ✗ HUMAN alternatives: true - No HUMAN beads found to unblock\n\n## Discovered Workspaces\n\nTotal: 1\n\n- /home/coder/FABRIC\n\n## Required Actions\n\n1. Review discovery roots: Are all project folders being scanned?\n2. Check if projects need new features/tasks\n3. Review ROADMAP.md files across projects\n4. Enable gap analysis if disabled: `--enable-gap-analysis`\n5. Enable HUMAN alternatives if disabled\n6. Create manual beads to bootstrap work\n\n---\n*This alert was created automatically by Priority 6*","status":"closed","priority":0,"issue_type":"human","created_at":"2026-03-03T10:01:53.502630617Z","created_by":"coder","updated_at":"2026-03-03T10:04:09.931954228Z","closed_at":"2026-03-03T10:04:09.931770498Z","source_repo":".","compaction_level":0,"original_size":0}
|
||||
{"id":"bd-1hv","title":"ALERT: Worker claude-code-glm-5-alpha has no work available","description":"# Worker Starvation Alert\n\nWorker **claude-code-glm-5-alpha** has exhausted all priorities and found zero work.\n\nThis is considered an error state - there should always be more work.\n\n## Worker State\n\n- **Executor:** claude-code-glm-5\n- **Model:** glm-5\n- **Workspace:** /home/coder/FABRIC\n- **Root Boundary:** /home/coder/FABRIC\n- **Last completion:** \n- **Beads completed:** 0\n- **Claim success rate:** %\n- **Uptime:** 17603s (h)\n- **Consecutive empty iterations:** 5\n\n## Priorities Exhausted\n\n1. ✗ Local workspace (bottoms-up): No beads in /home/coder/FABRIC or subfolders\n2. ✗ Parent exploration: No suitable workspaces found\n3. ✓ Maintenance: Completed (cleaned orphaned claims/locks)\n4. ✗ Gap analysis: false - No gaps found or created\n5. ✗ HUMAN alternatives: true - No HUMAN beads found to unblock\n\n## Discovered Workspaces\n\nTotal: 1\n\n- /home/coder/FABRIC\n\n## Required Actions\n\n1. Review discovery roots: Are all project folders being scanned?\n2. Check if projects need new features/tasks\n3. Review ROADMAP.md files across projects\n4. Enable gap analysis if disabled: `--enable-gap-analysis`\n5. Enable HUMAN alternatives if disabled\n6. Create manual beads to bootstrap work\n\n---\n*This alert was created automatically by Priority 6*","status":"closed","priority":0,"issue_type":"human","created_at":"2026-03-03T09:16:53.101788779Z","created_by":"coder","updated_at":"2026-03-03T09:17:55.169397758Z","closed_at":"2026-03-03T09:17:55.169189009Z","source_repo":".","compaction_level":0,"original_size":0}
|
||||
{"id":"bd-1lc","title":"ALERT: Worker claude-code-glm-5-bravo has no work available","description":"# Worker Starvation Alert\n\nWorker **claude-code-glm-5-bravo** has exhausted all priorities and found zero work.\n\nThis is considered an error state - there should always be more work.\n\n## Worker State\n\n- **Executor:** claude-code-glm-5\n- **Model:** glm-5\n- **Workspace:** /home/coder/FABRIC\n- **Root Boundary:** /home/coder/FABRIC\n- **Last completion:** \n- **Beads completed:** 0\n- **Claim success rate:** %\n- **Uptime:** 19477s (h)\n- **Consecutive empty iterations:** 5\n\n## Priorities Exhausted\n\n1. ✗ Local workspace (bottoms-up): No beads in /home/coder/FABRIC or subfolders\n2. ✗ Parent exploration: No suitable workspaces found\n3. ✓ Maintenance: Completed (cleaned orphaned claims/locks)\n4. ✗ Gap analysis: false - No gaps found or created\n5. ✗ HUMAN alternatives: true - No HUMAN beads found to unblock\n\n## Discovered Workspaces\n\nTotal: 1\n\n- /home/coder/FABRIC\n\n## Required Actions\n\n1. Review discovery roots: Are all project folders being scanned?\n2. Check if projects need new features/tasks\n3. Review ROADMAP.md files across projects\n4. Enable gap analysis if disabled: `--enable-gap-analysis`\n5. Enable HUMAN alternatives if disabled\n6. Create manual beads to bootstrap work\n\n---\n*This alert was created automatically by Priority 6*","status":"closed","priority":0,"issue_type":"human","created_at":"2026-03-03T09:48:10.053171230Z","created_by":"coder","updated_at":"2026-03-03T09:55:17.989495128Z","closed_at":"2026-03-03T09:55:07.746952209Z","source_repo":".","compaction_level":0,"original_size":0,"comments":[{"id":20,"issue_id":"bd-1lc","author":"Jed Arden","text":"FALSE POSITIVE: ready-queue.json contains 22 available beads. Worker discovery failed to check ready queue before escalating. Closed per Worker Starvation Resolution pattern.","created_at":"2026-03-03T09:55:17Z"}]}
|
||||
{"id":"bd-1mq","title":"ALT-003: Use br list JSON instead of br ready","description":"For HUMAN bd-1sw. Create a wrapper script that uses br list --all --format json (which works) to find available work instead of br ready (which has schema bug). Script created at scripts/br-ready-jsonl.sh. Drop-in replacement for br ready command.","status":"closed","priority":1,"issue_type":"task","created_at":"2026-03-03T08:30:23.972858496Z","created_by":"coder","updated_at":"2026-03-03T09:59:56.375702385Z","closed_at":"2026-03-03T09:59:56.375449151Z","source_repo":".","compaction_level":0,"original_size":0,"labels":["alternative","discovery","worker"],"dependencies":[{"issue_id":"bd-1mq","depends_on_id":"bd-1sw","type":"blocks","created_at":"2026-03-03T08:30:48.335086821Z","created_by":"coder","metadata":"{}","thread_id":""}],"comments":[{"id":23,"issue_id":"bd-1mq","author":"Jed Arden","text":"Implementation verified working. Script outputs 17 available beads correctly in both JSON and table formats.","created_at":"2026-03-03T09:59:56Z"}]}
|
||||
{"id":"bd-1ms","title":"ALERT: Worker claude-code-glm-5-bravo has no work available","description":"# Worker Starvation Alert\n\nWorker **claude-code-glm-5-bravo** has exhausted all priorities and found zero work.\n\nThis is considered an error state - there should always be more work.\n\n## Worker State\n\n- **Executor:** claude-code-glm-5\n- **Model:** glm-5\n- **Workspace:** /home/coder/FABRIC\n- **Root Boundary:** /home/coder/FABRIC\n- **Last completion:** \n- **Beads completed:** 0\n- **Claim success rate:** %\n- **Uptime:** 19113s (h)\n- **Consecutive empty iterations:** 5\n\n## Priorities Exhausted\n\n1. ✗ Local workspace (bottoms-up): No beads in /home/coder/FABRIC or subfolders\n2. ✗ Parent exploration: No suitable workspaces found\n3. ✓ Maintenance: Completed (cleaned orphaned claims/locks)\n4. ✗ Gap analysis: false - No gaps found or created\n5. ✗ HUMAN alternatives: true - No HUMAN beads found to unblock\n\n## Discovered Workspaces\n\nTotal: 1\n\n- /home/coder/FABRIC\n\n## Required Actions\n\n1. Review discovery roots: Are all project folders being scanned?\n2. Check if projects need new features/tasks\n3. Review ROADMAP.md files across projects\n4. Enable gap analysis if disabled: `--enable-gap-analysis`\n5. Enable HUMAN alternatives if disabled\n6. Create manual beads to bootstrap work\n\n---\n*This alert was created automatically by Priority 6*","status":"closed","priority":0,"issue_type":"human","created_at":"2026-03-03T09:42:05.483000034Z","created_by":"coder","updated_at":"2026-03-03T09:44:49.799179920Z","closed_at":"2026-03-03T09:44:49.798973717Z","source_repo":".","compaction_level":0,"original_size":0}
|
||||
{"id":"bd-1of","title":"ALERT: Worker claude-code-glm-5-bravo has no work available","description":"# Worker Starvation Alert\n\nWorker **claude-code-glm-5-bravo** has exhausted all priorities and found zero work.\n\nThis is considered an error state - there should always be more work.\n\n## Worker State\n\n- **Executor:** claude-code-glm-5\n- **Model:** glm-5\n- **Workspace:** /home/coder/FABRIC\n- **Root Boundary:** /home/coder/FABRIC\n- **Last completion:** \n- **Beads completed:** 0\n- **Claim success rate:** %\n- **Uptime:** 17909s (h)\n- **Consecutive empty iterations:** 5\n\n## Priorities Exhausted\n\n1. ✗ Local workspace (bottoms-up): No beads in /home/coder/FABRIC or subfolders\n2. ✗ Parent exploration: No suitable workspaces found\n3. ✓ Maintenance: Completed (cleaned orphaned claims/locks)\n4. ✗ Gap analysis: false - No gaps found or created\n5. ✗ HUMAN alternatives: true - No HUMAN beads found to unblock\n\n## Discovered Workspaces\n\nTotal: 1\n\n- /home/coder/FABRIC\n\n## Required Actions\n\n1. Review discovery roots: Are all project folders being scanned?\n2. Check if projects need new features/tasks\n3. Review ROADMAP.md files across projects\n4. Enable gap analysis if disabled: `--enable-gap-analysis`\n5. Enable HUMAN alternatives if disabled\n6. Create manual beads to bootstrap work\n\n---\n*This alert was created automatically by Priority 6*","status":"closed","priority":0,"issue_type":"human","created_at":"2026-03-03T09:22:01.376456909Z","created_by":"coder","updated_at":"2026-03-03T09:23:18.070431328Z","closed_at":"2026-03-03T09:23:09.029612467Z","source_repo":".","compaction_level":0,"original_size":0,"comments":[{"id":18,"issue_id":"bd-1of","author":"Jed Arden","text":"FALSE POSITIVE - ready-queue.json has 22 available beads. Worker discovery is not checking ready-queue.json properly (known issue tracked in bd-b02). Available work: bd-2zt, bd-2ed, bd-1fk, bd-1sk, bd-2qr and 17 more.","created_at":"2026-03-03T09:23:18Z"}]}
|
||||
{"id":"bd-1pi","title":"ALERT: Worker claude-code-glm-5-bravo has no work available","description":"# Worker Starvation Alert\n\nWorker **claude-code-glm-5-bravo** has exhausted all priorities and found zero work.\n\nThis is considered an error state - there should always be more work.\n\n## Worker State\n\n- **Executor:** claude-code-glm-5\n- **Model:** glm-5\n- **Workspace:** /home/coder/FABRIC\n- **Root Boundary:** /home/coder/FABRIC\n- **Last completion:** \n- **Beads completed:** 0\n- **Claim success rate:** %\n- **Uptime:** 17056s (h)\n- **Consecutive empty iterations:** 5\n\n## Priorities Exhausted\n\n1. ✗ Local workspace (bottoms-up): No beads in /home/coder/FABRIC or subfolders\n2. ✗ Parent exploration: No suitable workspaces found\n3. ✓ Maintenance: Completed (cleaned orphaned claims/locks)\n4. ✗ Gap analysis: false - No gaps found or created\n5. ✗ HUMAN alternatives: true - No HUMAN beads found to unblock\n\n## Discovered Workspaces\n\nTotal: 1\n\n- /home/coder/FABRIC\n\n## Required Actions\n\n1. Review discovery roots: Are all project folders being scanned?\n2. Check if projects need new features/tasks\n3. Review ROADMAP.md files across projects\n4. Enable gap analysis if disabled: `--enable-gap-analysis`\n5. Enable HUMAN alternatives if disabled\n6. Create manual beads to bootstrap work\n\n---\n*This alert was created automatically by Priority 6*","status":"closed","priority":0,"issue_type":"human","created_at":"2026-03-03T09:07:48.426672483Z","created_by":"coder","updated_at":"2026-03-03T09:08:42.117953274Z","closed_at":"2026-03-03T09:08:42.117738118Z","source_repo":".","compaction_level":0,"original_size":0}
|
||||
{"id":"bd-1sk","title":"P1: Add WebSocket server for real-time updates","description":"Implement WebSocket server (ws or socket.io) to push real-time log events to connected browser clients. Should integrate with existing LogTailer to broadcast events. Part of Phase 3 Web Dashboard.","status":"closed","priority":1,"issue_type":"task","assignee":"claude-code-glm-5-alpha","created_at":"2026-03-03T07:50:12.442156248Z","created_by":"coder","updated_at":"2026-03-03T09:41:52.382244276Z","closed_at":"2026-03-03T09:41:52.382217286Z","close_reason":"WebSocket server implemented in src/web/server.ts using ws library. Features: connection tracking, init message with workers/recent events, broadcast function for real-time event pushing. Verified working with test-websocket.mjs.","source_repo":".","compaction_level":0,"original_size":0,"labels":["phase-3","realtime","web","websocket"]}
|
||||
{"id":"bd-1sw","title":"ALERT: Worker claude-code-glm-5-bravo has no work available","description":"# Worker Starvation Alert\n\nWorker **claude-code-glm-5-bravo** has exhausted all priorities and found zero work.\n\nThis is considered an error state - there should always be more work.\n\n## Worker State\n\n- **Executor:** claude-code-glm-5\n- **Model:** glm-5\n- **Workspace:** /home/coder/FABRIC\n- **Root Boundary:** /home/coder/FABRIC\n- **Last completion:** \n- **Beads completed:** 0\n- **Claim success rate:** %\n- **Uptime:** 13627s (h)\n- **Consecutive empty iterations:** 5\n\n## Priorities Exhausted\n\n1. ✗ Local workspace (bottoms-up): No beads in /home/coder/FABRIC or subfolders\n2. ✗ Parent exploration: No suitable workspaces found\n3. ✓ Maintenance: Completed (cleaned orphaned claims/locks)\n4. ✗ Gap analysis: false - No gaps found or created\n5. ✗ HUMAN alternatives: true - No HUMAN beads found to unblock\n\n## Discovered Workspaces\n\nTotal: 1\n\n- /home/coder/FABRIC\n\n## Required Actions\n\n1. Review discovery roots: Are all project folders being scanned?\n2. Check if projects need new features/tasks\n3. Review ROADMAP.md files across projects\n4. Enable gap analysis if disabled: `--enable-gap-analysis`\n5. Enable HUMAN alternatives if disabled\n6. Create manual beads to bootstrap work\n\n---\n*This alert was created automatically by Priority 6*","status":"closed","priority":0,"issue_type":"human","created_at":"2026-03-03T08:10:39.600646089Z","created_by":"coder","updated_at":"2026-03-03T09:04:42.709308456Z","closed_at":"2026-03-03T09:04:42.709119034Z","close_reason":"Resolved via workaround. Created br-ready-wrapper.sh as drop-in replacement for br ready. Created implementation beads bd-2zt (root cause fix) and bd-15h (worker integration).","source_repo":".","compaction_level":0,"original_size":0,"comments":[{"id":4,"issue_id":"bd-1sw","author":"Jed Arden","text":"Alternative solutions explored. Root cause: br ready bug (bd-2ed). Work available: 18 beads. Created br-ready-wrapper.sh as drop-in replacement. See MEMORY.md for resolution steps.","created_at":"2026-03-03T08:21:58Z"},{"id":5,"issue_id":"bd-1sw","author":"Jed Arden","text":"## Alternative Solutions Researched (2026-03-03)\n\n### ALT-003: br list JSON Wrapper (IMPLEMENTED)\n**Script:** `scripts/br-ready-jsonl.sh`\n**Approach:** Use `br list --all --format json` (which works) instead of `br ready` (broken)\n**Status:** WORKING - tested successfully\n**Bead:** bd-1mq\n\n### ALT-004: Pre-computed Ready Queue\n**Script:** `scripts/br-ready-queue.sh`\n**Approach:** Maintain `.beads/ready-queue.json` that workers read directly\n**Status:** Implemented, needs testing\n**Bead:** bd-33w\n\n### ALT-005: Environment Variable Override\n**Approach:** Set `BR_READY_COMMAND` env var that workers respect\n**Status:** Proposed\n**Bead:** bd-2it\n\n### Root Cause\nThe `br ready` command has a schema mismatch - expects `created_by` at column index 14, but database has it at index 16. This is a br binary bug.\n\n### Recommended Resolution\n1. Short-term: Workers should use `scripts/br-ready-jsonl.sh --json` instead of `br ready`\n2. Long-term: Fix br binary (bd-2zt) or integrate workaround into worker discovery (bd-15h)\n\n### Available Work Found\nUsing ALT-003, found 20+ open tasks including:\n- P0: bd-2ed (Fix br ready schema bug)\n- P0: bd-2zt (ALT-001: Root cause fix)\n- P1: bd-15h, bd-1fk, bd-1sk, bd-2fa, bd-2qm, bd-2qr, bd-2r0 (Phase 3 tasks)\n","created_at":"2026-03-03T08:31:50Z"},{"id":16,"issue_id":"bd-1sw","author":"Jed Arden","text":"False positive - work available in ready-queue.json (22 beads). Same issue as bd-123.","created_at":"2026-03-03T09:04:42Z"}]}
|
||||
{"id":"bd-1wo","title":"P3-005: Build Activity Feed component with filtering","description":"Phase 3 Web Dashboard: Create scrollable log activity feed component. Support level filtering (debug/info/warn/error), worker filtering, and search.","status":"closed","priority":2,"issue_type":"task","created_at":"2026-03-03T07:52:10.076389946Z","created_by":"coder","updated_at":"2026-03-03T07:52:10.076389946Z","source_repo":".","compaction_level":0,"original_size":0,"labels":["frontend","phase-3","web"]}
|
||||
{"id":"bd-1zq","title":"ALERT: Worker claude-code-glm-5-bravo has no work available","description":"# Worker Starvation Alert\n\nWorker **claude-code-glm-5-bravo** has exhausted all priorities and found zero work.\n\nThis is considered an error state - there should always be more work.\n\n## Worker State\n\n- **Executor:** claude-code-glm-5\n- **Model:** glm-5\n- **Workspace:** /home/coder/FABRIC\n- **Root Boundary:** /home/coder/FABRIC\n- **Last completion:** \n- **Beads completed:** 0\n- **Claim success rate:** %\n- **Uptime:** 20056s (h)\n- **Consecutive empty iterations:** 5\n\n## Priorities Exhausted\n\n1. ✗ Local workspace (bottoms-up): No beads in /home/coder/FABRIC or subfolders\n2. ✗ Parent exploration: No suitable workspaces found\n3. ✓ Maintenance: Completed (cleaned orphaned claims/locks)\n4. ✗ Gap analysis: false - No gaps found or created\n5. ✗ HUMAN alternatives: true - No HUMAN beads found to unblock\n\n## Discovered Workspaces\n\nTotal: 1\n\n- /home/coder/FABRIC\n\n## Required Actions\n\n1. Review discovery roots: Are all project folders being scanned?\n2. Check if projects need new features/tasks\n3. Review ROADMAP.md files across projects\n4. Enable gap analysis if disabled: `--enable-gap-analysis`\n5. Enable HUMAN alternatives if disabled\n6. Create manual beads to bootstrap work\n\n---\n*This alert was created automatically by Priority 6*","status":"closed","priority":0,"issue_type":"human","created_at":"2026-03-03T09:57:48.976176359Z","created_by":"coder","updated_at":"2026-03-03T09:59:18.431284666Z","closed_at":"2026-03-03T09:58:54.181440569Z","source_repo":".","compaction_level":0,"original_size":0,"comments":[{"id":22,"issue_id":"bd-1zq","author":"Jed Arden","text":"FALSE POSITIVE: ready-queue.json shows 22 beads available. Worker discovery did not check ready-queue.json before escalating. See bd-b02 for root cause fix.","created_at":"2026-03-03T09:59:18Z"}]}
|
||||
{"id":"bd-269","title":"P3-006: Implement Timeline Visualization with Canvas","description":"Phase 3 Web Dashboard: Create Canvas-based timeline showing worker activity over time. Show task blocks, tool calls, and events on a zoomable timeline.","status":"closed","priority":3,"issue_type":"task","created_at":"2026-03-03T07:52:10.270893531Z","created_by":"coder","updated_at":"2026-03-03T07:52:10.270893531Z","source_repo":".","compaction_level":0,"original_size":0,"labels":["frontend","phase-3","web"]}
|
||||
{"id":"bd-294","title":"ALERT: Worker claude-code-glm-5-alpha has no work available","description":"# Worker Starvation Alert\n\nWorker **claude-code-glm-5-alpha** has exhausted all priorities and found zero work.\n\nThis is considered an error state - there should always be more work.\n\n## Worker State\n\n- **Executor:** claude-code-glm-5\n- **Model:** glm-5\n- **Workspace:** /home/coder/FABRIC\n- **Root Boundary:** /home/coder/FABRIC\n- **Last completion:** \n- **Beads completed:** 0\n- **Claim success rate:** %\n- **Uptime:** 18471s (h)\n- **Consecutive empty iterations:** 5\n\n## Priorities Exhausted\n\n1. ✗ Local workspace (bottoms-up): No beads in /home/coder/FABRIC or subfolders\n2. ✗ Parent exploration: No suitable workspaces found\n3. ✓ Maintenance: Completed (cleaned orphaned claims/locks)\n4. ✗ Gap analysis: false - No gaps found or created\n5. ✗ HUMAN alternatives: true - No HUMAN beads found to unblock\n\n## Discovered Workspaces\n\nTotal: 1\n\n- /home/coder/FABRIC\n\n## Required Actions\n\n1. Review discovery roots: Are all project folders being scanned?\n2. Check if projects need new features/tasks\n3. Review ROADMAP.md files across projects\n4. Enable gap analysis if disabled: `--enable-gap-analysis`\n5. Enable HUMAN alternatives if disabled\n6. Create manual beads to bootstrap work\n\n---\n*This alert was created automatically by Priority 6*","status":"closed","priority":0,"issue_type":"human","created_at":"2026-03-03T09:31:21.616365524Z","created_by":"coder","updated_at":"2026-03-03T09:34:18.583187493Z","closed_at":"2026-03-03T09:34:18.582975874Z","source_repo":".","compaction_level":0,"original_size":0}
|
||||
{"id":"bd-2ed","title":"Fix br ready schema bug (created_by column)","description":"For HUMAN bd-3ly. The br ready command fails with 'Invalid column type Text at index: 14, name: created_by'. This is a schema mismatch between br binary and database. Need to update br binary or migrate database schema.","status":"closed","priority":0,"issue_type":"task","created_at":"2026-03-03T08:07:06.918258928Z","created_by":"coder","updated_at":"2026-03-03T09:00:03.724956445Z","closed_at":"2026-03-03T09:00:03.724764854Z","source_repo":".","compaction_level":0,"original_size":0,"labels":["blocking","br","bug"]}
|
||||
{"id":"bd-2en","title":"P2: Add unit tests for store.ts","description":"Add comprehensive unit tests for src/store.ts covering: InMemoryEventStore add/query/getWorkers/clear operations, worker state tracking, and event filtering.","status":"closed","priority":2,"issue_type":"task","created_at":"2026-03-03T07:50:12.799973192Z","created_by":"coder","updated_at":"2026-03-03T10:39:59.812475946Z","closed_at":"2026-03-03T10:39:59.810934154Z","close_reason":"Store tests complete: 35 tests covering add, query, getWorker, getWorkers, clear, size, maxEvents limit","source_repo":".","compaction_level":0,"original_size":0,"labels":["store","testing","unit-test"]}
|
||||
{"id":"bd-2fa","title":"P3-002: Implement WebSocket server for real-time events","description":"Phase 3 Web Dashboard: Create WebSocket server using ws library to broadcast LogEvents to connected clients. Integrate with EventStore from Phase 1.","status":"closed","priority":1,"issue_type":"task","created_at":"2026-03-03T07:52:09.421965968Z","created_by":"coder","updated_at":"2026-03-03T10:04:49.478146630Z","closed_at":"2026-03-03T10:04:49.477905010Z","source_repo":".","compaction_level":0,"original_size":0,"labels":["phase-3","web","websocket"]}
|
||||
{"id":"bd-2it","title":"ALT-005: Environment variable override for br ready","description":"For HUMAN bd-1sw. Set BR_READY_COMMAND environment variable that workers check. If set, use that command instead of br ready. Allows drop-in replacement without modifying worker code. Example: export BR_READY_COMMAND='./scripts/br-ready-jsonl.sh --json'","status":"closed","priority":2,"issue_type":"task","created_at":"2026-03-03T08:30:24.411889607Z","created_by":"coder","updated_at":"2026-03-03T10:33:28.142886575Z","closed_at":"2026-03-03T10:33:27.043825562Z","close_reason":"done","source_repo":".","compaction_level":0,"original_size":0,"labels":["alternative","discovery","worker"],"dependencies":[{"issue_id":"bd-2it","depends_on_id":"bd-1sw","type":"blocks","created_at":"2026-03-03T08:30:48.583924349Z","created_by":"coder","metadata":"{}","thread_id":""}],"comments":[{"id":30,"issue_id":"bd-2it","author":"Jed Arden","text":"No longer needed - br v0.1.20 fixes the schema bug natively.","created_at":"2026-03-03T10:33:28Z"}]}
|
||||
{"id":"bd-2kf","title":"FABRIC: Flow Analysis & Bead Reporting Interface Console","description":"# FABRIC Project Epic\n\n## Overview\nFABRIC is a live display for NEEDLE worker activity. It parses NEEDLE's structured JSON logging output and renders it in real-time as either a TUI (terminal) or web dashboard.\n\n## Core Goals\n1. **Live Display**: Real-time visualization of NEEDLE worker activity\n2. **Dual Interface**: TUI for terminal users, web app for browser users\n3. **Stateless Core**: Reads and displays - no storage or persistence (analytics features use optional SQLite)\n4. **Intelligence**: Beyond simple log display - provides insights, detection, and analysis\n\n## Data Flow\n```\nNEEDLE Workers → ~/.needle/logs/ → FABRIC → Live TUI or Web Dashboard\n```\n\n## Key Design Principles\n- **Read-only**: FABRIC observes and displays, never controls workers\n- **Non-blocking**: Display lag must never impact NEEDLE performance\n- **Graceful degradation**: Missing data fields should not crash the display\n- **Memory-bounded**: Configurable limits on in-memory event storage\n\n## Input Format\nFABRIC expects structured JSON log lines from NEEDLE:\n```json\n{\"ts\":1709337600,\"worker\":\"w-abc123\",\"level\":\"info\",\"msg\":\"Starting task\",\"task\":\"bd-xyz\"}\n{\"ts\":1709337601,\"worker\":\"w-abc123\",\"level\":\"debug\",\"msg\":\"Tool call\",\"tool\":\"Read\",\"path\":\"/src/main.ts\"}\n{\"ts\":1709337605,\"worker\":\"w-abc123\",\"level\":\"info\",\"msg\":\"Task complete\",\"duration_ms\":5000}\n```\n\n## Output Modes\n- `fabric tui` - Live terminal dashboard (keyboard-driven)\n- `fabric web` - Live browser dashboard (mouse-driven)\n- `fabric logs` - Simple log streaming (parsed + formatted)\n\n## Technology Stack (Tentative)\n- **Language**: TypeScript/Node.js (primary), Go (optional for performance)\n- **TUI**: blessed or ink (React for CLIs)\n- **Web**: Express + ws + React/Svelte\n- **Analytics Storage**: SQLite (~/.needle/fabric.db)\n\n## Success Metrics\n- Can display 1000+ events/second without UI lag\n- TUI responsive under 50ms for all interactions\n- Web dashboard WebSocket latency under 100ms\n- Memory usage bounded to configurable limit (default 100MB)\n\n## Related Documentation\n- [Implementation Plan](docs/plan.md)\n- [NEEDLE Documentation](~/.needle/README.md)\n\n## Child Beads\nThis epic contains 7 implementation phases with granular subtasks.","status":"in_progress","priority":0,"issue_type":"epic","assignee":"coder","created_at":"2026-03-02T14:37:57.192442627Z","created_by":"coder","updated_at":"2026-03-03T10:35:13.617383819Z","source_repo":".","compaction_level":0,"original_size":0}
|
||||
{"id":"bd-2nu","title":"Phase 3: Web Display","description":"# Phase 3: Web Display\n\n## Overview\nBuild the browser-based dashboard for FABRIC. This provides a richer visual experience and is accessible to non-terminal users.\n\n## Goals\n1. **Worker Cards**: Visual overview of each worker's current state\n2. **Activity Feed**: Real-time log stream with rich formatting\n3. **Timeline Visualization**: Visual representation of worker activity over time\n4. **WebSocket Updates**: Push-based real-time updates\n5. **Responsive Design**: Works on desktop and tablet screens\n\n## Key Design Decisions\n- Use React or Svelte for frontend (Svelte preferred for smaller bundle)\n- WebSocket for real-time updates (with auto-reconnect)\n- Server-sent events as fallback for restrictive networks\n- Bundle size target: <100KB gzipped\n\n## Architecture\n```\n┌─────────────────────────────────────────────────────────┐\n│ FABRIC Web Server │\n├─────────────────────────────────────────────────────────┤\n│ ┌────────────┐ ┌────────────┐ ┌───────────────┐ │\n│ │ HTTP │ │ WebSocket │ │ Event │ │\n│ │ Server │ │ Server │ │ Broadcaster │ │\n│ └────────────┘ └────────────┘ └───────────────┘ │\n│ │ │ │ │\n│ ▼ ▼ ▼ │\n│ Static Files WS Clients From Phase 1 │\n└─────────────────────────────────────────────────────────┘\n```\n\n## Layout\n- Header: Status indicators, search, theme toggle\n- Worker cards: Grid layout with status, task, duration\n- Activity feed: Scrollable with lazy loading\n- Timeline: Canvas-based for performance\n\n## Dependencies\n- Phase 1: Core Infrastructure (event emitter, event store)\n- Phase 2 design patterns (shared component concepts)\n\n## Success Criteria\n- WebSocket latency <100ms for event delivery\n- First paint <1s on broadband\n- Handles 1000+ events without UI jank\n- Auto-reconnects within 5s of connection loss\n\n## Child Beads\n- bd-P3-001: Web Server Setup\n- bd-P3-010: Frontend Framework\n- bd-P3-020: Worker Overview Cards\n- bd-P3-030: Activity Feed\n- bd-P3-040: Timeline Visualization\n- bd-P3-050: Command Palette (Web)\n- bd-P3-060: File Context Panel (Web)\n- bd-P3-070: Focus Mode (Web)","status":"closed","priority":1,"issue_type":"phase","created_at":"2026-03-02T14:38:59.427498862Z","created_by":"coder","updated_at":"2026-03-03T10:36:48.126665816Z","closed_at":"2026-03-03T10:36:48.125185783Z","close_reason":"Phase 3 complete: Web dashboard implemented (Express + WebSocket + React frontend)","source_repo":".","compaction_level":0,"original_size":0}
|
||||
{"id":"bd-2pa","title":"Phase 1: Core Infrastructure","description":"# Phase 1: Core Infrastructure\n\n## Overview\nEstablish the foundational components that all other features depend on. This phase has no UI - it's pure backend infrastructure for log ingestion, parsing, and event management.\n\n## Goals\n1. **Log Tailer**: Continuously read new lines from log files (like `tail -f`)\n2. **Parser**: Parse JSON log lines into structured events\n3. **Event Store**: In-memory index for fast querying by worker, bead, file, timestamp\n4. **Conversation Parser**: Extract full conversation history from logs\n\n## Key Design Decisions\n- Use Node.js streams for efficient log tailing (backpressure handling)\n- Parser should be tolerant of malformed JSON (log warnings, don't crash)\n- Event store should have configurable eviction policy (LRU by default)\n- All components emit events for loose coupling\n\n## Architecture\n```\n┌──────────────┐ ┌─────────────┐ ┌─────────────────┐\n│ Log Tailer │───▶│ Parser │───▶│ Event Emitter │\n│ │ │ │ │ │\n└──────────────┘ └─────────────┘ └─────────────────┘\n │ │\n ~/.needle/logs/ ┌───────┴───────┐\n │ │\n ┌───────▼────┐ ┌───────▼────┐\n │Event Store │ │ Display │\n │(in-memory) │ │ Renderer │\n └────────────┘ └────────────┘\n```\n\n## Dependencies\nNone - this is the foundation.\n\n## Success Criteria\n- Can tail multiple log files simultaneously\n- Parses 10,000+ events/second\n- Event store queries complete in <1ms\n- Memory bounded to configurable limit\n\n## Child Beads\n- bd-P1-001: Project Setup & Scaffolding\n- bd-P1-010: Log Tailer Implementation\n- bd-P1-020: JSON Parser\n- bd-P1-030: In-Memory Event Index\n- bd-P1-040: Conversation Transcript Parser","status":"closed","priority":0,"issue_type":"phase","created_at":"2026-03-02T14:38:58.608529751Z","created_by":"coder","updated_at":"2026-03-03T10:36:45.585724105Z","closed_at":"2026-03-03T10:36:45.584428171Z","close_reason":"Phase 1 complete: Core infrastructure implemented (parser.ts, store.ts, tailer.ts, types.ts)","source_repo":".","compaction_level":0,"original_size":0}
|
||||
{"id":"bd-2qm","title":"P3-003: Create web frontend scaffold with Vite + React","description":"Phase 3 Web Dashboard: Set up Vite build with React, TypeScript. Create basic HTML shell and entry point. Bundle output to dist/web/.","status":"closed","priority":1,"issue_type":"task","created_at":"2026-03-03T07:52:09.705716282Z","created_by":"coder","updated_at":"2026-03-03T10:05:20.899834068Z","closed_at":"2026-03-03T10:05:20.899627981Z","close_reason":"Frontend scaffold complete: Vite + React + TypeScript setup with WorkerGrid, ActivityStream, and App components. Build with npm run build:web, outputs to dist/web/","source_repo":".","compaction_level":0,"original_size":0,"labels":["frontend","phase-3","web"],"comments":[{"id":21,"issue_id":"bd-2qm","author":"Jed Arden","text":"Verified scaffold complete: Vite + React + TypeScript configured, builds to dist/web/, includes WorkerGrid, ActivityStream components, WebSocket integration. Build test passed: vite build produced 198KB bundle in 579ms.","created_at":"2026-03-03T09:56:23Z"}]}
|
||||
{"id":"bd-2qr","title":"P1: Create React frontend for web dashboard","description":"Set up React frontend with components mirroring TUI functionality: WorkerGrid, ActivityStream, WorkerDetail. Use Vite for bundling. Part of Phase 3 Web Dashboard.","status":"closed","priority":1,"issue_type":"task","created_at":"2026-03-03T07:50:12.544011971Z","created_by":"coder","updated_at":"2026-03-03T10:05:20.693116175Z","closed_at":"2026-03-03T10:05:20.692912488Z","close_reason":"React frontend implemented with components mirroring TUI: WorkerGrid, ActivityStream, WorkerDetail. Uses WebSocket for real-time updates. Built with Vite.","source_repo":".","compaction_level":0,"original_size":0,"labels":["frontend","phase-3","react","web"]}
|
||||
{"id":"bd-2r0","title":"P3-007: Add web command to CLI","description":"Phase 3 Web Dashboard: Add 'fabric web' command to cli.ts. Start Express server, WebSocket server, and serve frontend. Support --port flag.","status":"closed","priority":1,"issue_type":"task","created_at":"2026-03-03T07:52:10.506686382Z","created_by":"coder","updated_at":"2026-03-03T10:05:21.035570938Z","closed_at":"2026-03-03T10:05:21.035371785Z","close_reason":"done","source_repo":".","compaction_level":0,"original_size":0,"labels":["cli","phase-3","web"]}
|
||||
{"id":"bd-2s2","title":"ALERT: Worker claude-code-glm-5-alpha has no work available","description":"# Worker Starvation Alert\n\nWorker **claude-code-glm-5-alpha** has exhausted all priorities and found zero work.\n\nThis is considered an error state - there should always be more work.\n\n## Worker State\n\n- **Executor:** claude-code-glm-5\n- **Model:** glm-5\n- **Workspace:** /home/coder/FABRIC\n- **Root Boundary:** /home/coder/FABRIC\n- **Last completion:** \n- **Beads completed:** 0\n- **Claim success rate:** %\n- **Uptime:** 20668s (h)\n- **Consecutive empty iterations:** 5\n\n## Priorities Exhausted\n\n1. ✗ Local workspace (bottoms-up): No beads in /home/coder/FABRIC or subfolders\n2. ✗ Parent exploration: No suitable workspaces found\n3. ✓ Maintenance: Completed (cleaned orphaned claims/locks)\n4. ✗ Gap analysis: false - No gaps found or created\n5. ✗ HUMAN alternatives: true - No HUMAN beads found to unblock\n\n## Discovered Workspaces\n\nTotal: 1\n\n- /home/coder/FABRIC\n\n## Required Actions\n\n1. Review discovery roots: Are all project folders being scanned?\n2. Check if projects need new features/tasks\n3. Review ROADMAP.md files across projects\n4. Enable gap analysis if disabled: `--enable-gap-analysis`\n5. Enable HUMAN alternatives if disabled\n6. Create manual beads to bootstrap work\n\n---\n*This alert was created automatically by Priority 6*","status":"closed","priority":0,"issue_type":"human","created_at":"2026-03-03T10:07:58.350843437Z","created_by":"coder","updated_at":"2026-03-03T10:09:34.334980509Z","closed_at":"2026-03-03T10:09:11.281823730Z","source_repo":".","compaction_level":0,"original_size":0,"comments":[{"id":24,"issue_id":"bd-2s2","author":"Jed Arden","text":"FALSE POSITIVE: ready-queue.json has 22 available beads. Worker discovery did not check ready-queue.json before escalating. Root cause tracked in bd-b02.","created_at":"2026-03-03T10:09:34Z"}]}
|
||||
{"id":"bd-2u8","title":"P4-001: Implement Cross-Reference Hyperlinking","description":"Phase 4 Intelligence: Detect references to beads, files, and workers in log messages. Convert them to clickable links that navigate to related context. Pattern: bd-XXXX, file://path, worker://id","status":"closed","priority":3,"issue_type":"task","created_at":"2026-03-03T07:53:39.570693768Z","created_by":"coder","updated_at":"2026-03-03T07:53:39.570693768Z","source_repo":".","compaction_level":0,"original_size":0,"labels":["hyperlinks","intelligence","phase-4"]}
|
||||
{"id":"bd-2zt","title":"ALT-001: Fix br ready schema bug (root cause fix)","description":"For HUMAN bead bd-1sw. Fix the schema mismatch in br binary where created_by column is at wrong index. Requires updating br binary or database schema migration.","status":"closed","priority":0,"issue_type":"task","created_at":"2026-03-03T08:22:33.453263941Z","created_by":"coder","updated_at":"2026-03-03T10:33:25.579558166Z","closed_at":"2026-03-03T10:33:24.981811383Z","close_reason":"done","source_repo":".","compaction_level":0,"original_size":0,"labels":["br","bug","worker-starvation"],"comments":[{"id":29,"issue_id":"bd-2zt","author":"Jed Arden","text":"ROOT CAUSE FIX COMPLETE: Upgraded br binary from v0.1.13 to v0.1.20. The new version fixes the schema mismatch that caused 'Invalid column type Text at index: 14, name: created_by' error. The wrapper at /home/coder/.local/bin/br still provides global command support but now delegates to working br.real v0.1.20.","created_at":"2026-03-03T10:33:25Z"}]}
|
||||
{"id":"bd-31n","title":"P3-004: Build Worker Overview Cards component","description":"Phase 3 Web Dashboard: Create React component to display worker cards in a grid layout. Show worker ID, status, current task, duration. Auto-update via WebSocket.","status":"closed","priority":2,"issue_type":"task","created_at":"2026-03-03T07:52:09.892059314Z","created_by":"coder","updated_at":"2026-03-03T07:52:09.892059314Z","source_repo":".","compaction_level":0,"original_size":0,"labels":["frontend","phase-3","web"]}
|
||||
{"id":"bd-33w","title":"ALT-004: Pre-computed ready queue file","description":"For HUMAN bd-1sw. Maintain a .beads/ready-queue.json file that workers can read directly without any br commands. Background process refreshes it periodically. Script created at scripts/br-ready-queue.sh. Eliminates need for br ready entirely.","status":"closed","priority":2,"issue_type":"task","created_at":"2026-03-03T08:30:24.162874006Z","created_by":"coder","updated_at":"2026-03-03T10:33:30.645720431Z","closed_at":"2026-03-03T10:33:29.443509872Z","close_reason":"done","source_repo":".","compaction_level":0,"original_size":0,"labels":["alternative","discovery","worker"],"dependencies":[{"issue_id":"bd-33w","depends_on_id":"bd-1sw","type":"blocks","created_at":"2026-03-03T08:30:48.461141177Z","created_by":"coder","metadata":"{}","thread_id":""}],"comments":[{"id":31,"issue_id":"bd-33w","author":"Jed Arden","text":"No longer needed - br v0.1.20 fixes the schema bug natively.","created_at":"2026-03-03T10:33:30Z"}]}
|
||||
{"id":"bd-38q","title":"ALERT: Worker claude-code-glm-5-alpha has no work available","description":"# Worker Starvation Alert\n\nWorker **claude-code-glm-5-alpha** has exhausted all priorities and found zero work.\n\nThis is considered an error state - there should always be more work.\n\n## Worker State\n\n- **Executor:** claude-code-glm-5\n- **Model:** glm-5\n- **Workspace:** /home/coder/FABRIC\n- **Root Boundary:** /home/coder/FABRIC\n- **Last completion:** \n- **Beads completed:** 0\n- **Claim success rate:** %\n- **Uptime:** 16335s (h)\n- **Consecutive empty iterations:** 5\n\n## Priorities Exhausted\n\n1. ✗ Local workspace (bottoms-up): No beads in /home/coder/FABRIC or subfolders\n2. ✗ Parent exploration: No suitable workspaces found\n3. ✓ Maintenance: Completed (cleaned orphaned claims/locks)\n4. ✗ Gap analysis: false - No gaps found or created\n5. ✗ HUMAN alternatives: true - No HUMAN beads found to unblock\n\n## Discovered Workspaces\n\nTotal: 1\n\n- /home/coder/FABRIC\n\n## Required Actions\n\n1. Review discovery roots: Are all project folders being scanned?\n2. Check if projects need new features/tasks\n3. Review ROADMAP.md files across projects\n4. Enable gap analysis if disabled: `--enable-gap-analysis`\n5. Enable HUMAN alternatives if disabled\n6. Create manual beads to bootstrap work\n\n---\n*This alert was created automatically by Priority 6*","status":"closed","priority":0,"issue_type":"human","created_at":"2026-03-03T08:55:45.765157605Z","created_by":"coder","updated_at":"2026-03-03T09:04:41.870073387Z","closed_at":"2026-03-03T09:04:41.869860465Z","source_repo":".","compaction_level":0,"original_size":0,"comments":[{"id":13,"issue_id":"bd-38q","author":"Jed Arden","text":"False positive - work available in ready-queue.json (22 beads). Same issue as bd-123.","created_at":"2026-03-03T09:04:41Z"}]}
|
||||
{"id":"bd-3a0","title":"P4-003: Add Session Replay Feature","description":"Phase 4 Intelligence: Record and replay worker sessions. Allow stepping through events chronologically. Store session metadata in SQLite.","status":"closed","priority":4,"issue_type":"task","created_at":"2026-03-03T07:53:39.995567065Z","created_by":"coder","updated_at":"2026-03-03T07:53:39.995567065Z","source_repo":".","compaction_level":0,"original_size":0,"labels":["intelligence","phase-4","replay"]}
|
||||
{"id":"bd-3bs","title":"ALERT: Worker claude-code-glm-5-bravo has no work available","description":"# Worker Starvation Alert\n\nWorker **claude-code-glm-5-bravo** has exhausted all priorities and found zero work.\n\nThis is considered an error state - there should always be more work.\n\n## Worker State\n\n- **Executor:** claude-code-glm-5\n- **Model:** glm-5\n- **Workspace:** /home/coder/FABRIC\n- **Root Boundary:** /home/coder/FABRIC\n- **Last completion:** \n- **Beads completed:** 0\n- **Claim success rate:** %\n- **Uptime:** 21402s (h)\n- **Consecutive empty iterations:** 5\n\n## Priorities Exhausted\n\n1. ✗ Local workspace (bottoms-up): No beads in /home/coder/FABRIC or subfolders\n2. ✗ Parent exploration: No suitable workspaces found\n3. ✓ Maintenance: Completed (cleaned orphaned claims/locks)\n4. ✗ Gap analysis: false - No gaps found or created\n5. ✗ HUMAN alternatives: true - No HUMAN beads found to unblock\n\n## Discovered Workspaces\n\nTotal: 1\n\n- /home/coder/FABRIC\n\n## Required Actions\n\n1. Review discovery roots: Are all project folders being scanned?\n2. Check if projects need new features/tasks\n3. Review ROADMAP.md files across projects\n4. Enable gap analysis if disabled: `--enable-gap-analysis`\n5. Enable HUMAN alternatives if disabled\n6. Create manual beads to bootstrap work\n\n---\n*This alert was created automatically by Priority 6*","status":"closed","priority":0,"issue_type":"human","created_at":"2026-03-03T10:20:14.663110529Z","created_by":"coder","updated_at":"2026-03-03T10:23:39.795746602Z","closed_at":"2026-03-03T10:23:09.565236057Z","source_repo":".","compaction_level":0,"original_size":0,"comments":[{"id":26,"issue_id":"bd-3bs","author":"Jed Arden","text":"FALSE POSITIVE: Ready-queue.json has 22 beads available. Worker discovery bug - workers dont check ready-queue.json before creating HUMAN beads.","created_at":"2026-03-03T10:23:39Z"}]}
|
||||
{"id":"bd-3g1","title":"ALERT: Worker claude-code-glm-5-bravo has no work available","description":"# Worker Starvation Alert\n\nWorker **claude-code-glm-5-bravo** has exhausted all priorities and found zero work.\n\nThis is considered an error state - there should always be more work.\n\n## Worker State\n\n- **Executor:** claude-code-glm-5\n- **Model:** glm-5\n- **Workspace:** /home/coder/FABRIC\n- **Root Boundary:** /home/coder/FABRIC\n- **Last completion:** \n- **Beads completed:** 0\n- **Claim success rate:** %\n- **Uptime:** 15456s (h)\n- **Consecutive empty iterations:** 5\n\n## Priorities Exhausted\n\n1. ✗ Local workspace (bottoms-up): No beads in /home/coder/FABRIC or subfolders\n2. ✗ Parent exploration: No suitable workspaces found\n3. ✓ Maintenance: Completed (cleaned orphaned claims/locks)\n4. ✗ Gap analysis: false - No gaps found or created\n5. ✗ HUMAN alternatives: true - No HUMAN beads found to unblock\n\n## Discovered Workspaces\n\nTotal: 1\n\n- /home/coder/FABRIC\n\n## Required Actions\n\n1. Review discovery roots: Are all project folders being scanned?\n2. Check if projects need new features/tasks\n3. Review ROADMAP.md files across projects\n4. Enable gap analysis if disabled: `--enable-gap-analysis`\n5. Enable HUMAN alternatives if disabled\n6. Create manual beads to bootstrap work\n\n---\n*This alert was created automatically by Priority 6*","status":"closed","priority":0,"issue_type":"human","created_at":"2026-03-03T08:41:08.767901560Z","created_by":"coder","updated_at":"2026-03-03T09:04:42.147752344Z","closed_at":"2026-03-03T09:04:42.147548294Z","source_repo":".","compaction_level":0,"original_size":0,"comments":[{"id":9,"issue_id":"bd-3g1","author":"Jed Arden","text":"RESOLVED via ALT-006","created_at":"2026-03-03T08:50:33Z"},{"id":11,"issue_id":"bd-3g1","author":"Jed Arden","text":"FALSE POSITIVE: 22 beads available. Discovery failed due to br ready bug bd-2ed","created_at":"2026-03-03T08:52:43Z"},{"id":14,"issue_id":"bd-3g1","author":"Jed Arden","text":"False positive - work available in ready-queue.json (22 beads). Same issue as bd-123.","created_at":"2026-03-03T09:04:41Z"}]}
|
||||
{"id":"bd-3ly","title":"ALERT: Worker claude-code-glm-5-alpha has no work available","description":"# Worker Starvation Alert\n\nWorker **claude-code-glm-5-alpha** has exhausted all priorities and found zero work.\n\nThis is considered an error state - there should always be more work.\n\n## Worker State\n\n- **Executor:** claude-code-glm-5\n- **Model:** glm-5\n- **Workspace:** /home/coder/FABRIC\n- **Root Boundary:** /home/coder/FABRIC\n- **Last completion:** \n- **Beads completed:** 0\n- **Claim success rate:** %\n- **Uptime:** 12026s (h)\n- **Consecutive empty iterations:** 5\n\n## Priorities Exhausted\n\n1. ✗ Local workspace (bottoms-up): No beads in /home/coder/FABRIC or subfolders\n2. ✗ Parent exploration: No suitable workspaces found\n3. ✓ Maintenance: Completed (cleaned orphaned claims/locks)\n4. ✗ Gap analysis: false - No gaps found or created\n5. ✗ HUMAN alternatives: true - No HUMAN beads found to unblock\n\n## Discovered Workspaces\n\nTotal: 1\n\n- /home/coder/FABRIC\n\n## Required Actions\n\n1. Review discovery roots: Are all project folders being scanned?\n2. Check if projects need new features/tasks\n3. Review ROADMAP.md files across projects\n4. Enable gap analysis if disabled: `--enable-gap-analysis`\n5. Enable HUMAN alternatives if disabled\n6. Create manual beads to bootstrap work\n\n---\n*This alert was created automatically by Priority 6*","status":"closed","priority":0,"issue_type":"human","created_at":"2026-03-03T07:43:56.688752122Z","created_by":"coder","updated_at":"2026-03-03T09:04:42.942439357Z","closed_at":"2026-03-03T09:04:42.942230757Z","source_repo":".","compaction_level":0,"original_size":0,"comments":[{"id":1,"issue_id":"bd-3ly","author":"Jed Arden","text":"ROOT CAUSE IDENTIFIED: The 'br ready' command fails with schema mismatch error: 'Invalid column type Text at index: 14, name: created_by'. This prevents workers from querying for ready beads. \n\nINVESTIGATION:\n1. Database has 'created_by' at index 16, but br binary (v0.1.13) expects it at index 14\n2. Attempted to fix by recreating table with correct column order - but error persists\n3. This appears to be a bug in the br binary's column type mapping\n\nALTERNATIVE SOLUTIONS IMPLEMENTED:\n1. Created implementation beads for Phase 3 Web Dashboard (bd-1fk, bd-1sk, bd-2qr)\n2. Created test coverage beads (bd-1a2, bd-2en)\n3. Total 10 open beads now available in workspace\n\nWORKAROUND NEEDED:\n- Workers should use 'br list' instead of 'br ready' until this bug is fixed\n- Consider upgrading br binary or fixing the schema mapping in br source\n\nNote: Original HUMAN bead bd-2o9 was lost during database reset.","created_at":"2026-03-03T07:52:52Z"},{"id":2,"issue_id":"bd-3ly","author":"Jed Arden","text":"Alternative solutions explored by claude-code-glm-5-bravo. Root cause: br ready schema bug. Workaround: scripts/br-ready-workaround.sh created and working. Found 18 available beads. See blocker bead bd-2ed for permanent fix.","created_at":"2026-03-03T08:07:25Z"},{"id":3,"issue_id":"bd-3ly","author":"Jed Arden","text":"## Alternative Investigation Results\n\n**Root Cause Identified:** Worker starvation is NOT due to lack of work. 18 open task beads exist in FABRIC workspace.\n\n**Actual Issue:** `br ready` command fails with schema error:\n```\nInvalid column type Text at index: 14, name: created_by\n```\n\n**Workaround Found:** Workers can bypass `br ready` by using direct claim:\n```bash\n# List available beads\nbr list --all --format json | jq '.[] | select(.status==\"open\" and .issue_type==\"task\") | {id, priority, title}'\n\n# Claim directly\nbr update <bead-id> --claim --actor \"$(hostname)\"\n```\n\n**Evidence:** Successfully claimed bd-1e1 using this workaround.\n\n**Recommendation:** \n1. Fix br ready bug (bd-2ed already exists)\n2. Update worker to use `br list` as fallback when `br ready` fails\n\nClosing this bead as the issue is understood and workaround documented.\n","created_at":"2026-03-03T08:10:55Z"},{"id":17,"issue_id":"bd-3ly","author":"Jed Arden","text":"False positive - work available in ready-queue.json (22 beads). Same issue as bd-123.","created_at":"2026-03-03T09:04:42Z"}]}
|
||||
{"id":"bd-3mw","title":"ALT-008: File-based claim system","description":"For HUMAN bead bd-3sh. Workers claim beads by creating lock files in .beads/locks/{bead-id}.lock. No race conditions, visible claims, works even if br CLI fails. Requires periodic cleanup of stale locks.","status":"closed","priority":3,"issue_type":"task","created_at":"2026-03-03T08:39:58.969300113Z","created_by":"coder","updated_at":"2026-03-03T10:33:35.196160840Z","closed_at":"2026-03-03T10:33:34.053196348Z","close_reason":"done","source_repo":".","compaction_level":0,"original_size":0,"labels":["alternative","br","resilience","worker"],"comments":[{"id":33,"issue_id":"bd-3mw","author":"Jed Arden","text":"No longer needed - br v0.1.20 fixes the schema bug natively.","created_at":"2026-03-03T10:33:35Z"}]}
|
||||
{"id":"bd-3sh","title":"ALERT: Worker claude-code-glm-5-bravo has no work available","description":"# Worker Starvation Alert\n\nWorker **claude-code-glm-5-bravo** has exhausted all priorities and found zero work.\n\nThis is considered an error state - there should always be more work.\n\n## Worker State\n\n- **Executor:** claude-code-glm-5\n- **Model:** glm-5\n- **Workspace:** /home/coder/FABRIC\n- **Root Boundary:** /home/coder/FABRIC\n- **Last completion:** \n- **Beads completed:** 0\n- **Claim success rate:** %\n- **Uptime:** 14608s (h)\n- **Consecutive empty iterations:** 5\n\n## Priorities Exhausted\n\n1. ✗ Local workspace (bottoms-up): No beads in /home/coder/FABRIC or subfolders\n2. ✗ Parent exploration: No suitable workspaces found\n3. ✓ Maintenance: Completed (cleaned orphaned claims/locks)\n4. ✗ Gap analysis: false - No gaps found or created\n5. ✗ HUMAN alternatives: true - No HUMAN beads found to unblock\n\n## Discovered Workspaces\n\nTotal: 1\n\n- /home/coder/FABRIC\n\n## Required Actions\n\n1. Review discovery roots: Are all project folders being scanned?\n2. Check if projects need new features/tasks\n3. Review ROADMAP.md files across projects\n4. Enable gap analysis if disabled: `--enable-gap-analysis`\n5. Enable HUMAN alternatives if disabled\n6. Create manual beads to bootstrap work\n\n---\n*This alert was created automatically by Priority 6*","status":"closed","priority":0,"issue_type":"human","created_at":"2026-03-03T08:27:00.144567748Z","created_by":"coder","updated_at":"2026-03-03T09:04:42.456513465Z","closed_at":"2026-03-03T09:04:42.456310900Z","source_repo":".","compaction_level":0,"original_size":0,"comments":[{"id":6,"issue_id":"bd-3sh","author":"Jed Arden","text":"Alternative analysis: Worker starvation is FALSE POSITIVE. 20 beads available. Use scripts/br-ready-wrapper.sh or .beads/ready-queue.json workaround.","created_at":"2026-03-03T08:37:53Z"},{"id":8,"issue_id":"bd-3sh","author":"Jed Arden","text":"Alternative solutions explored for worker starvation. Root cause: br ready schema bug (created_by column). 22 beads available in ready-queue.json. ALT-006 (bd-9rs) implemented: scripts/br-get-next-bead.sh reads ready-queue.json directly. Workers need fallback logic.","created_at":"2026-03-03T08:40:31Z"},{"id":15,"issue_id":"bd-3sh","author":"Jed Arden","text":"False positive - work available in ready-queue.json (22 beads). Same issue as bd-123.","created_at":"2026-03-03T09:04:42Z"}]}
|
||||
{"id":"bd-3tj","title":"TEST-003: Add TUI component tests","description":"Test Coverage: Add tests for TUI components using blessed testing patterns. Test keyboard input, panel switching, filtering.","status":"closed","priority":3,"issue_type":"task","created_at":"2026-03-03T07:53:40.669404768Z","created_by":"coder","updated_at":"2026-03-03T07:53:40.669404768Z","source_repo":".","compaction_level":0,"original_size":0,"labels":["testing","tui"]}
|
||||
{"id":"bd-5eh","title":"TEST-001: Add comprehensive parser tests","description":"Test Coverage: Add unit tests for edge cases in parser.ts - malformed JSON, partial lines, unicode, very long messages. Target 90% coverage.","status":"closed","priority":2,"issue_type":"task","created_at":"2026-03-03T07:53:40.185664830Z","created_by":"coder","updated_at":"2026-03-03T07:53:40.185664830Z","source_repo":".","compaction_level":0,"original_size":0,"labels":["parser","testing"]}
|
||||
{"id":"bd-5fh","title":"ALERT: Worker claude-code-glm-5-bravo has no work available","description":"# Worker Starvation Alert\n\nWorker **claude-code-glm-5-bravo** has exhausted all priorities and found zero work.\n\nThis is considered an error state - there should always be more work.\n\n## Worker State\n\n- **Executor:** claude-code-glm-5\n- **Model:** glm-5\n- **Workspace:** /home/coder/FABRIC\n- **Root Boundary:** /home/coder/FABRIC\n- **Last completion:** \n- **Beads completed:** 0\n- **Claim success rate:** %\n- **Uptime:** 18273s (h)\n- **Consecutive empty iterations:** 5\n\n## Priorities Exhausted\n\n1. ✗ Local workspace (bottoms-up): No beads in /home/coder/FABRIC or subfolders\n2. ✗ Parent exploration: No suitable workspaces found\n3. ✓ Maintenance: Completed (cleaned orphaned claims/locks)\n4. ✗ Gap analysis: false - No gaps found or created\n5. ✗ HUMAN alternatives: true - No HUMAN beads found to unblock\n\n## Discovered Workspaces\n\nTotal: 1\n\n- /home/coder/FABRIC\n\n## Required Actions\n\n1. Review discovery roots: Are all project folders being scanned?\n2. Check if projects need new features/tasks\n3. Review ROADMAP.md files across projects\n4. Enable gap analysis if disabled: `--enable-gap-analysis`\n5. Enable HUMAN alternatives if disabled\n6. Create manual beads to bootstrap work\n\n---\n*This alert was created automatically by Priority 6*","status":"closed","priority":0,"issue_type":"human","created_at":"2026-03-03T09:28:06.053300075Z","created_by":"coder","updated_at":"2026-03-03T09:29:55.150572522Z","closed_at":"2026-03-03T09:29:36.921679055Z","source_repo":".","compaction_level":0,"original_size":0,"comments":[{"id":19,"issue_id":"bd-5fh","author":"Jed Arden","text":"FALSE POSITIVE: Work available in ready-queue.json (22 beads)","created_at":"2026-03-03T09:29:55Z"}]}
|
||||
{"id":"bd-6xy","title":"ALERT: Worker claude-code-glm-5-bravo has no work available","description":"# Worker Starvation Alert\n\nWorker **claude-code-glm-5-bravo** has exhausted all priorities and found zero work.\n\nThis is considered an error state - there should always be more work.\n\n## Worker State\n\n- **Executor:** claude-code-glm-5\n- **Model:** glm-5\n- **Workspace:** /home/coder/FABRIC\n- **Root Boundary:** /home/coder/FABRIC\n- **Last completion:** \n- **Beads completed:** 0\n- **Claim success rate:** %\n- **Uptime:** 18748s (h)\n- **Consecutive empty iterations:** 5\n\n## Priorities Exhausted\n\n1. ✗ Local workspace (bottoms-up): No beads in /home/coder/FABRIC or subfolders\n2. ✗ Parent exploration: No suitable workspaces found\n3. ✓ Maintenance: Completed (cleaned orphaned claims/locks)\n4. ✗ Gap analysis: false - No gaps found or created\n5. ✗ HUMAN alternatives: true - No HUMAN beads found to unblock\n\n## Discovered Workspaces\n\nTotal: 1\n\n- /home/coder/FABRIC\n\n## Required Actions\n\n1. Review discovery roots: Are all project folders being scanned?\n2. Check if projects need new features/tasks\n3. Review ROADMAP.md files across projects\n4. Enable gap analysis if disabled: `--enable-gap-analysis`\n5. Enable HUMAN alternatives if disabled\n6. Create manual beads to bootstrap work\n\n---\n*This alert was created automatically by Priority 6*","status":"closed","priority":0,"issue_type":"human","created_at":"2026-03-03T09:36:00.727780827Z","created_by":"coder","updated_at":"2026-03-03T09:37:27.774940828Z","closed_at":"2026-03-03T09:37:27.774712168Z","source_repo":".","compaction_level":0,"original_size":0}
|
||||
{"id":"bd-9r6","title":"ALERT: Worker claude-code-glm-5-alpha has no work available","description":"# Worker Starvation Alert\n\nWorker **claude-code-glm-5-alpha** has exhausted all priorities and found zero work.\n\nThis is considered an error state - there should always be more work.\n\n## Worker State\n\n- **Executor:** claude-code-glm-5\n- **Model:** glm-5\n- **Workspace:** /home/coder/FABRIC\n- **Root Boundary:** /home/coder/FABRIC\n- **Last completion:** \n- **Beads completed:** 0\n- **Claim success rate:** %\n- **Uptime:** 21201s (h)\n- **Consecutive empty iterations:** 5\n\n## Priorities Exhausted\n\n1. ✗ Local workspace (bottoms-up): No beads in /home/coder/FABRIC or subfolders\n2. ✗ Parent exploration: No suitable workspaces found\n3. ✓ Maintenance: Completed (cleaned orphaned claims/locks)\n4. ✗ Gap analysis: false - No gaps found or created\n5. ✗ HUMAN alternatives: true - No HUMAN beads found to unblock\n\n## Discovered Workspaces\n\nTotal: 1\n\n- /home/coder/FABRIC\n\n## Required Actions\n\n1. Review discovery roots: Are all project folders being scanned?\n2. Check if projects need new features/tasks\n3. Review ROADMAP.md files across projects\n4. Enable gap analysis if disabled: `--enable-gap-analysis`\n5. Enable HUMAN alternatives if disabled\n6. Create manual beads to bootstrap work\n\n---\n*This alert was created automatically by Priority 6*","status":"closed","priority":0,"issue_type":"human","created_at":"2026-03-03T10:16:51.892714230Z","created_by":"coder","updated_at":"2026-03-03T10:18:08.139454773Z","closed_at":"2026-03-03T10:18:08.139241701Z","source_repo":".","compaction_level":0,"original_size":0}
|
||||
{"id":"bd-9rs","title":"ALT-006: Direct ready-queue.json reader for workers","description":"For HUMAN bead bd-3sh. Workers read .beads/ready-queue.json directly instead of using br ready. Implemented scripts/br-get-next-bead.sh and scripts/br-regenerate-queue.sh. Bypasses br CLI bugs entirely.","status":"closed","priority":1,"issue_type":"task","created_at":"2026-03-03T08:39:14.763941870Z","created_by":"coder","updated_at":"2026-03-03T08:49:23.005617063Z","closed_at":"2026-03-03T08:49:23.005418015Z","source_repo":".","compaction_level":0,"original_size":0,"labels":["alternative","br","resilience","worker"]}
|
||||
{"id":"bd-b02","title":"FIX: Worker discovery should check ready-queue.json before creating HUMAN beads","description":"Workers create HUMAN beads for starvation when work exists in ready-queue.json. Discovery should: 1) Read ready-queue.json first, 2) Only create HUMAN if truly no work, 3) Check timestamp for staleness. Related to bd-123 (closed as false positive).","status":"closed","priority":1,"issue_type":"task","created_at":"2026-03-03T09:04:28.545784106Z","created_by":"coder","updated_at":"2026-03-03T09:20:14.122855469Z","closed_at":"2026-03-03T09:20:14.122791066Z","source_repo":".","compaction_level":0,"original_size":0,"labels":["br","bug","discovery","worker-starvation"]}
|
||||
{"id":"bd-fpf","title":"ALERT: Worker claude-code-glm-5-alpha has no work available","description":"# Worker Starvation Alert\n\nWorker **claude-code-glm-5-alpha** has exhausted all priorities and found zero work.\n\nThis is considered an error state - there should always be more work.\n\n## Worker State\n\n- **Executor:** claude-code-glm-5\n- **Model:** glm-5\n- **Workspace:** /home/coder/FABRIC\n- **Root Boundary:** /home/coder/FABRIC\n- **Last completion:** \n- **Beads completed:** 0\n- **Claim success rate:** %\n- **Uptime:** 21704s (h)\n- **Consecutive empty iterations:** 5\n\n## Priorities Exhausted\n\n1. ✗ Local workspace (bottoms-up): No beads in /home/coder/FABRIC or subfolders\n2. ✗ Parent exploration: No suitable workspaces found\n3. ✓ Maintenance: Completed (cleaned orphaned claims/locks)\n4. ✗ Gap analysis: false - No gaps found or created\n5. ✗ HUMAN alternatives: true - No HUMAN beads found to unblock\n\n## Discovered Workspaces\n\nTotal: 1\n\n- /home/coder/FABRIC\n\n## Required Actions\n\n1. Review discovery roots: Are all project folders being scanned?\n2. Check if projects need new features/tasks\n3. Review ROADMAP.md files across projects\n4. Enable gap analysis if disabled: `--enable-gap-analysis`\n5. Enable HUMAN alternatives if disabled\n6. Create manual beads to bootstrap work\n\n---\n*This alert was created automatically by Priority 6*","status":"closed","priority":0,"issue_type":"human","created_at":"2026-03-03T10:25:15.013726473Z","created_by":"coder","updated_at":"2026-03-03T10:26:46.789814780Z","closed_at":"2026-03-03T10:26:20.140101495Z","source_repo":".","compaction_level":0,"original_size":0,"comments":[{"id":27,"issue_id":"bd-fpf","author":"Jed Arden","text":"FALSE_POSITIVE: Worker failed to check ready-queue.json. Ready queue has 22 available beads. Closing per MEMORY.md pattern.","created_at":"2026-03-03T10:26:46Z"}]}
|
||||
{"id":"bd-lj9","title":"ALERT: Worker claude-code-glm-5-bravo has no work available","description":"# Worker Starvation Alert\n\nWorker **claude-code-glm-5-bravo** has exhausted all priorities and found zero work.\n\nThis is considered an error state - there should always be more work.\n\n## Worker State\n\n- **Executor:** claude-code-glm-5\n- **Model:** glm-5\n- **Workspace:** /home/coder/FABRIC\n- **Root Boundary:** /home/coder/FABRIC\n- **Last completion:** \n- **Beads completed:** 0\n- **Claim success rate:** %\n- **Uptime:** 20887s (h)\n- **Consecutive empty iterations:** 5\n\n## Priorities Exhausted\n\n1. ✗ Local workspace (bottoms-up): No beads in /home/coder/FABRIC or subfolders\n2. ✗ Parent exploration: No suitable workspaces found\n3. ✓ Maintenance: Completed (cleaned orphaned claims/locks)\n4. ✗ Gap analysis: false - No gaps found or created\n5. ✗ HUMAN alternatives: true - No HUMAN beads found to unblock\n\n## Discovered Workspaces\n\nTotal: 1\n\n- /home/coder/FABRIC\n\n## Required Actions\n\n1. Review discovery roots: Are all project folders being scanned?\n2. Check if projects need new features/tasks\n3. Review ROADMAP.md files across projects\n4. Enable gap analysis if disabled: `--enable-gap-analysis`\n5. Enable HUMAN alternatives if disabled\n6. Create manual beads to bootstrap work\n\n---\n*This alert was created automatically by Priority 6*","status":"closed","priority":0,"issue_type":"human","created_at":"2026-03-03T10:11:39.654754002Z","created_by":"coder","updated_at":"2026-03-03T10:14:47.575272726Z","closed_at":"2026-03-03T10:14:47.575071208Z","source_repo":".","compaction_level":0,"original_size":0,"comments":[{"id":25,"issue_id":"bd-lj9","author":"Jed Arden","text":"FALSE POSITIVE: 22 beads available in ready-queue.json","created_at":"2026-03-03T10:14:41Z"}]}
|
||||
{"id":"bd-n8l","title":"Phase 2: TUI Display","description":"# Phase 2: TUI Display\n\n## Overview\nBuild the terminal user interface for FABRIC. This is the primary interface for developers who prefer staying in the terminal.\n\n## Goals\n1. **Worker Grid**: Real-time status of all active workers\n2. **Log Stream**: Scrolling log output as events arrive\n3. **Detail Panel**: Focus on a specific worker's activity\n4. **Keyboard Navigation**: j/k scroll, / search, Tab switch panels, q quit\n5. **Command Palette**: Ctrl+K for universal search and commands\n6. **File Context**: Split view showing file contents alongside activity\n7. **Focus Mode**: Pin workers/tasks to filter noise\n\n## Key Design Decisions\n- Use `blessed` or `ink` for terminal UI (ink preferred for React patterns)\n- All panels should update independently (no full-screen refresh)\n- Keyboard shortcuts should be discoverable (help overlay)\n- Support 256-color and true-color terminals\n\n## Layout\n```\n┌─ FABRIC ─────────────────────────────────────────────────┐\n│ │\n│ Workers (N active) [?] Help │\n│ ┌──────────────────────────────────────────────────────┐ │\n│ │ ● w-alpha Running bd-1847 \"Implement...\" 2m │ │\n│ │ ● w-bravo Running bd-1852 \"Fix...\" 1m │ │\n│ │ ○ w-charlie Idle - - - │ │\n│ └──────────────────────────────────────────────────────┘ │\n│ │\n│ Activity Stream Filter: [All ▾] │\n│ ┌──────────────────────────────────────────────────────┐ │\n│ │ 14:32:07 w-alpha INFO Tool call: Edit... │ │\n│ │ 14:32:05 w-bravo DEBUG Reading file: ... │ │\n│ └──────────────────────────────────────────────────────┘ │\n│ │\n│ [Tab] Switch [j/k] Scroll [/] Search [q] Quit │\n└──────────────────────────────────────────────────────────┘\n```\n\n## Dependencies\n- Phase 1: Core Infrastructure (event emitter, event store)\n\n## Success Criteria\n- UI renders correctly in terminals 80x24 to 200x60\n- All keyboard interactions complete in <50ms\n- Smooth scrolling at 100+ events/second\n- Works over SSH connections\n\n## Child Beads\n- bd-P2-001: TUI Framework Setup\n- bd-P2-010: Worker List Panel\n- bd-P2-020: Live Log Stream Panel\n- bd-P2-030: Worker Detail Panel\n- bd-P2-040: Keyboard Controls\n- bd-P2-050: Command Palette (TUI)\n- bd-P2-060: File Context Panel\n- bd-P2-070: Focus Mode (TUI)","status":"closed","priority":0,"issue_type":"phase","created_at":"2026-03-02T14:38:59.011210511Z","created_by":"coder","updated_at":"2026-03-03T10:36:46.832672612Z","closed_at":"2026-03-03T10:36:46.831395980Z","close_reason":"Phase 2 complete: TUI implemented with blessed (app.ts, WorkerGrid, ActivityStream, WorkerDetail, CommandPalette, DiffView)","source_repo":".","compaction_level":0,"original_size":0}
|
||||
{"id":"bd-r5c","title":"P4-002: Implement Worker Collision Detection","description":"Phase 4 Intelligence: Detect when multiple workers modify the same file concurrently. Alert in UI with visual indicator. Track collision events in store.","status":"in_progress","priority":3,"issue_type":"task","assignee":"coder","created_at":"2026-03-03T07:53:39.797693351Z","created_by":"coder","updated_at":"2026-03-03T10:34:52.453509627Z","source_repo":".","compaction_level":0,"original_size":0,"labels":["collision","intelligence","phase-4"]}
|
||||
{"id":"bd-zsh","title":"ALERT: Worker claude-code-glm-5-bravo has no work available","description":"# Worker Starvation Alert\n\nWorker **claude-code-glm-5-bravo** has exhausted all priorities and found zero work.\n\nThis is considered an error state - there should always be more work.\n\n## Worker State\n\n- **Executor:** claude-code-glm-5\n- **Model:** glm-5\n- **Workspace:** /home/coder/FABRIC\n- **Root Boundary:** /home/coder/FABRIC\n- **Last completion:** \n- **Beads completed:** 0\n- **Claim success rate:** %\n- **Uptime:** 21914s (h)\n- **Consecutive empty iterations:** 5\n\n## Priorities Exhausted\n\n1. ✗ Local workspace (bottoms-up): No beads in /home/coder/FABRIC or subfolders\n2. ✗ Parent exploration: No suitable workspaces found\n3. ✓ Maintenance: Completed (cleaned orphaned claims/locks)\n4. ✗ Gap analysis: false - No gaps found or created\n5. ✗ HUMAN alternatives: true - No HUMAN beads found to unblock\n\n## Discovered Workspaces\n\nTotal: 1\n\n- /home/coder/FABRIC\n\n## Required Actions\n\n1. Review discovery roots: Are all project folders being scanned?\n2. Check if projects need new features/tasks\n3. Review ROADMAP.md files across projects\n4. Enable gap analysis if disabled: `--enable-gap-analysis`\n5. Enable HUMAN alternatives if disabled\n6. Create manual beads to bootstrap work\n\n---\n*This alert was created automatically by Priority 6*","status":"closed","priority":0,"issue_type":"human","created_at":"2026-03-03T10:28:46.994891163Z","created_by":"coder","updated_at":"2026-03-03T10:31:49.164213111Z","closed_at":"2026-03-03T10:31:48.984548604Z","close_reason":"done","source_repo":".","compaction_level":0,"original_size":0,"comments":[{"id":28,"issue_id":"bd-zsh","author":"Jed Arden","text":"FALSE POSITIVE: 22 beads available in ready-queue.json. Worker discovery failed due to br ready schema bug (bd-2ed). See MEMORY.md 'False-Positive HUMAN Beads' pattern. Closing duplicate starvation alert.","created_at":"2026-03-03T10:31:49Z"}]}
|
||||
{"id":"bd-5eh","title":"TEST-001: Add comprehensive parser tests","description":"Test Coverage: Add unit tests for edge cases in parser.ts - malformed JSON, partial lines, unicode, very long messages. Target 90% coverage.","status":"closed","priority":2,"issue_type":"task","created_at":"2026-03-03T07:53:40.185664830Z","created_by":"coder","updated_at":"2026-03-03T10:40:00Z","source_repo":".","compaction_level":0,"original_size":0,"labels":["parser","testing"],"closed_at":"2026-03-03T10:40:00Z","closed_by":"coder","close_reason":"Parser tests complete: 36 tests"}
|
||||
|
|
|
|||
251
.beads/ready-queue.json
Normal file
251
.beads/ready-queue.json
Normal file
|
|
@ -0,0 +1,251 @@
|
|||
{
|
||||
"generated_at": "2026-03-03T08:38:56Z",
|
||||
"source": "br-list-workaround",
|
||||
"br_ready_status": "working",
|
||||
"total_available": 22,
|
||||
"workers_should_read": "This file contains available work. Read .beads[0] to get the highest priority bead.",
|
||||
"beads": [
|
||||
{
|
||||
"id": "bd-2zt",
|
||||
"title": "ALT-001: Fix br ready schema bug (root cause fix)",
|
||||
"priority": 0,
|
||||
"type": "task",
|
||||
"labels": [
|
||||
"br",
|
||||
"bug",
|
||||
"worker-starvation"
|
||||
]
|
||||
},
|
||||
{
|
||||
"id": "bd-2ed",
|
||||
"title": "Fix br ready schema bug (created_by column)",
|
||||
"priority": 0,
|
||||
"type": "task",
|
||||
"labels": [
|
||||
"blocking",
|
||||
"br",
|
||||
"bug"
|
||||
]
|
||||
},
|
||||
{
|
||||
"id": "bd-1mq",
|
||||
"title": "ALT-003: Use br list JSON instead of br ready",
|
||||
"priority": 1,
|
||||
"type": "task",
|
||||
"labels": [
|
||||
"alternative",
|
||||
"discovery",
|
||||
"worker"
|
||||
]
|
||||
},
|
||||
{
|
||||
"id": "bd-2r0",
|
||||
"title": "P3-007: Add web command to CLI",
|
||||
"priority": 1,
|
||||
"type": "task",
|
||||
"labels": [
|
||||
"cli",
|
||||
"phase-3",
|
||||
"web"
|
||||
]
|
||||
},
|
||||
{
|
||||
"id": "bd-2qm",
|
||||
"title": "P3-003: Create web frontend scaffold with Vite + React",
|
||||
"priority": 1,
|
||||
"type": "task",
|
||||
"labels": [
|
||||
"frontend",
|
||||
"phase-3",
|
||||
"web"
|
||||
]
|
||||
},
|
||||
{
|
||||
"id": "bd-2fa",
|
||||
"title": "P3-002: Implement WebSocket server for real-time events",
|
||||
"priority": 1,
|
||||
"type": "task",
|
||||
"labels": [
|
||||
"phase-3",
|
||||
"web",
|
||||
"websocket"
|
||||
]
|
||||
},
|
||||
{
|
||||
"id": "bd-2qr",
|
||||
"title": "P1: Create React frontend for web dashboard",
|
||||
"priority": 1,
|
||||
"type": "task",
|
||||
"labels": [
|
||||
"frontend",
|
||||
"phase-3",
|
||||
"react",
|
||||
"web"
|
||||
]
|
||||
},
|
||||
{
|
||||
"id": "bd-1sk",
|
||||
"title": "P1: Add WebSocket server for real-time updates",
|
||||
"priority": 1,
|
||||
"type": "task",
|
||||
"labels": [
|
||||
"phase-3",
|
||||
"realtime",
|
||||
"web",
|
||||
"websocket"
|
||||
]
|
||||
},
|
||||
{
|
||||
"id": "bd-1fk",
|
||||
"title": "P1: Add Express HTTP server for web dashboard",
|
||||
"priority": 1,
|
||||
"type": "task",
|
||||
"labels": [
|
||||
"http",
|
||||
"phase-3",
|
||||
"server",
|
||||
"web"
|
||||
]
|
||||
},
|
||||
{
|
||||
"id": "bd-2it",
|
||||
"title": "ALT-005: Environment variable override for br ready",
|
||||
"priority": 2,
|
||||
"type": "task",
|
||||
"labels": [
|
||||
"alternative",
|
||||
"discovery",
|
||||
"worker"
|
||||
]
|
||||
},
|
||||
{
|
||||
"id": "bd-33w",
|
||||
"title": "ALT-004: Pre-computed ready queue file",
|
||||
"priority": 2,
|
||||
"type": "task",
|
||||
"labels": [
|
||||
"alternative",
|
||||
"discovery",
|
||||
"worker"
|
||||
]
|
||||
},
|
||||
{
|
||||
"id": "bd-1c6",
|
||||
"title": "TEST-002: Add store integration tests",
|
||||
"priority": 2,
|
||||
"type": "task",
|
||||
"labels": [
|
||||
"store",
|
||||
"testing"
|
||||
]
|
||||
},
|
||||
{
|
||||
"id": "bd-5eh",
|
||||
"title": "TEST-001: Add comprehensive parser tests",
|
||||
"priority": 2,
|
||||
"type": "task",
|
||||
"labels": [
|
||||
"parser",
|
||||
"testing"
|
||||
]
|
||||
},
|
||||
{
|
||||
"id": "bd-1wo",
|
||||
"title": "P3-005: Build Activity Feed component with filtering",
|
||||
"priority": 2,
|
||||
"type": "task",
|
||||
"labels": [
|
||||
"frontend",
|
||||
"phase-3",
|
||||
"web"
|
||||
]
|
||||
},
|
||||
{
|
||||
"id": "bd-31n",
|
||||
"title": "P3-004: Build Worker Overview Cards component",
|
||||
"priority": 2,
|
||||
"type": "task",
|
||||
"labels": [
|
||||
"frontend",
|
||||
"phase-3",
|
||||
"web"
|
||||
]
|
||||
},
|
||||
{
|
||||
"id": "bd-2en",
|
||||
"title": "P2: Add unit tests for store.ts",
|
||||
"priority": 2,
|
||||
"type": "task",
|
||||
"labels": [
|
||||
"store",
|
||||
"testing",
|
||||
"unit-test"
|
||||
]
|
||||
},
|
||||
{
|
||||
"id": "bd-1a2",
|
||||
"title": "P2: Add unit tests for parser.ts",
|
||||
"priority": 2,
|
||||
"type": "task",
|
||||
"labels": [
|
||||
"parser",
|
||||
"testing",
|
||||
"unit-test"
|
||||
]
|
||||
},
|
||||
{
|
||||
"id": "bd-3tj",
|
||||
"title": "TEST-003: Add TUI component tests",
|
||||
"priority": 3,
|
||||
"type": "task",
|
||||
"labels": [
|
||||
"testing",
|
||||
"tui"
|
||||
]
|
||||
},
|
||||
{
|
||||
"id": "bd-r5c",
|
||||
"title": "P4-002: Implement Worker Collision Detection",
|
||||
"priority": 3,
|
||||
"type": "task",
|
||||
"labels": [
|
||||
"collision",
|
||||
"intelligence",
|
||||
"phase-4"
|
||||
]
|
||||
},
|
||||
{
|
||||
"id": "bd-2u8",
|
||||
"title": "P4-001: Implement Cross-Reference Hyperlinking",
|
||||
"priority": 3,
|
||||
"type": "task",
|
||||
"labels": [
|
||||
"hyperlinks",
|
||||
"intelligence",
|
||||
"phase-4"
|
||||
]
|
||||
},
|
||||
{
|
||||
"id": "bd-269",
|
||||
"title": "P3-006: Implement Timeline Visualization with Canvas",
|
||||
"priority": 3,
|
||||
"type": "task",
|
||||
"labels": [
|
||||
"frontend",
|
||||
"phase-3",
|
||||
"web"
|
||||
]
|
||||
},
|
||||
{
|
||||
"id": "bd-3a0",
|
||||
"title": "P4-003: Add Session Replay Feature",
|
||||
"priority": 4,
|
||||
"type": "task",
|
||||
"labels": [
|
||||
"intelligence",
|
||||
"phase-4",
|
||||
"replay"
|
||||
]
|
||||
}
|
||||
]
|
||||
}
|
||||
112
ROADMAP.md
Normal file
112
ROADMAP.md
Normal file
|
|
@ -0,0 +1,112 @@
|
|||
# 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
|
||||
|
||||
**Completed:**
|
||||
- Phase 1: Core Infrastructure
|
||||
- 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)
|
||||
|
||||
**In Progress:**
|
||||
- Phase 3: Web Dashboard
|
||||
|
||||
## 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
|
||||
|
||||
After Phase 2 is complete:
|
||||
|
||||
| Priority | Feature | Description |
|
||||
|----------|---------|-------------|
|
||||
| P1 | **HTTP Server** | Express/Fastify server |
|
||||
| P1 | **WebSocket** | Real-time updates |
|
||||
| P1 | **React Frontend** | Browser UI components |
|
||||
| P2 | **Timeline Viz** | Worker activity timeline |
|
||||
|
||||
## 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
|
||||
3243
package-lock.json
generated
3243
package-lock.json
generated
File diff suppressed because it is too large
Load diff
25
package.json
25
package.json
|
|
@ -9,12 +9,17 @@
|
|||
},
|
||||
"scripts": {
|
||||
"build": "tsc",
|
||||
"build:web": "vite build",
|
||||
"dev": "tsc --watch",
|
||||
"dev:web": "vite",
|
||||
"start": "node dist/cli.js",
|
||||
"tui": "node dist/cli.js tui",
|
||||
"web": "node dist/cli.js web",
|
||||
"clean": "rm -rf dist",
|
||||
"typecheck": "tsc --noEmit"
|
||||
"typecheck": "tsc --noEmit",
|
||||
"test": "vitest run",
|
||||
"test:watch": "vitest",
|
||||
"test:coverage": "vitest run --coverage"
|
||||
},
|
||||
"keywords": [
|
||||
"needle",
|
||||
|
|
@ -30,11 +35,25 @@
|
|||
"node": ">=18.0.0"
|
||||
},
|
||||
"devDependencies": {
|
||||
"@types/express": "^5.0.6",
|
||||
"@types/node": "^20.11.0",
|
||||
"typescript": "^5.3.0"
|
||||
"@types/react": "^19.2.14",
|
||||
"@types/react-dom": "^19.2.3",
|
||||
"@types/ws": "^8.18.1",
|
||||
"@vitejs/plugin-react": "^5.1.4",
|
||||
"@vitest/coverage-v8": "^4.0.18",
|
||||
"react": "^19.2.4",
|
||||
"react-dom": "^19.2.4",
|
||||
"typescript": "^5.3.0",
|
||||
"vite": "^7.3.1",
|
||||
"vitest": "^4.0.18"
|
||||
},
|
||||
"dependencies": {
|
||||
"@types/blessed": "^0.1.27",
|
||||
"blessed": "^0.1.81",
|
||||
"chalk": "^4.1.2",
|
||||
"commander": "^12.0.0"
|
||||
"commander": "^12.0.0",
|
||||
"express": "^5.2.1",
|
||||
"ws": "^8.19.0"
|
||||
}
|
||||
}
|
||||
|
|
|
|||
81
scripts/br-get-next-bead.sh
Executable file
81
scripts/br-get-next-bead.sh
Executable file
|
|
@ -0,0 +1,81 @@
|
|||
#!/bin/bash
|
||||
# br-get-next-bead.sh
|
||||
# ALT-006: Direct ready-queue.json reader
|
||||
#
|
||||
# This is an ALTERNATIVE to br ready that reads the pre-computed
|
||||
# ready-queue.json file instead of querying the database.
|
||||
#
|
||||
# Usage:
|
||||
# ./scripts/br-get-next-bead.sh # Get highest priority bead
|
||||
# ./scripts/br-get-next-bead.sh --claim # Get and claim the bead
|
||||
# ./scripts/br-get-next-bead.sh --json # Output as JSON
|
||||
#
|
||||
# For HUMAN bead bd-3sh - Worker starvation alternative solution
|
||||
|
||||
set -euo pipefail
|
||||
|
||||
READY_QUEUE="/home/coder/FABRIC/.beads/ready-queue.json"
|
||||
CLAIM_MODE=false
|
||||
JSON_OUTPUT=false
|
||||
|
||||
while [[ $# -gt 0 ]]; do
|
||||
case $1 in
|
||||
--claim|-c)
|
||||
CLAIM_MODE=true
|
||||
shift
|
||||
;;
|
||||
--json|-j)
|
||||
JSON_OUTPUT=true
|
||||
shift
|
||||
;;
|
||||
--help|-h)
|
||||
echo "Usage: $0 [--claim] [--json]"
|
||||
echo ""
|
||||
echo "Options:"
|
||||
echo " --claim, -c Claim the bead (set status to in_progress)"
|
||||
echo " --json, -j Output as JSON"
|
||||
echo " --help, -h Show this help"
|
||||
exit 0
|
||||
;;
|
||||
*)
|
||||
echo "Unknown option: $1"
|
||||
exit 1
|
||||
;;
|
||||
esac
|
||||
done
|
||||
|
||||
# Check if ready-queue exists
|
||||
if [[ ! -f "$READY_QUEUE" ]]; then
|
||||
echo "ERROR: ready-queue.json not found at $READY_QUEUE" >&2
|
||||
echo "Run the queue generator first or use br-ready-workaround.sh" >&2
|
||||
exit 1
|
||||
fi
|
||||
|
||||
# Get the first available bead (highest priority)
|
||||
NEXT_BEAD=$(jq -c '.beads[0]' "$READY_QUEUE" 2>/dev/null)
|
||||
|
||||
if [[ -z "$NEXT_BEAD" || "$NEXT_BEAD" == "null" ]]; then
|
||||
echo "ERROR: No beads available in ready-queue.json" >&2
|
||||
exit 1
|
||||
fi
|
||||
|
||||
BEAD_ID=$(echo "$NEXT_BEAD" | jq -r '.id')
|
||||
BEAD_TITLE=$(echo "$NEXT_BEAD" | jq -r '.title')
|
||||
BEAD_PRIORITY=$(echo "$NEXT_BEAD" | jq -r '.priority')
|
||||
|
||||
if [[ "$JSON_OUTPUT" == "true" ]]; then
|
||||
echo "$NEXT_BEAD"
|
||||
else
|
||||
echo "Next available bead:"
|
||||
echo " ID: $BEAD_ID"
|
||||
echo " Priority: P$BEAD_PRIORITY"
|
||||
echo " Title: $BEAD_TITLE"
|
||||
fi
|
||||
|
||||
# Claim the bead if requested
|
||||
if [[ "$CLAIM_MODE" == "true" ]]; then
|
||||
echo ""
|
||||
echo "Claiming bead $BEAD_ID..."
|
||||
br update "$BEAD_ID" --status in_progress
|
||||
echo "Bead claimed! Start working on: $BEAD_TITLE"
|
||||
fi
|
||||
117
scripts/br-ready-jsonl.sh
Executable file
117
scripts/br-ready-jsonl.sh
Executable file
|
|
@ -0,0 +1,117 @@
|
|||
#!/bin/bash
|
||||
# br-ready-jsonl.sh
|
||||
# ALT-003: JSON/br list parsing - uses br list --format json which works
|
||||
#
|
||||
# This alternative uses br list --format json which doesn't have the schema bug
|
||||
# that affects br ready. It then filters for available work using jq.
|
||||
#
|
||||
# Advantages:
|
||||
# - Uses working br list command (no schema bug)
|
||||
# - Works with just jq (portable)
|
||||
# - Can be used as drop-in replacement for br ready
|
||||
#
|
||||
# Usage:
|
||||
# ./scripts/br-ready-jsonl.sh # List available beads
|
||||
# ./scripts/br-ready-jsonl.sh --json # JSON output
|
||||
# ./scripts/br-ready-jsonl.sh --priority 1 # P1 only
|
||||
#
|
||||
# Exit codes:
|
||||
# 0 - Found available work
|
||||
# 1 - No available work found
|
||||
# 2 - Error (jq not installed, br list fails, etc.)
|
||||
|
||||
set -euo pipefail
|
||||
|
||||
SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
|
||||
PROJECT_ROOT="$(dirname "$SCRIPT_DIR")"
|
||||
|
||||
JSON_OUTPUT=false
|
||||
PRIORITY_FILTER=""
|
||||
LIMIT=20
|
||||
|
||||
while [[ $# -gt 0 ]]; do
|
||||
case $1 in
|
||||
--json|-j)
|
||||
JSON_OUTPUT=true
|
||||
shift
|
||||
;;
|
||||
--priority|-p)
|
||||
PRIORITY_FILTER="$2"
|
||||
shift 2
|
||||
;;
|
||||
--limit|-l)
|
||||
LIMIT="$2"
|
||||
shift 2
|
||||
;;
|
||||
--help|-h)
|
||||
echo "Usage: $0 [--json] [--priority N] [--limit N]"
|
||||
echo "Find available work using br list (avoids br ready schema bug)"
|
||||
echo ""
|
||||
echo "Options:"
|
||||
echo " --json, -j Output as JSON array"
|
||||
echo " --priority, -p N Filter by priority (0-4)"
|
||||
echo " --limit, -l N Max results (default: 20)"
|
||||
echo " --help, -h Show this help"
|
||||
exit 0
|
||||
;;
|
||||
*)
|
||||
echo "Unknown option: $1" >&2
|
||||
exit 2
|
||||
;;
|
||||
esac
|
||||
done
|
||||
|
||||
cd "$PROJECT_ROOT"
|
||||
|
||||
# Check dependencies
|
||||
if ! command -v jq &>/dev/null; then
|
||||
echo "Error: jq is required but not installed" >&2
|
||||
exit 2
|
||||
fi
|
||||
|
||||
# Use br list --format json which works (unlike br ready)
|
||||
# Filter for:
|
||||
# - status == "open"
|
||||
# - issue_type NOT IN ("human", "phase", "epic")
|
||||
# - (optional) priority == PRIORITY_FILTER
|
||||
if $JSON_OUTPUT; then
|
||||
# Output as JSON array
|
||||
result=$(br list --all --format json 2>/dev/null | jq -c --arg prio "$PRIORITY_FILTER" --argjson limit "$LIMIT" '
|
||||
[.[]
|
||||
| select(.status == "open")
|
||||
| select(.issue_type != "human" and .issue_type != "phase" and .issue_type != "epic")
|
||||
| select(.issue_type == "task" or .issue_type == "blocker")
|
||||
| if $prio != "" then select(.priority == ($prio | tonumber)) else . end
|
||||
| {id, title, priority, issue_type}]
|
||||
| sort_by(.priority, .id)
|
||||
| .[:$limit]
|
||||
')
|
||||
|
||||
if [[ "$result" == "[]" ]]; then
|
||||
echo "[]"
|
||||
exit 1
|
||||
fi
|
||||
echo "$result"
|
||||
else
|
||||
# Output as table
|
||||
echo "ID PRI TYPE TITLE"
|
||||
echo "------ --- ------- --------------------------------------------------"
|
||||
|
||||
count=$(br list --all --format json 2>/dev/null | jq -r --arg prio "$PRIORITY_FILTER" '
|
||||
.[]
|
||||
| select(.status == "open")
|
||||
| select(.issue_type != "human" and .issue_type != "phase" and .issue_type != "epic")
|
||||
| select(.issue_type == "task" or .issue_type == "blocker")
|
||||
| if $prio != "" then select(.priority == ($prio | tonumber)) else . end
|
||||
| "\(.id)\t\(.priority)\t\(.issue_type)\t\(.title)"
|
||||
' | sort -t$'\t' -k2,2n -k1,1 | head -$LIMIT | column -t -s $'\t' | tee /dev/stderr | wc -l)
|
||||
|
||||
if [[ $count -eq 0 ]]; then
|
||||
echo ""
|
||||
echo "No available work found"
|
||||
exit 1
|
||||
fi
|
||||
|
||||
echo ""
|
||||
echo "To claim: br update <bead-id> --status in_progress"
|
||||
fi
|
||||
71
scripts/br-ready-queue.sh
Executable file
71
scripts/br-ready-queue.sh
Executable file
|
|
@ -0,0 +1,71 @@
|
|||
#!/bin/bash
|
||||
# br-ready-queue.sh
|
||||
# ALT-004: Ready Queue File - pre-computed work queue
|
||||
#
|
||||
# This alternative maintains a ready-queue.json file that workers can read
|
||||
# directly without any br commands. A background process or cron refreshes it.
|
||||
#
|
||||
# Usage:
|
||||
# ./scripts/br-ready-queue.sh refresh # Refresh the queue file
|
||||
# ./scripts/br-ready-queue.sh read # Read current queue (for workers)
|
||||
# ./scripts/br-ready-queue.sh watch # Watch mode (refresh every 60s)
|
||||
#
|
||||
# Queue file location: .beads/ready-queue.json
|
||||
#
|
||||
# Workers can simply:
|
||||
# cat .beads/ready-queue.json | jq '.[0]' # Get first available bead
|
||||
|
||||
set -euo pipefail
|
||||
|
||||
SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
|
||||
PROJECT_ROOT="$(dirname "$SCRIPT_DIR")"
|
||||
QUEUE_FILE="$PROJECT_ROOT/.beads/ready-queue.json"
|
||||
JSONL_FILE="$PROJECT_ROOT/.beads/issues.jsonl"
|
||||
|
||||
refresh_queue() {
|
||||
if [[ ! -f "$JSONL_FILE" ]]; then
|
||||
echo "[]" > "$QUEUE_FILE"
|
||||
return 1
|
||||
fi
|
||||
|
||||
jq -c -s '
|
||||
map(select(.status == "open"))
|
||||
| map(select(.issue_type != "human" and .issue_type != "phase" and .issue_type != "epic"))
|
||||
| sort_by(.priority, .id)
|
||||
| [{id, title, priority, issue_type, labels, dependencies, updated_at: (now | todate)}]
|
||||
' "$JSONL_FILE" > "$QUEUE_FILE" 2>/dev/null
|
||||
|
||||
echo "Queue refreshed: $(jq 'length' "$QUEUE_FILE") beads available"
|
||||
}
|
||||
|
||||
read_queue() {
|
||||
if [[ ! -f "$QUEUE_FILE" ]]; then
|
||||
echo "[]" >&2
|
||||
return 1
|
||||
fi
|
||||
cat "$QUEUE_FILE"
|
||||
}
|
||||
|
||||
watch_queue() {
|
||||
echo "Starting watch mode (refresh every 60s)..."
|
||||
while true; do
|
||||
refresh_queue
|
||||
sleep 60
|
||||
done
|
||||
}
|
||||
|
||||
case "${1:-read}" in
|
||||
refresh)
|
||||
refresh_queue
|
||||
;;
|
||||
read)
|
||||
read_queue
|
||||
;;
|
||||
watch)
|
||||
watch_queue
|
||||
;;
|
||||
*)
|
||||
echo "Usage: $0 {refresh|read|watch}"
|
||||
exit 1
|
||||
;;
|
||||
esac
|
||||
46
scripts/br-ready-workaround.sh
Executable file
46
scripts/br-ready-workaround.sh
Executable file
|
|
@ -0,0 +1,46 @@
|
|||
#!/bin/bash
|
||||
# br-ready-workaround.sh
|
||||
# Workaround for "br ready" schema bug (Invalid column type Text at index: 14, name: created_by)
|
||||
#
|
||||
# Usage:
|
||||
# ./br-ready-workaround.sh [--priority N] [--type TYPE]
|
||||
#
|
||||
# This script replicates br ready functionality using br list --all --format json
|
||||
# until the schema bug is fixed.
|
||||
|
||||
set -euo pipefail
|
||||
|
||||
PRIORITY_FILTER=""
|
||||
TYPE_FILTER=""
|
||||
|
||||
while [[ $# -gt 0 ]]; do
|
||||
case $1 in
|
||||
--priority|-p)
|
||||
PRIORITY_FILTER="$2"
|
||||
shift 2
|
||||
;;
|
||||
--type|-t)
|
||||
TYPE_FILTER="$2"
|
||||
shift 2
|
||||
;;
|
||||
*)
|
||||
echo "Unknown option: $1"
|
||||
exit 1
|
||||
;;
|
||||
esac
|
||||
done
|
||||
|
||||
# Get all beads as JSON and filter with jq
|
||||
br list --all --format json 2>/dev/null | jq -c --arg prio "$PRIORITY_FILTER" --arg type "$TYPE_FILTER" '
|
||||
.[]
|
||||
| select(.status == "open")
|
||||
| select(.issue_type != "human" and .issue_type != "phase" and .issue_type != "epic")
|
||||
| if $prio != "" then select(.priority == ($prio | tonumber)) else . end
|
||||
| if $type != "" then select(.issue_type == $type) else . end
|
||||
| {id, title, priority, issue_type, labels}
|
||||
| [.id, "P\(.priority)", .issue_type, .title]
|
||||
| @tsv
|
||||
' -r | head -20 | column -t -s $'\t'
|
||||
|
||||
echo ""
|
||||
echo "To work on a bead, use: br update <bead-id> --status in_progress"
|
||||
66
scripts/br-ready-wrapper.sh
Executable file
66
scripts/br-ready-wrapper.sh
Executable file
|
|
@ -0,0 +1,66 @@
|
|||
#!/bin/bash
|
||||
# br-ready-wrapper.sh
|
||||
# Drop-in replacement for "br ready" that works around the schema bug.
|
||||
#
|
||||
# This script outputs the same format as "br ready" so it can be used as a
|
||||
# direct replacement in worker scripts.
|
||||
#
|
||||
# Usage:
|
||||
# ./scripts/br-ready-wrapper.sh # Equivalent to "br ready"
|
||||
# ./scripts/br-ready-wrapper.sh --json # JSON output format
|
||||
#
|
||||
# To use as a permanent replacement:
|
||||
# alias br-ready='./scripts/br-ready-wrapper.sh'
|
||||
# # Or add to ~/.bashrc:
|
||||
# export PATH="$HOME/FABRIC/scripts:$PATH"
|
||||
|
||||
set -euo pipefail
|
||||
|
||||
SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
|
||||
PROJECT_ROOT="$(dirname "$SCRIPT_DIR")"
|
||||
|
||||
JSON_OUTPUT=false
|
||||
|
||||
while [[ $# -gt 0 ]]; do
|
||||
case $1 in
|
||||
--json|-j)
|
||||
JSON_OUTPUT=true
|
||||
shift
|
||||
;;
|
||||
--help|-h)
|
||||
echo "Usage: $0 [--json]"
|
||||
echo "Drop-in replacement for 'br ready' command"
|
||||
exit 0
|
||||
;;
|
||||
*)
|
||||
echo "Unknown option: $1" >&2
|
||||
exit 1
|
||||
;;
|
||||
esac
|
||||
done
|
||||
|
||||
cd "$PROJECT_ROOT"
|
||||
|
||||
if $JSON_OUTPUT; then
|
||||
# Output as JSON array (same format as br ready --json)
|
||||
br list --all --format json 2>/dev/null | jq -c '
|
||||
[.[]
|
||||
| select(.status == "open")
|
||||
| select(.issue_type != "human" and .issue_type != "phase" and .issue_type != "epic")
|
||||
| {id, title, priority, issue_type, labels, dependencies}]
|
||||
'
|
||||
else
|
||||
# Output in tabular format (similar to br ready)
|
||||
echo "ID PRI TYPE TITLE"
|
||||
echo "------ --- ------ --------------------------------------------------"
|
||||
br list --all --format json 2>/dev/null | jq -r '
|
||||
.[]
|
||||
| select(.status == "open")
|
||||
| select(.issue_type != "human" and .issue_type != "phase" and .issue_type != "epic")
|
||||
| "\(.id)\t\(.priority)\t\(.issue_type)\t\(.title)"
|
||||
' | sort -t$'\t' -k2,2n -k1,1 | head -20 | while IFS=$'\t' read -r id pri type title; do
|
||||
printf "%-7s P%-3d %-7s %s\n" "$id" "$pri" "$type" "$title"
|
||||
done
|
||||
echo ""
|
||||
echo "To claim: br update <bead-id> --status in_progress"
|
||||
fi
|
||||
49
scripts/br-regenerate-queue.sh
Executable file
49
scripts/br-regenerate-queue.sh
Executable file
|
|
@ -0,0 +1,49 @@
|
|||
#!/bin/bash
|
||||
# br-regenerate-queue.sh
|
||||
# ALT-006配套: Regenerate ready-queue.json
|
||||
#
|
||||
# This script regenerates the ready-queue.json file by querying br list
|
||||
# and filtering for available work.
|
||||
#
|
||||
# Should be run periodically or when new beads are created.
|
||||
#
|
||||
# Usage:
|
||||
# ./scripts/br-regenerate-queue.sh
|
||||
|
||||
set -euo pipefail
|
||||
|
||||
BEADS_DIR="/home/coder/FABRIC/.beads"
|
||||
READY_QUEUE="$BEADS_DIR/ready-queue.json"
|
||||
|
||||
echo "Regenerating ready-queue.json..."
|
||||
|
||||
# Generate the queue using br list workaround
|
||||
BEADS_JSON=$(br list --all --format json 2>/dev/null | jq -c '
|
||||
[.[]
|
||||
| select(.status == "open")
|
||||
| select(.issue_type != "human" and .issue_type != "phase" and .issue_type != "epic")
|
||||
| {id, title, priority: .priority, type: .issue_type, labels}
|
||||
] | sort_by(.priority)
|
||||
')
|
||||
|
||||
# Count beads
|
||||
COUNT=$(echo "$BEADS_JSON" | jq 'length')
|
||||
|
||||
# Create the output
|
||||
jq -n \
|
||||
--arg generated "$(date -u +%Y-%m-%dT%H:%M:%SZ)" \
|
||||
--arg source "br-list-workaround" \
|
||||
--arg br_status "$(br ready 2>&1 | head -1 || echo 'unknown')" \
|
||||
--argjson beads "$BEADS_JSON" \
|
||||
'{
|
||||
generated_at: $generated,
|
||||
source: $source,
|
||||
br_ready_status: (if $br_status | contains("Invalid column") then "broken" else "working" end),
|
||||
total_available: ($beads | length),
|
||||
workers_should_read: "This file contains available work. Read .beads[0] to get the highest priority bead.",
|
||||
beads: $beads
|
||||
}' > "$READY_QUEUE"
|
||||
|
||||
echo "Done! $COUNT beads available in $READY_QUEUE"
|
||||
echo ""
|
||||
echo "Next bead: $(jq -r '.beads[0].id + " - " + .beads[0].title' "$READY_QUEUE")"
|
||||
98
src/cli.ts
98
src/cli.ts
|
|
@ -13,6 +13,8 @@ import { VERSION } from './index.js';
|
|||
import { LogTailer, tailLogFile } from './tailer.js';
|
||||
import { formatEvent } from './parser.js';
|
||||
import { getStore } from './store.js';
|
||||
import { createTuiApp } from './tui/index.js';
|
||||
import { createWebServer } from './web/index.js';
|
||||
|
||||
const program = new Command();
|
||||
|
||||
|
|
@ -25,10 +27,43 @@ program
|
|||
.command('tui')
|
||||
.description('Launch terminal UI dashboard')
|
||||
.option('-f, --file <path>', 'Log file to tail', '~/.needle/logs/workers.log')
|
||||
.action((options) => {
|
||||
console.log('FABRIC TUI - Terminal Dashboard');
|
||||
console.log(`Watching: ${options.file}`);
|
||||
console.log('\n(TUI implementation coming in Phase 2)');
|
||||
.action(async (options) => {
|
||||
const filePath = options.file.replace('~', process.env.HOME || '');
|
||||
|
||||
try {
|
||||
const store = getStore();
|
||||
const app = createTuiApp(store, { logPath: filePath });
|
||||
|
||||
// Setup log tailing
|
||||
const tailer = new LogTailer({
|
||||
path: filePath,
|
||||
parseJson: true,
|
||||
follow: true,
|
||||
lines: 50, // Load last 50 lines on start
|
||||
});
|
||||
|
||||
tailer.on('event', (event) => {
|
||||
store.add(event);
|
||||
app.addEvent(event);
|
||||
});
|
||||
|
||||
tailer.on('error', (err) => {
|
||||
console.error(`Tailer error: ${err.message}`);
|
||||
});
|
||||
|
||||
// Start tailing and TUI
|
||||
tailer.start();
|
||||
app.start();
|
||||
|
||||
// Handle graceful shutdown
|
||||
process.on('SIGINT', () => {
|
||||
tailer.stop();
|
||||
app.stop();
|
||||
});
|
||||
} catch (err) {
|
||||
console.error(`Failed to start TUI: ${(err as Error).message}`);
|
||||
process.exit(1);
|
||||
}
|
||||
});
|
||||
|
||||
program
|
||||
|
|
@ -36,11 +71,56 @@ program
|
|||
.description('Launch web dashboard')
|
||||
.option('-p, --port <number>', 'Port to listen on', '3000')
|
||||
.option('-f, --file <path>', 'Log file to tail', '~/.needle/logs/workers.log')
|
||||
.action((options) => {
|
||||
console.log('FABRIC Web Dashboard');
|
||||
console.log(`Starting server on port ${options.port}`);
|
||||
console.log(`Watching: ${options.file}`);
|
||||
console.log('\n(Web implementation coming in Phase 3)');
|
||||
.action(async (options) => {
|
||||
const filePath = options.file.replace('~', process.env.HOME || '');
|
||||
const port = parseInt(options.port, 10) || 3000;
|
||||
|
||||
try {
|
||||
const store = getStore();
|
||||
const server = createWebServer({
|
||||
port,
|
||||
logPath: filePath,
|
||||
store,
|
||||
});
|
||||
|
||||
// Setup log tailing
|
||||
const tailer = new LogTailer({
|
||||
path: filePath,
|
||||
parseJson: true,
|
||||
follow: true,
|
||||
lines: 100, // Load last 100 lines on start
|
||||
});
|
||||
|
||||
tailer.on('event', (event) => {
|
||||
store.add(event);
|
||||
server.broadcast(event);
|
||||
});
|
||||
|
||||
tailer.on('error', (err) => {
|
||||
console.error(`Tailer error: ${err.message}`);
|
||||
});
|
||||
|
||||
// Handle graceful shutdown
|
||||
process.on('SIGINT', () => {
|
||||
console.log('\nShutting down...');
|
||||
tailer.stop();
|
||||
server.stop();
|
||||
process.exit(0);
|
||||
});
|
||||
|
||||
server.on('error', (err: Error) => {
|
||||
console.error(`Server error: ${err.message}`);
|
||||
process.exit(1);
|
||||
});
|
||||
|
||||
// Start tailing and server
|
||||
tailer.start();
|
||||
server.start();
|
||||
|
||||
} catch (err) {
|
||||
console.error(`Failed to start web server: ${(err as Error).message}`);
|
||||
process.exit(1);
|
||||
}
|
||||
});
|
||||
|
||||
program
|
||||
|
|
|
|||
380
src/parser.test.ts
Normal file
380
src/parser.test.ts
Normal file
|
|
@ -0,0 +1,380 @@
|
|||
/**
|
||||
* Tests for FABRIC Log Parser
|
||||
*/
|
||||
|
||||
import { describe, it, expect } from 'vitest';
|
||||
import { parseLogLine, parseLogLines, formatEvent } from './parser.js';
|
||||
import { LogEvent, LogLevel } from './types.js';
|
||||
|
||||
describe('parseLogLine', () => {
|
||||
describe('valid inputs', () => {
|
||||
it('should parse a minimal valid log line', () => {
|
||||
const line = JSON.stringify({
|
||||
ts: 1709337600000,
|
||||
worker: 'w-abc123',
|
||||
level: 'info',
|
||||
msg: 'Test message',
|
||||
});
|
||||
|
||||
const result = parseLogLine(line);
|
||||
|
||||
expect(result).toEqual({
|
||||
ts: 1709337600000,
|
||||
worker: 'w-abc123',
|
||||
level: 'info',
|
||||
msg: 'Test message',
|
||||
});
|
||||
});
|
||||
|
||||
it('should parse a log line with all optional fields', () => {
|
||||
const line = JSON.stringify({
|
||||
ts: 1709337600000,
|
||||
worker: 'w-abc123',
|
||||
level: 'debug',
|
||||
msg: 'Tool call',
|
||||
tool: 'Read',
|
||||
path: '/src/main.ts',
|
||||
bead: 'bd-xyz',
|
||||
duration_ms: 5000,
|
||||
error: 'some error',
|
||||
});
|
||||
|
||||
const result = parseLogLine(line);
|
||||
|
||||
expect(result).toEqual({
|
||||
ts: 1709337600000,
|
||||
worker: 'w-abc123',
|
||||
level: 'debug',
|
||||
msg: 'Tool call',
|
||||
tool: 'Read',
|
||||
path: '/src/main.ts',
|
||||
bead: 'bd-xyz',
|
||||
duration_ms: 5000,
|
||||
error: 'some error',
|
||||
});
|
||||
});
|
||||
|
||||
it('should preserve additional non-standard fields', () => {
|
||||
const line = JSON.stringify({
|
||||
ts: 1709337600000,
|
||||
worker: 'w-abc123',
|
||||
level: 'info',
|
||||
msg: 'Test',
|
||||
customField: 'custom value',
|
||||
tokens: 150,
|
||||
});
|
||||
|
||||
const result = parseLogLine(line);
|
||||
|
||||
expect(result).toMatchObject({
|
||||
ts: 1709337600000,
|
||||
worker: 'w-abc123',
|
||||
level: 'info',
|
||||
msg: 'Test',
|
||||
customField: 'custom value',
|
||||
tokens: 150,
|
||||
});
|
||||
});
|
||||
|
||||
it('should accept all valid log levels', () => {
|
||||
const levels: LogLevel[] = ['debug', 'info', 'warn', 'error'];
|
||||
|
||||
for (const level of levels) {
|
||||
const line = JSON.stringify({
|
||||
ts: 1709337600000,
|
||||
worker: 'w-test',
|
||||
level,
|
||||
msg: 'Test',
|
||||
});
|
||||
|
||||
const result = parseLogLine(line);
|
||||
expect(result?.level).toBe(level);
|
||||
}
|
||||
});
|
||||
});
|
||||
|
||||
describe('invalid inputs', () => {
|
||||
it('should return null for empty string', () => {
|
||||
expect(parseLogLine('')).toBeNull();
|
||||
});
|
||||
|
||||
it('should return null for whitespace-only string', () => {
|
||||
expect(parseLogLine(' \n\t ')).toBeNull();
|
||||
});
|
||||
|
||||
it('should return null for non-JSON string', () => {
|
||||
expect(parseLogLine('not valid json')).toBeNull();
|
||||
});
|
||||
|
||||
it('should return null for malformed JSON', () => {
|
||||
expect(parseLogLine('{"ts": 123,')).toBeNull();
|
||||
});
|
||||
|
||||
it('should return null when ts is missing', () => {
|
||||
const line = JSON.stringify({
|
||||
worker: 'w-test',
|
||||
level: 'info',
|
||||
msg: 'Test',
|
||||
});
|
||||
|
||||
expect(parseLogLine(line)).toBeNull();
|
||||
});
|
||||
|
||||
it('should return null when ts is not a number', () => {
|
||||
const line = JSON.stringify({
|
||||
ts: 'not-a-number',
|
||||
worker: 'w-test',
|
||||
level: 'info',
|
||||
msg: 'Test',
|
||||
});
|
||||
|
||||
expect(parseLogLine(line)).toBeNull();
|
||||
});
|
||||
|
||||
it('should return null when worker is missing', () => {
|
||||
const line = JSON.stringify({
|
||||
ts: 1709337600000,
|
||||
level: 'info',
|
||||
msg: 'Test',
|
||||
});
|
||||
|
||||
expect(parseLogLine(line)).toBeNull();
|
||||
});
|
||||
|
||||
it('should return null when worker is not a string', () => {
|
||||
const line = JSON.stringify({
|
||||
ts: 1709337600000,
|
||||
worker: 123,
|
||||
level: 'info',
|
||||
msg: 'Test',
|
||||
});
|
||||
|
||||
expect(parseLogLine(line)).toBeNull();
|
||||
});
|
||||
|
||||
it('should return null when level is missing', () => {
|
||||
const line = JSON.stringify({
|
||||
ts: 1709337600000,
|
||||
worker: 'w-test',
|
||||
msg: 'Test',
|
||||
});
|
||||
|
||||
expect(parseLogLine(line)).toBeNull();
|
||||
});
|
||||
|
||||
it('should return null when level is invalid', () => {
|
||||
const line = JSON.stringify({
|
||||
ts: 1709337600000,
|
||||
worker: 'w-test',
|
||||
level: 'invalid',
|
||||
msg: 'Test',
|
||||
});
|
||||
|
||||
expect(parseLogLine(line)).toBeNull();
|
||||
});
|
||||
|
||||
it('should return null when msg is missing', () => {
|
||||
const line = JSON.stringify({
|
||||
ts: 1709337600000,
|
||||
worker: 'w-test',
|
||||
level: 'info',
|
||||
});
|
||||
|
||||
expect(parseLogLine(line)).toBeNull();
|
||||
});
|
||||
|
||||
it('should return null when msg is not a string', () => {
|
||||
const line = JSON.stringify({
|
||||
ts: 1709337600000,
|
||||
worker: 'w-test',
|
||||
level: 'info',
|
||||
msg: { text: 'nested' },
|
||||
});
|
||||
|
||||
expect(parseLogLine(line)).toBeNull();
|
||||
});
|
||||
});
|
||||
});
|
||||
|
||||
describe('parseLogLines', () => {
|
||||
it('should parse multiple valid log lines', () => {
|
||||
const content = [
|
||||
JSON.stringify({ ts: 1, worker: 'w1', level: 'info', msg: 'first' }),
|
||||
JSON.stringify({ ts: 2, worker: 'w2', level: 'debug', msg: 'second' }),
|
||||
JSON.stringify({ ts: 3, worker: 'w3', level: 'warn', msg: 'third' }),
|
||||
].join('\n');
|
||||
|
||||
const results = parseLogLines(content);
|
||||
|
||||
expect(results).toHaveLength(3);
|
||||
expect(results[0].msg).toBe('first');
|
||||
expect(results[1].msg).toBe('second');
|
||||
expect(results[2].msg).toBe('third');
|
||||
});
|
||||
|
||||
it('should skip invalid lines', () => {
|
||||
const content = [
|
||||
JSON.stringify({ ts: 1, worker: 'w1', level: 'info', msg: 'valid' }),
|
||||
'invalid json',
|
||||
JSON.stringify({ ts: 2, worker: 'w2', level: 'info', msg: 'also valid' }),
|
||||
].join('\n');
|
||||
|
||||
const results = parseLogLines(content);
|
||||
|
||||
expect(results).toHaveLength(2);
|
||||
expect(results[0].msg).toBe('valid');
|
||||
expect(results[1].msg).toBe('also valid');
|
||||
});
|
||||
|
||||
it('should skip empty lines', () => {
|
||||
const content = [
|
||||
JSON.stringify({ ts: 1, worker: 'w1', level: 'info', msg: 'first' }),
|
||||
'',
|
||||
' ',
|
||||
JSON.stringify({ ts: 2, worker: 'w2', level: 'info', msg: 'second' }),
|
||||
].join('\n');
|
||||
|
||||
const results = parseLogLines(content);
|
||||
|
||||
expect(results).toHaveLength(2);
|
||||
});
|
||||
|
||||
it('should return empty array for empty content', () => {
|
||||
expect(parseLogLines('')).toEqual([]);
|
||||
expect(parseLogLines('\n\n\n')).toEqual([]);
|
||||
});
|
||||
|
||||
it('should handle content with trailing newline', () => {
|
||||
const content =
|
||||
JSON.stringify({ ts: 1, worker: 'w1', level: 'info', msg: 'test' }) + '\n';
|
||||
|
||||
const results = parseLogLines(content);
|
||||
|
||||
expect(results).toHaveLength(1);
|
||||
});
|
||||
});
|
||||
|
||||
describe('formatEvent', () => {
|
||||
const baseEvent: LogEvent = {
|
||||
ts: 1709337600000, // 2024-03-02 00:00:00 UTC
|
||||
worker: 'w-test',
|
||||
level: 'info',
|
||||
msg: 'Test message',
|
||||
};
|
||||
|
||||
it('should format a basic event', () => {
|
||||
const formatted = formatEvent(baseEvent);
|
||||
|
||||
expect(formatted).toContain('w-test');
|
||||
expect(formatted).toContain('INFO');
|
||||
expect(formatted).toContain('Test message');
|
||||
});
|
||||
|
||||
it('should include timestamp', () => {
|
||||
const formatted = formatEvent(baseEvent);
|
||||
|
||||
// Timestamp should be in HH:MM:SS format
|
||||
expect(formatted).toMatch(/\d{2}:\d{2}:\d{2}/);
|
||||
});
|
||||
|
||||
it('should hide worker when showWorker is false', () => {
|
||||
const formatted = formatEvent(baseEvent, { showWorker: false });
|
||||
|
||||
// Worker ID should be padded to 12 chars in normal mode
|
||||
// In hidden mode, it shouldn't appear
|
||||
expect(formatted).not.toContain('w-test');
|
||||
});
|
||||
|
||||
it('should hide level when showLevel is false', () => {
|
||||
const formatted = formatEvent(baseEvent, { showLevel: false });
|
||||
|
||||
expect(formatted).not.toContain('INFO');
|
||||
});
|
||||
|
||||
it('should include tool when present', () => {
|
||||
const event: LogEvent = { ...baseEvent, tool: 'Read' };
|
||||
const formatted = formatEvent(event);
|
||||
|
||||
expect(formatted).toContain('[Read]');
|
||||
});
|
||||
|
||||
it('should include path when present', () => {
|
||||
const event: LogEvent = { ...baseEvent, path: '/src/main.ts' };
|
||||
const formatted = formatEvent(event);
|
||||
|
||||
expect(formatted).toContain('/src/main.ts');
|
||||
});
|
||||
|
||||
it('should include bead when present', () => {
|
||||
const event: LogEvent = { ...baseEvent, bead: 'bd-xyz' };
|
||||
const formatted = formatEvent(event);
|
||||
|
||||
expect(formatted).toContain('bead:bd-xyz');
|
||||
});
|
||||
|
||||
it('should include duration when present', () => {
|
||||
const event: LogEvent = { ...baseEvent, duration_ms: 5000 };
|
||||
const formatted = formatEvent(event);
|
||||
|
||||
expect(formatted).toContain('5.0s');
|
||||
});
|
||||
|
||||
it('should include error when present', () => {
|
||||
const event: LogEvent = { ...baseEvent, error: 'Something went wrong' };
|
||||
const formatted = formatEvent(event);
|
||||
|
||||
expect(formatted).toContain('ERROR: Something went wrong');
|
||||
});
|
||||
|
||||
it('should format short durations in milliseconds', () => {
|
||||
const event: LogEvent = { ...baseEvent, duration_ms: 500 };
|
||||
const formatted = formatEvent(event);
|
||||
|
||||
expect(formatted).toContain('500ms');
|
||||
});
|
||||
|
||||
it('should format medium durations in seconds', () => {
|
||||
const event: LogEvent = { ...baseEvent, duration_ms: 5000 };
|
||||
const formatted = formatEvent(event);
|
||||
|
||||
expect(formatted).toContain('5.0s');
|
||||
});
|
||||
|
||||
it('should format long durations in minutes and seconds', () => {
|
||||
const event: LogEvent = { ...baseEvent, duration_ms: 125000 }; // 2m 5s
|
||||
const formatted = formatEvent(event);
|
||||
|
||||
expect(formatted).toContain('2m 5s');
|
||||
});
|
||||
|
||||
describe('colorization', () => {
|
||||
it('should not colorize by default', () => {
|
||||
const formatted = formatEvent(baseEvent);
|
||||
|
||||
expect(formatted).not.toContain('\x1b[');
|
||||
});
|
||||
|
||||
it('should colorize when colorize is true', () => {
|
||||
const formatted = formatEvent(baseEvent, { colorize: true });
|
||||
|
||||
// ANSI color codes should be present
|
||||
expect(formatted).toContain('\x1b[');
|
||||
});
|
||||
|
||||
it('should use correct colors for each level', () => {
|
||||
const levels: Array<{ level: LogLevel; color: string }> = [
|
||||
{ level: 'debug', color: '\x1b[36m' }, // cyan
|
||||
{ level: 'info', color: '\x1b[32m' }, // green
|
||||
{ level: 'warn', color: '\x1b[33m' }, // yellow
|
||||
{ level: 'error', color: '\x1b[31m' }, // red
|
||||
];
|
||||
|
||||
for (const { level, color } of levels) {
|
||||
const event: LogEvent = { ...baseEvent, level };
|
||||
const formatted = formatEvent(event, { colorize: true });
|
||||
|
||||
expect(formatted).toContain(color);
|
||||
}
|
||||
});
|
||||
});
|
||||
});
|
||||
348
src/store.test.ts
Normal file
348
src/store.test.ts
Normal file
|
|
@ -0,0 +1,348 @@
|
|||
/**
|
||||
* Tests for FABRIC In-Memory Event Store
|
||||
*/
|
||||
|
||||
import { describe, it, expect, beforeEach, afterEach } from 'vitest';
|
||||
import { InMemoryEventStore, getStore, resetStore } from './store.js';
|
||||
import { LogEvent } from './types.js';
|
||||
|
||||
describe('InMemoryEventStore', () => {
|
||||
let store: InMemoryEventStore;
|
||||
|
||||
beforeEach(() => {
|
||||
store = new InMemoryEventStore();
|
||||
});
|
||||
|
||||
const createEvent = (overrides: Partial<LogEvent> = {}): LogEvent => ({
|
||||
ts: Date.now(),
|
||||
worker: 'w-test',
|
||||
level: 'info',
|
||||
msg: 'Test message',
|
||||
...overrides,
|
||||
});
|
||||
|
||||
describe('add', () => {
|
||||
it('should add an event to the store', () => {
|
||||
const event = createEvent();
|
||||
|
||||
store.add(event);
|
||||
|
||||
expect(store.size).toBe(1);
|
||||
});
|
||||
|
||||
it('should add multiple events', () => {
|
||||
store.add(createEvent({ worker: 'w1' }));
|
||||
store.add(createEvent({ worker: 'w2' }));
|
||||
store.add(createEvent({ worker: 'w3' }));
|
||||
|
||||
expect(store.size).toBe(3);
|
||||
});
|
||||
|
||||
it('should update worker info when adding event', () => {
|
||||
const event = createEvent({ worker: 'w-new' });
|
||||
|
||||
store.add(event);
|
||||
|
||||
const worker = store.getWorker('w-new');
|
||||
expect(worker).toBeDefined();
|
||||
expect(worker?.id).toBe('w-new');
|
||||
});
|
||||
});
|
||||
|
||||
describe('query', () => {
|
||||
beforeEach(() => {
|
||||
// Add some test events
|
||||
store.add(createEvent({ worker: 'w1', level: 'info', bead: 'bd-1', ts: 1000 }));
|
||||
store.add(createEvent({ worker: 'w1', level: 'debug', bead: 'bd-1', ts: 2000 }));
|
||||
store.add(createEvent({ worker: 'w2', level: 'error', bead: 'bd-2', ts: 3000 }));
|
||||
store.add(createEvent({ worker: 'w2', level: 'info', bead: 'bd-2', ts: 4000 }));
|
||||
store.add(createEvent({ worker: 'w3', level: 'warn', bead: 'bd-3', ts: 5000 }));
|
||||
});
|
||||
|
||||
it('should return all events without filter', () => {
|
||||
const events = store.query();
|
||||
|
||||
expect(events).toHaveLength(5);
|
||||
});
|
||||
|
||||
it('should filter by worker', () => {
|
||||
const events = store.query({ worker: 'w1' });
|
||||
|
||||
expect(events).toHaveLength(2);
|
||||
expect(events.every((e) => e.worker === 'w1')).toBe(true);
|
||||
});
|
||||
|
||||
it('should filter by level', () => {
|
||||
const events = store.query({ level: 'error' });
|
||||
|
||||
expect(events).toHaveLength(1);
|
||||
expect(events[0].worker).toBe('w2');
|
||||
});
|
||||
|
||||
it('should filter by bead', () => {
|
||||
const events = store.query({ bead: 'bd-2' });
|
||||
|
||||
expect(events).toHaveLength(2);
|
||||
expect(events.every((e) => e.bead === 'bd-2')).toBe(true);
|
||||
});
|
||||
|
||||
it('should filter by since timestamp', () => {
|
||||
const events = store.query({ since: 3000 });
|
||||
|
||||
expect(events).toHaveLength(3);
|
||||
});
|
||||
|
||||
it('should filter by until timestamp', () => {
|
||||
const events = store.query({ until: 3000 });
|
||||
|
||||
expect(events).toHaveLength(3);
|
||||
});
|
||||
|
||||
it('should combine multiple filters', () => {
|
||||
const events = store.query({ worker: 'w2', level: 'error' });
|
||||
|
||||
expect(events).toHaveLength(1);
|
||||
expect(events[0].ts).toBe(3000);
|
||||
});
|
||||
|
||||
it('should return empty array when no matches', () => {
|
||||
const events = store.query({ worker: 'nonexistent' });
|
||||
|
||||
expect(events).toEqual([]);
|
||||
});
|
||||
|
||||
it('should return a copy of events array', () => {
|
||||
const events1 = store.query();
|
||||
const events2 = store.query();
|
||||
|
||||
expect(events1).not.toBe(events2); // Different array references
|
||||
expect(events1).toEqual(events2); // Same content
|
||||
});
|
||||
});
|
||||
|
||||
describe('getWorker', () => {
|
||||
it('should return undefined for unknown worker', () => {
|
||||
expect(store.getWorker('unknown')).toBeUndefined();
|
||||
});
|
||||
|
||||
it('should return worker info for known worker', () => {
|
||||
store.add(createEvent({ worker: 'w-known' }));
|
||||
|
||||
const worker = store.getWorker('w-known');
|
||||
|
||||
expect(worker).toBeDefined();
|
||||
expect(worker?.id).toBe('w-known');
|
||||
expect(worker?.status).toBe('active');
|
||||
});
|
||||
});
|
||||
|
||||
describe('getWorkers', () => {
|
||||
it('should return empty array when no events', () => {
|
||||
expect(store.getWorkers()).toEqual([]);
|
||||
});
|
||||
|
||||
it('should return all workers', () => {
|
||||
store.add(createEvent({ worker: 'w1' }));
|
||||
store.add(createEvent({ worker: 'w2' }));
|
||||
store.add(createEvent({ worker: 'w3' }));
|
||||
|
||||
const workers = store.getWorkers();
|
||||
|
||||
expect(workers).toHaveLength(3);
|
||||
expect(workers.map((w) => w.id).sort()).toEqual(['w1', 'w2', 'w3']);
|
||||
});
|
||||
});
|
||||
|
||||
describe('worker status tracking', () => {
|
||||
it('should set status to active for new worker', () => {
|
||||
store.add(createEvent({ worker: 'w-new' }));
|
||||
|
||||
const worker = store.getWorker('w-new');
|
||||
expect(worker?.status).toBe('active');
|
||||
});
|
||||
|
||||
it('should set status to error on error event', () => {
|
||||
store.add(createEvent({ worker: 'w-test', level: 'error' }));
|
||||
|
||||
const worker = store.getWorker('w-test');
|
||||
expect(worker?.status).toBe('error');
|
||||
});
|
||||
|
||||
it('should set status to idle on completed message', () => {
|
||||
store.add(createEvent({ worker: 'w-test', msg: 'Task completed successfully' }));
|
||||
|
||||
const worker = store.getWorker('w-test');
|
||||
expect(worker?.status).toBe('idle');
|
||||
});
|
||||
|
||||
it('should set status to idle on complete message', () => {
|
||||
store.add(createEvent({ worker: 'w-test', msg: 'Task complete' }));
|
||||
|
||||
const worker = store.getWorker('w-test');
|
||||
expect(worker?.status).toBe('idle');
|
||||
});
|
||||
|
||||
it('should set status to active on Starting message', () => {
|
||||
// First make it idle
|
||||
store.add(createEvent({ worker: 'w-test', msg: 'Task completed' }));
|
||||
// Then starting
|
||||
store.add(createEvent({ worker: 'w-test', msg: 'Starting new task' }));
|
||||
|
||||
const worker = store.getWorker('w-test');
|
||||
expect(worker?.status).toBe('active');
|
||||
});
|
||||
|
||||
it('should increment beadsCompleted when task completes with bead', () => {
|
||||
store.add(createEvent({ worker: 'w-test', msg: 'Task completed', bead: 'bd-1' }));
|
||||
store.add(createEvent({ worker: 'w-test', msg: 'Task completed', bead: 'bd-2' }));
|
||||
|
||||
const worker = store.getWorker('w-test');
|
||||
expect(worker?.beadsCompleted).toBe(2);
|
||||
});
|
||||
|
||||
it('should track firstSeen timestamp', () => {
|
||||
const earlyTs = 1000;
|
||||
const lateTs = 5000;
|
||||
|
||||
store.add(createEvent({ worker: 'w-test', ts: lateTs }));
|
||||
store.add(createEvent({ worker: 'w-test', ts: earlyTs }));
|
||||
|
||||
const worker = store.getWorker('w-test');
|
||||
expect(worker?.firstSeen).toBe(lateTs); // First event sets firstSeen
|
||||
});
|
||||
|
||||
it('should track lastActivity timestamp', () => {
|
||||
const ts1 = 1000;
|
||||
const ts2 = 5000;
|
||||
|
||||
store.add(createEvent({ worker: 'w-test', ts: ts1 }));
|
||||
store.add(createEvent({ worker: 'w-test', ts: ts2 }));
|
||||
|
||||
const worker = store.getWorker('w-test');
|
||||
expect(worker?.lastActivity).toBe(ts2);
|
||||
});
|
||||
|
||||
it('should track lastEvent', () => {
|
||||
const event1 = createEvent({ worker: 'w-test', msg: 'First' });
|
||||
const event2 = createEvent({ worker: 'w-test', msg: 'Second' });
|
||||
|
||||
store.add(event1);
|
||||
store.add(event2);
|
||||
|
||||
const worker = store.getWorker('w-test');
|
||||
expect(worker?.lastEvent?.msg).toBe('Second');
|
||||
});
|
||||
});
|
||||
|
||||
describe('clear', () => {
|
||||
it('should clear all events', () => {
|
||||
store.add(createEvent());
|
||||
store.add(createEvent());
|
||||
|
||||
store.clear();
|
||||
|
||||
expect(store.size).toBe(0);
|
||||
});
|
||||
|
||||
it('should clear all workers', () => {
|
||||
store.add(createEvent({ worker: 'w1' }));
|
||||
store.add(createEvent({ worker: 'w2' }));
|
||||
|
||||
store.clear();
|
||||
|
||||
expect(store.getWorkers()).toEqual([]);
|
||||
});
|
||||
});
|
||||
|
||||
describe('maxEvents limit', () => {
|
||||
it('should trim old events when over limit', () => {
|
||||
const smallStore = new InMemoryEventStore(3);
|
||||
|
||||
smallStore.add(createEvent({ ts: 1 }));
|
||||
smallStore.add(createEvent({ ts: 2 }));
|
||||
smallStore.add(createEvent({ ts: 3 }));
|
||||
smallStore.add(createEvent({ ts: 4 }));
|
||||
|
||||
expect(smallStore.size).toBe(3);
|
||||
});
|
||||
|
||||
it('should keep most recent events', () => {
|
||||
const smallStore = new InMemoryEventStore(2);
|
||||
|
||||
smallStore.add(createEvent({ ts: 1, msg: 'old' }));
|
||||
smallStore.add(createEvent({ ts: 2, msg: 'mid' }));
|
||||
smallStore.add(createEvent({ ts: 3, msg: 'new' }));
|
||||
|
||||
const events = smallStore.query();
|
||||
expect(events).toHaveLength(2);
|
||||
expect(events[0].msg).toBe('mid');
|
||||
expect(events[1].msg).toBe('new');
|
||||
});
|
||||
|
||||
it('should use default maxEvents of 10000', () => {
|
||||
const defaultStore = new InMemoryEventStore();
|
||||
|
||||
// Add 10001 events
|
||||
for (let i = 0; i < 10001; i++) {
|
||||
defaultStore.add(createEvent({ ts: i }));
|
||||
}
|
||||
|
||||
expect(defaultStore.size).toBe(10000);
|
||||
});
|
||||
});
|
||||
|
||||
describe('size property', () => {
|
||||
it('should return 0 for empty store', () => {
|
||||
expect(store.size).toBe(0);
|
||||
});
|
||||
|
||||
it('should return correct count after adds', () => {
|
||||
store.add(createEvent());
|
||||
store.add(createEvent());
|
||||
|
||||
expect(store.size).toBe(2);
|
||||
});
|
||||
});
|
||||
});
|
||||
|
||||
describe('getStore and resetStore', () => {
|
||||
beforeEach(() => {
|
||||
resetStore();
|
||||
});
|
||||
|
||||
afterEach(() => {
|
||||
resetStore();
|
||||
});
|
||||
|
||||
it('should return the same store instance', () => {
|
||||
const store1 = getStore();
|
||||
const store2 = getStore();
|
||||
|
||||
expect(store1).toBe(store2);
|
||||
});
|
||||
|
||||
it('should create new store after reset', () => {
|
||||
const store1 = getStore();
|
||||
resetStore();
|
||||
const store2 = getStore();
|
||||
|
||||
expect(store1).not.toBe(store2);
|
||||
});
|
||||
|
||||
it('should clear store on reset', () => {
|
||||
const store = getStore();
|
||||
store.add({
|
||||
ts: Date.now(),
|
||||
worker: 'w-test',
|
||||
level: 'info',
|
||||
msg: 'Test',
|
||||
});
|
||||
|
||||
expect(store.size).toBe(1);
|
||||
|
||||
resetStore();
|
||||
|
||||
const newStore = getStore();
|
||||
expect(newStore.size).toBe(0);
|
||||
});
|
||||
});
|
||||
143
src/store.ts
143
src/store.ts
|
|
@ -2,13 +2,21 @@
|
|||
* FABRIC In-Memory Event Store
|
||||
*
|
||||
* Stores and indexes LogEvents for efficient querying.
|
||||
* Includes collision detection for concurrent file modifications.
|
||||
*/
|
||||
|
||||
import { LogEvent, WorkerInfo, WorkerStatus, EventFilter, EventStore } from './types.js';
|
||||
import { LogEvent, WorkerInfo, WorkerStatus, EventFilter, EventStore, FileCollision } from './types.js';
|
||||
|
||||
/** Time window (in ms) to consider events as concurrent */
|
||||
const COLLISION_WINDOW_MS = 5000;
|
||||
|
||||
/** File operations that indicate modification */
|
||||
const FILE_MODIFICATION_TOOLS = ['Edit', 'Write', 'NotebookEdit'];
|
||||
|
||||
export class InMemoryEventStore implements EventStore {
|
||||
private events: LogEvent[] = [];
|
||||
private workers: Map<string, WorkerInfo> = new Map();
|
||||
private collisions: Map<string, FileCollision> = new Map();
|
||||
private maxEvents: number;
|
||||
|
||||
constructor(maxEvents: number = 10000) {
|
||||
|
|
@ -21,6 +29,7 @@ export class InMemoryEventStore implements EventStore {
|
|||
add(event: LogEvent): void {
|
||||
this.events.push(event);
|
||||
this.updateWorkerInfo(event);
|
||||
this.detectCollision(event);
|
||||
|
||||
// Trim if over limit
|
||||
if (this.events.length > this.maxEvents) {
|
||||
|
|
@ -61,12 +70,29 @@ export class InMemoryEventStore implements EventStore {
|
|||
return Array.from(this.workers.values());
|
||||
}
|
||||
|
||||
/**
|
||||
* Get all active collisions
|
||||
*/
|
||||
getCollisions(): FileCollision[] {
|
||||
// Clean up stale collisions first
|
||||
this.cleanupStaleCollisions();
|
||||
return Array.from(this.collisions.values()).filter(c => c.isActive);
|
||||
}
|
||||
|
||||
/**
|
||||
* Get collisions for a specific worker
|
||||
*/
|
||||
getWorkerCollisions(workerId: string): FileCollision[] {
|
||||
return this.getCollisions().filter(c => c.workers.includes(workerId));
|
||||
}
|
||||
|
||||
/**
|
||||
* Clear all events
|
||||
*/
|
||||
clear(): void {
|
||||
this.events = [];
|
||||
this.workers.clear();
|
||||
this.collisions.clear();
|
||||
}
|
||||
|
||||
/**
|
||||
|
|
@ -89,6 +115,8 @@ export class InMemoryEventStore implements EventStore {
|
|||
beadsCompleted: 0,
|
||||
firstSeen: event.ts,
|
||||
lastActivity: event.ts,
|
||||
activeFiles: [],
|
||||
hasCollision: false,
|
||||
};
|
||||
this.workers.set(event.worker, worker);
|
||||
}
|
||||
|
|
@ -96,6 +124,13 @@ export class InMemoryEventStore implements EventStore {
|
|||
// Update last activity
|
||||
worker.lastActivity = event.ts;
|
||||
|
||||
// Track active files
|
||||
if (event.path && this.isFileModification(event)) {
|
||||
if (!worker.activeFiles.includes(event.path)) {
|
||||
worker.activeFiles.push(event.path);
|
||||
}
|
||||
}
|
||||
|
||||
// Update status based on event
|
||||
if (event.level === 'error') {
|
||||
worker.status = 'error';
|
||||
|
|
@ -104,12 +139,118 @@ export class InMemoryEventStore implements EventStore {
|
|||
if (event.bead) {
|
||||
worker.beadsCompleted++;
|
||||
}
|
||||
// Clear active files on completion
|
||||
worker.activeFiles = [];
|
||||
} else if (event.msg.includes('Starting') || event.msg.includes('starting')) {
|
||||
worker.status = 'active';
|
||||
}
|
||||
|
||||
// Update last event
|
||||
worker.lastEvent = event;
|
||||
|
||||
// Update collision status
|
||||
worker.hasCollision = this.getWorkerCollisions(worker.id).length > 0;
|
||||
}
|
||||
|
||||
/**
|
||||
* Check if event represents a file modification
|
||||
*/
|
||||
private isFileModification(event: LogEvent): boolean {
|
||||
if (!event.tool) return false;
|
||||
return FILE_MODIFICATION_TOOLS.includes(event.tool);
|
||||
}
|
||||
|
||||
/**
|
||||
* Detect collision when a file modification event occurs
|
||||
*/
|
||||
private detectCollision(event: LogEvent): void {
|
||||
if (!event.path || !this.isFileModification(event)) {
|
||||
return;
|
||||
}
|
||||
|
||||
const path = event.path;
|
||||
const workerId = event.worker;
|
||||
|
||||
// Look for other workers modifying the same file within the time window
|
||||
const recentEvents = this.events.filter(e => {
|
||||
if (e.path !== path) return false;
|
||||
if (e.worker === workerId) return false;
|
||||
if (!this.isFileModification(e)) return false;
|
||||
if (Math.abs(e.ts - event.ts) > COLLISION_WINDOW_MS) return false;
|
||||
return true;
|
||||
});
|
||||
|
||||
if (recentEvents.length > 0) {
|
||||
// Collision detected!
|
||||
const collisionKey = path;
|
||||
const workers = new Set<string>([workerId]);
|
||||
const collisionEvents: LogEvent[] = [event];
|
||||
|
||||
for (const e of recentEvents) {
|
||||
workers.add(e.worker);
|
||||
collisionEvents.push(e);
|
||||
}
|
||||
|
||||
// Update or create collision record
|
||||
const existing = this.collisions.get(collisionKey);
|
||||
if (existing) {
|
||||
// Add new worker if not already tracked
|
||||
for (const w of workers) {
|
||||
if (!existing.workers.includes(w)) {
|
||||
existing.workers.push(w);
|
||||
}
|
||||
}
|
||||
existing.events.push(event);
|
||||
existing.detectedAt = event.ts;
|
||||
} else {
|
||||
const collision: FileCollision = {
|
||||
path,
|
||||
workers: Array.from(workers),
|
||||
detectedAt: event.ts,
|
||||
events: collisionEvents,
|
||||
isActive: true,
|
||||
};
|
||||
this.collisions.set(collisionKey, collision);
|
||||
}
|
||||
|
||||
// Update collision status for all involved workers
|
||||
for (const w of workers) {
|
||||
const workerInfo = this.workers.get(w);
|
||||
if (workerInfo) {
|
||||
workerInfo.hasCollision = true;
|
||||
}
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
/**
|
||||
* Clean up collisions that are no longer active
|
||||
*/
|
||||
private cleanupStaleCollisions(): void {
|
||||
const now = Date.now();
|
||||
const staleThreshold = 30000; // 30 seconds
|
||||
|
||||
for (const [key, collision] of this.collisions) {
|
||||
// Check if all involved workers are still active on this file
|
||||
const isStale = collision.workers.every(workerId => {
|
||||
const worker = this.workers.get(workerId);
|
||||
if (!worker) return true;
|
||||
if (!worker.activeFiles.includes(collision.path)) return true;
|
||||
if (now - collision.detectedAt > staleThreshold) return true;
|
||||
return false;
|
||||
});
|
||||
|
||||
if (isStale) {
|
||||
collision.isActive = false;
|
||||
// Update worker collision status
|
||||
for (const workerId of collision.workers) {
|
||||
const worker = this.workers.get(workerId);
|
||||
if (worker) {
|
||||
worker.hasCollision = this.getWorkerCollisions(workerId).some(c => c.isActive);
|
||||
}
|
||||
}
|
||||
}
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
|
|
|
|||
364
src/tailer.test.ts
Normal file
364
src/tailer.test.ts
Normal file
|
|
@ -0,0 +1,364 @@
|
|||
/**
|
||||
* Tests for FABRIC Log Tailer
|
||||
*/
|
||||
|
||||
import { describe, it, expect, beforeEach, afterEach } from 'vitest';
|
||||
import * as fs from 'fs';
|
||||
import * as path from 'path';
|
||||
import * as os from 'os';
|
||||
import { LogTailer } from './tailer.js';
|
||||
|
||||
describe('LogTailer', () => {
|
||||
let tempDir: string;
|
||||
let logFile: string;
|
||||
|
||||
beforeEach(() => {
|
||||
// Create temp directory and file
|
||||
tempDir = fs.mkdtempSync(path.join(os.tmpdir(), 'fabric-test-'));
|
||||
logFile = path.join(tempDir, 'test.log');
|
||||
});
|
||||
|
||||
afterEach(() => {
|
||||
// Cleanup temp directory
|
||||
fs.rmSync(tempDir, { recursive: true, force: true });
|
||||
});
|
||||
|
||||
describe('constructor', () => {
|
||||
it('should expand ~ to home directory', () => {
|
||||
const tailer = new LogTailer({ path: '~/test.log' });
|
||||
expect(tailer).toBeDefined();
|
||||
});
|
||||
|
||||
it('should accept absolute paths', () => {
|
||||
const tailer = new LogTailer({ path: '/var/log/test.log' });
|
||||
expect(tailer).toBeDefined();
|
||||
});
|
||||
|
||||
it('should default parseJson to true', () => {
|
||||
const tailer = new LogTailer({ path: logFile });
|
||||
expect(tailer).toBeDefined();
|
||||
});
|
||||
|
||||
it('should default follow to true', () => {
|
||||
const tailer = new LogTailer({ path: logFile });
|
||||
expect(tailer).toBeDefined();
|
||||
});
|
||||
|
||||
it('should default lines to 0', () => {
|
||||
const tailer = new LogTailer({ path: logFile });
|
||||
expect(tailer).toBeDefined();
|
||||
});
|
||||
});
|
||||
|
||||
describe('start', () => {
|
||||
it('should emit error when file does not exist', async () => {
|
||||
const tailer = new LogTailer({ path: '/nonexistent/path/test.log' });
|
||||
|
||||
const errorPromise = new Promise<Error>((resolve) => {
|
||||
tailer.on('error', resolve);
|
||||
});
|
||||
|
||||
tailer.start();
|
||||
|
||||
const err = await errorPromise;
|
||||
expect(err.message).toContain('Log file not found');
|
||||
});
|
||||
|
||||
it('should start successfully when file exists', () => {
|
||||
fs.writeFileSync(logFile, '');
|
||||
const tailer = new LogTailer({ path: logFile, follow: false });
|
||||
|
||||
// Should not throw
|
||||
tailer.start();
|
||||
// If we get here without error, the test passes
|
||||
expect(true).toBe(true);
|
||||
});
|
||||
});
|
||||
|
||||
describe('event parsing', () => {
|
||||
it('should emit parsed events for valid JSON lines', async () => {
|
||||
const event = {
|
||||
ts: Date.now(),
|
||||
worker: 'w-test',
|
||||
level: 'info' as const,
|
||||
msg: 'Test message',
|
||||
};
|
||||
fs.writeFileSync(logFile, JSON.stringify(event) + '\n');
|
||||
|
||||
const tailer = new LogTailer({
|
||||
path: logFile,
|
||||
follow: false,
|
||||
lines: 10,
|
||||
});
|
||||
|
||||
const eventPromise = new Promise<any>((resolve) => {
|
||||
tailer.on('event', resolve);
|
||||
});
|
||||
|
||||
tailer.start();
|
||||
|
||||
const parsed = await eventPromise;
|
||||
expect(parsed.ts).toBe(event.ts);
|
||||
expect(parsed.worker).toBe(event.worker);
|
||||
expect(parsed.level).toBe(event.level);
|
||||
expect(parsed.msg).toBe(event.msg);
|
||||
});
|
||||
|
||||
it('should emit raw lines regardless of JSON validity', async () => {
|
||||
fs.writeFileSync(logFile, 'not valid json\n');
|
||||
|
||||
const tailer = new LogTailer({
|
||||
path: logFile,
|
||||
follow: false,
|
||||
lines: 10,
|
||||
parseJson: false,
|
||||
});
|
||||
|
||||
const linePromise = new Promise<string>((resolve) => {
|
||||
tailer.on('line', resolve);
|
||||
});
|
||||
|
||||
tailer.start();
|
||||
|
||||
const line = await linePromise;
|
||||
expect(line).toBe('not valid json');
|
||||
});
|
||||
|
||||
it('should not emit event for invalid JSON when parseJson is true', async () => {
|
||||
fs.writeFileSync(logFile, 'not valid json\n');
|
||||
|
||||
const tailer = new LogTailer({
|
||||
path: logFile,
|
||||
follow: false,
|
||||
lines: 10,
|
||||
});
|
||||
|
||||
let eventEmitted = false;
|
||||
tailer.on('event', () => {
|
||||
eventEmitted = true;
|
||||
});
|
||||
|
||||
tailer.start();
|
||||
|
||||
// Wait a bit for processing
|
||||
await new Promise((resolve) => setTimeout(resolve, 50));
|
||||
|
||||
expect(eventEmitted).toBe(false);
|
||||
});
|
||||
|
||||
it('should handle empty lines gracefully', async () => {
|
||||
fs.writeFileSync(logFile, '\n\n\n');
|
||||
|
||||
const tailer = new LogTailer({
|
||||
path: logFile,
|
||||
follow: false,
|
||||
lines: 10,
|
||||
});
|
||||
|
||||
let eventCount = 0;
|
||||
tailer.on('event', () => {
|
||||
eventCount++;
|
||||
});
|
||||
|
||||
tailer.start();
|
||||
|
||||
// Wait a bit for processing
|
||||
await new Promise((resolve) => setTimeout(resolve, 50));
|
||||
|
||||
expect(eventCount).toBe(0);
|
||||
});
|
||||
});
|
||||
|
||||
describe('reading existing lines', () => {
|
||||
it('should read last N lines on start when lines option is set', async () => {
|
||||
const events = [
|
||||
{ ts: 1, worker: 'w1', level: 'info' as const, msg: 'first' },
|
||||
{ ts: 2, worker: 'w2', level: 'info' as const, msg: 'second' },
|
||||
{ ts: 3, worker: 'w3', level: 'info' as const, msg: 'third' },
|
||||
];
|
||||
fs.writeFileSync(logFile, events.map((e) => JSON.stringify(e)).join('\n') + '\n');
|
||||
|
||||
const tailer = new LogTailer({
|
||||
path: logFile,
|
||||
follow: false,
|
||||
lines: 2, // Only read last 2 lines
|
||||
});
|
||||
|
||||
const receivedEvents: any[] = [];
|
||||
const allReceived = new Promise<void>((resolve) => {
|
||||
tailer.on('event', (event) => {
|
||||
receivedEvents.push(event);
|
||||
if (receivedEvents.length === 2) {
|
||||
resolve();
|
||||
}
|
||||
});
|
||||
});
|
||||
|
||||
tailer.start();
|
||||
|
||||
await allReceived;
|
||||
|
||||
// Should have received 2 events (second and third)
|
||||
expect(receivedEvents.length).toBe(2);
|
||||
expect(receivedEvents[0].msg).toBe('second');
|
||||
expect(receivedEvents[1].msg).toBe('third');
|
||||
});
|
||||
|
||||
it('should read all lines when lines is greater than file', async () => {
|
||||
const events = [
|
||||
{ ts: 1, worker: 'w1', level: 'info' as const, msg: 'first' },
|
||||
{ ts: 2, worker: 'w2', level: 'info' as const, msg: 'second' },
|
||||
];
|
||||
fs.writeFileSync(logFile, events.map((e) => JSON.stringify(e)).join('\n') + '\n');
|
||||
|
||||
const tailer = new LogTailer({
|
||||
path: logFile,
|
||||
follow: false,
|
||||
lines: 100, // More than file has
|
||||
});
|
||||
|
||||
const receivedEvents: any[] = [];
|
||||
const allReceived = new Promise<void>((resolve) => {
|
||||
tailer.on('event', (event) => {
|
||||
receivedEvents.push(event);
|
||||
if (receivedEvents.length === 2) {
|
||||
resolve();
|
||||
}
|
||||
});
|
||||
});
|
||||
|
||||
tailer.start();
|
||||
|
||||
await allReceived;
|
||||
expect(receivedEvents.length).toBe(2);
|
||||
});
|
||||
});
|
||||
|
||||
describe('stop', () => {
|
||||
it('should stop watching file', async () => {
|
||||
fs.writeFileSync(logFile, '');
|
||||
const tailer = new LogTailer({ path: logFile, follow: true });
|
||||
|
||||
const endPromise = new Promise<void>((resolve) => {
|
||||
tailer.on('end', resolve);
|
||||
});
|
||||
|
||||
tailer.start();
|
||||
// Give it time to start watching
|
||||
await new Promise((resolve) => setTimeout(resolve, 50));
|
||||
tailer.stop();
|
||||
|
||||
await endPromise;
|
||||
expect(tailer.isActive).toBe(false);
|
||||
});
|
||||
|
||||
it('should emit end event when stopped', async () => {
|
||||
fs.writeFileSync(logFile, '');
|
||||
const tailer = new LogTailer({ path: logFile, follow: true });
|
||||
|
||||
const endPromise = new Promise<void>((resolve) => {
|
||||
tailer.on('end', resolve);
|
||||
});
|
||||
|
||||
tailer.start();
|
||||
await new Promise((resolve) => setTimeout(resolve, 50));
|
||||
tailer.stop();
|
||||
|
||||
await endPromise;
|
||||
});
|
||||
});
|
||||
|
||||
describe('follow mode', () => {
|
||||
it('should detect new content appended to file', async () => {
|
||||
fs.writeFileSync(logFile, '');
|
||||
const tailer = new LogTailer({ path: logFile, follow: true });
|
||||
|
||||
const event = {
|
||||
ts: Date.now(),
|
||||
worker: 'w-test',
|
||||
level: 'info' as const,
|
||||
msg: 'new event',
|
||||
};
|
||||
|
||||
const eventPromise = new Promise<any>((resolve) => {
|
||||
tailer.on('event', resolve);
|
||||
});
|
||||
|
||||
tailer.start();
|
||||
|
||||
// Append to file after a short delay
|
||||
await new Promise((resolve) => setTimeout(resolve, 100));
|
||||
fs.appendFileSync(logFile, JSON.stringify(event) + '\n');
|
||||
|
||||
const parsed = await eventPromise;
|
||||
expect(parsed.msg).toBe('new event');
|
||||
tailer.stop();
|
||||
});
|
||||
|
||||
it('should handle multiple events appended', async () => {
|
||||
fs.writeFileSync(logFile, '');
|
||||
const tailer = new LogTailer({ path: logFile, follow: true });
|
||||
|
||||
const events = [
|
||||
{ ts: 1, worker: 'w1', level: 'info' as const, msg: 'first' },
|
||||
{ ts: 2, worker: 'w2', level: 'info' as const, msg: 'second' },
|
||||
];
|
||||
|
||||
const receivedEvents: any[] = [];
|
||||
const allEventsPromise = new Promise<void>((resolve) => {
|
||||
tailer.on('event', (event) => {
|
||||
receivedEvents.push(event);
|
||||
if (receivedEvents.length === 2) {
|
||||
resolve();
|
||||
}
|
||||
});
|
||||
});
|
||||
|
||||
tailer.start();
|
||||
|
||||
// Append events after a short delay
|
||||
await new Promise((resolve) => setTimeout(resolve, 100));
|
||||
fs.appendFileSync(logFile, events.map((e) => JSON.stringify(e)).join('\n') + '\n');
|
||||
|
||||
await allEventsPromise;
|
||||
expect(receivedEvents[0].msg).toBe('first');
|
||||
expect(receivedEvents[1].msg).toBe('second');
|
||||
tailer.stop();
|
||||
});
|
||||
});
|
||||
|
||||
describe('isActive', () => {
|
||||
it('should be false before start', () => {
|
||||
fs.writeFileSync(logFile, '');
|
||||
const tailer = new LogTailer({ path: logFile, follow: true });
|
||||
expect(tailer.isActive).toBe(false);
|
||||
});
|
||||
|
||||
it('should be true after start in follow mode', async () => {
|
||||
fs.writeFileSync(logFile, '');
|
||||
const tailer = new LogTailer({ path: logFile, follow: true });
|
||||
|
||||
tailer.start();
|
||||
// Give it a moment to set up the watcher
|
||||
await new Promise((resolve) => setTimeout(resolve, 50));
|
||||
expect(tailer.isActive).toBe(true);
|
||||
tailer.stop();
|
||||
});
|
||||
|
||||
it('should be false after stop', async () => {
|
||||
fs.writeFileSync(logFile, '');
|
||||
const tailer = new LogTailer({ path: logFile, follow: true });
|
||||
|
||||
const endPromise = new Promise<void>((resolve) => {
|
||||
tailer.on('end', resolve);
|
||||
});
|
||||
|
||||
tailer.start();
|
||||
await new Promise((resolve) => setTimeout(resolve, 50));
|
||||
tailer.stop();
|
||||
|
||||
await endPromise;
|
||||
expect(tailer.isActive).toBe(false);
|
||||
});
|
||||
});
|
||||
});
|
||||
307
src/tui/app.ts
Normal file
307
src/tui/app.ts
Normal file
|
|
@ -0,0 +1,307 @@
|
|||
/**
|
||||
* FABRIC TUI Application
|
||||
*
|
||||
* Main TUI application class using blessed for terminal rendering.
|
||||
*/
|
||||
|
||||
import * as blessed from 'blessed';
|
||||
import { LogEvent, WorkerInfo } from '../types.js';
|
||||
import { InMemoryEventStore } from '../store.js';
|
||||
import { colors } from './utils/colors.js';
|
||||
import { WorkerGrid } from './components/WorkerGrid.js';
|
||||
import { ActivityStream } from './components/ActivityStream.js';
|
||||
import { WorkerDetail } from './components/WorkerDetail.js';
|
||||
import { CommandPalette } from './components/CommandPalette.js';
|
||||
|
||||
export interface TuiOptions {
|
||||
/** Log file path to tail */
|
||||
logPath?: string;
|
||||
|
||||
/** Maximum events to display */
|
||||
maxEvents?: number;
|
||||
|
||||
/** Refresh interval in ms */
|
||||
refreshInterval?: number;
|
||||
}
|
||||
|
||||
export class FabricTuiApp {
|
||||
private screen: blessed.Widgets.Screen;
|
||||
private store: InMemoryEventStore;
|
||||
private options: Required<TuiOptions>;
|
||||
private isRunning = false;
|
||||
|
||||
// UI Components
|
||||
private headerBox!: blessed.Widgets.BoxElement;
|
||||
private workerGrid!: WorkerGrid;
|
||||
private activityStream!: ActivityStream;
|
||||
private workerDetail!: WorkerDetail;
|
||||
private commandPalette!: CommandPalette;
|
||||
private footerBox!: blessed.Widgets.BoxElement;
|
||||
private helpOverlay?: blessed.Widgets.BoxElement;
|
||||
|
||||
constructor(store: InMemoryEventStore, options: TuiOptions = {}) {
|
||||
this.store = store;
|
||||
this.options = {
|
||||
logPath: options.logPath || '',
|
||||
maxEvents: options.maxEvents || 1000,
|
||||
refreshInterval: options.refreshInterval || 100,
|
||||
};
|
||||
|
||||
this.screen = this.createScreen();
|
||||
this.createLayout();
|
||||
this.bindKeys();
|
||||
}
|
||||
|
||||
/**
|
||||
* Create the blessed screen
|
||||
*/
|
||||
private createScreen(): blessed.Widgets.Screen {
|
||||
return blessed.screen({
|
||||
smartCSR: true,
|
||||
title: 'FABRIC - Flow Analysis & Bead Reporting Interface Console',
|
||||
fullUnicode: true,
|
||||
});
|
||||
}
|
||||
|
||||
/**
|
||||
* Create the UI layout
|
||||
*/
|
||||
private createLayout(): void {
|
||||
// Header
|
||||
this.headerBox = blessed.box({
|
||||
parent: this.screen,
|
||||
top: 0,
|
||||
left: 0,
|
||||
right: 0,
|
||||
height: 1,
|
||||
content: ' FABRIC - Worker Activity Monitor',
|
||||
style: {
|
||||
fg: colors.header,
|
||||
bold: true,
|
||||
},
|
||||
});
|
||||
|
||||
// Worker grid panel (left side)
|
||||
this.workerGrid = new WorkerGrid({
|
||||
parent: this.screen,
|
||||
top: 1,
|
||||
left: 0,
|
||||
width: '40%',
|
||||
bottom: 1,
|
||||
});
|
||||
|
||||
// Activity stream (right side)
|
||||
this.activityStream = new ActivityStream({
|
||||
parent: this.screen,
|
||||
top: 1,
|
||||
right: 0,
|
||||
width: '60%',
|
||||
bottom: 1,
|
||||
maxLines: this.options.maxEvents,
|
||||
});
|
||||
|
||||
// Worker detail panel (hidden by default)
|
||||
this.workerDetail = new WorkerDetail({
|
||||
parent: this.screen,
|
||||
top: 'center',
|
||||
left: 'center',
|
||||
width: '50%',
|
||||
height: '60%',
|
||||
});
|
||||
|
||||
// Command palette (hidden by default, Ctrl+K)
|
||||
this.commandPalette = new CommandPalette({
|
||||
parent: this.screen,
|
||||
onSubmit: (cmd) => this.handleCommand(cmd),
|
||||
});
|
||||
|
||||
// Footer with key hints
|
||||
this.footerBox = blessed.box({
|
||||
parent: this.screen,
|
||||
bottom: 0,
|
||||
left: 0,
|
||||
right: 0,
|
||||
height: 1,
|
||||
content: ' [Tab] Switch [j/k] Scroll [/] Search [?] Help [q] Quit',
|
||||
style: {
|
||||
fg: colors.muted,
|
||||
},
|
||||
});
|
||||
}
|
||||
|
||||
/**
|
||||
* Bind keyboard shortcuts
|
||||
*/
|
||||
private bindKeys(): void {
|
||||
// Quit
|
||||
this.screen.key(['q', 'C-c'], () => {
|
||||
this.stop();
|
||||
});
|
||||
|
||||
// Help toggle
|
||||
this.screen.key(['?'], () => {
|
||||
this.toggleHelp();
|
||||
});
|
||||
|
||||
// Tab switching
|
||||
this.screen.key(['tab'], () => {
|
||||
this.screen.focusNext();
|
||||
});
|
||||
|
||||
this.screen.key(['S-tab'], () => {
|
||||
this.screen.focusPrevious();
|
||||
});
|
||||
|
||||
// Refresh
|
||||
this.screen.key(['r'], () => {
|
||||
this.render();
|
||||
});
|
||||
|
||||
// Command palette
|
||||
this.screen.key(['C-k'], () => {
|
||||
this.commandPalette.toggle();
|
||||
});
|
||||
|
||||
// Toggle worker detail
|
||||
this.screen.key(['enter'], () => {
|
||||
const selected = this.workerGrid.getSelected();
|
||||
if (selected) {
|
||||
this.showWorkerDetail(selected);
|
||||
}
|
||||
});
|
||||
}
|
||||
|
||||
/**
|
||||
* Handle command from palette
|
||||
*/
|
||||
private handleCommand(cmd: string): void {
|
||||
if (cmd === 'clear') {
|
||||
this.activityStream.clearFilter();
|
||||
} else if (cmd === 'pause') {
|
||||
this.activityStream.togglePause();
|
||||
} else if (cmd === 'refresh') {
|
||||
this.render();
|
||||
} else if (cmd === 'help') {
|
||||
this.toggleHelp();
|
||||
} else if (cmd === 'quit') {
|
||||
this.stop();
|
||||
} else if (cmd.startsWith('filter:worker:')) {
|
||||
const workerId = cmd.replace('filter:worker:', '');
|
||||
this.activityStream.setFilter({ workerId });
|
||||
} else if (cmd.startsWith('filter:level:')) {
|
||||
const level = cmd.replace('filter:level:', '');
|
||||
this.activityStream.setFilter({ level });
|
||||
}
|
||||
}
|
||||
|
||||
/**
|
||||
* Show worker detail panel
|
||||
*/
|
||||
private showWorkerDetail(worker: WorkerInfo): void {
|
||||
const events = this.store.query({ worker: worker.id });
|
||||
this.workerDetail.setWorker(worker);
|
||||
this.workerDetail.setRecentEvents(events);
|
||||
this.workerDetail.show();
|
||||
}
|
||||
|
||||
/**
|
||||
* Toggle help overlay
|
||||
*/
|
||||
private toggleHelp(): void {
|
||||
if (this.helpOverlay) {
|
||||
this.helpOverlay.destroy();
|
||||
this.helpOverlay = undefined;
|
||||
} else {
|
||||
this.helpOverlay = blessed.box({
|
||||
parent: this.screen,
|
||||
top: 'center',
|
||||
left: 'center',
|
||||
width: '50%',
|
||||
height: '50%',
|
||||
label: ' Help ',
|
||||
content: `
|
||||
Keyboard Shortcuts
|
||||
==================
|
||||
|
||||
Navigation:
|
||||
j/k - Scroll down/up
|
||||
g/G - Scroll to top/bottom
|
||||
Tab - Next panel
|
||||
Shift+Tab - Previous panel
|
||||
|
||||
Actions:
|
||||
/ - Search
|
||||
f - Filter
|
||||
r - Refresh
|
||||
p - Pause scroll
|
||||
|
||||
General:
|
||||
? - Toggle this help
|
||||
q - Quit
|
||||
Ctrl+C - Quit
|
||||
`,
|
||||
border: { type: 'line' },
|
||||
style: {
|
||||
border: { fg: colors.border },
|
||||
label: { fg: colors.header },
|
||||
},
|
||||
keys: true,
|
||||
vi: true,
|
||||
});
|
||||
this.helpOverlay.focus();
|
||||
}
|
||||
this.screen.render();
|
||||
}
|
||||
|
||||
/**
|
||||
* Render workers panel
|
||||
*/
|
||||
private renderWorkers(): void {
|
||||
const workers = this.store.getWorkers();
|
||||
this.workerGrid.updateWorkers(workers);
|
||||
}
|
||||
|
||||
/**
|
||||
* Add event to activity stream
|
||||
*/
|
||||
addEvent(event: LogEvent): void {
|
||||
this.activityStream.addEvent(event);
|
||||
this.renderWorkers();
|
||||
this.screen.render();
|
||||
}
|
||||
|
||||
/**
|
||||
* Render the entire UI
|
||||
*/
|
||||
render(): void {
|
||||
this.renderWorkers();
|
||||
this.screen.render();
|
||||
}
|
||||
|
||||
/**
|
||||
* Start the TUI event loop
|
||||
*/
|
||||
start(): void {
|
||||
if (this.isRunning) return;
|
||||
|
||||
this.isRunning = true;
|
||||
this.render();
|
||||
this.screen.render();
|
||||
}
|
||||
|
||||
/**
|
||||
* Stop the TUI and cleanup
|
||||
*/
|
||||
stop(): void {
|
||||
this.isRunning = false;
|
||||
this.screen.destroy();
|
||||
process.exit(0);
|
||||
}
|
||||
}
|
||||
|
||||
/**
|
||||
* Create and start a TUI app
|
||||
*/
|
||||
export function createTuiApp(store: InMemoryEventStore, options?: TuiOptions): FabricTuiApp {
|
||||
return new FabricTuiApp(store, options);
|
||||
}
|
||||
234
src/tui/components/ActivityStream.ts
Normal file
234
src/tui/components/ActivityStream.ts
Normal file
|
|
@ -0,0 +1,234 @@
|
|||
/**
|
||||
* ActivityStream Component
|
||||
*
|
||||
* Displays scrolling log output with filtering capabilities.
|
||||
*/
|
||||
|
||||
import * as blessed from 'blessed';
|
||||
import { LogEvent } from '../../types.js';
|
||||
import { colors, getLevelColor } from '../utils/colors.js';
|
||||
|
||||
export interface ActivityStreamOptions {
|
||||
/** Parent screen */
|
||||
parent: blessed.Widgets.Screen;
|
||||
|
||||
/** Position from top */
|
||||
top: number | string;
|
||||
|
||||
/** Position from right */
|
||||
right: number | string;
|
||||
|
||||
/** Width of the panel */
|
||||
width: number | string;
|
||||
|
||||
/** Position from bottom */
|
||||
bottom: number | string;
|
||||
|
||||
/** Maximum lines to keep in buffer */
|
||||
maxLines?: number;
|
||||
}
|
||||
|
||||
export interface ActivityFilter {
|
||||
/** Filter by worker ID */
|
||||
workerId?: string;
|
||||
|
||||
/** Filter by log level */
|
||||
level?: string;
|
||||
|
||||
/** Filter by search term */
|
||||
search?: string;
|
||||
}
|
||||
|
||||
/**
|
||||
* ActivityStream displays real-time log events
|
||||
*/
|
||||
export class ActivityStream {
|
||||
private log: blessed.Widgets.Log;
|
||||
private events: LogEvent[] = [];
|
||||
private filter: ActivityFilter = {};
|
||||
private maxLines: number;
|
||||
private isPaused = false;
|
||||
|
||||
constructor(options: ActivityStreamOptions) {
|
||||
this.maxLines = options.maxLines || 500;
|
||||
|
||||
this.log = blessed.log({
|
||||
parent: options.parent,
|
||||
top: options.top,
|
||||
right: options.right,
|
||||
width: options.width,
|
||||
bottom: options.bottom,
|
||||
label: ' Activity Stream ',
|
||||
border: { type: 'line' },
|
||||
style: {
|
||||
border: { fg: colors.border },
|
||||
label: { fg: colors.header },
|
||||
},
|
||||
scrollable: true,
|
||||
alwaysScroll: true,
|
||||
keys: true,
|
||||
vi: true,
|
||||
mouse: true,
|
||||
});
|
||||
|
||||
this.bindKeys();
|
||||
}
|
||||
|
||||
/**
|
||||
* Bind component-specific keys
|
||||
*/
|
||||
private bindKeys(): void {
|
||||
this.log.key(['p'], () => {
|
||||
this.togglePause();
|
||||
});
|
||||
|
||||
this.log.key(['C-c'], () => {
|
||||
this.clear();
|
||||
});
|
||||
}
|
||||
|
||||
/**
|
||||
* Format event for display
|
||||
*/
|
||||
private formatEvent(event: LogEvent): string {
|
||||
const time = new Date(event.ts).toLocaleTimeString();
|
||||
const levelColor = getLevelColor(event.level as 'debug' | 'info' | 'warn' | 'error');
|
||||
const workerShort = event.worker.slice(0, 8);
|
||||
|
||||
let msg = event.msg;
|
||||
if (event.tool) {
|
||||
msg = `[${event.tool}] ${msg}`;
|
||||
}
|
||||
if (event.bead) {
|
||||
msg = `{blue-fg}${event.bead}{/} ${msg}`;
|
||||
}
|
||||
|
||||
return `{gray-fg}${time}{/} {bold}${workerShort}{/} {${levelColor}-fg}${event.level.toUpperCase()}{/} ${msg}`;
|
||||
}
|
||||
|
||||
/**
|
||||
* Check if event passes current filter
|
||||
*/
|
||||
private passesFilter(event: LogEvent): boolean {
|
||||
if (this.filter.workerId && event.worker !== this.filter.workerId) {
|
||||
return false;
|
||||
}
|
||||
if (this.filter.level && event.level !== this.filter.level) {
|
||||
return false;
|
||||
}
|
||||
if (this.filter.search) {
|
||||
const searchLower = this.filter.search.toLowerCase();
|
||||
const matchesSearch =
|
||||
event.msg.toLowerCase().includes(searchLower) ||
|
||||
event.worker.toLowerCase().includes(searchLower) ||
|
||||
(event.tool?.toLowerCase().includes(searchLower) ?? false) ||
|
||||
(event.bead?.toLowerCase().includes(searchLower) ?? false);
|
||||
if (!matchesSearch) {
|
||||
return false;
|
||||
}
|
||||
}
|
||||
return true;
|
||||
}
|
||||
|
||||
/**
|
||||
* Add event to the stream
|
||||
*/
|
||||
addEvent(event: LogEvent): void {
|
||||
this.events.push(event);
|
||||
|
||||
// Trim old events
|
||||
if (this.events.length > this.maxLines) {
|
||||
this.events = this.events.slice(-this.maxLines);
|
||||
}
|
||||
|
||||
// Only display if not paused and passes filter
|
||||
if (!this.isPaused && this.passesFilter(event)) {
|
||||
const formatted = this.formatEvent(event);
|
||||
this.log.log(formatted);
|
||||
}
|
||||
}
|
||||
|
||||
/**
|
||||
* Add multiple events
|
||||
*/
|
||||
addEvents(events: LogEvent[]): void {
|
||||
for (const event of events) {
|
||||
this.addEvent(event);
|
||||
}
|
||||
}
|
||||
|
||||
/**
|
||||
* Toggle pause state
|
||||
*/
|
||||
togglePause(): void {
|
||||
this.isPaused = !this.isPaused;
|
||||
const label = this.isPaused ? ' Activity Stream [PAUSED] ' : ' Activity Stream ';
|
||||
this.log.setLabel(label);
|
||||
this.log.screen.render();
|
||||
}
|
||||
|
||||
/**
|
||||
* Set filter and re-render
|
||||
*/
|
||||
setFilter(filter: ActivityFilter): void {
|
||||
this.filter = filter;
|
||||
this.reRender();
|
||||
}
|
||||
|
||||
/**
|
||||
* Clear filter
|
||||
*/
|
||||
clearFilter(): void {
|
||||
this.filter = {};
|
||||
this.reRender();
|
||||
}
|
||||
|
||||
/**
|
||||
* Re-render all events with current filter
|
||||
*/
|
||||
private reRender(): void {
|
||||
// Clear the log
|
||||
this.log.setContent('');
|
||||
|
||||
// Re-add filtered events
|
||||
const filtered = this.events.filter(e => this.passesFilter(e));
|
||||
for (const event of filtered.slice(-100)) { // Show last 100 matching
|
||||
const formatted = this.formatEvent(event);
|
||||
this.log.log(formatted);
|
||||
}
|
||||
|
||||
this.log.screen.render();
|
||||
}
|
||||
|
||||
/**
|
||||
* Clear all events
|
||||
*/
|
||||
clear(): void {
|
||||
this.events = [];
|
||||
this.log.setContent('');
|
||||
this.log.screen.render();
|
||||
}
|
||||
|
||||
/**
|
||||
* Focus this component
|
||||
*/
|
||||
focus(): void {
|
||||
this.log.focus();
|
||||
}
|
||||
|
||||
/**
|
||||
* Get the underlying log element
|
||||
*/
|
||||
getElement(): blessed.Widgets.Log {
|
||||
return this.log;
|
||||
}
|
||||
|
||||
/**
|
||||
* Get pause state
|
||||
*/
|
||||
getIsPaused(): boolean {
|
||||
return this.isPaused;
|
||||
}
|
||||
}
|
||||
|
||||
export default ActivityStream;
|
||||
263
src/tui/components/CommandPalette.ts
Normal file
263
src/tui/components/CommandPalette.ts
Normal file
|
|
@ -0,0 +1,263 @@
|
|||
/**
|
||||
* CommandPalette Component
|
||||
*
|
||||
* Universal search/command interface triggered by Ctrl+K.
|
||||
*/
|
||||
|
||||
import * as blessed from 'blessed';
|
||||
import { colors } from '../utils/colors.js';
|
||||
|
||||
export interface CommandPaletteOptions {
|
||||
/** Parent screen */
|
||||
parent: blessed.Widgets.Screen;
|
||||
|
||||
/** Callback when command is submitted */
|
||||
onSubmit?: (command: string) => void;
|
||||
|
||||
/** Callback when search changes */
|
||||
onSearch?: (query: string) => void;
|
||||
}
|
||||
|
||||
export interface CommandSuggestion {
|
||||
/** Display text */
|
||||
label: string;
|
||||
|
||||
/** Category */
|
||||
category: string;
|
||||
|
||||
/** Action to perform */
|
||||
action: string;
|
||||
}
|
||||
|
||||
/**
|
||||
* Default command suggestions
|
||||
*/
|
||||
const DEFAULT_SUGGESTIONS: CommandSuggestion[] = [
|
||||
{ label: 'Filter by worker', category: 'Filter', action: 'filter:worker:' },
|
||||
{ label: 'Filter by level', category: 'Filter', action: 'filter:level:' },
|
||||
{ label: 'Filter by bead', category: 'Filter', action: 'filter:bead:' },
|
||||
{ label: 'Clear filters', category: 'Action', action: 'clear' },
|
||||
{ label: 'Toggle pause', category: 'Action', action: 'pause' },
|
||||
{ label: 'Refresh', category: 'Action', action: 'refresh' },
|
||||
{ label: 'Help', category: 'Navigation', action: 'help' },
|
||||
{ label: 'Quit', category: 'Navigation', action: 'quit' },
|
||||
];
|
||||
|
||||
/**
|
||||
* CommandPalette provides a searchable command interface
|
||||
*/
|
||||
export class CommandPalette {
|
||||
private box: blessed.Widgets.BoxElement;
|
||||
private input: blessed.Widgets.TextboxElement;
|
||||
private suggestionBox: blessed.Widgets.ListElement;
|
||||
private onSubmit?: (command: string) => void;
|
||||
private onSearch?: (query: string) => void;
|
||||
private suggestions: CommandSuggestion[];
|
||||
private filteredSuggestions: CommandSuggestion[];
|
||||
private selectedIndex = 0;
|
||||
|
||||
constructor(options: CommandPaletteOptions) {
|
||||
this.onSubmit = options.onSubmit;
|
||||
this.onSearch = options.onSearch;
|
||||
this.suggestions = [...DEFAULT_SUGGESTIONS];
|
||||
this.filteredSuggestions = [...this.suggestions];
|
||||
|
||||
// Container box
|
||||
this.box = blessed.box({
|
||||
parent: options.parent,
|
||||
top: 'center',
|
||||
left: 'center',
|
||||
width: '60%',
|
||||
height: 12,
|
||||
hidden: true,
|
||||
style: {
|
||||
bg: 'black',
|
||||
},
|
||||
});
|
||||
|
||||
// Input textbox
|
||||
this.input = blessed.textbox({
|
||||
parent: this.box,
|
||||
top: 0,
|
||||
left: 0,
|
||||
right: 0,
|
||||
height: 3,
|
||||
border: { type: 'line' },
|
||||
style: {
|
||||
border: { fg: colors.focus },
|
||||
focus: {
|
||||
border: { fg: colors.focus },
|
||||
},
|
||||
},
|
||||
label: ' Command (Ctrl+K to close) ',
|
||||
inputOnFocus: true,
|
||||
});
|
||||
|
||||
// Suggestions list
|
||||
this.suggestionBox = blessed.list({
|
||||
parent: this.box,
|
||||
top: 3,
|
||||
left: 0,
|
||||
right: 0,
|
||||
bottom: 0,
|
||||
border: { type: 'line' },
|
||||
style: {
|
||||
border: { fg: colors.border },
|
||||
selected: {
|
||||
bg: colors.focus,
|
||||
fg: 'black',
|
||||
},
|
||||
},
|
||||
keys: true,
|
||||
vi: true,
|
||||
mouse: true,
|
||||
});
|
||||
|
||||
this.bindEvents();
|
||||
this.renderSuggestions();
|
||||
}
|
||||
|
||||
private bindEvents(): void {
|
||||
// Input changes
|
||||
this.input.on('keypress', (ch, key) => {
|
||||
if (key.name === 'escape') {
|
||||
this.hide();
|
||||
return;
|
||||
}
|
||||
|
||||
if (key.name === 'down') {
|
||||
this.selectNext();
|
||||
return;
|
||||
}
|
||||
|
||||
if (key.name === 'up') {
|
||||
this.selectPrevious();
|
||||
return;
|
||||
}
|
||||
|
||||
if (key.name === 'enter') {
|
||||
this.executeSelected();
|
||||
return;
|
||||
}
|
||||
|
||||
// Filter suggestions based on input
|
||||
const value = this.input.getValue();
|
||||
this.filterSuggestions(value);
|
||||
});
|
||||
|
||||
// Submit on enter
|
||||
this.input.on('submit', (value) => {
|
||||
if (this.onSubmit) {
|
||||
this.onSubmit(value);
|
||||
}
|
||||
this.hide();
|
||||
});
|
||||
|
||||
// Cancel on escape
|
||||
this.input.key(['escape'], () => {
|
||||
this.hide();
|
||||
});
|
||||
}
|
||||
|
||||
private filterSuggestions(query: string): void {
|
||||
const q = query.toLowerCase();
|
||||
this.filteredSuggestions = this.suggestions.filter(s =>
|
||||
s.label.toLowerCase().includes(q) ||
|
||||
s.category.toLowerCase().includes(q) ||
|
||||
s.action.toLowerCase().includes(q)
|
||||
);
|
||||
this.selectedIndex = 0;
|
||||
this.renderSuggestions();
|
||||
}
|
||||
|
||||
private renderSuggestions(): void {
|
||||
const items = this.filteredSuggestions.map((s, i) => {
|
||||
const selected = i === this.selectedIndex ? '{green-fg}' : '';
|
||||
const end = i === this.selectedIndex ? '{/}' : '';
|
||||
return `${selected}${s.category}: ${s.label}${end}`;
|
||||
});
|
||||
|
||||
this.suggestionBox.setItems(items);
|
||||
this.suggestionBox.select(this.selectedIndex);
|
||||
this.box.screen.render();
|
||||
}
|
||||
|
||||
private selectNext(): void {
|
||||
if (this.filteredSuggestions.length === 0) return;
|
||||
this.selectedIndex = (this.selectedIndex + 1) % this.filteredSuggestions.length;
|
||||
this.renderSuggestions();
|
||||
}
|
||||
|
||||
private selectPrevious(): void {
|
||||
if (this.filteredSuggestions.length === 0) return;
|
||||
this.selectedIndex = this.selectedIndex === 0
|
||||
? this.filteredSuggestions.length - 1
|
||||
: this.selectedIndex - 1;
|
||||
this.renderSuggestions();
|
||||
}
|
||||
|
||||
private executeSelected(): void {
|
||||
const selected = this.filteredSuggestions[this.selectedIndex];
|
||||
if (selected && this.onSubmit) {
|
||||
this.onSubmit(selected.action);
|
||||
}
|
||||
this.hide();
|
||||
}
|
||||
|
||||
/**
|
||||
* Show the command palette
|
||||
*/
|
||||
show(): void {
|
||||
this.box.show();
|
||||
this.input.setValue('');
|
||||
this.filteredSuggestions = [...this.suggestions];
|
||||
this.selectedIndex = 0;
|
||||
this.renderSuggestions();
|
||||
this.input.focus();
|
||||
this.box.screen.render();
|
||||
}
|
||||
|
||||
/**
|
||||
* Hide the command palette
|
||||
*/
|
||||
hide(): void {
|
||||
this.box.hide();
|
||||
this.box.screen.render();
|
||||
}
|
||||
|
||||
/**
|
||||
* Toggle visibility
|
||||
*/
|
||||
toggle(): void {
|
||||
if (this.box.hidden) {
|
||||
this.show();
|
||||
} else {
|
||||
this.hide();
|
||||
}
|
||||
}
|
||||
|
||||
/**
|
||||
* Check if visible
|
||||
*/
|
||||
isVisible(): boolean {
|
||||
return !this.box.hidden;
|
||||
}
|
||||
|
||||
/**
|
||||
* Add custom suggestion
|
||||
*/
|
||||
addSuggestion(suggestion: CommandSuggestion): void {
|
||||
this.suggestions.push(suggestion);
|
||||
}
|
||||
|
||||
/**
|
||||
* Clear custom suggestions
|
||||
*/
|
||||
clearSuggestions(): void {
|
||||
this.suggestions = [...DEFAULT_SUGGESTIONS];
|
||||
}
|
||||
}
|
||||
|
||||
export function createCommandPalette(options: CommandPaletteOptions): CommandPalette {
|
||||
return new CommandPalette(options);
|
||||
}
|
||||
329
src/tui/components/DiffView.ts
Normal file
329
src/tui/components/DiffView.ts
Normal file
|
|
@ -0,0 +1,329 @@
|
|||
/**
|
||||
* DiffView Component
|
||||
*
|
||||
* Renders unified diffs from Edit tool calls.
|
||||
* Shows additions in green, deletions in red, with line numbers.
|
||||
*/
|
||||
|
||||
import * as blessed from 'blessed';
|
||||
import { colors } from '../utils/colors.js';
|
||||
|
||||
export interface DiffViewOptions {
|
||||
/** Parent screen */
|
||||
parent: blessed.Widgets.Screen;
|
||||
|
||||
/** Position from top */
|
||||
top: number | string;
|
||||
|
||||
/** Position from left */
|
||||
left: number | string;
|
||||
|
||||
/** Width of the panel */
|
||||
width: number | string;
|
||||
|
||||
/** Height of the panel */
|
||||
height: number | string;
|
||||
|
||||
/** Maximum lines to show before truncation */
|
||||
maxLines?: number;
|
||||
}
|
||||
|
||||
export interface DiffLine {
|
||||
/** Line type: added, removed, context, header */
|
||||
type: 'added' | 'removed' | 'context' | 'header';
|
||||
|
||||
/** Original line number (for removed/context) */
|
||||
oldLine?: number;
|
||||
|
||||
/** New line number (for added/context) */
|
||||
newLine?: number;
|
||||
|
||||
/** Line content */
|
||||
content: string;
|
||||
}
|
||||
|
||||
export interface DiffHunk {
|
||||
/** File path being diffed */
|
||||
path: string;
|
||||
|
||||
/** Diff lines */
|
||||
lines: DiffLine[];
|
||||
|
||||
/** Whether this is truncated */
|
||||
truncated?: boolean;
|
||||
}
|
||||
|
||||
/**
|
||||
* Parse unified diff format into structured lines
|
||||
*/
|
||||
export function parseDiff(diffText: string): DiffLine[] {
|
||||
const lines: DiffLine[] = [];
|
||||
const rawLines = diffText.split('\n');
|
||||
|
||||
let oldLineNum = 0;
|
||||
let newLineNum = 0;
|
||||
|
||||
for (const line of rawLines) {
|
||||
// Hunk header @@ -a,b +c,d @@
|
||||
if (line.startsWith('@@')) {
|
||||
const match = line.match(/@@ -(\d+)(?:,\d+)? \+(\d+)(?:,\d+)? @@/);
|
||||
if (match) {
|
||||
oldLineNum = parseInt(match[1], 10);
|
||||
newLineNum = parseInt(match[2], 10);
|
||||
}
|
||||
lines.push({ type: 'header', content: line });
|
||||
continue;
|
||||
}
|
||||
|
||||
// File header
|
||||
if (line.startsWith('---') || line.startsWith('+++') || line.startsWith('diff')) {
|
||||
lines.push({ type: 'header', content: line });
|
||||
continue;
|
||||
}
|
||||
|
||||
// Context line
|
||||
if (line.startsWith(' ') || line === '') {
|
||||
lines.push({
|
||||
type: 'context',
|
||||
oldLine: oldLineNum++,
|
||||
newLine: newLineNum++,
|
||||
content: line.slice(1),
|
||||
});
|
||||
continue;
|
||||
}
|
||||
|
||||
// Added line
|
||||
if (line.startsWith('+')) {
|
||||
lines.push({
|
||||
type: 'added',
|
||||
newLine: newLineNum++,
|
||||
content: line.slice(1),
|
||||
});
|
||||
continue;
|
||||
}
|
||||
|
||||
// Removed line
|
||||
if (line.startsWith('-')) {
|
||||
lines.push({
|
||||
type: 'removed',
|
||||
oldLine: oldLineNum++,
|
||||
content: line.slice(1),
|
||||
});
|
||||
continue;
|
||||
}
|
||||
|
||||
// Other lines (e.g., index, mode changes)
|
||||
lines.push({ type: 'context', content: line });
|
||||
}
|
||||
|
||||
return lines;
|
||||
}
|
||||
|
||||
/**
|
||||
* Format a single diff line for blessed display
|
||||
*/
|
||||
function formatDiffLine(line: DiffLine, width: number): string {
|
||||
const maxContentWidth = width - 12; // Account for line numbers and padding
|
||||
|
||||
switch (line.type) {
|
||||
case 'header':
|
||||
return `{cyan-fg}${line.content.slice(0, maxContentWidth)}{/}`;
|
||||
|
||||
case 'added':
|
||||
const addedNum = line.newLine?.toString().padStart(4) || ' ';
|
||||
return `{green-fg}+${addedNum} ${line.content.slice(0, maxContentWidth)}{/}`;
|
||||
|
||||
case 'removed':
|
||||
const removedNum = line.oldLine?.toString().padStart(4) || ' ';
|
||||
return `{red-fg}-${removedNum} ${line.content.slice(0, maxContentWidth)}{/}`;
|
||||
|
||||
case 'context':
|
||||
const oldNum = line.oldLine?.toString().padStart(4) || ' ';
|
||||
const newNum = line.newLine?.toString().padStart(4) || ' ';
|
||||
const truncatedContent = line.content.slice(0, maxContentWidth - 10);
|
||||
return `{gray-fg} ${oldNum} ${newNum} ${truncatedContent}{/}`;
|
||||
|
||||
default:
|
||||
return line.content;
|
||||
}
|
||||
}
|
||||
|
||||
/**
|
||||
* DiffView displays inline diffs from Edit tool calls
|
||||
*/
|
||||
export class DiffView {
|
||||
private box: blessed.Widgets.BoxElement;
|
||||
private currentHunk: DiffHunk | null = null;
|
||||
private maxLines: number;
|
||||
|
||||
constructor(options: DiffViewOptions) {
|
||||
this.maxLines = options.maxLines || 50;
|
||||
|
||||
this.box = blessed.box({
|
||||
parent: options.parent,
|
||||
top: options.top,
|
||||
left: options.left,
|
||||
width: options.width,
|
||||
height: options.height,
|
||||
label: ' Diff View ',
|
||||
border: { type: 'line' },
|
||||
style: {
|
||||
border: { fg: colors.border },
|
||||
label: { fg: colors.header },
|
||||
},
|
||||
scrollable: true,
|
||||
alwaysScroll: true,
|
||||
keys: true,
|
||||
vi: true,
|
||||
mouse: true,
|
||||
hidden: true,
|
||||
});
|
||||
}
|
||||
|
||||
/**
|
||||
* Set the diff to display
|
||||
*/
|
||||
setDiff(path: string, diffText: string): void {
|
||||
const lines = parseDiff(diffText);
|
||||
const truncated = lines.length > this.maxLines;
|
||||
|
||||
this.currentHunk = {
|
||||
path,
|
||||
lines: truncated ? lines.slice(0, this.maxLines) : lines,
|
||||
truncated,
|
||||
};
|
||||
|
||||
this.render();
|
||||
}
|
||||
|
||||
/**
|
||||
* Set diff from Edit tool parameters
|
||||
*/
|
||||
setEditDiff(path: string, oldString: string, newString: string): void {
|
||||
// Generate a simple unified diff
|
||||
const diff = this.generateSimpleDiff(path, oldString, newString);
|
||||
this.setDiff(path, diff);
|
||||
}
|
||||
|
||||
/**
|
||||
* Generate a simple unified diff from old/new strings
|
||||
*/
|
||||
private generateSimpleDiff(path: string, oldString: string, newString: string): string {
|
||||
const oldLines = oldString.split('\n');
|
||||
const newLines = newString.split('\n');
|
||||
|
||||
let diff = `--- a/${path}\n+++ b/${path}\n@@ -1,${oldLines.length} +1,${newLines.length} @@\n`;
|
||||
|
||||
// Show removed lines
|
||||
for (const line of oldLines) {
|
||||
diff += `-${line}\n`;
|
||||
}
|
||||
|
||||
// Show added lines
|
||||
for (const line of newLines) {
|
||||
diff += `+${line}\n`;
|
||||
}
|
||||
|
||||
return diff;
|
||||
}
|
||||
|
||||
/**
|
||||
* Render the current diff
|
||||
*/
|
||||
render(): void {
|
||||
if (!this.currentHunk) {
|
||||
this.box.setContent('{gray-fg}No diff to display{/}');
|
||||
this.box.screen.render();
|
||||
return;
|
||||
}
|
||||
|
||||
const hunk = this.currentHunk;
|
||||
const width = (this.box.width as number) - 2; // Account for border
|
||||
const lines: string[] = [];
|
||||
|
||||
// Header with file path
|
||||
lines.push(`{bold}${hunk.path}{/}`);
|
||||
lines.push('{gray-fg}─────────────────────────────────────{/}');
|
||||
lines.push('');
|
||||
|
||||
// Diff lines
|
||||
for (const line of hunk.lines) {
|
||||
lines.push(formatDiffLine(line, width));
|
||||
}
|
||||
|
||||
// Truncation notice
|
||||
if (hunk.truncated) {
|
||||
lines.push('');
|
||||
lines.push('{yellow-fg}... truncated (press Enter to expand){/}');
|
||||
}
|
||||
|
||||
this.box.setContent(lines.join('\n'));
|
||||
this.box.screen.render();
|
||||
}
|
||||
|
||||
/**
|
||||
* Show the diff view
|
||||
*/
|
||||
show(): void {
|
||||
this.box.show();
|
||||
this.box.screen.render();
|
||||
}
|
||||
|
||||
/**
|
||||
* Hide the diff view
|
||||
*/
|
||||
hide(): void {
|
||||
this.box.hide();
|
||||
this.box.screen.render();
|
||||
}
|
||||
|
||||
/**
|
||||
* Toggle visibility
|
||||
*/
|
||||
toggle(): void {
|
||||
if (this.box.hidden) {
|
||||
this.show();
|
||||
} else {
|
||||
this.hide();
|
||||
}
|
||||
}
|
||||
|
||||
/**
|
||||
* Check if visible
|
||||
*/
|
||||
isVisible(): boolean {
|
||||
return !this.box.hidden;
|
||||
}
|
||||
|
||||
/**
|
||||
* Get current hunk
|
||||
*/
|
||||
getHunk(): DiffHunk | null {
|
||||
return this.currentHunk;
|
||||
}
|
||||
|
||||
/**
|
||||
* Clear the diff
|
||||
*/
|
||||
clear(): void {
|
||||
this.currentHunk = null;
|
||||
this.box.setContent('{gray-fg}No diff to display{/}');
|
||||
this.box.screen.render();
|
||||
}
|
||||
|
||||
/**
|
||||
* Focus this component
|
||||
*/
|
||||
focus(): void {
|
||||
this.box.focus();
|
||||
}
|
||||
|
||||
/**
|
||||
* Get the underlying blessed element
|
||||
*/
|
||||
getElement(): blessed.Widgets.BoxElement {
|
||||
return this.box;
|
||||
}
|
||||
}
|
||||
|
||||
export default DiffView;
|
||||
202
src/tui/components/WorkerDetail.ts
Normal file
202
src/tui/components/WorkerDetail.ts
Normal file
|
|
@ -0,0 +1,202 @@
|
|||
/**
|
||||
* WorkerDetail Component
|
||||
*
|
||||
* Displays detailed information about a selected worker.
|
||||
*/
|
||||
|
||||
import * as blessed from 'blessed';
|
||||
import { WorkerInfo, LogEvent } from '../../types.js';
|
||||
import { colors, getStatusColor, getLevelColor } from '../utils/colors.js';
|
||||
|
||||
export interface WorkerDetailOptions {
|
||||
/** Parent screen */
|
||||
parent: blessed.Widgets.Screen;
|
||||
|
||||
/** Position options */
|
||||
top: number | string;
|
||||
left: number | string;
|
||||
width: number | string;
|
||||
height: number | string;
|
||||
}
|
||||
|
||||
export class WorkerDetail {
|
||||
private box: blessed.Widgets.BoxElement;
|
||||
private worker: WorkerInfo | null = null;
|
||||
private recentEvents: LogEvent[] = [];
|
||||
|
||||
constructor(options: WorkerDetailOptions) {
|
||||
this.box = blessed.box({
|
||||
parent: options.parent,
|
||||
top: options.top,
|
||||
left: options.left,
|
||||
width: options.width,
|
||||
height: options.height,
|
||||
label: ' Worker Details ',
|
||||
border: { type: 'line' },
|
||||
style: {
|
||||
border: { fg: colors.border },
|
||||
label: { fg: colors.header },
|
||||
},
|
||||
scrollable: true,
|
||||
alwaysScroll: true,
|
||||
keys: true,
|
||||
vi: true,
|
||||
hidden: true,
|
||||
});
|
||||
}
|
||||
|
||||
/**
|
||||
* Set worker to display
|
||||
*/
|
||||
setWorker(worker: WorkerInfo | null): void {
|
||||
this.worker = worker;
|
||||
this.render();
|
||||
}
|
||||
|
||||
/**
|
||||
* Set recent events for this worker
|
||||
*/
|
||||
setRecentEvents(events: LogEvent[]): void {
|
||||
this.recentEvents = events.slice(-20); // Last 20 events
|
||||
this.render();
|
||||
}
|
||||
|
||||
/**
|
||||
* Format duration for display
|
||||
*/
|
||||
private formatDuration(ms: number): string {
|
||||
if (ms < 1000) return `${ms}ms`;
|
||||
if (ms < 60000) return `${(ms / 1000).toFixed(1)}s`;
|
||||
return `${(ms / 60000).toFixed(1)}m`;
|
||||
}
|
||||
|
||||
/**
|
||||
* Format timestamp for display
|
||||
*/
|
||||
private formatTime(ts: number): string {
|
||||
return new Date(ts).toLocaleTimeString();
|
||||
}
|
||||
|
||||
/**
|
||||
* Format uptime
|
||||
*/
|
||||
private formatUptime(firstSeen: number): string {
|
||||
const seconds = Math.floor((Date.now() - firstSeen) / 1000);
|
||||
if (seconds < 60) return `${seconds}s`;
|
||||
if (seconds < 3600) return `${Math.floor(seconds / 60)}m ${seconds % 60}s`;
|
||||
const hours = Math.floor(seconds / 3600);
|
||||
const mins = Math.floor((seconds % 3600) / 60);
|
||||
return `${hours}h ${mins}m`;
|
||||
}
|
||||
|
||||
/**
|
||||
* Render the detail view
|
||||
*/
|
||||
render(): void {
|
||||
if (!this.worker) {
|
||||
this.box.setContent('{gray-fg}No worker selected{/}');
|
||||
this.box.screen.render();
|
||||
return;
|
||||
}
|
||||
|
||||
const w = this.worker;
|
||||
const lines: string[] = [];
|
||||
|
||||
// Header with status
|
||||
const statusColor = getStatusColor(w.status);
|
||||
const statusIcon = w.status === 'active' ? '●' : w.status === 'idle' ? '○' : '✗';
|
||||
lines.push(`{${statusColor}-fg}{bold}${statusIcon} ${w.id}{/}`);
|
||||
lines.push('{gray-fg}─────────────────────────────────────{/}');
|
||||
lines.push('');
|
||||
|
||||
// Status info
|
||||
lines.push(`{bold}Status:{/} {${statusColor}-fg}${w.status.toUpperCase()}{/}`);
|
||||
lines.push(`{bold}Uptime:{/} ${this.formatUptime(w.firstSeen)}`);
|
||||
lines.push(`{bold}Beads Completed:{/} {green-fg}${w.beadsCompleted}{/}`);
|
||||
lines.push('');
|
||||
|
||||
// Last activity
|
||||
lines.push('{bold}Last Activity:{/}');
|
||||
if (w.lastEvent) {
|
||||
const e = w.lastEvent;
|
||||
lines.push(` Time: ${this.formatTime(e.ts)}`);
|
||||
lines.push(` Level: {${getLevelColor(e.level)}-fg}${e.level.toUpperCase()}{/}`);
|
||||
if (e.bead) lines.push(` Bead: {magenta-fg}${e.bead}{/}`);
|
||||
if (e.tool) lines.push(` Tool: {cyan-fg}${e.tool}{/}`);
|
||||
if (e.msg) lines.push(` Msg: ${e.msg.slice(0, 60)}`);
|
||||
if (e.duration_ms) lines.push(` Duration: ${this.formatDuration(e.duration_ms)}`);
|
||||
if (e.error) lines.push(` {red-fg}Error: ${e.error}{/}`);
|
||||
} else {
|
||||
lines.push(' {gray-fg}No events recorded{/}');
|
||||
}
|
||||
|
||||
// Recent events
|
||||
if (this.recentEvents.length > 0) {
|
||||
lines.push('');
|
||||
lines.push('{bold}Recent Events:{/}');
|
||||
lines.push('{gray-fg}─────────────────────────────────────{/}');
|
||||
|
||||
for (const e of this.recentEvents.slice(-10)) {
|
||||
const time = this.formatTime(e.ts);
|
||||
const level = e.level.toUpperCase().slice(0, 3);
|
||||
const msg = e.msg?.slice(0, 40) || '';
|
||||
lines.push(` {gray-fg}${time}{/} {${getLevelColor(e.level)}-fg}${level}{/} ${msg}`);
|
||||
}
|
||||
}
|
||||
|
||||
this.box.setContent(lines.join('\n'));
|
||||
this.box.screen.render();
|
||||
}
|
||||
|
||||
/**
|
||||
* Show the detail view
|
||||
*/
|
||||
show(): void {
|
||||
this.box.show();
|
||||
this.box.screen.render();
|
||||
}
|
||||
|
||||
/**
|
||||
* Hide the detail view
|
||||
*/
|
||||
hide(): void {
|
||||
this.box.hide();
|
||||
this.box.screen.render();
|
||||
}
|
||||
|
||||
/**
|
||||
* Toggle visibility
|
||||
*/
|
||||
toggle(): void {
|
||||
if (this.box.hidden) {
|
||||
this.show();
|
||||
} else {
|
||||
this.hide();
|
||||
}
|
||||
}
|
||||
|
||||
/**
|
||||
* Check if visible
|
||||
*/
|
||||
isVisible(): boolean {
|
||||
return !this.box.hidden;
|
||||
}
|
||||
|
||||
/**
|
||||
* Focus this component
|
||||
*/
|
||||
focus(): void {
|
||||
this.box.focus();
|
||||
}
|
||||
|
||||
/**
|
||||
* Get the underlying blessed element
|
||||
*/
|
||||
getElement(): blessed.Widgets.BoxElement {
|
||||
return this.box;
|
||||
}
|
||||
}
|
||||
|
||||
export function createWorkerDetail(options: WorkerDetailOptions): WorkerDetail {
|
||||
return new WorkerDetail(options);
|
||||
}
|
||||
204
src/tui/components/WorkerGrid.ts
Normal file
204
src/tui/components/WorkerGrid.ts
Normal file
|
|
@ -0,0 +1,204 @@
|
|||
/**
|
||||
* WorkerGrid Component
|
||||
*
|
||||
* Displays all active workers with status indicators in a scrollable list.
|
||||
*/
|
||||
|
||||
import * as blessed from 'blessed';
|
||||
import { WorkerInfo } from '../../types.js';
|
||||
import { colors, getStatusColor } from '../utils/colors.js';
|
||||
|
||||
export interface WorkerGridOptions {
|
||||
/** Parent screen */
|
||||
parent: blessed.Widgets.Screen;
|
||||
|
||||
/** Position from top */
|
||||
top: number | string;
|
||||
|
||||
/** Position from left */
|
||||
left: number | string;
|
||||
|
||||
/** Width of the panel */
|
||||
width: number | string;
|
||||
|
||||
/** Position from bottom */
|
||||
bottom: number | string;
|
||||
}
|
||||
|
||||
/**
|
||||
* WorkerGrid displays worker status in a grid format
|
||||
*/
|
||||
export class WorkerGrid {
|
||||
private box: blessed.Widgets.BoxElement;
|
||||
private workers: WorkerInfo[] = [];
|
||||
private selectedIndex = 0;
|
||||
|
||||
constructor(options: WorkerGridOptions) {
|
||||
this.box = blessed.box({
|
||||
parent: options.parent,
|
||||
top: options.top,
|
||||
left: options.left,
|
||||
width: options.width,
|
||||
bottom: options.bottom,
|
||||
label: ' Workers ',
|
||||
border: { type: 'line' },
|
||||
style: {
|
||||
border: { fg: colors.border },
|
||||
label: { fg: colors.header },
|
||||
selected: { fg: colors.focus },
|
||||
},
|
||||
scrollable: true,
|
||||
alwaysScroll: true,
|
||||
keys: true,
|
||||
vi: true,
|
||||
mouse: true,
|
||||
});
|
||||
|
||||
this.bindKeys();
|
||||
}
|
||||
|
||||
/**
|
||||
* Bind component-specific keys
|
||||
*/
|
||||
private bindKeys(): void {
|
||||
this.box.key(['up', 'k'], () => {
|
||||
this.selectPrevious();
|
||||
});
|
||||
|
||||
this.box.key(['down', 'j'], () => {
|
||||
this.selectNext();
|
||||
});
|
||||
|
||||
this.box.key(['g'], () => {
|
||||
this.selectedIndex = 0;
|
||||
this.render();
|
||||
});
|
||||
|
||||
this.box.key(['G'], () => {
|
||||
this.selectedIndex = Math.max(0, this.workers.length - 1);
|
||||
this.render();
|
||||
});
|
||||
}
|
||||
|
||||
/**
|
||||
* Get status icon for worker
|
||||
*/
|
||||
private getStatusIcon(worker: WorkerInfo): string {
|
||||
switch (worker.status) {
|
||||
case 'active': return '●';
|
||||
case 'idle': return '○';
|
||||
case 'error': return '✗';
|
||||
}
|
||||
}
|
||||
|
||||
/**
|
||||
* Get collision indicator for worker
|
||||
*/
|
||||
private getCollisionIndicator(worker: WorkerInfo): string {
|
||||
if (worker.hasCollision) {
|
||||
return '{yellow-fg}⚠{/}';
|
||||
}
|
||||
return '';
|
||||
}
|
||||
|
||||
/**
|
||||
* Format worker line for display
|
||||
*/
|
||||
private formatWorkerLine(worker: WorkerInfo, isSelected: boolean): string {
|
||||
const icon = this.getStatusIcon(worker);
|
||||
const color = getStatusColor(worker.status);
|
||||
const workerId = worker.id.slice(0, 12);
|
||||
const currentTask = worker.lastEvent?.bead || '-';
|
||||
const taskDesc = (worker.lastEvent?.msg || '').slice(0, 25);
|
||||
const duration = this.formatDuration(worker.lastEvent?.ts);
|
||||
const collisionIndicator = this.getCollisionIndicator(worker);
|
||||
|
||||
const selectedMarker = isSelected ? '>' : ' ';
|
||||
return `${selectedMarker} {${color}-fg}${icon}{/} {bold}${workerId}{/} {gray-fg}${currentTask}{/} ${taskDesc} {blue-fg}${duration}{/} ${collisionIndicator}`;
|
||||
}
|
||||
|
||||
/**
|
||||
* Format duration from timestamp
|
||||
*/
|
||||
private formatDuration(ts?: number): string {
|
||||
if (!ts) return '-';
|
||||
const seconds = Math.floor((Date.now() - ts) / 1000);
|
||||
if (seconds < 60) return `${seconds}s`;
|
||||
if (seconds < 3600) return `${Math.floor(seconds / 60)}m`;
|
||||
return `${Math.floor(seconds / 3600)}h`;
|
||||
}
|
||||
|
||||
/**
|
||||
* Update workers data
|
||||
*/
|
||||
updateWorkers(workers: WorkerInfo[]): void {
|
||||
this.workers = workers;
|
||||
this.selectedIndex = Math.min(this.selectedIndex, Math.max(0, workers.length - 1));
|
||||
this.render();
|
||||
}
|
||||
|
||||
/**
|
||||
* Select next worker
|
||||
*/
|
||||
selectNext(): void {
|
||||
if (this.workers.length === 0) return;
|
||||
this.selectedIndex = (this.selectedIndex + 1) % this.workers.length;
|
||||
this.render();
|
||||
}
|
||||
|
||||
/**
|
||||
* Select previous worker
|
||||
*/
|
||||
selectPrevious(): void {
|
||||
if (this.workers.length === 0) return;
|
||||
this.selectedIndex = this.selectedIndex === 0
|
||||
? this.workers.length - 1
|
||||
: this.selectedIndex - 1;
|
||||
this.render();
|
||||
}
|
||||
|
||||
/**
|
||||
* Get currently selected worker
|
||||
*/
|
||||
getSelected(): WorkerInfo | undefined {
|
||||
return this.workers[this.selectedIndex];
|
||||
}
|
||||
|
||||
/**
|
||||
* Render the component
|
||||
*/
|
||||
render(): void {
|
||||
const lines: string[] = [];
|
||||
|
||||
if (this.workers.length === 0) {
|
||||
lines.push('{gray-fg}No workers detected{/}');
|
||||
} else {
|
||||
lines.push(`{bold}Total: ${this.workers.length} workers{/}\n`);
|
||||
|
||||
for (let i = 0; i < this.workers.length; i++) {
|
||||
const worker = this.workers[i];
|
||||
const isSelected = i === this.selectedIndex;
|
||||
lines.push(this.formatWorkerLine(worker, isSelected));
|
||||
}
|
||||
}
|
||||
|
||||
this.box.setContent(lines.join('\n'));
|
||||
this.box.screen.render();
|
||||
}
|
||||
|
||||
/**
|
||||
* Focus this component
|
||||
*/
|
||||
focus(): void {
|
||||
this.box.focus();
|
||||
}
|
||||
|
||||
/**
|
||||
* Get the underlying box element
|
||||
*/
|
||||
getElement(): blessed.Widgets.BoxElement {
|
||||
return this.box;
|
||||
}
|
||||
}
|
||||
|
||||
export default WorkerGrid;
|
||||
19
src/tui/components/index.ts
Normal file
19
src/tui/components/index.ts
Normal file
|
|
@ -0,0 +1,19 @@
|
|||
/**
|
||||
* TUI Components
|
||||
*
|
||||
* Export all TUI components for FABRIC.
|
||||
*/
|
||||
|
||||
export { WorkerGrid } from './WorkerGrid.js';
|
||||
export type { WorkerGridOptions } from './WorkerGrid.js';
|
||||
|
||||
export { ActivityStream } from './ActivityStream.js';
|
||||
export type { ActivityStreamOptions, ActivityFilter } from './ActivityStream.js';
|
||||
|
||||
export { WorkerDetail } from './WorkerDetail.js';
|
||||
|
||||
export { CommandPalette } from './CommandPalette.js';
|
||||
export type { CommandPaletteOptions, CommandSuggestion } from './CommandPalette.js';
|
||||
|
||||
export { DiffView, parseDiff } from './DiffView.js';
|
||||
export type { DiffViewOptions, DiffLine, DiffHunk } from './DiffView.js';
|
||||
11
src/tui/index.ts
Normal file
11
src/tui/index.ts
Normal file
|
|
@ -0,0 +1,11 @@
|
|||
/**
|
||||
* FABRIC TUI Module
|
||||
*
|
||||
* Terminal User Interface for FABRIC worker activity monitoring.
|
||||
*/
|
||||
|
||||
export { FabricTuiApp, createTuiApp, type TuiOptions } from './app.js';
|
||||
export * from './utils/colors.js';
|
||||
export * from './utils/keyboard.js';
|
||||
export * from './utils/stuckDetection.js';
|
||||
export * from './utils/costTracking.js';
|
||||
49
src/tui/utils/colors.ts
Normal file
49
src/tui/utils/colors.ts
Normal file
|
|
@ -0,0 +1,49 @@
|
|||
/**
|
||||
* FABRIC TUI Color Scheme
|
||||
*
|
||||
* Color definitions for terminal UI rendering.
|
||||
*/
|
||||
|
||||
export const colors = {
|
||||
// Status colors
|
||||
active: 'green',
|
||||
idle: 'yellow',
|
||||
error: 'red',
|
||||
|
||||
// Log level colors
|
||||
debug: 'gray',
|
||||
info: 'white',
|
||||
warn: 'yellow',
|
||||
error_level: 'red',
|
||||
|
||||
// UI colors
|
||||
border: 'blue',
|
||||
header: 'cyan',
|
||||
focus: 'green',
|
||||
muted: 'gray',
|
||||
|
||||
// Background colors
|
||||
bgPanel: 'black',
|
||||
bgFocus: 'blue',
|
||||
} as const;
|
||||
|
||||
export type ColorName = keyof typeof colors;
|
||||
|
||||
/**
|
||||
* Get color for worker status
|
||||
*/
|
||||
export function getStatusColor(status: 'active' | 'idle' | 'error'): string {
|
||||
return colors[status];
|
||||
}
|
||||
|
||||
/**
|
||||
* Get color for log level
|
||||
*/
|
||||
export function getLevelColor(level: 'debug' | 'info' | 'warn' | 'error'): string {
|
||||
switch (level) {
|
||||
case 'debug': return colors.debug;
|
||||
case 'info': return colors.info;
|
||||
case 'warn': return colors.warn;
|
||||
case 'error': return colors.error_level;
|
||||
}
|
||||
}
|
||||
346
src/tui/utils/costTracking.ts
Normal file
346
src/tui/utils/costTracking.ts
Normal file
|
|
@ -0,0 +1,346 @@
|
|||
/**
|
||||
* Cost Tracking Utilities
|
||||
*
|
||||
* Tracks token usage from log events and calculates estimated costs.
|
||||
* Displays total tokens, estimated cost, and per-worker breakdown.
|
||||
*/
|
||||
|
||||
import { LogEvent } from '../../types.js';
|
||||
|
||||
export interface TokenUsage {
|
||||
/** Input tokens */
|
||||
input: number;
|
||||
|
||||
/** Output tokens */
|
||||
output: number;
|
||||
|
||||
/** Total tokens */
|
||||
total: number;
|
||||
}
|
||||
|
||||
export interface WorkerCost extends TokenUsage {
|
||||
/** Worker ID */
|
||||
workerId: string;
|
||||
|
||||
/** Estimated cost in USD */
|
||||
costUsd: number;
|
||||
|
||||
/** Number of API calls */
|
||||
apiCalls: number;
|
||||
}
|
||||
|
||||
export interface CostSummary {
|
||||
/** Total usage across all workers */
|
||||
total: TokenUsage;
|
||||
|
||||
/** Estimated total cost in USD */
|
||||
totalCostUsd: number;
|
||||
|
||||
/** Per-worker breakdown */
|
||||
byWorker: Map<string, WorkerCost>;
|
||||
|
||||
/** Budget status */
|
||||
budget: BudgetStatus;
|
||||
|
||||
/** Time range of data */
|
||||
timeRange: {
|
||||
start: number;
|
||||
end: number;
|
||||
};
|
||||
}
|
||||
|
||||
export interface BudgetStatus {
|
||||
/** Budget limit in USD (0 = no limit) */
|
||||
limit: number;
|
||||
|
||||
/** Current spend */
|
||||
spent: number;
|
||||
|
||||
/** Percentage of budget used (0-100) */
|
||||
percentUsed: number;
|
||||
|
||||
/** Whether over budget */
|
||||
isOverBudget: boolean;
|
||||
|
||||
/** Warning level (none, warning, critical) */
|
||||
warningLevel: 'none' | 'warning' | 'critical';
|
||||
}
|
||||
|
||||
export interface CostTrackingOptions {
|
||||
/** Budget limit in USD (0 = no limit) */
|
||||
budgetLimit?: number;
|
||||
|
||||
/** Warning threshold (percent, default 75) */
|
||||
warningThreshold?: number;
|
||||
|
||||
/** Critical threshold (percent, default 90) */
|
||||
criticalThreshold?: number;
|
||||
|
||||
/** Input cost per 1M tokens (default: $3 for Claude) */
|
||||
inputCostPerMillion?: number;
|
||||
|
||||
/** Output cost per 1M tokens (default: $15 for Claude) */
|
||||
outputCostPerMillion?: number;
|
||||
}
|
||||
|
||||
const DEFAULT_OPTIONS: Required<CostTrackingOptions> = {
|
||||
budgetLimit: 0,
|
||||
warningThreshold: 75,
|
||||
criticalThreshold: 90,
|
||||
inputCostPerMillion: 3.00, // Claude Sonnet input
|
||||
outputCostPerMillion: 15.00, // Claude Sonnet output
|
||||
};
|
||||
|
||||
// Model pricing (per 1M tokens)
|
||||
const MODEL_PRICING: Record<string, { input: number; output: number }> = {
|
||||
'claude-sonnet-4-6': { input: 3.00, output: 15.00 },
|
||||
'claude-opus-4-6': { input: 15.00, output: 75.00 },
|
||||
'claude-haiku-4-5': { input: 0.80, output: 4.00 },
|
||||
'claude-3-5-sonnet': { input: 3.00, output: 15.00 },
|
||||
'claude-3-opus': { input: 15.00, output: 75.00 },
|
||||
'claude-3-haiku': { input: 0.25, output: 1.25 },
|
||||
'gpt-4o': { input: 2.50, output: 10.00 },
|
||||
'gpt-4-turbo': { input: 10.00, output: 30.00 },
|
||||
'gpt-3.5-turbo': { input: 0.50, output: 1.50 },
|
||||
'glm-5': { input: 0.50, output: 0.50 }, // Estimated
|
||||
};
|
||||
|
||||
/**
|
||||
* Cost Tracker class for managing token usage and costs
|
||||
*/
|
||||
export class CostTracker {
|
||||
private options: Required<CostTrackingOptions>;
|
||||
private workerCosts: Map<string, WorkerCost> = new Map();
|
||||
private firstEventTs: number | null = null;
|
||||
private lastEventTs: number | null = null;
|
||||
|
||||
constructor(options: CostTrackingOptions = {}) {
|
||||
this.options = { ...DEFAULT_OPTIONS, ...options };
|
||||
}
|
||||
|
||||
/**
|
||||
* Process a log event and extract token usage
|
||||
*/
|
||||
processEvent(event: LogEvent): void {
|
||||
// Track time range
|
||||
if (this.firstEventTs === null || event.ts < this.firstEventTs) {
|
||||
this.firstEventTs = event.ts;
|
||||
}
|
||||
if (this.lastEventTs === null || event.ts > this.lastEventTs) {
|
||||
this.lastEventTs = event.ts;
|
||||
}
|
||||
|
||||
// Extract token info from event
|
||||
const tokens = this.extractTokens(event);
|
||||
if (!tokens) return;
|
||||
|
||||
// Get or create worker cost entry
|
||||
let workerCost = this.workerCosts.get(event.worker);
|
||||
if (!workerCost) {
|
||||
workerCost = {
|
||||
workerId: event.worker,
|
||||
input: 0,
|
||||
output: 0,
|
||||
total: 0,
|
||||
costUsd: 0,
|
||||
apiCalls: 0,
|
||||
};
|
||||
this.workerCosts.set(event.worker, workerCost);
|
||||
}
|
||||
|
||||
// Update totals
|
||||
workerCost.input += tokens.input;
|
||||
workerCost.output += tokens.output;
|
||||
workerCost.total += tokens.input + tokens.output;
|
||||
workerCost.apiCalls += 1;
|
||||
|
||||
// Calculate cost based on model
|
||||
const model = (event.model as string) || 'claude-sonnet-4-6';
|
||||
const pricing = MODEL_PRICING[model] || MODEL_PRICING['claude-sonnet-4-6'];
|
||||
workerCost.costUsd =
|
||||
(workerCost.input * pricing.input / 1_000_000) +
|
||||
(workerCost.output * pricing.output / 1_000_000);
|
||||
}
|
||||
|
||||
/**
|
||||
* Extract token counts from event
|
||||
*/
|
||||
private extractTokens(event: LogEvent): { input: number; output: number } | null {
|
||||
// Check for explicit token fields
|
||||
if (typeof event.input_tokens === 'number' || typeof event.output_tokens === 'number') {
|
||||
return {
|
||||
input: (event.input_tokens as number) || 0,
|
||||
output: (event.output_tokens as number) || 0,
|
||||
};
|
||||
}
|
||||
|
||||
// Check for usage object
|
||||
const usage = event.usage as { input_tokens?: number; output_tokens?: number } | undefined;
|
||||
if (usage) {
|
||||
return {
|
||||
input: usage.input_tokens || 0,
|
||||
output: usage.output_tokens || 0,
|
||||
};
|
||||
}
|
||||
|
||||
// Check for token counts in message
|
||||
const msg = event.msg || '';
|
||||
const inputMatch = msg.match(/input[:\s]+(\d+)/i);
|
||||
const outputMatch = msg.match(/output[:\s]+(\d+)/i);
|
||||
|
||||
if (inputMatch || outputMatch) {
|
||||
return {
|
||||
input: inputMatch ? parseInt(inputMatch[1], 10) : 0,
|
||||
output: outputMatch ? parseInt(outputMatch[1], 10) : 0,
|
||||
};
|
||||
}
|
||||
|
||||
return null;
|
||||
}
|
||||
|
||||
/**
|
||||
* Get current cost summary
|
||||
*/
|
||||
getSummary(): CostSummary {
|
||||
let totalInput = 0;
|
||||
let totalOutput = 0;
|
||||
|
||||
for (const worker of this.workerCosts.values()) {
|
||||
totalInput += worker.input;
|
||||
totalOutput += worker.output;
|
||||
}
|
||||
|
||||
const totalPrice = MODEL_PRICING['claude-sonnet-4-6']; // Default pricing
|
||||
const totalCostUsd =
|
||||
(totalInput * totalPrice.input / 1_000_000) +
|
||||
(totalOutput * totalPrice.output / 1_000_000);
|
||||
|
||||
const budget = this.calculateBudgetStatus(totalCostUsd);
|
||||
|
||||
return {
|
||||
total: {
|
||||
input: totalInput,
|
||||
output: totalOutput,
|
||||
total: totalInput + totalOutput,
|
||||
},
|
||||
totalCostUsd,
|
||||
byWorker: new Map(this.workerCosts),
|
||||
budget,
|
||||
timeRange: {
|
||||
start: this.firstEventTs || Date.now(),
|
||||
end: this.lastEventTs || Date.now(),
|
||||
},
|
||||
};
|
||||
}
|
||||
|
||||
/**
|
||||
* Calculate budget status
|
||||
*/
|
||||
private calculateBudgetStatus(spent: number): BudgetStatus {
|
||||
const limit = this.options.budgetLimit;
|
||||
|
||||
if (limit === 0) {
|
||||
return {
|
||||
limit: 0,
|
||||
spent,
|
||||
percentUsed: 0,
|
||||
isOverBudget: false,
|
||||
warningLevel: 'none',
|
||||
};
|
||||
}
|
||||
|
||||
const percentUsed = (spent / limit) * 100;
|
||||
const isOverBudget = spent > limit;
|
||||
|
||||
let warningLevel: 'none' | 'warning' | 'critical' = 'none';
|
||||
if (percentUsed >= this.options.criticalThreshold || isOverBudget) {
|
||||
warningLevel = 'critical';
|
||||
} else if (percentUsed >= this.options.warningThreshold) {
|
||||
warningLevel = 'warning';
|
||||
}
|
||||
|
||||
return {
|
||||
limit,
|
||||
spent,
|
||||
percentUsed,
|
||||
isOverBudget,
|
||||
warningLevel,
|
||||
};
|
||||
}
|
||||
|
||||
/**
|
||||
* Reset tracking data
|
||||
*/
|
||||
reset(): void {
|
||||
this.workerCosts.clear();
|
||||
this.firstEventTs = null;
|
||||
this.lastEventTs = null;
|
||||
}
|
||||
|
||||
/**
|
||||
* Set budget limit
|
||||
*/
|
||||
setBudgetLimit(limit: number): void {
|
||||
this.options.budgetLimit = limit;
|
||||
}
|
||||
}
|
||||
|
||||
/**
|
||||
* Format cost for display
|
||||
*/
|
||||
export function formatCost(usd: number): string {
|
||||
if (usd < 0.01) {
|
||||
return `$${(usd * 100).toFixed(2)}c`;
|
||||
}
|
||||
if (usd < 1) {
|
||||
return `$${usd.toFixed(3)}`;
|
||||
}
|
||||
if (usd < 100) {
|
||||
return `$${usd.toFixed(2)}`;
|
||||
}
|
||||
return `$${usd.toFixed(0)}`;
|
||||
}
|
||||
|
||||
/**
|
||||
* Format token count for display
|
||||
*/
|
||||
export function formatTokens(count: number): string {
|
||||
if (count < 1000) {
|
||||
return count.toString();
|
||||
}
|
||||
if (count < 1_000_000) {
|
||||
return `${(count / 1000).toFixed(1)}K`;
|
||||
}
|
||||
return `${(count / 1_000_000).toFixed(2)}M`;
|
||||
}
|
||||
|
||||
/**
|
||||
* Get budget indicator character
|
||||
*/
|
||||
export function getBudgetIndicator(status: BudgetStatus): string {
|
||||
switch (status.warningLevel) {
|
||||
case 'critical':
|
||||
return status.isOverBudget ? '🚨' : '⚠️';
|
||||
case 'warning':
|
||||
return '⚡';
|
||||
case 'none':
|
||||
default:
|
||||
return '';
|
||||
}
|
||||
}
|
||||
|
||||
/**
|
||||
* Create a global cost tracker instance
|
||||
*/
|
||||
let globalTracker: CostTracker | undefined;
|
||||
|
||||
export function getCostTracker(): CostTracker {
|
||||
if (!globalTracker) {
|
||||
globalTracker = new CostTracker();
|
||||
}
|
||||
return globalTracker;
|
||||
}
|
||||
|
||||
export function resetCostTracker(): void {
|
||||
globalTracker = undefined;
|
||||
}
|
||||
62
src/tui/utils/keyboard.ts
Normal file
62
src/tui/utils/keyboard.ts
Normal file
|
|
@ -0,0 +1,62 @@
|
|||
/**
|
||||
* FABRIC TUI Keyboard Bindings
|
||||
*
|
||||
* Key binding definitions for terminal UI navigation.
|
||||
*/
|
||||
|
||||
export interface KeyBinding {
|
||||
key: string;
|
||||
description: string;
|
||||
action: () => void;
|
||||
}
|
||||
|
||||
export const defaultBindings: Record<string, string> = {
|
||||
// Navigation
|
||||
j: 'scroll-down',
|
||||
k: 'scroll-up',
|
||||
g: 'scroll-top',
|
||||
G: 'scroll-bottom',
|
||||
|
||||
// Panel switching
|
||||
tab: 'next-panel',
|
||||
'S-tab': 'prev-panel',
|
||||
'1': 'panel-workers',
|
||||
'2': 'panel-activity',
|
||||
'3': 'panel-detail',
|
||||
|
||||
// Actions
|
||||
'/': 'search',
|
||||
f: 'filter',
|
||||
r: 'refresh',
|
||||
p: 'pause',
|
||||
enter: 'select',
|
||||
|
||||
// General
|
||||
q: 'quit',
|
||||
'?': 'help',
|
||||
escape: 'cancel',
|
||||
};
|
||||
|
||||
/**
|
||||
* Format key for display
|
||||
*/
|
||||
export function formatKey(key: string): string {
|
||||
const displayMap: Record<string, string> = {
|
||||
tab: 'Tab',
|
||||
'S-tab': 'Shift+Tab',
|
||||
enter: 'Enter',
|
||||
escape: 'Esc',
|
||||
'/': '/',
|
||||
'?': '?',
|
||||
};
|
||||
return displayMap[key] || key.toUpperCase();
|
||||
}
|
||||
|
||||
/**
|
||||
* Get help text for key bindings
|
||||
*/
|
||||
export function getHelpText(): string {
|
||||
return Object.entries(defaultBindings)
|
||||
.map(([key, action]) => `{bold}${formatKey(key)}{/bold}: ${action}`)
|
||||
.join('\n');
|
||||
}
|
||||
264
src/tui/utils/stuckDetection.ts
Normal file
264
src/tui/utils/stuckDetection.ts
Normal file
|
|
@ -0,0 +1,264 @@
|
|||
/**
|
||||
* Stuck Worker Detection
|
||||
*
|
||||
* Analyzes worker patterns to detect when workers are spinning their wheels
|
||||
* without making meaningful progress.
|
||||
*/
|
||||
|
||||
import { LogEvent, WorkerInfo } from '../../types.js';
|
||||
|
||||
export interface StuckPattern {
|
||||
/** Type of stuck pattern detected */
|
||||
type: 'repeated_tool' | 'no_progress' | 'circular_edit' | 'long_running';
|
||||
|
||||
/** Human-readable description */
|
||||
reason: string;
|
||||
|
||||
/** Severity: warning = might be stuck, critical = definitely stuck */
|
||||
severity: 'warning' | 'critical';
|
||||
|
||||
/** Evidence from recent events */
|
||||
evidence: string[];
|
||||
|
||||
/** Suggested action */
|
||||
suggestion: string;
|
||||
}
|
||||
|
||||
export interface StuckDetectionOptions {
|
||||
/** Time window to analyze (ms), default 5 minutes */
|
||||
windowMs?: number;
|
||||
|
||||
/** Threshold for repeated tool calls */
|
||||
repeatedToolThreshold?: number;
|
||||
|
||||
/** Threshold for no progress (ms), default 2 minutes */
|
||||
noProgressThresholdMs?: number;
|
||||
|
||||
/** Threshold for long-running tasks (ms), default 10 minutes */
|
||||
longRunningThresholdMs?: number;
|
||||
}
|
||||
|
||||
const DEFAULT_OPTIONS: Required<StuckDetectionOptions> = {
|
||||
windowMs: 5 * 60 * 1000, // 5 minutes
|
||||
repeatedToolThreshold: 5,
|
||||
noProgressThresholdMs: 2 * 60 * 1000, // 2 minutes
|
||||
longRunningThresholdMs: 10 * 60 * 1000, // 10 minutes
|
||||
};
|
||||
|
||||
/**
|
||||
* Detect if a worker is stuck based on recent events
|
||||
*/
|
||||
export function isWorkerStuck(
|
||||
worker: WorkerInfo,
|
||||
events: LogEvent[],
|
||||
options: StuckDetectionOptions = {}
|
||||
): StuckPattern | null {
|
||||
const opts = { ...DEFAULT_OPTIONS, ...options };
|
||||
const now = Date.now();
|
||||
const windowStart = now - opts.windowMs;
|
||||
|
||||
// Filter to recent events for this worker
|
||||
const recentEvents = events.filter(
|
||||
(e) => e.worker === worker.id && e.ts >= windowStart
|
||||
);
|
||||
|
||||
if (recentEvents.length === 0) {
|
||||
return null;
|
||||
}
|
||||
|
||||
// Check patterns in order of severity
|
||||
const patterns = [
|
||||
detectRepeatedToolCalls(recentEvents, opts),
|
||||
detectNoProgress(worker, recentEvents, opts),
|
||||
detectCircularEdits(recentEvents, opts),
|
||||
detectLongRunning(worker, recentEvents, opts),
|
||||
];
|
||||
|
||||
// Return the most severe pattern
|
||||
for (const pattern of patterns) {
|
||||
if (pattern) {
|
||||
return pattern;
|
||||
}
|
||||
}
|
||||
|
||||
return null;
|
||||
}
|
||||
|
||||
/**
|
||||
* Get a human-readable stuck reason
|
||||
*/
|
||||
export function getStuckReason(
|
||||
worker: WorkerInfo,
|
||||
events: LogEvent[],
|
||||
options: StuckDetectionOptions = {}
|
||||
): string | null {
|
||||
const pattern = isWorkerStuck(worker, events, options);
|
||||
return pattern?.reason ?? null;
|
||||
}
|
||||
|
||||
/**
|
||||
* Detect repeated tool calls with same parameters
|
||||
*/
|
||||
function detectRepeatedToolCalls(
|
||||
events: LogEvent[],
|
||||
opts: Required<StuckDetectionOptions>
|
||||
): StuckPattern | null {
|
||||
// Group events by tool + path (if path exists)
|
||||
const toolCounts = new Map<string, { count: number; events: LogEvent[] }>();
|
||||
|
||||
for (const event of events) {
|
||||
if (!event.tool) continue;
|
||||
|
||||
const key = event.path
|
||||
? `${event.tool}:${event.path}`
|
||||
: event.tool;
|
||||
|
||||
const existing = toolCounts.get(key);
|
||||
if (existing) {
|
||||
existing.count++;
|
||||
existing.events.push(event);
|
||||
} else {
|
||||
toolCounts.set(key, { count: 1, events: [event] });
|
||||
}
|
||||
}
|
||||
|
||||
// Find repeated tool calls
|
||||
for (const [key, data] of toolCounts) {
|
||||
if (data.count >= opts.repeatedToolThreshold) {
|
||||
const [tool, path] = key.split(':');
|
||||
return {
|
||||
type: 'repeated_tool',
|
||||
reason: `Called ${tool}${path ? ` on ${path}` : ''} ${data.count} times without progress`,
|
||||
severity: data.count >= opts.repeatedToolThreshold * 2 ? 'critical' : 'warning',
|
||||
evidence: data.events.slice(-3).map((e) => `${e.tool}: ${e.msg?.slice(0, 50)}`),
|
||||
suggestion: 'Consider alternative approach or escalate to human',
|
||||
};
|
||||
}
|
||||
}
|
||||
|
||||
return null;
|
||||
}
|
||||
|
||||
/**
|
||||
* Detect no meaningful progress for extended time
|
||||
*/
|
||||
function detectNoProgress(
|
||||
worker: WorkerInfo,
|
||||
events: LogEvent[],
|
||||
opts: Required<StuckDetectionOptions>
|
||||
): StuckPattern | null {
|
||||
const now = Date.now();
|
||||
const timeSinceActivity = now - worker.lastActivity;
|
||||
|
||||
if (timeSinceActivity > opts.noProgressThresholdMs) {
|
||||
const seconds = Math.floor(timeSinceActivity / 1000);
|
||||
const minutes = Math.floor(seconds / 60);
|
||||
|
||||
return {
|
||||
type: 'no_progress',
|
||||
reason: `No activity for ${minutes > 0 ? `${minutes}m` : `${seconds}s`}`,
|
||||
severity: timeSinceActivity > opts.longRunningThresholdMs ? 'critical' : 'warning',
|
||||
evidence: worker.lastEvent
|
||||
? [`Last: ${worker.lastEvent.msg?.slice(0, 60)}`]
|
||||
: ['No recent events'],
|
||||
suggestion: 'Check if worker is waiting for external resource or blocked',
|
||||
};
|
||||
}
|
||||
|
||||
// Also check for events but no completions
|
||||
const recentCompletions = events.filter(
|
||||
(e) => e.msg?.includes('completed') || e.msg?.includes('complete')
|
||||
);
|
||||
|
||||
if (events.length > 10 && recentCompletions.length === 0) {
|
||||
return {
|
||||
type: 'no_progress',
|
||||
reason: `${events.length} events but no completions in window`,
|
||||
severity: 'warning',
|
||||
evidence: events.slice(-3).map((e) => e.msg?.slice(0, 40) || ''),
|
||||
suggestion: 'Worker may be stuck in exploration loop',
|
||||
};
|
||||
}
|
||||
|
||||
return null;
|
||||
}
|
||||
|
||||
/**
|
||||
* Detect circular file edits (same file edited back and forth)
|
||||
*/
|
||||
function detectCircularEdits(
|
||||
events: LogEvent[],
|
||||
opts: Required<StuckDetectionOptions>
|
||||
): StuckPattern | null {
|
||||
const editEvents = events.filter(
|
||||
(e) => e.tool === 'Edit' && e.path
|
||||
);
|
||||
|
||||
if (editEvents.length < 3) return null;
|
||||
|
||||
// Track edit sequences per file
|
||||
const fileEdits = new Map<string, string[]>();
|
||||
|
||||
for (const event of editEvents) {
|
||||
const path = event.path!;
|
||||
const edits = fileEdits.get(path) || [];
|
||||
// Simplified: track just the count per file
|
||||
edits.push(event.ts.toString());
|
||||
fileEdits.set(path, edits);
|
||||
}
|
||||
|
||||
// Check for files with many back-and-forth edits
|
||||
for (const [path, timestamps] of fileEdits) {
|
||||
if (timestamps.length >= 4) {
|
||||
return {
|
||||
type: 'circular_edit',
|
||||
reason: `File ${path} edited ${timestamps.length} times - possible circular changes`,
|
||||
severity: timestamps.length >= 6 ? 'critical' : 'warning',
|
||||
evidence: [`Edits at: ${timestamps.slice(-4).join(', ')}`],
|
||||
suggestion: 'Review edit history, may need to step back and reconsider approach',
|
||||
};
|
||||
}
|
||||
}
|
||||
|
||||
return null;
|
||||
}
|
||||
|
||||
/**
|
||||
* Detect long-running tasks
|
||||
*/
|
||||
function detectLongRunning(
|
||||
worker: WorkerInfo,
|
||||
events: LogEvent[],
|
||||
opts: Required<StuckDetectionOptions>
|
||||
): StuckPattern | null {
|
||||
const runningTime = Date.now() - worker.firstSeen;
|
||||
|
||||
if (runningTime > opts.longRunningThresholdMs) {
|
||||
const minutes = Math.floor(runningTime / 60000);
|
||||
|
||||
// Check if making progress
|
||||
const completions = events.filter(
|
||||
(e) => e.msg?.includes('completed') || e.msg?.includes('complete')
|
||||
).length;
|
||||
|
||||
if (completions < 2) {
|
||||
return {
|
||||
type: 'long_running',
|
||||
reason: `Running for ${minutes}m with only ${completions} completion(s)`,
|
||||
severity: minutes >= 20 ? 'critical' : 'warning',
|
||||
evidence: [`Beads completed: ${worker.beadsCompleted}`],
|
||||
suggestion: 'Consider breaking task into smaller pieces',
|
||||
};
|
||||
}
|
||||
}
|
||||
|
||||
return null;
|
||||
}
|
||||
|
||||
/**
|
||||
* Get stuck indicator character for display
|
||||
*/
|
||||
export function getStuckIndicator(pattern: StuckPattern | null): string {
|
||||
if (!pattern) return '';
|
||||
return pattern.severity === 'critical' ? '⚠' : '⚡';
|
||||
}
|
||||
32
src/types.ts
32
src/types.ts
|
|
@ -58,6 +58,12 @@ export interface WorkerInfo {
|
|||
|
||||
/** Last activity timestamp */
|
||||
lastActivity: number;
|
||||
|
||||
/** Files currently being modified by this worker */
|
||||
activeFiles: string[];
|
||||
|
||||
/** Whether this worker is involved in any collisions */
|
||||
hasCollision: boolean;
|
||||
}
|
||||
|
||||
export interface EventFilter {
|
||||
|
|
@ -80,6 +86,26 @@ export interface EventFilter {
|
|||
until?: number;
|
||||
}
|
||||
|
||||
/**
|
||||
* File collision event - when multiple workers modify the same file concurrently
|
||||
*/
|
||||
export interface FileCollision {
|
||||
/** File path being contested */
|
||||
path: string;
|
||||
|
||||
/** Workers involved in the collision */
|
||||
workers: string[];
|
||||
|
||||
/** Timestamp when collision was detected */
|
||||
detectedAt: number;
|
||||
|
||||
/** Events that triggered the collision */
|
||||
events: LogEvent[];
|
||||
|
||||
/** Whether the collision is still active */
|
||||
isActive: boolean;
|
||||
}
|
||||
|
||||
export interface EventStore {
|
||||
/** Add an event to the store */
|
||||
add(event: LogEvent): void;
|
||||
|
|
@ -95,4 +121,10 @@ export interface EventStore {
|
|||
|
||||
/** Clear all events */
|
||||
clear(): void;
|
||||
|
||||
/** Get all active collisions */
|
||||
getCollisions(): FileCollision[];
|
||||
|
||||
/** Get collisions for a specific worker */
|
||||
getWorkerCollisions(workerId: string): FileCollision[];
|
||||
}
|
||||
|
|
|
|||
16
src/web/frontend/index.html
Normal file
16
src/web/frontend/index.html
Normal file
|
|
@ -0,0 +1,16 @@
|
|||
<!DOCTYPE html>
|
||||
<html lang="en">
|
||||
<head>
|
||||
<meta charset="UTF-8" />
|
||||
<meta name="viewport" content="width=device-width, initial-scale=1.0" />
|
||||
<title>FABRIC - Worker Dashboard</title>
|
||||
<style>
|
||||
* { margin: 0; padding: 0; box-sizing: border-box; }
|
||||
body { font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, sans-serif; background: #1a1a2e; color: #eee; }
|
||||
</style>
|
||||
</head>
|
||||
<body>
|
||||
<div id="root"></div>
|
||||
<script type="module" src="/src/main.tsx"></script>
|
||||
</body>
|
||||
</html>
|
||||
156
src/web/frontend/src/App.tsx
Normal file
156
src/web/frontend/src/App.tsx
Normal file
|
|
@ -0,0 +1,156 @@
|
|||
import React, { useState, useEffect, useCallback } from 'react';
|
||||
import { LogEvent, WorkerInfo, WebSocketMessage } from './types';
|
||||
import WorkerGrid from './components/WorkerGrid';
|
||||
import ActivityStream from './components/ActivityStream';
|
||||
|
||||
const App: React.FC = () => {
|
||||
const [workers, setWorkers] = useState<WorkerInfo[]>([]);
|
||||
const [events, setEvents] = useState<LogEvent[]>([]);
|
||||
const [selectedWorker, setSelectedWorker] = useState<string | null>(null);
|
||||
const [connected, setConnected] = useState(false);
|
||||
|
||||
const handleWebSocketMessage = useCallback((message: WebSocketMessage) => {
|
||||
if (message.type === 'init') {
|
||||
const data = message.data as { workers?: WorkerInfo[]; recentEvents?: LogEvent[] };
|
||||
if (data.workers) setWorkers(data.workers);
|
||||
if (data.recentEvents) setEvents(data.recentEvents);
|
||||
} else if (message.type === 'event') {
|
||||
const event = message.data as LogEvent;
|
||||
setEvents(prev => [...prev.slice(-199), event]);
|
||||
|
||||
// Update worker info
|
||||
setWorkers(prev => {
|
||||
const existing = prev.find(w => w.id === event.worker);
|
||||
if (existing) {
|
||||
return prev.map(w => w.id === event.worker ? {
|
||||
...w,
|
||||
lastSeen: event.timestamp,
|
||||
eventCount: w.eventCount + 1,
|
||||
status: 'active' as const,
|
||||
currentTool: event.tool,
|
||||
recentEvents: [...w.recentEvents.slice(-9), event],
|
||||
} : w);
|
||||
} else {
|
||||
return [...prev, {
|
||||
id: event.worker,
|
||||
lastSeen: event.timestamp,
|
||||
eventCount: 1,
|
||||
status: 'active' as const,
|
||||
currentTool: event.tool,
|
||||
recentEvents: [event],
|
||||
}];
|
||||
}
|
||||
});
|
||||
}
|
||||
}, []);
|
||||
|
||||
useEffect(() => {
|
||||
const ws = new WebSocket(`${window.location.protocol === 'https:' ? 'wss:' : 'ws:'}//${window.location.host}/ws`);
|
||||
|
||||
ws.onopen = () => {
|
||||
setConnected(true);
|
||||
console.log('WebSocket connected');
|
||||
};
|
||||
|
||||
ws.onclose = () => {
|
||||
setConnected(false);
|
||||
console.log('WebSocket disconnected');
|
||||
};
|
||||
|
||||
ws.onerror = (err) => {
|
||||
console.error('WebSocket error:', err);
|
||||
};
|
||||
|
||||
ws.onmessage = (event) => {
|
||||
try {
|
||||
const message = JSON.parse(event.data) as WebSocketMessage;
|
||||
handleWebSocketMessage(message);
|
||||
} catch (err) {
|
||||
console.error('Failed to parse message:', err);
|
||||
}
|
||||
};
|
||||
|
||||
return () => {
|
||||
ws.close();
|
||||
};
|
||||
}, [handleWebSocketMessage]);
|
||||
|
||||
const filteredEvents = selectedWorker
|
||||
? events.filter(e => e.worker === selectedWorker)
|
||||
: events;
|
||||
|
||||
const selectedWorkerInfo = selectedWorker
|
||||
? workers.find(w => w.id === selectedWorker)
|
||||
: null;
|
||||
|
||||
return (
|
||||
<div className="app">
|
||||
<header className="header">
|
||||
<h1>FABRIC</h1>
|
||||
<div className="connection-status">
|
||||
<span className={`status-dot ${connected ? 'connected' : ''}`}></span>
|
||||
{connected ? 'Connected' : 'Disconnected'}
|
||||
</div>
|
||||
</header>
|
||||
|
||||
<main className="main-content">
|
||||
<WorkerGrid
|
||||
workers={workers}
|
||||
selectedWorker={selectedWorker}
|
||||
onSelectWorker={setSelectedWorker}
|
||||
/>
|
||||
|
||||
<ActivityStream
|
||||
events={filteredEvents}
|
||||
selectedWorker={selectedWorker}
|
||||
/>
|
||||
|
||||
{selectedWorkerInfo && (
|
||||
<aside className="worker-detail">
|
||||
<h2>{selectedWorkerInfo.id}</h2>
|
||||
|
||||
<div className="detail-section">
|
||||
<h3>Status</h3>
|
||||
<div className="detail-row">
|
||||
<span className="detail-label">State</span>
|
||||
<span className={`detail-value worker-status ${selectedWorkerInfo.status}`}>
|
||||
{selectedWorkerInfo.status}
|
||||
</span>
|
||||
</div>
|
||||
<div className="detail-row">
|
||||
<span className="detail-label">Events</span>
|
||||
<span className="detail-value">{selectedWorkerInfo.eventCount}</span>
|
||||
</div>
|
||||
<div className="detail-row">
|
||||
<span className="detail-label">Current Tool</span>
|
||||
<span className="detail-value">{selectedWorkerInfo.currentTool || '-'}</span>
|
||||
</div>
|
||||
<div className="detail-row">
|
||||
<span className="detail-label">Last Seen</span>
|
||||
<span className="detail-value">
|
||||
{new Date(selectedWorkerInfo.lastSeen).toLocaleTimeString()}
|
||||
</span>
|
||||
</div>
|
||||
</div>
|
||||
|
||||
<div className="detail-section">
|
||||
<h3>Recent Events</h3>
|
||||
{selectedWorkerInfo.recentEvents.slice(-5).map((event, i) => (
|
||||
<div key={i} className="detail-row">
|
||||
<span className={`detail-label event-level ${event.level}`}>
|
||||
{event.level}
|
||||
</span>
|
||||
<span className="detail-value" style={{ fontSize: '0.75rem', overflow: 'hidden', textOverflow: 'ellipsis' }}>
|
||||
{event.message.slice(0, 50)}
|
||||
</span>
|
||||
</div>
|
||||
))}
|
||||
</div>
|
||||
</aside>
|
||||
)}
|
||||
</main>
|
||||
</div>
|
||||
);
|
||||
};
|
||||
|
||||
export default App;
|
||||
67
src/web/frontend/src/components/ActivityStream.tsx
Normal file
67
src/web/frontend/src/components/ActivityStream.tsx
Normal file
|
|
@ -0,0 +1,67 @@
|
|||
import React, { useEffect, useRef } from 'react';
|
||||
import { LogEvent } from '../types';
|
||||
|
||||
interface ActivityStreamProps {
|
||||
events: LogEvent[];
|
||||
selectedWorker: string | null;
|
||||
}
|
||||
|
||||
const ActivityStream: React.FC<ActivityStreamProps> = ({ events, selectedWorker }) => {
|
||||
const listRef = useRef<HTMLDivElement>(null);
|
||||
|
||||
// Auto-scroll to bottom on new events
|
||||
useEffect(() => {
|
||||
if (listRef.current) {
|
||||
listRef.current.scrollTop = listRef.current.scrollHeight;
|
||||
}
|
||||
}, [events]);
|
||||
|
||||
const formatTime = (timestamp: string) => {
|
||||
return new Date(timestamp).toLocaleTimeString('en-US', {
|
||||
hour12: false,
|
||||
hour: '2-digit',
|
||||
minute: '2-digit',
|
||||
second: '2-digit',
|
||||
});
|
||||
};
|
||||
|
||||
const truncateWorker = (worker: string) => {
|
||||
// Extract just the identifying part (e.g., "alpha" from "claude-code-glm-5-alpha")
|
||||
const parts = worker.split('-');
|
||||
return parts[parts.length - 1];
|
||||
};
|
||||
|
||||
return (
|
||||
<div className="activity-stream">
|
||||
<h2>
|
||||
{selectedWorker ? `Events for ${selectedWorker}` : 'All Events'}
|
||||
<span style={{ marginLeft: '1rem', fontWeight: 'normal', color: '#666' }}>
|
||||
({events.length})
|
||||
</span>
|
||||
</h2>
|
||||
|
||||
<div className="event-list" ref={listRef}>
|
||||
{events.length === 0 ? (
|
||||
<div className="no-events">
|
||||
No events to display
|
||||
</div>
|
||||
) : (
|
||||
events.map((event, i) => (
|
||||
<div key={`${event.timestamp}-${i}`} className="event-item">
|
||||
<span className="event-time">{formatTime(event.timestamp)}</span>
|
||||
<span className={`event-level ${event.level}`}>{event.level}</span>
|
||||
{!selectedWorker && (
|
||||
<span className="event-worker">[{truncateWorker(event.worker)}]</span>
|
||||
)}
|
||||
<span className="event-message">
|
||||
{event.tool ? `[${event.tool}] ` : ''}{event.message}
|
||||
</span>
|
||||
</div>
|
||||
))
|
||||
)}
|
||||
</div>
|
||||
</div>
|
||||
);
|
||||
};
|
||||
|
||||
export default ActivityStream;
|
||||
70
src/web/frontend/src/components/WorkerGrid.tsx
Normal file
70
src/web/frontend/src/components/WorkerGrid.tsx
Normal file
|
|
@ -0,0 +1,70 @@
|
|||
import React from 'react';
|
||||
import { WorkerInfo } from '../types';
|
||||
|
||||
interface WorkerGridProps {
|
||||
workers: WorkerInfo[];
|
||||
selectedWorker: string | null;
|
||||
onSelectWorker: (id: string | null) => void;
|
||||
}
|
||||
|
||||
const WorkerGrid: React.FC<WorkerGridProps> = ({ workers, selectedWorker, onSelectWorker }) => {
|
||||
const formatLastSeen = (timestamp: string) => {
|
||||
const diff = Date.now() - new Date(timestamp).getTime();
|
||||
const seconds = Math.floor(diff / 1000);
|
||||
if (seconds < 60) return `${seconds}s ago`;
|
||||
const minutes = Math.floor(seconds / 60);
|
||||
if (minutes < 60) return `${minutes}m ago`;
|
||||
const hours = Math.floor(minutes / 60);
|
||||
return `${hours}h ago`;
|
||||
};
|
||||
|
||||
return (
|
||||
<div className="worker-grid">
|
||||
<h2>Workers ({workers.length})</h2>
|
||||
|
||||
{workers.length === 0 ? (
|
||||
<div className="empty-state">
|
||||
<p>No workers detected</p>
|
||||
<p style={{ fontSize: '0.75rem', marginTop: '0.5rem' }}>
|
||||
Waiting for log events...
|
||||
</p>
|
||||
</div>
|
||||
) : (
|
||||
workers.map(worker => (
|
||||
<div
|
||||
key={worker.id}
|
||||
className={`worker-card ${selectedWorker === worker.id ? 'selected' : ''} ${worker.hasCollision ? 'collision' : ''}`}
|
||||
onClick={() => onSelectWorker(selectedWorker === worker.id ? null : worker.id)}
|
||||
>
|
||||
<div className="worker-card-header">
|
||||
<span className="worker-id">
|
||||
{worker.id}
|
||||
{worker.hasCollision && (
|
||||
<span className="collision-indicator" title="File collision detected!">
|
||||
⚠️
|
||||
</span>
|
||||
)}
|
||||
</span>
|
||||
<span className={`worker-status ${worker.status}`}>
|
||||
{worker.status}
|
||||
</span>
|
||||
</div>
|
||||
<div className="worker-stats">
|
||||
<span>{worker.eventCount} events</span>
|
||||
<span>{formatLastSeen(worker.lastSeen)}</span>
|
||||
</div>
|
||||
{worker.hasCollision && worker.activeFiles && worker.activeFiles.length > 0 && (
|
||||
<div className="collision-warning">
|
||||
<span style={{ fontSize: '0.7rem', color: '#ff9800' }}>
|
||||
Colliding on: {worker.activeFiles.length} file(s)
|
||||
</span>
|
||||
</div>
|
||||
)}
|
||||
</div>
|
||||
))
|
||||
)}
|
||||
</div>
|
||||
);
|
||||
};
|
||||
|
||||
export default WorkerGrid;
|
||||
310
src/web/frontend/src/index.css
Normal file
310
src/web/frontend/src/index.css
Normal file
|
|
@ -0,0 +1,310 @@
|
|||
:root {
|
||||
--bg-primary: #1a1a2e;
|
||||
--bg-secondary: #16213e;
|
||||
--bg-tertiary: #0f3460;
|
||||
--accent: #e94560;
|
||||
--accent-dim: #e9456060;
|
||||
--text-primary: #eee;
|
||||
--text-secondary: #aaa;
|
||||
--success: #00c853;
|
||||
--warning: #ffc107;
|
||||
--error: #f44336;
|
||||
--info: #2196f3;
|
||||
}
|
||||
|
||||
* {
|
||||
margin: 0;
|
||||
padding: 0;
|
||||
box-sizing: border-box;
|
||||
}
|
||||
|
||||
body {
|
||||
font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, 'Helvetica Neue', sans-serif;
|
||||
background: var(--bg-primary);
|
||||
color: var(--text-primary);
|
||||
line-height: 1.5;
|
||||
}
|
||||
|
||||
.app {
|
||||
display: flex;
|
||||
flex-direction: column;
|
||||
height: 100vh;
|
||||
overflow: hidden;
|
||||
}
|
||||
|
||||
.header {
|
||||
display: flex;
|
||||
align-items: center;
|
||||
justify-content: space-between;
|
||||
padding: 0.75rem 1.5rem;
|
||||
background: var(--bg-secondary);
|
||||
border-bottom: 1px solid var(--bg-tertiary);
|
||||
}
|
||||
|
||||
.header h1 {
|
||||
font-size: 1.25rem;
|
||||
font-weight: 600;
|
||||
color: var(--accent);
|
||||
}
|
||||
|
||||
.connection-status {
|
||||
display: flex;
|
||||
align-items: center;
|
||||
gap: 0.5rem;
|
||||
font-size: 0.875rem;
|
||||
color: var(--text-secondary);
|
||||
}
|
||||
|
||||
.status-dot {
|
||||
width: 8px;
|
||||
height: 8px;
|
||||
border-radius: 50%;
|
||||
background: var(--error);
|
||||
}
|
||||
|
||||
.status-dot.connected {
|
||||
background: var(--success);
|
||||
}
|
||||
|
||||
.main-content {
|
||||
display: grid;
|
||||
grid-template-columns: 300px 1fr;
|
||||
flex: 1;
|
||||
overflow: hidden;
|
||||
}
|
||||
|
||||
.worker-grid {
|
||||
background: var(--bg-secondary);
|
||||
border-right: 1px solid var(--bg-tertiary);
|
||||
overflow-y: auto;
|
||||
padding: 1rem;
|
||||
}
|
||||
|
||||
.worker-grid h2 {
|
||||
font-size: 0.875rem;
|
||||
font-weight: 600;
|
||||
text-transform: uppercase;
|
||||
letter-spacing: 0.05em;
|
||||
color: var(--text-secondary);
|
||||
margin-bottom: 1rem;
|
||||
}
|
||||
|
||||
.worker-card {
|
||||
background: var(--bg-tertiary);
|
||||
border-radius: 6px;
|
||||
padding: 0.75rem;
|
||||
margin-bottom: 0.5rem;
|
||||
cursor: pointer;
|
||||
transition: all 0.2s;
|
||||
border: 2px solid transparent;
|
||||
}
|
||||
|
||||
.worker-card:hover {
|
||||
background: var(--bg-primary);
|
||||
}
|
||||
|
||||
.worker-card.selected {
|
||||
border-color: var(--accent);
|
||||
}
|
||||
|
||||
.worker-card.collision {
|
||||
border-color: var(--warning);
|
||||
animation: pulse-warning 2s infinite;
|
||||
}
|
||||
|
||||
@keyframes pulse-warning {
|
||||
0%, 100% {
|
||||
box-shadow: 0 0 0 0 rgba(255, 193, 7, 0.4);
|
||||
}
|
||||
50% {
|
||||
box-shadow: 0 0 0 8px rgba(255, 193, 7, 0);
|
||||
}
|
||||
}
|
||||
|
||||
.worker-card-header {
|
||||
display: flex;
|
||||
justify-content: space-between;
|
||||
align-items: center;
|
||||
margin-bottom: 0.5rem;
|
||||
}
|
||||
|
||||
.worker-id {
|
||||
font-weight: 600;
|
||||
font-size: 0.875rem;
|
||||
display: flex;
|
||||
align-items: center;
|
||||
gap: 0.5rem;
|
||||
}
|
||||
|
||||
.collision-indicator {
|
||||
font-size: 0.875rem;
|
||||
animation: bounce 1s infinite;
|
||||
}
|
||||
|
||||
@keyframes bounce {
|
||||
0%, 100% {
|
||||
transform: translateY(0);
|
||||
}
|
||||
50% {
|
||||
transform: translateY(-2px);
|
||||
}
|
||||
}
|
||||
|
||||
.collision-warning {
|
||||
margin-top: 0.5rem;
|
||||
padding-top: 0.5rem;
|
||||
border-top: 1px solid rgba(255, 152, 0, 0.3);
|
||||
}
|
||||
|
||||
.worker-status {
|
||||
font-size: 0.75rem;
|
||||
padding: 0.125rem 0.5rem;
|
||||
border-radius: 4px;
|
||||
text-transform: uppercase;
|
||||
}
|
||||
|
||||
.worker-status.active {
|
||||
background: var(--success);
|
||||
color: #fff;
|
||||
}
|
||||
|
||||
.worker-status.idle {
|
||||
background: var(--warning);
|
||||
color: #000;
|
||||
}
|
||||
|
||||
.worker-status.error {
|
||||
background: var(--error);
|
||||
color: #fff;
|
||||
}
|
||||
|
||||
.worker-stats {
|
||||
display: flex;
|
||||
gap: 1rem;
|
||||
font-size: 0.75rem;
|
||||
color: var(--text-secondary);
|
||||
}
|
||||
|
||||
.activity-stream {
|
||||
display: flex;
|
||||
flex-direction: column;
|
||||
overflow: hidden;
|
||||
}
|
||||
|
||||
.activity-stream h2 {
|
||||
padding: 1rem;
|
||||
font-size: 0.875rem;
|
||||
font-weight: 600;
|
||||
text-transform: uppercase;
|
||||
letter-spacing: 0.05em;
|
||||
color: var(--text-secondary);
|
||||
background: var(--bg-secondary);
|
||||
border-bottom: 1px solid var(--bg-tertiary);
|
||||
}
|
||||
|
||||
.event-list {
|
||||
flex: 1;
|
||||
overflow-y: auto;
|
||||
padding: 0.5rem;
|
||||
font-family: 'SF Mono', Monaco, 'Cascadia Code', monospace;
|
||||
font-size: 0.8125rem;
|
||||
}
|
||||
|
||||
.event-item {
|
||||
display: flex;
|
||||
gap: 0.75rem;
|
||||
padding: 0.375rem 0.5rem;
|
||||
border-radius: 4px;
|
||||
margin-bottom: 0.25rem;
|
||||
}
|
||||
|
||||
.event-item:hover {
|
||||
background: var(--bg-secondary);
|
||||
}
|
||||
|
||||
.event-time {
|
||||
color: var(--text-secondary);
|
||||
flex-shrink: 0;
|
||||
}
|
||||
|
||||
.event-level {
|
||||
flex-shrink: 0;
|
||||
width: 50px;
|
||||
text-transform: uppercase;
|
||||
font-weight: 600;
|
||||
}
|
||||
|
||||
.event-level.debug { color: var(--text-secondary); }
|
||||
.event-level.info { color: var(--info); }
|
||||
.event-level.warn { color: var(--warning); }
|
||||
.event-level.error { color: var(--error); }
|
||||
|
||||
.event-worker {
|
||||
color: var(--accent);
|
||||
flex-shrink: 0;
|
||||
}
|
||||
|
||||
.event-message {
|
||||
flex: 1;
|
||||
overflow: hidden;
|
||||
text-overflow: ellipsis;
|
||||
white-space: nowrap;
|
||||
}
|
||||
|
||||
.no-events {
|
||||
color: var(--text-secondary);
|
||||
text-align: center;
|
||||
padding: 2rem;
|
||||
}
|
||||
|
||||
.worker-detail {
|
||||
background: var(--bg-secondary);
|
||||
border-left: 1px solid var(--bg-tertiary);
|
||||
padding: 1rem;
|
||||
overflow-y: auto;
|
||||
}
|
||||
|
||||
.worker-detail h2 {
|
||||
font-size: 1rem;
|
||||
margin-bottom: 1rem;
|
||||
}
|
||||
|
||||
.detail-section {
|
||||
margin-bottom: 1.5rem;
|
||||
}
|
||||
|
||||
.detail-section h3 {
|
||||
font-size: 0.75rem;
|
||||
text-transform: uppercase;
|
||||
letter-spacing: 0.05em;
|
||||
color: var(--text-secondary);
|
||||
margin-bottom: 0.5rem;
|
||||
}
|
||||
|
||||
.detail-row {
|
||||
display: flex;
|
||||
justify-content: space-between;
|
||||
padding: 0.375rem 0;
|
||||
border-bottom: 1px solid var(--bg-tertiary);
|
||||
}
|
||||
|
||||
.detail-label {
|
||||
color: var(--text-secondary);
|
||||
}
|
||||
|
||||
.detail-value {
|
||||
font-weight: 500;
|
||||
}
|
||||
|
||||
.empty-state {
|
||||
display: flex;
|
||||
flex-direction: column;
|
||||
align-items: center;
|
||||
justify-content: center;
|
||||
height: 100%;
|
||||
color: var(--text-secondary);
|
||||
}
|
||||
|
||||
.empty-state p {
|
||||
margin-top: 0.5rem;
|
||||
}
|
||||
10
src/web/frontend/src/main.tsx
Normal file
10
src/web/frontend/src/main.tsx
Normal file
|
|
@ -0,0 +1,10 @@
|
|||
import React from 'react';
|
||||
import ReactDOM from 'react-dom/client';
|
||||
import App from './App';
|
||||
import './index.css';
|
||||
|
||||
ReactDOM.createRoot(document.getElementById('root')!).render(
|
||||
<React.StrictMode>
|
||||
<App />
|
||||
</React.StrictMode>
|
||||
);
|
||||
37
src/web/frontend/src/types.ts
Normal file
37
src/web/frontend/src/types.ts
Normal file
|
|
@ -0,0 +1,37 @@
|
|||
// FABRIC Web Frontend Types
|
||||
|
||||
export interface LogEvent {
|
||||
timestamp: string;
|
||||
level: 'debug' | 'info' | 'warn' | 'error';
|
||||
worker: string;
|
||||
tool?: string;
|
||||
message: string;
|
||||
raw: string;
|
||||
}
|
||||
|
||||
export interface WorkerInfo {
|
||||
id: string;
|
||||
lastSeen: string;
|
||||
eventCount: number;
|
||||
status: 'active' | 'idle' | 'error';
|
||||
currentTool?: string;
|
||||
recentEvents: LogEvent[];
|
||||
hasCollision?: boolean;
|
||||
activeFiles?: string[];
|
||||
}
|
||||
|
||||
export interface FileCollision {
|
||||
path: string;
|
||||
workers: string[];
|
||||
detectedAt: string;
|
||||
isActive: boolean;
|
||||
}
|
||||
|
||||
export interface WebSocketMessage {
|
||||
type: 'init' | 'event' | 'collision';
|
||||
data: {
|
||||
workers?: WorkerInfo[];
|
||||
recentEvents?: LogEvent[];
|
||||
collisions?: FileCollision[];
|
||||
} | LogEvent | FileCollision;
|
||||
}
|
||||
20
src/web/frontend/tsconfig.json
Normal file
20
src/web/frontend/tsconfig.json
Normal file
|
|
@ -0,0 +1,20 @@
|
|||
{
|
||||
"compilerOptions": {
|
||||
"target": "ES2020",
|
||||
"useDefineForClassFields": true,
|
||||
"lib": ["ES2020", "DOM", "DOM.Iterable"],
|
||||
"module": "ESNext",
|
||||
"skipLibCheck": true,
|
||||
"moduleResolution": "bundler",
|
||||
"allowImportingTsExtensions": true,
|
||||
"resolveJsonModule": true,
|
||||
"isolatedModules": true,
|
||||
"noEmit": true,
|
||||
"jsx": "react-jsx",
|
||||
"strict": true,
|
||||
"noUnusedLocals": true,
|
||||
"noUnusedParameters": true,
|
||||
"noFallthroughCasesInSwitch": true
|
||||
},
|
||||
"include": ["src"]
|
||||
}
|
||||
5
src/web/index.ts
Normal file
5
src/web/index.ts
Normal file
|
|
@ -0,0 +1,5 @@
|
|||
/**
|
||||
* FABRIC Web Module
|
||||
*/
|
||||
|
||||
export { createWebServer, WebServer, WebServerOptions } from './server.js';
|
||||
218
src/web/server.ts
Normal file
218
src/web/server.ts
Normal file
|
|
@ -0,0 +1,218 @@
|
|||
/**
|
||||
* FABRIC Web Server
|
||||
*
|
||||
* Express HTTP server with WebSocket support for real-time updates.
|
||||
*/
|
||||
|
||||
import express, { Express, Request, Response } from 'express';
|
||||
import { createServer, Server as HttpServer } from 'http';
|
||||
import { EventEmitter } from 'events';
|
||||
import { join, dirname } from 'path';
|
||||
import { fileURLToPath } from 'url';
|
||||
import { WebSocketServer, WebSocket } from 'ws';
|
||||
import { LogEvent, EventFilter } from '../types.js';
|
||||
import { InMemoryEventStore } from '../store.js';
|
||||
|
||||
const __dirname = dirname(fileURLToPath(import.meta.url));
|
||||
|
||||
export interface WebServerOptions {
|
||||
port: number;
|
||||
logPath: string;
|
||||
store: InMemoryEventStore;
|
||||
}
|
||||
|
||||
export interface WebServer extends EventEmitter {
|
||||
start(): void;
|
||||
stop(): void;
|
||||
getPort(): number;
|
||||
broadcast(event: LogEvent): void;
|
||||
broadcastCollisions(): void;
|
||||
}
|
||||
|
||||
/**
|
||||
* Create the FABRIC web server
|
||||
*/
|
||||
export function createWebServer(options: WebServerOptions): WebServer {
|
||||
const { port, logPath, store } = options;
|
||||
const emitter = new EventEmitter();
|
||||
|
||||
let app: Express;
|
||||
let httpServer: HttpServer;
|
||||
let wsServer: WebSocketServer;
|
||||
let running = false;
|
||||
const clients: Set<WebSocket> = new Set();
|
||||
|
||||
function start() {
|
||||
if (running) return;
|
||||
|
||||
app = express();
|
||||
httpServer = createServer(app);
|
||||
wsServer = new WebSocketServer({ server: httpServer });
|
||||
|
||||
// WebSocket connection handling
|
||||
wsServer.on('connection', (ws: WebSocket) => {
|
||||
clients.add(ws);
|
||||
console.log(`WebSocket client connected (${clients.size} total)`);
|
||||
|
||||
// Send initial state
|
||||
ws.send(JSON.stringify({
|
||||
type: 'init',
|
||||
data: {
|
||||
workers: store.getWorkers(),
|
||||
recentEvents: store.query().slice(-50),
|
||||
collisions: store.getCollisions()
|
||||
}
|
||||
}));
|
||||
|
||||
ws.on('close', () => {
|
||||
clients.delete(ws);
|
||||
console.log(`WebSocket client disconnected (${clients.size} total)`);
|
||||
});
|
||||
|
||||
ws.on('error', (err) => {
|
||||
console.error('WebSocket error:', err.message);
|
||||
clients.delete(ws);
|
||||
});
|
||||
});
|
||||
|
||||
// Health check endpoint
|
||||
app.get('/api/health', (_req: Request, res: Response) => {
|
||||
res.json({ status: 'ok', storeSize: store.size });
|
||||
});
|
||||
|
||||
// Get all workers
|
||||
app.get('/api/workers', (_req: Request, res: Response) => {
|
||||
const workers = store.getWorkers();
|
||||
res.json(workers);
|
||||
});
|
||||
|
||||
// Get recent events
|
||||
app.get('/api/events', (req: Request, res: Response) => {
|
||||
const limit = parseInt(req.query.limit as string) || 100;
|
||||
const workerId = req.query.worker as string;
|
||||
const level = req.query.level as string;
|
||||
|
||||
const filter: EventFilter = {};
|
||||
if (workerId) filter.worker = workerId;
|
||||
if (level) filter.level = level as EventFilter['level'];
|
||||
|
||||
const events = store.query(filter).slice(-limit);
|
||||
res.json(events);
|
||||
});
|
||||
|
||||
// Get worker details
|
||||
app.get('/api/workers/:id', (req: Request, res: Response) => {
|
||||
const workerId = Array.isArray(req.params.id) ? req.params.id[0] : req.params.id;
|
||||
const worker = store.getWorker(workerId);
|
||||
if (!worker) {
|
||||
res.status(404).json({ error: 'Worker not found' });
|
||||
return;
|
||||
}
|
||||
res.json(worker);
|
||||
});
|
||||
|
||||
// Get active collisions
|
||||
app.get('/api/collisions', (_req: Request, res: Response) => {
|
||||
const collisions = store.getCollisions();
|
||||
res.json(collisions);
|
||||
});
|
||||
|
||||
// Get collisions for specific worker
|
||||
app.get('/api/workers/:id/collisions', (req: Request, res: Response) => {
|
||||
const workerId = Array.isArray(req.params.id) ? req.params.id[0] : req.params.id;
|
||||
const collisions = store.getWorkerCollisions(workerId);
|
||||
res.json(collisions);
|
||||
});
|
||||
|
||||
// Serve static frontend files
|
||||
const staticPath = join(__dirname, '..', 'web');
|
||||
app.use(express.static(staticPath));
|
||||
|
||||
// Fallback to index.html for SPA routing
|
||||
app.use((_req: Request, res: Response) => {
|
||||
res.sendFile(join(staticPath, 'index.html'), (err) => {
|
||||
if (err) {
|
||||
res.status(404).send(`
|
||||
<!DOCTYPE html>
|
||||
<html>
|
||||
<head><title>FABRIC</title></head>
|
||||
<body>
|
||||
<h1>FABRIC Web Dashboard</h1>
|
||||
<p>Frontend not built. Run <code>npm run build:web</code> first.</p>
|
||||
<h2>API Endpoints</h2>
|
||||
<ul>
|
||||
<li><a href="/api/health">/api/health</a> - Health check</li>
|
||||
<li><a href="/api/workers">/api/workers</a> - List workers</li>
|
||||
<li><a href="/api/events">/api/events</a> - Recent events</li>
|
||||
</ul>
|
||||
</body>
|
||||
</html>
|
||||
`);
|
||||
}
|
||||
});
|
||||
});
|
||||
|
||||
httpServer.listen(port, () => {
|
||||
running = true;
|
||||
console.log(`FABRIC Web Dashboard running at http://localhost:${port}`);
|
||||
console.log(`API: http://localhost:${port}/api/`);
|
||||
console.log(`Watching: ${logPath}`);
|
||||
console.log('Press Ctrl+C to stop');
|
||||
emitter.emit('start');
|
||||
});
|
||||
|
||||
httpServer.on('error', (err) => {
|
||||
emitter.emit('error', err);
|
||||
});
|
||||
}
|
||||
|
||||
function stop() {
|
||||
if (!running || !httpServer) return;
|
||||
|
||||
// Close all WebSocket connections
|
||||
for (const client of clients) {
|
||||
client.close();
|
||||
}
|
||||
clients.clear();
|
||||
|
||||
wsServer.close(() => {
|
||||
httpServer.close(() => {
|
||||
running = false;
|
||||
emitter.emit('stop');
|
||||
});
|
||||
});
|
||||
}
|
||||
|
||||
function getPort(): number {
|
||||
return port;
|
||||
}
|
||||
|
||||
function broadcast(event: LogEvent): void {
|
||||
const message = JSON.stringify({ type: 'event', data: event });
|
||||
for (const client of clients) {
|
||||
if (client.readyState === WebSocket.OPEN) {
|
||||
client.send(message);
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
function broadcastCollisions(): void {
|
||||
const collisions = store.getCollisions();
|
||||
const message = JSON.stringify({
|
||||
type: 'collision',
|
||||
data: {
|
||||
collisions,
|
||||
workers: store.getWorkers()
|
||||
}
|
||||
});
|
||||
for (const client of clients) {
|
||||
if (client.readyState === WebSocket.OPEN) {
|
||||
client.send(message);
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
return Object.assign(emitter, { start, stop, getPort, broadcast, broadcastCollisions });
|
||||
}
|
||||
|
||||
export default createWebServer;
|
||||
|
|
@ -17,5 +17,5 @@
|
|||
"incremental": true
|
||||
},
|
||||
"include": ["src/**/*"],
|
||||
"exclude": ["node_modules", "dist"]
|
||||
"exclude": ["node_modules", "dist", "src/web/frontend"]
|
||||
}
|
||||
|
|
|
|||
File diff suppressed because one or more lines are too long
21
vite.config.ts
Normal file
21
vite.config.ts
Normal file
|
|
@ -0,0 +1,21 @@
|
|||
import { defineConfig } from 'vite';
|
||||
import react from '@vitejs/plugin-react';
|
||||
|
||||
export default defineConfig({
|
||||
plugins: [react()],
|
||||
root: 'src/web/frontend',
|
||||
build: {
|
||||
outDir: '../../../dist/web',
|
||||
emptyOutDir: true,
|
||||
},
|
||||
server: {
|
||||
port: 5173,
|
||||
proxy: {
|
||||
'/api': 'http://localhost:3000',
|
||||
'/ws': {
|
||||
target: 'ws://localhost:3000',
|
||||
ws: true,
|
||||
},
|
||||
},
|
||||
},
|
||||
});
|
||||
7
vitest.config.ts
Normal file
7
vitest.config.ts
Normal file
|
|
@ -0,0 +1,7 @@
|
|||
import { defineConfig } from 'vitest/config';
|
||||
|
||||
export default defineConfig({
|
||||
test: {
|
||||
exclude: ['node_modules', 'dist', 'src/web/frontend/**'],
|
||||
},
|
||||
});
|
||||
Loading…
Add table
Reference in a new issue