Set up Cloud Agent dev environment for Clinical KB

[BigSimmo]

Summary

Sets up the development environment for the Clinical KB Next.js app so future Cloud Agents can lint, test, build, and run it. No application code was changed — only AGENTS.md gained a durable ## Cursor Cloud specific instructions section.

Environment

• Installed Node 24.18.0 (via nvm) + npm 11 — the app hard-requires Node 24.x. Symlinked into /usr/local/cargo/bin (first in PATH) so node/npm resolve to v24 in all shells, overriding the sandbox's /exec-daemon/node v22.
• Ran npm install (update script).
• Configured .env.local (gitignored) with the live Supabase + OpenAI credentials the user provided, so the app runs against the real Clinical KB Database project (~2000 indexed docs). Without those secrets it auto-falls back to demo mode.

Verification

Offline / demo mode:

• ✅ npm run check:runtime
• ✅ npm run sitemap:check
• ✅ npm run lint (0 errors, 43 warnings)
• ✅ npm run typecheck
• ✅ npm run test (1057 passed, 2 skipped)

Live mode (with provided secrets):

• ✅ npm run check:supabase-project → targets Clinical KB Database
• ✅ GET /api/health?deep=1 → supabaseConfig/openaiConfig/supabase all ok, demoMode:false
• ✅ GET /api/setup-status → env/project/schema/search RPCs all ready
• ✅ npm run dev → served at http://localhost:4461

Hello-world (live)

Asked a real clinical question and received an answer grounded in real indexed documents with source citations (no demo banner).

clinical_kb_live_answer_flow.mp4

Live anaphylaxis answer with sources
Live clozapine answer source citations

Note: npm run worker (ingestion) additionally needs the Python OCR stack; edge functions need Deno v2.x. For durability, the Supabase/OpenAI values must be stored as Cloud Agent Secrets so future agents don't boot in demo mode.

_{To show artifacts inline, enable in settings.}

[supabase]

This pull request has been ignored for the connected project sjrfecxgysukkwxsowpy because there are no changes detected in supabase directory. You can change this behaviour in Project Integrations Settings ↗︎.

---

Preview Branches by Supabase.
Learn more about Supabase Branching ↗︎.

[cursor]

Bugbot is not enabled for your account, so this pull request was not reviewed.

Enable Bugbot in the Cursor dashboard to get automatic reviews on future PRs.

[chatgpt-codex-connector]

You have reached your Codex usage limits for code reviews. You can see your limits in the Codex usage dashboard.