Phase 10: Render deploy blueprint

- render.yaml: single Docker web service (SPA + API same-origin), free tier,
  Neon Postgres via AIDND_DATABASE_URL, generated AIDND_SECRET_KEY,
  /api/health check, us-east region, auto-deploy on main.
- README: "Deploy (Render)" section.
- Record verified Postgres path (real Neon, PG 18.4) and Phase 10 decisions
  (Neon, free tier, cloud Docker build) in plan/.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_017e6tQuojBLYPetUfmhit4X

plan/09-phase-hardening.md

@@ -74,5 +74,20 @@ rate-limited instead of burning the demo key, and the app streams turns normally
   (No LLM key configured here, so it streams the "No model configured" error event; a *live*
   provider turn through this path was verified end-to-end in Phase 8.)
 
-All Phase 9 exit criteria met. Not yet exercised: Postgres (`DATABASE_URL`) path and the
-Docker production image specifically — both are Phase 10 deploy steps.
+All Phase 9 exit criteria met.
+
+### Postgres path verified 2026-07-07 (real Neon, PostgreSQL 18.4)
+
+Pointed the backend at a live Neon `DATABASE_URL` (pooled, `sslmode=require&channel_binding=require`):
+
+- **Driver/URL:** `postgres://`/`postgresql://` normalized to `postgresql+psycopg://`; raw
+  psycopg3 connect succeeds.
+- **Bootstrap:** fresh DB → `create_all` builds all 11 tables and stamps `schema_version = 23`
+  (= `LATEST_VERSION`); the SQLite-only migrations 2–23 are correctly skipped on a fresh DB.
+- **Embedding column:** `memories.embedding` is Postgres `json`; a float list round-trips
+  intact (`[0.1, 0.2, 0.3, -0.4]` back as a `list`).
+- **ORM CRUD:** user → scenario → adventure → memory create/read/delete with FK cascades works.
+- **HTTP round-trip (multi-user, TestClient):** guest bootstrap → register → me → create
+  scenario → list → settings → delete, all 200/201/204 against Neon.
+
+Remaining Phase 10 step: the Docker production image specifically (build + run the container).

plan/10-phase-deploy.md

@@ -13,11 +13,21 @@ GitHub repo.
 **Ask before implementing:** Render tier (free-with-sleep vs ~$7/mo always-on — depends on the
 Phase 9 database decision), and the exact service name (it becomes the public URL).
 
+### Decisions (confirmed 2026-07-07)
+
+| Question | Answer |
+|---|---|
+| Database | **Neon Postgres** (external managed; free tier has no persistent disk). Path fully verified against real Neon — see `plan/09-phase-hardening.md`. |
+| Tier | **Free** (sleeps after ~15 min idle; ~30–60s first-wake). |
+| Service name | `ai-dnd` (→ `ai-dnd.onrender.com`, adjustable in dashboard). |
+| Region | `virginia` (us-east, matches Neon us-east-1). |
+| Local Docker preflight | Skipped by choice — Render builds the same Dockerfile in the cloud; its build logs are the image test. |
+
 ## Deploy
 
-- [ ] `render.yaml` blueprint: web service from the Dockerfile, env vars (SECRET_KEY generated,
-      demo-key vars, `MULTI_USER=true`), health check endpoint, plus disk or managed Postgres
-      per the Phase 9 decision.
+- [x] `render.yaml` blueprint: web service from the Dockerfile, env vars (SECRET_KEY generated,
+      demo-key vars, `MULTI_USER=true`), `/api/health` health check, external Neon Postgres.
+      README gained a "Deploy (Render)" section.
 - [ ] Set up the Render service, connect the GitHub repo, auto-deploy on push to `main`.
 - [ ] Seed production with 2–3 good demo scenarios (public/starter scenarios from Phase 8) so
       first-time visitors have something great to click immediately.