test(spec): 给 13 个 compiler-API 导出面 pin 一个符合真实工作量的超时 —— 今晨全部 CI 红的真因 (#4796)

[os-zhuang]

Fixes #4796
Refs #4845

真因(来自完整日志归档,不是尾部截断)

下载 run 30804783487 的完整日志后,失败明细第一次完整可见:

FAIL src/automation/state-machine.test.ts  [#4658] EventSchema pin        × 5602ms
FAIL src/automation/sync-retirement.test.ts [#4738] sync/conflict pin     × 5379ms
FAIL src/cloud/tenant.test.ts               [#4739] TenantPlan pin        × 5022ms
Error: Test timed out in 5000ms.  (×3)
Tests  3 failed | 7359 passed (7362)

全是超时,不是 OOM,与各 PR 的改动内容无关。 #4796 立案时只记了 tenant.test.ts 一条;实测这是一族 —— packages/spec 里 13 个 compiler-API 导出面 pin(每个退役/双源 PR 各留一个),零个有显式超时,全部骑在 vitest 默认 5s 线上。

为什么 CI 中而本地不中(按 #4796 的要求「先测量再决定」)

这族 pin 每个都对全部 16 个公共入口建一次 ts.createProgram —— 天然秒级:

环境	实测耗时
空闲机器(13 GB 可用)	~2-3s
CI 分片(turbo 把 spec#build 与 spec#test 并发跑在同 4 vCPU 上)	5.0 / 5.4 / 5.6s

争抢是概率性的 —— 这解释了「与改动内容无关、重跑可过、专挑真跑 spec 的 PR」的全部观测。今晨四次命中(#4831 ×2 含合并队列、#4841、#4846)加上 #4796 立案时的两次,共六次把 PR 或队列打红。

也顺带解释了 #4845 的误诊:DTS Build start 紧接 ELIFECYCLE 是并发任务的交织输出(turbo 多任务 stdout + GitHub 按 group 同戳 flush),真正失败的一直是 spec#test,而失败明细在 job log API 只回的 ~10KB 尾部之外。#4845 已更正。

修法与理由

packages/spec/vitest.config.ts 设 testTimeout: 30_000 + 长注释(测量数据、争抢机理、为什么 30s、真挂死由谁兜底):

• 30s ≈ 实测争抢峰值的 5 倍 —— 不是「4.5s 放宽到 10s 把踩雷推后」那种贴线调参;
• 真挂死仍由 CI 的 10 分钟 stall guard 兜底(run-with-stall-guard.mjs 才是挂死检测器)—— 这个数字只阻止「健康但受争抢」的运行被读成失败;
• 选 config 级而非逐 it 加参:13 个文件零显式超时,逐个补必漏(这族随每个退役 PR 增长,今天就新增了 3 个);
• flaky: spec/src/cloud/tenant.test.ts 的 #4739 导出面用例贴着 5s 超时 —— 今晚已两次把不相干的 PR 踢出合并队列 #4796 的方案 2(导出面做成构建期产物、pin 只比对不现场解析)仍是长期正解,本 PR 不关闭那个方向,issue 保持追踪。

验证

原三条失败 pin + 今晨新增的 activation-events pin 在新配置下实跑:

Test Files  4 passed (4)
     Tests  17 passed (17)
Duration  7.27s

空 frontmatter changeset(发布面零变化)。content/docs/releases/ 未触碰。

🤖 Generated with Claude Code

https://claude.ai/code/session_0176qgxgCXTJCUv4YFLtusP9

---

Generated by Claude Code

[vercel]

The latest updates on your projects. Learn more about Vercel for GitHub.

1 Skipped Deployment

Project	Deployment	Actions	Updated (UTC)
objectstack	Ignored		Aug 3, 2026 10:43am

[os-zhuang]

关闭:已被 #4856(#4850)superseded —— 另一车道在本 PR 开出前已把同一修复落进 main(d40f43a79,testTimeout: 60_000,注释同样覆盖全族 compiler-API 用例并关联 #4796)。

本 PR 若合入反而会把 60s 降回 30s 并覆盖对方的注释 —— 纯粹的车道重复,撤下。测量数据(空闲 ~2-3s / CI 争抢 5.0-5.6s、争抢源 = turbo 把 spec#build 与 #test 并发在同 4 vCPU)已记录在 #4796 评论中,对两个版本的修复同样成立;60s 余量更大,无异议。

---

Generated by Claude Code