用途:为 arra-oracle-skills-cli 计算或递增 CalVer 版本号。默认模式为 --check(只读),仅显示下一个目标版本,不修改文件;--apply 会把新版本写入 package.json 后停止,不执行 commit、push 或 PR,以避免递增意外触发发布。
版本方案:v{yy}.{m}.{d}[-(alpha|beta).{HMM}];HMM 为挂钟时间,按 H*100+M 十进制计算且无前导零(如 09:37 → 937,23:59 → 2359),每分钟一个唯一槽位。alpha 与 beta 为相互独立的通道。版本来源同时遍历 git tag 与 package.json.version。时区固定为 Asia/Bangkok。日期 D 可超过 31,作为日期耗尽后的稳定计数器,例如 v26.4.50 表示该周期第 50 次稳定切版。
使用方式:先用 ghq 定位仓库(ghq list -p --exact Soul-Brews-Studio/arra-oracle-skills-cli)。检查:TZ=Asia/Bangkok bun "$ARRA/scripts/calver.ts" --check;应用:TZ=Asia/Bangkok bun "$ARRA/scripts/calver.ts"(写 package.json);--stable 切稳定版;--beta 切 beta;--stable 与 --beta 互斥(退出码 2);--hour N 已弃用并将退出 2;--help 打印帮助。
限制:脚本为权威实现,不要手算版本;--apply 后不自动提交,需用户自行处理。若进行纯代码修改而不发布,应避免在 package.json 中递增版本。发布请使用 /release-alpha 或 /release-stable。