IF Commons GitHub

release plan

verbread

Say what a release would do, library by library and why; writes nothing.

Program repoctl-public. 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
kindreport
effectread
idempotenttrue
audienceboth
tierpublic
dryRunfalse
checkfalse
reachChannelslocal, mcp
reachReadOnlytrue
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]
--jsonWrite one JSON document and nothing else for a person.type=flag, required=false, standard=true, humanOnly=false, negatable=false, default=false
--sarifWrite the findings as SARIF 2.1.0 and nothing else.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

Examples

repoctl release plan  # What a release would do, library by library and why; nothing is written.
repoctl release plan --offline  # The same without asking npm.
repoctl release plan --raise headless=minor  # Plan the release with headless raised by a minor.

Physical: what it is drawn as

repoctl release plan

cli-command. Say what a release would do, library by library and why; writes nothing.

PropertyValue
usagerepoctl release plan
wordsrelease, plan
tierpublic

repoctl_release_plan

mcp-tool. Say what a release would do, library by library and why; writes nothing. (report, effect read, safe to repeat.)

PropertyValue
titlerepoctl release plan
toolNamerepoctl_release_plan
readOnlyHinttrue
destructiveHintfalse
idempotentHinttrue
inputsoffline, distribution, raise
tierpublic

Not drawn

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

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