@validate.qa/runner 1.0.2 → 1.0.3

package/dist/cli.js

@@ -1405,7 +1405,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) {
@@ -21738,7 +21738,7 @@ var require_util = __commonJS({
       return path;
     }
     exports2.normalize = normalize;
-    function join4(aRoot, aPath) {
+    function join5(aRoot, aPath) {
       if (aRoot === "") {
         aRoot = ".";
       }
@@ -21770,7 +21770,7 @@ var require_util = __commonJS({
       }
       return joined;
     }
-    exports2.join = join4;
+    exports2.join = join5;
     exports2.isAbsolute = function(aPath) {
       return aPath.charAt(0) === "/" || urlRegexp.test(aPath);
     };
@@ -21943,7 +21943,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);
     }
@@ -243098,7 +243098,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 {
@@ -243149,7 +243149,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",
@@ -243617,7 +243617,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();
@@ -243770,7 +243770,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,
@@ -243788,7 +243788,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,
@@ -243811,7 +243811,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) {
@@ -244792,7 +244792,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) {
@@ -244806,7 +244806,7 @@ var require_safe_stable_stringify = __commonJS({
                 indentation += spacer;
                 res += `
 ${indentation}`;
-                join4 = `,
+                join5 = `,
 ${indentation}`;
               }
               const maximumValuesToStringify = Math.min(value.length, maximumBreadth);
@@ -244814,13 +244814,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 += `
@@ -244841,7 +244841,7 @@ ${originalIndentation}`;
             let separator = "";
             if (spacer !== "") {
               indentation += spacer;
-              join4 = `,
+              join5 = `,
 ${indentation}`;
               whitespace = " ";
             }
@@ -244855,13 +244855,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 = `
@@ -244902,7 +244902,7 @@ ${originalIndentation}`;
             }
             const originalIndentation = indentation;
             let res = "";
-            let join4 = ",";
+            let join5 = ",";
             if (Array.isArray(value)) {
               if (value.length === 0) {
                 return "[]";
@@ -244915,7 +244915,7 @@ ${originalIndentation}`;
                 indentation += spacer;
                 res += `
 ${indentation}`;
-                join4 = `,
+                join5 = `,
 ${indentation}`;
               }
               const maximumValuesToStringify = Math.min(value.length, maximumBreadth);
@@ -244923,13 +244923,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 += `
@@ -244942,7 +244942,7 @@ ${originalIndentation}`;
             let whitespace = "";
             if (spacer !== "") {
               indentation += spacer;
-              join4 = `,
+              join5 = `,
 ${indentation}`;
               whitespace = " ";
             }
@@ -244951,7 +244951,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) {
@@ -245009,20 +245009,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}`;
@@ -245038,16 +245038,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);
@@ -245058,13 +245058,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 = `
@@ -285421,11 +285421,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) => {
@@ -312619,7 +312619,7 @@ var require_utils2 = __commonJS({
     module2.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;
@@ -312637,7 +312637,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;
@@ -314256,8 +314256,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) {
@@ -319670,14 +319670,14 @@ var require_path_arg = __commonJS({
 var require_find_made = __commonJS({
   "../../node_modules/tar/node_modules/mkdirp/lib/find-made.js"(exports2, module2) {
     "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) => {
@@ -319686,7 +319686,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;
       }
     };
     module2.exports = { findMade, findMadeSync };
@@ -319697,10 +319697,10 @@ var require_find_made = __commonJS({
 var require_mkdirp_manual = __commonJS({
   "../../node_modules/tar/node_modules/mkdirp/lib/mkdirp-manual.js"(exports2, module2) {
     "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")
@@ -319723,7 +319723,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 {
@@ -319759,12 +319759,12 @@ var require_mkdirp_manual = __commonJS({
 var require_mkdirp_native = __commonJS({
   "../../node_modules/tar/node_modules/mkdirp/lib/mkdirp-native.js"(exports2, module2) {
     "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) => {
@@ -319776,7 +319776,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);
@@ -320181,7 +320181,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";
     module2.exports = () => {
@@ -320190,7 +320190,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;
@@ -320258,7 +320258,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))
@@ -324796,7 +324796,7 @@ var require_package4 = __commonJS({
   "package.json"(exports2, module2) {
     module2.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"
@@ -324804,7 +324804,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: [
@@ -324882,9 +324882,9 @@ function getConfigDir() {
 }
 
 // src/runner.ts
-var import_fs2 = require("fs");
-var import_path2 = require("path");
-var import_os3 = require("os");
+var import_fs4 = require("fs");
+var import_path3 = require("path");
+var import_os5 = require("os");
 var import_node_crypto2 = require("crypto");
 
 // src/services/playwright-native.ts
@@ -325297,11 +325297,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
@@ -325376,7 +325377,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] ?? "";
@@ -325392,26 +325393,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 }
     };
@@ -325444,10 +325444,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];
@@ -325455,11 +325459,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)
   };
 }
 
@@ -325861,7 +325866,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(
@@ -326025,7 +326030,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(
@@ -326076,6 +326081,9 @@ async function createMobileDiscoverySession(target) {
 var import_http = require("http");
 var import_child_process3 = require("child_process");
 var import_crypto = require("crypto");
+var import_os3 = require("os");
+var import_path2 = require("path");
+var import_fs2 = require("fs");
 init_dist();
 
 // src/services/mobile/appium-actions.ts
@@ -326361,30 +326369,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 = (0, import_path2.join)((0, import_os3.homedir)(), ".validate.qa", "mobile-bridge.pid");
+function readBridgePidFile() {
   try {
-    const pids = (0, import_child_process3.execFileSync)("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 = (0, import_child_process3.execFileSync)("ps", ["-p", pid, "-o", "command="], { encoding: "utf-8" }).trim();
-        } catch {
-          continue;
-        }
-        if (!command.includes(BRIDGE_PROCESS_MARKER)) {
-          continue;
-        }
-        try {
-          (0, import_child_process3.execFileSync)("kill", ["-9", pid], { stdio: "ignore" });
-        } catch {
-        }
-      }
+    const raw = (0, import_fs2.readFileSync)(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 {
+    (0, import_fs2.mkdirSync)((0, import_path2.dirname)(BRIDGE_PID_FILE), { recursive: true, mode: 448 });
+    (0, import_fs2.writeFileSync)(BRIDGE_PID_FILE, String(pid), { mode: 384 });
+  } catch {
+  }
+}
+function clearBridgePidFile() {
+  try {
+    (0, import_fs2.unlinkSync)(BRIDGE_PID_FILE);
+  } catch {
+  }
+}
+function killStaleBridge() {
+  const pid = readBridgePidFile();
+  if (!pid) return;
+  try {
+    (0, import_child_process3.execFileSync)("kill", ["-0", String(pid)], { stdio: "ignore" });
+  } catch {
+    clearBridgePidFile();
+    return;
+  }
+  try {
+    const pidsOnPort = (0, import_child_process3.execFileSync)("lsof", ["-ti", `:${BRIDGE_PORT}`], { encoding: "utf-8" }).trim();
+    const pidList = pidsOnPort.split("\n").filter(Boolean);
+    if (!pidList.includes(String(pid))) {
+      return;
     }
+    (0, import_child_process3.execFileSync)("kill", ["-9", String(pid)], { stdio: "ignore" });
+    (0, import_child_process3.execFileSync)("sleep", ["1"], { stdio: "ignore" });
   } catch {
+  } finally {
+    clearBridgePidFile();
   }
 }
 function parseBody(req) {
@@ -327009,7 +327037,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 = (0, import_http.createServer)(route);
     server2.on("error", (err) => {
@@ -327025,6 +327053,7 @@ async function startMobileBridge(options) {
       state.port = port;
       state.tunnelToken = tunnelToken;
       state.tunnelUrl = void 0;
+      writeBridgePidFile(process.pid);
       let tunnelUrl;
       if (enableTunnel) {
         try {
@@ -327092,6 +327121,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"));
               }
@@ -327100,6 +327130,7 @@ async function startMobileBridge(options) {
               if (tunnelUrl) {
                 clearTimeout(timeout);
                 if (checkInterval) clearInterval(checkInterval);
+                checkInterval = null;
                 resolve2();
               }
             }, 500);
@@ -327129,6 +327160,7 @@ async function startMobileBridge(options) {
 async function stopMobileBridge() {
   stopAllMirrorClients();
   stopSessionReaper();
+  clearBridgePidFile();
   if (state.appiumSessionId) {
     try {
       validateSessionId(state.appiumSessionId);
@@ -327989,6 +328021,219 @@ async function startMobileNetworkCapture(options) {
   };
 }
 
+// src/services/doctor.ts
+var import_child_process4 = require("child_process");
+var import_fs3 = require("fs");
+var import_os4 = require("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 (0, import_child_process4.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 = (0, import_os4.platform)() === "darwin";
+  results.push(check("macOS", () => ({
+    ok: isMac,
+    detail: isMac ? `${(0, import_os4.platform)()} 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 && (0, import_fs3.existsSync)(androidHome),
+    detail: androidHome ? (0, import_fs3.existsSync)(androidHome) ? androidHome : `${androidHome} (not found)` : "Not set. Set ANDROID_HOME to your Android SDK path."
+  })));
+  if (!androidHome || !(0, import_fs3.existsSync)(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());
@@ -328078,7 +328323,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",
@@ -328088,25 +328333,25 @@ 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 || (0, import_path2.join)((0, import_os3.homedir)(), ".validate.qa", "runs");
-  if (!(0, import_fs2.existsSync)(dir)) (0, import_fs2.mkdirSync)(dir, { recursive: true });
+  const dir = process.env.RUNS_DIR || (0, import_path3.join)((0, import_os5.homedir)(), ".validate.qa", "runs");
+  if (!(0, import_fs4.existsSync)(dir)) (0, import_fs4.mkdirSync)(dir, { recursive: true });
   return dir;
 }
 function authStatePath(projectId) {
-  return (0, import_path2.join)(getRunsDir(), `auth-state-${projectId || "default"}.json`);
+  return (0, import_path3.join)(getRunsDir(), `auth-state-${projectId || "default"}.json`);
 }
 function getValidAuthState(projectId) {
   const path = authStatePath(projectId);
-  if (!(0, import_fs2.existsSync)(path)) return void 0;
-  const age = Date.now() - (0, import_fs2.statSync)(path).mtimeMs;
+  if (!(0, import_fs4.existsSync)(path)) return void 0;
+  const age = Date.now() - (0, import_fs4.statSync)(path).mtimeMs;
   return age < AUTH_MAX_AGE_MS ? path : void 0;
 }
 function buildHeaders(authToken, projectId) {
@@ -329048,9 +329293,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"](
@@ -329589,11 +329834,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.");
           }
@@ -330022,9 +330274,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) {
@@ -330046,20 +330298,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)`);
@@ -330071,8 +330327,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 {
@@ -330133,6 +330389,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) {
@@ -330241,7 +330524,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)();
@@ -330272,7 +330559,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)
       });
@@ -330472,219 +330762,6 @@ async function startRunner(opts) {
   }
 }
 
-// src/services/doctor.ts
-var import_child_process4 = require("child_process");
-var import_fs3 = require("fs");
-var import_os4 = require("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 (0, import_child_process4.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 = (0, import_os4.platform)() === "darwin";
-  results.push(check("macOS", () => ({
-    ok: isMac,
-    detail: isMac ? `${(0, import_os4.platform)()} 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 && (0, import_fs3.existsSync)(androidHome),
-    detail: androidHome ? (0, import_fs3.existsSync)(androidHome) ? androidHome : `${androidHome} (not found)` : "Not set. Set ANDROID_HOME to your Android SDK path."
-  })));
-  if (!androidHome || !(0, import_fs3.existsSync)(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 import_commander.Command();