CLI command

probierz check

Check whether one target's toolchain and host prerequisites are ready, and report the owner and fix for anything missing.

Invocation#

Shell
probierz check <TARGET>

Required inputs and options#

  • `<target>` is required and is one of web | mobile:ios | mobile:android | desktop:mac | desktop:win | desktop:cua | tui, or `suites/<checkout>`.
  • `suites/<checkout>` reads the test suites a product checkout's `.wisent-release.json` declares under `platforms.<this platform>.quality` with kind `test` — `name`, the `argv` that runs it in the checkout, and optionally `reports`, the checkout-relative paths it leaves its reports at; the platform is this host's (`darwin-arm64`, `darwin-x64`, `linux-arm64`, `linux-x64`), named in the release pipeline's vocabulary.

Output and state effects#

Writes the preflight report as JSON. It does not install or run anything; a non-ready report sets exit code 1. For `suites/<checkout>` it prints, read-only, the product, the declared suites (platform, name, argv, reports), where its runs are kept (`test-results/.suites/<product>/`) and `lastRun`, the newest kept `run.json`, or null when none was kept.

Exact refusals#

  • Missing target: `check needs a target (one of …)`.
  • Unknown target: `unknown target: <target>`.
  • suites: `<checkout>/.wisent-release.json could not be read: <error>`, `… is not JSON: <error>`, `… declares no product name`, `… declares no platforms`, `… declares no platform <name>; declared: <names>`, `… declares no quality gates for platform <name>`; a test gate without a name or argv, with an empty argv, or whose `argv`/`reports` is not a list of strings is refused naming the gate and the value found; gate names must be one path-safe component and unique on the platform; report paths must be nonempty checkout-relative paths without parent traversal or an absolute root. The refusal names the manifest, gate and offending declaration. A product name that is not one plain directory name is refused; a kept run whose `run.json` cannot be read or is not a run record is refused naming the file.

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