@bitmagic/cli 0.1.52-dev.10 → 0.1.52-dev.11

package/dist/verify/result.d.ts

@@ -1,5 +1,7 @@
-import type { RendererObservation, SettleObservation, StateSnapshot, VerifyResult } from './classify.js';
+import type { RendererObservation, SettleObservation, StateSnapshot, TouchControlsObservation, VerifyObservations, VerifyResult } from './classify.js';
 import type { EventsObservation } from './events.js';
+import type { MobileParityGap } from './mobile-parity.js';
+import type { VerifyPlatform } from './platform.js';
 export declare const VERIFY_RESULT_FILENAME = "result.json";
 /**
  * What `bitmagic verify` observed, written so `bitmagic publish` can gate on it.
@@ -30,6 +32,53 @@ export interface VerifyRunRecord {
     /** Semantic gameplay events (deaths, pickups, match-end) from the engine's `?eventlog=1`
      *  session; null when the engine predates it. Optional for the same cross-version reason. */
     events?: EventsObservation | null;
+    /**
+     * Which platform the fields above describe — the LEAD platform, `platforms[0]` of the run.
+     * Absent on records written before `--platform` existed, which were all desktop.
+     */
+    platform?: VerifyPlatform;
+    /**
+     * Touch affordances the engine rendered — the direct evidence that the mobile branch ran.
+     * Absent on a desktop lead run, where the engine never builds MobileControls at all, so
+     * absent is not the same as zero.
+     */
+    touchControls?: TouchControlsObservation | null;
+    /**
+     * The engine's mobile-parity gaps, as it reported them at game start. Null means it reported
+     * none: a clean game, an engine too old to have the check, or a genre whose controller does
+     * not implement it. A property of the game's CODE rather than of the emulated device, so it is
+     * reported once whatever the run covered.
+     */
+    mobileParity?: MobileParityGap | null;
+    /**
+     * One entry per platform, in run order, present ONLY on a run that covered more than one.
+     * A single-platform record keeps exactly the shape it has always had — nothing that reads
+     * these records today has a new key to learn.
+     */
+    platforms?: VerifyPlatformRun[];
+}
+/** One platform's half of a multi-platform run. */
+export interface VerifyPlatformRun {
+    platform: VerifyPlatform;
+    ok: boolean;
+    /** Unprefixed — the platform is the sibling key, so the prefixing the merged top-level
+     *  `failures`/`warnings` need would only be noise here. */
+    failures: string[];
+    warnings: string[];
+    renderer?: RendererObservation;
+    retriedWithSoftwareGl?: boolean;
+    settle?: SettleObservation;
+    snapshot?: StateSnapshot | null;
+    events?: EventsObservation | null;
+    /** Touch affordances the engine rendered. Only on a mobile run. */
+    touchControls?: TouchControlsObservation | null;
+    /**
+     * File names, not paths: every artifact is a sibling of the `result.json` these appear in, and
+     * an absolute path baked into a persisted record describes the machine that wrote it rather
+     * than the run.
+     */
+    screenshotFile?: string;
+    consoleFile: string;
 }
 export declare function writeVerifyRecord(artifactDir: string, record: VerifyRunRecord): void;
 /**
@@ -50,7 +99,38 @@ export declare function readVerifyRecord(artifactDir: string): VerifyRunRecord |
  * different messages and different remedies. Inside `run()` that ordering is only observable by
  * spawning vite and a browser, which is why it went unguarded.
  */
-export declare function decideVerifyOutcome(result: VerifyResult, fingerprint: string, at: string, extras?: Pick<VerifyRunRecord, 'renderer' | 'retriedWithSoftwareGl' | 'settle' | 'snapshot' | 'events'>): {
+export type VerifyRunExtras = Pick<VerifyRunRecord, 'renderer' | 'retriedWithSoftwareGl' | 'settle' | 'snapshot' | 'events' | 'platform' | 'touchControls' | 'mobileParity' | 'platforms'>;
+/**
+ * One platform's finished run, ready to merge.
+ *
+ * Shared by the one-shot command and the watch loop because both assemble exactly this from
+ * exactly these parts, and the only interesting thing about the assembly — which observations
+ * belong to the platform and which to the run as a whole — is the thing that would drift if it
+ * were written twice.
+ */
+export declare function toVerifyPlatformRun(platform: VerifyPlatform, result: VerifyResult, observations: Pick<VerifyObservations, 'renderer' | 'settle' | 'snapshot' | 'events' | 'touchControls' | 'mobileParity'>, retriedWithSoftwareGl: boolean, paths: {
+    screenshotPath: string;
+    consolePath: string;
+}, fast: boolean): VerifyPlatformRun;
+/**
+ * One verdict, and one set of top-level fields, from however many platforms the run covered.
+ *
+ * The prefixing rule is what keeps a `both` run readable. A finding EVERY platform produced is
+ * one problem, not two — a missing `Loaded world.json` is the same missing file whichever
+ * viewport asked for it — so it is reported once, unprefixed. A finding only some platforms
+ * produced is prefixed with the platform, because there the platform IS the information. A
+ * single-platform run therefore comes out byte-identical to what it produced before this
+ * existed: every finding is in every run, so nothing is prefixed.
+ *
+ * The top-level observations are the LEAD run's (`runs[0]`), which `resolveVerifyPlatforms`
+ * chooses as the platform the game is actually for. `platforms` is only attached for a genuine
+ * multi-platform run, so a single-platform record grows no keys.
+ */
+export declare function mergeVerifyPlatformRuns(runs: VerifyPlatformRun[], mobileParity: MobileParityGap | null | undefined): {
+    result: VerifyResult;
+    extras: VerifyRunExtras;
+};
+export declare function decideVerifyOutcome(result: VerifyResult, fingerprint: string, at: string, extras?: VerifyRunExtras): {
     record: VerifyRunRecord;
     shouldThrow: boolean;
 };
@@ -71,7 +151,11 @@ export interface VerifyReporter {
 export declare function recordAndGateVerify(artifactDir: string, outcome: {
     record: VerifyRunRecord;
     shouldThrow: boolean;
-}, paths: {
-    consolePath: string;
-    screenshotPath?: string;
-}, reporter: VerifyReporter): void;
+}, 
+/**
+ * Every file this run actually wrote, in the order to list them. A list rather than a
+ * console/screenshot pair because a run can now cover two platforms and write four files, and
+ * because a `--fast` run captures no screenshot at all — naming a file that does not exist
+ * (or worse, a stale one from an earlier run) is exactly what this avoids.
+ */
+artifacts: string[], reporter: VerifyReporter): void;

package/dist/verify/result.js

@@ -36,14 +36,89 @@ export function readVerifyRecord(artifactDir) {
     }
 }
 /**
- * What a classified verify run produces: the record to write, and whether the command then
- * fails.
+ * One platform's finished run, ready to merge.
  *
- * Split out of the command so the ORDER is testable. The record must be written even when the
- * run failed — publish distinguishes "verify failed" from "verify never ran", and those have
- * different messages and different remedies. Inside `run()` that ordering is only observable by
- * spawning vite and a browser, which is why it went unguarded.
+ * Shared by the one-shot command and the watch loop because both assemble exactly this from
+ * exactly these parts, and the only interesting thing about the assembly — which observations
+ * belong to the platform and which to the run as a whole — is the thing that would drift if it
+ * were written twice.
  */
+export function toVerifyPlatformRun(platform, result, observations, retriedWithSoftwareGl, paths, fast) {
+    return {
+        platform,
+        ok: result.ok,
+        failures: result.failures,
+        warnings: result.warnings,
+        renderer: observations.renderer,
+        ...(retriedWithSoftwareGl ? { retriedWithSoftwareGl } : {}),
+        settle: observations.settle,
+        snapshot: observations.snapshot,
+        events: observations.events,
+        ...(observations.touchControls !== undefined ? { touchControls: observations.touchControls } : {}),
+        consoleFile: path.basename(paths.consolePath),
+        ...(fast ? {} : { screenshotFile: path.basename(paths.screenshotPath) }),
+    };
+}
+/**
+ * One verdict, and one set of top-level fields, from however many platforms the run covered.
+ *
+ * The prefixing rule is what keeps a `both` run readable. A finding EVERY platform produced is
+ * one problem, not two — a missing `Loaded world.json` is the same missing file whichever
+ * viewport asked for it — so it is reported once, unprefixed. A finding only some platforms
+ * produced is prefixed with the platform, because there the platform IS the information. A
+ * single-platform run therefore comes out byte-identical to what it produced before this
+ * existed: every finding is in every run, so nothing is prefixed.
+ *
+ * The top-level observations are the LEAD run's (`runs[0]`), which `resolveVerifyPlatforms`
+ * chooses as the platform the game is actually for. `platforms` is only attached for a genuine
+ * multi-platform run, so a single-platform record grows no keys.
+ */
+export function mergeVerifyPlatformRuns(runs, mobileParity) {
+    if (runs.length === 0) {
+        throw new CliError('A verify run covered no platforms, which should be impossible.');
+    }
+    const lead = runs[0];
+    return {
+        result: {
+            ok: runs.every((run) => run.ok),
+            failures: mergeFindings(runs, (run) => run.failures),
+            warnings: mergeFindings(runs, (run) => run.warnings),
+        },
+        extras: {
+            ...(lead.renderer !== undefined ? { renderer: lead.renderer } : {}),
+            ...(lead.retriedWithSoftwareGl === true ? { retriedWithSoftwareGl: true } : {}),
+            ...(lead.settle !== undefined ? { settle: lead.settle } : {}),
+            ...(lead.snapshot !== undefined ? { snapshot: lead.snapshot } : {}),
+            ...(lead.events !== undefined ? { events: lead.events } : {}),
+            platform: lead.platform,
+            ...(lead.touchControls !== undefined ? { touchControls: lead.touchControls } : {}),
+            ...(mobileParity !== undefined ? { mobileParity } : {}),
+            ...(runs.length > 1 ? { platforms: runs } : {}),
+        },
+    };
+}
+/** Findings from every run, deduplicated, in first-seen order, prefixed only where they differ. */
+function mergeFindings(runs, pick) {
+    const seenIn = new Map();
+    for (const run of runs) {
+        for (const finding of pick(run)) {
+            const platforms = seenIn.get(finding);
+            if (platforms === undefined)
+                seenIn.set(finding, [run.platform]);
+            else if (!platforms.includes(run.platform))
+                platforms.push(run.platform);
+        }
+    }
+    const merged = [];
+    for (const [finding, platforms] of seenIn) {
+        if (platforms.length === runs.length)
+            merged.push(finding);
+        else
+            for (const platform of platforms)
+                merged.push(`[${platform}] ${finding}`);
+    }
+    return merged;
+}
 export function decideVerifyOutcome(result, fingerprint, at, extras) {
     return {
         record: {
@@ -66,16 +141,20 @@ export function decideVerifyOutcome(result, fingerprint, at, extras) {
  * survives a failing run — inside `run()` it was observable only by spawning vite and a browser,
  * which is why it went unguarded.
  */
-export function recordAndGateVerify(artifactDir, outcome, paths, reporter) {
+export function recordAndGateVerify(artifactDir, outcome, 
+/**
+ * Every file this run actually wrote, in the order to list them. A list rather than a
+ * console/screenshot pair because a run can now cover two platforms and write four files, and
+ * because a `--fast` run captures no screenshot at all — naming a file that does not exist
+ * (or worse, a stale one from an earlier run) is exactly what this avoids.
+ */
+artifacts, reporter) {
     reporter.write(artifactDir, outcome.record);
     for (const warning of outcome.record.warnings)
         reporter.info(`warning: ${warning}`);
     if (outcome.shouldThrow) {
         for (const failure of outcome.record.failures)
             reporter.error(`✗ ${failure}`);
-        // screenshotPath is absent on a `--fast` run, which captures none — listing it would point
-        // the reader at a file that does not exist (or worse, a stale one from an earlier run).
-        const artifacts = [paths.consolePath, paths.screenshotPath].filter((p) => p !== undefined);
         reporter.error(`\nArtifacts: ${artifacts.join(', ')}`);
         throw new CliError('Verification failed.');
     }

package/dist/verify/result.js.map

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

package/dist/verify/url.d.ts

@@ -1,4 +1,5 @@
 import type { RendererChoice } from '../browser-gl.js';
+import type { VerifyPlatform } from './platform.js';
 /**
  * The URL verify boots the game at — one place, because one-shot and watch
  * mode were already building it separately and drift here is invisible until
@@ -8,5 +9,12 @@ import type { RendererChoice } from '../browser-gl.js';
  * localStorage preference. `?eventlog=1` asks the engine to run a passive
  * GameEventLog session for the semantic-events probe — an engine too old to
  * know the param ignores it, and the probe then reads null ("not observed").
+ *
+ * `?platform=mobile` is the engine's own boot override and wins over every
+ * device probe (`isMobileRuntime.ts`), which is what makes the mobile run
+ * exercise the real branch — the touch HUD, the pixel-ratio clamp, the
+ * level-detail tier, the light warmup — rather than a resized desktop page.
+ * A desktop run sends NO platform param rather than `?platform=desktop`, so a
+ * vendored engine that predates the override boots exactly as it always has.
  */
-export declare function buildVerifyUrl(port: number, renderer: RendererChoice): string;
+export declare function buildVerifyUrl(port: number, renderer: RendererChoice, platform?: VerifyPlatform): string;

package/dist/verify/url.js

@@ -7,8 +7,16 @@
  * localStorage preference. `?eventlog=1` asks the engine to run a passive
  * GameEventLog session for the semantic-events probe — an engine too old to
  * know the param ignores it, and the probe then reads null ("not observed").
+ *
+ * `?platform=mobile` is the engine's own boot override and wins over every
+ * device probe (`isMobileRuntime.ts`), which is what makes the mobile run
+ * exercise the real branch — the touch HUD, the pixel-ratio clamp, the
+ * level-detail tier, the light warmup — rather than a resized desktop page.
+ * A desktop run sends NO platform param rather than `?platform=desktop`, so a
+ * vendored engine that predates the override boots exactly as it always has.
  */
-export function buildVerifyUrl(port, renderer) {
-    return `http://localhost:${port}/?renderer=${renderer}&eventlog=1`;
+export function buildVerifyUrl(port, renderer, platform = 'desktop') {
+    const base = `http://localhost:${port}/?renderer=${renderer}&eventlog=1`;
+    return platform === 'mobile' ? `${base}&platform=mobile` : base;
 }
 //# sourceMappingURL=url.js.map

package/dist/verify/url.js.map

@@ -1 +1 @@
-{"version":3,"file":"url.js","sourceRoot":"","sources":["../../src/verify/url.ts"],"names":[],"mappings":"AAEA;;;;;;;;;GASG;AACH,MAAM,UAAU,cAAc,CAAC,IAAY,EAAE,QAAwB;IACnE,OAAO,oBAAoB,IAAI,cAAc,QAAQ,aAAa,CAAC;AACrE,CAAC"}
+{"version":3,"file":"url.js","sourceRoot":"","sources":["../../src/verify/url.ts"],"names":[],"mappings":"AAGA;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,UAAU,cAAc,CAC5B,IAAY,EACZ,QAAwB,EACxB,WAA2B,SAAS;IAEpC,MAAM,IAAI,GAAG,oBAAoB,IAAI,cAAc,QAAQ,aAAa,CAAC;IACzE,OAAO,QAAQ,KAAK,QAAQ,CAAC,CAAC,CAAC,GAAG,IAAI,kBAAkB,CAAC,CAAC,CAAC,IAAI,CAAC;AAClE,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bitmagic/cli",
-  "version": "0.1.52-dev.10",
+  "version": "0.1.52-dev.11",
   "description": "Build Bitmagic games from your own agent tool",
   "license": "SEE LICENSE IN LICENSE.md",
   "author": "Bitmagic Oy",
@@ -23,9 +23,9 @@
     "fflate": "^0.8.2",
     "playwright-core": "^1.59.1",
     "tar": "^7.4.3",
-    "@bitmagic/animation-forger": "0.1.7-dev.10",
-    "@bitmagic/world-forger": "0.1.12-dev.10",
-    "@bitmagic/asset-core": "0.2.7-dev.10"
+    "@bitmagic/asset-core": "0.2.7-dev.11",
+    "@bitmagic/animation-forger": "0.1.7-dev.11",
+    "@bitmagic/world-forger": "0.1.12-dev.11"
   },
   "devDependencies": {
     "@eslint/js": "^9.38.0",