prove
verbreadCompute the proof a change needs from its blast radius (the tiers, the tests and why each skipped proof is safe) and run it.
Program repoctl-contributor. Origin repoctl.
Governance: the action
What the verb is and may do, as governance says it. Each annotation is expressed by the surfaces or says why it is not.
| Property | Value |
|---|---|
kind | report |
effect | read |
idempotent | true |
audience | both |
tier | public |
dryRun | false |
check | false |
reachChannels | local, mcp |
reachReadOnly | true |
reachNeedsTty | false |
reachRunsAs | caller |
reachConfirmation | none |
Options
| Option | Meaning | Properties |
|---|---|---|
--base | The revision the change starts at (origin/main, else main, else HEAD). | type=value, required=false, standard=false, humanOnly=false, valueName=REF |
--plan | Print the plan as one JSON document and run nothing. | type=flag, required=false, standard=false, humanOnly=false, negatable=false, default=false |
--why | Say, for every proof and every proof left out, why. | type=flag, required=false, standard=false, humanOnly=false, negatable=false, default=false |
--tier | Run only this tier (0 to 6 or T0 to T6). | type=value, required=false, standard=false, humanOnly=false, valueName=N |
--all | Plan every proof of every tier, whatever changed. | type=flag, required=false, standard=false, humanOnly=false, negatable=false, default=false |
--no-cache | Run every selected test, whatever the cache holds. | type=flag, required=false, standard=false, humanOnly=false, negatable=false, default=false |
--json | Write one JSON document and nothing else for a person. | type=flag, required=false, standard=true, humanOnly=false, negatable=false, default=false |
--sarif | Write the findings as SARIF 2.1.0 and nothing else. | type=flag, required=false, standard=true, humanOnly=false, negatable=false, default=false |
--quiet | Show only how it ended. | type=flag, short=q, required=false, standard=true, humanOnly=false, negatable=false, default=false |
--verbose | Show every step as it happens. | type=flag, short=v, required=false, standard=true, humanOnly=false, negatable=false, default=false |
--color | Use colour where the terminal shows it (--no-color turns it off). | type=flag, required=false, standard=true, humanOnly=false, negatable=true, default=true |
--non-interactive | Never ask a question: where one is needed, fail and say so. | type=flag, required=false, standard=true, humanOnly=false, negatable=false, default=false |
Examples
repoctl prove # Prove what the working tree changes since origin/main: the tiers T0 to T3 that apply, and only those.
repoctl prove --why # The same, with the sentence that says why each proof runs and why each skipped proof is safe to skip.
repoctl prove --plan # The plan as JSON, run nothing: what CI and the development loop read.
repoctl prove --tier 0 # Only the static proofs of the plan.
repoctl prove --all --plan # Every proof of every tier, as the nightly run and the release plan it.Physical: what it is drawn as
repoctl prove
cli-command. Compute the proof a change needs from its blast radius (the tiers, the tests and why each skipped proof is safe) and run it.
| Property | Value |
|---|---|
usage | repoctl prove |
words | prove |
tier | public |
repoctl_prove
mcp-tool. Compute the proof a change needs from its blast radius (the tiers, the tests and why each skipped proof is safe) and run it. (report, effect read, safe to repeat.)
| Property | Value |
|---|---|
title | repoctl prove |
toolName | repoctl_prove |
readOnlyHint | true |
destructiveHint | false |
idempotentHint | true |
inputs | base, plan, why, tier, all, noCache |
tier | public |
Not drawn
- rest: its reach policy does not name the rest channel