bregctl examples run command reference
Run or resume an example against the project’s ready owned development instance.
Contract status
Section titled “Contract status”This page is generated from the public Clap command tree for Registry Stack source version 0.30.0 and catalog SHA-256 2221f17eae216048d4cfaf7f66e3dcd68a250f6f6de4e24b177441819192b475. Hidden implementation commands are omitted.
bregctl examples run [OPTIONS] <SCENARIO> [PROJECT]Constraints
Section titled “Constraints”| Condition | Requirement |
|---|---|
| Command invocation | --attempt <ATTEMPT> and --new-attempt cannot be used together. |
Arguments
Section titled “Arguments”| Argument | Always required | Default | Values | Environment | Description |
|---|---|---|---|---|---|
<SCENARIO> | Yes | n/a | starter-data, first-record, reviewed-change | n/a | Fixed teaching scenario declared by this project |
[PROJECT] | No | . | n/a | n/a | Authored project whose owned local development instance is ready. A symbolic link at any component of this path is refused. |
Options
Section titled “Options”| Option | Always required | Default | Values | Environment | Description |
|---|---|---|---|---|---|
--input <INPUT> | No | n/a | n/a | n/a | Editable JSON input (default: the scenario’s declared examples input file) |
--attempt <ATTEMPT> | No | n/a | n/a | n/a | Resume exactly this retained execution attempt |
--new-attempt | No | n/a | n/a | n/a | Start a distinct attempt, with new idempotency keys and ordinary uniqueness checks |
--from-attempt <FROM_ATTEMPT> | No | n/a | n/a | n/a | Completed first-record attempt whose captured UUID is the review target |
--step <STEP> | No | n/a | submit, inspect, approve, reject, apply, history | n/a | Reviewed changes advance one explicit stage; approval never applies a change |
--format <FORMAT> | No | human | human, json | n/a | Emit the selected command’s report in this format |
-h, --help | No | n/a | n/a | n/a | Print help |
Generation contract
Section titled “Generation contract”Run npm run generate from docs/site after changing a public command, argument, option, default, environment binding, or help description.