v1.85.1 的 Codex session-end hook 脚本存在重复 path 声明，fresh install 后直接语法报错

[rendigua]

问题概述

在 fresh install 的 @evomap/evolver@1.85.1 上，按官方方式执行：

npm install -g @evomap/evolver@1.85.1
evolver setup-hooks --platform=codex

之后直接运行生成的 session-end hook，会报语法错误：

SyntaxError: Identifier 'path' has already been declared

环境

• OS: Windows
• Host: Codex
• package: @evomap/evolver@1.85.1
• node: v22.15.0
• npm: 11.6.2
• git: 2.53.0.windows.2

我做了什么

这次不是旧环境增量升级，而是完整重装：

1. npm uninstall -g @evomap/evolver
2. 清掉活跃全局残留（AGENTS.md、.codex/hooks.json、.codex/hooks/）
3. 重新安装 @evomap/evolver@1.85.1
4. 执行：

evolver setup-hooks --platform=codex
node <configRoot>/.codex/hooks/evolver-session-end.js

实际行为

生成的脚本头部里出现了重复声明：

• 第 9 行：const path = require('path');
• 第 16 行：const path = require('path');

因此脚本直接报：

SyntaxError: Identifier 'path' has already been declared

额外确认

我还把本机安装出来的文件和 GitHub v1.85.1 tag 对应文件直接对比过，二者一致。

也就是说，这看起来不是本地安装污染，而是 v1.85.1 源码本身就带着这个回归。

期望行为

• setup-hooks --platform=codex 生成的 session-end hook 应该能直接运行
• 不应包含重复变量声明导致的语法错误

关联

这个问题和 #540 不完全相同。

• #540 讨论的是 review/context 输入链
• 这里是一个新的 hook 脚本语法回归，会直接阻断 session-end 正常执行

[imxyanua]

@rendigua 感谢这份高质量的报告 — 复现步骤、与 v1.85.1 tag 直接比对、以及和 #540 的边界划分都非常清楚。

确认 root cause:

• 上一次改 hook 行为的修复在 src/adapters/scripts/evolver-session-end.js 顶部新加了一组 import(fs / path / os),但没注意到文件下方原本就还有一行 const path = require('path')。两行同时存在 → parse 阶段直接抛 SyntaxError: Identifier 'path' has already been declared,Codex 的 session-end hook 一次都跑不了。
• 这个回归确实进了 v1.85.1 的 npm 包。你做的 v1.85.1 tag 对比已经直接排除了本地安装污染。

更糟的一点(刚验证完):v1.85.2 同样带着这个 bug。 我刚 npm pack @evomap/evolver@1.85.2 把 tarball 解开,对生成出的 evolver-session-end.js 直接跑 node --check,reproduce 出和你一模一样的 Identifier 'path' has already been declared。也就是说 1.85.1 → 1.85.2 这次发布里并没有捎带修这个回归 — 1.85.2 上 Codex session-end 仍然完全不能用。

为什么既有测试没拦下来:hook 脚本是 Codex / Claude 触发时另起 node 子进程跑的,现有测试套件从来不 require 它们 — parse-time 错误整套测试根本看不到,pre-publish 也漏过去。

修复 将作为 v1.85.3 hotfix 发布:

1. 删掉重复的 const path = require('path'),只保留文件顶部那一行。
2. 新增针对所有 entry-point 脚本(hook scripts + CLI 入口)的 node --check 防回归测试。在打补丁前的旧状态下这条测试是 FAIL 的、打完补丁后全绿 — 同类「entry-point 脚本 parse-time 回归」以后会在 pre-publish 测试套就被拦下,不会再有第二次。

v1.85.3 发出 npm 之后我会回到这里再 ping 一次确认。

临时绕过(在 1.85.3 出来之前,不要降级到 1.85.1 或 1.85.2 — 它们带同样的 bug):

1. 找到 <install-root>/src/adapters/scripts/evolver-session-end.js(全局安装通常在 node -e 'console.log(require.resolve("@evomap/evolver"))' 指出来的目录附近)。
2. 把 import 区里两行 const path = require('path'); 删掉其中靠下面那一行(大约在 const MAX_EXEC_BUFFER 后面)。
3. node --check 验证一下,然后 evolver setup-hooks --platform=codex 重新装一遍 hook(setup-hooks 会从 install root 拷贝源文件)。

[rendigua]

补一条最新结果：我刚按同样标准做了 fresh install 的 @evomap/evolver@1.85.3 复测，结论是这条回归仍然存在。

这次步骤仍然是：

1. npm uninstall -g @evomap/evolver
2. 清掉活跃全局残留（AGENTS.md、.codex/hooks.json、.codex/hooks/）
3. 重新安装 @evomap/evolver@1.85.3
4. 直接执行：

node --check <install-root>/src/adapters/scripts/evolver-session-end.js

结果还是：

SyntaxError: Identifier 'path' has already been declared

而且我还做了两层排除：

• 本机 fresh install 后复现
• 与 GitHub v1.85.3 tag 对应文件头部一致：
  • 第 9 行仍然有 const path = require('path');
  • 文件后面没有删掉这层冲突带来的问题路径

所以当前看：

不只是 1.85.1 / 1.85.2，1.85.3 也仍然带着这条 Codex session-end 语法回归。

如果你们已经有还没发版的 hotfix commit / tag，我可以继续按那个版本复测。

[imxyanua]

@rendigua 谢谢继续盯，这种 fresh-install + tag 双重对比的习惯确实很有用。
这次的结果我侧没复现到，想跟你对一下数据；如果对不上我们再继续深挖。

---

我这边做的两层独立验证

1. 直接拉 npm 上的 1.85.3 tarball

npm pack @evomap/evolver@1.85.3
tar -xzf evomap-evolver-1.85.3.tgz

head -18 package/src/adapters/scripts/evolver-session-end.js
node --check package/src/adapters/scripts/evolver-session-end.js

结果：

• 文件头部只有一行：

const path = require('path');

（第 9 行，原来的重复声明已经删掉了）

• node --check 退出码为 0
• 没有任何 SyntaxError

---

2. 直接 clone GitHub 上的 v1.85.3 tag

git clone --depth 1 --branch v1.85.3 https://github.com/EvoMap/evolver.git

node --check evolver/src/adapters/scripts/evolver-session-end.js

结果同样：

• 文件内容正常
• node --check 通过
• 且与 tarball 里的那份字节完全一致

---

时间线对照

Event	Time (UTC)
v1.85.3 tag commit	2026-05-23 04:30
npm publish	2026-05-23 04:32
你这条 comment	2026-05-23 07:15

也就是说，在你这次复测之前约 3 小时，带 fix 的 1.85.3 已经同时存在于：

• GitHub tag
• npm registry

因此这里不存在：

“PR 已合，但 tag / npm 还没同步到”的竞态问题。

---

目前最可能的两种情况

1. npm cache 命中了旧 tarball

npm uninstall -g 不会清理 ~/.npm 缓存。

在某些情况下：

npm install -g @evomap/evolver@1.85.3

可能会直接复用缓存中的旧 tarball（尤其是刚发布的小版本）。

如果之前安装过：

• 1.85.1
• 1.85.2

有概率出现：

• metadata 已更新到 1.85.3
• 实际安装文件仍来自旧缓存

---

2. 多 npm prefix / install root 共存

例如：

• 旧版本装在某个 nvm node 下
• 当前 install -g 落到了另一个 node prefix

最终导致：

which evolver

和你实际查看的：

<install-root>/src/adapters/scripts/evolver-session-end.js

并不是同一份安装。

---

可以麻烦你按下面这套再跑一次吗？

这套流程会把上面两种情况都彻底排除：

1. 完整卸载 + 清缓存

npm uninstall -g @evomap/evolver
npm cache clean --force

2. 确认真实 global install root

npm root -g

记下输出路径。

3. 强制在线拉取 1.85.3

npm install -g @evomap/evolver@1.85.3 --prefer-online --no-audit

4. 直接检查刚安装出来的文件

INSTALL_ROOT="$(npm root -g)/@evomap/evolver"

sed -n '1,20p' \
  "$INSTALL_ROOT/src/adapters/scripts/evolver-session-end.js"

node --check \
  "$INSTALL_ROOT/src/adapters/scripts/evolver-session-end.js"

5. （可选）确认 package version

cat "$INSTALL_ROOT/package.json" | grep version

---

如果问题仍然存在

如果第 4 步后：

• 还能看到两行：

const path = require('path');

• 或者：

Identifier 'path' has already been declared

仍然出现，

麻烦把下面两段输出原样贴回来：

1. sed -n '1,20p' ...
2. node --check ...

我可以直接按 byte 对比，看那份文件到底是从哪里来的。

也欢迎顺便贴一下：

npm root -g
node -v
which node

方便进一步排查多 prefix / 多 node 环境。

---

如果 step 4 已经全绿，那基本可以确认是 npm cache / install-root 问题被这套流程清掉了。

劳烦确认后 close 这条 issue。