doc-detective 4.22.0 → 4.23.0

package/dist/common/src/types/generated/config_v3.d.ts

@@ -180,7 +180,7 @@ export interface Context {
      */
     platforms?: ("linux" | "mac" | "windows" | "android" | "ios") | ("linux" | "mac" | "windows" | "android" | "ios")[];
     /**
-     * Browsers to run tests on.
+     * Browsers to run tests on. On a mobile (`android`/`ios`) platform entry, the browser runs on the managed device: `chrome` on Android, `safari` on iOS (other combinations skip the context), and it fills in automatically when omitted. Device browsers don't take desktop display config: authored `window`/`viewport` dimensions and `headless: false` are rejected on mobile entries (the device owns its display — control it via the device descriptor's `headless`/`deviceType`); `headless: true` matches this schema's default and is ignored.
      */
     browsers?: ("chrome" | "firefox" | "safari" | "webkit") | Browser | (("chrome" | "firefox" | "safari" | "webkit") | Browser1)[];
     /**

package/dist/common/src/types/generated/context_v3.d.ts

@@ -20,7 +20,7 @@ export interface Context {
      */
     platforms?: ("linux" | "mac" | "windows" | "android" | "ios") | ("linux" | "mac" | "windows" | "android" | "ios")[];
     /**
-     * Browsers to run tests on.
+     * Browsers to run tests on. On a mobile (`android`/`ios`) platform entry, the browser runs on the managed device: `chrome` on Android, `safari` on iOS (other combinations skip the context), and it fills in automatically when omitted. Device browsers don't take desktop display config: authored `window`/`viewport` dimensions and `headless: false` are rejected on mobile entries (the device owns its display — control it via the device descriptor's `headless`/`deviceType`); `headless: true` matches this schema's default and is ignored.
      */
     browsers?: ("chrome" | "firefox" | "safari" | "webkit") | Browser | (("chrome" | "firefox" | "safari" | "webkit") | Browser1)[];
     /**

package/dist/common/src/types/generated/report_v3.d.ts

@@ -104,7 +104,7 @@ export interface Context {
      */
     platforms?: ("linux" | "mac" | "windows" | "android" | "ios") | ("linux" | "mac" | "windows" | "android" | "ios")[];
     /**
-     * Browsers to run tests on.
+     * Browsers to run tests on. On a mobile (`android`/`ios`) platform entry, the browser runs on the managed device: `chrome` on Android, `safari` on iOS (other combinations skip the context), and it fills in automatically when omitted. Device browsers don't take desktop display config: authored `window`/`viewport` dimensions and `headless: false` are rejected on mobile entries (the device owns its display — control it via the device descriptor's `headless`/`deviceType`); `headless: true` matches this schema's default and is ignored.
      */
     browsers?: ("chrome" | "firefox" | "safari" | "webkit") | Browser | (("chrome" | "firefox" | "safari" | "webkit") | Browser1)[];
     /**

package/dist/common/src/types/generated/resolvedTests_v3.d.ts

@@ -218,7 +218,7 @@ export interface Context {
      */
     platforms?: ("linux" | "mac" | "windows" | "android" | "ios") | ("linux" | "mac" | "windows" | "android" | "ios")[];
     /**
-     * Browsers to run tests on.
+     * Browsers to run tests on. On a mobile (`android`/`ios`) platform entry, the browser runs on the managed device: `chrome` on Android, `safari` on iOS (other combinations skip the context), and it fills in automatically when omitted. Device browsers don't take desktop display config: authored `window`/`viewport` dimensions and `headless: false` are rejected on mobile entries (the device owns its display — control it via the device descriptor's `headless`/`deviceType`); `headless: true` matches this schema's default and is ignored.
      */
     browsers?: ("chrome" | "firefox" | "safari" | "webkit") | Browser | (("chrome" | "firefox" | "safari" | "webkit") | Browser1)[];
     /**
@@ -657,7 +657,7 @@ export interface Context1 {
      */
     platforms?: ("linux" | "mac" | "windows" | "android" | "ios") | ("linux" | "mac" | "windows" | "android" | "ios")[];
     /**
-     * Browsers to run tests on.
+     * Browsers to run tests on. On a mobile (`android`/`ios`) platform entry, the browser runs on the managed device: `chrome` on Android, `safari` on iOS (other combinations skip the context), and it fills in automatically when omitted. Device browsers don't take desktop display config: authored `window`/`viewport` dimensions and `headless: false` are rejected on mobile entries (the device owns its display — control it via the device descriptor's `headless`/`deviceType`); `headless: true` matches this schema's default and is ignored.
      */
     browsers?: ("chrome" | "firefox" | "safari" | "webkit") | Browser2 | (("chrome" | "firefox" | "safari" | "webkit") | Browser3)[];
     /**

package/dist/common/src/types/generated/spec_v3.d.ts

@@ -81,7 +81,7 @@ export interface Context {
      */
     platforms?: ("linux" | "mac" | "windows" | "android" | "ios") | ("linux" | "mac" | "windows" | "android" | "ios")[];
     /**
-     * Browsers to run tests on.
+     * Browsers to run tests on. On a mobile (`android`/`ios`) platform entry, the browser runs on the managed device: `chrome` on Android, `safari` on iOS (other combinations skip the context), and it fills in automatically when omitted. Device browsers don't take desktop display config: authored `window`/`viewport` dimensions and `headless: false` are rejected on mobile entries (the device owns its display — control it via the device descriptor's `headless`/`deviceType`); `headless: true` matches this schema's default and is ignored.
      */
     browsers?: ("chrome" | "firefox" | "safari" | "webkit") | Browser | (("chrome" | "firefox" | "safari" | "webkit") | Browser1)[];
     /**

package/dist/common/src/types/generated/test_v3.d.ts

@@ -4022,7 +4022,7 @@ export interface Context {
      */
     platforms?: ("linux" | "mac" | "windows" | "android" | "ios") | ("linux" | "mac" | "windows" | "android" | "ios")[];
     /**
-     * Browsers to run tests on.
+     * Browsers to run tests on. On a mobile (`android`/`ios`) platform entry, the browser runs on the managed device: `chrome` on Android, `safari` on iOS (other combinations skip the context), and it fills in automatically when omitted. Device browsers don't take desktop display config: authored `window`/`viewport` dimensions and `headless: false` are rejected on mobile entries (the device owns its display — control it via the device descriptor's `headless`/`deviceType`); `headless: true` matches this schema's default and is ignored.
      */
     browsers?: ("chrome" | "firefox" | "safari" | "webkit") | Browser | (("chrome" | "firefox" | "safari" | "webkit") | Browser1)[];
     /**

package/dist/core/appium.d.ts

@@ -1,5 +1,6 @@
-export { setAppiumHome, appiumHomeForDriverPath };
+export { setAppiumHome, appiumHomeForDriverPath, runtimeHomeHasBrowserDriver };
 declare function appiumHomeForDriverPath(driverEntry: string): string | null;
+declare function runtimeHomeHasBrowserDriver(runtimeDir: string): boolean;
 declare function setAppiumHome(ctx?: {
     cacheDir?: string;
 }): void;

package/dist/core/appium.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"appium.d.ts","sourceRoot":"","sources":["../../src/core/appium.ts"],"names":[],"mappings":"AAQA,OAAO,EAAE,aAAa,EAAE,uBAAuB,EAAE,CAAC;AAOlD,iBAAS,uBAAuB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAInE;AAED,iBAAS,aAAa,CAAC,GAAG,GAAE;IAAE,QAAQ,CAAC,EAAE,MAAM,CAAA;CAAO,QA8DrD"}
+{"version":3,"file":"appium.d.ts","sourceRoot":"","sources":["../../src/core/appium.ts"],"names":[],"mappings":"AAQA,OAAO,EAAE,aAAa,EAAE,uBAAuB,EAAE,2BAA2B,EAAE,CAAC;AAO/E,iBAAS,uBAAuB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAInE;AAsBD,iBAAS,2BAA2B,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAMhE;AAED,iBAAS,aAAa,CAAC,GAAG,GAAE;IAAE,QAAQ,CAAC,EAAE,MAAM,CAAA;CAAO,QAiErD"}

package/dist/core/appium.js

@@ -4,7 +4,7 @@ import { fileURLToPath } from "node:url";
 import { getRuntimeDir } from "../runtime/cacheDir.js";
 import { resolveHeavyDepPath } from "../runtime/loader.js";
 const __dirname = path.dirname(fileURLToPath(import.meta.url));
-export { setAppiumHome, appiumHomeForDriverPath };
+export { setAppiumHome, appiumHomeForDriverPath, runtimeHomeHasBrowserDriver };
 // Given a resolved driver module path like
 // `<X>/node_modules/appium-geckodriver/build/lib/index.js`, return `<X>` — the
 // directory whose `node_modules` holds the driver. `appium driver list` looks
@@ -15,12 +15,44 @@ function appiumHomeForDriverPath(driverEntry) {
     const idx = driverEntry.lastIndexOf(marker);
     return idx === -1 ? null : driverEntry.slice(0, idx);
 }
+// The browser drivers `appium driver list` must report as `installed (npm)`
+// for Chrome/Firefox/Safari detection (getAvailableApps) to mark the browser
+// available. A home missing all of these can't drive a browser, so it must
+// not be chosen as APPIUM_HOME for the browser paths. Safari is included
+// because its availability check (config.ts) also gates on
+// `npmInstalled("appium-safari-driver")` via `appium driver list`.
+const BROWSER_DRIVER_PACKAGES = [
+    "appium-chromium-driver",
+    "appium-geckodriver",
+    "appium-safari-driver",
+];
+// True when <runtimeDir>/node_modules contains appium AND at least one browser
+// driver — i.e. the runtime cache is a COMPLETE browser home. `appium driver
+// list` scans <APPIUM_HOME>/node_modules, so a runtime that holds appium but no
+// browser driver (e.g. appium pulled in only as a peer of a lazily-installed
+// native driver like appium-xcuitest-driver) reports every browser driver
+// "not installed" and browser detection comes up empty. Requiring a browser
+// driver's presence lets setAppiumHome fall through to the shim home (which
+// carries the full driver set) in that case.
+function runtimeHomeHasBrowserDriver(runtimeDir) {
+    const nm = path.join(runtimeDir, "node_modules");
+    if (!existsSync(path.join(nm, "appium")))
+        return false;
+    return BROWSER_DRIVER_PACKAGES.some((driver) => existsSync(path.join(nm, driver)));
+}
 function setAppiumHome(ctx = {}) {
-    // 1. Prefer the lazy-installed copy in <cacheDir>/runtime/node_modules/appium.
-    // The cache install is the canonical home post-shim.
-    const runtimeAppium = path.join(getRuntimeDir({ cacheDir: ctx.cacheDir }), "node_modules", "appium");
-    if (existsSync(runtimeAppium)) {
-        process.env.APPIUM_HOME = path.join(getRuntimeDir({ cacheDir: ctx.cacheDir }));
+    // 1. Prefer the lazy-installed copy in <cacheDir>/runtime — but only when it
+    // is a COMPLETE browser home (appium + a browser driver). A runtime that has
+    // appium without any browser driver (e.g. appium arrived only as a peer of a
+    // lazily-installed native driver such as appium-xcuitest-driver) would make
+    // `appium driver list` report chromium/gecko "not installed" and browser
+    // detection come up empty — the pre-fix bug that failed the browser unit
+    // tests on Linux/macOS after `install all` seeded such a partial runtime.
+    // When the runtime is incomplete, fall through to step 2, which homes at the
+    // shim's node_modules that carries every driver.
+    const runtimeDir = getRuntimeDir({ cacheDir: ctx.cacheDir });
+    if (runtimeHomeHasBrowserDriver(runtimeDir)) {
+        process.env.APPIUM_HOME = runtimeDir;
         return;
     }
     // 2. Otherwise anchor APPIUM_HOME to the directory whose node_modules holds
@@ -34,8 +66,10 @@ function setAppiumHome(ctx = {}) {
     // detection come up empty.
     // Try each driver in turn: resolveHeavyDepPath can return a shim path with no
     // node_modules segment (appiumHomeForDriverPath then yields null), so a bad
-    // first candidate must not stop us from deriving the home from the second.
-    for (const driverName of ["appium-chromium-driver", "appium-geckodriver"]) {
+    // first candidate must not stop us from deriving the home from the next. The
+    // candidate list is BROWSER_DRIVER_PACKAGES so it stays in sync with the
+    // completeness gate above (Safari included).
+    for (const driverName of BROWSER_DRIVER_PACKAGES) {
         const driverEntry = resolveHeavyDepPath(driverName, {
             cacheDir: ctx.cacheDir,
         });
@@ -45,11 +79,11 @@ function setAppiumHome(ctx = {}) {
             return;
         }
     }
-    /* c8 ignore start - legacy fallback (step 3), reached only when NEITHER
-     * appium-chromium-driver NOR appium-geckodriver resolves via
-     * resolveHeavyDepPath in step 2 above. Both are installed dependencies of
-     * this repo that shim-resolve first on every measured CI leg -- the
-     * cross-platform coverage union shows step 2's return (lines 49-57)
+    /* c8 ignore start - legacy fallback (step 3), reached only when NONE of the
+     * BROWSER_DRIVER_PACKAGES (appium-chromium-driver first) resolves via
+     * resolveHeavyDepPath in step 2 above. chromium/gecko are installed
+     * dependencies of this repo that shim-resolve first on every measured CI leg
+     * -- the cross-platform coverage union shows step 2's return (lines 49-57)
      * covered and never reaches here -- so step 2 always returns before this
      * fallback runs. It exists for driver-less installs and can't be exercised
      * hermetically without uninstalling a real dependency the runner and the

package/dist/core/appium.js.map

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

package/dist/core/ptyProbeWorker.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=ptyProbeWorker.d.ts.map

package/dist/core/ptyProbeWorker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ptyProbeWorker.d.ts","sourceRoot":"","sources":["../../src/core/ptyProbeWorker.ts"],"names":[],"mappings":""}

package/dist/core/ptyProbeWorker.js

@@ -0,0 +1,61 @@
+// Worker-thread half of the ConPTY watchdog (issue #501, ADR 01024). Runs in
+// the SAME process as the runner (worker threads share the process's state and
+// console attachment), so a throwaway ConPTY allocation here exercises the
+// conditions the real spawn would hit — where a child process, with its own
+// fresh state, could report a false "healthy".
+//
+// Protocol: post exactly one message to the parent.
+//   { ok: true }            — a throwaway ConPTY allocated and exited: healthy.
+//   { ok: false, error }    — the backend couldn't load or the spawn threw.
+// If the allocation WEDGES (the #501 failure), `pty.spawn`/`onExit` never
+// returns and this worker posts nothing — the parent's timeout declares it
+// "wedged" and terminates the worker.
+import { parentPort, workerData } from "node:worker_threads";
+import { pathToFileURL } from "node:url";
+async function main() {
+    const { ptyModulePath } = (workerData ?? {});
+    if (!ptyModulePath) {
+        parentPort?.postMessage({ ok: false, error: "no ptyModulePath provided" });
+        return;
+    }
+    // node-pty is native/CJS; dynamic-import it by absolute path. `.spawn` may be
+    // on the namespace or under `default` depending on interop.
+    const mod = await import(pathToFileURL(ptyModulePath).href);
+    const pty = typeof mod?.spawn === "function" ? mod : mod?.default;
+    if (!pty || typeof pty.spawn !== "function") {
+        parentPort?.postMessage({
+            ok: false,
+            error: "node-pty module has no spawn()",
+        });
+        return;
+    }
+    const isWin = process.platform === "win32";
+    const shell = isWin ? process.env.ComSpec || "cmd.exe" : "/bin/sh";
+    // A command that exits immediately — we only care that the PTY allocates.
+    const args = isWin ? ["/d", "/s", "/c", "exit"] : ["-c", "exit 0"];
+    const ptyProcess = pty.spawn(shell, args, {
+        name: "xterm-color",
+        cols: 80,
+        rows: 24,
+        cwd: process.cwd(),
+        env: process.env,
+    });
+    let posted = false;
+    const post = (msg) => {
+        if (posted)
+            return;
+        posted = true;
+        try {
+            ptyProcess.kill();
+        }
+        catch {
+            // best-effort — it may already have exited
+        }
+        parentPort?.postMessage(msg);
+    };
+    ptyProcess.onExit(() => post({ ok: true }));
+}
+main().catch((error) => {
+    parentPort?.postMessage({ ok: false, error: String(error?.message ?? error) });
+});
+//# sourceMappingURL=ptyProbeWorker.js.map

package/dist/core/ptyProbeWorker.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ptyProbeWorker.js","sourceRoot":"","sources":["../../src/core/ptyProbeWorker.ts"],"names":[],"mappings":"AAAA,6EAA6E;AAC7E,+EAA+E;AAC/E,2EAA2E;AAC3E,4EAA4E;AAC5E,+CAA+C;AAC/C,EAAE;AACF,oDAAoD;AACpD,gFAAgF;AAChF,4EAA4E;AAC5E,0EAA0E;AAC1E,2EAA2E;AAC3E,sCAAsC;AAEtC,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAC7D,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAEzC,KAAK,UAAU,IAAI;IACjB,MAAM,EAAE,aAAa,EAAE,GAAG,CAAC,UAAU,IAAI,EAAE,CAA+B,CAAC;IAC3E,IAAI,CAAC,aAAa,EAAE,CAAC;QACnB,UAAU,EAAE,WAAW,CAAC,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,2BAA2B,EAAE,CAAC,CAAC;QAC3E,OAAO;IACT,CAAC;IAED,8EAA8E;IAC9E,4DAA4D;IAC5D,MAAM,GAAG,GAAQ,MAAM,MAAM,CAAC,aAAa,CAAC,aAAa,CAAC,CAAC,IAAI,CAAC,CAAC;IACjE,MAAM,GAAG,GAAQ,OAAO,GAAG,EAAE,KAAK,KAAK,UAAU,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,EAAE,OAAO,CAAC;IACvE,IAAI,CAAC,GAAG,IAAI,OAAO,GAAG,CAAC,KAAK,KAAK,UAAU,EAAE,CAAC;QAC5C,UAAU,EAAE,WAAW,CAAC;YACtB,EAAE,EAAE,KAAK;YACT,KAAK,EAAE,gCAAgC;SACxC,CAAC,CAAC;QACH,OAAO;IACT,CAAC;IAED,MAAM,KAAK,GAAG,OAAO,CAAC,QAAQ,KAAK,OAAO,CAAC;IAC3C,MAAM,KAAK,GAAG,KAAK,CAAC,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,OAAO,IAAI,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC;IACnE,0EAA0E;IAC1E,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;IAEnE,MAAM,UAAU,GAAG,GAAG,CAAC,KAAK,CAAC,KAAK,EAAE,IAAI,EAAE;QACxC,IAAI,EAAE,aAAa;QACnB,IAAI,EAAE,EAAE;QACR,IAAI,EAAE,EAAE;QACR,GAAG,EAAE,OAAO,CAAC,GAAG,EAAE;QAClB,GAAG,EAAE,OAAO,CAAC,GAAG;KACjB,CAAC,CAAC;IAEH,IAAI,MAAM,GAAG,KAAK,CAAC;IACnB,MAAM,IAAI,GAAG,CAAC,GAAQ,EAAE,EAAE;QACxB,IAAI,MAAM;YAAE,OAAO;QACnB,MAAM,GAAG,IAAI,CAAC;QACd,IAAI,CAAC;YACH,UAAU,CAAC,IAAI,EAAE,CAAC;QACpB,CAAC;QAAC,MAAM,CAAC;YACP,2CAA2C;QAC7C,CAAC;QACD,UAAU,EAAE,WAAW,CAAC,GAAG,CAAC,CAAC;IAC/B,CAAC,CAAC;IAEF,UAAU,CAAC,MAAM,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;AAC9C,CAAC;AAED,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,KAAU,EAAE,EAAE;IAC1B,UAAU,EAAE,WAAW,CAAC,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE,OAAO,IAAI,KAAK,CAAC,EAAE,CAAC,CAAC;AACjF,CAAC,CAAC,CAAC"}

package/dist/core/ptyWatchdog.d.ts

@@ -0,0 +1,77 @@
+/** Default wall-clock budget for the ConPTY probe. A healthy allocation
+ * returns in well under a second; 15s is generous headroom that still bounds
+ * the freeze. Overridable via env for tests (and as an escape hatch). */
+export declare const PTY_PROBE_TIMEOUT_MS: number;
+export type PtyProbeOutcome = "healthy" | "inconclusive" | "wedged";
+export interface PtyProbeResult {
+    outcome: PtyProbeOutcome;
+    /** Human-readable context for logs / the SKIP message. */
+    detail?: string;
+}
+/** Minimal surface of a worker the probe drives. `node:worker_threads`'s
+ * `Worker` satisfies it; tests inject a fake. */
+export interface ProbeWorkerLike {
+    on(event: "message", cb: (msg: any) => void): void;
+    on(event: "error", cb: (err: any) => void): void;
+    on(event: "exit", cb: (code: number) => void): void;
+    terminate(): Promise<number> | void;
+}
+/**
+ * Probe whether a new ConPTY can be allocated in this process without wedging.
+ * Never rejects — every failure mode maps to an outcome the caller can act on.
+ *
+ * @param opts.ptyModulePath Absolute path to the node-pty backend the worker
+ *   should load (resolved on the main thread; the worker can't run the async
+ *   heavy-dep resolver itself).
+ * @param opts.timeoutMs Budget before a non-responding probe is declared
+ *   "wedged". Defaults to {@link PTY_PROBE_TIMEOUT_MS}.
+ * @param opts.createWorker Injectable worker factory (tests).
+ */
+export declare function probePtyAllocation(opts: {
+    ptyModulePath: string;
+    timeoutMs?: number;
+    createWorker?: (data: {
+        ptyModulePath: string;
+    }) => ProbeWorkerLike;
+}): Promise<PtyProbeResult>;
+/**
+ * Verify the PTY backend is PHYSICALLY on disk before any spawn, healing a
+ * pruned install by force-reinstalling — issue #501's actual mechanism.
+ *
+ * A mid-run JIT `npm install` of another heavy dep used to prune node-pty's
+ * files from the runtime cache while the module stayed loaded (the OS-locked
+ * .node binary survives; the JS support files node-pty needs at spawn time do
+ * not). The stale resolution + ESM caches then serve the in-memory module
+ * without touching disk, and the next `pty.spawn` freezes the process inside
+ * a native wait. So "the module loaded" is NOT sufficient — the resolved path
+ * must exist on disk, and when it doesn't we reinstall (same paths → the
+ * already-loaded module's support files are back) rather than proceed onto a
+ * spawn we know can wedge. If the reinstall can't produce the files, throw
+ * the `NODE_PTY_UNAVAILABLE`-tagged error so runShell degrades to SKIPPED.
+ *
+ * All collaborators are injectable for tests; `exists` defaults to
+ * `fs.existsSync`.
+ */
+export declare function ensurePtyBackendOnDisk(opts: {
+    resolvePath: () => string | null;
+    reinstall: () => Promise<void>;
+    exists?: (p: string) => boolean;
+}): Promise<string>;
+/**
+ * Windows-only gate for the `tty` spawn path. Probes ConPTY allocation and, if
+ * it is wedged (the #501 freeze signature), throws a `NODE_PTY_UNAVAILABLE`-
+ * tagged error so the caller (runShell) degrades the step to SKIPPED instead of
+ * hanging. Returns (no-op) on non-Windows, when no backend path resolved, or
+ * when the probe is healthy/inconclusive — the caller then proceeds to the
+ * direct spawn.
+ *
+ * `platform` and `probe` are injectable so the gate is unit-testable on any host.
+ */
+export declare function assertConptyAllocatable(opts: {
+    ptyModulePath: string | null | undefined;
+    platform?: string;
+    probe?: (o: {
+        ptyModulePath: string;
+    }) => Promise<PtyProbeResult>;
+}): Promise<void>;
+//# sourceMappingURL=ptyWatchdog.d.ts.map

package/dist/core/ptyWatchdog.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ptyWatchdog.d.ts","sourceRoot":"","sources":["../../src/core/ptyWatchdog.ts"],"names":[],"mappings":"AAqCA;;yEAEyE;AACzE,eAAO,MAAM,oBAAoB,QACgC,CAAC;AAElE,MAAM,MAAM,eAAe,GAAG,SAAS,GAAG,cAAc,GAAG,QAAQ,CAAC;AAEpE,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,eAAe,CAAC;IACzB,0DAA0D;IAC1D,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;iDACiD;AACjD,MAAM,WAAW,eAAe;IAC9B,EAAE,CAAC,KAAK,EAAE,SAAS,EAAE,EAAE,EAAE,CAAC,GAAG,EAAE,GAAG,KAAK,IAAI,GAAG,IAAI,CAAC;IACnD,EAAE,CAAC,KAAK,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC,GAAG,EAAE,GAAG,KAAK,IAAI,GAAG,IAAI,CAAC;IACjD,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,GAAG,IAAI,CAAC;IACpD,SAAS,IAAI,OAAO,CAAC,MAAM,CAAC,GAAG,IAAI,CAAC;CACrC;AAQD;;;;;;;;;;GAUG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE;IACvC,aAAa,EAAE,MAAM,CAAC;IACtB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,YAAY,CAAC,EAAE,CAAC,IAAI,EAAE;QAAE,aAAa,EAAE,MAAM,CAAA;KAAE,KAAK,eAAe,CAAC;CACrE,GAAG,OAAO,CAAC,cAAc,CAAC,CAgE1B;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAsB,sBAAsB,CAAC,IAAI,EAAE;IACjD,WAAW,EAAE,MAAM,MAAM,GAAG,IAAI,CAAC;IACjC,SAAS,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAC/B,MAAM,CAAC,EAAE,CAAC,CAAC,EAAE,MAAM,KAAK,OAAO,CAAC;CACjC,GAAG,OAAO,CAAC,MAAM,CAAC,CAoBlB;AAED;;;;;;;;;GASG;AACH,wBAAsB,uBAAuB,CAAC,IAAI,EAAE;IAClD,aAAa,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC;IACzC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,CAAC,CAAC,EAAE;QAAE,aAAa,EAAE,MAAM,CAAA;KAAE,KAAK,OAAO,CAAC,cAAc,CAAC,CAAC;CACnE,GAAG,OAAO,CAAC,IAAI,CAAC,CAYhB"}

package/dist/core/ptyWatchdog.js

@@ -0,0 +1,179 @@
+// Guards for the `tty` spawn path (issue #501, ADR 01024).
+//
+// On Windows, `pty.spawn` can block the libuv event loop FOREVER inside a
+// synchronous native call — no timer, log line, or step result ever fires
+// again, and the run dies at an external timeout. The proven #501 mechanism
+// was a mid-run JIT install pruning node-pty's files from the runtime cache
+// while the module stayed loaded (see `ensurePtyBackendOnDisk`, the targeted
+// fix, and ADR 01025 for the root fix); the same wedged-spawn symptom also
+// exists upstream for other reasons (microsoft/node-pty #640/#532 — the
+// native connect runs inline on the calling thread with no timeout).
+//
+// Two layers, ordered:
+//
+// 1. `ensurePtyBackendOnDisk` — the backend's files must physically exist
+//    before any spawn; heals a pruned cache by force-reinstalling.
+// 2. `probePtyAllocation` / `assertConptyAllocatable` — defense-in-depth for
+//    wedges the disk check can't see. Because a wedged spawn blocks the event
+//    loop, a same-thread `Promise.race([spawn, setTimeout])` can never fire;
+//    the probe must run OFF the main thread, in a WORKER THREAD. A worker
+//    shares this process's state (module tree, console attachment) where a
+//    child process would not — a fresh process could report a false
+//    "healthy". The probe spawns a throwaway ConPTY that exits immediately:
+//
+//      - it exits fast              → allocation works    → "healthy"
+//      - the worker errors / can't
+//        host the native addon      → probe inconclusive  → "inconclusive"
+//      - no response within budget  → a wedged allocation → "wedged"
+//
+//    Only "wedged" (a genuine timeout) is treated as a reason to SKIP the
+//    step. "inconclusive" falls through to the direct spawn, so a platform
+//    where workers can't host node-pty behaves exactly as before — the happy
+//    path can never regress; the watchdog only ever converts an
+//    otherwise-infinite freeze into a bounded, observable outcome.
+import fs from "node:fs";
+import { Worker } from "node:worker_threads";
+/** Default wall-clock budget for the ConPTY probe. A healthy allocation
+ * returns in well under a second; 15s is generous headroom that still bounds
+ * the freeze. Overridable via env for tests (and as an escape hatch). */
+export const PTY_PROBE_TIMEOUT_MS = Number(process.env.DOC_DETECTIVE_PTY_PROBE_TIMEOUT_MS) || 15000;
+function defaultCreateWorker(data) {
+    // ptyProbeWorker.js sits next to this module in dist/core/.
+    const url = new URL("./ptyProbeWorker.js", import.meta.url);
+    return new Worker(url, { workerData: data });
+}
+/**
+ * Probe whether a new ConPTY can be allocated in this process without wedging.
+ * Never rejects — every failure mode maps to an outcome the caller can act on.
+ *
+ * @param opts.ptyModulePath Absolute path to the node-pty backend the worker
+ *   should load (resolved on the main thread; the worker can't run the async
+ *   heavy-dep resolver itself).
+ * @param opts.timeoutMs Budget before a non-responding probe is declared
+ *   "wedged". Defaults to {@link PTY_PROBE_TIMEOUT_MS}.
+ * @param opts.createWorker Injectable worker factory (tests).
+ */
+export function probePtyAllocation(opts) {
+    const timeoutMs = opts.timeoutMs ?? PTY_PROBE_TIMEOUT_MS;
+    const createWorker = opts.createWorker ?? defaultCreateWorker;
+    let worker;
+    try {
+        worker = createWorker({ ptyModulePath: opts.ptyModulePath });
+    }
+    catch (error) {
+        // Couldn't even start a worker (workers disabled, out of threads). That's
+        // not the freeze — never report "wedged" here; fall through to the direct
+        // spawn.
+        return Promise.resolve({
+            outcome: "inconclusive",
+            detail: `worker-unavailable: ${error?.message ?? error}`,
+        });
+    }
+    return new Promise((resolve) => {
+        let settled = false;
+        const terminate = () => {
+            // Fire-and-forget: a worker wedged in a synchronous native call may not
+            // stop promptly, and the main thread must never block on it. A leaked
+            // worker thread is reaped at process exit — strictly better than a frozen
+            // run.
+            try {
+                Promise.resolve(worker.terminate()).catch(() => { });
+            }
+            catch {
+                // terminate() may throw if the worker is already gone — ignore.
+            }
+        };
+        const finish = (outcome, detail) => {
+            if (settled)
+                return;
+            settled = true;
+            clearTimeout(timer);
+            resolve({ outcome, detail });
+        };
+        const timer = setTimeout(() => {
+            // No verdict within budget == the #501 freeze signature.
+            terminate();
+            finish("wedged", `no response in ${timeoutMs}ms`);
+        }, timeoutMs);
+        // Don't let the watchdog timer itself keep the process alive.
+        if (typeof timer.unref === "function")
+            timer.unref();
+        worker.on("message", (msg) => {
+            terminate();
+            if (msg && msg.ok === true)
+                finish("healthy");
+            else
+                finish("inconclusive", msg?.error ? String(msg.error) : "probe reported not-ok");
+        });
+        worker.on("error", (err) => {
+            // The worker threw (e.g. the native addon can't load in a worker). Not a
+            // freeze — inconclusive, so the caller falls through to the direct spawn.
+            finish("inconclusive", `worker-error: ${err?.message ?? err}`);
+        });
+        worker.on("exit", () => {
+            // Exited without ever posting a verdict (load/spawn error path).
+            finish("inconclusive", "worker exited without a result");
+        });
+    });
+}
+/**
+ * Verify the PTY backend is PHYSICALLY on disk before any spawn, healing a
+ * pruned install by force-reinstalling — issue #501's actual mechanism.
+ *
+ * A mid-run JIT `npm install` of another heavy dep used to prune node-pty's
+ * files from the runtime cache while the module stayed loaded (the OS-locked
+ * .node binary survives; the JS support files node-pty needs at spawn time do
+ * not). The stale resolution + ESM caches then serve the in-memory module
+ * without touching disk, and the next `pty.spawn` freezes the process inside
+ * a native wait. So "the module loaded" is NOT sufficient — the resolved path
+ * must exist on disk, and when it doesn't we reinstall (same paths → the
+ * already-loaded module's support files are back) rather than proceed onto a
+ * spawn we know can wedge. If the reinstall can't produce the files, throw
+ * the `NODE_PTY_UNAVAILABLE`-tagged error so runShell degrades to SKIPPED.
+ *
+ * All collaborators are injectable for tests; `exists` defaults to
+ * `fs.existsSync`.
+ */
+export async function ensurePtyBackendOnDisk(opts) {
+    const exists = opts.exists ?? fs.existsSync;
+    const first = opts.resolvePath();
+    if (first && exists(first))
+        return first;
+    try {
+        await opts.reinstall();
+    }
+    catch (error) {
+        const err = new Error(`The PTY backend's files are missing from the runtime cache (a JIT install of another dependency previously pruned them — doc-detective issue #501) and reinstalling failed: ${error?.message ?? error}. Skipping this \`tty\` background process.`);
+        err.code = "NODE_PTY_UNAVAILABLE";
+        throw err;
+    }
+    const healed = opts.resolvePath();
+    if (healed && exists(healed))
+        return healed;
+    const err = new Error(`The PTY backend's files are missing from the runtime cache (doc-detective issue #501) and did not materialize after a reinstall. Skipping this \`tty\` background process.`);
+    err.code = "NODE_PTY_UNAVAILABLE";
+    throw err;
+}
+/**
+ * Windows-only gate for the `tty` spawn path. Probes ConPTY allocation and, if
+ * it is wedged (the #501 freeze signature), throws a `NODE_PTY_UNAVAILABLE`-
+ * tagged error so the caller (runShell) degrades the step to SKIPPED instead of
+ * hanging. Returns (no-op) on non-Windows, when no backend path resolved, or
+ * when the probe is healthy/inconclusive — the caller then proceeds to the
+ * direct spawn.
+ *
+ * `platform` and `probe` are injectable so the gate is unit-testable on any host.
+ */
+export async function assertConptyAllocatable(opts) {
+    const platform = opts.platform ?? process.platform;
+    if (platform !== "win32" || !opts.ptyModulePath)
+        return;
+    const probe = opts.probe ?? probePtyAllocation;
+    const result = await probe({ ptyModulePath: opts.ptyModulePath });
+    if (result.outcome === "wedged") {
+        const err = new Error(`ConPTY allocation is wedged on this Windows environment (${result.detail}). This matches doc-detective issue #501: a native app-surface (NovaWindows) context in the same run can leave the console subsystem unable to allocate a new pseudo-terminal, which otherwise freezes the whole process. Skipping this \`tty\` background process instead of hanging the run.`);
+        err.code = "NODE_PTY_UNAVAILABLE";
+        throw err;
+    }
+}
+//# sourceMappingURL=ptyWatchdog.js.map

package/dist/core/ptyWatchdog.js.map

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

package/dist/core/resolveTests.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"resolveTests.d.ts","sourceRoot":"","sources":["../../src/core/resolveTests.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAUH,iBAAS,gBAAgB,CAAC,EAAE,IAAI,EAAE,EAAE;IAAE,IAAI,EAAE,GAAG,CAAA;CAAE,WAShD;AAED,iBAAS,eAAe,CAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE;IAAE,QAAQ,EAAE,GAAG,EAAE,CAAC;IAAC,IAAI,EAAE,GAAG,CAAC;IAAC,MAAM,EAAE,GAAG,CAAA;CAAE,SAsG/F;AAsJD;;;;;;;GAOG;AACH,iBAAe,YAAY,CAAC,EAAE,MAAM,EAAE,aAAa,EAAE,EAAE;IAAE,MAAM,EAAE,GAAG,CAAC;IAAC,aAAa,EAAE,GAAG,EAAE,CAAA;CAAE;;;WAM3E,GAAG,EAAE;GAWrB;AAED,OAAO,EACL,YAAY,EACZ,eAAe,EACf,gBAAgB,GACjB,CAAC"}
+{"version":3,"file":"resolveTests.d.ts","sourceRoot":"","sources":["../../src/core/resolveTests.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAWH,iBAAS,gBAAgB,CAAC,EAAE,IAAI,EAAE,EAAE;IAAE,IAAI,EAAE,GAAG,CAAA;CAAE,WAShD;AAED,iBAAS,eAAe,CAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE;IAAE,QAAQ,EAAE,GAAG,EAAE,CAAC;IAAC,IAAI,EAAE,GAAG,CAAC;IAAC,MAAM,EAAE,GAAG,CAAA;CAAE,SAmH/F;AAsJD;;;;;;;GAOG;AACH,iBAAe,YAAY,CAAC,EAAE,MAAM,EAAE,aAAa,EAAE,EAAE;IAAE,MAAM,EAAE,GAAG,CAAC;IAAC,aAAa,EAAE,GAAG,EAAE,CAAA;CAAE;;;WAM3E,GAAG,EAAE;GAWrB;AAED,OAAO,EACL,YAAY,EACZ,eAAe,EACf,gBAAgB,GACjB,CAAC"}

package/dist/core/resolveTests.js

@@ -10,6 +10,7 @@ import { contentHash } from "../common/src/detectTests.js";
 import { loadDescription } from "./openapi.js";
 // Single source of truth for browser/driver-requiring step keys.
 import { BROWSER_STEP_KEYS as driverActions } from "../runtime/browserStepKeys.js";
+import { isMobileTargetPlatform } from "./tests/mobilePlatform.js";
 function isDriverRequired({ test }) {
     let driverRequired = false;
     test.steps.forEach((step) => {
@@ -46,8 +47,6 @@ function resolveContexts({ contexts, test, config }) {
                 if (typeof browser === "string") {
                     browser = { name: browser };
                 }
-                if (browser.name === "safari")
-                    browser.name = "webkit";
                 // Mark the engine as explicitly requested by the author. The runner's
                 // cross-engine fallback uses this to decide PASS vs WARNING when it has
                 // to substitute another browser: an auto-selected default falls back
@@ -91,8 +90,21 @@ function resolveContexts({ contexts, test, config }) {
                     const staticContext = { ...carry };
                     if (platform !== undefined)
                         staticContext.platform = platform;
-                    if (browser !== undefined)
-                        staticContext.browser = browser;
+                    if (browser !== undefined) {
+                        // Desktop `safari` is an alias for the `webkit` engine, so the
+                        // rewrite happens per platform pair (not during normalization):
+                        // on a mobile target platform (android/ios) the authored name is
+                        // preserved — `safari` on ios is the real device browser (phase
+                        // A5), and the mobile support matrix, not engine aliasing,
+                        // decides unsupported combinations. Every pair gets its own
+                        // clone so contexts sharing one authored browser object can't
+                        // leak a rewrite (or any later per-context mutation) across
+                        // platforms.
+                        staticContext.browser =
+                            browser.name === "safari" && !isMobileTargetPlatform(platform)
+                                ? { ...browser, name: "webkit" }
+                                : { ...browser };
+                    }
                     staticContexts.push(staticContext);
                 });
             }