@validate.qa/runner 1.0.2 → 1.0.4

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) {
@@ -7557,7 +7557,7 @@ Each entry is exactly one of:
       const systemPrompt = context.mode === "survey" ? SURVEY_SYSTEM_PROMPT : exports.SCENARIO_SYSTEM_PROMPT;
       const userPrompt = formatEvidenceForPlanner(compressed, evidence, context);
       logs2.push(`AI planner: ~${Math.ceil(userPrompt.length / 3.5)} input tokens`);
-      const aiClient = options.modelOverride ? (0, ai_provider_js_1.getClientForModel)(options.modelOverride) : (0, ai_provider_js_1.getAIClient)();
+      const aiClient = options.aiClient ?? (options.modelOverride ? (0, ai_provider_js_1.getClientForModel)(options.modelOverride) : (0, ai_provider_js_1.getAIClient)());
       const messages = [
         { role: "system", content: systemPrompt },
         { role: "user", content: userPrompt }
@@ -7769,6 +7769,7 @@ var require_mobile_discovery_prompts = __commonJS({
     exports.formatMobileEvidenceForPlanner = formatMobileEvidenceForPlanner;
     exports.buildMobileSiteMap = buildMobileSiteMap;
     exports.runMobileAIPlanner = runMobileAIPlanner;
+    var ai_provider_js_1 = require_ai_provider();
     var discover_ai_planner_js_1 = require_discover_ai_planner();
     exports.MOBILE_SURVEY_SYSTEM_PROMPT = `You are a feature analyst for a native mobile application (iOS or Android). You receive evidence from an AI explorer that mapped the app's screens by tapping, typing, and swiping through the live UI. Your job is to organize screens into meaningful feature groups.
 
@@ -8168,6 +8169,8 @@ ${constraints.join("\n")}`);
     }
     async function runMobileAIPlanner(input, options = {}) {
       const planner = options.planner ?? discover_ai_planner_js_1.runAIPlanner;
+      const shouldBuildMobileAIClient = (process.env.SERVER_URL ?? "").trim().length > 0 || !options.planner;
+      const aiClient = options.aiClient ?? (shouldBuildMobileAIClient ? options.modelOverride ? (0, ai_provider_js_1.getMobileClientForModel)(options.modelOverride) : (0, ai_provider_js_1.getMobileAIClient)() : void 0);
       const siteMap = buildMobileSiteMap(input.graph, {
         projectId: input.projectId,
         appId: input.appId
@@ -8193,7 +8196,8 @@ ${constraints.join("\n")}`);
         testBudget: input.testBudget
       }, {
         modelOverride: options.modelOverride,
-        onAICall: options.onAICall
+        onAICall: options.onAICall,
+        ...aiClient ? { aiClient } : {}
       });
     }
   }
@@ -21743,7 +21747,7 @@ var require_util = __commonJS({
       return path;
     }
     exports.normalize = normalize;
-    function join4(aRoot, aPath) {
+    function join5(aRoot, aPath) {
       if (aRoot === "") {
         aRoot = ".";
       }
@@ -21775,7 +21779,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 +21952,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 +243107,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 +243158,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 +243626,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 +243779,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 +243797,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 +243820,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 +244801,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 +244815,7 @@ var require_safe_stable_stringify = __commonJS({
                 indentation += spacer;
                 res += `
 ${indentation}`;
-                join4 = `,
+                join5 = `,
 ${indentation}`;
               }
               const maximumValuesToStringify = Math.min(value.length, maximumBreadth);
@@ -244819,13 +244823,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 +244850,7 @@ ${originalIndentation}`;
             let separator = "";
             if (spacer !== "") {
               indentation += spacer;
-              join4 = `,
+              join5 = `,
 ${indentation}`;
               whitespace = " ";
             }
@@ -244860,13 +244864,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 +244911,7 @@ ${originalIndentation}`;
             }
             const originalIndentation = indentation;
             let res = "";
-            let join4 = ",";
+            let join5 = ",";
             if (Array.isArray(value)) {
               if (value.length === 0) {
                 return "[]";
@@ -244920,7 +244924,7 @@ ${originalIndentation}`;
                 indentation += spacer;
                 res += `
 ${indentation}`;
-                join4 = `,
+                join5 = `,
 ${indentation}`;
               }
               const maximumValuesToStringify = Math.min(value.length, maximumBreadth);
@@ -244928,13 +244932,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 +244951,7 @@ ${originalIndentation}`;
             let whitespace = "";
             if (spacer !== "") {
               indentation += spacer;
-              join4 = `,
+              join5 = `,
 ${indentation}`;
               whitespace = " ";
             }
@@ -244956,7 +244960,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 +245018,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 +245047,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 +245067,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 +285430,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 +312628,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 +312646,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 +314265,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 +319679,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 +319695,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 +319706,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 +319732,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 +319768,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 +319785,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 +320190,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 +320199,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 +320267,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 +324805,7 @@ var require_package4 = __commonJS({
   "package.json"(exports, module) {
     module.exports = {
       name: "@validate.qa/runner",
-      version: "1.0.2",
+      version: "1.0.4",
       description: "validate local test runner - execute Playwright tests on your machine, connected to validate.qa cloud.",
       bin: {
         "validate-runner": "dist/cli.js"
@@ -324809,7 +324813,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 +324891,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 +325306,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 +325386,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 +325402,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 +325453,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 +325468,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 +325875,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 +326039,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 +326090,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
@@ -326311,6 +326323,7 @@ var polling = false;
 var sessionStartInFlight = null;
 var sessionReaperTimer = null;
 var mirrorClientsEmptyAt = null;
+var mirrorSessionOwner = null;
 var executorBusy = false;
 var rateLimitBuckets = /* @__PURE__ */ new Map();
 function isRateLimited(clientIp) {
@@ -326366,30 +326379,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) {
@@ -326627,6 +326660,7 @@ async function startSession(validated, res) {
     }
     state.appiumSessionId = null;
     state.platform = null;
+    mirrorSessionOwner = null;
   }
   stopAllMirrorClients();
   const realCaps = isPhysicalDevice(deviceId, targetPlatform) ? realDeviceCapabilities2(targetPlatform) : {};
@@ -326657,11 +326691,14 @@ async function startSession(validated, res) {
       })
     });
     state.appiumSessionId = result?.value?.sessionId ?? result?.sessionId ?? null;
-    state.platform = targetPlatform === "IOS" ? "IOS" : "ANDROID";
     if (!state.appiumSessionId) {
+      state.platform = null;
+      mirrorSessionOwner = null;
       sendJSON(res, 500, { error: "Appium session creation returned no session ID" });
       return;
     }
+    state.platform = targetPlatform === "IOS" ? "IOS" : "ANDROID";
+    mirrorSessionOwner = "recording";
     if (launchMode === "DEEP_LINK" && deeplink) {
       try {
         const args = targetPlatform === "IOS" ? [{ url: deeplink, bundleId: appId }] : [{ url: deeplink, package: appId }];
@@ -326686,6 +326723,7 @@ async function handleSessionStop(_req, res) {
     }
     state.appiumSessionId = null;
     state.platform = null;
+    mirrorSessionOwner = null;
   }
   stopAllMirrorClients();
   stopSessionReaper();
@@ -326766,6 +326804,7 @@ async function pollAndBroadcastFrame() {
         if (!alive) {
           state.appiumSessionId = null;
           state.platform = null;
+          mirrorSessionOwner = null;
           stopAllMirrorClients();
           return;
         }
@@ -326836,6 +326875,7 @@ async function reapIdleSession() {
   const sessionId = state.appiumSessionId;
   state.appiumSessionId = null;
   state.platform = null;
+  mirrorSessionOwner = null;
   mirrorClientsEmptyAt = null;
   stopSessionReaper();
   try {
@@ -327014,7 +327054,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 +327070,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 +327138,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 +327147,7 @@ async function startMobileBridge(options) {
               if (tunnelUrl) {
                 clearTimeout(timeout);
                 if (checkInterval) clearInterval(checkInterval);
+                checkInterval = null;
                 resolve2();
               }
             }, 500);
@@ -327134,6 +327177,7 @@ async function startMobileBridge(options) {
 async function stopMobileBridge() {
   stopAllMirrorClients();
   stopSessionReaper();
+  clearBridgePidFile();
   if (state.appiumSessionId) {
     try {
       validateSessionId(state.appiumSessionId);
@@ -327142,6 +327186,7 @@ async function stopMobileBridge() {
     }
     state.appiumSessionId = null;
     state.platform = null;
+    mirrorSessionOwner = null;
   }
   if (ngrokProcess) {
     try {
@@ -327172,13 +327217,37 @@ function getBridgeState() {
     tunnelUrl: state.tunnelUrl,
     tunnelToken: state.tunnelToken,
     hasActiveSession: !!state.appiumSessionId,
-    recordingActive: !!state.appiumSessionId,
+    recordingActive: !!state.appiumSessionId && mirrorSessionOwner === "recording",
     platform: state.platform
   };
 }
 function setExecutorBusy(busy) {
   executorBusy = busy;
 }
+function attachMirrorSession(sessionId, platform3) {
+  validateSessionId(sessionId);
+  if (state.appiumSessionId && state.appiumSessionId !== sessionId) {
+    stopAllMirrorClients();
+  }
+  state.appiumSessionId = sessionId;
+  state.platform = platform3;
+  mirrorSessionOwner = "runner";
+  mirrorNullTicks = 0;
+  mirrorClientsEmptyAt = null;
+  ensureSessionReaper();
+  if (state.mirrorClients.size > 0) {
+    ensureMirrorPolling();
+    void pollAndBroadcastFrame();
+  }
+}
+function detachMirrorSession(sessionId) {
+  if (sessionId && state.appiumSessionId && state.appiumSessionId !== sessionId) return;
+  state.appiumSessionId = null;
+  state.platform = null;
+  mirrorSessionOwner = null;
+  stopAllMirrorClients();
+  stopSessionReaper();
+}
 
 // src/services/mobile/mobile-bridge-driver.ts
 var import_runner_core7 = __toESM(require_dist2());
@@ -327392,7 +327461,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 +327473,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 +327757,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 +327863,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 +327905,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 +327950,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 +328066,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 +328368,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 +328378,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 +329338,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 +329879,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.");
           }
@@ -329620,6 +329909,7 @@ ${finalVerifyResult.logs ?? ""}`;
               deeplink: mobileTarget.deeplink
             });
             mobileOnLog(`Appium session created: ${session.sessionId} on device ${session.deviceId}`);
+            attachMirrorSession(session.sessionId, platform3);
             const driver = new MobileBridgeDriver({
               sessionId: session.sessionId,
               platform: platform3,
@@ -329660,6 +329950,7 @@ ${finalVerifyResult.logs ?? ""}`;
               }
             }
             if (session) {
+              detachMirrorSession(session.sessionId);
               try {
                 await session.stop();
               } catch {
@@ -330030,9 +330321,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 +330345,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 +330374,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 +330436,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 +330571,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 +330606,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 +330809,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();