- `pnpm check:changed`: runs the smart changed check gate for the diff against `origin/main`. It runs typecheck, lint, and guard commands for the affected architectural lanes, but does not run Vitest tests. Use `pnpm test:changed` or explicit `pnpm test <target>` for test proof.

- `pnpm test`: routes explicit file/directory targets through scoped Vitest lanes. Untargeted runs use fixed shard groups and expand to leaf configs for local parallel execution; the extension group always expands to the per-extension shard configs instead of one giant root-project process.

- Test wrapper runs end with a short `[test] passed|failed|skipped ... in ...` summary. Vitest's own duration line stays the per-shard detail.

- Shared OpenClaw test state: use `src/test-utils/openclaw-test-state.ts` from Vitest when a test needs an isolated `HOME`, `OPENCLAW_STATE_DIR`, `OPENCLAW_CONFIG_PATH`, config fixture, workspace, agent dir, or auth-profile store. Docker/Bash E2E lanes can use `scripts/lib/openclaw-test-state.mjs shell --label <name> --scenario <name>` for an in-container shell snippet, or `node scripts/lib/openclaw-test-state.mjs -- create --label <name> --scenario <name> --env-file <path> --json` for a sourceable host env file. The `--` before `create` keeps newer Node runtimes from treating `--env-file` as a Node flag.

- Full, extension, and include-pattern shard runs update local timing data in `.artifacts/vitest-shard-timings.json`; later whole-config runs use those timings to balance slow and fast shards. Include-pattern CI shards append the shard name to the timing key, which keeps filtered shard timings visible without replacing whole-config timing data. Set `OPENCLAW_TEST_PROJECTS_TIMINGS=0` to ignore the local timing artifact.

- Selected `plugin-sdk` and `commands` test files now route through dedicated light lanes that keep only `test/setup.ts`, leaving runtime-heavy cases on their existing lanes.

- Source files with sibling tests map to that sibling before falling back to wider directory globs. Helper edits under `src/channels/plugins/contracts/test-helpers`, `src/plugin-sdk/test-helpers`, and `src/plugins/contracts` use a local import graph to run importing tests instead of broad-running every shard when the dependency path is precise.

ROOT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")/../.." && pwd)"

source "$ROOT_DIR/scripts/lib/docker-e2e-image.sh"

IMAGE_NAME="$(docker_e2e_resolve_image "openclaw-onboard-e2e" OPENCLAW_ONBOARD_E2E_IMAGE)"

OPENCLAW_TEST_STATE_FUNCTION_B64="$(

node "$ROOT_DIR/scripts/lib/openclaw-test-state.mjs" shell-function \

| base64 \

| tr -d '\n'

)"

docker_e2e_build_or_reuse "$IMAGE_NAME" onboard

echo "Running onboarding E2E..."

docker run --rm -t "$IMAGE_NAME" bash -lc '

docker run --rm -t \

-e "OPENCLAW_TEST_STATE_FUNCTION_B64=$OPENCLAW_TEST_STATE_FUNCTION_B64" \

"$IMAGE_NAME" bash -lc '

set -euo pipefail

trap "" PIPE

export TERM=xterm-256color

eval "$(printf "%s" "${OPENCLAW_TEST_STATE_FUNCTION_B64:?missing OPENCLAW_TEST_STATE_FUNCTION_B64}" | base64 -d)"

ONBOARD_FLAGS="--flow quickstart --auth-choice skip --skip-channels --skip-skills --skip-daemon --skip-ui"

# tsdown may emit dist/index.js or dist/index.mjs depending on runtime/bundler.

if [ -f dist/index.mjs ]; then

}

set_isolated_openclaw_env() {

local home_dir="$1"

export HOME="$home_dir"

export OPENCLAW_HOME="$home_dir"

export OPENCLAW_STATE_DIR="$home_dir/.openclaw"

export OPENCLAW_CONFIG_PATH="$OPENCLAW_STATE_DIR/openclaw.json"

mkdir -p "$OPENCLAW_STATE_DIR"

local label="$1"

openclaw_test_state_create "$label" empty

}

assert_file() {

PACKAGE_TGZ="$(docker_e2e_prepare_package_tgz update-channel-switch "${OPENCLAW_CURRENT_PACKAGE_TGZ:-}")"

# Bare lanes mount the package artifact instead of baking app sources into the image.

docker_e2e_package_mount_args "$PACKAGE_TGZ"

OPENCLAW_TEST_STATE_SCRIPT_B64="$(

node "$ROOT_DIR/scripts/lib/openclaw-test-state.mjs" shell \

--label update-channel-switch \

--scenario update-stable \

| base64 \

| tr -d '\n'

)"

docker_e2e_build_or_reuse "$IMAGE_NAME" update-channel-switch "$ROOT_DIR/scripts/e2e/Dockerfile" "$ROOT_DIR" "bare" "$SKIP_BUILD"

-e COREPACK_ENABLE_DOWNLOAD_PROMPT=0 \

-e OPENCLAW_SKIP_CHANNELS=1 \

-e OPENCLAW_SKIP_PROVIDERS=1 \

-e "OPENCLAW_TEST_STATE_SCRIPT_B64=$OPENCLAW_TEST_STATE_SCRIPT_B64" \

"${DOCKER_E2E_PACKAGE_ARGS[@]}" \

"$IMAGE_NAME" \

bash -lc 'set -euo pipefail

)"

export OPENCLAW_PACKAGE_ACCEPTANCE_LEGACY_COMPAT

home_dir="$(mktemp -d /tmp/openclaw-update-channel-switch-home.XXXXXX)"

export HOME="$home_dir"

mkdir -p "$HOME/.openclaw"

cat > "$HOME/.openclaw/openclaw.json" <<'"'"'JSON'"'"'

{

"update": {

"channel": "stable"

},

"plugins": {}

}

JSON

eval "$(printf "%s" "${OPENCLAW_TEST_STATE_SCRIPT_B64:?missing OPENCLAW_TEST_STATE_SCRIPT_B64}" | base64 -d)"

export OPENCLAW_GIT_DIR="$git_root"

export OPENCLAW_UPDATE_DEV_TARGET_REF="$fixture_sha"