feat(static): Pocket Static — one TypeScript game, three cartridges (GBA/GB/NES), starring BOARDROOM

[doodlewind]

What

Pocket Static (static/, @pocketjs/static) — a new static game compiler that replaces @pocketjs/aot: you write a game as one TypeScript module (build-time declarations + generator scripts that never execute), and the compiler partially evaluates it into real cartridges for GBA, Game Boy, and NES. Supersedes #52's prototype with a fresh implementation, and ships a launch game: BOARDROOM, the November 2023 OpenAI board crisis as a five-day RPG.

How

• A real script compiler, not a statement whitelist. script(function* (s, v, f) {...}) bodies lower from their ASTs to a stack VM: locals, i16 expressions with folding, if/while/for/switch, short-circuit &&/||, break/continue, subroutine CALLs, and macro inlining with static binding (for...of unrolls, static if folds, return values). ${...} interpolation compiles to scratch-var stores + textbox format tokens. 23 compiler tests run against a TypeScript reference VM — no emulator in the loop.
• One engine, three consoles. The VM interpreter (~600 lines) and the whole RPG engine (movement, collision, actors, triggers/warps, textbox/choice state machines) are portable C compiled by arm-none-eabi-gcc, sdcc and cc65; each console adds one small HAL. Battle-tested quirks are documented in-tree: DMG drops VRAM writes outside vblank (STAT-gated queue), sdcc 4.6 miscompiles some u8×u8 multiply frames (engine uses accumulation/shifts), NES scenarios pace on engine ticks because cc65 frames stretch.
• Determinism as the contract. Seeded story RNG advanced only by script rnd(); a fixed-layout debug block mirrored at a per-console address; headless harnesses (libmgba for GBA+GB, jsnes for NES) drive identical scenarios and hold every console to the reference VM's answers. For the story suite, the reference VM plays the whole game first and its event log becomes the console input script.
• rpg/battle.ts: a complete turn-based battle system written as compiler macros — zero bespoke runtime; each encounter compiles to specialized bytecode.
• BOARDROOM (static/games/boardroom/): the Vegas call, the guest badge, three CEOs in three days, the Microsoft feint, 743 signatures, Ilya's flip, and a final negotiation battle vs THE BOARD. Every quoted line pinned to the public record in dossier.md; the rest is labeled parody. Cast art is a deterministic pixel-person generator in the declaration zone.
• Retire aot/: tsconfig aliases, the site product page + docs (now /static/, 6 fresh pages, E2E captures as the demo), and skills updated; site/build.ts green end-to-end.

Testing

bun test .                        41 pass   (vm semantics, script compiler, pipeline)
bun test/e2e.ts                  105 pass   (smoke contract game × gba/gb/nes)
bun games/boardroom/test/e2e.ts   51 pass   (full story playthrough × gba/gb/nes)
bun site/build.ts                 ok        (static/docs 6 pages)

ROM sizes: BOARDROOM ≈ 28.5 KB (.gba), 32 KB (.gb, MBC5), 32 KB (.nes, UNROM+CHR-RAM). Headers are flashcart-correct; real-hardware runs not yet attempted.

Follow-ups (not in this PR): codex/PixelLab imagegen sheet upgrade for the cast (the deterministic art is the fallback by design), VN/platformer categories, cjk16 text mode, NES scrolling.

🤖 Generated with Claude Code