Skip to content

An open source design system that's fully customizable and agent ready

TypeScript

ci: an undecided scope runs the contracts its budget fits and owes every audit (#10634)

Cindy Zhangc7558e8d3af1
diff --git a/.github/actions/test-scope/action.yml b/.github/actions/test-scope/action.yml
index eb8aa34cfb..0d29dad5e1 100644
--- a/.github/actions/test-scope/action.yml
+++ b/.github/actions/test-scope/action.yml
@@ -87,6 +87,11 @@ outputs:
not decide; a job that must do work on a lane it cannot recognize (spec
validation) reads this.
value: ${{ steps.scope.outputs.decided }}
+ truncated:
+ description: >-
+ `true` when the step could not decide because GitHub truncated the pull
+ request's file list (3,000 files); a re-run cannot decide such a scope.
+ value: ${{ steps.scope.outputs.truncated }}
touches:
description: A changed path matches `paths` (true when `paths` is empty or undecidable).
value: ${{ steps.scope.outputs.touches }}
@@ -148,6 +153,7 @@ runs:
applies: 'true',
head_file_present: 'true',
decided: 'true',
+ truncated: 'false',
};
// Outside a pull request, or when undecidable, every component audit
// applies in full; a specialized lane has none.
@@ -235,7 +241,11 @@ runs:
}
} catch (error) {
core.warning(`Scope could not be decided (${error.message}); everything is in scope.`);
- report({...everything, decided: 'false'});
+ report({
+ ...everything,
+ decided: 'false',
+ truncated: String(/truncated the file list/.test(error.message)),
+ });
return;
}
diff --git a/.github/scripts/a11y-dependent-audits.mjs b/.github/scripts/a11y-dependent-audits.mjs
index 32d05c4daf..fb29cb9dda 100644
--- a/.github/scripts/a11y-dependent-audits.mjs
+++ b/.github/scripts/a11y-dependent-audits.mjs
@@ -169,8 +169,10 @@ export function changedComponents(changed) {
* @param {Map<string, Set<string>>} options.importers
* @param {Record<string, number>} options.seconds
* @param {number} [options.attempt] the run's attempt; 1 for its first run
- * @param {boolean} [options.everything] the changed files are unknown and
- * everything is in scope: every component's audits are owed
+ * @param {boolean} [options.everything] the changed files are unknown (a diff
+ * GitHub truncates, or a scope that could not be read) and everything is in
+ * scope: every audit is owed, the run fits what it can, and the record is
+ * never complete
*/
export function planDependentAudits({
changed,
@@ -181,16 +183,8 @@ export function planDependentAudits({
attempt = 1,
everything = false,
}) {
- const components = everything
- ? [
- ...new Set(
- specs
- .filter(({mode}) => mode === 'audit')
- .map(({file}) => componentFolderOf(file))
- .filter(Boolean),
- ),
- ].sort()
- : changedComponents(changed);
+ if (everything) return planEverything(specs, seconds);
+ const components = changedComponents(changed);
const touched = changedPrimitives(primitives, changed);
const order = [
...components,
@@ -234,6 +228,58 @@ export function planDependentAudits({
return {...base, files, deferred, complete: deferred.length === 0, ...legs};
}
+/**
+ * An undecided scope's plan: every audit is owed; one run fits what it can
+ * and lists the rest; it is never complete.
+ * @param {{file: string, mode: string}[]} specs
+ * @param {Record<string, number>} seconds
+ */
+function planEverything(specs, seconds) {
+ const owed = specs
+ .filter(spec => spec.mode === 'audit')
+ .map(({file}) => file)
+ .sort();
+ /** @type {string[]} */
+ const files = [];
+ /** @type {string[]} */
+ const deferred = [];
+ for (const file of owed) {
+ const fits =
+ fitLegs([...files, file], seconds, MAX_LEGS).longestMs <=
+ budgetFor([...files, file], seconds);
+ (fits || files.length === 0 ? files : deferred).push(file);
+ }
+ return {
+ components: [],
+ primitives: [],
+ owed,
+ files,
+ deferred,
+ complete: false,
+ everything: true,
+ ...fitLegs(files, seconds, MAX_LEGS),
+ };
+}
+
+export const TOO_LARGE = 'diff too large to scope (>3,000 files); split the PR';
+export const UNDECIDED =
+ 'the changed files could not be read; re-run all jobs at this head';
+
+/**
+ * What an undecided scope's run says: a truncated file list needs a split,
+ * any other undecided scope a re-run.
+ * @param {{deferred: string[]}} plan
+ * @param {boolean} truncated
+ */
+export function undecidedMessage(plan, truncated) {
+ const why = truncated ? TOO_LARGE : UNDECIDED;
+ const title = truncated ? 'Diff too large to scope' : 'Scope not decided';
+ return {
+ annotation: `::error title=${title}::${why}. ${plan.deferred.length} owed audit spec files do not run, so merge-guard does not merge this head.`,
+ summary: `${why}. Not run (${plan.deferred.length}):`,
+ };
+}
+
function main() {
const argv = process.argv.slice(2);
const value = name => {
@@ -243,6 +289,7 @@ function main() {
const root = process.cwd();
const changedFile = value('--changed');
const everything = argv.includes('--all');
+ const truncated = argv.includes('--truncated');
const out = value('--out');
const attempt = Number(value('--attempt') ?? '1');
if (
@@ -298,7 +345,9 @@ function main() {
`This run (attempt ${attempt}) runs ${plan.files.length} of ${plan.owed.length} owed audit spec files in ${plan.count} leg(s), the longest leg's recorded time ${minutes} min:`,
);
for (const file of plan.files) console.log(` ${file}`);
- if (plan.deferred.length > 0) {
+ if (plan.everything) {
+ console.log(undecidedMessage(plan, truncated).annotation);
+ } else if (plan.deferred.length > 0) {
console.log(
`::warning title=Audits not yet run::${plan.deferred.length} owed audit spec files do not fit three legs of ten minutes. Re-run all jobs at this head to run every owed audit; merge-guard merges only on a run that ran them all.`,
);
@@ -325,9 +374,11 @@ function main() {
fs.appendFileSync(
process.env.GITHUB_STEP_SUMMARY,
`### Dependent audits\n\nRan (${plan.files.length}):\n\n${list(plan.files)}\n\n` +
- (plan.deferred.length
- ? `Not yet run (${plan.deferred.length}); re-run all jobs at this head:\n\n${list(plan.deferred)}\n`
- : 'Every owed audit ran.\n'),
+ (plan.everything
+ ? `${undecidedMessage(plan, truncated).summary}\n\n${list(plan.deferred)}\n`
+ : plan.deferred.length
+ ? `Not yet run (${plan.deferred.length}); re-run all jobs at this head:\n\n${list(plan.deferred)}\n`
+ : 'Every owed audit ran.\n'),
);
}
}
diff --git a/.github/scripts/a11y-dependent-audits.test.mjs b/.github/scripts/a11y-dependent-audits.test.mjs
index 88c885ac83..f5dd8a6843 100644
--- a/.github/scripts/a11y-dependent-audits.test.mjs
+++ b/.github/scripts/a11y-dependent-audits.test.mjs
@@ -11,7 +11,9 @@
* names, within at most three legs of about ten minutes each.
*/
+import {execFileSync} from 'node:child_process';
import fs from 'node:fs';
+import os from 'node:os';
import path from 'node:path';
import {describe, expect, it} from 'vitest';
@@ -27,6 +29,9 @@ import {
planDependentAudits,
PRIMITIVES_FILE,
readPrimitives,
+ TOO_LARGE,
+ UNDECIDED,
+ undecidedMessage,
} from './a11y-dependent-audits.mjs';
import {
fileSeconds,
@@ -233,27 +238,80 @@ describe("a component's source change runs its own audits", () => {
});
describe('an undecided scope', () => {
- it('owes every audit, and a first run lists what does not fit', () => {
- const all = plan([]);
- expect(all.owed).toEqual([]);
- const everything = planDependentAudits({
+ const everything = attempt =>
+ planDependentAudits({
changed: [],
primitives: readPrimitives(root),
specs,
importers,
seconds,
+ attempt,
everything: true,
});
- const audits = specs
+
+ it('owes every audit, runs what fits, and is never complete', () => {
+ const expected = specs
.filter(({mode}) => mode === 'audit')
- .map(({file}) => file);
- expect([...everything.owed].sort()).toEqual([...audits].sort());
- expect([...everything.files, ...everything.deferred].sort()).toEqual(
- [...audits].sort(),
+ .map(({file}) => file)
+ .sort();
+ for (const attempt of [1, 2]) {
+ const plan = everything(attempt);
+ expect([...plan.owed].sort()).toEqual(expected);
+ expect([...plan.files, ...plan.deferred].sort()).toEqual(expected);
+ expect(plan.complete).toBe(false);
+ expect(plan.count).toBeLessThanOrEqual(MAX_LEGS);
+ expect(plan.longestMs).toBeLessThanOrEqual(
+ budgetFor(plan.files, seconds),
+ );
+ }
+ });
+
+ it('asks for a split only when GitHub truncated the file list', () => {
+ const plan = {deferred: ['a', 'b']};
+ const truncated = undecidedMessage(plan, true);
+ expect(truncated.annotation).toContain(
+ 'diff too large to scope (>3,000 files); split the PR',
);
- expect(everything.longestMs).toBeLessThanOrEqual(
- budgetFor(everything.files, seconds),
+ expect(truncated.summary).toContain(TOO_LARGE);
+ const unread = undecidedMessage(plan, false);
+ expect(unread.annotation).toContain(
+ 'the changed files could not be read; re-run all jobs at this head',
);
+ expect(unread.annotation).not.toContain('split the PR');
+ expect(unread.summary).toContain(UNDECIDED);
+ });
+
+ it('prints the message the scope calls for', () => {
+ const dir = fs.mkdtempSync(path.join(os.tmpdir(), 'dependent-audits-'));
+ try {
+ const run = args =>
+ execFileSync(
+ process.execPath,
+ [
+ '.github/scripts/a11y-dependent-audits.mjs',
+ ...args,
+ '--out',
+ path.join(dir, 'record.json'),
+ ],
+ {
+ cwd: root,
+ encoding: 'utf8',
+ env: {...process.env, GITHUB_OUTPUT: '', GITHUB_STEP_SUMMARY: ''},
+ },
+ );
+ expect(run(['--all', '--truncated'])).toContain(
+ `::error title=Diff too large to scope::${TOO_LARGE}`,
+ );
+ expect(run(['--all'])).toContain(
+ `::error title=Scope not decided::${UNDECIDED}`,
+ );
+ const record = JSON.parse(
+ fs.readFileSync(path.join(dir, 'record.json'), 'utf8'),
+ );
+ expect(record.complete).toBe(false);
+ } finally {
+ fs.rmSync(dir, {recursive: true, force: true});
+ }
});
});
@@ -272,6 +330,10 @@ describe('the dependent-audits jobs', () => {
// An undecided scope (a truncated diff) owes every audit; a decided
// scope without its list stops.
expect(run.run).toContain('changes=(--all)');
+ // Only a truncated file list asks for a split.
+ expect(run.env.TRUNCATED).toBe('${{ steps.scope.outputs.truncated }}');
+ expect(run.run).toContain('elif [ "$TRUNCATED" = true ]; then');
+ expect(run.run).toContain('changes=(--all --truncated)');
expect(step(planJob, 'Require the changed-file list').if).toContain(
"steps.scope.outputs.decided != 'false'",
);
diff --git a/.github/scripts/test-scope-action.test.mjs b/.github/scripts/test-scope-action.test.mjs
index caa564da49..0b8fbc2361 100644
--- a/.github/scripts/test-scope-action.test.mjs
+++ b/.github/scripts/test-scope-action.test.mjs
@@ -181,6 +181,7 @@ describe('per-job scope step', () => {
'spec_only',
'tooling_only',
'touches',
+ 'truncated',
'vitest_full_suite',
].sort(),
);
@@ -379,11 +380,15 @@ describe('per-job scope step', () => {
missingBase: ['scripts/component-packages.cjs'],
},
],
- ])('puts everything in scope when %s', async (_, options) => {
+ ])('puts everything in scope when %s', async (name, options) => {
const {outputs, messages} = await decide({
...options,
inputs: {paths: INTERACTION_PATHS},
});
+ // Only a truncated file list is one a re-run cannot decide.
+ expect(outputs.truncated).toBe(
+ name === 'GitHub truncates the file list' ? 'true' : 'false',
+ );
expect(outputs).toMatchObject({
spec_only: 'false',
docsite_only: 'false',
@@ -834,3 +839,42 @@ describe('the temporary policy folder', () => {
expect(left).toEqual([]);
});
});
+
+describe('the contract job on a pull request GitHub truncates', () => {
+ it('lists every file and runs, never fails, on an undecided scope', async () => {
+ const ci = yaml.parse(
+ fs.readFileSync(
+ path.join(import.meta.dirname, '../workflows/ci.yml'),
+ 'utf8',
+ ),
+ );
+ const job = ci.jobs['pr-component-a11y-contracts'];
+ const scopeStep = job.steps.find(step => step.id === 'scope');
+ const {outputs} = await decide({
+ files: Array.from({length: 3001}, (_, i) => ({
+ filename: `packages/core/src/Button/file${i}.tsx`,
+ status: 'modified',
+ })),
+ inputs: scopeStep.with,
+ });
+ expect(outputs).toMatchObject({applies: 'true', decided: 'false'});
+ expect(outputs.changed_files_path ?? '').toBe('');
+ // The workflow's own conditions, read against these outputs.
+ const holds = condition =>
+ Function(
+ 'outputs',
+ `return (${condition
+ .replace(
+ /steps\.scope\.outputs\.(\w+)/g,
+ (_, key) => `(outputs.${key} ?? '')`,
+ )
+ .replace(/ == /g, ' === ')
+ .replace(/ != /g, ' !== ')});`,
+ )(outputs);
+ const step = name => job.steps.find(candidate => candidate.name === name);
+ expect(holds(step('Require the changed-file list').if)).toBe(false);
+ expect(holds(step('List every file when the scope is undecided').if)).toBe(
+ true,
+ );
+ });
+});
diff --git a/.github/scripts/touched-components.test.mjs b/.github/scripts/touched-components.test.mjs
index 0ff3994b46..bf06474918 100644
--- a/.github/scripts/touched-components.test.mjs
+++ b/.github/scripts/touched-components.test.mjs
@@ -751,10 +751,34 @@ describe('pr-component-a11y-contracts routing', () => {
}
});
- it('fails, never passes, when the scope step cannot list the changed files', () => {
+ it('runs every contract its budget fits when the scope is undecided', () => {
+ // A diff GitHub truncates leaves the scope undecided and lists no files:
+ // every file then counts as changed.
+ const every = contractStep('List every file when the scope is undecided');
+ expect(every.if).toBe(
+ "steps.scope.outputs.applies == 'true' && steps.scope.outputs.changed_files_path == '' && steps.scope.outputs.decided == 'false'",
+ );
+ expect(every.run).toContain('git ls-files > "$RUNNER_TEMP/every-file.txt"');
+ // The changed-spec list reads only the scope's own list: every file
+ // counted as changed would make every spec a changed spec.
+ expect(
+ contractStep('Find the changed browser accessibility specs').env
+ .FILES_PATH,
+ ).toBe('${{ steps.scope.outputs.changed_files_path }}');
+ for (const name of [
+ 'Decide the touched components',
+ "Run the touched components' accessibility contracts",
+ ]) {
+ expect(contractStep(name).env.FILES_PATH, name).toBe(
+ '${{ steps.scope.outputs.changed_files_path || steps.everything.outputs.path }}',
+ );
+ }
+ });
+
+ it('fails, never passes, when a decided scope cannot list the changed files', () => {
const guard = contractStep('Require the changed-file list');
expect(guard.if).toBe(
- "steps.scope.outputs.applies == 'true' && steps.scope.outputs.changed_files_path == ''",
+ "steps.scope.outputs.applies == 'true' && steps.scope.outputs.changed_files_path == '' && steps.scope.outputs.decided != 'false'",
);
expect(guard.run).toContain('exit 1');
expect(guard['continue-on-error']).toBeUndefined();
@@ -833,7 +857,7 @@ describe('pr-component-a11y-contracts routing', () => {
// Every changed path, not only the changed specs: a change in a
// component folder owns that folder's specs.
expect(runStep.env.FILES_PATH).toBe(
- '${{ steps.scope.outputs.changed_files_path }}',
+ '${{ steps.scope.outputs.changed_files_path || steps.everything.outputs.path }}',
);
// A wide change still runs the touched components' own specs, then the
// specs of the folders that render them (FR12).
diff --git a/.github/workflows/ci.yml b/.github/workflows/ci.yml
index 479f0f1913..6681ae9585 100644
--- a/.github/workflows/ci.yml
+++ b/.github/workflows/ci.yml
@@ -4468,10 +4468,21 @@ jobs:
with:
persist-credentials: false
+ # When the scope could not be decided (a diff GitHub truncates at 3,000
+ # files, say), everything is in scope: every file counts as changed, and
+ # the job runs every contract its budget fits and lists the rest.
+ - name: List every file when the scope is undecided
+ id: everything
+ if: steps.scope.outputs.applies == 'true' && steps.scope.outputs.changed_files_path == '' && steps.scope.outputs.decided == 'false'
+ run: |
+ git ls-files > "$RUNNER_TEMP/every-file.txt"
+ echo "path=$RUNNER_TEMP/every-file.txt" >> "$GITHUB_OUTPUT"
+ echo "::notice title=Every contract in scope::The scope could not be decided, so every file counts as changed."
+
# The changed-spec list and the folder rule both read this list. Without
# it, a contract would not run and the job would still pass.
- name: Require the changed-file list
- if: steps.scope.outputs.applies == 'true' && steps.scope.outputs.changed_files_path == ''
+ if: steps.scope.outputs.applies == 'true' && steps.scope.outputs.changed_files_path == '' && steps.scope.outputs.decided != 'false'
run: |
echo "::error::The scope step could not list the changed files, so the contracts to run are unknown. Re-run the job."
exit 1
@@ -4491,7 +4502,7 @@ jobs:
id: touched
if: steps.scope.outputs.applies == 'true'
env:
- FILES_PATH: ${{ steps.scope.outputs.changed_files_path }}
+ FILES_PATH: ${{ steps.scope.outputs.changed_files_path || steps.everything.outputs.path }}
run: |
GITHUB_STEP_SUMMARY=/dev/null node .github/scripts/touched-components.mjs scope \
--analysis analysis.json \
@@ -4587,7 +4598,7 @@ jobs:
ASTRYX_HEAD_SHA: ${{ github.event.pull_request.head.sha }}
WORKFLOW_SHA: ${{ github.sha }}
SPECS_PATH: ${{ steps.specs.outputs.path }}
- FILES_PATH: ${{ steps.scope.outputs.changed_files_path }}
+ FILES_PATH: ${{ steps.scope.outputs.changed_files_path || steps.everything.outputs.path }}
OWNERS: ${{ steps.touched.outputs.contract_owners }}
FOLDERS: ${{ steps.touched.outputs.contract_folders }}
A11Y_CONTRACT_WORKERS: 4
@@ -4685,9 +4696,12 @@ jobs:
CHANGED_FILES: ${{ steps.scope.outputs.changed_files_path }}
ASTRYX_HEAD_SHA: ${{ github.event.pull_request.head.sha || github.sha }}
RUN_ATTEMPT: ${{ github.run_attempt }}
+ TRUNCATED: ${{ steps.scope.outputs.truncated }}
run: |
if [ -n "$CHANGED_FILES" ]; then
changes=(--changed "$CHANGED_FILES")
+ elif [ "$TRUNCATED" = true ]; then
+ changes=(--all --truncated)
else
changes=(--all)
fi
diff --git a/docs/specs/AST-030/spec.md b/docs/specs/AST-030/spec.md
index 1863d43cf5..e09c7b7a08 100644
--- a/docs/specs/AST-030/spec.md
+++ b/docs/specs/AST-030/spec.md
@@ -249,7 +249,7 @@ they are separately named.
scope and spec-location mapping the labelled run uses. Then, in the time
left and for at most one minute of it, it runs the `scoped` and
`release-only` spec files of the component folders that render a touched
- component through their source value imports, nearest first. It runs no unchanged `audit` or `always` spec. For a shared primitive named in `.github/a11y-shared-primitives.json`, FR12's touched-component rule also runs a dependent-audits leg on every pull-request CI run that includes a change to it: at most three legs, each at most 10 minutes, covering the audits of components that use it. The list starts with Button and IconButton. Layer joins when a Layer change breaks release-check or a dependent audit at release; other additions are a CI & Release and chief-of-staff call. A change to a component's source also runs that component's own audit specs in the same leg, on every pull-request CI run that includes the change, within the same three legs of ten minutes. Audits beyond that budget are listed by name as not yet run, and they run on a later run at the same head, which may use more legs; merge-guard merges only on a run at the exact head that ran every owed audit. The contract job runs in parallel with the unit-test jobs and
+ component through their source value imports, nearest first. It runs no unchanged `audit` or `always` spec. For a shared primitive named in `.github/a11y-shared-primitives.json`, FR12's touched-component rule also runs a dependent-audits leg on every pull-request CI run that includes a change to it: at most three legs, each at most 10 minutes, covering the audits of components that use it. The list starts with Button and IconButton. Layer joins when a Layer change breaks release-check or a dependent audit at release; other additions are a CI & Release and chief-of-staff call. A change to a component's source also runs that component's own audit specs in the same leg, on every pull-request CI run that includes the change, within the same three legs of ten minutes. Audits beyond that budget are listed by name as not yet run, and they run on a later run at the same head, which may use more legs; merge-guard merges only on a run at the exact head that ran every owed audit. When GitHub cannot list a pull request's changed files, every audit is owed and no run at that head is complete, so merge-guard does not merge it; the pull request must be split. The contract job runs in parallel with the unit-test jobs and
MUST NOT become the pull request's critical path: it starts after the
Storybook build and MUST finish before the slowest unit-test job, so the
time until the required `test` join reports does not grow. It stops after
@@ -662,6 +662,7 @@ The nightly perf lane is the one scheduled measurement outside them (FR18).
| FR12 | `a11y-pr-contracts.test.mjs` ownership cases; the CI workflow contract; contract-job and unit-test-job timings on 17 component pull requests | a pull request that touches one component with an owned `release-only` contract, passing and failing; a contract file that cannot finish within the budget; a wide change; a reverse dependent of the touched component; measured: setup up to about 1.5 minutes plus the 8-minute stop, against the slowest unit-test job finishing 9.9 to 25 minutes after the Storybook build; a wide change touching Spinner (its own specs run); the folders that render a touched component, nearest first, type-only imports left out, within a one-minute share, and one that does not fit (reported as not run) | a touched component's owned `release-only` contract does not run on its pull request, a failing contract leaves the `test` join green, a skipped file is split, does not show as "not run" in the check's summary or fails the join, the contract job finishes after the slowest unit-test job, or a touched component's own spec does not run on a wide change, or a rendering folder's spec runs before an owned one |
| FR12 | `a11y-dependent-audits.test.mjs` planning cases and the CI workflow contract | a Button change; an IconButton change; a test, story or doc change in a primitive's folder; a change to no primitive; the plan's legs and their recorded times | a Button change that leaves a dependent component's audit out, plans more than three legs or a leg over ten minutes, or a dependent audit failure the `test` join passes |
| FR12 | `a11y-dependent-audits.test.mjs` own-audit and deferral cases; the dependent-audit record | a component source change; an over-budget set on a first run; a later run at the same head | a component source change that leaves its own audits out; an over-budget set whose deferred audits are not listed by name; a head that merges on a run that left an owed audit unrun |
+| FR12 | `a11y-dependent-audits.test.mjs` undecided-scope cases; `test-scope-action.test.mjs` truncated-diff case | a diff over GitHub's file-list limit on a first run and on a later run | such a diff whose record is complete, that omits the split message, or that merge-guard merges |
| FR13 | classifier, workflow contract, component-analysis and RTL-scope tests | component change; shared module; Changeset beside code; infrastructure path; incomplete list; no build; an interaction-harness or lint-plugin path beside code, alone and with another shared path, and a script or other shared path beside one | an infrastructure path is scoped, a file-system guard test is skipped, a reverse dependent leaves visual/RTL or enters PR accessibility, or a full-suite event is narrowed |
| FR14 | `workflow-paths.test.mjs` over every workflow | path allowlist; required-context workflow | a `paths-ignore`, a match-all or exclusion glob, or a path filter on a workflow that reports a required context fails |
| FR15 | workflow contract and reconciler tests | ENGOWNER spec PR; owner command; other comment; fork review; non-spec PR; run over the request budget; maintainer dispatch; fork PR, code-only: an owner's exact-head approval plus the owner command clears the code half | `review-required` succeeds while spec approval is missing, another workflow publishes a review context, a fork review starts the spec checks, a non-command comment starts a runner, an over-budget run decides, or a fork's approved code-only PR stays pending after the owner command |