Release the Ralphy CLI
This skill ships the agent-facing CLI in this repository. It never releases the
marketing site, public docs site, desktop app, or unattended farm runtime.
Repositories
- CLI: current repository,
alecs5am/ralphy.
- Public docs: sibling
../ralphy-docs, alecs5am/ralphy-docs.
- Marketing and library: sibling
../ralphy-web, alecs5am/ralphy-web.
- Desktop: sibling
../ralphy-desktop, alecs5am/ralphy-desktop.
- Unattended automation: sibling
../ralphy-farm, alecs5am/ralphy-farm.
Only the CLI repository receives the vX.Y.Z release tag. If a CLI change
affects public documentation, update and push ralphy-docs before tagging the
CLI. Web, desktop, and farm changes follow their own release processes.
Release contract
One version must reach all three CLI channels:
- GitHub Release with platform binaries and
SHA256SUMS.
alecs5am/homebrew-tap formula.
@alecs5am/ralphy on npm.
Never amend or replace an existing release. Never publish only one channel.
Procedure
Confirm the current branch is main, the worktree is clean, and gh auth status plus npm whoami identify the expected maintainer.
Read scripts/release/last-release-commit, the latest v* tag, and commits
since that baseline. Propose the semver bump and grouped release notes.
Inspect the diff for public-doc impact. If needed, update ../ralphy-docs,
validate docs.json, commit, and push that repository separately.
Run the CLI verification suite:
bun run lint
bun test --timeout 45000 ./tests/unit/ ./tests/integration/
bun run build:bin:current
gitleaks detect --source .
After explicit user approval, update these version sources in lockstep:
package.json
cli/lib/version.ts
npm/package.json
- the current-version line in
AGENTS.md
Commit chore(release): vX.Y.Z, tag that commit vX.Y.Z, and push the
commit and tag. Do not create the GitHub Release manually; the release
workflow owns binaries, checksums, and the release object.
Watch the GitHub Actions release workflow to success.
Run scripts/release/update-brew-tap.sh X.Y.Z and
scripts/release/publish-npm.sh X.Y.Z, then verify both registries resolve
the new version.
Update scripts/release/last-release-commit in a separate trailing commit
so the next release has an exact baseline.
Stop conditions
Stop before tagging when tests fail, versions disagree, credentials are wrong,
there are no releasable commits, or the user has not approved the proposed
version. Documentation-only changes in ralphy-docs do not require a CLI tag.
1---2name: dev-release3namespace: maintainer4description: >-5 Cut a Ralphy CLI release across GitHub Releases, Homebrew, and npm. Use when6 the user asks to release, tag, publish, or prepare release notes for the CLI.7 Public documentation and the marketing site live in sibling repositories and8 are synchronized separately when their content is affected.9metadata:10 source: https://skillmd.com/skills/alecs5am/dev-release11---1213# Release the Ralphy CLI1415This skill ships the agent-facing CLI in this repository. It never releases the16marketing site, public docs site, desktop app, or unattended farm runtime.1718## Repositories1920- CLI: current repository, `alecs5am/ralphy`.21- Public docs: sibling `../ralphy-docs`, `alecs5am/ralphy-docs`.22- Marketing and library: sibling `../ralphy-web`, `alecs5am/ralphy-web`.23- Desktop: sibling `../ralphy-desktop`, `alecs5am/ralphy-desktop`.24- Unattended automation: sibling `../ralphy-farm`, `alecs5am/ralphy-farm`.2526Only the CLI repository receives the `vX.Y.Z` release tag. If a CLI change27affects public documentation, update and push `ralphy-docs` before tagging the28CLI. Web, desktop, and farm changes follow their own release processes.2930## Release contract3132One version must reach all three CLI channels:33341. GitHub Release with platform binaries and `SHA256SUMS`.352. `alecs5am/homebrew-tap` formula.363. `@alecs5am/ralphy` on npm.3738Never amend or replace an existing release. Never publish only one channel.3940## Procedure41421. Confirm the current branch is `main`, the worktree is clean, and `gh auth43 status` plus `npm whoami` identify the expected maintainer.442. Read `scripts/release/last-release-commit`, the latest `v*` tag, and commits45 since that baseline. Propose the semver bump and grouped release notes.463. Inspect the diff for public-doc impact. If needed, update `../ralphy-docs`,47 validate `docs.json`, commit, and push that repository separately.484. Run the CLI verification suite:4950 ```bash51 bun run lint52 bun test --timeout 45000 ./tests/unit/ ./tests/integration/53 bun run build:bin:current54 gitleaks detect --source .55 ```56575. After explicit user approval, update these version sources in lockstep:5859 - `package.json`60 - `cli/lib/version.ts`61 - `npm/package.json`62 - the current-version line in `AGENTS.md`63646. Commit `chore(release): vX.Y.Z`, tag that commit `vX.Y.Z`, and push the65 commit and tag. Do not create the GitHub Release manually; the release66 workflow owns binaries, checksums, and the release object.677. Watch the GitHub Actions release workflow to success.688. Run `scripts/release/update-brew-tap.sh X.Y.Z` and69 `scripts/release/publish-npm.sh X.Y.Z`, then verify both registries resolve70 the new version.719. Update `scripts/release/last-release-commit` in a separate trailing commit72 so the next release has an exact baseline.7374## Stop conditions7576Stop before tagging when tests fail, versions disagree, credentials are wrong,77there are no releasable commits, or the user has not approved the proposed78version. Documentation-only changes in `ralphy-docs` do not require a CLI tag.