用途：为 brooks-lint 项目执行一次完整发布，把版本号从 package.json 传播到各插件清单与所有含版本号的文本文件，并生成对应的 CHANGELOG 条目。
主要能力与用法：目标版本来自 $ARGUMENTS（如 1.4.0），为空时需先向维护者确认 semver 升级幅度。接受版本前先运行 npm run changelog:audit 查看未发布范围，由整个范围而非触发发布的单个改动决定升级类型；若范围含新功能或新平台而维护者要求补丁版本，应停止并说明。步骤依次为：用 npm version <version> --no-git-tag-version 设置唯一版本源（必须带该标志，否则会自行创建提交与标签）；运行 npm run bump 写入 .claude-plugin/plugin.json、.claude-plugin/marketplace.json、.codex-plugin/plugin.json、gemini-extension.json 及 scripts/version-refs.mjs 发现的所有含版本号文本文件（六个 README 徽章与文档落地页的 JSON-LD softwareVersion）；在 CHANGELOG.md 顶部新增分类条目（Added / Fixed / Changed），标题必须为 ## [<version>] - YYYY-MM-DD，否则 npm run validate 会失败；逐条审计范围内每个提交，仅三类豁免（发布版本提升、分支提交已单独列出的合并提交、仅触及图表两个文件的 star-history 机器人提交），其余均需条目或说明理由；运行 npm run validate 与 npm test；提交并推送至 main（直接提交，无 PR）；用 gh release create v<version> --title "v<version>" --notes "<changelog section>" 创建 GitHub Release，最后报告版本与发布 URL。
限制：bump-version.mjs 只读取 package.json 中的版本，不修改 CHANGELOG，版本编辑与 CHANGELOG 条目需手动完成；审计脚本仅能对范围内 PR 的 #N 未被引用报错，其余检查靠人工判断，绿色审计不代表 CHANGELOG 完整。其他细节暂未提供。