09803a75b7
- Add tsc build step (tsconfig.build.json) so npm package ships compiled JS instead of raw TypeScript requiring tsx at runtime - Update qmd wrapper and daemon spawn to use dist/qmd.js in production while keeping tsx for development - Add self-installing pre-push hook validating v* tag pushes: package.json version match, changelog entry, CI status - Add release.sh script that renames [Unreleased] to versioned entry, bumps package.json, commits, and tags - Add extract-changelog.sh for cumulative GitHub release notes - Update publish workflow with build step and GitHub release creation - Flesh out CHANGELOG.md with full history from 0.1.0 through 1.0.0 in Keep-a-Changelog format with PR/contributor attributions - Add release standards and changelog guidelines to CLAUDE.md
113 lines
2.9 KiB
Bash
Executable File
113 lines
2.9 KiB
Bash
Executable File
#!/usr/bin/env bash
|
|
set -euo pipefail
|
|
|
|
# QMD Release Script
|
|
#
|
|
# Renames the [Unreleased] section in CHANGELOG.md to the new version,
|
|
# bumps package.json, commits, and creates a tag. The actual publish
|
|
# happens via GitHub Actions when the tag is pushed.
|
|
#
|
|
# Usage: ./scripts/release.sh [patch|minor|major|<version>]
|
|
# Examples:
|
|
# ./scripts/release.sh patch # 0.9.0 -> 0.9.1
|
|
# ./scripts/release.sh minor # 0.9.0 -> 0.10.0
|
|
# ./scripts/release.sh major # 0.9.0 -> 1.0.0
|
|
# ./scripts/release.sh 1.0.0 # explicit version
|
|
|
|
BUMP="${1:?Usage: release.sh [patch|minor|major|<version>]}"
|
|
|
|
# Ensure we're on main and clean
|
|
BRANCH=$(git branch --show-current)
|
|
if [[ "$BRANCH" != "main" ]]; then
|
|
echo "Error: must be on main branch (currently on $BRANCH)" >&2
|
|
exit 1
|
|
fi
|
|
|
|
if [[ -n "$(git status --porcelain)" ]]; then
|
|
echo "Error: working directory not clean" >&2
|
|
git status --short
|
|
exit 1
|
|
fi
|
|
|
|
# Read current version
|
|
CURRENT=$(jq -r .version package.json)
|
|
echo "Current version: $CURRENT"
|
|
|
|
# Calculate new version
|
|
bump_version() {
|
|
local current="$1" type="$2"
|
|
IFS='.' read -r major minor patch <<< "$current"
|
|
case "$type" in
|
|
major) echo "$((major + 1)).0.0" ;;
|
|
minor) echo "$major.$((minor + 1)).0" ;;
|
|
patch) echo "$major.$minor.$((patch + 1))" ;;
|
|
*) echo "$type" ;; # explicit version
|
|
esac
|
|
}
|
|
|
|
NEW=$(bump_version "$CURRENT" "$BUMP")
|
|
DATE=$(date +%Y-%m-%d)
|
|
echo "New version: $NEW"
|
|
echo ""
|
|
|
|
# --- Validate CHANGELOG.md ---
|
|
|
|
if [[ ! -f CHANGELOG.md ]]; then
|
|
echo "Error: CHANGELOG.md not found" >&2
|
|
exit 1
|
|
fi
|
|
|
|
# The [Unreleased] section must have content
|
|
if ! grep -q "^## \[Unreleased\]" CHANGELOG.md; then
|
|
echo "Error: no [Unreleased] section in CHANGELOG.md" >&2
|
|
echo "" >&2
|
|
echo "Add your changes under an [Unreleased] heading first:" >&2
|
|
echo "" >&2
|
|
echo " ## [Unreleased]" >&2
|
|
echo "" >&2
|
|
echo " ### Changes" >&2
|
|
echo " - Your change here" >&2
|
|
exit 1
|
|
fi
|
|
|
|
# --- Preview release notes ---
|
|
|
|
echo "--- Release notes (will appear on GitHub) ---"
|
|
./scripts/extract-changelog.sh "$NEW"
|
|
echo "--- End ---"
|
|
echo ""
|
|
|
|
# --- Confirm ---
|
|
|
|
read -p "Release v$NEW? [y/N] " -n 1 -r
|
|
echo ""
|
|
[[ $REPLY =~ ^[Yy]$ ]] || { echo "Aborted."; exit 1; }
|
|
|
|
# --- Rename [Unreleased] -> [X.Y.Z] - date, add fresh [Unreleased] ---
|
|
|
|
sed -i '' "s/^## \[Unreleased\].*/## [$NEW] - $DATE/" CHANGELOG.md
|
|
|
|
# Insert a new empty [Unreleased] section after the header
|
|
awk '
|
|
/^## \['"$NEW"'\]/ && !done {
|
|
print "## [Unreleased]\n"
|
|
done = 1
|
|
}
|
|
{ print }
|
|
' CHANGELOG.md > CHANGELOG.md.tmp && mv CHANGELOG.md.tmp CHANGELOG.md
|
|
|
|
# --- Bump version and commit ---
|
|
|
|
jq --arg v "$NEW" '.version = $v' package.json > package.json.tmp && mv package.json.tmp package.json
|
|
|
|
git add package.json CHANGELOG.md
|
|
git commit -m "release: v$NEW"
|
|
git tag -a "v$NEW" -m "v$NEW"
|
|
|
|
echo ""
|
|
echo "Created commit and tag v$NEW"
|
|
echo ""
|
|
echo "Next: push to trigger the publish workflow"
|
|
echo ""
|
|
echo " git push origin main --tags"
|