@vgai/cli 0.5.23 → 0.5.25

package/dist/index.js

@@ -1977,6 +1977,34 @@ var init_client2 = __esm({
           };
         }
       }
+      /** THE MODULE LANE under a real Playwright host: the step's source is
+       *  evaluated INSIDE the editor page via the same in-page handler the relay
+       *  op uses (`window.__vgaiGameEval`), because `modules()` only means
+       *  anything in the page's own module space — a Node-side call could never
+       *  hand back the running mount's instances. Same serialization contract
+       *  as the relay leg. */
+      async runGameScript(src, _step, instance) {
+        try {
+          const result = await this.page.evaluate(
+            async (args2) => {
+              const hook = window["__vgaiGameEval"];
+              if (typeof hook !== "function") {
+                throw new Error(
+                  "game-eval: this page has no __vgaiGameEval hook \u2014 is the editor page loaded?"
+                );
+              }
+              return hook(args2.src, args2.instance);
+            },
+            { src, ...instance === void 0 ? {} : { instance } }
+          );
+          return { ok: true, result };
+        } catch (err2) {
+          return {
+            ok: false,
+            error: { code: void 0, message: err2 instanceof Error ? err2.message : String(err2) }
+          };
+        }
+      }
       /** Playwright's own reload already waits for the new document's `load`
        *  event, which is exactly the completion signal this method's contract
        *  asks for — nothing to reconstruct on this leg. */
@@ -2221,6 +2249,9 @@ var init_client2 = __esm({
       /** Per-test tick-rate samples, fed by every `snapshot()` read (a poll the
        *  client was making anyway — zero extra page.evaluate round trips). */
       #tps = new TpsAccumulator();
+      /** True after the settled run-ticks door proved absent on this page (an older exported
+       *  game's engine) — see `fastForward`'s `runTicksBatch`. */
+      #legacyRunTicksDoor = false;
       /** Hidden-tab recovery (hollowstone field lesson: the engine hard-stops
        *  while `document.hidden`). Client-lifetime state so `bringToFront()`
        *  fires at most once per test, across ALL waitFor/waitSimTime loops. */
@@ -2292,7 +2323,28 @@ var init_client2 = __esm({
       async fastForward(budget, opts) {
         assertValidWaitForBudget(budget, "fastForward");
         const clock = {
-          runTicksBatch: (n, render2) => this.callBridgeVoid("runTicks", n, { render: render2 }),
+          // The SETTLED door (`runTicksSettled`, an async bridge method): ticks never race a scene
+          // remount's async commit, so which tick first runs a freshly reloaded world is
+          // deterministic (see engine/runtime/run-ticks-settled.ts — measured: without it, one
+          // drive script produced 7 or 8 post-respawn walked ticks depending on wall timing).
+          // Falls back ONCE to the plain sync door for a page whose engine predates the method
+          // (an older exported game), and remembers the verdict for the rest of the burst.
+          runTicksBatch: async (n, render2) => {
+            if (this.#legacyRunTicksDoor) {
+              await this.callBridgeVoid("runTicks", n, { render: render2 });
+              return;
+            }
+            try {
+              await this.callBridgeAsync("runTicksSettled", n, { render: render2 });
+            } catch (error48) {
+              const code = error48.code;
+              const message = error48 instanceof Error ? error48.message : String(error48);
+              const doorAbsent = code === "UNKNOWN_BRIDGE_METHOD" || /is not a function|undefined/i.test(message);
+              if (!doorAbsent) throw error48;
+              this.#legacyRunTicksDoor = true;
+              await this.callBridgeVoid("runTicks", n, { render: render2 });
+            }
+          },
           readTime: async () => {
             const snap = await this.callBridge("snapshot");
             return { tick: snap.time.tick, simSeconds: snap.time.simSeconds };
@@ -2444,6 +2496,29 @@ var init_client2 = __esm({
         const outcome = await this.#transport.runPageScript(step.toString(), erased);
         return this.unwrap(outcome);
       }
+      /**
+       * THE MODULE LANE — run literal JS INSIDE the game's page, with the
+       * running mount's modules in reach:
+       *
+       * ```js
+       * await game.run(async ({ modules }) => {
+       *   const { simHost } = await modules('src/sim/host.ts');
+       *   return simHost().state.day;
+       * })
+       * ```
+       *
+       * `scope` is `{ page, modules, instanceId }`. Serialization contract as
+       * `game.page()`: the step travels as source (no closures), and the return
+       * value must be plain data. `modules(path)` resolves through the ACTIVE
+       * mount's own url space, so what you touch IS the running game — never a
+       * phantom second copy. Dev-server sessions only; a shipped build's curated
+       * surface is its adapter exports.
+       */
+      async run(step, opts) {
+        const erased = (arg) => step(arg);
+        const outcome = await this.#transport.runGameScript(step.toString(), erased, opts?.instance);
+        return this.unwrap(outcome);
+      }
       /**
        * Reload the document showing the game, resolving only once it is back and
        * answering commands (see `bridge-transport.ts`'s `reloadPage`).
@@ -2750,6 +2825,24 @@ var init_relay_transport = __esm({
           };
         }
       }
+      /** THE MODULE LANE over the relay — same wire shape as `page-script`. */
+      async runGameScript(src, _step, instance) {
+        try {
+          const body = await this.postCommand(
+            { type: "game-eval", src, ...instance === void 0 ? {} : { instance } },
+            PAGE_SCRIPT_TIMEOUT_MS
+          );
+          return this.toBridgeOutcome(body);
+        } catch (err2) {
+          return {
+            ok: false,
+            error: {
+              code: "RELAY_UNREACHABLE",
+              message: `vgai: could not reach the editor dev server relay at ${this.baseUrl} \u2014 ${err2 instanceof Error ? err2.message : String(err2)}`
+            }
+          };
+        }
+      }
       /**
        * P20 — order the tab to reload, then wait for EVIDENCE that it came back.
        *
@@ -78094,9 +78187,9 @@ var require_browser = __commonJS({
   }
 });
 
-// ../../../vgai-engine/node_modules/has-flag/index.js
+// ../../../../node_modules/has-flag/index.js
 var require_has_flag = __commonJS({
-  "../../../vgai-engine/node_modules/has-flag/index.js"(exports, module) {
+  "../../../../node_modules/has-flag/index.js"(exports, module) {
     "use strict";
     module.exports = (flag, argv = process.argv) => {
       const prefix = flag.startsWith("-") ? "" : flag.length === 1 ? "-" : "--";
@@ -78107,9 +78200,9 @@ var require_has_flag = __commonJS({
   }
 });
 
-// ../../../vgai-engine/node_modules/supports-color/index.js
+// ../../../../node_modules/supports-color/index.js
 var require_supports_color = __commonJS({
-  "../../../vgai-engine/node_modules/supports-color/index.js"(exports, module) {
+  "../../../../node_modules/supports-color/index.js"(exports, module) {
     "use strict";
     var os3 = __require("os");
     var tty3 = __require("tty");
@@ -80126,13 +80219,26 @@ var require_theme = __commonJS({
   }
 });
 
+// ../../../vgai-engine/node_modules/has-flag/index.js
+var require_has_flag2 = __commonJS({
+  "../../../vgai-engine/node_modules/has-flag/index.js"(exports, module) {
+    "use strict";
+    module.exports = (flag, argv = process.argv) => {
+      const prefix = flag.startsWith("-") ? "" : flag.length === 1 ? "-" : "--";
+      const position = argv.indexOf(prefix + flag);
+      const terminatorPosition = argv.indexOf("--");
+      return position !== -1 && (terminatorPosition === -1 || position < terminatorPosition);
+    };
+  }
+});
+
 // ../../../vgai-engine/node_modules/@oclif/core/node_modules/supports-color/index.js
 var require_supports_color2 = __commonJS({
   "../../../vgai-engine/node_modules/@oclif/core/node_modules/supports-color/index.js"(exports, module) {
     "use strict";
     var os3 = __require("os");
     var tty3 = __require("tty");
-    var hasFlag2 = require_has_flag();
+    var hasFlag2 = require_has_flag2();
     var { env: env3 } = process;
     var flagForceColor2;
     if (hasFlag2("no-color") || hasFlag2("no-colors") || hasFlag2("color=false") || hasFlag2("color=never")) {
@@ -80604,9 +80710,9 @@ var require_warn = __commonJS({
   }
 });
 
-// ../../../vgai-engine/node_modules/source-map/lib/base64.js
+// ../../../../node_modules/source-map/lib/base64.js
 var require_base64 = __commonJS({
-  "../../../vgai-engine/node_modules/source-map/lib/base64.js"(exports) {
+  "../../../../node_modules/source-map/lib/base64.js"(exports) {
     var intToCharMap = "ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789+/".split("");
     exports.encode = function(number4) {
       if (0 <= number4 && number4 < intToCharMap.length) {
@@ -80645,9 +80751,9 @@ var require_base64 = __commonJS({
   }
 });
 
-// ../../../vgai-engine/node_modules/source-map/lib/base64-vlq.js
+// ../../../../node_modules/source-map/lib/base64-vlq.js
 var require_base64_vlq = __commonJS({
-  "../../../vgai-engine/node_modules/source-map/lib/base64-vlq.js"(exports) {
+  "../../../../node_modules/source-map/lib/base64-vlq.js"(exports) {
     var base643 = require_base64();
     var VLQ_BASE_SHIFT = 5;
     var VLQ_BASE = 1 << VLQ_BASE_SHIFT;
@@ -80699,9 +80805,9 @@ var require_base64_vlq = __commonJS({
   }
 });
 
-// ../../../vgai-engine/node_modules/source-map/lib/util.js
+// ../../../../node_modules/source-map/lib/util.js
 var require_util4 = __commonJS({
-  "../../../vgai-engine/node_modules/source-map/lib/util.js"(exports) {
+  "../../../../node_modules/source-map/lib/util.js"(exports) {
     function getArg(aArgs, aName, aDefaultValue) {
       if (aName in aArgs) {
         return aArgs[aName];
@@ -81000,9 +81106,9 @@ var require_util4 = __commonJS({
   }
 });
 
-// ../../../vgai-engine/node_modules/source-map/lib/array-set.js
+// ../../../../node_modules/source-map/lib/array-set.js
 var require_array_set = __commonJS({
-  "../../../vgai-engine/node_modules/source-map/lib/array-set.js"(exports) {
+  "../../../../node_modules/source-map/lib/array-set.js"(exports) {
     var util2 = require_util4();
     var has = Object.prototype.hasOwnProperty;
     var hasNativeMap = typeof Map !== "undefined";
@@ -81070,9 +81176,9 @@ var require_array_set = __commonJS({
   }
 });
 
-// ../../../vgai-engine/node_modules/source-map/lib/mapping-list.js
+// ../../../../node_modules/source-map/lib/mapping-list.js
 var require_mapping_list = __commonJS({
-  "../../../vgai-engine/node_modules/source-map/lib/mapping-list.js"(exports) {
+  "../../../../node_modules/source-map/lib/mapping-list.js"(exports) {
     var util2 = require_util4();
     function generatedPositionAfter(mappingA, mappingB) {
       var lineA = mappingA.generatedLine;
@@ -81109,9 +81215,9 @@ var require_mapping_list = __commonJS({
   }
 });
 
-// ../../../vgai-engine/node_modules/source-map/lib/source-map-generator.js
+// ../../../../node_modules/source-map/lib/source-map-generator.js
 var require_source_map_generator = __commonJS({
-  "../../../vgai-engine/node_modules/source-map/lib/source-map-generator.js"(exports) {
+  "../../../../node_modules/source-map/lib/source-map-generator.js"(exports) {
     var base64VLQ = require_base64_vlq();
     var util2 = require_util4();
     var ArraySet = require_array_set().ArraySet;
@@ -81385,9 +81491,9 @@ var require_source_map_generator = __commonJS({
   }
 });
 
-// ../../../vgai-engine/node_modules/source-map/lib/binary-search.js
+// ../../../../node_modules/source-map/lib/binary-search.js
 var require_binary_search = __commonJS({
-  "../../../vgai-engine/node_modules/source-map/lib/binary-search.js"(exports) {
+  "../../../../node_modules/source-map/lib/binary-search.js"(exports) {
     exports.GREATEST_LOWER_BOUND = 1;
     exports.LEAST_UPPER_BOUND = 2;
     function recursiveSearch(aLow, aHigh, aNeedle, aHaystack, aCompare, aBias) {
@@ -81441,9 +81547,9 @@ var require_binary_search = __commonJS({
   }
 });
 
-// ../../../vgai-engine/node_modules/source-map/lib/quick-sort.js
+// ../../../../node_modules/source-map/lib/quick-sort.js
 var require_quick_sort = __commonJS({
-  "../../../vgai-engine/node_modules/source-map/lib/quick-sort.js"(exports) {
+  "../../../../node_modules/source-map/lib/quick-sort.js"(exports) {
     function swap(ary, x, y) {
       var temp = ary[x];
       ary[x] = ary[y];
@@ -81476,9 +81582,9 @@ var require_quick_sort = __commonJS({
   }
 });
 
-// ../../../vgai-engine/node_modules/source-map/lib/source-map-consumer.js
+// ../../../../node_modules/source-map/lib/source-map-consumer.js
 var require_source_map_consumer = __commonJS({
-  "../../../vgai-engine/node_modules/source-map/lib/source-map-consumer.js"(exports) {
+  "../../../../node_modules/source-map/lib/source-map-consumer.js"(exports) {
     var util2 = require_util4();
     var binarySearch = require_binary_search();
     var ArraySet = require_array_set().ArraySet;
@@ -82077,9 +82183,9 @@ var require_source_map_consumer = __commonJS({
   }
 });
 
-// ../../../vgai-engine/node_modules/source-map/lib/source-node.js
+// ../../../../node_modules/source-map/lib/source-node.js
 var require_source_node = __commonJS({
-  "../../../vgai-engine/node_modules/source-map/lib/source-node.js"(exports) {
+  "../../../../node_modules/source-map/lib/source-node.js"(exports) {
     var SourceMapGenerator = require_source_map_generator().SourceMapGenerator;
     var util2 = require_util4();
     var REGEX_NEWLINE = /(\r?\n)/;
@@ -82342,18 +82448,18 @@ var require_source_node = __commonJS({
   }
 });
 
-// ../../../vgai-engine/node_modules/source-map/source-map.js
+// ../../../../node_modules/source-map/source-map.js
 var require_source_map = __commonJS({
-  "../../../vgai-engine/node_modules/source-map/source-map.js"(exports) {
+  "../../../../node_modules/source-map/source-map.js"(exports) {
     exports.SourceMapGenerator = require_source_map_generator().SourceMapGenerator;
     exports.SourceMapConsumer = require_source_map_consumer().SourceMapConsumer;
     exports.SourceNode = require_source_node().SourceNode;
   }
 });
 
-// ../../../vgai-engine/node_modules/buffer-from/index.js
+// ../../../../node_modules/buffer-from/index.js
 var require_buffer_from = __commonJS({
-  "../../../vgai-engine/node_modules/buffer-from/index.js"(exports, module) {
+  "../../../../node_modules/buffer-from/index.js"(exports, module) {
     var toString = Object.prototype.toString;
     var isModern = typeof Buffer !== "undefined" && typeof Buffer.alloc === "function" && typeof Buffer.allocUnsafe === "function" && typeof Buffer.from === "function";
     function isArrayBuffer(input) {
@@ -82400,9 +82506,9 @@ var require_buffer_from = __commonJS({
   }
 });
 
-// ../../../vgai-engine/node_modules/source-map-support/source-map-support.js
+// ../../../../node_modules/source-map-support/source-map-support.js
 var require_source_map_support = __commonJS({
-  "../../../vgai-engine/node_modules/source-map-support/source-map-support.js"(exports, module) {
+  "../../../../node_modules/source-map-support/source-map-support.js"(exports) {
     var SourceMapConsumer = require_source_map().SourceMapConsumer;
     var path = __require("path");
     var fs3;
@@ -82414,9 +82520,6 @@ var require_source_map_support = __commonJS({
     } catch (err2) {
     }
     var bufferFrom = require_buffer_from();
-    function dynamicRequire(mod, request) {
-      return mod.require(request);
-    }
     var errorFormatterInstalled = false;
     var uncaughtShimInstalled = false;
     var emptyCacheBetweenOperations = false;
@@ -82436,23 +82539,6 @@ var require_source_map_support = __commonJS({
     function hasGlobalProcessEventEmitter() {
       return typeof process === "object" && process !== null && typeof process.on === "function";
     }
-    function globalProcessVersion() {
-      if (typeof process === "object" && process !== null) {
-        return process.version;
-      } else {
-        return "";
-      }
-    }
-    function globalProcessStderr() {
-      if (typeof process === "object" && process !== null) {
-        return process.stderr;
-      }
-    }
-    function globalProcessExit(code) {
-      if (typeof process === "object" && process !== null && typeof process.exit === "function") {
-        return process.exit(code);
-      }
-    }
     function handlerExec(list) {
       return function(arg) {
         for (var i = 0; i < list.length; i++) {
@@ -82677,20 +82763,15 @@ var require_source_map_support = __commonJS({
       object3.toString = CallSiteToString;
       return object3;
     }
-    function wrapCallSite(frame, state) {
-      if (state === void 0) {
-        state = { nextPosition: null, curPosition: null };
-      }
+    function wrapCallSite(frame) {
       if (frame.isNative()) {
-        state.curPosition = null;
         return frame;
       }
       var source = frame.getFileName() || frame.getScriptNameOrSourceURL();
       if (source) {
         var line = frame.getLineNumber();
         var column = frame.getColumnNumber() - 1;
-        var noHeader = /^v(10\.1[6-9]|10\.[2-9][0-9]|10\.[0-9]{3,}|1[2-9]\d*|[2-9]\d|\d{3,}|11\.11)/;
-        var headerLength = noHeader.test(globalProcessVersion()) ? 0 : 62;
+        var headerLength = 62;
         if (line === 1 && column > headerLength && !isInBrowser() && !frame.isEval()) {
           column -= headerLength;
         }
@@ -82699,14 +82780,10 @@ var require_source_map_support = __commonJS({
           line,
           column
         });
-        state.curPosition = position;
         frame = cloneCallSite(frame);
         var originalFunctionName = frame.getFunctionName;
         frame.getFunctionName = function() {
-          if (state.nextPosition == null) {
-            return originalFunctionName();
-          }
-          return state.nextPosition.name || originalFunctionName();
+          return position.name || originalFunctionName();
         };
         frame.getFileName = function() {
           return position.source;
@@ -82741,14 +82818,9 @@ var require_source_map_support = __commonJS({
       var name = error48.name || "Error";
       var message = error48.message || "";
       var errorString = name + ": " + message;
-      var state = { nextPosition: null, curPosition: null };
-      var processedStack = [];
-      for (var i = stack.length - 1; i >= 0; i--) {
-        processedStack.push("\n    at " + wrapCallSite(stack[i], state));
-        state.nextPosition = state.curPosition;
-      }
-      state.curPosition = state.nextPosition = null;
-      return errorString + processedStack.reverse().join("");
+      return errorString + stack.map(function(frame) {
+        return "\n    at " + wrapCallSite(frame);
+      }).join("");
     }
     function getErrorSource(error48) {
       var match = /\n    at [^(]+ \((.*):(\d+):(\d+)\)/.exec(error48.stack);
@@ -82775,16 +82847,15 @@ var require_source_map_support = __commonJS({
     }
     function printErrorAndExit(error48) {
       var source = getErrorSource(error48);
-      var stderr = globalProcessStderr();
-      if (stderr && stderr._handle && stderr._handle.setBlocking) {
-        stderr._handle.setBlocking(true);
+      if (process.stderr._handle && process.stderr._handle.setBlocking) {
+        process.stderr._handle.setBlocking(true);
       }
       if (source) {
         console.error();
         console.error(source);
       }
       console.error(error48.stack);
-      globalProcessExit(1);
+      process.exit(1);
     }
     function shimEmitUncaughtException() {
       var origEmit = process.emit;
@@ -82826,7 +82897,11 @@ var require_source_map_support = __commonJS({
         retrieveMapHandlers.unshift(options.retrieveSourceMap);
       }
       if (options.hookRequire && !isInBrowser()) {
-        var Module = dynamicRequire(module, "module");
+        var Module;
+        try {
+          Module = __require("module");
+        } catch (err2) {
+        }
         var $compile = Module.prototype._compile;
         if (!$compile.__sourceMapSupport) {
           Module.prototype._compile = function(content, filename) {
@@ -82846,13 +82921,6 @@ var require_source_map_support = __commonJS({
       }
       if (!uncaughtShimInstalled) {
         var installHandler = "handleUncaughtExceptions" in options ? options.handleUncaughtExceptions : true;
-        try {
-          var worker_threads = dynamicRequire(module, "worker_threads");
-          if (worker_threads.isMainThread === false) {
-            installHandler = false;
-          }
-        } catch (e) {
-        }
         if (installHandler && hasGlobalProcessEventEmitter()) {
           uncaughtShimInstalled = true;
           shimEmitUncaughtException();
@@ -309821,9 +309889,11 @@ import { dirname as dirname11, isAbsolute as isAbsolute8, join as join18, relati
 // ../../../vgai-engine/node_modules/fflate/esm/index.mjs
 import { createRequire } from "module";
 var require2 = createRequire("/");
+var _a2;
 var Worker;
+var isMarkedAsUntransferable;
 try {
-  Worker = require2("worker_threads").Worker;
+  _a2 = require2("worker_threads"), Worker = _a2.Worker, isMarkedAsUntransferable = _a2.isMarkedAsUntransferable;
 } catch (e) {
 }
 var u8 = Uint8Array;
@@ -310021,6 +310091,7 @@ var ec = [
   "stream finished",
   "no stream handler",
   ,
+  // determined by compression function
   "no callback",
   "invalid UTF-8 data",
   "extra field too long",
@@ -310551,7 +310622,7 @@ var fltn = function(d, p, t, o) {
     var val = d[k], n = p + k, op = o;
     if (Array.isArray(val))
       op = mrg(o, val[1]), val = val[0];
-    if (val instanceof u8)
+    if (ArrayBuffer.isView(val))
       t[n] = [val, op];
     else {
       t[n += "/"] = [new u8(0), op];
@@ -310635,14 +310706,28 @@ var slzh = function(d, b) {
   return b + 30 + b2(d, b + 26) + b2(d, b + 28);
 };
 var zh = function(d, b, z2) {
-  var fnl = b2(d, b + 28), fn = strFromU8(d.subarray(b + 46, b + 46 + fnl), !(b2(d, b + 8) & 2048)), es = b + 46 + fnl, bs = b4(d, b + 20);
-  var _a3 = z2 && bs == 4294967295 ? z64e(d, es) : [bs, b4(d, b + 24), b4(d, b + 42)], sc = _a3[0], su = _a3[1], off = _a3[2];
-  return [b2(d, b + 10), sc, su, fn, es + b2(d, b + 30) + b2(d, b + 32), off];
+  var fnl = b2(d, b + 28), efl = b2(d, b + 30), fn = strFromU8(d.subarray(b + 46, b + 46 + fnl), !(b2(d, b + 8) & 2048)), es = b + 46 + fnl;
+  var _a3 = z64hs(d, es, efl, z2, b4(d, b + 20), b4(d, b + 24), b4(d, b + 42)), sc = _a3[0], su = _a3[1], off = _a3[2];
+  return [b2(d, b + 10), sc, su, fn, es + efl + b2(d, b + 32), off];
 };
-var z64e = function(d, b) {
-  for (; b2(d, b) != 1; b += 4 + b2(d, b + 2))
-    ;
-  return [b8(d, b + 12), b8(d, b + 4), b8(d, b + 20)];
+var z64hs = function(d, b, l, z2, sc, su, off) {
+  var nsc = sc == 4294967295, nsu = su == 4294967295, noff = off == 4294967295, e = b + l;
+  var nf = nsc + nsu + noff;
+  if (z2 && nf) {
+    for (; b + 4 < e; b += 4 + b2(d, b + 2)) {
+      if (b2(d, b) == 1) {
+        return [
+          nsc ? b8(d, b + 4 + 8 * nsu) : sc,
+          nsu ? b8(d, b + 4) : su,
+          noff ? b8(d, b + 4 + 8 * (nsu + nsc)) : off,
+          1
+        ];
+      }
+    }
+    if (z2 < 2)
+      err(13);
+  }
+  return [sc, su, off, 0];
 };
 var exfl = function(ex) {
   var le = 0;
@@ -310757,7 +310842,7 @@ function unzipSync(data, opts) {
   if (!c)
     return {};
   var o = b4(data, e + 16);
-  var z2 = o == 4294967295 || c == 65535;
+  var z2 = b4(data, e - 20) == 117853008;
   if (z2) {
     var ze = b4(data, e - 12);
     z2 = b4(data, ze) == 101075792;
@@ -311794,6 +311879,8 @@ var RELAY_COMMANDS = {
   "bridge-recording-start": { timeoutMs: 15e3 },
   "bridge-recording-stop": { timeoutMs: 6e4 },
   "page-script": { timeoutMs: 6e4 },
+  // THE MODULE LANE: an in-page step over { page, modules, instanceId }.
+  "game-eval": { timeoutMs: 6e4 },
   "page-reload": { timeoutMs: DEFAULT_RELAY_COMMAND_TIMEOUT_MS }
 };
 var RELAY_COMMAND_TYPES = Object.keys(RELAY_COMMANDS);
@@ -316371,7 +316458,7 @@ var src_default = Yoga;
 // ../../../vgai-engine/node_modules/ink/node_modules/ansi-regex/index.js
 function ansiRegex({ onlyFirst = false } = {}) {
   const ST = "(?:\\u0007|\\u001B\\u005C|\\u009C)";
-  const osc = `(?:\\u001B\\][\\s\\S]*?${ST})`;
+  const osc = `(?:\\u001B\\][^\\u0007\\u001B\\u009C]*${ST})`;
   const csi = "[\\u001B\\u009B][[\\]()#;?]*(?:\\d{1,4}(?:[;:]\\d{0,4})*)?[\\dA-PR-TZcf-nq-uy=><~]";
   const pattern = `${osc}|${csi}`;
   return new RegExp(pattern, onlyFirst ? void 0 : "g");
@@ -323661,6 +323748,34 @@ function shouldMountInk(input) {
 }
 
 // src/instrumentation-signal.ts
+import { spawnSync as spawnSync8 } from "node:child_process";
+function git2(cwd2, args2) {
+  const result = spawnSync8("git", args2, { cwd: cwd2, encoding: "utf-8" });
+  if (result.error || result.status !== 0) return null;
+  return (result.stdout ?? "").trim();
+}
+var REAL_HISTORY_COMMITS = 5;
+var UNPUSHED_THRESHOLD = 10;
+function remoteLine(projectRoot) {
+  if (!projectRoot) return null;
+  if (git2(projectRoot, ["rev-parse", "--is-inside-work-tree"]) !== "true") return null;
+  const commitsRaw = git2(projectRoot, ["rev-list", "--count", "HEAD"]);
+  const commits = commitsRaw === null ? 0 : Number.parseInt(commitsRaw, 10);
+  if (!Number.isFinite(commits) || commits < REAL_HISTORY_COMMITS) return null;
+  const remotes = git2(projectRoot, ["remote"]);
+  if (remotes === null || remotes === "") {
+    return `remote: NONE \u2014 ${commits} commit(s) of history exist only on this machine (create one: \`gh repo create <owner>/<name> --private --source . --push\`)`;
+  }
+  const ahead = git2(projectRoot, ["rev-list", "--count", "@{upstream}..HEAD"]);
+  if (ahead === null) {
+    return `remote: ${remotes.split("\n")[0]} exists but this branch has NO UPSTREAM \u2014 push with -u`;
+  }
+  const aheadCount = Number.parseInt(ahead, 10);
+  if (Number.isFinite(aheadCount) && aheadCount >= UNPUSHED_THRESHOLD) {
+    return `remote: ${aheadCount} commit(s) unpushed \u2014 this machine is the only copy of recent work`;
+  }
+  return null;
+}
 function livePlaneLine(shape) {
   if (!shape) {
     return "live plane: idle \u2014 commands/providers enumerate while playing (`vgai play`)";
@@ -324104,7 +324219,7 @@ function runIntegrationsCommand(argv, io = {}) {
 }
 
 // src/isolated-worktree.ts
-import { execFileSync as execFileSync5, spawnSync as spawnSync8 } from "node:child_process";
+import { execFileSync as execFileSync5, spawnSync as spawnSync9 } from "node:child_process";
 import { createHash as createHash7, randomUUID } from "node:crypto";
 import {
   chmodSync,
@@ -324140,7 +324255,7 @@ function canonical(path) {
     return resolve13(path);
   }
 }
-function git2(cwd2, args2) {
+function git3(cwd2, args2) {
   try {
     const output = execFileSync4("git", ["-C", cwd2, ...args2], {
       encoding: "utf8",
@@ -324157,7 +324272,7 @@ function resolveGitPath(worktreeRoot, rawPath) {
 }
 function defaultBaseCommit(worktreeRoot, headCommit) {
   if (!headCommit) return null;
-  const originHead = git2(worktreeRoot, ["symbolic-ref", "--quiet", "refs/remotes/origin/HEAD"]);
+  const originHead = git3(worktreeRoot, ["symbolic-ref", "--quiet", "refs/remotes/origin/HEAD"]);
   const candidates = [
     originHead,
     "refs/remotes/origin/main",
@@ -324166,14 +324281,14 @@ function defaultBaseCommit(worktreeRoot, headCommit) {
   ];
   for (const candidate of candidates) {
     if (!candidate) continue;
-    const base = git2(worktreeRoot, ["merge-base", "HEAD", candidate]);
+    const base = git3(worktreeRoot, ["merge-base", "HEAD", candidate]);
     if (base) return base;
   }
   return headCommit;
 }
 function resolveWorktreeIdentity(projectRoot) {
   const project = canonical(projectRoot);
-  const discoveredRoot = git2(project, ["rev-parse", "--show-toplevel"]);
+  const discoveredRoot = git3(project, ["rev-parse", "--show-toplevel"]);
   if (!discoveredRoot) {
     const repositoryId2 = `local-${hash2(project)}`;
     return {
@@ -324189,13 +324304,13 @@ function resolveWorktreeIdentity(projectRoot) {
   const worktreeRoot = canonical(discoveredRoot);
   const commonDir = resolveGitPath(
     worktreeRoot,
-    git2(worktreeRoot, ["rev-parse", "--git-common-dir"])
+    git3(worktreeRoot, ["rev-parse", "--git-common-dir"])
   );
-  const remote = git2(worktreeRoot, ["config", "--get", "remote.origin.url"]);
+  const remote = git3(worktreeRoot, ["config", "--get", "remote.origin.url"]);
   const repositoryKey = remote ?? commonDir ?? worktreeRoot;
   const repositoryId = `repository-${hash2(repositoryKey)}`;
-  const branch = git2(worktreeRoot, ["symbolic-ref", "--quiet", "--short", "HEAD"]);
-  const headCommit = git2(worktreeRoot, ["rev-parse", "--verify", "HEAD"]);
+  const branch = git3(worktreeRoot, ["symbolic-ref", "--quiet", "--short", "HEAD"]);
+  const headCommit = git3(worktreeRoot, ["rev-parse", "--verify", "HEAD"]);
   const projectRelativePath = relative8(worktreeRoot, project) || ".";
   if (projectRelativePath === ".." || projectRelativePath.startsWith(`..${process.platform === "win32" ? "\\" : "/"}`)) {
     throw new Error(`Project ${project} is outside its reported Git worktree ${worktreeRoot}.`);
@@ -324245,7 +324360,7 @@ var systemRunner = {
   runToFile(command2, args2, destination) {
     const output = openSync2(destination, "wx", 384);
     try {
-      const result = spawnSync8(command2, [...args2], {
+      const result = spawnSync9(command2, [...args2], {
         encoding: "utf8",
         stdio: ["ignore", output, "pipe"]
       });
@@ -324715,7 +324830,7 @@ function stopIsolatedWorktree(id, discard, runner = systemRunner) {
 }
 function attachIsolatedAgent(id, harness) {
   const record2 = readRecord(id);
-  const result = spawnSync8(
+  const result = spawnSync9(
     "docker",
     [
       "exec",
@@ -327047,7 +327162,7 @@ function applyPorcelainField(record2, key, value) {
   else if (key === "bare") record2.bare = true;
   else if (key === "detached") record2.detached = true;
 }
-function git3(cwd2, args2) {
+function git4(cwd2, args2) {
   try {
     return execFileSync6("git", ["-C", cwd2, ...args2], {
       encoding: "utf8",
@@ -327121,7 +327236,7 @@ async function listRepositoryWorktrees(projectRoot, sessions2 = []) {
     throw new Error(`${projectRoot} is not inside a Git repository.`);
   }
   const records = parseWorktreePorcelain(
-    git3(currentIdentity.worktreeRoot, ["worktree", "list", "--porcelain"])
+    git4(currentIdentity.worktreeRoot, ["worktree", "list", "--porcelain"])
   );
   return Promise.all(
     records.map(async (record2) => {
@@ -327147,10 +327262,10 @@ function createRepositoryWorktree(projectRoot, options) {
   const identity = resolveWorktreeIdentity(projectRoot);
   if (identity.headCommit === null)
     throw new Error(`${projectRoot} is not inside a Git repository.`);
-  git3(identity.worktreeRoot, ["check-ref-format", "--branch", options.branch]);
+  git4(identity.worktreeRoot, ["check-ref-format", "--branch", options.branch]);
   const branchExists = (() => {
     try {
-      git3(identity.worktreeRoot, ["show-ref", "--verify", `refs/heads/${options.branch}`]);
+      git4(identity.worktreeRoot, ["show-ref", "--verify", `refs/heads/${options.branch}`]);
       return true;
     } catch {
       return false;
@@ -327165,7 +327280,7 @@ function createRepositoryWorktree(projectRoot, options) {
   const args2 = ["worktree", "add"];
   if (!branchExists) args2.push("-b", options.branch);
   args2.push(destination, branchExists ? options.branch : options.from ?? "HEAD");
-  git3(identity.worktreeRoot, args2);
+  git4(identity.worktreeRoot, args2);
   const root = realpathSync6(destination);
   const project = join36(root, identity.projectRelativePath);
   return {
@@ -327211,12 +327326,12 @@ function archiveRepositoryWorktree(projectRoot, targetRoot, sessions2) {
   if (sessions2.some((session) => session.worktreeId === target.worktreeId)) {
     throw new Error(`Stop the live session for ${target.worktreeRoot} before archiving it.`);
   }
-  if (git3(target.worktreeRoot, ["status", "--porcelain"]) !== "") {
+  if (git4(target.worktreeRoot, ["status", "--porcelain"]) !== "") {
     throw new Error(
       `Worktree ${target.worktreeRoot} is dirty; checkpoint or clean it before archiving.`
     );
   }
-  git3(current.worktreeRoot, ["worktree", "remove", target.worktreeRoot]);
+  git4(current.worktreeRoot, ["worktree", "remove", target.worktreeRoot]);
 }
 
 // src/index.ts
@@ -327233,8 +327348,8 @@ function catalogDistributionDir() {
   );
 }
 function cliVersion() {
-  if ("0.5.23") {
-    return "0.5.23";
+  if ("0.5.25") {
+    return "0.5.25";
   }
   try {
     const pkg = JSON.parse(readFileSync31(join37(__dirname4, "..", "package.json"), "utf8"));
@@ -327253,7 +327368,7 @@ function bakedTargetVersions() {
   if (false)
     return void 0;
   try {
-    return JSON.parse('{"@vgai/engine":"0.5.23","@vgai/editor":"0.5.23","@vgai/p2p-colyseus":"0.5.23","@vgai/live":"0.5.23","@vgai/sdk":"0.5.23","@vgai/editor-sdk":"0.5.23","@vgai/cli":"0.5.23"}');
+    return JSON.parse('{"@vgai/engine":"0.5.25","@vgai/editor":"0.5.25","@vgai/p2p-colyseus":"0.5.25","@vgai/live":"0.5.25","@vgai/sdk":"0.5.25","@vgai/editor-sdk":"0.5.25","@vgai/cli":"0.5.25"}');
   } catch {
     return void 0;
   }
@@ -328203,6 +328318,8 @@ async function instrumentationSignalLines(state) {
     const shape = state.playState === "playing" ? await readDebugPlaneShape(Number(new URL(resolveEditorTargetUrl()).port)) : null;
     lines.push(livePlaneLine(shape));
   }
+  const remote = remoteLine(findProjectRootFrom2(process.cwd()));
+  if (remote) lines.push(remote);
   return lines;
 }
 function playFailureReport(evidence) {

package/package.json

@@ -2,7 +2,7 @@
   "name": "@vgai/cli",
   "author": "Volter AI, Inc.",
   "license": "Apache-2.0",
-  "version": "0.5.23",
+  "version": "0.5.25",
   "description": "Create, open, control, validate, and playtest VGAI game projects.",
   "keywords": [
     "game-engine",
@@ -39,12 +39,12 @@
   },
   "dependencies": {
     "@oclif/core": "^4.11.14",
-    "@vgai/editor": "0.5.23",
-    "@vgai/editor-sdk": "0.5.23",
-    "@vgai/engine": "0.5.23",
-    "@vgai/live": "0.5.23",
-    "@vgai/p2p-colyseus": "0.5.23",
-    "@vgai/sdk": "0.5.23",
+    "@vgai/editor": "0.5.25",
+    "@vgai/editor-sdk": "0.5.25",
+    "@vgai/engine": "0.5.25",
+    "@vgai/live": "0.5.25",
+    "@vgai/p2p-colyseus": "0.5.25",
+    "@vgai/sdk": "0.5.25",
     "ink": "^7.1.0",
     "playwright": "^1.58.2",
     "react": "^19.2.4",