CLI command
probierz author-spec
Draft a product-owned journey spec through the authenticated Stado model router, verify it with a real Probierz run, and register it only on green.
Invocation#
probierz author-spec --target <TARGET> --desc <DESC> <APP_ID> <JOURNEY>Required inputs and options#
- `<appId>`, `<journey>`, `--target`, and `--desc` are required.
- `--paths` is repeatable and adds repository-to-journey mappings; `--rounds` defaults to 3; `--dry-run` prevents installation.
- File-based authoring supports the JavaScript-runner surfaces. TUI and `desktop:cua` journeys are registered Rust functions and are not generated as spec files.
Output and state effects#
Each candidate runs as the selected product through Probierz. The terminal probe captures a finite command's output and actual exit status; an empty screen is refused, and the captured output alone never counts as a passed test. On green, the accepted journey is installed in the product-owned test location and registered in the application manifest. JSON returns the accepted spec, manifest, run ID, and completed authoring round.
Exact refusals#
- Missing app/journey, description, or target is refused with the corresponding `author-spec needs …` error.
- The `tui` and `desktop:cua` targets are refused with `tui journeys are Rust functions in probierz-rs/src/specs, not spec files` or the corresponding `desktop:cua` sentence.
- Unknown options, unexpected arguments, and valueless flags are refused. A candidate that cannot complete a real green Probierz run is never registered.
- An invalid test directory or a path that escapes the product through a symlink is refused before creating its destination.
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`.