IF Commons GitHub

commit

verbmutate

Make the commit with the repository's identity and trailers, refusing what must not be committed, after the generated files are checked.

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
kindaction
effectmutate
idempotentfalse
audienceboth
tiercontributor
dryRuntrue
checkfalse
reachChannelslocal, mcp
reachReadOnlyfalse
reachNeedsTtyfalse
reachRunsAscaller
reachConfirmationnone

Operands

OperandMeaning
PATHFiles to stage before the commit; the files already staged are committed in any case.

Options

OptionMeaningProperties
--messageThe subject of the commit: one line of at most 100 characters, with no full stop at its end.type=value, short=m, required=true, standard=false, humanOnly=false, valueName=SUBJECT
--refsThe issue the commit refers to: its number, written as the line `Refs #N`.type=value, required=false, standard=false, humanOnly=false, valueName=N
--impactHow much the release raises the version of a library this commit changes: major (a breaking change; a minor while the major version is 0), minor (a feature) or patch (a fix), written as the line `Impact:`.type=value, required=false, standard=false, humanOnly=false, valueName=IMPACT
--sessionThe address of the session, written as the line `Claude-Session` (else the variable CLAUDE_SESSION_URL).type=value, required=false, standard=false, humanOnly=false, valueName=URL
--co-authorThe line that credits the agent (else the variable REPOCTL_CO_AUTHOR, else the configuration's).type=value, required=false, standard=false, humanOnly=false, valueName=LINE
--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 commit -m Add the doctor --refs 10  # Commit what is staged, as the repository's identity, with the trailers its configuration lists (`Refs #10`, the co-author, the session).
repoctl commit -m Fix the merge --dry-run commons/repoctl/src  # Show the message and the files, and commit nothing.

Physical: what it is drawn as

Not drawn by any surface for this tier.

Not drawn

  • cli: commit is for the tier contributor; this caller holds public
  • mcp: commit is for the tier contributor; this caller holds public
  • rest: commit is for the tier contributor; this caller holds public

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