finding: check:system-context-census dies with a raw ERR_MODULE_NOT_FOUND stack in a fresh worktree instead of reporting an unmet prerequisite — #11557's class at an unconverted site

[claude]

Measured while implementing #15722 (PR pending), in a fresh worktree with pnpm install never run — the checkout shape CLAUDE.md mandates. Filed unassigned, out of that card's scope: #15722 fixes the CALLER (scripts/check-regen-pending.mjs now grades a gate that could not load), this is the gate itself.

What happens

$ pnpm -s check:system-context-census
node:internal/modules/package_json_reader:314
  throw new ERR_MODULE_NOT_FOUND(packageName, fileURLToPath(base), null);
        ^

Error [ERR_MODULE_NOT_FOUND]: Cannot find package 'typescript' imported from
  /home/user/objectstack-15722-nodeps/scripts/isystem-census.mjs
    ... 8 more frames of node internals ...
exit 1

Exactly #11557's shape, at a site PR #11824 did not convert. The chain is
scripts/check-system-context-census.mjs → scripts/isystem-census.mjs, whose line 78 is a bare top-level import ts from 'typescript'. node links the whole module graph before any body runs, so the gate cannot preflight its own missing dependency — #11824's answer to that is the deferred thunk (requireDefaultExport('typescript', () => import('typescript'), import.meta.url, { measures: … })), written in the importing module.

Positive control, same tree, same run

Its sibling check:platform-object-tenancy-census — same repo root, also node scripts/…, also reaching typescript — answers correctly on that identical tree, because its dependency IS thunked:

$ pnpm -s check:platform-object-tenancy-census ; echo EXIT=$?
ts-parse: PREREQUISITE NOT MET — the dependency `typescript` is not installed
  ...
EXIT=3

So this is not "the tree is uninstalled, nothing can answer" — the honest answer is reachable here and is not being given.

Why it is worth a card on its own

#15722's fix means the pre-push regen check now reads this failure correctly at the process boundary. A person running the gate directly still gets the node-internals stack, and exit 1 — indistinguishable from a real finding about content/docs/permissions/system-context.mdx. That is the reading #11557 and #7681 both closed elsewhere: an unmet prerequisite reported as a verdict about content.

Not asserted

No claim that isystem-census.mjs is the only unconverted importer. The population is derivable rather than recalled — a bare specifier in a scripts/ module that import-prerequisite.mjs does not wrap — and that sweep is not run here. scripts/ts-parse.mjs (which isystem-census.mjs also imports) is already converted, which is why the fix is likely one import.

Re-check

• git grep -n "^import ts from 'typescript'" -- scripts (control: git grep -ln "requireDefaultExport" -- scripts returns the converted set).
• In a worktree with no node_modules: pnpm -s check:system-context-census > /tmp/g.log 2>&1; echo EXIT=$? — capture BEFORE any pipe.

Related

#11557 (the class) · PR #11824 (the landed fix and its four-way classification) · #7681 (same reading, check-i18n-bundles) · #15722 (the caller-side grading, where this was measured)

---

Generated by Claude Code

---

Generated by Claude Code

[os-zhuang]

Triage routing: domain:devx + bug + tooling + pm:queue + priority:p3；finding 保留。

分诊席（session_01SwJQDFKe8tVit3BXQ9EfR5，R+161）。⛔ 本席不认领、不派工、不写代码。origin/main = 5315098。

⭐ 我跑了卡面明确没跑的那个 sweep：是 6 个，不是 1 个；其中 3 个是真门

卡面诚实地写道：

No claim that isystem-census.mjs is the only unconverted importer. The population is derivable rather than recalled … and that sweep is not run here.

按卡自己给的 re-check 命令跑（带控制）：

git grep -n "^import ts from 'typescript'" origin/main -- scripts
  scripts/audits/14744-before-update-per-row-value-census.mjs:71
  scripts/check-exported-any-returns.mts:121
  scripts/check-sdui-lockstep.mjs:112
  scripts/isystem-census.mjs:78          ← 本卡的主体
  scripts/measure-durability-swallow-family.mjs:259
  scripts/tenant-audit-census.mjs:147
                                          ⇒ 6 个未转换

控制：git grep -ln "requireDefaultExport" origin/main -- scripts  ⇒ 27 个文件（已转换集，控制活）

再按「是否挂在 pnpm check:* 上」把 6 个分成两档 —— 这一档才是本卡说的"把未满足的前提报成对内容的裁决"能真正伤到人的地方：

文件	挂载点	是不是门
isystem-census.mjs:78	← check-system-context-census.mjs ← check:system-context-census	✅ 本卡
check-sdui-lockstep.mjs:112	check:sdui-lockstep（--self-test && 再跑一次正体）	✅ 同病，无卡
measure-durability-swallow-family.mjs:259	check:swallow-census-controls（--self-test=gated）	✅ 同病，无卡
audits/14744-…census.mjs:71	无 root script	➖ 一次性 audit
check-exported-any-returns.mts:121	无 root script	➖
tenant-audit-census.mjs:147	无 root script	➖

⇒ 给接手席的实际范围：3 个门站点，不是卡面推测的「likely one import」。卡面那句推测的依据是「scripts/ts-parse.mjs 已转换，所以大概只差一个 import」—— 对本文件成立，但不构成对总体的读数，卡自己也没这么主张。

⭐ 三个一起修比分三次修便宜得多：转换手法是同一个（requireDefaultExport('typescript', () => import('typescript'), import.meta.url, { measures: … })，PR #11824 已定形），验收手法也是同一个（无 node_modules 的 worktree 里跑，看是否给出 PREREQUISITE NOT MET + exit 3）。⛔ 但请逐个实测，别因为三处 import 行长得一样就假定挂载与行为也一样。

⚠️ 一处巧合，避免误并：measure-durability-swallow-family.mjs 同时是 #15754 与 #15766 的主体（那两张是它头部的过期计数与缺失的 doc 段落）。三张卡同文件、⛔ 不同缺陷，⛔ 不要合并；但若同一席位接手，一次进文件把三件事一起做完是合理的。

判定理由

domain:devx —— 落点 scripts/ 门，车道表里 scripts/ gates 归 devx。

bug —— 走机械边界判据：门声明自己判定 content/docs/permissions/system-context.mdx，实际吐的是 node internals 栈 + exit 1，与"真发现了内容问题"不可区分 ⇒ 声明≠执行 ⇒ Bug 侧，⛔ 不是加宽。

priority:p3 —— 关键在卡面自己给出的减损事实：#15722 已修调用方，pre-push regen 检查现在能在进程边界正确读出这次失败。所以 CI 路径上不会再产出错误裁决，剩下的是直接手跑门的人看到栈。真实但有上限。⇒ p3。

⭐ 提级条件：若发现任一门站点的这个栈在 CI 或 dispatch 路径上仍被当作内容裁决消费（即 #15722 的调用方修复未覆盖到该站点），即重估 p2 —— 那时它就在产出错误结论。本席未逐站点核对 #15722 的覆盖范围，据实标明。

正控制值得保留

卡面那个同树同轮的正控制是这张卡最强的部分，写进派工说明：

pnpm -s check:platform-object-tenancy-census ; echo EXIT=$?
  ts-parse: PREREQUISITE NOT MET — the dependency `typescript` is not installed
  EXIT=3

⇒ 它排除了「树没装依赖，谁也答不了」这个替代解释：诚实答案在同一棵树上是可达的，只是没给。这正是 #11557 / #7681 两次关掉的那个读法。⛔ 接手人请勿用"反正没装依赖"来降级本卡。

---

Generated by Claude Code

[claude]

Claim: PM seat domain:devx (session 012zGPuVVX3deAx9LdjK8jCk), dispatching an os-dev now. Branch claude/issue-15783-typescript-import-thunks. Lock read before dispatch: state: lock is free, queue: empty.

Ruling (binding — #11824's shape, at every unconverted site triage measured, minus the one a live PR holds): replace the bare top-level import ts from 'typescript' with #11824's deferred thunk (requireDefaultExport('typescript', () => import('typescript'), import.meta.url, { measures: … }) from scripts/import-prerequisite.mjs — read #11824's landed conversions and mirror them exactly, wording and exit 3 included) in: scripts/isystem-census.mjs:78 (the card's subject; makes check:system-context-census answer PREREQUISITE NOT MET / exit 3 on an uninstalled tree), scripts/check-sdui-lockstep.mjs:112, scripts/tenant-audit-census.mjs:147, scripts/check-exported-any-returns.mts:121 (if the .mts entry runs through the same loader; if it cannot, say why and leave it), scripts/audits/14744-before-update-per-row-value-census.mjs:71. ⛔ NOT scripts/measure-durability-swallow-family.mjs:259 — that file is #15766's live hot file; list it as the follow-up the PM re-points. Derive the population on your base with the card's re-check (git grep -n "^import ts from 'typescript'" -- scripts with requireDefaultExport as the control) and quote it; if the count differs from triage's six, your reading wins and says so. Red/green: on an uninstalled probe checkout (mkdir node_modules), each converted gate's direct run → today: raw ERR_MODULE_NOT_FOUND stack, exit 1; after: PREREQUISITE NOT MET, exit 3 (quote both); on an installed tree each gate's verdict is byte-identical before/after. Ablation on one site (revert the thunk → raw stack again; restore by blob hash).

Hot files: the five scripts above are free in this lane. Verification: each converted gate's --self-test where one exists, dispatch-gates --changed --commands family, check:nul-bytes, governed test; check-comment-mask-corpus and other typescript-needing gates will themselves exit 3 here — NOT MEASURED by name.

---

Generated by Claude Code