prowl-tools 0.1.6 → 0.1.7

package/dist/index.js

@@ -1,6 +1,7 @@
 #!/usr/bin/env node
 import {
   DEFAULT_FLAKY_THRESHOLD,
+  MACDRIVER_VERSION,
   analyzeAndroidApp,
   analyzeIosApp,
   analyzeMacApp,
@@ -9,12 +10,15 @@ import {
   assertIosAppAllowed,
   assertTargetAppAllowed,
   closeBrowser,
+  collectMacdriverStatus,
   createPlaywrightDriver,
   generateHunt,
+  installMacdriver,
   launchAndroidSession,
   launchBrowser,
   launchIosSession,
   launchMacSession,
+  macdriverReleaseTag,
   parseBrowserEngine,
   printCiSummary,
   rankFlaky,
@@ -22,8 +26,9 @@ import {
   runHunt,
   runSuite,
   saveStorageState,
+  tccGuidance,
   updateBacklogFromSuite
-} from "./chunk-5KQR3IR3.js";
+} from "./chunk-R7NUH44M.js";
 import {
   CONFIG_DIR,
   findConfigPath,
@@ -31,17 +36,18 @@ import {
   loadConfig,
   loadHuntMeta,
   loadHuntTags,
+  normalizeHuntName,
   resolveViewport
-} from "./chunk-WHAMB4TY.js";
+} from "./chunk-O3OUTZ2P.js";
 
 // src/cli/program.ts
-import { Command as Command13 } from "commander";
+import { Command as Command14 } from "commander";
 
 // package.json
 var package_default = {
   name: "prowl-tools",
-  version: "0.1.6",
-  description: "CLI-first QA testing tool for deterministic Playwright flows.",
+  version: "0.1.7",
+  description: "E2E testing for native macOS apps and web apps from declarative YAML hunts.",
   type: "module",
   license: "Apache-2.0",
   author: "Prowl Tools",
@@ -56,9 +62,12 @@ var package_default = {
   keywords: [
     "testing",
     "qa",
+    "e2e",
+    "macos",
+    "desktop-testing",
+    "accessibility",
     "playwright",
     "yaml",
-    "e2e",
     "browser-testing",
     "automation",
     "web-testing",
@@ -274,7 +283,11 @@ ${bot}`);
 
 // src/cli/commands/run.ts
 function buildRunCommand() {
-  const command = new Command("run").argument("<hunt-name>", "Hunt name or path (e.g. homepage or admin/users-crud)").option("--url <target>", "Override target URL").option("--headed", "Show browser window").option("--slow-mo <ms>", "Slow down Playwright actions", (value) => Number(value)).option("--trace", "Capture Playwright trace").option("--browser <engine>", "Browser engine: chromium, firefox, or webkit").option("--channel <name>", "Browser channel: chrome, msedge, chrome-beta, etc.").option("--viewport <size>", "Viewport size: WxH (e.g. 1920x1080) or preset (mobile, tablet, desktop)").option("--include-tags <tags>", "Only run hunts matching these tags (comma-separated)").option("--exclude-tags <tags>", "Skip hunts matching these tags (comma-separated)").option("--junit", "Generate JUnit XML report").option("--config <path>", "Custom config path").option("--json", "Output results as JSON").action(async (huntName, options) => {
+  const command = new Command("run").argument(
+    "<hunt-name>",
+    "Hunt name or path (e.g. homepage, admin/users-crud, or .prowl/hunts/homepage.yml)"
+  ).option("--url <target>", "Override target URL").option("--headed", "Show browser window").option("--slow-mo <ms>", "Slow down Playwright actions", (value) => Number(value)).option("--trace", "Capture Playwright trace").option("--browser <engine>", "Browser engine: chromium, firefox, or webkit").option("--channel <name>", "Browser channel: chrome, msedge, chrome-beta, etc.").option("--viewport <size>", "Viewport size: WxH (e.g. 1920x1080) or preset (mobile, tablet, desktop)").option("--include-tags <tags>", "Only run hunts matching these tags (comma-separated)").option("--exclude-tags <tags>", "Skip hunts matching these tags (comma-separated)").option("--junit", "Generate JUnit XML report").option("--config <path>", "Custom config path").option("--json", "Output results as JSON").action(async (huntArg, options) => {
+    const huntName = normalizeHuntName(huntArg);
     try {
       if (options.includeTags || options.excludeTags) {
         const { configDir } = loadConfig(options.config);
@@ -409,7 +422,7 @@ function buildInitCommand() {
     console.log(welcomeBanner());
     console.log(chalk4.green(`  Initialized ${CONFIG_DIR} directory.`));
     console.log(chalk4.gray("  Run ") + chalk4.bold("prowl run hello") + chalk4.gray(" to get started."));
-    console.log(chalk4.gray("  Browse hunt templates at ") + chalk4.cyan("https://hub.prowl.tools") + "\n");
+    console.log(chalk4.gray("  See ") + chalk4.cyan(`${CONFIG_DIR}/hunts/login-flow.yml`) + chalk4.gray(" for a fuller example.") + "\n");
   });
   return command;
 }
@@ -546,7 +559,11 @@ function createDebouncer(delayMs, fn) {
 
 // src/cli/commands/watch.ts
 function buildWatchCommand() {
-  const command = new Command5("watch").argument("<hunt-name>", "Hunt name or path (e.g. homepage or admin/users-crud)").option("--url <target>", "Override target URL").option("--headed", "Show browser window").option("--slow-mo <ms>", "Slow down Playwright actions", (value) => Number(value)).option("--trace", "Capture Playwright trace").option("--config <path>", "Custom config path").action(async (huntName, options) => {
+  const command = new Command5("watch").argument(
+    "<hunt-name>",
+    "Hunt name or path (e.g. homepage, admin/users-crud, or .prowl/hunts/homepage.yml)"
+  ).option("--url <target>", "Override target URL").option("--headed", "Show browser window").option("--slow-mo <ms>", "Slow down Playwright actions", (value) => Number(value)).option("--trace", "Capture Playwright trace").option("--config <path>", "Custom config path").action(async (huntArg, options) => {
+    const huntName = normalizeHuntName(huntArg);
     const { configDir } = loadConfig(options.config);
     const watchTargets = getWatchTargets(configDir, huntName);
     let running = false;
@@ -1177,7 +1194,7 @@ function buildGenerateCommand() {
         } else if (options.output) {
           let configDir;
           try {
-            const { loadConfig: loadConfig2 } = await import("./loader-PBBYV3U7.js");
+            const { loadConfig: loadConfig2 } = await import("./loader-X37URHUV.js");
             const result = loadConfig2(options.config);
             configDir = result.configDir;
           } catch {
@@ -1211,13 +1228,17 @@ function buildGenerateCommand() {
 import { Command as Command10 } from "commander";
 import chalk12 from "chalk";
 function buildHistoryCommand() {
-  const command = new Command10("history").argument("<hunt-name>", "Hunt name or path (e.g. homepage or admin/users-crud)").description("Show run history for a hunt").option("--config <path>", "Custom config path").option("--limit <n>", "Show the last N runs (default: 20)", (value) => {
+  const command = new Command10("history").argument(
+    "<hunt-name>",
+    "Hunt name or path (e.g. homepage, admin/users-crud, or .prowl/hunts/homepage.yml)"
+  ).description("Show run history for a hunt").option("--config <path>", "Custom config path").option("--limit <n>", "Show the last N runs (default: 20)", (value) => {
     const n = Number(value);
     if (!Number.isInteger(n) || n < 1) {
       throw new Error("--limit must be a positive integer");
     }
     return n;
-  }).option("--json", "Output as JSON").action((huntName, options) => {
+  }).option("--json", "Output as JSON").action((huntArg, options) => {
+    const huntName = normalizeHuntName(huntArg);
     try {
       const { configDir } = loadConfig(options.config);
       const entries = readHuntHistory(configDir, huntName);
@@ -1605,10 +1626,83 @@ function buildMcpCommand() {
   });
 }
 
+// src/cli/commands/macdriver.ts
+import chalk14 from "chalk";
+import { Command as Command13 } from "commander";
+function buildInstallCommand() {
+  return new Command13("install").description("Download and install the prebuilt, signed prowl-macdriver helper").option("--force", "Reinstall even if the pinned version is already present").action(async (options) => {
+    try {
+      console.log(
+        chalk14.cyan(
+          `Installing prowl-macdriver ${MACDRIVER_VERSION} (${macdriverReleaseTag(MACDRIVER_VERSION)})\u2026`
+        )
+      );
+      const result = await installMacdriver({ force: options.force });
+      if (result.alreadyInstalled) {
+        console.log(
+          chalk14.green(`Already installed at ${result.binaryPath}`) + chalk14.dim(" (use --force to reinstall)")
+        );
+      } else {
+        console.log(chalk14.green(`Installed prowl-macdriver ${result.version} \u2192 ${result.binaryPath}`));
+      }
+      console.log("");
+      console.log(tccGuidance());
+    } catch (error) {
+      const message = error instanceof Error ? error.message : "Install failed";
+      console.error(chalk14.red(`Error: ${message}`));
+      process.exitCode = 1;
+    }
+  });
+}
+function buildStatusCommand() {
+  return new Command13("status").description("Report the resolved prowl-macdriver binary, installed versions, and permissions guidance").action(async () => {
+    try {
+      const status = await collectMacdriverStatus();
+      console.log(chalk14.bold("prowl-macdriver status"));
+      console.log(`  pinned version:   ${status.pinnedVersion}`);
+      if (status.resolved) {
+        const label = status.resolved.source === "env" ? "PROWL_MACDRIVER_BIN override" : status.resolved.source === "user-install" ? "user install (~/.prowl/macdriver)" : "repo source build (macdriver/.build)";
+        console.log(`  resolved binary:  ${status.resolved.path}`);
+        console.log(`  resolved via:     ${label}`);
+        console.log(
+          `  runs:             ${status.probedVersion ? chalk14.green(`yes (reports ${status.probedVersion})`) : chalk14.yellow("no (binary did not respond to `version`)")}`
+        );
+      } else {
+        console.log(`  resolved binary:  ${chalk14.yellow("none")}`);
+        console.log(chalk14.dim("  search order: PROWL_MACDRIVER_BIN \u2192 ~/.prowl/macdriver \u2192 macdriver/.build"));
+        console.log(chalk14.cyan("  Run `prowl macdriver install` to install the prebuilt helper."));
+      }
+      if (status.installed.length > 0) {
+        console.log("  installed versions:");
+        for (const entry of status.installed) {
+          const marker = entry.version === status.pinnedVersion ? chalk14.green(" (pinned)") : "";
+          console.log(`    - ${entry.version}${marker}  ${chalk14.dim(entry.binaryPath)}`);
+        }
+      } else {
+        console.log("  installed versions: none");
+      }
+      console.log("");
+      console.log(tccGuidance());
+    } catch (error) {
+      const message = error instanceof Error ? error.message : "Status failed";
+      console.error(chalk14.red(`Error: ${message}`));
+      process.exitCode = 1;
+    }
+  });
+}
+function buildMacdriverCommand() {
+  const command = new Command13("macdriver").description(
+    "Manage the macOS helper binary (prowl-macdriver) for the macOS target"
+  );
+  command.addCommand(buildInstallCommand());
+  command.addCommand(buildStatusCommand());
+  return command;
+}
+
 // src/cli/program.ts
 var CLI_VERSION = package_default.version;
 function buildProgram() {
-  const program2 = new Command13();
+  const program2 = new Command14();
   program2.name("prowl").description("CLI-first QA testing tool for deterministic Playwright flows").version(CLI_VERSION);
   program2.addCommand(buildRunCommand());
   program2.addCommand(buildCiCommand());
@@ -1622,6 +1716,7 @@ function buildProgram() {
   program2.addCommand(buildHistoryCommand());
   program2.addCommand(buildFlakyCommand());
   program2.addCommand(buildMcpCommand());
+  program2.addCommand(buildMacdriverCommand());
   return program2;
 }