update-v8-version

Source excerpt starting at line 1.

1---2name: update-v8-version3description: Update Codex's pinned `v8` / `rusty_v8` versions, validate the release-candidate path, and investigate failed V8 canary or artifact builds. Use when asked to bump V8, update `rusty_v8` artifacts, prepare or validate a V8 release candidate, check `v8-canary`, or diagnose why a V8 version update no longer builds.4---5 6# Update V8 Version7 8## Core Workflow9 101. Read `third_party/v8/README.md` and follow its version-bump sequence. Treat11   that document as the release-process source of truth.122. Inspect and update the concrete repo surfaces that carry the pin:13   - `codex-rs/Cargo.toml`14   - `codex-rs/Cargo.lock`15   - `MODULE.bazel`16   - `third_party/v8/BUILD.bazel`17   - `third_party/v8/README.md`18   - the matching `third_party/v8/rusty_v8_<version>.sha256` manifest when the19     remaining prebuilt inputs change203. Keep the existing checksum helpers in the loop:21 22   ```bash23   python3 .github/scripts/rusty_v8_bazel.py update-module-bazel24   python3 .github/scripts/rusty_v8_bazel.py check-module-bazel25   python3 -m unittest discover -s .github/scripts -p test_rusty_v8_bazel.py26   ```27 284. Validate the release-candidate path before broadening the work:29   - Prefer checking the `v8-canary` CI result for the candidate branch or PR30     when one exists, using GitHub check tooling or `gh` as appropriate.31   - If CI is unavailable or the user asked for a local-only check, run the32     closest local validation that is practical for the changed surface and say33     explicitly that it is a local substitute, not the full hosted canary.345. If the canary path passes, stop there. Summarize the result and encourage the35   user to commit the candidate changes or proceed with the release flow they36   requested. Do not publish tags, releases, or pushes unless the user asked.37 38## Failure Path39 40Enter this path only when the canary or local build path fails.41 421. Capture the failing target, workflow job, and first actionable error.432. Compare the currently pinned version with the target version at the relevant44   upstream tag or SHA. Inspect both:45   - `denoland/rusty_v8`46   - upstream V8 source at the target Bazel-pinned version473. Track build-relevant deltas rather than broad source churn:48   - generated binding layout changes49   - archive or asset naming changes50   - GN/Bazel target changes51   - custom libc++ / libc++abi / llvm-libc inputs52   - sandbox or pointer-compression feature relationships53   - patch hunks in `patches/` that no longer apply or no longer match upstream544. Trace each failing delta back into Codex's build graph:55   - `MODULE.bazel`56   - `third_party/v8/BUILD.bazel`57   - `.github/scripts/rusty_v8_bazel.py`58   - `.github/workflows/v8-canary.yml`59   - `.github/workflows/rusty-v8-release.yml`605. Update only the pieces required to restore the target version's build and61   artifact contract. Keep patch explanations and doc changes close to the62   affected files.636. Re-run the focused validation. If it becomes green, return to the normal64   workflow and stop with a concise summary plus the remaining release step.65 66## Reporting67 68- Say whether validation came from hosted `v8-canary` or from a local69  substitute.70- Distinguish "version bump complete" from "release published".71- When blocked, report the upstream delta that matters, the Codex file it hits,72  and the next concrete fix to try.73