Skip to content

fix(template): per-template depset recipe for the automated Ray bump#831

Merged
Aydin-ab merged 7 commits into
mainfrom
fix-ray-bump-depsets
Jul 2, 2026
Merged

fix(template): per-template depset recipe for the automated Ray bump#831
Aydin-ab merged 7 commits into
mainfrom
fix-ray-bump-depsets

Conversation

@Aydin-ab

@Aydin-ab Aydin-ab commented Jul 1, 2026

Copy link
Copy Markdown
Contributor

The /template Ray-bump automation had no per-template depset recipe, so the Ray 2.56.0 batch behaved inconsistently. This teaches the skill (and the cursor preflight) how depsets interact with a bump. Docs + preflight only — no CI or lockfile changes (those are #834 / #835 / #833).

Why

  • No per-template depset recipebump-ray-version.md only pointed at the whole-repo batch upgrade-dependencies.md; nothing covered no-lock templates or how to read the repo-global check-depsets gate.
  • [ray-update-2.56.0] Update asynchronous_inference to Ray 2.56.0 #819 was a workflow drop — the cleanest 2.56.0 PR stuck because the agent opened a draft and never dispatched /test-template.
  • .cursor was never the blockraydepsets bundles uv and recompiled fine in the cursor env; but preflight never smoke-tested the toolchain, so a real breakage would only surface mid-bump.

Changes

  • bump-ray-version.md — per-template depset recipe (no-lock vs has-lock), batch-vs-per-template preamble, check-depsets-is-repo-global note, explicit Done criteria.
  • upgrade-dependencies.md / dependencies.md — label the human/batch path; document the gate's collateral behavior.
  • .cursor/preflight.sh — depset-toolchain smoke test (fail at preflight, not mid-bump).

Testing

pre-commit on changed files passed. Docs/preflight only — no runtime impact; validated end-to-end by retriggering template-updater against the fixed skill.

bump-ray-version.md gains a per-template depset recipe (no-lock vs has-lock
incremental repoint), a batch-vs-per-template preamble, check-depsets literacy,
and explicit Done criteria (never leave a draft with no test dispatched).
upgrade-dependencies.md is labeled the human/whole-repo batch path;
dependencies.md documents the repo-global gate's collateral behavior.
.cursor/preflight.sh smoke-tests the depset toolchain so it fails at preflight,
not mid-bump.

CI-gate changes (scope-to-changed + retry) and the scheduled refresh live in
their own PRs.

Claude-Session: https://claude.ai/code/session_01HEiVRurDkXnrLAyCduiLdH
Signed-off-by: Aydin Abiar <aydin@anyscale.com>
…'s deps

Expand references/dependencies.md: add a "Running it" section (linux-x86_64 only;
macOS via Docker + uname shim) and a "Changing a template's dependencies" recipe;
sharpen the base-lock overview (it's Ray's img lock re-emitted minus ray, not a
fresh resolve); surface the driver-vs-workers wiring (workers get deps only via
runtime_env). Trim redundancy — consolidate the two check-depsets gotchas, drop
the parked scoped/scheduled claim, merge the pin traps. Cross-link "Running it"
from both workflows.

Claude-Session: https://claude.ai/code/session_01HEiVRurDkXnrLAyCduiLdH
Signed-off-by: Aydin Abiar <aydin@anyscale.com>
@Aydin-ab Aydin-ab force-pushed the fix-ray-bump-depsets branch from d0ce34b to 75466d6 Compare July 2, 2026 20:16
@Aydin-ab Aydin-ab marked this pull request as ready for review July 2, 2026 20:17
@Aydin-ab Aydin-ab requested a review from a team as a code owner July 2, 2026 20:17
…late only)

bump-ray-version.md is the per-template flow; it doesn't need to explain the
whole-repo batch alternative. Remove its "Batch vs per-template" preamble and the
matching "Audience — whole repo" paragraph in upgrade-dependencies.md. The
per-template recipe (add/attach/repoint own entry) already stands on its own.

Claude-Session: https://claude.ai/code/session_01HEiVRurDkXnrLAyCduiLdH
Signed-off-by: Aydin Abiar <aydin@anyscale.com>
Aydin-ab and others added 2 commits July 2, 2026 15:00
…ld shipped)

raydepsets v0.0.1 now publishes raydepsets-darwin-arm64 alongside linux-x86_64, so
./update_deps.sh runs natively on both. Drop the Docker + uname-shim workaround from
dependencies.md "Running it" and the linux-only caveats in the two workflows.
Verified: a native macOS compile of ray_depset_2.56.0_3.11 reproduces the committed
lock byte-for-byte.

Claude-Session: https://claude.ai/code/session_01HEiVRurDkXnrLAyCduiLdH
Signed-off-by: Aydin Abiar <aydin@anyscale.com>
@Aydin-ab Aydin-ab force-pushed the fix-ray-bump-depsets branch 2 times, most recently from 05cc204 to 190e784 Compare July 2, 2026 22:15
Aydin-ab added 2 commits July 2, 2026 15:54
…s disabled)

Remove the "## CI gate" section and the "the CI gate" attribution on --check; the
gate is disabled, so it's no longer referenced. Reframe the live-index gotcha as a
property of update_deps.sh itself (a fresh run can show ambient drift / a transient
503), not of the gate.

Claude-Session: https://claude.ai/code/session_01HEiVRurDkXnrLAyCduiLdH
Signed-off-by: Aydin Abiar <aydin@anyscale.com>
Stop referring to check-depsets as an active gate across the agent docs: drop the
"check-depsets gate" attributions on ./update_deps.sh --check in create-template.md,
update-template.md, and upgrade-dependencies.md (kept as local validation), and
remove "gated by check-depsets in CI" from AGENTS.md. The only remaining reference
is the disabled job itself in premerge.yaml.

Claude-Session: https://claude.ai/code/session_01HEiVRurDkXnrLAyCduiLdH
Signed-off-by: Aydin Abiar <aydin@anyscale.com>
@Aydin-ab Aydin-ab merged commit d7ba808 into main Jul 2, 2026
4 checks passed
@Aydin-ab Aydin-ab deleted the fix-ray-bump-depsets branch July 2, 2026 23:02
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants