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`.
  • A process with none of `PROBIERZ_ACTOR`, `GITHUB_ACTOR` or `USER` set is refused at `records.actor`: `no actor to attribute this record to: PROBIERZ_ACTOR, GITHUB_ACTOR and USER are all unset or empty`; the same refusal applies to resolve, reopen and the evidence access audit.
  • 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 `f65b755da397f2ec7435eb80ed722aa6017437c1`.

Combined help SHA-256: `4a12655d233812abc29eeebbf3db3065efe3e00288024383f3eef3970d092e94`; binary SHA-256: `d5398832d3ab52c541b1efe979730dea62941ac6197898a20fccfc5d3fca44df`.