@qawolf/cli 2.0.0 → 2.2.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -7104,6 +7104,7 @@ var agentSessionStatusSchema = _enum(agentSessionStatuses).describe('Where the w
7104
7104
  var agentReplySchema = object({
7105
7105
  askedAt: exports_iso.datetime().describe("When the AI wrote this, as an ISO 8601 timestamp."),
7106
7106
  choices: array(string2()).optional().describe("The answers the AI offered, when the reply is a question with a fixed set of them. Answer by sending one of these back through agent.send."),
7107
+ id: string2().min(1).describe("Stays the same while the AI is still writing this reply, so a reply that a later check returns again, longer, replaces the one with this id."),
7107
7108
  text: string2().describe("What the AI said.")
7108
7109
  });
7109
7110
 
@@ -7234,12 +7235,13 @@ var uploadedFileNameSchema = teamStoragePathSchema.refine((fileName) => teamStor
7234
7235
  // node_modules/@qawolf/api-contracts/dist/v1/file/requestDownload.js
7235
7236
  var makeRequestFileDownloadContract = (ids) => {
7236
7237
  const input = object({
7237
- filePath: teamStoragePathSchema.describe("The file's path in team storage, as file.requestUpload answered with."),
7238
+ filePath: teamStoragePathSchema.describe("The file's path in team storage, as the filePath file.requestUpload answered with."),
7238
7239
  workspaceId: ids.workspace.optional().describe("The workspace the file belongs to. Required when authenticating with an organization or user API key.")
7239
7240
  });
7240
7241
  const output = object({
7241
7242
  expiresAt: exports_iso.datetime().describe("When readUrl stops working. Request another one after it."),
7242
- path: string2().describe("The file's path in team storage."),
7243
+ filePath: string2().describe("The file's path in team storage."),
7244
+ path: string2().describe("Deprecated: the same value as filePath. Read filePath instead."),
7243
7245
  readUrl: string2().describe('Fetch the file\'s bytes from here, for example `curl -o journeys.csv "<readUrl>"`. Write it to a file and read that file, rather than printing the contents, so a large file costs one line of output instead of all of it.')
7244
7246
  });
7245
7247
  return {
@@ -7270,7 +7272,8 @@ var makeRequestFileUploadContract = (ids) => {
7270
7272
  const output = object({
7271
7273
  contentType: string2().describe("Send this as the PUT's `Content-Type` header, exactly. The URL is signed for it and refuses any other value."),
7272
7274
  expiresAt: exports_iso.datetime().describe("When uploadUrl stops working. Request another one after it."),
7273
- path: string2().describe("Where the file lives in team storage. Send this to agent.send as a filePath, and the AI fetches it from there."),
7275
+ filePath: string2().describe("Where the file lives in team storage. Send it as filePath to file.requestDownload, or in agent.send's filePaths so the AI fetches it from there."),
7276
+ path: string2().describe("Deprecated: the same value as filePath. Read filePath instead."),
7274
7277
  uploadUrl: string2().describe(`Send the file's bytes here with a single HTTP PUT carrying the returned contentType, for example \`curl -H 'Content-Type: application/octet-stream' --upload-file "journeys.csv" "<uploadUrl>"\`. Upload the bytes from the shell rather than through this API, so a large file never has to be written out as text.`)
7275
7278
  });
7276
7279
  return {
@@ -7284,7 +7287,7 @@ var makeRequestFileUploadContract = (ids) => {
7284
7287
  openWorldHint: false,
7285
7288
  readOnlyHint: false
7286
7289
  },
7287
- description: "Get a URL to put a file into team storage: a spreadsheet of journeys, anything too large to paste. PUT with the returned contentType, then name the path in filePaths.",
7290
+ description: "Get a URL to put a file into team storage: a spreadsheet of journeys, anything too large to paste. PUT with the returned contentType, then name the returned filePath in filePaths.",
7288
7291
  input,
7289
7292
  kind: "write",
7290
7293
  name: "file.requestUpload",
@@ -7376,7 +7379,7 @@ var makeCreateRunContract = (ids) => {
7376
7379
  aiTaskId: ids.aiTask.optional().describe("The AI task whose conversation should receive run status updates."),
7377
7380
  chatSessionId: ids.chatSession.optional().describe("The chat session whose transcript should receive run status updates."),
7378
7381
  environmentId: ids.environmentRef,
7379
- environmentVariables: record(string2(), string2()).optional(),
7382
+ environmentVariables: record(string2(), string2()).optional().describe("Environment variables for this run only, over the environment's own."),
7380
7383
  ignoreRules: boolean2().describe("Ignore this team's sequencing rules for this run. By default they are honoured: the flows your selection depends on are added to the run, and flows run in the order the rules require. Set this to run exactly what you selected, in any order.").default(false),
7381
7384
  pullRequestNumber: number2().int().positive().describe("The number of the pull request to associate with the run.").optional(),
7382
7385
  repository: string2().min(1).describe('The owner/name of the repository, e.g. "acme/web".').optional(),
@@ -7611,7 +7614,8 @@ var runnerNameSchema = _enum([
7611
7614
  "playwright",
7612
7615
  "android",
7613
7616
  "ios",
7614
- "windows"
7617
+ "windows",
7618
+ "mac"
7615
7619
  ]);
7616
7620
  var runnerWorkspaceRequirement = "Read it from whoami.";
7617
7621
  var runnerWorkspaceIdDescription = `The workspace the runner belongs to. ${runnerWorkspaceRequirement}`;
@@ -8311,14 +8315,6 @@ var makeTriggerScheduleFields = (ids) => ({
8311
8315
  timeOfDay: string2().regex(/^([01]\d|2[0-3]):[0-5]\d$/).optional().describe('The wall clock time a daily or weekly schedule fires, as "HH:mm". Required when cadence is daily or weekly.'),
8312
8316
  timezoneId: string2().min(1).refine(isTimezone, "Expected an IANA timezone, such as America/New_York.").optional().describe("The IANA timezone the schedule is read in, such as America/New_York. Required for every cadence: it sets the day boundaries daysOfWeek is read against, and the wall clock timeOfDay is read against.")
8313
8317
  });
8314
- var makeTriggerDeploymentFields = (ids) => ({
8315
- action: makeTriggerActionSchema(ids),
8316
- branchPattern: string2().min(1).optional().describe("Only fire for deployments of a branch matching this pattern."),
8317
- deployTargetPattern: string2().min(1).optional().describe("Only fire for deployments whose deploy target matches this pattern. A deploy target is the URL the deploy reported, which many deployments do not carry."),
8318
- environmentIds: array(ids.environment).default([]).describe("Only fire for deployments to these environments. Mutually exclusive with environmentPattern."),
8319
- environmentPattern: string2().min(1).optional().describe("Only fire for deployments to environments matching this pattern. Mutually exclusive with environmentIds."),
8320
- servicePattern: string2().min(1).optional().describe("Only fire for deployments whose service matches this pattern. A deployment that names no service never matches it.")
8321
- });
8322
8318
 
8323
8319
  // node_modules/@qawolf/api-contracts/dist/v1/trigger/configurationRules.js
8324
8320
  var checkAction = (action, ctx) => {
@@ -8420,6 +8416,17 @@ var checkDeployment = (value, ctx) => {
8420
8416
  };
8421
8417
  var checkTriggerConfiguration = (value, ctx) => value.kind === "schedule" ? checkSchedule(value, ctx) : checkDeployment(value, ctx);
8422
8418
 
8419
+ // node_modules/@qawolf/api-contracts/dist/v1/trigger/deploymentFields.js
8420
+ var makeTriggerDeploymentFields = (ids) => ({
8421
+ action: makeTriggerActionSchema(ids),
8422
+ branchPattern: string2().min(1).optional().describe("Only fire for deployments of a branch matching this pattern."),
8423
+ deployTargetPattern: string2().min(1).optional().describe("Only fire for deployments whose deploy target matches this pattern. A deploy target is the URL the deploy reported, which many deployments do not carry."),
8424
+ environmentIds: array(ids.environment).default([]).describe("Only fire for deployments to these environments. Mutually exclusive with environmentPattern."),
8425
+ environmentPattern: string2().min(1).optional().describe("Only fire for deployments to environments matching this pattern. Mutually exclusive with environmentIds."),
8426
+ repositoryPattern: string2().min(1).optional().describe('Only fire for deployments from a repository whose "owner/name" matches this pattern, such as acme/web or acme/*. A deployment that names no repository never matches it.'),
8427
+ servicePattern: string2().min(1).optional().describe("Only fire for deployments whose service matches this pattern. A deployment that names no service never matches it.")
8428
+ });
8429
+
8423
8430
  // node_modules/@qawolf/api-contracts/dist/v1/trigger/resource.js
8424
8431
  var makeTriggerConfigurationSchema = (ids) => discriminatedUnion("kind", [
8425
8432
  object({
@@ -8765,13 +8772,14 @@ var makeGetAttemptContract = (ids) => {
8765
8772
  error: string2().optional(),
8766
8773
  startedAt: exports_iso.datetime().optional()
8767
8774
  });
8775
+ const artifactUrls = {
8776
+ logsUrl: url().optional(),
8777
+ traceUrl: url().optional(),
8778
+ videoUrl: url().optional()
8779
+ };
8768
8780
  const output = discriminatedUnion("artifactStatus", [
8769
8781
  response.extend({
8770
- artifacts: object({
8771
- logsUrl: url().optional(),
8772
- traceUrl: url().optional(),
8773
- videoUrl: url().optional()
8774
- }),
8782
+ artifacts: object(artifactUrls),
8775
8783
  artifactStatus: literal("signed"),
8776
8784
  attempt: attempt.extend({
8777
8785
  kind: literal("automated"),
@@ -8792,7 +8800,8 @@ var makeGetAttemptContract = (ids) => {
8792
8800
  attempt: attempt.extend({
8793
8801
  kind: literal("manual"),
8794
8802
  status: literal("passed")
8795
- })
8803
+ }),
8804
+ evidence: object(artifactUrls).optional().describe("Signed links to the logs, trace, and video that the Wolf Browser run kept. Absent when it kept none. The artifacts field stays empty for a manual attempt.")
8796
8805
  })
8797
8806
  ]);
8798
8807
  return {
@@ -8900,7 +8909,7 @@ var makeDeploymentResourceSchema = (ids) => resource({
8900
8909
  environmentName: string2().optional().describe("The environment's name. Absent when the environment has since been deleted."),
8901
8910
  id: ids.deployment,
8902
8911
  provider: _enum(["github", "gitlab", "api"]).optional().describe("How QA Wolf received the deployment: a GitHub webhook, a GitLab webhook, or the deployment.reportStatus API."),
8903
- repository: string2().optional().describe('The repository the deployment came from, as "owner/name". Absent when neither the code host nor the deployment report named one.'),
8912
+ repository: string2().optional().describe(`The repository the deployment came from, as "owner/name". Absent when neither the code host nor the deployment report named one. A trigger's repositoryPattern matches against it.`),
8904
8913
  service: string2().optional().describe("Which application was deployed, as the deployer named it. Absent when the deployer named none."),
8905
8914
  status: _enum(["pending", "success", "failure", "inactive"]).optional().describe("The deployment's lifecycle status, in the vocabulary deployment.reportStatus accepts. Absent when no status was ever reported.")
8906
8915
  }, {
@@ -8937,7 +8946,7 @@ var makeFindDeploymentsContract = (ids) => {
8937
8946
  };
8938
8947
 
8939
8948
  // node_modules/@qawolf/api-contracts/dist/v1/deployment/listTriggerEvaluations.js
8940
- var conditionKindSchema = _enum(["environment", "deployTarget", "branch", "service"]).describe("What the condition checks on the deployment: the environment it reported into, the deploy target it serves, the git branch of the deployed commit, or the service it deployed.");
8949
+ var conditionKindSchema = _enum(["environment", "deployTarget", "branch", "service", "repository"]).describe("What the condition checks on the deployment: the environment it reported into, the deploy target it serves, the git branch of the deployed commit, the service it deployed, or the repository it came from.");
8941
8950
  var conditionVerdictSchema = discriminatedUnion("outcome", [
8942
8951
  object({
8943
8952
  kind: conditionKindSchema,
@@ -9023,7 +9032,7 @@ var deploymentReportMetadata = strictObject({
9023
9032
  commitUrl: httpUrl().max(2048).describe("A link to the deployed commit in your code host. Send this when QA Wolf cannot resolve the commit itself, for example when the QA Wolf GitHub App is not installed.").optional(),
9024
9033
  pullRequestNumber: number2().int().positive().describe("The number of the pull request the deployment belongs to. Requires repository.").optional(),
9025
9034
  ref: string2().trim().min(1).max(255).describe("The branch or ref that was deployed.").optional(),
9026
- repository: string2().trim().min(1).max(255).describe('The owner/name of the repository, e.g. "acme/web".').optional()
9035
+ repository: string2().trim().min(1).max(255).describe(`The owner/name of the repository, e.g. "acme/web". A deployment trigger's repositoryPattern matches against it.`).optional()
9027
9036
  }).refine((value) => value.pullRequestNumber === undefined || value.repository !== undefined, {
9028
9037
  message: "repository is required when pullRequestNumber is provided.",
9029
9038
  path: ["pullRequestNumber"]
@@ -9316,7 +9325,7 @@ var makeEnvironmentResourceSchema = (ids) => resource({
9316
9325
  kind: _enum(["static", "preview"]).describe("Whether the environment is static or a preview."),
9317
9326
  name: string2(),
9318
9327
  runConcurrencyLimit: string2().describe('Maximum number of concurrent runs: a whole number, "unlimited", or a concurrency expression.'),
9319
- status: _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)."),
9328
+ status: _enum(["blocked", "needs-investigation", "ready", "running"]).describe("Release readiness from the environment's open bugs and runs, not its Git reconciliation state: blocked (an open urgent, high, or unprioritized bug reproduces here), needs-investigation (failures await triage), running (flows are executing), or ready (none of these, the greenlit state). It only reports. It never stops runs, validation, or publishing."),
9320
9329
  terminatedAt: exports_iso.datetime().optional().describe("When the environment was terminated, if it has been."),
9321
9330
  variablesUrl: url().optional().describe("Absolute URL of the page where a person saves this environment's variables. Give it to the user when a login or key is missing, rather than collecting the value yourself. Absent once the environment is terminated, because that page no longer exists.")
9322
9331
  }, { urlFieldDescription: "Absolute URL of the environment page." });
@@ -9452,14 +9461,14 @@ var makeGetEnvironmentContract = (ids) => {
9452
9461
  annotationJustifications: {
9453
9462
  destructiveHint: "Does not alter environment settings or concurrency limits.",
9454
9463
  openWorldHint: "Reads QA Wolf environment state without updating the connected Git provider.",
9455
- readOnlyHint: "Retrieves an environment's configuration, run health and code-reconciliation state."
9464
+ readOnlyHint: "Retrieves an environment's configuration, release readiness and code-reconciliation state."
9456
9465
  },
9457
9466
  annotations: {
9458
9467
  destructiveHint: false,
9459
9468
  openWorldHint: false,
9460
9469
  readOnlyHint: true
9461
9470
  },
9462
- 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.",
9471
+ description: "Read a single environment's name, kind, release readiness status, 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.",
9463
9472
  input,
9464
9473
  kind: "read",
9465
9474
  name: "environment.get",
@@ -9870,7 +9879,7 @@ var openIssueStatuses = [
9870
9879
  "paused"
9871
9880
  ];
9872
9881
  var makeIssueResourceSchema = (ids) => resource({
9873
- coveredFlowIds: array(ids.flow).describe("The flows a coverage request covers. Always empty on bug and maintenance reports, whose flows are listed under reproductions."),
9882
+ coveredFlowIds: array(ids.flow).describe("The flows a coverage request covers. Always empty on bug reports and blockers, whose flows are listed under reproductions."),
9874
9883
  createdAt: exports_coerce.date().describe("When the issue was created."),
9875
9884
  description: string2().describe("The issue description in Markdown."),
9876
9885
  issueId: ids.issue,
@@ -9891,25 +9900,25 @@ var makeFindIssuesContract = (ids) => {
9891
9900
  const input = object({
9892
9901
  ...makePaginationInputFields({ defaultLimit: 20, maxLimit: 100 }),
9893
9902
  statuses: array(issueStatusSchema).min(1).default([...openIssueStatuses]).describe("Issue statuses to include. Defaults to backlog, pending, in-progress, and paused issues."),
9894
- type: publicIssueTypeSchema.describe("The issue type to include: bug report, maintenance report, or coverage request."),
9903
+ type: publicIssueTypeSchema.describe("The issue type to include: bug report (`bug`), blocker (`maintenance`), or coverage request (`coverageRequest`)."),
9895
9904
  workspaceId: ids.workspace.optional().describe("The workspace whose issues to list. Required when authenticating with an organization or user API key.")
9896
9905
  });
9897
9906
  const output = object({
9898
- issues: array(makeIssueResourceSchema(ids)).describe("The team's bug reports, maintenance reports, or coverage requests, newest first."),
9907
+ issues: array(makeIssueResourceSchema(ids)).describe("The team's bug reports, blockers, or coverage requests, newest first."),
9899
9908
  nextCursor: nextCursorSchema
9900
9909
  });
9901
9910
  return {
9902
9911
  annotationJustifications: {
9903
9912
  destructiveHint: "Does not edit issue details, statuses or coverage associations.",
9904
9913
  openWorldHint: "Reads QA Wolf issue records without publishing updates to linked trackers.",
9905
- readOnlyHint: "Lists workspace bug reports, maintenance reports or coverage requests."
9914
+ readOnlyHint: "Lists workspace bug reports, blockers or coverage requests."
9906
9915
  },
9907
9916
  annotations: {
9908
9917
  destructiveHint: false,
9909
9918
  openWorldHint: false,
9910
9919
  readOnlyHint: true
9911
9920
  },
9912
- description: "List the team's bug reports, maintenance reports, or coverage requests, newest first.",
9921
+ description: "List the team's bug reports, blockers, or coverage requests, newest first.",
9913
9922
  input,
9914
9923
  kind: "read",
9915
9924
  name: "issue.find",
@@ -10056,7 +10065,7 @@ var makeAddFlowsToIssueContract = (ids) => {
10056
10065
  openWorldHint: false,
10057
10066
  readOnlyHint: false
10058
10067
  },
10059
- description: "Add flows to a coverage request owned by the caller's team. " + "Flows already covered stay covered. " + "Bug and maintenance reports link to flows through the runs that reproduce them; use run.diagnose to record one.",
10068
+ description: "Add flows to a coverage request owned by the caller's team. " + "Flows already covered stay covered. " + "Bug reports and blockers link to flows through the runs that reproduce them; use run.diagnose to record one.",
10060
10069
  input,
10061
10070
  kind: "write",
10062
10071
  name: "issue.addFlows",
@@ -10086,7 +10095,18 @@ var makeCreateIssueContract = (ids) => {
10086
10095
  ...commonFields,
10087
10096
  effort: _enum(["extraSmall", "small", "medium", "large", "extraLarge"]).describe("The effort to repair the flows."),
10088
10097
  priority: _enum(["low", "medium", "high", "urgent"]),
10089
- reason: _enum(["dataChanged", "flowNeedsWork", "other", "uiChanged"]).describe("Why the flows need maintenance."),
10098
+ reason: _enum([
10099
+ "featureNotAvailable",
10100
+ "needsTestData",
10101
+ "needsAccess",
10102
+ "needsConfirmation",
10103
+ "environmentUnavailable",
10104
+ "qaWolfQueue",
10105
+ "dataChanged",
10106
+ "flowNeedsWork",
10107
+ "other",
10108
+ "uiChanged"
10109
+ ]).describe('What the blocked flows wait on. "qaWolfQueue" is only for full-service workspaces. "dataChanged", "flowNeedsWork", "other" and "uiChanged" are deprecated and still accepted.'),
10090
10110
  type: literal("maintenance")
10091
10111
  })
10092
10112
  ]);
@@ -10104,7 +10124,7 @@ var makeCreateIssueContract = (ids) => {
10104
10124
  openWorldHint: true,
10105
10125
  readOnlyHint: false
10106
10126
  },
10107
- description: "Create a bug report, maintenance report, or coverage request issue for the caller's team. " + "A user can create a maintenance report only when they can see the workspace's maintenance reports; " + "a team or organization API key credits it to the workspace's automation user. " + "Link its failed flows afterwards with run.diagnose.",
10127
+ description: "Create a bug report, blocker (issue type `maintenance`), or coverage request issue for the caller's team. " + "A user can create a blocker only when they can see the workspace's blockers; " + "a team or organization API key credits it to the workspace's automation user. " + "Link its failed flows afterwards with run.diagnose.",
10108
10128
  input,
10109
10129
  kind: "write",
10110
10130
  name: "issue.create",
@@ -10169,7 +10189,7 @@ var makeListIssueActivityContract = (ids) => {
10169
10189
  // node_modules/@qawolf/api-contracts/dist/v1/issue/removeFlows.js
10170
10190
  var makeRemoveFlowsFromIssueContract = (ids) => {
10171
10191
  const input = object({
10172
- environmentId: ids.environment.optional().describe("The environment whose bug or maintenance reproductions to remove. Required when a selected flow is linked in more than one environment."),
10192
+ environmentId: ids.environment.optional().describe("The environment whose bug report or blocker reproductions to remove. Required when a selected flow is linked in more than one environment."),
10173
10193
  flowIds: array(ids.flow).min(1).max(300).refine((flowIds) => new Set(flowIds).size === flowIds.length, "flowIds must be unique").describe("The flows to remove from the issue."),
10174
10194
  issueId: ids.issue
10175
10195
  });
@@ -10187,7 +10207,7 @@ var makeRemoveFlowsFromIssueContract = (ids) => {
10187
10207
  openWorldHint: true,
10188
10208
  readOnlyHint: false
10189
10209
  },
10190
- description: "Remove flows from a coverage request or remove bug/maintenance reproductions in an environment. " + "Unlinked flows are left alone. Reports auto-close when no active reproductions remain and auto-close is enabled. " + "For reports, omit environmentId only when each selected flow is linked in at most one environment.",
10210
+ description: "Remove flows from a coverage request or remove bug report or blocker reproductions in an environment. " + "Unlinked flows are left alone. Reports auto-close when no active reproductions remain and auto-close is enabled. " + "For reports, omit environmentId only when each selected flow is linked in at most one environment.",
10191
10211
  input,
10192
10212
  kind: "write",
10193
10213
  name: "issue.removeFlows",
@@ -10204,7 +10224,7 @@ var makeUpdateIssueContract = (ids) => {
10204
10224
  issueId: ids.issue,
10205
10225
  name: nameSchema.optional(),
10206
10226
  priority: issuePrioritySchema.optional(),
10207
- status: issueStatusSchema.optional()
10227
+ status: issueStatusSchema.optional().describe("Bug reports and blockers allow only these changes: pending to canceled or archived, canceled to archived, and resolved to archived. Requesting pending or inProgress on a bug report resolved in the last 7 days reopens it. The stored status is inProgress when a flow still reproduces it, and pending otherwise. Never set resolved on a bug report: it resolves on its own once its flows pass. A coverage request can move to backlog, pending, paused, inProgress, resolved or archived.")
10208
10228
  }).refine((update) => update.description !== undefined || update.name !== undefined || update.priority !== undefined || update.status !== undefined, {
10209
10229
  message: "At least one of description, name, priority, or status is required."
10210
10230
  });
@@ -10243,8 +10263,12 @@ var branchScope = union([
10243
10263
  ]);
10244
10264
  var codeHostingServiceRepository = union([
10245
10265
  object({ kind: literal("any") }),
10246
- object({ kind: literal("none") }),
10247
- object({ id: string2(), kind: literal("by-id") })
10266
+ object({ kind: literal("none") }).describe("The trigger ran with the code host integration's features off. It is not a repository filter and maps to no repositoryPattern."),
10267
+ object({
10268
+ fullName: string2().describe(`The repository's full name on the code host, such as "acme/storefront", as codeHostIntegration.listRepositories reports it and as a current trigger's repositoryPattern matches it.`),
10269
+ id: string2(),
10270
+ kind: literal("by-id")
10271
+ })
10248
10272
  ]);
10249
10273
  var makeLegacyTriggerSchema = (ids) => {
10250
10274
  const base = {
@@ -10432,14 +10456,14 @@ var makeDiagnoseRunContract = (ids) => {
10432
10456
  annotationJustifications: {
10433
10457
  destructiveHint: "Can replace a flow's existing diagnosis association and change externally reported run information.",
10434
10458
  openWorldHint: "Recorded diagnosis changes can update run-related messages in configured external integrations.",
10435
- readOnlyHint: "Records failed flows as reproductions of a selected bug or maintenance issue."
10459
+ readOnlyHint: "Records failed flows as reproductions of a selected bug report or blocker."
10436
10460
  },
10437
10461
  annotations: {
10438
10462
  destructiveHint: true,
10439
10463
  openWorldHint: true,
10440
10464
  readOnlyHint: false
10441
10465
  },
10442
- description: "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 in the run moves to this issue, and may stay linked to other open reports. " + "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.",
10466
+ description: "Link failed flows in a run to an existing bug report or blocker owned by the caller's team, recording them as its reproductions. " + "It does not explain why a run failed; read investigation.get or attempt.get for that. " + "The issue's type selects the diagnosis. " + "Each flow must have failed in the run. " + "A flow that is already diagnosed in the run moves to this issue, and may stay linked to other open reports. " + "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.",
10443
10467
  input,
10444
10468
  kind: "write",
10445
10469
  name: "run.diagnose",
@@ -10482,35 +10506,15 @@ var makeFindRunsContract = (ids) => {
10482
10506
  };
10483
10507
  };
10484
10508
 
10485
- // node_modules/@qawolf/api-contracts/dist/v1/run/flowFailure.js
10486
- var makeFlowFailureSchema = (ids) => {
10487
- const diagnosis = object({
10488
- issueId: ids.issue,
10489
- type: _enum(["bug", "maintenance"])
10490
- }).optional().describe("QA Wolf's investigation verdict for the failure: `bug` means the " + "application is broken, `maintenance` means the test needed an " + "update and the failure does not indicate an application problem. " + "Absent until the investigation reaches a verdict, and absent when " + "the flow was opted out of investigation. Pass issueId to issue.get " + "for details.");
10491
- const optedOutOfInvestigation = object({
10492
- by: _enum(["user", "system"]).describe("Who stopped the investigation: `user` is a person, in the app or " + "with a user API key, or the workspace's automation user for a " + "team or organization API key, for example through " + "run.optOutOfInvestigation; `system` is QA Wolf, when the " + "investigation expired.")
10493
- }).optional().describe('Present when the failure was marked "do not investigate" (DNI): ' + "it will get no bug or maintenance verdict.");
10494
- return object({
10495
- diagnosis,
10496
- error: string2(),
10497
- optedOutOfInvestigation
10498
- });
10499
- };
10500
-
10501
- // node_modules/@qawolf/api-contracts/dist/v1/run/get.js
10502
- var makeGetRunContract = (ids) => {
10503
- const flowStatus = _enum(publicRunStatusValues);
10504
- const input = object({
10505
- flowStatuses: array(flowStatus).min(1).optional().describe("Return only the flows whose status is one of these. A suite run can " + "hold hundreds of flows, so start an investigation with failed " + "alone. A flow that passed after a retry reads passed, so add " + "passed when a flaky flow is missing from the answer. Omit to " + "return every flow. The run-level fields are unaffected."),
10506
- runId: ids.run
10507
- });
10509
+ // node_modules/@qawolf/api-contracts/dist/v1/run/flowAttempts.js
10510
+ var makeFlowAttemptsSchema = (ids) => {
10508
10511
  const artifactUrls = {
10509
10512
  logsUrl: url().optional().describe("Signed URL for the attempt's execution logs."),
10510
10513
  traceUrl: url().optional().describe("Signed URL for the attempt's Playwright trace (a trace.zip; open it with `npx playwright show-trace`)."),
10511
10514
  videoUrl: url().optional().describe("Signed URL for the attempt's screen recording.")
10512
10515
  };
10513
10516
  const automatedKind = literal("automated").describe("The attempt ran on a QA Wolf runner.");
10517
+ const attemptUrl = url().optional().describe("Absolute URL of the attempt's page in the app, which opens this flow at this attempt. Link this page to show one flow's attempt: the run page opens a different flow. Absent only in replies from servers older than this field.");
10514
10518
  const automatedAttempt = discriminatedUnion("status", [
10515
10519
  object({
10516
10520
  ...artifactUrls,
@@ -10518,7 +10522,8 @@ var makeGetRunContract = (ids) => {
10518
10522
  completedAt: exports_iso.datetime(),
10519
10523
  kind: automatedKind,
10520
10524
  startedAt: exports_iso.datetime(),
10521
- status: literal("passed")
10525
+ status: literal("passed"),
10526
+ url: attemptUrl
10522
10527
  }),
10523
10528
  object({
10524
10529
  ...artifactUrls,
@@ -10526,7 +10531,8 @@ var makeGetRunContract = (ids) => {
10526
10531
  completedAt: exports_iso.datetime(),
10527
10532
  kind: automatedKind,
10528
10533
  startedAt: exports_iso.datetime().optional().describe("Absent when the attempt failed before it could start."),
10529
- status: literal("failed")
10534
+ status: literal("failed"),
10535
+ url: attemptUrl
10530
10536
  }),
10531
10537
  object({
10532
10538
  attemptId: ids.runAttempt.optional(),
@@ -10534,18 +10540,47 @@ var makeGetRunContract = (ids) => {
10534
10540
  completedAt: exports_iso.datetime().optional(),
10535
10541
  kind: automatedKind,
10536
10542
  startedAt: exports_iso.datetime().optional(),
10537
- status: literal("canceled").describe("The attempt was terminated without reaching a verdict.")
10543
+ status: literal("canceled").describe("The attempt was terminated without reaching a verdict."),
10544
+ url: attemptUrl
10538
10545
  })
10539
10546
  ]);
10540
10547
  const manualAttempt = object({
10548
+ ...artifactUrls,
10541
10549
  attemptId: ids.runAttempt.optional(),
10542
10550
  completedAt: exports_iso.datetime(),
10543
10551
  kind: literal("manual").describe("The attempt ran by hand in the Wolf Browser."),
10544
10552
  startedAt: exports_iso.datetime(),
10545
- status: literal("passed")
10553
+ status: literal("passed"),
10554
+ url: attemptUrl
10546
10555
  });
10547
10556
  const attempt = union([automatedAttempt, manualAttempt]);
10548
- const attempts = array(attempt).optional().describe("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.");
10557
+ return array(attempt).optional().describe("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 attempts that reached a " + "verdict, and on a manual attempt only when its Wolf Browser run " + "kept them. They 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.");
10558
+ };
10559
+
10560
+ // node_modules/@qawolf/api-contracts/dist/v1/run/flowFailure.js
10561
+ var makeFlowFailureSchema = (ids) => {
10562
+ const diagnosis = object({
10563
+ issueId: ids.issue,
10564
+ type: _enum(["bug", "maintenance"])
10565
+ }).optional().describe("QA Wolf's investigation verdict for the failure: `bug` means the " + "application is broken, `maintenance` means the test needed an " + "update and the failure does not indicate an application problem. " + "Absent until the investigation reaches a verdict, and absent when " + "the flow was opted out of investigation. Pass issueId to issue.get " + "for details.");
10566
+ const optedOutOfInvestigation = object({
10567
+ by: _enum(["user", "system"]).describe("Who stopped the investigation: `user` is a person, in the app or " + "with a user API key, or the workspace's automation user for a " + "team or organization API key, for example through " + "run.optOutOfInvestigation; `system` is QA Wolf, when the " + "investigation expired.")
10568
+ }).optional().describe('Present when the failure was marked "do not investigate" (DNI): ' + "it will get no bug or maintenance verdict.");
10569
+ return object({
10570
+ diagnosis,
10571
+ error: string2(),
10572
+ optedOutOfInvestigation
10573
+ });
10574
+ };
10575
+
10576
+ // node_modules/@qawolf/api-contracts/dist/v1/run/get.js
10577
+ var makeGetRunContract = (ids) => {
10578
+ const flowStatus = _enum(publicRunStatusValues);
10579
+ const input = object({
10580
+ flowStatuses: array(flowStatus).min(1).optional().describe("Return only the flows whose status is one of these. A suite run can " + "hold hundreds of flows, so start an investigation with failed " + "alone. A flow that passed after a retry reads passed, so add " + "passed when a flaky flow is missing from the answer. Omit to " + "return every flow. The run-level fields are unaffected."),
10581
+ runId: ids.run
10582
+ });
10583
+ const attempts = makeFlowAttemptsSchema(ids);
10549
10584
  const failedFlow = object({
10550
10585
  attempts,
10551
10586
  failure: makeFlowFailureSchema(ids),
@@ -10599,14 +10634,14 @@ var makeOptOutOfInvestigationRunContract = (ids) => {
10599
10634
  annotationJustifications: {
10600
10635
  destructiveHint: "Ends the investigation of the selected failures and changes externally reported run information.",
10601
10636
  openWorldHint: "Recorded opt-outs can update run-related messages in configured external integrations.",
10602
- readOnlyHint: "Records failed flows as needing no bug or maintenance report."
10637
+ readOnlyHint: "Records failed flows as needing no bug report or blocker."
10603
10638
  },
10604
10639
  annotations: {
10605
10640
  destructiveHint: true,
10606
10641
  openWorldHint: true,
10607
10642
  readOnlyHint: false
10608
10643
  },
10609
- description: 'Mark failed flows in a run as "do not investigate" (DNI): the failures need no bug or maintenance report. ' + "Each flow must have failed in the run and still be under investigation. " + "A flow that already has a diagnosis cannot be opted out. " + "A team or organization key records the opt-out as the workspace's automation user. " + "To link a failure to a report instead, use run.diagnose.",
10644
+ description: 'Mark failed flows in a run as "do not investigate" (DNI): the failures need no bug report or blocker. ' + "Each flow must have failed in the run and still be under investigation. " + "A flow that already has a diagnosis cannot be opted out. " + "A team or organization key records the opt-out as the workspace's automation user. " + "To link a failure to a report instead, use run.diagnose.",
10610
10645
  input,
10611
10646
  kind: "write",
10612
10647
  name: "run.optOutOfInvestigation",
@@ -10617,13 +10652,20 @@ var makeOptOutOfInvestigationRunContract = (ids) => {
10617
10652
  // node_modules/@qawolf/api-contracts/dist/v1/run/reattempt.js
10618
10653
  var makeReattemptRunContract = (ids) => {
10619
10654
  const input = object({
10655
+ afterCommit: string2().regex(/^[0-9a-f]{40}$/u, "afterCommit must be a full 40-character commit hash").optional().describe("A commit you published to the environment's flow code branch. " + "The request is refused until the environment has synced this " + "commit or a later one, so the new attempts run it. Omit to run " + "whatever code the environment has synced."),
10656
+ aiTaskId: ids.aiTask.optional().describe("The AI task whose conversation should receive the new attempts' results."),
10657
+ chatSessionId: ids.chatSession.optional().describe("The chat session whose transcript should receive the new attempts' results."),
10620
10658
  flowIds: 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."),
10621
10659
  runId: ids.run
10660
+ }).refine((value) => !(value.aiTaskId && value.chatSessionId), {
10661
+ message: "Provide at most one of aiTaskId and chatSessionId: a task already implies its own chat session.",
10662
+ path: ["chatSessionId"]
10622
10663
  });
10623
10664
  const output = resource({
10624
10665
  reattemptedFlowIds: array(ids.flow).describe("The flows a new attempt was requested for."),
10625
10666
  reattemptedInRunIds: array(ids.run).describe("The runs the new attempts were added to, which is where to poll " + "for their results. It is this run alone unless a flow had kept " + "failing in later runs, because the attempt then goes to the " + "latest of them."),
10626
- runId: ids.run
10667
+ runId: ids.run,
10668
+ tracking: _enum(["registered", "failed", "not-requested"]).describe(`Whether the conversation named by aiTaskId or chatSessionId will receive the new attempts' results: "registered" when it will, "failed" when the attempts were requested but the registration failed, "not-requested" when neither id was given or the AI task has no conversation to notify.`)
10627
10669
  }, { urlFieldDescription: "Absolute URL of the run page." });
10628
10670
  return {
10629
10671
  annotationJustifications: {
@@ -10636,7 +10678,7 @@ var makeReattemptRunContract = (ids) => {
10636
10678
  openWorldHint: true,
10637
10679
  readOnlyHint: false
10638
10680
  },
10639
- description: "Request new attempts for a run's flows. " + "A flow is eligible once its result is failed or canceled and QA Wolf's " + "automatic retries have finished. " + "A flow that kept failing in later runs is attempted in the latest of " + "them, because that is the run carrying the failure, so read " + "reattemptedInRunIds for where each attempt landed. " + "A fully investigated run no longer accepts reattempts. " + "Attempts run with the latest flow code. Poll run.get for results.",
10681
+ description: "Request new attempts for a run's flows. " + "A flow is eligible once its result is failed or canceled and QA Wolf's " + "automatic retries have finished. " + "A flow that kept failing in later runs is attempted in the latest of " + "them, because that is the run carrying the failure, so read " + "reattemptedInRunIds for where each attempt landed. " + "A fully investigated run no longer accepts reattempts. " + "Attempts run with the flow code the environment has synced when the " + "request arrives: after publishing a fix, pass afterCommit so the " + "request waits for that commit instead of rerunning older code. " + "Poll run.get for results, or pass aiTaskId or chatSessionId to be " + "notified when they settle.",
10640
10682
  input,
10641
10683
  kind: "write",
10642
10684
  name: "run.reattempt",
@@ -11182,7 +11224,7 @@ var makeTakeScreenshotOnRunnerContract = (ids) => {
11182
11224
  openWorldHint: false,
11183
11225
  readOnlyHint: false
11184
11226
  },
11185
- description: `Take one screenshot of an interactive runner's screen. On a runner with a browser the image is the whole virtual desktop, browser window and all; this refreshes the inactivity timer and can extend the runner's billed lifetime. On a mobile runner it is the device's own screen, and on Windows the VM's whole desktop, re-encoded to JPEG on the pod so this contract reads one image format regardless of runner family. ${screenNeedsARunDescription} ${screenNotReadyDescription} ${runnerHasNoScreenDescription} ${retryableRunnerUnreachableDescription}`,
11227
+ description: `Take one screenshot of an interactive runner's screen. On a runner with a browser the image is the whole virtual desktop, browser window and all; this refreshes the inactivity timer and can extend the runner's billed lifetime. On a mobile runner it is the device's own screen, and on Windows the VM's whole desktop, re-encoded to JPEG on the pod so this contract reads one image format regardless of runner family. ${screenNeedsARunDescription} ${screenNotReadyDescription} On a mobile or Windows runner, \`screen-not-ready\` can also mean its Appium session did not answer in time; if it persists after 3 tries, terminate the runner and launch it again with the same id and runnerName. ${runnerHasNoScreenDescription} ${retryableRunnerUnreachableDescription}`,
11186
11228
  input,
11187
11229
  kind: "read",
11188
11230
  name: "runner.takeScreenshot",
@@ -11536,6 +11578,18 @@ var authMessages = {
11536
11578
  success: "Logged out successfully.",
11537
11579
  cancelled: "Logout cancelled."
11538
11580
  },
11581
+ gitHelper: {
11582
+ added: (file) => `Git now uses your QA Wolf sign-in. Added to ${file ?? "your global Git config"}:`,
11583
+ unchanged: "Git already uses your QA Wolf sign-in.",
11584
+ gitMissing: "Git is not installed, so Git setup was skipped.",
11585
+ temporaryInstall: "Git setup was skipped because this CLI runs from a temporary install. Install the CLI globally to clone with your QA Wolf sign-in.",
11586
+ teamApiKeySkipped: "Git setup was skipped because Git cannot use a team API key. Sign in with your browser or a user API key to clone with your QA Wolf sign-in.",
11587
+ failed: (detail) => `Could not set up Git: ${detail}`,
11588
+ removed: (file) => `Removed the QA Wolf Git helper from ${file ?? "your global Git config"}:`,
11589
+ removalFailed: (detail) => `Could not remove the QA Wolf Git helper: ${detail}`,
11590
+ signedOut: "qawolf: run 'qawolf auth login' to use your QA Wolf sign-in with Git.",
11591
+ teamApiKey: "qawolf: Git needs a browser sign-in or a user API key. Run 'qawolf auth login' to use one."
11592
+ },
11539
11593
  errors: authErrorMessages,
11540
11594
  whoami: whoamiMessages
11541
11595
  };
@@ -16020,4 +16074,4 @@ export {
16020
16074
  createRunnerSdk
16021
16075
  };
16022
16076
 
16023
- //# debugId=A94DB3C7942B00FA64756E2164756E21
16077
+ //# debugId=56D1BCF300A31BCC64756E2164756E21
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@qawolf/cli",
3
- "version": "2.0.0",
3
+ "version": "2.2.0",
4
4
  "description": "Run and manage QA Wolf flows from the terminal, CI, or an AI agent",
5
5
  "keywords": [
6
6
  "automation",
@@ -72,7 +72,7 @@
72
72
  "@clack/prompts": "1.5.1",
73
73
  "@napi-rs/keyring": "1.3.0",
74
74
  "@oxc-node/core": "0.1.0",
75
- "@qawolf/api-contracts": "0.91.0",
75
+ "@qawolf/api-contracts": "0.98.1",
76
76
  "@qawolf/emails": "1.1.1",
77
77
  "@qawolf/flow-targets": "2.0.0",
78
78
  "@qawolf/flows": "0.3.0",
@@ -151,7 +151,7 @@ that `url`; never guess a route and never send a repository link in its place.
151
151
  | `qawolf environment create` | write | Create an environment on the caller's team and return it in the environment.get shape. This can also create a branch on the team's connected Git provider. |
152
152
  | `qawolf environment deleteVariable` | write | Remove one environment variable by name. Succeeds whether or not the variable existed. |
153
153
  | `qawolf environment find` | read | List the team's environments, newest first. |
154
- | `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. |
154
+ | `qawolf environment get` | read | Read a single environment's name, kind, release readiness status, 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. |
155
155
  | `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. |
156
156
  | `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. |
157
157
  | `qawolf environment promote` | write | Declare a preview environment's work accepted, typically when its pull request merges: its flow changes are promoted into its base environment and the environment is terminated once they land. Returns the promotion in pending; poll promotion.get to learn how it settled. Calling again while a promotion is open returns that promotion. A conflict settles the promotion conflicted and cancels the environment's in-progress runs; promotion.get names the conflicting paths. Use environment.terminate instead when the work is abandoned. |
@@ -159,7 +159,7 @@ that `url`; never guess a route and never send a repository link in its place.
159
159
  | `qawolf environment terminate` | write | Terminate a preview environment, typically when its pull request closes without merging: its flow changes are not promoted into its base. Returns the environment, now terminated. A terminated environment cannot be terminated again. Use environment.promote instead when the work is accepted. |
160
160
  | `qawolf environment update` | write | Update an environment owned by the caller's team and return it in the environment.get shape. Omitted fields remain unchanged. |
161
161
  | `qawolf file requestDownload` | read | Get a URL for reading a file out of the caller's team storage. Answers 404 when nothing is stored at that path. |
162
- | `qawolf file requestUpload` | write | Get a URL to put a file into team storage: a spreadsheet of journeys, anything too large to paste. PUT with the returned contentType, then name the path in filePaths. |
162
+ | `qawolf file requestUpload` | write | Get a URL to put a file into team storage: a spreadsheet of journeys, anything too large to paste. PUT with the returned contentType, then name the returned filePath in filePaths. |
163
163
  | `qawolf flow addTag` | write | Assign an existing tag to the selected flows. Create tags with tag.create. Flows that already carry the tag are reported in skippedFlows. |
164
164
  | `qawolf flow getHistory` | read | List one flow's results across runs in an environment, newest first, with status, attempts, duration, and diagnosis. Use it to spot flakiness, failure streaks, and duration trends. |
165
165
  | `qawolf flow removeTag` | write | Remove a tag from the selected flows. Succeeds whether or not each flow carried the tag; the flows that did not are reported in skippedFlows. |
@@ -173,12 +173,12 @@ that `url`; never guess a route and never send a repository link in its place.
173
173
  | `qawolf install browsers` | local | Install Playwright browsers used by the project's web flows |
174
174
  | `qawolf install clear` | local | Remove the managed runtime cache (all installed runtime versions) |
175
175
  | `qawolf investigation get` | read | Read what the QA Wolf AI investigating a run has concluded: one finding per cause of its failures, with the question waiting for a person and any answer or dispute the investigation hasn't acted on yet. A run that automatic investigation does not cover answers status "not-enabled". |
176
- | `qawolf issue addFlows` | write | Add flows to a coverage request owned by the caller's team. Flows already covered stay covered. Bug and maintenance reports link to flows through the runs that reproduce them; use run.diagnose to record one. |
177
- | `qawolf issue create` | write | Create a bug report, maintenance report, or coverage request issue for the caller's team. A user can create a maintenance report only when they can see the workspace's maintenance reports; a team or organization API key credits it to the workspace's automation user. Link its failed flows afterwards with run.diagnose. |
178
- | `qawolf issue find` | read | List the team's bug reports, maintenance reports, or coverage requests, newest first. |
176
+ | `qawolf issue addFlows` | write | Add flows to a coverage request owned by the caller's team. Flows already covered stay covered. Bug reports and blockers link to flows through the runs that reproduce them; use run.diagnose to record one. |
177
+ | `qawolf issue create` | write | Create a bug report, blocker (issue type `maintenance`), or coverage request issue for the caller's team. A user can create a blocker only when they can see the workspace's blockers; a team or organization API key credits it to the workspace's automation user. Link its failed flows afterwards with run.diagnose. |
178
+ | `qawolf issue find` | read | List the team's bug reports, blockers, or coverage requests, newest first. |
179
179
  | `qawolf issue get` | read | Get an issue by id. |
180
180
  | `qawolf issue listActivity` | read | List an issue's activity, oldest first: creation, status and priority changes, and the flows that started or stopped reproducing it. Use it to measure time to fix or to find issues that came back. |
181
- | `qawolf issue removeFlows` | write | Remove flows from a coverage request or remove bug/maintenance reproductions in an environment. Unlinked flows are left alone. Reports auto-close when no active reproductions remain and auto-close is enabled. For reports, omit environmentId only when each selected flow is linked in at most one environment. |
181
+ | `qawolf issue removeFlows` | write | Remove flows from a coverage request or remove bug report or blocker reproductions in an environment. Unlinked flows are left alone. Reports auto-close when no active reproductions remain and auto-close is enabled. For reports, omit environmentId only when each selected flow is linked in at most one environment. |
182
182
  | `qawolf issue update` | write | Update an issue owned by the caller's team. Omitted fields remain unchanged. |
183
183
  | `qawolf legacyTrigger find` | read | List a workspace's legacy per-environment triggers; trigger.find lists the current ones. For migration only; it goes when legacy triggers go. adaptiveFlowSelection becomes a generativeSuite action, which takes no tags. |
184
184
  | `qawolf legacyTrigger pause` | write | Pause one legacy trigger, the older per-environment kind, so it stops firing; use trigger.pause for a current one. Its copies in pull request environments pause too. For migration only; it goes when legacy triggers go. |
@@ -188,12 +188,12 @@ that `url`; never guess a route and never send a repository link in its place.
188
188
  | `qawolf promotion resolve` | write | Submit the resolution of a conflicted promotion: the full resolved contents of every conflicting path to keep, and every conflicting path to delete. Together they must cover exactly the paths in the promotion's conflict, and both commit hashes must match the conflict's; if a branch moved since, the call is refused as stale-conflict and promotion.get has the current conflict. Returns the promotion in resolving; poll promotion.get until it is promoted, or conflicted again if the branches moved while it applied. |
189
189
  | `qawolf run acceptScreenshotBaseline` | write | Make the new screenshot of a failed screenshot comparison the baseline, so later runs compare with it. Use it only when the difference is an intended change of the app, not a bug, noise, or a page that was not ready. Every later run of every environment of the workspace compares with the new baseline. Refuses without changing anything when the baseline changed since the run. |
190
190
  | `qawolf run create` | write | Create a run for the selected flows and/or tags in an environment. |
191
- | `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 in the run moves to this issue, and may stay linked to other open reports. 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. |
191
+ | `qawolf run diagnose` | write | Link failed flows in a run to an existing bug report or blocker owned by the caller's team, recording them as its reproductions. It does not explain why a run failed; read investigation.get or attempt.get for that. The issue's type selects the diagnosis. Each flow must have failed in the run. A flow that is already diagnosed in the run moves to this issue, and may stay linked to other open reports. 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. |
192
192
  | `qawolf run find` | read | List an environment's recent runs, newest first, including failed-attempt discovery metadata. |
193
193
  | `qawolf run get` | read | Get a run's status, per-flow results, links, and how many of its bugs are blocking. |
194
194
  | `qawolf run listScreenshotComparisons` | read | List the screenshot comparisons that failed a run's flows, with the expected, actual and diff images of each. Only comparisons that caused a failure are listed: a screenshot that differs within tolerance, or that differs on a line that did not fail, is left out. Each comparison tells whether its baseline changed since the run and whether the baseline still passes in other environments. The image URLs expire after a few minutes; fetch the preview URLs to look at the images. The first call for an image makes its missing JPEG preview and keeps it in team storage, so later calls reuse it. |
195
- | `qawolf run optOutOfInvestigation` | write | Mark failed flows in a run as "do not investigate" (DNI): the failures need no bug or maintenance report. Each flow must have failed in the run and still be under investigation. A flow that already has a diagnosis cannot be opted out. A team or organization key records the opt-out as the workspace's automation user. To link a failure to a report instead, use run.diagnose. |
196
- | `qawolf run reattempt` | write | Request new attempts for a run's flows. A flow is eligible once its result is failed or canceled and QA Wolf's automatic retries have finished. A flow that kept failing in later runs is attempted in the latest of them, because that is the run carrying the failure, so read reattemptedInRunIds for where each attempt landed. A fully investigated run no longer accepts reattempts. Attempts run with the latest flow code. Poll run.get for results. |
195
+ | `qawolf run optOutOfInvestigation` | write | Mark failed flows in a run as "do not investigate" (DNI): the failures need no bug report or blocker. Each flow must have failed in the run and still be under investigation. A flow that already has a diagnosis cannot be opted out. A team or organization key records the opt-out as the workspace's automation user. To link a failure to a report instead, use run.diagnose. |
196
+ | `qawolf run reattempt` | write | Request new attempts for a run's flows. A flow is eligible once its result is failed or canceled and QA Wolf's automatic retries have finished. A flow that kept failing in later runs is attempted in the latest of them, because that is the run carrying the failure, so read reattemptedInRunIds for where each attempt landed. A fully investigated run no longer accepts reattempts. Attempts run with the flow code the environment has synced when the request arrives: after publishing a fix, pass afterCommit so the request waits for that commit instead of rerunning older code. Poll run.get for results, or pass aiTaskId or chatSessionId to be notified when they settle. |
197
197
  | `qawolf run restoreScreenshotBaseline` | write | Undo a screenshot baseline change that accepted a failed comparison of the run: put back the baseline it replaced, so later runs compare with the old baseline again. Use it when a person disputes a baseline the AI accepted. Refuses without changing anything when the baseline changed again since. |
198
198
  | `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. |
199
199
  | `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 |