@validate.qa/runner 1.0.2 → 1.0.3

package/dist/cli.mjs

@@ -1410,7 +1410,7 @@ function selectorForValue(value) {
   if (value.startsWith("~") || value.startsWith("id="))
     return value;
   if (value.includes(":id/"))
-    return `id=${value.split(":id/")[1]}`;
+    return `id=${value}`;
   return `~${value}`;
 }
 function selectorCandidatesForStep(step) {
@@ -21743,7 +21743,7 @@ var require_util = __commonJS({
       return path;
     }
     exports.normalize = normalize;
-    function join4(aRoot, aPath) {
+    function join5(aRoot, aPath) {
       if (aRoot === "") {
         aRoot = ".";
       }
@@ -21775,7 +21775,7 @@ var require_util = __commonJS({
       }
       return joined;
     }
-    exports.join = join4;
+    exports.join = join5;
     exports.isAbsolute = function(aPath) {
       return aPath.charAt(0) === "/" || urlRegexp.test(aPath);
     };
@@ -21948,7 +21948,7 @@ var require_util = __commonJS({
             parsed.path = parsed.path.substring(0, index + 1);
           }
         }
-        sourceURL = join4(urlGenerate(parsed), sourceURL);
+        sourceURL = join5(urlGenerate(parsed), sourceURL);
       }
       return normalize(sourceURL);
     }
@@ -243103,7 +243103,7 @@ var require_thread_stream = __commonJS({
     var { version } = require_package();
     var { EventEmitter: EventEmitter2 } = __require("events");
     var { Worker } = __require("worker_threads");
-    var { join: join4 } = __require("path");
+    var { join: join5 } = __require("path");
     var { pathToFileURL } = __require("url");
     var { wait } = require_wait();
     var {
@@ -243154,7 +243154,7 @@ var require_thread_stream = __commonJS({
     function createWorker(stream, opts) {
       const { filename, workerData } = opts;
       const bundlerOverrides = "__bundlerPathsOverrides" in globalThis ? globalThis.__bundlerPathsOverrides : {};
-      const toExecute = bundlerOverrides["thread-stream-worker"] || join4(__dirname, "lib", "worker.js");
+      const toExecute = bundlerOverrides["thread-stream-worker"] || join5(__dirname, "lib", "worker.js");
       const worker = new Worker(toExecute, {
         ...opts.workerOpts,
         name: opts.workerOpts?.name || "thread-stream",
@@ -243622,7 +243622,7 @@ var require_transport = __commonJS({
     var { createRequire } = __require("module");
     var { existsSync: existsSync4 } = __require("fs");
     var getCallers = require_caller();
-    var { join: join4, isAbsolute, sep } = __require("path");
+    var { join: join5, isAbsolute, sep } = __require("path");
     var { fileURLToPath } = __require("url");
     var sleep = require_atomic_sleep();
     var onExit = require_on_exit_leak_free();
@@ -243775,7 +243775,7 @@ var require_transport = __commonJS({
         throw new Error("only one of target or targets can be specified");
       }
       if (targets) {
-        target = bundlerOverrides["pino-worker"] || join4(__dirname, "worker.js");
+        target = bundlerOverrides["pino-worker"] || join5(__dirname, "worker.js");
         options.targets = targets.filter((dest) => dest.target).map((dest) => {
           return {
             ...dest,
@@ -243793,7 +243793,7 @@ var require_transport = __commonJS({
           });
         });
       } else if (pipeline) {
-        target = bundlerOverrides["pino-worker"] || join4(__dirname, "worker.js");
+        target = bundlerOverrides["pino-worker"] || join5(__dirname, "worker.js");
         options.pipelines = [pipeline.map((dest) => {
           return {
             ...dest,
@@ -243816,7 +243816,7 @@ var require_transport = __commonJS({
           return origin;
         }
         if (origin === "pino/file") {
-          return join4(__dirname, "..", "file.js");
+          return join5(__dirname, "..", "file.js");
         }
         let fixTarget2;
         for (const filePath of callers) {
@@ -244797,7 +244797,7 @@ var require_safe_stable_stringify = __commonJS({
               return circularValue;
             }
             let res = "";
-            let join4 = ",";
+            let join5 = ",";
             const originalIndentation = indentation;
             if (Array.isArray(value)) {
               if (value.length === 0) {
@@ -244811,7 +244811,7 @@ var require_safe_stable_stringify = __commonJS({
                 indentation += spacer;
                 res += `
 ${indentation}`;
-                join4 = `,
+                join5 = `,
 ${indentation}`;
               }
               const maximumValuesToStringify = Math.min(value.length, maximumBreadth);
@@ -244819,13 +244819,13 @@ ${indentation}`;
               for (; i < maximumValuesToStringify - 1; i++) {
                 const tmp2 = stringifyFnReplacer(String(i), value, stack, replacer, spacer, indentation);
                 res += tmp2 !== void 0 ? tmp2 : "null";
-                res += join4;
+                res += join5;
               }
               const tmp = stringifyFnReplacer(String(i), value, stack, replacer, spacer, indentation);
               res += tmp !== void 0 ? tmp : "null";
               if (value.length - 1 > maximumBreadth) {
                 const removedKeys = value.length - maximumBreadth - 1;
-                res += `${join4}"... ${getItemCount(removedKeys)} not stringified"`;
+                res += `${join5}"... ${getItemCount(removedKeys)} not stringified"`;
               }
               if (spacer !== "") {
                 res += `
@@ -244846,7 +244846,7 @@ ${originalIndentation}`;
             let separator = "";
             if (spacer !== "") {
               indentation += spacer;
-              join4 = `,
+              join5 = `,
 ${indentation}`;
               whitespace = " ";
             }
@@ -244860,13 +244860,13 @@ ${indentation}`;
               const tmp = stringifyFnReplacer(key2, value, stack, replacer, spacer, indentation);
               if (tmp !== void 0) {
                 res += `${separator}${strEscape(key2)}:${whitespace}${tmp}`;
-                separator = join4;
+                separator = join5;
               }
             }
             if (keyLength > maximumBreadth) {
               const removedKeys = keyLength - maximumBreadth;
               res += `${separator}"...":${whitespace}"${getItemCount(removedKeys)} not stringified"`;
-              separator = join4;
+              separator = join5;
             }
             if (spacer !== "" && separator.length > 1) {
               res = `
@@ -244907,7 +244907,7 @@ ${originalIndentation}`;
             }
             const originalIndentation = indentation;
             let res = "";
-            let join4 = ",";
+            let join5 = ",";
             if (Array.isArray(value)) {
               if (value.length === 0) {
                 return "[]";
@@ -244920,7 +244920,7 @@ ${originalIndentation}`;
                 indentation += spacer;
                 res += `
 ${indentation}`;
-                join4 = `,
+                join5 = `,
 ${indentation}`;
               }
               const maximumValuesToStringify = Math.min(value.length, maximumBreadth);
@@ -244928,13 +244928,13 @@ ${indentation}`;
               for (; i < maximumValuesToStringify - 1; i++) {
                 const tmp2 = stringifyArrayReplacer(String(i), value[i], stack, replacer, spacer, indentation);
                 res += tmp2 !== void 0 ? tmp2 : "null";
-                res += join4;
+                res += join5;
               }
               const tmp = stringifyArrayReplacer(String(i), value[i], stack, replacer, spacer, indentation);
               res += tmp !== void 0 ? tmp : "null";
               if (value.length - 1 > maximumBreadth) {
                 const removedKeys = value.length - maximumBreadth - 1;
-                res += `${join4}"... ${getItemCount(removedKeys)} not stringified"`;
+                res += `${join5}"... ${getItemCount(removedKeys)} not stringified"`;
               }
               if (spacer !== "") {
                 res += `
@@ -244947,7 +244947,7 @@ ${originalIndentation}`;
             let whitespace = "";
             if (spacer !== "") {
               indentation += spacer;
-              join4 = `,
+              join5 = `,
 ${indentation}`;
               whitespace = " ";
             }
@@ -244956,7 +244956,7 @@ ${indentation}`;
               const tmp = stringifyArrayReplacer(key2, value[key2], stack, replacer, spacer, indentation);
               if (tmp !== void 0) {
                 res += `${separator}${strEscape(key2)}:${whitespace}${tmp}`;
-                separator = join4;
+                separator = join5;
               }
             }
             if (spacer !== "" && separator.length > 1) {
@@ -245014,20 +245014,20 @@ ${originalIndentation}`;
               indentation += spacer;
               let res2 = `
 ${indentation}`;
-              const join5 = `,
+              const join6 = `,
 ${indentation}`;
               const maximumValuesToStringify = Math.min(value.length, maximumBreadth);
               let i = 0;
               for (; i < maximumValuesToStringify - 1; i++) {
                 const tmp2 = stringifyIndent(String(i), value[i], stack, spacer, indentation);
                 res2 += tmp2 !== void 0 ? tmp2 : "null";
-                res2 += join5;
+                res2 += join6;
               }
               const tmp = stringifyIndent(String(i), value[i], stack, spacer, indentation);
               res2 += tmp !== void 0 ? tmp : "null";
               if (value.length - 1 > maximumBreadth) {
                 const removedKeys = value.length - maximumBreadth - 1;
-                res2 += `${join5}"... ${getItemCount(removedKeys)} not stringified"`;
+                res2 += `${join6}"... ${getItemCount(removedKeys)} not stringified"`;
               }
               res2 += `
 ${originalIndentation}`;
@@ -245043,16 +245043,16 @@ ${originalIndentation}`;
               return '"[Object]"';
             }
             indentation += spacer;
-            const join4 = `,
+            const join5 = `,
 ${indentation}`;
             let res = "";
             let separator = "";
             let maximumPropertiesToStringify = Math.min(keyLength, maximumBreadth);
             if (isTypedArrayWithEntries(value)) {
-              res += stringifyTypedArray(value, join4, maximumBreadth);
+              res += stringifyTypedArray(value, join5, maximumBreadth);
               keys = keys.slice(value.length);
               maximumPropertiesToStringify -= value.length;
-              separator = join4;
+              separator = join5;
             }
             if (deterministic) {
               keys = sort(keys, comparator);
@@ -245063,13 +245063,13 @@ ${indentation}`;
               const tmp = stringifyIndent(key2, value[key2], stack, spacer, indentation);
               if (tmp !== void 0) {
                 res += `${separator}${strEscape(key2)}: ${tmp}`;
-                separator = join4;
+                separator = join5;
               }
             }
             if (keyLength > maximumBreadth) {
               const removedKeys = keyLength - maximumBreadth;
               res += `${separator}"...": "${getItemCount(removedKeys)} not stringified"`;
-              separator = join4;
+              separator = join5;
             }
             if (separator !== "") {
               res = `
@@ -285426,11 +285426,11 @@ var require_core = __commonJS({
     function mapOuter(r, f) {
       return r.matched ? f(r) : r;
     }
-    function ab(pa, pb, join4) {
-      return (data, i) => mapOuter(pa(data, i), (ma) => mapInner(pb(data, ma.position), (vb, j) => join4(ma.value, vb, data, i, j)));
+    function ab(pa, pb, join5) {
+      return (data, i) => mapOuter(pa(data, i), (ma) => mapInner(pb(data, ma.position), (vb, j) => join5(ma.value, vb, data, i, j)));
     }
-    function abc(pa, pb, pc, join4) {
-      return (data, i) => mapOuter(pa(data, i), (ma) => mapOuter(pb(data, ma.position), (mb) => mapInner(pc(data, mb.position), (vc, j) => join4(ma.value, mb.value, vc, data, i, j))));
+    function abc(pa, pb, pc, join5) {
+      return (data, i) => mapOuter(pa(data, i), (ma) => mapOuter(pb(data, ma.position), (mb) => mapInner(pc(data, mb.position), (vc, j) => join5(ma.value, mb.value, vc, data, i, j))));
     }
     function action(f) {
       return (data, i) => {
@@ -312624,7 +312624,7 @@ var require_utils2 = __commonJS({
     module.exports = Utils;
     Utils.prototype.makeDir = function(folder) {
       const self = this;
-      function mkdirSync3(fpath) {
+      function mkdirSync4(fpath) {
         let resolvedPath = fpath.split(self.sep)[0];
         fpath.split(self.sep).forEach(function(name) {
           if (!name || name.substr(-1, 1) === ":") return;
@@ -312642,7 +312642,7 @@ var require_utils2 = __commonJS({
           if (stat && stat.isFile()) throw Errors.FILE_IN_THE_WAY(`"${resolvedPath}"`);
         });
       }
-      mkdirSync3(folder);
+      mkdirSync4(folder);
     };
     Utils.prototype.writeFileTo = function(path, content, overwrite, attr) {
       const self = this;
@@ -314261,8 +314261,8 @@ var require_adm_zip = __commonJS({
         return null;
       }
       function fixPath(zipPath) {
-        const { join: join4, normalize, sep } = pth.posix;
-        return join4(pth.isAbsolute(zipPath) ? "/" : ".", normalize(sep + zipPath.split("\\").join(sep) + sep));
+        const { join: join5, normalize, sep } = pth.posix;
+        return join5(pth.isAbsolute(zipPath) ? "/" : ".", normalize(sep + zipPath.split("\\").join(sep) + sep));
       }
       function filenameFilter(filterfn) {
         if (filterfn instanceof RegExp) {
@@ -319675,14 +319675,14 @@ var require_path_arg = __commonJS({
 var require_find_made = __commonJS({
   "../../node_modules/tar/node_modules/mkdirp/lib/find-made.js"(exports, module) {
     "use strict";
-    var { dirname } = __require("path");
+    var { dirname: dirname2 } = __require("path");
     var findMade = (opts, parent, path = void 0) => {
       if (path === parent)
         return Promise.resolve();
       return opts.statAsync(parent).then(
         (st) => st.isDirectory() ? path : void 0,
         // will fail later
-        (er) => er.code === "ENOENT" ? findMade(opts, dirname(parent), parent) : void 0
+        (er) => er.code === "ENOENT" ? findMade(opts, dirname2(parent), parent) : void 0
       );
     };
     var findMadeSync = (opts, parent, path = void 0) => {
@@ -319691,7 +319691,7 @@ var require_find_made = __commonJS({
       try {
         return opts.statSync(parent).isDirectory() ? path : void 0;
       } catch (er) {
-        return er.code === "ENOENT" ? findMadeSync(opts, dirname(parent), parent) : void 0;
+        return er.code === "ENOENT" ? findMadeSync(opts, dirname2(parent), parent) : void 0;
       }
     };
     module.exports = { findMade, findMadeSync };
@@ -319702,10 +319702,10 @@ var require_find_made = __commonJS({
 var require_mkdirp_manual = __commonJS({
   "../../node_modules/tar/node_modules/mkdirp/lib/mkdirp-manual.js"(exports, module) {
     "use strict";
-    var { dirname } = __require("path");
+    var { dirname: dirname2 } = __require("path");
     var mkdirpManual = (path, opts, made) => {
       opts.recursive = false;
-      const parent = dirname(path);
+      const parent = dirname2(path);
       if (parent === path) {
         return opts.mkdirAsync(path, opts).catch((er) => {
           if (er.code !== "EISDIR")
@@ -319728,7 +319728,7 @@ var require_mkdirp_manual = __commonJS({
       });
     };
     var mkdirpManualSync = (path, opts, made) => {
-      const parent = dirname(path);
+      const parent = dirname2(path);
       opts.recursive = false;
       if (parent === path) {
         try {
@@ -319764,12 +319764,12 @@ var require_mkdirp_manual = __commonJS({
 var require_mkdirp_native = __commonJS({
   "../../node_modules/tar/node_modules/mkdirp/lib/mkdirp-native.js"(exports, module) {
     "use strict";
-    var { dirname } = __require("path");
+    var { dirname: dirname2 } = __require("path");
     var { findMade, findMadeSync } = require_find_made();
     var { mkdirpManual, mkdirpManualSync } = require_mkdirp_manual();
     var mkdirpNative = (path, opts) => {
       opts.recursive = true;
-      const parent = dirname(path);
+      const parent = dirname2(path);
       if (parent === path)
         return opts.mkdirAsync(path, opts);
       return findMade(opts, path).then((made) => opts.mkdirAsync(path, opts).then(() => made).catch((er) => {
@@ -319781,7 +319781,7 @@ var require_mkdirp_native = __commonJS({
     };
     var mkdirpNativeSync = (path, opts) => {
       opts.recursive = true;
-      const parent = dirname(path);
+      const parent = dirname2(path);
       if (parent === path)
         return opts.mkdirSync(path, opts);
       const made = findMadeSync(opts, path);
@@ -320186,7 +320186,7 @@ var require_path_reservations = __commonJS({
     var assert = __require("assert");
     var normalize = require_normalize_unicode();
     var stripSlashes = require_strip_trailing_slashes();
-    var { join: join4 } = __require("path");
+    var { join: join5 } = __require("path");
     var platform3 = process.env.TESTING_TAR_FAKE_PLATFORM || process.platform;
     var isWindows = platform3 === "win32";
     module.exports = () => {
@@ -320195,7 +320195,7 @@ var require_path_reservations = __commonJS({
       const getDirs = (path) => {
         const dirs = path.split("/").slice(0, -1).reduce((set, path2) => {
           if (set.length) {
-            path2 = join4(set[set.length - 1], path2);
+            path2 = join5(set[set.length - 1], path2);
           }
           set.push(path2 || "/");
           return set;
@@ -320263,7 +320263,7 @@ var require_path_reservations = __commonJS({
       };
       const reserve = (paths, fn) => {
         paths = isWindows ? ["win32 parallelization disabled"] : paths.map((p) => {
-          return stripSlashes(join4(normalize(p))).toLowerCase();
+          return stripSlashes(join5(normalize(p))).toLowerCase();
         });
         const dirs = new Set(
           paths.map((path) => getDirs(path)).reduce((a, b) => a.concat(b))
@@ -324801,7 +324801,7 @@ var require_package4 = __commonJS({
   "package.json"(exports, module) {
     module.exports = {
       name: "@validate.qa/runner",
-      version: "1.0.2",
+      version: "1.0.3",
       description: "validate local test runner - execute Playwright tests on your machine, connected to validate.qa cloud.",
       bin: {
         "validate-runner": "dist/cli.js"
@@ -324809,7 +324809,7 @@ var require_package4 = __commonJS({
       scripts: {
         build: "tsup",
         dev: "tsx src/cli.ts",
-        "test:mobile": "node --import tsx --test src/services/mobile/mobile-network-capture.smoke.test.ts",
+        "test:mobile": "node --import tsx --test src/runner.mobile-ai-env.test.ts src/services/mobile/mobile-network-capture.smoke.test.ts",
         prepublishOnly: "npm run build"
       },
       files: [
@@ -324887,9 +324887,9 @@ function getConfigDir() {
 }
 
 // src/runner.ts
-import { existsSync as existsSync2, statSync, mkdirSync as mkdirSync2 } from "fs";
-import { join as join3 } from "path";
-import { homedir as homedir2 } from "os";
+import { existsSync as existsSync3, statSync, mkdirSync as mkdirSync3 } from "fs";
+import { join as join4 } from "path";
+import { homedir as homedir3 } from "os";
 import { createHash } from "crypto";
 
 // src/services/playwright-native.ts
@@ -325302,11 +325302,12 @@ function discoverRealIOSDevices() {
       for (const [index, node] of iosNodes.entries()) {
         const serial = typeof node.serial_num === "string" && node.serial_num.trim() ? node.serial_num.trim() : `usb-ios-device-${index + 1}`;
         const name = typeof node._name === "string" && node._name.trim() ? node._name.trim() : "iOS Device";
+        const version = runCommand("ideviceinfo", ["-u", serial, "-k", "ProductVersion"]) || "unknown";
         devices.push({
           id: serial,
           name,
           platform: "IOS",
-          platformVersion: "unknown",
+          platformVersion: version,
           state: "BOOTED",
           isAvailable: true,
           isPhysical: true
@@ -325381,7 +325382,7 @@ function parseAdbDevices() {
   const output = runCommand("adb", ["devices", "-l"]);
   if (!output) return [];
   const lines = output.split("\n").slice(1);
-  return lines.filter((line) => line.includes("	") || line.includes("device ")).map((line) => {
+  return lines.filter((line) => line.trim().length > 0).map((line) => {
     const parts = line.trim().split(/\s+/);
     const serial = parts[0];
     const type = parts[1] ?? "";
@@ -325397,26 +325398,25 @@ function parseAdbDevices() {
       device: props["device"],
       transportId: props["transport_id"]
     };
-  }).filter((d) => d.type === "device");
+  }).filter((d) => d.type === "device" || d.type === "unauthorized");
 }
 function getAndroidProp(serial, prop) {
   return runCommand("adb", ["-s", serial, "shell", "getprop", prop]);
 }
 function discoverAndroidDevices() {
   const adbDevices = parseAdbDevices();
-  return adbDevices.filter((d) => {
-    return d.type === "device";
-  }).map((d) => {
+  return adbDevices.filter((d) => d.type === "device" || d.type === "unauthorized").map((d) => {
     const isEmulator = d.serial.startsWith("emulator-");
+    const isAvailable = d.type === "device";
     const name = d.model || d.device || (isEmulator ? "Android Emulator" : "Android Device");
-    const platformVersion = getAndroidProp(d.serial, "ro.build.version.release") || "unknown";
+    const platformVersion = isAvailable ? getAndroidProp(d.serial, "ro.build.version.release") || "unknown" : "unknown";
     return {
       id: d.serial,
       name,
       platform: "ANDROID",
       platformVersion,
       state: "BOOTED",
-      isAvailable: true,
+      isAvailable,
       // Mark if it's a real device vs emulator
       ...isEmulator ? {} : { isPhysical: true }
     };
@@ -325449,10 +325449,14 @@ function discoverAllDevices(options) {
   const androidDevices = discoverAndroidDevices();
   if (options?.includeApps) {
     for (const device of iosDevices) {
-      device.installedApps = listIOSInstalledApps(device.id, !!device.isPhysical);
+      if (device.isAvailable) {
+        device.installedApps = listIOSInstalledApps(device.id, !!device.isPhysical);
+      }
     }
     for (const device of androidDevices) {
-      device.installedApps = listAndroidInstalledApps(device.id);
+      if (device.isAvailable) {
+        device.installedApps = listAndroidInstalledApps(device.id);
+      }
     }
   }
   return [...iosDevices, ...androidDevices];
@@ -325460,11 +325464,12 @@ function discoverAllDevices(options) {
 function getRunnerCapabilities() {
   const iosDevices = discoverIOSDevices();
   const androidDevices = discoverAndroidDevices();
+  const isReadyDevice = (device) => device.isAvailable && device.state === "BOOTED";
   return {
     web: true,
     // Always capable of web testing via Playwright
-    ios: iosDevices.length > 0,
-    android: androidDevices.length > 0
+    ios: iosDevices.some(isReadyDevice),
+    android: androidDevices.some(isReadyDevice)
   };
 }
 
@@ -325866,7 +325871,7 @@ async function executeMobileTest(options) {
     const devices = discoverAllDevices({ includeApps: true });
     const platformFilter = options.target.platform;
     const matchingDevices = devices.filter(
-      (d) => d.platform === platformFilter && d.state === "BOOTED"
+      (d) => d.platform === platformFilter && d.isAvailable && d.state === "BOOTED"
     );
     if (matchingDevices.length === 0) {
       throw new Error(
@@ -326030,7 +326035,7 @@ async function createMobileDiscoverySession(target) {
   const devices = discoverAllDevices({ includeApps: true });
   const platformFilter = target.platform;
   const matchingDevices = devices.filter(
-    (d) => d.platform === platformFilter && d.state === "BOOTED"
+    (d) => d.platform === platformFilter && d.isAvailable && d.state === "BOOTED"
   );
   if (matchingDevices.length === 0) {
     throw new Error(
@@ -326081,6 +326086,9 @@ async function createMobileDiscoverySession(target) {
 import { createServer } from "http";
 import { execFileSync as execFileSync3 } from "child_process";
 import { randomBytes, timingSafeEqual } from "crypto";
+import { homedir as homedir2 } from "os";
+import { join as join2, dirname } from "path";
+import { readFileSync as readFileSync2, writeFileSync as writeFileSync2, unlinkSync as unlinkSync2, mkdirSync as mkdirSync2 } from "fs";
 init_dist();
 
 // src/services/mobile/appium-actions.ts
@@ -326366,30 +326374,50 @@ async function getWindowSize3() {
   return getWindowSize2(`/session/${state.appiumSessionId}`);
 }
 var BRIDGE_PROCESS_MARKER = "validateqa-mobile-bridge";
-function killPort2(port) {
-  if (!Number.isInteger(port) || port <= 0 || port > 65535) return;
+var BRIDGE_PORT = MOBILE_BRIDGE_PORT2;
+var BRIDGE_PID_FILE = join2(homedir2(), ".validate.qa", "mobile-bridge.pid");
+function readBridgePidFile() {
   try {
-    const pids = execFileSync3("lsof", ["-ti", `:${port}`], { encoding: "utf-8" }).trim();
-    if (pids) {
-      const pidList = pids.split("\n").filter(Boolean);
-      for (const pid of pidList) {
-        if (!/^\d+$/.test(pid)) continue;
-        let command = "";
-        try {
-          command = execFileSync3("ps", ["-p", pid, "-o", "command="], { encoding: "utf-8" }).trim();
-        } catch {
-          continue;
-        }
-        if (!command.includes(BRIDGE_PROCESS_MARKER)) {
-          continue;
-        }
-        try {
-          execFileSync3("kill", ["-9", pid], { stdio: "ignore" });
-        } catch {
-        }
-      }
+    const raw = readFileSync2(BRIDGE_PID_FILE, "utf-8").trim();
+    const pid = parseInt(raw, 10);
+    return Number.isFinite(pid) && pid > 0 ? pid : null;
+  } catch {
+    return null;
+  }
+}
+function writeBridgePidFile(pid) {
+  try {
+    mkdirSync2(dirname(BRIDGE_PID_FILE), { recursive: true, mode: 448 });
+    writeFileSync2(BRIDGE_PID_FILE, String(pid), { mode: 384 });
+  } catch {
+  }
+}
+function clearBridgePidFile() {
+  try {
+    unlinkSync2(BRIDGE_PID_FILE);
+  } catch {
+  }
+}
+function killStaleBridge() {
+  const pid = readBridgePidFile();
+  if (!pid) return;
+  try {
+    execFileSync3("kill", ["-0", String(pid)], { stdio: "ignore" });
+  } catch {
+    clearBridgePidFile();
+    return;
+  }
+  try {
+    const pidsOnPort = execFileSync3("lsof", ["-ti", `:${BRIDGE_PORT}`], { encoding: "utf-8" }).trim();
+    const pidList = pidsOnPort.split("\n").filter(Boolean);
+    if (!pidList.includes(String(pid))) {
+      return;
     }
+    execFileSync3("kill", ["-9", String(pid)], { stdio: "ignore" });
+    execFileSync3("sleep", ["1"], { stdio: "ignore" });
   } catch {
+  } finally {
+    clearBridgePidFile();
   }
 }
 function parseBody(req) {
@@ -327014,7 +327042,7 @@ async function startMobileBridge(options) {
   if (!process.title.includes(BRIDGE_PROCESS_MARKER)) {
     process.title = `${process.title} ${BRIDGE_PROCESS_MARKER}`;
   }
-  killPort2(port);
+  killStaleBridge();
   return new Promise((resolve, reject) => {
     server2 = createServer(route);
     server2.on("error", (err) => {
@@ -327030,6 +327058,7 @@ async function startMobileBridge(options) {
       state.port = port;
       state.tunnelToken = tunnelToken;
       state.tunnelUrl = void 0;
+      writeBridgePidFile(process.pid);
       let tunnelUrl;
       if (enableTunnel) {
         try {
@@ -327097,6 +327126,7 @@ async function startMobileBridge(options) {
             let checkInterval = null;
             const timeout = setTimeout(() => {
               if (checkInterval) clearInterval(checkInterval);
+              checkInterval = null;
               if (!tunnelUrl) {
                 reject2(new Error("ngrok tunnel failed to start"));
               }
@@ -327105,6 +327135,7 @@ async function startMobileBridge(options) {
               if (tunnelUrl) {
                 clearTimeout(timeout);
                 if (checkInterval) clearInterval(checkInterval);
+                checkInterval = null;
                 resolve2();
               }
             }, 500);
@@ -327134,6 +327165,7 @@ async function startMobileBridge(options) {
 async function stopMobileBridge() {
   stopAllMirrorClients();
   stopSessionReaper();
+  clearBridgePidFile();
   if (state.appiumSessionId) {
     try {
       validateSessionId(state.appiumSessionId);
@@ -327392,7 +327424,7 @@ import { execFile, execFileSync as execFileSync4 } from "child_process";
 import { randomUUID } from "crypto";
 import { mkdtemp, rm, writeFile, readFile, readdir, mkdir, unlink } from "fs/promises";
 import { tmpdir, networkInterfaces } from "os";
-import { join as join2 } from "path";
+import { join as join3 } from "path";
 import { promisify } from "util";
 import {
   getLocal,
@@ -327404,7 +327436,7 @@ var MAX_BODY_CAPTURE_BYTES = 64 * 1024;
 var DEVICE_CMD_TIMEOUT_MS = 15e3;
 var CA_KEY_BITS = 2048;
 var ANDROID_EMULATOR_HOST_LOOPBACK = "10.0.2.2";
-var PENDING_CLEANUP_DIR = join2(tmpdir(), "validateqa-mobile-capture-pending");
+var PENDING_CLEANUP_DIR = join3(tmpdir(), "validateqa-mobile-capture-pending");
 function rawHeadersToPairs(rawHeaders) {
   return rawHeaders.map(([name, value]) => ({ name, value }));
 }
@@ -327688,7 +327720,7 @@ async function generateCaCert(dir, onLog) {
       // rely on stop() to remove the cert from the device promptly after the run
       // rather than on a short expiry.
     });
-    const caCertPath = join2(dir, "validateqa-mobile-ca.pem");
+    const caCertPath = join3(dir, "validateqa-mobile-ca.pem");
     await writeFile(caCertPath, cert, "utf-8");
     return { caCertPath, caKeyPem: key, caCertPem: cert };
   } catch (err) {
@@ -327794,7 +327826,7 @@ function errMsg(err) {
 var activeCleanups = /* @__PURE__ */ new Map();
 var exitHandlersInstalled = false;
 function markerPath(sessionKey) {
-  return join2(PENDING_CLEANUP_DIR, `${sessionKey}.json`);
+  return join3(PENDING_CLEANUP_DIR, `${sessionKey}.json`);
 }
 async function writePendingCleanup(sessionKey, marker) {
   try {
@@ -327836,7 +327868,7 @@ async function reconcilePendingCleanups(onLog) {
   }
   for (const file of files) {
     if (!file.endsWith(".json")) continue;
-    const full = join2(PENDING_CLEANUP_DIR, file);
+    const full = join3(PENDING_CLEANUP_DIR, file);
     try {
       const raw = await readFile(full, "utf-8");
       const marker = JSON.parse(raw);
@@ -327881,7 +327913,7 @@ async function startMobileNetworkCapture(options) {
   let caKeyPem = null;
   let caCertPem = null;
   try {
-    tmpDir = await mkdtemp(join2(tmpdir(), "validateqa-mobile-ca-"));
+    tmpDir = await mkdtemp(join3(tmpdir(), "validateqa-mobile-ca-"));
     const ca = await generateCaCert(tmpDir, onLog);
     if (ca) {
       caCertPath = ca.caCertPath;
@@ -327997,6 +328029,219 @@ async function startMobileNetworkCapture(options) {
   };
 }
 
+// src/services/doctor.ts
+import { execSync } from "child_process";
+import { existsSync as existsSync2 } from "fs";
+import { platform as platform2 } from "os";
+var C = {
+  reset: "\x1B[0m",
+  bold: "\x1B[1m",
+  green: "\x1B[32m",
+  red: "\x1B[31m",
+  yellow: "\x1B[33m",
+  cyan: "\x1B[36m",
+  gray: "\x1B[90m"
+};
+function run(cmd) {
+  try {
+    return execSync(cmd, { encoding: "utf-8", timeout: 15e3, stdio: ["pipe", "pipe", "pipe"] }).trim();
+  } catch {
+    return null;
+  }
+}
+function check(name, fn) {
+  try {
+    const result = fn();
+    return { name, ...result };
+  } catch (err) {
+    return { name, ok: false, detail: err instanceof Error ? err.message : "Unknown error" };
+  }
+}
+function checkWeb() {
+  const results = [];
+  results.push(check("Node.js", () => {
+    const version = process.version;
+    const major = parseInt(version.slice(1).split(".")[0], 10);
+    return { ok: major >= 20, detail: `${version}${major < 20 ? " (>= 20 required)" : ""}` };
+  }));
+  results.push(check("Playwright", () => {
+    const version = run("npx playwright --version");
+    if (!version) return { ok: false, detail: "Not installed. Run: npm i -D playwright" };
+    return { ok: true, detail: version };
+  }));
+  return results;
+}
+function checkIOS() {
+  const results = [];
+  const isMac = platform2() === "darwin";
+  results.push(check("macOS", () => ({
+    ok: isMac,
+    detail: isMac ? `${platform2()} detected` : "iOS testing requires macOS"
+  })));
+  if (!isMac) return results;
+  results.push(check("Xcode", () => {
+    const version = run("xcodebuild -version");
+    if (!version) return { ok: false, detail: "Not installed. Install from App Store." };
+    const firstLine = version.split("\n")[0];
+    return { ok: true, detail: firstLine };
+  }));
+  results.push(check("Xcode Command Line Tools", () => {
+    const path = run("xcode-select -p");
+    return { ok: !!path, detail: path || "Not installed. Run: xcode-select --install" };
+  }));
+  results.push(check("Appium xcuitest driver", () => {
+    const drivers = run("appium driver list --installed --json");
+    if (!drivers) return { ok: false, detail: "Appium not found. Run: npm i -g appium" };
+    try {
+      const parsed = JSON.parse(drivers);
+      const hasXcuitest = parsed?.xcuitest || typeof parsed === "object" && Object.keys(parsed).some((k) => k.toLowerCase().includes("xcuitest"));
+      return {
+        ok: !!hasXcuitest,
+        detail: hasXcuitest ? "Installed" : "Not installed. Run: appium driver install xcuitest"
+      };
+    } catch {
+      const hasXcuitest = drivers.toLowerCase().includes("xcuitest");
+      return {
+        ok: hasXcuitest,
+        detail: hasXcuitest ? "Installed" : "Not installed. Run: appium driver install xcuitest"
+      };
+    }
+  }));
+  results.push(check("iOS Devices", () => {
+    const json = run("xcrun simctl list devices booted --json");
+    let bootedSimulators = 0;
+    if (json) {
+      try {
+        const parsed = JSON.parse(json);
+        const devices = Object.values(parsed.devices ?? {}).flat();
+        bootedSimulators = devices.filter((d) => d.state === "Booted").length;
+      } catch {
+      }
+    }
+    const realDevices = discoverRealIOSDevices().length;
+    const total = bootedSimulators + realDevices;
+    if (total === 0) {
+      return {
+        ok: false,
+        detail: "No devices found. Boot a simulator or connect a real device via USB."
+      };
+    }
+    const details = [];
+    if (bootedSimulators > 0) details.push(`${bootedSimulators} simulator(s)`);
+    if (realDevices > 0) details.push(`${realDevices} real device(s)`);
+    return {
+      ok: true,
+      detail: `${total} device(s) available: ${details.join(", ")}`
+    };
+  }));
+  return results;
+}
+function checkAndroid() {
+  const results = [];
+  const androidHome = process.env.ANDROID_HOME || process.env.ANDROID_SDK_ROOT;
+  results.push(check("ANDROID_HOME", () => ({
+    ok: !!androidHome && existsSync2(androidHome),
+    detail: androidHome ? existsSync2(androidHome) ? androidHome : `${androidHome} (not found)` : "Not set. Set ANDROID_HOME to your Android SDK path."
+  })));
+  if (!androidHome || !existsSync2(androidHome)) return results;
+  results.push(check("adb", () => {
+    const version = run("adb version");
+    if (!version) return { ok: false, detail: "Not found in PATH. Ensure Android platform-tools are installed." };
+    const firstLine = version.split("\n")[0];
+    return { ok: true, detail: firstLine };
+  }));
+  results.push(check("Appium uiautomator2 driver", () => {
+    const drivers = run("appium driver list --installed --json");
+    if (!drivers) return { ok: false, detail: "Appium not found. Run: npm i -g appium" };
+    try {
+      const parsed = JSON.parse(drivers);
+      const hasUia2 = parsed?.uiautomator2 || typeof parsed === "object" && Object.keys(parsed).some((k) => k.toLowerCase().includes("uiautomator2"));
+      return {
+        ok: !!hasUia2,
+        detail: hasUia2 ? "Installed" : "Not installed. Run: appium driver install uiautomator2"
+      };
+    } catch {
+      const hasUia2 = drivers.toLowerCase().includes("uiautomator2");
+      return {
+        ok: hasUia2,
+        detail: hasUia2 ? "Installed" : "Not installed. Run: appium driver install uiautomator2"
+      };
+    }
+  }));
+  results.push(check("Android Devices", () => {
+    const output = run("adb devices");
+    if (!output) return { ok: false, detail: "adb devices failed" };
+    const lines = output.split("\n").filter((l) => l.includes("	device"));
+    const emulators = lines.filter((l) => l.startsWith("emulator-"));
+    const realDevices = lines.filter((l) => !l.startsWith("emulator-") && l.includes("	device"));
+    const total = emulators.length + realDevices.length;
+    if (total === 0) {
+      return {
+        ok: false,
+        detail: "No devices found. Start an emulator or connect a real device via USB with USB debugging enabled."
+      };
+    }
+    const details = [];
+    if (emulators.length > 0) details.push(`${emulators.length} emulator(s)`);
+    if (realDevices.length > 0) details.push(`${realDevices.length} real device(s)`);
+    return {
+      ok: true,
+      detail: `${total} device(s) available: ${details.join(", ")}`
+    };
+  }));
+  return results;
+}
+function checkTunnel() {
+  const version = run("ngrok version") || run("ngrok --version");
+  if (!version) {
+    return [{
+      name: "ngrok",
+      ok: false,
+      detail: "Not installed (only needed for --tunnel with an HTTPS dashboard). Install: brew install ngrok && ngrok config add-authtoken <token>"
+    }];
+  }
+  const match = version.match(/(\d+)\.\d+\.\d+/);
+  const major = match ? parseInt(match[1], 10) : 0;
+  return [{
+    name: "ngrok",
+    ok: major >= 3,
+    detail: major >= 3 ? `${version} (configure an authtoken with: ngrok config add-authtoken <token>)` : `${version} \u2014 ngrok v3+ is recommended (brew install ngrok)`
+  }];
+}
+function runDoctor() {
+  const web = checkWeb();
+  const ios = checkIOS();
+  const android = checkAndroid();
+  const tunnel = checkTunnel();
+  const allPassed = [...web, ...ios, ...android].every((c) => c.ok);
+  return { web, ios, android, tunnel, allPassed };
+}
+function printDoctorReport(report) {
+  console.log("");
+  console.log(`${C.bold}${C.cyan}\u{1F3E5} validate.qa Doctor${C.reset}`);
+  console.log(`${C.gray}${"\u2500".repeat(40)}${C.reset}`);
+  const printSection = (title, checks) => {
+    console.log("");
+    console.log(`  ${C.bold}${title}:${C.reset}`);
+    for (const c of checks) {
+      const icon = c.ok ? `${C.green}\u2713${C.reset}` : `${C.red}\u2717${C.reset}`;
+      console.log(`    ${icon}  ${c.name}: ${c.detail}`);
+    }
+  };
+  printSection("Web Testing", report.web);
+  printSection("iOS Testing", report.ios);
+  printSection("Android Testing", report.android);
+  printSection("Tunnel (optional \u2014 only for --tunnel / HTTPS dashboard)", report.tunnel);
+  console.log("");
+  if (report.allPassed) {
+    console.log(`  ${C.green}\u2705 All checks passed - ready for web + mobile testing${C.reset}`);
+  } else {
+    const failCount = [...report.web, ...report.ios, ...report.android].filter((c) => !c.ok).length;
+    console.log(`  ${C.yellow}\u26A0  ${failCount} check(s) need attention${C.reset}`);
+  }
+  console.log("");
+}
+
 // src/runner.ts
 init_dist();
 var import_runner_core11 = __toESM(require_dist2());
@@ -328086,7 +328331,7 @@ var browserPool = new import_runner_core6.BrowserPool({
   maxContextsPerBrowser: envInt("MAX_CONTEXTS_PER_BROWSER", DEFAULT_MAX_CONTEXTS_PER_BROWSER),
   retireAfterContexts: 30
 });
-var C = {
+var C2 = {
   reset: "\x1B[0m",
   bold: "\x1B[1m",
   green: "\x1B[32m",
@@ -328096,24 +328341,24 @@ var C = {
   gray: "\x1B[90m"
 };
 var log = {
-  info: (msg) => console.log(`${C.cyan}\u2139${C.reset}  ${msg}`),
-  ok: (msg) => console.log(`${C.green}\u2713${C.reset}  ${msg}`),
-  fail: (msg) => console.log(`${C.red}\u2717${C.reset}  ${msg}`),
-  warn: (msg) => console.log(`${C.yellow}\u26A0${C.reset}  ${msg}`),
-  dim: (msg) => console.log(`${C.gray}${msg}${C.reset}`)
+  info: (msg) => console.log(`${C2.cyan}\u2139${C2.reset}  ${msg}`),
+  ok: (msg) => console.log(`${C2.green}\u2713${C2.reset}  ${msg}`),
+  fail: (msg) => console.log(`${C2.red}\u2717${C2.reset}  ${msg}`),
+  warn: (msg) => console.log(`${C2.yellow}\u26A0${C2.reset}  ${msg}`),
+  dim: (msg) => console.log(`${C2.gray}${msg}${C2.reset}`)
 };
 var AUTH_MAX_AGE_MS = 60 * 60 * 1e3;
 function getRunsDir() {
-  const dir = process.env.RUNS_DIR || join3(homedir2(), ".validate.qa", "runs");
-  if (!existsSync2(dir)) mkdirSync2(dir, { recursive: true });
+  const dir = process.env.RUNS_DIR || join4(homedir3(), ".validate.qa", "runs");
+  if (!existsSync3(dir)) mkdirSync3(dir, { recursive: true });
   return dir;
 }
 function authStatePath(projectId) {
-  return join3(getRunsDir(), `auth-state-${projectId || "default"}.json`);
+  return join4(getRunsDir(), `auth-state-${projectId || "default"}.json`);
 }
 function getValidAuthState(projectId) {
   const path = authStatePath(projectId);
-  if (!existsSync2(path)) return void 0;
+  if (!existsSync3(path)) return void 0;
   const age = Date.now() - statSync(path).mtimeMs;
   return age < AUTH_MAX_AGE_MS ? path : void 0;
 }
@@ -329056,9 +329301,9 @@ ${finalVerifyResult.logs ?? ""}`;
           (l) => l.includes("Phase 1: Script-driven") || l.includes("Phase 2: Escalating") || l.includes("Phase 2: Script + MCP") || l.includes("Phase 1 succeeded") || l.includes("Phase 2 iteration") || l.includes("\u{1F916} Verdict:") || l.includes("\u{1F916} finish_fix:") || l.includes("native verification PASSED") || l.includes("native verification FAILED") || l.includes("Native run PASSED") || l.includes("Native run FAILED") || l.includes("APP_BUG") || l.includes("CONFIG_ISSUE") || l.includes("needs_browser") || l.includes("--- Attempt") || l.includes("Proven commands") || l.includes("Proven fix:") || l.includes("Same error repeated") || l.includes("aborting heal")
         );
         if (phaseLines.length > 0) {
-          console.log(`${C.gray}\u2500\u2500 Heal summary \u2500\u2500${C.reset}`);
+          console.log(`${C2.gray}\u2500\u2500 Heal summary \u2500\u2500${C2.reset}`);
           for (const line of phaseLines) console.log(line);
-          console.log(`${C.gray}\u2500\u2500 End summary \u2500\u2500\u2500${C.reset}`);
+          console.log(`${C2.gray}\u2500\u2500 End summary \u2500\u2500\u2500${C2.reset}`);
         }
       }
       log[result2.passed ? "ok" : "fail"](
@@ -329597,11 +329842,18 @@ ${finalVerifyResult.logs ?? ""}`;
       }
       try {
         if (isNativeMobile) {
-          const platform3 = mobileMedium === "IOS_NATIVE" ? "IOS" : "ANDROID";
           const mobileTarget = ctx.target;
           if (!mobileTarget || !mobileTarget.appId) {
             throw new Error("Native mobile discovery requires a target with an appId (bundleId/appPackage).");
           }
+          const targetPlatform = mobileTarget.platform;
+          const platform3 = mobileMedium === "IOS_NATIVE" ? "IOS" : mobileMedium === "ANDROID_NATIVE" ? "ANDROID" : targetPlatform === "IOS" || targetPlatform === "ANDROID" ? targetPlatform : null;
+          if (!platform3) {
+            throw new Error("Native mobile discovery requires medium IOS_NATIVE/ANDROID_NATIVE or target.platform IOS/ANDROID.");
+          }
+          if (mobileMedium === "IOS_NATIVE" && targetPlatform === "ANDROID" || mobileMedium === "ANDROID_NATIVE" && targetPlatform === "IOS") {
+            throw new Error("Native mobile discovery medium does not match target.platform.");
+          }
           if (getBridgeState().hasActiveSession) {
             throw new Error("CONFIG_ISSUE: the shared mobile device is busy with an active recording session; mobile discovery will retry once it ends.");
           }
@@ -330030,9 +330282,9 @@ ${finalVerifyResult.logs ?? ""}`;
     } else {
       log.fail(`FAILED  (${duration}ms)${result.error ? ` - ${result.error}` : ""}`);
       if (result.logs) {
-        console.log(`${C.gray}\u2500\u2500 Runner logs \u2500\u2500${C.reset}`);
+        console.log(`${C2.gray}\u2500\u2500 Runner logs \u2500\u2500${C2.reset}`);
         console.log(result.logs);
-        console.log(`${C.gray}\u2500\u2500 End logs \u2500\u2500\u2500\u2500\u2500${C.reset}`);
+        console.log(`${C2.gray}\u2500\u2500 End logs \u2500\u2500\u2500\u2500\u2500${C2.reset}`);
       }
     }
   } catch (err) {
@@ -330054,20 +330306,24 @@ ${finalVerifyResult.logs ?? ""}`;
 }
 async function startRunner(opts) {
   const { serverUrl, authToken, projectId, pollIntervalMs = 2e3, runnerMode = "playwright-native", enableMobile = false, enableMobileTunnel = false } = opts;
+  process.env.SERVER_URL = serverUrl;
+  process.env.AUTH_TOKEN = authToken;
+  process.env.RUNNER_TOKEN = authToken;
+  if (projectId) process.env.PROJECT_ID = projectId;
   const headers = buildHeaders(authToken, projectId);
   console.log("");
-  console.log(`${C.bold}${C.cyan}\u{1F399}\uFE0F  validate.qa Local Runner${C.reset}`);
-  console.log(`${C.gray}${"\u2500".repeat(40)}${C.reset}`);
+  console.log(`${C2.bold}${C2.cyan}\u{1F399}\uFE0F  validate.qa Local Runner${C2.reset}`);
+  console.log(`${C2.gray}${"\u2500".repeat(40)}${C2.reset}`);
   log.info(`Server:   ${serverUrl}`);
   log.info(`Project:  ${projectId}`);
   log.info(`Mode:     \u{1F3AD} Playwright Native${enableMobile ? " + \u{1F4F1} Mobile" : ""}${enableMobile && enableMobileTunnel ? " \u{1F310} Tunnel" : ""}`);
   log.info(`Interval: ${pollIntervalMs}ms`);
   if (process.env.DISCOVERY_PROMPT_V3 === "true") {
-    log.ok("Discovery: V3 forced (DISCOVERY_PROMPT_V3=true)");
+    log.ok("Discovery prompt: V3 (per-turn rebuild) \u2014 DISCOVERY_PROMPT_V3=true");
   } else if (process.env.DISCOVERY_PROMPT_V3 === "false") {
-    log.ok("Discovery: V2.5 forced (DISCOVERY_PROMPT_V3=false)");
+    log.ok("Discovery prompt: V2.5 (full transcript + control brief) \u2014 DISCOVERY_PROMPT_V3=false");
   } else {
-    log.ok("Discovery: auto mode (Grok -> V2.5, others -> V3)");
+    log.ok("Discovery prompt: V3 (per-turn rebuild, default) \u2014 set DISCOVERY_PROMPT_V3=false for V2.5");
   }
   if ((0, import_runner_core5.hasUsableChromeProfile)()) {
     log.ok(`Browser:  Chrome with user profile (cookies/logins persist)`);
@@ -330079,8 +330335,8 @@ async function startRunner(opts) {
       const devices = discoverAllDevices();
       const capabilities = {
         web: true,
-        ios: devices.some((d) => d.platform === "IOS"),
-        android: devices.some((d) => d.platform === "ANDROID")
+        ios: devices.some((d) => d.platform === "IOS" && d.isAvailable && d.state === "BOOTED"),
+        android: devices.some((d) => d.platform === "ANDROID" && d.isAvailable && d.state === "BOOTED")
       };
       log.info(`\u{1F4F1} Mobile: iOS ${capabilities.ios ? "\u2713" : "\u2717"} | Android ${capabilities.android ? "\u2713" : "\u2717"} | ${devices.length} device(s)`);
       try {
@@ -330141,6 +330397,33 @@ async function startRunner(opts) {
   const startedAt = Date.now();
   const MAX_BACKOFF_MS = 6e4;
   let consecutivePollErrors = 0;
+  let cachedDoctor = null;
+  const DOCTOR_TTL_MS = 5 * 60 * 1e3;
+  let doctorRefreshInFlight = false;
+  const refreshDoctorInBackground = () => {
+    if (doctorRefreshInFlight) return;
+    doctorRefreshInFlight = true;
+    setImmediate(() => {
+      try {
+        const report = runDoctor();
+        cachedDoctor = { report, at: Date.now() };
+      } catch (err) {
+        log.dim(`  [doctor] refresh failed: ${err instanceof Error ? err.message : String(err)}`);
+      } finally {
+        doctorRefreshInFlight = false;
+      }
+    });
+  };
+  const getCachedDoctor = () => {
+    if (!enableMobile) return void 0;
+    if (!cachedDoctor) {
+      refreshDoctorInBackground();
+      return void 0;
+    }
+    const now = Date.now();
+    if (now - cachedDoctor.at >= DOCTOR_TTL_MS) refreshDoctorInBackground();
+    return cachedDoctor.report;
+  };
   log.info(`Concurrency: ${RESOURCE_GOVERNOR_OPTIONS.adaptive ? `adaptive (${RESOURCE_GOVERNOR_OPTIONS.maxUnits} weighted units, hard cap ${MAX_CONCURRENT})` : `static (hard cap ${MAX_CONCURRENT})`}`);
   const poolSize = envInt("BROWSER_POOL_SIZE", DEFAULT_BROWSER_POOL_SIZE);
   if (poolSize > 0) {
@@ -330249,7 +330532,11 @@ async function startRunner(opts) {
   const sendHeartbeat = async () => {
     try {
       const devices = enableMobile ? discoverAllDevices() : [];
-      const capabilities = enableMobile ? { web: true, ios: devices.some((d) => d.platform === "IOS"), android: devices.some((d) => d.platform === "ANDROID") } : { web: true, ios: false, android: false };
+      const capabilities = enableMobile ? {
+        web: true,
+        ios: devices.some((d) => d.platform === "IOS" && d.isAvailable && d.state === "BOOTED"),
+        android: devices.some((d) => d.platform === "ANDROID" && d.isAvailable && d.state === "BOOTED")
+      } : { web: true, ios: false, android: false };
       const bridge = enableMobile ? getBridgeState() : void 0;
       const resourceStatus = (0, import_runner_core11.getResourceGovernorStatus)(RESOURCE_GOVERNOR_OPTIONS, Object.fromEntries(activeByType));
       const processInventory = await (0, import_runner_core11.getBrowserProcessInventory)();
@@ -330280,7 +330567,10 @@ async function startRunner(opts) {
           resourceGovernor: resourceStatus.governor,
           processInventory,
           aiQueue: (0, import_runner_core11.getRunnerAIQueueStats)(),
-          liveBrowsers: import_runner_core10.liveBrowserRegistry.snapshotForHeartbeat()
+          liveBrowsers: import_runner_core10.liveBrowserRegistry.snapshotForHeartbeat(),
+          // Pre-flight checks (ANDROID_HOME, Xcode, Appium drivers, adb, etc).
+          // Cached & cheap — see getCachedDoctor above.
+          doctor: getCachedDoctor()
         }),
         signal: AbortSignal.timeout(1e4)
       });
@@ -330480,219 +330770,6 @@ async function startRunner(opts) {
   }
 }
 
-// src/services/doctor.ts
-import { execSync } from "child_process";
-import { existsSync as existsSync3 } from "fs";
-import { platform as platform2 } from "os";
-var C2 = {
-  reset: "\x1B[0m",
-  bold: "\x1B[1m",
-  green: "\x1B[32m",
-  red: "\x1B[31m",
-  yellow: "\x1B[33m",
-  cyan: "\x1B[36m",
-  gray: "\x1B[90m"
-};
-function run(cmd) {
-  try {
-    return execSync(cmd, { encoding: "utf-8", timeout: 15e3, stdio: ["pipe", "pipe", "pipe"] }).trim();
-  } catch {
-    return null;
-  }
-}
-function check(name, fn) {
-  try {
-    const result = fn();
-    return { name, ...result };
-  } catch (err) {
-    return { name, ok: false, detail: err instanceof Error ? err.message : "Unknown error" };
-  }
-}
-function checkWeb() {
-  const results = [];
-  results.push(check("Node.js", () => {
-    const version = process.version;
-    const major = parseInt(version.slice(1).split(".")[0], 10);
-    return { ok: major >= 20, detail: `${version}${major < 20 ? " (>= 20 required)" : ""}` };
-  }));
-  results.push(check("Playwright", () => {
-    const version = run("npx playwright --version");
-    if (!version) return { ok: false, detail: "Not installed. Run: npm i -D playwright" };
-    return { ok: true, detail: version };
-  }));
-  return results;
-}
-function checkIOS() {
-  const results = [];
-  const isMac = platform2() === "darwin";
-  results.push(check("macOS", () => ({
-    ok: isMac,
-    detail: isMac ? `${platform2()} detected` : "iOS testing requires macOS"
-  })));
-  if (!isMac) return results;
-  results.push(check("Xcode", () => {
-    const version = run("xcodebuild -version");
-    if (!version) return { ok: false, detail: "Not installed. Install from App Store." };
-    const firstLine = version.split("\n")[0];
-    return { ok: true, detail: firstLine };
-  }));
-  results.push(check("Xcode Command Line Tools", () => {
-    const path = run("xcode-select -p");
-    return { ok: !!path, detail: path || "Not installed. Run: xcode-select --install" };
-  }));
-  results.push(check("Appium xcuitest driver", () => {
-    const drivers = run("appium driver list --installed --json");
-    if (!drivers) return { ok: false, detail: "Appium not found. Run: npm i -g appium" };
-    try {
-      const parsed = JSON.parse(drivers);
-      const hasXcuitest = parsed?.xcuitest || typeof parsed === "object" && Object.keys(parsed).some((k) => k.toLowerCase().includes("xcuitest"));
-      return {
-        ok: !!hasXcuitest,
-        detail: hasXcuitest ? "Installed" : "Not installed. Run: appium driver install xcuitest"
-      };
-    } catch {
-      const hasXcuitest = drivers.toLowerCase().includes("xcuitest");
-      return {
-        ok: hasXcuitest,
-        detail: hasXcuitest ? "Installed" : "Not installed. Run: appium driver install xcuitest"
-      };
-    }
-  }));
-  results.push(check("iOS Devices", () => {
-    const json = run("xcrun simctl list devices booted --json");
-    let bootedSimulators = 0;
-    if (json) {
-      try {
-        const parsed = JSON.parse(json);
-        const devices = Object.values(parsed.devices ?? {}).flat();
-        bootedSimulators = devices.filter((d) => d.state === "Booted").length;
-      } catch {
-      }
-    }
-    const realDevices = discoverRealIOSDevices().length;
-    const total = bootedSimulators + realDevices;
-    if (total === 0) {
-      return {
-        ok: false,
-        detail: "No devices found. Boot a simulator or connect a real device via USB."
-      };
-    }
-    const details = [];
-    if (bootedSimulators > 0) details.push(`${bootedSimulators} simulator(s)`);
-    if (realDevices > 0) details.push(`${realDevices} real device(s)`);
-    return {
-      ok: true,
-      detail: `${total} device(s) available: ${details.join(", ")}`
-    };
-  }));
-  return results;
-}
-function checkAndroid() {
-  const results = [];
-  const androidHome = process.env.ANDROID_HOME || process.env.ANDROID_SDK_ROOT;
-  results.push(check("ANDROID_HOME", () => ({
-    ok: !!androidHome && existsSync3(androidHome),
-    detail: androidHome ? existsSync3(androidHome) ? androidHome : `${androidHome} (not found)` : "Not set. Set ANDROID_HOME to your Android SDK path."
-  })));
-  if (!androidHome || !existsSync3(androidHome)) return results;
-  results.push(check("adb", () => {
-    const version = run("adb version");
-    if (!version) return { ok: false, detail: "Not found in PATH. Ensure Android platform-tools are installed." };
-    const firstLine = version.split("\n")[0];
-    return { ok: true, detail: firstLine };
-  }));
-  results.push(check("Appium uiautomator2 driver", () => {
-    const drivers = run("appium driver list --installed --json");
-    if (!drivers) return { ok: false, detail: "Appium not found. Run: npm i -g appium" };
-    try {
-      const parsed = JSON.parse(drivers);
-      const hasUia2 = parsed?.uiautomator2 || typeof parsed === "object" && Object.keys(parsed).some((k) => k.toLowerCase().includes("uiautomator2"));
-      return {
-        ok: !!hasUia2,
-        detail: hasUia2 ? "Installed" : "Not installed. Run: appium driver install uiautomator2"
-      };
-    } catch {
-      const hasUia2 = drivers.toLowerCase().includes("uiautomator2");
-      return {
-        ok: hasUia2,
-        detail: hasUia2 ? "Installed" : "Not installed. Run: appium driver install uiautomator2"
-      };
-    }
-  }));
-  results.push(check("Android Devices", () => {
-    const output = run("adb devices");
-    if (!output) return { ok: false, detail: "adb devices failed" };
-    const lines = output.split("\n").filter((l) => l.includes("	device"));
-    const emulators = lines.filter((l) => l.startsWith("emulator-"));
-    const realDevices = lines.filter((l) => !l.startsWith("emulator-") && l.includes("	device"));
-    const total = emulators.length + realDevices.length;
-    if (total === 0) {
-      return {
-        ok: false,
-        detail: "No devices found. Start an emulator or connect a real device via USB with USB debugging enabled."
-      };
-    }
-    const details = [];
-    if (emulators.length > 0) details.push(`${emulators.length} emulator(s)`);
-    if (realDevices.length > 0) details.push(`${realDevices.length} real device(s)`);
-    return {
-      ok: true,
-      detail: `${total} device(s) available: ${details.join(", ")}`
-    };
-  }));
-  return results;
-}
-function checkTunnel() {
-  const version = run("ngrok version") || run("ngrok --version");
-  if (!version) {
-    return [{
-      name: "ngrok",
-      ok: false,
-      detail: "Not installed (only needed for --tunnel with an HTTPS dashboard). Install: brew install ngrok && ngrok config add-authtoken <token>"
-    }];
-  }
-  const match = version.match(/(\d+)\.\d+\.\d+/);
-  const major = match ? parseInt(match[1], 10) : 0;
-  return [{
-    name: "ngrok",
-    ok: major >= 3,
-    detail: major >= 3 ? `${version} (configure an authtoken with: ngrok config add-authtoken <token>)` : `${version} \u2014 ngrok v3+ is recommended (brew install ngrok)`
-  }];
-}
-function runDoctor() {
-  const web = checkWeb();
-  const ios = checkIOS();
-  const android = checkAndroid();
-  const tunnel = checkTunnel();
-  const allPassed = [...web, ...ios, ...android].every((c) => c.ok);
-  return { web, ios, android, tunnel, allPassed };
-}
-function printDoctorReport(report) {
-  console.log("");
-  console.log(`${C2.bold}${C2.cyan}\u{1F3E5} validate.qa Doctor${C2.reset}`);
-  console.log(`${C2.gray}${"\u2500".repeat(40)}${C2.reset}`);
-  const printSection = (title, checks) => {
-    console.log("");
-    console.log(`  ${C2.bold}${title}:${C2.reset}`);
-    for (const c of checks) {
-      const icon = c.ok ? `${C2.green}\u2713${C2.reset}` : `${C2.red}\u2717${C2.reset}`;
-      console.log(`    ${icon}  ${c.name}: ${c.detail}`);
-    }
-  };
-  printSection("Web Testing", report.web);
-  printSection("iOS Testing", report.ios);
-  printSection("Android Testing", report.android);
-  printSection("Tunnel (optional \u2014 only for --tunnel / HTTPS dashboard)", report.tunnel);
-  console.log("");
-  if (report.allPassed) {
-    console.log(`  ${C2.green}\u2705 All checks passed - ready for web + mobile testing${C2.reset}`);
-  } else {
-    const failCount = [...report.web, ...report.ios, ...report.android].filter((c) => !c.ok).length;
-    console.log(`  ${C2.yellow}\u26A0  ${failCount} check(s) need attention${C2.reset}`);
-  }
-  console.log("");
-}
-
 // src/cli.ts
 var pkg = require_package4();
 var program = new Command();