release-bump
Release Bump
Overview
Bump version and trigger release for ralph-orchestrator. All versions live in workspace Cargo.toml - individual crates inherit via version.workspace = true.
Confirm the new version with the user. Once the bump commit is pushed, track progress of the release.
Quick Reference
| Step | Command/Action |
|---|---|
| 1. Bump version | Edit Cargo.toml: replace all version = "X.Y.Z" (7 occurrences) |
| 2. Build | cargo build (updates Cargo.lock) |
| 3. Test | cargo test |
| 4. Commit | git add Cargo.toml Cargo.lock && git commit -m "chore: bump to vX.Y.Z" |
| 5. Push | git push origin main |
| 6. Tag | git tag vX.Y.Z && git push origin vX.Y.Z |
Version Locations (All in Cargo.toml)
# Line ~17 - workspace version
[workspace.package]
version = "X.Y.Z"
# Lines ~113-118 - internal crate dependencies
ralph-proto = { version = "X.Y.Z", path = "crates/ralph-proto" }
ralph-core = { version = "X.Y.Z", path = "crates/ralph-core" }
ralph-adapters = { version = "X.Y.Z", path = "crates/ralph-adapters" }
ralph-tui = { version = "X.Y.Z", path = "crates/ralph-tui" }
ralph-cli = { version = "X.Y.Z", path = "crates/ralph-cli" }
ralph-bench = { version = "X.Y.Z", path = "crates/ralph-bench" }
Tip: Use Edit tool with replace_all: true on version = "OLD" → version = "NEW" to update all 7 at once.
What CI Does Automatically
Once you push the tag, .github/workflows/release.yml triggers and:
- Creates the GitHub Release with auto-generated notes
- Builds binaries for macOS (arm64, x64) and Linux (arm64, x64)
- Uploads artifacts to the GitHub Release
- Publishes to crates.io (in dependency order)
- Publishes to npm as
@ralph-orchestrator/ralph
Common Mistakes
| Mistake | Fix |
|---|---|
| Only updating workspace.package.version | Must update all 7 occurrences including internal deps |
| Forgetting to run tests | Always cargo test before commit |
Creating release manually with gh release create |
Just push the tag - CI creates the release with artifacts |
| Pushing tag before main | Push main first, then push the tag |
More from mikeyobrien/ralph-orchestrator
ralph-loop
Run, monitor, resume, merge, and debug Ralph loops. Use this skill whenever the user asks to operate `ralph run` or `ralph loops`, inspect loop state, recover suspended loops, analyze diagnostics, or unblock merge queue issues.
80pdd
Transforms a rough idea into a detailed design document with implementation plan. Follows Prompt-Driven Development — iterative requirements clarification, research, design, and planning.
52tui-validate
Validates Terminal User Interface (TUI) output using freeze for screenshot capture and LLM-as-judge for semantic validation. Supports both visual (PNG/SVG) and text-based validation modes.
44code-assist
Guides implementation of code tasks using test-driven development in an Explore, Plan, Code, Commit workflow. Acts as a Technical Implementation Partner and TDD Coach — following existing patterns, avoiding over-engineering, and producing idiomatic, modern code.
41ralph-hats
Create, inspect, validate, explain, and improve Ralph hat collections. Use this skill whenever the user asks to make or refine a `.ralph/hats/*.yml` workflow, debug hat routing, explain event topology, or tune a multi-hat Ralph run.
41code-task-generator
Generates structured .code-task.md files from descriptions or PDD implementation plans. Auto-detects input type, creates properly formatted tasks with Given-When-Then acceptance criteria.
37