@qawolf/cli 1.40.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 CHANGED
@@ -61,12 +61,36 @@ 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
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.
69
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.
93
+
70
94
  ## Agent integration
71
95
 
72
96
  This repository ships a [`qawolf-cli` Agent Skill](skills/qawolf-cli/SKILL.md) that follows the open [Agent Skills specification](https://agentskills.io/specification). It works with compatible harnesses such as Claude Code, Codex, Cursor, Gemini CLI, GitHub Copilot, and OpenCode.