chore(module-size): 棘轮在主干上自己超基线 —— 补上 #1381 漏改的那一行,别让每条分支都背一条不属于自己的 ⚠ (#1430)

[jinjunnn]

这条 ⚠ 是谁的

origin/alpha@f2456275f(干净树、零本地改动)上跑判官:

$ bash scripts/assert-module-size.sh
    · ① 棘轮(scripts/module-size-ratchet.tsv,只许降不许升):
        ⚠ 超基线:packages/ui-mac/src/main/ext-install-planner.ts 实测 3539 行 > 基线 3525(+14)
        ✓ packages/ui-mac/src/main/ext-transaction.ts 2825 行(= 基线)
        ✓ packages/ui-mac/src/main 59075 行(= 基线)
    ⚠ 模块体积有告警(见上)—— 不拦 push,但这次运行不能算「全绿」(先量后闸,#1289)。
=== exit 2 ===

逐 commit 量 ext-install-planner.ts 的行数(git show <c>:<path> | wc -l),找出那 +14 的出处:

行数	commit
3525	329847979 2026-08-30 REQ-139 默认工作区 (#1192)
3539	ad3864206 2026-09-22 #1381 / PR #1409 远程 MCP 真源

+14 全部来自这一个已合并的 commit,中间没有第二个 commit 碰过这个文件。而 #1381
把 tree 那一行从 57,542 抬到了 59,055,理由列里还逐字写着
「ext-install-planner.ts 的启停投影(+13)」—— 也就是说这次增长在评审面前出现过、被登记过一次,
只是 file 这一行漏改了。

所以这个 PR 不是新开一次抬基线,是把 #1381 只做了一半的登记补完。

选 B(抬基线 + 写明理由),不选 A(拆文件)

先读了那 14 行是什么(git show ad3864206 -- packages/ui-mac/src/main/ext-install-planner.ts):

行数	内容
6	remoteMcpTruthNames() —— 真源里的远程 MCP 名单;没有环境根(纯单测)即空集
2	computeEnableProjectionEdit 的 remoteMcpNames 形参及其注
4	缺叶分支里「真源里的远程 MCP 只翻账本、不投影 config」那一句判据 + 三行为什么
1	reconcileDesiredStateAtBoot 里每次启动读一遍名单
1	真源读端 readMcpServerRecords 的 import

不选 A 的两个实测理由:

1. 这 14 行全长在本文件的私有函数 computeEnableProjectionEdit 上,它的调用点全在本文件内。
   把它们搬出去,要先把启停投影的内部形状导出成公共 API —— 为了让一个体积数字变小而扩大公共面。
2. 就算搬,也搬不过线。 唯一形状上可独立的是 remoteMcpTruthNames() 那 6 行,
   挪进新文件后本文件 3533 行,仍 > 3525;而 tree 那一行(59075)一点不降。
   那正是本表抬头逐字点名要挡的形态:「把 800 行从 planner 搬进一个新文件就能让两条 file 行全绿,
   而这一层的总量一点没少」。

整文件按阶段拆是另一件事,本 PR 不做也不开票:#1289 票面明写 out of scope,
本表 file 行的理由列自己也写着「拆分本身另立票」—— 而那张票至今没开。
把一张 S 级 chore 变成 3,539 行安装计划器的重构,正是 #1430 边界禁止的。

按 #1430 AC2 的三条界:没有 --update 式写回、没有删这一行、没有改判官,
也没顺手动另两行。diff 是 1 file changed, 1 insertion(+), 1 deletion(-)。

AC1:那条 ⚠ 消失

本分支、工作树只有这一行 tsv 改动,别的什么都没改:

$ git status --short
 M scripts/module-size-ratchet.tsv
$ bash scripts/assert-module-size.sh
    · ① 棘轮(scripts/module-size-ratchet.tsv,只许降不许升):
        ✓ packages/ui-mac/src/main/ext-install-planner.ts 3539 行(= 基线)
        ✓ packages/ui-mac/src/main/ext-transaction.ts 2825 行(= 基线)
        ✓ packages/ui-mac/src/main 59075 行(= 基线)
    · ② 本分支新增/修改的非测试源码里没有超过 800 行的
=== exit 0 ===

AC3:先证明判官测得出已知的坏(成对)

故意写坏 —— 往 ext-install-planner.ts 末尾加一行注释(3539 → 3540):

$ printf '// AC3 probe: one line over the new baseline — must trip the ratchet.\n' >> packages/ui-mac/src/main/ext-install-planner.ts
$ wc -l < packages/ui-mac/src/main/ext-install-planner.ts
    3540
$ bash scripts/assert-module-size.sh
        ⚠ 超基线:packages/ui-mac/src/main/ext-install-planner.ts 实测 3540 行 > 基线 3539(+1)
        ✓ packages/ui-mac/src/main/ext-transaction.ts 2825 行(= 基线)
        ⚠ 超基线:packages/ui-mac/src/main 实测 59076 行 > 基线 59075(+1)
    ⚠ 模块体积有告警(见上)—— 不拦 push,但这次运行不能算「全绿」
=== exit 2 ===

一行就够它响,而且 file 行与 tree 行同时响 —— 顺带证明了新基线不是橡皮章,
tree 那道防「搬进新文件」的闸也还活着。

还原(git checkout -- <file>,回到 3539):

$ wc -l < packages/ui-mac/src/main/ext-install-planner.ts
    3539
$ bash scripts/assert-module-size.sh
        ✓ packages/ui-mac/src/main/ext-install-planner.ts 3539 行(= 基线)
        ✓ packages/ui-mac/src/main/ext-transaction.ts 2825 行(= 基线)
        ✓ packages/ui-mac/src/main 59075 行(= 基线)
=== exit 0 ===

响了能还原 ⇒ 不是恒响门。这一对是 AC3 要的两份输出。

本地门(worktree 1430-ratchet,产物已补齐)

bash scripts/alpha-check.sh 手跑 + pre-push 钩子各跑一遍,两遍 exit 0,14/14 步全绿。
关键行:

✓ zero upstream package edits                       [1/14]
✓ typecheck                                         [4/14]
 5321 pass / 0 fail / Ran 5321 tests across 382 files   [5/14] ui-mac 整包
  724 pass / 0 fail                                     [5/14] packages/app
✓ 221 个闸门文件全部在位且真的跑过(条数与登记精确一致)  [6/14]
✓ 模块体积:棘轮全部在基线内,本分支改动里没有超阈值的文件  [14/14]

与 base fail-set 的差:零。 origin/alpha 的 base 是 5321 pass / 0 fail,本分支逐字相同。

唯一一条「本次未验成」是 [11/14]:本机没有 MINIMAX_API_KEY / DASHSCOPE_API_KEY /
MOONSHOT_API_KEY,三个 BYOK provider 的目录 id 这次没能问上游。与本改动无关、脚本按设计不拦。

跑门前按 alpha-work/governance/local-verification-traps.md 补齐了两个未追踪产物
(electron/{dist,path.txt} 软链主 checkout;alpha_fence.node 用
bun run --cwd packages/ui-mac build:fence-addon 在本树现编),否则量到的 fail 是缺口的性质、
不是这棵树的性质。跑完 core.hooksPath 仍是 .githooks(读回确认,没被 husky 改掉)。
分支落地用 git ls-remote --heads 读回确认,不信 push 的退出码。

Fixes #1430

🤖 Generated with Claude Code