docs(bf-2wf): verify Phase 9 Productivity Analytics implementation

Verified all Phase 9 items are complete:
- currentBead field (store.ts)
- Fleet summary bar (FleetSummaryBar.tsx)
- Worker card enrichment (beadsCompleted + currentBead)
- Worker sort by state (stateSort function)
- Test worker filter (hideTestWorkers toggle)
- Productivity panel (daily throughput + worker leaderboard)
- GET /api/productivity endpoint
- Bead workspace scanner (scanBeadWorkspaces)

All components properly integrated. No code changes required.

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>

notes/bf-2wf.md

@@ -0,0 +1,88 @@
+# Phase 9: Productivity Analytics - Verification
+
+## Date
+2026-05-22
+
+## Summary
+Verified that all Phase 9 items are fully implemented in the codebase.
+
+## Items Verified
+
+### 1. currentBead Field
+- **Location**: `src/store.ts:625`
+- **Population**: Set on `bead.claim.succeeded` event (line 715)
+- **Cleared**: On `bead.released` event (line 693)
+- **Status**: ✅ Complete
+
+### 2. Fleet Summary Bar
+- **Component**: `src/web/frontend/src/components/FleetSummaryBar.tsx`
+- **Integration**: Used in `App.tsx:887`
+- **Features**:
+  - WORKING count
+  - SELECTING count
+  - EXHAUSTED count
+  - Beads completed today
+  - Stuck worker count
+- **Status**: ✅ Complete
+
+### 3. Worker Card Enrichment
+- **Location**: `src/web/frontend/src/components/WorkerGrid.tsx:157-159`
+- **Display**: Shows `beadsCompleted` and `currentBead` when WORKING
+- **Removed**: `eventCount` no longer displayed
+- **Status**: ✅ Complete
+
+### 4. Worker Sort by State
+- **Function**: `stateSort` in `WorkerGrid.tsx:48-53`
+- **Priority**: WORKING > CLAIMING > SELECTING > BOOTING > CLOSING > EXHAUSTED_IDLE > STOPPED
+- **Status**: ✅ Complete
+
+### 5. Test Worker Filter
+- **Pattern Matching**: `isTestWorker()` in `WorkerGrid.tsx:44-46`
+- **Toggle**: UI button in `App.tsx:842-848`
+- **Default**: Hidden (`hideTestWorkers = true`)
+- **Status**: ✅ Complete
+
+### 6. Productivity Panel
+- **Component**: `src/web/frontend/src/components/ProductivityPanel.tsx`
+- **Features**:
+  - Daily throughput chart (14 days)
+  - Worker leaderboard (beads completed, beads/hour)
+  - By project breakdown
+- **Status**: ✅ Complete
+
+### 7. GET /api/productivity Endpoint
+- **Location**: `src/web/server.ts:1101-1144`
+- **Response**:
+  - `daily`: Array of {date, count} for last 30 days
+  - `workers`: Array of {id, beadsCompleted, beadsPerHour}
+  - `byProject`: From `scanBeadWorkspaces()`
+- **Status**: ✅ Complete
+
+### 8. Bead Workspace Scanner
+- **Module**: `src/beadWorkspaceScanner.ts`
+- **Function**: `scanBeadWorkspaces()` returns project breakdown
+- **Config**: `src/config.ts` with `loadWorkspaces()`
+- **Data Source**: Reads `.beads/issues.jsonl` from configured workspaces
+- **Status**: ✅ Complete
+
+## Integration Points
+
+### Web UI
+- `App.tsx` imports and uses `FleetSummaryBar` (line 23, 887)
+- `App.tsx` manages `hideTestWorkers` state (line 264, 842-848, 897)
+- `WorkerGrid` receives `hideTestWorkers` prop and filters accordingly
+
+### API
+- `/api/productivity` endpoint integrates `scanBeadWorkspaces()` for project breakdown
+- Daily counts computed from in-memory `bead.released` events
+- Worker leaderboard computed from `store.getWorkers()`
+
+### Data Flow
+1. NEEDLE emits `bead.claim.succeeded` → `currentBead` set
+2. NEEDLE emits `bead.released` with `release_success` → `beadsCompleted` incremented, `currentBead` cleared
+3. `/api/productivity` aggregates data from:
+   - In-memory events (daily counts, worker stats)
+   - Workspace JSONL files (project breakdown via `scanBeadWorkspaces()`)
+
+## Conclusion
+All Phase 9 items are implemented and functional. No code changes required.