@joeytheman/gemini-mcp-tool 2.2.0 → 2.3.0

package/dist/utils/artifactFile.js

@@ -0,0 +1,55 @@
+import * as fs from 'fs';
+import * as path from 'path';
+import { isWithin } from './fileReferences.js';
+import { LIVE_PASS } from '../constants.js';
+export const IMAGE_FILE = /\.(png|jpe?g)$/i;
+export function hasImageSignature(file) {
+    const extension = path.extname(file).toLowerCase();
+    if (extension !== '.png' && extension !== '.jpg' && extension !== '.jpeg')
+        return false;
+    let handle;
+    try {
+        handle = fs.openSync(file, 'r');
+    }
+    catch {
+        return false;
+    }
+    try {
+        const header = Buffer.alloc(24);
+        const size = fs.readSync(handle, header, 0, header.length, 0);
+        if (extension === '.png') {
+            return size === header.length
+                && header.subarray(0, 8).equals(Buffer.from([137, 80, 78, 71, 13, 10, 26, 10]))
+                && header.readUInt32BE(8) === 13
+                && header.toString('ascii', 12, 16) === 'IHDR'
+                && header.readUInt32BE(16) > 0
+                && header.readUInt32BE(20) > 0;
+        }
+        return size >= 3 && header[0] === 0xff && header[1] === 0xd8 && header[2] === 0xff;
+    }
+    catch {
+        return false;
+    }
+    finally {
+        fs.closeSync(handle);
+    }
+}
+/** Whether a file a pass wrote is inside `artifactDir`, present, non-empty and written during this run. */
+export function checkArtifactFile(absFile, artifactDir, runStartMs) {
+    if (!isWithin(artifactDir, absFile))
+        return 'OUTSIDE';
+    try {
+        const stat = fs.statSync(absFile);
+        if (!stat.isFile())
+            return 'MISSING';
+        if (stat.size === 0)
+            return 'EMPTY';
+        if (stat.mtimeMs < runStartMs - LIVE_PASS.FRESHNESS_TOLERANCE_MS)
+            return 'STALE';
+        return 'OK';
+    }
+    catch {
+        return 'MISSING';
+    }
+}
+//# sourceMappingURL=artifactFile.js.map

package/dist/utils/artifactFile.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"artifactFile.js","sourceRoot":"","sources":["../../src/utils/artifactFile.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,IAAI,CAAC;AACzB,OAAO,KAAK,IAAI,MAAM,MAAM,CAAC;AAC7B,OAAO,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAC/C,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAI5C,MAAM,CAAC,MAAM,UAAU,GAAG,iBAAiB,CAAC;AAE5C,MAAM,UAAU,iBAAiB,CAAC,IAAY;IAC5C,MAAM,SAAS,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,WAAW,EAAE,CAAC;IACnD,IAAI,SAAS,KAAK,MAAM,IAAI,SAAS,KAAK,MAAM,IAAI,SAAS,KAAK,OAAO;QAAE,OAAO,KAAK,CAAC;IAExF,IAAI,MAAc,CAAC;IACnB,IAAI,CAAC;QACH,MAAM,GAAG,EAAE,CAAC,QAAQ,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;IAClC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;IAED,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;QAChC,MAAM,IAAI,GAAG,EAAE,CAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;QAC9D,IAAI,SAAS,KAAK,MAAM,EAAE,CAAC;YACzB,OAAO,IAAI,KAAK,MAAM,CAAC,MAAM;mBACxB,MAAM,CAAC,QAAQ,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,CAAC,CAAC,CAAC;mBAC5E,MAAM,CAAC,YAAY,CAAC,CAAC,CAAC,KAAK,EAAE;mBAC7B,MAAM,CAAC,QAAQ,CAAC,OAAO,EAAE,EAAE,EAAE,EAAE,CAAC,KAAK,MAAM;mBAC3C,MAAM,CAAC,YAAY,CAAC,EAAE,CAAC,GAAG,CAAC;mBAC3B,MAAM,CAAC,YAAY,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC;QACnC,CAAC;QACD,OAAO,IAAI,IAAI,CAAC,IAAI,MAAM,CAAC,CAAC,CAAC,KAAK,IAAI,IAAI,MAAM,CAAC,CAAC,CAAC,KAAK,IAAI,IAAI,MAAM,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC;IACrF,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;YAAS,CAAC;QACT,EAAE,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;IACvB,CAAC;AACH,CAAC;AAED,2GAA2G;AAC3G,MAAM,UAAU,iBAAiB,CAAC,OAAe,EAAE,WAAmB,EAAE,UAAkB;IACxF,IAAI,CAAC,QAAQ,CAAC,WAAW,EAAE,OAAO,CAAC;QAAE,OAAO,SAAS,CAAC;IACtD,IAAI,CAAC;QACH,MAAM,IAAI,GAAG,EAAE,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;QAClC,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE;YAAE,OAAO,SAAS,CAAC;QACrC,IAAI,IAAI,CAAC,IAAI,KAAK,CAAC;YAAE,OAAO,OAAO,CAAC;QACpC,IAAI,IAAI,CAAC,OAAO,GAAG,UAAU,GAAG,SAAS,CAAC,sBAAsB;YAAE,OAAO,OAAO,CAAC;QACjF,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,SAAS,CAAC;IACnB,CAAC;AACH,CAAC"}

package/dist/utils/captureScript.d.ts

@@ -0,0 +1,24 @@
+export interface Viewport {
+    width: number;
+    height: number;
+}
+/**
+ * With a shown aria-modal sheet open, only the scrollers inside it count, so a
+ * sheet over a long screen is still shot at the viewport. `shown` and the modal
+ * lookup match src/layout-check.snippet.js, so both agree on which sheet counts.
+ */
+export declare const SCROLL_OVERFLOW_SNIPPET = "() => {\n    const shown = (el) => {\n      const r = el.getBoundingClientRect();\n      return r.width > 0 && r.height > 0 && getComputedStyle(el).visibility !== 'hidden' && !el.closest('[aria-hidden=\"true\"],[inert]');\n    };\n    const scrolls = (el) => el.tagName !== 'TEXTAREA' && /^(auto|scroll)$/.test(getComputedStyle(el).overflowY) && shown(el);\n    const modal = [...document.querySelectorAll('[aria-modal=\"true\"]')].find(shown);\n    let overflow = modal ? 0 : (document.scrollingElement || document.documentElement).scrollHeight - innerHeight;\n    for (const el of modal ? [modal, ...modal.querySelectorAll('*')] : document.querySelectorAll('*')) {\n      const extra = el.scrollHeight - el.clientHeight;\n      if (extra > overflow && scrolls(el)) overflow = extra;\n    }\n    return overflow;\n  }";
+export declare function parseViewport(viewport: string): Viewport | null;
+export declare function saveLayoutFunction(key: string): string;
+/**
+ * The text of one target's capture file, run by @playwright/mcp's
+ * browser_run_code_unsafe as `(<text>)(page)` in a vm context that holds only
+ * `page` and a few timer and web globals: it must stay one expression, with no
+ * `require`, `fs` or `process`, and no trailing `;` or line comment.
+ */
+export declare function buildCaptureScript(config: {
+    viewport: Viewport;
+    frameFile: string;
+    key: string;
+}): string;
+//# sourceMappingURL=captureScript.d.ts.map

package/dist/utils/captureScript.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"captureScript.d.ts","sourceRoot":"","sources":["../../src/utils/captureScript.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,QAAQ;IACvB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;;;GAIG;AACH,eAAO,MAAM,uBAAuB,uzBAahC,CAAC;AAEL,wBAAgB,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,QAAQ,GAAG,IAAI,CAG/D;AAED,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAEtD;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE;IAAE,QAAQ,EAAE,QAAQ,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,GAAG,MAAM,CAgDzG"}

package/dist/utils/captureScript.js

@@ -0,0 +1,83 @@
+import { LAYOUT_CHECK_SNIPPET, LIVE_PASS } from '../constants.js';
+/**
+ * With a shown aria-modal sheet open, only the scrollers inside it count, so a
+ * sheet over a long screen is still shot at the viewport. `shown` and the modal
+ * lookup match src/layout-check.snippet.js, so both agree on which sheet counts.
+ */
+export const SCROLL_OVERFLOW_SNIPPET = `() => {
+    const shown = (el) => {
+      const r = el.getBoundingClientRect();
+      return r.width > 0 && r.height > 0 && getComputedStyle(el).visibility !== 'hidden' && !el.closest('[aria-hidden="true"],[inert]');
+    };
+    const scrolls = (el) => el.tagName !== 'TEXTAREA' && /^(auto|scroll)$/.test(getComputedStyle(el).overflowY) && shown(el);
+    const modal = [...document.querySelectorAll('[aria-modal="true"]')].find(shown);
+    let overflow = modal ? 0 : (document.scrollingElement || document.documentElement).scrollHeight - innerHeight;
+    for (const el of modal ? [modal, ...modal.querySelectorAll('*')] : document.querySelectorAll('*')) {
+      const extra = el.scrollHeight - el.clientHeight;
+      if (extra > overflow && scrolls(el)) overflow = extra;
+    }
+    return overflow;
+  }`;
+export function parseViewport(viewport) {
+    const match = /^\s*([1-9]\d*)\s*x\s*([1-9]\d*)\s*$/i.exec(viewport);
+    return match ? { width: Number(match[1]), height: Number(match[2]) } : null;
+}
+export function saveLayoutFunction(key) {
+    return `() => window.__livePassLayout?.[${JSON.stringify(key)}]`;
+}
+/**
+ * The text of one target's capture file, run by @playwright/mcp's
+ * browser_run_code_unsafe as `(<text>)(page)` in a vm context that holds only
+ * `page` and a few timer and web globals: it must stay one expression, with no
+ * `require`, `fs` or `process`, and no trailing `;` or line comment.
+ */
+export function buildCaptureScript(config) {
+    const capture = JSON.stringify({
+        ...config,
+        settleMs: LIVE_PASS.CAPTURE_SETTLE_MS,
+        maxHeight: Math.max(LIVE_PASS.CAPTURE_MAX_HEIGHT, config.viewport.height),
+        maxGrows: LIVE_PASS.CAPTURE_MAX_GROWS,
+    });
+    return `async (page) => {
+  const { viewport, frameFile, key, settleMs, maxHeight, maxGrows } = ${capture};
+  const settle = () => new Promise((resolve) => setTimeout(resolve, settleMs));
+  const firstLine = (error) => String((error && error.message) || error).split('\\n')[0];
+  const overflow = () => page.evaluate(${SCROLL_OVERFLOW_SNIPPET});
+  const shoot = async () => {
+    let height = viewport.height;
+    for (let grown = 0, last = Infinity; grown < maxGrows && height < maxHeight; grown++) {
+      const by = await overflow();
+      if (by <= 1 || by >= last) break;
+      height = Math.min(height + Math.ceil(by), maxHeight);
+      await page.setViewportSize({ width: viewport.width, height });
+      await settle();
+      last = by;
+    }
+    await page.screenshot({ path: frameFile, type: 'png', scale: 'css' });
+    const saved = 'saved ' + frameFile + ' at ' + viewport.width + 'x' + height;
+    try {
+      await page.evaluate((key) => {
+        const reports = (window.__livePassLayout = window.__livePassLayout || {});
+        delete reports[key];
+        reports[key] = (${LAYOUT_CHECK_SNIPPET})();
+      }, key);
+      return saved;
+    } catch (error) {
+      return saved + '; layout not measured: ' + firstLine(error);
+    }
+  };
+  const restore = () => page.setViewportSize(viewport).then(() => '', (error) => '; viewport not restored: ' + firstLine(error));
+  await page.setViewportSize(viewport);
+  await settle();
+  let result;
+  try {
+    result = await shoot();
+  } catch (error) {
+    await restore();
+    throw error;
+  }
+  return result + (await restore());
+}
+`;
+}
+//# sourceMappingURL=captureScript.js.map

package/dist/utils/captureScript.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"captureScript.js","sourceRoot":"","sources":["../../src/utils/captureScript.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAOlE;;;;GAIG;AACH,MAAM,CAAC,MAAM,uBAAuB,GAAG;;;;;;;;;;;;;IAanC,CAAC;AAEL,MAAM,UAAU,aAAa,CAAC,QAAgB;IAC5C,MAAM,KAAK,GAAG,sCAAsC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IACpE,OAAO,KAAK,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;AAC9E,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,GAAW;IAC5C,OAAO,mCAAmC,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,GAAG,CAAC;AACnE,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,kBAAkB,CAAC,MAA8D;IAC/F,MAAM,OAAO,GAAG,IAAI,CAAC,SAAS,CAAC;QAC7B,GAAG,MAAM;QACT,QAAQ,EAAE,SAAS,CAAC,iBAAiB;QACrC,SAAS,EAAE,IAAI,CAAC,GAAG,CAAC,SAAS,CAAC,kBAAkB,EAAE,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC;QACzE,QAAQ,EAAE,SAAS,CAAC,iBAAiB;KACtC,CAAC,CAAC;IACH,OAAO;wEAC+D,OAAO;;;yCAGtC,uBAAuB;;;;;;;;;;;;;;;;;0BAiBtC,oBAAoB;;;;;;;;;;;;;;;;;;;CAmB7C,CAAC;AACF,CAAC"}

package/dist/utils/commandExecutor.d.ts

@@ -1,2 +1,8 @@
-export declare function executeCommand(command: string, args: string[], onProgress?: (newOutput: string) => void, cwd?: string): Promise<string>;
+export interface CommandLimits {
+    /** Stop the process this long after spawn (SIGTERM then SIGKILL on POSIX; taskkill on Windows). */
+    killAfterMs?: number;
+    /** Stop the process when the caller's request is cancelled. */
+    signal?: AbortSignal;
+}
+export declare function executeCommand(command: string, args: string[], onProgress?: (newOutput: string) => void, cwd?: string, limits?: CommandLimits): Promise<string>;
 //# sourceMappingURL=commandExecutor.d.ts.map

package/dist/utils/commandExecutor.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"commandExecutor.d.ts","sourceRoot":"","sources":["../../src/utils/commandExecutor.ts"],"names":[],"mappings":"AAGA,wBAAsB,cAAc,CAClC,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,MAAM,EAAE,EACd,UAAU,CAAC,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,IAAI,EACxC,GAAG,CAAC,EAAE,MAAM,GACX,OAAO,CAAC,MAAM,CAAC,CA2FjB"}
+{"version":3,"file":"commandExecutor.d.ts","sourceRoot":"","sources":["../../src/utils/commandExecutor.ts"],"names":[],"mappings":"AAOA,MAAM,WAAW,aAAa;IAC5B,mGAAmG;IACnG,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,+DAA+D;IAC/D,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB;AAED,wBAAsB,cAAc,CAClC,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,MAAM,EAAE,EACd,UAAU,CAAC,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,IAAI,EACxC,GAAG,CAAC,EAAE,MAAM,EACZ,MAAM,GAAE,aAAkB,GACzB,OAAO,CAAC,MAAM,CAAC,CAmNjB"}

package/dist/utils/commandExecutor.js

@@ -1,21 +1,140 @@
 import { spawn } from "child_process";
 import { Logger } from "./logger.js";
-export async function executeCommand(command, args, onProgress, cwd) {
+import { AGY_LIMITS, ERROR_MESSAGES } from "../constants.js";
+// Node clamps longer delays to 1 ms, so long limits need more than one timer.
+const MAX_TIMER_DELAY_MS = 2 ** 31 - 1;
+export async function executeCommand(command, args, onProgress, cwd, limits = {}) {
     return new Promise((resolve, reject) => {
+        if (limits.signal?.aborted) {
+            reject(new Error(ERROR_MESSAGES.AGY_CANCELLED));
+            return;
+        }
         const startTime = Date.now();
         Logger.commandExecution(command, args, startTime);
+        // Give limited POSIX commands their own process group. agy's MCP children
+        // inherit it, so a stop can reach them even if agy ignores SIGTERM.
+        const grouped = process.platform !== "win32" &&
+            (limits.killAfterMs !== undefined || limits.signal !== undefined);
         const childProcess = spawn(command, args, {
             env: process.env,
             shell: false,
             stdio: ["ignore", "pipe", "pipe"],
             ...(cwd && { cwd }),
+            ...(grouped && { detached: true }),
         });
         // Use array buffers for O(n) performance instead of O(n²) string concatenation
         const stdoutChunks = [];
         const stderrChunks = [];
         let isResolved = false;
+        let stopError;
         let resourceExhausted = false;
+        let ceilingTimer;
+        let graceTimer;
+        let closeTimer;
+        const settle = () => {
+            isResolved = true;
+            clearTimeout(ceilingTimer);
+            clearTimeout(graceTimer);
+            clearTimeout(closeTimer);
+            limits.signal?.removeEventListener("abort", onAbort);
+        };
+        const signalProcessGroup = (signal) => {
+            try {
+                if (grouped && childProcess.pid !== undefined) {
+                    process.kill(-childProcess.pid, signal);
+                }
+                else {
+                    childProcess.kill(signal);
+                }
+            }
+            catch {
+                // A process can exit between the timer and the signal. If the group
+                // signal failed for another reason, still try to stop agy itself.
+                if (grouped)
+                    childProcess.kill(signal);
+            }
+        };
+        const signalWindowsTree = () => {
+            if (childProcess.pid === undefined) {
+                childProcess.kill("SIGKILL");
+                return;
+            }
+            // Windows has no negative-PID group signal. Kill the tree while the
+            // parent PID still exists, before its children can become orphaned.
+            const killer = spawn("taskkill", ["/PID", String(childProcess.pid), "/T", "/F"], {
+                shell: false,
+                stdio: "ignore",
+                windowsHide: true,
+            });
+            killer.on("error", (error) => {
+                Logger.error("Could not stop the Windows process tree:", error);
+                childProcess.kill("SIGKILL");
+            });
+            killer.on("close", (code) => {
+                if (code !== 0 && !isResolved) {
+                    Logger.error(`taskkill could not stop the Windows process tree (exit ${code})`);
+                    childProcess.kill("SIGKILL");
+                }
+            });
+        };
+        const finishStopped = (code) => {
+            if (isResolved)
+                return;
+            settle();
+            Logger.commandComplete(startTime, code);
+            reject(stopError);
+        };
+        const forceStop = () => {
+            if (isResolved)
+                return;
+            if (process.platform === "win32")
+                signalWindowsTree();
+            else
+                signalProcessGroup("SIGKILL");
+            // A detached descendant can keep inherited pipes open after agy dies,
+            // so bound the wait for close.
+            closeTimer = setTimeout(() => {
+                childProcess.stdout.destroy?.();
+                childProcess.stderr.destroy?.();
+                finishStopped(childProcess.exitCode ?? null);
+            }, AGY_LIMITS.KILL_CLOSE_WAIT_MS);
+        };
+        const stop = (error) => {
+            if (isResolved || stopError)
+                return;
+            stopError = error;
+            clearTimeout(ceilingTimer);
+            limits.signal?.removeEventListener("abort", onAbort);
+            Logger.error(error.message);
+            if (process.platform === "win32")
+                signalWindowsTree();
+            else
+                signalProcessGroup("SIGTERM");
+            graceTimer = setTimeout(forceStop, AGY_LIMITS.KILL_GRACE_MS);
+        };
+        function onAbort() {
+            stop(new Error(ERROR_MESSAGES.AGY_CANCELLED));
+        }
+        if (limits.killAfterMs !== undefined) {
+            const limitMs = limits.killAfterMs;
+            const deadline = Date.now() + limitMs;
+            const scheduleCeiling = () => {
+                const remaining = deadline - Date.now();
+                if (remaining <= 0) {
+                    stop(new Error(`${ERROR_MESSAGES.AGY_HUNG}: limit ${Math.round(limitMs / 1000)}s`));
+                }
+                else {
+                    ceilingTimer = setTimeout(scheduleCeiling, Math.min(remaining, MAX_TIMER_DELAY_MS));
+                }
+            };
+            scheduleCeiling();
+        }
+        limits.signal?.addEventListener("abort", onAbort, { once: true });
+        if (limits.signal?.aborted)
+            onAbort();
         childProcess.stdout.on("data", (data) => {
+            if (stopError)
+                return;
             const chunk = data.toString();
             stdoutChunks.push(chunk);
             // Report immediately if callback provided (no substring calculation needed)
@@ -25,6 +144,8 @@ export async function executeCommand(command, args, onProgress, cwd) {
         });
         // CLI level errors
         childProcess.stderr.on("data", (data) => {
+            if (stopError)
+                return;
             const chunk = data.toString();
             stderrChunks.push(chunk);
             // Surface resource/quota failures from the backend without attempting
@@ -54,32 +175,43 @@ export async function executeCommand(command, args, onProgress, cwd) {
         });
         childProcess.on("error", (error) => {
             if (!isResolved) {
-                isResolved = true;
+                if (stopError)
+                    return;
+                settle();
                 Logger.error(`Process error:`, error);
+                Logger.commandComplete(startTime, null);
                 reject(new Error(`Failed to spawn command: ${error.message}`));
             }
         });
         childProcess.on("close", (code) => {
-            if (!isResolved) {
-                isResolved = true;
-                // Join array buffers efficiently
-                const stdout = stdoutChunks.join('');
-                const stderr = stderrChunks.join('');
-                // Treat an exit-0 run as failed only when it reported quota exhaustion
-                // AND produced no usable stdout — so a quota error with empty output is
-                // surfaced (not silently "recovered"), while a run that still returned a
-                // real answer is kept.
-                const quotaFailure = resourceExhausted && stdout.trim() === "";
-                if (code === 0 && !quotaFailure) {
-                    Logger.commandComplete(startTime, code, stdout.length);
-                    resolve(stdout.trim());
-                }
-                else {
-                    Logger.commandComplete(startTime, code);
-                    Logger.error(`Failed with exit code ${code}`);
-                    const errorMessage = stderr.trim() || (resourceExhausted ? "RESOURCE_EXHAUSTED" : "Unknown error");
-                    reject(new Error(`Command failed with exit code ${code}: ${errorMessage}`));
-                }
+            if (isResolved)
+                return;
+            if (stopError) {
+                // A parent can exit before its children. Clear any survivors from its
+                // process group before reporting that the request has stopped.
+                if (grouped && childProcess.pid !== undefined)
+                    signalProcessGroup("SIGKILL");
+                finishStopped(code);
+                return;
+            }
+            settle();
+            // Join array buffers efficiently
+            const stdout = stdoutChunks.join('');
+            const stderr = stderrChunks.join('');
+            // Treat an exit-0 run as failed only when it reported quota exhaustion
+            // AND produced no usable stdout — so a quota error with empty output is
+            // surfaced (not silently "recovered"), while a run that still returned a
+            // real answer is kept.
+            const quotaFailure = resourceExhausted && stdout.trim() === "";
+            if (code === 0 && !quotaFailure) {
+                Logger.commandComplete(startTime, code, stdout.length);
+                resolve(stdout.trim());
+            }
+            else {
+                Logger.commandComplete(startTime, code);
+                Logger.error(`Failed with exit code ${code}`);
+                const errorMessage = stderr.trim() || (resourceExhausted ? "RESOURCE_EXHAUSTED" : "Unknown error");
+                reject(new Error(`Command failed with exit code ${code}: ${errorMessage}`));
             }
         });
     });

package/dist/utils/commandExecutor.js.map

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

package/dist/utils/gitCheckout.d.ts

@@ -0,0 +1,14 @@
+export interface Checkout {
+    /** Null on a detached HEAD. */
+    branch: string | null;
+    head: string;
+}
+/** The branch and commit checked out in `directory`, or null when it is not a git checkout with a commit. */
+export declare function readCheckout(directory: string): Promise<Checkout | null>;
+/**
+ * The merge base of `ref` and HEAD in `directory`. Throws with git's own reason
+ * when the ref does not resolve; `--end-of-options` keeps a ref spelled like an
+ * option from being read as one.
+ */
+export declare function resolveMergeBase(directory: string, ref: string): Promise<string>;
+//# sourceMappingURL=gitCheckout.d.ts.map

package/dist/utils/gitCheckout.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gitCheckout.d.ts","sourceRoot":"","sources":["../../src/utils/gitCheckout.ts"],"names":[],"mappings":"AAMA,MAAM,WAAW,QAAQ;IACvB,+BAA+B;IAC/B,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,IAAI,EAAE,MAAM,CAAC;CACd;AAMD,6GAA6G;AAC7G,wBAAsB,YAAY,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,GAAG,IAAI,CAAC,CAS9E;AAED;;;;GAIG;AACH,wBAAsB,gBAAgB,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAQtF"}

package/dist/utils/gitCheckout.js

@@ -0,0 +1,36 @@
+import { execFile } from 'child_process';
+import { promisify } from 'util';
+const execFileAsync = promisify(execFile);
+const GIT_TIMEOUT_MS = 10_000;
+function git(directory, args) {
+    return execFileAsync('git', args, { cwd: directory, timeout: GIT_TIMEOUT_MS });
+}
+/** The branch and commit checked out in `directory`, or null when it is not a git checkout with a commit. */
+export async function readCheckout(directory) {
+    try {
+        const { stdout } = await git(directory, ['rev-parse', 'HEAD', '--abbrev-ref', 'HEAD']);
+        const [head, branch] = stdout.trim().split('\n');
+        if (!head || !branch)
+            return null;
+        return { head, branch: branch === 'HEAD' ? null : branch };
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * The merge base of `ref` and HEAD in `directory`. Throws with git's own reason
+ * when the ref does not resolve; `--end-of-options` keeps a ref spelled like an
+ * option from being read as one.
+ */
+export async function resolveMergeBase(directory, ref) {
+    try {
+        const { stdout } = await git(directory, ['merge-base', '--end-of-options', ref, 'HEAD']);
+        return stdout.trim();
+    }
+    catch (error) {
+        const stderr = error.stderr?.trim();
+        throw new Error(stderr || error.message);
+    }
+}
+//# sourceMappingURL=gitCheckout.js.map

package/dist/utils/gitCheckout.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"gitCheckout.js","sourceRoot":"","sources":["../../src/utils/gitCheckout.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AACzC,OAAO,EAAE,SAAS,EAAE,MAAM,MAAM,CAAC;AAEjC,MAAM,aAAa,GAAG,SAAS,CAAC,QAAQ,CAAC,CAAC;AAC1C,MAAM,cAAc,GAAG,MAAM,CAAC;AAQ9B,SAAS,GAAG,CAAC,SAAiB,EAAE,IAAc;IAC5C,OAAO,aAAa,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE,GAAG,EAAE,SAAS,EAAE,OAAO,EAAE,cAAc,EAAE,CAAC,CAAC;AACjF,CAAC;AAED,6GAA6G;AAC7G,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,SAAiB;IAClD,IAAI,CAAC;QACH,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,GAAG,CAAC,SAAS,EAAE,CAAC,WAAW,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,CAAC,CAAC,CAAC;QACvF,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,GAAG,MAAM,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QACjD,IAAI,CAAC,IAAI,IAAI,CAAC,MAAM;YAAE,OAAO,IAAI,CAAC;QAClC,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,KAAK,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;IAC7D,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAAC,SAAiB,EAAE,GAAW;IACnE,IAAI,CAAC;QACH,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,GAAG,CAAC,SAAS,EAAE,CAAC,YAAY,EAAE,kBAAkB,EAAE,GAAG,EAAE,MAAM,CAAC,CAAC,CAAC;QACzF,OAAO,MAAM,CAAC,IAAI,EAAE,CAAC;IACvB,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,MAAM,GAAI,KAA6B,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC;QAC7D,MAAM,IAAI,KAAK,CAAC,MAAM,IAAK,KAAe,CAAC,OAAO,CAAC,CAAC;IACtD,CAAC;AACH,CAAC"}

package/dist/utils/layoutCheck.d.ts

@@ -0,0 +1,58 @@
+import { z } from 'zod';
+/** `dev-overlay` marks a frame a framework dev overlay (such as Expo's error overlay) covered; its other entries are suspect. */
+export declare const LAYOUT_ENTRY_KINDS: readonly ["dev-overlay", "page-scroll-x", "text-spill", "text-clipped", "control-covered", "control-offscreen"];
+export declare const layoutReportSchema: z.ZodObject<{
+    check: z.ZodLiteral<"layout-check/1">;
+    viewport: z.ZodObject<{
+        width: z.ZodNumber;
+        height: z.ZodNumber;
+    }, z.core.$strip>;
+    found: z.ZodNumber;
+    entries: z.ZodArray<z.ZodObject<{
+        text: z.ZodString;
+        testID: z.ZodNullable<z.ZodString>;
+        rect: z.ZodObject<{
+            x: z.ZodNumber;
+            y: z.ZodNumber;
+            width: z.ZodNumber;
+            height: z.ZodNumber;
+        }, z.core.$strip>;
+        kind: z.ZodEnum<{
+            "dev-overlay": "dev-overlay";
+            "page-scroll-x": "page-scroll-x";
+            "text-spill": "text-spill";
+            "text-clipped": "text-clipped";
+            "control-covered": "control-covered";
+            "control-offscreen": "control-offscreen";
+        }>;
+    }, z.core.$strip>>;
+    clamped: z.ZodArray<z.ZodObject<{
+        text: z.ZodString;
+        testID: z.ZodNullable<z.ZodString>;
+        rect: z.ZodObject<{
+            x: z.ZodNumber;
+            y: z.ZodNumber;
+            width: z.ZodNumber;
+            height: z.ZodNumber;
+        }, z.core.$strip>;
+        kind: z.ZodLiteral<"text-clamped">;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export type LayoutReport = z.infer<typeof layoutReportSchema>;
+export type LayoutEntry = LayoutReport['entries'][number] | LayoutReport['clamped'][number];
+export type LayoutCheckStatus = 'OK' | 'MISSING' | 'STALE' | 'OUTSIDE' | 'MALFORMED' | 'MISMATCHED';
+export interface LayoutCheck {
+    file: string;
+    status: LayoutCheckStatus;
+    report?: LayoutReport;
+    problem?: string;
+}
+export declare function layoutFileName(frameFileName: string): string;
+/**
+ * Read one frame's layout file. Never throws: a file that cannot be trusted is
+ * reported with its status and treated by the report as "not run". A file
+ * measured at another width than the frame's describes a different layout.
+ */
+export declare function readLayoutCheck(file: string, artifactDir: string, runStartMs: number, expectedWidth?: number): LayoutCheck;
+export declare function formatLayoutEntry(entry: LayoutEntry): string;
+//# sourceMappingURL=layoutCheck.d.ts.map

package/dist/utils/layoutCheck.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"layoutCheck.d.ts","sourceRoot":"","sources":["../../src/utils/layoutCheck.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAmBxB,iIAAiI;AACjI,eAAO,MAAM,kBAAkB,iHAOrB,CAAC;AAEX,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAM7B,CAAC;AAEH,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAC9D,MAAM,MAAM,WAAW,GAAG,YAAY,CAAC,SAAS,CAAC,CAAC,MAAM,CAAC,GAAG,YAAY,CAAC,SAAS,CAAC,CAAC,MAAM,CAAC,CAAC;AAE5F,MAAM,MAAM,iBAAiB,GAAG,IAAI,GAAG,SAAS,GAAG,OAAO,GAAG,SAAS,GAAG,WAAW,GAAG,YAAY,CAAC;AAEpG,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,iBAAiB,CAAC;IAC1B,MAAM,CAAC,EAAE,YAAY,CAAC;IACtB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,wBAAgB,cAAc,CAAC,aAAa,EAAE,MAAM,GAAG,MAAM,CAE5D;AAQD;;;;GAIG;AACH,wBAAgB,eAAe,CAC7B,IAAI,EAAE,MAAM,EACZ,WAAW,EAAE,MAAM,EACnB,UAAU,EAAE,MAAM,EAClB,aAAa,CAAC,EAAE,MAAM,GACrB,WAAW,CA8Bb;AAED,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,WAAW,GAAG,MAAM,CAI5D"}