Merge pull request #45 from omdsh-dev/fix/release-final-align

fix: pin toolchain, fail on missing changelog section (sibling align)

Author: btspoony

.github/workflows/ci.yml

@@ -20,11 +20,11 @@ jobs:
       # setup-node's `cache: pnpm` can locate the pnpm store path.
       - uses: pnpm/action-setup@v4
         with:
-          version: 11
+          version: 11.21.0
 
       - uses: actions/setup-node@v4
         with:
-          node-version: "24"
+          node-version: "24.19.0"
           cache: pnpm
 
       - name: Install dependencies

.github/workflows/release-prep.yml

@@ -40,11 +40,11 @@ jobs:
       # `cache: pnpm` can locate the pnpm store path (same order as ci.yml).
       - uses: pnpm/action-setup@v4
         with:
-          version: 11
+          version: 11.21.0
 
       - uses: actions/setup-node@v4
         with:
-          node-version: "24"
+          node-version: "24.19.0"
           cache: pnpm
 
       - name: Install dependencies

.github/workflows/release.yml

@@ -53,11 +53,11 @@ jobs:
       # `cache: pnpm` can locate the pnpm store path (same order as ci.yml).
       - uses: pnpm/action-setup@v4
         with:
-          version: 11
+          version: 11.21.0
 
       - uses: actions/setup-node@v4
         with:
-          node-version: "24"
+          node-version: "24.19.0"
           registry-url: https://registry.npmjs.org
           cache: pnpm
 
@@ -171,12 +171,15 @@ jobs:
           # additionally appends a merge-instruction line; the Release body is
           # the section only).
           # Guard on the file existing: under `set -e`, awk on a missing
-          # CHANGELOG.md exits 2 and aborts the step before the fallback could
-          # run. The version anchor is prefix-safe: the pattern is anchored at
-          # `^## \[<version>\]`, so `0.1.1` cannot match a `## [0.1.10]` header.
-          # Fall back to git log (nearest ancestor tag of HEAD, full history
-          # when no tag exists) only when the file or the section is missing,
-          # e.g. a release PR prepared before CHANGELOG.md existed.
+          # CHANGELOG.md exits 2 and aborts the step. The version anchor is
+          # prefix-safe: the pattern is anchored at `^## \[<version>\]`, so
+          # `0.1.1` cannot match a `## [0.1.10]` header.
+          # No git-log fallback on the Release side: every release PR prepared
+          # by the current prep writes its CHANGELOG section before the PR
+          # opens, so a missing section is a contract break — fail loudly
+          # instead of shipping an empty GitHub Release (mirror
+          # dsh-llm-fallbacks; an empty Release is a silent quality
+          # regression, not a recoverable one).
           VERSION="${{ steps.ver.outputs.version }}"
           if [ -f CHANGELOG.md ]; then
             # Escape regex metacharacters in the version inside awk (the gsub
@@ -194,11 +197,8 @@ jobs:
             ' CHANGELOG.md > /tmp/notes.md
           fi
           if [ ! -s /tmp/notes.md ]; then
-            PREV_TAG=$(git describe --tags --abbrev=0 HEAD 2>/dev/null || echo "")
-            git log --oneline --first-parent ${PREV_TAG:+$PREV_TAG..}HEAD > /tmp/notes.md
-            if [ ! -s /tmp/notes.md ]; then
-              echo "No commits between releases." > /tmp/notes.md
-            fi
+            echo "::error::No changelog section found for v${VERSION} in CHANGELOG.md; refusing to create an empty GitHub Release."
+            exit 1
           fi
 
       - name: Create + push tag

docs/release.md

@@ -23,7 +23,7 @@
 2. **构建**：`pnpm run typecheck && pnpm run build && pnpm run test`（与 CI 相同的校验命令）。
 3. **发布**：`npm publish --provenance --access public`，向 npm 发布 `dsh-advisor@X.Y.Z`（认证走 OIDC trusted publishing，无需任何 secret；`--provenance` 显式请求 sigstore 签名，与 dsh-llm-fallbacks 一致）。版本号含 `-` 的 prerelease（如 `0.1.3-alpha.1`）自动带 `--tag <前缀>`（前缀 = 首个 `-` 之后到首个 `.` 之前的文本，如 `alpha`），发布到 `alpha` dist-tag；正式版本（`X.Y.Z`）不带 `--tag`，默认发布到 `latest`。
 4. **打 tag**：以 `github-actions[bot]` 身份创建并推送注解 tag `vX.Y.Z`（commit message `Release vX.Y.Z`）；若该 tag 已存在，tag 步骤会跳过。**tag 跳过只覆盖 tag**——npm 不允许重复发布同一版本（`npm error ... previously published versions`），因此重跑工作流只在 **`npm publish` 步骤本身失败**（尚未发布任何版本、也未创建 tag）时才能继续完成发布；如果发布已经成功（例如随后 tag 或 GitHub Release 步骤失败），重跑会在 `npm publish` 步骤失败，而不是照常发布。**注意「已发布但未打 tag」的缺口**：发布成功后若 tag 步骤失败，仓库中没有任何 `vX.Y.Z` tag（基于 tag 的重复版本检查也拦不住该版本），此时重跑会卡在 `npm publish`；恢复只能人工处理——用 `gh release create vX.Y.Z --generate-notes`（或 `gh release create` 手动编辑正文）为已发布版本补建 tag 与 GitHub Release，或 bump 一个新版本重新走发布流程。
-5. **创建 GitHub Release**：以 `vX.Y.Z` 为 tag 与标题创建 Release，正文取自 `CHANGELOG.md` 中对应版本的 `## [X.Y.Z]` 小节（该小节由 **Release prep** 写入并随发布 PR 提交），仅包含该小节本身；PR 正文取自同一小节（提取来源相同），并额外附一行合并说明（见 [§1 步骤 4](#1-发布流程)）。版本号含 `-`（如 `0.1.3-alpha.1`）时，该 Release 会被标记为 **Pre-release**，不会作为最新稳定版展示。若该小节缺失（例如在引入 `CHANGELOG.md` 之前准备的旧发布 PR），则回退为自上一个 tag 以来的提交记录（`git log --oneline --first-parent`，取最近祖先 tag 为基准；无 tag 时为完整历史）。注：在 `CHANGELOG.md` 引入之前就已打开的在途发布 PR（例如本次变更时在途的 0.1.1 PR）合并后，其 Release 正文经回退逻辑以 git-log 格式生成，且该版本不会在 `CHANGELOG.md` 中留下小节（同版本不可重复准备）；从下一个版本起，Release 正文恢复为对应 `## [X.Y.Z]` 小节。
+5. **创建 GitHub Release**：以 `vX.Y.Z` 为 tag 与标题创建 Release，正文取自 `CHANGELOG.md` 中对应版本的 `## [X.Y.Z]` 小节（该小节由 **Release prep** 写入并随发布 PR 提交），仅包含该小节本身；PR 正文取自同一小节（提取来源相同），并额外附一行合并说明（见 [§1 步骤 4](#1-发布流程)）。版本号含 `-`（如 `0.1.3-alpha.1`）时，该 Release 会被标记为 **Pre-release**，不会作为最新稳定版展示。若该小节缺失（例如绕过 Release prep 手工准备的发布 PR），Release 工作流会直接报错退出（exit 1），拒绝创建空的 GitHub Release——当前 Release prep 生成的每个发布 PR 都会先写入对应小节，缺失即契约被破坏，不再回退到 git log。
 
 ## 3. 版本策略