[Bug] pnpm run build 静默退出，5 个 CLI 脚本入口不执行（Node 24.0.x import.meta.main 兼容问题）

[Tonys-L]

现象

• 环境：Windows，Node v24.0.0，tsx 4.23.12
• 执行 pnpm run build，瞬间结束，无任何输出。不报错，退出码 0。但没有任何构建产物，.dsh-build/client-build-environment.json 也不存在。
• 同样症状影响 pnpm run check:all、pnpm run verify-cordis-config、pnpm run verify-doc-site-fragments、pnpm run verify-runtime-closure 等脚本。全部都是静默退出 exit 0。

根因

Node.js bug #58660 ：import.meta.main 在 TypeScript 入口文件下返回 undefined。Node 24.2.0 才修复，但本仓库 package.json 声明的 engines.node: "^22.19.0 || >=24.0.0" 允许使用 24.0.x。

本项目 5 个脚本用 if (import.meta.main) 作为 CLI 入口 guard：

脚本	作用	调用位置
scripts/build.ts	根 build 入口	pnpm run build
scripts/run-gates.ts	所有 check:* 聚合脚本	pnpm run check:all、pnpm run check:ci
scripts/verify-cordis-config.ts	Cordis 配置校验	pnpm run verify-cordis-config
scripts/verify-doc-site-fragments.ts	文档站点片段校验	pnpm run docs:build 内部调用
scripts/verify-runtime-closure.ts	runtime 闭包校验	pnpm run verify-runtime-closure

在 Node 24.0.x 上，guard 条件永远是 false，main() 没被调用，脚本直接跑完模块求值、退出 0，看上去什么都没执行。

engines.node 已经声明支持这一范围，所以用户按声明使用 Node 24.0.x 是合理的，属于仓库真实 bug。

复现步骤

node --version           # v24.0.0（< 24.2 即可复现）
pnpm run build           # 瞬间返回，终端只剩 PS 提示符
echo $LASTEXITCODE       # 0
Test-Path apps/web/dist/index.html   # False（没产物）

再单独执行其中一个脚本观察：

node --import tsx scripts/verify-cordis-config.ts
# （无任何输出，exit 0）

修复方案

把 if (import.meta.main) 替换为跨版本兼容的入口检测：

import { pathToFileURL } from 'node:url'

const entryUrl = process.argv[1] === undefined ? '' : pathToFileURL(process.argv[1]).href
if (import.meta.url === entryUrl) main()

• 兼容 Node 22 / 24.0.x / 24.2+ 全范围
• pathToFileURL() 而非模板字符串，避免安装路径含空格、#、?、% 时百分号编码不匹配（参考 cyberuni/cyberplace#272 ）

本地修复验证

修复后再次运行其中最轻量的脚本：

node --import tsx scripts/verify-cordis-config.ts
# verify-cordis-config: 130 config files passed. ✅

5 个脚本全部正常执行。commit + pre-push hook（完整 typecheck + build）通过。

补丁文件

附带修复补丁（5 files changed, +15 insertions, -5 deletions）：

(附件：0001-fix-scripts-replace-import.meta.main-guard-with-path.patch)

相关链接

• Node 上游 bug：nodejs/node#58660 — import.meta.main 在 TS 入口下失效
• 类似静默 exit 0 模式的详细分析：cyberuni/cyberplace#272 （含 file:// 模板字面量百分号编码陷阱的踩坑记录）

0001-fix-scripts-replace-import.meta.main-guard-with-path.patch