@qawolf/cli 1.13.0 → 1.14.0

package/dist/cli.js

@@ -326186,6 +326186,7 @@ var interactiveRunnerMessages = {
 };
 // src/core/messages/runner.ts
 var maxListedNames = 5;
+var allowNoMatchHint = "Pass --allow-no-match to exit 0 instead.";
 function listNames(names) {
   const shown = names.slice(0, maxListedNames).join(", ");
   const rest = names.length - maxListedNames;
@@ -326195,6 +326196,10 @@ var runnerMessages = {
   playwrightLoadFailed: (envDir, detail) => packageLoadFailed("Playwright", envDir, detail),
   androidWorkersUnsupported: "Android flows are not yet supported with --workers > 1; rerun Android flows with --workers 1.",
   noFlowsMatched: "No flows matched.",
+  noFlowsMatchedPattern: (pattern) => pattern === undefined ? `No flows found. ${allowNoMatchHint}` : `No flows matched '${pattern}'. ${allowNoMatchHint}`,
+  noFlowsMatchedInEnv: (env, pattern) => pattern === undefined ? `No flows found in env '${env}'. ${allowNoMatchHint}` : `No flows matched '${pattern}' in env '${env}'. ${allowNoMatchHint}`,
+  noTargetedFlows: `No matched flow declares a target. ${allowNoMatchHint}`,
+  noRunnableFlows: `No matched flow has a target the CLI can run locally. ${allowNoMatchHint}`,
   androidBootFailed: "Android boot failed",
   preparingEnvironment: "Preparing environment",
   environmentReady: "Environment ready",
@@ -341006,7 +341011,10 @@ var inlineReasonMaxLength = 200;
 function describeIdentityError(err) {
   if (err.kind === "http") {
     if (err.status === 401 || err.status === 403) {
-      return { error: m.identity.invalidOrUnauthorized };
+      return {
+        error: m.identity.invalidOrUnauthorized,
+        ...err.status === 401 ? { exitCode: exitCodes.auth } : {}
+      };
     }
     return {
       error: m.identity.couldNotVerify(parseErrorBody(err.body, inlineReasonMaxLength), err.status)
@@ -341025,7 +341033,11 @@ function describeRequestError(err, baseUrl, noun) {
     const reason = parseErrorBody(err.body);
     const body = reason ? { errorBody: reason } : {};
     if (err.status === 401)
-      return { error: m.request.rejected401(noun), ...body };
+      return {
+        error: m.request.rejected401(noun),
+        exitCode: exitCodes.auth,
+        ...body
+      };
     if (err.status === 403)
       return { error: m.request.rejected403(noun), ...body };
     if (err.status === 404)
@@ -341074,7 +341086,11 @@ var sleep = (ms) => setTimeout2(ms);
 
 // src/shell/platform/requestWithRetry.ts
 function failureFields(failure) {
-  return failure.errorBody ? { error: failure.error, errorBody: failure.errorBody } : { error: failure.error };
+  return {
+    error: failure.error,
+    ...failure.errorBody ? { errorBody: failure.errorBody } : {},
+    ...failure.exitCode === undefined ? {} : { exitCode: failure.exitCode }
+  };
 }
 async function requestWithRetry(args) {
   const sleep2 = args.sleep ?? sleep;
@@ -345820,7 +345836,7 @@ function startUpdateCheck(deps) {
 // package.json
 var package_default = {
   name: "@qawolf/cli",
-  version: "1.13.0",
+  version: "1.14.0",
   description: "Run and manage QA Wolf flows from the terminal, CI, or an AI agent",
   keywords: [
     "automation",
@@ -346114,7 +346130,7 @@ async function handleWhoami(ctx, deps = {}) {
     } else {
       ctx.ui.output({ authenticated: false, source: undefined }, authMessages.notAuthenticated);
     }
-    return { error: "not authenticated" };
+    return { error: "not authenticated", exitCode: exitCodes.auth };
   }
   const platformClient = (deps.createPlatform ?? createPlatformClient)(resolved.key, {
     baseUrl: ctx.apiBaseUrl,
@@ -346134,7 +346150,10 @@ async function handleWhoami(ctx, deps = {}) {
         valid: false
       }, authMessages.whoami.authFailed(resolved.source, identity.error));
     }
-    return { error: "invalid key" };
+    return {
+      error: "invalid key",
+      ...identity.exitCode === undefined ? {} : { exitCode: identity.exitCode }
+    };
   }
   const { value } = identity;
   if ("user" in value) {
@@ -352872,6 +352891,16 @@ async function executeFlows(args) {
   }
 }
 
+// src/domains/runner/noMatch.ts
+function noMatchResult(ctx, args) {
+  if (!args.allowNoMatch) {
+    return { error: args.error, exitCode: exitCodes.invalidArgs };
+  }
+  if (args.notice !== undefined)
+    ctx.ui.info(args.notice);
+  return;
+}
+
 // src/domains/runner/run.ts
 async function flowsRun(ctx, files, flags, deps) {
   const flows = [];
@@ -352907,10 +352936,12 @@ async function flowsRun(ctx, files, flags, deps) {
   }
   flows.sort((a2, b3) => a2.file.localeCompare(b3.file));
   if (flows.length === 0) {
-    if (skippedByType.size === 0) {
-      ctx.ui.info(runnerMessages.noFlowsMatched);
-    }
-    return;
+    const skipped = skippedByType.size > 0;
+    return noMatchResult(ctx, {
+      allowNoMatch: flags.allowNoMatch,
+      error: skipped ? runnerMessages.noRunnableFlows : runnerMessages.noTargetedFlows,
+      notice: skipped ? undefined : runnerMessages.noFlowsMatched
+    });
   }
   const webFlows = flows.filter((f3) => f3.kind === "web");
   const browsers = [
@@ -355280,8 +355311,11 @@ async function handleFlowsRun(ctx, pattern, flags, deps) {
   const expandedFiles = await resolvedDeps.expandPatterns(buildPatternArgs(pattern), cwd, ctx.log("flows"));
   ctx.log("flows").debug(`discovered ${pluralize(expandedFiles.length, "flow")}`);
   if (expandedFiles.length === 0) {
-    ctx.ui.info(runnerMessages.noFlowsMatched);
-    return;
+    return noMatchResult(ctx, {
+      allowNoMatch: flags.allowNoMatch,
+      error: runnerMessages.noFlowsMatchedPattern(pattern),
+      notice: runnerMessages.noFlowsMatched
+    });
   }
   return runStagedFlows({
     ctx,
@@ -355321,10 +355355,11 @@ async function handleHybridFlowsRun(ctx, pattern, flags, deps) {
       return pullResult;
     files = await globFlows();
     if (files.length === 0) {
-      return {
-        error: pattern !== undefined ? `No flows matched '${pattern}' in env '${flags.env}'` : `No flows found in env '${flags.env}'`,
-        exitCode: 2
-      };
+      return noMatchResult(ctx, {
+        allowNoMatch: flags.allowNoMatch,
+        error: runnerMessages.noFlowsMatchedInEnv(flags.env, pattern),
+        notice: runnerMessages.noFlowsMatched
+      });
     }
   }
   return runStagedFlows({ ctx, files, flags, envDir, deps: resolvedDeps });
@@ -355348,7 +355383,7 @@ Examples:
 function registerFlowsRunCommand(flows, signals) {
   declareCommandKind(flows.command("run [pattern]"), "local", {
     kindNote: "read with --env"
-  }).description("Run flows matching [pattern], or every flow when omitted; with --env, pull missing flows from that QA Wolf environment").option("--retries <n>", "Retry each failing flow up to this many times", parseInteger("--retries", { min: 0 }), 0).option("--bail", "Stop the run after the first failure", false).option("--workers <n>", "Parallel worker count for web flows", parseInteger("--workers", { min: 1 }), 1).option("--timeout <ms>", "Default timeout for actions and assertions, in milliseconds", parseInteger("--timeout", { min: 0 }), 30000).option("--video <mode>", "Record video: on | off | retain-on-failure", parseEnum("--video", videoModes), videoDefault).option("--trace <mode>", "Record Playwright trace: on | off | retain-on-failure", parseEnum("--trace", traceModes), traceDefault).option("--har <mode>", "Record HAR network log: on | off | retain-on-failure", parseEnum("--har", harModes), harDefault).option("--har-content <mode>", "HAR response bodies: omit | full (full uses more memory)", parseEnum("--har-content", harContentModes), harContentDefault).option("--output-dir <path>", "Directory for run artifacts (videos, traces, HAR)", defaultOutputDir).option("--junit [path]", "Write a JUnit XML report (default: <output-dir>/junit-report.xml)").option("--headed", "Show the browser window instead of headless", false).option("--env <env>", "Pull and run a flow from this environment (UUID or slug) if not cached locally").option("--deps <dir>", "Use this prepared dependency directory instead of auto-installing the runtime; or set QAWOLF_RUNTIME_DIR to relocate the managed runtime").option("--no-browser-deps", "Skip installing OS-level browser dependencies (Linux --with-deps, which needs root); requires the system libraries to already be present").addHelpText("after", runExamples).action((pattern, opts, command) => {
+  }).description("Run flows matching [pattern], or every flow when omitted; with --env, pull missing flows from that QA Wolf environment").option("--retries <n>", "Retry each failing flow up to this many times", parseInteger("--retries", { min: 0 }), 0).option("--bail", "Stop the run after the first failure", false).option("--workers <n>", "Parallel worker count for web flows", parseInteger("--workers", { min: 1 }), 1).option("--timeout <ms>", "Default timeout for actions and assertions, in milliseconds", parseInteger("--timeout", { min: 0 }), 30000).option("--video <mode>", "Record video: on | off | retain-on-failure", parseEnum("--video", videoModes), videoDefault).option("--trace <mode>", "Record Playwright trace: on | off | retain-on-failure", parseEnum("--trace", traceModes), traceDefault).option("--har <mode>", "Record HAR network log: on | off | retain-on-failure", parseEnum("--har", harModes), harDefault).option("--har-content <mode>", "HAR response bodies: omit | full (full uses more memory)", parseEnum("--har-content", harContentModes), harContentDefault).option("--output-dir <path>", "Directory for run artifacts (videos, traces, HAR)", defaultOutputDir).option("--junit [path]", "Write a JUnit XML report (default: <output-dir>/junit-report.xml)").option("--headed", "Show the browser window instead of headless", false).option("--env <env>", "Pull and run a flow from this environment (UUID or slug) if not cached locally").option("--deps <dir>", "Use this prepared dependency directory instead of auto-installing the runtime; or set QAWOLF_RUNTIME_DIR to relocate the managed runtime").option("--allow-no-match", "Exit 0 instead of 2 when the pattern selects no runnable flow", false).option("--no-browser-deps", "Skip installing OS-level browser dependencies (Linux --with-deps, which needs root); requires the system libraries to already be present").addHelpText("after", runExamples).action((pattern, opts, command) => {
     if (opts.env !== undefined) {
       return withResolvedEnv(signals, {
         explicit: opts.env,
@@ -358159,4 +358194,4 @@ createProgram({ signals }).parseAsync().catch(() => {
     process.exitCode = 1;
 }).finally(() => flushAndExit(typeof process.exitCode === "number" ? process.exitCode : 0));
 
-//# debugId=23E147B93341D71864756E2164756E21
+//# debugId=9D7349D928400D0E64756E2164756E21

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@qawolf/cli",
-  "version": "1.13.0",
+  "version": "1.14.0",
   "description": "Run and manage QA Wolf flows from the terminal, CI, or an AI agent",
   "keywords": [
     "automation",