Skip to content
OpenPlanr Docs
GitHub (opens in a new tab)

Changelog

Versions and cadence

  • CLI numbering. openplanr releases are <major>.<YYWW>.<n>. YYWW is the ISO week-year and week the version PR was prepared in, and n counts earlier releases in that week. For example, 2026 week 39 gives 2.2639.0, and a second release that week gives 2.2639.1. Changesets still decides whether the CLI releases and whether it is a new major; cli-version.mjs then takes the week number from the UTC date and the patch count from npm, and fails rather than produce a version below one already published. The numbering cannot be reverted: after 2.2639.0, returning to small minor numbers needs a new major.
  • Library numbering. planr-pipeline and @openplanr/protocol keep ordinary SemVer.
  • Cadence. Merge the version PR once a week. An urgent fix can still be released on another day; it becomes the next patch of that week's number.
  • Bump types. Write patch changesets by default, minor only for a milestone the maintainers call out, and major for a breaking change.

Releases