release

Current state

# Each line ends with `|| true` so a missing optional file (Cargo.toml,
# pyproject.toml, etc.) doesn't fail the whole block — ls's exit code 2
# propagates through `&&` even when stderr is silenced.
echo "=== branch ===" && git rev-parse --abbrev-ref HEAD 2>/dev/null || true
echo "=== clean? ===" && git status --short
echo "=== upstream sync ===" && git status -sb | head -1
echo "=== last tags ===" && git tag --sort=-version:refname | head -5
echo "=== remote ===" && git remote get-url origin 2>/dev/null || true
echo "=== release workflows ===" && ls .github/workflows/ 2>/dev/null || true
echo "=== node version files ===" && ls package.json src/version.ts version.ts lib/version.ts 2>/dev/null || true
echo "=== rust version files ===" && ls Cargo.toml 2>/dev/null || true
echo "=== python version files ===" && ls pyproject.toml 2>/dev/null || true

What you're doing

The user wants to cut a release. Argument $1 is one of:

• patch / minor / major — semver bump from the current version
• explicit version like 1.2.3 or v1.2.3
• empty — ask the user which they want

Workflow

1. Preflight — stop or ask the user if any of these are off:

   • Working tree dirty (offer to commit/stash first, or abort)
   • On a non-default branch (warn and confirm; some projects do release branches)
   • Local branch behind origin (pull or warn)
   • Tag for the target version already exists (always abort — don't retag)
   • npm name collision (Node projects only): if a package.json exists and isn't marked "private": true, query the npm registry — curl -fsS -o /dev/null -w '%{http_code}' https://registry.npmjs.org/<name>/<NEW>. A 200 means that version is already published and any CI npm publish will fail later. Abort early; ask the user to bump further. A 404 means it's free to publish.

2. Discover version-bearing files. Be thorough; many projects have more than one:

   • package.json (top-level version)
   • src/version.ts / src/version.js / version.ts / version.js / lib/version.* (look for a VERSION = "..." literal)
   • Cargo.toml ([package].version)
   • pyproject.toml ([project].version or [tool.poetry].version)
   • __init__.py files with __version__ = "..."