@bitmagic/cli 0.1.37 → 0.1.38

package/dist/verify/settle.js

@@ -0,0 +1,90 @@
+/**
+ * The decision "has the game settled enough to observe", extracted pure so it is testable
+ * without a browser.
+ *
+ * Verify used to wait a fixed 15 seconds regardless of what the game was doing. The samples the
+ * browser loop feeds this function come from the live engine (`window.gameTemplate`), so a
+ * healthy game that reaches gameplay and holds steady is observed after ~4-5 seconds, while the
+ * fixed `--timeout` stays as the hard cap for games that never stabilise. An engine too old to
+ * answer the probes never settles early — it gets exactly the old fixed-wait behaviour.
+ */
+export const DEFAULT_SETTLE_CONFIG = {
+    minSettleMs: 4_000,
+    minFrames: 90,
+    quietMs: 1_500,
+};
+export const SETTLE_POLL_MS = 500;
+/**
+ * Per-sample drop (world units per poll) below which the player counts as falling. A walking
+ * player descends a slope far slower; a player falling out of the world drops tens of units
+ * between 500ms polls.
+ */
+const FREEFALL_DROP_PER_SAMPLE = 2;
+/** How many consecutive falling samples make a freefall. One can be a jump; three in a row
+ *  (a full second and a half of accelerating descent) is not gameplay. */
+const FREEFALL_SAMPLES = 3;
+/**
+ * The player is in sustained freefall at the end of `samples`.
+ *
+ * Judged over the trailing samples that HAVE a player position; unobservable positions mean
+ * "cannot tell", never "falling". Exported because the final state snapshot reports the same
+ * judgement as `player.isFalling`.
+ */
+export function isFreefalling(samples) {
+    const positioned = samples.filter((sample) => sample.playerY !== null);
+    if (positioned.length < FREEFALL_SAMPLES + 1)
+        return false;
+    const tail = positioned.slice(-(FREEFALL_SAMPLES + 1));
+    for (let i = 1; i < tail.length; i++) {
+        const drop = tail[i - 1].playerY - tail[i].playerY;
+        if (drop < FREEFALL_DROP_PER_SAMPLE)
+            return false;
+    }
+    return true;
+}
+/**
+ * True when the run has seen enough to stop settling early.
+ *
+ * Every condition must hold on the latest sample:
+ * - the minimum settle floor has passed;
+ * - gameplay is actually running — state 'playing' or 'end' (a run-to-completion minigame), or
+ *   `hasStarted` when the state manager is not observable. Both unobservable → never settle
+ *   early; the fixed timeout is the correct behaviour for an engine that cannot be asked;
+ * - the page has rendered enough frames to prove a live render loop;
+ * - the error counters have been flat for the quiet window;
+ * - the player is not falling out of the world.
+ */
+export function settleVerdict(samples, config) {
+    if (samples.length === 0)
+        return 'keep-waiting';
+    const latest = samples[samples.length - 1];
+    if (latest.atMs < config.minSettleMs)
+        return 'keep-waiting';
+    const playing = latest.gameState === null
+        ? latest.hasStarted === true
+        : latest.gameState === 'playing' || latest.gameState === 'end';
+    if (!playing)
+        return 'keep-waiting';
+    if (latest.frameCount === null || latest.frameCount < config.minFrames)
+        return 'keep-waiting';
+    const quietWindowStart = latest.atMs - config.quietMs;
+    const windowSamples = samples.filter((sample) => sample.atMs >= quietWindowStart);
+    // The window must span actual time: right after the floor passes there may be only the latest
+    // sample in it, and "no errors between one sample and itself" proves nothing.
+    const earliest = windowSamples[0];
+    if (earliest === latest && samples.length > 1)
+        return 'keep-waiting';
+    if (windowSamples.some((sample) => sample.errorEventCount !== latest.errorEventCount)) {
+        return 'keep-waiting';
+    }
+    // Cumulative frames are not enough: a loop that rendered its 90 frames on the menu and froze
+    // at game start (measured under software WebGPU) would settle as "stable" on the count alone.
+    // Stable means frames are still being produced NOW — strictly more than at the window's start.
+    if (earliest !== latest && earliest.frameCount !== null && latest.frameCount <= earliest.frameCount) {
+        return 'keep-waiting';
+    }
+    if (isFreefalling(samples))
+        return 'keep-waiting';
+    return 'settled';
+}
+//# sourceMappingURL=settle.js.map

package/dist/verify/settle.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bitmagic/cli",
-  "version": "0.1.37",
+  "version": "0.1.38",
   "description": "Build Bitmagic games from your own agent tool",
   "type": "module",
   "bin": {