Commit graph

11 commits

Author SHA1 Message Date
jedarden
91d0896797 docs(bd-0nd): update plan.md and README to reflect directory-tailing behavior
Mark all Phase 8 checklist items complete (bd-0nd.1–4 closed).
Clarify README: FABRIC watches the directory and tails every *.jsonl,
not a single workers.log file.

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
2026-04-22 16:37:59 -04:00
jeda
43079b35ca docs: add SQLite storage for Worker Analytics and Recovery Playbook
- SQLite file at ~/.needle/fabric.db for historical data
- Schema: sessions, task_metrics, error_history tables
- Data written on session close, not real-time
- Supports Worker Analytics and Recovery Playbook features
- Updated non-goals to clarify storage model

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-03-02 03:05:46 +00:00
jeda
9ab1e3a407 docs: add 8 additional intelligence features (wave 2)
New features added:
- Conversation Transcript View: see full Claude prompts/responses
- Semantic Activity Narrative: natural language status updates
- AI Session Digest: auto-generated session summaries
- File Context Panel: see file contents alongside activity
- Git Integration Panel: live git status and conflict detection
- Worker Comparison Analytics: performance tracking over time
- Recovery Playbook: suggestions from similar past errors
- Focus Mode with Pinning: filter to specific workers/tasks

Updated implementation phases to 7 phases covering all 18 features.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-03-02 02:52:55 +00:00
jeda
42e8cb9226 docs: add 10 intelligence features with mockups
1. Stuck & Loop Detection - catch spinning workers
2. Live Inline Diff View - see actual code changes
3. Cross-Reference Hyperlinking - navigate by clicking entities
4. Worker Collision Detection - prevent conflicts early
5. Session Replay - scrub through past sessions
6. Smart Error Grouping - contextualized error analysis
7. Command Palette (Ctrl+K) - universal search/command interface
8. Cost & Token Tracking - budget awareness and projections
9. Task Dependency DAG - visualize task relationships
10. File Activity Heatmap - see where work is happening

Updated implementation phases to include all features.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-03-02 02:43:37 +00:00
jeda
9f14a6b226 docs: add TUI and web dashboard mockups
ASCII mockups showing:
- TUI main view with worker grid and activity stream
- TUI worker detail view with focused log
- Web dashboard with worker cards, activity feed, and timeline
- Web worker detail modal

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-03-02 02:35:55 +00:00
jeda
88ee6a4cf5 docs: FABRIC is a live display, not a report generator
- Remove static HTML report generation concept
- TUI and web modes are both live, real-time displays
- Add 'fabric web' command for browser dashboard
- Emphasize tail-style log watching and WebSocket updates
- Simplify README to focus on live display purpose

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-03-02 02:28:51 +00:00
jeda
433881aa30 docs: align with actual ~/.needle/ structure
Verified NEEDLE outputs to ~/.needle/logs/. Updated plan to match
actual folder structure (config.yaml, logs/, state/, cache/).

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-03-02 02:01:41 +00:00
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
jeda
25ddfb6733 docs: simplify FABRIC to stateless parser/renderer
Remove storage, metrics accumulation, databases, and retention concerns.
FABRIC just reads NEEDLE output, parses it, and renders TUI or HTML.

- Add clear data flow diagram
- Define explicit non-goals
- Simplify architecture to reader → parser → renderer
- Add piping examples (needle | fabric tui)

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-03-02 01:53:50 +00:00
jeda
f164e7e253 docs: refocus FABRIC on worker visualization via logging/telemetry
- Shift focus from bead tracking to NEEDLE worker visibility
- Emphasize TUI and HTML output formats as primary deliverables
- Add CLI interface examples (fabric tui, fabric html, fabric logs)
- Define worker event data model and log format contract
- Update README to reflect worker-centric purpose

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-03-02 01:52:04 +00:00
jeda
727661e0f0 feat: initialize FABRIC (Flow Analysis & Bead Reporting Interface Console)
Add initial README and implementation plan for visualization/dashboard
system to monitor NEEDLE's bead orchestration output.

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
2026-03-02 00:58:09 +00:00