跳转至

ISSUE-0112 · package.json 加了依赖、lockfile 没跟上

症状

6464ac8(Markdown 第一版)之后,HEAD 上:

package.json    turndown ^7.2.4 / turndown-plugin-gfm ^1.0.2 / @types/turndown ^5.0.6
pnpm-lock.yaml  turndown 命中 0 条

⇒ 任何干净 clone 上 pnpm install --frozen-lockfile 直接失败。 本机没暴露,是因为工作区的 node_modules 和未提交的 lock 都已经是对的 —— 破的只有 HEAD,而 HEAD 才是别人和 CI 看到的东西。

根因:两条正确的规矩撞在一起

并行会话纪律禁止 git add -A(会带走别的会话在共享文件里的在制品), 于是第一版走了 path-scoped 的 git add package.json。

但 package.json 与 pnpm-lock.yaml 是原子对:改一个不带另一个, 产出的 commit 自身不自洽。path-scoped 把「别人的文件」挡住了, 同时也把「我自己的配套文件」挡在了外面 —— 它按路径过滤,不按逻辑单元过滤。

🔴 判据不是「用不用 path-scoped」(该用,仍然用),而是 「这次改动的逻辑单元由哪几个文件构成」,列全清单再逐个 add。

已知的原子对(本项目)

改了这个 必须同提交
package.json 的 deps/devDeps pnpm-lock.yaml
package.json 的 version docs/_overview.md(pnpm docs:rebuild 重生成)
任何文档的 frontmatter docs/_index.tsv(scripts/gen-index-tsv.py)
src/utils/jsstore/base.ts 的表定义 version 字段 bump

修复

v0.10.136 一并提交 pnpm-lock.yaml(turndown 相关 9 条)。

验证:

pnpm install --frozen-lockfile   →  Done in 2.4s

证据边界

「干净 clone 上会失败」是从 HEAD 内容推的,没有真的另开一个 clone 跑一遍 —— --frozen-lockfile 在本机通过,验的是修好之后的工作区 lock,不是修之前的 HEAD。 推断依据是 pnpm 在 lock 与 package.json 不一致时于该模式下报错退出, 这条行为本身没有在本项目实测。