// Bump the Ret2Shell version number across all relevant files — Cargo workspace, frontend, Helm chart, and K8s deployment references. Use when the user asks to bump, release, or change the version number.
| name | version-bump |
| description | Bump the Ret2Shell version number across all relevant files — Cargo workspace, frontend, Helm chart, and K8s deployment references. Use when the user asks to bump, release, or change the version number. |
This skill describes the complete version bumping procedure for the Ret2Shell monorepo. The version must be kept in sync across all of the following locations.
Whenever the version is bumped, edit these files (listed in the order they should be changed):
| # | File | Field(s) |
|---|---|---|
| 1 | Cargo.toml | workspace.package.version (line ~12) — all 17 sub-crates inherit from this via version = { workspace = true } |
| 2 | web/package.json | "version" field |
| 3 | web/.env | VITE_COMPAT_VERSION |
| 4 | deploy/helm/ret2shell/Chart.yaml | version (line 5) and appVersion (line 6) |
| 5 | deploy/helm/ret2shell/values.yaml | platform.image.tag (line ~15) |
| 6 | deploy/k8s/values.private.example.yaml | platform.image.tag (line 3) |
| 7 | deploy/k8s/README.md | R2S_VERSION shell variable (two occurrences — install and update examples) |
After editing all seven files, run cargo check (or cargo build) to regenerate Cargo.lock with the new workspace version. The lock file will update automatically — no manual editing needed.
These files read the version dynamically at build/release time and will pick up the new version automatically:
release-image.sh — reads Cargo.toml at build time via grep.github/workflows/release.yml — validates that Cargo.toml, Chart.yaml (version + appVersion), and values.yaml (image tag) all match the Git tagweb/src/lib/storage/platform.ts — reads VITE_COMPAT_VERSION from environment at build timedocs/software-copyright-application.md — historical document referencing a specific past version (keep as-is)crates/config/src/cluster.rs — #[deprecated(since = "...")] annotations mark when a field was deprecated (keep the original version)