@bitmagic/cli 0.1.52-dev.9 → 0.1.53-dev.0

package/dist/publish/platform.js

@@ -1,11 +1,13 @@
-import * as fs from 'node:fs';
-import * as path from 'node:path';
-import { aliasSourceDir } from '../scaffold/aliases.js';
+import { readPlatformDeclaration } from '../project/platform-declaration.js';
 /**
  * The platform indicators a publish syncs from the project's own work copy: which platform the
  * game is FOR (`primaryPlatform`, top level of game.json) and, for a phone game that only makes
  * sense one way up, `worldProfileData.mobileOrientation`.
  *
+ * The parse itself lives in `project/platform-declaration.ts`, shared with `bitmagic verify`,
+ * which boots the platform the same two fields declare. What stays HERE is the wire semantics,
+ * which are publish's alone.
+ *
  * The project files are the source of truth, exactly as they are in the web lane — the columns
  * are "indicators synced from game.json at publish, like `genre`" (migration 048). So a value
  * changed anywhere else is reverted by the creator's next publish, and the way to make a game
@@ -22,44 +24,29 @@ import { aliasSourceDir } from '../scaffold/aliases.js';
  *    the key instead would make an orientation impossible to remove from here. Only a work copy
  *    neither of whose files can be read omits the key.
  *
- * world.json wins over game.json for the orientation, matching the web lane's own resolution
- * (`game-storage-backend.ts`'s `getListingFieldsSync`). Note this is the OPPOSITE order to
- * `readFaviconOverride` in favicon.ts, which reads game.json first — the favicon override's home
- * is game.json, the orientation's is world.json, and neither order is a house style.
- *
- * The legacy `mainPlatform` spelling is NOT honoured: it predates the CLI lane entirely, so no
- * project this reads can carry it.
- *
  * Best effort throughout, like `readFaviconOverride`: a missing, unreadable or malformed file
  * means "the project declares nothing", never an error. A catalog indicator must not be able to
  * fail a publish whose bundle is already uploaded.
  */
 export function readPlatformIndicators(root) {
-    const workDir = path.join(root, aliasSourceDir('work'));
-    const game = readJsonObject(path.join(workDir, 'game.json'));
-    const world = readJsonObject(path.join(workDir, 'world.json'));
+    const declaration = readPlatformDeclaration(root);
     const fields = {};
     const notes = [];
-    const declared = game?.primaryPlatform;
-    if (declared === 'desktop' || declared === 'mobile') {
-        fields.primaryPlatform = declared;
+    if (declaration.primaryPlatform !== undefined) {
+        fields.primaryPlatform = declaration.primaryPlatform;
+    }
+    if (declaration.workCopyReadable) {
+        // Explicit null when the work copy is readable but declares nothing — see the doc comment.
+        fields.mobileOrientation = declaration.mobileOrientation ?? null;
     }
-    else if (declared !== undefined) {
-        notes.push(`game.json primaryPlatform ${JSON.stringify(declared)} is not "desktop" or "mobile" — ` +
-            'leaving the stored platform alone.');
+    const { rejected } = declaration;
+    if ('primaryPlatform' in rejected) {
+        notes.push(`game.json primaryPlatform ${JSON.stringify(rejected.primaryPlatform)} is not "desktop" `
+            + 'or "mobile" — leaving the stored platform alone.');
     }
-    if (world !== null || game !== null) {
-        const orientation = worldProfileValue(world, 'mobileOrientation') ?? worldProfileValue(game, 'mobileOrientation');
-        if (orientation === 'portrait' || orientation === 'landscape') {
-            fields.mobileOrientation = orientation;
-        }
-        else {
-            if (orientation !== undefined) {
-                notes.push(`worldProfileData.mobileOrientation ${JSON.stringify(orientation)} is not "portrait" ` +
-                    'or "landscape" — publishing with no orientation lock.');
-            }
-            fields.mobileOrientation = null;
-        }
+    if ('mobileOrientation' in rejected) {
+        notes.push(`worldProfileData.mobileOrientation ${JSON.stringify(rejected.mobileOrientation)} is not `
+            + '"portrait" or "landscape" — publishing with no orientation lock.');
     }
     if (fields.primaryPlatform === 'mobile') {
         notes.push(fields.mobileOrientation
@@ -68,25 +55,4 @@ export function readPlatformIndicators(root) {
     }
     return { fields, notes };
 }
-/** Parse one work-copy JSON file, or null when it is missing, unreadable or not an object. */
-function readJsonObject(filePath) {
-    let parsed;
-    try {
-        if (!fs.existsSync(filePath))
-            return null;
-        parsed = JSON.parse(fs.readFileSync(filePath, 'utf-8'));
-    }
-    catch {
-        return null;
-    }
-    return typeof parsed === 'object' && parsed !== null && !Array.isArray(parsed)
-        ? parsed
-        : null;
-}
-function worldProfileValue(source, key) {
-    const profile = source?.worldProfileData;
-    if (typeof profile !== 'object' || profile === null || Array.isArray(profile))
-        return undefined;
-    return profile[key];
-}
 //# sourceMappingURL=platform.js.map

package/dist/publish/platform.js.map

@@ -1 +1 @@
-{"version":3,"file":"platform.js","sourceRoot":"","sources":["../../src/publish/platform.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,SAAS,CAAC;AAC9B,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAClC,OAAO,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAgBxD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AACH,MAAM,UAAU,sBAAsB,CAAC,IAAY;IACjD,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,cAAc,CAAC,MAAM,CAAC,CAAC,CAAC;IACxD,MAAM,IAAI,GAAG,cAAc,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,WAAW,CAAC,CAAC,CAAC;IAC7D,MAAM,KAAK,GAAG,cAAc,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,YAAY,CAAC,CAAC,CAAC;IAE/D,MAAM,MAAM,GAAuB,EAAE,CAAC;IACtC,MAAM,KAAK,GAAa,EAAE,CAAC;IAE3B,MAAM,QAAQ,GAAG,IAAI,EAAE,eAAe,CAAC;IACvC,IAAI,QAAQ,KAAK,SAAS,IAAI,QAAQ,KAAK,QAAQ,EAAE,CAAC;QACpD,MAAM,CAAC,eAAe,GAAG,QAAQ,CAAC;IACpC,CAAC;SAAM,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;QAClC,KAAK,CAAC,IAAI,CACR,6BAA6B,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,kCAAkC;YACrF,oCAAoC,CACvC,CAAC;IACJ,CAAC;IAED,IAAI,KAAK,KAAK,IAAI,IAAI,IAAI,KAAK,IAAI,EAAE,CAAC;QACpC,MAAM,WAAW,GAAG,iBAAiB,CAAC,KAAK,EAAE,mBAAmB,CAAC,IAAI,iBAAiB,CAAC,IAAI,EAAE,mBAAmB,CAAC,CAAC;QAClH,IAAI,WAAW,KAAK,UAAU,IAAI,WAAW,KAAK,WAAW,EAAE,CAAC;YAC9D,MAAM,CAAC,iBAAiB,GAAG,WAAW,CAAC;QACzC,CAAC;aAAM,CAAC;YACN,IAAI,WAAW,KAAK,SAAS,EAAE,CAAC;gBAC9B,KAAK,CAAC,IAAI,CACR,sCAAsC,IAAI,CAAC,SAAS,CAAC,WAAW,CAAC,qBAAqB;oBACpF,uDAAuD,CAC1D,CAAC;YACJ,CAAC;YACD,MAAM,CAAC,iBAAiB,GAAG,IAAI,CAAC;QAClC,CAAC;IACH,CAAC;IAED,IAAI,MAAM,CAAC,eAAe,KAAK,QAAQ,EAAE,CAAC;QACxC,KAAK,CAAC,IAAI,CACR,MAAM,CAAC,iBAAiB;YACtB,CAAC,CAAC,yCAAyC,MAAM,CAAC,iBAAiB,GAAG;YACtE,CAAC,CAAC,6BAA6B,CAClC,CAAC;IACJ,CAAC;IAED,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC;AAC3B,CAAC;AAED,8FAA8F;AAC9F,SAAS,cAAc,CAAC,QAAgB;IACtC,IAAI,MAAe,CAAC;IACpB,IAAI,CAAC;QACH,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,QAAQ,CAAC;YAAE,OAAO,IAAI,CAAC;QAC1C,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,YAAY,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC,CAAC;IAC1D,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;IACD,OAAO,OAAO,MAAM,KAAK,QAAQ,IAAI,MAAM,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC;QAC5E,CAAC,CAAE,MAAkC;QACrC,CAAC,CAAC,IAAI,CAAC;AACX,CAAC;AAED,SAAS,iBAAiB,CAAC,MAAsC,EAAE,GAAW;IAC5E,MAAM,OAAO,GAAG,MAAM,EAAE,gBAAgB,CAAC;IACzC,IAAI,OAAO,OAAO,KAAK,QAAQ,IAAI,OAAO,KAAK,IAAI,IAAI,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC;QAAE,OAAO,SAAS,CAAC;IAChG,OAAQ,OAAmC,CAAC,GAAG,CAAC,CAAC;AACnD,CAAC"}
+{"version":3,"file":"platform.js","sourceRoot":"","sources":["../../src/publish/platform.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,uBAAuB,EAAE,MAAM,oCAAoC,CAAC;AAgB7E;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,MAAM,UAAU,sBAAsB,CAAC,IAAY;IACjD,MAAM,WAAW,GAAG,uBAAuB,CAAC,IAAI,CAAC,CAAC;IAElD,MAAM,MAAM,GAAuB,EAAE,CAAC;IACtC,MAAM,KAAK,GAAa,EAAE,CAAC;IAE3B,IAAI,WAAW,CAAC,eAAe,KAAK,SAAS,EAAE,CAAC;QAC9C,MAAM,CAAC,eAAe,GAAG,WAAW,CAAC,eAAe,CAAC;IACvD,CAAC;IAED,IAAI,WAAW,CAAC,gBAAgB,EAAE,CAAC;QACjC,2FAA2F;QAC3F,MAAM,CAAC,iBAAiB,GAAG,WAAW,CAAC,iBAAiB,IAAI,IAAI,CAAC;IACnE,CAAC;IAED,MAAM,EAAE,QAAQ,EAAE,GAAG,WAAW,CAAC;IACjC,IAAI,iBAAiB,IAAI,QAAQ,EAAE,CAAC;QAClC,KAAK,CAAC,IAAI,CACR,6BAA6B,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,eAAe,CAAC,oBAAoB;cACrF,kDAAkD,CACvD,CAAC;IACJ,CAAC;IACD,IAAI,mBAAmB,IAAI,QAAQ,EAAE,CAAC;QACpC,KAAK,CAAC,IAAI,CACR,sCAAsC,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,iBAAiB,CAAC,UAAU;cACtF,kEAAkE,CACvE,CAAC;IACJ,CAAC;IAED,IAAI,MAAM,CAAC,eAAe,KAAK,QAAQ,EAAE,CAAC;QACxC,KAAK,CAAC,IAAI,CACR,MAAM,CAAC,iBAAiB;YACtB,CAAC,CAAC,yCAAyC,MAAM,CAAC,iBAAiB,GAAG;YACtE,CAAC,CAAC,6BAA6B,CAClC,CAAC;IACJ,CAAC;IAED,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC;AAC3B,CAAC"}

package/dist/scaffold/project-files.js

@@ -647,11 +647,17 @@ are configured in **code** — there is no panel for them.
   …)\` for a gameplay action. The first strands phone players and the engine logs a
   \`[mobile-parity]\` error on game start; the raw listener strands them **silently** — the parity
   check cannot see a listener that never went through the engine.
+- **\`bitmagic verify\` enforces this.** Every run reports the parity gaps, naming the key and the
+  system that registered it — a warning normally, and a **failure** on a game whose
+  \`primaryPlatform\` is \`mobile\`. \`bitmagic verify --platform mobile\` goes further and boots
+  the game as a phone: touch controls, phone viewport, the engine's real mobile branch.
 - **Say which platform the game is for.** \`"primaryPlatform": "mobile"\` at the top level of
   \`src/work/game.json\` is what bitmagic.ai catalogs it as, and \`bitmagic publish\` sends it —
-  editing that file is the only way to set it. For a game that only works one way up, add
-  \`"mobileOrientation": "portrait"\` (or \`"landscape"\`) to \`worldProfileData\` in
-  \`src/work/world.json\`; published mobile builds lock to it.
+  editing that file is the only way to set it. It also decides what \`verify\` boots and \`judge\`
+  grades by default, so setting it is how a phone game gets checked as one. For a game that only
+  works one way up, add \`"mobileOrientation": "portrait"\` (or \`"landscape"\`) to
+  \`worldProfileData\` in \`src/work/world.json\`; published mobile builds lock to it, and the
+  mobile verify run turns the phone the same way.
 
 Details — button slots, icons, the joystick, the parity check: \`engine/agent-docs/control-system.md\`.
 
@@ -661,6 +667,7 @@ Details — button slots, icons, the joystick, the parity check: \`engine/agent-
 bitmagic check     # typecheck against the vendored engine
 bitmagic reload    # tell the open browser you have finished a round of edits
 bitmagic verify    # boot the game in a real browser and report what broke
+bitmagic verify --platform mobile   # boot it as a phone: touch controls, phone viewport
 bitmagic judge     # grade the verify screenshot against a quality rubric (paid, cheap)
 \`\`\`
 
@@ -751,7 +758,8 @@ bitmagic publish    # verify-gate, build if needed, and ship to bitmagic.ai
 Follow this order; \`publish\` enforces it and refuses otherwise:
 
 1. Run \`bitmagic verify\` and get it passing. It writes \`.bitmagic/verify/result.json\`,
-   \`.bitmagic/verify/screenshot.png\` and \`.bitmagic/verify/console.log\`.
+   \`.bitmagic/verify/screenshot.png\` and \`.bitmagic/verify/console.log\` — or the
+   \`.mobile\`-suffixed names when the run was a phone one.
 
    The publish thumbnail is \`.bitmagic/cover.webp\` when \`bitmagic cover\` has produced one, and
    that screenshot otherwise. The output names which one it used.
@@ -815,14 +823,16 @@ are developing, when rebuilding is cheap, rather than being blocked at the momen
 You can create game content from here — no web editor needed:
 
 \`\`\`
-bitmagic generate skybox    --description "a stormy alien sky with two moons"
-bitmagic generate sound     --prompt "heavy wooden door slamming" [--duration 3] [--loop]
-bitmagic generate image     --name hero-portrait --prompt "..." [--width 512] [--height 512]
-bitmagic generate character --name guard --prompt "..." [--apply-to-player]
-bitmagic generate animation --family gait --name LimpStride --based-on walk [--dial limpSide=right]
-bitmagic generate animation --spec clip.json          # melee and oneShot clips: a spec file
-bitmagic generate model     --prompt "a mossy stone arch" [--height 3]
-bitmagic generate vehicle   --prompt "a rusty orange pickup" | --preset VAN
+bitmagic generate skybox     --description "a stormy alien sky with two moons"
+bitmagic generate background --description "layered pine forest at dusk"
+bitmagic generate block-type --name mossy_brick --description "damp green moss on red brick"
+bitmagic generate sound      --prompt "heavy wooden door slamming" [--duration 3] [--loop]
+bitmagic generate image      --name hero-portrait --prompt "..." [--width 512] [--height 512]
+bitmagic generate character  --name guard --prompt "..." [--apply-to-player]
+bitmagic generate animation  --family gait --name LimpStride --based-on walk [--dial limpSide=right]
+bitmagic generate animation  --spec clip.json          # melee and oneShot clips: a spec file
+bitmagic generate model      --prompt "a mossy stone arch" [--height 3]
+bitmagic generate vehicle    --prompt "a rusty orange pickup" | --preset VAN
 \`\`\`
 
 Run \`bitmagic generate <type> --help\` for the full flags of any one.
@@ -843,9 +853,8 @@ Four things worth knowing before you use these:
    the write settles; \`bitmagic reload\` forces it if you want it now.
 
 Three lanes make a 3D object, and the wrong one wastes a generation: \`generate model\` mints a NEW
-asset from a prompt, \`generate prop --asset <id>\` UPGRADES a placeholder (every instance changes
-with it), \`assets add <file>\` uploads one you already have. **Block types** are the one thing no
-subcommand makes; never hand-edit \`world.json\` to point at an asset you have not made.
+asset, \`generate prop --asset <id>\` UPGRADES a placeholder, \`assets add <file>\` uploads your own.
+Splats, video and \`.vox\`/\`.fbx\` still need the web editor; never reference an asset you did not make.
 
 ## Forging a whole level
 
@@ -1004,7 +1013,8 @@ that I would otherwise have defaulted differently.
 
 ## Platform
 \`primaryPlatform\` in \`game.json\` — \`desktop\` or \`mobile\`. Plus \`worldProfileData.mobileOrientation\`
-in \`world.json\` when the game only works one way up.
+in \`world.json\` when the game only works one way up. If \`mobile\`: every action needs a touch
+button, and \`bitmagic verify\` fails the run otherwise.
 
 ## Slice 1 — the smallest playable thing
 - Core verb:          the ONE thing the player does
@@ -1203,7 +1213,7 @@ These docs are shared with Bitmagic's hosted agent, so two things read oddly her
   |---|---|
   | \`configure_game\`, \`manage-achievements\`, \`manage-levels\`, \`spawnpoint upsert\` | edit \`src/work/world.json\` directly |
   | \`node bin/voxel.mjs\` / \`bin/world-edit.mjs\` | edit \`src/work/world.json\` directly |
-  | \`generate_character\`, \`design-vehicle\`, skybox/sound/image/animation generation | \`bitmagic generate <type>\` |
+  | \`generate_character\`, \`design-vehicle\`, \`generateBlockTypeTool\`, \`backgroundImageGenerationTool\`, skybox/sound/image/animation generation | \`bitmagic generate <type>\` |
   | \`runWorldForger\` / \`run-world-forger\` | \`bitmagic forge\` |
 
   Everything else in the doc — the engine APIs, the world.json shape, the gotchas — still applies.
@@ -1254,16 +1264,18 @@ you work. Re-read it before editing it.
 export function renderGenerateSkill() {
     return `---
 name: generating-assets
-description: Use when this Bitmagic game needs a new skybox, sound effect, image, character, animation or drivable vehicle, or when the creator has a model, sound, image or .vxl file of their own to add — anything that would otherwise require the web editor.
+description: Use when this Bitmagic game needs a new skybox, 2D background, custom block type, sound effect, image, character, animation or drivable vehicle, or when the creator has a model, sound, image or .vxl file of their own to add — anything that would otherwise require the web editor.
 ---
 
 # Generating game assets
 
-The \`bitmagic\` CLI generates content directly into this project. Seven types work today:
+The \`bitmagic\` CLI generates content directly into this project. Nine types work today:
 
 | Command | Makes | Lands in |
 |---|---|---|
 | \`bitmagic generate skybox --description "..."\` | a 360° environment | \`worldProfileData.skyboxUrl\` |
+| \`bitmagic generate background --description "..."\` | a flat 2D backdrop | \`worldProfileData.skyboxUrl\` |
+| \`bitmagic generate block-type --name <id> --description "..."\` | a custom voxel block | \`worldProfileData.customBlockTypes[]\` |
 | \`bitmagic generate sound --prompt "..."\` | a sound effect | \`assets[]\` |
 | \`bitmagic generate image --name <id> --prompt "..."\` | a 2D image | \`assets[]\` |
 | \`bitmagic generate character --name <id> --prompt "..."\` | a rigged character | \`assets[]\` |
@@ -1297,6 +1309,21 @@ engine.getVehicleSpawner().spawnAndEnterFromAsset({ x: 0, z: 0 }, '<assetName>',
 
 Headlights, taillights and beacons are built and lit automatically — never ask for them.
 
+\`background\` and \`skybox\` write the **same field**. Pick one: \`skybox\` for a 360° panorama a
+free-look camera can turn in, \`background\` for a flat layered backdrop behind a fixed sidescroller
+or top-down camera. The engine wraps either onto the sky sphere, so a flat backdrop reads as a
+distant painted horizon rather than a full-screen image — and running one after the other replaces
+the first, silently.
+
+\`block-type\` registers a block **before** anything can use it: \`--name\` is what
+\`create-voxel-asset\`, \`groundConfig.surfaceBlockType\` and building code refer to, and an
+unrecognised name falls back to flat vertex colour instead of failing. Names are lowercase
+snake_case, are compared case-insensitively, and cannot shadow a built-in (\`wood\`, \`leaves\`,
+\`stone\`, \`grass\`, \`sand\`, \`dirt\`, \`ice\`, \`asphalt\`, \`water\`, \`lava\`, \`marble\`, or the
+aliases \`trunk\`, \`foliage\`, \`rock\`, \`road\`). Re-running with the same \`--name\` **replaces**
+the entry rather than adding a second one. \`--side-description\` gives the side faces their own
+texture and generates a second one.
+
 Cover art is the one generation that is **not** a \`generate\` subcommand:
 
 | Command | Makes | Lands in |
@@ -1352,7 +1379,8 @@ assets list\` shows what is there; \`bitmagic assets remove <id>\` takes one out
 
 ## What is not available
 
-**Block types** are the one thing no subcommand makes — those still need the web editor. Do not
+Gaussian splats, video, and the import formats \`assets add\` refuses (\`.gltf\`, \`.vox\`, \`.qb\`,
+\`.fbx\`, \`.spz\`, \`.ply\`, \`.sog\`, \`.mp4\`) still need the web editor's Assets tab. Do not
 hand-edit \`world.json\` to reference an asset you have neither generated nor added; the game will
 fail to load it.
 `;
@@ -1449,6 +1477,7 @@ description: Use after finishing a milestone — a mechanics-plan slice shipped,
 bitmagic verify              # first: captures the screenshot the judge grades (no --fast)
 bitmagic judge               # one vision-model call; prints a scorecard, exits 0
 bitmagic judge --genre platformer   # sharpen the rubric: platformer, racing, shooter, combat, driving, tower-defense
+bitmagic judge --platform mobile   # grade the phone frame: touch-HUD legibility, thumb reach, portrait framing
 bitmagic judge --min-score 7 # exit 4 when the overall score is below the bar
 bitmagic judge --json        # the scorecard as one JSON document on stdout
 \`\`\`
@@ -1459,6 +1488,10 @@ model and prints back four dimension scores (visual-quality, readability, design
 and at most three findings — each naming what to change, most severe first. The scorecard is also
 written to \`.bitmagic/judge.json\`.
 
+A mobile-primary game is graded on its phone frame by default — the one
+\`bitmagic verify --platform mobile\` captured — with the rubric re-pointed at what a phone player
+sees. Pass \`--platform desktop\` to grade the other one.
+
 It is paid (sparks, roughly the cost of one small model call) and deliberate — which is why it is
 a command you run, not something verify does for you.
 
@@ -1541,7 +1574,7 @@ are lost on the next upgrade.
 |---|---|
 | \`planning-a-game/\` | starting a game, a genre, or anything touching more than one gameplay feature — scoping the first playable slice and writing \`mechanics-plan.md\` |
 | \`finding-engine-apis/\` | you need an engine API and do not know its name or signature, or \`bitmagic check\` cannot resolve a symbol |
-| \`generating-assets/\` | the game needs a skybox, sound, image, character, animation or vehicle |
+| \`generating-assets/\` | the game needs a skybox, a background, a custom block type, sound, image, character, animation or vehicle |
 | \`checking-usage/\` | asked what sparks were spent on, how much Pro allowance is left, or whether there is enough left to keep generating |
 | \`judging-quality/\` | a milestone is done and the game deserves an independent quality verdict — \`bitmagic judge\` |
 

package/dist/scaffold/project-files.js.map

@@ -1 +1 @@
-{"version":3,"file":"project-files.js","sourceRoot":"","sources":["../../src/scaffold/project-files.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"project-files.js","sourceRoot":"","sources":["../../src/scaffold/project-files.ts"],"names":[],"mappings":"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"}

package/dist/verify/artifacts.d.ts

@@ -0,0 +1,19 @@
+import type { VerifyPlatform } from './platform.js';
+export interface VerifyArtifactPaths {
+    /** The publish thumbnail candidate on desktop. Not written by a `--fast` run. */
+    screenshotPath: string;
+    consolePath: string;
+    /** Where the automatic software-GL re-run's console goes, so the first run's evidence survives. */
+    retryConsolePath: string;
+}
+export declare function verifyArtifactPaths(artifactDir: string, platform: VerifyPlatform): VerifyArtifactPaths;
+export declare const VERIFY_PLATFORMS: VerifyPlatform[];
+/**
+ * Every screenshot any platform could write.
+ *
+ * A run deletes the ones it is not going to produce, extending the rule `--fast` already follows:
+ * a stale screenshot beside a fresh `result.json` is worse than none, because publish would ship
+ * a picture of some earlier state of the game — and after this change "earlier state" includes
+ * "the other platform, from an older run".
+ */
+export declare function allVerifyScreenshotPaths(artifactDir: string): string[];

package/dist/verify/artifacts.js

@@ -0,0 +1,34 @@
+/**
+ * What a verify run writes, per platform.
+ *
+ * One place, because a `both` run writes two of everything and the desktop names are a contract
+ * with two other commands: `bitmagic publish` reads `screenshot.png` as its thumbnail fallback
+ * and `bitmagic judge` grades it. Desktop therefore keeps exactly the names it has always had,
+ * and mobile infixes `.mobile` before the extension.
+ *
+ * A per-platform CONSOLE log is not cosmetic. Without it a `both` run would overwrite the desktop
+ * console — by far the most useful artifact when something breaks — with the mobile one, and the
+ * run would look like it only ever booted a phone.
+ */
+import * as path from 'path';
+export function verifyArtifactPaths(artifactDir, platform) {
+    const suffix = platform === 'mobile' ? '.mobile' : '';
+    return {
+        screenshotPath: path.join(artifactDir, `screenshot${suffix}.png`),
+        consolePath: path.join(artifactDir, `console${suffix}.log`),
+        retryConsolePath: path.join(artifactDir, `console.retry${suffix}.log`),
+    };
+}
+export const VERIFY_PLATFORMS = ['desktop', 'mobile'];
+/**
+ * Every screenshot any platform could write.
+ *
+ * A run deletes the ones it is not going to produce, extending the rule `--fast` already follows:
+ * a stale screenshot beside a fresh `result.json` is worse than none, because publish would ship
+ * a picture of some earlier state of the game — and after this change "earlier state" includes
+ * "the other platform, from an older run".
+ */
+export function allVerifyScreenshotPaths(artifactDir) {
+    return VERIFY_PLATFORMS.map((platform) => verifyArtifactPaths(artifactDir, platform).screenshotPath);
+}
+//# sourceMappingURL=artifacts.js.map

package/dist/verify/artifacts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"artifacts.js","sourceRoot":"","sources":["../../src/verify/artifacts.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,OAAO,KAAK,IAAI,MAAM,MAAM,CAAC;AAW7B,MAAM,UAAU,mBAAmB,CACjC,WAAmB,EACnB,QAAwB;IAExB,MAAM,MAAM,GAAG,QAAQ,KAAK,QAAQ,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC;IACtD,OAAO;QACL,cAAc,EAAE,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,aAAa,MAAM,MAAM,CAAC;QACjE,WAAW,EAAE,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,UAAU,MAAM,MAAM,CAAC;QAC3D,gBAAgB,EAAE,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,gBAAgB,MAAM,MAAM,CAAC;KACvE,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,MAAM,gBAAgB,GAAqB,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;AAExE;;;;;;;GAOG;AACH,MAAM,UAAU,wBAAwB,CAAC,WAAmB;IAC1D,OAAO,gBAAgB,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,mBAAmB,CAAC,WAAW,EAAE,QAAQ,CAAC,CAAC,cAAc,CAAC,CAAC;AACvG,CAAC"}

package/dist/verify/browser.d.ts

@@ -1,5 +1,6 @@
 import { type BrowserLaunchPlan, type RendererChoice } from '../browser-gl.js';
 import { type VerifyObservations } from './classify.js';
+import type { VerifyDeviceOptions } from './device.js';
 export interface StartInteractionOptions {
     /** Selector for the engine Play button. Its label is localizable and per-game overridable, so
      *  never match by text. */
@@ -56,6 +57,15 @@ export interface HeadlessCheckOptions {
      * `browserGlArgs(process.env)`. `--mute-audio` is always added here, not by callers.
      */
     launch?: BrowserLaunchPlan;
+    /**
+     * Emulate a phone for this check — viewport, screen, deviceScaleFactor, `isMobile` and
+     * `hasTouch` from `verify/device.ts`. Absent means the desktop 1280x720 context, byte-identical
+     * to what every run did before this existed, which is what `publish`'s smoke check keeps using.
+     *
+     * Pair it with a `?platform=mobile` URL: this side makes the BROWSER a phone, that side makes
+     * the ENGINE take its mobile branch, and only both together verify what a player gets.
+     */
+    device?: VerifyDeviceOptions;
     /**
      * Capture the screenshot and measure its pixels (default true). `bitmagic verify --fast`
      * turns this off for the inner loop: `screenshotBytes`/`canvasFrame` come back null and

package/dist/verify/browser.js

@@ -3,6 +3,7 @@ import { chromium } from 'playwright-core';
 import { browserGlArgs } from '../browser-gl.js';
 import { CliError } from '../errors.js';
 import { RESPAWN_LINE, } from './classify.js';
+import { parseMobileParityGap } from './mobile-parity.js';
 import { DEFAULT_SETTLE_CONFIG, SETTLE_POLL_MS, isFreefalling, settleVerdict, } from './settle.js';
 import { deriveEventsObservation } from './events.js';
 export const DEFAULT_START_INTERACTION = {
@@ -66,7 +67,8 @@ export class VerifyBrowserSession {
         // browser phase throws (e.g. page.goto timing out) — artifacts are the point of a failing run.
         const consoleLines = [];
         const pageErrors = [];
-        const context = await this.browser.newContext({ viewport: { width: 1280, height: 720 } });
+        const contextOptions = options.device ?? DESKTOP_CONTEXT_OPTIONS;
+        const context = await this.browser.newContext(contextOptions);
         try {
             const page = await context.newPage();
             await armContextLossProbe(page);
@@ -82,7 +84,7 @@ export class VerifyBrowserSession {
                 // worth having. The console log (written in `finally` below) is the useful artifact here.
                 if (options.captureScreenshot !== false) {
                     try {
-                        fs.writeFileSync(options.screenshotPath, await page.screenshot());
+                        fs.writeFileSync(options.screenshotPath, await page.screenshot(SCREENSHOT_OPTIONS));
                     }
                     catch {
                         // Page may already be unusable (closed context, crashed renderer) — nothing to save.
@@ -93,7 +95,7 @@ export class VerifyBrowserSession {
             }
             const interaction = options.startInteraction === undefined
                 ? null
-                : await performStartInteraction(page, consoleLines, options.startInteraction);
+                : await performStartInteraction(page, consoleLines, options.startInteraction, options.device?.hasTouch === true);
             // Verify settles adaptively — a game that provably reached stable gameplay is observed
             // after a few seconds instead of the full fixed window, with `settleMs` as the hard cap.
             // The smoke check keeps the fixed wait: its game lives in an iframe this probe does not
@@ -142,7 +144,7 @@ export class VerifyBrowserSession {
             let screenshotBytes = null;
             let canvasFrame = null;
             if (options.captureScreenshot !== false) {
-                const screenshotBuffer = await page.screenshot();
+                const screenshotBuffer = await page.screenshot(SCREENSHOT_OPTIONS);
                 fs.writeFileSync(options.screenshotPath, screenshotBuffer);
                 screenshotBytes = screenshotBuffer.length;
                 canvasFrame = canvas === null
@@ -176,6 +178,9 @@ export class VerifyBrowserSession {
                     menuVisibleAfterSettle: await isMenuVisible(page),
                 };
             }
+            // Only meaningful on a run that emulated a phone: on desktop the engine never builds
+            // MobileControls at all, so zero affordances there is the correct state, not a finding.
+            const touchControls = options.device === undefined ? undefined : await countTouchAffordances(page);
             return {
                 consoleLines,
                 pageErrors,
@@ -188,6 +193,13 @@ export class VerifyBrowserSession {
                 snapshot,
                 settle,
                 events,
+                touchControls,
+                viewport: contextOptions.viewport,
+                // From the console this run already captured — the engine logs the check on every game
+                // start, desktop included (see verify/mobile-parity.ts). Behind the same gate as the
+                // snapshot and event probes: the check only runs at game start, so a run that never
+                // starts one has observed nothing, and `publish`'s smoke check keeps its exact shape.
+                mobileParity: engineTarget === null ? undefined : parseMobileParityGap(consoleLines),
             };
         }
         finally {
@@ -199,6 +211,19 @@ export class VerifyBrowserSession {
         }
     }
 }
+/**
+ * Every capture, on every platform.
+ *
+ * `scale: 'css'` rather than Playwright's default `'device'` because a phone context runs at
+ * deviceScaleFactor 3, and `measureCanvasFrame` below samples the captured image using the
+ * canvas's CSS-pixel rect. At device scale those coordinates would be off by 3x and the
+ * black-frame check would measure the wrong region of the image entirely. CSS scale keeps that
+ * invariant true on both paths — at DSF 1 the two are identical, so the desktop artifact is
+ * unchanged — and keeps the mobile PNG small enough for `bitmagic judge`'s image limit.
+ */
+const SCREENSHOT_OPTIONS = { scale: 'css' };
+/** The context every run used before device emulation existed, and still the default. */
+const DESKTOP_CONTEXT_OPTIONS = { viewport: { width: 1280, height: 720 } };
 /** Window counter the init script below increments on every rAF tick. */
 const FRAME_COUNT_FLAG = '__bitmagicFrameCount';
 /**
@@ -505,8 +530,10 @@ async function measureCanvasFrame(page, screenshot, rect) {
             const image = new Image();
             image.src = input.dataUrl;
             await image.decode();
-            // The screenshot is a viewport capture at deviceScaleFactor 1, so its pixels are the
-            // page's CSS pixels; clamp to the image in case the canvas overhangs the viewport.
+            // The screenshot is a viewport capture taken at CSS scale (`SCREENSHOT_OPTIONS`), so its
+            // pixels are the page's CSS pixels whatever the device pixel ratio — which is what lets
+            // this rect, read from getBoundingClientRect, index straight into the image on a phone
+            // context at deviceScaleFactor 3. Clamp in case the canvas overhangs the viewport.
             const left = Math.max(0, input.left);
             const top = Math.max(0, input.top);
             const width = Math.min(input.width, image.naturalWidth - left);
@@ -563,7 +590,8 @@ function hasStartMarker(consoleLines, marker) {
     return consoleLines.some((line) => line.includes(marker));
 }
 /**
- * Start gameplay the way a player does: wait for the engine Play button and click it. The button
+ * Start gameplay the way a player does: wait for the engine Play button and press it — a click on
+ * the desktop run, a tap on the mobile one (see `tap` below). The button
  * only becomes visible once the world has finished loading, so "button appeared" doubles as a
  * load-complete signal. Games without the button (auto-starting genres, custom start UIs) are
  * accepted through the start marker instead.
@@ -572,7 +600,17 @@ function hasStartMarker(consoleLines, marker) {
  * failing game still leaves its menu screenshot and console log as artifacts, and classification
  * decides pass/fail from what is recorded here.
  */
-async function performStartInteraction(page, consoleLines, options) {
+async function performStartInteraction(page, consoleLines, options, 
+/**
+ * Press Play with a touch tap instead of a mouse click.
+ *
+ * Derived from the context's own `hasTouch` rather than passed as its own flag, so the
+ * mismatch is unrepresentable: `tap()` throws outright on a context without touch. The mobile
+ * run must press Play the way its player does — the StartScreen binds `touchend` as well as
+ * `click`, and mobile gameplay start reads the transient user activation a real gesture leaves
+ * behind before it asks for fullscreen.
+ */
+tap) {
     const button = page.locator(options.playButtonSelector).first();
     let playButtonSeen = false;
     let playButtonClicked = false;
@@ -592,7 +630,7 @@ async function performStartInteraction(page, consoleLines, options) {
     }
     if (playButtonSeen) {
         try {
-            await button.click({ timeout: 5_000 });
+            await (tap ? button.tap({ timeout: 5_000 }) : button.click({ timeout: 5_000 }));
             playButtonClicked = true;
         }
         catch {
@@ -606,6 +644,38 @@ async function performStartInteraction(page, consoleLines, options) {
     }
     return { playButtonSeen, playButtonClicked };
 }
+/**
+ * How many touch affordances the engine's MobileControls actually put on screen.
+ *
+ * The direct evidence that the mobile branch ran: `MobileControls` builds its UI only when
+ * `isMobileRuntime()` is true, so a phone-emulated run that ends with none of these elements
+ * either never took the branch or has no touch bindings at all. Matched by the engine's own
+ * stable class names rather than by structure, because the joystick and the action buttons are
+ * plain divs the game may restyle.
+ *
+ * Null on any failure, under the same "not observed is never a failure" contract as every other
+ * probe here.
+ */
+async function countTouchAffordances(page) {
+    try {
+        return await page.evaluate(() => {
+            /* eslint-disable no-undef -- browser-side callback, see the canvas probe above. */
+            try {
+                return {
+                    joysticks: document.querySelectorAll('.hud-mobile-joystick-outer').length,
+                    buttons: document.querySelectorAll('.hud-mobile-button').length,
+                };
+            }
+            catch {
+                return null;
+            }
+            /* eslint-enable no-undef */
+        });
+    }
+    catch {
+        return null;
+    }
+}
 /**
  * Whether the engine's start menu overlay is still displayed. After a successful start the
  * StartScreen fades out and sets `display: none`; a menu still up at the end of the run means