prowl-tools 0.1.4 → 0.1.5

package/dist/index.js

@@ -1,11 +1,14 @@
 #!/usr/bin/env node
 import {
   DEFAULT_FLAKY_THRESHOLD,
+  analyzeMacApp,
   analyzePage,
+  assertTargetAppAllowed,
   closeBrowser,
   createPlaywrightDriver,
   generateHunt,
   launchBrowser,
+  launchMacSession,
   parseBrowserEngine,
   printCiSummary,
   rankFlaky,
@@ -14,15 +17,16 @@ import {
   runSuite,
   saveStorageState,
   updateBacklogFromSuite
-} from "./chunk-ZEFVTKQT.js";
+} from "./chunk-2KD2XCTH.js";
 import {
   CONFIG_DIR,
+  findConfigPath,
   listHunts,
   loadConfig,
   loadHuntMeta,
   loadHuntTags,
   resolveViewport
-} from "./chunk-MBAIGNVO.js";
+} from "./chunk-ITOSUJCN.js";
 
 // src/cli/program.ts
 import { Command as Command13 } from "commander";
@@ -30,7 +34,7 @@ import { Command as Command13 } from "commander";
 // package.json
 var package_default = {
   name: "prowl-tools",
-  version: "0.1.4",
+  version: "0.1.5",
   description: "CLI-first QA testing tool for deterministic Playwright flows.",
   type: "module",
   license: "Apache-2.0",
@@ -100,6 +104,10 @@ var package_default = {
     yaml: "^2.6.1",
     zod: "^3.23.8"
   },
+  optionalDependencies: {
+    "appium-uiautomator2-server": "10.6.2",
+    "appium-webdriveragent": "16.4.0"
+  },
   devDependencies: {
     "@types/node": "^22.13.1",
     "@types/pngjs": "^6.0.5",
@@ -422,7 +430,7 @@ function buildLoginCommand() {
     let session = null;
     try {
       const { config, configDir } = loadConfig(options.config);
-      if (config.target.type === "macos") {
+      if (config.target.type !== "web") {
         throw new Error("`prowl login` captures browser auth state and only applies to web targets.");
       }
       const targetUrl = options.url ?? config.target.url;
@@ -779,73 +787,160 @@ function parseViewportFlag(value) {
   }
   return value;
 }
-function buildAnalyzeCommand() {
-  const command = new Command8("analyze").argument("<url>", "URL to analyze").description("Analyze a page to discover interactive elements and selectors").option("--json", "Output as JSON").option("--browser <engine>", "Browser engine: chromium, firefox, or webkit").option("--channel <name>", "Browser channel: chrome, msedge, etc.").option("--viewport <size>", "Viewport size: WxH or preset (mobile, tablet, desktop)").option("--headed", "Show browser window").option("--config <path>", "Custom config path").action(async (url, options) => {
-    try {
-      const engine = parseBrowserEngine(options.browser);
-      const channel = options.channel;
-      const viewport = options.viewport ? resolveViewport(parseViewportFlag(options.viewport)) : { width: 1280, height: 720 };
-      const session = await launchBrowser({
-        headless: !options.headed,
-        slowMo: 0,
-        timeout: 3e4,
-        trace: false,
-        recordHar: false,
-        runDir: process.cwd(),
-        engine,
-        channel,
-        viewport
-      });
-      const driver = createPlaywrightDriver(session.page);
-      try {
-        await driver.goto(url, { waitUntil: "networkidle" });
-        const result = await analyzePage(driver);
-        if (options.json) {
-          console.log(JSON.stringify(result, null, 2));
-        } else {
-          console.log(`
+function tryLoadConfig(configPath) {
+  const configLocation = configPath !== void 0 ? configPath : findConfigPath(process.cwd());
+  if (configLocation === null) {
+    return null;
+  }
+  try {
+    return loadConfig(configLocation).config;
+  } catch (error) {
+    const message = error instanceof Error ? error.message : "Unknown configuration error";
+    throw new Error(`Failed to load config at ${configLocation}: ${message}`);
+  }
+}
+async function runWebAnalyze(url, options) {
+  const engine = parseBrowserEngine(options.browser);
+  const channel = options.channel;
+  const viewport = options.viewport ? resolveViewport(parseViewportFlag(options.viewport)) : { width: 1280, height: 720 };
+  const session = await launchBrowser({
+    headless: !options.headed,
+    slowMo: 0,
+    timeout: 3e4,
+    trace: false,
+    recordHar: false,
+    runDir: process.cwd(),
+    engine,
+    channel,
+    viewport
+  });
+  const driver = createPlaywrightDriver(session.page);
+  try {
+    await driver.goto(url, { waitUntil: "networkidle" });
+    const result = await analyzePage(driver);
+    if (options.json) {
+      console.log(JSON.stringify(result, null, 2));
+    } else {
+      console.log(`
   ${chalk10.bold("Page Analysis:")} ${result.title}`);
-          console.log(`  ${chalk10.gray("URL:")} ${result.url}
+      console.log(`  ${chalk10.gray("URL:")} ${result.url}
 `);
-          if (result.forms.length > 0) {
-            console.log(chalk10.bold("  Forms:"));
-            for (const form of result.forms) {
-              const method = form.method ? chalk10.cyan(form.method) : "";
-              const action = form.action ? chalk10.gray(form.action) : "";
-              console.log(`    [${form.index}] ${method} ${action} (${form.fieldCount} fields)`);
-            }
-            console.log();
-          }
-          if (result.elements.length > 0) {
-            console.log(chalk10.bold("  Interactive Elements:"));
-            for (const el of result.elements) {
-              const tag = chalk10.cyan(el.tag);
-              const type = el.type ? chalk10.gray(`[${el.type}]`) : "";
-              const bestSelector = el.selectors.testId ?? el.selectors.label ?? el.selectors.ariaLabel ?? el.selectors.css ?? el.selectors.name ?? "";
-              const selectorStr = bestSelector ? chalk10.yellow(bestSelector) : chalk10.gray("(no selector)");
-              const req = el.required ? chalk10.red(" *") : "";
-              const form = el.formGroup !== void 0 ? chalk10.gray(` form[${el.formGroup}]`) : "";
-              console.log(`    ${tag}${type} ${selectorStr}${req}${form}`);
-            }
-            console.log();
-          }
-          if (result.links.length > 0) {
-            console.log(chalk10.bold("  Links:"));
-            for (const link of result.links.slice(0, 20)) {
-              const text = link.text || chalk10.gray("(no text)");
-              console.log(`    ${text} ${chalk10.gray("\u2192")} ${chalk10.blue(link.href)}`);
-            }
-            if (result.links.length > 20) {
-              console.log(chalk10.gray(`    ... and ${result.links.length - 20} more`));
-            }
-            console.log();
-          }
-          console.log(chalk10.gray(`  ${result.elements.length} elements, ${result.forms.length} forms, ${result.links.length} links
+      if (result.forms.length > 0) {
+        console.log(chalk10.bold("  Forms:"));
+        for (const form of result.forms) {
+          const method = form.method ? chalk10.cyan(form.method) : "";
+          const action = form.action ? chalk10.gray(form.action) : "";
+          console.log(`    [${form.index}] ${method} ${action} (${form.fieldCount} fields)`);
+        }
+        console.log();
+      }
+      if (result.elements.length > 0) {
+        console.log(chalk10.bold("  Interactive Elements:"));
+        for (const el of result.elements) {
+          const tag = chalk10.cyan(el.tag);
+          const type = el.type ? chalk10.gray(`[${el.type}]`) : "";
+          const bestSelector = el.selectors.testId ?? el.selectors.label ?? el.selectors.ariaLabel ?? el.selectors.css ?? el.selectors.name ?? "";
+          const selectorStr = bestSelector ? chalk10.yellow(bestSelector) : chalk10.gray("(no selector)");
+          const req = el.required ? chalk10.red(" *") : "";
+          const form = el.formGroup !== void 0 ? chalk10.gray(` form[${el.formGroup}]`) : "";
+          console.log(`    ${tag}${type} ${selectorStr}${req}${form}`);
+        }
+        console.log();
+      }
+      if (result.links.length > 0) {
+        console.log(chalk10.bold("  Links:"));
+        for (const link of result.links.slice(0, 20)) {
+          const text = link.text || chalk10.gray("(no text)");
+          console.log(`    ${text} ${chalk10.gray("\u2192")} ${chalk10.blue(link.href)}`);
+        }
+        if (result.links.length > 20) {
+          console.log(chalk10.gray(`    ... and ${result.links.length - 20} more`));
+        }
+        console.log();
+      }
+      console.log(chalk10.gray(`  ${result.elements.length} elements, ${result.forms.length} forms, ${result.links.length} links
 `));
+    }
+  } finally {
+    await closeBrowser(session);
+  }
+}
+function printMacElement(el) {
+  const role = chalk10.cyan(el.role);
+  const [best] = el.selectors;
+  const selectorStr = best ? chalk10.yellow(best) : chalk10.gray("(no selector)");
+  const label = el.title ?? el.description ?? el.value;
+  const labelStr = label ? ` ${chalk10.gray(`"${label}"`)}` : "";
+  const disabled = el.enabled === false ? chalk10.gray(" (disabled)") : "";
+  console.log(`    ${role} ${selectorStr}${labelStr}${disabled}`);
+}
+async function runMacAnalyze(app, config, options) {
+  const allowedApps = config?.guardrails.allowedApps ?? [];
+  assertTargetAppAllowed(allowedApps, app);
+  const session = await launchMacSession({ app, timeoutMs: config?.browser.timeout });
+  try {
+    const result = await analyzeMacApp(session.client, { app: session.bundleId });
+    if (options.json) {
+      console.log(JSON.stringify(result, null, 2));
+    } else {
+      console.log(`
+  ${chalk10.bold("App Analysis:")} ${result.app}
+`);
+      if (result.windows.length > 0) {
+        console.log(chalk10.bold("  Windows:"));
+        for (const win of result.windows) {
+          const title = win.title ? chalk10.gray(`"${win.title}"`) : chalk10.gray("(untitled)");
+          console.log(`    ${title} ${chalk10.yellow(win.selector)}`);
         }
-      } finally {
-        await closeBrowser(session);
+        console.log();
+      }
+      if (result.elements.length > 0) {
+        console.log(chalk10.bold("  Interactive Elements:"));
+        for (const el of result.elements) {
+          printMacElement(el);
+        }
+        console.log();
+      }
+      if (result.menuItems.length > 0) {
+        console.log(chalk10.bold("  Menu Bar:"));
+        for (const el of result.menuItems) {
+          printMacElement(el);
+        }
+        console.log();
+      }
+      console.log(
+        chalk10.gray(
+          `  ${result.elements.length} elements, ${result.windows.length} windows, ${result.menuItems.length} menu items
+`
+        )
+      );
+    }
+  } finally {
+    await session.client.close();
+  }
+}
+function buildAnalyzeCommand() {
+  const command = new Command8("analyze").argument("[url]", "URL to analyze (web target)").description("Analyze a page or macOS app to discover interactive elements and selectors").option("--json", "Output as JSON").option("--app <app>", "macOS app to analyze: bundle id or /path/to/App.app (macOS target)").option("--browser <engine>", "Browser engine: chromium, firefox, or webkit").option("--channel <name>", "Browser channel: chrome, msedge, etc.").option("--viewport <size>", "Viewport size: WxH or preset (mobile, tablet, desktop)").option("--headed", "Show browser window").option("--config <path>", "Custom config path").action(async (url, options) => {
+    try {
+      if (options.app && url) {
+        throw new Error("Pass either a URL argument (web) or --app (macOS), not both.");
       }
+      if (options.app) {
+        await runMacAnalyze(options.app, tryLoadConfig(options.config), options);
+        return;
+      }
+      if (url) {
+        await runWebAnalyze(url, options);
+        return;
+      }
+      const config = tryLoadConfig(options.config);
+      if (config?.target.type === "macos") {
+        await runMacAnalyze(config.target.app, config, options);
+        return;
+      }
+      throw new Error(
+        "analyze needs a target: pass a URL for the web target, or use --app <bundle-id|.app-path> (or set target.type: macos in .prowl/config.yml) for the macOS target."
+      );
     } catch (error) {
       const message = error instanceof Error ? error.message : "Analysis failed";
       if (options.json) {
@@ -919,7 +1014,7 @@ function buildGenerateCommand() {
         } else if (options.output) {
           let configDir;
           try {
-            const { loadConfig: loadConfig2 } = await import("./loader-XMTDB6OL.js");
+            const { loadConfig: loadConfig2 } = await import("./loader-FCXPARP7.js");
             const result = loadConfig2(options.config);
             configDir = result.configDir;
           } catch {