@qawolf/cli 1.39.0 → 1.41.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/README.md +25 -1
- package/dist/cli.js +1096 -119
- package/dist/investigation-parser.js +11423 -0
- package/dist/runner-sdk.js +259 -99
- package/package.json +4 -2
- package/skills/qawolf-cli/SKILL.md +13 -4
- package/skills/qawolf-cli/references/runner.md +1096 -545
package/README.md
CHANGED
|
@@ -61,11 +61,35 @@ qawolf flows run examples/example.flow.ts
|
|
|
61
61
|
| `qawolf auth` | [Authenticate with QA Wolf](https://docs.qawolf.com/qawolf/local-execution/authenticate) |
|
|
62
62
|
| `qawolf flows` | [Run flows locally](https://docs.qawolf.com/qawolf/local-execution/run-flows-locally), [pull flows](https://docs.qawolf.com/qawolf/local-execution/pull-flows) |
|
|
63
63
|
| `qawolf run` | Trigger and manage QA Wolf runs on the platform (public API) |
|
|
64
|
+
| `qawolf attempt` | Summarize and inspect a finished run attempt's trace and logs |
|
|
64
65
|
| `qawolf install` | [Install runtime dependencies](https://docs.qawolf.com/qawolf/local-execution/install-dependencies) |
|
|
65
66
|
| `qawolf init` | [Set up a local-only project](https://docs.qawolf.com/qawolf/local-execution/set-up-a-project) |
|
|
66
67
|
| `qawolf doctor` | [Diagnose problems](https://docs.qawolf.com/qawolf/local-execution/diagnose-problems) |
|
|
67
68
|
|
|
68
|
-
Run any command with `--help` for its flags and options.
|
|
69
|
+
Run any command with `--help` for its flags and options. `qawolf help ref <command>` prints the help of a command and of every command under it, as Markdown.
|
|
70
|
+
|
|
71
|
+
### Investigate a run attempt
|
|
72
|
+
|
|
73
|
+
Start with a run ID, pick an attempt ID from its failed flows, then narrow the evidence only when the summary points to it:
|
|
74
|
+
|
|
75
|
+
```bash
|
|
76
|
+
qawolf run get --run-id <run-id> --flow-statuses failed
|
|
77
|
+
qawolf attempt investigate --attempt-id <attempt-id>
|
|
78
|
+
qawolf attempt inspect --attempt-id <attempt-id> --timeline --limit 20
|
|
79
|
+
qawolf attempt inspect --attempt-id <attempt-id> --request <request-id>
|
|
80
|
+
```
|
|
81
|
+
|
|
82
|
+
`attempt inspect` requires exactly one of `--action`, `--timeline`, `--network`, `--request`, `--snapshot`, `--screenshot`, `--console`, or `--log`. Use `--evidence-id` with `--console` or `--log` to return exactly that one evidence record; the other filters are listed in `qawolf attempt inspect --help`.
|
|
83
|
+
|
|
84
|
+
Snapshot HTML can be returned directly or written to a new file. Screenshots require a file. The CLI refuses to overwrite an existing path:
|
|
85
|
+
|
|
86
|
+
```bash
|
|
87
|
+
qawolf attempt inspect --attempt-id <attempt-id> --snapshot <snapshot-id> --format html
|
|
88
|
+
qawolf attempt inspect --attempt-id <attempt-id> --snapshot <snapshot-id> --format html --output-file snapshot.html
|
|
89
|
+
qawolf attempt inspect --attempt-id <attempt-id> --screenshot <screenshot-id> --output-file screenshot.jpeg
|
|
90
|
+
```
|
|
91
|
+
|
|
92
|
+
The trace and logs are downloaded from the signed links `qawolf attempt get` returns and parsed on your machine. Downloads, output text, HTML, request bodies, and log retention are bounded; `incomplete`, `truncated`, `malformed`, and artifact status fields describe evidence that could not be read in full.
|
|
69
93
|
|
|
70
94
|
## Agent integration
|
|
71
95
|
|