release apply
verbmutateMake a release: raise the versions the plan says, make the generated files, run the tests that pack and write the record; commits nothing.
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 | action |
effect | mutate |
idempotent | false |
audience | both |
tier | contributor |
dryRun | true |
check | false |
reachChannels | local, mcp |
reachReadOnly | false |
reachNeedsTty | false |
reachRunsAs | caller |
reachConfirmation | none |
Options
| Option | Meaning | Properties |
|---|---|---|
--offline | Do not ask npm what it holds: a version with no tag is then raised only where its files changed since it was raised. | type=flag, required=false, standard=false, humanOnly=false, negatable=false, default=false |
--distribution | The distribution mode for this run: per-library or single (the mode of the repository, or IFC_DISTRIBUTION, where it is not given). | type=value, required=false, standard=false, humanOnly=false, valueName=MODE |
--raise | Raise a library whatever its state says: NAME, or NAME=major|minor|patch. | type=many, required=false, standard=false, humanOnly=false, valueName=NAME[=IMPACT] |
--tests | Run the tests that pack, install and type-check every library (on by default). | type=flag, required=false, standard=false, humanOnly=false, negatable=true, default=true |
--json | Write one JSON document and nothing else for a person. | 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 |
--dry-run | Show what would change and change nothing. | type=flag, required=false, standard=true, humanOnly=false, negatable=false, default=false |
Examples
repoctl release apply --dry-run # The plan, with nothing written.
repoctl release apply # Raise the versions the plan says, make every generated file, run the tests that pack and write the record.
repoctl release apply --no-tests # The same without the tests that pack: for trying the command, never for a release.Physical: what it is drawn as
repoctl release apply
cli-command. Make a release: raise the versions the plan says, make the generated files, run the tests that pack and write the record; commits nothing.
| Property | Value |
|---|---|
usage | repoctl release apply |
words | release, apply |
tier | contributor |
repoctl_release_apply
mcp-tool. Make a release: raise the versions the plan says, make the generated files, run the tests that pack and write the record; commits nothing. (action, effect mutate.)
| Property | Value |
|---|---|
title | repoctl release apply |
toolName | repoctl_release_apply |
readOnlyHint | false |
destructiveHint | false |
idempotentHint | false |
inputs | offline, distribution, raise, tests, dryRun |
tier | contributor |
Not drawn
- rest: its reach policy does not name the rest channel