@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)
|
|
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
|
-
|
|
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
|
|
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.
|
|
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.
|
|
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=
|
|
44662
|
+
//# debugId=36A5EEFD853AC29364756E2164756E21
|
package/dist/runner-sdk.js
CHANGED
|
@@ -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)
|
|
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
|
-
|
|
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
|
|
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=
|
|
18440
|
+
//# debugId=940E5D66DC71ADE164756E2164756E21
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@qawolf/cli",
|
|
3
|
-
"version": "2.
|
|
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.
|
|
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
|
|
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
|
|
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,
|
|
572
|
-
and run-status; a stream nobody has written reads as empty rather
|
|
573
|
-
error, and a stream this CLI version does not know about is still
|
|
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
|