release-prep

Release Preparation Checklist

Usage: /release-prep <version>

Example: /release-prep 2.8.0

Purpose: Automated release readiness validation

---

🚀 Release Preparation Workflow

Step 1: Validate Version Number

Parse and validate version from $ARGUMENTS:

VERSION=$ARGUMENTS

# Validate semantic versioning format
if [[ ! $VERSION =~ ^[0-9]+\.[0-9]+\.[0-9]+$ ]]; then
    echo "❌ Invalid version format. Use X.Y.Z (e.g., 2.8.0)"
    exit 1
fi

echo "✅ Preparing release v$VERSION"

Step 2: Pre-Release Checklist

Run comprehensive validation:

Code Quality:

# 1. All tests passing
make test-unit
make test-integration
make test-all-quality

# 2. Linting clean
make lint-check

# 3. Security scan
make security-check

# 4. Type checking
mypy src/ --strict

Status: Pass/Fail for each

Documentation:

# 1. CHANGELOG.md updated
grep -q "## \[$VERSION\]" CHANGELOG.md

# 2. Version in pyproject.toml
grep -q "version = \"$VERSION\"" pyproject.toml

# 3. Breaking changes documented
[ -f BREAKING_CHANGES.md ] && grep -q "## $VERSION" BREAKING_CHANGES.md

Deployment Configs:

# 1. Validate all deployment configs
make validate-all

# 2. Check Docker image builds
docker build -t test:$VERSION .

# 3. Verify Helm chart version
grep -q "version: $VERSION" deployments/helm/langgraph-agent/Chart.yaml

Step 3: Generate Release Notes

Create release notes from CHANGELOG.md and git commits:

# Extract changelog section for this version
sed -n "/## \[$VERSION\]/,/## \[/p" CHANGELOG.md > /tmp/release_notes.md

# Add git commit summary since last tag
LAST_TAG=$(git describe --tags --abbrev=0 2>/dev/null || echo "HEAD~10")
git log $LAST_TAG..HEAD --oneline --no-merges >> /tmp/release_notes_commits.txt

Format:

# Release v$VERSION

**Release Date**: YYYY-MM-DD
**Type**: Major | Minor | Patch

## 🎯 Highlights

- [Key feature 1]
- [Key feature 2]
- [Key improvement]

## ✨ New Features

- [List from CHANGELOG]

## 🐛 Bug Fixes

- [List from CHANGELOG]

## 📚 Documentation

- [Updates]

## ⚠️ Breaking Changes

- [If any]

## 📦 Deployment Notes

- [Any special deployment steps]

## 🔗 Links

- Full Changelog: [link]
- Documentation: [link]