@futurelastic/colab-handbook 1.20.4-rc.8 → 1.20.4-rc.9

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/package.json CHANGED
@@ -33,5 +33,5 @@
33
33
  "engines": {
34
34
  "node": ">=18"
35
35
  },
36
- "version": "1.20.4-rc.8"
36
+ "version": "1.20.4-rc.9"
37
37
  }
@@ -428,8 +428,8 @@ Decided 2026-07-19, after a GitHub Actions billing lock stopped every
428
428
  | Repo class | `runs-on` | Why |
429
429
  |---|---|---|
430
430
  | **Public** repo | `ubuntu-latest` | Free minutes, unaffected by billing — and **never** self-hosted: a fork PR would execute arbitrary code on your runner. |
431
- | **Private** CI | the org's `[self-hosted, ...]` runner **where one exists**; `ubuntu-latest` otherwise | Immune to billing, persistent tool caches, local network. Runners are registered per-org — one org's runner serves nothing in another org. Register a runner for an org when its billing or scale makes it worth it, not preemptively. |
432
- | **Private** deploy | its own runner label | Deploys must never queue behind CI jobs. |
431
+ | **Private** CI | `[self-hosted, <class>]` — a job class, never a host ([CONVENTIONS.md §7, *Runner classes*](../CONVENTIONS.md#runner-classes--runs-on-names-a-job-class-never-a-host-720)) — **where the org's pool carries that class online**; `ubuntu-latest` otherwise | Immune to billing, persistent tool caches, local network. Runners are registered per-org — one org's runner serves nothing in another org. Register a runner for an org when its billing or scale makes it worth it, not preemptively. Each template's `runs-on` `EDIT:` names the class its job takes. |
432
+ | **Private** deploy | its own restricted runner label, outside the classes | Deploys must never queue behind CI jobs. |
433
433
 
434
434
  Self-hosted job hygiene: no `sudo`, install tools into `$RUNNER_TEMP`, never
435
435
  write outside the workspace, prefer the runner's native toolchains. A shared
@@ -64,7 +64,7 @@ jobs:
64
64
  # that concludes `success` when the nightly skips: a run whose jobs all skip reads as not-green.
65
65
  plan:
66
66
  name: What to test
67
- runs-on: ubuntu-latest # EDIT: needs `gh` (GitHub-hosted images have it).
67
+ runs-on: ubuntu-latest # EDIT: self-hosted → the trunk class, never a host (CONVENTIONS.md §7, "Runner classes"); it needs `gh`.
68
68
  timeout-minutes: 5
69
69
  permissions:
70
70
  actions: read
@@ -129,7 +129,7 @@ jobs:
129
129
  name: Full suite @ ${{ needs.plan.outputs.sha }}
130
130
  needs: plan
131
131
  if: ${{ needs.plan.outputs.run == 'true' }}
132
- runs-on: ubuntu-latest # EDIT: self-hosted label if this repo needs one.
132
+ runs-on: ubuntu-latest # EDIT: self-hosted → a class, never a host: e2e (service containers), browser (browser-driven), else trunk (CONVENTIONS.md §7, "Runner classes").
133
133
  timeout-minutes: 120 # EDIT: well above YOUR heavy p99; the default is 360.
134
134
  permissions:
135
135
  contents: read
@@ -357,7 +357,7 @@ jobs:
357
357
  name: Secret scan, full history (gitleaks)
358
358
  needs: plan
359
359
  if: ${{ needs.plan.outputs.run == 'true' }}
360
- runs-on: ubuntu-latest # EDIT: the same label as ci.yml's gitleaks job.
360
+ runs-on: ubuntu-latest # EDIT: self-hosted → the trunk class, never a host (CONVENTIONS.md §7, "Runner classes").
361
361
  timeout-minutes: 30 # the whole history, not a range. EDIT: the default is 360.
362
362
  permissions:
363
363
  contents: read
@@ -482,7 +482,7 @@ jobs:
482
482
  name: Report a red nightly
483
483
  needs: [plan, heavy, secrets]
484
484
  if: ${{ always() && github.event_name == 'schedule' && (needs.heavy.result == 'failure' || needs.secrets.result == 'failure') }}
485
- runs-on: ubuntu-latest # EDIT: needs `gh`.
485
+ runs-on: ubuntu-latest # EDIT: self-hosted → the trunk class; it needs `gh`.
486
486
  timeout-minutes: 5
487
487
  permissions:
488
488
  issues: write
@@ -57,7 +57,7 @@ on:
57
57
  # EDIT: on ONE self-hosted agent shared with trunk, go back to trunk-only until
58
58
  # trunk has its own lane — branch runs queue ahead of the one trunk run a merge
59
59
  # waits for (CONVENTIONS.md §7, "Self-hosted runners", #355). GitHub-hosted
60
- # runners, a runner pool, or a trunk-only label picked in `runs-on` on
60
+ # runners, a runner pool, or the `trunk` class picked in `runs-on` on
61
61
  # github.ref all have that capacity; keep '**' there. Trunk-only means the
62
62
  # branches this repo actually has — and never drop `dev` on a Tier A or C repo:
63
63
  # dev is the trunk, so a main-only trigger runs zero checks on the branch you
@@ -141,7 +141,7 @@ jobs:
141
141
  name: Already tested at this sha or tree?
142
142
  # EDIT: the trunk refs here mirror `concurrency`'s list above (#493).
143
143
  if: github.event_name == 'push' && (github.event.created || github.ref == 'refs/heads/main' || github.ref == 'refs/heads/dev')
144
- runs-on: ubuntu-latest # EDIT: the same label as the jobs below; it needs `gh` (GitHub-hosted images have it).
144
+ runs-on: ubuntu-latest # EDIT: self-hosted → the class of the jobs below, never a host (CONVENTIONS.md §7, "Runner classes"); it needs `gh`.
145
145
  timeout-minutes: 5 # one `gh api` listing, a hung call must not hold the slot. EDIT: the default is 360.
146
146
  permissions:
147
147
  actions: read
@@ -266,7 +266,7 @@ jobs:
266
266
  name: Secret scan (gitleaks)
267
267
  needs: dedupe
268
268
  if: ${{ !cancelled() && needs.dedupe.outputs.tested != 'true' && (github.event_name != 'pull_request' || github.event.pull_request.head.repo.full_name != github.repository) }}
269
- runs-on: ubuntu-latest # EDIT: self-hosted label if this repo needs one.
269
+ runs-on: ubuntu-latest # EDIT: self-hosted → a class, never a host: quick on a branch, trunk on trunk (CONVENTIONS.md §7, "Runner classes").
270
270
  timeout-minutes: 15 # a scan of the checkout. EDIT: the default is 360.
271
271
  steps:
272
272
  - uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6
@@ -419,7 +419,7 @@ jobs:
419
419
  name: Build (Laravel + Vite)
420
420
  needs: dedupe
421
421
  if: ${{ !cancelled() && needs.dedupe.outputs.tested != 'true' && (github.event_name != 'pull_request' || github.event.pull_request.head.repo.full_name != github.repository) }}
422
- runs-on: ubuntu-latest # EDIT: self-hosted label if this repo needs one.
422
+ runs-on: ubuntu-latest # EDIT: self-hosted → a class, never a host: full (quick if it keeps quick's promise) on a branch, trunk on trunk (CONVENTIONS.md §7, "Runner classes").
423
423
  timeout-minutes: 45 # a hung build must not hold the runner for the 360-minute default (#572).
424
424
  # EDIT: measured (#572): the slowest Laravel adopter's build ran p99 20 / max 26 min. Keep this
425
425
  # well above YOUR p99 — below it a slow but healthy suite goes red (`gh run view <id>` per job).
@@ -807,7 +807,7 @@ jobs:
807
807
  # including `dedupe`, which is skipped on every ordinary push — so the implicit
808
808
  # form would skip this job on exactly the runs it exists for (#418).
809
809
  if: ${{ !cancelled() && needs.build.result == 'success' }}
810
- runs-on: ubuntu-latest # EDIT: self-hosted label if this repo needs one.
810
+ runs-on: ubuntu-latest # EDIT: self-hosted → a class, never a host: e2e (service containers) (CONVENTIONS.md §7, "Runner classes").
811
811
  timeout-minutes: 15 # a hung round-trip must not hold the runner for the 360-minute default (#572).
812
812
  # EDIT: measured (#572): p99 under 4 min / max 5 min on every adopter. Keep it well above your own p99.
813
813
  strategy:
@@ -61,7 +61,7 @@ jobs:
61
61
  # that concludes `success` when the nightly skips: a run whose jobs all skip reads as not-green.
62
62
  plan:
63
63
  name: What to test
64
- runs-on: ubuntu-latest # EDIT: needs `gh` (GitHub-hosted images have it).
64
+ runs-on: ubuntu-latest # EDIT: self-hosted → the trunk class, never a host (CONVENTIONS.md §7, "Runner classes"); it needs `gh`.
65
65
  timeout-minutes: 5
66
66
  permissions:
67
67
  actions: read
@@ -126,7 +126,7 @@ jobs:
126
126
  name: Full suite @ ${{ needs.plan.outputs.sha }}
127
127
  needs: plan
128
128
  if: ${{ needs.plan.outputs.run == 'true' }}
129
- runs-on: ubuntu-latest # EDIT: self-hosted label if this repo needs one.
129
+ runs-on: ubuntu-latest # EDIT: self-hosted → a class, never a host: e2e (service containers), browser (browser-driven), else trunk (CONVENTIONS.md §7, "Runner classes").
130
130
  timeout-minutes: 120 # EDIT: well above YOUR heavy p99; the default is 360.
131
131
  permissions:
132
132
  contents: read
@@ -280,7 +280,7 @@ jobs:
280
280
  name: Secret scan, full history (gitleaks)
281
281
  needs: plan
282
282
  if: ${{ needs.plan.outputs.run == 'true' }}
283
- runs-on: ubuntu-latest # EDIT: the same label as ci.yml's gitleaks job.
283
+ runs-on: ubuntu-latest # EDIT: self-hosted → the trunk class, never a host (CONVENTIONS.md §7, "Runner classes").
284
284
  timeout-minutes: 30 # the whole history, not a range. EDIT: the default is 360.
285
285
  permissions:
286
286
  contents: read
@@ -409,7 +409,7 @@ jobs:
409
409
  name: Report a red nightly
410
410
  needs: [plan, heavy, secrets]
411
411
  if: ${{ always() && github.event_name == 'schedule' && (needs.heavy.result == 'failure' || needs.secrets.result == 'failure') }}
412
- runs-on: ubuntu-latest # EDIT: needs `gh`.
412
+ runs-on: ubuntu-latest # EDIT: self-hosted → the trunk class; it needs `gh`.
413
413
  timeout-minutes: 5
414
414
  permissions:
415
415
  issues: write
@@ -44,7 +44,7 @@ on:
44
44
  # EDIT: on ONE self-hosted agent shared with trunk, go back to trunk-only until
45
45
  # trunk has its own lane — branch runs queue ahead of the one trunk run a merge
46
46
  # waits for (CONVENTIONS.md §7, "Self-hosted runners", #355). GitHub-hosted
47
- # runners, a runner pool, or a trunk-only label picked in `runs-on` on
47
+ # runners, a runner pool, or the `trunk` class picked in `runs-on` on
48
48
  # github.ref all have that capacity; keep '**' there. Trunk-only means the
49
49
  # branches this repo actually has — and never drop `dev` on a Tier A or C repo:
50
50
  # dev is the trunk, so a main-only trigger runs zero checks on the branch you
@@ -126,7 +126,7 @@ jobs:
126
126
  name: Already tested at this sha or tree?
127
127
  # EDIT: the trunk refs here mirror `concurrency`'s list above (#493).
128
128
  if: github.event_name == 'push' && (github.event.created || github.ref == 'refs/heads/main' || github.ref == 'refs/heads/dev')
129
- runs-on: ubuntu-latest # EDIT: the same label as the jobs below; it needs `gh` (GitHub-hosted images have it).
129
+ runs-on: ubuntu-latest # EDIT: self-hosted → the class of the jobs below, never a host (CONVENTIONS.md §7, "Runner classes"); it needs `gh`.
130
130
  timeout-minutes: 5 # one `gh api` listing, a hung call must not hold the slot. EDIT: the default is 360.
131
131
  permissions:
132
132
  actions: read
@@ -251,7 +251,7 @@ jobs:
251
251
  name: Secret scan (gitleaks)
252
252
  needs: dedupe
253
253
  if: ${{ !cancelled() && needs.dedupe.outputs.tested != 'true' && (github.event_name != 'pull_request' || github.event.pull_request.head.repo.full_name != github.repository) }}
254
- runs-on: ubuntu-latest # EDIT: self-hosted label if this repo needs one.
254
+ runs-on: ubuntu-latest # EDIT: self-hosted → a class, never a host: quick on a branch, trunk on trunk (CONVENTIONS.md §7, "Runner classes").
255
255
  timeout-minutes: 15 # a scan of the checkout. EDIT: the default is 360.
256
256
  steps:
257
257
  - uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6
@@ -431,7 +431,7 @@ jobs:
431
431
  # workspace isn't even checked out yet at job level, so a job-level
432
432
  # hashFiles() would have been testing an empty directory even if it were
433
433
  # allowed.
434
- runs-on: ubuntu-latest # EDIT: self-hosted label if this repo needs one.
434
+ runs-on: ubuntu-latest # EDIT: self-hosted → a class, never a host: full (quick if it keeps quick's promise) on a branch, trunk on trunk (CONVENTIONS.md §7, "Runner classes").
435
435
  timeout-minutes: 60 # a hung build must not hold the runner for the 360-minute default (#572).
436
436
  # EDIT: measured (#572): the slowest Node adopter's build ran p99 37 / max 43 min. Keep this
437
437
  # well above YOUR p99 — below it a slow but healthy suite goes red (`gh run view <id>` per job).
@@ -785,7 +785,7 @@ jobs:
785
785
  # # including `dedupe`, which is skipped on every ordinary push (#418). `roundtrip` is `on`
786
786
  # # only once ROUNDTRIP_APPLY (the workflow env, above) is set — skipped until then (#625).
787
787
  # if: ${{ !cancelled() && needs.build.result == 'success' && needs.build.outputs.roundtrip == 'on' }}
788
- # runs-on: ubuntu-latest # EDIT: self-hosted label if this repo needs one.
788
+ # runs-on: ubuntu-latest # EDIT: self-hosted → a class, never a host: e2e (service containers) (CONVENTIONS.md §7, "Runner classes").
789
789
  # timeout-minutes: 15 # a hung round-trip must not hold the runner for the 360-minute default (#572).
790
790
  # # EDIT: measured (#572): p99 under 4 min on every adopter. Keep it well above your own p99.
791
791
  # strategy:
@@ -63,7 +63,7 @@ jobs:
63
63
  # that concludes `success` when the nightly skips: a run whose jobs all skip reads as not-green.
64
64
  plan:
65
65
  name: What to test
66
- runs-on: ubuntu-latest # EDIT: needs `gh` (GitHub-hosted images have it).
66
+ runs-on: ubuntu-latest # EDIT: self-hosted → the trunk class, never a host (CONVENTIONS.md §7, "Runner classes"); it needs `gh`.
67
67
  timeout-minutes: 5
68
68
  permissions:
69
69
  actions: read
@@ -128,7 +128,7 @@ jobs:
128
128
  name: Full suite @ ${{ needs.plan.outputs.sha }}
129
129
  needs: plan
130
130
  if: ${{ needs.plan.outputs.run == 'true' }}
131
- runs-on: ubuntu-latest # EDIT: self-hosted label if this repo needs one.
131
+ runs-on: ubuntu-latest # EDIT: self-hosted → a class, never a host: e2e (service containers), browser (browser-driven), else trunk (CONVENTIONS.md §7, "Runner classes").
132
132
  timeout-minutes: 120 # EDIT: well above YOUR heavy p99; the default is 360.
133
133
  permissions:
134
134
  contents: read
@@ -289,7 +289,7 @@ jobs:
289
289
  name: Secret scan, full history (gitleaks)
290
290
  needs: plan
291
291
  if: ${{ needs.plan.outputs.run == 'true' }}
292
- runs-on: ubuntu-latest # EDIT: the same label as ci.yml's gitleaks job.
292
+ runs-on: ubuntu-latest # EDIT: self-hosted → the trunk class, never a host (CONVENTIONS.md §7, "Runner classes").
293
293
  timeout-minutes: 30 # the whole history, not a range. EDIT: the default is 360.
294
294
  permissions:
295
295
  contents: read
@@ -418,7 +418,7 @@ jobs:
418
418
  name: Report a red nightly
419
419
  needs: [plan, heavy, secrets]
420
420
  if: ${{ always() && github.event_name == 'schedule' && (needs.heavy.result == 'failure' || needs.secrets.result == 'failure') }}
421
- runs-on: ubuntu-latest # EDIT: needs `gh`.
421
+ runs-on: ubuntu-latest # EDIT: self-hosted → the trunk class; it needs `gh`.
422
422
  timeout-minutes: 5
423
423
  permissions:
424
424
  issues: write
@@ -56,7 +56,7 @@ on:
56
56
  # EDIT: on ONE self-hosted agent shared with trunk, go back to trunk-only until
57
57
  # trunk has its own lane — branch runs queue ahead of the one trunk run a merge
58
58
  # waits for (CONVENTIONS.md §7, "Self-hosted runners", #355). GitHub-hosted
59
- # runners, a runner pool, or a trunk-only label picked in `runs-on` on
59
+ # runners, a runner pool, or the `trunk` class picked in `runs-on` on
60
60
  # github.ref all have that capacity; keep '**' there. Trunk-only means the
61
61
  # branches this repo actually has — and never drop `dev` on a Tier A or C repo:
62
62
  # dev is the trunk, so a main-only trigger runs zero checks on the branch you
@@ -137,7 +137,7 @@ jobs:
137
137
  name: Already tested at this sha or tree?
138
138
  # EDIT: the trunk refs here mirror `concurrency`'s list above (#493).
139
139
  if: github.event_name == 'push' && (github.event.created || github.ref == 'refs/heads/main' || github.ref == 'refs/heads/dev')
140
- runs-on: ubuntu-latest # EDIT: the same label as the jobs below; it needs `gh` (GitHub-hosted images have it).
140
+ runs-on: ubuntu-latest # EDIT: self-hosted → the class of the jobs below, never a host (CONVENTIONS.md §7, "Runner classes"); it needs `gh`.
141
141
  timeout-minutes: 5 # one `gh api` listing, a hung call must not hold the slot. EDIT: the default is 360.
142
142
  permissions:
143
143
  actions: read
@@ -262,7 +262,7 @@ jobs:
262
262
  name: Secret scan (gitleaks)
263
263
  needs: dedupe
264
264
  if: ${{ !cancelled() && needs.dedupe.outputs.tested != 'true' && (github.event_name != 'pull_request' || github.event.pull_request.head.repo.full_name != github.repository) }}
265
- runs-on: ubuntu-latest # EDIT: self-hosted label if this repo needs one.
265
+ runs-on: ubuntu-latest # EDIT: self-hosted → a class, never a host: quick on a branch, trunk on trunk (CONVENTIONS.md §7, "Runner classes").
266
266
  timeout-minutes: 15 # a scan of the checkout. EDIT: the default is 360.
267
267
  steps:
268
268
  - uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6
@@ -419,7 +419,7 @@ jobs:
419
419
  name: Build (Python)
420
420
  needs: dedupe
421
421
  if: ${{ !cancelled() && needs.dedupe.outputs.tested != 'true' && (github.event_name != 'pull_request' || github.event.pull_request.head.repo.full_name != github.repository) }}
422
- runs-on: ubuntu-latest # EDIT: self-hosted label if this repo needs one.
422
+ runs-on: ubuntu-latest # EDIT: self-hosted → a class, never a host: full (quick if it keeps quick's promise) on a branch, trunk on trunk (CONVENTIONS.md §7, "Runner classes").
423
423
  timeout-minutes: 30 # a hung build must not hold the runner for the 360-minute default (#572).
424
424
  # EDIT: NOT a measured fit (#572) — one Python adopter, whose build is a byte-compile (p99
425
425
  # under 1 min). Set it well above YOUR p99 — below it a slow but healthy suite goes red.
@@ -754,7 +754,7 @@ jobs:
754
754
  # # including `dedupe`, which is skipped on every ordinary push (#418). `roundtrip` is `on`
755
755
  # # only once ROUNDTRIP_APPLY (the workflow env, above) is set — skipped until then (#625).
756
756
  # if: ${{ !cancelled() && needs.build.result == 'success' && needs.build.outputs.roundtrip == 'on' }}
757
- # runs-on: ubuntu-latest # EDIT: self-hosted label if this repo needs one.
757
+ # runs-on: ubuntu-latest # EDIT: self-hosted → a class, never a host: e2e (service containers) (CONVENTIONS.md §7, "Runner classes").
758
758
  # timeout-minutes: 15 # a hung round-trip must not hold the runner for the 360-minute default (#572).
759
759
  # # EDIT: NOT measured for Python (#572) — ci-node's adopters ran p99 under 4 min. Keep it well above your own p99.
760
760
  # strategy:
@@ -11,6 +11,7 @@ on:
11
11
  jobs:
12
12
  instruction-files:
13
13
  uses: futurelastic/colab-handbook/.github/workflows/instruction-files.yml@main
14
- # No GitHub-hosted minutes (self-hosted-only org)? Pass your runner (#594) — a label or a JSON list:
14
+ # No GitHub-hosted minutes (self-hosted-only org)? Pass your runner (#594) — a label or a JSON list,
15
+ # naming a job class, never a host (CONVENTIONS.md §7, "Runner classes"):
15
16
  # with:
16
- # runs-on: '["self-hosted","linux"]'
17
+ # runs-on: '["self-hosted","quick"]'
@@ -221,9 +221,11 @@
221
221
  # owner's billing fails GitHub refuses a hosted job before it starts: main goes red, every landing
222
222
  # is refused until a human steps in — measured twice in a row on one adopting repo, where this was
223
223
  # the only workflow on main still on hosted runners. So:
224
- # private / internal repo `release`, `npm-record` (and `deploy`, if you enable it) run on the
225
- # SAME self-hosted label your ci.yml's trunk jobs use. The runner needs
226
- # git, node, gh and jq on its PATH (GitHub-hosted images have all four).
224
+ # private / internal repo `release` and `npm-record` run on the trunk class, `[self-hosted,
225
+ # trunk]` — the class your ci.yml's trunk jobs use (CONVENTIONS.md §7,
226
+ # "Runner classes"); `deploy`, if you enable it, on its own restricted
227
+ # deploy label. The runner needs git, node, gh and jq on its PATH
228
+ # (GitHub-hosted images have all four).
227
229
  # public repo `ubuntu-latest` is fine — hosted minutes are free there.
228
230
  # the `npm` job GitHub-hosted on every repo: npm trusted publishing requires it. It only
229
231
  # runs on a public repo (a private one is refused outright, #432), so it
@@ -359,7 +361,7 @@ jobs:
359
361
  # the whole run as `skipped` at that main sha, and `colab ship` reads any finished run that is
360
362
  # neither success nor cancelled as "not green". Re-run CI green on that sha and the skipped
361
363
  # Release (auto) row would still sit beside it, refusing every ship until main moves.
362
- # EDIT: PRIVATE repo → your ci.yml's self-hosted trunk label, e.g. [self-hosted, linux]
364
+ # EDIT: PRIVATE repo → the trunk class, [self-hosted, trunk] — a class, never a host
363
365
  # (RUNNERS, above). ubuntu-latest only on a public repo.
364
366
  runs-on: ubuntu-latest
365
367
  permissions:
@@ -107,7 +107,7 @@ jobs:
107
107
  release:
108
108
  name: Publish release
109
109
  needs: heavy
110
- runs-on: ubuntu-latest # EDIT: self-hosted label if this repo needs one.
110
+ runs-on: ubuntu-latest # EDIT: self-hosted → the trunk class, never a host (CONVENTIONS.md §7, "Runner classes").
111
111
  permissions:
112
112
  # Required to create the release. Nothing else is needed — keep it minimal.
113
113
  contents: write
@@ -363,7 +363,7 @@ function releaseRungSteps(ctx = {}) {
363
363
  const texts = ctx.workflowTexts || {};
364
364
  const releaseWf = Object.keys(texts).find((f) => /colab release cut/.test(texts[f] || ''));
365
365
  if (releaseWf) {
366
- steps.push({ n: 6, text: `Release workflow present (.github/workflows/${releaseWf}) — check its \`HANDBOOK_REF\` names a ref the handbook carries (#480) and its \`runs-on\` is the self-hosted label on a private repo` });
366
+ steps.push({ n: 6, text: `Release workflow present (.github/workflows/${releaseWf}) — check its \`HANDBOOK_REF\` names a ref the handbook carries (#480) and its \`runs-on\` is the trunk class, [self-hosted, trunk], on a private repo` });
367
367
  } else {
368
368
  steps.push({ n: 6, text: 'Copy the release workflow — `colab template release-auto`, then walk its `# EDIT:` points: `HANDBOOK_REF` (a channel or tag the handbook carries, #480), the test-suite workflow `name:`, and on a PRIVATE repo the self-hosted runner label from ci.yml on every job except `npm` (#492)' });
369
369
  }
@@ -114,7 +114,7 @@ function findings({ readFile, workflows, visibility }) {
114
114
  const own = selfHostedLabel(workflows, readFile, wf);
115
115
  const hint = own
116
116
  ? `use the label your ${own.wf} already runs on: runs-on: [${own.labels.join(', ')}]`
117
- : 'use your self-hosted trunk runner label';
117
+ : 'use the trunk runner class: runs-on: [self-hosted, trunk] (CONVENTIONS.md §7, "Runner classes")';
118
118
  for (const j of hosted) {
119
119
  out.push(`${wf} job \`${j.job}\` runs on GitHub-hosted (${j.runsOn.join(', ')}, line ${j.line}) on a ${String(visibility).toLowerCase()} repo — hosted minutes are billed here, and a billing refusal fails this run at trunk's head, which turns trunk red for \`colab ship\`; ${hint} (templates/release-auto.yml, RUNNERS)`);
120
120
  }