@qawolf/cli 2.11.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
@@ -18158,7 +18158,7 @@ var makeResolvePromotionContract = (ids) => {
18158
18158
  openWorldHint: false,
18159
18159
  readOnlyHint: false
18160
18160
  },
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. 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.",
18162
18162
  input,
18163
18163
  kind: "write",
18164
18164
  name: "promotion.resolve",
@@ -21770,8 +21770,12 @@ var issueCommentAuthorSchema = discriminatedUnion("type", [
21770
21770
  }),
21771
21771
  object({ type: literal("former-user") }),
21772
21772
  object({ type: literal("team-api-key") }),
21773
- object({ type: literal("system") })
21774
- ]).describe("Who wrote the comment: a person, a person whose account was since deleted (`former-user`), an API key of the team or its organization (`team-api-key`), or QA Wolf itself (`system`).");
21773
+ object({ type: literal("system") }),
21774
+ object({
21775
+ name: string2().optional().describe("Their name in Slack. Absent when Slack could not say."),
21776
+ type: literal("slack-user")
21777
+ })
21778
+ ]).describe("Who wrote the comment: a person, a person whose account was since deleted (`former-user`), an API key of the team or its organization (`team-api-key`), QA Wolf itself (`system`), or someone who replied in the bug's Slack thread whom QA Wolf could not match to a member of the team (`slack-user`).");
21775
21779
  var makeIssueCommentResourceSchema = (ids) => resource({
21776
21780
  author: issueCommentAuthorSchema,
21777
21781
  body: string2().describe("The comment in GitHub-flavored Markdown."),
@@ -22359,6 +22363,21 @@ var makeFindRunsContract = (ids) => {
22359
22363
  };
22360
22364
  };
22361
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
+
22362
22381
  // node_modules/@qawolf/api-contracts/dist/v1/run/flowAttempts.js
22363
22382
  var makeFlowAttemptsSchema = (ids) => {
22364
22383
  const artifactUrls = {
@@ -22412,6 +22431,10 @@ var makeFlowAttemptsSchema = (ids) => {
22412
22431
 
22413
22432
  // node_modules/@qawolf/api-contracts/dist/v1/run/flowFailure.js
22414
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.");
22415
22438
  const diagnosis = object({
22416
22439
  issueId: ids.issue,
22417
22440
  type: _enum(["bug", "maintenance"])
@@ -22420,6 +22443,7 @@ var makeFlowFailureSchema = (ids) => {
22420
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.")
22421
22444
  }).optional().describe('Present when the failure was marked "do not investigate" (DNI): ' + "it will get no bug or maintenance verdict.");
22422
22445
  return object({
22446
+ blockedBy,
22423
22447
  diagnosis,
22424
22448
  error: string2(),
22425
22449
  optedOutOfInvestigation
@@ -22485,9 +22509,10 @@ var makeGetRunContract = (ids) => {
22485
22509
  const output = resource({
22486
22510
  ...makeRunSummaryFields(ids),
22487
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."),
22488
- builds: array(makeBuildResourceSchema(ids)).describe("The builds the run installs, one per app and platform. Empty when the run has none."),
22512
+ builds: array(makeBuildResourceSchema(ids)).describe("The builds the run got that its flows installed, one per app and platform: a build counts once a finished or stopped attempt reported installing it. Empty while no attempt has, and when the run got none. `buildVersions[].expected` names the build the run got for each app."),
22489
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."),
22490
22514
  flows,
22515
+ runAlertNotifications: runAlertNotificationsSchema,
22491
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."),
22492
22517
  siteVersions: array(runSiteVersionSchema).describe("The versions the run's attempts saw on each site origin, with warnings. Empty when no attempt reported one."),
22493
22518
  waitSeconds: number2().int().optional().describe("The hold this check was allowed, in seconds, after clamping. Absent when the check did not wait."),
@@ -25948,7 +25973,7 @@ function startUpdateCheck(deps) {
25948
25973
  // package.json
25949
25974
  var package_default = {
25950
25975
  name: "@qawolf/cli",
25951
- version: "2.11.0",
25976
+ version: "2.12.0",
25952
25977
  description: "Run and manage QA Wolf flows from the terminal, CI, or an AI agent",
25953
25978
  keywords: [
25954
25979
  "automation",
@@ -26020,7 +26045,7 @@ var package_default = {
26020
26045
  "@clack/prompts": "1.5.1",
26021
26046
  "@napi-rs/keyring": "1.3.0",
26022
26047
  "@oxc-node/core": "0.1.0",
26023
- "@qawolf/api-contracts": "0.132.0",
26048
+ "@qawolf/api-contracts": "0.134.0",
26024
26049
  "@qawolf/emails": "1.1.1",
26025
26050
  "@qawolf/flow-targets": "2.0.0",
26026
26051
  commander: "14.0.3",
@@ -44634,4 +44659,4 @@ createProgram({ signals }).parseAsync().catch(() => {
44634
44659
  process.exitCode = 1;
44635
44660
  }).finally(() => exitWhenIdle(typeof process.exitCode === "number" ? process.exitCode : 0));
44636
44661
 
44637
- //# debugId=114AC29954890FBA64756E2164756E21
44662
+ //# debugId=36A5EEFD853AC29364756E2164756E21
@@ -8343,7 +8343,7 @@ var makeResolvePromotionContract = (ids) => {
8343
8343
  openWorldHint: false,
8344
8344
  readOnlyHint: false
8345
8345
  },
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. 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.",
8347
8347
  input,
8348
8348
  kind: "write",
8349
8349
  name: "promotion.resolve",
@@ -11962,8 +11962,12 @@ var issueCommentAuthorSchema = discriminatedUnion("type", [
11962
11962
  }),
11963
11963
  object({ type: literal("former-user") }),
11964
11964
  object({ type: literal("team-api-key") }),
11965
- object({ type: literal("system") })
11966
- ]).describe("Who wrote the comment: a person, a person whose account was since deleted (`former-user`), an API key of the team or its organization (`team-api-key`), or QA Wolf itself (`system`).");
11965
+ object({ type: literal("system") }),
11966
+ object({
11967
+ name: string2().optional().describe("Their name in Slack. Absent when Slack could not say."),
11968
+ type: literal("slack-user")
11969
+ })
11970
+ ]).describe("Who wrote the comment: a person, a person whose account was since deleted (`former-user`), an API key of the team or its organization (`team-api-key`), QA Wolf itself (`system`), or someone who replied in the bug's Slack thread whom QA Wolf could not match to a member of the team (`slack-user`).");
11967
11971
  var makeIssueCommentResourceSchema = (ids) => resource({
11968
11972
  author: issueCommentAuthorSchema,
11969
11973
  body: string2().describe("The comment in GitHub-flavored Markdown."),
@@ -12551,6 +12555,21 @@ var makeFindRunsContract = (ids) => {
12551
12555
  };
12552
12556
  };
12553
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
+
12554
12573
  // node_modules/@qawolf/api-contracts/dist/v1/run/flowAttempts.js
12555
12574
  var makeFlowAttemptsSchema = (ids) => {
12556
12575
  const artifactUrls = {
@@ -12604,6 +12623,10 @@ var makeFlowAttemptsSchema = (ids) => {
12604
12623
 
12605
12624
  // node_modules/@qawolf/api-contracts/dist/v1/run/flowFailure.js
12606
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.");
12607
12630
  const diagnosis = object({
12608
12631
  issueId: ids.issue,
12609
12632
  type: _enum(["bug", "maintenance"])
@@ -12612,6 +12635,7 @@ var makeFlowFailureSchema = (ids) => {
12612
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.")
12613
12636
  }).optional().describe('Present when the failure was marked "do not investigate" (DNI): ' + "it will get no bug or maintenance verdict.");
12614
12637
  return object({
12638
+ blockedBy,
12615
12639
  diagnosis,
12616
12640
  error: string2(),
12617
12641
  optedOutOfInvestigation
@@ -12677,9 +12701,10 @@ var makeGetRunContract = (ids) => {
12677
12701
  const output = resource({
12678
12702
  ...makeRunSummaryFields(ids),
12679
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."),
12680
- builds: array(makeBuildResourceSchema(ids)).describe("The builds the run installs, one per app and platform. Empty when the run has none."),
12704
+ builds: array(makeBuildResourceSchema(ids)).describe("The builds the run got that its flows installed, one per app and platform: a build counts once a finished or stopped attempt reported installing it. Empty while no attempt has, and when the run got none. `buildVersions[].expected` names the build the run got for each app."),
12681
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."),
12682
12706
  flows,
12707
+ runAlertNotifications: runAlertNotificationsSchema,
12683
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."),
12684
12709
  siteVersions: array(runSiteVersionSchema).describe("The versions the run's attempts saw on each site origin, with warnings. Empty when no attempt reported one."),
12685
12710
  waitSeconds: number2().int().optional().describe("The hold this check was allowed, in seconds, after clamping. Absent when the check did not wait."),
@@ -18412,4 +18437,4 @@ export {
18412
18437
  createRunnerSdk
18413
18438
  };
18414
18439
 
18415
- //# debugId=BBFB581D3BFFB3C364756E2164756E21
18440
+ //# debugId=940E5D66DC71ADE164756E2164756E21
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@qawolf/cli",
3
- "version": "2.11.0",
3
+ "version": "2.12.0",
4
4
  "description": "Run and manage QA Wolf flows from the terminal, CI, or an AI agent",
5
5
  "keywords": [
6
6
  "automation",
@@ -72,7 +72,7 @@
72
72
  "@clack/prompts": "1.5.1",
73
73
  "@napi-rs/keyring": "1.3.0",
74
74
  "@oxc-node/core": "0.1.0",
75
- "@qawolf/api-contracts": "0.132.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",
@@ -209,7 +209,7 @@ that `url`; never guess a route and never send a repository link in its place.
209
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. |
210
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. |
211
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. Returns the promotion in resolving; poll promotion.get until it is promoted, or conflicted again if the branches moved while it applied. |
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. |
@@ -192,7 +192,7 @@ Every documented field of the `run.get` response. `[]` marks an array, so
192
192
  - `supersededBy.runId` — The id of the run.
193
193
  - `supersededBy.url` — Absolute URL of the replacement run's page.
194
194
  - `blockingBugCount` — How many bugs this run found are blocking: still open, and priority urgent, high, or unprioritized — unprioritized counts because nobody has ruled it out yet. This is what `failed` is derived from, so it explains a failure rather than adding a second verdict: gate on `status`, then read this to say how many bugs are holding the build. It counts a bug filed against a later run by an investigation that carried over from this one, and it drops a bug once that bug is resolved.
195
- - `builds` — The builds the run installs, one per app and platform. Empty when the run has none.
195
+ - `builds` — The builds the run got that its flows installed, one per app and platform: a build counts once a finished or stopped attempt reported installing it. Empty while no attempt has, and when the run got none. `buildVersions[].expected` names the build the run got for each app.
196
196
  - `builds[].appId` — The package name (Android) or bundle ID (iOS) read from the file. A flow launches it with `launch({ app: { id } })`.
197
197
  - `builds[].appName` — The app's display name, when the file names one.
198
198
  - `builds[].branch` — The branch the uploader said the build came from.
@@ -229,6 +229,8 @@ Every documented field of the `run.get` response. `[]` marks an array, so
229
229
  - `flows[].attempts[].status` — One of: passed, failed, canceled
230
230
  - `flows[].attempts[].url` — Absolute URL of the attempt's page in the app, which opens this flow at this attempt. Link this page to show one flow's attempt: the run page opens a different flow. Absent only in replies from servers older than this field.
231
231
  - `flows[].attempts[].canceledReason` — Why the attempt was canceled. userCanceled means a person stopped it; do not immediately retry that activity.
232
+ - `flows[].failure.blockedBy` — Present when the flow never started because flows it depends on failed in this run. This flow has no failure of its own: the named flows' failures explain it, and it runs again in the next run after those flows pass.
233
+ - `flows[].failure.blockedBy[].flowId` — The id of the flow.
232
234
  - `flows[].failure.diagnosis` — QA Wolf's investigation verdict for the failure: `bug` means the application is broken, `maintenance` means the test needed an update and the failure does not indicate an application problem. Absent until the investigation reaches a verdict, and absent when the flow was opted out of investigation. Pass issueId to issue.get for details.
233
235
  - `flows[].failure.diagnosis.issueId` — The id of the issue.
234
236
  - `flows[].failure.diagnosis.type` — One of: bug, maintenance
@@ -236,6 +238,13 @@ Every documented field of the `run.get` response. `[]` marks an array, so
236
238
  - `flows[].failure.optedOutOfInvestigation.by` — One of: user, system
237
239
  - `flows[].flowId` — The id of the flow.
238
240
  - `flows[].status` — One of: failed, queued, running, passed, canceled
241
+ - `runAlertNotifications` — Where QA Wolf sent this run's alert, oldest first. Empty when it was not sent anywhere. Lists only destinations your team can see: your own Slack's channels, and QA Wolf's channels shared through Slack Connect. A destination QA Wolf could not check with Slack just now is left out, so if an entry you expect is missing, ask again later.
242
+ - `runAlertNotifications[].destination` — Where on the channel the alert went.
243
+ - `runAlertNotifications[].destination.channelId` — The Slack channel's id.
244
+ - `runAlertNotifications[].destination.workspaceId` — The Slack workspace the channel is in (Slack's team id), not a QA Wolf workspace.
245
+ - `runAlertNotifications[].messageId` — The alert's message at that destination. In Slack this is the message's `ts`: pass it as `thread_ts` to reply in the alert's thread.
246
+ - `runAlertNotifications[].permalink` — Link to the message. Absent for the moment between sending and the provider returning one.
247
+ - `runAlertNotifications[].sentAt` — When the alert's message was sent. In Slack this is the time in its `ts`, which stays the same when QA Wolf later updates the message.
239
248
  - `siteVersions` — The versions the run's attempts saw on each site origin, with warnings. Empty when no attempt reported one.
240
249
  - `siteVersions[].expected` — The commit the run should see. Only on the origin the deployment reported as its target. Absent when no deployment names a commit and a target, or the deployment has a service.
241
250
  - `siteVersions[].expected.from` — One of deployment, latestDeployment; newer servers may add values, so ignore any you don't know. deployment: the run's own deployment. latestDeployment: the environment's latest successful deployment before the run.