Node.js ESM の CLI が何も出さずに exit 13 で止まる — 循環 import × top-level await のデッドロック診断と直し方

症状

• node tool.mjs ... を実行すると、何も出力しないまま次の警告で終わる。終了コードは 13 Warning: Detected unsettled top-level await at file:///.../tool.mjs:NNN process.exitCode = await main();
• テスト（main を import して呼ぶ形）は通る。CLI として直接起動したときだけ止まる。

原因

1. エントリの tool.mjs が、末尾で if (isEntry) process.exitCode = await main(); のように top-level await で main を待っている。
2. main の中で await import('./helper.mjs') を動的に読み込む。
3. helper.mjs が import { x } from './tool.mjs' で tool.mjs を静的に読み込んでいる（循環）。
4. tool.mjs はまだ評価中（TLA で main を待っている）なので、helper.mjs の評価は tool.mjs の評価完了を待つ。main は helper を待つ。互いに待ち合って、イベントループが空になる → Node が「unsettled TLA」として exit 13 にする。

テストでは tool.mjs を普通に import して評価が完了してから main を呼ぶので、循環しても止まらない。

確認手順（AI にそのまま渡せる）

1. 警告に出た行が await main() のような TLA であることを確認する。
2. main の中にある await import(...) をすべて列挙する。
3. それぞれの読み込み先（とその先）から、エントリファイルを静的 import していないかを grep -n "^import" <file> で調べる。
4. 戻ってくる import があれば、それが原因。

すぐ使える回避策（コードを変えずに動かす）

別ファイルから import して main を呼ぶと、エントリ判定が偽になり TLA が走らないので動く。

// run.mjs
import { pathToFileURL } from 'node:url';
const m = await import(pathToFileURL('<tool.mjs の絶対パス>').href);
process.exitCode = await m.main(process.argv.slice(2));

node run.mjs <元と同じ引数>

恒久修正（どちらか）

• A: 循環を断つ。helper が tool.mjs から借りている関数（例: ラベル解決）を、両者が import する小さな共通モジュールへ切り出す。最も素直。
• B: エントリで TLA を使わない。

if (isEntry) main().then(code => { process.exitCode = code; }, err => { console.error(err.message); process.exitCode = 1; });

B は症状を消すだけで、循環そのものは残る。可能なら A。

再発防止

• CLI 経路のスモークテストを 1 本足す: child_process.spawnSync(process.execPath, ['tool.mjs', '--dry-run']) を実行し、status が 13 でないこと・期待の出力が出ることを確かめる。import して main を呼ぶテストだけでは、この不具合を検出できない。