IF Commons GitHub

release apply

verbmutate

Make 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.

PropertyValue
kindaction
effectmutate
idempotentfalse
audienceboth
tiercontributor
dryRuntrue
checkfalse
reachChannelslocal, mcp
reachReadOnlyfalse
reachNeedsTtyfalse
reachRunsAscaller
reachConfirmationnone

Options

OptionMeaningProperties
--offlineDo 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
--distributionThe 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
--raiseRaise a library whatever its state says: NAME, or NAME=major|minor|patch.type=many, required=false, standard=false, humanOnly=false, valueName=NAME[=IMPACT]
--testsRun 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
--jsonWrite one JSON document and nothing else for a person.type=flag, required=false, standard=true, humanOnly=false, negatable=false, default=false
--quietShow only how it ended.type=flag, short=q, required=false, standard=true, humanOnly=false, negatable=false, default=false
--verboseShow every step as it happens.type=flag, short=v, required=false, standard=true, humanOnly=false, negatable=false, default=false
--colorUse colour where the terminal shows it (--no-color turns it off).type=flag, required=false, standard=true, humanOnly=false, negatable=true, default=true
--non-interactiveNever ask a question: where one is needed, fail and say so.type=flag, required=false, standard=true, humanOnly=false, negatable=false, default=false
--dry-runShow 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.

PropertyValue
usagerepoctl release apply
wordsrelease, apply
tiercontributor

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.)

PropertyValue
titlerepoctl release apply
toolNamerepoctl_release_apply
readOnlyHintfalse
destructiveHintfalse
idempotentHintfalse
inputsoffline, distribution, raise, tests, dryRun
tiercontributor

Not drawn

  • rest: its reach policy does not name the rest channel

Titles, headings, exports, tables, columns and requirements. Esc closes.