- Add BUILDING, DISPATCHING, EXECUTING, HANDLING, LOGGING, EXHAUSTED_IDLE states
- These represent the inner loop of bead execution, all map to WORKING display
- DirectoryTailer now re-reads files modified within 4 hours from start on startup
This reconstructs worker state after FABRIC restart without replaying ancient history
- Update VALID_TRANSITIONS to include new state transitions
- Update color/icon mappings for new states
- Add currentBead: null to all WorkerInfo test fixtures (8 files)
- Add missing required fields to SemanticNarrative test fixtures
- accomplishments, challenges, sentiment, stats, generatedAt, isLive
- Add missing workerId and events to NarrativeSegment fixtures
- Fix onSelectCallback mock type assertion
- Add Record<string, string> index signature to mockBeadsData
All npx tsc --noEmit errors resolved. Test failures (6) remain
and are tracked in separate bead bf-40cu.
Closes: bf-7x4z
All Phase 9 items verified as implemented:
- beadsCompleted fires on bead.released/release_success
- currentBead field tracks active bead per worker
- Fleet summary bar shows real-time fleet state
- Worker cards show beadsCompleted + currentBead (removed eventCount)
- Worker sort by state (WORKING > SELECTING > EXHAUSTED)
- Test worker filter with hideTestWorkers toggle
- Productivity panel with daily throughput chart + worker leaderboard
- Bead workspace scanner reads .beads/issues.jsonl for project breakdown
- GET /api/productivity endpoint returns all productivity data
Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
Use vi.hoisted() to declare mock classes before the factory runs,
preventing "Cannot access X before initialization" errors that occur
when vitest hoists vi.mock() calls but the factory captures references
to variables not yet initialized.
Fixes errors in:
- src/tui/components/CrossReferencePanel.test.ts (MockCrossReferenceManager)
- src/tui/components/WorkerAnalyticsPanel.test.ts (MockWorkerAnalytics)
Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
Fix mock hoisting issues in CrossReferencePanel and WorkerAnalyticsPanel test files by:
- Defining mock classes entirely inline within vi.mock() factory functions
- Removing references to external consts that were causing "Cannot access before initialization" errors
- Simplifying getMockFunctions() helper to use the already-imported mocked constructor
The vitest hoisting mechanism moves vi.mock() calls to the top of the file before regular variable declarations, so any consts referenced in the mock factory must also be defined inside the factory or via vi.hoisted(). The simplest fix is to define everything inline.
Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
Fix "Cannot access before initialization" errors in:
- CrossReferencePanel.test.ts
- WorkerAnalyticsPanel.test.ts
Root cause: vi.mock() factory functions referenced variables declared
outside the factory via vi.hoisted(), but vitest hoists vi.mock()
calls to the top of the file before variable initialization.
Solution: Define all mock implementations inline within the
vi.mock() factory functions, removing external variable references.
Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
The vi.mock() callback was capturing mockManagerInstance at module
load time when it was undefined. Fixed by:
1. Changing mock to vi.fn() without return value
2. Adding mockReturnValue(mockManagerInstance) in beforeEach
This ensures the mock returns the properly configured instance when
getSemanticNarrativeManager() is called during panel construction.
Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
Fixed 3 failing tests by correcting the mock setup:
- Moved mock function initialization from module-level to beforeEach
- This ensures fresh mock functions for each test run
- Added stub implementations for all interface methods
- Fixed mock manager instance creation per test
Tests now passing:
- "should refresh narrative from manager"
- "should generate narrative for worker and set it"
- "should generate aggregated narrative and set it"
The issue was that mock functions were defined globally at module
load time, causing them to be stale between test runs. Tests were
setting return values on stale function references, so mock calls
weren't being tracked properly.
Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
Fixed the mock setup for the SemanticNarrativeManager to properly
allow mockReturnValue() to work on the manager methods.
The issue was that the mock class methods were defined as class
properties with vi.fn(() => null), which created new instances for
each test run. By defining the mock functions as module-level
variables and assigning them to the class methods, we ensure that
the same vi.fn() instances are used throughout, allowing tests to
properly configure return values with mockReturnValue().
This fixes 3 failing tests:
- "should refresh narrative from manager"
- "should generate narrative for worker and set it"
- "should generate aggregated narrative and set it"
Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
- Make render() public so tests can call it directly without casting
- Change hide() to call this.render() instead of this.box.screen.render() directly
- This makes hide() consistent with show() and improves test compatibility
These changes address test failures in FileContextPanel.test.ts where:
- Tests call (panel as any).render() directly
- Tests expect mainBoxInstance.screen.render to be called after show/hide
Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
The original mock returned the same instance for all blessed.box() calls,
but the implementation creates 4 separate boxes (main, fileInfo, fileContent,
fileHistory). This caused tests to fail because they couldn't distinguish
which methods were called on which elements.
Changes:
- Make the mock return a new instance for each blessed.box() call
- Track all mock instances in a mockBoxes array
- Keep mainBoxInstance reference for tests that need the primary box
- Fix test expecting setContent on main box to use mockBoxes[1] (fileInfo)
All 57 FileContextPanel tests now pass.
Fixed test setup to correctly capture the mock instances that were
actually used during CommandPalette construction. The previous
approach of re-calling blessedMock.box() after clearing mocks
resulted in checking different mock instances than those used by
the actual palette object.
Changed from:
- Calling blessedMock.box() after construction (different instances)
To:
- Accessing blessedMock.box.mock.results[0]?.value (same instances)
This ensures tests correctly verify the behavior of the actual
CommandPalette instance, not mock instances that were never used
by the palette.
Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
Fix CrossReferencePanel.test.ts and WorkerAnalyticsPanel.test.ts
which failed to load due to vi.mock() hoisting issues.
The vi.mock() factory functions referenced variables declared after
the mock call. When vitest hoists these mocks to the top of the
file, those variables weren't initialized yet, causing
"Cannot access before initialization" errors.
Solution: Use vi.hoisted() to declare mock variables before the
factory runs, ensuring they're available when the mock is evaluated.
Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
Fixed test mocks to include required fields added to SemanticNarrative type:
- workerId: required string field
- events: array field for narrative events
- startTime, endTime, durationMs: temporal fields
Also fixed store.ts to handle potential undefined avgModificationInterval.
All 2399 unit tests pass (4 skipped).
Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
Verified all implementation gaps from the genesis bead checklist are complete:
- memoryProfiler.ts: Fully implemented with snapshot tracking and V8 heap dumps
- FileHeatmap treemap + timelapse: Both views fully implemented with playback controls
- SpanDag zoom/pan: Fully implemented with wheel zoom and drag-to-pan
All 2399 tests pass (4 skipped).
Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
Add comprehensive tests for the worker count badge feature that
displays active/idle/error worker counts in the TUI header.
Tests verify:
- Badge displays with active workers
- Mixed status badges (active, idle, error)
- Real-time updates as workers join/leave
- Filter indicator display
- Graceful handling of no workers
Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
The hot reload functionality for workers.log was already implemented
in src/cli.ts (lines 152-179). This commit adds comprehensive tests
to verify the behavior.
Key findings:
- workers.log is monitored via LogTailer when it exists at TUI startup
- New events are parsed and added to store/TUI in real-time
- CLI filters are applied correctly
- Deduplication works for canonical NeedleEvents (sequence >= 0)
- Legacy events (sequence < 0) cannot be deduplicated
Known limitations:
- If workers.log doesn't exist at TUI startup, it won't be watched
- File rotation is handled but may have edge cases
Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
Add comprehensive export/import functionality for session replay in both TUI and web UI:
- TUI: Add keyboard shortcuts [e] export file, [E] export base64, [m] export markdown, [i] import
- Web UI: Add export dropdown with JSON, Markdown, and shareable link options
- Web UI: Add "Import from URL" option for loading replay data
- Auto-import from URL parameters on page load for shared links
Export formats:
- JSON (.fabric-replay): Full event data with metadata
- Markdown (.md): Human-readable session summary with tables
- Base64 URL: Shareable link for collaboration
Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
Add side-by-side worker comparison analytics to the TUI analytics panel.
Users can now press 'c' to enter comparison mode and view detailed metrics
comparing two workers across performance, error, cost, and efficiency dimensions.
- Add WorkerComparison type with differences, percent differences, and winner per metric
- Add compareWorkers() method to WorkerAnalytics class
- Extend WorkerAnalyticsPanel with comparison view mode
- Add renderComparison() method with formatted comparison rows
- Add keyboard bindings: [c] toggle comparison, [↑/↓] cycle workers, [←/→] swap selection
Related to docs/plan.md Worker Comparison Analytics section.
Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
Add missing commands to TUI command palette as listed in docs/plan.md:
- worker:<id> - Jump to worker detail view
- bead:<id> - Show all events for a bead (cross-reference view)
- file:<pattern> - Show all operations on matching files
- filter:last:<duration> - Filter to last N minutes (e.g., 5m, 1h)
- goto:<timestamp> - Jump to specific timestamp in activity stream
- export - Export current view to .fabric-replay file
- export:link - Generate shareable base64 link
- export:import - Import replay file
Also added support methods in ActivityStream:
- setTimeFilter() for time-based filtering
- scrollToTimestamp() for timestamp navigation
- Enhanced setFilter() to support beadId and filePattern
Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
Wire shared EventDeduplicator across all ingestion paths (JSONL tailer,
OTLP/gRPC receiver, OTLP/HTTP receiver) so duplicate events from dual
ingestion are silently dropped on (session_id, worker_id, sequence).
Also adds docs/needle-exporter-wiring.md (OTLP configuration guide for
NEEDLE), SpanDag React component, EventFilter.eventType field, and
various test/layout fixes.
Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
Replace coarse NeedleWorkerStatus ('idle'|'executing'|'draining'|'starting')
with the real NEEDLE state machine: BOOTING→SELECTING→CLAIMING→WORKING→CLOSING→STOPPED.
- Add NeedleState type, VALID_TRANSITIONS map, needleStateToStatus() helper in types.ts
- Track needleState + lastStateTransition per worker by consuming worker.state_transition events
- Surface all six states in TUI worker cards (WorkerGrid, WorkerDetail) with per-state icons/colors
- Surface all six states in web WorkerGrid.tsx with NEEDLE_STATE_LABELS and NEEDLE_STATE_COLORS
- Add getNeedleStateColor/getNeedleStateIcon to colors.ts
- Rewire stuck detection to fire on state-transition gaps (state_gap pattern in stuckDetection.ts)
- Add sequence-based event ordering via compareEventsBySequence and queryOrdered()
- Legacy event-type fallback preserved for workers not emitting state_transition events
Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
- Add state_gap stuck detection using lastStateTransition — fires when
a worker in an active NeedleState hasn't transitioned within the
configurable threshold (default 5min, critical at 2x).
- Update web WorkerDetail.tsx to display needleState with icons and
colors instead of coarse active/idle/error status.
- Add stuckDetection.test.ts with 16 tests covering gap-based detection,
legacy patterns, and edge cases.
Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
Adds Budget panel (B key) to TUI with per-bead/per-worker cost tracking,
EMA-smoothed burn rate, time-series storage, and CostDashboard web component.
Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
The header now displays a live badge showing worker counts by status:
- Green for active workers
- Blue for idle workers
- Red for error workers
Example: "FABRIC - Worker Activity Monitor [2 active | 1 idle]"
Changes:
- getWorkerStats() calculates total/active/idle/error counts
- getHeaderContent() builds colored badge with status breakdown
- updateHeader() refreshes the badge in default view
- Added updateHeader() call in addEvent() for real-time updates
- Fixed setViewMode() to use getHeaderContent() when returning to default view
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Verify WorkerDetail displays correct worker information including status
(active/idle/error), uptime formatting, beads completed count, last
activity details (bead, tool, duration, error), and recent events with
proper color tags and truncation.
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Create vitest E2E test that verifies WorkerGrid component renders
worker entries with correct status colors:
- Green (light-green-fg) for active workers
- Yellow (light-yellow-fg) for idle workers
- Red (light-red-fg) for error workers
The test mocks blessed screen and verifies the content contains
appropriate color tags matching the theme system's status colors.
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Wrap os.homedir() in try/catch and guard against undefined return value
in ThemeManager.getConfigPath(). In CI environments, os.homedir() may be
undefined, causing path.join() to throw and preventing SessionReplay
from being constructed. When homedir is unavailable, theme persistence
is gracefully skipped and the default dark theme is used.
Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
- Add scripts/fabric-web.sh for managing FABRIC web server as tmux session
- Supports start/stop/restart/status/logs commands
- Auto-restarts on crash via tmux session management
- Configurable via FABRIC_PORT and FABRIC_LOG_PATH env vars
- Fix TypeScript build error in CommandPalette.test.ts
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
- Integrate fuzzyMatch utility for fzf-style fuzzy matching on label, category, and action fields
- Highlight matching characters in yellow using blessed tags
- Add recent commands history (last 10), persisted to ~/.fabric/recent-commands.json
- Boost recently-used commands in fuzzy search scoring
- Show recent commands first when no query is entered
- Arrow key navigation with wrapping (pre-existing)
- Add comprehensive test suite (13 tests)
Co-Authored-By: Claude Worker <noreply@anthropic.com>
Verified and closed bd-2u6 - FileContextPanel is fully implemented for both TUI and Web:
Features:
- Split view: Activity (left) | File Context (right)
- Auto-update when file event selected
- Syntax highlighting based on file extension (TS, JS, Python, Rust, Go, etc.)
- Line numbers with highlight on relevant lines
- Sticky panel - stays visible while scrolling activity
- File history: see all operations on this file
- Quick toggle between recently touched files ([/]/[] keys)
- 'Open in Editor' button (launches configured editor)
TUI Layout:
- Ctrl+F to toggle file context panel
- { and } to resize split view
- Tab to switch focus between panels
Web Layout:
- Collapsible side panel with toggle button
- Resizable divider
- Pop out to separate window
Editor Integration:
- Uses $EDITOR env var
- Supports VS Code, vim, nano, etc.
- Opens at specific line number
🤖 Generated with [Claude Code](https://claude.ai/code)
Co-Authored-By: Claude Worker <noreply@anthropic.com>
Implements save/load/delete functionality for focus mode pin configurations:
**TUI Changes:**
- [ key to save current focus configuration as named preset
- ] key to cycle through saved presets
- Preset commands in CommandPalette (Ctrl+K):
- preset:save - Save current focus
- preset:list - List all presets
- preset:load:<name> - Load a specific preset
- preset:delete:<name> - Delete a preset
- Presets stored in ~/.fabric/focus-presets.json
- Updated help text with new keybindings
**Web Changes:**
- Preset dropdown in header with save/load/delete UI
- Modal dialog for saving new presets
- Presets stored in localStorage
- Styled with CSS matching existing UI
**Core:**
- FocusPresetManager utility class for preset CRUD operations
- Storage abstraction (Memory, LocalStorage, File-based)
- Full test coverage for preset management
🤖 Generated with [Claude Code](https://claude.ai/code)
Co-Authored-By: Claude Worker <noreply@anthropic.com>
Add PR preview functionality to the Git Integration panel:
- Generate PR title from commit messages
- Auto-generate PR description with file changes summary
- Generate commit message preview from activity
- List files changed with +/lines count
- Detect potential conflicts with upstream
- Rebase recommendation when conflicts detected
- New keyboard shortcuts: [p] Preview PR, [d] Diff, [s] Status
- PRPreview type with conflict detection and file stats
🤖 Generated with [Claude Code](https://claude.ai/code)
Co-Authored-By: Claude <noreply@anthropic.com>
Add export/import functionality for session replay:
**Export Features:**
- Export as shareable link (base64 encoded events in URL parameter)
- Export as .fabric-replay file (JSON format)
- Share button in replay controls with dropdown menu
**Import Features:**
- Import from .fabric-replay file via file picker
- Import from URL parameter (?replay=base64EncodedEvents)
- Automatic detection and loading of replay data from URL
**Implementation:**
- src/utils/replayExport.ts: Core export/import utilities for Node.js
- src/web/frontend/src/utils/replayExport.ts: Browser-specific utilities
- Updated web SessionReplay.tsx with export dropdown and status messages
- Updated TUI SessionReplay.ts with exportToFile/importFromFile methods
- Added session replay panel to App.tsx with URL parameter support
- Added CSS styles for export dropdown, status messages, and replay panel
**Export Format:**
```json
{
"version": "1.0",
"exportedAt": 1709337600,
"eventCount": 150,
"events": [...],
"metadata": {
"sessionStart": 1709337000,
"sessionEnd": 1709337600,
"workerCount": 3
}
}
```
🤖 Generated with [Claude Code](https://claude.ai/code)
Co-Authored-By: Claude <noreply@anthropic.com>
## TUI Theme Support
- Create ThemeManager class with dark/light theme palettes
- Update colors.ts to use theme system via proxy pattern
- Add Ctrl+T keybinding for theme toggle
- Add theme commands to CommandPalette (theme:toggle, theme:dark, theme:light)
- Persist theme preference to ~/.fabric/theme.json
- Update footer to show current theme
## Web Dashboard Theme Support
- Create ThemeContext with React context API
- Add light theme CSS variables (data-theme="light")
- Add ThemeToggle button to header
- Persist theme preference to localStorage
- Support system color scheme preference detection
🤖 Generated with [Claude Code](https://claude.ai/code)
Co-Authored-By: Claude Worker <noreply@anthropic.com>
Implements persistent storage for historical session analytics:
- Add HistoricalStore class using better-sqlite3
- Schema includes sessions, task_metrics, and error_history tables
- Session management: start/end sessions with worker/task/cost metrics
- Task metrics: record per-bead completion times, costs, tokens
- Error history: track errors with resolution status
- Historical queries: worker comparison across sessions
- Learned recoveries: extract patterns from historical error resolutions
- Integration with EventStore for automatic session persistence
- Historical query methods in WorkerAnalytics
- Enhanced recovery suggestions using historical data in RecoveryManager
- Comprehensive unit tests (20 passing tests)
Database stored at ~/.needle/fabric.db for cross-session persistence.
🤖 Generated with [Claude Code](https://claude.ai/code)
Co-Authored-By: Claude Worker <noreply@anthropic.com>
Previously Escape only handled view mode changes. Now it first checks
if the WorkerDetail modal is visible and closes it before returning
to the default view.
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
Added comprehensive E2E test suite for WorkerDetail component with 39 test cases covering:
- Worker status display (active, idle, error)
- Event count and current tool display
- Last seen timestamp formatting
- Recent events list rendering
- Collision alert display
- Current activity section
- CSS classes and accessibility features
- Edge cases and error handling
All tests passing.
Co-Authored-By: Claude Worker <noreply@anthropic.com>
Comprehensive E2E test suite covering:
- Chronological order display (100+ events)
- Timestamp formatting and display
- Level colors for debug/info/warn/error
- Scrolling behavior with maxLines buffer
- Filtering by worker, level, search term, time range
- Pause/resume workflow
- High volume event handling (1000+ events)
All 36 tests passing.
Co-Authored-By: Claude Worker <noreply@anthropic.com>
- Replaced basic terminal colors with light/bright variants for better visibility
- Changed gray to light-black for consistent muting across terminal themes
- Changed backgrounds from black to 'default' for light theme compatibility
- Updated text colors to light-white, light-cyan, etc. for better contrast
- All status indicators (active, idle, error) now use light variants
- Heat levels use progressive light colors for better differentiation
- Updated tests to expect new light-green-fg, light-yellow-fg, light-red-fg tags
The new color scheme provides better contrast and readability in both
light and dark terminal themes by using blessed's light color variants
and avoiding hard-coded black/white backgrounds.
Co-Authored-By: Claude Worker <noreply@anthropic.com>
- Created comprehensive regression test suite with 73 new tests
- Test coverage includes:
- Component integration and coordination
- View mode transitions (heatmap, DAG, replay, errors, etc.)
- Focus mode behavior with worker/bead pinning
- Keyboard navigation and bindings
- Command palette integration
- Error handling and edge cases
- Performance and resource management
- State consistency across renders
- Rendered output format validation
All 1213 tests pass (3 skipped), verifying no regressions in TUI functionality.
Co-Authored-By: Claude Worker <noreply@anthropic.com>
Created comprehensive E2E test verifying LogTailer and ActivityStream integration:
- Tests real-time log file tailing with file system changes
- Verifies new events appended to log file appear in ActivityStream
- Tests sequential and bulk event appending
- Validates NEEDLE format event parsing
- Tests pause/resume functionality
- Includes error handling for malformed JSON and empty lines
- Tests initial content loading and cleanup
All 13 E2E tests pass successfully.
Co-Authored-By: Claude Worker <noreply@anthropic.com>
Added vitest test to verify WorkerGrid component renders worker entries with correct status colors (green for active, yellow for idle, red for error). Test verifies blessed color tags are present in rendered content.
Co-Authored-By: Claude Worker <noreply@anthropic.com>
Added `tags: true` to all blessed.box and blessed.log elements to enable
processing of blessed markup tags like {bold}, {gray-fg}, {blue-fg}, etc.
Without this option, blessed displays the tags as literal text instead
of rendering them as terminal colors and styles.
Components fixed:
- ActivityStream, CollisionAlert, CommandPalette, CrossReferencePanel
- DependencyDag, DiffView, FileHeatmap, FilterPanel
- SemanticNarrativePanel, SessionReplay, WorkerAnalyticsPanel
- WorkerDetail, WorkerGrid, app.ts
Also adds beads for frankentui migration with proper dependency chain:
- Implementation tasks (Rust workspace, types, parser, widgets)
- E2E tests blocked by their respective implementations
- Regression suite blocked by all widget implementations
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
