ML serving: - LinUCB contextual bandit (disjoint, d=5 features: hour_sin/cos, is_overdue, task_age, priority) - /score endpoint replaces stub random; /reward endpoint for online learning - Per-user model state persisted to disk as JSON (survives restarts) - venv at ml/serving/.venv; start with pnpm dev from ml/serving Recommender: - Todoist fetch now extracts features (is_overdue, task_age_days, priority) - RemotePolicy calls ml/serving with 3s timeout; falls back to RandomPolicy - Reward sent to /reward on feedback (done=+1, snooze=0, dismiss=-1) Web Push: - VAPID keys in config; push_subscriptions table in DB - POST/DELETE /api/push/subscribe; GET /api/push/vapid-public-key - Service worker (public/sw.js): push → showNotification, notificationclick → focus/open - "notify me" button on tip page; registers SW + subscribes on permission grant Event bus: - services/api/src/events/bus.ts: typed EventEmitter wrapper - Subjects: signals.tip.served, signals.tip.feedback, signals.task.synced - Same publish/subscribe API NATS JetStream will implement — swap is mechanical Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
apps/web
Next.js PWA. Phase 0 scope: three pages.
| Route | Purpose |
|---|---|
/sign-in |
Google/Apple OAuth buttons. No form. |
/connect |
List of integrations (cards). Tap → OAuth. Tap connected card → disconnect. |
/ (tip) |
Pure black background. One tip centered. Tap gestures: done / snooze / dismiss. |
Design notes
- The tip page is the product. Treat it like a watch face.
- Zero chrome, no nav bar, no settings icon while a tip is showing. Long-press reveals actions.
- Offline-first: last tip is cached; reactions queued until reconnect.