@qawolf/cli 2.9.0 → 2.11.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 +376 -105
- package/dist/runner-sdk.js +373 -102
- package/package.json +2 -2
- package/skills/qawolf-cli/SKILL.md +6 -2
- package/skills/qawolf-cli/references/run-results.md +1 -1
- package/skills/qawolf-cli/references/runner.md +6 -6
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@qawolf/cli",
|
|
3
|
-
"version": "2.
|
|
3
|
+
"version": "2.11.0",
|
|
4
4
|
"description": "Run and manage QA Wolf flows from the terminal, CI, or an AI agent",
|
|
5
5
|
"keywords": [
|
|
6
6
|
"automation",
|
|
@@ -72,7 +72,7 @@
|
|
|
72
72
|
"@clack/prompts": "1.5.1",
|
|
73
73
|
"@napi-rs/keyring": "1.3.0",
|
|
74
74
|
"@oxc-node/core": "0.1.0",
|
|
75
|
-
"@qawolf/api-contracts": "0.
|
|
75
|
+
"@qawolf/api-contracts": "0.132.0",
|
|
76
76
|
"@qawolf/emails": "1.1.1",
|
|
77
77
|
"@qawolf/flow-targets": "2.0.0",
|
|
78
78
|
"commander": "14.0.3",
|
|
@@ -195,7 +195,6 @@ that `url`; never guess a route and never send a repository link in its place.
|
|
|
195
195
|
| `qawolf issue attachFiles` | write | Attach files from the team's storage to a bug report or coverage request owned by the caller's team, for example the files a bug was reproduced with or the test data a flow should use. Files already attached stay attached. Upload a file with file.requestUpload first. |
|
|
196
196
|
| `qawolf issue comment` | write | Comment on a bug report, blocker (issue type `maintenance`), or coverage request owned by the caller's team. The comment changes nothing else on the issue, such as its status or priority. |
|
|
197
197
|
| `qawolf issue create` | write | Create a bug report, blocker (issue type `maintenance`), or coverage request issue for the caller's team. A user can create a blocker only when they can see the workspace's blockers; a team or organization API key credits it to the workspace's automation user. Link its failed flows afterwards with run.diagnose. |
|
|
198
|
-
| `qawolf issue decideSuggestion` | write | Decide a coverage request or bug report that QA Wolf suggested after exploring an environment. Add turns on the suggested flow in the environment. Report files a potential bug. Skip declines the suggestion. Undo takes back a decision before the flow joins. The issue's status follows the decision, so change the status only through this tool while the suggestion is undecided. |
|
|
199
198
|
| `qawolf issue find` | read | List the team's bug reports, blockers, or coverage requests, newest first. |
|
|
200
199
|
| `qawolf issue get` | read | Get an issue by id. |
|
|
201
200
|
| `qawolf issue listActivity` | read | List an issue's activity, oldest first: creation, status and priority changes, and the flows that started or stopped reproducing it. Use it to measure time to fix or to find issues that came back. |
|
|
@@ -206,8 +205,10 @@ that `url`; never guess a route and never send a repository link in its place.
|
|
|
206
205
|
| `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
206
|
| `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
207
|
| `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. |
|
|
208
|
+
| `qawolf narratedRecording get` | read | Get a narrated recording's voiced video: its video page URL, its export status, and, once the export is ready, its duration and signed links to the mp4 with the voiceover baked in and its subtitles. Signed links stop working at video.expiresAt; the video page URL stays stable. While exportStatus is pending, check again later. |
|
|
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
|
+
| `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. |
|
|
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. |
|
|
212
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. |
|
|
213
214
|
| `qawolf run create` | write | Create a run for the selected flows and/or tags in an environment. |
|
|
@@ -221,7 +222,7 @@ that `url`; never guess a route and never send a repository link in its place.
|
|
|
221
222
|
| `qawolf run stop` | write | Stop a run, including its queued flows and automatic retries. Stopping is asynchronous and can update run-status messages and commit statuses in connected integrations. Repeated requests are safe, and finished runs keep their results. A run that is still being created returns not found; retry once run.get returns the run. If run.get returns a different runId, use that ID. Poll run.get for results. |
|
|
222
223
|
| `qawolf runner act` | write | Perform one raw action on a runner's screen. A browser runner takes click, double_click, scroll, move, drag, keypress, navigate and type; a mobile runner takes tap, swipe, fill and type. A browser runner answers mobile actions with action-not-supported-on-browser; a mobile runner answers the other browser actions with action-not-supported-on-mobile. Use - to read a whole action as JSON from stdin |
|
|
223
224
|
| `qawolf runner actions` | write | Perform a sequence of up to ten raw actions on a runner's screen in one request, as a JSON array of the same actions `runner act` takes. Use - to read the array from stdin. Actions run back to back, so batch only steps whose targets are on the screen you last saw, and end the sequence at the step that changes the page. Each result carries an effect: performed, not-performed, or unknown when the runner stopped answering and the action may have landed |
|
|
224
|
-
| `qawolf runner events` | read | Print a runner's journal, one entry per line. QA Wolf writes console, recorder, run-events, run-logs, run-status |
|
|
225
|
+
| `qawolf runner events` | read | Print a runner's journal, one entry per line. QA Wolf writes console, network, recorder, run-events, run-logs, run-status |
|
|
225
226
|
| `qawolf runner exec` | write | Evaluate a snippet against a runner's live page. Use - to read the snippet from stdin |
|
|
226
227
|
| `qawolf runner highlight-selector` | write | Highlight what a selector matches on a runner's live page, so the next screenshot shows it. Omit the selector to clear the highlight |
|
|
227
228
|
| `qawolf runner import-package` | write | Install a package into a runner's live run, so a snippet or a selection can import it |
|
|
@@ -247,6 +248,9 @@ that `url`; never guess a route and never send a repository link in its place.
|
|
|
247
248
|
| `qawolf runner terminate` | write | End an interactive runner, and the pod it runs on with it |
|
|
248
249
|
| `qawolf skill get` | read | Read a QA Wolf skill: the instructions a coding agent follows for one kind of QA Wolf work. The reply carries the skill's SKILL.md and every file under its references directory, so nothing else has to be fetched for it. Read the skill before starting the work it covers and follow it. A link in the reply of the form ../<skill>/SKILL.md names another skill, which this call reads by that name. |
|
|
249
250
|
| `qawolf skill list` | read | List the QA Wolf skills, each with its name and the description that says when to use it. A skill is the instructions a coding agent follows for one kind of QA Wolf work, such as onboarding an application, creating a flow, repairing a failing flow, or setting up triggers. Call this before any QA Wolf work, pick the skill whose description matches the request, and read it with skill.get. |
|
|
251
|
+
| `qawolf suggestion decide` | write | Decide a coverage suggestion QA Wolf made while exploring an environment, as the signed-in person. Add turns on the suggested flow in the environment. Report files the potential bug. Skip declines the suggestion and needs a skipReason. Undo takes back a decision. Activate retries a held suggestion. Only the decisions suggestion.get lists take effect. Use this, not issue.update, to accept or skip a suggestion. |
|
|
252
|
+
| `qawolf suggestion find` | read | List the coverage QA Wolf suggested for a workspace, newest first: flows it wrote for missing coverage and potential bugs it found while exploring an environment. Use this, not issue.find, for QA Wolf's suggestions, such as the ones a new suggestions notification points to. Filter by state waiting to find the ones that need a decision. |
|
|
253
|
+
| `qawolf suggestion get` | read | Read one coverage suggestion QA Wolf made while exploring an environment: its state, the flow it proposes, the bug report or coverage request behind it, and the decisions it takes now. Use this, not issue.get, for a suggestion id. A suggestion QA Wolf withdrew reads as not found. |
|
|
250
254
|
| `qawolf tag create` | write | Create a tag on the caller's team. Tags select flows in run.create. |
|
|
251
255
|
| `qawolf tag list` | read | List the team's tags, alphabetical by name. Tag names select flows in run.create. |
|
|
252
256
|
| `qawolf trigger create` | write | Create a trigger. A schedule trigger runs a named set of flows on a cadence; a deployment trigger runs when a matching deployment is reported. |
|
|
@@ -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.
|
|
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.
|
|
@@ -89,7 +89,7 @@ Commands:
|
|
|
89
89
|
run [options] <flowFile> Run a flow on an interactive runner, shipping the flow
|
|
90
90
|
and what it imports
|
|
91
91
|
events [options] <stream> Print a runner's journal, one entry per line. QA Wolf
|
|
92
|
-
writes console, recorder, run-events, run-logs,
|
|
92
|
+
writes console, network, recorder, run-events, run-logs,
|
|
93
93
|
run-status
|
|
94
94
|
screenshot [options] Save a JPEG of an interactive runner's screen to a file,
|
|
95
95
|
or write it to stdout with --out -
|
|
@@ -536,7 +536,7 @@ Environment variables:
|
|
|
536
536
|
```text
|
|
537
537
|
Usage: qawolf runner events [options] <stream>
|
|
538
538
|
|
|
539
|
-
Print a runner's journal, one entry per line. QA Wolf writes console, recorder, run-events,
|
|
539
|
+
Print a runner's journal, one entry per line. QA Wolf writes console, network, recorder, run-events,
|
|
540
540
|
run-logs, run-status
|
|
541
541
|
|
|
542
542
|
Options:
|
|
@@ -568,10 +568,10 @@ Examples:
|
|
|
568
568
|
Streams:
|
|
569
569
|
Everything observable is an append-only stream on the pod, read by cursor or
|
|
570
570
|
tail rather than subscribed to, so attaching late still gets you the history
|
|
571
|
-
that is still there. QA Wolf writes recorder, console, run-events,
|
|
572
|
-
and run-status; a stream nobody has written reads as empty rather
|
|
573
|
-
error, and a stream this CLI version does not know about is still
|
|
574
|
-
name. One payload per line, so shell tools compose:
|
|
571
|
+
that is still there. QA Wolf writes recorder, console, network, run-events,
|
|
572
|
+
run-logs and run-status; a stream nobody has written reads as empty rather
|
|
573
|
+
than as an error, and a stream this CLI version does not know about is still
|
|
574
|
+
readable by name. One payload per line, so shell tools compose:
|
|
575
575
|
|
|
576
576
|
$ qawolf runner events console --tail 20 | jq -r '.message'
|
|
577
577
|
$ qawolf runner events run-logs --run <runId> --follow > run.log
|