prowl-tools 0.1.3 → 0.1.5

package/dist/index.js

@@ -1,23 +1,32 @@
 #!/usr/bin/env node
 import {
   DEFAULT_FLAKY_THRESHOLD,
+  analyzeMacApp,
   analyzePage,
+  assertTargetAppAllowed,
+  closeBrowser,
+  createPlaywrightDriver,
   generateHunt,
+  launchBrowser,
+  launchMacSession,
+  parseBrowserEngine,
   printCiSummary,
   rankFlaky,
   readHuntHistory,
   runHunt,
   runSuite,
+  saveStorageState,
   updateBacklogFromSuite
-} from "./chunk-T7YLXF6X.js";
+} from "./chunk-2KD2XCTH.js";
 import {
   CONFIG_DIR,
+  findConfigPath,
   listHunts,
   loadConfig,
   loadHuntMeta,
   loadHuntTags,
   resolveViewport
-} from "./chunk-NXXGJOBG.js";
+} from "./chunk-ITOSUJCN.js";
 
 // src/cli/program.ts
 import { Command as Command13 } from "commander";
@@ -25,11 +34,11 @@ import { Command as Command13 } from "commander";
 // package.json
 var package_default = {
   name: "prowl-tools",
-  version: "0.1.3",
+  version: "0.1.5",
   description: "CLI-first QA testing tool for deterministic Playwright flows.",
   type: "module",
   license: "Apache-2.0",
-  author: "Michael Tookes",
+  author: "Prowl Tools",
   repository: {
     type: "git",
     url: "https://github.com/prowl-tools/prowl.git"
@@ -95,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",
@@ -396,7 +409,6 @@ import path2 from "path";
 import readline from "readline";
 import chalk5 from "chalk";
 import { Command as Command3 } from "commander";
-import { chromium } from "playwright";
 function resolvePath(configDir, inputPath) {
   if (path2.isAbsolute(inputPath)) {
     return inputPath;
@@ -415,30 +427,35 @@ function waitForEnter(prompt) {
 }
 function buildLoginCommand() {
   const command = new Command3("login").option("--url <target>", "Override target URL").option("--config <path>", "Custom config path").action(async (options) => {
-    let browser = null;
-    let context = null;
+    let session = null;
     try {
       const { config, configDir } = loadConfig(options.config);
+      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;
       const storageStatePath = config.auth.storageStatePath ? resolvePath(configDir, config.auth.storageStatePath) : resolvePath(configDir, ".prowl/auth-state.json");
-      browser = await chromium.launch({ headless: false });
-      context = await browser.newContext();
-      const page = await context.newPage();
-      await page.goto(targetUrl);
+      session = await launchBrowser({
+        headless: false,
+        slowMo: 0,
+        timeout: config.browser.timeout,
+        trace: false,
+        recordHar: false,
+        runDir: configDir
+      });
+      const driver = createPlaywrightDriver(session.page);
+      await driver.goto(targetUrl);
       console.log(chalk5.green("Browser opened. Log in manually."));
       await waitForEnter("Press Enter to save auth state and close the browser... ");
-      await context.storageState({ path: storageStatePath });
+      await saveStorageState(session, storageStatePath);
       console.log(chalk5.green(`Saved auth state to ${storageStatePath}`));
     } catch (error) {
       const message = error instanceof Error ? error.message : "Login failed";
       console.error(chalk5.red(`Error: ${message}`));
       process.exitCode = 1;
     } finally {
-      if (context) {
-        await context.close();
-      }
-      if (browser) {
-        await browser.close();
+      if (session) {
+        await closeBrowser(session);
       }
     }
   });
@@ -763,8 +780,6 @@ function buildUpdateBaselinesCommand() {
 // src/cli/commands/analyze.ts
 import { Command as Command8 } from "commander";
 import chalk10 from "chalk";
-import { chromium as chromium2, firefox, webkit } from "playwright";
-var ENGINES = { chromium: chromium2, firefox, webkit };
 function parseViewportFlag(value) {
   const match = /^(\d+)x(\d+)$/i.exec(value);
   if (match) {
@@ -772,69 +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 = options.browser ?? "chromium";
-      const channel = options.channel;
-      const viewport = options.viewport ? resolveViewport(parseViewportFlag(options.viewport)) : { width: 1280, height: 720 };
-      const browserEngine = ENGINES[engine];
-      const browser = await browserEngine.launch({
-        headless: !options.headed,
-        channel
-      });
-      const context = await browser.newContext({ viewport });
-      const page = await context.newPage();
-      try {
-        await page.goto(url, { waitUntil: "networkidle" });
-        const result = await analyzePage(page);
-        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)}`);
+        }
+        console.log();
+      }
+      if (result.elements.length > 0) {
+        console.log(chalk10.bold("  Interactive Elements:"));
+        for (const el of result.elements) {
+          printMacElement(el);
         }
-      } finally {
-        await context.close();
-        await browser.close();
+        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) {
@@ -908,7 +1014,7 @@ function buildGenerateCommand() {
         } else if (options.output) {
           let configDir;
           try {
-            const { loadConfig: loadConfig2 } = await import("./loader-5RDNTJHH.js");
+            const { loadConfig: loadConfig2 } = await import("./loader-FCXPARP7.js");
             const result = loadConfig2(options.config);
             configDir = result.configDir;
           } catch {