You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: docs/ci.md
+8-8Lines changed: 8 additions & 8 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -90,9 +90,9 @@ Scope logic lives in `scripts/ci-changed-scope.mjs` and is covered by unit tests
90
90
91
91
The slowest Node test families are split or balanced so each job stays small without over-reserving runners: plugin contracts and channel contracts each run as two weighted Blacksmith-backed shards with the standard GitHub runner fallback, core unit fast/support lanes run separately, core runtime infra is split between state, process/config, shared, and three cron domain shards, auto-reply runs as balanced workers (with the reply subtree split into agent-runner, dispatch, and commands/state-routing shards), and agentic gateway/server configs are split across chat/auth/model/http-plugin/runtime/startup lanes instead of waiting on built artifacts. Normal CI then packs only isolated infra include-pattern shards into deterministic bundles of at most 64 test files, reducing the Node matrix without merging non-isolated command/cron, stateful agents-core, or gateway/server suites; heavy fixed suites stay on 8 vCPU while the bundled and lower-weight lanes use 4 vCPU. Pull requests on the canonical repository use an additional compact admission plan: the same per-config groups run in isolated subprocesses inside the current 34-job Linux Node plan, so a single PR does not register the full 70-plus-job Node matrix. `main` pushes, manual dispatches, and release gates retain the full matrix. Broad browser, QA, media, and miscellaneous plugin tests use their dedicated Vitest configs instead of the shared plugin catch-all. Include-pattern shards record timing entries using the CI shard name, so `.artifacts/vitest-shard-timings.json` can distinguish a whole config from a filtered shard. `check-additional-*` keeps package-boundary compile/canary work together and separates runtime topology architecture from gateway watch coverage; the boundary guard list is striped into one prompt-heavy shard and one combined shard for the remaining guard stripes, each running selected independent guards concurrently and printing per-check timings. The expensive Codex happy-path prompt snapshot drift check runs as its own additional job for manual CI and for prompt-affecting changes only, so normal unrelated Node changes do not wait behind cold prompt snapshot generation and the boundary shards stay balanced while prompt drift is still pinned to the PR that caused it; the same flag skips prompt snapshot Vitest generation inside the built-artifact core support-boundary shard. Gateway watch, channel tests, and the core support-boundary shard run concurrently inside `build-artifacts` after `dist/` and `dist-runtime/` are already built.
92
92
93
-
Once admitted, canonical Linux CI permits up to 12 concurrent Node jobs and 8 for
94
-
the smaller fast/check lanes; Windows and Android stay at two because those
95
-
runner pools are narrower.
93
+
Once admitted, canonical Linux CI permits up to 24 concurrent Node test jobs and
94
+
12 for the smaller fast/check lanes; Windows and Android stay at two because
95
+
those runner pools are narrower.
96
96
97
97
The compact PR plan emits 18 Node jobs for the current suite: whole-config
98
98
groups are batched in isolated subprocesses with a 120-minute batch timeout,
@@ -145,17 +145,17 @@ gh workflow run full-release-validation.yml --ref main -f ref=<branch-or-sha>
145
145
146
146
## Runner registration budget
147
147
148
-
GitHub caps self-hosted runner registrations at 1,500 runners per 5 minutes per
149
-
repository, organization, or enterprise. The limit is shared by all Blacksmith
150
-
runner registrations in the `openclaw` organization, so adding another
151
-
Blacksmith installation does not add a new bucket.
148
+
OpenClaw's current GitHub runner-registration bucket allows 3,000 self-hosted
149
+
runner registrations per 5 minutes. The limit is shared by all Blacksmith runner
150
+
registrations in the `openclaw` organization, so adding another Blacksmith
151
+
installation does not add a new bucket.
152
152
153
153
Treat Blacksmith labels as the scarce resource for burst control. Jobs that
154
154
only route, notify, summarize, select shards, or run short CodeQL scans should
155
155
stay on GitHub-hosted runners unless they have measured Blacksmith-specific
156
156
needs. Any new Blacksmith matrix, larger `max-parallel`, or high-frequency
157
157
workflow must show its worst-case registration count and keep the org-level
158
-
target below 1,000 registrations per 5 minutes, leaving headroom for concurrent
158
+
target below 2,000 registrations per 5 minutes, leaving headroom for concurrent
159
159
repositories and retried jobs.
160
160
161
161
Canonical-repo CI keeps Blacksmith as the default runner path for normal push and pull-request runs. `workflow_dispatch` and non-canonical repository runs use GitHub-hosted runners, but normal canonical runs do not currently probe Blacksmith queue health or automatically fall back to GitHub-hosted labels when Blacksmith is unavailable.
0 commit comments