FABRIC (moved from ex44; canonical on git.ardenone.com, mirrors to github.com/jedarden)
Find a file
jeda c931f9db10 docs: use .needle/ as default source for logging artifacts
FABRIC reads from .needle/ in cwd by default, matching NEEDLE's
output location for worker logs and session data.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-03-02 01:59:49 +00:00
docs docs: use .needle/ as default source for logging artifacts 2026-03-02 01:59:49 +00:00
README.md docs: refocus FABRIC on worker visualization via logging/telemetry 2026-03-02 01:52:04 +00:00

FABRIC

Flow Analysis & Bead Reporting Interface Console

A visualization system for surfacing NEEDLE worker activity through TUI and HTML dashboards.

Purpose

FABRIC consumes logging and telemetry output from NEEDLE workers, transforming raw execution data into reviewable visualizations:

  • Flow Analysis: Visualize worker execution timelines and patterns
  • Bead Reporting: Surface what workers are doing and how they're performing
  • Interface Console: Both TUI (terminal) and HTML dashboards for review

Output Formats

TUI Dashboard

Real-time terminal interface showing:

  • Active worker status grid
  • Live log streaming with filtering
  • Worker detail views and session history
  • Keyboard-driven navigation

HTML Reports

Static and interactive browser-based views:

  • Session timeline visualizations (Gantt-style)
  • Metrics charts (API calls, tokens, duration)
  • Searchable log explorer
  • Shareable, self-contained reports

Relationship to NEEDLE

NEEDLE orchestrates workers; FABRIC surfaces their activity:

  • What is each worker currently doing?
  • How long are tasks taking?
  • What errors are occurring?
  • What's the API/token usage?
  • What does the execution timeline look like?

Status

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

Getting Started

(Coming soon)

Documentation