ADR: Adopt CalVer (YY.MINOR.PATCH) versioning format#1
Conversation
Propose adopting CalVer with YY.MINOR.PATCH across all sbomify projects, replacing SemVer. The ADR steelmans six versioning schemes and recommends YY.MINOR.PATCH for its freshness signal, release cadence flexibility, and seamless migration from SemVer. Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
There was a problem hiding this comment.
Pull request overview
Adds a new Architecture Decision Record (ADR) proposing a shift from SemVer to CalVer (YY.MINOR.PATCH) across sbomify projects, and documents repository guidance for managing ADRs with adr-tools.
Changes:
- Add
CLAUDE.mdwith guidance for working in this ADR repository and using adr-tools. - Add ADR
0002proposing adoption of CalVer (YY.MINOR.PATCH) and explaining rationale/trade-offs.
Reviewed changes
Copilot reviewed 2 out of 2 changed files in this pull request and generated 3 comments.
| File | Description |
|---|---|
CLAUDE.md |
Documents ADR repo purpose, format, and adr-tools workflow conventions. |
0002-adopt-calver-versioning.md |
New ADR proposing CalVer (YY.MINOR.PATCH) and outlining impacts and consequences. |
💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.
- Nuance migration claims: distinguish syntax compatibility from constraint semantics, note that ^/caret ranges cap at next major (next calendar year) - Clarify pre-release suffixes are ecosystem-specific (SemVer-style vs PEP 440) - Reword "seamless migration" to scope it to internal tooling and flag that downstream consumers will need to revisit version constraints Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
Add markdownlint configuration, pre-commit hook, and CI workflow to enforce consistent markdown style across all ADR files. Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
There was a problem hiding this comment.
Pull request overview
Copilot reviewed 5 out of 5 changed files in this pull request and generated 2 comments.
💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.
Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
There was a problem hiding this comment.
Pull request overview
Copilot reviewed 5 out of 5 changed files in this pull request and generated 2 comments.
💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.
| - repo: local | ||
| hooks: | ||
| - id: markdownlint | ||
| name: markdownlint | ||
| entry: bun x markdownlint-cli --fix | ||
| language: system |
There was a problem hiding this comment.
This pre-commit hook relies on bun being installed on the developer machine (language: system + bun x ...). Without bun, pre-commit run will fail. If bun is not a guaranteed prerequisite for contributors, consider switching to a non-system hook (e.g., a Node-based markdownlint hook with managed dependencies) or documenting bun as a required tool for this repo.
| - repo: local | |
| hooks: | |
| - id: markdownlint | |
| name: markdownlint | |
| entry: bun x markdownlint-cli --fix | |
| language: system | |
| - repo: https://github.com/igorshubovych/markdownlint-cli | |
| rev: v0.41.0 | |
| hooks: | |
| - id: markdownlint | |
| args: [--fix] |
Summary
YY.MINOR.PATCH) across all sbomify projectsTest plan
🤖 Generated with Claude Code