WisentProbierz
Probierz/Docs

CLI command

probierz ci

Select affected targets, run the ready targets, analyze completed runs, and return one change-driven verdict.

Invocation#

Shell
probierz ci [ARGS]...

Options from source help#

run opts
NAME=VALUE            Environment variable given to the suite; repeatable
  --app <ID>            Application manifest whose surface and secrets apply
  --spec <FILE>         One spec file instead of the target's whole suite
  --tool <NAME>         Report shape to expect: wdio or probierz
  --record              Keep video, traces, and screenshots for every journey
  --force               Run even when the resource this target locks is held
  --no-analyze          Skip report analysis and print the raw run
  --no-repair           Do not offer an authored repair for a failed run
  --frames <N>          Frames to extract, spread across each recording; none unless given
  --files <PATH>...     Changed files that select what runs (affected, ci)

Required inputs and options#

  • `[ref]` or `--files path ...` defines the change set.
  • `--app <appId>` selects the registered product whose manifest and source identity belong to the run.
  • `--record` requests supported video, trace, and screenshot capture; `--force` runs even when the resource this target locks is held.
  • `--spec <path>` narrows execution to one spec. An absolute path may name an application-owned program in its own repository; its report records `owner: "application"`. `--frames N` extracts N frames spread across each recording; none are extracted unless it is given, in a plan or on the command line. `--tool wdio|probierz` names the report shape to expect.
  • Trailing `KEY=VALUE` arguments become the target process environment.

Output and state effects#

Writes selected targets, per-target results, analyses, and summary counts. A failed journey or check fails with code `refused`; if nothing failed but at least one target is blocked, it fails with code `prerequisite`; both exit 1 and carry the whole result.

Exact refusals#

  • Unknown options, missing values, and negative frame counts are refused.
  • Blocked preflights are reported with their fixes and are not spawned unless `--force` is explicit.
  • Selection or orchestration failure propagates; unavailable work is never counted as passed.

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`.