feat(mc): Pool B Health + Install Funnel ('auto-sync') + claude CLI prereq

[aimerdoux]

Summary

Two operator-visible additions on top of #27, plus one quality-of-life prereq cleanup.

1. Pool B Health + Install Funnel — new Mission Control subnav tab

The operator wants five questions answered at a glance. This adds a "Pool B" tab to MissionControlPage that surfaces all five:

	Question	Answer source
①	Is the Mac actually serving customers right now?	os_devices ⋈ max(usage_ledger.ran_at) — green dot if any device served within 5m
②	Which devices are paired + when did each last serve?	Device table sorted online-first, then by last-inference
③	Are pillar-suggest chips populating in the chat onboarding?	24h success rate over Pool B usage_ledger rows
④	Are downloading customers following the right path?	Pair → claim → first-inference funnel, 24h window
⑤	What's Pool B costing this week per subscription?	Daily usage_ledger.cost_cents roll-up grouped by subscription_id, 14d

This is the "auto-sync" framing — one glance confirms both that the customer-facing chat onboarding's chips are alive AND that downloading users are not silently dropping off mid-pair.

Wiring

PoolBHealthWidget (UI, plugin)
   ↓ usePluginData
plugin worker.ts → ctx.data.register("pool-b-health-{recent,devices,pairings,spend,funnel}")
   ↓ localFetch to wavex-os-server
GET /api/pool-b-health/{recent,devices,pairings,spend,funnel}    ← board-gated
   ↓ assertBoard
mission-control/pool-b-health.ts   ← 30s in-memory cache, ?fresh=1 bypasses
   ↓ service-role Supabase client
wavex_os.{usage_ledger, os_devices, os_device_pairings}

Files

• server: packages/wavex-os-server/src/mission-control/pool-b-health.ts — five query functions + 30s cache + service-role client
• routes: packages/wavex-os-server/src/routes/pool-b-health.ts — five GET endpoints, board-gated, ?fresh=1 for live QA
• plugin worker: five new ctx.data.register("pool-b-health-*") handlers in paperclip-plugin-wavex/src/worker.ts
• plugin UI: paperclip-plugin-wavex/src/ui/PoolBHealthWidget.tsx — KPI row + 4 stacked sections + 30s auto-refresh + manual ↻ button
• subnav: new "Pool B" tab in MissionControlPage.tsx (between Operations and Polish)

2. Claude CLI as a hard prereq in install.sh

The repo runs in BYOC mode — the tier-router T2 calls spawn the local claude binary. Without it, the dev server boots but T2 inference paths halt and the operator sees nothing come back from pillar-suggest / narrate / etc. install.sh was silently leaving this gap.

Now:

• command -v claude check during prereq pass
• Missing → npm install -g @anthropic-ai/claude-code (works on macOS + Linux uniformly, same path as the existing npm install -g pnpm@8)
• WAVEX_SKIP_CLAUDE_CLI=1 env to bypass if you manage it elsewhere (asdf, system package)
• Post-install message lists claude login as step 1 before wavex-os login at step 2

Why these belong together

The whole point of the Pool B Health tab is to answer "are chips still working?" — but if claude CLI isn't installed, chips can never work, and the dashboard will just show a flat zero forever. Making claude a hard prereq closes the loop: a fresh install either works end-to-end or surfaces the missing dep explicitly.

Verification

• bash -n install.sh clean
• TypeScript transpile on all 3 new files (server query module + route + plugin UI) — parsed ok
• Plugin worker + MissionControlPage + ui/index re-exports — match the existing v0.15.0 conventions
• CI / human review pass

Live QA after merge

Once landed + redeployed, hit the new endpoints directly to confirm wiring:

curl -H 'Authorization: Bearer <board-token>' \
  https://your-wavex-os-host/api/pool-b-health/funnel?fresh=1

# Expected (fresh install, no traffic):
# { "ok": true, "summary": {
#     "pairings_initiated_24h": 0, "pairings_claimed_24h": 0,
#     "devices_first_active_24h": 0, "devices_ever_active": 0,
#     "pillar_suggest_calls_24h": 0, "pillar_suggest_success_24h": 0
# } }

Then in MC: MissionControlPage → Pool B tab → should see "no devices paired" empty state. Once a customer runs wavex-os login + completes onboarding, the dots light up.

🤖 Generated with Claude Code