@qawolf/cli 2.13.1 → 2.14.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/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@qawolf/cli",
3
- "version": "2.13.1",
3
+ "version": "2.14.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.135.0",
75
+ "@qawolf/api-contracts": "0.142.0",
76
76
  "@qawolf/emails": "1.1.1",
77
77
  "@qawolf/flow-targets": "2.0.0",
78
78
  "commander": "14.0.3",
@@ -146,13 +146,14 @@ that `url`; never guess a route and never send a repository link in its place.
146
146
  | `qawolf auth switch` | local | Choose which workspace to work in |
147
147
  | `qawolf auth whoami` | read | Show authentication status |
148
148
  | `qawolf build create` | write | Create a build from a file uploaded with build.requestUpload. Reads the app ID, name, version and build number from the file before it answers, or refuses a file that isn't an app. Calling it again with the same buildId answers the build the first call created, unchanged: a repeated call's branch, commitSha and environment are ignored. |
149
- | `qawolf build delete` | write | Delete a build. Runs never install a deleted build. Deleting an environment's latest build makes the previous one its latest. Runs install that build only if its file is still kept: only the latest builds of static environments are kept past the bucket's expiry, 180 days after upload on QA Wolf's cloud. Answers the build with deletedAt set. Deleting a deleted build answers it unchanged. |
149
+ | `qawolf build delete` | write | Delete a build. Runs never install a deleted build. Deleting an environment's latest build makes the previous one its latest. Runs install that build only if its file is still kept. On QA Wolf's cloud, the latest builds of static environments are always kept. Otherwise the newest 50 builds of each app and platform in an environment, and the newest 100 with no environment, are kept up to 180 days after upload; older ones are deleted 7 days after they fall out. The builds of a terminated preview environment are deleted 7 days after it terminates. Answers the build with deletedAt set. Deleting a deleted build answers it unchanged. |
150
150
  | `qawolf build get` | read | Get a build: its app, platform, version and environment. Deleted builds are returned too. |
151
151
  | `qawolf build list` | read | List the workspace's undeleted builds, newest first. With latestOnly, list what the environment's next run installs. |
152
152
  | `qawolf build requestDownload` | read | Get a URL to download a build's file. Deleted builds can be downloaded while their file exists. Answers 404 when the file has expired. |
153
- | `qawolf build requestUpload` | write | Get a URL to upload an app build: an .apk, .aab or .ipa, up to 1 GB by default. PUT the file there with uploadHeaders, then call build.create with the buildId. |
154
- | `qawolf build upload` | write | Upload an app file (.apk, .aab or .ipa, up to 1 GB by default) and create a build from it. Runs build requestUpload, the PUT and build create in one step |
153
+ | `qawolf build requestUpload` | write | Get a URL to upload an app build: an .apk, .aab, .ipa, or a Linux Electron app as a .deb or .rpm, up to 1 GB by default. PUT the file there with uploadHeaders, then call build.create with the buildId. |
154
+ | `qawolf build upload` | write | Upload an app file (.apk, .aab, .ipa, or a Linux Electron .deb or .rpm, up to 1 GB by default) and create a build from it. Runs build requestUpload, the PUT and build create in one step |
155
155
  | `qawolf codeHostIntegration find` | read | List the workspace's code host integrations (GitHub or GitLab). A connected integration lets QA Wolf read repositories and receive the code host's webhooks. codeHostIntegration.listRepositories pages the repositories each integration covers. |
156
+ | `qawolf codeHostIntegration findForRepository` | read | Check whether QA Wolf can read a repository through the workspace's code host integrations, and what it can access: the repository's code and its pull requests. A CI job calls this before reporting a deployment to decide which changes to include. Not covered means QA Wolf only knows the changes the report includes; settingsUrl is where a workspace admin connects the code host. |
156
157
  | `qawolf codeHostIntegration listRepositories` | read | List the repositories the workspace's code host integrations cover, alphabetical by full name. The list reflects the last sync from the code host; codeHostIntegration.find lists the integrations themselves. |
157
158
  | `qawolf deployment find` | read | List the deployments QA Wolf has received for the workspace, newest first. A deployment arrives through a code host integration's webhook or through deployment.reportStatus, and is what a deployment trigger evaluates against. deployment.listTriggerEvaluations reports each trigger's verdict for one deployment. |
158
159
  | `qawolf deployment listTriggerEvaluations` | read | List the per-trigger verdicts recorded when a deployment was evaluated against the workspace's triggers. Each verdict says whether the trigger matched, did not match with the reason per condition, or was never considered and why. Verdicts are a snapshot from evaluation time: editing or deleting a trigger later does not change them. |
@@ -199,7 +200,10 @@ that `url`; never guess a route and never send a repository link in its place.
199
200
  | `qawolf issue get` | read | Get an issue by id. |
200
201
  | `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. |
201
202
  | `qawolf issue listComments` | read | List the comments on a bug report, blocker (issue type `maintenance`), or coverage request, oldest first, with who wrote each one. |
203
+ | `qawolf issue markFixReadyForReview` | write | Mark the draft pull request of the bug's fix ready for review, so the code host asks its code owners. The pull request stays a draft unless a loop's instructions ask for this. Only a QA Wolf session that a loop started can call it. Refused as no-fix-pull-request when the bug's fix has no open pull request. |
202
204
  | `qawolf issue removeFlows` | write | Remove flows from a coverage request or remove bug report or blocker reproductions in an environment. Unlinked flows are left alone. Reports auto-close when no active reproductions remain and auto-close is enabled. For reports, omit environmentId only when each selected flow is linked in at most one environment. |
205
+ | `qawolf issue requestFix` | write | Hand a bug report to the team's own coding agent, which fixes it in the team's CI. Only a QA Wolf session that a loop started can call it, when the loop's instructions use /coding-agent. A bug has one open fix: a second request returns that fix. |
206
+ | `qawolf issue retryFix` | write | Ask the team's coding agent for one more try at a bug that the check of its fix still shows. QA Wolf sends the same agent the failure of the check's run, as a new fix on the same branch, and checks again. Only a QA Wolf session that a loop started can call it, when the loop's instructions ask for it. A bug gets one extra try at most. Refused as bug-not-still-showing when the check of the bug's fix does not show the bug, and as no-tries-left after the extra try. |
203
207
  | `qawolf issue update` | write | Update an issue owned by the caller's team. Omitted fields remain unchanged. |
204
208
  | `qawolf legacyTrigger find` | read | List a workspace's legacy per-environment triggers; trigger.find lists the current ones. For migration only; it goes when legacy triggers go. adaptiveFlowSelection becomes a generativeSuite action, which takes no tags. |
205
209
  | `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. |
@@ -255,13 +259,14 @@ that `url`; never guess a route and never send a repository link in its place.
255
259
  | `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. |
256
260
  | `qawolf tag create` | write | Create a tag on the caller's team. Tags select flows in run.create. |
257
261
  | `qawolf tag list` | read | List the team's tags, alphabetical by name. Tag names select flows in run.create. |
258
- | `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. |
262
+ | `qawolf trigger create` | write | Create a trigger. A schedule trigger fires on a cadence; a deployment trigger fires when a matching deployment is reported. Its action runs flows, or, as startAgent, starts a QA Wolf session that carries out its instructions. A startAgent trigger made with a team API key has no owner, so it stays paused until a person takes ownership of it in the app. |
259
263
  | `qawolf trigger delete` | write | Delete a trigger permanently. The runs it already created are kept. To stop a trigger without losing it, use trigger.pause. |
260
264
  | `qawolf trigger find` | read | List the team's triggers, newest first. |
261
265
  | `qawolf trigger get` | read | Get one trigger by id. |
262
266
  | `qawolf trigger pause` | write | Pause a trigger so it stops firing. Pausing is idempotent. A team whose triggers are all paused reports no trigger activity at all. |
263
267
  | `qawolf trigger resume` | write | Resume a paused trigger. A schedule trigger restarts from the next upcoming slot: the slots it missed while paused do not run. |
264
- | `qawolf trigger update` | write | Replace a trigger's configuration. Every field is written, so read the trigger first and send its configuration back with your changes applied. Pausing is separate: use trigger.pause and trigger.resume. |
268
+ | `qawolf trigger update` | write | Replace a trigger's configuration. Every configuration field is written, so read the trigger first and send its definition back with your changes applied. isPaused and description are kept when omitted. |
269
+ | `qawolf usage breakdown` | read | Show where credits went over a range of UTC days, grouped by time, workspace, environment, platform, source, trigger or user. Use it to find what uses the most credits, or to build a usage dashboard. Credits only, no dollar amounts. |
265
270
 
266
271
  <!-- commands-table:end -->
267
272
 
@@ -326,8 +331,8 @@ by default.
326
331
 
327
332
  ## Uploading an app build: `build upload`
328
333
 
329
- `qawolf build upload <file>` uploads an `.apk`, `.aab` or `.ipa` and creates a
330
- build from it in one step. Use it instead of `build requestUpload`, a PUT and
334
+ `qawolf build upload <file>` uploads an `.apk`, `.aab`, `.ipa`, or a Linux
335
+ Electron `.deb` or `.rpm`, and creates a build from it in one step. Use it instead of `build requestUpload`, a PUT and
331
336
  `build create` whenever the file is on this machine.
332
337
 
333
338
  Without an environment flag, the build belongs to no environment: only a run
@@ -193,19 +193,19 @@ Every documented field of the `run.get` response. `[]` marks an array, so
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
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
- - `builds[].appId` — The package name (Android) or bundle ID (iOS) read from the file. A flow launches it with `launch({ app: { id } })`.
196
+ - `builds[].appId` — The package name (Android, Linux) 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.
199
- - `builds[].buildNumber` — versionCode (Android) or CFBundleVersion (iOS), when the file has one.
199
+ - `builds[].buildNumber` — versionCode (Android), CFBundleVersion (iOS) or RPM release (Linux), when the file has one.
200
200
  - `builds[].commitSha` — The commit the uploader said the build came from.
201
201
  - `builds[].createdAt` — When the build was created.
202
202
  - `builds[].deletedAt` — When the build was deleted. Runs never install it after.
203
203
  - `builds[].environmentId` — The environment whose runs install the build while it is the newest one there for its app and platform. Absent: only a run created with the build installs it.
204
204
  - `builds[].fileName` — The uploaded file's name.
205
205
  - `builds[].id` — The id of the build, from build.requestUpload.
206
- - `builds[].platform` — One of: android, ios
206
+ - `builds[].platform` — One of android, ios, linux; newer servers may add values, so ignore any you don't know. The OS the build runs on, read from its file type. `linux` builds are Electron apps that Electron flows launch.
207
207
  - `builds[].sizeBytes` — The file's size in bytes.
208
- - `builds[].version` — versionName (Android) or CFBundleShortVersionString (iOS), when the file has one.
208
+ - `builds[].version` — versionName (Android), CFBundleShortVersionString (iOS) or package version (Linux), when the file has one.
209
209
  - `builds[].url` — Absolute URL of the team's Builds page.
210
210
  - `buildVersions` — 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.
211
211
  - `buildVersions[].appId` — The package name (Android) or bundle ID (iOS) of the app.
@@ -215,12 +215,13 @@ Every documented field of the `run.get` response. `[]` marks an array, so
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.
218
- - `buildVersions[].platform` — One of: android, ios
218
+ - `buildVersions[].platform` — One of android, ios, linux; newer servers may add values, so ignore any you don't know. The OS the build runs on, read from its file type. `linux` builds are Electron apps that Electron flows launch.
219
219
  - `buildVersions[].unreportedAttempts` — Finished attempts that reported no installed app, such as web attempts or attempts on an older Flows SDK.
220
220
  - `buildVersions[].warnings` — Why the installed apps may not be what the run should test.
221
221
  - `flows` — The run's flows, ordered alphabetically by name. Only the flows matching flowStatuses when the request set it.
222
222
  - `flows[].attempts` — The flow's finished execution attempts, oldest first, including manual Wolf Browser attempts. Present once at least one attempt has finished, so a flow that passed after retries also lists its failed attempts. Artifact URLs appear only on attempts that reached a verdict, and on a manual attempt only when its Wolf Browser run kept them. They stay valid for at least a day (call run.get again for fresh ones), and can return 404 when the attempt did not produce that artifact.
223
223
  - `flows[].attempts[].logsUrl` — Signed URL for the attempt's execution logs.
224
+ - `flows[].attempts[].networkLogsUrl` — Signed URL for the attempt's iOS network log, as NDJSON: request and connection lines are HAR 1.2 entries, DNS and WebSocket lines are `_qawolf` objects, and the last line is a summary. For up to 2 minutes after the attempt ends, the file can be partial or 404 while the runner uploads it; it is final once the summary line is there. Signed for every attempt; after that, a 404 means the attempt captured no network.
224
225
  - `flows[].attempts[].traceUrl` — Signed URL for the attempt's Playwright trace (a trace.zip; open it with `npx playwright show-trace`).
225
226
  - `flows[].attempts[].videoUrl` — Signed URL for the attempt's screen recording.
226
227
  - `flows[].attempts[].attemptId` — The id of the run attempt.