OPF
DocsReferenceView source

Rerunning checks through the shared PR gate

node scripts/pr-gate.mjs owner/repo#123 --rerun-once keeps the existing policy: retry failed jobs once; a cancelled workflow restarts in full. The gate still observes all required checks and never treats requesting a rerun as success.

Use --rerun-once --rerun-scope all when successful prerequisite jobs also need to run again:

sh
node scripts/pr-gate.mjs owner/repo#123 --expect-head <reviewed-head> --required all --rerun-once --rerun-scope all

For example, sibling workflows resolve coordinated refs in a candidate-selection job and pass its outputs to downstream jobs. The refs resolver reads current Depends-On peer heads, and candidate-gallery.mjs resolve fetches the current PR body for Gallery authorization. A failed-jobs-only rerun can retain a previously successful selection job's outputs. Full scope requests the complete workflow rerun so that selection executes again; this describes the code path, not a diagnosis of a particular CI failure.

A rerun still uses the original workflow/head. It does not test a newer own-source commit automatically; preserve the appropriate --expect-head and review the selected graph. Full scope does not change the required checks, head guards, merge rules, timeout, polling cadence or quota policy. It sends one POST per failing workflow run, deduplicating multiple failed jobs from that run, and retries at most once. Successful workflows are not rerun. The printed resume command preserves full scope.

--rerun-scope accepts only failed or all and requires --rerun-once. Omitting scope preserves failed and the existing resume command.