---
title: Changelog
description: CLI numbering. openplanr releases are <major>.<YYWW>.<n>.
url: https://openplanr.dev/docs/changelog
updated: 2026-10-06
related: []
---

# Changelog

- **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.