commit¶
Commit the change as type(scope): subject on a proved tree.
TYPE is one of the conventional types the release train reads and
SUBJECT says what the change does. The scope is the packages the
staged change touches, by directory name, or none for a change
outside every package; --scope overrides it. A package whose
only changes are the files the engine composes into it is left
out. The affected gate runs first in its fix mode, so mechanical
findings heal into the commit and nothing unproved is committed;
--no-check skips it. Everything is staged unless --only
names the paths. Refuses on main, on a reserved branch, and
with nothing to commit.
| Parameter | Type | Default | Description |
|---|---|---|---|
<type> |
required | ||
<subject> |
required | ||
--body=VALUE |
"" |
the commit body, after the subject | |
--scope=VALUE |
"" |
the scope; derived from the changed paths when absent | |
--only=VALUE |
"" |
stage these paths alone, comma-separated; everything when absent | |
--breaking |
flag | false |
mark the commit as a break (the ! before the colon) |
--check |
flag | true |
run the affected gate first, healing what is mechanical |