beads/scripts/update-versions.sh
matt wilkie f8b847f781
fix(release): regenerate and gate the MCP uv.lock on version bumps (#5082)
The release workflow's MCP package gate runs 'uv sync --locked', but
update-versions.sh bumped integrations/beads-mcp/pyproject.toml without
regenerating uv.lock, and no pre-tag gate checked the lock. The stale
lock therefore only surfaced in the tag-triggered release run — after
the tag existed and could no longer be rewritten. This cost v1.1.0 and
v1.1.2 their first release runs and burned the v1.1.1 tag outright.

Two-part fix:
- update-versions.sh runs 'uv lock' as part of the bump when uv is
  available, warning loudly (without aborting the bump half-applied)
  when uv is missing or the lock fails.
- check-versions.sh gains a dependency-free check that the beads-mcp
  version pinned in uv.lock matches the canonical version (PEP 440
  normalization applied for -rc.N prereleases), plus a fuller
  'uv lock --check' freshness pass when uv is available. Both the
  release-tag pre-push hook and CI's verify-version-consistency job
  run this script, so a stale lock is now refused before a tag exists.

Agent-Signature: claude-fable-5-xhigh on behalf of matt wilkie

Claude-Session: https://claude.ai/code/session_01HmGSvX14yJcKD8Ezw7qZwd

Co-authored-by: Claude Fable 5 <noreply@anthropic.com>
2026-07-26 12:53:58 -07:00

162 lines
6.4 KiB
Bash
Executable file

#!/bin/bash
set -e
# =============================================================================
# Quick version bump utility (no git operations)
# =============================================================================
#
# Updates version numbers across all beads components without any git
# operations. Use this for local testing or when you want manual control
# over commits.
#
# For full releases with CI gates and verification, use:
# bd mol wisp beads-release --var version=X.Y.Z
#
# =============================================================================
RED='\033[0;31m'
GREEN='\033[0;32m'
YELLOW='\033[1;33m'
NC='\033[0m'
usage() {
echo "Usage: $0 <version>"
echo ""
echo "Updates version numbers across all components (no git operations)."
echo ""
echo "Examples:"
echo " $0 0.47.1"
echo " $0 1.1.0-rc.1"
echo ""
echo "For full releases, use: bd mol wisp beads-release --var version=X.Y.Z"
}
NEW_VERSION=""
for arg in "$@"; do
case "$arg" in
-h|--help) usage; exit 0 ;;
-*) echo "Unknown option: $arg" >&2; usage; exit 1 ;;
*)
if [ -n "$NEW_VERSION" ]; then
echo "Error: multiple versions given" >&2; usage; exit 1
fi
NEW_VERSION="$arg"
;;
esac
done
if [ -z "$NEW_VERSION" ]; then
usage
exit 1
fi
# Validate semantic versioning. Accept prerelease identifiers so release
# candidates can be cut without pretending to be stable package releases.
if ! [[ $NEW_VERSION =~ ^[0-9]+\.[0-9]+\.[0-9]+(-[0-9A-Za-z][0-9A-Za-z.-]*)?$ ]]; then
echo -e "${RED}Error: Invalid version format '$NEW_VERSION'${NC}"
echo "Expected: MAJOR.MINOR.PATCH or MAJOR.MINOR.PATCH-prerelease (e.g., 0.47.1 or 1.1.0-rc.1)"
exit 1
fi
BASE_VERSION="${NEW_VERSION%%-*}"
# Check we're in repo root
if [ ! -f "cmd/bd/version.go" ]; then
echo -e "${RED}Error: Must run from repository root${NC}"
exit 1
fi
# Get current version
CURRENT_VERSION=$(grep 'Version = ' cmd/bd/version.go | sed 's/.*"\(.*\)".*/\1/')
# Base (prerelease-stripped) form of the current version. The Windows PE
# numeric fields (file_version/product_version, manifest version) only ever
# hold the base form, so they must be matched on the base, not on the full
# CURRENT_VERSION which may carry a -rc.N suffix.
CURRENT_BASE="${CURRENT_VERSION%%-*}"
echo -e "${YELLOW}Bumping: $CURRENT_VERSION → $NEW_VERSION${NC}"
echo ""
# Cross-platform sed helper
update_file() {
local file=$1
local old=$2
local new=$3
if [[ "$OSTYPE" == "darwin"* ]]; then
sed -i '' "s|$old|$new|g" "$file"
else
sed -i "s|$old|$new|g" "$file"
fi
}
echo "Updating version files..."
# 1. cmd/bd/version.go
echo " • cmd/bd/version.go"
update_file "cmd/bd/version.go" "Version = \"$CURRENT_VERSION\"" "Version = \"$NEW_VERSION\""
# 2. Plugin JSON files
echo " • plugin metadata"
update_file "plugins/beads/.claude-plugin/plugin.json" "\"version\": \"$CURRENT_VERSION\"" "\"version\": \"$NEW_VERSION\""
update_file "plugins/beads/.codex-plugin/plugin.json" "\"version\": \"$CURRENT_VERSION\"" "\"version\": \"$NEW_VERSION\""
update_file "plugins/beads/.copilot-plugin/plugin.json" "\"version\": \"$CURRENT_VERSION\"" "\"version\": \"$NEW_VERSION\""
update_file ".claude-plugin/marketplace.json" "\"version\": \"$CURRENT_VERSION\"" "\"version\": \"$NEW_VERSION\""
# 3. MCP Python package
echo " • integrations/beads-mcp/*"
update_file "integrations/beads-mcp/pyproject.toml" "version = \"$CURRENT_VERSION\"" "version = \"$NEW_VERSION\""
update_file "integrations/beads-mcp/src/beads_mcp/__init__.py" "__version__ = \"$CURRENT_VERSION\"" "__version__ = \"$NEW_VERSION\""
# The release workflow's MCP package gate runs `uv sync --locked`, so a
# pyproject bump without a lock refresh fails the release only in the
# tag-triggered run — after the tag exists and can no longer be rewritten.
# That cost v1.1.0 and v1.1.2 their first release runs and burned the v1.1.1
# tag outright. Regenerate the lock as part of the bump. A failure here must
# not abort the bump half-applied (set -e): warn and let check-versions.sh
# hold the gate.
if command -v uv >/dev/null 2>&1; then
echo " • integrations/beads-mcp/uv.lock"
if ! uv lock --directory integrations/beads-mcp; then
echo -e "${RED}✗ uv lock failed — integrations/beads-mcp/uv.lock NOT refreshed.${NC}"
echo " Fix and rerun before tagging, or check-versions.sh and the release MCP gate will fail:"
echo " uv lock --directory integrations/beads-mcp"
fi
else
echo -e "${RED}✗ uv not found — integrations/beads-mcp/uv.lock NOT refreshed.${NC}"
echo " Run this before tagging, or check-versions.sh and the release MCP gate will fail:"
echo " uv lock --directory integrations/beads-mcp"
fi
# 4. npm package
echo " • npm-package/package.json"
update_file "npm-package/package.json" "\"version\": \"$CURRENT_VERSION\"" "\"version\": \"$NEW_VERSION\""
# 5. README badge
echo " • README.md"
update_file "README.md" "Alpha (v$CURRENT_VERSION)" "Alpha (v$NEW_VERSION)"
# 6. default.nix
echo " • default.nix"
update_file "default.nix" "version = \"$CURRENT_VERSION\";" "version = \"$NEW_VERSION\";"
# 7. Hook templates — now generated dynamically by cmd/bd/hooks.go using the
# Version constant from version.go. No template files to update.
# (Previously updated cmd/bd/templates/hooks/* which no longer exist.)
# 8. Windows PE resource metadata
echo " • cmd/bd/winres/winres.json"
update_file "cmd/bd/winres/winres.json" "\"file_version\": \"$CURRENT_BASE\"" "\"file_version\": \"$BASE_VERSION\""
update_file "cmd/bd/winres/winres.json" "\"product_version\": \"$CURRENT_BASE\"" "\"product_version\": \"$BASE_VERSION\""
update_file "cmd/bd/winres/winres.json" "\"FileVersion\": \"$CURRENT_VERSION\"" "\"FileVersion\": \"$NEW_VERSION\""
update_file "cmd/bd/winres/winres.json" "\"ProductVersion\": \"$CURRENT_VERSION\"" "\"ProductVersion\": \"$NEW_VERSION\""
echo " • cmd/bd/winres/manifest.xml"
update_file "cmd/bd/winres/manifest.xml" "version=\"$CURRENT_BASE.0\"" "version=\"$BASE_VERSION.0\""
echo ""
echo -e "${GREEN}✓ Version constants updated to $NEW_VERSION${NC}"
echo ""
echo "Changed files:"
git diff --stat 2>/dev/null || true
echo ""
echo "Next steps:"
echo " • Update CHANGELOG.md with release notes"
echo " • Update cmd/bd/info.go versionChanges"
echo " • Or use: bd mol wisp beads-release --var version=$NEW_VERSION"