agent-qa 0.1.17 → 0.1.19

package/dist/cli.js

@@ -598,10 +598,14 @@ function buildExampleTest(platform, variant) {
   const expectedUrl = variant === "pass" ? "https://www.iana.org/help/example-domains" : "https://www.iana.org/example-domains";
   const testId = variant === "pass" ? "t_amber-birch-coral-delta-ember-falcon-garden-harbor-island-jungle" : "t_bronze-cedar-dune-ember-fjord-glade-harbor-ivory-jade-kelp";
   const name = variant === "pass" ? "Example passing test" : "Example failing test";
+  const browserOverride = variant === "fail" && hasWeb(platform) ? `use:
+  browser:
+    headless: false
+` : "";
   return `test-id: ${testId}
 name: ${name}
 target: ${defaultExampleTargetName(platform)}
-steps:
+${browserOverride}steps:
   - Verify the page says "Example Domain"
   - Click on "Learn More"
   - Verify the page url is "${expectedUrl}"
@@ -2113,7 +2117,7 @@ init_config();
 import { randomUUID } from "crypto";
 import { resolve as resolvePath3 } from "path";
 import { Command as Command6 } from "commander";
-import pc7 from "picocolors";
+import pc8 from "picocolors";
 import { ATTR_RUNNER, ATTR_TRIGGER, AUTH_STATE_SCHEMA_VERSION, 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, normalizeAuthStateUse, parseRunAttrFlags, redactAuthStateValue, resolveAuthStateForRun, resolveAuthStatePaths, resolveMemoryRoot, resolveMobileRunConfig, validateTrustedRunAttributes } from "@vostride/agent-qa-core";
 import { discoverWorkspaceFiles as discoverWorkspaceFiles2, isWorkspacePathMatch, resolveWorkspaceFileTarget, resolveWorkspacePaths as resolveWorkspacePaths2 } from "@vostride/agent-qa-core";
 
@@ -2209,6 +2213,88 @@ function resolveProviderCredentials(transport, localBindings) {
 // src/commands/run.ts
 init_llm_utils();
 import { isPathInsideDir } from "@vostride/agent-qa-core";
+
+// src/version-notice.ts
+import { existsSync as existsSync3, readFileSync as readFileSync3 } from "fs";
+import { join as join5 } from "path";
+import pc7 from "picocolors";
+import { getAgentQaUpdateStatus } from "@vostride/agent-qa-core";
+var RELEASES_URL = "https://github.com/vostride/agent-qa/releases";
+var UPDATE_COMMANDS = {
+  pnpm: "pnpm add -D agent-qa@latest",
+  npm: "npm install --save-dev agent-qa@latest",
+  yarn: "yarn add --dev agent-qa@latest",
+  bun: "bun add --dev agent-qa@latest"
+};
+var LOCKFILES = [
+  { file: "pnpm-lock.yaml", packageManager: "pnpm" },
+  { file: "package-lock.json", packageManager: "npm" },
+  { file: "npm-shrinkwrap.json", packageManager: "npm" },
+  { file: "yarn.lock", packageManager: "yarn" },
+  { file: "bun.lock", packageManager: "bun" },
+  { file: "bun.lockb", packageManager: "bun" }
+];
+function shouldPrintAgentQaUpdateNotice(context) {
+  return Boolean(
+    context.reporterSelection.console && !context.reporterSelection.stdoutLive && context.liveEvents !== "true" && context.effectiveLogLevel !== "quiet" && context.effectiveLogLevel !== "silent"
+  );
+}
+function inferAgentQaDevDependencyUpdateCommand(cwd = process.cwd()) {
+  try {
+    const packageJsonPath = join5(cwd, "package.json");
+    if (!existsSync3(packageJsonPath)) return void 0;
+    const manifest = JSON.parse(readFileSync3(packageJsonPath, "utf-8"));
+    if (!isRecord(manifest) || !hasAgentQaDevDependency(manifest)) return void 0;
+    const packageManager = inferPackageManager(manifest, cwd);
+    return packageManager ? UPDATE_COMMANDS[packageManager] : void 0;
+  } catch {
+    return void 0;
+  }
+}
+async function printAgentQaUpdateNoticeIfNeeded(context) {
+  try {
+    if (!shouldPrintAgentQaUpdateNotice(context)) return;
+    const status = await getAgentQaUpdateStatus();
+    const installedVersion = status.installedVersion.trim();
+    const latestVersion = typeof status.latestVersion === "string" ? status.latestVersion.trim() : "";
+    if (!status.updateAvailable || !latestVersion) return;
+    const command = inferAgentQaDevDependencyUpdateCommand(context.cwd);
+    const log = context.log ?? console.log;
+    log();
+    log(`${pc7.bold("Update available:")} agent-qa v${latestVersion}`);
+    if (installedVersion) {
+      log(pc7.dim(`Current version: v${installedVersion}`));
+    }
+    log(`Releases: ${pc7.cyan(RELEASES_URL)}`);
+    if (command) {
+      log(`Update: ${pc7.cyan(command)}`);
+    }
+  } catch {
+  }
+}
+function hasAgentQaDevDependency(manifest) {
+  const devDependencies = manifest.devDependencies;
+  return isRecord(devDependencies) && Object.prototype.hasOwnProperty.call(devDependencies, "agent-qa");
+}
+function inferPackageManager(manifest, cwd) {
+  if (typeof manifest.packageManager === "string") {
+    return packageManagerFromSpecifier(manifest.packageManager);
+  }
+  const matchingLockfiles = LOCKFILES.filter(({ file }) => existsSync3(join5(cwd, file)));
+  return matchingLockfiles.length === 1 ? matchingLockfiles[0].packageManager : void 0;
+}
+function packageManagerFromSpecifier(specifier) {
+  const name = specifier.split("@")[0];
+  if (name === "pnpm" || name === "npm" || name === "yarn" || name === "bun") {
+    return name;
+  }
+  return void 0;
+}
+function isRecord(value) {
+  return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+
+// src/commands/run.ts
 var RUNTIME_ARTIFACTS_DIR = DEFAULT_AGENT_QA_ARTIFACTS_DIR || ".agent-qa/artifacts";
 var RUNTIME_CACHE_DIR = DEFAULT_AGENT_QA_CACHE_DIR3 || ".agent-qa/cache";
 var RUNTIME_VIDEOS_DIR = DEFAULT_AGENT_QA_VIDEOS_DIR || ".agent-qa/artifacts/videos";
@@ -2440,6 +2526,13 @@ async function flushAnalyticsRunReporter(reporter) {
   } catch {
   }
 }
+async function maybePrintPostRunUpdateNotice(context) {
+  try {
+    if (!shouldPrintAgentQaUpdateNotice(context)) return;
+    await printAgentQaUpdateNoticeIfNeeded(context);
+  } catch {
+  }
+}
 async function captureSingleAnalyticsResult(reporter, result) {
   if (!reporter?.onRunEnd) {
     await flushAnalyticsRunReporter(reporter);
@@ -2460,14 +2553,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" ? pc7.red("error") : pc7.yellow("warning");
+    const severity = err.severity === "error" ? pc8.red("error") : pc8.yellow("warning");
     console.error(`${severity}: ${err.message}`);
-    console.error(`  ${pc7.blue("-->")} ${location}`);
+    console.error(`  ${pc8.blue("-->")} ${location}`);
     if (err.source) {
-      console.error(`  ${pc7.blue("|")} ${err.source}`);
+      console.error(`  ${pc8.blue("|")} ${err.source}`);
     }
     if (err.suggestion) {
-      console.error(`  ${pc7.blue("=")} ${pc7.bold("help")}: ${err.suggestion}`);
+      console.error(`  ${pc8.blue("=")} ${pc8.bold("help")}: ${err.suggestion}`);
     }
     console.error();
   }
@@ -2483,14 +2576,14 @@ function printRunId(runId) {
 }
 function printMemoryStatus(log) {
   const parts = [];
-  if (log.added > 0) parts.push(pc7.green(`${log.added} added`));
+  if (log.added > 0) parts.push(pc8.green(`${log.added} added`));
   if (log.confirmed > 0) parts.push(`${log.confirmed} confirmed`);
-  if (log.deprecated > 0) parts.push(pc7.yellow(`${log.deprecated} deprecated`));
+  if (log.deprecated > 0) parts.push(pc8.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(`  ${pc7.dim("Memory:")} ${parts.join(", ")} ${pc7.dim(`(${secs})`)}`);
+  console.log(`  ${pc8.dim("Memory:")} ${parts.join(", ")} ${pc8.dim(`(${secs})`)}`);
   for (const err of log.errors) {
-    console.log(`  ${pc7.dim("Memory:")} ${pc7.yellow(`warning -- ${err}`)}`);
+    console.log(`  ${pc8.dim("Memory:")} ${pc8.yellow(`warning -- ${err}`)}`);
   }
 }
 function isGlobLikePattern(value) {
@@ -2562,21 +2655,21 @@ function buildHooksArtifact(hooks) {
 async function loadRuntimeSecrets(input3) {
   const configuredSecretsFile = input3.config.workspace?.secretsFile;
   if (typeof configuredSecretsFile !== "string" || configuredSecretsFile.trim().length === 0) {
-    console.error(pc7.red("Error: workspace.secretsFile is required. Run `agent-qa init` or set it in agent-qa.config.yaml."));
+    console.error(pc8.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(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."));
+    console.error(pc8.red(`Error: Secrets file not found: ${secretsPath}`));
+    console.error(pc8.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(pc7.red(`Error: Secrets file could not be read: ${secretsPath}`));
-    console.error(pc7.dim("Check the path and file permissions before running tests."));
+    console.error(pc8.red(`Error: Secrets file could not be read: ${secretsPath}`));
+    console.error(pc8.dim("Check the path and file permissions before running tests."));
     process.exit(1);
   }
   try {
@@ -2593,7 +2686,7 @@ async function loadRuntimeSecrets(input3) {
     };
   } catch (err) {
     const message = err instanceof Error ? err.message : String(err);
-    console.error(pc7.red(`Error: Secrets file is invalid: ${message}`));
+    console.error(pc8.red(`Error: Secrets file is invalid: ${message}`));
     process.exit(1);
   }
 }
@@ -2724,7 +2817,7 @@ async function resolveSelectedAuthStateForRun(input3) {
       target: { platform: input3.resolvedTarget.platform }
     });
   } catch (err) {
-    console.error(pc7.red(`Error: ${err instanceof Error ? err.message : String(err)}`));
+    console.error(pc8.red(`Error: ${err instanceof Error ? err.message : String(err)}`));
     process.exit(2);
   }
 }
@@ -2739,7 +2832,7 @@ function resolveAuthStateCapturePathsForRun(input3) {
       target: { platform: input3.resolvedTarget.platform }
     });
   } catch (err) {
-    console.error(pc7.red(`Error: ${err instanceof Error ? err.message : String(err)}`));
+    console.error(pc8.red(`Error: ${err instanceof Error ? err.message : String(err)}`));
     process.exit(2);
   }
 }
@@ -2832,7 +2925,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(pc7.red(`Error: ${reporterSelectionResult.error}`));
+    console.error(pc8.red(`Error: ${reporterSelectionResult.error}`));
     process.exit(2);
   }
   const reporterSelection = reporterSelectionResult.selection;
@@ -2848,7 +2941,7 @@ async function executeSuites(suiteFiles, opts, config, globalOpts, configContent
       activeSuiteDbs.add(dashboardDb);
       return { dashboardDb, logStorage: dashboardDb };
     } catch (err) {
-      console.warn(pc7.yellow(`Warning: Could not load dashboard reporter: ${err instanceof Error ? err.message : String(err)}`));
+      console.warn(pc8.yellow(`Warning: Could not load dashboard reporter: ${err instanceof Error ? err.message : String(err)}`));
       return {};
     }
   };
@@ -2897,7 +2990,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(pc7.red(`Path traversal rejected: ${relativePath}`));
+        console.error(pc8.red(`Path traversal rejected: ${relativePath}`));
         const runId = createSuiteRunId();
         if (dashboardDb) {
           const now = (/* @__PURE__ */ new Date()).toISOString();
@@ -2935,7 +3028,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(pc7.red(`Parse errors in ${relativePath}:`));
+        console.error(pc8.red(`Parse errors in ${relativePath}:`));
         formatParseErrors(parseResult.errors);
         const runId = createSuiteRunId();
         if (dashboardDb) {
@@ -2977,7 +3070,7 @@ async function executeSuites(suiteFiles, opts, config, globalOpts, configContent
         process.exit(2);
       }
       if (parseResult.tests.length === 0) {
-        console.error(pc7.red(`No test definition found in ${relativePath}`));
+        console.error(pc8.red(`No test definition found in ${relativePath}`));
         const runId = createSuiteRunId();
         if (dashboardDb) {
           const now = (/* @__PURE__ */ new Date()).toISOString();
@@ -3014,12 +3107,12 @@ async function executeSuites(suiteFiles, opts, config, globalOpts, configContent
       const testDef = parseResult.tests[0];
       const childAuthStateUse = getSelectedAuthStateUse(testDef.use);
       if (suiteAuthStateUse && childAuthStateUse && childAuthStateUse.name !== suiteAuthStateUse.name) {
-        console.error(pc7.red(`Suite auth state "${suiteAuthStateUse.name}" conflicts with child test auth state "${childAuthStateUse.name}". Use one primary auth state per suite.`));
+        console.error(pc8.red(`Suite auth state "${suiteAuthStateUse.name}" conflicts with child test auth state "${childAuthStateUse.name}". Use one primary auth state per suite.`));
         process.exit(2);
       }
       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(pc7.red(mismatchMsg));
+        console.error(pc8.red(mismatchMsg));
         const runId = createSuiteRunId();
         if (dashboardDb) {
           const now = (/* @__PURE__ */ new Date()).toISOString();
@@ -3270,7 +3363,7 @@ async function executeSuites(suiteFiles, opts, config, globalOpts, configContent
           curatorLockTimeout: suiteMemoryConfig?.curatorLockTimeout
         });
       } catch (err) {
-        console.warn(`  ${pc7.dim("Memory:")} init error -- ${err.message}`);
+        console.warn(`  ${pc8.dim("Memory:")} init error -- ${err.message}`);
       }
       if (suiteMemoryConfig?.circuitBreakerEnabled !== false) {
         const { CircuitBreaker } = await import("@vostride/agent-qa-core");
@@ -3415,19 +3508,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(pc7.yellow("\nBailing out \u2014 stopping after first failed suite"));
+      console.log(pc8.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(pc7.yellow("\nBailing out \u2014 stopping after first failed suite"));
+      console.log(pc8.yellow("\nBailing out \u2014 stopping after first failed suite"));
       break;
     }
   }
   const finalBatchOutcome = await flushSuiteParents();
   if (opts.bail && finalBatchOutcome.failed) {
-    console.log(pc7.yellow("\nBailing out \u2014 stopping after first failed suite"));
+    console.log(pc8.yellow("\nBailing out \u2014 stopping after first failed suite"));
   }
   process.removeListener("SIGINT", handleShutdown);
   process.removeListener("SIGTERM", handleShutdown);
@@ -3440,7 +3533,7 @@ function createRunCommand() {
     try {
       const modeFlags = [opts.test, opts.suite, opts.all].filter(Boolean).length;
       if (modeFlags > 1) {
-        console.error(pc7.red("Error: --test, --suite, and --all are mutually exclusive."));
+        console.error(pc8.red("Error: --test, --suite, and --all are mutually exclusive."));
         process.exit(1);
       }
       const program2 = command.parent;
@@ -3468,7 +3561,7 @@ function createRunCommand() {
       } catch {
       }
       const { parseEnvFile } = await import("@vostride/agent-qa-core");
-      const { readFileSync: readFileSync5, existsSync: existsSync8 } = await import("fs");
+      const { readFileSync: readFileSync6, existsSync: existsSync9 } = await import("fs");
       const configDir = workspacePaths.configDir;
       const cliVars = parseVarFlags(opts.var);
       const inheritedContextRunId = process.env.AGENT_QA_RUN_ID ?? process.env.AGENT_QA_SUITE_QUEUE_ID ?? process.env.AGENT_QA_PARENT_RUN_ID;
@@ -3481,7 +3574,7 @@ function createRunCommand() {
           console.warn(`Warning: duplicate --run-attr key "${duplicateKey}"; using last value`);
         }
       } catch (err) {
-        console.error(pc7.red(`Error: ${err instanceof Error ? err.message : String(err)}`));
+        console.error(pc8.red(`Error: ${err instanceof Error ? err.message : String(err)}`));
         process.exit(2);
       }
       const inlineVars = {};
@@ -3489,37 +3582,37 @@ function createRunCommand() {
         config,
         configDir,
         secretsFilePath: workspacePaths.secretsFile.absolutePath,
-        readFileSync: readFileSync5,
-        existsSync: existsSync8
+        readFileSync: readFileSync6,
+        existsSync: existsSync9
       });
       let envFileVars = {};
       let rawEnvFileContent = null;
       let resolvedEnvFilePath = null;
       resolvedEnvFilePath = workspacePaths.envFile.absolutePath;
-      if (!existsSync8(workspacePaths.envFile.absolutePath)) {
-        console.error(pc7.red(`Error: Env file not found: ${workspacePaths.envFile.absolutePath}`));
+      if (!existsSync9(workspacePaths.envFile.absolutePath)) {
+        console.error(pc8.red(`Error: Env file not found: ${workspacePaths.envFile.absolutePath}`));
         process.exit(1);
       }
       try {
-        rawEnvFileContent = readFileSync5(workspacePaths.envFile.absolutePath, "utf-8");
+        rawEnvFileContent = readFileSync6(workspacePaths.envFile.absolutePath, "utf-8");
         envFileVars = parseEnvFile(rawEnvFileContent);
       } catch {
-        console.error(pc7.red(`Error: Env file could not be read: ${workspacePaths.envFile.absolutePath}`));
+        console.error(pc8.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(pc7.red(`Error: Hooks file not found: ${hooksFilePath}`));
+      if (!existsSync9(hooksFilePath)) {
+        console.error(pc8.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(pc7.red("Hooks configuration errors:"));
-          for (const err of errors) console.error(pc7.red(`  - ${err}`));
+          console.error(pc8.red("Hooks configuration errors:"));
+          for (const err of errors) console.error(pc8.red(`  - ${err}`));
           process.exit(1);
         }
         resolvedHooks = new Map(hooks.map((h) => [h.id, h]));
@@ -3528,8 +3621,8 @@ function createRunCommand() {
           secretRedactor: runtimeSecrets.secretRedactor
         };
       } catch (err) {
-        console.error(pc7.red(`Error: Hooks file could not be read: ${hooksFilePath}`));
-        if (err instanceof Error && err.message) console.error(pc7.dim(err.message));
+        console.error(pc8.red(`Error: Hooks file could not be read: ${hooksFilePath}`));
+        if (err instanceof Error && err.message) console.error(pc8.dim(err.message));
         process.exit(1);
       }
       let agentRulesContent;
@@ -3537,7 +3630,7 @@ function createRunCommand() {
       try {
         agentRulesContent = await readFileAsync(workspacePaths.agentRules.absolutePath, "utf-8");
       } catch {
-        console.error(pc7.red(`Error: Agent rules file not found: ${workspacePaths.agentRules.absolutePath}`));
+        console.error(pc8.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";
@@ -3549,21 +3642,21 @@ function createRunCommand() {
           discoveredTestFiles = selected.tests;
           discoveredSuiteFiles = selected.suites;
         } catch (err) {
-          console.error(pc7.red(`Error: ${err instanceof Error ? err.message : String(err)}`));
+          console.error(pc8.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(pc7.red(`Error: No ${patternKind} files found matching patterns:`));
-          for (const p of patterns) console.error(pc7.red(`  ${p}`));
+          console.error(pc8.red(`Error: No ${patternKind} files found matching patterns:`));
+          for (const p of patterns) console.error(pc8.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(pc7.red("Error: No suite files found matching workspace.suiteMatch"));
+          console.error(pc8.red("Error: No suite files found matching workspace.suiteMatch"));
           for (const p of workspacePaths.suiteMatch) {
-            console.error(pc7.red(`  ${p}`));
+            console.error(pc8.red(`  ${p}`));
           }
           process.exit(2);
         }
@@ -3571,26 +3664,36 @@ 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(pc7.red("Error: No test or suite files found. Check workspace.testMatch and workspace.suiteMatch in agent-qa.config.yaml"));
+          console.error(pc8.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(pc7.red("Error: No testMatch patterns in config. Add workspace.testMatch to agent-qa.config.yaml."));
+          console.error(pc8.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(pc7.red("Error: No test files found matching workspace.testMatch"));
+          console.error(pc8.red("Error: No test files found matching workspace.testMatch"));
           for (const p of workspacePaths.testMatch) {
-            console.error(pc7.red(`  ${p}`));
+            console.error(pc8.red(`  ${p}`));
           }
           process.exit(2);
         }
       }
       if (discoveredSuiteFiles.length > 0 && discoveredTestFiles.length === 0) {
         const hasFailed2 = await executeSuites(discoveredSuiteFiles, opts, config, globalOpts, configContent, effectiveLogLevel, { envFileVars, inlineVars, cliVars, rawEnvFileContent, resolvedEnvFilePath, userRunAttributes, inheritedRunAttributes, ...runtimeSecrets }, resolvedHooks && sandboxOptions ? { resolvedHooks, sandboxOptions } : void 0);
-        process.exit(hasFailed2 ? 1 : 0);
+        const exitCode2 = hasFailed2 ? 1 : 0;
+        const suiteReporterSelection = resolveReporterSelection(opts, Boolean(config.services?.dashboard)).selection;
+        if (suiteReporterSelection) {
+          await maybePrintPostRunUpdateNotice({
+            reporterSelection: suiteReporterSelection,
+            effectiveLogLevel,
+            liveEvents: process.env.AGENT_QA_LIVE_EVENTS,
+            cwd: process.cwd()
+          });
+        }
+        process.exit(exitCode2);
       }
       let suitesFailed = false;
       if (discoveredSuiteFiles.length > 0 && discoveredTestFiles.length > 0) {
@@ -3598,7 +3701,7 @@ function createRunCommand() {
       }
       const files = discoveredTestFiles;
       if (opts.listTests) {
-        console.log(pc7.bold(`
+        console.log(pc8.bold(`
 Discovered ${files.length} test file(s):
 `));
         for (const file of files) {
@@ -3610,7 +3713,7 @@ Discovered ${files.length} test file(s):
       const dashboardCfg2 = config.services?.dashboard;
       const reporterSelectionResult = resolveReporterSelection(opts, Boolean(dashboardCfg2));
       if (reporterSelectionResult.error) {
-        console.error(pc7.red(`Error: ${reporterSelectionResult.error}`));
+        console.error(pc8.red(`Error: ${reporterSelectionResult.error}`));
         process.exit(2);
       }
       const reporterSelection = reporterSelectionResult.selection;
@@ -3627,13 +3730,13 @@ Discovered ${files.length} test file(s):
           logStorage = dashboardDb;
           _crashDb = dashboardDb;
         } catch (err) {
-          console.warn(pc7.yellow(`Warning: Could not load dashboard reporter: ${err instanceof Error ? err.message : String(err)}`));
+          console.warn(pc8.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(pc7.red(`Found ${parseResult.errors.length} parse error(s):
+        console.error(pc8.red(`Found ${parseResult.errors.length} parse error(s):
 `));
         for (const err of parseResult.errors) {
           console.error(formatParseError(err));
@@ -3644,8 +3747,8 @@ Discovered ${files.length} test file(s):
           const now = (/* @__PURE__ */ new Date()).toISOString();
           const { basename: basename2 } = await import("path");
           const errorText = parseResult.errors.map((e) => formatParseError(e)).join("\n").replace(/\x1b\[[0-9;]*m/g, "");
-          const { readFileSync: readFileSync6 } = await import("fs");
-          const rawContent = readFileSync6(files[0], "utf-8");
+          const { readFileSync: readFileSync7 } = await import("fs");
+          const rawContent = readFileSync7(files[0], "utf-8");
           const nameMatch = rawContent.match(/^\s*name:\s*(.+)$/m);
           const targetMatch = rawContent.match(/^\s*target:\s*(.+)$/m);
           let detectedPlatform = "web";
@@ -3729,17 +3832,17 @@ Discovered ${files.length} test file(s):
       }
       const filtered = parseResult.tests;
       if (filtered.length === 0) {
-        console.log(pc7.yellow("No tests match filters"));
+        console.log(pc8.yellow("No tests match filters"));
         process.exit(0);
       }
       if (opts.dryRun) {
-        console.log(pc7.bold(`
+        console.log(pc8.bold(`
 Found ${filtered.length} test(s):
 `));
         for (const test of filtered) {
-          console.log(`  ${pc7.green("\u25CF")} ${test.name}`);
+          console.log(`  ${pc8.green("\u25CF")} ${test.name}`);
           if (opts.configDebug) {
-            console.log(pc7.bold(`
+            console.log(pc8.bold(`
   Config for: ${test.name}`));
             console.log(formatConfigDebug(config, test.use, flagOverrides));
             console.log();
@@ -3789,7 +3892,7 @@ Found ${filtered.length} test(s):
             }
           }));
         } catch (err) {
-          console.warn(pc7.yellow(`Warning: Could not load dashboard reporter: ${err instanceof Error ? err.message : String(err)}`));
+          console.warn(pc8.yellow(`Warning: Could not load dashboard reporter: ${err instanceof Error ? err.message : String(err)}`));
         }
       }
       const analyticsReporter = createAnalyticsRunReporter({ config, surface: "cli" });
@@ -3883,7 +3986,7 @@ Found ${filtered.length} test(s):
             const testMergedConfig = { ...config, use: mergedUse };
             const effectiveCacheEnabled = opts.cache !== false && mergedUse.cache !== false;
             if (opts.configDebug) {
-              console.log(pc7.bold(`
+              console.log(pc8.bold(`
 Config for: ${test.name}`));
               console.log(formatConfigDebug(config, test.use, testFlagOverrides));
               console.log();
@@ -4008,7 +4111,7 @@ Config for: ${test.name}`));
                 });
               }
               if (effectiveLogLevel === "debug") {
-                console.log(pc7.dim(`  Platform: ${testPlatform}${useFarm ? ` (farm: ${testResolvedDevice?.transport})` : ""}${testPlatform !== "web" ? " (adapter re-created)" : ""}`));
+                console.log(pc8.dim(`  Platform: ${testPlatform}${useFarm ? ` (farm: ${testResolvedDevice?.transport})` : ""}${testPlatform !== "web" ? " (adapter re-created)" : ""}`));
               }
             }
             const mergedForLLM = { registry: config.registry, use: testMergedConfig.use ?? config.use };
@@ -4019,7 +4122,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(pc7.dim(`  Model: ${plannerCfg.model} (${plannerCfg.provider})`));
+              console.log(pc8.dim(`  Model: ${plannerCfg.model} (${plannerCfg.provider})`));
             }
             const plannerModel = await createModel(plannerModelConfig);
             const verifierModel = await createModel(verifierModelConfig);
@@ -4186,7 +4289,7 @@ Config for: ${test.name}`));
                 const testId = testDef["test-id"] ?? testDef.name;
                 memoryInitParams = { product, testId, memoryRoot };
               } catch (err) {
-                console.warn(`  ${pc7.dim("Memory:")} init error -- ${err.message}`);
+                console.warn(`  ${pc8.dim("Memory:")} init error -- ${err.message}`);
               }
             }
             const result = await runTestWithRetry(testDef, {
@@ -4300,7 +4403,7 @@ Config for: ${test.name}`));
               try {
                 const { shouldAblate, collectAllInjectedIds, deprecateOnFailure } = await import("@vostride/agent-qa-core");
                 if (shouldAblate(result, memoryProvider)) {
-                  console.log(`  ${pc7.dim("Memory:")} ablation retry -- re-running without memory...`);
+                  console.log(`  ${pc8.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);
@@ -4348,7 +4451,7 @@ Config for: ${test.name}`));
                       circuitBreaker.record({ withMemory: false, passed: ablationResult.status === "passed" });
                     }
                     if (ablationResult.status === "passed") {
-                      console.log(`  ${pc7.dim("Memory:")} ablation confirmed memory caused failure -- penalizing observations`);
+                      console.log(`  ${pc8.dim("Memory:")} ablation confirmed memory caused failure -- penalizing observations`);
                       const injectedMap = collectAllInjectedIds(result, memoryProvider);
                       await deprecateOnFailure({
                         testResult: result,
@@ -4359,14 +4462,14 @@ Config for: ${test.name}`));
                       });
                       ablationHandledDeprecation = true;
                     } else {
-                      console.log(`  ${pc7.dim("Memory:")} ablation retry also failed -- memory not the cause`);
+                      console.log(`  ${pc8.dim("Memory:")} ablation retry also failed -- memory not the cause`);
                     }
                   } finally {
                     await ablationAdapter.cleanup();
                   }
                 }
               } catch (err) {
-                console.warn(`  ${pc7.dim("Memory:")} ablation error -- ${err.message}`);
+                console.warn(`  ${pc8.dim("Memory:")} ablation error -- ${err.message}`);
               }
             }
             if (memoryProvider && memoryConfig?.curatorEnabled !== false && !ablationHandledDeprecation) {
@@ -4400,7 +4503,7 @@ Config for: ${test.name}`));
                   }
                 }
               } catch (err) {
-                console.warn(`  ${pc7.dim("Memory:")} curator error -- ${err.message}`);
+                console.warn(`  ${pc8.dim("Memory:")} curator error -- ${err.message}`);
               }
             }
             if (testAuthStateUse?.capture === true) {
@@ -4414,12 +4517,12 @@ Config for: ${test.name}`));
             }
             if (circuitBreaker?.isTripped() && !circuitBreakerTripped) {
               circuitBreakerTripped = true;
-              console.log(`  ${pc7.yellow("Memory: circuit breaker tripped -- disabling memory injection for remaining tests")}`);
+              console.log(`  ${pc8.yellow("Memory: circuit breaker tripped -- disabling memory injection for remaining tests")}`);
             }
             if (result.status === "failed" && !authStateCaptureFailed && actionCache && effectiveCacheEnabled && result.steps.length > 0) {
               const { hashStepInstruction: hashStepInstruction2 } = await import("@vostride/agent-qa-core");
               const { rm: rm3 } = await import("fs/promises");
-              const { resolve: resolve9, join: join8 } = await import("path");
+              const { resolve: resolve9, join: join9 } = await import("path");
               const cacheDir = resolve9(configDir, config.services?.cache?.dir ?? RUNTIME_CACHE_DIR);
               const cacheLog = logger.createScopedLogger("cache");
               let purged = 0;
@@ -4427,7 +4530,7 @@ Config for: ${test.name}`));
                 const step = result.steps[i];
                 const stepHash = hashStepInstruction2(step.name, testPlatform, configContent, testFileContent, i);
                 try {
-                  await rm3(join8(cacheDir, stepHash), { recursive: true, force: true });
+                  await rm3(join9(cacheDir, stepHash), { recursive: true, force: true });
                   purged++;
                 } catch {
                 }
@@ -4499,13 +4602,13 @@ Config for: ${test.name}`));
         }
         const parallelBatchFailed = await flushParallelRuns();
         if (opts.bail && parallelBatchFailed) {
-          console.log(pc7.yellow("\nBailing out \u2014 stopping after first failure"));
+          console.log(pc8.yellow("\nBailing out \u2014 stopping after first failure"));
           bailTriggered = true;
           break;
         }
         const outcome = await runOneDirectTest(test);
         if (opts.bail && outcome.failed) {
-          console.log(pc7.yellow("\nBailing out \u2014 stopping after first failure"));
+          console.log(pc8.yellow("\nBailing out \u2014 stopping after first failure"));
           bailTriggered = true;
           break;
         }
@@ -4513,7 +4616,7 @@ Config for: ${test.name}`));
       if (!bailTriggered) {
         const parallelBatchFailed = await flushParallelRuns();
         if (opts.bail && parallelBatchFailed) {
-          console.log(pc7.yellow("\nBailing out \u2014 stopping after first failure"));
+          console.log(pc8.yellow("\nBailing out \u2014 stopping after first failure"));
         }
       }
       releaseAppium();
@@ -4527,12 +4630,19 @@ Config for: ${test.name}`));
         dashboardDb.close();
       }
       const hasFailed = results.some((r) => r.status === "failed") || suitesFailed;
-      process.exit(hasFailed ? 1 : 0);
+      const exitCode = hasFailed ? 1 : 0;
+      await maybePrintPostRunUpdateNotice({
+        reporterSelection,
+        effectiveLogLevel,
+        liveEvents: process.env.AGENT_QA_LIVE_EVENTS,
+        cwd: process.cwd()
+      });
+      process.exit(exitCode);
     } catch (err) {
       const errMsg = err instanceof Error ? err.message : String(err);
       const errStack = err instanceof Error ? err.stack ?? "" : "";
       const formattedError = formatFrameworkError(errMsg);
-      console.error(pc7.red(formattedError.displayMessage));
+      console.error(pc8.red(formattedError.displayMessage));
       if (_crashDb) {
         const fullError = `${errMsg}
 ${errStack}`;
@@ -4589,7 +4699,7 @@ init_model_defaults();
 import { Command as Command7 } from "commander";
 import { resolve as resolve5, dirname as dirname6 } from "path";
 import { createRequire as createRequire2 } from "module";
-import pc8 from "picocolors";
+import pc9 from "picocolors";
 import { flushAnalytics, resolveWorkspacePaths as resolveWorkspacePaths3 } from "@vostride/agent-qa-core";
 async function startDashboardBackedServices(opts, command, labels) {
   try {
@@ -4642,7 +4752,7 @@ async function startDashboardBackedServices(opts, command, labels) {
       uiDir = resolve5(dirname6(pkgPath), "dist");
     } catch {
       if (globalOpts.verbose) {
-        console.log(pc8.yellow("Warning: @vostride/agent-qa-dashboard-ui not found \u2014 API-only mode"));
+        console.log(pc9.yellow("Warning: @vostride/agent-qa-dashboard-ui not found \u2014 API-only mode"));
       }
     }
     const { close } = await startServer({
@@ -4665,7 +4775,7 @@ async function startDashboardBackedServices(opts, command, labels) {
     const shutdown = async () => {
       if (shuttingDown) return;
       shuttingDown = true;
-      console.log(pc8.dim(`
+      console.log(pc9.dim(`
 Shutting down ${labels.shutdown}...`));
       close();
       await flushAnalytics({ config }).catch(() => {
@@ -4675,7 +4785,7 @@ Shutting down ${labels.shutdown}...`));
     process.on("SIGINT", shutdown);
     process.on("SIGTERM", shutdown);
   } catch (err) {
-    console.error(pc8.red(`${labels.error} error: ${err instanceof Error ? err.message : String(err)}`));
+    console.error(pc9.red(`${labels.error} error: ${err instanceof Error ? err.message : String(err)}`));
     process.exit(2);
   }
 }
@@ -4701,7 +4811,7 @@ function createServeCommand() {
 // src/commands/mcp.ts
 init_config();
 import { Command as Command8 } from "commander";
-import pc9 from "picocolors";
+import pc10 from "picocolors";
 import { flushAnalytics as flushAnalytics2 } from "@vostride/agent-qa-core";
 function createMcpCommand() {
   const cmd = new Command8("mcp").description("Start MCP (Model Context Protocol) server over stdio").action(async (command) => {
@@ -4723,7 +4833,7 @@ function createMcpCommand() {
         });
       }
     } catch (err) {
-      console.error(pc9.red("Failed to start MCP server:"), err instanceof Error ? err.message : String(err));
+      console.error(pc10.red("Failed to start MCP server:"), err instanceof Error ? err.message : String(err));
       process.exitCode = 1;
     }
   });
@@ -4733,7 +4843,7 @@ function createMcpCommand() {
 // src/commands/config.ts
 init_config();
 import { Command as Command9 } from "commander";
-import pc10 from "picocolors";
+import pc11 from "picocolors";
 import { parseDocument, Document } from "yaml";
 import { readFile as readFile3, writeFile } from "fs/promises";
 import { createInterface as createInterface2 } from "readline";
@@ -4778,14 +4888,14 @@ async function getValue(key, providedValue) {
 }
 async function setAction(key, value) {
   if (isSensitiveKey(key)) {
-    console.error(pc10.red("Credential values are not written by config set."));
+    console.error(pc11.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(pc10.red("No value provided."));
+    console.error(pc11.red("No value provided."));
     return;
   }
   const configPath = "agent-qa.config.yaml";
@@ -4802,7 +4912,7 @@ async function setAction(key, value) {
   }
   doc.setIn(key.split("."), resolved);
   await writeFile(configPath, doc.toString());
-  console.log(pc10.green(`\u2713 ${key} = ${resolved} saved to agent-qa.config.yaml`));
+  console.log(pc11.green(`\u2713 ${key} = ${resolved} saved to agent-qa.config.yaml`));
 }
 async function showAction() {
   const fileConfig = await loadConfigFile("agent-qa.config.yaml");
@@ -4810,7 +4920,7 @@ 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(pc10.bold("\nResolved Configuration:\n"));
+  console.log(pc11.bold("\nResolved Configuration:\n"));
   console.log(table);
   console.log();
 }
@@ -4824,7 +4934,7 @@ function createConfigCommand() {
 // src/commands/queue.ts
 init_config();
 import { Command as Command10 } from "commander";
-import pc11 from "picocolors";
+import pc12 from "picocolors";
 function timeAgo(dateStr) {
   const diff = Date.now() - new Date(dateStr).getTime();
   const seconds = Math.floor(diff / 1e3);
@@ -4858,13 +4968,13 @@ function createQueueCommand() {
       try {
         const response = await fetch(endpoint);
         if (!response.ok) {
-          console.error(pc11.red(`Server returned ${response.status}: ${response.statusText}`));
+          console.error(pc12.red(`Server returned ${response.status}: ${response.statusText}`));
           process.exit(1);
         }
         data = await response.json();
       } catch {
-        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"));
+        console.error(pc12.red(`Could not connect to dashboard server at ${serverUrl}`));
+        console.error(pc12.dim("Make sure the dashboard is running: agent-qa dashboard"));
         process.exit(1);
       }
       if (opts.json) {
@@ -4872,19 +4982,19 @@ function createQueueCommand() {
         return;
       }
       console.log();
-      console.log(pc11.bold("Queue Status"));
-      console.log(`  Concurrency: ${pc11.blue(String(data.concurrency))} slots (${pc11.yellow(String(data.activeSlots))} active)`);
+      console.log(pc12.bold("Queue Status"));
+      console.log(`  Concurrency: ${pc12.blue(String(data.concurrency))} slots (${pc12.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(pc11.dim("  Queue is empty \u2014 no pending or running jobs"));
+        console.log(pc12.dim("  Queue is empty \u2014 no pending or running jobs"));
         console.log();
         return;
       }
       if (pending.length > 0) {
-        console.log(pc11.bold(`Pending (${pending.length} jobs):`));
-        console.log(pc11.dim("  #   ID            Name                Priority  Source      Queued"));
+        console.log(pc12.bold(`Pending (${pending.length} jobs):`));
+        console.log(pc12.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);
@@ -4893,37 +5003,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} ${pc11.dim(id)}  ${name}  ${priority}  ${source}  ${pc11.dim(queued)}`);
+          console.log(`  ${num} ${pc12.dim(id)}  ${name}  ${priority}  ${source}  ${pc12.dim(queued)}`);
         }
         console.log();
       }
       if (running.length > 0) {
-        console.log(pc11.bold(`Running (${running.length} jobs):`));
-        console.log(pc11.dim("  ID            Name                Source      Started"));
+        console.log(pc12.bold(`Running (${running.length} jobs):`));
+        console.log(pc12.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(`  ${pc11.green(id)}  ${name}  ${source}  ${pc11.dim(started)}`);
+          console.log(`  ${pc12.green(id)}  ${name}  ${source}  ${pc12.dim(started)}`);
         }
         console.log();
       }
       if (opts.all && data.recent?.length > 0) {
-        console.log(pc11.bold(`Recent (${data.recent.length} jobs):`));
-        console.log(pc11.dim("  ID            Name                Status    Duration"));
+        console.log(pc12.bold(`Recent (${data.recent.length} jobs):`));
+        console.log(pc12.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" ? pc11.green : job.status === "failed" ? pc11.red : pc11.dim;
-          console.log(`  ${pc11.dim(id)}  ${name}  ${statusColor(status)}  ${pc11.dim(duration)}`);
+          const statusColor = job.status === "passed" ? pc12.green : job.status === "failed" ? pc12.red : pc12.dim;
+          console.log(`  ${pc12.dim(id)}  ${name}  ${statusColor(status)}  ${pc12.dim(duration)}`);
         }
         console.log();
       }
     } catch (err) {
-      console.error(pc11.red(`Error: ${err instanceof Error ? err.message : String(err)}`));
+      console.error(pc12.red(`Error: ${err instanceof Error ? err.message : String(err)}`));
       process.exit(1);
     }
   });
@@ -4936,25 +5046,25 @@ function createQueueCommand() {
       try {
         response = await fetch(`${serverUrl}/api/runs/${runId}/cancel`, { method: "POST" });
       } catch {
-        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"));
+        console.error(pc12.red(`Could not connect to dashboard server at ${serverUrl}`));
+        console.error(pc12.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(pc11.green(`\u2713 Cancelled job ${runId}`));
+          console.log(pc12.green(`\u2713 Cancelled job ${runId}`));
         } else {
-          console.log(pc11.red(`Failed to cancel: ${data.error ?? "Unknown error"}`));
+          console.log(pc12.red(`Failed to cancel: ${data.error ?? "Unknown error"}`));
         }
       } else if (response.status === 404) {
-        console.log(pc11.red(`Job not found: ${runId}`));
+        console.log(pc12.red(`Job not found: ${runId}`));
       } else {
         const data = await response.json().catch(() => ({}));
-        console.log(pc11.red(`Failed to cancel: ${data.error ?? response.statusText}`));
+        console.log(pc12.red(`Failed to cancel: ${data.error ?? response.statusText}`));
       }
     } catch (err) {
-      console.error(pc11.red(`Error: ${err instanceof Error ? err.message : String(err)}`));
+      console.error(pc12.red(`Error: ${err instanceof Error ? err.message : String(err)}`));
       process.exit(1);
     }
   });
@@ -4991,7 +5101,7 @@ function createValidateCommand() {
 // src/commands/auth.ts
 import { Command as Command12 } from "commander";
 import { exec } from "child_process";
-import pc12 from "picocolors";
+import pc13 from "picocolors";
 import input2 from "@inquirer/input";
 import password from "@inquirer/password";
 var PROVIDER_LABELS = {
@@ -5026,10 +5136,10 @@ function getGlobalConfigPath2(command) {
   return command.parent?.parent?.opts().config ?? command.parent?.opts().config;
 }
 function printCredentialGuidance(configName, provider) {
-  console.log(pc12.red(`Config ${configName} uses ${providerLabel(provider)} credentials.`));
-  console.log(pc12.dim("Use agent-qa auth set --config <name> --type api-key"));
+  console.log(pc13.red(`Config ${configName} uses ${providerLabel(provider)} credentials.`));
+  console.log(pc13.dim("Use agent-qa auth set --config <name> --type api-key"));
   if (provider === "anthropic-compatible") {
-    console.log(pc12.dim("or --type bearer-token"));
+    console.log(pc13.dim("or --type bearer-token"));
   }
 }
 function applyAuthToModelConfig(llmConfig, auth) {
@@ -5049,15 +5159,15 @@ function applyAuthToModelConfig(llmConfig, auth) {
 function statusForResolvedAuth(auth) {
   switch (auth.kind) {
     case "api-key":
-      return pc12.green("Saved API key");
+      return pc13.green("Saved API key");
     case "bearer-token":
-      return pc12.green("Saved bearer token");
+      return pc13.green("Saved bearer token");
     case "auth-fetch":
-      return Number(auth.expires ?? Date.now() + 1) <= Date.now() ? pc12.red("Expired") : pc12.green("OAuth connected");
+      return Number(auth.expires ?? Date.now() + 1) <= Date.now() ? pc13.red("Expired") : pc13.green("OAuth connected");
     case "unauthenticated":
-      return pc12.dim("No credential");
+      return pc13.dim("No credential");
     case "missing":
-      return pc12.red("Missing credential");
+      return pc13.red("Missing credential");
   }
 }
 function extractProviderError(err) {
@@ -5088,16 +5198,16 @@ function openAuthorizationUrl(url) {
   });
 }
 function printMissingSubscriptionPluginGuidance(configName, provider) {
-  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."));
+  console.log(pc13.red(`Provider "${provider}" is configured for "${configName}", but no auth plugin is registered.`));
+  console.log(pc13.dim(`Config: ${configName}`));
+  console.log(pc13.dim(`Provider: ${provider}`));
+  console.log(pc13.dim("Add the subscription auth plugin to package.json and install with your package manager:"));
+  console.log(pc13.dim('  "devDependencies": { "@vostride/agent-qa-subscription-auth": "<agent-qa version>" }'));
+  console.log(pc13.dim("Declare it in agent-qa.config.yaml under plugins.auth:"));
+  console.log(pc13.dim("  plugins:"));
+  console.log(pc13.dim("    auth:"));
+  console.log(pc13.dim("      - package: @vostride/agent-qa-subscription-auth"));
+  console.log(pc13.dim("Then authenticate from agent-qa dashboard or rerun this command."));
 }
 async function readTokensFromPlugin(provider, plugin, started) {
   if (started.waitForTokens) {
@@ -5105,19 +5215,19 @@ async function readTokensFromPlugin(provider, plugin, started) {
   }
   if (plugin.dashboardAuth.mode === "manual-code") {
     if (!plugin.exchangeCode) {
-      console.log(pc12.red(`Provider "${provider}" does not support CLI code exchange. Use agent-qa dashboard.`));
+      console.log(pc13.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(pc12.red("Authorization code is required"));
+      console.log(pc13.red("Authorization code is required"));
       process.exitCode = 1;
       return null;
     }
     return await plugin.exchangeCode({ code, sessionState: started.sessionState });
   }
-  console.log(pc12.red(`Provider "${provider}" does not support CLI auth login. Use agent-qa dashboard.`));
+  console.log(pc13.red(`Provider "${provider}" does not support CLI auth login. Use agent-qa dashboard.`));
   process.exitCode = 1;
   return null;
 }
@@ -5130,14 +5240,14 @@ async function runSubscriptionPluginLogin(configName, provider) {
     return;
   }
   if (!plugin.startAuth) {
-    console.log(pc12.red(`Provider "${provider}" does not support CLI auth login. Use agent-qa dashboard.`));
+    console.log(pc13.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: ${pc12.cyan(started.authorizeUrl)}`);
+    console.log(`Open this URL to authenticate: ${pc13.cyan(started.authorizeUrl)}`);
     openAuthorizationUrl(started.authorizeUrl);
     const tokens = await readTokensFromPlugin(provider, plugin, started);
     if (!tokens) return;
@@ -5146,9 +5256,9 @@ async function runSubscriptionPluginLogin(configName, provider) {
       provider: plugin.credentialProviderId,
       tokens
     });
-    console.log(pc12.green(`Authenticated ${configName} with ${plugin.label}`));
+    console.log(pc13.green(`Authenticated ${configName} with ${plugin.label}`));
   } catch (err) {
-    console.log(pc12.red(err instanceof Error ? err.message : String(err)));
+    console.log(pc13.red(err instanceof Error ? err.message : String(err)));
     process.exitCode = 1;
   } finally {
     started?.cleanup?.();
@@ -5165,13 +5275,13 @@ function createAuthCommand() {
       try {
         const requestedName = normalizeConfigName(opts.config);
         if (!requestedName) {
-          console.log(pc12.red("configName is required"));
+          console.log(pc13.red("configName is required"));
           return;
         }
         const resolved = await resolveNamedConfig2(requestedName, configPath);
         const resolvedName = normalizeConfigName(resolved.config.name);
         if (!resolvedName) {
-          console.log(pc12.red("Config name is invalid"));
+          console.log(pc13.red("Config name is invalid"));
           return;
         }
         configName = resolvedName;
@@ -5182,7 +5292,7 @@ function createAuthCommand() {
         }
         provider = configProvider;
       } catch (err) {
-        console.log(pc12.red(err instanceof Error ? err.message : String(err)));
+        console.log(pc13.red(err instanceof Error ? err.message : String(err)));
         return;
       }
       await runSubscriptionPluginLogin(configName, provider);
@@ -5192,7 +5302,7 @@ function createAuthCommand() {
     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(pc12.red("type must be api-key or bearer-token"));
+        console.log(pc13.red("type must be api-key or bearer-token"));
         return;
       }
       const { resolveNamedConfig: resolveNamedConfig2 } = await Promise.resolve().then(() => (init_llm_utils(), llm_utils_exports));
@@ -5201,35 +5311,35 @@ function createAuthCommand() {
       try {
         resolved = await resolveNamedConfig2(opts.config, configPath);
       } catch (err) {
-        console.log(pc12.red(err instanceof Error ? err.message : String(err)));
+        console.log(pc13.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(pc12.red("Subscription providers use OAuth login"));
+        console.log(pc13.red("Subscription providers use OAuth login"));
         return;
       }
       if (credentialType === "bearer-token" && provider !== "anthropic-compatible") {
-        console.log(pc12.red("bearer-token credentials are only supported for anthropic-compatible configs"));
+        console.log(pc13.red("bearer-token credentials are only supported for anthropic-compatible configs"));
         return;
       }
       if (credentialType === "api-key" && !API_KEY_CREDENTIAL_PROVIDERS.has(provider)) {
-        console.log(pc12.red("api-key credentials are not supported for this provider"));
+        console.log(pc13.red("api-key credentials are not supported for this provider"));
         return;
       }
       const secret = (secretArg ?? await password({ message: "Secret:" })).trim();
       if (!secret) {
-        console.log(pc12.red("Secret is required"));
+        console.log(pc13.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(pc12.green(`Saved bearer token for ${configName}`));
+        console.log(pc13.green(`Saved bearer token for ${configName}`));
       } else {
         await writeAuth(configName, { type: "api", provider, key: secret });
-        console.log(pc12.green(`Saved API key for ${configName}`));
+        console.log(pc13.green(`Saved API key for ${configName}`));
       }
     })
   );
@@ -5238,7 +5348,7 @@ function createAuthCommand() {
       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(pc12.bold("Auth status:\n"));
+      console.log(pc13.bold("Auth status:\n"));
       let llms;
       let defaultLLM;
       try {
@@ -5249,20 +5359,20 @@ function createAuthCommand() {
       } catch {
       }
       if (!llms?.length) {
-        console.log(pc12.dim("  No LLM configs found"));
+        console.log(pc13.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} ${pc12.dim("(default)")}` : name;
+        const label = isDefault ? `${name} ${pc13.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} ${pc12.dim(`[${providerLabel(provider)}]`)} ${pc12.dim(dots)} ${status}`);
+        console.log(`  ${label} ${pc13.dim(`[${providerLabel(provider)}]`)} ${pc13.dim(dots)} ${status}`);
       }
     })
   );
@@ -5279,12 +5389,12 @@ function createAuthCommand() {
           const resolved = await resolveNamedConfig2(void 0, configPath);
           storeKey = resolved.config.name;
         } catch {
-          console.log(pc12.red("Specify --config <name> or run with a config file"));
+          console.log(pc13.red("Specify --config <name> or run with a config file"));
           return;
         }
       }
       await removeAuth(storeKey);
-      console.log(pc12.green(`Logged out from ${storeKey}`));
+      console.log(pc13.green(`Logged out from ${storeKey}`));
     })
   );
   cmd.addCommand(
@@ -5299,19 +5409,19 @@ function createAuthCommand() {
         planner = modelFields;
         configName = name;
       } catch (err) {
-        console.log(pc12.red(err instanceof Error ? err.message : String(err)));
+        console.log(pc13.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(pc12.dim(`Testing config: ${configName}...`));
+      console.log(pc13.dim(`Testing config: ${configName}...`));
       const auth = await resolveModelAuth2(configName, planner);
       if (auth.kind === "missing") {
-        console.log(pc12.red(auth.message));
+        console.log(pc13.red(auth.message));
         return;
       }
       if (auth.kind === "unauthenticated") {
-        console.log(pc12.dim(auth.message));
+        console.log(pc13.dim(auth.message));
       }
       const { createModel, getProviderOptions } = await import("@vostride/agent-qa-core");
       const { generateText } = await import("ai");
@@ -5329,24 +5439,24 @@ function createAuthCommand() {
           ...providerOpts ? { providerOptions: providerOpts } : {}
         });
         const elapsed = Date.now() - start;
-        console.log(pc12.green(`Connected to ${planner.provider}/${planner.model} (${elapsed}ms)`));
+        console.log(pc13.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(pc12.red("Authentication failed. Check the saved credential for this config."));
+          console.log(pc13.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(pc12.red("Model not found. Check the model name."));
+          console.log(pc13.red("Model not found. Check the model name."));
         } else if (/rate|429|quota|limit/i.test(fullContext)) {
-          console.log(pc12.red("Rate limited. Try again later."));
+          console.log(pc13.red("Rate limited. Try again later."));
         } else if (/ECONNREFUSED|ENOTFOUND|timeout|abort|fetch failed|network/i.test(fullContext)) {
-          console.log(pc12.red("Network error. Check the exact base URL and try again."));
+          console.log(pc13.red("Network error. Check the exact base URL and try again."));
         } else if (/invalid_request|400|bad request/i.test(fullContext)) {
-          console.log(pc12.red("Invalid request. Check model and provider settings."));
+          console.log(pc13.red("Invalid request. Check model and provider settings."));
         } else {
-          console.log(pc12.red(`Connection failed. ${message}`));
+          console.log(pc13.red(`Connection failed. ${message}`));
         }
-        console.log(pc12.dim(message));
+        console.log(pc13.dim(message));
       } finally {
         clearTimeout(timeout);
       }
@@ -5360,7 +5470,7 @@ init_config();
 import { createInterface as createInterface3 } from "readline/promises";
 import { dirname as dirname7, resolve as resolvePath4 } from "path";
 import { Command as Command13 } from "commander";
-import pc13 from "picocolors";
+import pc14 from "picocolors";
 import {
   AUTH_STATE_SCHEMA_VERSION as AUTH_STATE_SCHEMA_VERSION2,
   listAuthStateMetadata,
@@ -5427,7 +5537,7 @@ function isSafeAuthStateError(message) {
 }
 function printSafeAuthStateError(error, fallback) {
   const message = error instanceof Error ? error.message : String(error);
-  console.error(pc13.red(isSafeAuthStateError(message) ? message : fallback));
+  console.error(pc14.red(isSafeAuthStateError(message) ? message : fallback));
 }
 function assertWebAuthStateTarget(input3) {
   resolveAuthStatePaths2({
@@ -5527,7 +5637,7 @@ function createAuthStateCommand(deps = {}) {
           target: { platform: target.platform }
         });
         if (!target.url) {
-          console.error(pc13.red(`Target "${target.name}" must define a web URL for auth-state capture.`));
+          console.error(pc14.red(`Target "${target.name}" must define a web URL for auth-state capture.`));
           process.exitCode = 1;
           return;
         }
@@ -5551,7 +5661,7 @@ function createAuthStateCommand(deps = {}) {
         }
         if (confirmation === "browser-closed") {
           await closeBrowser(browser);
-          console.error(pc13.red("Browser was closed before auth state was saved."));
+          console.error(pc14.red("Browser was closed before auth state was saved."));
           process.exitCode = 1;
           return;
         }
@@ -5569,7 +5679,7 @@ function createAuthStateCommand(deps = {}) {
           });
         } catch {
           await closeBrowser(browser);
-          console.error(pc13.red(`Could not save auth state "${opts.name}" for target "${target.name}".`));
+          console.error(pc14.red(`Could not save auth state "${opts.name}" for target "${target.name}".`));
           process.exitCode = 1;
           return;
         }
@@ -5577,7 +5687,7 @@ function createAuthStateCommand(deps = {}) {
         console.log(`Saved auth state "${opts.name}" for target "${target.name}".`);
       } catch (error) {
         await closeBrowser(browser);
-        console.error(pc13.red(error instanceof Error ? error.message : String(error)));
+        console.error(pc14.red(error instanceof Error ? error.message : String(error)));
         process.exitCode = 1;
       }
     })
@@ -5589,33 +5699,33 @@ function createAuthStateCommand(deps = {}) {
 init_config();
 import { Command as Command14 } 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 { existsSync as existsSync4, readFileSync as readFileSync4, writeFileSync as writeFileSync2 } from "fs";
+import { join as join6 } from "path";
 import { stringify as stringify2 } from "yaml";
-import pc14 from "picocolors";
+import pc15 from "picocolors";
 function formatStatus2(transport, localBinding) {
   if (transport !== "local") {
-    return pc14.green("Ready") + pc14.dim(" (no local binding required)");
+    return pc15.green("Ready") + pc15.dim(" (no local binding required)");
   }
   if (!localBinding) {
-    return pc14.red("UNBOUND") + pc14.yellow(" - run `agent-qa devices init`");
+    return pc15.red("UNBOUND") + pc15.yellow(" - run `agent-qa devices init`");
   }
   const keys = Object.entries(localBinding).slice(0, 2);
   const details = keys.map(([k, v]) => `${k}: ${v}`).join(", ");
-  return pc14.green("Bound") + pc14.dim(` (${details})`);
+  return pc15.green("Bound") + pc15.dim(` (${details})`);
 }
 async function listDevices() {
   let config;
   try {
     config = await resolveConfig({});
   } catch (err) {
-    console.error(pc14.red(`Config error: ${err instanceof Error ? err.message : String(err)}`));
+    console.error(pc15.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(pc14.yellow("No devices configured in registry.devices"));
+    console.log(pc15.yellow("No devices configured in registry.devices"));
     return;
   }
   const localBindings = loadLocalBindings();
@@ -5623,13 +5733,13 @@ async function listDevices() {
   const platWidth = 10;
   const transWidth = 14;
   console.log("");
-  console.log(pc14.bold("  Configured Devices"));
+  console.log(pc15.bold("  Configured Devices"));
   console.log("");
   console.log(
-    `  ${pc14.dim("Name".padEnd(nameWidth))}  ${pc14.dim("Platform".padEnd(platWidth))}  ${pc14.dim("Transport".padEnd(transWidth))}  ${pc14.dim("Status")}`
+    `  ${pc15.dim("Name".padEnd(nameWidth))}  ${pc15.dim("Platform".padEnd(platWidth))}  ${pc15.dim("Transport".padEnd(transWidth))}  ${pc15.dim("Status")}`
   );
   console.log(
-    `  ${pc14.dim("\u2500".repeat(nameWidth))}  ${pc14.dim("\u2500".repeat(platWidth))}  ${pc14.dim("\u2500".repeat(transWidth))}  ${pc14.dim("\u2500".repeat(30))}`
+    `  ${pc15.dim("\u2500".repeat(nameWidth))}  ${pc15.dim("\u2500".repeat(platWidth))}  ${pc15.dim("\u2500".repeat(transWidth))}  ${pc15.dim("\u2500".repeat(30))}`
   );
   for (const [name, profile] of Object.entries(devices)) {
     const localBinding = localBindings?.devices?.[name] ?? null;
@@ -5680,10 +5790,10 @@ function scanSimctlDevices() {
   }
 }
 function appendGitignoreEntry(dir, entry) {
-  const gitignorePath = join5(dir, ".gitignore");
+  const gitignorePath = join6(dir, ".gitignore");
   let existing = "";
-  if (existsSync3(gitignorePath)) {
-    existing = readFileSync3(gitignorePath, "utf-8");
+  if (existsSync4(gitignorePath)) {
+    existing = readFileSync4(gitignorePath, "utf-8");
   }
   if (existing.includes(entry)) return;
   const append = (existing.length > 0 && !existing.endsWith("\n") ? "\n" : "") + entry + "\n";
@@ -5691,30 +5801,30 @@ function appendGitignoreEntry(dir, entry) {
 }
 async function initDevices() {
   const dir = process.cwd();
-  const localFilePath = join5(dir, "agent-qa.local.yaml");
-  if (existsSync3(localFilePath)) {
-    console.log(pc14.yellow("agent-qa.local.yaml already exists. Skipping generation."));
+  const localFilePath = join6(dir, "agent-qa.local.yaml");
+  if (existsSync4(localFilePath)) {
+    console.log(pc15.yellow("agent-qa.local.yaml already exists. Skipping generation."));
     return;
   }
-  console.log(pc14.bold("\n  Scanning for connected devices...\n"));
+  console.log(pc15.bold("\n  Scanning for connected devices...\n"));
   const adbDevices = scanAdbDevices();
   const simctlDevices = scanSimctlDevices();
   if (adbDevices.length > 0) {
-    console.log(`  ${pc14.green("Android:")} found ${adbDevices.length} device(s)`);
+    console.log(`  ${pc15.green("Android:")} found ${adbDevices.length} device(s)`);
     for (const d of adbDevices) {
-      console.log(`    ${pc14.dim("\u2022")} ${d.model} (${d.serial})`);
+      console.log(`    ${pc15.dim("\u2022")} ${d.model} (${d.serial})`);
     }
   } else {
-    console.log(`  ${pc14.dim("Android:")} no devices found (adb not available or no devices connected)`);
+    console.log(`  ${pc15.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(`  ${pc14.green("iOS:")} found ${simctlDevices.length} simulator(s) (${booted.length} booted)`);
+    console.log(`  ${pc15.green("iOS:")} found ${simctlDevices.length} simulator(s) (${booted.length} booted)`);
     for (const d of booted) {
-      console.log(`    ${pc14.dim("\u2022")} ${d.name} (${d.udid})`);
+      console.log(`    ${pc15.dim("\u2022")} ${d.name} (${d.udid})`);
     }
   } else {
-    console.log(`  ${pc14.dim("iOS:")} no simulators found (simctl not available or none installed)`);
+    console.log(`  ${pc15.dim("iOS:")} no simulators found (simctl not available or none installed)`);
   }
   let config;
   try {
@@ -5748,8 +5858,8 @@ async function initDevices() {
   writeFileSync2(localFilePath, yamlContent);
   appendGitignoreEntry(dir, "agent-qa.local.yaml");
   console.log("");
-  console.log(pc14.green(`  Generated agent-qa.local.yaml with ${bindCount} device binding(s)`));
-  console.log(pc14.dim("  Added agent-qa.local.yaml to .gitignore"));
+  console.log(pc15.green(`  Generated agent-qa.local.yaml with ${bindCount} device binding(s)`));
+  console.log(pc15.dim("  Added agent-qa.local.yaml to .gitignore"));
   console.log("");
 }
 function createDevicesCommand() {
@@ -5761,7 +5871,7 @@ function createDevicesCommand() {
 
 // src/commands/ids.ts
 import { Command as Command15 } from "commander";
-import pc15 from "picocolors";
+import pc16 from "picocolors";
 import {
   ENTITY_ID_TYPES,
   generateCanonicalId,
@@ -5787,7 +5897,7 @@ function createIdsCommand() {
         console.log(id);
       }
     } catch (err) {
-      console.error(pc15.red(err instanceof Error ? err.message : String(err)));
+      console.error(pc16.red(err instanceof Error ? err.message : String(err)));
       process.exitCode = 1;
     }
   });
@@ -5806,15 +5916,15 @@ function createIdsCommand() {
       if (opts.json) {
         console.log(JSON.stringify(result, null, 2));
       } else if (valid) {
-        console.log(pc15.green(result.message));
+        console.log(pc16.green(result.message));
       } else {
-        console.error(pc15.red(result.message));
+        console.error(pc16.red(result.message));
       }
       if (!valid) {
         process.exitCode = 1;
       }
     } catch (err) {
-      console.error(pc15.red(err instanceof Error ? err.message : String(err)));
+      console.error(pc16.red(err instanceof Error ? err.message : String(err)));
       process.exitCode = 1;
     }
   });
@@ -5826,14 +5936,14 @@ import { Command as Command16 } 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 { existsSync as existsSync5 } from "fs";
 import { resolve as resolve6, dirname as dirname8 } from "path";
-import pc16 from "picocolors";
+import pc17 from "picocolors";
 function createCreateTestCommand() {
   const cmd = new Command16("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(pc16.red("Error: File already exists: " + resolved));
+    if (existsSync5(resolved)) {
+      console.error(pc17.red("Error: File already exists: " + resolved));
       process.exitCode = 1;
       return;
     }
@@ -5847,8 +5957,8 @@ function createCreateTestCommand() {
     const yamlContent = stringify3(template);
     await mkdir(dirname8(resolved), { recursive: true });
     await writeFile2(resolved, yamlContent, "utf-8");
-    console.log(pc16.green("Created " + resolved));
-    console.log(pc16.dim("  test-id: " + testId));
+    console.log(pc17.green("Created " + resolved));
+    console.log(pc17.dim("  test-id: " + testId));
   });
   return cmd;
 }
@@ -5858,14 +5968,14 @@ import { Command as Command17 } 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 { existsSync as existsSync6 } from "fs";
 import { resolve as resolve7, dirname as dirname9 } from "path";
-import pc17 from "picocolors";
+import pc18 from "picocolors";
 function createCreateSuiteCommand() {
   const cmd = new Command17("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(pc17.red("Error: File already exists: " + resolved));
+    if (existsSync6(resolved)) {
+      console.error(pc18.red("Error: File already exists: " + resolved));
       process.exitCode = 1;
       return;
     }
@@ -5881,8 +5991,8 @@ function createCreateSuiteCommand() {
     );
     await mkdir2(dirname9(resolved), { recursive: true });
     await writeFile3(resolved, yamlContent, "utf-8");
-    console.log(pc17.green("Created " + resolved));
-    console.log(pc17.dim("  suite-id: " + suiteId));
+    console.log(pc18.green("Created " + resolved));
+    console.log(pc18.dim("  suite-id: " + suiteId));
   });
   return cmd;
 }
@@ -5890,11 +6000,11 @@ function createCreateSuiteCommand() {
 // src/commands/clean-memory.ts
 init_config();
 import { Command as Command18 } from "commander";
-import pc18 from "picocolors";
+import pc19 from "picocolors";
 import { createInterface as createInterface4 } from "readline";
 import { readFile as readFile4, readdir as readdir2, rm as rm2, stat as stat2 } from "fs/promises";
-import { existsSync as existsSync6 } from "fs";
-import { join as join6 } from "path";
+import { existsSync as existsSync7 } from "fs";
+import { join as join7 } from "path";
 import {
   discoverWorkspaceFiles as discoverWorkspaceFiles3,
   parseObservation,
@@ -5910,12 +6020,12 @@ function formatSize(bytes) {
   return `${(bytes / 1048576).toFixed(1)} MB`;
 }
 async function getOrphanInfo(memoryRoot, tier, scope) {
-  const scopePath = join6(memoryRoot, tier, scope);
+  const scopePath = join7(memoryRoot, tier, scope);
   const obsFiles = await listObservations(scopePath);
   let newest = null;
   for (const filename of obsFiles) {
     try {
-      const content = await readFile4(join6(scopePath, filename), "utf-8");
+      const content = await readFile4(join7(scopePath, filename), "utf-8");
       const { data } = parseObservation(content, filename);
       if (data?.last_confirmed) {
         if (!newest || data.last_confirmed > newest) {
@@ -5930,7 +6040,7 @@ async function getOrphanInfo(memoryRoot, tier, scope) {
     const entries = await readdir2(scopePath);
     for (const entry of entries) {
       try {
-        const s = await stat2(join6(scopePath, entry));
+        const s = await stat2(join7(scopePath, entry));
         if (s.isFile()) totalSize += s.size;
       } catch {
       }
@@ -5938,7 +6048,7 @@ async function getOrphanInfo(memoryRoot, tier, scope) {
   } catch {
   }
   return {
-    path: join6(tier, scope),
+    path: join7(tier, scope),
     tier,
     scope,
     fileCount: obsFiles.length,
@@ -5979,8 +6089,8 @@ function createCleanMemoryCommand() {
       }
     }
     const memoryRoot = resolveMemoryRoot2(config, workspace.configDir);
-    if (!existsSync6(memoryRoot)) {
-      console.log(pc18.dim("No memory directory found."));
+    if (!existsSync7(memoryRoot)) {
+      console.log(pc19.dim("No memory directory found."));
       return;
     }
     const TIERS = [
@@ -5990,7 +6100,7 @@ function createCleanMemoryCommand() {
     ];
     const orphans = [];
     for (const tier of TIERS) {
-      const tierPath = join6(memoryRoot, tier.dir);
+      const tierPath = join7(memoryRoot, tier.dir);
       let entries;
       try {
         entries = await readdir2(tierPath);
@@ -5999,7 +6109,7 @@ function createCleanMemoryCommand() {
       }
       for (const entry of entries) {
         try {
-          const s = await stat2(join6(tierPath, entry));
+          const s = await stat2(join7(tierPath, entry));
           if (!s.isDirectory()) continue;
         } catch {
           continue;
@@ -6010,17 +6120,17 @@ function createCleanMemoryCommand() {
       }
     }
     if (orphans.length === 0) {
-      console.log(pc18.dim("No orphaned memory directories found."));
+      console.log(pc19.dim("No orphaned memory directories found."));
       return;
     }
     const maxPathLen = Math.max("Path".length, ...orphans.map((o) => o.path.length));
     console.log("");
-    console.log(pc18.bold("Orphaned memory directories:"));
+    console.log(pc19.bold("Orphaned memory directories:"));
     console.log("");
-    console.log("  " + pc18.dim("Path".padEnd(maxPathLen + 2) + "Files".padStart(7) + "  " + "Last Confirmed".padEnd(20) + "Size".padStart(10)));
-    console.log("  " + pc18.dim("-".repeat(maxPathLen + 2 + 7 + 2 + 20 + 10)));
+    console.log("  " + pc19.dim("Path".padEnd(maxPathLen + 2) + "Files".padStart(7) + "  " + "Last Confirmed".padEnd(20) + "Size".padStart(10)));
+    console.log("  " + pc19.dim("-".repeat(maxPathLen + 2 + 7 + 2 + 20 + 10)));
     for (const o of orphans) {
-      const confirmed = o.lastConfirmed ?? pc18.dim("never");
+      const confirmed = o.lastConfirmed ?? pc19.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("");
@@ -6036,25 +6146,25 @@ function createCleanMemoryCommand() {
       }
     }
     for (const orphan of orphans) {
-      await rm2(join6(memoryRoot, orphan.tier, orphan.scope), { recursive: true, force: true });
+      await rm2(join7(memoryRoot, orphan.tier, orphan.scope), { recursive: true, force: true });
     }
-    console.log(pc18.green(`Deleted ${orphans.length} orphaned director${orphans.length === 1 ? "y" : "ies"}.`));
+    console.log(pc19.green(`Deleted ${orphans.length} orphaned director${orphans.length === 1 ? "y" : "ies"}.`));
   });
   return cmd;
 }
 
 // src/commands/skills.ts
 import { Command as Command19 } from "commander";
-import { existsSync as existsSync7, readdirSync, readFileSync as readFileSync4, statSync } from "fs";
-import { dirname as dirname10, join as join7, resolve as resolve8 } from "path";
+import { existsSync as existsSync8, readdirSync, readFileSync as readFileSync5, statSync } from "fs";
+import { dirname as dirname10, join as join8, resolve as resolve8 } from "path";
 import { fileURLToPath } from "url";
 function findPackageRoot(startDir) {
   let current = resolve8(startDir);
   while (true) {
-    const packagePath = join7(current, "package.json");
-    if (existsSync7(packagePath)) {
+    const packagePath = join8(current, "package.json");
+    if (existsSync8(packagePath)) {
       try {
-        const pkg = JSON.parse(readFileSync4(packagePath, "utf-8"));
+        const pkg = JSON.parse(readFileSync5(packagePath, "utf-8"));
         if (pkg.name === "agent-qa") {
           return current;
         }
@@ -6069,11 +6179,11 @@ function findPackageRoot(startDir) {
   }
 }
 function hasSkillDirectories(dir) {
-  if (!existsSync7(dir)) return false;
+  if (!existsSync8(dir)) return false;
   try {
     return readdirSync(dir).some((entry) => {
-      const skillDir = join7(dir, entry);
-      return statSync(skillDir).isDirectory() && existsSync7(join7(skillDir, "SKILL.md"));
+      const skillDir = join8(dir, entry);
+      return statSync(skillDir).isDirectory() && existsSync8(join8(skillDir, "SKILL.md"));
     });
   } catch {
     return false;
@@ -6081,7 +6191,7 @@ function hasSkillDirectories(dir) {
 }
 function resolveAgentQaSkillsDirectory(startDir = dirname10(fileURLToPath(import.meta.url))) {
   const packageRoot = findPackageRoot(startDir);
-  const packagedSkills = join7(packageRoot, "skills");
+  const packagedSkills = join8(packageRoot, "skills");
   if (hasSkillDirectories(packagedSkills)) {
     return { path: packagedSkills, source: "package" };
   }
@@ -6092,21 +6202,21 @@ function resolveAgentQaSkillsDirectory(startDir = dirname10(fileURLToPath(import
   return { path: packagedSkills, source: "missing" };
 }
 function parseSkillDescription(skillPath) {
-  const body = readFileSync4(skillPath, "utf-8");
+  const body = readFileSync5(skillPath, "utf-8");
   const description = body.match(/^description:\s*(.+)$/m)?.[1]?.trim();
   return description?.replace(/^["']|["']$/g, "");
 }
 function listAgentQaSkills(skillsDir) {
   if (!hasSkillDirectories(skillsDir)) return [];
   return readdirSync(skillsDir).filter((entry) => {
-    const skillDir = join7(skillsDir, entry);
-    return statSync(skillDir).isDirectory() && existsSync7(join7(skillDir, "SKILL.md"));
+    const skillDir = join8(skillsDir, entry);
+    return statSync(skillDir).isDirectory() && existsSync8(join8(skillDir, "SKILL.md"));
   }).sort().map((entry) => {
-    const skillDir = join7(skillsDir, entry);
+    const skillDir = join8(skillsDir, entry);
     return {
       name: entry,
       path: skillDir,
-      description: parseSkillDescription(join7(skillDir, "SKILL.md"))
+      description: parseSkillDescription(join8(skillDir, "SKILL.md"))
     };
   });
 }
@@ -6196,7 +6306,7 @@ function rejectRemovedCliSurface(input3 = {}) {
 rejectRemovedCliSurface();
 var program = new Command20();
 program.enablePositionalOptions();
-program.name("agent-qa").description("AI-powered testing framework").version(VERSION);
+program.name("agent-qa").description("The self-improving Agentic QA harness with Memory").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());