calver

Installation
SKILL.md

/calver

Compute / bump the CalVer version for arra-oracle-skills-cli.

⚠️ Pair with the right skill. This skill is --check (read-only) or --apply (writes package.json and stops). It does NOT commit, push, or PR — that's deliberate so a bump can never accidentally cut a release.

Want to… Use
See the next target version /calver (default = --check)
Just bump package.json and stop /calver --apply
Cut a soak release (alpha pre-release) /release-alpha
Cut a stable release on main /release-stable
Land a code fix without releasing regular branch + PR — keep package.json version untouched

Never combine a package.json bump with a code fix in the same commit on this repo — calver-release.yml auto-tags on push to main, so a fix-PR with a bump = automatic stable release.

CalVer scheme: v{yy}.{m}.{d}[-(alpha|beta).{HMM}] — HMM is the wall-clock as decimal H*100 + M with no leading zero (e.g. 09:37 → 937, 23:59 → 2359). Each minute is a unique slot — no merge-order collisions. Alpha and beta are independent channels (#754 / PR #783). Walks git tags AND package.json.version for source-of-truth (#784 / PR #786). TZ fixed to Asia/Bangkok. HMM replaced monotonic counter (#766/#775) in #923.

Day-of-month D may exceed 31 — used as a stable counter once natural date is exhausted (#930). E.g. v26.4.50 is the 50th stable cut in the period, not "April 50".

Installs
5
GitHub Stars
122
First Seen
Jun 2, 2026
calver — soul-brews-studio/arra-oracle-skills-cli