dotframe 0.1.0

package/CHANGELOG.md

@@ -0,0 +1,11 @@
+# Changelog
+
+## 0.1.0
+
+First npm release: the engine plus the agent-first `dotframe` CLI.
+
+- `sim`, `snap`, `replay record/verify`, `desync`: play a game headless or render a frame through WebGPU, deterministically, through the Sim contract in `src/sim.ts`.
+- `desync` compares the full state graph (`inspect()`) at checkpoints and names the first differing path, so render code that changes simulation state shows up before a real match.
+- `build`, `deploy`, `relay deploy`, `device install`, `doctor`, `config`: targets live in `dotframe.json`; external actions need `--yes` and preview with `--dry-run`.
+- `skills list/get/path`: nine guides bundled with the CLI version (core, netplay, export-web, discord, ios, macos, relay, game-design, assets).
+- `new` with fighter, platformer, and blank templates, and `dev`.

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Railly Hugo
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,57 @@
+# dotframe
+
+TS-first game engine. One TypeScript codebase runs on the web (WebGPU) and compiles to native macOS and Windows binaries with [scriptc](https://scriptc.dev), with no JavaScript engine in the binary.
+
+Status: S5 in progress (porting Crafter Smash). `examples/canvas2d` exercises `src/draw2d.ts`, an immediate-mode 2D layer modeled on Canvas2D (transforms, alpha, concave paths, arcs, strokes, PNG sprites) so Canvas2D games port mechanically. Before that, S4: `examples/smash-lite` is a two-player platform fighter: keyboard and gamepad input, fixed-step AABB physics, hitstun, knockback that scales with damage, and KOs. `DF_DEMO=1` (native) or `?demo` (web) lets scripted players fight, which is how CI captures it. Earlier slices: `examples/suzanne` loads a glTF mesh, spawns three entities in a minimal ECS and renders them lit with depth and a perspective camera. The same game code renders in the browser (WebGPU) and in native macOS and Windows binaries (SDL3 + wgpu-native through a flat C shim). CI runs both binaries and captures them with [cuse](https://github.com/crafter-agents/cuse).
+
+## CLI
+
+`dotframe` is an agent-first CLI over the engine. The simulation is deterministic, so an agent can play a game without a screen, render a frame with the real renderer, and catch netplay desyncs before a real match.
+
+```sh
+bun link                                    # or: bun add -g github:crafter-games/dotframe
+dotframe new my-game --template fighter     # fighter, platformer, blank
+dotframe sim --mash 7 --frames 600 --json   # headless run: state + checksum
+dotframe snap --frame 300 --mash 7          # one frame through WebGPU (agent-browser)
+dotframe replay record replays/a.json --mash 7 && dotframe replay verify replays/*.json
+dotframe desync --latency 120ms --jitter 30ms
+dotframe build web|ios|macos|discord
+dotframe deploy web --prod --dry-run        # external actions need --yes
+dotframe doctor --fix
+dotframe skills list                        # guides bundled with this version
+```
+
+A game opts in with a `dotframe.json` (targets, deploy, relay, vendor links, local-only assets) and a `sim` module that default-exports `defineSim` from `src/sim.ts`. Agents start with `dotframe skills get core`. Every command takes `--json`; errors carry a `code`, a `fix`, and the `skill` to read.
+
+- `cli/`: the CLI (Bun). `skills/`: the guides served by `dotframe skills`. `templates/`: the `dotframe new` templates.
+
+## Layout
+
+- `native/df_native.c`: flat C ABI over SDL3 and wgpu-native. scriptc FFI accepts scalars and byte spans only, so the shim owns every WebGPU struct.
+- `src/gpu.ts`: backend-agnostic types for game code. Backends are plain objects of functions, because scriptc compiles structural types as record copies and a class cannot stand in for an interface.
+- `src/math.ts`, `src/ecs.ts`, `src/gltf.ts`, `src/render.ts`: column-major matrices, a Map-per-component ECS, a `.glb` reader (positions, normals, indices) and a lit mesh renderer.
+- `src/input.ts`, `src/physics.ts`, `src/shapes.ts`: engine key ids mapped per backend (SDL scancodes, `KeyboardEvent.code`, first gamepad), side-view AABB physics, and a unit box mesh.
+- `src/draw2d.ts`: Canvas2D-style layer batched into one vertex buffer, one draw per texture. Setters replace property assignment (`setFillStyle` for `ctx.fillStyle =`). PNGs decode with stb_image natively and `createImageBitmap` on the web.
+- `src/audio.ts`, `native/df_audio.c`: sound effects (MP3, volume, playback rate), square tones and one streamed music track. Native mixes in C over SDL3 audio with dr_mp3; the web uses Web Audio and an `<audio>` element. `examples/audio-check` plays a known timeline that CI records with SDL's disk driver and verifies with `tools/check-audio.ts` (segments, 880 Hz tone, 262 Hz music, silence after stop).
+- `test/`: `bun test` covers color parsing, triangulation and physics (landing, walls, ceilings, falling off edges).
+- `src/native`: FFI declarations and the native run loop. `native/ffi.{macos,windows}.json` bind them for every example.
+- `src/web`: the browser run loop over `navigator.gpu`.
+- `examples/*`: `game.ts` is shared; `main.native.ts` and `main.web.ts` pick the backend.
+- `assets/audio/*.mp3`: original test sounds generated with ffmpeg.
+- `assets/fonts/*`: Bangers and Archivo Black (SIL OFL, see `tools/fonts/`) baked into SDF atlases by `tools/bake-font.c`.
+- `assets/crafter.png`: original 16x16 two-frame sprite, generated by `tools/make-sprite.ts`.
+- `assets/suzanne.glb`: Blender's Suzanne from the Khronos glTF sample assets (CC0, Norbert Nopper / UX3D), packed geometry-only.
+- `scripts/build-native.sh`: builds an example for `macos` or `windows`.
+
+## Vendored dependencies (not committed)
+
+- wgpu-native `v29.0.1.1` prebuilt (`wgpu-macos-aarch64-release`, `wgpu-windows-x86_64-gnu-release`) in `vendor/wgpu/{macos,windows}`.
+- SDL3 `3.4.16` source in `vendor/SDL3-3.4.16`, built static into `vendor/build/sdl-{macos,windows}`. Windows is cross-built with zig via `vendor/toolchain/zig-windows.cmake`.
+
+## Build
+
+```sh
+scripts/build-native.sh macos triangle
+scripts/build-native.sh windows triangle   # needs zig and @scriptc/runtime-win32-x64-msvc
+scripts/build-web.sh triangle               # then serve build/web/triangle
+```

package/assets/fonts/archivo-black.json

@@ -0,0 +1,133 @@
+{
+  "size": 64,
+  "ascent": 51.6471,
+  "descent": -12.3529,
+  "lineGap": 0,
+  "distanceRange": 8,
+  "glyphs": [
+    { "code": 32, "x": 0, "y": 0, "width": 0, "height": 0, "offsetX": 0, "offsetY": 0, "advance": 19.5882 },
+    { "code": 33, "x": 1, "y": 0, "width": 31, "height": 57, "offsetX": -6, "offsetY": -49, "advance": 19.5882 },
+    { "code": 34, "x": 33, "y": 0, "width": 39, "height": 34, "offsetX": -5, "offsetY": -49, "advance": 29.4118 },
+    { "code": 35, "x": 73, "y": 0, "width": 53, "height": 59, "offsetX": -7, "offsetY": -50, "advance": 38.8235 },
+    { "code": 36, "x": 127, "y": 0, "width": 49, "height": 65, "offsetX": -4, "offsetY": -53, "advance": 39.2353 },
+    { "code": 37, "x": 177, "y": 0, "width": 70, "height": 59, "offsetX": -6, "offsetY": -50, "advance": 58.8235 },
+    { "code": 38, "x": 248, "y": 0, "width": 65, "height": 59, "offsetX": -4, "offsetY": -50, "advance": 52.2941 },
+    { "code": 39, "x": 314, "y": 0, "width": 26, "height": 34, "offsetX": -5, "offsetY": -49, "advance": 16.3529 },
+    { "code": 40, "x": 341, "y": 0, "width": 34, "height": 70, "offsetX": -5, "offsetY": -52, "advance": 22.8824 },
+    { "code": 41, "x": 376, "y": 0, "width": 34, "height": 70, "offsetX": -6, "offsetY": -52, "advance": 22.8824 },
+    { "code": 42, "x": 411, "y": 0, "width": 39, "height": 39, "offsetX": -3, "offsetY": -49, "advance": 32.7059 },
+    { "code": 43, "x": 451, "y": 0, "width": 48, "height": 48, "offsetX": -5, "offsetY": -40, "advance": 38.8235 },
+    { "code": 44, "x": 500, "y": 0, "width": 30, "height": 39, "offsetX": -5, "offsetY": -20, "advance": 19.5882 },
+    { "code": 45, "x": 531, "y": 0, "width": 32, "height": 26, "offsetX": -6, "offsetY": -29, "advance": 19.5882 },
+    { "code": 46, "x": 564, "y": 0, "width": 30, "height": 28, "offsetX": -5, "offsetY": -20, "advance": 19.5882 },
+    { "code": 47, "x": 595, "y": 0, "width": 34, "height": 63, "offsetX": -9, "offsetY": -52, "advance": 16.3529 },
+    { "code": 48, "x": 630, "y": 0, "width": 51, "height": 59, "offsetX": -6, "offsetY": -50, "advance": 39.2353 },
+    { "code": 49, "x": 682, "y": 0, "width": 47, "height": 57, "offsetX": -2, "offsetY": -49, "advance": 39.2353 },
+    { "code": 50, "x": 730, "y": 0, "width": 51, "height": 58, "offsetX": -6, "offsetY": -50, "advance": 39.2353 },
+    { "code": 51, "x": 782, "y": 0, "width": 51, "height": 59, "offsetX": -6, "offsetY": -50, "advance": 39.2353 },
+    { "code": 52, "x": 834, "y": 0, "width": 53, "height": 58, "offsetX": -7, "offsetY": -50, "advance": 39.2353 },
+    { "code": 53, "x": 888, "y": 0, "width": 51, "height": 58, "offsetX": -6, "offsetY": -49, "advance": 39.2353 },
+    { "code": 54, "x": 940, "y": 0, "width": 52, "height": 59, "offsetX": -6, "offsetY": -50, "advance": 39.2353 },
+    { "code": 55, "x": 0, "y": 71, "width": 51, "height": 57, "offsetX": -6, "offsetY": -49, "advance": 39.2353 },
+    { "code": 56, "x": 52, "y": 71, "width": 51, "height": 59, "offsetX": -6, "offsetY": -50, "advance": 39.2353 },
+    { "code": 57, "x": 104, "y": 71, "width": 51, "height": 59, "offsetX": -6, "offsetY": -50, "advance": 39.2353 },
+    { "code": 58, "x": 156, "y": 71, "width": 30, "height": 48, "offsetX": -5, "offsetY": -40, "advance": 19.5882 },
+    { "code": 59, "x": 187, "y": 71, "width": 30, "height": 59, "offsetX": -5, "offsetY": -40, "advance": 19.5882 },
+    { "code": 60, "x": 218, "y": 71, "width": 48, "height": 49, "offsetX": -5, "offsetY": -40, "advance": 38.8235 },
+    { "code": 61, "x": 267, "y": 71, "width": 48, "height": 38, "offsetX": -5, "offsetY": -35, "advance": 38.8235 },
+    { "code": 62, "x": 316, "y": 71, "width": 47, "height": 49, "offsetX": -4, "offsetY": -40, "advance": 38.8235 },
+    { "code": 63, "x": 364, "y": 71, "width": 48, "height": 58, "offsetX": -6, "offsetY": -50, "advance": 35.9412 },
+    { "code": 64, "x": 413, "y": 71, "width": 58, "height": 67, "offsetX": -7, "offsetY": -50, "advance": 43.5294 },
+    { "code": 65, "x": 472, "y": 71, "width": 62, "height": 57, "offsetX": -8, "offsetY": -49, "advance": 45.7647 },
+    { "code": 66, "x": 535, "y": 71, "width": 56, "height": 57, "offsetX": -4, "offsetY": -49, "advance": 45.7647 },
+    { "code": 67, "x": 592, "y": 71, "width": 58, "height": 59, "offsetX": -6, "offsetY": -50, "advance": 45.7647 },
+    { "code": 68, "x": 651, "y": 71, "width": 56, "height": 57, "offsetX": -4, "offsetY": -49, "advance": 45.7647 },
+    { "code": 69, "x": 708, "y": 71, "width": 52, "height": 57, "offsetX": -4, "offsetY": -49, "advance": 42.4706 },
+    { "code": 70, "x": 761, "y": 71, "width": 50, "height": 57, "offsetX": -4, "offsetY": -49, "advance": 39.2353 },
+    { "code": 71, "x": 812, "y": 71, "width": 60, "height": 59, "offsetX": -6, "offsetY": -50, "advance": 49 },
+    { "code": 72, "x": 873, "y": 71, "width": 57, "height": 57, "offsetX": -4, "offsetY": -49, "advance": 49 },
+    { "code": 73, "x": 931, "y": 71, "width": 30, "height": 57, "offsetX": -4, "offsetY": -49, "advance": 22.8824 },
+    { "code": 74, "x": 962, "y": 71, "width": 50, "height": 58, "offsetX": -7, "offsetY": -49, "advance": 39.2353 },
+    { "code": 75, "x": 0, "y": 139, "width": 61, "height": 57, "offsetX": -4, "offsetY": -49, "advance": 49 },
+    { "code": 76, "x": 62, "y": 139, "width": 51, "height": 57, "offsetX": -4, "offsetY": -49, "advance": 39.2353 },
+    { "code": 77, "x": 114, "y": 139, "width": 65, "height": 57, "offsetX": -5, "offsetY": -49, "advance": 55.5294 },
+    { "code": 78, "x": 180, "y": 139, "width": 57, "height": 57, "offsetX": -4, "offsetY": -49, "advance": 49 },
+    { "code": 79, "x": 238, "y": 139, "width": 61, "height": 59, "offsetX": -6, "offsetY": -50, "advance": 49 },
+    { "code": 80, "x": 300, "y": 139, "width": 52, "height": 57, "offsetX": -4, "offsetY": -49, "advance": 42.4706 },
+    { "code": 81, "x": 353, "y": 139, "width": 61, "height": 66, "offsetX": -6, "offsetY": -50, "advance": 49 },
+    { "code": 82, "x": 415, "y": 139, "width": 56, "height": 57, "offsetX": -4, "offsetY": -49, "advance": 45.7647 },
+    { "code": 83, "x": 472, "y": 139, "width": 55, "height": 59, "offsetX": -6, "offsetY": -50, "advance": 42.4706 },
+    { "code": 84, "x": 528, "y": 139, "width": 56, "height": 57, "offsetX": -7, "offsetY": -49, "advance": 42.4706 },
+    { "code": 85, "x": 585, "y": 139, "width": 57, "height": 58, "offsetX": -4, "offsetY": -49, "advance": 49 },
+    { "code": 86, "x": 643, "y": 139, "width": 60, "height": 57, "offsetX": -7, "offsetY": -49, "advance": 45.7647 },
+    { "code": 87, "x": 704, "y": 139, "width": 75, "height": 57, "offsetX": -8, "offsetY": -49, "advance": 58.8235 },
+    { "code": 88, "x": 780, "y": 139, "width": 62, "height": 57, "offsetX": -8, "offsetY": -49, "advance": 45.7647 },
+    { "code": 89, "x": 843, "y": 139, "width": 62, "height": 57, "offsetX": -8, "offsetY": -49, "advance": 45.7647 },
+    { "code": 90, "x": 906, "y": 139, "width": 56, "height": 57, "offsetX": -7, "offsetY": -49, "advance": 42.4706 },
+    { "code": 91, "x": 963, "y": 139, "width": 33, "height": 70, "offsetX": -5, "offsetY": -52, "advance": 22.8824 },
+    { "code": 92, "x": 0, "y": 210, "width": 34, "height": 63, "offsetX": -9, "offsetY": -52, "advance": 16.3529 },
+    { "code": 93, "x": 35, "y": 210, "width": 33, "height": 70, "offsetX": -5, "offsetY": -52, "advance": 22.8824 },
+    { "code": 94, "x": 69, "y": 210, "width": 49, "height": 38, "offsetX": -5, "offsetY": -49, "advance": 38.8235 },
+    { "code": 95, "x": 119, "y": 210, "width": 46, "height": 21, "offsetX": -8, "offsetY": -5, "advance": 29.4118 },
+    { "code": 96, "x": 166, "y": 210, "width": 34, "height": 25, "offsetX": -7, "offsetY": -51, "advance": 19.5882 },
+    { "code": 97, "x": 201, "y": 210, "width": 54, "height": 49, "offsetX": -7, "offsetY": -40, "advance": 39.2353 },
+    { "code": 98, "x": 256, "y": 210, "width": 51, "height": 60, "offsetX": -5, "offsetY": -51, "advance": 39.2353 },
+    { "code": 99, "x": 308, "y": 210, "width": 51, "height": 49, "offsetX": -6, "offsetY": -40, "advance": 39.2353 },
+    { "code": 100, "x": 360, "y": 210, "width": 50, "height": 60, "offsetX": -6, "offsetY": -51, "advance": 39.2353 },
+    { "code": 101, "x": 411, "y": 210, "width": 52, "height": 49, "offsetX": -6, "offsetY": -40, "advance": 39.2353 },
+    { "code": 102, "x": 464, "y": 210, "width": 39, "height": 60, "offsetX": -8, "offsetY": -52, "advance": 22.8824 },
+    { "code": 103, "x": 504, "y": 210, "width": 55, "height": 66, "offsetX": -8, "offsetY": -45, "advance": 39.2353 },
+    { "code": 104, "x": 560, "y": 210, "width": 49, "height": 59, "offsetX": -5, "offsetY": -51, "advance": 39.2353 },
+    { "code": 105, "x": 610, "y": 210, "width": 29, "height": 59, "offsetX": -5, "offsetY": -51, "advance": 19.5882 },
+    { "code": 106, "x": 640, "y": 210, "width": 35, "height": 72, "offsetX": -11, "offsetY": -51, "advance": 19.5882 },
+    { "code": 107, "x": 676, "y": 210, "width": 53, "height": 59, "offsetX": -5, "offsetY": -51, "advance": 39.2353 },
+    { "code": 108, "x": 730, "y": 210, "width": 29, "height": 59, "offsetX": -5, "offsetY": -51, "advance": 19.5882 },
+    { "code": 109, "x": 760, "y": 210, "width": 69, "height": 48, "offsetX": -5, "offsetY": -40, "advance": 58.8235 },
+    { "code": 110, "x": 830, "y": 210, "width": 49, "height": 48, "offsetX": -5, "offsetY": -40, "advance": 39.2353 },
+    { "code": 111, "x": 880, "y": 210, "width": 52, "height": 49, "offsetX": -6, "offsetY": -40, "advance": 39.2353 },
+    { "code": 112, "x": 933, "y": 210, "width": 51, "height": 60, "offsetX": -5, "offsetY": -40, "advance": 39.2353 },
+    { "code": 113, "x": 0, "y": 283, "width": 50, "height": 60, "offsetX": -6, "offsetY": -40, "advance": 39.2353 },
+    { "code": 114, "x": 51, "y": 283, "width": 39, "height": 48, "offsetX": -5, "offsetY": -40, "advance": 26.1176 },
+    { "code": 115, "x": 91, "y": 283, "width": 49, "height": 49, "offsetX": -7, "offsetY": -40, "advance": 35.9412 },
+    { "code": 116, "x": 141, "y": 283, "width": 40, "height": 58, "offsetX": -7, "offsetY": -49, "advance": 26.1176 },
+    { "code": 117, "x": 182, "y": 283, "width": 49, "height": 49, "offsetX": -5, "offsetY": -40, "advance": 39.2353 },
+    { "code": 118, "x": 232, "y": 283, "width": 52, "height": 48, "offsetX": -8, "offsetY": -40, "advance": 35.9412 },
+    { "code": 119, "x": 285, "y": 283, "width": 72, "height": 48, "offsetX": -8, "offsetY": -40, "advance": 55.5294 },
+    { "code": 120, "x": 358, "y": 283, "width": 55, "height": 48, "offsetX": -8, "offsetY": -40, "advance": 39.2353 },
+    { "code": 121, "x": 414, "y": 283, "width": 52, "height": 61, "offsetX": -8, "offsetY": -40, "advance": 35.9412 },
+    { "code": 122, "x": 467, "y": 283, "width": 47, "height": 48, "offsetX": -7, "offsetY": -40, "advance": 32.7059 },
+    { "code": 123, "x": 515, "y": 283, "width": 36, "height": 70, "offsetX": -7, "offsetY": -52, "advance": 22.8824 },
+    { "code": 124, "x": 552, "y": 283, "width": 24, "height": 72, "offsetX": -4, "offsetY": -51, "advance": 16.3529 },
+    { "code": 125, "x": 577, "y": 283, "width": 36, "height": 70, "offsetX": -6, "offsetY": -52, "advance": 22.8824 },
+    { "code": 126, "x": 614, "y": 283, "width": 51, "height": 30, "offsetX": -6, "offsetY": -33, "advance": 38.8235 },
+    { "code": 225, "x": 666, "y": 283, "width": 54, "height": 60, "offsetX": -7, "offsetY": -51, "advance": 39.2353 },
+    { "code": 233, "x": 721, "y": 283, "width": 52, "height": 60, "offsetX": -6, "offsetY": -51, "advance": 39.2353 },
+    { "code": 237, "x": 774, "y": 283, "width": 34, "height": 59, "offsetX": -5, "offsetY": -51, "advance": 19.5882 },
+    { "code": 243, "x": 809, "y": 283, "width": 52, "height": 60, "offsetX": -6, "offsetY": -51, "advance": 39.2353 },
+    { "code": 250, "x": 862, "y": 283, "width": 49, "height": 60, "offsetX": -5, "offsetY": -51, "advance": 39.2353 },
+    { "code": 193, "x": 912, "y": 283, "width": 62, "height": 69, "offsetX": -8, "offsetY": -61, "advance": 45.7647 },
+    { "code": 201, "x": 0, "y": 356, "width": 52, "height": 69, "offsetX": -4, "offsetY": -61, "advance": 42.4706 },
+    { "code": 205, "x": 53, "y": 356, "width": 35, "height": 69, "offsetX": -4, "offsetY": -61, "advance": 22.8824 },
+    { "code": 211, "x": 89, "y": 356, "width": 61, "height": 70, "offsetX": -6, "offsetY": -61, "advance": 49 },
+    { "code": 218, "x": 151, "y": 356, "width": 57, "height": 70, "offsetX": -4, "offsetY": -61, "advance": 49 },
+    { "code": 241, "x": 209, "y": 356, "width": 49, "height": 59, "offsetX": -5, "offsetY": -51, "advance": 39.2353 },
+    { "code": 209, "x": 259, "y": 356, "width": 57, "height": 69, "offsetX": -4, "offsetY": -61, "advance": 49 },
+    { "code": 161, "x": 317, "y": 356, "width": 31, "height": 58, "offsetX": -6, "offsetY": -40, "advance": 19.5882 },
+    { "code": 191, "x": 349, "y": 356, "width": 48, "height": 58, "offsetX": -6, "offsetY": -39, "advance": 35.9412 },
+    { "code": 252, "x": 398, "y": 356, "width": 49, "height": 60, "offsetX": -5, "offsetY": -51, "advance": 39.2353 },
+    { "code": 220, "x": 448, "y": 356, "width": 57, "height": 70, "offsetX": -4, "offsetY": -61, "advance": 49 },
+    { "code": 176, "x": 506, "y": 356, "width": 35, "height": 35, "offsetX": -6, "offsetY": -50, "advance": 23.5294 },
+    { "code": 8230, "x": 542, "y": 356, "width": 69, "height": 28, "offsetX": -5, "offsetY": -20, "advance": 58.8235 },
+    { "code": 215, "x": 612, "y": 356, "width": 47, "height": 47, "offsetX": -4, "offsetY": -39, "advance": 38.8235 },
+    { "code": 183, "x": 660, "y": 356, "width": 28, "height": 28, "offsetX": -4, "offsetY": -33, "advance": 19.5882 },
+    { "code": 8211, "x": 689, "y": 356, "width": 46, "height": 25, "offsetX": -8, "offsetY": -28, "advance": 29.4118 },
+    { "code": 8212, "x": 736, "y": 356, "width": 75, "height": 25, "offsetX": -8, "offsetY": -28, "advance": 58.8235 },
+    { "code": 8216, "x": 812, "y": 356, "width": 28, "height": 38, "offsetX": -6, "offsetY": -49, "advance": 16.3529 },
+    { "code": 8217, "x": 841, "y": 356, "width": 28, "height": 38, "offsetX": -6, "offsetY": -49, "advance": 16.3529 },
+    { "code": 8220, "x": 870, "y": 356, "width": 41, "height": 38, "offsetX": -6, "offsetY": -49, "advance": 29.4118 },
+    { "code": 8221, "x": 912, "y": 356, "width": 41, "height": 38, "offsetX": -6, "offsetY": -49, "advance": 29.4118 },
+    { "code": 8226, "x": 954, "y": 356, "width": 36, "height": 36, "offsetX": -3, "offsetY": -38, "advance": 29.4118 }
+  ],
+  "atlasWidth": 1024,
+  "atlasHeight": 426
+}

package/assets/fonts/bangers.json

@@ -0,0 +1,133 @@
+{
+  "size": 64,
+  "ascent": 53.1128,
+  "descent": -10.8872,
+  "lineGap": 0,
+  "distanceRange": 8,
+  "glyphs": [
+    { "code": 32, "x": 0, "y": 0, "width": 0, "height": 0, "offsetX": 0, "offsetY": 0, "advance": 11.7293 },
+    { "code": 33, "x": 1, "y": 0, "width": 41, "height": 63, "offsetX": -9, "offsetY": -53, "advance": 15.8195 },
+    { "code": 34, "x": 43, "y": 0, "width": 47, "height": 38, "offsetX": -4, "offsetY": -56, "advance": 25.3233 },
+    { "code": 35, "x": 91, "y": 0, "width": 56, "height": 62, "offsetX": -6, "offsetY": -53, "advance": 37.6541 },
+    { "code": 36, "x": 148, "y": 0, "width": 46, "height": 70, "offsetX": -7, "offsetY": -57, "advance": 26.5865 },
+    { "code": 37, "x": 195, "y": 0, "width": 62, "height": 65, "offsetX": -4, "offsetY": -55, "advance": 48.0602 },
+    { "code": 38, "x": 258, "y": 0, "width": 52, "height": 62, "offsetX": -7, "offsetY": -53, "advance": 32.1805 },
+    { "code": 39, "x": 311, "y": 0, "width": 33, "height": 37, "offsetX": -4, "offsetY": -56, "advance": 12.1504 },
+    { "code": 40, "x": 345, "y": 0, "width": 43, "height": 78, "offsetX": -6, "offsetY": -61, "advance": 20.0902 },
+    { "code": 41, "x": 389, "y": 0, "width": 44, "height": 78, "offsetX": -12, "offsetY": -61, "advance": 19.9098 },
+    { "code": 42, "x": 434, "y": 0, "width": 41, "height": 44, "offsetX": -4, "offsetY": -49, "advance": 25.4436 },
+    { "code": 43, "x": 476, "y": 0, "width": 35, "height": 41, "offsetX": -5, "offsetY": -39, "advance": 19.8496 },
+    { "code": 44, "x": 512, "y": 0, "width": 32, "height": 34, "offsetX": -11, "offsetY": -19, "advance": 11.8496 },
+    { "code": 45, "x": 545, "y": 0, "width": 38, "height": 28, "offsetX": -6, "offsetY": -34, "advance": 21.6541 },
+    { "code": 46, "x": 584, "y": 0, "width": 30, "height": 29, "offsetX": -9, "offsetY": -19, "advance": 12.5714 },
+    { "code": 47, "x": 615, "y": 0, "width": 57, "height": 64, "offsetX": -9, "offsetY": -54, "advance": 33.1429 },
+    { "code": 48, "x": 673, "y": 0, "width": 46, "height": 61, "offsetX": -6, "offsetY": -53, "advance": 28.5113 },
+    { "code": 49, "x": 720, "y": 0, "width": 36, "height": 60, "offsetX": -4, "offsetY": -52, "advance": 19.2481 },
+    { "code": 50, "x": 757, "y": 0, "width": 49, "height": 60, "offsetX": -8, "offsetY": -52, "advance": 28.0902 },
+    { "code": 51, "x": 807, "y": 0, "width": 48, "height": 62, "offsetX": -8, "offsetY": -53, "advance": 27.5489 },
+    { "code": 52, "x": 856, "y": 0, "width": 46, "height": 61, "offsetX": -7, "offsetY": -52, "advance": 27.609 },
+    { "code": 53, "x": 903, "y": 0, "width": 46, "height": 61, "offsetX": -6, "offsetY": -52, "advance": 27.0677 },
+    { "code": 54, "x": 950, "y": 0, "width": 45, "height": 61, "offsetX": -5, "offsetY": -53, "advance": 28.7519 },
+    { "code": 55, "x": 0, "y": 79, "width": 43, "height": 61, "offsetX": -7, "offsetY": -53, "advance": 20.391 },
+    { "code": 56, "x": 44, "y": 79, "width": 51, "height": 62, "offsetX": -7, "offsetY": -53, "advance": 31.1579 },
+    { "code": 57, "x": 96, "y": 79, "width": 45, "height": 61, "offsetX": -4, "offsetY": -53, "advance": 29.4135 },
+    { "code": 58, "x": 142, "y": 79, "width": 31, "height": 49, "offsetX": -7, "offsetY": -43, "advance": 11.7293 },
+    { "code": 59, "x": 174, "y": 79, "width": 33, "height": 52, "offsetX": -7, "offsetY": -42, "advance": 15.7594 },
+    { "code": 60, "x": 208, "y": 79, "width": 37, "height": 60, "offsetX": -6, "offsetY": -53, "advance": 19.0075 },
+    { "code": 61, "x": 246, "y": 79, "width": 37, "height": 42, "offsetX": -6, "offsetY": -40, "advance": 21.0526 },
+    { "code": 62, "x": 284, "y": 79, "width": 37, "height": 60, "offsetX": -8, "offsetY": -52, "advance": 17.3233 },
+    { "code": 63, "x": 322, "y": 79, "width": 42, "height": 62, "offsetX": -3, "offsetY": -52, "advance": 26.3459 },
+    { "code": 64, "x": 365, "y": 79, "width": 76, "height": 62, "offsetX": -6, "offsetY": -52, "advance": 59.3684 },
+    { "code": 65, "x": 442, "y": 79, "width": 46, "height": 61, "offsetX": -10, "offsetY": -53, "advance": 26.0451 },
+    { "code": 66, "x": 489, "y": 79, "width": 48, "height": 62, "offsetX": -9, "offsetY": -53, "advance": 25.7444 },
+    { "code": 67, "x": 538, "y": 79, "width": 45, "height": 61, "offsetX": -6, "offsetY": -52, "advance": 24.9023 },
+    { "code": 68, "x": 584, "y": 79, "width": 47, "height": 61, "offsetX": -8, "offsetY": -52, "advance": 26.5263 },
+    { "code": 69, "x": 632, "y": 79, "width": 44, "height": 62, "offsetX": -8, "offsetY": -53, "advance": 20.5113 },
+    { "code": 70, "x": 677, "y": 79, "width": 45, "height": 62, "offsetX": -8, "offsetY": -53, "advance": 20.5113 },
+    { "code": 71, "x": 723, "y": 79, "width": 49, "height": 63, "offsetX": -6, "offsetY": -53, "advance": 30.015 },
+    { "code": 72, "x": 773, "y": 79, "width": 49, "height": 62, "offsetX": -8, "offsetY": -53, "advance": 26.5865 },
+    { "code": 73, "x": 823, "y": 79, "width": 35, "height": 60, "offsetX": -9, "offsetY": -52, "advance": 12.0301 },
+    { "code": 74, "x": 859, "y": 79, "width": 43, "height": 64, "offsetX": -10, "offsetY": -55, "advance": 16.782 },
+    { "code": 75, "x": 903, "y": 79, "width": 53, "height": 62, "offsetX": -8, "offsetY": -53, "advance": 27.7895 },
+    { "code": 76, "x": 957, "y": 79, "width": 35, "height": 62, "offsetX": -8, "offsetY": -53, "advance": 18.1654 },
+    { "code": 77, "x": 0, "y": 144, "width": 60, "height": 62, "offsetX": -10, "offsetY": -54, "advance": 37.2331 },
+    { "code": 78, "x": 61, "y": 144, "width": 50, "height": 63, "offsetX": -8, "offsetY": -54, "advance": 27.2481 },
+    { "code": 79, "x": 112, "y": 144, "width": 49, "height": 62, "offsetX": -7, "offsetY": -53, "advance": 29.6541 },
+    { "code": 80, "x": 162, "y": 144, "width": 46, "height": 62, "offsetX": -9, "offsetY": -53, "advance": 22.797 },
+    { "code": 81, "x": 209, "y": 144, "width": 50, "height": 64, "offsetX": -7, "offsetY": -53, "advance": 31.5789 },
+    { "code": 82, "x": 260, "y": 144, "width": 47, "height": 61, "offsetX": -8, "offsetY": -52, "advance": 26.7068 },
+    { "code": 83, "x": 308, "y": 144, "width": 48, "height": 61, "offsetX": -8, "offsetY": -52, "advance": 25.8647 },
+    { "code": 84, "x": 357, "y": 144, "width": 40, "height": 61, "offsetX": -3, "offsetY": -52, "advance": 21.7744 },
+    { "code": 85, "x": 398, "y": 144, "width": 47, "height": 62, "offsetX": -7, "offsetY": -52, "advance": 25.203 },
+    { "code": 86, "x": 446, "y": 144, "width": 44, "height": 62, "offsetX": -5, "offsetY": -53, "advance": 22.797 },
+    { "code": 87, "x": 491, "y": 144, "width": 58, "height": 62, "offsetX": -6, "offsetY": -53, "advance": 36.1504 },
+    { "code": 88, "x": 550, "y": 144, "width": 51, "height": 61, "offsetX": -11, "offsetY": -52, "advance": 24.7218 },
+    { "code": 89, "x": 602, "y": 144, "width": 44, "height": 61, "offsetX": -4, "offsetY": -53, "advance": 23.0977 },
+    { "code": 90, "x": 647, "y": 144, "width": 48, "height": 59, "offsetX": -8, "offsetY": -51, "advance": 25.9248 },
+    { "code": 91, "x": 696, "y": 144, "width": 43, "height": 64, "offsetX": -7, "offsetY": -55, "advance": 19.188 },
+    { "code": 92, "x": 740, "y": 144, "width": 39, "height": 62, "offsetX": -1, "offsetY": -54, "advance": 30.6767 },
+    { "code": 93, "x": 780, "y": 144, "width": 43, "height": 64, "offsetX": -10, "offsetY": -54, "advance": 18.8271 },
+    { "code": 94, "x": 824, "y": 144, "width": 37, "height": 34, "offsetX": -2, "offsetY": -62, "advance": 24.0602 },
+    { "code": 95, "x": 862, "y": 144, "width": 44, "height": 24, "offsetX": -12, "offsetY": -9, "advance": 24.1203 },
+    { "code": 96, "x": 907, "y": 144, "width": 33, "height": 36, "offsetX": -6, "offsetY": -62, "advance": 21.5338 },
+    { "code": 97, "x": 941, "y": 144, "width": 46, "height": 61, "offsetX": -10, "offsetY": -53, "advance": 26.0451 },
+    { "code": 98, "x": 0, "y": 209, "width": 48, "height": 62, "offsetX": -9, "offsetY": -53, "advance": 25.7444 },
+    { "code": 99, "x": 49, "y": 209, "width": 45, "height": 61, "offsetX": -6, "offsetY": -52, "advance": 24.9023 },
+    { "code": 100, "x": 95, "y": 209, "width": 47, "height": 61, "offsetX": -8, "offsetY": -52, "advance": 26.5263 },
+    { "code": 101, "x": 143, "y": 209, "width": 44, "height": 62, "offsetX": -8, "offsetY": -53, "advance": 20.5113 },
+    { "code": 102, "x": 188, "y": 209, "width": 45, "height": 62, "offsetX": -8, "offsetY": -53, "advance": 20.5113 },
+    { "code": 103, "x": 234, "y": 209, "width": 49, "height": 63, "offsetX": -6, "offsetY": -53, "advance": 30.015 },
+    { "code": 104, "x": 284, "y": 209, "width": 49, "height": 62, "offsetX": -8, "offsetY": -53, "advance": 26.5263 },
+    { "code": 105, "x": 334, "y": 209, "width": 34, "height": 60, "offsetX": -8, "offsetY": -52, "advance": 12.1504 },
+    { "code": 106, "x": 369, "y": 209, "width": 43, "height": 64, "offsetX": -10, "offsetY": -55, "advance": 16.782 },
+    { "code": 107, "x": 413, "y": 209, "width": 53, "height": 62, "offsetX": -8, "offsetY": -53, "advance": 27.7895 },
+    { "code": 108, "x": 467, "y": 209, "width": 35, "height": 62, "offsetX": -8, "offsetY": -53, "advance": 18.1654 },
+    { "code": 109, "x": 503, "y": 209, "width": 60, "height": 62, "offsetX": -10, "offsetY": -54, "advance": 37.2331 },
+    { "code": 110, "x": 564, "y": 209, "width": 50, "height": 63, "offsetX": -8, "offsetY": -54, "advance": 27.188 },
+    { "code": 111, "x": 615, "y": 209, "width": 49, "height": 62, "offsetX": -7, "offsetY": -53, "advance": 29.6541 },
+    { "code": 112, "x": 665, "y": 209, "width": 46, "height": 62, "offsetX": -9, "offsetY": -53, "advance": 22.797 },
+    { "code": 113, "x": 712, "y": 209, "width": 50, "height": 64, "offsetX": -7, "offsetY": -53, "advance": 31.5789 },
+    { "code": 114, "x": 763, "y": 209, "width": 47, "height": 61, "offsetX": -8, "offsetY": -52, "advance": 26.7068 },
+    { "code": 115, "x": 811, "y": 209, "width": 48, "height": 61, "offsetX": -8, "offsetY": -52, "advance": 25.8647 },
+    { "code": 116, "x": 860, "y": 209, "width": 40, "height": 61, "offsetX": -3, "offsetY": -52, "advance": 21.7744 },
+    { "code": 117, "x": 901, "y": 209, "width": 47, "height": 62, "offsetX": -7, "offsetY": -52, "advance": 25.203 },
+    { "code": 118, "x": 949, "y": 209, "width": 44, "height": 62, "offsetX": -5, "offsetY": -53, "advance": 22.797 },
+    { "code": 119, "x": 0, "y": 274, "width": 58, "height": 62, "offsetX": -6, "offsetY": -53, "advance": 36.1504 },
+    { "code": 120, "x": 59, "y": 274, "width": 51, "height": 61, "offsetX": -11, "offsetY": -52, "advance": 24.7218 },
+    { "code": 121, "x": 111, "y": 274, "width": 44, "height": 61, "offsetX": -4, "offsetY": -53, "advance": 23.0977 },
+    { "code": 122, "x": 156, "y": 274, "width": 48, "height": 59, "offsetX": -8, "offsetY": -51, "advance": 25.9248 },
+    { "code": 123, "x": 205, "y": 274, "width": 36, "height": 60, "offsetX": -6, "offsetY": -52, "advance": 16.9023 },
+    { "code": 124, "x": 242, "y": 274, "width": 35, "height": 64, "offsetX": -7, "offsetY": -54, "advance": 14.9173 },
+    { "code": 125, "x": 278, "y": 274, "width": 36, "height": 60, "offsetX": -7, "offsetY": -52, "advance": 16.4211 },
+    { "code": 126, "x": 315, "y": 274, "width": 43, "height": 31, "offsetX": -6, "offsetY": -37, "advance": 25.3233 },
+    { "code": 225, "x": 359, "y": 274, "width": 46, "height": 83, "offsetX": -10, "offsetY": -75, "advance": 26.0451 },
+    { "code": 233, "x": 406, "y": 274, "width": 44, "height": 83, "offsetX": -8, "offsetY": -74, "advance": 20.5113 },
+    { "code": 237, "x": 451, "y": 274, "width": 38, "height": 81, "offsetX": -8, "offsetY": -73, "advance": 12.1504 },
+    { "code": 243, "x": 490, "y": 274, "width": 49, "height": 84, "offsetX": -7, "offsetY": -75, "advance": 29.6541 },
+    { "code": 250, "x": 540, "y": 274, "width": 47, "height": 83, "offsetX": -7, "offsetY": -73, "advance": 25.203 },
+    { "code": 193, "x": 588, "y": 274, "width": 47, "height": 82, "offsetX": -10, "offsetY": -74, "advance": 26.0451 },
+    { "code": 201, "x": 636, "y": 274, "width": 44, "height": 85, "offsetX": -8, "offsetY": -76, "advance": 20.5113 },
+    { "code": 205, "x": 681, "y": 274, "width": 42, "height": 82, "offsetX": -9, "offsetY": -74, "advance": 12.0301 },
+    { "code": 211, "x": 724, "y": 274, "width": 51, "height": 85, "offsetX": -7, "offsetY": -76, "advance": 29.6541 },
+    { "code": 218, "x": 776, "y": 274, "width": 48, "height": 85, "offsetX": -7, "offsetY": -75, "advance": 25.203 },
+    { "code": 241, "x": 825, "y": 274, "width": 55, "height": 77, "offsetX": -8, "offsetY": -68, "advance": 27.188 },
+    { "code": 209, "x": 881, "y": 274, "width": 55, "height": 77, "offsetX": -8, "offsetY": -68, "advance": 27.2481 },
+    { "code": 161, "x": 937, "y": 274, "width": 41, "height": 63, "offsetX": -13, "offsetY": -55, "advance": 15.8797 },
+    { "code": 191, "x": 979, "y": 274, "width": 42, "height": 63, "offsetX": -7, "offsetY": -53, "advance": 26.406 },
+    { "code": 252, "x": 0, "y": 360, "width": 51, "height": 78, "offsetX": -7, "offsetY": -68, "advance": 25.203 },
+    { "code": 220, "x": 52, "y": 360, "width": 51, "height": 79, "offsetX": -7, "offsetY": -69, "advance": 25.203 },
+    { "code": 176, "x": 104, "y": 360, "width": 32, "height": 31, "offsetX": -3, "offsetY": -53, "advance": 14.3158 },
+    { "code": 8230, "x": 137, "y": 360, "width": 62, "height": 29, "offsetX": -8, "offsetY": -19, "advance": 46.3759 },
+    { "code": 215, "x": 200, "y": 360, "width": 47, "height": 45, "offsetX": -7, "offsetY": -43, "advance": 28.5714 },
+    { "code": 183, "x": 248, "y": 360, "width": 30, "height": 29, "offsetX": -6, "offsetY": -37, "advance": 12.8722 },
+    { "code": 8211, "x": 279, "y": 360, "width": 38, "height": 28, "offsetX": -6, "offsetY": -34, "advance": 21.6541 },
+    { "code": 8212, "x": 318, "y": 360, "width": 48, "height": 28, "offsetX": -6, "offsetY": -34, "advance": 31.2782 },
+    { "code": 8216, "x": 367, "y": 360, "width": 33, "height": 37, "offsetX": -4, "offsetY": -56, "advance": 12.1504 },
+    { "code": 8217, "x": 401, "y": 360, "width": 33, "height": 36, "offsetX": -4, "offsetY": -56, "advance": 12.1504 },
+    { "code": 8220, "x": 435, "y": 360, "width": 43, "height": 41, "offsetX": -4, "offsetY": -54, "advance": 24.2406 },
+    { "code": 8221, "x": 479, "y": 360, "width": 43, "height": 41, "offsetX": -4, "offsetY": -56, "advance": 24.0602 },
+    { "code": 8226, "x": 523, "y": 360, "width": 35, "height": 38, "offsetX": -6, "offsetY": -41, "advance": 17.0827 }
+  ],
+  "atlasWidth": 1024,
+  "atlasHeight": 439
+}

package/cli/commands/config.ts

@@ -0,0 +1,35 @@
+import { readFileSync, writeFileSync } from "node:fs";
+import { join } from "node:path";
+import { CONFIG_FILE, CliError, type Ctx, loadConfig, print } from "../lib";
+
+// Dotted keys: targets.web.deploy.project
+export async function configCmd(ctx: Ctx, args: string[]): Promise<void> {
+  const [op, key, value] = args;
+  const config = loadConfig();
+  const file = join(config.root, CONFIG_FILE);
+  const raw = JSON.parse(readFileSync(file, "utf8")) as Record<string, unknown>;
+  const parts = key ? key.split(".") : [];
+  if (op === "get" || op === undefined) {
+    let cur: unknown = raw;
+    for (const p of parts) cur = (cur as Record<string, unknown> | undefined)?.[p];
+    if (cur === undefined) throw new CliError("UNKNOWN_KEY", `${key} is not set`, "dotframe config get");
+    print(ctx, { key: key ?? null, value: cur }, (): string => (typeof cur === "string" ? cur : JSON.stringify(cur, null, 2)));
+    return;
+  }
+  if (op !== "set" || !key || value === undefined) throw new CliError("MISSING_ARG", "config set needs <key> <json value>", `dotframe config set targets.ios.device '"00008120-..."'`);
+  let parsed: unknown;
+  try {
+    parsed = JSON.parse(value);
+  } catch {
+    parsed = value;
+  }
+  let cur = raw;
+  for (const p of parts.slice(0, -1)) cur = (cur[p] ??= {}) as Record<string, unknown>;
+  cur[parts[parts.length - 1]] = parsed;
+  if (ctx.dryRun) {
+    print(ctx, { dryRun: true, key, value: parsed }, (): string => `would set ${key} = ${JSON.stringify(parsed)}`);
+    return;
+  }
+  writeFileSync(file, `${JSON.stringify(raw, null, 2)}\n`);
+  print(ctx, { key, value: parsed }, (): string => `${key} = ${JSON.stringify(parsed)}`);
+}

package/cli/commands/doctor.ts

@@ -0,0 +1,71 @@
+import { existsSync, lstatSync, mkdirSync, readlinkSync, symlinkSync, unlinkSync } from "node:fs";
+import { dirname, resolve } from "node:path";
+import { type Config, type Ctx, findRoot, home, loadConfig, print, which } from "../lib";
+import { loadSim } from "../simkit";
+
+interface Check {
+  check: string;
+  ok: boolean;
+  detail: string;
+  fix: string;
+  skill: string;
+}
+
+const tool = (bin: string, why: string, fix: string, skill: string): Check => {
+  const path = which(bin);
+  return { check: `tool:${bin}`, ok: path !== null, detail: path ?? `missing (${why})`, fix: path ? "" : fix, skill };
+};
+
+export async function doctor(ctx: Ctx, fix: boolean): Promise<void> {
+  const checks: Check[] = [tool("bun", "runs the CLI and the web build", "curl -fsSL https://bun.sh/install | bash", "core")];
+  let config: Config | null = null;
+  if (!findRoot()) checks.push({ check: "config", ok: false, detail: "no dotframe.json here or above", fix: "cd into a game repo or dotframe new <name>", skill: "core" });
+  else {
+    try {
+      config = loadConfig();
+      checks.push({ check: "config", ok: true, detail: `${config.root}/dotframe.json`, fix: "", skill: "core" });
+    } catch (error) {
+      checks.push({ check: "config", ok: false, detail: error instanceof Error ? error.message : "unreadable", fix: "fix the JSON", skill: "core" });
+    }
+  }
+  if (config) {
+    if (config.sim) {
+      try {
+        const sim = await loadSim(config);
+        checks.push({ check: "sim", ok: true, detail: `${config.sim} (${sim.players} players)`, fix: "", skill: "core" });
+      } catch (error) {
+        checks.push({ check: "sim", ok: false, detail: error instanceof Error ? error.message : "failed to load", fix: "dotframe skills get core (Sim contract)", skill: "core" });
+      }
+    }
+    const targets = Object.keys(config.targets);
+    if (targets.some((t: string): boolean => t === "web" || t === "discord")) {
+      checks.push(tool("vercel", "deploy web", "npm i -g vercel", "export-web"), tool("agent-browser", "dotframe snap", "npm i -g agent-browser && agent-browser install", "core"));
+    }
+    if (targets.includes("ios") || targets.includes("macos")) checks.push(tool("scriptc", "native builds", "npm i -g scriptc", "macos"));
+    if (targets.includes("ios")) checks.push(tool("xcodegen", "iOS project", "brew install xcodegen", "ios"), tool("xcodebuild", "iOS build", "install Xcode", "ios"));
+    if (config.relay) checks.push(config.relay.provider === "fly" ? tool("fly", "relay deploy", "brew install flyctl && fly auth login", "relay") : tool("vps", "relay deploy", "install the vps CLI and log in to the crafter profile", "relay"));
+    for (const link of config.links ?? []) {
+      const path = resolve(config.root, link.path);
+      const want = home(link.target);
+      let isLink = false;
+      try {
+        isLink = lstatSync(path).isSymbolicLink();
+      } catch {}
+      let ok = existsSync(path) && existsSync(want);
+      let detail = ok ? `${link.path} -> ${isLink ? readlinkSync(path) : "(directory)"}` : `${link.path} missing or broken`;
+      if (!ok && fix && existsSync(want)) {
+        mkdirSync(dirname(path), { recursive: true });
+        if (isLink) unlinkSync(path);
+        symlinkSync(want, path);
+        ok = true;
+        detail = `${link.path} -> ${want} (created)`;
+      }
+      checks.push({ check: `link:${link.path}`, ok, detail, fix: ok ? "" : existsSync(want) ? "dotframe doctor --fix" : `${want} does not exist: run dotframe's scripts/vendor.sh first`, skill: "ios" });
+    }
+  }
+  const failed = checks.filter((c: Check): boolean => !c.ok);
+  print(ctx, { ok: failed.length === 0, checks }, (): string =>
+    checks.map((c: Check): string => `${c.ok ? "ok  " : "FAIL"} ${c.check}: ${c.detail}${c.fix ? `\n     fix: ${c.fix}` : ""}`).join("\n"),
+  );
+  if (failed.length > 0) process.exit(1);
+}

package/cli/commands/new.ts

@@ -0,0 +1,73 @@
+import { cpSync, existsSync, mkdirSync, readdirSync, readFileSync, watch, writeFileSync } from "node:fs";
+import { join, resolve } from "node:path";
+import { CliError, type Ctx, exec, loadConfig, print, runSteps, target } from "../lib";
+
+const TEMPLATES = resolve(import.meta.dir, "../../templates");
+const STUB = `---
+name: dotframe
+description: Build, test, and export this dotframe game. Use when changing gameplay, simulating or replaying frames, checking a render, debugging netplay desyncs, or building and deploying a target.
+---
+Run \`dotframe skills get core\` before any dotframe command. It matches the installed CLI version.
+List the specialized guides with \`dotframe skills list\`.
+`;
+
+export async function create(ctx: Ctx, name: string | undefined, template: string, install = true): Promise<void> {
+  if (!name || !/^[a-z0-9][a-z0-9-]*$/.test(name)) throw new CliError("BAD_NAME", "new needs a lowercase name (letters, digits, dashes)", "dotframe new my-game --template fighter", "game-design");
+  const templates = readdirSync(TEMPLATES).filter((t: string): boolean => !t.startsWith("_"));
+  if (!templates.includes(template)) throw new CliError("UNKNOWN_TEMPLATE", `no template "${template}"`, `available: ${templates.join(", ")}`, "game-design");
+  const dir = resolve(process.cwd(), name);
+  if (existsSync(dir)) throw new CliError("EXISTS", `${dir} already exists`, "pick another name or delete it", "game-design");
+  const files: [string, string][] = [
+    ...readdirSync(join(TEMPLATES, "_base")).map((f: string): [string, string] => [join(TEMPLATES, "_base", f), f === "gitignore" ? ".gitignore" : f]),
+    [join(TEMPLATES, template, "game.ts"), "src/game.ts"],
+  ];
+  if (ctx.dryRun) {
+    print(ctx, { dryRun: true, dir, template, files: files.map(([, to]) => to) }, (): string => `would create ${dir} (${template}): ${files.map(([, to]) => to).join(", ")}`);
+    return;
+  }
+  for (const [from, to] of files) {
+    mkdirSync(join(dir, to, ".."), { recursive: true });
+    writeFileSync(join(dir, to), readFileSync(from, "utf8").replaceAll("__NAME__", name).replaceAll("__SCOPE__", "your-vercel-team"));
+  }
+  mkdirSync(join(dir, ".agents/skills/dotframe"), { recursive: true });
+  writeFileSync(join(dir, ".agents/skills/dotframe/SKILL.md"), STUB);
+  mkdirSync(join(dir, "replays"), { recursive: true });
+  const steps = [
+    { label: "git init", argv: ["git", "init", "-q"] },
+    ...(install ? [{ label: "install", argv: ["bun", "install"] }] : []),
+  ];
+  for (const step of steps) {
+    const r = await exec(ctx, dir, step);
+    if (r.code !== 0) throw new CliError("STEP_FAILED", `${step.label}: ${r.tail}`, "on a machine with a private registry, run bun install --registry https://registry.npmjs.org", "game-design");
+  }
+  print(ctx, { dir, template, next: [`cd ${name}`, "dotframe sim --mash 7 --json", "dotframe dev"] }, (): string => `created ${dir} (${template})\nnext: cd ${name} && dotframe sim --mash 7 && dotframe dev`);
+}
+
+// Builds the web target, serves it, and rebuilds when source changes. For humans; agents use sim and snap.
+export async function dev(ctx: Ctx, port: number): Promise<void> {
+  const config = loadConfig();
+  const t = target(config, "web");
+  if (!t.out) throw new CliError("NO_OUT", "the web target needs an out dir", "", "export-web");
+  const out = resolve(config.root, t.out);
+  await runSteps(ctx, config.root, t.steps, "export-web");
+  const server = Bun.serve({
+    port,
+    fetch: (req: Request): Response => {
+      const path = decodeURIComponent(new URL(req.url).pathname);
+      return new Response(Bun.file(join(out, path === "/" ? "index.html" : path)));
+    },
+  });
+  console.error(`serving ${out} at http://localhost:${server.port}`);
+  let pending: ReturnType<typeof setTimeout> | null = null;
+  watch(config.root, { recursive: true }, (_event, file): void => {
+    if (!file || /(^|\/)(node_modules|dist|\.dotframe|\.git)\//.test(`${file}/`) || file.startsWith(t.out ?? "dist")) return;
+    if (pending) clearTimeout(pending);
+    pending = setTimeout((): void => {
+      runSteps(ctx, config.root, t.steps, "export-web").then(
+        (): void => console.error(`rebuilt (${file})`),
+        (e: unknown): void => console.error(e instanceof Error ? e.message : e),
+      );
+    }, 150);
+  });
+  await new Promise((): void => {});
+}