openclaw/docs/ci.md
Peter Steinberger 77292356e9
fix(ui): avoid redundant child-session refreshes in chat (#146122)
* fix(ui): avoid redundant child-session refreshes in chat

* fix(ui): preserve scoped chat refresh ownership

* test(ui): keep scoped session fixtures authoritative

Keep canonical mock transitions and child query membership aligned across descriptor, history, and list reads. Preserve real Gateway stale Stop coverage by delaying only the exact terminal descriptor until post-Stop history recovery. Rebalance existing Gateway test-type graphs after main exceeded the unchanged root budget.

* ci: match real Gateway job budgets to hosted runners

Give the existing hosted real-Gateway route a 40-minute job budget while retaining 20 minutes on Blacksmith. The hosted diagnostic run reached its job deadline after 7m42s of preparation and a progressing full suite. Preserve every per-test deadline, test inventory, worker, runner and concurrency setting; check budget/routing agreement across 96 contexts.
2026-09-12 11:40:00 -07:00

7.8 KiB

summary title read_when
CI job graph, scope gates, release umbrellas, and local command equivalents CI pipeline
You need to understand why a CI job did or did not run
You are debugging a failing GitHub Actions check
You are coordinating a release validation run or rerun
You are changing ClawSweeper dispatch or GitHub activity forwarding

This page is an index. CI is documented on nine pages, one per reader job. Open the page that matches your task.

For the published-upgrade regression gate, see selection and routing, runner budgets, and Package Acceptance baselines. Weekly validation is listed under Update Migration.

Docs-only main pushes skip CI. Every canonical main push admitted by the CI workflow selects the published-upgrade regression gate.

Real-Gateway browser checks use job budgets matched to their selected runner.

Page Read it when
CI pipeline jobs The job table, the fail-fast order, and the Control UI size budgets.
Watch a CI run Wait on one pull request head, recover a stuck run, and pass the evidence gate.
CI checkout ownership Shared checkout anchors, fetch retry budgets, and trusted action policy.
CI scope and routing Why a job did or did not run: changed-scope detection and manual dispatch.
CI runner classes Trust-based runner routing, Blacksmith classes, and runner backend modes.
CI capacity and shard weights The runner registration budget and the measured timings behind shard packing.
Release validation workflows Full Release Validation, live and E2E shards, Package Acceptance, install smoke, Docker E2E, and Plugin Prerelease.
Scheduled and maintenance workflows OpenClaw Performance, QA Lab, CodeQL, the maintenance jobs, and ClawSweeper activity forwarding.
Local checks and Testbox Reproduce a lane locally, keep the shrink-only ratchets, and run Crabbox or Testbox proof.

Where each section moved

Every section heading from the previous single-page version keeps its anchor here, so an existing link such as /ci#pipeline-overview still resolves. Each entry points at the page that now holds the content.