@qawolf/cli 1.36.0 → 1.37.0

package/dist/cli.js

@@ -16617,6 +16617,10 @@ var publicRunStatusValues = [
   "failed",
   "canceled"
 ];
+var publicRunSummaryStatusValues = [
+  ...publicRunStatusValues,
+  "superseded"
+];
 var makeRunSummaryFields = (ids) => ({
   completedAt: exports_iso.datetime().optional().describe("When the run finished executing. Absent while queued or running, and also absent for a terminal run that never completed execution (e.g. every flow was canceled or skipped)."),
   createdAt: exports_iso.datetime(),
@@ -16628,7 +16632,11 @@ var makeRunSummaryFields = (ids) => ({
   }).describe("The branch and commit under test. The fields are present when a deploy notification started the run, and absent for runs started another way, for example manually or with run.create."),
   needsReview: boolean2().optional().describe("True once every flow has finished its attempts and at least one failed flow still has no diagnosis, including one whose investigation carried over to a later run. `status` stays `running` until that failure is diagnosed, so a caller that is not waiting for a diagnosis can stop polling here and read the run's failed flows."),
   runId: ids.run,
-  status: _enum(publicRunStatusValues).describe("Whole-run status, and the value to gate a pipeline on. Terminal statuses are passed, failed, and canceled; poll until one is reached. `failed` means the run found a bug that is still open and serious enough to block — a lower-priority bug, or one since resolved, reads `passed`, and the per-flow diagnoses are still in `flows`. The run stays `running` while any investigation is unresolved, including one that carried over to a later run, so a terminal status always means a settled answer. `needsReview` tells such a run apart from one that is still executing.")
+  status: _enum(publicRunSummaryStatusValues).describe("Whole-run status, and the value to gate a pipeline on. Terminal statuses are passed, failed, canceled, and superseded; poll until one is reached. `failed` means the run found a bug that is still open and serious enough to block — a lower-priority bug, or one since resolved, reads `passed`, and the per-flow diagnoses are still in `flows`. The run stays `running` while any investigation is unresolved, including one that carried over to a later run, so a terminal status always means a settled answer, and `needsReview` tells such a run apart from one that is still executing. `superseded` means a newer run replaced this one before it finished: it is not a pass, this run will never change again, and the verdict belongs to the run in `supersededBy`."),
+  supersededBy: object({
+    runId: ids.run,
+    url: url().describe("Absolute URL of the replacement run's page.")
+  }).optional().describe("The run that replaced this one, present only when `status` is `superseded`. A newer deployment to the same branch and environment (and service, when the deployment named one) cancels the older run's unfinished flows and takes over. Deduplication ignores the commit, so the replacement may be testing a later commit than this run did. Only the direct replacement is named; that run can itself be superseded.")
 });
 
 // node_modules/@qawolf/api-contracts/dist/v1/deployment/didNotRunReason.js
@@ -16843,6 +16851,7 @@ var defaultIdSchemas = {
   issue: string2().min(1).describe("The id of the issue."),
   legacyTrigger: string2().min(1).describe("The id of the legacy trigger, from legacyTrigger.find."),
   run: string2().min(1).describe("The id of the run."),
+  runAttempt: string2().min(1).describe("The id of the run attempt."),
   trigger: string2().min(1).describe("The id of the trigger."),
   workspace: string2().min(1).describe("The id of the workspace.")
 };
@@ -19045,7 +19054,7 @@ var makeAddFlowsToIssueContract = (ids) => {
 // node_modules/@qawolf/api-contracts/dist/v1/issue/create.js
 var makeCreateIssueContract = (ids) => {
   const commonFields = {
-    description: string2().optional().describe("The issue description as plain text; each line becomes a paragraph. Markdown is not parsed."),
+    description: string2().optional().describe("The issue description in Markdown, which is stored as rich text. Text without Markdown is stored as written, one paragraph per line."),
     name: string2().trim().min(1).max(255),
     priority: issuePrioritySchema.optional().describe('Defaults to "unprioritized" for bug reports and coverage requests.'),
     workspaceId: ids.workspace.optional().describe("The workspace to create the issue in. Required when authenticating with an organization or user API key.")
@@ -19110,7 +19119,7 @@ var makeRemoveFlowsFromIssueContract = (ids) => {
 
 // node_modules/@qawolf/api-contracts/dist/v1/issue/update.js
 var makeUpdateIssueContract = (ids) => {
-  const descriptionSchema = string2().describe("The issue description as plain text; each line becomes a paragraph. Markdown is not parsed.");
+  const descriptionSchema = string2().describe("The issue description in Markdown, which is stored as rich text. Text without Markdown is stored as written, one paragraph per line.");
   const nameSchema = string2().trim().min(1).max(255);
   const input = object({
     description: descriptionSchema.optional(),
@@ -19294,9 +19303,11 @@ var makeFindRunsContract = (ids) => {
   });
   const output = object({
     nextCursor: nextCursorSchema,
-    runs: array(resource(makeRunSummaryFields(ids), {
-      urlFieldDescription: "Absolute URL of the run page."
-    })).describe("The environment's runs, newest first. Per-flow results are available via run.get.")
+    runs: array(resource({
+      ...makeRunSummaryFields(ids),
+      failedAttemptCount: number2().int().nonnegative().optional(),
+      hasFailedAttempts: boolean2().optional()
+    }, { urlFieldDescription: "Absolute URL of the run page." })).describe("The environment's runs, newest first. Per-flow results are available via run.get.")
   });
   return {
     annotations: {
@@ -19304,7 +19315,7 @@ var makeFindRunsContract = (ids) => {
       openWorldHint: false,
       readOnlyHint: true
     },
-    description: "List an environment's recent runs, newest first.",
+    description: "List an environment's recent runs, newest first, including failed-attempt discovery metadata.",
     input,
     kind: "read",
     name: "run.find",
@@ -19328,6 +19339,7 @@ var makeGetRunContract = (ids) => {
   const automatedAttempt = discriminatedUnion("status", [
     object({
       ...artifactUrls,
+      attemptId: ids.runAttempt.optional(),
       completedAt: exports_iso.datetime(),
       kind: automatedKind,
       startedAt: exports_iso.datetime(),
@@ -19335,12 +19347,14 @@ var makeGetRunContract = (ids) => {
     }),
     object({
       ...artifactUrls,
+      attemptId: ids.runAttempt.optional(),
       completedAt: exports_iso.datetime(),
       kind: automatedKind,
       startedAt: exports_iso.datetime().optional().describe("Absent when the attempt failed before it could start."),
       status: literal("failed")
     }),
     object({
+      attemptId: ids.runAttempt.optional(),
       completedAt: exports_iso.datetime().optional(),
       kind: automatedKind,
       startedAt: exports_iso.datetime().optional(),
@@ -19348,6 +19362,7 @@ var makeGetRunContract = (ids) => {
     })
   ]);
   const manualAttempt = object({
+    attemptId: ids.runAttempt.optional(),
     completedAt: exports_iso.datetime(),
     kind: literal("manual").describe("The attempt ran by hand in the Wolf Browser."),
     startedAt: exports_iso.datetime(),
@@ -19396,6 +19411,83 @@ var makeGetRunContract = (ids) => {
   };
 };
 
+// node_modules/@qawolf/api-contracts/dist/v1/run/getAttemptArtifacts.js
+var makeGetRunAttemptArtifactsContract = (ids) => {
+  const input = object({ attemptId: ids.runAttempt });
+  const attemptStatus = _enum([
+    "passed",
+    "failed",
+    "canceled",
+    "aborted",
+    "skipped"
+  ]);
+  const attemptNeighbor = object({
+    attemptId: ids.runAttempt,
+    status: attemptStatus
+  });
+  const response = object({
+    flowId: ids.flow,
+    flowStatus: _enum(publicRunStatusValues),
+    retryContext: object({
+      currentOrdinal: number2().int().min(1),
+      next: attemptNeighbor.optional(),
+      previous: attemptNeighbor.optional(),
+      total: number2().int().min(1)
+    }),
+    runId: ids.run,
+    runStatus: _enum(publicRunSummaryStatusValues)
+  });
+  const attempt = object({
+    attemptId: ids.runAttempt,
+    completedAt: exports_iso.datetime().optional(),
+    createdAt: exports_iso.datetime(),
+    error: string2().optional(),
+    startedAt: exports_iso.datetime().optional()
+  });
+  const output = discriminatedUnion("artifactStatus", [
+    response.extend({
+      artifacts: object({
+        logsUrl: url().optional(),
+        traceUrl: url().optional(),
+        videoUrl: url().optional()
+      }),
+      artifactStatus: literal("signed"),
+      attempt: attempt.extend({
+        kind: literal("automated"),
+        status: attemptStatus
+      })
+    }),
+    response.extend({
+      artifacts: object({}).strict(),
+      artifactStatus: literal("signing-failed"),
+      attempt: attempt.extend({
+        kind: literal("automated"),
+        status: attemptStatus
+      })
+    }),
+    response.extend({
+      artifacts: object({}).strict(),
+      artifactStatus: literal("not-captured"),
+      attempt: attempt.extend({
+        kind: literal("manual"),
+        status: literal("passed")
+      })
+    })
+  ]);
+  return {
+    annotations: {
+      destructiveHint: false,
+      openWorldHint: false,
+      readOnlyHint: true
+    },
+    description: "Get metadata and signed artifact URLs for one finished run attempt.",
+    input,
+    kind: "read",
+    name: "run.getAttemptArtifacts",
+    output
+  };
+};
+
 // node_modules/@qawolf/api-contracts/dist/v1/run/reattempt.js
 var makeReattemptRunContract = (ids) => {
   const input = object({
@@ -19956,7 +20048,11 @@ var makeListTagsContract = (ids) => {
 
 // node_modules/@qawolf/api-contracts/dist/v1/index.js
 var makeContractsV1 = (ids) => {
-  const resolvedIds = { ...defaultIdSchemas, ...ids };
+  const resolvedIds = {
+    ...defaultIdSchemas,
+    ...ids,
+    runAttempt: ids.runAttempt ?? defaultIdSchemas.runAttempt
+  };
   return {
     agent: {
       get: makeAgentGetContract(resolvedIds),
@@ -20007,6 +20103,7 @@ var makeContractsV1 = (ids) => {
       diagnose: makeDiagnoseRunContract(resolvedIds),
       find: makeFindRunsContract(resolvedIds),
       get: makeGetRunContract(resolvedIds),
+      getAttemptArtifacts: makeGetRunAttemptArtifactsContract(resolvedIds),
       reattempt: makeReattemptRunContract(resolvedIds),
       stop: makeStopRunContract(resolvedIds)
     },
@@ -22524,7 +22621,7 @@ function startUpdateCheck(deps) {
 // package.json
 var package_default = {
   name: "@qawolf/cli",
-  version: "1.36.0",
+  version: "1.37.0",
   description: "Run and manage QA Wolf flows from the terminal, CI, or an AI agent",
   keywords: [
     "automation",
@@ -22595,7 +22692,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.73.0",
+    "@qawolf/api-contracts": "0.74.0",
     "@qawolf/emails": "1.1.1",
     "@qawolf/flow-targets": "1.0.0",
     "@qawolf/flows": "0.1.4",
@@ -38846,4 +38943,4 @@ createProgram({ signals }).parseAsync().catch(() => {
     process.exitCode = 1;
 }).finally(() => exitWhenIdle(typeof process.exitCode === "number" ? process.exitCode : 0));
 
-//# debugId=9A39ADF2531708B264756E2164756E21
+//# debugId=0EBF9D8CD8CB2E9E64756E2164756E21

package/dist/runner-sdk.js

@@ -6979,6 +6979,10 @@ var publicRunStatusValues = [
   "failed",
   "canceled"
 ];
+var publicRunSummaryStatusValues = [
+  ...publicRunStatusValues,
+  "superseded"
+];
 var makeRunSummaryFields = (ids) => ({
   completedAt: exports_iso.datetime().optional().describe("When the run finished executing. Absent while queued or running, and also absent for a terminal run that never completed execution (e.g. every flow was canceled or skipped)."),
   createdAt: exports_iso.datetime(),
@@ -6990,7 +6994,11 @@ var makeRunSummaryFields = (ids) => ({
   }).describe("The branch and commit under test. The fields are present when a deploy notification started the run, and absent for runs started another way, for example manually or with run.create."),
   needsReview: boolean2().optional().describe("True once every flow has finished its attempts and at least one failed flow still has no diagnosis, including one whose investigation carried over to a later run. `status` stays `running` until that failure is diagnosed, so a caller that is not waiting for a diagnosis can stop polling here and read the run's failed flows."),
   runId: ids.run,
-  status: _enum(publicRunStatusValues).describe("Whole-run status, and the value to gate a pipeline on. Terminal statuses are passed, failed, and canceled; poll until one is reached. `failed` means the run found a bug that is still open and serious enough to block — a lower-priority bug, or one since resolved, reads `passed`, and the per-flow diagnoses are still in `flows`. The run stays `running` while any investigation is unresolved, including one that carried over to a later run, so a terminal status always means a settled answer. `needsReview` tells such a run apart from one that is still executing.")
+  status: _enum(publicRunSummaryStatusValues).describe("Whole-run status, and the value to gate a pipeline on. Terminal statuses are passed, failed, canceled, and superseded; poll until one is reached. `failed` means the run found a bug that is still open and serious enough to block — a lower-priority bug, or one since resolved, reads `passed`, and the per-flow diagnoses are still in `flows`. The run stays `running` while any investigation is unresolved, including one that carried over to a later run, so a terminal status always means a settled answer, and `needsReview` tells such a run apart from one that is still executing. `superseded` means a newer run replaced this one before it finished: it is not a pass, this run will never change again, and the verdict belongs to the run in `supersededBy`."),
+  supersededBy: object({
+    runId: ids.run,
+    url: url().describe("Absolute URL of the replacement run's page.")
+  }).optional().describe("The run that replaced this one, present only when `status` is `superseded`. A newer deployment to the same branch and environment (and service, when the deployment named one) cancels the older run's unfinished flows and takes over. Deduplication ignores the commit, so the replacement may be testing a later commit than this run did. Only the direct replacement is named; that run can itself be superseded.")
 });
 
 // node_modules/@qawolf/api-contracts/dist/v1/deployment/didNotRunReason.js
@@ -7205,6 +7213,7 @@ var defaultIdSchemas = {
   issue: string2().min(1).describe("The id of the issue."),
   legacyTrigger: string2().min(1).describe("The id of the legacy trigger, from legacyTrigger.find."),
   run: string2().min(1).describe("The id of the run."),
+  runAttempt: string2().min(1).describe("The id of the run attempt."),
   trigger: string2().min(1).describe("The id of the trigger."),
   workspace: string2().min(1).describe("The id of the workspace.")
 };
@@ -9414,7 +9423,7 @@ var makeAddFlowsToIssueContract = (ids) => {
 // node_modules/@qawolf/api-contracts/dist/v1/issue/create.js
 var makeCreateIssueContract = (ids) => {
   const commonFields = {
-    description: string2().optional().describe("The issue description as plain text; each line becomes a paragraph. Markdown is not parsed."),
+    description: string2().optional().describe("The issue description in Markdown, which is stored as rich text. Text without Markdown is stored as written, one paragraph per line."),
     name: string2().trim().min(1).max(255),
     priority: issuePrioritySchema.optional().describe('Defaults to "unprioritized" for bug reports and coverage requests.'),
     workspaceId: ids.workspace.optional().describe("The workspace to create the issue in. Required when authenticating with an organization or user API key.")
@@ -9479,7 +9488,7 @@ var makeRemoveFlowsFromIssueContract = (ids) => {
 
 // node_modules/@qawolf/api-contracts/dist/v1/issue/update.js
 var makeUpdateIssueContract = (ids) => {
-  const descriptionSchema = string2().describe("The issue description as plain text; each line becomes a paragraph. Markdown is not parsed.");
+  const descriptionSchema = string2().describe("The issue description in Markdown, which is stored as rich text. Text without Markdown is stored as written, one paragraph per line.");
   const nameSchema = string2().trim().min(1).max(255);
   const input = object({
     description: descriptionSchema.optional(),
@@ -9663,9 +9672,11 @@ var makeFindRunsContract = (ids) => {
   });
   const output = object({
     nextCursor: nextCursorSchema,
-    runs: array(resource(makeRunSummaryFields(ids), {
-      urlFieldDescription: "Absolute URL of the run page."
-    })).describe("The environment's runs, newest first. Per-flow results are available via run.get.")
+    runs: array(resource({
+      ...makeRunSummaryFields(ids),
+      failedAttemptCount: number2().int().nonnegative().optional(),
+      hasFailedAttempts: boolean2().optional()
+    }, { urlFieldDescription: "Absolute URL of the run page." })).describe("The environment's runs, newest first. Per-flow results are available via run.get.")
   });
   return {
     annotations: {
@@ -9673,7 +9684,7 @@ var makeFindRunsContract = (ids) => {
       openWorldHint: false,
       readOnlyHint: true
     },
-    description: "List an environment's recent runs, newest first.",
+    description: "List an environment's recent runs, newest first, including failed-attempt discovery metadata.",
     input,
     kind: "read",
     name: "run.find",
@@ -9697,6 +9708,7 @@ var makeGetRunContract = (ids) => {
   const automatedAttempt = discriminatedUnion("status", [
     object({
       ...artifactUrls,
+      attemptId: ids.runAttempt.optional(),
       completedAt: exports_iso.datetime(),
       kind: automatedKind,
       startedAt: exports_iso.datetime(),
@@ -9704,12 +9716,14 @@ var makeGetRunContract = (ids) => {
     }),
     object({
       ...artifactUrls,
+      attemptId: ids.runAttempt.optional(),
       completedAt: exports_iso.datetime(),
       kind: automatedKind,
       startedAt: exports_iso.datetime().optional().describe("Absent when the attempt failed before it could start."),
       status: literal("failed")
     }),
     object({
+      attemptId: ids.runAttempt.optional(),
       completedAt: exports_iso.datetime().optional(),
       kind: automatedKind,
       startedAt: exports_iso.datetime().optional(),
@@ -9717,6 +9731,7 @@ var makeGetRunContract = (ids) => {
     })
   ]);
   const manualAttempt = object({
+    attemptId: ids.runAttempt.optional(),
     completedAt: exports_iso.datetime(),
     kind: literal("manual").describe("The attempt ran by hand in the Wolf Browser."),
     startedAt: exports_iso.datetime(),
@@ -9765,6 +9780,83 @@ var makeGetRunContract = (ids) => {
   };
 };
 
+// node_modules/@qawolf/api-contracts/dist/v1/run/getAttemptArtifacts.js
+var makeGetRunAttemptArtifactsContract = (ids) => {
+  const input = object({ attemptId: ids.runAttempt });
+  const attemptStatus = _enum([
+    "passed",
+    "failed",
+    "canceled",
+    "aborted",
+    "skipped"
+  ]);
+  const attemptNeighbor = object({
+    attemptId: ids.runAttempt,
+    status: attemptStatus
+  });
+  const response = object({
+    flowId: ids.flow,
+    flowStatus: _enum(publicRunStatusValues),
+    retryContext: object({
+      currentOrdinal: number2().int().min(1),
+      next: attemptNeighbor.optional(),
+      previous: attemptNeighbor.optional(),
+      total: number2().int().min(1)
+    }),
+    runId: ids.run,
+    runStatus: _enum(publicRunSummaryStatusValues)
+  });
+  const attempt = object({
+    attemptId: ids.runAttempt,
+    completedAt: exports_iso.datetime().optional(),
+    createdAt: exports_iso.datetime(),
+    error: string2().optional(),
+    startedAt: exports_iso.datetime().optional()
+  });
+  const output = discriminatedUnion("artifactStatus", [
+    response.extend({
+      artifacts: object({
+        logsUrl: url().optional(),
+        traceUrl: url().optional(),
+        videoUrl: url().optional()
+      }),
+      artifactStatus: literal("signed"),
+      attempt: attempt.extend({
+        kind: literal("automated"),
+        status: attemptStatus
+      })
+    }),
+    response.extend({
+      artifacts: object({}).strict(),
+      artifactStatus: literal("signing-failed"),
+      attempt: attempt.extend({
+        kind: literal("automated"),
+        status: attemptStatus
+      })
+    }),
+    response.extend({
+      artifacts: object({}).strict(),
+      artifactStatus: literal("not-captured"),
+      attempt: attempt.extend({
+        kind: literal("manual"),
+        status: literal("passed")
+      })
+    })
+  ]);
+  return {
+    annotations: {
+      destructiveHint: false,
+      openWorldHint: false,
+      readOnlyHint: true
+    },
+    description: "Get metadata and signed artifact URLs for one finished run attempt.",
+    input,
+    kind: "read",
+    name: "run.getAttemptArtifacts",
+    output
+  };
+};
+
 // node_modules/@qawolf/api-contracts/dist/v1/run/reattempt.js
 var makeReattemptRunContract = (ids) => {
   const input = object({
@@ -10325,7 +10417,11 @@ var makeListTagsContract = (ids) => {
 
 // node_modules/@qawolf/api-contracts/dist/v1/index.js
 var makeContractsV1 = (ids) => {
-  const resolvedIds = { ...defaultIdSchemas, ...ids };
+  const resolvedIds = {
+    ...defaultIdSchemas,
+    ...ids,
+    runAttempt: ids.runAttempt ?? defaultIdSchemas.runAttempt
+  };
   return {
     agent: {
       get: makeAgentGetContract(resolvedIds),
@@ -10376,6 +10472,7 @@ var makeContractsV1 = (ids) => {
       diagnose: makeDiagnoseRunContract(resolvedIds),
       find: makeFindRunsContract(resolvedIds),
       get: makeGetRunContract(resolvedIds),
+      getAttemptArtifacts: makeGetRunAttemptArtifactsContract(resolvedIds),
       reattempt: makeReattemptRunContract(resolvedIds),
       stop: makeStopRunContract(resolvedIds)
     },
@@ -15011,4 +15108,4 @@ export {
   createRunnerSdk
 };
 
-//# debugId=CBFC365D381BD6E864756E2164756E21
+//# debugId=3EFB50CF5F60CF8264756E2164756E21

package/package.json

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

package/skills/qawolf-cli/SKILL.md

@@ -178,8 +178,9 @@ that `url`; never guess a route and never send a repository link in its place.
 | `qawolf legacyTrigger resume` | write | Resume one legacy trigger, the older per-environment kind; use trigger.resume for a current one. Its copies in pull request environments resume too, and a scheduled one jumps to the next upcoming slot even if it was not paused. For migration only; it goes when legacy triggers go. |
 | `qawolf run create` | write | Create a run for the selected flows and/or tags in an environment. |
 | `qawolf run diagnose` | write | Diagnose failed flows in a run as reproductions of a bug or maintenance report owned by the caller's team. The issue's type selects the diagnosis. Each flow must have failed in the run. A flow that is already diagnosed moves to this issue. The diagnosis appears on the run, and the reproduction appears under the issue's reproductions. Coverage requests cannot be diagnosed; use issue.addFlows to cover flows instead. |
-| `qawolf run find` | read | List an environment's recent runs, newest first. |
+| `qawolf run find` | read | List an environment's recent runs, newest first, including failed-attempt discovery metadata. |
 | `qawolf run get` | read | Get a run's status, per-flow results, links, and how many of its bugs are blocking. |
+| `qawolf run getAttemptArtifacts` | read | Get metadata and signed artifact URLs for one finished run attempt. |
 | `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 run stop` | write | Stop a run, including its queued flows and automatic retries. Stopping is asynchronous and can update run-status messages and commit statuses in connected integrations. Repeated requests are safe, and finished runs keep their results. A run that is still being created returns not found; retry once run.get returns the run. If run.get returns a different runId, use that ID. Poll run.get for results. |
 | `qawolf runner act` | write | Perform one raw action on a runner's screen. A browser runner takes click, double_click, scroll, move, drag, keypress, navigate and type; a mobile runner takes tap, swipe, fill and type. A browser runner answers mobile actions with action-not-supported-on-browser; a mobile runner answers the other browser actions with action-not-supported-on-mobile. Use - to read a whole action as JSON from stdin |

package/skills/qawolf-cli/references/run-results.md

@@ -59,8 +59,10 @@ A run that has been requested but not yet created answers exit `8` too, and
 says it is still being created. That one clears on its own, so read the message
 rather than the code before deciding whether to poll.
 
-Poll `status` until it reaches `passed`, `failed` or `canceled`. The other
-values mean the run is still going.
+Poll `status` until it reaches `passed`, `failed`, `canceled` or `superseded`.
+When it is `superseded`, this run will never change again. Read the replacement
+run in `supersededBy.runId` for the verdict. `queued` and `running` mean the run
+is still going.
 
 ## Fields a passing run does not show you
 
@@ -185,13 +187,17 @@ Every documented field of the `run.get` response. `[]` marks an array, so
 - `git.commitUrl` — Link to the commit on the code host.
 - `needsReview` — True once every flow has finished its attempts and at least one failed flow still has no diagnosis, including one whose investigation carried over to a later run. `status` stays `running` until that failure is diagnosed, so a caller that is not waiting for a diagnosis can stop polling here and read the run's failed flows.
 - `runId` — The run this response describes. Treat it as canonical: it can differ from the id you asked for. A deploy notification returns a run id before the run exists, and if a second notification for the same commit is folded into an earlier run, that id resolves to the earlier run instead.
-- `status` — One of: queued, running, passed, failed, canceled
+- `status` — One of: queued, running, passed, failed, canceled, superseded
+- `supersededBy` — The run that replaced this one, present only when `status` is `superseded`. A newer deployment to the same branch and environment (and service, when the deployment named one) cancels the older run's unfinished flows and takes over. Deduplication ignores the commit, so the replacement may be testing a later commit than this run did. Only the direct replacement is named; that run can itself be superseded.
+- `supersededBy.runId` — The id of the run.
+- `supersededBy.url` — Absolute URL of the replacement run's page.
 - `blockingBugCount` — How many bugs this run found are blocking: still open, and priority urgent, high, or unprioritized — unprioritized counts because nobody has ruled it out yet. This is what `failed` is derived from, so it explains a failure rather than adding a second verdict: gate on `status`, then read this to say how many bugs are holding the build. It counts a bug filed against a later run by an investigation that carried over from this one, and it drops a bug once that bug is resolved.
 - `flows` — The run's flows, ordered alphabetically by name. Only the flows matching flowStatuses when the request set it.
 - `flows[].attempts` — The flow's finished execution attempts, oldest first, including manual Wolf Browser attempts. Present once at least one attempt has finished, so a flow that passed after retries also lists its failed attempts. Artifact URLs appear only on automated attempts that reached a verdict, stay valid for at least a day (call run.get again for fresh ones), and can return 404 when the attempt did not produce that artifact.
 - `flows[].attempts[].logsUrl` — Signed URL for the attempt's execution logs.
 - `flows[].attempts[].traceUrl` — Signed URL for the attempt's Playwright trace (a trace.zip; open it with `npx playwright show-trace`).
 - `flows[].attempts[].videoUrl` — Signed URL for the attempt's screen recording.
+- `flows[].attempts[].attemptId` — The id of the run attempt.
 - `flows[].attempts[].kind` — One of: automated, manual
 - `flows[].attempts[].startedAt` — Absent when the attempt failed before it could start.
 - `flows[].attempts[].status` — One of: passed, failed, canceled