@qawolf/cli 2.10.0 → 2.12.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.
package/dist/cli.js CHANGED
@@ -17953,8 +17953,41 @@ function resource(fields, { urlFieldDescription = "Absolute URL." } = {}) {
17953
17953
  });
17954
17954
  }
17955
17955
 
17956
+ // node_modules/@qawolf/api-contracts/dist/v1/promotion/decision.js
17957
+ var promotionDecisionTypeSchema = _enum(["picked-by-run", "combined", "kept-more-checks", "needs-person"]).describe("picked-by-run (exactly one version passed, so it was kept), combined (every version passed and they check different things, so they were merged), kept-more-checks (every version passed and one checks more, so it was kept), needs-person (every version failed or the runs could not tell them apart, so a person decides).");
17958
+ var promotionCandidateSchema = _enum(["head", "base", "combined"]).describe("head (the head environment's version), base (the base environment's version), combined (the resolver's combination of the two).");
17959
+ var promotionCandidateOutcomeSchema = _enum(["passed", "failed", "inconclusive"]).describe("How the version did in its run. inconclusive: it passed in some attempts and failed in others, or the run did not finish.");
17960
+ var makePromotionDecisionSchema = (ids) => object({
17961
+ candidateRuns: array(object({
17962
+ candidate: promotionCandidateSchema,
17963
+ outcome: promotionCandidateOutcomeSchema,
17964
+ runId: ids.run
17965
+ })).describe("The run of each version the decision relied on."),
17966
+ kept: promotionCandidateSchema.optional().describe("The version kept. Present for picked-by-run and kept-more-checks."),
17967
+ path: string2().describe("The conflicting path this decision is about."),
17968
+ reason: string2().describe("Why, in a sentence or two a person can read."),
17969
+ sourceCommitHash: string2().describe("The head commit of the conflict this decision was made for."),
17970
+ targetCommitHash: string2().describe("The base commit of the conflict this decision was made for."),
17971
+ type: promotionDecisionTypeSchema
17972
+ });
17973
+
17974
+ // node_modules/@qawolf/api-contracts/dist/v1/promotion/needsPerson.js
17975
+ var promotionNeedsPersonReasonSchema = _enum([
17976
+ "undecided-paths",
17977
+ "run-limit-reached",
17978
+ "flows-undetermined",
17979
+ "agent-stopped",
17980
+ "agent-failed",
17981
+ "agent-not-started",
17982
+ "agent-resolution-off"
17983
+ ]).describe("undecided-paths (the runs of these paths' versions, if any, left no single answer), run-limit-reached (the resolution agent started as many runs as one conflict allows), flows-undetermined (which flows the conflict affects could not be told, so no resolution could be checked), agent-stopped (the resolution agent finished without submitting; its session says why), agent-failed (the resolution agent failed, timed out or was canceled), agent-not-started (QA Wolf had no user to run the resolution agent as), agent-resolution-off (the workspace does not have QA Wolf resolve conflicts).");
17984
+ var promotionNeedsPersonSchema = object({
17985
+ paths: array(object({ path: string2() })).optional().describe("The paths left undecided. Present for undecided-paths."),
17986
+ reason: promotionNeedsPersonReasonSchema
17987
+ });
17988
+
17956
17989
  // node_modules/@qawolf/api-contracts/dist/v1/promotion/validationRun.js
17957
- var resolutionRunModeSchema = _enum(["confirm-after"]).describe("Why a promotion conflict resolution task runs flows. confirm-after confirms a finished resolution before it is submitted.");
17990
+ var resolutionRunModeSchema = _enum(["confirm-after", "choose-version"]).describe("Why a promotion conflict resolution task runs flows. confirm-after confirms a finished resolution before it is submitted; choose-version runs one version of an undecided path to choose between them.");
17958
17991
  var makePromotionValidationRunSchema = (ids) => object({
17959
17992
  aiTaskId: ids.aiTask.describe("The resolution task that started the run."),
17960
17993
  runId: ids.run,
@@ -17982,8 +18015,10 @@ var makePromotionResourceSchema = (ids) => resource({
17982
18015
  baseEnvironmentId: ids.environment.describe("The environment the flow changes promote into."),
17983
18016
  conflict: conflictSchema.optional().describe("The conflict awaiting resolution. Present while status is conflicted or resolving. A resolution must name both commit hashes and cover exactly these paths; if either branch moves, the conflict is recomputed and this changes."),
17984
18017
  createdAt: exports_iso.datetime().describe("When the promotion was requested."),
18018
+ decisions: array(makePromotionDecisionSchema(ids)).optional().describe("How the resolution agent settled each conflicting path it decided by running the versions, or why it left one for a person. Absent when it reported none."),
17985
18019
  headEnvironmentId: ids.environment.describe("The environment whose flow changes are promoted."),
17986
18020
  id: ids.promotion,
18021
+ needsPerson: promotionNeedsPersonSchema.optional().describe("Present while the current conflict waits on a person, with why. Absent once a resolution is submitted, the conflict is recomputed, or the promotion settles."),
17987
18022
  promotedCommitHash: string2().optional().describe("The commit the promotion landed on the base environment's flow code branch. Present when status is promoted."),
17988
18023
  settledAt: exports_iso.datetime().optional().describe("When the promotion reached promoted, no-changes or abandoned. Absent while it is open."),
17989
18024
  status: promotionStatusSchema,
@@ -18046,6 +18081,53 @@ var makeGetPromotionContract = (ids) => {
18046
18081
  };
18047
18082
  };
18048
18083
 
18084
+ // node_modules/@qawolf/api-contracts/dist/v1/promotion/reportDecision.js
18085
+ var keptIsRequiredFor = new Set(["kept-more-checks", "picked-by-run"]);
18086
+ var makeReportPromotionDecisionContract = (ids) => {
18087
+ const candidateRun = (version) => object({
18088
+ outcome: promotionCandidateOutcomeSchema,
18089
+ runId: ids.run.describe(`The run of ${version}, started for this promotion's resolution.`)
18090
+ }).optional().describe(`How ${version} did when it ran. Omit when it did not run.`);
18091
+ const input = object({
18092
+ base: candidateRun("the base environment's version"),
18093
+ combined: candidateRun("the resolver's combination of both versions"),
18094
+ decision: promotionDecisionTypeSchema,
18095
+ expectedSourceCommitHash: string2().min(1).describe("conflict.sourceCommitHash from promotion.get. A different current commit means the branch moved and the call is refused."),
18096
+ expectedTargetCommitHash: string2().min(1).describe("conflict.targetCommitHash from promotion.get. A different current commit means the branch moved and the call is refused."),
18097
+ head: candidateRun("the head environment's version"),
18098
+ kept: promotionCandidateSchema.optional().describe("The version kept: required for picked-by-run and kept-more-checks (head or base), omitted otherwise."),
18099
+ path: string2().min(1).max(1024).describe("One of the promotion's conflicting paths."),
18100
+ promotionId: ids.promotion,
18101
+ reason: string2().min(1).max(1000).describe("Why, in a sentence or two a person can read: what was kept and what the runs showed, or what is undecided.")
18102
+ }).superRefine(({ decision, kept }, refinement) => {
18103
+ if (keptIsRequiredFor.has(decision) === (kept !== undefined))
18104
+ return;
18105
+ refinement.addIssue({
18106
+ code: "custom",
18107
+ message: keptIsRequiredFor.has(decision) ? `${decision} needs the version it kept.` : `${decision} keeps no single version; omit kept.`,
18108
+ path: ["kept"]
18109
+ });
18110
+ });
18111
+ const output = makePromotionResourceSchema(ids);
18112
+ return {
18113
+ annotationJustifications: {
18114
+ destructiveHint: "Records a decision on the promotion and changes no flow code.",
18115
+ openWorldHint: "Changes a private QA Wolf promotion record without touching external systems.",
18116
+ readOnlyHint: "Records how a conflicting path was settled."
18117
+ },
18118
+ annotations: {
18119
+ destructiveHint: false,
18120
+ openWorldHint: false,
18121
+ readOnlyHint: false
18122
+ },
18123
+ description: "Record how one conflicting path of a conflicted promotion was settled by running its versions, or why it is left for a person, with the run of each version. Exactly one passing version is kept (picked-by-run); when every version passed, they are combined or the one with more checks is kept; a person is asked only when every version failed or the runs could not tell them apart. Every run must have been started for this promotion's resolution. Reporting a path again replaces its decision. Returns the promotion.",
18124
+ input,
18125
+ kind: "write",
18126
+ name: "promotion.reportDecision",
18127
+ output
18128
+ };
18129
+ };
18130
+
18049
18131
  // node_modules/@qawolf/api-contracts/dist/v1/promotion/resolve.js
18050
18132
  var maxResolvedFileBytes = 1e6;
18051
18133
  var utf8ByteLength = (content) => new TextEncoder().encode(content).byteLength;
@@ -18076,7 +18158,7 @@ var makeResolvePromotionContract = (ids) => {
18076
18158
  openWorldHint: false,
18077
18159
  readOnlyHint: false
18078
18160
  },
18079
- description: "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.",
18161
+ description: "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. If the base environment has been terminated, the call is refused as target-environment-gone and the promotion can no longer be resolved. Returns the promotion in resolving; poll promotion.get until it is promoted, or conflicted again if the branches moved while it applied.",
18080
18162
  input,
18081
18163
  kind: "write",
18082
18164
  name: "promotion.resolve",
@@ -18088,6 +18170,7 @@ var makeResolvePromotionContract = (ids) => {
18088
18170
  var makePromotionContracts = (ids) => ({
18089
18171
  find: makeFindPromotionsContract(ids),
18090
18172
  get: makeGetPromotionContract(ids),
18173
+ reportDecision: makeReportPromotionDecisionContract(ids),
18091
18174
  resolve: makeResolvePromotionContract(ids)
18092
18175
  });
18093
18176
 
@@ -18408,6 +18491,7 @@ var defaultIdSchemas = {
18408
18491
  promotion: string2().min(1).describe("The id of the promotion, from promotion.find or environment.promote."),
18409
18492
  run: string2().min(1).describe("The id of the run."),
18410
18493
  runAttempt: string2().min(1).describe("The id of the run attempt."),
18494
+ suggestion: string2().min(1).describe("The id of the coverage suggestion, from suggestion.find or a new suggestions notification."),
18411
18495
  trigger: string2().min(1).describe("The id of the trigger."),
18412
18496
  workspace: string2().min(1).describe("The id of the workspace.")
18413
18497
  };
@@ -18479,7 +18563,7 @@ var makeCreateRunContract = (ids) => {
18479
18563
  investigateFailures: boolean2().optional().describe("Whether QA Wolf investigates failures in this run. False disables automatic AI Investigation for this run, including PR-testing runs. Omission or true follows the existing policy and never forces investigation. Uninvestigated failures fail associated commit checks."),
18480
18564
  pullRequestNumber: number2().int().positive().describe("The number of the pull request to associate with the run.").optional(),
18481
18565
  repository: string2().min(1).describe('The owner/name of the repository, e.g. "acme/web".').optional(),
18482
- resolutionRunMode: resolutionRunModeSchema.optional().describe('Required when aiTaskId names a promotion conflict resolution task: why it runs flows. "confirm-after" confirms a finished resolution before it is submitted.'),
18566
+ resolutionRunMode: resolutionRunModeSchema.optional().describe('Required when aiTaskId names a promotion conflict resolution task: why it runs flows. "confirm-after" confirms a finished resolution before it is submitted; "choose-version" runs one version of an undecided path to choose between them.'),
18483
18567
  workspaceId: workspaceForEnvironmentRef(ids.workspace)
18484
18568
  }).and(makeFlowSelectionSchema(ids)).refine((value) => !(value.aiTaskId && value.chatSessionId), {
18485
18569
  message: "Provide at most one of aiTaskId and chatSessionId: a task already implies its own chat session.",
@@ -18971,6 +19055,7 @@ var journalEntrySchema = object({
18971
19055
  }));
18972
19056
  var knownJournalStreams = [
18973
19057
  "console",
19058
+ "network",
18974
19059
  "recorder",
18975
19060
  "run-events",
18976
19061
  "run-logs",
@@ -20839,7 +20924,10 @@ var makeFindEnvironmentsContract = (ids) => {
20839
20924
  });
20840
20925
  const output = object({
20841
20926
  defaultEnvironmentId: ids.environment.describe("The id of the workspace's default environment."),
20842
- environments: array(makeEnvironmentResourceSchema(ids)).describe("The team's environments, newest first."),
20927
+ environments: array(makeEnvironmentResourceSchema(ids).extend({
20928
+ flowCount: number2().int().nonnegative().optional().describe("The number of active and draft flows at the latest reconciled commit, when available."),
20929
+ testCount: number2().int().nonnegative().optional().describe("The number of tests in those flows, when available. One flow can contain several tests.")
20930
+ })).describe("The team's environments, newest first."),
20843
20931
  nextCursor: nextCursorSchema
20844
20932
  });
20845
20933
  return {
@@ -21682,8 +21770,12 @@ var issueCommentAuthorSchema = discriminatedUnion("type", [
21682
21770
  }),
21683
21771
  object({ type: literal("former-user") }),
21684
21772
  object({ type: literal("team-api-key") }),
21685
- object({ type: literal("system") })
21686
- ]).describe("Who wrote the comment: a person, a person whose account was since deleted (`former-user`), an API key of the team or its organization (`team-api-key`), or QA Wolf itself (`system`).");
21773
+ object({ type: literal("system") }),
21774
+ object({
21775
+ name: string2().optional().describe("Their name in Slack. Absent when Slack could not say."),
21776
+ type: literal("slack-user")
21777
+ })
21778
+ ]).describe("Who wrote the comment: a person, a person whose account was since deleted (`former-user`), an API key of the team or its organization (`team-api-key`), QA Wolf itself (`system`), or someone who replied in the bug's Slack thread whom QA Wolf could not match to a member of the team (`slack-user`).");
21687
21779
  var makeIssueCommentResourceSchema = (ids) => resource({
21688
21780
  author: issueCommentAuthorSchema,
21689
21781
  body: string2().describe("The comment in GitHub-flavored Markdown."),
@@ -21783,35 +21875,6 @@ var makeCreateIssueContract = (ids) => {
21783
21875
  };
21784
21876
  };
21785
21877
 
21786
- // node_modules/@qawolf/api-contracts/dist/v1/issue/decideSuggestion.js
21787
- var makeDecideSuggestionContract = (ids) => {
21788
- const input = object({
21789
- decision: _enum(["add", "report", "skip", "undo", "activate"]).describe("add: turn on the suggested flow. report: file the potential bug. skip: decline the suggestion. undo: take back an add, report or skip before the flow joins. activate: retry a suggestion that QA Wolf held."),
21790
- issueId: ids.issue.describe("The coverage request or bug report that QA Wolf opened for a suggestion."),
21791
- skipReason: _enum(["not-worth-testing", "already-covered", "feature-removed"]).optional().describe("Why the suggestion is skipped. Required for skip.")
21792
- }).refine(({ decision, skipReason }) => decision !== "skip" || skipReason !== undefined, { message: "skipReason is required when the decision is skip." });
21793
- const output = object({
21794
- issue: makeIssueResourceSchema(ids)
21795
- });
21796
- return {
21797
- annotationJustifications: {
21798
- destructiveHint: "Every decision can be undone until the flow joins, and nothing is deleted.",
21799
- openWorldHint: "An added suggestion writes its flow to the environment's flow code repository.",
21800
- readOnlyHint: "Records a decision on a suggestion and changes the issue's status."
21801
- },
21802
- annotations: {
21803
- destructiveHint: false,
21804
- openWorldHint: true,
21805
- readOnlyHint: false
21806
- },
21807
- description: "Decide a coverage request or bug report that QA Wolf suggested after exploring an environment. " + "Add turns on the suggested flow in the environment. Report files a potential bug. " + "Skip declines the suggestion. Undo takes back a decision before the flow joins. " + "The issue's status follows the decision, so change the status only through this tool while the suggestion is undecided.",
21808
- input,
21809
- kind: "write",
21810
- name: "issue.decideSuggestion",
21811
- output
21812
- };
21813
- };
21814
-
21815
21878
  // node_modules/@qawolf/api-contracts/dist/v1/issue/listActivity.js
21816
21879
  var issueActivityTypeSchema = _enum([
21817
21880
  "created",
@@ -21965,7 +22028,6 @@ var makeIssueContracts = (ids) => ({
21965
22028
  attachFiles: makeAttachFilesToIssueContract(ids),
21966
22029
  comment: makeCommentOnIssueContract(ids),
21967
22030
  create: makeCreateIssueContract(ids),
21968
- decideSuggestion: makeDecideSuggestionContract(ids),
21969
22031
  find: makeFindIssuesContract(ids),
21970
22032
  get: makeGetIssueContract(ids),
21971
22033
  listActivity: makeListIssueActivityContract(ids),
@@ -22301,6 +22363,21 @@ var makeFindRunsContract = (ids) => {
22301
22363
  };
22302
22364
  };
22303
22365
 
22366
+ // node_modules/@qawolf/api-contracts/dist/v1/run/alertNotifications.js
22367
+ var slackChannelDestinationSchema = object({
22368
+ channelId: string2().min(1).describe("The Slack channel's id."),
22369
+ kind: literal("slack-channel"),
22370
+ workspaceId: string2().min(1).describe("The Slack workspace the channel is in (Slack's team id), not a QA Wolf workspace.")
22371
+ });
22372
+ var runAlertNotificationSchema = object({
22373
+ channel: _enum(["slack"]).describe("The kind of channel the alert was sent on."),
22374
+ destination: discriminatedUnion("kind", [slackChannelDestinationSchema]).describe("Where on the channel the alert went."),
22375
+ messageId: string2().describe("The alert's message at that destination. In Slack this is the message's `ts`: pass it as `thread_ts` to reply in the alert's thread."),
22376
+ permalink: string2().optional().describe("Link to the message. Absent for the moment between sending and the provider returning one."),
22377
+ sentAt: exports_iso.datetime().describe("When the alert's message was sent. In Slack this is the time in its `ts`, which stays the same when QA Wolf later updates the message.")
22378
+ });
22379
+ var runAlertNotificationsSchema = array(runAlertNotificationSchema).describe("Where QA Wolf sent this run's alert, oldest first. Empty when it was not sent anywhere. Lists only destinations your team can see: your own Slack's channels, and QA Wolf's channels shared through Slack Connect. A destination QA Wolf could not check with Slack just now is left out, so if an entry you expect is missing, ask again later.");
22380
+
22304
22381
  // node_modules/@qawolf/api-contracts/dist/v1/run/flowAttempts.js
22305
22382
  var makeFlowAttemptsSchema = (ids) => {
22306
22383
  const artifactUrls = {
@@ -22354,6 +22431,10 @@ var makeFlowAttemptsSchema = (ids) => {
22354
22431
 
22355
22432
  // node_modules/@qawolf/api-contracts/dist/v1/run/flowFailure.js
22356
22433
  var makeFlowFailureSchema = (ids) => {
22434
+ const blockedBy = array(object({
22435
+ flowId: ids.flow,
22436
+ name: string2()
22437
+ })).min(1).optional().describe("Present when the flow never started because flows it depends on " + "failed in this run. This flow has no failure of its own: the " + "named flows' failures explain it, and it runs again in the next " + "run after those flows pass.");
22357
22438
  const diagnosis = object({
22358
22439
  issueId: ids.issue,
22359
22440
  type: _enum(["bug", "maintenance"])
@@ -22362,6 +22443,7 @@ var makeFlowFailureSchema = (ids) => {
22362
22443
  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.")
22363
22444
  }).optional().describe('Present when the failure was marked "do not investigate" (DNI): ' + "it will get no bug or maintenance verdict.");
22364
22445
  return object({
22446
+ blockedBy,
22365
22447
  diagnosis,
22366
22448
  error: string2(),
22367
22449
  optedOutOfInvestigation
@@ -22427,9 +22509,10 @@ var makeGetRunContract = (ids) => {
22427
22509
  const output = resource({
22428
22510
  ...makeRunSummaryFields(ids),
22429
22511
  blockingBugCount: number2().int().nonnegative().describe("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."),
22430
- builds: array(makeBuildResourceSchema(ids)).describe("The builds the run installs, one per app and platform. Empty when the run has none."),
22512
+ builds: array(makeBuildResourceSchema(ids)).describe("The builds the run got that its flows installed, one per app and platform: a build counts once a finished or stopped attempt reported installing it. Empty while no attempt has, and when the run got none. `buildVersions[].expected` names the build the run got for each app."),
22431
22513
  buildVersions: array(runBuildVersionSchema).describe("The apps the run's attempts installed, one per app and platform, with warnings. Empty when no attempt reported an install and the run has no builds."),
22432
22514
  flows,
22515
+ runAlertNotifications: runAlertNotificationsSchema,
22433
22516
  runId: ids.run.describe("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."),
22434
22517
  siteVersions: array(runSiteVersionSchema).describe("The versions the run's attempts saw on each site origin, with warnings. Empty when no attempt reported one."),
22435
22518
  waitSeconds: number2().int().optional().describe("The hold this check was allowed, in seconds, after clamping. Absent when the check did not wait."),
@@ -23143,6 +23226,130 @@ var makeSkillContracts = () => ({
23143
23226
  list: makeListSkillsContract()
23144
23227
  });
23145
23228
 
23229
+ // node_modules/@qawolf/api-contracts/dist/v1/suggestion/resource.js
23230
+ var suggestionStateSchema = _enum(["waiting", "accepted", "skipped", "expired"]).describe("waiting (QA Wolf proposed it and nobody has decided yet), accepted (someone added the flow or reported the bug; it stays accepted while the flow joins, is held, or is being undone), skipped (someone declined it), expired (nobody decided it in time).");
23231
+ var suggestionDecisionSchema = _enum(["add", "report", "skip", "undo", "activate"]).describe("add: turn on the suggested flow. report: file the potential bug. skip: decline the suggestion. undo: take back an add, report or skip. activate: retry a held suggestion.");
23232
+ var suggestionSkipReasonSchema = _enum(["not-worth-testing", "already-covered", "feature-removed"]).describe("Why the suggestion was skipped.");
23233
+ var makeSuggestionResourceSchema = (ids) => resource({
23234
+ decidedAt: exports_iso.datetime().optional().describe("When someone last decided the suggestion. Absent while it is waiting."),
23235
+ decisions: array(suggestionDecisionSchema).describe("The decisions suggestion.decide takes for this suggestion now. Empty when it takes none."),
23236
+ environmentId: ids.environment.describe("The environment QA Wolf explored when it made the suggestion."),
23237
+ environmentName: string2(),
23238
+ flow: object({
23239
+ flowId: ids.flow.optional().describe("The flow, once it joined the environment."),
23240
+ path: string2().describe("Where the proposed flow lives in the environment's flow code.")
23241
+ }).describe("The flow QA Wolf proposes. For a potential bug, the flow that stopped at the bug."),
23242
+ holdReason: _enum([
23243
+ "path-taken",
23244
+ "not-proven-on-merged-commit",
23245
+ "merge-conflicted",
23246
+ "undo-cleanup-failed"
23247
+ ]).optional().describe("Why QA Wolf held an accepted suggestion. activate retries it once the cause is gone."),
23248
+ issue: object({
23249
+ issueId: ids.issue,
23250
+ type: _enum(["bug", "coverageRequest"])
23251
+ }).optional().describe("The bug report or coverage request behind the suggestion, which the issue tools read. Absent when there is none."),
23252
+ kind: _enum(["new-flow", "potential-bug"]).describe("new-flow: QA Wolf wrote a flow for coverage that is missing. potential-bug: the flow it wrote stopped at what looks like a bug."),
23253
+ location: string2().describe("Where in the app the suggestion applies."),
23254
+ reason: string2().describe("Why QA Wolf suggests it."),
23255
+ skipReason: suggestionSkipReasonSchema.optional().describe("Why the suggestion was skipped. Present when skipped."),
23256
+ state: suggestionStateSchema,
23257
+ suggestedAt: exports_iso.datetime().describe("When QA Wolf suggested it."),
23258
+ suggestionId: ids.suggestion.describe("The suggestion's id, which suggestion.get and suggestion.decide take."),
23259
+ title: string2()
23260
+ }, {
23261
+ urlFieldDescription: "Absolute URL of the suggestion on the workspace's Suggested page."
23262
+ });
23263
+
23264
+ // node_modules/@qawolf/api-contracts/dist/v1/suggestion/decide.js
23265
+ var makeDecideSuggestionContract = (ids) => {
23266
+ const input = object({
23267
+ decision: suggestionDecisionSchema,
23268
+ skipReason: suggestionSkipReasonSchema.optional().describe("Why the suggestion is skipped. Required for skip."),
23269
+ suggestionId: ids.suggestion.describe("The id of the coverage suggestion, from suggestion.find or a new suggestions notification.")
23270
+ }).refine(({ decision, skipReason }) => decision !== "skip" || skipReason !== undefined, { message: "skipReason is required when the decision is skip." });
23271
+ const output = object({ suggestion: makeSuggestionResourceSchema(ids) });
23272
+ return {
23273
+ annotationJustifications: {
23274
+ destructiveHint: "Every decision can be undone until the flow joins, and nothing is deleted.",
23275
+ openWorldHint: "An added suggestion writes its flow to the environment's flow code repository.",
23276
+ readOnlyHint: "Records a decision on a suggestion and changes its linked issue's status."
23277
+ },
23278
+ annotations: {
23279
+ destructiveHint: false,
23280
+ openWorldHint: true,
23281
+ readOnlyHint: false
23282
+ },
23283
+ description: "Decide a coverage suggestion QA Wolf made while exploring an environment, as the signed-in person. " + "Add turns on the suggested flow in the environment. Report files the potential bug. Skip declines the suggestion and needs a skipReason. " + "Undo takes back a decision. Activate retries a held suggestion. Only the decisions suggestion.get lists take effect. " + "Use this, not issue.update, to accept or skip a suggestion.",
23284
+ input,
23285
+ kind: "write",
23286
+ name: "suggestion.decide",
23287
+ output
23288
+ };
23289
+ };
23290
+
23291
+ // node_modules/@qawolf/api-contracts/dist/v1/suggestion/find.js
23292
+ var makeFindSuggestionsContract = (ids) => {
23293
+ const input = object({
23294
+ state: _enum(["waiting", "accepted", "skipped"]).optional().describe("Only list suggestions in this state. Use waiting to find the ones that need a decision. Omit to list all three."),
23295
+ workspaceId: ids.workspace.optional().describe("The workspace whose suggestions to list. Required when authenticating with an organization or user API key."),
23296
+ ...makePaginationInputFields({ defaultLimit: 20, maxLimit: 100 })
23297
+ });
23298
+ const output = object({
23299
+ nextCursor: nextCursorSchema,
23300
+ suggestions: array(makeSuggestionResourceSchema(ids)).describe("The workspace's coverage suggestions, newest first.")
23301
+ });
23302
+ return {
23303
+ annotationJustifications: {
23304
+ destructiveHint: "Does not decide or change any suggestion.",
23305
+ openWorldHint: "Reads QA Wolf suggestion records without changing external systems.",
23306
+ readOnlyHint: "Lists the workspace's coverage suggestions."
23307
+ },
23308
+ annotations: {
23309
+ destructiveHint: false,
23310
+ openWorldHint: false,
23311
+ readOnlyHint: true
23312
+ },
23313
+ description: "List the coverage QA Wolf suggested for a workspace, newest first: flows it wrote for missing coverage and potential bugs it found while exploring an environment. " + "Use this, not issue.find, for QA Wolf's suggestions, such as the ones a new suggestions notification points to. Filter by state waiting to find the ones that need a decision.",
23314
+ input,
23315
+ kind: "read",
23316
+ name: "suggestion.find",
23317
+ output
23318
+ };
23319
+ };
23320
+
23321
+ // node_modules/@qawolf/api-contracts/dist/v1/suggestion/get.js
23322
+ var makeGetSuggestionContract = (ids) => {
23323
+ const input = object({
23324
+ suggestionId: ids.suggestion.describe("The id of the coverage suggestion, from suggestion.find or a new suggestions notification.")
23325
+ });
23326
+ const output = object({ suggestion: makeSuggestionResourceSchema(ids) });
23327
+ return {
23328
+ annotationJustifications: {
23329
+ destructiveHint: "Does not decide or change the suggestion.",
23330
+ openWorldHint: "Reads a QA Wolf suggestion record without changing external systems.",
23331
+ readOnlyHint: "Retrieves one coverage suggestion."
23332
+ },
23333
+ annotations: {
23334
+ destructiveHint: false,
23335
+ openWorldHint: false,
23336
+ readOnlyHint: true
23337
+ },
23338
+ description: "Read one coverage suggestion QA Wolf made while exploring an environment: its state, the flow it proposes, the bug report or coverage request behind it, and the decisions it takes now. " + "Use this, not issue.get, for a suggestion id. A suggestion QA Wolf withdrew reads as not found.",
23339
+ input,
23340
+ kind: "read",
23341
+ name: "suggestion.get",
23342
+ output
23343
+ };
23344
+ };
23345
+
23346
+ // node_modules/@qawolf/api-contracts/dist/v1/suggestion/index.js
23347
+ var makeSuggestionContracts = (ids) => ({
23348
+ decide: makeDecideSuggestionContract(ids),
23349
+ find: makeFindSuggestionsContract(ids),
23350
+ get: makeGetSuggestionContract(ids)
23351
+ });
23352
+
23146
23353
  // node_modules/@qawolf/api-contracts/dist/v1/tag/list.js
23147
23354
  var makeListTagsContract = (ids) => {
23148
23355
  const input = object({
@@ -23181,7 +23388,8 @@ var makeContractsV1 = (ids) => {
23181
23388
  const resolvedIds = {
23182
23389
  ...defaultIdSchemas,
23183
23390
  ...ids,
23184
- runAttempt: ids.runAttempt ?? defaultIdSchemas.runAttempt
23391
+ runAttempt: ids.runAttempt ?? defaultIdSchemas.runAttempt,
23392
+ suggestion: ids.suggestion ?? defaultIdSchemas.suggestion
23185
23393
  };
23186
23394
  return {
23187
23395
  activity: {
@@ -23252,6 +23460,7 @@ var makeContractsV1 = (ids) => {
23252
23460
  },
23253
23461
  runner: makeRunnerContracts(resolvedIds),
23254
23462
  skill: makeSkillContracts(),
23463
+ suggestion: makeSuggestionContracts(resolvedIds),
23255
23464
  tag: {
23256
23465
  create: makeCreateTagContract(resolvedIds),
23257
23466
  list: makeListTagsContract(resolvedIds)
@@ -25764,7 +25973,7 @@ function startUpdateCheck(deps) {
25764
25973
  // package.json
25765
25974
  var package_default = {
25766
25975
  name: "@qawolf/cli",
25767
- version: "2.10.0",
25976
+ version: "2.12.0",
25768
25977
  description: "Run and manage QA Wolf flows from the terminal, CI, or an AI agent",
25769
25978
  keywords: [
25770
25979
  "automation",
@@ -25836,7 +26045,7 @@ var package_default = {
25836
26045
  "@clack/prompts": "1.5.1",
25837
26046
  "@napi-rs/keyring": "1.3.0",
25838
26047
  "@oxc-node/core": "0.1.0",
25839
- "@qawolf/api-contracts": "0.130.0",
26048
+ "@qawolf/api-contracts": "0.134.0",
25840
26049
  "@qawolf/emails": "1.1.1",
25841
26050
  "@qawolf/flow-targets": "2.0.0",
25842
26051
  commander: "14.0.3",
@@ -41971,7 +42180,7 @@ A sequence exits by the worst thing that happened to any one of its actions: an
41971
42180
  // src/commands/runner/guides/events.txt
41972
42181
  var events_default = `# Streams
41973
42182
 
41974
- Everything observable is an append-only stream on the pod, read by cursor or tail rather than subscribed to, so attaching late still gets you the history that is still there. QA Wolf writes recorder, console, run-events, run-logs and run-status; a stream nobody has written reads as empty rather than as an error, and a stream this CLI version does not know about is still readable by name. One payload per line, so shell tools compose:
42183
+ Everything observable is an append-only stream on the pod, read by cursor or tail rather than subscribed to, so attaching late still gets you the history that is still there. QA Wolf writes recorder, console, network, run-events, run-logs and run-status; a stream nobody has written reads as empty rather than as an error, and a stream this CLI version does not know about is still readable by name. One payload per line, so shell tools compose:
41975
42184
 
41976
42185
  $ qawolf runner events console --tail 20 | jq -r '.message'
41977
42186
  $ qawolf runner events run-logs --run <runId> --follow > run.log
@@ -44450,4 +44659,4 @@ createProgram({ signals }).parseAsync().catch(() => {
44450
44659
  process.exitCode = 1;
44451
44660
  }).finally(() => exitWhenIdle(typeof process.exitCode === "number" ? process.exitCode : 0));
44452
44661
 
44453
- //# debugId=607AD2DAA196641B64756E2164756E21
44662
+ //# debugId=36A5EEFD853AC29364756E2164756E21
@@ -8138,8 +8138,41 @@ function resource(fields, { urlFieldDescription = "Absolute URL." } = {}) {
8138
8138
  });
8139
8139
  }
8140
8140
 
8141
+ // node_modules/@qawolf/api-contracts/dist/v1/promotion/decision.js
8142
+ var promotionDecisionTypeSchema = _enum(["picked-by-run", "combined", "kept-more-checks", "needs-person"]).describe("picked-by-run (exactly one version passed, so it was kept), combined (every version passed and they check different things, so they were merged), kept-more-checks (every version passed and one checks more, so it was kept), needs-person (every version failed or the runs could not tell them apart, so a person decides).");
8143
+ var promotionCandidateSchema = _enum(["head", "base", "combined"]).describe("head (the head environment's version), base (the base environment's version), combined (the resolver's combination of the two).");
8144
+ var promotionCandidateOutcomeSchema = _enum(["passed", "failed", "inconclusive"]).describe("How the version did in its run. inconclusive: it passed in some attempts and failed in others, or the run did not finish.");
8145
+ var makePromotionDecisionSchema = (ids) => object({
8146
+ candidateRuns: array(object({
8147
+ candidate: promotionCandidateSchema,
8148
+ outcome: promotionCandidateOutcomeSchema,
8149
+ runId: ids.run
8150
+ })).describe("The run of each version the decision relied on."),
8151
+ kept: promotionCandidateSchema.optional().describe("The version kept. Present for picked-by-run and kept-more-checks."),
8152
+ path: string2().describe("The conflicting path this decision is about."),
8153
+ reason: string2().describe("Why, in a sentence or two a person can read."),
8154
+ sourceCommitHash: string2().describe("The head commit of the conflict this decision was made for."),
8155
+ targetCommitHash: string2().describe("The base commit of the conflict this decision was made for."),
8156
+ type: promotionDecisionTypeSchema
8157
+ });
8158
+
8159
+ // node_modules/@qawolf/api-contracts/dist/v1/promotion/needsPerson.js
8160
+ var promotionNeedsPersonReasonSchema = _enum([
8161
+ "undecided-paths",
8162
+ "run-limit-reached",
8163
+ "flows-undetermined",
8164
+ "agent-stopped",
8165
+ "agent-failed",
8166
+ "agent-not-started",
8167
+ "agent-resolution-off"
8168
+ ]).describe("undecided-paths (the runs of these paths' versions, if any, left no single answer), run-limit-reached (the resolution agent started as many runs as one conflict allows), flows-undetermined (which flows the conflict affects could not be told, so no resolution could be checked), agent-stopped (the resolution agent finished without submitting; its session says why), agent-failed (the resolution agent failed, timed out or was canceled), agent-not-started (QA Wolf had no user to run the resolution agent as), agent-resolution-off (the workspace does not have QA Wolf resolve conflicts).");
8169
+ var promotionNeedsPersonSchema = object({
8170
+ paths: array(object({ path: string2() })).optional().describe("The paths left undecided. Present for undecided-paths."),
8171
+ reason: promotionNeedsPersonReasonSchema
8172
+ });
8173
+
8141
8174
  // node_modules/@qawolf/api-contracts/dist/v1/promotion/validationRun.js
8142
- var resolutionRunModeSchema = _enum(["confirm-after"]).describe("Why a promotion conflict resolution task runs flows. confirm-after confirms a finished resolution before it is submitted.");
8175
+ var resolutionRunModeSchema = _enum(["confirm-after", "choose-version"]).describe("Why a promotion conflict resolution task runs flows. confirm-after confirms a finished resolution before it is submitted; choose-version runs one version of an undecided path to choose between them.");
8143
8176
  var makePromotionValidationRunSchema = (ids) => object({
8144
8177
  aiTaskId: ids.aiTask.describe("The resolution task that started the run."),
8145
8178
  runId: ids.run,
@@ -8167,8 +8200,10 @@ var makePromotionResourceSchema = (ids) => resource({
8167
8200
  baseEnvironmentId: ids.environment.describe("The environment the flow changes promote into."),
8168
8201
  conflict: conflictSchema.optional().describe("The conflict awaiting resolution. Present while status is conflicted or resolving. A resolution must name both commit hashes and cover exactly these paths; if either branch moves, the conflict is recomputed and this changes."),
8169
8202
  createdAt: exports_iso.datetime().describe("When the promotion was requested."),
8203
+ decisions: array(makePromotionDecisionSchema(ids)).optional().describe("How the resolution agent settled each conflicting path it decided by running the versions, or why it left one for a person. Absent when it reported none."),
8170
8204
  headEnvironmentId: ids.environment.describe("The environment whose flow changes are promoted."),
8171
8205
  id: ids.promotion,
8206
+ needsPerson: promotionNeedsPersonSchema.optional().describe("Present while the current conflict waits on a person, with why. Absent once a resolution is submitted, the conflict is recomputed, or the promotion settles."),
8172
8207
  promotedCommitHash: string2().optional().describe("The commit the promotion landed on the base environment's flow code branch. Present when status is promoted."),
8173
8208
  settledAt: exports_iso.datetime().optional().describe("When the promotion reached promoted, no-changes or abandoned. Absent while it is open."),
8174
8209
  status: promotionStatusSchema,
@@ -8231,6 +8266,53 @@ var makeGetPromotionContract = (ids) => {
8231
8266
  };
8232
8267
  };
8233
8268
 
8269
+ // node_modules/@qawolf/api-contracts/dist/v1/promotion/reportDecision.js
8270
+ var keptIsRequiredFor = new Set(["kept-more-checks", "picked-by-run"]);
8271
+ var makeReportPromotionDecisionContract = (ids) => {
8272
+ const candidateRun = (version) => object({
8273
+ outcome: promotionCandidateOutcomeSchema,
8274
+ runId: ids.run.describe(`The run of ${version}, started for this promotion's resolution.`)
8275
+ }).optional().describe(`How ${version} did when it ran. Omit when it did not run.`);
8276
+ const input = object({
8277
+ base: candidateRun("the base environment's version"),
8278
+ combined: candidateRun("the resolver's combination of both versions"),
8279
+ decision: promotionDecisionTypeSchema,
8280
+ expectedSourceCommitHash: string2().min(1).describe("conflict.sourceCommitHash from promotion.get. A different current commit means the branch moved and the call is refused."),
8281
+ expectedTargetCommitHash: string2().min(1).describe("conflict.targetCommitHash from promotion.get. A different current commit means the branch moved and the call is refused."),
8282
+ head: candidateRun("the head environment's version"),
8283
+ kept: promotionCandidateSchema.optional().describe("The version kept: required for picked-by-run and kept-more-checks (head or base), omitted otherwise."),
8284
+ path: string2().min(1).max(1024).describe("One of the promotion's conflicting paths."),
8285
+ promotionId: ids.promotion,
8286
+ reason: string2().min(1).max(1000).describe("Why, in a sentence or two a person can read: what was kept and what the runs showed, or what is undecided.")
8287
+ }).superRefine(({ decision, kept }, refinement) => {
8288
+ if (keptIsRequiredFor.has(decision) === (kept !== undefined))
8289
+ return;
8290
+ refinement.addIssue({
8291
+ code: "custom",
8292
+ message: keptIsRequiredFor.has(decision) ? `${decision} needs the version it kept.` : `${decision} keeps no single version; omit kept.`,
8293
+ path: ["kept"]
8294
+ });
8295
+ });
8296
+ const output = makePromotionResourceSchema(ids);
8297
+ return {
8298
+ annotationJustifications: {
8299
+ destructiveHint: "Records a decision on the promotion and changes no flow code.",
8300
+ openWorldHint: "Changes a private QA Wolf promotion record without touching external systems.",
8301
+ readOnlyHint: "Records how a conflicting path was settled."
8302
+ },
8303
+ annotations: {
8304
+ destructiveHint: false,
8305
+ openWorldHint: false,
8306
+ readOnlyHint: false
8307
+ },
8308
+ description: "Record how one conflicting path of a conflicted promotion was settled by running its versions, or why it is left for a person, with the run of each version. Exactly one passing version is kept (picked-by-run); when every version passed, they are combined or the one with more checks is kept; a person is asked only when every version failed or the runs could not tell them apart. Every run must have been started for this promotion's resolution. Reporting a path again replaces its decision. Returns the promotion.",
8309
+ input,
8310
+ kind: "write",
8311
+ name: "promotion.reportDecision",
8312
+ output
8313
+ };
8314
+ };
8315
+
8234
8316
  // node_modules/@qawolf/api-contracts/dist/v1/promotion/resolve.js
8235
8317
  var maxResolvedFileBytes = 1e6;
8236
8318
  var utf8ByteLength = (content) => new TextEncoder().encode(content).byteLength;
@@ -8261,7 +8343,7 @@ var makeResolvePromotionContract = (ids) => {
8261
8343
  openWorldHint: false,
8262
8344
  readOnlyHint: false
8263
8345
  },
8264
- description: "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.",
8346
+ description: "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. If the base environment has been terminated, the call is refused as target-environment-gone and the promotion can no longer be resolved. Returns the promotion in resolving; poll promotion.get until it is promoted, or conflicted again if the branches moved while it applied.",
8265
8347
  input,
8266
8348
  kind: "write",
8267
8349
  name: "promotion.resolve",
@@ -8273,6 +8355,7 @@ var makeResolvePromotionContract = (ids) => {
8273
8355
  var makePromotionContracts = (ids) => ({
8274
8356
  find: makeFindPromotionsContract(ids),
8275
8357
  get: makeGetPromotionContract(ids),
8358
+ reportDecision: makeReportPromotionDecisionContract(ids),
8276
8359
  resolve: makeResolvePromotionContract(ids)
8277
8360
  });
8278
8361
 
@@ -8594,6 +8677,7 @@ var defaultIdSchemas = {
8594
8677
  promotion: string2().min(1).describe("The id of the promotion, from promotion.find or environment.promote."),
8595
8678
  run: string2().min(1).describe("The id of the run."),
8596
8679
  runAttempt: string2().min(1).describe("The id of the run attempt."),
8680
+ suggestion: string2().min(1).describe("The id of the coverage suggestion, from suggestion.find or a new suggestions notification."),
8597
8681
  trigger: string2().min(1).describe("The id of the trigger."),
8598
8682
  workspace: string2().min(1).describe("The id of the workspace.")
8599
8683
  };
@@ -8665,7 +8749,7 @@ var makeCreateRunContract = (ids) => {
8665
8749
  investigateFailures: boolean2().optional().describe("Whether QA Wolf investigates failures in this run. False disables automatic AI Investigation for this run, including PR-testing runs. Omission or true follows the existing policy and never forces investigation. Uninvestigated failures fail associated commit checks."),
8666
8750
  pullRequestNumber: number2().int().positive().describe("The number of the pull request to associate with the run.").optional(),
8667
8751
  repository: string2().min(1).describe('The owner/name of the repository, e.g. "acme/web".').optional(),
8668
- resolutionRunMode: resolutionRunModeSchema.optional().describe('Required when aiTaskId names a promotion conflict resolution task: why it runs flows. "confirm-after" confirms a finished resolution before it is submitted.'),
8752
+ resolutionRunMode: resolutionRunModeSchema.optional().describe('Required when aiTaskId names a promotion conflict resolution task: why it runs flows. "confirm-after" confirms a finished resolution before it is submitted; "choose-version" runs one version of an undecided path to choose between them.'),
8669
8753
  workspaceId: workspaceForEnvironmentRef(ids.workspace)
8670
8754
  }).and(makeFlowSelectionSchema(ids)).refine((value) => !(value.aiTaskId && value.chatSessionId), {
8671
8755
  message: "Provide at most one of aiTaskId and chatSessionId: a task already implies its own chat session.",
@@ -9161,6 +9245,7 @@ var journalEntrySchema = object({
9161
9245
  }));
9162
9246
  var knownJournalStreams = [
9163
9247
  "console",
9248
+ "network",
9164
9249
  "recorder",
9165
9250
  "run-events",
9166
9251
  "run-logs",
@@ -11031,7 +11116,10 @@ var makeFindEnvironmentsContract = (ids) => {
11031
11116
  });
11032
11117
  const output = object({
11033
11118
  defaultEnvironmentId: ids.environment.describe("The id of the workspace's default environment."),
11034
- environments: array(makeEnvironmentResourceSchema(ids)).describe("The team's environments, newest first."),
11119
+ environments: array(makeEnvironmentResourceSchema(ids).extend({
11120
+ flowCount: number2().int().nonnegative().optional().describe("The number of active and draft flows at the latest reconciled commit, when available."),
11121
+ testCount: number2().int().nonnegative().optional().describe("The number of tests in those flows, when available. One flow can contain several tests.")
11122
+ })).describe("The team's environments, newest first."),
11035
11123
  nextCursor: nextCursorSchema
11036
11124
  });
11037
11125
  return {
@@ -11874,8 +11962,12 @@ var issueCommentAuthorSchema = discriminatedUnion("type", [
11874
11962
  }),
11875
11963
  object({ type: literal("former-user") }),
11876
11964
  object({ type: literal("team-api-key") }),
11877
- object({ type: literal("system") })
11878
- ]).describe("Who wrote the comment: a person, a person whose account was since deleted (`former-user`), an API key of the team or its organization (`team-api-key`), or QA Wolf itself (`system`).");
11965
+ object({ type: literal("system") }),
11966
+ object({
11967
+ name: string2().optional().describe("Their name in Slack. Absent when Slack could not say."),
11968
+ type: literal("slack-user")
11969
+ })
11970
+ ]).describe("Who wrote the comment: a person, a person whose account was since deleted (`former-user`), an API key of the team or its organization (`team-api-key`), QA Wolf itself (`system`), or someone who replied in the bug's Slack thread whom QA Wolf could not match to a member of the team (`slack-user`).");
11879
11971
  var makeIssueCommentResourceSchema = (ids) => resource({
11880
11972
  author: issueCommentAuthorSchema,
11881
11973
  body: string2().describe("The comment in GitHub-flavored Markdown."),
@@ -11975,35 +12067,6 @@ var makeCreateIssueContract = (ids) => {
11975
12067
  };
11976
12068
  };
11977
12069
 
11978
- // node_modules/@qawolf/api-contracts/dist/v1/issue/decideSuggestion.js
11979
- var makeDecideSuggestionContract = (ids) => {
11980
- const input = object({
11981
- decision: _enum(["add", "report", "skip", "undo", "activate"]).describe("add: turn on the suggested flow. report: file the potential bug. skip: decline the suggestion. undo: take back an add, report or skip before the flow joins. activate: retry a suggestion that QA Wolf held."),
11982
- issueId: ids.issue.describe("The coverage request or bug report that QA Wolf opened for a suggestion."),
11983
- skipReason: _enum(["not-worth-testing", "already-covered", "feature-removed"]).optional().describe("Why the suggestion is skipped. Required for skip.")
11984
- }).refine(({ decision, skipReason }) => decision !== "skip" || skipReason !== undefined, { message: "skipReason is required when the decision is skip." });
11985
- const output = object({
11986
- issue: makeIssueResourceSchema(ids)
11987
- });
11988
- return {
11989
- annotationJustifications: {
11990
- destructiveHint: "Every decision can be undone until the flow joins, and nothing is deleted.",
11991
- openWorldHint: "An added suggestion writes its flow to the environment's flow code repository.",
11992
- readOnlyHint: "Records a decision on a suggestion and changes the issue's status."
11993
- },
11994
- annotations: {
11995
- destructiveHint: false,
11996
- openWorldHint: true,
11997
- readOnlyHint: false
11998
- },
11999
- description: "Decide a coverage request or bug report that QA Wolf suggested after exploring an environment. " + "Add turns on the suggested flow in the environment. Report files a potential bug. " + "Skip declines the suggestion. Undo takes back a decision before the flow joins. " + "The issue's status follows the decision, so change the status only through this tool while the suggestion is undecided.",
12000
- input,
12001
- kind: "write",
12002
- name: "issue.decideSuggestion",
12003
- output
12004
- };
12005
- };
12006
-
12007
12070
  // node_modules/@qawolf/api-contracts/dist/v1/issue/listActivity.js
12008
12071
  var issueActivityTypeSchema = _enum([
12009
12072
  "created",
@@ -12157,7 +12220,6 @@ var makeIssueContracts = (ids) => ({
12157
12220
  attachFiles: makeAttachFilesToIssueContract(ids),
12158
12221
  comment: makeCommentOnIssueContract(ids),
12159
12222
  create: makeCreateIssueContract(ids),
12160
- decideSuggestion: makeDecideSuggestionContract(ids),
12161
12223
  find: makeFindIssuesContract(ids),
12162
12224
  get: makeGetIssueContract(ids),
12163
12225
  listActivity: makeListIssueActivityContract(ids),
@@ -12493,6 +12555,21 @@ var makeFindRunsContract = (ids) => {
12493
12555
  };
12494
12556
  };
12495
12557
 
12558
+ // node_modules/@qawolf/api-contracts/dist/v1/run/alertNotifications.js
12559
+ var slackChannelDestinationSchema = object({
12560
+ channelId: string2().min(1).describe("The Slack channel's id."),
12561
+ kind: literal("slack-channel"),
12562
+ workspaceId: string2().min(1).describe("The Slack workspace the channel is in (Slack's team id), not a QA Wolf workspace.")
12563
+ });
12564
+ var runAlertNotificationSchema = object({
12565
+ channel: _enum(["slack"]).describe("The kind of channel the alert was sent on."),
12566
+ destination: discriminatedUnion("kind", [slackChannelDestinationSchema]).describe("Where on the channel the alert went."),
12567
+ messageId: string2().describe("The alert's message at that destination. In Slack this is the message's `ts`: pass it as `thread_ts` to reply in the alert's thread."),
12568
+ permalink: string2().optional().describe("Link to the message. Absent for the moment between sending and the provider returning one."),
12569
+ sentAt: exports_iso.datetime().describe("When the alert's message was sent. In Slack this is the time in its `ts`, which stays the same when QA Wolf later updates the message.")
12570
+ });
12571
+ var runAlertNotificationsSchema = array(runAlertNotificationSchema).describe("Where QA Wolf sent this run's alert, oldest first. Empty when it was not sent anywhere. Lists only destinations your team can see: your own Slack's channels, and QA Wolf's channels shared through Slack Connect. A destination QA Wolf could not check with Slack just now is left out, so if an entry you expect is missing, ask again later.");
12572
+
12496
12573
  // node_modules/@qawolf/api-contracts/dist/v1/run/flowAttempts.js
12497
12574
  var makeFlowAttemptsSchema = (ids) => {
12498
12575
  const artifactUrls = {
@@ -12546,6 +12623,10 @@ var makeFlowAttemptsSchema = (ids) => {
12546
12623
 
12547
12624
  // node_modules/@qawolf/api-contracts/dist/v1/run/flowFailure.js
12548
12625
  var makeFlowFailureSchema = (ids) => {
12626
+ const blockedBy = array(object({
12627
+ flowId: ids.flow,
12628
+ name: string2()
12629
+ })).min(1).optional().describe("Present when the flow never started because flows it depends on " + "failed in this run. This flow has no failure of its own: the " + "named flows' failures explain it, and it runs again in the next " + "run after those flows pass.");
12549
12630
  const diagnosis = object({
12550
12631
  issueId: ids.issue,
12551
12632
  type: _enum(["bug", "maintenance"])
@@ -12554,6 +12635,7 @@ var makeFlowFailureSchema = (ids) => {
12554
12635
  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.")
12555
12636
  }).optional().describe('Present when the failure was marked "do not investigate" (DNI): ' + "it will get no bug or maintenance verdict.");
12556
12637
  return object({
12638
+ blockedBy,
12557
12639
  diagnosis,
12558
12640
  error: string2(),
12559
12641
  optedOutOfInvestigation
@@ -12619,9 +12701,10 @@ var makeGetRunContract = (ids) => {
12619
12701
  const output = resource({
12620
12702
  ...makeRunSummaryFields(ids),
12621
12703
  blockingBugCount: number2().int().nonnegative().describe("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."),
12622
- builds: array(makeBuildResourceSchema(ids)).describe("The builds the run installs, one per app and platform. Empty when the run has none."),
12704
+ builds: array(makeBuildResourceSchema(ids)).describe("The builds the run got that its flows installed, one per app and platform: a build counts once a finished or stopped attempt reported installing it. Empty while no attempt has, and when the run got none. `buildVersions[].expected` names the build the run got for each app."),
12623
12705
  buildVersions: array(runBuildVersionSchema).describe("The apps the run's attempts installed, one per app and platform, with warnings. Empty when no attempt reported an install and the run has no builds."),
12624
12706
  flows,
12707
+ runAlertNotifications: runAlertNotificationsSchema,
12625
12708
  runId: ids.run.describe("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."),
12626
12709
  siteVersions: array(runSiteVersionSchema).describe("The versions the run's attempts saw on each site origin, with warnings. Empty when no attempt reported one."),
12627
12710
  waitSeconds: number2().int().optional().describe("The hold this check was allowed, in seconds, after clamping. Absent when the check did not wait."),
@@ -13335,6 +13418,130 @@ var makeSkillContracts = () => ({
13335
13418
  list: makeListSkillsContract()
13336
13419
  });
13337
13420
 
13421
+ // node_modules/@qawolf/api-contracts/dist/v1/suggestion/resource.js
13422
+ var suggestionStateSchema = _enum(["waiting", "accepted", "skipped", "expired"]).describe("waiting (QA Wolf proposed it and nobody has decided yet), accepted (someone added the flow or reported the bug; it stays accepted while the flow joins, is held, or is being undone), skipped (someone declined it), expired (nobody decided it in time).");
13423
+ var suggestionDecisionSchema = _enum(["add", "report", "skip", "undo", "activate"]).describe("add: turn on the suggested flow. report: file the potential bug. skip: decline the suggestion. undo: take back an add, report or skip. activate: retry a held suggestion.");
13424
+ var suggestionSkipReasonSchema = _enum(["not-worth-testing", "already-covered", "feature-removed"]).describe("Why the suggestion was skipped.");
13425
+ var makeSuggestionResourceSchema = (ids) => resource({
13426
+ decidedAt: exports_iso.datetime().optional().describe("When someone last decided the suggestion. Absent while it is waiting."),
13427
+ decisions: array(suggestionDecisionSchema).describe("The decisions suggestion.decide takes for this suggestion now. Empty when it takes none."),
13428
+ environmentId: ids.environment.describe("The environment QA Wolf explored when it made the suggestion."),
13429
+ environmentName: string2(),
13430
+ flow: object({
13431
+ flowId: ids.flow.optional().describe("The flow, once it joined the environment."),
13432
+ path: string2().describe("Where the proposed flow lives in the environment's flow code.")
13433
+ }).describe("The flow QA Wolf proposes. For a potential bug, the flow that stopped at the bug."),
13434
+ holdReason: _enum([
13435
+ "path-taken",
13436
+ "not-proven-on-merged-commit",
13437
+ "merge-conflicted",
13438
+ "undo-cleanup-failed"
13439
+ ]).optional().describe("Why QA Wolf held an accepted suggestion. activate retries it once the cause is gone."),
13440
+ issue: object({
13441
+ issueId: ids.issue,
13442
+ type: _enum(["bug", "coverageRequest"])
13443
+ }).optional().describe("The bug report or coverage request behind the suggestion, which the issue tools read. Absent when there is none."),
13444
+ kind: _enum(["new-flow", "potential-bug"]).describe("new-flow: QA Wolf wrote a flow for coverage that is missing. potential-bug: the flow it wrote stopped at what looks like a bug."),
13445
+ location: string2().describe("Where in the app the suggestion applies."),
13446
+ reason: string2().describe("Why QA Wolf suggests it."),
13447
+ skipReason: suggestionSkipReasonSchema.optional().describe("Why the suggestion was skipped. Present when skipped."),
13448
+ state: suggestionStateSchema,
13449
+ suggestedAt: exports_iso.datetime().describe("When QA Wolf suggested it."),
13450
+ suggestionId: ids.suggestion.describe("The suggestion's id, which suggestion.get and suggestion.decide take."),
13451
+ title: string2()
13452
+ }, {
13453
+ urlFieldDescription: "Absolute URL of the suggestion on the workspace's Suggested page."
13454
+ });
13455
+
13456
+ // node_modules/@qawolf/api-contracts/dist/v1/suggestion/decide.js
13457
+ var makeDecideSuggestionContract = (ids) => {
13458
+ const input = object({
13459
+ decision: suggestionDecisionSchema,
13460
+ skipReason: suggestionSkipReasonSchema.optional().describe("Why the suggestion is skipped. Required for skip."),
13461
+ suggestionId: ids.suggestion.describe("The id of the coverage suggestion, from suggestion.find or a new suggestions notification.")
13462
+ }).refine(({ decision, skipReason }) => decision !== "skip" || skipReason !== undefined, { message: "skipReason is required when the decision is skip." });
13463
+ const output = object({ suggestion: makeSuggestionResourceSchema(ids) });
13464
+ return {
13465
+ annotationJustifications: {
13466
+ destructiveHint: "Every decision can be undone until the flow joins, and nothing is deleted.",
13467
+ openWorldHint: "An added suggestion writes its flow to the environment's flow code repository.",
13468
+ readOnlyHint: "Records a decision on a suggestion and changes its linked issue's status."
13469
+ },
13470
+ annotations: {
13471
+ destructiveHint: false,
13472
+ openWorldHint: true,
13473
+ readOnlyHint: false
13474
+ },
13475
+ description: "Decide a coverage suggestion QA Wolf made while exploring an environment, as the signed-in person. " + "Add turns on the suggested flow in the environment. Report files the potential bug. Skip declines the suggestion and needs a skipReason. " + "Undo takes back a decision. Activate retries a held suggestion. Only the decisions suggestion.get lists take effect. " + "Use this, not issue.update, to accept or skip a suggestion.",
13476
+ input,
13477
+ kind: "write",
13478
+ name: "suggestion.decide",
13479
+ output
13480
+ };
13481
+ };
13482
+
13483
+ // node_modules/@qawolf/api-contracts/dist/v1/suggestion/find.js
13484
+ var makeFindSuggestionsContract = (ids) => {
13485
+ const input = object({
13486
+ state: _enum(["waiting", "accepted", "skipped"]).optional().describe("Only list suggestions in this state. Use waiting to find the ones that need a decision. Omit to list all three."),
13487
+ workspaceId: ids.workspace.optional().describe("The workspace whose suggestions to list. Required when authenticating with an organization or user API key."),
13488
+ ...makePaginationInputFields({ defaultLimit: 20, maxLimit: 100 })
13489
+ });
13490
+ const output = object({
13491
+ nextCursor: nextCursorSchema,
13492
+ suggestions: array(makeSuggestionResourceSchema(ids)).describe("The workspace's coverage suggestions, newest first.")
13493
+ });
13494
+ return {
13495
+ annotationJustifications: {
13496
+ destructiveHint: "Does not decide or change any suggestion.",
13497
+ openWorldHint: "Reads QA Wolf suggestion records without changing external systems.",
13498
+ readOnlyHint: "Lists the workspace's coverage suggestions."
13499
+ },
13500
+ annotations: {
13501
+ destructiveHint: false,
13502
+ openWorldHint: false,
13503
+ readOnlyHint: true
13504
+ },
13505
+ description: "List the coverage QA Wolf suggested for a workspace, newest first: flows it wrote for missing coverage and potential bugs it found while exploring an environment. " + "Use this, not issue.find, for QA Wolf's suggestions, such as the ones a new suggestions notification points to. Filter by state waiting to find the ones that need a decision.",
13506
+ input,
13507
+ kind: "read",
13508
+ name: "suggestion.find",
13509
+ output
13510
+ };
13511
+ };
13512
+
13513
+ // node_modules/@qawolf/api-contracts/dist/v1/suggestion/get.js
13514
+ var makeGetSuggestionContract = (ids) => {
13515
+ const input = object({
13516
+ suggestionId: ids.suggestion.describe("The id of the coverage suggestion, from suggestion.find or a new suggestions notification.")
13517
+ });
13518
+ const output = object({ suggestion: makeSuggestionResourceSchema(ids) });
13519
+ return {
13520
+ annotationJustifications: {
13521
+ destructiveHint: "Does not decide or change the suggestion.",
13522
+ openWorldHint: "Reads a QA Wolf suggestion record without changing external systems.",
13523
+ readOnlyHint: "Retrieves one coverage suggestion."
13524
+ },
13525
+ annotations: {
13526
+ destructiveHint: false,
13527
+ openWorldHint: false,
13528
+ readOnlyHint: true
13529
+ },
13530
+ description: "Read one coverage suggestion QA Wolf made while exploring an environment: its state, the flow it proposes, the bug report or coverage request behind it, and the decisions it takes now. " + "Use this, not issue.get, for a suggestion id. A suggestion QA Wolf withdrew reads as not found.",
13531
+ input,
13532
+ kind: "read",
13533
+ name: "suggestion.get",
13534
+ output
13535
+ };
13536
+ };
13537
+
13538
+ // node_modules/@qawolf/api-contracts/dist/v1/suggestion/index.js
13539
+ var makeSuggestionContracts = (ids) => ({
13540
+ decide: makeDecideSuggestionContract(ids),
13541
+ find: makeFindSuggestionsContract(ids),
13542
+ get: makeGetSuggestionContract(ids)
13543
+ });
13544
+
13338
13545
  // node_modules/@qawolf/api-contracts/dist/v1/tag/list.js
13339
13546
  var makeListTagsContract = (ids) => {
13340
13547
  const input = object({
@@ -13373,7 +13580,8 @@ var makeContractsV1 = (ids) => {
13373
13580
  const resolvedIds = {
13374
13581
  ...defaultIdSchemas,
13375
13582
  ...ids,
13376
- runAttempt: ids.runAttempt ?? defaultIdSchemas.runAttempt
13583
+ runAttempt: ids.runAttempt ?? defaultIdSchemas.runAttempt,
13584
+ suggestion: ids.suggestion ?? defaultIdSchemas.suggestion
13377
13585
  };
13378
13586
  return {
13379
13587
  activity: {
@@ -13444,6 +13652,7 @@ var makeContractsV1 = (ids) => {
13444
13652
  },
13445
13653
  runner: makeRunnerContracts(resolvedIds),
13446
13654
  skill: makeSkillContracts(),
13655
+ suggestion: makeSuggestionContracts(resolvedIds),
13447
13656
  tag: {
13448
13657
  create: makeCreateTagContract(resolvedIds),
13449
13658
  list: makeListTagsContract(resolvedIds)
@@ -18228,4 +18437,4 @@ export {
18228
18437
  createRunnerSdk
18229
18438
  };
18230
18439
 
18231
- //# debugId=1A80CC3801EFA71A64756E2164756E21
18440
+ //# debugId=940E5D66DC71ADE164756E2164756E21
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@qawolf/cli",
3
- "version": "2.10.0",
3
+ "version": "2.12.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.130.0",
75
+ "@qawolf/api-contracts": "0.134.0",
76
76
  "@qawolf/emails": "1.1.1",
77
77
  "@qawolf/flow-targets": "2.0.0",
78
78
  "commander": "14.0.3",
@@ -195,7 +195,6 @@ that `url`; never guess a route and never send a repository link in its place.
195
195
  | `qawolf issue attachFiles` | write | Attach files from the team's storage to a bug report or coverage request owned by the caller's team, for example the files a bug was reproduced with or the test data a flow should use. Files already attached stay attached. Upload a file with file.requestUpload first. |
196
196
  | `qawolf issue comment` | write | Comment on a bug report, blocker (issue type `maintenance`), or coverage request owned by the caller's team. The comment changes nothing else on the issue, such as its status or priority. |
197
197
  | `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. |
198
- | `qawolf issue decideSuggestion` | write | Decide a coverage request or bug report that QA Wolf suggested after exploring an environment. Add turns on the suggested flow in the environment. Report files a potential bug. Skip declines the suggestion. Undo takes back a decision before the flow joins. The issue's status follows the decision, so change the status only through this tool while the suggestion is undecided. |
199
198
  | `qawolf issue find` | read | List the team's bug reports, blockers, or coverage requests, newest first. |
200
199
  | `qawolf issue get` | read | Get an issue by id. |
201
200
  | `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. |
@@ -209,7 +208,8 @@ that `url`; never guess a route and never send a repository link in its place.
209
208
  | `qawolf narratedRecording get` | read | Get a narrated recording's voiced video: its video page URL, its export status, and, once the export is ready, its duration and signed links to the mp4 with the voiceover baked in and its subtitles. Signed links stop working at video.expiresAt; the video page URL stays stable. While exportStatus is pending, check again later. |
210
209
  | `qawolf promotion find` | read | List environment promotions, newest first. A promotion moves the flow changes made in a head environment into its base environment. Filter by status conflicted to find the promotions whose conflicts still need a resolution. |
211
210
  | `qawolf promotion get` | read | Read one environment promotion: its status, the conflicting paths and commit hashes while it is conflicted or resolving, the commit it landed when promoted, and the AI task resolving it. Poll it after environment.promote to learn how the promotion settled. It does not serve file contents; a resolver reads both branches from the flow code repository. |
212
- | `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. |
211
+ | `qawolf promotion reportDecision` | write | Record how one conflicting path of a conflicted promotion was settled by running its versions, or why it is left for a person, with the run of each version. Exactly one passing version is kept (picked-by-run); when every version passed, they are combined or the one with more checks is kept; a person is asked only when every version failed or the runs could not tell them apart. Every run must have been started for this promotion's resolution. Reporting a path again replaces its decision. Returns the promotion. |
212
+ | `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. If the base environment has been terminated, the call is refused as target-environment-gone and the promotion can no longer be resolved. Returns the promotion in resolving; poll promotion.get until it is promoted, or conflicted again if the branches moved while it applied. |
213
213
  | `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. |
214
214
  | `qawolf run create` | write | Create a run for the selected flows and/or tags in an environment. |
215
215
  | `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. Pass failures to diagnose an attempt's failures one by one, for an attempt that failed on several checks. 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. |
@@ -222,7 +222,7 @@ that `url`; never guess a route and never send a repository link in its place.
222
222
  | `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. |
223
223
  | `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 |
224
224
  | `qawolf runner actions` | write | Perform a sequence of up to ten raw actions on a runner's screen in one request, as a JSON array of the same actions `runner act` takes. Use - to read the array from stdin. Actions run back to back, so batch only steps whose targets are on the screen you last saw, and end the sequence at the step that changes the page. Each result carries an effect: performed, not-performed, or unknown when the runner stopped answering and the action may have landed |
225
- | `qawolf runner events` | read | Print a runner's journal, one entry per line. QA Wolf writes console, recorder, run-events, run-logs, run-status |
225
+ | `qawolf runner events` | read | Print a runner's journal, one entry per line. QA Wolf writes console, network, recorder, run-events, run-logs, run-status |
226
226
  | `qawolf runner exec` | write | Evaluate a snippet against a runner's live page. Use - to read the snippet from stdin |
227
227
  | `qawolf runner highlight-selector` | write | Highlight what a selector matches on a runner's live page, so the next screenshot shows it. Omit the selector to clear the highlight |
228
228
  | `qawolf runner import-package` | write | Install a package into a runner's live run, so a snippet or a selection can import it |
@@ -248,6 +248,9 @@ that `url`; never guess a route and never send a repository link in its place.
248
248
  | `qawolf runner terminate` | write | End an interactive runner, and the pod it runs on with it |
249
249
  | `qawolf skill get` | read | Read a QA Wolf skill: the instructions a coding agent follows for one kind of QA Wolf work. The reply carries the skill's SKILL.md and every file under its references directory, so nothing else has to be fetched for it. Read the skill before starting the work it covers and follow it. A link in the reply of the form ../<skill>/SKILL.md names another skill, which this call reads by that name. |
250
250
  | `qawolf skill list` | read | List the QA Wolf skills, each with its name and the description that says when to use it. A skill is the instructions a coding agent follows for one kind of QA Wolf work, such as onboarding an application, creating a flow, repairing a failing flow, or setting up triggers. Call this before any QA Wolf work, pick the skill whose description matches the request, and read it with skill.get. |
251
+ | `qawolf suggestion decide` | write | Decide a coverage suggestion QA Wolf made while exploring an environment, as the signed-in person. Add turns on the suggested flow in the environment. Report files the potential bug. Skip declines the suggestion and needs a skipReason. Undo takes back a decision. Activate retries a held suggestion. Only the decisions suggestion.get lists take effect. Use this, not issue.update, to accept or skip a suggestion. |
252
+ | `qawolf suggestion find` | read | List the coverage QA Wolf suggested for a workspace, newest first: flows it wrote for missing coverage and potential bugs it found while exploring an environment. Use this, not issue.find, for QA Wolf's suggestions, such as the ones a new suggestions notification points to. Filter by state waiting to find the ones that need a decision. |
253
+ | `qawolf suggestion get` | read | Read one coverage suggestion QA Wolf made while exploring an environment: its state, the flow it proposes, the bug report or coverage request behind it, and the decisions it takes now. Use this, not issue.get, for a suggestion id. A suggestion QA Wolf withdrew reads as not found. |
251
254
  | `qawolf tag create` | write | Create a tag on the caller's team. Tags select flows in run.create. |
252
255
  | `qawolf tag list` | read | List the team's tags, alphabetical by name. Tag names select flows in run.create. |
253
256
  | `qawolf trigger create` | write | Create a trigger. A schedule trigger runs a named set of flows on a cadence; a deployment trigger runs when a matching deployment is reported. |
@@ -192,7 +192,7 @@ Every documented field of the `run.get` response. `[]` marks an array, so
192
192
  - `supersededBy.runId` — The id of the run.
193
193
  - `supersededBy.url` — Absolute URL of the replacement run's page.
194
194
  - `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.
195
- - `builds` — The builds the run installs, one per app and platform. Empty when the run has none.
195
+ - `builds` — The builds the run got that its flows installed, one per app and platform: a build counts once a finished or stopped attempt reported installing it. Empty while no attempt has, and when the run got none. `buildVersions[].expected` names the build the run got for each app.
196
196
  - `builds[].appId` — The package name (Android) or bundle ID (iOS) read from the file. A flow launches it with `launch({ app: { id } })`.
197
197
  - `builds[].appName` — The app's display name, when the file names one.
198
198
  - `builds[].branch` — The branch the uploader said the build came from.
@@ -229,6 +229,8 @@ Every documented field of the `run.get` response. `[]` marks an array, so
229
229
  - `flows[].attempts[].status` — One of: passed, failed, canceled
230
230
  - `flows[].attempts[].url` — 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.
231
231
  - `flows[].attempts[].canceledReason` — Why the attempt was canceled. userCanceled means a person stopped it; do not immediately retry that activity.
232
+ - `flows[].failure.blockedBy` — Present when the flow never started because flows it depends on failed in this run. This flow has no failure of its own: the named flows' failures explain it, and it runs again in the next run after those flows pass.
233
+ - `flows[].failure.blockedBy[].flowId` — The id of the flow.
232
234
  - `flows[].failure.diagnosis` — 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.
233
235
  - `flows[].failure.diagnosis.issueId` — The id of the issue.
234
236
  - `flows[].failure.diagnosis.type` — One of: bug, maintenance
@@ -236,6 +238,13 @@ Every documented field of the `run.get` response. `[]` marks an array, so
236
238
  - `flows[].failure.optedOutOfInvestigation.by` — One of: user, system
237
239
  - `flows[].flowId` — The id of the flow.
238
240
  - `flows[].status` — One of: failed, queued, running, passed, canceled
241
+ - `runAlertNotifications` — Where QA Wolf sent this run's alert, oldest first. Empty when it was not sent anywhere. Lists only destinations your team can see: your own Slack's channels, and QA Wolf's channels shared through Slack Connect. A destination QA Wolf could not check with Slack just now is left out, so if an entry you expect is missing, ask again later.
242
+ - `runAlertNotifications[].destination` — Where on the channel the alert went.
243
+ - `runAlertNotifications[].destination.channelId` — The Slack channel's id.
244
+ - `runAlertNotifications[].destination.workspaceId` — The Slack workspace the channel is in (Slack's team id), not a QA Wolf workspace.
245
+ - `runAlertNotifications[].messageId` — The alert's message at that destination. In Slack this is the message's `ts`: pass it as `thread_ts` to reply in the alert's thread.
246
+ - `runAlertNotifications[].permalink` — Link to the message. Absent for the moment between sending and the provider returning one.
247
+ - `runAlertNotifications[].sentAt` — When the alert's message was sent. In Slack this is the time in its `ts`, which stays the same when QA Wolf later updates the message.
239
248
  - `siteVersions` — The versions the run's attempts saw on each site origin, with warnings. Empty when no attempt reported one.
240
249
  - `siteVersions[].expected` — The commit the run should see. Only on the origin the deployment reported as its target. Absent when no deployment names a commit and a target, or the deployment has a service.
241
250
  - `siteVersions[].expected.from` — One of deployment, latestDeployment; newer servers may add values, so ignore any you don't know. deployment: the run's own deployment. latestDeployment: the environment's latest successful deployment before the run.
@@ -89,7 +89,7 @@ Commands:
89
89
  run [options] <flowFile> Run a flow on an interactive runner, shipping the flow
90
90
  and what it imports
91
91
  events [options] <stream> Print a runner's journal, one entry per line. QA Wolf
92
- writes console, recorder, run-events, run-logs,
92
+ writes console, network, recorder, run-events, run-logs,
93
93
  run-status
94
94
  screenshot [options] Save a JPEG of an interactive runner's screen to a file,
95
95
  or write it to stdout with --out -
@@ -536,7 +536,7 @@ Environment variables:
536
536
  ```text
537
537
  Usage: qawolf runner events [options] <stream>
538
538
 
539
- Print a runner's journal, one entry per line. QA Wolf writes console, recorder, run-events,
539
+ Print a runner's journal, one entry per line. QA Wolf writes console, network, recorder, run-events,
540
540
  run-logs, run-status
541
541
 
542
542
  Options:
@@ -568,10 +568,10 @@ Examples:
568
568
  Streams:
569
569
  Everything observable is an append-only stream on the pod, read by cursor or
570
570
  tail rather than subscribed to, so attaching late still gets you the history
571
- that is still there. QA Wolf writes recorder, console, run-events, run-logs
572
- and run-status; a stream nobody has written reads as empty rather than as an
573
- error, and a stream this CLI version does not know about is still readable by
574
- name. One payload per line, so shell tools compose:
571
+ that is still there. QA Wolf writes recorder, console, network, run-events,
572
+ run-logs and run-status; a stream nobody has written reads as empty rather
573
+ than as an error, and a stream this CLI version does not know about is still
574
+ readable by name. One payload per line, so shell tools compose:
575
575
 
576
576
  $ qawolf runner events console --tail 20 | jq -r '.message'
577
577
  $ qawolf runner events run-logs --run <runId> --follow > run.log