submit.default¶
Gate, push, open-or-reuse the PR, arm, and watch it land.
Idempotent: re-running it is the recovery procedure. Exits 10 and
17 self-heal by integrating the base and re-submitting; the other
verdict codes surface unchanged (see livery.workshop._verdict).
--fix runs the gate's format and lint in their fix modes and
folds any rewrites into the branch before pushing: amended into
HEAD while unpushed, a follow-up commit otherwise. --no-close
submits without the close footer, for a branch that carries
preparatory work on an issue the merge must leave open.
--every-runner labels the pull request ci:every-runner, so
the gate runs every runner for it where its check legs run on
fewer: for a change to a line only another platform reaches, which
a narrowed run judges red by name.
fm submit.default [--title=VALUE] [--body=VALUE] [--base=VALUE] [--closes=INT] [--no-close] [--armed] [--no-gate] [--fix] [--force] [--every-runner] [--no-follow] [--interval=INT] [--timeout=INT]
| Parameter | Type | Default | Description |
|---|---|---|---|
--title=VALUE |
"" |
PR title; defaults to HEAD's subject | |
--body=VALUE |
"" |
PR body; defaults to HEAD's body | |
--base=VALUE |
"main" |
target branch | |
--closes=INT |
int | 0 |
issue to close on merge; 0 = from branch name |
--close |
flag | true |
close the branch's issue on merge |
--armed |
flag | false |
arm auto-merge (ladder: flag, WORKSHOP_AUTOMERGE, [ci] automerge) |
--gate |
flag | true |
run fm check first |
--fix |
flag | false |
heal mechanical gate findings, fold into HEAD |
--force |
flag | false |
force-push with a lease after a deliberate history rewrite |
--every-runner |
flag | false |
label the PR ci:every-runner so the gate runs every runner: for a change only another platform reaches while the pull request's legs run on fewer |
--follow |
flag | true |
watch until it lands or says what stopped it |
--interval=INT |
int | 15 |
watch poll seconds |
--timeout=INT |
int | 1800 |
watch deadline seconds |