- web/manual.html — 17 chapters: playing, the editor deeply, the
authoring cookbook (full JSON reference + the five load-bearing
puzzle patterns), dialogue trees, flags, the art pipeline with
sprite-generation prompts, sound, driving the engine with code
(real JSONL transcripts), AIs + MCP, prompt patterns with actual
outputs (the roof room is the real shipped expansion), the web
build & cloud saves, engine internals, extension recipes,
troubleshooting, and full command/event/palette reference.
- Game menu gains "Manual": window.open on the web (via a JS plugin
import), the default browser natively.
- README tab links the Book; repo README points at it.
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
The handover plan (docs/HANDOVER.md), P0-P6, in one pass. One insight
powers it: CLI/HTTP/MCP/Python is one feature, not four — a headless
core driven by Commands in, Events out, with every surface a thin
adapter.
- mrpgi-core: the whole sim as a library with zero macroquad (the
workspace boundary is the guardrail). GameState::apply/tick, fixed
1/20s cycles, deterministic replays, headless RGBA/PNG rendering.
- mrpgi-headless: JSONL stdio REPL, --script replay (AI lane off =
byte-identical), --render-room PNG, --serve HTTP (state/command/
events cursor/frame.png), --mcp JSON-RPC stdio server whose
render_frame returns a real PNG so a model sees its own moves.
- Games are folders: game.json manifest (all fields default — legacy
dirs still load), data-driven verb table feeding both the parser and
the AI whitelist, flags with requires_flag/sets_flag gating on
objects and dialogue choices, live UpsertRoom lore ingestion with
validation.
- mrpgi (GUI): now one consumer of the bus; editor commits through the
same commands MCP uses; audio became core events with per-game
sfx/ music/ file overrides beating the chiptune synth.
- Tests: parser goldens + a full win-path playthrough asserting
byte-identical transcripts across runs.
Deleted: the old fused src/ (root is now a virtual workspace), the
dead demo Scene/Assets path.
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
