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

package/dist/verify/iterate.js

@@ -9,14 +9,15 @@
  * agent's five-file edit burst becomes one re-verify, and a red build reports its type errors
  * instead of wasting a browser run on the previous emit.
  */
-import * as path from 'path';
 import { browserLaunchPlan, shouldRetrySoftwareGl, softwareGlLaunchPlan, } from '../browser-gl.js';
 import { ReloadCoordinator, pipeTscWatch, watchProject } from '../editor/watch.js';
 import { computeFingerprint } from '../publish/fingerprint.js';
 import { VerifyBrowserSession, DEFAULT_START_INTERACTION } from './browser.js';
 import { classifyVerifyRun } from './classify.js';
-import { decideVerifyOutcome, writeVerifyRecord } from './result.js';
+import { decideVerifyOutcome, mergeVerifyPlatformRuns, toVerifyPlatformRun, writeVerifyRecord, } from './result.js';
 import { buildVerifyUrl } from './url.js';
+import { verifyArtifactPaths } from './artifacts.js';
+import { mobileContextOptions } from './device.js';
 /**
  * Runs verify iterations one at a time. A change that lands mid-iteration queues exactly one
  * follow-up — not one per change, because the follow-up will see all of them anyway.
@@ -81,48 +82,54 @@ export async function runVerifyWatch(options) {
         // that changes mid-run makes the record stale, and the coordinator immediately queues the
         // iteration that will re-verify it.
         const fingerprint = computeFingerprint(options.root);
-        const checkOptions = {
-            url: buildVerifyUrl(options.port, options.renderer),
-            screenshotPath: options.screenshotPath,
-            consolePath: options.consolePath,
-            settleMs: options.settleMs,
-            startInteraction: DEFAULT_START_INTERACTION,
-            requestedRenderer: options.renderer,
-            captureScreenshot: !options.fast,
-        };
-        let observations = await session.check(checkOptions);
-        let result = classifyVerifyRun(observations);
-        let retriedWithSoftwareGl = false;
-        if (!result.ok && !onSoftwareGl && shouldRetrySoftwareGl(observations, process.env)) {
-            output.info('The WebGL context was lost — switching this watch to software rendering…');
-            await session.close();
-            session = await VerifyBrowserSession.launch(softwareGlLaunchPlan(process.env, options.renderer));
-            onSoftwareGl = true;
-            retriedWithSoftwareGl = true;
-            observations = await session.check({
-                ...checkOptions,
-                consolePath: path.join(options.artifactDir, 'console.retry.log'),
-            });
-            result = classifyVerifyRun(observations);
+        const classifyContext = { mobilePrimary: options.mobilePrimary };
+        const runs = [];
+        const states = [];
+        let mobileParity;
+        for (const platform of options.platforms) {
+            const paths = verifyArtifactPaths(options.artifactDir, platform);
+            const checkOptions = {
+                url: buildVerifyUrl(options.port, options.renderer, platform),
+                screenshotPath: paths.screenshotPath,
+                consolePath: paths.consolePath,
+                settleMs: options.settleMs,
+                startInteraction: DEFAULT_START_INTERACTION,
+                requestedRenderer: options.renderer,
+                captureScreenshot: !options.fast,
+                ...(platform === 'mobile' ? { device: mobileContextOptions(options.orientation) } : {}),
+            };
+            let observations = await session.check(checkOptions);
+            let result = classifyVerifyRun(observations, { ...classifyContext, platform });
+            let retriedWithSoftwareGl = false;
+            if (!result.ok && !onSoftwareGl && shouldRetrySoftwareGl(observations, process.env)) {
+                output.info('The WebGL context was lost — switching this watch to software rendering…');
+                await session.close();
+                session = await VerifyBrowserSession.launch(softwareGlLaunchPlan(process.env, options.renderer));
+                onSoftwareGl = true;
+                retriedWithSoftwareGl = true;
+                observations = await session.check({ ...checkOptions, consolePath: paths.retryConsolePath });
+                result = classifyVerifyRun(observations, { ...classifyContext, platform });
+            }
+            if (mobileParity === undefined)
+                mobileParity = observations.mobileParity;
+            runs.push(toVerifyPlatformRun(platform, result, observations, retriedWithSoftwareGl, paths, options.fast));
+            const state = options.describeRunState(observations);
+            states.push(options.platforms.length > 1 ? `${platform}: ${state}` : state);
         }
-        const outcome = decideVerifyOutcome(result, fingerprint, new Date().toISOString(), {
-            renderer: observations.renderer,
-            settle: observations.settle,
-            snapshot: observations.snapshot,
-            events: observations.events,
-            ...(retriedWithSoftwareGl ? { retriedWithSoftwareGl } : {}),
-        });
+        const merged = mergeVerifyPlatformRuns(runs, mobileParity);
+        const outcome = decideVerifyOutcome(merged.result, fingerprint, new Date().toISOString(), merged.extras);
         // Recorded but never thrown: a failing iteration is information for the next edit, not the
         // end of the loop. Publish still gates on this record exactly as it does after one-shot.
         writeVerifyRecord(options.artifactDir, outcome.record);
+        const { failures } = merged.result;
         const seconds = ((Date.now() - startedAt) / 1000).toFixed(1);
-        if (result.ok) {
-            output.info(`✓ verified in ${seconds}s (${reason}) — ${options.describeRunState(observations)}`);
+        if (merged.result.ok) {
+            output.info(`✓ verified in ${seconds}s (${reason}) — ${states.join(' | ')}`);
         }
         else {
-            for (const failure of result.failures)
+            for (const failure of failures)
                 output.info(`✗ ${failure}`);
-            output.info(`✗ ${result.failures.length} failure${result.failures.length === 1 ? '' : 's'} in `
+            output.info(`✗ ${failures.length} failure${failures.length === 1 ? '' : 's'} in `
                 + `${seconds}s (${reason})`);
         }
     }, reportIterationError);

package/dist/verify/iterate.js.map

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

package/dist/verify/mobile-parity.d.ts

@@ -0,0 +1,42 @@
+/**
+ * Reading the engine's mobile-parity verdict out of the console verify already captures.
+ *
+ * `GameTemplate` calls `playerController.verifyMobileParity()` on every game start — desktop runs
+ * included — and when it finds gaps the engine logs one `console.error` listing every one of
+ * them (`game/src/engine/PlayerController.ts`, documented in
+ * `game/agent-docs/control-system.md`). Nothing consumed it, so a game with actions no phone can
+ * reach passed verify silently.
+ *
+ * Parsing that line rather than listening for the `aitopia:mobile-parity-gap` postMessage the
+ * same check also fires is deliberate on two counts: the console is already captured, so this
+ * needs no new browser plumbing; and only the console line carries the `(source)` annotation
+ * naming which system registered an orphan key, which is the difference between "KeyF is
+ * unreachable" and "the attack system left KeyF unreachable".
+ *
+ * The line's format is a documented contract, but this parser still degrades rather than
+ * insisting on it: anything it cannot read comes back null, which classifies as "not observed"
+ * and never as a failure. Two legitimate ways to get null: a clean game (the engine logs nothing
+ * when parity holds) and a genre whose controller has no parity check at all — the 2D genres'
+ * `Physics2DPlayerController` deliberately has no `verifyMobileParity`, so `GameTemplate`'s
+ * duck-typed guard skips it.
+ */
+/** The engine's marker. Also what a reader greps the console log for. */
+export declare const MOBILE_PARITY_MARKER = "[mobile-parity]";
+export interface MobileParityGap {
+    /**
+     * Unpaired desktop keys exactly as the engine names them, source annotation included —
+     * `KeyF(CombatSystem)`, or `KeyF((anonymous))` when the registration passed no `source`. The
+     * annotation is the actionable half: it points at the call site to fix.
+     */
+    unpairedDesktopKeys: string[];
+    /** Mobile buttons with no desktop key, as bare action names. */
+    unpairedMobileActions: string[];
+}
+/**
+ * The gap the engine reported during this run, or null when it reported none.
+ *
+ * The last matching line wins: a run that starts gameplay more than once (a restart during the
+ * settle) logs the check once per start, and the newest verdict is the one about the game as it
+ * ended up.
+ */
+export declare function parseMobileParityGap(consoleLines: string[]): MobileParityGap | null;

package/dist/verify/mobile-parity.js

@@ -0,0 +1,84 @@
+/**
+ * Reading the engine's mobile-parity verdict out of the console verify already captures.
+ *
+ * `GameTemplate` calls `playerController.verifyMobileParity()` on every game start — desktop runs
+ * included — and when it finds gaps the engine logs one `console.error` listing every one of
+ * them (`game/src/engine/PlayerController.ts`, documented in
+ * `game/agent-docs/control-system.md`). Nothing consumed it, so a game with actions no phone can
+ * reach passed verify silently.
+ *
+ * Parsing that line rather than listening for the `aitopia:mobile-parity-gap` postMessage the
+ * same check also fires is deliberate on two counts: the console is already captured, so this
+ * needs no new browser plumbing; and only the console line carries the `(source)` annotation
+ * naming which system registered an orphan key, which is the difference between "KeyF is
+ * unreachable" and "the attack system left KeyF unreachable".
+ *
+ * The line's format is a documented contract, but this parser still degrades rather than
+ * insisting on it: anything it cannot read comes back null, which classifies as "not observed"
+ * and never as a failure. Two legitimate ways to get null: a clean game (the engine logs nothing
+ * when parity holds) and a genre whose controller has no parity check at all — the 2D genres'
+ * `Physics2DPlayerController` deliberately has no `verifyMobileParity`, so `GameTemplate`'s
+ * duck-typed guard skips it.
+ */
+/** The engine's marker. Also what a reader greps the console log for. */
+export const MOBILE_PARITY_MARKER = '[mobile-parity]';
+/** The engine's literal for "this side has none", on either list. */
+const NONE = '(none)';
+const DESKTOP_LABEL = 'Desktop keys with no mobile button:';
+const MOBILE_LABEL = 'Mobile actions with no desktop key:';
+/**
+ * The gap the engine reported during this run, or null when it reported none.
+ *
+ * The last matching line wins: a run that starts gameplay more than once (a restart during the
+ * settle) logs the check once per start, and the newest verdict is the one about the game as it
+ * ended up.
+ */
+export function parseMobileParityGap(consoleLines) {
+    for (let i = consoleLines.length - 1; i >= 0; i--) {
+        const gap = parseLine(consoleLines[i]);
+        if (gap !== null)
+            return gap;
+    }
+    return null;
+}
+function parseLine(line) {
+    if (!line.includes(MOBILE_PARITY_MARKER))
+        return null;
+    const desktop = between(line, DESKTOP_LABEL, MOBILE_LABEL);
+    const mobile = between(line, MOBILE_LABEL, 'Use playerController');
+    if (desktop === null && mobile === null)
+        return null;
+    const gap = {
+        unpairedDesktopKeys: splitList(desktop),
+        unpairedMobileActions: splitList(mobile),
+    };
+    // Both sides empty means the line was recognised but says nothing actionable — the engine
+    // never logs that, so treat it as unobserved rather than inventing a gap with no contents.
+    return gap.unpairedDesktopKeys.length === 0 && gap.unpairedMobileActions.length === 0
+        ? null
+        : gap;
+}
+/** The text between `label` and whatever comes next, or null when `label` is absent. */
+function between(line, label, next) {
+    const start = line.indexOf(label);
+    if (start === -1)
+        return null;
+    const from = start + label.length;
+    const end = line.indexOf(next, from);
+    return line.slice(from, end === -1 ? undefined : end);
+}
+/**
+ * One comma-separated engine list. Safe to split on a bare comma even though every desktop entry
+ * carries a parenthesised source: `source` strings are identifiers naming the registering system,
+ * never prose with commas in it.
+ */
+function splitList(raw) {
+    if (raw === null)
+        return [];
+    return raw
+        .replace(/\.\s*$/, '')
+        .split(',')
+        .map((entry) => entry.trim())
+        .filter((entry) => entry.length > 0 && entry !== NONE);
+}
+//# sourceMappingURL=mobile-parity.js.map

package/dist/verify/mobile-parity.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mobile-parity.js","sourceRoot":"","sources":["../../src/verify/mobile-parity.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH,yEAAyE;AACzE,MAAM,CAAC,MAAM,oBAAoB,GAAG,iBAAiB,CAAC;AAEtD,qEAAqE;AACrE,MAAM,IAAI,GAAG,QAAQ,CAAC;AAEtB,MAAM,aAAa,GAAG,qCAAqC,CAAC;AAC5D,MAAM,YAAY,GAAG,qCAAqC,CAAC;AAa3D;;;;;;GAMG;AACH,MAAM,UAAU,oBAAoB,CAAC,YAAsB;IACzD,KAAK,IAAI,CAAC,GAAG,YAAY,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;QAClD,MAAM,GAAG,GAAG,SAAS,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,CAAC;QACvC,IAAI,GAAG,KAAK,IAAI;YAAE,OAAO,GAAG,CAAC;IAC/B,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,SAAS,SAAS,CAAC,IAAY;IAC7B,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,oBAAoB,CAAC;QAAE,OAAO,IAAI,CAAC;IACtD,MAAM,OAAO,GAAG,OAAO,CAAC,IAAI,EAAE,aAAa,EAAE,YAAY,CAAC,CAAC;IAC3D,MAAM,MAAM,GAAG,OAAO,CAAC,IAAI,EAAE,YAAY,EAAE,sBAAsB,CAAC,CAAC;IACnE,IAAI,OAAO,KAAK,IAAI,IAAI,MAAM,KAAK,IAAI;QAAE,OAAO,IAAI,CAAC;IACrD,MAAM,GAAG,GAAG;QACV,mBAAmB,EAAE,SAAS,CAAC,OAAO,CAAC;QACvC,qBAAqB,EAAE,SAAS,CAAC,MAAM,CAAC;KACzC,CAAC;IACF,0FAA0F;IAC1F,2FAA2F;IAC3F,OAAO,GAAG,CAAC,mBAAmB,CAAC,MAAM,KAAK,CAAC,IAAI,GAAG,CAAC,qBAAqB,CAAC,MAAM,KAAK,CAAC;QACnF,CAAC,CAAC,IAAI;QACN,CAAC,CAAC,GAAG,CAAC;AACV,CAAC;AAED,wFAAwF;AACxF,SAAS,OAAO,CAAC,IAAY,EAAE,KAAa,EAAE,IAAY;IACxD,MAAM,KAAK,GAAG,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;IAClC,IAAI,KAAK,KAAK,CAAC,CAAC;QAAE,OAAO,IAAI,CAAC;IAC9B,MAAM,IAAI,GAAG,KAAK,GAAG,KAAK,CAAC,MAAM,CAAC;IAClC,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;IACrC,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;AACxD,CAAC;AAED;;;;GAIG;AACH,SAAS,SAAS,CAAC,GAAkB;IACnC,IAAI,GAAG,KAAK,IAAI;QAAE,OAAO,EAAE,CAAC;IAC5B,OAAO,GAAG;SACP,OAAO,CAAC,QAAQ,EAAE,EAAE,CAAC;SACrB,KAAK,CAAC,GAAG,CAAC;SACV,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC;SAC5B,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,IAAI,KAAK,KAAK,IAAI,CAAC,CAAC;AAC3D,CAAC"}

package/dist/verify/platform.d.ts

@@ -0,0 +1,47 @@
+import type { MobileOrientation, PlatformDeclaration } from '../project/platform-declaration.js';
+export type VerifyPlatform = 'desktop' | 'mobile';
+/** What `--platform` accepts. `both` is a request for two runs, not a platform. */
+export type PlatformRequest = 'desktop' | 'mobile' | 'both';
+export interface ResolvedPlatforms {
+    /**
+     * The platforms to run, in order. `platforms[0]` is the LEAD: the run whose observations land
+     * at the top level of `result.json`, which is what `bitmagic judge` summarises and what the
+     * one-line run state reports. A `both` run leads with the platform the game is FOR, so the
+     * headline numbers describe the game as it is meant to be played; the other run is in
+     * `platforms[]`. Artifact names are per platform, never per lead, so this ordering never moves
+     * a file.
+     */
+    platforms: VerifyPlatform[];
+    /** How to orient a mobile run. Portrait unless world.json locks the game to landscape. */
+    orientation: MobileOrientation;
+    /**
+     * The project declares itself mobile-primary. This is what turns a mobile-parity gap from a
+     * warning into a failure: an action a phone cannot reach is a broken game when the phone is
+     * the platform.
+     */
+    mobilePrimary: boolean;
+    /** One line for the creator naming what will run and why it was chosen. */
+    note: string;
+    /** Values the declaration carried that could not be used, and what was done instead. */
+    warnings: string[];
+}
+/**
+ * Validate `--platform`, or undefined when it was not passed. Mirrors `parseRendererArg` — an
+ * unrecognised value is a mistake worth stopping for, not something to silently default.
+ */
+export declare function parsePlatformArg(raw: string | undefined): PlatformRequest | undefined;
+export declare function resolveVerifyPlatforms(requested: PlatformRequest | undefined, declaration: PlatformDeclaration): ResolvedPlatforms;
+/**
+ * Validate `bitmagic judge --platform`. No `both`: the judge sends ONE frame and returns one
+ * scorecard, and a verdict averaged over two screens would be a verdict about neither.
+ */
+export declare function parseJudgePlatformArg(raw: string | undefined): VerifyPlatform | undefined;
+/**
+ * Which frame `bitmagic judge` grades.
+ *
+ * Explicit wins. Otherwise mobile, but only when BOTH halves hold: the game says it is a phone
+ * game, and a phone frame actually exists. Requiring the file is what keeps the auto-default from
+ * becoming a dead end — a mobile-primary project whose last verify was `--platform desktop` gets
+ * its desktop frame graded rather than an error about a screenshot nobody asked for.
+ */
+export declare function resolveJudgePlatform(explicit: VerifyPlatform | undefined, declaration: PlatformDeclaration, mobileScreenshotExists: boolean): VerifyPlatform;

package/dist/verify/platform.js

@@ -0,0 +1,89 @@
+/**
+ * Which platform(s) a verify run boots, and why.
+ *
+ * Pure, so the decision is testable without a browser: `commands/verify.ts` reads the project's
+ * declaration off disk, this decides, and `browser.ts` obeys.
+ *
+ * The default is the project's own answer rather than a fixed 'desktop'. A game whose
+ * `src/work/game.json` says `primaryPlatform: "mobile"` is a phone game, and verifying it on a
+ * 1280x720 desktop viewport answers a question nobody asked — it exercises neither the touch HUD
+ * nor the mobile pixel-ratio clamp, level-detail tier or warmup path the player will actually
+ * run. An explicit `--platform` always wins, and the chosen platform is always reported, so an
+ * auto-selected mobile run is never a surprise.
+ */
+import { CliError } from '../errors.js';
+/**
+ * Validate `--platform`, or undefined when it was not passed. Mirrors `parseRendererArg` — an
+ * unrecognised value is a mistake worth stopping for, not something to silently default.
+ */
+export function parsePlatformArg(raw) {
+    if (raw === undefined)
+        return undefined;
+    if (raw === 'desktop' || raw === 'mobile' || raw === 'both')
+        return raw;
+    throw new CliError(`--platform must be "desktop", "mobile" or "both", got ${JSON.stringify(raw)}.`);
+}
+export function resolveVerifyPlatforms(requested, declaration) {
+    const mobilePrimary = declaration.primaryPlatform === 'mobile';
+    const warnings = [];
+    if (declaration.rejected.primaryPlatform !== undefined) {
+        warnings.push(`game.json primaryPlatform ${JSON.stringify(declaration.rejected.primaryPlatform)} is not `
+            + '"desktop" or "mobile" — verifying as a desktop game.');
+    }
+    if (declaration.rejected.mobileOrientation !== undefined) {
+        warnings.push(`worldProfileData.mobileOrientation ${JSON.stringify(declaration.rejected.mobileOrientation)} `
+            + 'is not "portrait" or "landscape" — verifying the mobile run in portrait.');
+    }
+    const effective = requested ?? (mobilePrimary ? 'mobile' : 'desktop');
+    const platforms = effective !== 'both'
+        ? [effective]
+        : mobilePrimary ? ['mobile', 'desktop'] : ['desktop', 'mobile'];
+    const orientation = declaration.mobileOrientation ?? 'portrait';
+    return {
+        platforms,
+        orientation,
+        mobilePrimary,
+        note: describe(effective, orientation, requested !== undefined, mobilePrimary),
+        warnings,
+    };
+}
+/**
+ * Validate `bitmagic judge --platform`. No `both`: the judge sends ONE frame and returns one
+ * scorecard, and a verdict averaged over two screens would be a verdict about neither.
+ */
+export function parseJudgePlatformArg(raw) {
+    if (raw === undefined)
+        return undefined;
+    if (raw === 'desktop' || raw === 'mobile')
+        return raw;
+    throw new CliError(`--platform must be "desktop" or "mobile", got ${JSON.stringify(raw)}.`
+        + (raw === 'both' ? ' The judge grades one frame; run it once per platform.' : ''));
+}
+/**
+ * Which frame `bitmagic judge` grades.
+ *
+ * Explicit wins. Otherwise mobile, but only when BOTH halves hold: the game says it is a phone
+ * game, and a phone frame actually exists. Requiring the file is what keeps the auto-default from
+ * becoming a dead end — a mobile-primary project whose last verify was `--platform desktop` gets
+ * its desktop frame graded rather than an error about a screenshot nobody asked for.
+ */
+export function resolveJudgePlatform(explicit, declaration, mobileScreenshotExists) {
+    if (explicit !== undefined)
+        return explicit;
+    return declaration.primaryPlatform === 'mobile' && mobileScreenshotExists ? 'mobile' : 'desktop';
+}
+function describe(effective, orientation, explicit, mobilePrimary) {
+    const includesMobile = effective !== 'desktop';
+    const what = effective === 'both'
+        ? `desktop and mobile (${orientation})`
+        : effective === 'mobile'
+            ? `mobile (${orientation})`
+            : 'desktop';
+    if (explicit)
+        return `Platform: ${what}.`;
+    return mobilePrimary && includesMobile
+        ? `Platform: ${what} — game.json declares primaryPlatform "mobile". `
+            + 'Pass --platform desktop to verify the desktop path instead.'
+        : `Platform: ${what}.`;
+}
+//# sourceMappingURL=platform.js.map

package/dist/verify/platform.js.map

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

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;