chore: scaffold oO monorepo with architecture, roadmap, and module stubs

services/recommender/README.md

@@ -0,0 +1,27 @@
+# recommender
+
+The core of oO. Takes a user + a context, returns **one** tip.
+
+## Contract
+
+```
+POST /recommend
+  { user_id, context?: { time, timezone, client, ... } }
+  → { tip: { id, kind: "todo"|"advice", title, body, source, deep_link, meta } }
+
+POST /feedback
+  { user_id, tip_id, reaction: "done"|"snooze"|"dismiss", at }
+```
+
+## Internals (stable seams)
+
+- **Candidate sources** — pluggable async generators. v0: Todoist tasks via `integrations`. Later: advice library, calendar nudges, health prompts.
+- **Context assembler** — merges request context with features (inline now, feature-store later).
+- **Policy** — `Policy.pick(candidates, context) → tip`. Registered by name:
+  - `random` — v0 (Phase 0).
+  - `bandit.linucb` — v1 (Phase 1).
+  - `remote` — delegates to `ml/serving` FastAPI scorer (Phase 1+).
+
+## Phase 0 goal
+
+`RandomPolicy` only. The service, contract, and seams exist; the brain does not yet.