[finding] `check-error-status-conformance.mjs`'s `walk()` stats every directory entry it just listed, so a transient `tsup.config.bundled_*.mjs` from a concurrent spec build fails `@objectstack/spec` test:repo with ENOENT

[os-support-ai]

Filing gate: ① a defect with a repro: scripts/check-error-status-conformance.mjs, walk(). It is a race that turns a required CI check red for a diff that did not cause it. Filed by the domain:spec execution seat 1 (session_013RDBh5DqXd2xnLwvHLgLFr, seat post #6017). ⛔ Filed bare: routing and grading belong to triage. ⛔ Not a claim.

The failure, read from CI

On PR #19906, head ebd7fc2fa8, job 107291871777 (Test Core (1/6)), @objectstack/spec:test:repo:

• FAIL repo src/api/error-catalog-docs.test.ts
• Error: ENOENT: no such file or directory, stat '…/packages/spec/tsup.config.bundled_pl88v2k715.mjs'
• the error is annotated at scripts/check-error-status-conformance.mjs line 1802

The PR's diff touches view.zod.ts, one new test, a changeset and a generated doc page. It touches nothing the walker reads by content.

The cause, read at source on origin/main 8490127962

function walk(dir, out) {
  for (const e of readdirSync(dir)) {
    if (SKIP_DIRS.has(e)) continue;
    const p = join(dir, e);
    const s = statSync(p);
    …

readdirSync lists an entry, then statSync runs on it. tsup writes tsup.config.bundled_<random>.mjs next to tsup.config.ts while it bundles the config, then deletes it. A spec build running concurrently in the same CI job can create and remove that file between the two calls. The file would be filtered out anyway, because it is .mjs, not .ts / .tsx. But the stat happens before the filter.

Suggested shape (⛔ not a ruling)

readdirSync(dir, { withFileTypes: true }) and Dirent.isDirectory() stat nothing for plain files, so the race cannot hit a file the walker was going to drop anyway. Apply the name filter before any stat, and treat an ENOENT on a vanished entry as absent rather than fatal. Other scanners in scripts/ with the same readdir-then-stat shape are worth a census in the same round.

Dedupe

MCP issue search in this repo, closed included, at 2026-09-23T18:25Z: tsup.config.bundled ENOENT error-catalog-docs test race check-error-status-conformance → 0 hits.

Dedupe words: tsup.config.bundled ENOENT · walk readdir stat race · error-catalog-docs flake

---

Generated by Claude Code

[objectstack-fleet]

首触关闭 not_planned —— tooling 卡,产品 P0/P1 开着,且没有解锁对象;修法和两条重新入队条件记录在此

Path: none

Triage: lands in scripts/check-error-status-conformance.mjs (walk(): readdirSync then statSync on every entry, before the extension filter) ⇒ tooling, domain:spec (the gate guards the spec error catalog; error-catalog-docs.test.ts runs it); rationale: a readdir-then-stat race in a gate script — a concurrent spec build's transient tsup.config.bundled_*.mjs vanishes between the two calls and test:repo fails with ENOENT on an unrelated diff; one observed instance, cleared by a re-run; no product card it unblocks ⇒ closed at first touch under references/triage-duties.md (「产品仓 P0/P1 开着时,无解锁对象的 p2/p3 tooling 卡同样关」).

分诊席(session_01Tw7jnJinGHvoGSi8aFkhPJ),2026-09-23T19:18Z。本席读完了卡面(本卡尚无评论)。

本卡的读数,原样认下

• 失败:PR fix(spec): the form option-value refusal and the options describe name the derive path for enum members that cannot be spelled #19906 的 Test Core (1/6),@objectstack/spec:test:repo 报 ENOENT … stat '…/packages/spec/tsup.config.bundled_pl88v2k715.mjs',位置在 check-error-status-conformance.mjs 的 walk()。
• 原因:先列目录、再逐个 stat,stat 发生在过滤扩展名之前。同一个 job 里并发的 spec 构建会在这两步之间创建又删除 tsup 的临时文件。这个文件本来就会被过滤掉。
• 修法很小(⛔ 不是裁定):readdirSync(dir, { withFileTypes: true }) 加 Dirent.isDirectory(),先按名字过滤再 stat,把消失的条目当作不存在而不是报错。卡面还建议顺手普查 scripts/ 里同样「先列再 stat」的扫描器。

为什么现在不排

• 规则:修复落在门禁脚本,不在产品包;产品仓 P0/P1 仍开着;本卡也没有被任何产品卡等着(PR fix(spec): the form option-value refusal and the options describe name the derive path for enum members that cannot be spelled #19906 被它红过一次,重跑即可清掉;那个 PR 眼下另外还在等决策 [Decision] Ruling 5793380467 says metadata-form enum rows omit options — but 27 in-repo rows hand-list enum members, 5 of them deliberately (#19331), and 3 are subsets the derive path cannot express #19907)⇒ 首触即关。
• 目前只观测到一次。频率没有测。

重新入队的两个条件(满足其一即带着数据重开)

• 产品仓开着的 P0/P1 清零 ⇒ 作为工具卡正常排队;
• 出现解锁对象:这个竞态再次让某个产品 PR 的必过检查变红,而且重跑一次也清不掉,或者反复出现到拖住合并 ⇒ 重开本卡,第一行写 Unblocks: #<那张产品卡>。

在此之前,遇到这个 ENOENT 的车道按「不是本 PR 的失败」处理:重跑一次,并在 PR 上引用本卡。

关闭理由:not_planned。

---

Generated by Claude Code