adventure/README.md

adventure

Backend for the choose-your-adventure builder/player (Express 5 + Postgres), scaffolded by platform/new-service adventure --kind backend --with postgres. Frontend: adventure-web.

A story is one JSONB doc: { start, nodes: { key: { title, text, ending?, choices: [{label, to}] } } }. Validation (src/lib/story.ts): errors block publishing (missing start/targets, dead ends, no reachable ending); warnings are advisory (unreachable scenes, choices on endings).

Method	Path
GET	/stories	published stories (?mine=1 includes drafts)
GET	/stories/:id	story + issues
POST / PUT	/stories, /stories/:id	create / replace; 400 on bad shape
POST	/stories/:id/publish	422 + issues if errors
POST	/stories/:id/unpublish
DELETE	/stories/:id	204

No auth (homelab). Without DATABASE_URL an in-memory store is used (tests).