Release Process¶

main ─────●────────●────────●──────── (production releases)
          │        ↑        ↑
          │        │        │
develop ──●────●───●────●───●──────── (integration branch)
               │        │
               │        └── feature/new-pattern
               └── feature/llm-output

# Start a feature
git checkout develop
git checkout -b feature/my-feature

# Work on feature...
git commit -m "feat: add feature"

# Merge back to develop (via PR)
git checkout develop
git merge feature/my-feature

# Prepare release from develop
git checkout main
git merge develop
git tag -a v0.2.0 -m "Release v0.2.0"
git push origin main v0.2.0

# Sync develop with main
git checkout develop
git merge main

# 1. Ensure you're on main with latest changes
git checkout main
git pull origin main

# 2. Verify tests pass
uv run pytest tests/ -v
uv run mypy src/
uv run ruff check src/

# 3. Create annotated tag
git tag -a v0.2.0 -m "Release v0.2.0: Brief description"

# 4. Push tag (triggers automation)
git push origin v0.2.0

git tag -a v0.2.0-rc1 -m "Release candidate 1"
git push origin v0.2.0-rc1

git checkout main
git commit -m "fix: critical issue"
git tag -a v0.1.1 -m "Hotfix: Fix description"
git push origin main v0.1.1

feat: add new redaction pattern
fix: handle empty traceback
docs: update CLI reference
test: add property tests