PJR-SNHK register-plan-escape の共通の規約の test が負荷で 5 秒の上限を超えて落ちる
1. 概要
tests/src/exec/register-plan-escape.test.ts の「approach の有無によらず、共通の規約は参照パスと要点だけを本文に載せる」が、負荷のある実行で Vitest の既定の上限（5 秒）を超えて落ちる。変更と関係のない項目の統合を止め、やり直しが要る。
- 起きたこと（2026-10-25）:
- オーケストレーターが測った時間:
- 本体の develop で単独に流すと約 1.6 秒、全件の中では約 1.9 秒。単体テストで最も遅く、2 位（約 1.0 秒）の倍近い。
- ZG0A の worktree で単独に流すと、1 回目は 6.5 秒で落ち、2 回目以降は約 1.5〜1.9 秒で通った。変換のキャッシュがない状態で遅くなる。
- この test は
generateRegisterPlanを 2 回呼ぶ（approach なしと、カタログを書いてfully-guidedの approach あり）。どこに時間がかかっているかは未確認である。
2. 完了条件
- この test に時間がかかる原因を調べ、個票の対応結果と報告の
handoffに書く。 - 原因を取り除いて速くできる場合は、速くする。test が確かめる内容（両方の plan に共通の規約の参照パスと要点が載り、全文が載らないこと）は変えない。
- 速くできない場合、または速くしても 5 秒に余裕がない場合は、この test に限って上限を広げる。設定全体の
testTimeoutは変えない。広げた値と理由を test の近くのコメントに書く。 - 本番のコード（
src/）は、test を速くするためだけには変えない。plan の生成が遅い原因がsrc/にある場合は、直さずに個票の対応結果と報告のhandoffに書く。 - v0.4.6 の範囲とする。
- 作業を終える前に、
npm run typecheck・npm run lint:ts・npm run test:unitを実行して通す。 - 親の検証（lint-ts・lint-fm・lint-md・typecheck・test-unit・test-integration・validate-schema）が通る。
- CHANGELOG には書かない（利用者に見える変更がないため）。
3. 作業内容
| No | 作業 | 担当 | 状態 | メモ |
|---|---|---|---|---|
| 1 | 時間のかかる原因を調べる | DEV | open | - |
| 2 | 速くするか、この test の上限を広げる | DEV | open | 設定全体の上限は変えない |
4. 対応結果
- 原因の調査:
- 1 回目（approach なし）の
generateRegisterPlanは約 60ms で、時間はほぼ 2 回目（カタログを書いた approach あり）の呼び出しにかかる（約 1.5 秒）。 - 2 回目は
SPECDOJO_PACKAGE_ROOTを設定しない test のため、カタログの読み込みと関連文書の解決に、実 repo 側の読み込みと初回の変換が入ると推測する。冷えた状態の負荷時に 6.5 秒まで伸びた。 src/側の遅さの内訳までは未特定。test のためだけにsrc/は変えていない。
- 1 回目（approach なし）の
- 対応: この test に限って上限を 30 秒へ広げ、理由を test の近くのコメントに書いた。設定全体の
testTimeoutは変えていない。確かめる内容は変えていない。 - 残課題: 2 回目の呼び出しが遅い内訳（
src/側）は未調査。必要なら別項目にする。
5. 関連ドキュメント
- prj-0001:pjr-zg0a-empty-register-views-blank-lines：統合が 4 回止まった項目
- prj-0001:pjr-50yh-markdownlint-cli2-overrides：親の検証で同じ test が落ちた項目