Skip to content

Release Notes - Version 0.1.2

Released: 2026-02-14

🎉 What's New

  • Release branches workflow with CI/CD automated tagging (industry best practice)
  • Automated merge of release branches to main after documentation generation
  • Automated immutable tag creation on main branch (no manual tagging)
  • Automated release branch cleanup after successful releases
  • Comprehensive release process documentation (00.release-process.md) with 11-step CI/CD pipeline guide
  • Deployment documentation directory (05.deployment/) with overview README
  • Post-release cleanup guide with git pull --prune workflow
  • Three undo scenarios for different release stages
  • Complete troubleshooting section for release issues
  • Workflow diagram showing 18-step release pipeline

✨ Improvements

  • BREAKING: Release workflow trigger changed from tags to release/** branches
  • Release preparation script now creates release branches instead of tags
  • CI/CD workflow extracts version from branch name (release/vX.Y.Z)
  • Release tags are now created automatically by CI/CD after all artifacts are generated
  • Tag creation moved from developer's local machine to CI/CD pipeline
  • Release workflow now merges to main before creating tags (immutable tags on complete state)
  • Release process documentation reorganized from root to 05.deployment/ directory
  • Release process guide updated to v2.0 with release branches workflow documentation
  • Development README updated with deployment section quick link
  • Documentation structure now includes numbered prefix (00.release-process.md)
  • Documentation navigation: Simplified release notes menu to single overview page (automatically updated by CI/CD)
  • Implement release branches workflow with automated tagging (#56)

🗑️ Removed

  • Manual tag creation from release preparation workflow
  • Tag-based release triggering (replaced with branch-based triggering)

🔧 Bug Fixes

  • Release workflow YAML syntax error in multi-line git tag message (use multiple -m flags)
  • Critical bug in 20.prepare-release.ps1: Version replacement now correctly uses MultiLine regex flag (was silently failing to update pyproject.toml)
  • Documentation workflow (docs.yml) version extraction from release branch names (was failing to parse release/vX.Y.Z format)
  • Documentation workflow (docs.yml) checkout failure due to uncommitted uv.lock changes (now uses force checkout -f flag)

Full Changelog: View on GitHub