RELEASE_CHECKLIST.md

Release Checklist

Use this checklist before tagging or publishing a new OmniRoute release.

Version and Changelog

1. Bump package.json version (x.y.z) in the release branch.
2. Move release notes from ## [Unreleased] in CHANGELOG.md to a dated section:
   • ## [x.y.z] — YYYY-MM-DD
3. Keep ## [Unreleased] as the first changelog section for upcoming work.
4. Ensure the latest semver section in CHANGELOG.md equals package.json version.

API Docs

1. Update docs/openapi.yaml:
   • info.version must equal package.json version.
2. Validate endpoint examples if API contracts changed.

Runtime Docs

1. Review docs/ARCHITECTURE.md for storage/runtime drift.
2. Review docs/TROUBLESHOOTING.md for env var and operational drift.
3. Update localized docs if source docs changed significantly.

Automated Check

Run the sync guard locally before opening PR:

npm run check:docs-sync

CI also runs this check in .github/workflows/ci.yml (lint job).