Commit graph

17 commits

Author SHA1 Message Date
jedarden
15d7915caf docs(plan): update status to reflect Phase 8 complete
Some checks are pending
CI / test (18.x) (push) Waiting to run
CI / test (20.x) (push) Waiting to run
CI / test (22.x) (push) Waiting to run
Phase 8 (Post-launch Fixes, bd-0nd series) was already complete but the
status line only mentioned Phases 1-7 and 9. Updated to show all phases
complete.
2026-05-26 17:35:27 -04:00
jedarden
01a7554ead docs(plan): check off completed Phases 2, 3, and 6
Some checks are pending
CI / test (18.x) (push) Waiting to run
CI / test (20.x) (push) Waiting to run
CI / test (22.x) (push) Waiting to run
- Phase 2 (TUI Display): All components implemented and tested
- Phase 3 (Web Display): All components implemented and tested
- Phase 6 (Worker Comparison Analytics): Web API + frontend complete (bf-4cqq)

Closes: bf-3pck
2026-05-26 17:32:02 -04:00
jedarden
08b1b5a473 docs(plan): check off completed Phase 4-7 items
Some checks are pending
CI / test (18.x) (push) Waiting to run
CI / test (20.x) (push) Waiting to run
CI / test (22.x) (push) Waiting to run
Updated plan.md Implementation Phases checklist to reflect completed
features in Phases 4-7 that were verified implemented in code but not
yet checked off.

Completed items now marked:
- Phase 4 (all 5): Cross-reference hyperlinking, inline diff view,
  file activity heatmap, cost & token tracking, conversation transcript
- Phase 5 (all 5): Stuck detection, loop detection, worker collision,
  smart error grouping, semantic activity narrative
- Phase 6 (3 of 4): Git integration, AI session digest, historical
  session index; worker comparison analytics web layer remains (bf-4cqq)
- Phase 7 (all 5): Session replay, task DAG, budget alerts, anomaly
  detection, recovery playbook

Updated status line to reflect Phase 6 has one remaining gap.

Closes: bf-ozsu
2026-05-26 17:24:42 -04:00
jedarden
f043cff143 docs(bf-2wf): verify Phase 9 Productivity Analytics complete
Some checks failed
CI / test (22.x) (push) Has been cancelled
CI / test (18.x) (push) Has been cancelled
CI / test (20.x) (push) Has been cancelled
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>
2026-05-22 18:02:10 -04:00
jedarden
402e9340ad docs(bf-48nk): update bead states and add Phase 9 productivity analytics plan
All implementation gaps from Phases 1-8 are closed (2418 tests passing).
Phase 9 planning added to docs/plan.md with productivity analytics design.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
Bead-Id: bf-48nk
2026-05-13 16:58:47 -04:00
jedarden
3da90f1be0 feat(bf-52d6): add conversation transcript parser module
Add standalone conversationParser module to extract full conversation
transcripts from NEEDLE logs. This completes Phase 1 Core Infrastructure
item for conversation parsing.

Implementation:
- isConversationSpanEvent(): Identify conversation-related span events
- buildConversationSessions(): Build sessions from log events
- getWorkerConversationSessions(): Filter sessions by worker
- getBeadConversationSession(): Get session for a specific bead
- extractConversationEvents(): Extract all conversation events

Types supported:
- PromptEvent: User input/prompt
- ResponseEvent: Assistant response text
- ThinkingEvent: Internal reasoning/thinking blocks
- ToolCallEvent: Tool invocations with arguments
- ToolResultEvent: Tool call results

Also updates docs/plan.md to mark Phase 1 Core Infrastructure items complete.

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
2026-05-08 14:29:12 -04:00
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