CLI command
probierz onboarding
Show the first-run journey and optionally adopt definitions from an existing Probierz repository without running them.
Invocation#
probierz onboarding [--reset] [--source <repository>] [--replace] [--json]Required inputs and options#
- `--source <repository>` selects an existing Git repository containing validated `apps/<appId>/probierz.yaml` manifests and established Probierz package spec directories.
- `--replace` is accepted only with `--source` and explicitly permits replacement after conflicts have been reviewed.
- `--reset` resets walkthrough progress; `--json` returns the journey and adoption result as structured data.
Output and state effects#
Validates the whole selection before mutation, persists accepted definitions and `apps/.adoptions.json`, reports imported, unchanged, removed, conflicting, and rejected counts, then renders onboarding. It never runs a journey.
Exact refusals#
- Unknown or missing option values are refused with exit code 2.
- Invalid manifests, missing referenced specs, symlinks, and unsupported filesystem entries are refused before any destination file changes.
- Differing destination files return every conflict and write nothing unless explicit replacement is safe.
- Onboarding progress (`$XDG_STATE_HOME/probierz/onboarding.json`, else under the home directory) that exists and cannot be read or is not JSON is refused at `onboarding.state` with its path and cause, and is not overwritten; only a missing file starts a fresh journey.
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`.