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