WisentProbierz
Probierz/Docs

CLI command

probierz incident record

Record one attempt that did not hold, with the claim in the words it was claimed in.

Invocation#

Shell
probierz incident record --claim <CLAIM>

Required inputs and options#

  • `--claim` is required and is stored verbatim; it is the sentence the register is asked about later.
  • The failure is supplied either as `--envelope <file>` (or `-` for stdin), or as the four flags `--service`, `--failure-point`, `--code`, and `--detail`. A `wisent-errors` envelope needs all four fields.
  • `--run <runId>` binds the entry to a recorded run when one exists. `PROBIERZ_ACTOR` names who recorded it; without it the register takes the operating-system user.

Output and state effects#

Appends one `ai.wisent.probierz.incident.v1` line and prints its content-addressed ID, derived from the claim, timestamp and envelope. Actor selection follows `PROBIERZ_ACTOR`, `GITHUB_ACTOR`, then `USER`. The register is locked across processes during reads and mutations. Desktop's Record incident form accepts a claim, a pasted or imported complete envelope, and an optional run ID.

Exact refusals#

  • A missing claim is refused by the parser: `error: the following required arguments were not provided: --claim <CLAIM>`. A claim of only whitespace is refused as `--claim must say what was claimed`.
  • An envelope missing a field is refused by name, for example `the envelope is not usable: detail must be a non-empty string`.
  • The failure described twice: `--envelope carries the failure, so --service, --detail would be a second answer to the same field`, naming every flag that arrived with it.
  • An unreadable envelope file or a body that is not one JSON object is refused instead of being recorded as an empty failure.

Source snapshot#

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

Combined help SHA-256: `43f0d9cd136ac2c46ec3eedb2824bd5d6168f235dea4caaa50610c005f40c84a`; binary SHA-256: `7e42c843082863ed265817de90a110a2f27546426a54d372e10009fd665a4d8e`.