@qawolf/cli 1.14.0 → 1.15.0

package/dist/cli.js

@@ -342187,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,
@@ -342547,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." });
 
@@ -342556,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({
@@ -342601,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",
@@ -342643,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 {
@@ -342683,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 {
@@ -342809,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."),
@@ -342863,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({
@@ -343025,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 = () => {
@@ -343253,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({
@@ -343300,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(),
@@ -343315,7 +343345,7 @@ var makeContractsV1 = (ids) => {
       terminate: makeTerminateRunnerContract()
     },
     tag: {
-      create: makeCreateTagContract(),
+      create: makeCreateTagContract(resolvedIds),
       list: makeListTagsContract(resolvedIds)
     }
   };
@@ -345836,7 +345866,7 @@ function startUpdateCheck(deps) {
 // package.json
 var package_default = {
   name: "@qawolf/cli",
-  version: "1.14.0",
+  version: "1.15.0",
   description: "Run and manage QA Wolf flows from the terminal, CI, or an AI agent",
   keywords: [
     "automation",
@@ -345896,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",
@@ -358194,4 +358224,4 @@ createProgram({ signals }).parseAsync().catch(() => {
     process.exitCode = 1;
 }).finally(() => flushAndExit(typeof process.exitCode === "number" ? process.exitCode : 0));
 
-//# debugId=9D7349D928400D0E64756E2164756E21
+//# debugId=DD39A64EAC42A5D564756E2164756E21

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@qawolf/cli",
-  "version": "1.14.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 |