Skip to content

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

Example

$ fm submit.default --close