Release & Versioning

Versioning

• Keep semantic versioning (MAJOR.MINOR.PATCH).
• Release notes must include:
• Evidence source
• Link to delta spec
• PHPStan + tests + click-test report used
• openspec archive status
• After release watch for regressions: rerun relevant click-tests and quick smoke tests.

---

CHANGELOG Format

## [1.5.0] - 2025-02-28
### Added
- PDF export (FEAT-042) — source: meeting 2025-02-10#32:10; click-test: latest-pdf-export
### Changed
- Invoice approval over 50k (CHG-023)
### Fixed
- Duplicate notifications (BUG-015)

---

Release Checklist

• [ ] openspec archive run for completed changes
• [ ] Release notes contain evidence and test links
• [ ] Click-tests and smoke tests executed after release
• [ ] CHANGELOG updated
• [ ] New change requests go back through intake (meeting/e-mail)

---

➡️ For the detailed change process see Change Proposals.