jedarden/FABRIC
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions
FABRIC (moved from ex44; canonical on git.ardenone.com, mirrors to github.com/jedarden)
302 commits 1 branch 0 tags 24 MiB
TypeScript 93.3%
CSS 5.1%
JavaScript 0.9%
Shell 0.7%
Find a file
jedarden 46c51a79c3 feat: add budget dashboard with per-bead cost tracking and EMA burn rate 
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>
2026-03-21 01:14:14 -04:00
.beads fix(bd-188): Close worker starvation false positive alert 2026-03-11 07:05:43 +00:00
.github/workflows feat: Add GitHub Actions CI and release workflows 2026-03-04 21:37:01 +00:00
bin feat: initialize FABRIC TypeScript project 2026-03-03 04:41:00 +00:00
docs feat(bd-muv): Gap analysis: Compare implementation against plan.md and create beads for missing features 2026-03-07 03:47:50 +00:00
e2e test: add Playwright E2E tests for web dashboard 2026-03-05 05:14:24 +00:00
scripts feat(bd-288): Add systemd service for persistent FABRIC web server 2026-03-16 23:51:07 -04:00
src feat: add budget dashboard with per-bead cost tracking and EMA burn rate 2026-03-21 01:14:14 -04:00
test-results feat(bd-2u6): File Context Panel (Split View) implementation 2026-03-07 12:24:28 +00:00
.gitignore feat: initialize FABRIC TypeScript project 2026-03-03 04:41:00 +00:00
package-lock.json feat(bd-art): SQLite Historical Analytics Storage 2026-03-07 04:18:45 +00:00
package.json feat: add budget dashboard with per-bead cost tracking and EMA burn rate 2026-03-21 01:14:14 -04:00
playwright.config.ts test: add Playwright E2E tests for web dashboard 2026-03-05 05:14:24 +00:00
README.md docs: add 8 additional intelligence features (wave 2) 2026-03-02 02:52:55 +00:00
ROADMAP.md chore(bd-yxm): close starvation alert - false positive detected 2026-03-05 00:55:27 +00:00
SESSION_REPLAY_SUMMARY.md docs(bd-3k9): add session replay implementation summary 2026-03-04 03:21:41 +00:00
tsconfig.json feat(bd-3jl): FileHeatmap integration complete + build fixes 2026-03-04 04:18:13 +00:00
tsconfig.tsbuildinfo feat: add budget dashboard with per-bead cost tracking and EMA burn rate 2026-03-21 01:14:14 -04:00
vite.config.ts feat: add budget dashboard with per-bead cost tracking and EMA burn rate 2026-03-21 01:14:14 -04:00
vitest.config.ts feat(bd-3jl): FileHeatmap integration complete + build fixes 2026-03-04 04:18:13 +00:00

README.md

FABRIC

Flow Analysis & Bead Reporting Interface Console

A live display for NEEDLE worker activity, available as TUI or web dashboard.

Purpose

FABRIC tails NEEDLE's logging output and renders it in real-time. It answers:

  • What is each worker doing right now?
  • What events are happening across all workers?
  • Which workers are active, idle, or erroring?
  • Is any worker stuck or looping?
  • Are workers colliding on the same files?
  • How much is this costing?

Display Modes

TUI (fabric tui)

Live terminal dashboard:

  • Worker status grid
  • Scrolling log stream
  • Worker detail panel
  • Keyboard navigation and filtering

Web (fabric web)

Live browser dashboard at localhost:3000:

  • Worker overview cards
  • Real-time activity feed
  • Timeline visualization
  • WebSocket-powered updates

Quick Start

# Terminal dashboard
fabric tui

# Web dashboard
fabric web

FABRIC reads from ~/.needle/logs/ by default.

Intelligence Features

Beyond simple log display, FABRIC provides:

Feature Description
Stuck & Loop Detection Automatic alerts when workers spin their wheels
Inline Diff View See actual code changes, not just "Edit was called"
Cross-Reference Links Click any bead, file, or worker to navigate
Collision Detection Know when workers edit the same files
Session Replay Scrub through past sessions like a video
Smart Error Grouping Errors with context, not scattered through logs
Command Palette Ctrl+K for universal search and commands
Cost Tracking Real-time token usage and budget alerts
Task Dependency DAG Visual graph of task relationships
File Heatmap See where all the action is at a glance
Conversation Transcript See the full Claude conversation, not just tool calls
Semantic Narrative Natural language summary of what workers are doing
AI Session Digest Auto-generated session summaries for stakeholders
File Context Panel See file contents alongside activity stream
Git Integration Live git status, diff preview, conflict detection
Worker Analytics Compare worker performance over time
Recovery Playbook Suggestions based on similar past errors
Focus Mode Pin workers/tasks, hide everything else

Relationship to NEEDLE

NEEDLE (orchestrates workers) → logs → FABRIC (displays + analyzes)

NEEDLE does the work. FABRIC shows you what's happening and helps you understand it.

Status

🚧 In Development - See docs/plan.md for implementation roadmap.

Documentation