@qawolf/cli 2.9.0 → 2.10.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,6 +17953,16 @@ function resource(fields, { urlFieldDescription = "Absolute URL." } = {}) {
17953
17953
  });
17954
17954
  }
17955
17955
 
17956
+ // 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.");
17958
+ var makePromotionValidationRunSchema = (ids) => object({
17959
+ aiTaskId: ids.aiTask.describe("The resolution task that started the run."),
17960
+ runId: ids.run,
17961
+ runMode: resolutionRunModeSchema,
17962
+ sourceCommitHash: string2().describe("The head commit of the conflict the run was started for."),
17963
+ targetCommitHash: string2().describe("The base commit of the conflict the run was started for.")
17964
+ });
17965
+
17956
17966
  // node_modules/@qawolf/api-contracts/dist/v1/promotion/resource.js
17957
17967
  var promotionStatusSchema = _enum([
17958
17968
  "pending",
@@ -17976,7 +17986,8 @@ var makePromotionResourceSchema = (ids) => resource({
17976
17986
  id: ids.promotion,
17977
17987
  promotedCommitHash: string2().optional().describe("The commit the promotion landed on the base environment's flow code branch. Present when status is promoted."),
17978
17988
  settledAt: exports_iso.datetime().optional().describe("When the promotion reached promoted, no-changes or abandoned. Absent while it is open."),
17979
- status: promotionStatusSchema
17989
+ status: promotionStatusSchema,
17990
+ validationRuns: array(makePromotionValidationRunSchema(ids)).describe("The runs the resolution agent started, oldest first, each with the conflict commits it was for. Only runs whose commits match the current conflict speak for it. Empty when no run was started.")
17980
17991
  }, { urlFieldDescription: "Absolute URL of the head environment's page." });
17981
17992
 
17982
17993
  // node_modules/@qawolf/api-contracts/dist/v1/promotion/find.js
@@ -18459,7 +18470,7 @@ var makeFlowSelectionSchema = (ids) => object({
18459
18470
  // node_modules/@qawolf/api-contracts/dist/v1/run/index.js
18460
18471
  var makeCreateRunContract = (ids) => {
18461
18472
  const input = object({
18462
- aiTaskId: ids.aiTask.optional().describe("The AI task whose conversation should receive run status updates."),
18473
+ aiTaskId: ids.aiTask.optional().describe("The AI task the run is for. Its conversation receives run status updates, or, for a promotion conflict resolution task, the promotion links the run."),
18463
18474
  builds: array(buildIdSchema).min(1).max(20).optional().describe("Builds to install in this run only. Each replaces the environment's latest build of its app and platform."),
18464
18475
  chatSessionId: ids.chatSession.optional().describe("The chat session whose transcript should receive run status updates."),
18465
18476
  environmentId: ids.environmentRef,
@@ -18468,6 +18479,7 @@ var makeCreateRunContract = (ids) => {
18468
18479
  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."),
18469
18480
  pullRequestNumber: number2().int().positive().describe("The number of the pull request to associate with the run.").optional(),
18470
18481
  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.'),
18471
18483
  workspaceId: workspaceForEnvironmentRef(ids.workspace)
18472
18484
  }).and(makeFlowSelectionSchema(ids)).refine((value) => !(value.aiTaskId && value.chatSessionId), {
18473
18485
  message: "Provide at most one of aiTaskId and chatSessionId: a task already implies its own chat session.",
@@ -18587,6 +18599,7 @@ var screenPointSchema = strictObject({
18587
18599
  });
18588
18600
  var maxScrollDelta = 5000;
18589
18601
  var scrollDeltaSchema = int().min(-maxScrollDelta).max(maxScrollDelta);
18602
+ var optionalScrollDeltaSchema = scrollDeltaSchema.optional().default(0);
18590
18603
  var maxTypedTextLength = 200;
18591
18604
  var maxKeypressKeys = 10;
18592
18605
  var maxKeyNameLength = 32;
@@ -18607,8 +18620,8 @@ var browserActionSchema = discriminatedUnion("type", [
18607
18620
  y: screenCoordinateSchema
18608
18621
  }),
18609
18622
  strictObject({
18610
- scroll_x: scrollDeltaSchema,
18611
- scroll_y: scrollDeltaSchema,
18623
+ scroll_x: optionalScrollDeltaSchema,
18624
+ scroll_y: optionalScrollDeltaSchema,
18612
18625
  type: literal("scroll"),
18613
18626
  x: screenCoordinateSchema,
18614
18627
  y: screenCoordinateSchema
@@ -19357,10 +19370,16 @@ var runSelectionSchema = object({
19357
19370
  error: "A selection's startLine must not be after its endLine.",
19358
19371
  path: ["startLine"]
19359
19372
  });
19373
+ // node_modules/@qawolf/api-contracts/dist/v1/trigger/hourlyWindowField.js
19374
+ var triggerHourlyWindowSchema = object({
19375
+ endTime: string2().regex(/^([01]\d|2[0-3]):00$/, 'Expected a whole hour, "HH:00".').optional().describe(`The latest hour a run can land in, as "HH:00", later than startTime's hour. Runs keep startTime's minute, so the last run is the last step of every from startTime whose hour is at or before this one, and it can come after endTime: 01:30 to 22:00 last runs at 22:30, while every 4 hours from 06:00 to 16:00 last runs at 14:00. Omitting it runs until the end of the day.`),
19376
+ startTime: string2({ error: "window.startTime is required when a window is set." }).regex(/^([01]\d|2[0-3]):[0-5][05]$/, 'Expected "HH:mm" on a 5-minute step.').describe(`The first run of each day, as "HH:mm" on a 5-minute step. Its minute is every run's minute, and every counts from it.`)
19377
+ }).optional().describe("Runs an hourly schedule only in these hours of the day, read as wall clock times in timezoneId: from startTime up to the endTime hour. A window cannot go past midnight. Omitting it runs all day, counted from midnight.");
19378
+
19360
19379
  // node_modules/@qawolf/api-contracts/dist/v1/trigger/scheduleRepeatFields.js
19361
19380
  var triggerScheduleRepeatFields = {
19362
19381
  dayOfMonth: number2().int().min(1).max(28).optional().describe("The day of the month a monthly schedule fires on, from 1 to 28 so it exists in every month. Required when cadence is monthly."),
19363
- every: number2().int().min(1).optional().describe("How many hours, days, weeks or months sit between fires. Defaults to 1. Hourly takes 1, 2, 3, 4, 6, 8 or 12, counted from midnight in timezoneId; daily takes up to 31, and weekly and monthly up to 12."),
19382
+ every: number2().int().min(1).optional().describe("How many hours, days, weeks or months sit between fires. Defaults to 1. Hourly takes up to 12, counted from window.startTime, or from midnight in timezoneId without a window, and starts over each day; daily takes up to 31, and weekly and monthly up to 12."),
19364
19383
  startDate: string2().regex(/^\d{4}-\d{2}-\d{2}$/).optional().describe('The date of the first fire, as "YYYY-MM-DD" in timezoneId, for a daily, weekly or monthly schedule whose every is more than 1. Later fires repeat every N units from it. A weekly start date falls on dayOfWeek and a monthly one on dayOfMonth. Required when every is more than 1.')
19365
19384
  };
19366
19385
 
@@ -19402,15 +19421,99 @@ var makeTriggerScheduleFields = (ids) => ({
19402
19421
  }).optional().describe("The only days an hourly or daily schedule fires on, read in timezoneId. Name each day at most once. Omitting it fires on every day."),
19403
19422
  environmentId: ids.environmentId.describe("The environment the scheduled runs happen in."),
19404
19423
  ...triggerScheduleRepeatFields,
19405
- minuteOfHour: number2().int().min(0).max(59).optional().describe("Minutes past the hour an hourly schedule fires. Defaults to 0."),
19424
+ minuteOfHour: number2().int().min(0).max(59).optional().describe("Minutes past the hour an hourly schedule fires. Defaults to 0, or to the minute of window.startTime."),
19406
19425
  timeOfDay: string2().regex(/^([01]\d|2[0-3]):[0-5]\d$/).optional().describe('The wall clock time a daily, weekly or monthly schedule fires, as "HH:mm". Required when cadence is daily, weekly or monthly.'),
19407
- timezoneId: string2().min(1).refine(isTimezone, "Expected an IANA timezone, such as America/New_York.").optional().describe("The IANA timezone the schedule is read in, such as America/New_York. Required for every cadence: it sets the day boundaries daysOfWeek is read against, and the wall clock timeOfDay is read against.")
19426
+ timezoneId: string2().min(1).refine(isTimezone, "Expected an IANA timezone, such as America/New_York.").optional().describe("The IANA timezone the schedule is read in, such as America/New_York. Required for every cadence: it sets the day boundaries daysOfWeek is read against, and the wall clock timeOfDay is read against."),
19427
+ window: triggerHourlyWindowSchema
19408
19428
  });
19409
19429
 
19430
+ // node_modules/@qawolf/api-contracts/dist/v1/trigger/hourlyWindowRules.js
19431
+ var partsOf = (time) => time.split(":").map(Number);
19432
+ var checkHourlyWindow = (value, ctx) => {
19433
+ if (value.cadence !== "hourly" || value.window === undefined)
19434
+ return;
19435
+ const [startHour, startMinute] = partsOf(value.window.startTime);
19436
+ const [endHour] = value.window.endTime === undefined ? [] : partsOf(value.window.endTime);
19437
+ if (endHour !== undefined && startHour !== undefined && endHour <= startHour) {
19438
+ ctx.addIssue({
19439
+ code: "custom",
19440
+ message: "window.endTime must be a later hour than window.startTime. A window cannot go past midnight, so leave endTime out to run until the end of the day.",
19441
+ path: ["window", "endTime"]
19442
+ });
19443
+ }
19444
+ if (value.minuteOfHour !== undefined && value.minuteOfHour !== startMinute) {
19445
+ ctx.addIssue({
19446
+ code: "custom",
19447
+ message: "minuteOfHour must match the minute of window.startTime, which sets it.",
19448
+ path: ["minuteOfHour"]
19449
+ });
19450
+ }
19451
+ };
19452
+
19453
+ // node_modules/@qawolf/api-contracts/dist/v1/trigger/scheduleFieldRules.js
19454
+ var requiredScheduleFields = {
19455
+ daily: ["timeOfDay", "timezoneId"],
19456
+ hourly: ["timezoneId"],
19457
+ monthly: ["dayOfMonth", "timeOfDay", "timezoneId"],
19458
+ weekly: ["dayOfWeek", "timeOfDay", "timezoneId"]
19459
+ };
19460
+ var optionalScheduleFields = {
19461
+ daily: ["daysOfWeek", "every", "startDate"],
19462
+ hourly: ["daysOfWeek", "every", "minuteOfHour", "window"],
19463
+ monthly: ["every", "startDate"],
19464
+ weekly: ["every", "startDate"]
19465
+ };
19466
+ var cadencesUsingField = {
19467
+ dayOfMonth: "a monthly cadence",
19468
+ dayOfWeek: "a weekly cadence",
19469
+ daysOfWeek: "an hourly or daily cadence",
19470
+ every: "any cadence",
19471
+ minuteOfHour: "an hourly cadence",
19472
+ startDate: "a daily, weekly or monthly cadence",
19473
+ timeOfDay: "a daily, weekly or monthly cadence",
19474
+ timezoneId: "an hourly, daily, weekly or monthly cadence",
19475
+ window: "an hourly cadence"
19476
+ };
19477
+ var scheduleFields = [
19478
+ "dayOfMonth",
19479
+ "dayOfWeek",
19480
+ "daysOfWeek",
19481
+ "every",
19482
+ "minuteOfHour",
19483
+ "startDate",
19484
+ "timeOfDay",
19485
+ "timezoneId",
19486
+ "window"
19487
+ ];
19488
+ var checkScheduleFields = (value, ctx) => {
19489
+ const required = requiredScheduleFields[value.cadence];
19490
+ const optional = optionalScheduleFields[value.cadence];
19491
+ for (const field of scheduleFields) {
19492
+ const isSupplied = value[field] !== undefined;
19493
+ if (required.includes(field)) {
19494
+ if (!isSupplied) {
19495
+ ctx.addIssue({
19496
+ code: "custom",
19497
+ message: `${field} is required when cadence is ${value.cadence}.`,
19498
+ path: [field]
19499
+ });
19500
+ }
19501
+ continue;
19502
+ }
19503
+ if (isSupplied && !optional.includes(field)) {
19504
+ ctx.addIssue({
19505
+ code: "custom",
19506
+ message: `${field} applies to ${cadencesUsingField[field]} only.`,
19507
+ path: [field]
19508
+ });
19509
+ }
19510
+ }
19511
+ };
19512
+
19410
19513
  // node_modules/@qawolf/api-contracts/dist/v1/trigger/scheduleRepeatRules.js
19411
- var hourlyEveryValues = [1, 2, 3, 4, 6, 8, 12];
19412
19514
  var maxEvery = {
19413
19515
  daily: 31,
19516
+ hourly: 12,
19414
19517
  monthly: 12,
19415
19518
  weekly: 12
19416
19519
  };
@@ -19428,9 +19531,6 @@ var calendarDayOf = (startDate) => {
19428
19531
  return !Number.isNaN(date.getTime()) && date.toISOString().startsWith(startDate) ? date : undefined;
19429
19532
  };
19430
19533
  var everyIssue = (value, every) => {
19431
- if (value.cadence === "hourly") {
19432
- return hourlyEveryValues.includes(every) ? undefined : "every must divide a day evenly when cadence is hourly: 1, 2, 3, 4, 6, 8 or 12.";
19433
- }
19434
19534
  const max = maxEvery[value.cadence];
19435
19535
  return every > max ? `every is at most ${max} when cadence is ${value.cadence}.` : undefined;
19436
19536
  };
@@ -19497,65 +19597,10 @@ var checkAction = (action, ctx) => {
19497
19597
  });
19498
19598
  }
19499
19599
  };
19500
- var requiredScheduleFields = {
19501
- daily: ["timeOfDay", "timezoneId"],
19502
- hourly: ["timezoneId"],
19503
- monthly: ["dayOfMonth", "timeOfDay", "timezoneId"],
19504
- weekly: ["dayOfWeek", "timeOfDay", "timezoneId"]
19505
- };
19506
- var optionalScheduleFields = {
19507
- daily: ["daysOfWeek", "every", "startDate"],
19508
- hourly: ["daysOfWeek", "every", "minuteOfHour"],
19509
- monthly: ["every", "startDate"],
19510
- weekly: ["every", "startDate"]
19511
- };
19512
- var cadencesUsingField = {
19513
- dayOfMonth: "a monthly cadence",
19514
- dayOfWeek: "a weekly cadence",
19515
- daysOfWeek: "an hourly or daily cadence",
19516
- every: "any cadence",
19517
- minuteOfHour: "an hourly cadence",
19518
- startDate: "a daily, weekly or monthly cadence",
19519
- timeOfDay: "a daily, weekly or monthly cadence",
19520
- timezoneId: "an hourly, daily, weekly or monthly cadence"
19521
- };
19522
- var scheduleFields = [
19523
- "dayOfMonth",
19524
- "dayOfWeek",
19525
- "daysOfWeek",
19526
- "every",
19527
- "minuteOfHour",
19528
- "startDate",
19529
- "timeOfDay",
19530
- "timezoneId"
19531
- ];
19532
- var checkScheduleFields = (value, ctx) => {
19533
- const required = requiredScheduleFields[value.cadence];
19534
- const optional = optionalScheduleFields[value.cadence];
19535
- for (const field of scheduleFields) {
19536
- const isSupplied = value[field] !== undefined;
19537
- if (required.includes(field)) {
19538
- if (!isSupplied) {
19539
- ctx.addIssue({
19540
- code: "custom",
19541
- message: `${field} is required when cadence is ${value.cadence}.`,
19542
- path: [field]
19543
- });
19544
- }
19545
- continue;
19546
- }
19547
- if (isSupplied && !optional.includes(field)) {
19548
- ctx.addIssue({
19549
- code: "custom",
19550
- message: `${field} applies to ${cadencesUsingField[field]} only.`,
19551
- path: [field]
19552
- });
19553
- }
19554
- }
19555
- };
19556
19600
  var checkSchedule = (value, ctx) => {
19557
19601
  checkScheduleFields(value, ctx);
19558
19602
  checkScheduleRepeat(value, ctx);
19603
+ checkHourlyWindow(value, ctx);
19559
19604
  if (value.action.kind === "generativeSuite") {
19560
19605
  ctx.addIssue({
19561
19606
  code: "custom",
@@ -22100,6 +22145,45 @@ var makeConnectMcpServerContract = (ids) => {
22100
22145
  };
22101
22146
  };
22102
22147
 
22148
+ // node_modules/@qawolf/api-contracts/dist/v1/narratedRecording/get.js
22149
+ var makeGetNarratedRecordingContract = (ids) => {
22150
+ const input = object({
22151
+ narratedRecordingId: string2().min(1).describe("The id of the narrated recording: the last segment of its video page URL, .../<workspace>/bug-report-video/<narratedRecordingId>."),
22152
+ workspaceId: ids.workspace.optional().describe("The workspace the narrated recording belongs to. Required when authenticating with an organization or user API key. Read it from whoami.")
22153
+ });
22154
+ const output = object({
22155
+ exportFailureMessage: string2().optional().describe("Why the export failed, when it failed and said why."),
22156
+ exportStatus: _enum(["not-requested", "pending", "ready", "failed"]).describe("Where the voiced video export is. pending: it is rendering, so check again in a minute. ready: video holds its links. failed: the export stopped; exportFailureMessage may say why. not-requested: no export was asked for yet."),
22157
+ narratedRecordingId: string2(),
22158
+ url: url().describe("The QA Wolf video page that plays the narrated recording. Share it with people; it stays stable."),
22159
+ video: object({
22160
+ downloadUrl: url().describe("Signed link that downloads the voiced mp4 instead of playing it."),
22161
+ durationMs: number2().positive(),
22162
+ expiresAt: exports_iso.datetime().describe("When the signed links stop working. Call narratedRecording.get again for fresh ones after it."),
22163
+ posterUrl: url().optional().describe("Signed link to an animated webp preview, when one exists."),
22164
+ subtitlesUrl: url().describe("Signed link to the WebVTT subtitles of the narration."),
22165
+ videoUrl: url().describe("Signed link that plays the voiced mp4 with the narration baked in.")
22166
+ }).optional().describe("The exported voiced video. Present only when exportStatus is ready. Its signed links stop working at expiresAt, so read this again for fresh links instead of storing them.")
22167
+ });
22168
+ return {
22169
+ annotationJustifications: {
22170
+ destructiveHint: "Does not change, re-export or delete the recording.",
22171
+ openWorldHint: "Reads QA Wolf workspace storage without changing the application under test.",
22172
+ readOnlyHint: "Reads a narrated recording's export status and signed video links."
22173
+ },
22174
+ annotations: {
22175
+ destructiveHint: false,
22176
+ openWorldHint: false,
22177
+ readOnlyHint: true
22178
+ },
22179
+ description: "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.",
22180
+ input,
22181
+ kind: "read",
22182
+ name: "narratedRecording.get",
22183
+ output
22184
+ };
22185
+ };
22186
+
22103
22187
  // node_modules/@qawolf/api-contracts/dist/v1/run/investigationSessionId.js
22104
22188
  var investigationSessionId = string2().trim().min(1).max(100).optional();
22105
22189
 
@@ -22293,7 +22377,7 @@ var runBuildVersionSchema = object({
22293
22377
  buildId: buildIdSchema,
22294
22378
  version: string2().optional()
22295
22379
  }).optional().describe("The run's build of this app. Absent for an app it got none of."),
22296
- kind: extensibleValue(["build", "info"], "build: the run got a build of this app. info: any other app an attempt installed, such as a companion app. It has no warnings."),
22380
+ kind: extensibleValue(["build", "info"], "build: the run got a build of this app. info: any other app an attempt installed, such as a companion app. Its only warning is changedDuringRun."),
22297
22381
  observed: array(object({
22298
22382
  attempts: attemptCount,
22299
22383
  buildId: buildIdSchema.optional().describe("Absent when the file is not one of the team's builds."),
@@ -22301,7 +22385,7 @@ var runBuildVersionSchema = object({
22301
22385
  })).describe("What attempts installed, one entry per build or version."),
22302
22386
  platform: buildPlatformSchema,
22303
22387
  unreportedAttempts: number2().int().nonnegative().describe("Finished attempts that reported no installed app, such as web attempts or attempts on an older Flows SDK."),
22304
- warnings: array(extensibleValue(["changedDuringRun", "notTested", "unknownApp"], "changedDuringRun: attempts installed different builds of the run's app. notTested: attempts installed files on this platform that could be this app, but none installed the run's build. An install of another app never counts. unknownApp: an attempt installed a file of this app that is not the run's build.")).describe("Why the installed apps may not be what the run should test.")
22388
+ warnings: array(extensibleValue(["changedDuringRun", "notTested", "unknownApp"], "changedDuringRun: attempts installed different builds of the run's app, or different versions of an info app. notTested: attempts installed files on this platform that could be this app, but none installed the run's build. An install of another app never counts. unknownApp: an attempt installed a file of this app that is not the run's build.")).describe("Why the installed apps may not be what the run should test.")
22305
22389
  });
22306
22390
  var runSiteVersionSchema = object({
22307
22391
  expected: object({
@@ -23150,6 +23234,9 @@ var makeContractsV1 = (ids) => {
23150
23234
  mcpServer: {
23151
23235
  connect: makeConnectMcpServerContract(resolvedIds)
23152
23236
  },
23237
+ narratedRecording: {
23238
+ get: makeGetNarratedRecordingContract(resolvedIds)
23239
+ },
23153
23240
  promotion: makePromotionContracts(resolvedIds),
23154
23241
  run: {
23155
23242
  acceptScreenshotBaseline: makeAcceptScreenshotBaselineContract(resolvedIds),
@@ -25677,7 +25764,7 @@ function startUpdateCheck(deps) {
25677
25764
  // package.json
25678
25765
  var package_default = {
25679
25766
  name: "@qawolf/cli",
25680
- version: "2.9.0",
25767
+ version: "2.10.0",
25681
25768
  description: "Run and manage QA Wolf flows from the terminal, CI, or an AI agent",
25682
25769
  keywords: [
25683
25770
  "automation",
@@ -25749,7 +25836,7 @@ var package_default = {
25749
25836
  "@clack/prompts": "1.5.1",
25750
25837
  "@napi-rs/keyring": "1.3.0",
25751
25838
  "@oxc-node/core": "0.1.0",
25752
- "@qawolf/api-contracts": "0.129.0",
25839
+ "@qawolf/api-contracts": "0.130.0",
25753
25840
  "@qawolf/emails": "1.1.1",
25754
25841
  "@qawolf/flow-targets": "2.0.0",
25755
25842
  commander: "14.0.3",
@@ -44363,4 +44450,4 @@ createProgram({ signals }).parseAsync().catch(() => {
44363
44450
  process.exitCode = 1;
44364
44451
  }).finally(() => exitWhenIdle(typeof process.exitCode === "number" ? process.exitCode : 0));
44365
44452
 
44366
- //# debugId=9DA6FB8390FD6B4C64756E2164756E21
44453
+ //# debugId=607AD2DAA196641B64756E2164756E21
@@ -8138,6 +8138,16 @@ function resource(fields, { urlFieldDescription = "Absolute URL." } = {}) {
8138
8138
  });
8139
8139
  }
8140
8140
 
8141
+ // 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.");
8143
+ var makePromotionValidationRunSchema = (ids) => object({
8144
+ aiTaskId: ids.aiTask.describe("The resolution task that started the run."),
8145
+ runId: ids.run,
8146
+ runMode: resolutionRunModeSchema,
8147
+ sourceCommitHash: string2().describe("The head commit of the conflict the run was started for."),
8148
+ targetCommitHash: string2().describe("The base commit of the conflict the run was started for.")
8149
+ });
8150
+
8141
8151
  // node_modules/@qawolf/api-contracts/dist/v1/promotion/resource.js
8142
8152
  var promotionStatusSchema = _enum([
8143
8153
  "pending",
@@ -8161,7 +8171,8 @@ var makePromotionResourceSchema = (ids) => resource({
8161
8171
  id: ids.promotion,
8162
8172
  promotedCommitHash: string2().optional().describe("The commit the promotion landed on the base environment's flow code branch. Present when status is promoted."),
8163
8173
  settledAt: exports_iso.datetime().optional().describe("When the promotion reached promoted, no-changes or abandoned. Absent while it is open."),
8164
- status: promotionStatusSchema
8174
+ status: promotionStatusSchema,
8175
+ validationRuns: array(makePromotionValidationRunSchema(ids)).describe("The runs the resolution agent started, oldest first, each with the conflict commits it was for. Only runs whose commits match the current conflict speak for it. Empty when no run was started.")
8165
8176
  }, { urlFieldDescription: "Absolute URL of the head environment's page." });
8166
8177
 
8167
8178
  // node_modules/@qawolf/api-contracts/dist/v1/promotion/find.js
@@ -8645,7 +8656,7 @@ var makeFlowSelectionSchema = (ids) => object({
8645
8656
  // node_modules/@qawolf/api-contracts/dist/v1/run/index.js
8646
8657
  var makeCreateRunContract = (ids) => {
8647
8658
  const input = object({
8648
- aiTaskId: ids.aiTask.optional().describe("The AI task whose conversation should receive run status updates."),
8659
+ aiTaskId: ids.aiTask.optional().describe("The AI task the run is for. Its conversation receives run status updates, or, for a promotion conflict resolution task, the promotion links the run."),
8649
8660
  builds: array(buildIdSchema).min(1).max(20).optional().describe("Builds to install in this run only. Each replaces the environment's latest build of its app and platform."),
8650
8661
  chatSessionId: ids.chatSession.optional().describe("The chat session whose transcript should receive run status updates."),
8651
8662
  environmentId: ids.environmentRef,
@@ -8654,6 +8665,7 @@ var makeCreateRunContract = (ids) => {
8654
8665
  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."),
8655
8666
  pullRequestNumber: number2().int().positive().describe("The number of the pull request to associate with the run.").optional(),
8656
8667
  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.'),
8657
8669
  workspaceId: workspaceForEnvironmentRef(ids.workspace)
8658
8670
  }).and(makeFlowSelectionSchema(ids)).refine((value) => !(value.aiTaskId && value.chatSessionId), {
8659
8671
  message: "Provide at most one of aiTaskId and chatSessionId: a task already implies its own chat session.",
@@ -8774,6 +8786,7 @@ var screenPointSchema = strictObject({
8774
8786
  });
8775
8787
  var maxScrollDelta = 5000;
8776
8788
  var scrollDeltaSchema = int().min(-maxScrollDelta).max(maxScrollDelta);
8789
+ var optionalScrollDeltaSchema = scrollDeltaSchema.optional().default(0);
8777
8790
  var maxTypedTextLength = 200;
8778
8791
  var maxKeypressKeys = 10;
8779
8792
  var maxKeyNameLength = 32;
@@ -8794,8 +8807,8 @@ var browserActionSchema = discriminatedUnion("type", [
8794
8807
  y: screenCoordinateSchema
8795
8808
  }),
8796
8809
  strictObject({
8797
- scroll_x: scrollDeltaSchema,
8798
- scroll_y: scrollDeltaSchema,
8810
+ scroll_x: optionalScrollDeltaSchema,
8811
+ scroll_y: optionalScrollDeltaSchema,
8799
8812
  type: literal("scroll"),
8800
8813
  x: screenCoordinateSchema,
8801
8814
  y: screenCoordinateSchema
@@ -9549,10 +9562,16 @@ var runSelectionSchema = object({
9549
9562
  error: "A selection's startLine must not be after its endLine.",
9550
9563
  path: ["startLine"]
9551
9564
  });
9565
+ // node_modules/@qawolf/api-contracts/dist/v1/trigger/hourlyWindowField.js
9566
+ var triggerHourlyWindowSchema = object({
9567
+ endTime: string2().regex(/^([01]\d|2[0-3]):00$/, 'Expected a whole hour, "HH:00".').optional().describe(`The latest hour a run can land in, as "HH:00", later than startTime's hour. Runs keep startTime's minute, so the last run is the last step of every from startTime whose hour is at or before this one, and it can come after endTime: 01:30 to 22:00 last runs at 22:30, while every 4 hours from 06:00 to 16:00 last runs at 14:00. Omitting it runs until the end of the day.`),
9568
+ startTime: string2({ error: "window.startTime is required when a window is set." }).regex(/^([01]\d|2[0-3]):[0-5][05]$/, 'Expected "HH:mm" on a 5-minute step.').describe(`The first run of each day, as "HH:mm" on a 5-minute step. Its minute is every run's minute, and every counts from it.`)
9569
+ }).optional().describe("Runs an hourly schedule only in these hours of the day, read as wall clock times in timezoneId: from startTime up to the endTime hour. A window cannot go past midnight. Omitting it runs all day, counted from midnight.");
9570
+
9552
9571
  // node_modules/@qawolf/api-contracts/dist/v1/trigger/scheduleRepeatFields.js
9553
9572
  var triggerScheduleRepeatFields = {
9554
9573
  dayOfMonth: number2().int().min(1).max(28).optional().describe("The day of the month a monthly schedule fires on, from 1 to 28 so it exists in every month. Required when cadence is monthly."),
9555
- every: number2().int().min(1).optional().describe("How many hours, days, weeks or months sit between fires. Defaults to 1. Hourly takes 1, 2, 3, 4, 6, 8 or 12, counted from midnight in timezoneId; daily takes up to 31, and weekly and monthly up to 12."),
9574
+ every: number2().int().min(1).optional().describe("How many hours, days, weeks or months sit between fires. Defaults to 1. Hourly takes up to 12, counted from window.startTime, or from midnight in timezoneId without a window, and starts over each day; daily takes up to 31, and weekly and monthly up to 12."),
9556
9575
  startDate: string2().regex(/^\d{4}-\d{2}-\d{2}$/).optional().describe('The date of the first fire, as "YYYY-MM-DD" in timezoneId, for a daily, weekly or monthly schedule whose every is more than 1. Later fires repeat every N units from it. A weekly start date falls on dayOfWeek and a monthly one on dayOfMonth. Required when every is more than 1.')
9557
9576
  };
9558
9577
 
@@ -9594,15 +9613,99 @@ var makeTriggerScheduleFields = (ids) => ({
9594
9613
  }).optional().describe("The only days an hourly or daily schedule fires on, read in timezoneId. Name each day at most once. Omitting it fires on every day."),
9595
9614
  environmentId: ids.environmentId.describe("The environment the scheduled runs happen in."),
9596
9615
  ...triggerScheduleRepeatFields,
9597
- minuteOfHour: number2().int().min(0).max(59).optional().describe("Minutes past the hour an hourly schedule fires. Defaults to 0."),
9616
+ minuteOfHour: number2().int().min(0).max(59).optional().describe("Minutes past the hour an hourly schedule fires. Defaults to 0, or to the minute of window.startTime."),
9598
9617
  timeOfDay: string2().regex(/^([01]\d|2[0-3]):[0-5]\d$/).optional().describe('The wall clock time a daily, weekly or monthly schedule fires, as "HH:mm". Required when cadence is daily, weekly or monthly.'),
9599
- timezoneId: string2().min(1).refine(isTimezone, "Expected an IANA timezone, such as America/New_York.").optional().describe("The IANA timezone the schedule is read in, such as America/New_York. Required for every cadence: it sets the day boundaries daysOfWeek is read against, and the wall clock timeOfDay is read against.")
9618
+ timezoneId: string2().min(1).refine(isTimezone, "Expected an IANA timezone, such as America/New_York.").optional().describe("The IANA timezone the schedule is read in, such as America/New_York. Required for every cadence: it sets the day boundaries daysOfWeek is read against, and the wall clock timeOfDay is read against."),
9619
+ window: triggerHourlyWindowSchema
9600
9620
  });
9601
9621
 
9622
+ // node_modules/@qawolf/api-contracts/dist/v1/trigger/hourlyWindowRules.js
9623
+ var partsOf = (time) => time.split(":").map(Number);
9624
+ var checkHourlyWindow = (value, ctx) => {
9625
+ if (value.cadence !== "hourly" || value.window === undefined)
9626
+ return;
9627
+ const [startHour, startMinute] = partsOf(value.window.startTime);
9628
+ const [endHour] = value.window.endTime === undefined ? [] : partsOf(value.window.endTime);
9629
+ if (endHour !== undefined && startHour !== undefined && endHour <= startHour) {
9630
+ ctx.addIssue({
9631
+ code: "custom",
9632
+ message: "window.endTime must be a later hour than window.startTime. A window cannot go past midnight, so leave endTime out to run until the end of the day.",
9633
+ path: ["window", "endTime"]
9634
+ });
9635
+ }
9636
+ if (value.minuteOfHour !== undefined && value.minuteOfHour !== startMinute) {
9637
+ ctx.addIssue({
9638
+ code: "custom",
9639
+ message: "minuteOfHour must match the minute of window.startTime, which sets it.",
9640
+ path: ["minuteOfHour"]
9641
+ });
9642
+ }
9643
+ };
9644
+
9645
+ // node_modules/@qawolf/api-contracts/dist/v1/trigger/scheduleFieldRules.js
9646
+ var requiredScheduleFields = {
9647
+ daily: ["timeOfDay", "timezoneId"],
9648
+ hourly: ["timezoneId"],
9649
+ monthly: ["dayOfMonth", "timeOfDay", "timezoneId"],
9650
+ weekly: ["dayOfWeek", "timeOfDay", "timezoneId"]
9651
+ };
9652
+ var optionalScheduleFields = {
9653
+ daily: ["daysOfWeek", "every", "startDate"],
9654
+ hourly: ["daysOfWeek", "every", "minuteOfHour", "window"],
9655
+ monthly: ["every", "startDate"],
9656
+ weekly: ["every", "startDate"]
9657
+ };
9658
+ var cadencesUsingField = {
9659
+ dayOfMonth: "a monthly cadence",
9660
+ dayOfWeek: "a weekly cadence",
9661
+ daysOfWeek: "an hourly or daily cadence",
9662
+ every: "any cadence",
9663
+ minuteOfHour: "an hourly cadence",
9664
+ startDate: "a daily, weekly or monthly cadence",
9665
+ timeOfDay: "a daily, weekly or monthly cadence",
9666
+ timezoneId: "an hourly, daily, weekly or monthly cadence",
9667
+ window: "an hourly cadence"
9668
+ };
9669
+ var scheduleFields = [
9670
+ "dayOfMonth",
9671
+ "dayOfWeek",
9672
+ "daysOfWeek",
9673
+ "every",
9674
+ "minuteOfHour",
9675
+ "startDate",
9676
+ "timeOfDay",
9677
+ "timezoneId",
9678
+ "window"
9679
+ ];
9680
+ var checkScheduleFields = (value, ctx) => {
9681
+ const required = requiredScheduleFields[value.cadence];
9682
+ const optional = optionalScheduleFields[value.cadence];
9683
+ for (const field of scheduleFields) {
9684
+ const isSupplied = value[field] !== undefined;
9685
+ if (required.includes(field)) {
9686
+ if (!isSupplied) {
9687
+ ctx.addIssue({
9688
+ code: "custom",
9689
+ message: `${field} is required when cadence is ${value.cadence}.`,
9690
+ path: [field]
9691
+ });
9692
+ }
9693
+ continue;
9694
+ }
9695
+ if (isSupplied && !optional.includes(field)) {
9696
+ ctx.addIssue({
9697
+ code: "custom",
9698
+ message: `${field} applies to ${cadencesUsingField[field]} only.`,
9699
+ path: [field]
9700
+ });
9701
+ }
9702
+ }
9703
+ };
9704
+
9602
9705
  // node_modules/@qawolf/api-contracts/dist/v1/trigger/scheduleRepeatRules.js
9603
- var hourlyEveryValues = [1, 2, 3, 4, 6, 8, 12];
9604
9706
  var maxEvery = {
9605
9707
  daily: 31,
9708
+ hourly: 12,
9606
9709
  monthly: 12,
9607
9710
  weekly: 12
9608
9711
  };
@@ -9620,9 +9723,6 @@ var calendarDayOf = (startDate) => {
9620
9723
  return !Number.isNaN(date.getTime()) && date.toISOString().startsWith(startDate) ? date : undefined;
9621
9724
  };
9622
9725
  var everyIssue = (value, every) => {
9623
- if (value.cadence === "hourly") {
9624
- return hourlyEveryValues.includes(every) ? undefined : "every must divide a day evenly when cadence is hourly: 1, 2, 3, 4, 6, 8 or 12.";
9625
- }
9626
9726
  const max = maxEvery[value.cadence];
9627
9727
  return every > max ? `every is at most ${max} when cadence is ${value.cadence}.` : undefined;
9628
9728
  };
@@ -9689,65 +9789,10 @@ var checkAction = (action, ctx) => {
9689
9789
  });
9690
9790
  }
9691
9791
  };
9692
- var requiredScheduleFields = {
9693
- daily: ["timeOfDay", "timezoneId"],
9694
- hourly: ["timezoneId"],
9695
- monthly: ["dayOfMonth", "timeOfDay", "timezoneId"],
9696
- weekly: ["dayOfWeek", "timeOfDay", "timezoneId"]
9697
- };
9698
- var optionalScheduleFields = {
9699
- daily: ["daysOfWeek", "every", "startDate"],
9700
- hourly: ["daysOfWeek", "every", "minuteOfHour"],
9701
- monthly: ["every", "startDate"],
9702
- weekly: ["every", "startDate"]
9703
- };
9704
- var cadencesUsingField = {
9705
- dayOfMonth: "a monthly cadence",
9706
- dayOfWeek: "a weekly cadence",
9707
- daysOfWeek: "an hourly or daily cadence",
9708
- every: "any cadence",
9709
- minuteOfHour: "an hourly cadence",
9710
- startDate: "a daily, weekly or monthly cadence",
9711
- timeOfDay: "a daily, weekly or monthly cadence",
9712
- timezoneId: "an hourly, daily, weekly or monthly cadence"
9713
- };
9714
- var scheduleFields = [
9715
- "dayOfMonth",
9716
- "dayOfWeek",
9717
- "daysOfWeek",
9718
- "every",
9719
- "minuteOfHour",
9720
- "startDate",
9721
- "timeOfDay",
9722
- "timezoneId"
9723
- ];
9724
- var checkScheduleFields = (value, ctx) => {
9725
- const required = requiredScheduleFields[value.cadence];
9726
- const optional = optionalScheduleFields[value.cadence];
9727
- for (const field of scheduleFields) {
9728
- const isSupplied = value[field] !== undefined;
9729
- if (required.includes(field)) {
9730
- if (!isSupplied) {
9731
- ctx.addIssue({
9732
- code: "custom",
9733
- message: `${field} is required when cadence is ${value.cadence}.`,
9734
- path: [field]
9735
- });
9736
- }
9737
- continue;
9738
- }
9739
- if (isSupplied && !optional.includes(field)) {
9740
- ctx.addIssue({
9741
- code: "custom",
9742
- message: `${field} applies to ${cadencesUsingField[field]} only.`,
9743
- path: [field]
9744
- });
9745
- }
9746
- }
9747
- };
9748
9792
  var checkSchedule = (value, ctx) => {
9749
9793
  checkScheduleFields(value, ctx);
9750
9794
  checkScheduleRepeat(value, ctx);
9795
+ checkHourlyWindow(value, ctx);
9751
9796
  if (value.action.kind === "generativeSuite") {
9752
9797
  ctx.addIssue({
9753
9798
  code: "custom",
@@ -12292,6 +12337,45 @@ var makeConnectMcpServerContract = (ids) => {
12292
12337
  };
12293
12338
  };
12294
12339
 
12340
+ // node_modules/@qawolf/api-contracts/dist/v1/narratedRecording/get.js
12341
+ var makeGetNarratedRecordingContract = (ids) => {
12342
+ const input = object({
12343
+ narratedRecordingId: string2().min(1).describe("The id of the narrated recording: the last segment of its video page URL, .../<workspace>/bug-report-video/<narratedRecordingId>."),
12344
+ workspaceId: ids.workspace.optional().describe("The workspace the narrated recording belongs to. Required when authenticating with an organization or user API key. Read it from whoami.")
12345
+ });
12346
+ const output = object({
12347
+ exportFailureMessage: string2().optional().describe("Why the export failed, when it failed and said why."),
12348
+ exportStatus: _enum(["not-requested", "pending", "ready", "failed"]).describe("Where the voiced video export is. pending: it is rendering, so check again in a minute. ready: video holds its links. failed: the export stopped; exportFailureMessage may say why. not-requested: no export was asked for yet."),
12349
+ narratedRecordingId: string2(),
12350
+ url: url().describe("The QA Wolf video page that plays the narrated recording. Share it with people; it stays stable."),
12351
+ video: object({
12352
+ downloadUrl: url().describe("Signed link that downloads the voiced mp4 instead of playing it."),
12353
+ durationMs: number2().positive(),
12354
+ expiresAt: exports_iso.datetime().describe("When the signed links stop working. Call narratedRecording.get again for fresh ones after it."),
12355
+ posterUrl: url().optional().describe("Signed link to an animated webp preview, when one exists."),
12356
+ subtitlesUrl: url().describe("Signed link to the WebVTT subtitles of the narration."),
12357
+ videoUrl: url().describe("Signed link that plays the voiced mp4 with the narration baked in.")
12358
+ }).optional().describe("The exported voiced video. Present only when exportStatus is ready. Its signed links stop working at expiresAt, so read this again for fresh links instead of storing them.")
12359
+ });
12360
+ return {
12361
+ annotationJustifications: {
12362
+ destructiveHint: "Does not change, re-export or delete the recording.",
12363
+ openWorldHint: "Reads QA Wolf workspace storage without changing the application under test.",
12364
+ readOnlyHint: "Reads a narrated recording's export status and signed video links."
12365
+ },
12366
+ annotations: {
12367
+ destructiveHint: false,
12368
+ openWorldHint: false,
12369
+ readOnlyHint: true
12370
+ },
12371
+ description: "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.",
12372
+ input,
12373
+ kind: "read",
12374
+ name: "narratedRecording.get",
12375
+ output
12376
+ };
12377
+ };
12378
+
12295
12379
  // node_modules/@qawolf/api-contracts/dist/v1/run/investigationSessionId.js
12296
12380
  var investigationSessionId = string2().trim().min(1).max(100).optional();
12297
12381
 
@@ -12485,7 +12569,7 @@ var runBuildVersionSchema = object({
12485
12569
  buildId: buildIdSchema,
12486
12570
  version: string2().optional()
12487
12571
  }).optional().describe("The run's build of this app. Absent for an app it got none of."),
12488
- kind: extensibleValue(["build", "info"], "build: the run got a build of this app. info: any other app an attempt installed, such as a companion app. It has no warnings."),
12572
+ kind: extensibleValue(["build", "info"], "build: the run got a build of this app. info: any other app an attempt installed, such as a companion app. Its only warning is changedDuringRun."),
12489
12573
  observed: array(object({
12490
12574
  attempts: attemptCount,
12491
12575
  buildId: buildIdSchema.optional().describe("Absent when the file is not one of the team's builds."),
@@ -12493,7 +12577,7 @@ var runBuildVersionSchema = object({
12493
12577
  })).describe("What attempts installed, one entry per build or version."),
12494
12578
  platform: buildPlatformSchema,
12495
12579
  unreportedAttempts: number2().int().nonnegative().describe("Finished attempts that reported no installed app, such as web attempts or attempts on an older Flows SDK."),
12496
- warnings: array(extensibleValue(["changedDuringRun", "notTested", "unknownApp"], "changedDuringRun: attempts installed different builds of the run's app. notTested: attempts installed files on this platform that could be this app, but none installed the run's build. An install of another app never counts. unknownApp: an attempt installed a file of this app that is not the run's build.")).describe("Why the installed apps may not be what the run should test.")
12580
+ warnings: array(extensibleValue(["changedDuringRun", "notTested", "unknownApp"], "changedDuringRun: attempts installed different builds of the run's app, or different versions of an info app. notTested: attempts installed files on this platform that could be this app, but none installed the run's build. An install of another app never counts. unknownApp: an attempt installed a file of this app that is not the run's build.")).describe("Why the installed apps may not be what the run should test.")
12497
12581
  });
12498
12582
  var runSiteVersionSchema = object({
12499
12583
  expected: object({
@@ -13342,6 +13426,9 @@ var makeContractsV1 = (ids) => {
13342
13426
  mcpServer: {
13343
13427
  connect: makeConnectMcpServerContract(resolvedIds)
13344
13428
  },
13429
+ narratedRecording: {
13430
+ get: makeGetNarratedRecordingContract(resolvedIds)
13431
+ },
13345
13432
  promotion: makePromotionContracts(resolvedIds),
13346
13433
  run: {
13347
13434
  acceptScreenshotBaseline: makeAcceptScreenshotBaselineContract(resolvedIds),
@@ -18141,4 +18228,4 @@ export {
18141
18228
  createRunnerSdk
18142
18229
  };
18143
18230
 
18144
- //# debugId=706D757BA902B47B64756E2164756E21
18231
+ //# debugId=1A80CC3801EFA71A64756E2164756E21
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@qawolf/cli",
3
- "version": "2.9.0",
3
+ "version": "2.10.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.129.0",
75
+ "@qawolf/api-contracts": "0.130.0",
76
76
  "@qawolf/emails": "1.1.1",
77
77
  "@qawolf/flow-targets": "2.0.0",
78
78
  "commander": "14.0.3",
@@ -206,6 +206,7 @@ that `url`; never guess a route and never send a repository link in its place.
206
206
  | `qawolf legacyTrigger pause` | write | Pause one legacy trigger, the older per-environment kind, so it stops firing; use trigger.pause for a current one. Its copies in pull request environments pause too. For migration only; it goes when legacy triggers go. |
207
207
  | `qawolf legacyTrigger resume` | write | Resume one legacy trigger, the older per-environment kind; use trigger.resume for a current one. Its copies in pull request environments resume too, and a scheduled one jumps to the next upcoming slot even if it was not paused. For migration only; it goes when legacy triggers go. |
208
208
  | `qawolf mcpServer connect` | write | Start connecting an MCP server from the workspace's catalog, such as Linear, so Tester can use its tools. Returns a sign-in link to show the user. |
209
+ | `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. |
209
210
  | `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. |
210
211
  | `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. |
211
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,7 +211,7 @@ Every documented field of the `run.get` response. `[]` marks an array, so
211
211
  - `buildVersions[].appId` — The package name (Android) or bundle ID (iOS) of the app.
212
212
  - `buildVersions[].expected` — The run's build of this app. Absent for an app it got none of.
213
213
  - `buildVersions[].expected.buildId` — The id of the build, from build.requestUpload.
214
- - `buildVersions[].kind` — One of build, info; newer servers may add values, so ignore any you don't know. build: the run got a build of this app. info: any other app an attempt installed, such as a companion app. It has no warnings.
214
+ - `buildVersions[].kind` — One of build, info; newer servers may add values, so ignore any you don't know. build: the run got a build of this app. info: any other app an attempt installed, such as a companion app. Its only warning is changedDuringRun.
215
215
  - `buildVersions[].observed` — What attempts installed, one entry per build or version.
216
216
  - `buildVersions[].observed[].attempts` — How many attempts reported it.
217
217
  - `buildVersions[].observed[].buildId` — Absent when the file is not one of the team's builds.