@qawolf/cli 1.13.0 → 1.15.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;
@@ -342171,7 +342187,14 @@ var makeCreateRunContract = (ids) => {
     pullRequestNumber: exports_external.number().int().positive().describe("The number of the pull request to associate with the run.").optional(),
     repository: exports_external.string().min(1).describe('The owner/name of the repository, e.g. "acme/web".').optional()
   }).and(makeFlowSelectionSchema(ids));
-  const output = resource({ runId: ids.run }, { urlFieldDescription: "Absolute URL of the run page." });
+  const output = resource({
+    excludedFlows: exports_external.array(exports_external.object({
+      flowId: ids.flow,
+      name: exports_external.string().describe("The name of the flow."),
+      reason: exports_external.enum(["deleted", "not-on-branch"]).describe('Why the flow cannot run: "deleted" means the flow was deleted, "not-on-branch" means the flow has no file at the commit the run was created from.')
+    })).describe("Explicitly requested flows that were left out of the run, each with the reason. Flows selected through tags are not reported here."),
+    runId: ids.run
+  }, { urlFieldDescription: "Absolute URL of the run page." });
   return {
     description: "Create a run for the selected flows and/or tags in an environment.",
     input,
@@ -342531,7 +342554,7 @@ var makeEnvironmentResourceSchema = (ids) => resource({
   kind: exports_external.enum(["static", "preview"]).describe("Whether the environment is static or a preview."),
   name: exports_external.string(),
   runConcurrencyLimit: exports_external.string().describe('Maximum number of concurrent runs: a whole number, "unlimited", or a concurrency expression.'),
-  status: exports_external.enum(["blocked", "needs-investigation", "ready", "running"]).describe("Standing health across the environment's runs: blocked (open blocking bugs), needs-investigation (failures awaiting triage), running (flows executing), ready (none of the above — the greenlit state)."),
+  status: exports_external.enum(["blocked", "needs-investigation", "ready", "running"]).describe("Standing health across the environment's runs, not its Git reconciliation state: blocked (open blocking bugs), needs-investigation (failures awaiting triage), running (flows executing), ready (none of the above — the greenlit state)."),
   terminatedAt: exports_external.iso.datetime().optional().describe("When the environment was terminated, if it has been.")
 }, { urlFieldDescription: "Absolute URL of the environment page." });
 
@@ -342540,6 +342563,7 @@ var makeFindEnvironmentsContract = (ids) => {
   const input = exports_external.object({
     includeTerminated: exports_external.boolean().default(false).describe("Also list terminated environments. By default only environments that have not been terminated are listed."),
     kind: exports_external.enum(["static", "preview"]).optional().describe("Only list environments of this kind. Omit to list both."),
+    workspaceId: ids.workspace.optional().describe("The workspace to list environments from. Required when authenticating with an organization or user API key."),
     ...makePaginationInputFields({ defaultLimit: 20, maxLimit: 100 })
   });
   const output = exports_external.object({
@@ -342585,7 +342609,7 @@ var makeGetEnvironmentContract = (ids) => {
   });
   const output = makeEnvironmentResourceSchema(ids);
   return {
-    description: "Read a single environment's name, kind, health status, run concurrency limit, and termination state.",
+    description: "Read a single environment's name, kind, standing run health, flow-code branch and reconciliation state, run concurrency limit, and termination state. If flowCodeBranch exists, use its syncStatus for Git reconciliation and read lastSyncedCommitHash only when syncStatus is reconciled.",
     input,
     kind: "read",
     name: "environment.get",
@@ -342627,7 +342651,7 @@ var makeSetEnvironmentVariableContract = (ids) => {
 var makeCreateEnvironmentContract = (ids) => {
   const input = exports_external.object({
     name: exports_external.string().min(1).max(255).regex(/\S/, "Environment name cannot be blank.").describe("Display name of the new environment."),
-    workspaceId: ids.workspace.optional().describe("The workspace to create the environment in. Required when authenticating with an organization API key.")
+    workspaceId: ids.workspace.optional().describe("The workspace to create the environment in. Required when authenticating with an organization or user API key.")
   });
   const output = makeEnvironmentResourceSchema(ids);
   return {
@@ -342667,9 +342691,10 @@ var makeTagResourceSchema = () => resource({
 }, {
   urlFieldDescription: "Absolute URL of the team's tag settings page."
 });
-var makeCreateTagContract = () => {
+var makeCreateTagContract = (ids) => {
   const input = exports_external.object({
-    name: exports_external.string().trim().min(1).max(255).refine((name) => !name.includes(","), "Tag names cannot include commas.")
+    name: exports_external.string().trim().min(1).max(255).refine((name) => !name.includes(","), "Tag names cannot include commas."),
+    workspaceId: ids.workspace.optional().describe("The workspace to create the tag in. Required when authenticating with an organization or user API key.")
   });
   const output = makeTagResourceSchema();
   return {
@@ -342793,7 +342818,7 @@ var makeFindIssuesContract = (ids) => {
     ...makePaginationInputFields({ defaultLimit: 20, maxLimit: 100 }),
     statuses: exports_external.array(issueStatusSchema).min(1).default([...openIssueStatuses]).describe("Issue statuses to include. Defaults to pending, in-progress, and paused issues."),
     type: publicIssueTypeSchema.describe("The issue type to include: bug report, maintenance report, or coverage request."),
-    workspaceId: ids.workspace.optional().describe("The workspace whose issues to list. Required when authenticating with an organization API key.")
+    workspaceId: ids.workspace.optional().describe("The workspace whose issues to list. Required when authenticating with an organization or user API key.")
   });
   const output = exports_external.object({
     issues: exports_external.array(makeIssueResourceSchema(ids)).describe("The team's bug reports, maintenance reports, or coverage requests, newest first."),
@@ -342847,7 +342872,7 @@ var makeCreateIssueContract = (ids) => {
     description: exports_external.string().optional().describe("The issue description as plain text; each line becomes a paragraph. Markdown is not parsed."),
     name: exports_external.string().trim().min(1).max(255),
     priority: issuePrioritySchema.optional().describe('Defaults to "unprioritized".'),
-    workspaceId: ids.workspace.optional().describe("The workspace to create the issue in. Required when authenticating with an organization API key.")
+    workspaceId: ids.workspace.optional().describe("The workspace to create the issue in. Required when authenticating with an organization or user API key.")
   };
   const input = exports_external.discriminatedUnion("type", [
     exports_external.object({
@@ -343009,6 +343034,25 @@ var makeGetRunContract = (ids) => {
   };
 };
 
+// node_modules/@qawolf/api-contracts/dist/v1/run/reattempt.js
+var makeReattemptRunContract = (ids) => {
+  const input = exports_external.object({
+    flowIds: exports_external.array(ids.flow).min(1).max(300).refine((flowIds) => new Set(flowIds).size === flowIds.length, "flowIds must be unique").optional().describe("The flows to reattempt. Every named flow must be eligible or the " + "whole request is rejected. Omit to reattempt every eligible flow."),
+    runId: ids.run
+  });
+  const output = resource({
+    reattemptedFlowIds: exports_external.array(ids.flow).describe("The flows a new attempt was requested for."),
+    runId: ids.run
+  }, { urlFieldDescription: "Absolute URL of the run page." });
+  return {
+    description: "Request new attempts for a run's flows, in the same run. " + "A flow is eligible once its result is failed or canceled and QA Wolf's " + "automatic retries have finished. " + "A fully investigated run no longer accepts reattempts. " + "Attempts run with the latest flow code. Poll run.get for results.",
+    input,
+    kind: "write",
+    name: "run.reattempt",
+    output
+  };
+};
+
 // node_modules/@qawolf/api-contracts/dist/v1/runner/evaluateSnippet.js
 var maxSnippetCodeLength = 64 * 1024;
 var makeEvaluateSnippetOnRunnerContract = () => {
@@ -343237,6 +343281,7 @@ var makeListTagsContract = (ids) => {
   const input = exports_external.object({
     includeFlowIds: exports_external.boolean().default(false).describe("Also return the ids of the flows that carry each tag."),
     names: exports_external.array(exports_external.string().trim().min(1)).min(1).max(100).optional().describe("Only list tags with these names. Matching is case sensitive. Omit to list all tags."),
+    workspaceId: ids.workspace.optional().describe("The workspace to list tags from. Required when authenticating with an organization or user API key."),
     ...makePaginationInputFields({ defaultLimit: 20, maxLimit: 100 })
   });
   const output = exports_external.object({
@@ -343284,7 +343329,8 @@ var makeContractsV1 = (ids) => {
     run: {
       create: makeCreateRunContract(resolvedIds),
       find: makeFindRunsContract(resolvedIds),
-      get: makeGetRunContract(resolvedIds)
+      get: makeGetRunContract(resolvedIds),
+      reattempt: makeReattemptRunContract(resolvedIds)
     },
     runner: {
       evaluateSnippet: makeEvaluateSnippetOnRunnerContract(),
@@ -343299,7 +343345,7 @@ var makeContractsV1 = (ids) => {
       terminate: makeTerminateRunnerContract()
     },
     tag: {
-      create: makeCreateTagContract(),
+      create: makeCreateTagContract(resolvedIds),
       list: makeListTagsContract(resolvedIds)
     }
   };
@@ -345820,7 +345866,7 @@ function startUpdateCheck(deps) {
 // package.json
 var package_default = {
   name: "@qawolf/cli",
-  version: "1.13.0",
+  version: "1.15.0",
   description: "Run and manage QA Wolf flows from the terminal, CI, or an AI agent",
   keywords: [
     "automation",
@@ -345880,7 +345926,7 @@ var package_default = {
     "@clack/prompts": "1.5.1",
     "@napi-rs/keyring": "1.3.0",
     "@oxc-node/core": "0.1.0",
-    "@qawolf/api-contracts": "0.27.0",
+    "@qawolf/api-contracts": "0.30.0",
     "@qawolf/emails": "1.1.1",
     "@qawolf/flow-targets": "1.0.0",
     "@qawolf/flows": "0.1.4",
@@ -346114,7 +346160,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 +346180,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 +352921,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 +352966,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 +355341,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 +355385,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 +355413,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 +358224,4 @@ createProgram({ signals }).parseAsync().catch(() => {
     process.exitCode = 1;
 }).finally(() => flushAndExit(typeof process.exitCode === "number" ? process.exitCode : 0));
 
-//# debugId=23E147B93341D71864756E2164756E21
+//# debugId=DD39A64EAC42A5D564756E2164756E21

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@qawolf/cli",
-  "version": "1.13.0",
+  "version": "1.15.0",
   "description": "Run and manage QA Wolf flows from the terminal, CI, or an AI agent",
   "keywords": [
     "automation",
@@ -60,7 +60,7 @@
     "@clack/prompts": "1.5.1",
     "@napi-rs/keyring": "1.3.0",
     "@oxc-node/core": "0.1.0",
-    "@qawolf/api-contracts": "0.27.0",
+    "@qawolf/api-contracts": "0.30.0",
     "@qawolf/emails": "1.1.1",
     "@qawolf/flow-targets": "1.0.0",
     "@qawolf/flows": "0.1.4",

package/skills/qawolf-cli/SKILL.md

@@ -118,7 +118,7 @@ current branch.
 | `qawolf environment create` | write | Create an environment on the caller's team and return it in the environment.get shape. |
 | `qawolf environment deleteVariable` | write | Remove one environment variable by name. Succeeds whether or not the variable existed. |
 | `qawolf environment find` | read | List the team's environments, newest first. |
-| `qawolf environment get` | read | Read a single environment's name, kind, health status, run concurrency limit, and termination state. |
+| `qawolf environment get` | read | Read a single environment's name, kind, standing run health, flow-code branch and reconciliation state, run concurrency limit, and termination state. If flowCodeBranch exists, use its syncStatus for Git reconciliation and read lastSyncedCommitHash only when syncStatus is reconciled. |
 | `qawolf environment getVariable` | read | Read the values of named environment variables in one call. Values are secrets. Names that do not exist go to missingNames and do not fail the call. |
 | `qawolf environment listVariableNames` | read | Use this to answer which QA Wolf environment variables are available to test code. Returns names only; values never leave the server. |
 | `qawolf environment setVariable` | write | Create or replace an environment variable. If the user asks to create one for "my email" without naming it, use DEFAULT_EMAIL. The value is never returned. |
@@ -141,6 +141,7 @@ current branch.
 | `qawolf run create` | write | Create a run for the selected flows and/or tags in an environment. |
 | `qawolf run find` | read | List an environment's recent runs, newest first. |
 | `qawolf run get` | read | Get a run's status, per-flow results, and links. |
+| `qawolf run reattempt` | write | Request new attempts for a run's flows, in the same run. A flow is eligible once its result is failed or canceled and QA Wolf's automatic retries have finished. A fully investigated run no longer accepts reattempts. Attempts run with the latest flow code. Poll run.get for results. |
 | `qawolf runner act` | write | Perform one raw action on a runner's screen: click, double_click, scroll, move, drag, keypress, navigate or type. Use - to read a whole action as JSON from stdin |
 | `qawolf runner events` | read | Print a runner's journal, one entry per line. QA Wolf writes console, recorder, run-events, run-logs, run-status |
 | `qawolf runner exec` | write | Evaluate a snippet against a runner's live page. Use - to read the snippet from stdin |