@vostride/agent-qa-core 0.1.9 → 0.1.10

package/dist/index.js

@@ -67,20 +67,20 @@ var init_schema = __esm({
 // src/memory/observation-io.ts
 import { parse as parseYaml2, stringify as stringifyYaml } from "yaml";
 import { mkdir as mkdir5, writeFile as writeFile5, readdir as readdir2 } from "fs/promises";
-import { join as join4, resolve as resolve3, sep } from "path";
+import { join as join5, resolve as resolve4, sep } from "path";
 function toObservationFrontmatter(data) {
   const { content, ...frontmatter } = data;
   return frontmatter;
 }
 async function ensureMemoryDirs(root) {
   await Promise.all(
-    MEMORY_TIERS.map((tier) => mkdir5(join4(root, tier), { recursive: true }))
+    MEMORY_TIERS.map((tier) => mkdir5(join5(root, tier), { recursive: true }))
   );
 }
 async function writeObservation(root, tier, scope, data) {
-  const dir = join4(root, tier, scope);
-  const resolved = resolve3(dir);
-  const boundary = resolve3(root);
+  const dir = join5(root, tier, scope);
+  const resolved = resolve4(dir);
+  const boundary = resolve4(root);
   if (!resolved.startsWith(boundary + sep)) {
     throw new Error(`Scope "${scope}" escapes memory root`);
   }
@@ -92,7 +92,7 @@ async function writeObservation(root, tier, scope, data) {
 ${stringifyYaml({ ...frontmatter }, { lineWidth: 0 })}---
 ${validated.content}
 `;
-  const filePath = join4(dir, `${data.id}.md`);
+  const filePath = join5(dir, `${data.id}.md`);
   await writeFile5(filePath, content, "utf-8");
   return filePath;
 }
@@ -198,11 +198,11 @@ var init_security_scanner = __esm({
 
 // src/sqlite.ts
 import { execFileSync } from "child_process";
-import { existsSync as existsSync6, mkdirSync, rmSync, writeFileSync } from "fs";
+import { existsSync as existsSync7, mkdirSync, rmSync, writeFileSync } from "fs";
 import { createHash as createHash3 } from "crypto";
 import { createRequire as createRequire3 } from "module";
 import { tmpdir as tmpdir2 } from "os";
-import { dirname as dirname10, join as join6 } from "path";
+import { dirname as dirname11, join as join7 } from "path";
 function getBetterSqlite3ErrorMessage(error) {
   return error instanceof Error ? error.message : String(error);
 }
@@ -222,14 +222,14 @@ function isBetterSqlite3NodeGypSymlinkConflict(error) {
   return message.includes("node_gyp_bins/python3") && message.includes("EEXIST");
 }
 function resolveCurrentRuntimeNpmCliPath() {
-  const nodeInstallRoot = dirname10(dirname10(process.execPath));
-  const npmCliPath = join6(nodeInstallRoot, "lib", "node_modules", "npm", "bin", "npm-cli.js");
-  return existsSync6(npmCliPath) ? npmCliPath : null;
+  const nodeInstallRoot = dirname11(dirname11(process.execPath));
+  const npmCliPath = join7(nodeInstallRoot, "lib", "node_modules", "npm", "bin", "npm-cli.js");
+  return existsSync7(npmCliPath) ? npmCliPath : null;
 }
 function resolveCurrentRuntimeNodeDir() {
-  const nodeInstallRoot = dirname10(dirname10(process.execPath));
-  const nodeHeaderPath = join6(nodeInstallRoot, "include", "node", "node.h");
-  return existsSync6(nodeHeaderPath) ? nodeInstallRoot : null;
+  const nodeInstallRoot = dirname11(dirname11(process.execPath));
+  const nodeHeaderPath = join7(nodeInstallRoot, "include", "node", "node.h");
+  return existsSync7(nodeHeaderPath) ? nodeInstallRoot : null;
 }
 function resolveBetterSqliteRebuildCommand() {
   const npmCliPath = resolveCurrentRuntimeNpmCliPath();
@@ -250,26 +250,26 @@ function sleepSync(milliseconds) {
   Atomics.wait(new Int32Array(new SharedArrayBuffer(4)), 0, 0, milliseconds);
 }
 function waitForBetterSqlite3BuildOutput(installRoot, timeoutMs = 3e4) {
-  const bindingPath = join6(installRoot, "build", "Release", "better_sqlite3.node");
+  const bindingPath = join7(installRoot, "build", "Release", "better_sqlite3.node");
   const deadline = Date.now() + timeoutMs;
   while (Date.now() < deadline) {
-    if (existsSync6(bindingPath)) {
+    if (existsSync7(bindingPath)) {
       return true;
     }
     sleepSync(200);
   }
-  return existsSync6(bindingPath);
+  return existsSync7(bindingPath);
 }
 function acquireBetterSqlite3RebuildLock(installRoot) {
-  const lockRoot = join6(tmpdir2(), "agent-qa-better-sqlite3-rebuild-locks");
+  const lockRoot = join7(tmpdir2(), "agent-qa-better-sqlite3-rebuild-locks");
   const lockKey = createHash3("sha256").update(`${installRoot}\0${process.version}`).digest("hex");
-  const lockDir = join6(lockRoot, lockKey);
+  const lockDir = join7(lockRoot, lockKey);
   const deadline = Date.now() + 12e4;
   mkdirSync(lockRoot, { recursive: true });
   while (true) {
     try {
       mkdirSync(lockDir);
-      writeFileSync(join6(lockDir, "owner"), `${process.pid}
+      writeFileSync(join7(lockDir, "owner"), `${process.pid}
 ${(/* @__PURE__ */ new Date()).toISOString()}
 ${installRoot}
 `);
@@ -298,13 +298,13 @@ function rebuildBetterSqlite3ForCurrentRuntime(originalError) {
   }
   rebuildAttempted = true;
   const packageJsonPath = require2.resolve("better-sqlite3/package.json");
-  const installRoot = dirname10(packageJsonPath);
+  const installRoot = dirname11(packageJsonPath);
   const rebuildCommand = resolveBetterSqliteRebuildCommand();
-  const nodeGypDevDir = join6(tmpdir2(), "agent-qa-node-gyp", process.version.replace(/^v/, ""));
-  const npmCacheDir = join6(tmpdir2(), "agent-qa-npm-cache");
+  const nodeGypDevDir = join7(tmpdir2(), "agent-qa-node-gyp", process.version.replace(/^v/, ""));
+  const npmCacheDir = join7(tmpdir2(), "agent-qa-npm-cache");
   const nodeDir = resolveCurrentRuntimeNodeDir();
-  const nodeGypBinsPath = join6(installRoot, "build", "node_gyp_bins");
-  const buildRoot = join6(installRoot, "build");
+  const nodeGypBinsPath = join7(installRoot, "build", "node_gyp_bins");
+  const buildRoot = join7(installRoot, "build");
   const releaseLock = acquireBetterSqlite3RebuildLock(installRoot);
   try {
     clearBetterSqlite3Cache();
@@ -387,7 +387,7 @@ var init_sqlite = __esm({
 
 // src/memory/memory-index.ts
 import { readFile as readFile12 } from "fs/promises";
-import { join as join7 } from "path";
+import { join as join8 } from "path";
 function validatePathComponent(value) {
   return !/\.\./.test(value) && !/[/\\]/.test(value) && !/\0/.test(value);
 }
@@ -409,13 +409,13 @@ async function buildMemoryIndex(params) {
     const insert = db.prepare("INSERT INTO observations(title, content, id, trust) VALUES (?, ?, ?, ?)");
     const dirs = [];
     if (validatePathComponent(params.product)) {
-      dirs.push({ path: join7(params.memoryRoot, "products", params.product), isSuite: false });
+      dirs.push({ path: join8(params.memoryRoot, "products", params.product), isSuite: false });
     }
     if (params.suiteId && validatePathComponent(params.suiteId)) {
-      dirs.push({ path: join7(params.memoryRoot, "suites", params.suiteId), isSuite: true });
+      dirs.push({ path: join8(params.memoryRoot, "suites", params.suiteId), isSuite: true });
     }
     if (validatePathComponent(params.testId)) {
-      dirs.push({ path: join7(params.memoryRoot, "tests", params.testId), isSuite: false });
+      dirs.push({ path: join8(params.memoryRoot, "tests", params.testId), isSuite: false });
     }
     if (dirs.length === 0) {
       console.warn("[memory-index] All path components failed validation", {
@@ -434,7 +434,7 @@ async function buildMemoryIndex(params) {
     for (const { path: dirPath, isSuite } of dirs) {
       const filenames = await listObservations(dirPath);
       for (const filename of filenames) {
-        const filePath = join7(dirPath, filename);
+        const filePath = join8(dirPath, filename);
         let raw;
         try {
           raw = await readFile12(filePath, "utf-8");
@@ -485,7 +485,7 @@ var init_xml_escape = __esm({
 
 // src/memory/lock-manager.ts
 import { writeFile as writeFile7, readFile as readFile13, unlink as unlink3, mkdir as mkdir7 } from "fs/promises";
-import { dirname as dirname11 } from "path";
+import { dirname as dirname12 } from "path";
 var LockManager;
 var init_lock_manager = __esm({
   "src/memory/lock-manager.ts"() {
@@ -498,7 +498,7 @@ var init_lock_manager = __esm({
         this.timeout = timeout;
       }
       async acquire() {
-        await mkdir7(dirname11(this.lockPath), { recursive: true });
+        await mkdir7(dirname12(this.lockPath), { recursive: true });
         const deadline = Date.now() + this.timeout;
         while (Date.now() < deadline) {
           try {
@@ -630,7 +630,7 @@ var local_provider_exports = {};
 __export(local_provider_exports, {
   LocalMemoryProvider: () => LocalMemoryProvider
 });
-import { join as join8, resolve as resolve6, sep as sep2 } from "path";
+import { join as join9, resolve as resolve7, sep as sep2 } from "path";
 import { readdirSync, readFileSync as readFileSync3 } from "fs";
 import { unlink as unlink4 } from "fs/promises";
 var LocalMemoryProvider;
@@ -657,7 +657,7 @@ var init_local_provider = __esm({
         this.minTrust = opts?.minTrust ?? 0.3;
         this.maxInjections = opts?.maxInjections ?? 3;
         this.lockManager = new LockManager(
-          join8(this.memoryRoot, ".curator.lock"),
+          join9(this.memoryRoot, ".curator.lock"),
           opts?.curatorLockTimeout ?? 12e4
         );
       }
@@ -727,9 +727,9 @@ ${lines.join("\n")}
         return writeObservation(this.memoryRoot, tier, scope, data);
       }
       async deleteObservation(tier, scope, id) {
-        const filePath = join8(this.memoryRoot, tier, scope, `${id}.md`);
-        const resolved = resolve6(filePath);
-        if (!resolved.startsWith(resolve6(this.memoryRoot) + sep2)) {
+        const filePath = join9(this.memoryRoot, tier, scope, `${id}.md`);
+        const resolved = resolve7(filePath);
+        if (!resolved.startsWith(resolve7(this.memoryRoot) + sep2)) {
           throw new Error("Path escapes memory root");
         }
         try {
@@ -746,7 +746,7 @@ ${lines.join("\n")}
           const results = [];
           const tiers = ["products", "suites", "tests"];
           for (const tier of tiers) {
-            const tierDir = join8(this.memoryRoot, tier);
+            const tierDir = join9(this.memoryRoot, tier);
             let scopes;
             try {
               scopes = readdirSync(tierDir, { withFileTypes: true }).filter((d) => d.isDirectory()).map((d) => d.name);
@@ -754,7 +754,7 @@ ${lines.join("\n")}
               continue;
             }
             for (const scope of scopes) {
-              const scopeDir = join8(tierDir, scope);
+              const scopeDir = join9(tierDir, scope);
               let files;
               try {
                 files = readdirSync(scopeDir).filter((f) => f.startsWith("obs_") && f.endsWith(".md"));
@@ -764,7 +764,7 @@ ${lines.join("\n")}
               for (const file of files) {
                 let raw;
                 try {
-                  raw = readFileSync3(join8(scopeDir, file), "utf-8");
+                  raw = readFileSync3(join9(scopeDir, file), "utf-8");
                 } catch {
                   continue;
                 }
@@ -799,7 +799,7 @@ ${lines.join("\n")}
           const tiers = ["products", "suites", "tests"];
           const toInsert = [];
           for (const tier of tiers) {
-            const tierDir = join8(this.memoryRoot, tier);
+            const tierDir = join9(this.memoryRoot, tier);
             let scopes;
             try {
               scopes = readdirSync(tierDir, { withFileTypes: true }).filter((d) => d.isDirectory()).map((d) => d.name);
@@ -807,7 +807,7 @@ ${lines.join("\n")}
               continue;
             }
             for (const scope of scopes) {
-              const scopeDir = join8(tierDir, scope);
+              const scopeDir = join9(tierDir, scope);
               let files;
               try {
                 files = readdirSync(scopeDir).filter((f) => f.startsWith("obs_") && f.endsWith(".md"));
@@ -817,7 +817,7 @@ ${lines.join("\n")}
               for (const file of files) {
                 let raw;
                 try {
-                  raw = readFileSync3(join8(scopeDir, file), "utf-8");
+                  raw = readFileSync3(join9(scopeDir, file), "utf-8");
                 } catch {
                   continue;
                 }
@@ -4674,9 +4674,9 @@ function getHookCommand(runtime, entryFile) {
   }
 }
 async function checkDockerAvailable(dockerBin = DEFAULT_DOCKER_BIN) {
-  return new Promise((resolve7) => {
+  return new Promise((resolve8) => {
     execFile(dockerBin, ["info", "--format", "{{.ID}}"], { timeout: 5e3 }, (err) => {
-      resolve7(!err);
+      resolve8(!err);
     });
   });
 }
@@ -4789,22 +4789,22 @@ function filterSecretVariables(variables, secretStore) {
   );
 }
 function imageExists(dockerBin, image) {
-  return new Promise((resolve7) => {
+  return new Promise((resolve8) => {
     execFile(dockerBin, ["image", "inspect", image], { timeout: 1e4 }, (err) => {
-      resolve7(!err);
+      resolve8(!err);
     });
   });
 }
 function pullImage(dockerBin, image) {
-  return new Promise((resolve7, reject) => {
+  return new Promise((resolve8, reject) => {
     execFile(dockerBin, ["pull", image], { timeout: 12e4 }, (err) => {
       if (err) reject(new Error(`Failed to pull image ${image}: ${err.message}`));
-      else resolve7();
+      else resolve8();
     });
   });
 }
 function execDocker(dockerBin, args, timeout) {
-  return new Promise((resolve7, reject) => {
+  return new Promise((resolve8, reject) => {
     let stdout = "";
     let stderr = "";
     let resolved = false;
@@ -4814,11 +4814,11 @@ function execDocker(dockerBin, args, timeout) {
       stdout = out ?? "";
       stderr = errOut ?? "";
       if (err && "killed" in err && err.killed) {
-        resolve7({ stdout, stderr: `Hook timed out after ${timeout}ms`, exitCode: 124 });
+        resolve8({ stdout, stderr: `Hook timed out after ${timeout}ms`, exitCode: 124 });
         return;
       }
       const exitCode = err?.code ?? 0;
-      resolve7({ stdout, stderr, exitCode: typeof exitCode === "number" ? exitCode : 1 });
+      resolve8({ stdout, stderr, exitCode: typeof exitCode === "number" ? exitCode : 1 });
     });
   });
 }
@@ -6894,14 +6894,41 @@ function resolveMobileRunConfig(input) {
   };
 }
 
+// src/mobile/appium-executable.ts
+import { existsSync as existsSync2 } from "fs";
+import { dirname as dirname6, join as join3, parse, resolve as resolve2 } from "path";
+function localAppiumBinaryNames(platform = process.platform) {
+  return platform === "win32" ? ["appium.cmd", "appium.exe", "appium"] : ["appium"];
+}
+function resolveAppiumExecutable(opts = {}) {
+  const exists = opts.exists ?? existsSync2;
+  const names = localAppiumBinaryNames(opts.platform ?? process.platform);
+  let current = resolve2(opts.cwd ?? process.cwd());
+  const root = parse(current).root;
+  while (true) {
+    for (const name of names) {
+      const candidate = join3(current, "node_modules", ".bin", name);
+      if (exists(candidate)) {
+        return { command: candidate, source: "local" };
+      }
+    }
+    if (current === root) break;
+    current = dirname6(current);
+  }
+  return { command: "appium", source: "path" };
+}
+function formatAppiumInstallGuidance() {
+  return "Install Appium locally with `npm install -D appium` (or `pnpm add -D appium` / `yarn add -D appium`). If you prefer a machine-wide setup, use `npm install -g appium`.";
+}
+
 // src/auth/store.ts
 import { readFile as readFile6, writeFile as writeFile4, mkdir as mkdir4, unlink as unlink2 } from "fs/promises";
-import { dirname as dirname6, join as join3 } from "path";
+import { dirname as dirname7, join as join4 } from "path";
 import { homedir } from "os";
 function getAuthPath() {
   const xdg = process.env.XDG_DATA_HOME;
-  if (xdg) return join3(xdg, "agent-qa", "auth.json");
-  return join3(homedir(), ".agent-qa", "auth.json");
+  if (xdg) return join4(xdg, "agent-qa", "auth.json");
+  return join4(homedir(), ".agent-qa", "auth.json");
 }
 async function readAuth(path5) {
   const authPath = path5 ?? getAuthPath();
@@ -6916,7 +6943,7 @@ async function writeAuth(provider, credential, path5) {
   const authPath = path5 ?? getAuthPath();
   const store = await readAuth(authPath);
   store[provider] = credential;
-  await mkdir4(dirname6(authPath), { recursive: true });
+  await mkdir4(dirname7(authPath), { recursive: true });
   await writeFile4(authPath, JSON.stringify(store, null, 2), { mode: 384 });
 }
 async function removeAuth(provider, path5) {
@@ -7094,16 +7121,16 @@ async function resolveLLMAuth(configName, llmConfig, authPath) {
 
 // src/auth/plugin-loader.ts
 import { createRequire } from "module";
-import { existsSync as existsSync2, readFileSync } from "fs";
-import { dirname as dirname7, isAbsolute as isAbsolute2, resolve as resolve2 } from "path";
+import { existsSync as existsSync3, readFileSync } from "fs";
+import { dirname as dirname8, isAbsolute as isAbsolute2, resolve as resolve3 } from "path";
 import { pathToFileURL } from "url";
 var loadedDeclarations = /* @__PURE__ */ new Set();
 function findPackageJson(packageName, baseDir) {
-  let current = resolve2(baseDir);
+  let current = resolve3(baseDir);
   while (true) {
-    const candidate = resolve2(current, "node_modules", ...packageName.split("/"), "package.json");
-    if (existsSync2(candidate)) return candidate;
-    const parent = dirname7(current);
+    const candidate = resolve3(current, "node_modules", ...packageName.split("/"), "package.json");
+    if (existsSync3(candidate)) return candidate;
+    const parent = dirname8(current);
     if (parent === current) return null;
     current = parent;
   }
@@ -7131,7 +7158,7 @@ function resolvePackageImportFromBase(packageName, baseDir) {
   const pkg = JSON.parse(readFileSync(packageJsonPath, "utf-8"));
   const target = exportTargetFromPackageJson(pkg);
   if (!target || !target.startsWith(".")) return null;
-  return pathToFileURL(resolve2(dirname7(packageJsonPath), target)).href;
+  return pathToFileURL(resolve3(dirname8(packageJsonPath), target)).href;
 }
 function packageDeclarationValue(declaration) {
   return "package" in declaration && typeof declaration.package === "string" ? declaration.package.trim() : "";
@@ -7142,24 +7169,24 @@ function pathDeclarationValue(declaration) {
 function declarationKey(declaration, baseDir) {
   const packageName = packageDeclarationValue(declaration);
   if (packageName) return `package:${packageName}`;
-  return `path:${resolve2(baseDir, pathDeclarationValue(declaration))}`;
+  return `path:${resolve3(baseDir, pathDeclarationValue(declaration))}`;
 }
 function resolveModuleSpecifier(declaration, baseDir) {
   const packageName = packageDeclarationValue(declaration);
   if (packageName) {
     const packageImport = resolvePackageImportFromBase(packageName, baseDir);
     if (packageImport) return packageImport;
-    const parentUrl = pathToFileURL(resolve2(baseDir, "agent-qa.config.yaml")).href;
+    const parentUrl = pathToFileURL(resolve3(baseDir, "agent-qa.config.yaml")).href;
     try {
       const resolveImport = import.meta.resolve;
       return resolveImport(packageName, parentUrl);
     } catch {
-      const require3 = createRequire(resolve2(baseDir, "agent-qa.config.yaml"));
+      const require3 = createRequire(resolve3(baseDir, "agent-qa.config.yaml"));
       return pathToFileURL(require3.resolve(packageName)).href;
     }
   }
   const pluginPath = pathDeclarationValue(declaration);
-  const absolutePath = isAbsolute2(pluginPath) ? pluginPath : resolve2(baseDir, pluginPath);
+  const absolutePath = isAbsolute2(pluginPath) ? pluginPath : resolve3(baseDir, pluginPath);
   return pathToFileURL(absolutePath).href;
 }
 async function resolvePluginBundle(module, source) {
@@ -7548,7 +7575,7 @@ function mapMobileCapabilities(match, platform, credentials, opts) {
 }
 
 // src/farm/browserstack.ts
-import { existsSync as existsSync3, readFileSync as readFileSync2 } from "fs";
+import { existsSync as existsSync4, readFileSync as readFileSync2 } from "fs";
 import { basename as basename2, resolve as resolvePath3 } from "path";
 function isAbsoluteAppValue(value) {
   return value.startsWith("/") || /^[A-Za-z]:[\\/]/.test(value) || value.startsWith("\\\\");
@@ -7570,7 +7597,7 @@ async function resolveBrowserStackApp(config) {
   const appBaseDir = config.appBaseDir ?? process.cwd();
   const resolvedPath = resolvePath3(appBaseDir, config.app);
   const mustExist = isExplicitRelativePath(config.app);
-  if (!existsSync3(resolvedPath)) {
+  if (!existsSync4(resolvedPath)) {
     if (mustExist) {
       throw new MobileSetupError({
         category: "app-install",
@@ -7762,7 +7789,7 @@ async function runHooks(hooks, options = {}) {
 init_observation_io();
 import { generateText as generateText5, Output as Output4 } from "ai";
 import { z as z19 } from "zod";
-import { join as join5 } from "path";
+import { join as join6 } from "path";
 import { access as access2, readFile as readFile7, readdir as readdir3 } from "fs/promises";
 
 // src/memory/observation-id.ts
@@ -7910,7 +7937,7 @@ function collectKnownObservationIds(injectedObservationIds, dedupMatches) {
 async function findObservationFile(memoryRoot, id) {
   const tiers = ["products", "suites", "tests"];
   for (const tier of tiers) {
-    const tierDir = join5(memoryRoot, tier);
+    const tierDir = join6(memoryRoot, tier);
     let scopes;
     try {
       scopes = await readdir3(tierDir);
@@ -7918,7 +7945,7 @@ async function findObservationFile(memoryRoot, id) {
       continue;
     }
     for (const scope of scopes) {
-      const filePath = join5(tierDir, scope, `${id}.md`);
+      const filePath = join6(tierDir, scope, `${id}.md`);
       try {
         await access2(filePath);
         return { tier, scope, filePath };
@@ -8147,11 +8174,11 @@ ${userMessage}`;
       }
       if (ctx.suiteId && ctx.suiteContext) {
         try {
-          const suiteDir = join5(ctx.memoryRoot, "suites", ctx.suiteId);
+          const suiteDir = join6(ctx.memoryRoot, "suites", ctx.suiteId);
           const files = await listObservations(suiteDir);
           for (const file of files) {
             try {
-              const filePath = join5(suiteDir, file);
+              const filePath = join6(suiteDir, file);
               const raw = await readFile7(filePath, "utf-8");
               const { data } = parseObservation(raw, file);
               if (!data || !("suite_snapshot" in data)) continue;
@@ -8853,14 +8880,14 @@ async function runSuite(suite, testEntries, config) {
 
 // src/validation/validate.ts
 import { readFile as readFile10 } from "fs/promises";
-import { existsSync as existsSync5 } from "fs";
+import { existsSync as existsSync6 } from "fs";
 import path4 from "path";
 import { parse as parseYaml4, LineCounter as LineCounter2, parseDocument } from "yaml";
 import { glob as glob2 } from "glob";
 
 // src/hooks/parser.ts
 import { readFile as readFile9 } from "fs/promises";
-import { dirname as dirname8, resolve as resolve4 } from "path";
+import { dirname as dirname9, resolve as resolve5 } from "path";
 import { parse as parseYaml3 } from "yaml";
 async function parseHooksFile(filePath) {
   let raw;
@@ -8882,12 +8909,12 @@ async function parseHooksFile(filePath) {
     );
     return { hooks: [], errors };
   }
-  const dir = dirname8(filePath);
+  const dir = dirname9(filePath);
   const hooks = result.data.hooks.map((h) => ({
     ...h,
-    file: resolve4(dir, h.file),
-    deps: h.deps.map((d) => resolve4(dir, d)),
-    packageFile: h.packageFile ? resolve4(dir, h.packageFile) : void 0
+    file: resolve5(dir, h.file),
+    deps: h.deps.map((d) => resolve5(dir, d)),
+    packageFile: h.packageFile ? resolve5(dir, h.packageFile) : void 0
   }));
   return { hooks, errors: [] };
 }
@@ -8902,7 +8929,7 @@ function isPathInsideDir(childPath, parentDir) {
 }
 
 // src/workspace/workspace-paths.ts
-import { existsSync as existsSync4 } from "fs";
+import { existsSync as existsSync5 } from "fs";
 import path3 from "path";
 import { glob } from "glob";
 function toForwardSlash(value) {
@@ -9015,7 +9042,7 @@ function resolveWorkspacePaths(input) {
       ["workspace.envFile", resolved.envFile],
       ["workspace.secretsFile", resolved.secretsFile]
     ]) {
-      if (!existsSync4(file.absolutePath)) {
+      if (!existsSync5(file.absolutePath)) {
         throw new Error(`Configured workspace file not found: ${key} -> ${file.absolutePath}`);
       }
     }
@@ -9046,7 +9073,7 @@ async function resolveWorkspaceFileTarget(input) {
   })) {
     throw new Error(`Workspace ${input.kind} file is not matched by configured workspace patterns: ${workspaceRelativePath}`);
   }
-  if (input.requireExisting && !existsSync4(absolutePath)) {
+  if (input.requireExisting && !existsSync5(absolutePath)) {
     throw new Error(`Workspace ${input.kind} file not found: ${workspaceRelativePath}`);
   }
   return {
@@ -9168,7 +9195,7 @@ function validateSuiteFile(filePath, content, basedir) {
       continue;
     }
     const resolved = path4.resolve(basedir, testPath);
-    if (!existsSync5(resolved)) {
+    if (!existsSync6(resolved)) {
       let line = 1;
       let column = 1;
       const seqNode = testsNode;
@@ -9203,7 +9230,7 @@ function validateFilename(filePath) {
 }
 async function validateHooksFile(hooksFilePath, options = {}) {
   const diagnostics = [];
-  if (!existsSync5(hooksFilePath)) {
+  if (!existsSync6(hooksFilePath)) {
     if (options.required) {
       return [buildDiagnostic(hooksFilePath, `Configured hooks file not found: ${hooksFilePath}`)];
     }
@@ -9223,7 +9250,7 @@ async function validateHooksFile(hooksFilePath, options = {}) {
     return diagnostics;
   }
   for (const hook of hooks) {
-    if (!existsSync5(hook.file)) {
+    if (!existsSync6(hook.file)) {
       diagnostics.push({
         file: hooksFilePath,
         line: 1,
@@ -9233,7 +9260,7 @@ async function validateHooksFile(hooksFilePath, options = {}) {
       });
     }
     for (const dep of hook.deps) {
-      if (!existsSync5(dep)) {
+      if (!existsSync6(dep)) {
         diagnostics.push({
           file: hooksFilePath,
           line: 1,
@@ -9243,7 +9270,7 @@ async function validateHooksFile(hooksFilePath, options = {}) {
         });
       }
     }
-    if (hook.packageFile && !existsSync5(hook.packageFile)) {
+    if (hook.packageFile && !existsSync6(hook.packageFile)) {
       diagnostics.push({
         file: hooksFilePath,
         line: 1,
@@ -9358,7 +9385,7 @@ function validateRequiredWorkspaceFiles(workspace) {
     ["workspace.envFile", workspace.envFile],
     ["workspace.secretsFile", workspace.secretsFile]
   ]) {
-    if (!existsSync5(file.absolutePath)) {
+    if (!existsSync6(file.absolutePath)) {
       diagnostics.push(buildDiagnostic(file.absolutePath, `Configured workspace file not found: ${key} -> ${file.absolutePath}`));
     }
   }
@@ -9419,7 +9446,7 @@ async function validateProject(options = {}) {
     if (d.severity === "error") result.errorCount++;
     else result.warningCount++;
   }
-  if (hooksFilePath && hooksDiags.length === 0 && existsSync5(hooksFilePath)) {
+  if (hooksFilePath && hooksDiags.length === 0 && existsSync6(hooksFilePath)) {
     const { hooks } = await parseHooksFile(hooksFilePath);
     const hookIds = new Set(hooks.map((h) => h.id));
     for (const filePath of filePaths) {
@@ -9525,7 +9552,7 @@ function warnIfOutOfBounds(coords, viewport, actionType) {
 
 // src/hooks/migrate-hook-refs.ts
 import { mkdir as mkdir6, readFile as readFile11, rm as rm2, writeFile as writeFile6 } from "fs/promises";
-import { dirname as dirname9, relative, resolve as resolve5 } from "path";
+import { dirname as dirname10, relative, resolve as resolve6 } from "path";
 import { parse as parseYaml5, stringify as stringifyYaml2 } from "yaml";
 import { z as z20 } from "zod";
 import { generateHookId, isCanonicalHookId as isCanonicalHookId5 } from "@vostride/agent-qa-ids";
@@ -9631,7 +9658,7 @@ function rewriteSteps(owner, filePath, hookNameToId, hookIds, errors) {
   return changed;
 }
 async function resolveWorkspaceMigrationContext(workspaceDir, configPath) {
-  const resolvedConfigPath = configPath ? resolve5(configPath) : resolve5(workspaceDir, "agent-qa.config.yaml");
+  const resolvedConfigPath = configPath ? resolve6(configPath) : resolve6(workspaceDir, "agent-qa.config.yaml");
   const rawConfig = await readFile11(resolvedConfigPath, "utf-8");
   const parsedConfig = parseYaml5(rawConfig);
   const configResult = AgentQaConfigSchema.safeParse(parsedConfig);
@@ -9658,7 +9685,7 @@ async function resolveWorkspaceMigrationContext(workspaceDir, configPath) {
   };
 }
 async function auditWorkspaceHookReferenceMigration(options) {
-  const workspaceDir = resolve5(options.workspaceDir);
+  const workspaceDir = resolve6(options.workspaceDir);
   const errors = [];
   let context;
   try {
@@ -9726,7 +9753,7 @@ async function auditWorkspaceHookReferenceMigration(options) {
     });
   }
   for (const relativePath of context.targetFiles) {
-    const absolutePath = resolve5(context.configDir, relativePath);
+    const absolutePath = resolve6(context.configDir, relativePath);
     let parsedFile;
     try {
       parsedFile = parseYaml5(await readFile11(absolutePath, "utf-8"));
@@ -9767,14 +9794,14 @@ async function applyWorkspaceHookReferenceMigration(options) {
   if (!audit.ok) {
     throw new HookReferenceMigrationError(audit.errors);
   }
-  const workspaceDir = options.configPath ? dirname9(resolve5(options.configPath)) : resolve5(options.workspaceDir);
+  const workspaceDir = options.configPath ? dirname10(resolve6(options.configPath)) : resolve6(options.workspaceDir);
   for (const rewrite of audit.rewriteFiles) {
-    const outputPath = resolve5(workspaceDir, rewrite.path);
-    await mkdir6(dirname9(outputPath), { recursive: true });
+    const outputPath = resolve6(workspaceDir, rewrite.path);
+    await mkdir6(dirname10(outputPath), { recursive: true });
     await writeFile6(outputPath, rewrite.content, "utf-8");
   }
   for (const cleanupTarget of audit.cleanupTargets) {
-    await rm2(resolve5(workspaceDir, cleanupTarget), { recursive: true, force: true });
+    await rm2(resolve6(workspaceDir, cleanupTarget), { recursive: true, force: true });
   }
   return audit;
 }
@@ -9845,12 +9872,12 @@ var RUN_ARTIFACT_SCHEMA_VERSION = 1;
 // src/analytics/identity.ts
 import { chmod, mkdir as mkdir8, readFile as readFile15, writeFile as writeFile8 } from "fs/promises";
 import { homedir as homedir2 } from "os";
-import { dirname as dirname12, join as join9 } from "path";
+import { dirname as dirname13, join as join10 } from "path";
 import { idAgent } from "id-agent";
 var LOCAL_ANALYTICS_ID_PATTERN = /^u_([a-z]+-){9}[a-z]+$/;
 function getAnalyticsIdentityPath(env = process.env, homeDir = homedir2()) {
-  if (env.XDG_DATA_HOME) return join9(env.XDG_DATA_HOME, "agent-qa", "analytics.json");
-  return join9(homeDir, ".agent-qa", "analytics.json");
+  if (env.XDG_DATA_HOME) return join10(env.XDG_DATA_HOME, "agent-qa", "analytics.json");
+  return join10(homeDir, ".agent-qa", "analytics.json");
 }
 function generateAnalyticsUserId() {
   return idAgent({ prefix: "u", words: 10 });
@@ -9882,7 +9909,7 @@ async function readAnalyticsIdentity(path5) {
 }
 async function writeAnalyticsIdentity(distinctId, path5, isInternal = false) {
   const identityPath = path5 ?? getAnalyticsIdentityPath();
-  await mkdir8(dirname12(identityPath), { recursive: true });
+  await mkdir8(dirname13(identityPath), { recursive: true });
   await writeFile8(identityPath, JSON.stringify({
     distinctId,
     is_internal: isInternal
@@ -10992,6 +11019,7 @@ export {
   findSecretTemplates,
   findUnresolvedTemplates,
   flushAnalytics,
+  formatAppiumInstallGuidance,
   formatDiagnostics,
   formatDiagnosticsPlain,
   formatLogEntry,
@@ -11026,6 +11054,7 @@ export {
   listObservations,
   listProviders,
   loadLLMAuthPlugins,
+  localAppiumBinaryNames,
   mapMobileCapabilities,
   mapWebCapabilities,
   mergeRunAttributes,
@@ -11052,6 +11081,7 @@ export {
   resolveAnalyticsAgentProduct,
   resolveAnalyticsIdentity,
   resolveAnalyticsStandardProperties,
+  resolveAppiumExecutable,
   resolveBetterSqliteRebuildCommand,
   resolveFarmCredentials,
   resolveFileReferences,