agent-qa 0.1.8 → 0.1.10

package/dist/cli.js

@@ -248,7 +248,7 @@ __export(llm_utils_exports, {
   resolveModelAuth: () => resolveModelAuth,
   resolveNamedConfig: () => resolveNamedConfig
 });
-import { dirname as dirname3, resolve as resolvePath2 } from "path";
+import { dirname as dirname4, resolve as resolvePath2 } from "path";
 function normalizeLLMConfig(raw) {
   return {
     name: raw.name,
@@ -266,7 +266,7 @@ async function loadAuthPluginsForRawConfig(raw, configPath = "agent-qa.config.ya
   if (!Array.isArray(declarations) || declarations.length === 0) return;
   const { loadLLMAuthPlugins: loadLLMAuthPlugins2 } = await import("@vostride/agent-qa-core");
   await loadLLMAuthPlugins2(declarations, {
-    baseDir: dirname3(resolvePath2(configPath))
+    baseDir: dirname4(resolvePath2(configPath))
   });
 }
 async function resolveNamedConfig(configName, configPath = "agent-qa.config.yaml") {
@@ -337,7 +337,7 @@ var init_llm_utils = __esm({
 });
 
 // src/cli.ts
-import { Command as Command18 } from "commander";
+import { Command as Command19 } from "commander";
 
 // src/index.ts
 var index_exports = {};
@@ -491,128 +491,19 @@ function createCacheCommand() {
 var VERSION = getAgentQaVersion();
 
 // src/commands/init.ts
-import { Command as Command3 } from "commander";
+init_model_defaults();
+import { Command as Command2 } from "commander";
 import { writeFileSync, mkdirSync, existsSync, readFileSync } from "fs";
-import { join as join3, resolve as resolve2 } from "path";
-import { execSync } from "child_process";
+import { join as join2, resolve as resolve2 } from "path";
 import { stringify } from "yaml";
-import pc4 from "picocolors";
+import pc3 from "picocolors";
 import select from "@inquirer/select";
 import input from "@inquirer/input";
 import checkbox from "@inquirer/checkbox";
-
-// src/commands/install-browsers.ts
-import { spawnSync } from "child_process";
-import { createRequire } from "module";
-import { dirname as dirname2, join as join2 } from "path";
-import { Command as Command2 } from "commander";
-import pc3 from "picocolors";
-function selectedBrowserCount(selection) {
-  return [selection.chromium, selection.firefox, selection.webkit].filter(Boolean).length;
-}
-function validateBrowserInstallSelection(selection) {
-  if (!selection.all && selectedBrowserCount(selection) === 0) {
-    return "Select at least one browser flag: --all, --chromium, --firefox, or --webkit.";
-  }
-  if (selection.all && selectedBrowserCount(selection) > 0) {
-    return "Cannot combine --all with --chromium, --firefox, or --webkit.";
-  }
-  return null;
-}
-function buildBrowserInstallArgs(selection) {
-  const args = [];
-  if (selection.withDeps) args.push("--with-deps");
-  if (selection.force) args.push("--force");
-  if (!selection.all) {
-    if (selection.chromium) args.push("chromium");
-    if (selection.firefox) args.push("firefox");
-    if (selection.webkit) args.push("webkit");
-  }
-  return args;
-}
-function formatInstallBrowsersRetryCommand(selection) {
-  const args = ["agent-qa", "install-browsers"];
-  if (selection.all) {
-    args.push("--all");
-  } else {
-    if (selection.chromium) args.push("--chromium");
-    if (selection.firefox) args.push("--firefox");
-    if (selection.webkit) args.push("--webkit");
-  }
-  if (selection.withDeps) args.push("--with-deps");
-  if (selection.force) args.push("--force");
-  return args.join(" ");
-}
-function resolvePlaywrightCoreCli() {
-  const require2 = createRequire(import.meta.url);
-  const webEntry = require2.resolve("@vostride/agent-qa-web");
-  const webRequire = createRequire(webEntry);
-  const packagePath = webRequire.resolve("playwright-core/package.json");
-  return join2(dirname2(packagePath), "cli.js");
-}
-function normalizeSpawnStatus(result) {
-  if (typeof result.status === "number") return result.status;
-  return 1;
-}
-function runBrowserInstall(selection, deps = {}) {
-  let cliPath;
-  try {
-    cliPath = (deps.resolveCli ?? resolvePlaywrightCoreCli)();
-  } catch (error) {
-    return { ok: false, status: 1, stage: "resolve", error };
-  }
-  const spawn = deps.spawn ?? spawnSync;
-  const result = spawn(process.execPath, [cliPath, "install", ...buildBrowserInstallArgs(selection)], {
-    stdio: "inherit"
-  });
-  if (result.error) {
-    return { ok: false, status: normalizeSpawnStatus(result), stage: "spawn", error: result.error };
-  }
-  const status = normalizeSpawnStatus(result);
-  return { ok: status === 0, status, stage: "installer" };
-}
-function printBrowserInstallFailure(selection, result) {
-  if (result.stage === "resolve") {
-    console.error(pc3.red("agent-qa could not find its bundled browser installer."));
-    console.error(pc3.dim("Reinstall agent-qa dependencies, then retry:"));
-  } else {
-    console.error(pc3.red("Browser installation failed."));
-    console.error(pc3.dim("Retry:"));
-  }
-  console.error(`  ${pc3.cyan(formatInstallBrowsersRetryCommand(selection))}`);
-}
-function createInstallBrowsersCommand(deps = {}) {
-  const cmd = new Command2("install-browsers").description("Install browser support for agent-qa").option("--all", "install all Playwright-managed browsers for agent-qa").option("--chromium", "install Chromium browser support").option("--firefox", "install Firefox browser support").option("--webkit", "install WebKit browser support").option("--with-deps", "also install required system dependencies").option("--force", "force reinstall even if browser support already exists").action((opts) => {
-    const selection = {
-      all: !!opts.all,
-      chromium: !!opts.chromium,
-      firefox: !!opts.firefox,
-      webkit: !!opts.webkit,
-      withDeps: !!opts.withDeps,
-      force: !!opts.force
-    };
-    const validationError = validateBrowserInstallSelection(selection);
-    if (validationError) {
-      console.error(pc3.red(`Error: ${validationError}`));
-      console.error(cmd.helpInformation());
-      process.exitCode = 1;
-      return;
-    }
-    console.log(pc3.blue("Installing agent-qa browser support..."));
-    const result = runBrowserInstall(selection, deps);
-    if (result.ok) {
-      console.log(pc3.green("\u2713 agent-qa browser support installed"));
-      return;
-    }
-    printBrowserInstallFailure(selection, result);
-    process.exitCode = result.status || 1;
-  });
-  return cmd;
-}
-
-// src/commands/init.ts
-init_model_defaults();
-import { DEFAULT_AGENT_QA_CACHE_DIR as DEFAULT_AGENT_QA_CACHE_DIR2, DEFAULT_AGENT_QA_RUNTIME_DIR } from "@vostride/agent-qa-core";
+import {
+  DEFAULT_AGENT_QA_CACHE_DIR as DEFAULT_AGENT_QA_CACHE_DIR2,
+  DEFAULT_AGENT_QA_RUNTIME_DIR
+} from "@vostride/agent-qa-core";
 var INIT_CACHE_DIR = DEFAULT_AGENT_QA_CACHE_DIR2 || ".agent-qa/cache";
 var INIT_RUNTIME_DIR = DEFAULT_AGENT_QA_RUNTIME_DIR || ".agent-qa";
 var SUBSCRIPTION_AUTH_PACKAGE = "@vostride/agent-qa-subscription-auth";
@@ -676,9 +567,6 @@ function normalizePlatformSelection(platform) {
       return { capabilities: ["web", "mobile"], mobileRuntimes: ["ios"] };
   }
 }
-function hasMobile(platform) {
-  return normalizePlatformSelection(platform).mobileRuntimes.length > 0;
-}
 function hasWeb(platform) {
   return normalizePlatformSelection(platform).capabilities.includes("web");
 }
@@ -851,7 +739,7 @@ function configUsesSubscriptionAuth(config) {
   return authPlugins.some((plugin) => objectRecord(plugin)?.package === SUBSCRIPTION_AUTH_PACKAGE);
 }
 function upsertSubscriptionAuthPackageDependency(dir) {
-  const packageJsonPath = join3(dir, PACKAGE_JSON_FILE);
+  const packageJsonPath = join2(dir, PACKAGE_JSON_FILE);
   const created = !existsSync(packageJsonPath);
   const pkg = created ? { private: true } : JSON.parse(readFileSync(packageJsonPath, "utf-8"));
   if (!objectRecord(pkg)) {
@@ -1046,7 +934,7 @@ providers:
 `;
 }
 function appendGitignore(dir) {
-  const gitignorePath = join3(dir, ".gitignore");
+  const gitignorePath = join2(dir, ".gitignore");
   let existing = "";
   if (existsSync(gitignorePath)) {
     existing = readFileSync(gitignorePath, "utf-8");
@@ -1056,135 +944,38 @@ function appendGitignore(dir) {
   const append = (existing.length > 0 && !existing.endsWith("\n") ? "\n" : "") + missing.join("\n") + "\n";
   writeFileSync(gitignorePath, existing + append);
 }
-function installPlaywrightBrowsers(platform) {
-  if (!hasWeb(platform)) return;
-  const selection = { chromium: true };
-  console.log(pc4.blue("Installing agent-qa browser support..."));
-  const result = runBrowserInstall(selection);
-  if (result.ok) {
-    console.log(pc4.green("\u2713 agent-qa browser support installed"));
-  } else {
-    console.log(pc4.yellow(`\u26A0 Browser installation failed. Run \`${formatInstallBrowsersRetryCommand(selection)}\` to retry.`));
-  }
-}
-function collectDriverNames(value, names) {
-  if (!value) return;
-  if (typeof value === "string") {
-    names.add(value);
-    return;
-  }
-  if (Array.isArray(value)) {
-    for (const item of value) collectDriverNames(item, names);
-    return;
-  }
-  if (typeof value !== "object") return;
-  const record = value;
-  if (typeof record.name === "string") names.add(record.name);
-  if (typeof record.driverName === "string") names.add(record.driverName);
-  if (typeof record.automationName === "string") names.add(record.automationName);
-  for (const [key, child] of Object.entries(record)) {
-    if (key !== "drivers" && key !== "installed" && key !== "name" && key !== "driverName" && typeof child === "object" && child !== null) {
-      names.add(key);
-    }
-    collectDriverNames(child, names);
-  }
-}
-function parseInstalledAppiumDrivers(output) {
-  const names = /* @__PURE__ */ new Set();
-  const trimmed = output.trim();
-  if (!trimmed) return names;
-  try {
-    collectDriverNames(JSON.parse(trimmed), names);
-    const normalizedNames = /* @__PURE__ */ new Set();
-    for (const name of names) {
-      const normalized = name.toLowerCase();
-      normalizedNames.add(normalized);
-      if (normalized.includes("uiautomator2")) normalizedNames.add("uiautomator2");
-      if (normalized.includes("xcuitest")) normalizedNames.add("xcuitest");
-    }
-    return normalizedNames;
-  } catch {
-    for (const line of trimmed.split("\n")) {
-      const normalized = line.toLowerCase();
-      if (normalized.includes("uiautomator2")) names.add("uiautomator2");
-      if (normalized.includes("xcuitest")) names.add("xcuitest");
-    }
-    return names;
-  }
-}
-function getInstalledAppiumDrivers() {
-  try {
-    const output = execSync("appium driver list --installed --json", { stdio: "pipe", encoding: "utf-8" });
-    return parseInstalledAppiumDrivers(String(output));
-  } catch {
-    try {
-      const output = execSync("appium driver list --installed", { stdio: "pipe", encoding: "utf-8" });
-      return parseInstalledAppiumDrivers(String(output));
-    } catch {
-      return /* @__PURE__ */ new Set();
-    }
-  }
-}
-function appiumDriverLabel(driver) {
-  return driver === "uiautomator2" ? "UiAutomator2" : "XCUITest";
-}
-function isAlreadyInstalledDriverError(err, driver) {
-  const details = [
-    err instanceof Error ? err.message : String(err),
-    err?.stdout,
-    err?.stderr
-  ].map(String).join("\n").toLowerCase();
-  return details.includes(`driver named "${driver}" is already installed`) || details.includes(`${driver}" is already installed`) || details.includes(`${driver} is already installed`);
-}
-function ensureAppiumDriver(driver, installedDrivers) {
-  const label = appiumDriverLabel(driver);
-  if (installedDrivers.has(driver)) {
-    console.log(pc4.green(`\u2713 ${label} driver already installed`));
-    return;
-  }
-  try {
-    execSync(`appium driver install ${driver}`, { stdio: "inherit" });
-    console.log(pc4.green(`\u2713 ${label} driver installed`));
-  } catch (err) {
-    if (isAlreadyInstalledDriverError(err, driver)) {
-      console.log(pc4.green(`\u2713 ${label} driver already installed`));
-      return;
-    }
-    console.log(pc4.yellow(`\u26A0 ${label} driver installation failed. Run \`appium driver install ${driver}\` manually.`));
-  }
-}
-function installAppium(platform) {
-  if (!hasMobile(platform)) return;
-  const selection = normalizePlatformSelection(platform);
-  console.log(pc4.blue("Installing Appium..."));
-  let appiumInstalled = false;
-  try {
-    execSync("appium --version", { stdio: "pipe" });
-    appiumInstalled = true;
-    console.log(pc4.green("\u2713 Appium already installed"));
-  } catch {
-    try {
-      execSync("npm install -g appium", { stdio: "inherit" });
-      console.log(pc4.green("\u2713 Appium installed"));
-      appiumInstalled = true;
-    } catch {
-      console.log(pc4.yellow("\u26A0 Appium installation failed. Run `npm install -g appium` manually."));
-    }
-  }
-  if (!appiumInstalled) return;
-  const installedDrivers = getInstalledAppiumDrivers();
-  if (selection.mobileRuntimes.includes("android")) {
-    ensureAppiumDriver("uiautomator2", installedDrivers);
-  }
-  if (selection.mobileRuntimes.includes("ios")) {
-    ensureAppiumDriver("xcuitest", installedDrivers);
-  }
+function browserSetupCommand(platform) {
+  return hasWeb(platform) ? "agent-qa install-browsers --chromium" : null;
+}
+function mobileDriverSetupCommand(platform) {
+  const runtimes = normalizePlatformSelection(platform).mobileRuntimes;
+  if (runtimes.length === 0) return null;
+  if (runtimes.includes("android") && runtimes.includes("ios")) return "agent-qa install-mobile-drivers --all";
+  if (runtimes.includes("android")) return "agent-qa install-mobile-drivers --android";
+  return "agent-qa install-mobile-drivers --ios";
+}
+function initNextSteps(platform) {
+  const steps = [];
+  const browserCommand = browserSetupCommand(platform);
+  const mobileCommand = mobileDriverSetupCommand(platform);
+  if (browserCommand) {
+    steps.push({ command: browserCommand, description: "Install browser support" });
+  }
+  if (mobileCommand) {
+    steps.push({ command: mobileCommand, description: "Install mobile driver support" });
+  }
+  steps.push(
+    { command: "agent-qa doctor", description: "Verify your environment" },
+    { command: "Edit tests/example-pass.yaml", description: "Write your first test" },
+    { command: "agent-qa run", description: "Run all tests" },
+    { command: "agent-qa dashboard", description: "View results in browser" }
+  );
+  return steps;
 }
 function createInitCommand() {
-  const cmd = new Command3("init").description("Initialize a new agent-qa project").option("--dir <path>", "target directory", process.cwd()).option("--platform <type>", "platform to configure (web, android, ios, web+android, web+ios)").option("--skip-install", "skip auto-installation of browsers/Appium").option("--force", "overwrite existing files").action(async (opts) => {
+  const cmd = new Command2("init").description("Initialize a new agent-qa project").option("--dir <path>", "target directory", process.cwd()).option("--platform <type>", "platform to configure (web, android, ios, web+android, web+ios)").option("--skip-install", "deprecated no-op; setup commands are shown after init").option("--force", "overwrite existing files").action(async (opts) => {
     const dir = resolve2(opts.dir);
     const force = opts.force ?? false;
-    const skipInstall = opts.skipInstall ?? false;
     const isInteractive = !opts.platform;
     let platform;
     let provider = "anthropic-subscription";
@@ -1212,7 +1003,7 @@ function createInitCommand() {
       }) : [];
       platform = { capabilities, mobileRuntimes };
       const llmSetup = await checkbox({
-        message: `Subscription auth ${pc4.dim("(optional)")}`,
+        message: `Subscription auth ${pc3.dim("(optional)")}`,
         choices: LLM_SETUP_CHOICES,
         required: true,
         validate: (value) => {
@@ -1247,12 +1038,12 @@ function createInitCommand() {
       provider = "anthropic-subscription";
       model = DEFAULT_ANTHROPIC_MODEL;
     }
-    const configPath = join3(dir, "agent-qa.config.yaml");
+    const configPath = join2(dir, "agent-qa.config.yaml");
     if (existsSync(configPath) && !force) {
-      console.log(pc4.yellow(`Config file already exists at ${configPath}. Use --force to overwrite.`));
+      console.log(pc3.yellow(`Config file already exists at ${configPath}. Use --force to overwrite.`));
       return;
     }
-    const testsDir = join3(dir, "tests");
+    const testsDir = join2(dir, "tests");
     if (!existsSync(testsDir)) {
       mkdirSync(testsDir, { recursive: true });
     }
@@ -1261,119 +1052,111 @@ function createInitCommand() {
     const yamlStr = stringify(config);
     const configContent = addYamlComments(yamlStr);
     writeFileSync(configPath, configContent);
-    console.log(pc4.green(`\u2713 Created ${configPath}`));
+    console.log(pc3.green(`\u2713 Created ${configPath}`));
     const subscriptionAuthDependency = usesSubscriptionAuth ? upsertSubscriptionAuthPackageDependency(dir) : null;
     if (subscriptionAuthDependency) {
       const action = subscriptionAuthDependency.created ? "Created" : "Updated";
-      console.log(pc4.green(`\u2713 ${action} ${subscriptionAuthDependency.path}`));
+      console.log(pc3.green(`\u2713 ${action} ${subscriptionAuthDependency.path}`));
     }
-    const secretsPath = join3(dir, DEFAULT_SECRETS_FILE);
+    const secretsPath = join2(dir, DEFAULT_SECRETS_FILE);
     if (force || !existsSync(secretsPath)) {
       writeFileSync(secretsPath, "");
-      console.log(pc4.green(`\u2713 Created ${secretsPath}`));
+      console.log(pc3.green(`\u2713 Created ${secretsPath}`));
     }
-    const envPath = join3(dir, DEFAULT_ENV_FILE);
+    const envPath = join2(dir, DEFAULT_ENV_FILE);
     if (force || !existsSync(envPath)) {
       writeFileSync(envPath, "");
-      console.log(pc4.green(`\u2713 Created ${envPath}`));
+      console.log(pc3.green(`\u2713 Created ${envPath}`));
     }
-    const hooksPath = join3(dir, DEFAULT_HOOKS_FILE);
+    const hooksPath = join2(dir, DEFAULT_HOOKS_FILE);
     if (force || !existsSync(hooksPath)) {
       writeFileSync(hooksPath, buildHooksFile(platform));
-      console.log(pc4.green(`\u2713 Created ${hooksPath}`));
+      console.log(pc3.green(`\u2713 Created ${hooksPath}`));
     }
-    const agentRulesPath = join3(dir, DEFAULT_AGENT_RULES_FILE);
+    const agentRulesPath = join2(dir, DEFAULT_AGENT_RULES_FILE);
     if (force || !existsSync(agentRulesPath)) {
       writeFileSync(agentRulesPath, "# agent-qa Rules\n");
-      console.log(pc4.green(`\u2713 Created ${agentRulesPath}`));
+      console.log(pc3.green(`\u2713 Created ${agentRulesPath}`));
     }
-    const localConfigPath = join3(dir, DEFAULT_LOCAL_CONFIG_FILE);
+    const localConfigPath = join2(dir, DEFAULT_LOCAL_CONFIG_FILE);
     if (force || !existsSync(localConfigPath)) {
       writeFileSync(localConfigPath, buildLocalConfigTemplate());
-      console.log(pc4.green(`\u2713 Created ${localConfigPath}`));
+      console.log(pc3.green(`\u2713 Created ${localConfigPath}`));
     }
-    const examplePassPath = join3(testsDir, "example-pass.yaml");
+    const examplePassPath = join2(testsDir, "example-pass.yaml");
     writeFileSync(examplePassPath, buildExampleTest(platform, "pass"));
-    console.log(pc4.green(`\u2713 Created ${examplePassPath}`));
-    const exampleFailPath = join3(testsDir, "example-fail.yaml");
+    console.log(pc3.green(`\u2713 Created ${examplePassPath}`));
+    const exampleFailPath = join2(testsDir, "example-fail.yaml");
     writeFileSync(exampleFailPath, buildExampleTest(platform, "fail"));
-    console.log(pc4.green(`\u2713 Created ${exampleFailPath}`));
+    console.log(pc3.green(`\u2713 Created ${exampleFailPath}`));
     if (hasWeb(platform)) {
-      const suitesDir = join3(dir, "suites");
+      const suitesDir = join2(dir, "suites");
       if (!existsSync(suitesDir)) {
         mkdirSync(suitesDir, { recursive: true });
       }
-      const scriptsDir = join3(dir, "scripts");
+      const scriptsDir = join2(dir, "scripts");
       if (!existsSync(scriptsDir)) {
         mkdirSync(scriptsDir, { recursive: true });
       }
-      const automationTestsDir = join3(testsDir, "automation-exercise");
+      const automationTestsDir = join2(testsDir, "automation-exercise");
       if (!existsSync(automationTestsDir)) {
         mkdirSync(automationTestsDir, { recursive: true });
       }
       for (const test of AUTOMATION_EXERCISE_TESTS) {
-        const testPath = join3(automationTestsDir, test.fileName);
+        const testPath = join2(automationTestsDir, test.fileName);
         writeFileSync(testPath, buildAutomationExerciseTest(test));
-        console.log(pc4.green(`\u2713 Created ${testPath}`));
+        console.log(pc3.green(`\u2713 Created ${testPath}`));
       }
-      const automationSuitePath = join3(suitesDir, "automation-exercise.suite.yaml");
+      const automationSuitePath = join2(suitesDir, "automation-exercise.suite.yaml");
       writeFileSync(automationSuitePath, buildAutomationExerciseSuite());
-      console.log(pc4.green(`\u2713 Created ${automationSuitePath}`));
-      const hnScriptPath = join3(scriptsDir, "fetch-hn-top-story.mjs");
+      console.log(pc3.green(`\u2713 Created ${automationSuitePath}`));
+      const hnScriptPath = join2(scriptsDir, "fetch-hn-top-story.mjs");
       writeFileSync(hnScriptPath, buildHackerNewsHookScript());
-      console.log(pc4.green(`\u2713 Created ${hnScriptPath}`));
-      const hnTestPath = join3(testsDir, "hacker-news-top-story.yaml");
+      console.log(pc3.green(`\u2713 Created ${hnScriptPath}`));
+      const hnTestPath = join2(testsDir, "hacker-news-top-story.yaml");
       writeFileSync(hnTestPath, buildHackerNewsTopStoryTest());
-      console.log(pc4.green(`\u2713 Created ${hnTestPath}`));
+      console.log(pc3.green(`\u2713 Created ${hnTestPath}`));
     }
     appendGitignore(dir);
-    console.log(pc4.green("\u2713 Updated .gitignore"));
-    if (!skipInstall) {
-      installPlaywrightBrowsers(platform);
-      installAppium(platform);
-    }
+    console.log(pc3.green("\u2713 Updated .gitignore"));
     console.log("");
-    console.log(pc4.green(pc4.bold("\u2713 agent-qa project initialized!")));
+    console.log(pc3.green(pc3.bold("\u2713 agent-qa project initialized!")));
     console.log("");
     console.log("  Created:");
-    console.log(`    ${pc4.dim("\u2022")} agent-qa.config.yaml`);
+    console.log(`    ${pc3.dim("\u2022")} agent-qa.config.yaml`);
     if (subscriptionAuthDependency) {
-      console.log(`    ${pc4.dim("\u2022")} ${PACKAGE_JSON_FILE} dependency for ${SUBSCRIPTION_AUTH_PACKAGE}@${subscriptionAuthDependency.range}`);
-    }
-    console.log(`    ${pc4.dim("\u2022")} ${DEFAULT_HOOKS_FILE}`);
-    console.log(`    ${pc4.dim("\u2022")} ${DEFAULT_AGENT_RULES_FILE}`);
-    console.log(`    ${pc4.dim("\u2022")} ${DEFAULT_ENV_FILE}`);
-    console.log(`    ${pc4.dim("\u2022")} ${DEFAULT_SECRETS_FILE}`);
-    console.log(`    ${pc4.dim("\u2022")} ${DEFAULT_LOCAL_CONFIG_FILE}`);
-    console.log(`    ${pc4.dim("\u2022")} tests/example-pass.yaml`);
-    console.log(`    ${pc4.dim("\u2022")} tests/example-fail.yaml`);
+      console.log(`    ${pc3.dim("\u2022")} ${PACKAGE_JSON_FILE} dependency for ${SUBSCRIPTION_AUTH_PACKAGE}@${subscriptionAuthDependency.range}`);
+    }
+    console.log(`    ${pc3.dim("\u2022")} ${DEFAULT_HOOKS_FILE}`);
+    console.log(`    ${pc3.dim("\u2022")} ${DEFAULT_AGENT_RULES_FILE}`);
+    console.log(`    ${pc3.dim("\u2022")} ${DEFAULT_ENV_FILE}`);
+    console.log(`    ${pc3.dim("\u2022")} ${DEFAULT_SECRETS_FILE}`);
+    console.log(`    ${pc3.dim("\u2022")} ${DEFAULT_LOCAL_CONFIG_FILE}`);
+    console.log(`    ${pc3.dim("\u2022")} tests/example-pass.yaml`);
+    console.log(`    ${pc3.dim("\u2022")} tests/example-fail.yaml`);
     if (hasWeb(platform)) {
-      console.log(`    ${pc4.dim("\u2022")} tests/automation-exercise/*.yaml`);
-      console.log(`    ${pc4.dim("\u2022")} tests/hacker-news-top-story.yaml`);
-      console.log(`    ${pc4.dim("\u2022")} suites/automation-exercise.suite.yaml`);
-      console.log(`    ${pc4.dim("\u2022")} scripts/fetch-hn-top-story.mjs`);
+      console.log(`    ${pc3.dim("\u2022")} tests/automation-exercise/*.yaml`);
+      console.log(`    ${pc3.dim("\u2022")} tests/hacker-news-top-story.yaml`);
+      console.log(`    ${pc3.dim("\u2022")} suites/automation-exercise.suite.yaml`);
+      console.log(`    ${pc3.dim("\u2022")} scripts/fetch-hn-top-story.mjs`);
     }
-    console.log(`    ${pc4.dim("\u2022")} .gitignore entries`);
+    console.log(`    ${pc3.dim("\u2022")} .gitignore entries`);
     console.log("");
     console.log("  Next steps:");
-    console.log(`    1. ${pc4.cyan("agent-qa doctor")}      Verify your environment`);
-    console.log(`    2. Edit ${pc4.cyan("tests/example-pass.yaml")} with your first test`);
-    console.log(`    3. ${pc4.cyan("agent-qa run")}         Run all tests`);
-    console.log(`    4. ${pc4.cyan("agent-qa dashboard")}   View results in browser`);
-    if (skipInstall && hasWeb(platform)) {
-      console.log(`    ${pc4.dim("\u2022")} Install browser support with ${pc4.cyan("agent-qa install-browsers --chromium")}`);
+    for (const [index, step] of initNextSteps(platform).entries()) {
+      console.log(`    ${index + 1}. ${pc3.cyan(step.command)}  ${step.description}`);
     }
     const generatedLLMs = config.registry?.llms ?? [];
     const subscriptionLLMs = generatedLLMs.filter((llm) => isSubscriptionProvider(String(llm.provider)));
     if (subscriptionLLMs.length === 0) {
-      console.log(`    ${pc4.dim("\u2022")} Save credentials with ${pc4.cyan("agent-qa auth set --config default --type api-key")}`);
+      console.log(`    ${pc3.dim("\u2022")} Save credentials with ${pc3.cyan("agent-qa auth set --config default --type api-key")}`);
       if (provider === "anthropic-compatible") {
-        console.log(`    ${pc4.dim("\u2022")} Bearer tokens use ${pc4.cyan("agent-qa auth set --config default --type bearer-token")}`);
+        console.log(`    ${pc3.dim("\u2022")} Bearer tokens use ${pc3.cyan("agent-qa auth set --config default --type bearer-token")}`);
       }
     } else {
-      console.log(`    ${pc4.dim("\u2022")} Fetch ${SUBSCRIPTION_AUTH_PACKAGE} with your package manager install command`);
+      console.log(`    ${pc3.dim("\u2022")} Fetch ${SUBSCRIPTION_AUTH_PACKAGE} with your package manager install command`);
       for (const llm of subscriptionLLMs) {
-        console.log(`    ${pc4.dim("\u2022")} Authenticate ${pc4.cyan(String(llm.name))} from ${pc4.cyan("agent-qa dashboard")}`);
+        console.log(`    ${pc3.dim("\u2022")} Authenticate ${pc3.cyan(String(llm.name))} from ${pc3.cyan("agent-qa dashboard")}`);
       }
     }
     console.log("");
@@ -1381,16 +1164,369 @@ function createInitCommand() {
   return cmd;
 }
 
+// src/commands/install-browsers.ts
+import { spawnSync } from "child_process";
+import { createRequire } from "module";
+import { dirname as dirname2, join as join3 } from "path";
+import { Command as Command3 } from "commander";
+import pc4 from "picocolors";
+function selectedBrowserCount(selection) {
+  return [selection.chromium, selection.firefox, selection.webkit].filter(Boolean).length;
+}
+function validateBrowserInstallSelection(selection) {
+  if (!selection.all && selectedBrowserCount(selection) === 0) {
+    return "Select at least one browser flag: --all, --chromium, --firefox, or --webkit.";
+  }
+  if (selection.all && selectedBrowserCount(selection) > 0) {
+    return "Cannot combine --all with --chromium, --firefox, or --webkit.";
+  }
+  return null;
+}
+function buildBrowserInstallArgs(selection) {
+  const args = [];
+  if (selection.withDeps) args.push("--with-deps");
+  if (selection.force) args.push("--force");
+  if (!selection.all) {
+    if (selection.chromium) args.push("chromium");
+    if (selection.firefox) args.push("firefox");
+    if (selection.webkit) args.push("webkit");
+  }
+  return args;
+}
+function formatInstallBrowsersRetryCommand(selection) {
+  const args = ["agent-qa", "install-browsers"];
+  if (selection.all) {
+    args.push("--all");
+  } else {
+    if (selection.chromium) args.push("--chromium");
+    if (selection.firefox) args.push("--firefox");
+    if (selection.webkit) args.push("--webkit");
+  }
+  if (selection.withDeps) args.push("--with-deps");
+  if (selection.force) args.push("--force");
+  return args.join(" ");
+}
+function resolvePlaywrightCoreCli() {
+  const require2 = createRequire(import.meta.url);
+  const webEntry = require2.resolve("@vostride/agent-qa-web");
+  const webRequire = createRequire(webEntry);
+  const packagePath = webRequire.resolve("playwright-core/package.json");
+  return join3(dirname2(packagePath), "cli.js");
+}
+function normalizeSpawnStatus(result) {
+  if (typeof result.status === "number") return result.status;
+  return 1;
+}
+function runBrowserInstall(selection, deps = {}) {
+  let cliPath;
+  try {
+    cliPath = (deps.resolveCli ?? resolvePlaywrightCoreCli)();
+  } catch (error) {
+    return { ok: false, status: 1, stage: "resolve", error };
+  }
+  const spawn = deps.spawn ?? spawnSync;
+  const result = spawn(process.execPath, [cliPath, "install", ...buildBrowserInstallArgs(selection)], {
+    stdio: "inherit"
+  });
+  if (result.error) {
+    return { ok: false, status: normalizeSpawnStatus(result), stage: "spawn", error: result.error };
+  }
+  const status = normalizeSpawnStatus(result);
+  return { ok: status === 0, status, stage: "installer" };
+}
+function printBrowserInstallFailure(selection, result) {
+  if (result.stage === "resolve") {
+    console.error(pc4.red("agent-qa could not find its bundled browser installer."));
+    console.error(pc4.dim("Reinstall agent-qa dependencies, then retry:"));
+  } else {
+    console.error(pc4.red("Browser installation failed."));
+    console.error(pc4.dim("Retry:"));
+  }
+  console.error(`  ${pc4.cyan(formatInstallBrowsersRetryCommand(selection))}`);
+}
+function createInstallBrowsersCommand(deps = {}) {
+  const cmd = new Command3("install-browsers").description("Install browser support for agent-qa").option("--all", "install all Playwright-managed browsers for agent-qa").option("--chromium", "install Chromium browser support").option("--firefox", "install Firefox browser support").option("--webkit", "install WebKit browser support").option("--with-deps", "also install required system dependencies").option("--force", "force reinstall even if browser support already exists").action((opts) => {
+    const selection = {
+      all: !!opts.all,
+      chromium: !!opts.chromium,
+      firefox: !!opts.firefox,
+      webkit: !!opts.webkit,
+      withDeps: !!opts.withDeps,
+      force: !!opts.force
+    };
+    const validationError = validateBrowserInstallSelection(selection);
+    if (validationError) {
+      console.error(pc4.red(`Error: ${validationError}`));
+      console.error(cmd.helpInformation());
+      process.exitCode = 1;
+      return;
+    }
+    console.log(pc4.blue("Installing agent-qa browser support..."));
+    const result = runBrowserInstall(selection, deps);
+    if (result.ok) {
+      console.log(pc4.green("\u2713 agent-qa browser support installed"));
+      return;
+    }
+    printBrowserInstallFailure(selection, result);
+    process.exitCode = result.status || 1;
+  });
+  return cmd;
+}
+
+// src/commands/install-mobile-drivers.ts
+import { execFileSync } from "child_process";
+import { dirname as dirname3, resolve as resolve3 } from "path";
+import { Command as Command4 } from "commander";
+import pc5 from "picocolors";
+import {
+  formatAppiumInstallGuidance,
+  resolveAppiumExecutable
+} from "@vostride/agent-qa-core";
+var MOBILE_DRIVERS = [
+  { target: "android", driver: "uiautomator2", label: "UiAutomator2" },
+  { target: "ios", driver: "xcuitest", label: "XCUITest" }
+];
+function selectedTargetCount(selection) {
+  return [selection.android, selection.ios].filter(Boolean).length;
+}
+function selectedDrivers(selection) {
+  if (selection.all) return MOBILE_DRIVERS;
+  return MOBILE_DRIVERS.filter((driver) => selection[driver.target]);
+}
+function validateMobileDriverInstallSelection(selection) {
+  if (!selection.all && selectedTargetCount(selection) === 0) {
+    return "Select at least one mobile platform flag: --all, --android, or --ios.";
+  }
+  if (selection.all && selectedTargetCount(selection) > 0) {
+    return "Cannot combine --all with --android or --ios.";
+  }
+  if (selection.unsafe && !selection.update) {
+    return "Cannot use --unsafe without --update.";
+  }
+  return null;
+}
+function formatInstallMobileDriversRetryCommand(selection) {
+  const args = ["agent-qa", "install-mobile-drivers"];
+  if (selection.all) {
+    args.push("--all");
+  } else {
+    if (selection.android) args.push("--android");
+    if (selection.ios) args.push("--ios");
+  }
+  if (selection.update) args.push("--update");
+  if (selection.unsafe) args.push("--unsafe");
+  return args.join(" ");
+}
+function collectDriverNames(value, names) {
+  if (!value) return;
+  if (typeof value === "string") {
+    names.add(value);
+    return;
+  }
+  if (Array.isArray(value)) {
+    for (const item of value) collectDriverNames(item, names);
+    return;
+  }
+  if (typeof value !== "object") return;
+  const record = value;
+  if (typeof record.name === "string") names.add(record.name);
+  if (typeof record.driverName === "string") names.add(record.driverName);
+  if (typeof record.automationName === "string") names.add(record.automationName);
+  for (const [key, child] of Object.entries(record)) {
+    if (key !== "drivers" && key !== "installed" && key !== "name" && key !== "driverName" && typeof child === "object" && child !== null) {
+      names.add(key);
+    }
+    collectDriverNames(child, names);
+  }
+}
+function parseInstalledAppiumDrivers(output) {
+  const names = /* @__PURE__ */ new Set();
+  const trimmed = output.trim();
+  if (!trimmed) return names;
+  try {
+    collectDriverNames(JSON.parse(trimmed), names);
+    const normalizedNames = /* @__PURE__ */ new Set();
+    for (const name of names) {
+      const normalized = name.toLowerCase();
+      normalizedNames.add(normalized);
+      if (normalized.includes("uiautomator2")) normalizedNames.add("uiautomator2");
+      if (normalized.includes("xcuitest")) normalizedNames.add("xcuitest");
+    }
+    return normalizedNames;
+  } catch {
+    for (const line of trimmed.split("\n")) {
+      const normalized = line.toLowerCase();
+      if (normalized.includes("uiautomator2")) names.add("uiautomator2");
+      if (normalized.includes("xcuitest")) names.add("xcuitest");
+    }
+    return names;
+  }
+}
+function errorStatus(error) {
+  const status = error?.status;
+  return typeof status === "number" ? status : 1;
+}
+function isMissingExecutableError(error) {
+  return error?.code === "ENOENT";
+}
+function isAlreadyInstalledDriverError(error, driver) {
+  const details = [
+    error instanceof Error ? error.message : String(error),
+    error?.stdout,
+    error?.stderr
+  ].map(String).join("\n").toLowerCase();
+  return details.includes(`driver named "${driver}" is already installed`) || details.includes(`${driver}" is already installed`) || details.includes(`${driver} is already installed`);
+}
+function getInstalledAppiumDrivers(appiumCommand, execFile) {
+  try {
+    const output = execFile(appiumCommand, ["driver", "list", "--installed", "--json"], { stdio: "pipe", encoding: "utf-8" });
+    return { ok: true, drivers: parseInstalledAppiumDrivers(String(output)) };
+  } catch {
+    try {
+      const output = execFile(appiumCommand, ["driver", "list", "--installed"], { stdio: "pipe", encoding: "utf-8" });
+      return { ok: true, drivers: parseInstalledAppiumDrivers(String(output)) };
+    } catch (error) {
+      return { ok: false, error, status: errorStatus(error) };
+    }
+  }
+}
+function driverOperationArgs(driver, selection, installed) {
+  if (installed && !selection.update) {
+    return { action: "reuse", args: null };
+  }
+  if (installed && selection.update) {
+    const args = ["driver", "update", driver];
+    if (selection.unsafe) args.push("--unsafe");
+    return { action: "update", args };
+  }
+  return { action: "install", args: ["driver", "install", driver] };
+}
+function runMobileDriverInstall(selection, deps = {}) {
+  const resolveAppium = deps.resolveAppium ?? resolveAppiumExecutable;
+  const execFile = deps.execFile ?? execFileSync;
+  const events = [];
+  let appium;
+  try {
+    appium = resolveAppium({ cwd: selection.cwd ?? process.cwd() });
+  } catch (error) {
+    return { ok: false, status: 1, stage: "resolve", events, error };
+  }
+  try {
+    execFile(appium.command, ["--version"], { stdio: "pipe" });
+  } catch (error) {
+    return { ok: false, status: errorStatus(error), stage: "check", appium, events, error };
+  }
+  const installedResult = getInstalledAppiumDrivers(appium.command, execFile);
+  if (!installedResult.ok) {
+    return { ok: false, status: installedResult.status, stage: "list", appium, events, error: installedResult.error };
+  }
+  let status = 0;
+  for (const definition of selectedDrivers(selection)) {
+    const installed = installedResult.drivers.has(definition.driver);
+    const operation = driverOperationArgs(definition.driver, selection, installed);
+    if (!operation.args) {
+      events.push({ driver: definition.driver, label: definition.label, action: operation.action, ok: true });
+      continue;
+    }
+    try {
+      execFile(appium.command, operation.args, { stdio: "inherit" });
+      events.push({ driver: definition.driver, label: definition.label, action: operation.action, ok: true });
+    } catch (error) {
+      if (operation.action === "install" && isAlreadyInstalledDriverError(error, definition.driver)) {
+        events.push({ driver: definition.driver, label: definition.label, action: "reuse", ok: true });
+        continue;
+      }
+      status = status || errorStatus(error);
+      events.push({ driver: definition.driver, label: definition.label, action: operation.action, ok: false, error });
+    }
+  }
+  return { ok: status === 0, status, stage: "driver", appium, events };
+}
+function resolveCommandCwd(command) {
+  const configPath = command.parent?.opts().config ?? "agent-qa.config.yaml";
+  return dirname3(resolve3(configPath));
+}
+function printMobileDriverInstallResult(selection, result) {
+  if (result.stage === "check" && isMissingExecutableError(result.error)) {
+    console.error(pc5.red("Appium not found."));
+    console.error(pc5.dim(formatAppiumInstallGuidance()));
+    return;
+  }
+  if (result.stage === "resolve") {
+    console.error(pc5.red("agent-qa could not resolve an Appium executable."));
+    console.error(pc5.dim(formatAppiumInstallGuidance()));
+    return;
+  }
+  if (result.stage === "check") {
+    console.error(pc5.red("Could not run Appium."));
+    console.error(pc5.dim(formatAppiumInstallGuidance()));
+    return;
+  }
+  if (result.stage === "list") {
+    console.error(pc5.red("Could not inspect installed Appium drivers."));
+    console.error(pc5.dim("Retry:"));
+    console.error(`  ${pc5.cyan(formatInstallMobileDriversRetryCommand(selection))}`);
+    return;
+  }
+  for (const event of result.events) {
+    if (event.ok && event.action === "reuse") {
+      console.log(pc5.green(`\u2713 ${event.label} driver already installed`));
+    } else if (event.ok && event.action === "install") {
+      console.log(pc5.green(`\u2713 ${event.label} driver installed`));
+    } else if (event.ok && event.action === "update") {
+      console.log(pc5.green(`\u2713 ${event.label} driver updated`));
+    } else {
+      const action = event.action === "update" ? "update" : "installation";
+      console.error(pc5.red(`\u2717 ${event.label} driver ${action} failed`));
+    }
+  }
+  if (!result.ok) {
+    console.error(pc5.dim("Retry:"));
+    console.error(`  ${pc5.cyan(formatInstallMobileDriversRetryCommand(selection))}`);
+    return;
+  }
+  console.log(pc5.green("\u2713 agent-qa mobile driver support ready"));
+}
+function createInstallMobileDriversCommand(deps = {}) {
+  const cmd = new Command4("install-mobile-drivers").description("Install Appium mobile drivers for agent-qa").option("--all", "install Android and iOS Appium drivers").option("--android", "install the UiAutomator2 Appium driver").option("--ios", "install the XCUITest Appium driver").option("--update", "update selected drivers when they are already installed").option("--unsafe", "allow Appium driver updates across major versions; requires --update").action((opts) => {
+    const selection = {
+      all: !!opts.all,
+      android: !!opts.android,
+      ios: !!opts.ios,
+      update: !!opts.update,
+      unsafe: !!opts.unsafe,
+      cwd: resolveCommandCwd(cmd)
+    };
+    const validationError = validateMobileDriverInstallSelection(selection);
+    if (validationError) {
+      console.error(pc5.red(`Error: ${validationError}`));
+      console.error(cmd.helpInformation());
+      process.exitCode = 1;
+      return;
+    }
+    console.log(pc5.blue("Installing agent-qa mobile driver support..."));
+    const result = runMobileDriverInstall(selection, deps);
+    printMobileDriverInstallResult(selection, result);
+    if (!result.ok) {
+      process.exitCode = result.status || 1;
+    }
+  });
+  return cmd;
+}
+
 // src/commands/doctor.ts
 init_config();
 init_llm_utils();
 init_model_defaults();
-import { Command as Command4 } from "commander";
-import { execSync as execSync2 } from "child_process";
+import { Command as Command5 } from "commander";
+import { execFileSync as execFileSync2, execSync } from "child_process";
 import { existsSync as existsSync2 } from "fs";
-import pc5 from "picocolors";
+import { dirname as dirname5, resolve as resolve4 } from "path";
+import pc6 from "picocolors";
 import {
   discoverWorkspaceFiles,
+  formatAppiumInstallGuidance as formatAppiumInstallGuidance2,
+  resolveAppiumExecutable as resolveAppiumExecutable2,
   resolveWorkspacePaths
 } from "@vostride/agent-qa-core";
 function resolveDoctorWorkspace(config, configPath) {
@@ -1451,20 +1587,20 @@ function applyResolvedAuth(llm, auth) {
 function formatStatus(status) {
   switch (status) {
     case "pass":
-      return pc5.green("PASS");
+      return pc6.green("PASS");
     case "warn":
-      return pc5.yellow("WARN");
+      return pc6.yellow("WARN");
     case "fail":
-      return pc5.red("FAIL");
+      return pc6.red("FAIL");
     case "skip":
-      return pc5.dim("SKIP");
+      return pc6.dim("SKIP");
   }
 }
 function padDots(name, message) {
   const totalWidth = 60;
   const used = name.length + message.length;
   const dots = Math.max(2, totalWidth - used);
-  return pc5.dim(".".repeat(dots));
+  return pc6.dim(".".repeat(dots));
 }
 function checkNodeVersion() {
   return {
@@ -1694,7 +1830,7 @@ function checkLLMConnection(config) {
 function checkPlaywright(config) {
   return {
     name: "Playwright",
-    fixInstructions: "Run `agent-qa install-browsers --chromium` or `agent-qa init`",
+    fixInstructions: "Run `agent-qa install-browsers --chromium`",
     check: async () => {
       const browsers = config?.browsers;
       const hasBrowsers = browsers && browsers.length > 0;
@@ -1702,7 +1838,7 @@ function checkPlaywright(config) {
         return { status: "skip", message: "not configured" };
       }
       try {
-        execSync2("npx playwright --version", { stdio: "pipe" });
+        execSync("npx playwright --version", { stdio: "pipe" });
         return { status: "pass", message: "installed" };
       } catch {
         return { status: "fail", message: "not installed" };
@@ -1710,16 +1846,28 @@ function checkPlaywright(config) {
     }
   };
 }
-function checkAppium(config) {
+function appiumResolverCwd(configPath) {
+  return dirname5(resolve4(configPath));
+}
+function mobileDriverInstallCommand(config) {
+  const hasAndroid = hasAndroidPlatform(config);
+  const hasIOS = hasIOSPlatform(config);
+  if (hasAndroid && hasIOS) return "agent-qa install-mobile-drivers --all";
+  if (hasAndroid) return "agent-qa install-mobile-drivers --android";
+  if (hasIOS) return "agent-qa install-mobile-drivers --ios";
+  return "agent-qa install-mobile-drivers --all";
+}
+function checkAppium(config, configPath) {
   return {
     name: "Appium",
-    fixInstructions: "Run `npm install -g appium`",
+    fixInstructions: `${formatAppiumInstallGuidance2()} Then run \`${mobileDriverInstallCommand(config)}\`.`,
     check: async () => {
       if (!isMobilePlatform(config)) {
         return { status: "skip", message: "not configured" };
       }
       try {
-        const version = execSync2("appium --version", { stdio: "pipe" }).toString().trim();
+        const appium = resolveAppiumExecutable2({ cwd: appiumResolverCwd(configPath) });
+        const version = execFileSync2(appium.command, ["--version"], { stdio: "pipe" }).toString().trim();
         return { status: "pass", message: `v${version}` };
       } catch {
         return { status: "fail", message: "not installed" };
@@ -1727,16 +1875,17 @@ function checkAppium(config) {
     }
   };
 }
-function checkAppiumDrivers(config) {
+function checkAppiumDrivers(config, configPath) {
   return {
     name: "Appium drivers",
-    fixInstructions: "Run `appium driver install uiautomator2` or `appium driver install xcuitest`",
+    fixInstructions: `Run \`${mobileDriverInstallCommand(config)}\``,
     check: async () => {
       if (!isMobilePlatform(config)) {
         return { status: "skip", message: "not configured" };
       }
       try {
-        const output = execSync2("appium driver list --installed", { stdio: "pipe" }).toString();
+        const appium = resolveAppiumExecutable2({ cwd: appiumResolverCwd(configPath) });
+        const output = execFileSync2(appium.command, ["driver", "list", "--installed"], { stdio: "pipe" }).toString();
         const hasDrivers = output.includes("uiautomator2") || output.includes("xcuitest");
         if (hasDrivers) {
           return { status: "pass", message: "drivers installed" };
@@ -1780,7 +1929,7 @@ function checkXcode(config) {
         return { status: "fail", message: "iOS testing requires macOS" };
       }
       try {
-        execSync2("xcrun simctl list", { stdio: "pipe" });
+        execSync("xcrun simctl list", { stdio: "pipe" });
         return { status: "pass", message: "simctl available" };
       } catch {
         return { status: "fail", message: "simctl not available" };
@@ -1872,7 +2021,7 @@ function getGlobalConfigPath(command) {
   return command.parent?.opts().config ?? "agent-qa.config.yaml";
 }
 function createDoctorCommand() {
-  const cmd = new Command4("doctor").description("Validate environment and dependencies").action(async function() {
+  const cmd = new Command5("doctor").description("Validate environment and dependencies").action(async function() {
     const configPath = getGlobalConfigPath(this);
     let config = null;
     try {
@@ -1894,15 +2043,15 @@ function createDoctorCommand() {
       checkSubscriptionAuth(config),
       checkLLMConnection(config),
       checkPlaywright(config),
-      checkAppium(config),
-      checkAppiumDrivers(config),
+      checkAppium(config, configPath),
+      checkAppiumDrivers(config, configPath),
       checkAndroidSDK(config),
       checkXcode(config),
       checkTestDiscovery(config, configPath),
       checkValidation(config, configPath)
     ];
     console.log("");
-    console.log(pc5.bold("  agent-qa doctor"));
+    console.log(pc6.bold("  agent-qa doctor"));
     console.log("");
     let hasFailure = false;
     const results = [];
@@ -1913,16 +2062,16 @@ function createDoctorCommand() {
       const status = formatStatus(result.status);
       console.log(`    ${check.name}  ${dots}  ${result.message}  ${status}`);
       if (result.status === "fail") {
-        console.log(pc5.dim(`      Fix: ${check.fixInstructions}`));
+        console.log(pc6.dim(`      Fix: ${check.fixInstructions}`));
         hasFailure = true;
       }
     }
     console.log("");
     if (hasFailure) {
-      console.log(pc5.red("  Some checks failed. See fix instructions above."));
+      console.log(pc6.red("  Some checks failed. See fix instructions above."));
       process.exitCode = 1;
     } else {
-      console.log(pc5.green("  All checks passed! Your environment is ready."));
+      console.log(pc6.green("  All checks passed! Your environment is ready."));
     }
     console.log("");
   });
@@ -1933,8 +2082,8 @@ function createDoctorCommand() {
 init_config();
 import { randomUUID } from "crypto";
 import { resolve as resolvePath3 } from "path";
-import { Command as Command5 } from "commander";
-import pc6 from "picocolors";
+import { Command as Command6 } from "commander";
+import pc7 from "picocolors";
 import { ATTR_RUNNER, ATTR_TRIGGER, buildInternalRunAttributes, DEFAULT_AGENT_QA_ARTIFACTS_DIR, DEFAULT_AGENT_QA_CACHE_DIR as DEFAULT_AGENT_QA_CACHE_DIR3, DEFAULT_AGENT_QA_VIDEOS_DIR, formatRunAttributesBlock, generateRunId, mergeRunAttributes, MobileSetupError, parseRunAttrFlags, resolveMemoryRoot, resolveMobileRunConfig, validateTrustedRunAttributes } from "@vostride/agent-qa-core";
 import { discoverWorkspaceFiles as discoverWorkspaceFiles2, isWorkspacePathMatch, resolveWorkspaceFileTarget, resolveWorkspacePaths as resolveWorkspacePaths2 } from "@vostride/agent-qa-core";
 
@@ -2277,14 +2426,14 @@ async function captureSingleAnalyticsResult(reporter, result) {
 function formatParseErrors(errors) {
   for (const err of errors) {
     const location = `${err.file}:${err.line}:${err.column}`;
-    const severity = err.severity === "error" ? pc6.red("error") : pc6.yellow("warning");
+    const severity = err.severity === "error" ? pc7.red("error") : pc7.yellow("warning");
     console.error(`${severity}: ${err.message}`);
-    console.error(`  ${pc6.blue("-->")} ${location}`);
+    console.error(`  ${pc7.blue("-->")} ${location}`);
     if (err.source) {
-      console.error(`  ${pc6.blue("|")} ${err.source}`);
+      console.error(`  ${pc7.blue("|")} ${err.source}`);
     }
     if (err.suggestion) {
-      console.error(`  ${pc6.blue("=")} ${pc6.bold("help")}: ${err.suggestion}`);
+      console.error(`  ${pc7.blue("=")} ${pc7.bold("help")}: ${err.suggestion}`);
     }
     console.error();
   }
@@ -2300,14 +2449,14 @@ function printRunId(runId) {
 }
 function printMemoryStatus(log) {
   const parts = [];
-  if (log.added > 0) parts.push(pc6.green(`${log.added} added`));
+  if (log.added > 0) parts.push(pc7.green(`${log.added} added`));
   if (log.confirmed > 0) parts.push(`${log.confirmed} confirmed`);
-  if (log.deprecated > 0) parts.push(pc6.yellow(`${log.deprecated} deprecated`));
+  if (log.deprecated > 0) parts.push(pc7.yellow(`${log.deprecated} deprecated`));
   if (parts.length === 0) parts.push("no changes");
   const secs = log.curatorDuration >= 1e3 ? `${Math.round(log.curatorDuration / 1e3)}s` : `${log.curatorDuration}ms`;
-  console.log(`  ${pc6.dim("Memory:")} ${parts.join(", ")} ${pc6.dim(`(${secs})`)}`);
+  console.log(`  ${pc7.dim("Memory:")} ${parts.join(", ")} ${pc7.dim(`(${secs})`)}`);
   for (const err of log.errors) {
-    console.log(`  ${pc6.dim("Memory:")} ${pc6.yellow(`warning -- ${err}`)}`);
+    console.log(`  ${pc7.dim("Memory:")} ${pc7.yellow(`warning -- ${err}`)}`);
   }
 }
 function isGlobLikePattern(value) {
@@ -2379,21 +2528,21 @@ function buildHooksArtifact(hooks) {
 async function loadRuntimeSecrets(input3) {
   const configuredSecretsFile = input3.config.workspace?.secretsFile;
   if (typeof configuredSecretsFile !== "string" || configuredSecretsFile.trim().length === 0) {
-    console.error(pc6.red("Error: workspace.secretsFile is required. Run `agent-qa init` or set it in agent-qa.config.yaml."));
+    console.error(pc7.red("Error: workspace.secretsFile is required. Run `agent-qa init` or set it in agent-qa.config.yaml."));
     process.exit(1);
   }
   const secretsPath = input3.secretsFilePath ?? resolvePath3(input3.configDir, configuredSecretsFile);
   if (!input3.existsSync(secretsPath)) {
-    console.error(pc6.red(`Error: Secrets file not found: ${secretsPath}`));
-    console.error(pc6.dim("Create the file before running tests. It may be empty, but it must exist."));
+    console.error(pc7.red(`Error: Secrets file not found: ${secretsPath}`));
+    console.error(pc7.dim("Create the file before running tests. It may be empty, but it must exist."));
     process.exit(1);
   }
   let secretsContent;
   try {
     secretsContent = input3.readFileSync(secretsPath, "utf-8");
   } catch {
-    console.error(pc6.red(`Error: Secrets file could not be read: ${secretsPath}`));
-    console.error(pc6.dim("Check the path and file permissions before running tests."));
+    console.error(pc7.red(`Error: Secrets file could not be read: ${secretsPath}`));
+    console.error(pc7.dim("Check the path and file permissions before running tests."));
     process.exit(1);
   }
   try {
@@ -2410,7 +2559,7 @@ async function loadRuntimeSecrets(input3) {
     };
   } catch (err) {
     const message = err instanceof Error ? err.message : String(err);
-    console.error(pc6.red(`Error: Secrets file is invalid: ${message}`));
+    console.error(pc7.red(`Error: Secrets file is invalid: ${message}`));
     process.exit(1);
   }
 }
@@ -2573,7 +2722,7 @@ async function executeSuites(suiteFiles, opts, config, globalOpts, configContent
   const dashboardCfg = config.services?.dashboard;
   const reporterSelectionResult = resolveReporterSelection(opts, Boolean(dashboardCfg));
   if (reporterSelectionResult.error) {
-    console.error(pc6.red(`Error: ${reporterSelectionResult.error}`));
+    console.error(pc7.red(`Error: ${reporterSelectionResult.error}`));
     process.exit(2);
   }
   const reporterSelection = reporterSelectionResult.selection;
@@ -2589,7 +2738,7 @@ async function executeSuites(suiteFiles, opts, config, globalOpts, configContent
       activeSuiteDbs.add(dashboardDb);
       return { dashboardDb, logStorage: dashboardDb };
     } catch (err) {
-      console.warn(pc6.yellow(`Warning: Could not load dashboard reporter: ${err instanceof Error ? err.message : String(err)}`));
+      console.warn(pc7.yellow(`Warning: Could not load dashboard reporter: ${err instanceof Error ? err.message : String(err)}`));
       return {};
     }
   };
@@ -2631,7 +2780,7 @@ async function executeSuites(suiteFiles, opts, config, globalOpts, configContent
     const suiteMembers = [];
     for (const { test: relativePath, id: suiteEntryId } of suite.tests) {
       if (!isPathInsideDir(relativePath, configDir)) {
-        console.error(pc6.red(`Path traversal rejected: ${relativePath}`));
+        console.error(pc7.red(`Path traversal rejected: ${relativePath}`));
         const runId = createSuiteRunId();
         if (dashboardDb) {
           const now = (/* @__PURE__ */ new Date()).toISOString();
@@ -2669,7 +2818,7 @@ async function executeSuites(suiteFiles, opts, config, globalOpts, configContent
       const fileContent = await readFile5(absolutePath, "utf-8");
       const parseResult = parseTestFile2(fileContent, absolutePath);
       if (parseResult.errors.length > 0) {
-        console.error(pc6.red(`Parse errors in ${relativePath}:`));
+        console.error(pc7.red(`Parse errors in ${relativePath}:`));
         formatParseErrors(parseResult.errors);
         const runId = createSuiteRunId();
         if (dashboardDb) {
@@ -2711,7 +2860,7 @@ async function executeSuites(suiteFiles, opts, config, globalOpts, configContent
         process.exit(2);
       }
       if (parseResult.tests.length === 0) {
-        console.error(pc6.red(`No test definition found in ${relativePath}`));
+        console.error(pc7.red(`No test definition found in ${relativePath}`));
         const runId = createSuiteRunId();
         if (dashboardDb) {
           const now = (/* @__PURE__ */ new Date()).toISOString();
@@ -2748,7 +2897,7 @@ async function executeSuites(suiteFiles, opts, config, globalOpts, configContent
       const testDef = parseResult.tests[0];
       if (testDef["test-id"] && testDef["test-id"] !== suiteEntryId) {
         const mismatchMsg = `ID mismatch in suite "${suite.name}": test file ${relativePath} has test-id "${testDef["test-id"]}" but suite entry specifies id "${suiteEntryId}"`;
-        console.error(pc6.red(mismatchMsg));
+        console.error(pc7.red(mismatchMsg));
         const runId = createSuiteRunId();
         if (dashboardDb) {
           const now = (/* @__PURE__ */ new Date()).toISOString();
@@ -2949,11 +3098,11 @@ async function executeSuites(suiteFiles, opts, config, globalOpts, configContent
     if (reporterSelection.dashboard && dashboardDb) {
       try {
         const { DashboardReporter } = await import("@vostride/agent-qa-dashboard");
-        const { resolve: resolve7 } = await import("path");
+        const { resolve: resolve9 } = await import("path");
         const dashArtifactsDir = config.services?.dashboard?.artifactsDir ?? RUNTIME_ARTIFACTS_DIR;
         reporters.push(new DashboardReporter({
           db: dashboardDb,
-          artifactsDir: resolve7(configDir, dashArtifactsDir),
+          artifactsDir: resolve9(configDir, dashArtifactsDir),
           redactor: variableContext?.secretRedactor,
           onRunCreated: (runId) => {
             lastSuiteRunId = runId;
@@ -2968,9 +3117,9 @@ async function executeSuites(suiteFiles, opts, config, globalOpts, configContent
     let actionCache;
     if (opts.cache !== false) {
       const { FileActionCache } = await import("@vostride/agent-qa-core");
-      const { resolve: resolve7 } = await import("path");
+      const { resolve: resolve9 } = await import("path");
       actionCache = new FileActionCache({
-        dir: resolve7(configDir, config.services?.cache?.dir ?? RUNTIME_CACHE_DIR),
+        dir: resolve9(configDir, config.services?.cache?.dir ?? RUNTIME_CACHE_DIR),
         ttl: config.services?.cache?.ttl ?? "7d",
         logger: logger.createScopedLogger("cache")
       });
@@ -2992,7 +3141,7 @@ async function executeSuites(suiteFiles, opts, config, globalOpts, configContent
           curatorLockTimeout: suiteMemoryConfig?.curatorLockTimeout
         });
       } catch (err) {
-        console.warn(`  ${pc6.dim("Memory:")} init error -- ${err.message}`);
+        console.warn(`  ${pc7.dim("Memory:")} init error -- ${err.message}`);
       }
       if (suiteMemoryConfig?.circuitBreakerEnabled !== false) {
         const { CircuitBreaker } = await import("@vostride/agent-qa-core");
@@ -3131,19 +3280,19 @@ async function executeSuites(suiteFiles, opts, config, globalOpts, configContent
     const batchOutcome = await flushSuiteParents();
     if (batchOutcome.cancelled || shutdownRequested) break;
     if (opts.bail && batchOutcome.failed) {
-      console.log(pc6.yellow("\nBailing out \u2014 stopping after first failed suite"));
+      console.log(pc7.yellow("\nBailing out \u2014 stopping after first failed suite"));
       break;
     }
     const outcome = await runOneSuiteFile(suiteFile, suite);
     if (outcome.cancelled || shutdownRequested) break;
     if (opts.bail && outcome.failed) {
-      console.log(pc6.yellow("\nBailing out \u2014 stopping after first failed suite"));
+      console.log(pc7.yellow("\nBailing out \u2014 stopping after first failed suite"));
       break;
     }
   }
   const finalBatchOutcome = await flushSuiteParents();
   if (opts.bail && finalBatchOutcome.failed) {
-    console.log(pc6.yellow("\nBailing out \u2014 stopping after first failed suite"));
+    console.log(pc7.yellow("\nBailing out \u2014 stopping after first failed suite"));
   }
   process.removeListener("SIGINT", handleShutdown);
   process.removeListener("SIGTERM", handleShutdown);
@@ -3151,12 +3300,12 @@ async function executeSuites(suiteFiles, opts, config, globalOpts, configContent
   return suiteResults.some((r) => r.status === "failed" || r.status === "cancelled") || shutdownRequested;
 }
 function createRunCommand() {
-  const cmd = new Command5("run").description("Run test files").argument("[patterns...]", "glob patterns for test files").option("--browser <name>", "override browser (chromium, firefox, webkit)").option("--platform <name>", "filter by platform (web, android, ios)").option("--headless", "run in headless mode").option("--no-headless", "run in headed mode").option("--no-cache", "bypass action cache for this run").option("--no-memory", "disable runtime memory injection for this run").option("--bail", "stop on first test failure").option("--dry-run", "parse and list tests without executing").option("--list-tests", "list discovered test files without executing").option("--junit-output <path>", "path for JUnit XML output").option("--screenshot-dir <dir>", "directory for failure screenshots").option("--screenshot-mode <mode>", "when to capture: failure (default) or every-step").option("--reporter <names...>", "select reporters (default: console)").option("--record", "enable session video recording").option("--config-debug", "print resolved config with source attribution for each test").option("--test", "discover and run tests via testMatch patterns (default when no flags)").option("--suite", "discover and run suites via suiteMatch patterns").option("--all", "discover and run both tests (testMatch) and suites (suiteMatch)").option("--device <name>", "Override the mobile test/suite device for this run").option("--var <kv...>", "set variable KEY=VALUE (repeatable)").option("--run-attr <kv...>", "attach run attribute KEY=VALUE; repeatable").action(async (patterns, opts, command) => {
+  const cmd = new Command6("run").description("Run test files").argument("[patterns...]", "glob patterns for test files").option("--browser <name>", "override browser (chromium, firefox, webkit)").option("--platform <name>", "filter by platform (web, android, ios)").option("--headless", "run in headless mode").option("--no-headless", "run in headed mode").option("--no-cache", "bypass action cache for this run").option("--no-memory", "disable runtime memory injection for this run").option("--bail", "stop on first test failure").option("--dry-run", "parse and list tests without executing").option("--list-tests", "list discovered test files without executing").option("--junit-output <path>", "path for JUnit XML output").option("--screenshot-dir <dir>", "directory for failure screenshots").option("--screenshot-mode <mode>", "when to capture: failure (default) or every-step").option("--reporter <names...>", "select reporters (default: console)").option("--record", "enable session video recording").option("--config-debug", "print resolved config with source attribution for each test").option("--test", "discover and run tests via testMatch patterns (default when no flags)").option("--suite", "discover and run suites via suiteMatch patterns").option("--all", "discover and run both tests (testMatch) and suites (suiteMatch)").option("--device <name>", "Override the mobile test/suite device for this run").option("--var <kv...>", "set variable KEY=VALUE (repeatable)").option("--run-attr <kv...>", "attach run attribute KEY=VALUE; repeatable").action(async (patterns, opts, command) => {
     let _crashDb;
     try {
       const modeFlags = [opts.test, opts.suite, opts.all].filter(Boolean).length;
       if (modeFlags > 1) {
-        console.error(pc6.red("Error: --test, --suite, and --all are mutually exclusive."));
+        console.error(pc7.red("Error: --test, --suite, and --all are mutually exclusive."));
         process.exit(1);
       }
       const program2 = command.parent;
@@ -3197,7 +3346,7 @@ function createRunCommand() {
           console.warn(`Warning: duplicate --run-attr key "${duplicateKey}"; using last value`);
         }
       } catch (err) {
-        console.error(pc6.red(`Error: ${err instanceof Error ? err.message : String(err)}`));
+        console.error(pc7.red(`Error: ${err instanceof Error ? err.message : String(err)}`));
         process.exit(2);
       }
       const inlineVars = {};
@@ -3213,29 +3362,29 @@ function createRunCommand() {
       let resolvedEnvFilePath = null;
       resolvedEnvFilePath = workspacePaths.envFile.absolutePath;
       if (!existsSync8(workspacePaths.envFile.absolutePath)) {
-        console.error(pc6.red(`Error: Env file not found: ${workspacePaths.envFile.absolutePath}`));
+        console.error(pc7.red(`Error: Env file not found: ${workspacePaths.envFile.absolutePath}`));
         process.exit(1);
       }
       try {
         rawEnvFileContent = readFileSync5(workspacePaths.envFile.absolutePath, "utf-8");
         envFileVars = parseEnvFile(rawEnvFileContent);
       } catch {
-        console.error(pc6.red(`Error: Env file could not be read: ${workspacePaths.envFile.absolutePath}`));
+        console.error(pc7.red(`Error: Env file could not be read: ${workspacePaths.envFile.absolutePath}`));
         process.exit(1);
       }
       let resolvedHooks;
       let sandboxOptions;
       const hooksFilePath = workspacePaths.hooksFile.absolutePath;
       if (!existsSync8(hooksFilePath)) {
-        console.error(pc6.red(`Error: Hooks file not found: ${hooksFilePath}`));
+        console.error(pc7.red(`Error: Hooks file not found: ${hooksFilePath}`));
         process.exit(1);
       }
       try {
         const { parseHooksFile } = await import("@vostride/agent-qa-core");
         const { hooks, errors } = await parseHooksFile(hooksFilePath);
         if (errors.length > 0) {
-          console.error(pc6.red("Hooks configuration errors:"));
-          for (const err of errors) console.error(pc6.red(`  - ${err}`));
+          console.error(pc7.red("Hooks configuration errors:"));
+          for (const err of errors) console.error(pc7.red(`  - ${err}`));
           process.exit(1);
         }
         resolvedHooks = new Map(hooks.map((h) => [h.id, h]));
@@ -3244,8 +3393,8 @@ function createRunCommand() {
           secretRedactor: runtimeSecrets.secretRedactor
         };
       } catch (err) {
-        console.error(pc6.red(`Error: Hooks file could not be read: ${hooksFilePath}`));
-        if (err instanceof Error && err.message) console.error(pc6.dim(err.message));
+        console.error(pc7.red(`Error: Hooks file could not be read: ${hooksFilePath}`));
+        if (err instanceof Error && err.message) console.error(pc7.dim(err.message));
         process.exit(1);
       }
       let agentRulesContent;
@@ -3253,7 +3402,7 @@ function createRunCommand() {
       try {
         agentRulesContent = await readFileAsync(workspacePaths.agentRules.absolutePath, "utf-8");
       } catch {
-        console.error(pc6.red(`Error: Agent rules file not found: ${workspacePaths.agentRules.absolutePath}`));
+        console.error(pc7.red(`Error: Agent rules file not found: ${workspacePaths.agentRules.absolutePath}`));
         process.exit(1);
       }
       const effectiveLogLevel = globalOpts.logLevel ?? (globalOpts.verbose ? "debug" : void 0) ?? (globalOpts.quiet ? "silent" : void 0) ?? config.services?.logging?.level ?? "warn";
@@ -3265,21 +3414,21 @@ function createRunCommand() {
           discoveredTestFiles = selected.tests;
           discoveredSuiteFiles = selected.suites;
         } catch (err) {
-          console.error(pc6.red(`Error: ${err instanceof Error ? err.message : String(err)}`));
+          console.error(pc7.red(`Error: ${err instanceof Error ? err.message : String(err)}`));
           process.exit(1);
         }
         if (discoveredTestFiles.length === 0 && discoveredSuiteFiles.length === 0) {
           const patternKind = patterns.every((pattern) => classifyRunPattern(pattern) === "suite") ? "suite" : "test";
-          console.error(pc6.red(`Error: No ${patternKind} files found matching patterns:`));
-          for (const p of patterns) console.error(pc6.red(`  ${p}`));
+          console.error(pc7.red(`Error: No ${patternKind} files found matching patterns:`));
+          for (const p of patterns) console.error(pc7.red(`  ${p}`));
           process.exit(2);
         }
       } else if (opts.suite) {
         discoveredSuiteFiles = (await discoverWorkspaceFiles2({ workspace: workspacePaths, kind: "suite" })).map((record) => record.absolutePath);
         if (discoveredSuiteFiles.length === 0) {
-          console.error(pc6.red("Error: No suite files found matching workspace.suiteMatch"));
+          console.error(pc7.red("Error: No suite files found matching workspace.suiteMatch"));
           for (const p of workspacePaths.suiteMatch) {
-            console.error(pc6.red(`  ${p}`));
+            console.error(pc7.red(`  ${p}`));
           }
           process.exit(2);
         }
@@ -3287,19 +3436,19 @@ function createRunCommand() {
         discoveredTestFiles = (await discoverWorkspaceFiles2({ workspace: workspacePaths, kind: "test" })).map((record) => record.absolutePath);
         discoveredSuiteFiles = (await discoverWorkspaceFiles2({ workspace: workspacePaths, kind: "suite" })).map((record) => record.absolutePath);
         if (discoveredTestFiles.length === 0 && discoveredSuiteFiles.length === 0) {
-          console.error(pc6.red("Error: No test or suite files found. Check workspace.testMatch and workspace.suiteMatch in agent-qa.config.yaml"));
+          console.error(pc7.red("Error: No test or suite files found. Check workspace.testMatch and workspace.suiteMatch in agent-qa.config.yaml"));
           process.exit(2);
         }
       } else {
         if (!workspacePaths.testMatch || workspacePaths.testMatch.length === 0) {
-          console.error(pc6.red("Error: No testMatch patterns in config. Add workspace.testMatch to agent-qa.config.yaml."));
+          console.error(pc7.red("Error: No testMatch patterns in config. Add workspace.testMatch to agent-qa.config.yaml."));
           process.exit(2);
         }
         discoveredTestFiles = (await discoverWorkspaceFiles2({ workspace: workspacePaths, kind: "test" })).map((record) => record.absolutePath);
         if (discoveredTestFiles.length === 0) {
-          console.error(pc6.red("Error: No test files found matching workspace.testMatch"));
+          console.error(pc7.red("Error: No test files found matching workspace.testMatch"));
           for (const p of workspacePaths.testMatch) {
-            console.error(pc6.red(`  ${p}`));
+            console.error(pc7.red(`  ${p}`));
           }
           process.exit(2);
         }
@@ -3314,7 +3463,7 @@ function createRunCommand() {
       }
       const files = discoveredTestFiles;
       if (opts.listTests) {
-        console.log(pc6.bold(`
+        console.log(pc7.bold(`
 Discovered ${files.length} test file(s):
 `));
         for (const file of files) {
@@ -3326,7 +3475,7 @@ Discovered ${files.length} test file(s):
       const dashboardCfg2 = config.services?.dashboard;
       const reporterSelectionResult = resolveReporterSelection(opts, Boolean(dashboardCfg2));
       if (reporterSelectionResult.error) {
-        console.error(pc6.red(`Error: ${reporterSelectionResult.error}`));
+        console.error(pc7.red(`Error: ${reporterSelectionResult.error}`));
         process.exit(2);
       }
       const reporterSelection = reporterSelectionResult.selection;
@@ -3343,13 +3492,13 @@ Discovered ${files.length} test file(s):
           logStorage = dashboardDb;
           _crashDb = dashboardDb;
         } catch (err) {
-          console.warn(pc6.yellow(`Warning: Could not load dashboard reporter: ${err instanceof Error ? err.message : String(err)}`));
+          console.warn(pc7.yellow(`Warning: Could not load dashboard reporter: ${err instanceof Error ? err.message : String(err)}`));
         }
       }
       const { parseAllTests, formatParseError } = await import("@vostride/agent-qa-core");
       const parseResult = await parseAllTests(files);
       if (parseResult.errors.length > 0) {
-        console.error(pc6.red(`Found ${parseResult.errors.length} parse error(s):
+        console.error(pc7.red(`Found ${parseResult.errors.length} parse error(s):
 `));
         for (const err of parseResult.errors) {
           console.error(formatParseError(err));
@@ -3445,17 +3594,17 @@ Discovered ${files.length} test file(s):
       }
       const filtered = parseResult.tests;
       if (filtered.length === 0) {
-        console.log(pc6.yellow("No tests match filters"));
+        console.log(pc7.yellow("No tests match filters"));
         process.exit(0);
       }
       if (opts.dryRun) {
-        console.log(pc6.bold(`
+        console.log(pc7.bold(`
 Found ${filtered.length} test(s):
 `));
         for (const test of filtered) {
-          console.log(`  ${pc6.green("\u25CF")} ${test.name}`);
+          console.log(`  ${pc7.green("\u25CF")} ${test.name}`);
           if (opts.configDebug) {
-            console.log(pc6.bold(`
+            console.log(pc7.bold(`
   Config for: ${test.name}`));
             console.log(formatConfigDebug(config, test.use, flagOverrides));
             console.log();
@@ -3493,11 +3642,11 @@ Found ${filtered.length} test(s):
       if (reporterSelection.dashboard && dashboardDb) {
         try {
           const { DashboardReporter } = await import("@vostride/agent-qa-dashboard");
-          const { resolve: resolve7 } = await import("path");
+          const { resolve: resolve9 } = await import("path");
           const dashArtifactsDir = config.services?.dashboard?.artifactsDir ?? RUNTIME_ARTIFACTS_DIR;
           reporters.push(new DashboardReporter({
             db: dashboardDb,
-            artifactsDir: resolve7(configDir, dashArtifactsDir),
+            artifactsDir: resolve9(configDir, dashArtifactsDir),
             redactor: runtimeSecrets.secretRedactor,
             onRunCreated: (runId) => {
               currentRunId = runId;
@@ -3505,7 +3654,7 @@ Found ${filtered.length} test(s):
             }
           }));
         } catch (err) {
-          console.warn(pc6.yellow(`Warning: Could not load dashboard reporter: ${err instanceof Error ? err.message : String(err)}`));
+          console.warn(pc7.yellow(`Warning: Could not load dashboard reporter: ${err instanceof Error ? err.message : String(err)}`));
         }
       }
       const analyticsReporter = createAnalyticsRunReporter({ config, surface: "cli" });
@@ -3519,9 +3668,9 @@ Found ${filtered.length} test(s):
       });
       if (opts.cache !== false) {
         const { FileActionCache } = await import("@vostride/agent-qa-core");
-        const { resolve: resolve7 } = await import("path");
+        const { resolve: resolve9 } = await import("path");
         actionCache = new FileActionCache({
-          dir: resolve7(configDir, config.services?.cache?.dir ?? RUNTIME_CACHE_DIR),
+          dir: resolve9(configDir, config.services?.cache?.dir ?? RUNTIME_CACHE_DIR),
           ttl: config.services?.cache?.ttl ?? "7d",
           logger: logger.createScopedLogger("cache")
         });
@@ -3599,7 +3748,7 @@ Found ${filtered.length} test(s):
             const testMergedConfig = { ...config, use: mergedUse };
             const effectiveCacheEnabled = opts.cache !== false && mergedUse.cache !== false;
             if (opts.configDebug) {
-              console.log(pc6.bold(`
+              console.log(pc7.bold(`
 Config for: ${test.name}`));
               console.log(formatConfigDebug(config, test.use, testFlagOverrides));
               console.log();
@@ -3709,7 +3858,7 @@ Config for: ${test.name}`));
                 });
               }
               if (effectiveLogLevel === "debug") {
-                console.log(pc6.dim(`  Platform: ${testPlatform}${useFarm ? ` (farm: ${testResolvedDevice?.transport})` : ""}${testPlatform !== "web" ? " (adapter re-created)" : ""}`));
+                console.log(pc7.dim(`  Platform: ${testPlatform}${useFarm ? ` (farm: ${testResolvedDevice?.transport})` : ""}${testPlatform !== "web" ? " (adapter re-created)" : ""}`));
               }
             }
             const mergedForLLM = { registry: config.registry, use: testMergedConfig.use ?? config.use };
@@ -3720,7 +3869,7 @@ Config for: ${test.name}`));
             process.env.AGENT_QA_LLM_MODEL = plannerCfg.model;
             process.env.AGENT_QA_LLM_PROVIDER = plannerCfg.provider;
             if (effectiveLogLevel === "debug") {
-              console.log(pc6.dim(`  Model: ${plannerCfg.model} (${plannerCfg.provider})`));
+              console.log(pc7.dim(`  Model: ${plannerCfg.model} (${plannerCfg.provider})`));
             }
             const plannerModel = await createModel(plannerModelConfig);
             const verifierModel = await createModel(verifierModelConfig);
@@ -3885,7 +4034,7 @@ Config for: ${test.name}`));
                 const testId = testDef["test-id"] ?? testDef.name;
                 memoryInitParams = { product, testId, memoryRoot };
               } catch (err) {
-                console.warn(`  ${pc6.dim("Memory:")} init error -- ${err.message}`);
+                console.warn(`  ${pc7.dim("Memory:")} init error -- ${err.message}`);
               }
             }
             const result = await runTestWithRetry(testDef, {
@@ -3979,7 +4128,7 @@ Config for: ${test.name}`));
               try {
                 const { shouldAblate, collectAllInjectedIds, deprecateOnFailure } = await import("@vostride/agent-qa-core");
                 if (shouldAblate(result, memoryProvider)) {
-                  console.log(`  ${pc6.dim("Memory:")} ablation retry -- re-running without memory...`);
+                  console.log(`  ${pc7.dim("Memory:")} ablation retry -- re-running without memory...`);
                   const ablationAdapter = await createPlatformAdapter(testPlatform);
                   const mergedBrowser = mergedUse.browser;
                   const ablationPlatformConfig = buildPlatformConfig(testPlatform, testResolvedDevice, testTimeoutsForSetup, mergedBrowser ?? config.use?.browser, testMergedConfig.use?.logCapture ?? config.use?.logCapture, testFarmSession, testMobileResolved);
@@ -4024,7 +4173,7 @@ Config for: ${test.name}`));
                       circuitBreaker.record({ withMemory: false, passed: ablationResult.status === "passed" });
                     }
                     if (ablationResult.status === "passed") {
-                      console.log(`  ${pc6.dim("Memory:")} ablation confirmed memory caused failure -- penalizing observations`);
+                      console.log(`  ${pc7.dim("Memory:")} ablation confirmed memory caused failure -- penalizing observations`);
                       const injectedMap = collectAllInjectedIds(result, memoryProvider);
                       await deprecateOnFailure({
                         testResult: result,
@@ -4035,14 +4184,14 @@ Config for: ${test.name}`));
                       });
                       ablationHandledDeprecation = true;
                     } else {
-                      console.log(`  ${pc6.dim("Memory:")} ablation retry also failed -- memory not the cause`);
+                      console.log(`  ${pc7.dim("Memory:")} ablation retry also failed -- memory not the cause`);
                     }
                   } finally {
                     await ablationAdapter.cleanup();
                   }
                 }
               } catch (err) {
-                console.warn(`  ${pc6.dim("Memory:")} ablation error -- ${err.message}`);
+                console.warn(`  ${pc7.dim("Memory:")} ablation error -- ${err.message}`);
               }
             }
             if (memoryProvider && memoryConfig?.curatorEnabled !== false && !ablationHandledDeprecation) {
@@ -4076,7 +4225,7 @@ Config for: ${test.name}`));
                   }
                 }
               } catch (err) {
-                console.warn(`  ${pc6.dim("Memory:")} curator error -- ${err.message}`);
+                console.warn(`  ${pc7.dim("Memory:")} curator error -- ${err.message}`);
               }
             }
             results.push(result);
@@ -4087,13 +4236,13 @@ Config for: ${test.name}`));
             }
             if (circuitBreaker?.isTripped() && !circuitBreakerTripped) {
               circuitBreakerTripped = true;
-              console.log(`  ${pc6.yellow("Memory: circuit breaker tripped -- disabling memory injection for remaining tests")}`);
+              console.log(`  ${pc7.yellow("Memory: circuit breaker tripped -- disabling memory injection for remaining tests")}`);
             }
             if (result.status === "failed" && actionCache && effectiveCacheEnabled && result.steps.length > 0) {
               const { hashStepInstruction: hashStepInstruction2 } = await import("@vostride/agent-qa-core");
               const { rm: rm3 } = await import("fs/promises");
-              const { resolve: resolve7, join: join8 } = await import("path");
-              const cacheDir = resolve7(configDir, config.services?.cache?.dir ?? RUNTIME_CACHE_DIR);
+              const { resolve: resolve9, join: join8 } = await import("path");
+              const cacheDir = resolve9(configDir, config.services?.cache?.dir ?? RUNTIME_CACHE_DIR);
               const cacheLog = logger.createScopedLogger("cache");
               let purged = 0;
               for (let i = 0; i < result.steps.length; i++) {
@@ -4172,13 +4321,13 @@ Config for: ${test.name}`));
         }
         const parallelBatchFailed = await flushParallelRuns();
         if (opts.bail && parallelBatchFailed) {
-          console.log(pc6.yellow("\nBailing out \u2014 stopping after first failure"));
+          console.log(pc7.yellow("\nBailing out \u2014 stopping after first failure"));
           bailTriggered = true;
           break;
         }
         const outcome = await runOneDirectTest(test);
         if (opts.bail && outcome.failed) {
-          console.log(pc6.yellow("\nBailing out \u2014 stopping after first failure"));
+          console.log(pc7.yellow("\nBailing out \u2014 stopping after first failure"));
           bailTriggered = true;
           break;
         }
@@ -4186,7 +4335,7 @@ Config for: ${test.name}`));
       if (!bailTriggered) {
         const parallelBatchFailed = await flushParallelRuns();
         if (opts.bail && parallelBatchFailed) {
-          console.log(pc6.yellow("\nBailing out \u2014 stopping after first failure"));
+          console.log(pc7.yellow("\nBailing out \u2014 stopping after first failure"));
         }
       }
       releaseAppium();
@@ -4205,7 +4354,7 @@ Config for: ${test.name}`));
       const errMsg = err instanceof Error ? err.message : String(err);
       const errStack = err instanceof Error ? err.stack ?? "" : "";
       const formattedError = formatFrameworkError(errMsg);
-      console.error(pc6.red(formattedError.displayMessage));
+      console.error(pc7.red(formattedError.displayMessage));
       if (_crashDb) {
         const fullError = `${errMsg}
 ${errStack}`;
@@ -4259,10 +4408,10 @@ ${errStack}`;
 init_config();
 init_llm_utils();
 init_model_defaults();
-import { Command as Command6 } from "commander";
-import { resolve as resolve3, dirname as dirname4 } from "path";
+import { Command as Command7 } from "commander";
+import { resolve as resolve5, dirname as dirname6 } from "path";
 import { createRequire as createRequire2 } from "module";
-import pc7 from "picocolors";
+import pc8 from "picocolors";
 import { flushAnalytics, resolveWorkspacePaths as resolveWorkspacePaths3 } from "@vostride/agent-qa-core";
 async function startDashboardBackedServices(opts, command, labels) {
   try {
@@ -4271,8 +4420,8 @@ async function startDashboardBackedServices(opts, command, labels) {
     const config = await resolveConfig({
       configPath: globalOpts.config
     });
-    const configFilePath = resolve3(globalOpts.config ?? "agent-qa.config.yaml");
-    const configDir = dirname4(configFilePath);
+    const configFilePath = resolve5(globalOpts.config ?? "agent-qa.config.yaml");
+    const configDir = dirname6(configFilePath);
     const workspacePaths = resolveWorkspacePaths3({
       config,
       configPath: configFilePath,
@@ -4312,17 +4461,17 @@ async function startDashboardBackedServices(opts, command, labels) {
     try {
       const require2 = createRequire2(import.meta.url);
       const pkgPath = require2.resolve("@vostride/agent-qa-dashboard-ui/package.json");
-      uiDir = resolve3(dirname4(pkgPath), "dist");
+      uiDir = resolve5(dirname6(pkgPath), "dist");
     } catch {
       if (globalOpts.verbose) {
-        console.log(pc7.yellow("Warning: @vostride/agent-qa-dashboard-ui not found \u2014 API-only mode"));
+        console.log(pc8.yellow("Warning: @vostride/agent-qa-dashboard-ui not found \u2014 API-only mode"));
       }
     }
     const { close } = await startServer({
       db,
       port,
       uiDir,
-      artifactsDir: resolve3(configDir, artifactsDir),
+      artifactsDir: resolve5(configDir, artifactsDir),
       workspacePaths,
       configPath: configFilePath,
       mcp: mcpConfig,
@@ -4338,7 +4487,7 @@ async function startDashboardBackedServices(opts, command, labels) {
     const shutdown = async () => {
       if (shuttingDown) return;
       shuttingDown = true;
-      console.log(pc7.dim(`
+      console.log(pc8.dim(`
 Shutting down ${labels.shutdown}...`));
       close();
       await flushAnalytics({ config }).catch(() => {
@@ -4348,12 +4497,12 @@ Shutting down ${labels.shutdown}...`));
     process.on("SIGINT", shutdown);
     process.on("SIGTERM", shutdown);
   } catch (err) {
-    console.error(pc7.red(`${labels.error} error: ${err instanceof Error ? err.message : String(err)}`));
+    console.error(pc8.red(`${labels.error} error: ${err instanceof Error ? err.message : String(err)}`));
     process.exit(2);
   }
 }
 function createDashboardCommand() {
-  const cmd = new Command6("dashboard").description("Start the dashboard web server").option("--port <number>", "server port (default: 3470)").option("--db <path>", "database file path").option("--open", "open browser after start").action(async (opts, command) => {
+  const cmd = new Command7("dashboard").description("Start the dashboard web server").option("--port <number>", "server port (default: 3470)").option("--db <path>", "database file path").option("--open", "open browser after start").action(async (opts, command) => {
     await startDashboardBackedServices(opts, command, {
       error: "Dashboard",
       shutdown: "dashboard"
@@ -4362,7 +4511,7 @@ function createDashboardCommand() {
   return cmd;
 }
 function createServeCommand() {
-  const cmd = new Command6("serve").description("Start configured local agent-qa services").action(async (_opts, command) => {
+  const cmd = new Command7("serve").description("Start configured local agent-qa services").action(async (_opts, command) => {
     await startDashboardBackedServices({}, command, {
       error: "Serve",
       shutdown: "local services"
@@ -4373,11 +4522,11 @@ function createServeCommand() {
 
 // src/commands/mcp.ts
 init_config();
-import { Command as Command7 } from "commander";
-import pc8 from "picocolors";
+import { Command as Command8 } from "commander";
+import pc9 from "picocolors";
 import { flushAnalytics as flushAnalytics2 } from "@vostride/agent-qa-core";
 function createMcpCommand() {
-  const cmd = new Command7("mcp").description("Start MCP (Model Context Protocol) server over stdio").action(async (command) => {
+  const cmd = new Command8("mcp").description("Start MCP (Model Context Protocol) server over stdio").action(async (command) => {
     try {
       const program2 = command.parent;
       const globalOpts = program2?.opts() ?? {};
@@ -4395,7 +4544,7 @@ function createMcpCommand() {
         });
       }
     } catch (err) {
-      console.error(pc8.red("Failed to start MCP server:"), err instanceof Error ? err.message : String(err));
+      console.error(pc9.red("Failed to start MCP server:"), err instanceof Error ? err.message : String(err));
       process.exitCode = 1;
     }
   });
@@ -4404,8 +4553,8 @@ function createMcpCommand() {
 
 // src/commands/config.ts
 init_config();
-import { Command as Command8 } from "commander";
-import pc9 from "picocolors";
+import { Command as Command9 } from "commander";
+import pc10 from "picocolors";
 import { parseDocument, Document } from "yaml";
 import { readFile as readFile3, writeFile } from "fs/promises";
 import { createInterface as createInterface2 } from "readline";
@@ -4434,10 +4583,10 @@ async function readStdin() {
 }
 function plainPrompt(question) {
   const rl = createInterface2({ input: process.stdin, output: process.stdout });
-  return new Promise((resolve7) => {
+  return new Promise((resolve9) => {
     rl.question(question, (answer) => {
       rl.close();
-      resolve7(answer.trim());
+      resolve9(answer.trim());
     });
   });
 }
@@ -4450,14 +4599,14 @@ async function getValue(key, providedValue) {
 }
 async function setAction(key, value) {
   if (isSensitiveKey(key)) {
-    console.error(pc9.red("Credential values are not written by config set."));
+    console.error(pc10.red("Credential values are not written by config set."));
     console.error("Use agent-qa auth set --config <name> --type api-key|bearer-token for compatible or Gemini configs.");
     console.error("Use plugins.auth plus the dashboard auth flow for subscription configs.");
     return;
   }
   const resolved = await getValue(key, value);
   if (!resolved) {
-    console.error(pc9.red("No value provided."));
+    console.error(pc10.red("No value provided."));
     return;
   }
   const configPath = "agent-qa.config.yaml";
@@ -4474,7 +4623,7 @@ async function setAction(key, value) {
   }
   doc.setIn(key.split("."), resolved);
   await writeFile(configPath, doc.toString());
-  console.log(pc9.green(`\u2713 ${key} = ${resolved} saved to agent-qa.config.yaml`));
+  console.log(pc10.green(`\u2713 ${key} = ${resolved} saved to agent-qa.config.yaml`));
 }
 async function showAction() {
   const fileConfig = await loadConfigFile("agent-qa.config.yaml");
@@ -4482,12 +4631,12 @@ async function showAction() {
   const { mergeConfigs: mergeConfigs2 } = await Promise.resolve().then(() => (init_config(), config_exports));
   const globalConfig = mergeConfigs2(fileConfig, envOverrides, {});
   const table = formatConfigDebug(globalConfig, {}, {});
-  console.log(pc9.bold("\nResolved Configuration:\n"));
+  console.log(pc10.bold("\nResolved Configuration:\n"));
   console.log(table);
   console.log();
 }
 function createConfigCommand() {
-  const cmd = new Command8("config").description("Manage configuration");
+  const cmd = new Command9("config").description("Manage configuration");
   cmd.command("set <key> [value]").description("Set a config value").action(setAction);
   cmd.command("show").description("Show resolved config with source attribution").action(showAction);
   return cmd;
@@ -4495,8 +4644,8 @@ function createConfigCommand() {
 
 // src/commands/queue.ts
 init_config();
-import { Command as Command9 } from "commander";
-import pc10 from "picocolors";
+import { Command as Command10 } from "commander";
+import pc11 from "picocolors";
 function timeAgo(dateStr) {
   const diff = Date.now() - new Date(dateStr).getTime();
   const seconds = Math.floor(diff / 1e3);
@@ -4519,7 +4668,7 @@ async function resolveServerUrl(opts, globalOpts) {
   }
 }
 function createQueueCommand() {
-  const cmd = new Command9("queue").description("Manage the test execution queue");
+  const cmd = new Command10("queue").description("Manage the test execution queue");
   cmd.command("list").description("Show pending and running jobs in the queue").option("--json", "output raw JSON").option("--all", "include recently completed jobs").option("--server <url>", "dashboard server URL").action(async (opts, command) => {
     try {
       const program2 = command.parent.parent;
@@ -4530,13 +4679,13 @@ function createQueueCommand() {
       try {
         const response = await fetch(endpoint);
         if (!response.ok) {
-          console.error(pc10.red(`Server returned ${response.status}: ${response.statusText}`));
+          console.error(pc11.red(`Server returned ${response.status}: ${response.statusText}`));
           process.exit(1);
         }
         data = await response.json();
       } catch {
-        console.error(pc10.red(`Could not connect to dashboard server at ${serverUrl}`));
-        console.error(pc10.dim("Make sure the dashboard is running: agent-qa dashboard"));
+        console.error(pc11.red(`Could not connect to dashboard server at ${serverUrl}`));
+        console.error(pc11.dim("Make sure the dashboard is running: agent-qa dashboard"));
         process.exit(1);
       }
       if (opts.json) {
@@ -4544,19 +4693,19 @@ function createQueueCommand() {
         return;
       }
       console.log();
-      console.log(pc10.bold("Queue Status"));
-      console.log(`  Concurrency: ${pc10.blue(String(data.concurrency))} slots (${pc10.yellow(String(data.activeSlots))} active)`);
+      console.log(pc11.bold("Queue Status"));
+      console.log(`  Concurrency: ${pc11.blue(String(data.concurrency))} slots (${pc11.yellow(String(data.activeSlots))} active)`);
       console.log();
       const pending = data.pending?.jobs ?? [];
       const running = data.running?.jobs ?? [];
       if (pending.length === 0 && running.length === 0) {
-        console.log(pc10.dim("  Queue is empty \u2014 no pending or running jobs"));
+        console.log(pc11.dim("  Queue is empty \u2014 no pending or running jobs"));
         console.log();
         return;
       }
       if (pending.length > 0) {
-        console.log(pc10.bold(`Pending (${pending.length} jobs):`));
-        console.log(pc10.dim("  #   ID            Name                Priority  Source      Queued"));
+        console.log(pc11.bold(`Pending (${pending.length} jobs):`));
+        console.log(pc11.dim("  #   ID            Name                Priority  Source      Queued"));
         for (let i = 0; i < pending.length; i++) {
           const job = pending[i];
           const num = String(i + 1).padEnd(3);
@@ -4565,37 +4714,37 @@ function createQueueCommand() {
           const priority = String(job.priority ?? 0).padEnd(8);
           const source = (job.source ?? "").padEnd(10);
           const queued = job.createdAt ? timeAgo(job.createdAt) : "";
-          console.log(`  ${num} ${pc10.dim(id)}  ${name}  ${priority}  ${source}  ${pc10.dim(queued)}`);
+          console.log(`  ${num} ${pc11.dim(id)}  ${name}  ${priority}  ${source}  ${pc11.dim(queued)}`);
         }
         console.log();
       }
       if (running.length > 0) {
-        console.log(pc10.bold(`Running (${running.length} jobs):`));
-        console.log(pc10.dim("  ID            Name                Source      Started"));
+        console.log(pc11.bold(`Running (${running.length} jobs):`));
+        console.log(pc11.dim("  ID            Name                Source      Started"));
         for (const job of running) {
           const id = (job.id ?? "").slice(0, 12).padEnd(12);
           const name = (job.name ?? "").slice(0, 18).padEnd(18);
           const source = (job.source ?? "").padEnd(10);
           const started = job.startedAt ? timeAgo(job.startedAt) : "";
-          console.log(`  ${pc10.green(id)}  ${name}  ${source}  ${pc10.dim(started)}`);
+          console.log(`  ${pc11.green(id)}  ${name}  ${source}  ${pc11.dim(started)}`);
         }
         console.log();
       }
       if (opts.all && data.recent?.length > 0) {
-        console.log(pc10.bold(`Recent (${data.recent.length} jobs):`));
-        console.log(pc10.dim("  ID            Name                Status    Duration"));
+        console.log(pc11.bold(`Recent (${data.recent.length} jobs):`));
+        console.log(pc11.dim("  ID            Name                Status    Duration"));
         for (const job of data.recent) {
           const id = (job.id ?? "").slice(0, 12).padEnd(12);
           const name = (job.name ?? "").slice(0, 18).padEnd(18);
           const status = (job.status ?? "").padEnd(8);
           const duration = job.duration ? `${Math.round(job.duration / 1e3)}s` : "";
-          const statusColor = job.status === "passed" ? pc10.green : job.status === "failed" ? pc10.red : pc10.dim;
-          console.log(`  ${pc10.dim(id)}  ${name}  ${statusColor(status)}  ${pc10.dim(duration)}`);
+          const statusColor = job.status === "passed" ? pc11.green : job.status === "failed" ? pc11.red : pc11.dim;
+          console.log(`  ${pc11.dim(id)}  ${name}  ${statusColor(status)}  ${pc11.dim(duration)}`);
         }
         console.log();
       }
     } catch (err) {
-      console.error(pc10.red(`Error: ${err instanceof Error ? err.message : String(err)}`));
+      console.error(pc11.red(`Error: ${err instanceof Error ? err.message : String(err)}`));
       process.exit(1);
     }
   });
@@ -4608,25 +4757,25 @@ function createQueueCommand() {
       try {
         response = await fetch(`${serverUrl}/api/runs/${runId}/cancel`, { method: "POST" });
       } catch {
-        console.error(pc10.red(`Could not connect to dashboard server at ${serverUrl}`));
-        console.error(pc10.dim("Make sure the dashboard is running: agent-qa dashboard"));
+        console.error(pc11.red(`Could not connect to dashboard server at ${serverUrl}`));
+        console.error(pc11.dim("Make sure the dashboard is running: agent-qa dashboard"));
         process.exit(1);
       }
       if (response.ok) {
         const data = await response.json();
         if (data.cancelled) {
-          console.log(pc10.green(`\u2713 Cancelled job ${runId}`));
+          console.log(pc11.green(`\u2713 Cancelled job ${runId}`));
         } else {
-          console.log(pc10.red(`Failed to cancel: ${data.error ?? "Unknown error"}`));
+          console.log(pc11.red(`Failed to cancel: ${data.error ?? "Unknown error"}`));
         }
       } else if (response.status === 404) {
-        console.log(pc10.red(`Job not found: ${runId}`));
+        console.log(pc11.red(`Job not found: ${runId}`));
       } else {
         const data = await response.json().catch(() => ({}));
-        console.log(pc10.red(`Failed to cancel: ${data.error ?? response.statusText}`));
+        console.log(pc11.red(`Failed to cancel: ${data.error ?? response.statusText}`));
       }
     } catch (err) {
-      console.error(pc10.red(`Error: ${err instanceof Error ? err.message : String(err)}`));
+      console.error(pc11.red(`Error: ${err instanceof Error ? err.message : String(err)}`));
       process.exit(1);
     }
   });
@@ -4635,10 +4784,10 @@ function createQueueCommand() {
 
 // src/commands/validate.ts
 init_config();
-import { Command as Command10 } from "commander";
+import { Command as Command11 } from "commander";
 import { validateProject, formatDiagnostics, resolveWorkspacePaths as resolveWorkspacePaths4 } from "@vostride/agent-qa-core";
 function createValidateCommand() {
-  const cmd = new Command10("validate").description("Validate config, test files, and suite references").argument("[files...]", "specific files to validate (default: auto-discover all)").action(async (files, command) => {
+  const cmd = new Command11("validate").description("Validate config, test files, and suite references").argument("[files...]", "specific files to validate (default: auto-discover all)").action(async (files, command) => {
     const configPath = command.parent?.opts().config ?? "agent-qa.config.yaml";
     let workspace;
     try {
@@ -4661,9 +4810,9 @@ function createValidateCommand() {
 }
 
 // src/commands/auth.ts
-import { Command as Command11 } from "commander";
+import { Command as Command12 } from "commander";
 import { exec } from "child_process";
-import pc11 from "picocolors";
+import pc12 from "picocolors";
 import input2 from "@inquirer/input";
 import password from "@inquirer/password";
 var PROVIDER_LABELS = {
@@ -4698,10 +4847,10 @@ function getGlobalConfigPath2(command) {
   return command.parent?.parent?.opts().config ?? command.parent?.opts().config;
 }
 function printCredentialGuidance(configName, provider) {
-  console.log(pc11.red(`Config ${configName} uses ${providerLabel(provider)} credentials.`));
-  console.log(pc11.dim("Use agent-qa auth set --config <name> --type api-key"));
+  console.log(pc12.red(`Config ${configName} uses ${providerLabel(provider)} credentials.`));
+  console.log(pc12.dim("Use agent-qa auth set --config <name> --type api-key"));
   if (provider === "anthropic-compatible") {
-    console.log(pc11.dim("or --type bearer-token"));
+    console.log(pc12.dim("or --type bearer-token"));
   }
 }
 function applyAuthToModelConfig(llmConfig, auth) {
@@ -4721,15 +4870,15 @@ function applyAuthToModelConfig(llmConfig, auth) {
 function statusForResolvedAuth(auth) {
   switch (auth.kind) {
     case "api-key":
-      return pc11.green("Saved API key");
+      return pc12.green("Saved API key");
     case "bearer-token":
-      return pc11.green("Saved bearer token");
+      return pc12.green("Saved bearer token");
     case "auth-fetch":
-      return Number(auth.expires ?? Date.now() + 1) <= Date.now() ? pc11.red("Expired") : pc11.green("OAuth connected");
+      return Number(auth.expires ?? Date.now() + 1) <= Date.now() ? pc12.red("Expired") : pc12.green("OAuth connected");
     case "unauthenticated":
-      return pc11.dim("No credential");
+      return pc12.dim("No credential");
     case "missing":
-      return pc11.red("Missing credential");
+      return pc12.red("Missing credential");
   }
 }
 function extractProviderError(err) {
@@ -4760,16 +4909,16 @@ function openAuthorizationUrl(url) {
   });
 }
 function printMissingSubscriptionPluginGuidance(configName, provider) {
-  console.log(pc11.red(`Provider "${provider}" is configured for "${configName}", but no auth plugin is registered.`));
-  console.log(pc11.dim(`Config: ${configName}`));
-  console.log(pc11.dim(`Provider: ${provider}`));
-  console.log(pc11.dim("Add the subscription auth plugin to package.json and install with your package manager:"));
-  console.log(pc11.dim('  "devDependencies": { "@vostride/agent-qa-subscription-auth": "<agent-qa version>" }'));
-  console.log(pc11.dim("Declare it in agent-qa.config.yaml under plugins.auth:"));
-  console.log(pc11.dim("  plugins:"));
-  console.log(pc11.dim("    auth:"));
-  console.log(pc11.dim("      - package: @vostride/agent-qa-subscription-auth"));
-  console.log(pc11.dim("Then authenticate from agent-qa dashboard or rerun this command."));
+  console.log(pc12.red(`Provider "${provider}" is configured for "${configName}", but no auth plugin is registered.`));
+  console.log(pc12.dim(`Config: ${configName}`));
+  console.log(pc12.dim(`Provider: ${provider}`));
+  console.log(pc12.dim("Add the subscription auth plugin to package.json and install with your package manager:"));
+  console.log(pc12.dim('  "devDependencies": { "@vostride/agent-qa-subscription-auth": "<agent-qa version>" }'));
+  console.log(pc12.dim("Declare it in agent-qa.config.yaml under plugins.auth:"));
+  console.log(pc12.dim("  plugins:"));
+  console.log(pc12.dim("    auth:"));
+  console.log(pc12.dim("      - package: @vostride/agent-qa-subscription-auth"));
+  console.log(pc12.dim("Then authenticate from agent-qa dashboard or rerun this command."));
 }
 async function readTokensFromPlugin(provider, plugin, started) {
   if (started.waitForTokens) {
@@ -4777,19 +4926,19 @@ async function readTokensFromPlugin(provider, plugin, started) {
   }
   if (plugin.dashboardAuth.mode === "manual-code") {
     if (!plugin.exchangeCode) {
-      console.log(pc11.red(`Provider "${provider}" does not support CLI code exchange. Use agent-qa dashboard.`));
+      console.log(pc12.red(`Provider "${provider}" does not support CLI code exchange. Use agent-qa dashboard.`));
       process.exitCode = 1;
       return null;
     }
     const code = (await input2({ message: "Authorization code:" })).trim();
     if (!code) {
-      console.log(pc11.red("Authorization code is required"));
+      console.log(pc12.red("Authorization code is required"));
       process.exitCode = 1;
       return null;
     }
     return await plugin.exchangeCode({ code, sessionState: started.sessionState });
   }
-  console.log(pc11.red(`Provider "${provider}" does not support CLI auth login. Use agent-qa dashboard.`));
+  console.log(pc12.red(`Provider "${provider}" does not support CLI auth login. Use agent-qa dashboard.`));
   process.exitCode = 1;
   return null;
 }
@@ -4802,14 +4951,14 @@ async function runSubscriptionPluginLogin(configName, provider) {
     return;
   }
   if (!plugin.startAuth) {
-    console.log(pc11.red(`Provider "${provider}" does not support CLI auth login. Use agent-qa dashboard.`));
+    console.log(pc12.red(`Provider "${provider}" does not support CLI auth login. Use agent-qa dashboard.`));
     process.exitCode = 1;
     return;
   }
   let started;
   try {
     started = await plugin.startAuth({ configName });
-    console.log(`Open this URL to authenticate: ${pc11.cyan(started.authorizeUrl)}`);
+    console.log(`Open this URL to authenticate: ${pc12.cyan(started.authorizeUrl)}`);
     openAuthorizationUrl(started.authorizeUrl);
     const tokens = await readTokensFromPlugin(provider, plugin, started);
     if (!tokens) return;
@@ -4818,18 +4967,18 @@ async function runSubscriptionPluginLogin(configName, provider) {
       provider: plugin.credentialProviderId,
       tokens
     });
-    console.log(pc11.green(`Authenticated ${configName} with ${plugin.label}`));
+    console.log(pc12.green(`Authenticated ${configName} with ${plugin.label}`));
   } catch (err) {
-    console.log(pc11.red(err instanceof Error ? err.message : String(err)));
+    console.log(pc12.red(err instanceof Error ? err.message : String(err)));
     process.exitCode = 1;
   } finally {
     started?.cleanup?.();
   }
 }
 function createAuthCommand() {
-  const cmd = new Command11("auth").description("Manage LLM config credentials");
+  const cmd = new Command12("auth").description("Manage LLM config credentials");
   cmd.addCommand(
-    new Command11("login").description("Authenticate with a subscription provider").requiredOption("--config <name>", "named subscription LLM config to authenticate").action(async (opts, command) => {
+    new Command12("login").description("Authenticate with a subscription provider").requiredOption("--config <name>", "named subscription LLM config to authenticate").action(async (opts, command) => {
       const { resolveNamedConfig: resolveNamedConfig2 } = await Promise.resolve().then(() => (init_llm_utils(), llm_utils_exports));
       const configPath = getGlobalConfigPath2(command);
       let provider;
@@ -4837,13 +4986,13 @@ function createAuthCommand() {
       try {
         const requestedName = normalizeConfigName(opts.config);
         if (!requestedName) {
-          console.log(pc11.red("configName is required"));
+          console.log(pc12.red("configName is required"));
           return;
         }
         const resolved = await resolveNamedConfig2(requestedName, configPath);
         const resolvedName = normalizeConfigName(resolved.config.name);
         if (!resolvedName) {
-          console.log(pc11.red("Config name is invalid"));
+          console.log(pc12.red("Config name is invalid"));
           return;
         }
         configName = resolvedName;
@@ -4854,17 +5003,17 @@ function createAuthCommand() {
         }
         provider = configProvider;
       } catch (err) {
-        console.log(pc11.red(err instanceof Error ? err.message : String(err)));
+        console.log(pc12.red(err instanceof Error ? err.message : String(err)));
         return;
       }
       await runSubscriptionPluginLogin(configName, provider);
     })
   );
   cmd.addCommand(
-    new Command11("set").description("Save a credential for a named LLM config").requiredOption("--config <name>", "named LLM config to save a credential for").requiredOption("--type <type>", "credential type: api-key or bearer-token").argument("[secret]", "credential secret; prompted when omitted").action(async (secretArg, opts, command) => {
+    new Command12("set").description("Save a credential for a named LLM config").requiredOption("--config <name>", "named LLM config to save a credential for").requiredOption("--type <type>", "credential type: api-key or bearer-token").argument("[secret]", "credential secret; prompted when omitted").action(async (secretArg, opts, command) => {
       const credentialType = opts.type.trim();
       if (credentialType !== "api-key" && credentialType !== "bearer-token") {
-        console.log(pc11.red("type must be api-key or bearer-token"));
+        console.log(pc12.red("type must be api-key or bearer-token"));
         return;
       }
       const { resolveNamedConfig: resolveNamedConfig2 } = await Promise.resolve().then(() => (init_llm_utils(), llm_utils_exports));
@@ -4873,44 +5022,44 @@ function createAuthCommand() {
       try {
         resolved = await resolveNamedConfig2(opts.config, configPath);
       } catch (err) {
-        console.log(pc11.red(err instanceof Error ? err.message : String(err)));
+        console.log(pc12.red(err instanceof Error ? err.message : String(err)));
         return;
       }
       const configName = resolved.config.name ?? opts.config;
       const provider = resolved.config.provider;
       if (SUBSCRIPTION_PROVIDERS2.has(provider)) {
-        console.log(pc11.red("Subscription providers use OAuth login"));
+        console.log(pc12.red("Subscription providers use OAuth login"));
         return;
       }
       if (credentialType === "bearer-token" && provider !== "anthropic-compatible") {
-        console.log(pc11.red("bearer-token credentials are only supported for anthropic-compatible configs"));
+        console.log(pc12.red("bearer-token credentials are only supported for anthropic-compatible configs"));
         return;
       }
       if (credentialType === "api-key" && !API_KEY_CREDENTIAL_PROVIDERS.has(provider)) {
-        console.log(pc11.red("api-key credentials are not supported for this provider"));
+        console.log(pc12.red("api-key credentials are not supported for this provider"));
         return;
       }
       const secret = (secretArg ?? await password({ message: "Secret:" })).trim();
       if (!secret) {
-        console.log(pc11.red("Secret is required"));
+        console.log(pc12.red("Secret is required"));
         return;
       }
       const { writeAuth } = await import("@vostride/agent-qa-core");
       if (credentialType === "bearer-token") {
         await writeAuth(configName, { type: "bearer", provider: "anthropic-compatible", token: secret });
-        console.log(pc11.green(`Saved bearer token for ${configName}`));
+        console.log(pc12.green(`Saved bearer token for ${configName}`));
       } else {
         await writeAuth(configName, { type: "api", provider, key: secret });
-        console.log(pc11.green(`Saved API key for ${configName}`));
+        console.log(pc12.green(`Saved API key for ${configName}`));
       }
     })
   );
   cmd.addCommand(
-    new Command11("status").description("Show credential status for configured LLMs").action(async function() {
+    new Command12("status").description("Show credential status for configured LLMs").action(async function() {
       const { loadAuthPluginsForRawConfig: loadAuthPluginsForRawConfig2, resolveModelAuth: resolveModelAuth2 } = await Promise.resolve().then(() => (init_llm_utils(), llm_utils_exports));
       const { loadConfigFile: loadConfigFile2 } = await Promise.resolve().then(() => (init_config(), config_exports));
       const configPath = getGlobalConfigPath2(this) ?? "agent-qa.config.yaml";
-      console.log(pc11.bold("Auth status:\n"));
+      console.log(pc12.bold("Auth status:\n"));
       let llms;
       let defaultLLM;
       try {
@@ -4921,25 +5070,25 @@ function createAuthCommand() {
       } catch {
       }
       if (!llms?.length) {
-        console.log(pc11.dim("  No LLM configs found"));
+        console.log(pc12.dim("  No LLM configs found"));
         return;
       }
       const maxNameLen = Math.max(...llms.map((c) => String(c.name ?? "").length), 4) + 12;
       for (const llm of llms) {
         const name = String(llm.name ?? "");
         const isDefault = name === defaultLLM;
-        const label = isDefault ? `${name} ${pc11.dim("(default)")}` : name;
+        const label = isDefault ? `${name} ${pc12.dim("(default)")}` : name;
         const rawLabel = isDefault ? `${name} (default)` : name;
         const padLen = Math.max(0, maxNameLen - rawLabel.length);
         const dots = ".".repeat(padLen + 2);
         const provider = llm.provider;
         const status = statusForResolvedAuth(await resolveModelAuth2(name, llm));
-        console.log(`  ${label} ${pc11.dim(`[${providerLabel(provider)}]`)} ${pc11.dim(dots)} ${status}`);
+        console.log(`  ${label} ${pc12.dim(`[${providerLabel(provider)}]`)} ${pc12.dim(dots)} ${status}`);
       }
     })
   );
   cmd.addCommand(
-    new Command11("logout").description("Remove stored credentials for a named config").option("--config <name>", "named LLM config to log out from").action(async (opts, command) => {
+    new Command12("logout").description("Remove stored credentials for a named config").option("--config <name>", "named LLM config to log out from").action(async (opts, command) => {
       const { removeAuth } = await import("@vostride/agent-qa-core");
       const { resolveNamedConfig: resolveNamedConfig2 } = await Promise.resolve().then(() => (init_llm_utils(), llm_utils_exports));
       const configPath = getGlobalConfigPath2(command);
@@ -4951,16 +5100,16 @@ function createAuthCommand() {
           const resolved = await resolveNamedConfig2(void 0, configPath);
           storeKey = resolved.config.name;
         } catch {
-          console.log(pc11.red("Specify --config <name> or run with a config file"));
+          console.log(pc12.red("Specify --config <name> or run with a config file"));
           return;
         }
       }
       await removeAuth(storeKey);
-      console.log(pc11.green(`Logged out from ${storeKey}`));
+      console.log(pc12.green(`Logged out from ${storeKey}`));
     })
   );
   cmd.addCommand(
-    new Command11("test").description("Test LLM connection using named config credentials").option("--config <name>", "named LLM config to test").option("--provider <name>", "override config provider").option("--model <name>", "override config model").action(async (opts, command) => {
+    new Command12("test").description("Test LLM connection using named config credentials").option("--config <name>", "named LLM config to test").option("--provider <name>", "override config provider").option("--model <name>", "override config model").action(async (opts, command) => {
       const { resolveModelAuth: resolveModelAuth2, resolveNamedConfig: resolveNamedConfig2 } = await Promise.resolve().then(() => (init_llm_utils(), llm_utils_exports));
       const configPath = getGlobalConfigPath2(command);
       let planner;
@@ -4971,19 +5120,19 @@ function createAuthCommand() {
         planner = modelFields;
         configName = name;
       } catch (err) {
-        console.log(pc11.red(err instanceof Error ? err.message : String(err)));
+        console.log(pc12.red(err instanceof Error ? err.message : String(err)));
         return;
       }
       if (opts.provider) planner = { ...planner, provider: opts.provider };
       if (opts.model) planner = { ...planner, model: opts.model };
-      console.log(pc11.dim(`Testing config: ${configName}...`));
+      console.log(pc12.dim(`Testing config: ${configName}...`));
       const auth = await resolveModelAuth2(configName, planner);
       if (auth.kind === "missing") {
-        console.log(pc11.red(auth.message));
+        console.log(pc12.red(auth.message));
         return;
       }
       if (auth.kind === "unauthenticated") {
-        console.log(pc11.dim(auth.message));
+        console.log(pc12.dim(auth.message));
       }
       const { createModel, getProviderOptions } = await import("@vostride/agent-qa-core");
       const { generateText } = await import("ai");
@@ -5001,24 +5150,24 @@ function createAuthCommand() {
           ...providerOpts ? { providerOptions: providerOpts } : {}
         });
         const elapsed = Date.now() - start;
-        console.log(pc11.green(`Connected to ${planner.provider}/${planner.model} (${elapsed}ms)`));
+        console.log(pc12.green(`Connected to ${planner.provider}/${planner.model} (${elapsed}ms)`));
       } catch (err) {
         const { message, statusCode } = extractProviderError(err);
         const fullContext = `${message} ${statusCode ?? ""}`;
         if (/auth|unauthorized|401|invalid.*key|permission/i.test(fullContext)) {
-          console.log(pc11.red("Authentication failed. Check the saved credential for this config."));
+          console.log(pc12.red("Authentication failed. Check the saved credential for this config."));
         } else if (/model.*not.*support|not found|404|does not exist/i.test(fullContext)) {
-          console.log(pc11.red("Model not found. Check the model name."));
+          console.log(pc12.red("Model not found. Check the model name."));
         } else if (/rate|429|quota|limit/i.test(fullContext)) {
-          console.log(pc11.red("Rate limited. Try again later."));
+          console.log(pc12.red("Rate limited. Try again later."));
         } else if (/ECONNREFUSED|ENOTFOUND|timeout|abort|fetch failed|network/i.test(fullContext)) {
-          console.log(pc11.red("Network error. Check the exact base URL and try again."));
+          console.log(pc12.red("Network error. Check the exact base URL and try again."));
         } else if (/invalid_request|400|bad request/i.test(fullContext)) {
-          console.log(pc11.red("Invalid request. Check model and provider settings."));
+          console.log(pc12.red("Invalid request. Check model and provider settings."));
         } else {
-          console.log(pc11.red(`Connection failed. ${message}`));
+          console.log(pc12.red(`Connection failed. ${message}`));
         }
-        console.log(pc11.dim(message));
+        console.log(pc12.dim(message));
       } finally {
         clearTimeout(timeout);
       }
@@ -5029,35 +5178,35 @@ function createAuthCommand() {
 
 // src/commands/devices.ts
 init_config();
-import { Command as Command12 } from "commander";
-import { execSync as execSync3 } from "child_process";
+import { Command as Command13 } from "commander";
+import { execSync as execSync2 } from "child_process";
 import { existsSync as existsSync3, readFileSync as readFileSync3, writeFileSync as writeFileSync2 } from "fs";
 import { join as join5 } from "path";
 import { stringify as stringify2 } from "yaml";
-import pc12 from "picocolors";
+import pc13 from "picocolors";
 function formatStatus2(transport, localBinding) {
   if (transport !== "local") {
-    return pc12.green("Ready") + pc12.dim(" (no local binding required)");
+    return pc13.green("Ready") + pc13.dim(" (no local binding required)");
   }
   if (!localBinding) {
-    return pc12.red("UNBOUND") + pc12.yellow(" - run `agent-qa devices init`");
+    return pc13.red("UNBOUND") + pc13.yellow(" - run `agent-qa devices init`");
   }
   const keys = Object.entries(localBinding).slice(0, 2);
   const details = keys.map(([k, v]) => `${k}: ${v}`).join(", ");
-  return pc12.green("Bound") + pc12.dim(` (${details})`);
+  return pc13.green("Bound") + pc13.dim(` (${details})`);
 }
 async function listDevices() {
   let config;
   try {
     config = await resolveConfig({});
   } catch (err) {
-    console.error(pc12.red(`Config error: ${err instanceof Error ? err.message : String(err)}`));
+    console.error(pc13.red(`Config error: ${err instanceof Error ? err.message : String(err)}`));
     process.exitCode = 1;
     return;
   }
   const devices = config.registry?.devices;
   if (!devices || Object.keys(devices).length === 0) {
-    console.log(pc12.yellow("No devices configured in registry.devices"));
+    console.log(pc13.yellow("No devices configured in registry.devices"));
     return;
   }
   const localBindings = loadLocalBindings();
@@ -5065,13 +5214,13 @@ async function listDevices() {
   const platWidth = 10;
   const transWidth = 14;
   console.log("");
-  console.log(pc12.bold("  Configured Devices"));
+  console.log(pc13.bold("  Configured Devices"));
   console.log("");
   console.log(
-    `  ${pc12.dim("Name".padEnd(nameWidth))}  ${pc12.dim("Platform".padEnd(platWidth))}  ${pc12.dim("Transport".padEnd(transWidth))}  ${pc12.dim("Status")}`
+    `  ${pc13.dim("Name".padEnd(nameWidth))}  ${pc13.dim("Platform".padEnd(platWidth))}  ${pc13.dim("Transport".padEnd(transWidth))}  ${pc13.dim("Status")}`
   );
   console.log(
-    `  ${pc12.dim("\u2500".repeat(nameWidth))}  ${pc12.dim("\u2500".repeat(platWidth))}  ${pc12.dim("\u2500".repeat(transWidth))}  ${pc12.dim("\u2500".repeat(30))}`
+    `  ${pc13.dim("\u2500".repeat(nameWidth))}  ${pc13.dim("\u2500".repeat(platWidth))}  ${pc13.dim("\u2500".repeat(transWidth))}  ${pc13.dim("\u2500".repeat(30))}`
   );
   for (const [name, profile] of Object.entries(devices)) {
     const localBinding = localBindings?.devices?.[name] ?? null;
@@ -5084,7 +5233,7 @@ async function listDevices() {
 }
 function scanAdbDevices() {
   try {
-    const output = execSync3("adb devices -l", { encoding: "utf-8", stdio: ["pipe", "pipe", "pipe"] });
+    const output = execSync2("adb devices -l", { encoding: "utf-8", stdio: ["pipe", "pipe", "pipe"] });
     const lines = output.split("\n").slice(1);
     const results = [];
     for (const line of lines) {
@@ -5103,7 +5252,7 @@ function scanAdbDevices() {
 }
 function scanSimctlDevices() {
   try {
-    const output = execSync3("xcrun simctl list devices --json", {
+    const output = execSync2("xcrun simctl list devices --json", {
       encoding: "utf-8",
       stdio: ["pipe", "pipe", "pipe"]
     });
@@ -5135,28 +5284,28 @@ async function initDevices() {
   const dir = process.cwd();
   const localFilePath = join5(dir, "agent-qa.local.yaml");
   if (existsSync3(localFilePath)) {
-    console.log(pc12.yellow("agent-qa.local.yaml already exists. Skipping generation."));
+    console.log(pc13.yellow("agent-qa.local.yaml already exists. Skipping generation."));
     return;
   }
-  console.log(pc12.bold("\n  Scanning for connected devices...\n"));
+  console.log(pc13.bold("\n  Scanning for connected devices...\n"));
   const adbDevices = scanAdbDevices();
   const simctlDevices = scanSimctlDevices();
   if (adbDevices.length > 0) {
-    console.log(`  ${pc12.green("Android:")} found ${adbDevices.length} device(s)`);
+    console.log(`  ${pc13.green("Android:")} found ${adbDevices.length} device(s)`);
     for (const d of adbDevices) {
-      console.log(`    ${pc12.dim("\u2022")} ${d.model} (${d.serial})`);
+      console.log(`    ${pc13.dim("\u2022")} ${d.model} (${d.serial})`);
     }
   } else {
-    console.log(`  ${pc12.dim("Android:")} no devices found (adb not available or no devices connected)`);
+    console.log(`  ${pc13.dim("Android:")} no devices found (adb not available or no devices connected)`);
   }
   if (simctlDevices.length > 0) {
     const booted = simctlDevices.filter((d) => d.state === "Booted");
-    console.log(`  ${pc12.green("iOS:")} found ${simctlDevices.length} simulator(s) (${booted.length} booted)`);
+    console.log(`  ${pc13.green("iOS:")} found ${simctlDevices.length} simulator(s) (${booted.length} booted)`);
     for (const d of booted) {
-      console.log(`    ${pc12.dim("\u2022")} ${d.name} (${d.udid})`);
+      console.log(`    ${pc13.dim("\u2022")} ${d.name} (${d.udid})`);
     }
   } else {
-    console.log(`  ${pc12.dim("iOS:")} no simulators found (simctl not available or none installed)`);
+    console.log(`  ${pc13.dim("iOS:")} no simulators found (simctl not available or none installed)`);
   }
   let config;
   try {
@@ -5190,20 +5339,20 @@ async function initDevices() {
   writeFileSync2(localFilePath, yamlContent);
   appendGitignoreEntry(dir, "agent-qa.local.yaml");
   console.log("");
-  console.log(pc12.green(`  Generated agent-qa.local.yaml with ${bindCount} device binding(s)`));
-  console.log(pc12.dim("  Added agent-qa.local.yaml to .gitignore"));
+  console.log(pc13.green(`  Generated agent-qa.local.yaml with ${bindCount} device binding(s)`));
+  console.log(pc13.dim("  Added agent-qa.local.yaml to .gitignore"));
   console.log("");
 }
 function createDevicesCommand() {
-  const cmd = new Command12("devices").description("Manage device profiles and local bindings");
+  const cmd = new Command13("devices").description("Manage device profiles and local bindings");
   cmd.command("list").description("Show configured devices with merged shared + local view").action(listDevices);
   cmd.command("init").description("Scan connected devices and generate agent-qa.local.yaml").action(initDevices);
   return cmd;
 }
 
 // src/commands/ids.ts
-import { Command as Command13 } from "commander";
-import pc13 from "picocolors";
+import { Command as Command14 } from "commander";
+import pc14 from "picocolors";
 import {
   ENTITY_ID_TYPES,
   generateCanonicalId,
@@ -5217,7 +5366,7 @@ function parseEntityType(value) {
   throw new Error(`Unknown ID type "${value}". Expected one of: ${ENTITY_ID_TYPES.join(", ")}`);
 }
 function createIdsCommand() {
-  const cmd = new Command13("ids").description("Generate and validate canonical agent-qa entity IDs");
+  const cmd = new Command14("ids").description("Generate and validate canonical agent-qa entity IDs");
   cmd.command("generate").description("Generate a canonical agent-qa ID using id-agent").argument("<type>", `entity type: ${ENTITY_ID_TYPES.join("|")}`).option("--json", "print structured JSON").action((typeValue, opts) => {
     try {
       const type = parseEntityType(typeValue);
@@ -5229,7 +5378,7 @@ function createIdsCommand() {
         console.log(id);
       }
     } catch (err) {
-      console.error(pc13.red(err instanceof Error ? err.message : String(err)));
+      console.error(pc14.red(err instanceof Error ? err.message : String(err)));
       process.exitCode = 1;
     }
   });
@@ -5248,15 +5397,15 @@ function createIdsCommand() {
       if (opts.json) {
         console.log(JSON.stringify(result, null, 2));
       } else if (valid) {
-        console.log(pc13.green(result.message));
+        console.log(pc14.green(result.message));
       } else {
-        console.error(pc13.red(result.message));
+        console.error(pc14.red(result.message));
       }
       if (!valid) {
         process.exitCode = 1;
       }
     } catch (err) {
-      console.error(pc13.red(err instanceof Error ? err.message : String(err)));
+      console.error(pc14.red(err instanceof Error ? err.message : String(err)));
       process.exitCode = 1;
     }
   });
@@ -5264,18 +5413,18 @@ function createIdsCommand() {
 }
 
 // src/commands/create-test.ts
-import { Command as Command14 } from "commander";
+import { Command as Command15 } from "commander";
 import { generateTestId } from "@vostride/agent-qa-ids";
 import { stringify as stringify3 } from "yaml";
 import { writeFile as writeFile2, mkdir } from "fs/promises";
 import { existsSync as existsSync4 } from "fs";
-import { resolve as resolve4, dirname as dirname5 } from "path";
-import pc14 from "picocolors";
+import { resolve as resolve6, dirname as dirname7 } from "path";
+import pc15 from "picocolors";
 function createCreateTestCommand() {
-  const cmd = new Command14("create-test").description("Scaffold a new test YAML file with auto-generated ID").argument("<path>", "output file path for the test YAML").action(async (path) => {
-    const resolved = resolve4(path);
+  const cmd = new Command15("create-test").description("Scaffold a new test YAML file with auto-generated ID").argument("<path>", "output file path for the test YAML").action(async (path) => {
+    const resolved = resolve6(path);
     if (existsSync4(resolved)) {
-      console.error(pc14.red("Error: File already exists: " + resolved));
+      console.error(pc15.red("Error: File already exists: " + resolved));
       process.exitCode = 1;
       return;
     }
@@ -5287,27 +5436,27 @@ function createCreateTestCommand() {
       steps: ["Describe your first test step here"]
     };
     const yamlContent = stringify3(template);
-    await mkdir(dirname5(resolved), { recursive: true });
+    await mkdir(dirname7(resolved), { recursive: true });
     await writeFile2(resolved, yamlContent, "utf-8");
-    console.log(pc14.green("Created " + resolved));
-    console.log(pc14.dim("  test-id: " + testId));
+    console.log(pc15.green("Created " + resolved));
+    console.log(pc15.dim("  test-id: " + testId));
   });
   return cmd;
 }
 
 // src/commands/create-suite.ts
-import { Command as Command15 } from "commander";
+import { Command as Command16 } from "commander";
 import { generateSuiteId } from "@vostride/agent-qa-ids";
 import { stringify as stringify4 } from "yaml";
 import { writeFile as writeFile3, mkdir as mkdir2 } from "fs/promises";
 import { existsSync as existsSync5 } from "fs";
-import { resolve as resolve5, dirname as dirname6 } from "path";
-import pc15 from "picocolors";
+import { resolve as resolve7, dirname as dirname8 } from "path";
+import pc16 from "picocolors";
 function createCreateSuiteCommand() {
-  const cmd = new Command15("create-suite").description("Scaffold a new suite YAML file with auto-generated ID").argument("<path>", "output file path for the suite YAML").action(async (path) => {
-    const resolved = resolve5(path);
+  const cmd = new Command16("create-suite").description("Scaffold a new suite YAML file with auto-generated ID").argument("<path>", "output file path for the suite YAML").action(async (path) => {
+    const resolved = resolve7(path);
     if (existsSync5(resolved)) {
-      console.error(pc15.red("Error: File already exists: " + resolved));
+      console.error(pc16.red("Error: File already exists: " + resolved));
       process.exitCode = 1;
       return;
     }
@@ -5321,18 +5470,18 @@ function createCreateSuiteCommand() {
       "tests: []",
       "tests: []\n  # - test: ./path/to/test.yaml\n  #   id: my-test-id"
     );
-    await mkdir2(dirname6(resolved), { recursive: true });
+    await mkdir2(dirname8(resolved), { recursive: true });
     await writeFile3(resolved, yamlContent, "utf-8");
-    console.log(pc15.green("Created " + resolved));
-    console.log(pc15.dim("  suite-id: " + suiteId));
+    console.log(pc16.green("Created " + resolved));
+    console.log(pc16.dim("  suite-id: " + suiteId));
   });
   return cmd;
 }
 
 // src/commands/clean-memory.ts
 init_config();
-import { Command as Command16 } from "commander";
-import pc16 from "picocolors";
+import { Command as Command17 } from "commander";
+import pc17 from "picocolors";
 import { createInterface as createInterface3 } from "readline";
 import { readFile as readFile4, readdir as readdir2, rm as rm2, stat as stat2 } from "fs/promises";
 import { existsSync as existsSync6 } from "fs";
@@ -5389,7 +5538,7 @@ async function getOrphanInfo(memoryRoot, tier, scope) {
   };
 }
 function createCleanMemoryCommand() {
-  const cmd = new Command16("clean-memory").description("Remove orphaned memory observation directories").option("-y, --yes", "skip confirmation prompt").action(async (_opts, command) => {
+  const cmd = new Command17("clean-memory").description("Remove orphaned memory observation directories").option("-y, --yes", "skip confirmation prompt").action(async (_opts, command) => {
     const opts = command.opts();
     const configPath = command.parent?.opts()?.config ?? "agent-qa.config.yaml";
     const config = await resolveConfig({ configPath });
@@ -5422,7 +5571,7 @@ function createCleanMemoryCommand() {
     }
     const memoryRoot = resolveMemoryRoot2(config, workspace.configDir);
     if (!existsSync6(memoryRoot)) {
-      console.log(pc16.dim("No memory directory found."));
+      console.log(pc17.dim("No memory directory found."));
       return;
     }
     const TIERS = [
@@ -5452,17 +5601,17 @@ function createCleanMemoryCommand() {
       }
     }
     if (orphans.length === 0) {
-      console.log(pc16.dim("No orphaned memory directories found."));
+      console.log(pc17.dim("No orphaned memory directories found."));
       return;
     }
     const maxPathLen = Math.max("Path".length, ...orphans.map((o) => o.path.length));
     console.log("");
-    console.log(pc16.bold("Orphaned memory directories:"));
+    console.log(pc17.bold("Orphaned memory directories:"));
     console.log("");
-    console.log("  " + pc16.dim("Path".padEnd(maxPathLen + 2) + "Files".padStart(7) + "  " + "Last Confirmed".padEnd(20) + "Size".padStart(10)));
-    console.log("  " + pc16.dim("-".repeat(maxPathLen + 2 + 7 + 2 + 20 + 10)));
+    console.log("  " + pc17.dim("Path".padEnd(maxPathLen + 2) + "Files".padStart(7) + "  " + "Last Confirmed".padEnd(20) + "Size".padStart(10)));
+    console.log("  " + pc17.dim("-".repeat(maxPathLen + 2 + 7 + 2 + 20 + 10)));
     for (const o of orphans) {
-      const confirmed = o.lastConfirmed ?? pc16.dim("never");
+      const confirmed = o.lastConfirmed ?? pc17.dim("never");
       console.log("  " + o.path.padEnd(maxPathLen + 2) + String(o.fileCount).padStart(7) + "  " + String(confirmed).padEnd(20) + formatSize(o.size).padStart(10));
     }
     console.log("");
@@ -5480,18 +5629,18 @@ function createCleanMemoryCommand() {
     for (const orphan of orphans) {
       await rm2(join6(memoryRoot, orphan.tier, orphan.scope), { recursive: true, force: true });
     }
-    console.log(pc16.green(`Deleted ${orphans.length} orphaned director${orphans.length === 1 ? "y" : "ies"}.`));
+    console.log(pc17.green(`Deleted ${orphans.length} orphaned director${orphans.length === 1 ? "y" : "ies"}.`));
   });
   return cmd;
 }
 
 // src/commands/skills.ts
-import { Command as Command17 } from "commander";
+import { Command as Command18 } from "commander";
 import { existsSync as existsSync7, readdirSync, readFileSync as readFileSync4, statSync } from "fs";
-import { dirname as dirname7, join as join7, resolve as resolve6 } from "path";
+import { dirname as dirname9, join as join7, resolve as resolve8 } from "path";
 import { fileURLToPath } from "url";
 function findPackageRoot(startDir) {
-  let current = resolve6(startDir);
+  let current = resolve8(startDir);
   while (true) {
     const packagePath = join7(current, "package.json");
     if (existsSync7(packagePath)) {
@@ -5503,9 +5652,9 @@ function findPackageRoot(startDir) {
       } catch {
       }
     }
-    const parent = dirname7(current);
+    const parent = dirname9(current);
     if (parent === current) {
-      return resolve6(startDir);
+      return resolve8(startDir);
     }
     current = parent;
   }
@@ -5521,13 +5670,13 @@ function hasSkillDirectories(dir) {
     return false;
   }
 }
-function resolveAgentQaSkillsDirectory(startDir = dirname7(fileURLToPath(import.meta.url))) {
+function resolveAgentQaSkillsDirectory(startDir = dirname9(fileURLToPath(import.meta.url))) {
   const packageRoot = findPackageRoot(startDir);
   const packagedSkills = join7(packageRoot, "skills");
   if (hasSkillDirectories(packagedSkills)) {
     return { path: packagedSkills, source: "package" };
   }
-  const sourceSkills = resolve6(packageRoot, "../..", "skills");
+  const sourceSkills = resolve8(packageRoot, "../..", "skills");
   if (hasSkillDirectories(sourceSkills)) {
     return { path: sourceSkills, source: "source" };
   }
@@ -5555,7 +5704,7 @@ function listAgentQaSkills(skillsDir) {
 function createSkillsCommand(options = {}) {
   const stdout = options.stdout ?? process.stdout;
   const stderr = options.stderr ?? process.stderr;
-  return new Command17("skills").description("List packaged agent-qa skills").option("--json", "print machine-readable output").action((opts) => {
+  return new Command18("skills").description("List packaged agent-qa skills").option("--json", "print machine-readable output").action((opts) => {
     const resolved = resolveAgentQaSkillsDirectory(options.startDir);
     const skills = listAgentQaSkills(resolved.path);
     if (resolved.source === "missing" || skills.length === 0) {
@@ -5636,13 +5785,14 @@ function rejectRemovedCliSurface(input3 = {}) {
 
 // src/cli.ts
 rejectRemovedCliSurface();
-var program = new Command18();
+var program = new Command19();
 program.enablePositionalOptions();
 program.name("agent-qa").description("AI-powered testing framework").version(VERSION);
 program.option("--config <path>", "config file path", "agent-qa.config.yaml").option("--log-level <level>", "log verbosity: silent|error|warn|info|debug").option("--verbose", "shorthand for --log-level debug").option("--quiet", "shorthand for --log-level silent");
 program.addCommand(createRunCommand());
 program.addCommand(createInitCommand());
 program.addCommand(createInstallBrowsersCommand());
+program.addCommand(createInstallMobileDriversCommand());
 program.addCommand(createDoctorCommand());
 program.addCommand(createDashboardCommand());
 program.addCommand(createServeCommand());