PJR-JG9Q strategy が更新されたトラックを exec cycle で自動再生成する
1. 概要
計画物として sch-strategy-
preprocess と postprocess を宣言する仕組みは導入しない。今回の要件は鮮度検知だけで表現でき、設定面を増やすとコマンド注入の攻撃面も増えるためである。鮮度では表せない要求（トラック完了時の通知、失敗時のみの処理など）が出た場合に、pipeline.parent_validations と同じ固定 ID 参照方式で別途設計する。
2. 完了条件
exec cycleの実行中に、sch-strategy-<track>がsch-track-<track>より新しいトラックが自動で再生成される。- 判定は既存の鮮度検知（
src/exec-schedule.tsの警告と同じ基準）を用い、新しい設定項目を追加しない。 - 再生成は
--autoでタスクを選ぶ前に完了し、同じ cycle の中で新しいトラックのタスクが Ready として現れる。 - 再生成に失敗した場合は、その時点で理由を出力して停止する。古い track のままタスクを実行しない。
- 鮮度が同じ（再生成不要）の場合は何も実行せず、出力にも余計な行を出さない。
- 自動再生成が
sch-milestones.yamlのstatusを書き換えない（PJR-AAR2 の対応が前提）。 - 単発の
exec runやexec refreshの挙動は変えない。自動再生成はexec cycleに限定する。 - 上記を検証する unit test / integration test が追加され、
npm run test:unitとnpm run test:integrationが成功する。 exec cycleの手順がコマンドリファレンスと exec 運用ガイドへ反映されている。
3. 作業内容
| No | 作業 | 担当 | 状態 | メモ |
|---|---|---|---|---|
| 1 | 既存の鮮度検知を再利用できる形に整理する | ARC | done | 警告と cycle が findStaleGeneratedTracks を共用 |
| 2 | exec cycle の手順へ自動再生成を組み込む | ARC | done | index 後・validate / refresh 前と auto の各次ラウンド前に実行 |
| 3 | 失敗時の停止と出力を実装する | ARC | done | build 失敗時は refresh と auto を実行せず終了コード 1 |
| 4 | PJR-AAR2 の status 書き換えを解消してから有効化する | ARC | done | PJR-AAR2 完了済みを確認し、既存 status 保持テストを前提にした |
| 5 | unit test / integration test を追加する | ARC | done | fresh・missing・outdated・失敗停止・Ready 反映・実行順を網羅 |
| 6 | コマンドリファレンスと exec 運用ガイドを更新する | ARC | done | 5 step と loop 内の再判定を command / exec / routine 文書へ反映 |
4. 対応結果
src/exec-schedule.tsの鮮度判定をfindStaleGeneratedTracksとして構造化し、従来のexec validate警告とexec cycleの自動再生成で同じ判定を共用した。track がない場合と strategy の更新時刻が track より新しい場合を対象とし、track 名順で決定的に処理する。src/exec-run.tsで doc-index 再構築後、exec validate/exec refreshより前に stale track ごとのschedule build --forceを実行するようにした。--loopでは auto の各次ラウンドでも index build 後・refresh 前に再判定するため、前ラウンドで strategy を更新した場合も同じ cycle で次 track の Ready task を選択できる。- 再生成が不要な場合はコマンドを実行せず、再生成用のログや summary 項目も出力しない。再生成に失敗した場合は該当 track を表示し、古い track のまま refresh / auto へ進まず終了コード 1 とする。単発の
exec runとexec refreshには自動再生成を追加していない。 - PJR-AAR2 sch-milestones の status が最後に build したトラックの strategy に引きずられる が完了済みで、
schedule buildが既存sch-milestones.yamlの status を保持する実装と回帰テストを確認した。今回の再生成経路でも同じコマンドを利用する。 - unit test に鮮度判定、fresh 時の無処理・無出力、複数 track の処理順、失敗時の即時停止を追加した。integration test には、実際の
schedule buildとexec refreshを通して新規 task が Ready になること、および cycle の dry-run で build が index と validate の間に配置されることを追加した。 - コマンドリファレンス、exec運用ガイド、routine運用ガイドへ、条件付きの再生成、失敗時の停止、loop 内の再判定、単発コマンドとの境界を反映した。
npm run typecheckと unit test 全 1,255 件が成功した。Markdown の整形・静的検査、register build、catalog validate、index build も成功した。integration test の実行は executor / reporter pipeline の分担に従って親 runner が行う。- preprocess / postprocess や新しい設定項目は追加していない。残課題はない。
5. 関連ドキュメント
- 前提となる課題: PJR-AAR2 sch-milestones の status が最後に build したトラックの strategy に引きずられる
- 計画物をトラック化した項目: PJR-QF7T planning ドメインとトラックを新設し、計画成果物をカタログとScheduleへ載せる
- 同じ鮮度検知の実装例:
src/build-if-stale.tsとsrc/dist-freshness.ts - 変更対象の実装:
src/exec-run.tsの cycle 手順、src/exec-schedule.tsの鮮度検知