CLI command

probierz incident

Enter the register of attempts that did not hold.

Invocation#

Shell
probierz incident <COMMAND>

Required inputs and options#

  • The leaf must be `record`, `list`, `show`, or `resolve`.

Output and state effects#

The group dispatches to the selected register operation. Record and resolve append to `test-results/.incidents/register.jsonl`; list and show read it. Probierz Desktop uses the same core through the loopback API started by `probierz serve`, not a separate file parser or writer.

Exact refusals#

  • Missing or unknown leaves return the group usage, which names the two `record` forms and the envelope fields the register requires.

Desktop API: POST /v1/incidents/record#

Start `probierz --harness <project> serve` and use the loopback address in its ready response. The serve command has its own CLI reference page. Send JSON with Content-Type application/json; requests are limited to 1 MiB.

Successful operations return HTTP 200. Invalid inputs and register failures return HTTP 400 with the same error sentence as the core; unknown routes return 404. Use the incident ID returned by record for show and resolve. Read responses keep complete envelopes, including nested context.

JSON body
{"claim":"The check passed","envelope":{"service":"probierz","failure_point":"verification.claim","error_code":"invalid","detail":"The run was not retained"},"run_id":"optional-run"}

Desktop API: POST /v1/incidents/list#

Start `probierz --harness <project> serve` and use the loopback address in its ready response. The serve command has its own CLI reference page. Send JSON with Content-Type application/json; requests are limited to 1 MiB.

Successful operations return HTTP 200. Invalid inputs and register failures return HTTP 400 with the same error sentence as the core; unknown routes return 404. Use the incident ID returned by record for show and resolve. Read responses keep complete envelopes, including nested context.

JSON body
{"state":"all","limit":20}

Desktop API: POST /v1/incidents/show#

Start `probierz --harness <project> serve` and use the loopback address in its ready response. The serve command has its own CLI reference page. Send JSON with Content-Type application/json; requests are limited to 1 MiB.

Successful operations return HTTP 200. Invalid inputs and register failures return HTTP 400 with the same error sentence as the core; unknown routes return 404. Use the incident ID returned by record for show and resolve. Read responses keep complete envelopes, including nested context.

JSON body
{"id":"recorded-incident-id"}

Desktop API: POST /v1/incidents/resolve#

Start `probierz --harness <project> serve` and use the loopback address in its ready response. The serve command has its own CLI reference page. Send JSON with Content-Type application/json; requests are limited to 1 MiB.

Successful operations return HTTP 200. Invalid inputs and register failures return HTTP 400 with the same error sentence as the core; unknown routes return 404. Use the incident ID returned by record for show and resolve. Read responses keep complete envelopes, including nested context.

JSON body
{"id":"recorded-incident-id","note":"Retained the actual verification","run_id":"optional-verification-run"}

Source snapshot#

Generated from the Rust binaries at https://github.com/wisent-ai/probierz.git revision `f40fa7ed94a028b56b5a59342eaf55982ba5cf7d`.

Combined help SHA-256: `04bab0ac1e9691119efcb70627b534a73431f51bb44ed8ba81d93cc10afd6569`; binary SHA-256: `08424ee2465261eafaa112d13ef05a20ce1fe1b6479e896341e22fbc55e61d3e`.