PJR-XRAB exec run でプロダクトリポジトリの統合先を run ごとに指定できるようにする
1. 概要
integration_branch は project の設定に固定され、GitHub flow ではトピックが変わるたびに設定ファイルを書き換える必要がある。exec run に --integration-branch <repo>=<branch> の指定を加え、run ごとに統合先を選べるようにする。
2. 完了条件
exec runで、プロダクトリポジトリの統合先を run ごとに指定できる。指定がない場合は、従来どおりrepos[].integration_branch（省略時はそのリポジトリの現在のブランチ）を使う。- UNDECIDED: 指定の形（例:
--integration-branch <repo>=<branch>）、--resumeや--parallelでの扱い、指定したブランチが存在しない場合の扱いは、設計時に決める。 - 指定した統合先が result の trace（統合先ブランチと commit snapshot）に記録される。
- specdojo:command-reference と specdojo:specdojo-config-reference に、指定の方法と優先順位が書かれている。
- 単体テストで優先順位（run の指定 → 設定 → 現在のブランチ）を、統合テストで指定したブランチへ統合されることを確認している。
_UNDECIDED_の点は、設計の段階で executor が決め、決めた内容と理由を result と個票の対応結果に書く。決めた内容は既存の動きを変えない（指定しない利用者の動きは今のまま）ものにする。- 作業を終える前に、
npm run typecheck・npm run lint:ts・npm run test:unitを実行して通す。 - 親の検証（lint-ts・lint-fm・lint-md・typecheck・test-unit・test-integration・validate-schema）が通る。
- runner のコードを変えるため、統合の後に
exec run --registerを 1 回流して動作を確かめる（PJR-JSEY）。 - CHANGELOG の
## [0.4.1] - 未定の節に書く。公開済みの版の節は変えない（2026-10-20、利用者の承認で 0.4.1 の範囲に加えた）。
3. 作業内容
| No | 作業 | 担当 | 状態 | メモ |
|---|---|---|---|---|
| 1 | 指定の形と優先順位を設計する | DEV | done | 下記の設計で実装した。 |
| 2 | 実装し、テストと文書を更新する | DEV | done | CLI、checkpoint、schema、単体・統合テスト、利用者向け文書、CHANGELOG を更新した。 |
4. 対応結果
- register の worktree モードに、繰り返し可能な
--integration-branch <repo>=<branch>を追加した。<repo>はrepos[].name、<branch>はそのリポジトリに既存の有効なローカルブランチとし、リモートからの取得やブランチの自動作成は行わない。入力は register の状態変更前に検査する。 - 優先順位は「run の指定 →
repos[].integration_branch→ 現在のブランチ」とした。オプションを使わない既存利用者の動作を変えないためである。 --parallelでは選択した各 item run に同じ指定を適用する。--resumeでは開始時の明示指定だけをpipeline-state.jsonに保存して再利用し、再開時の省略を認める一方、途中での変更・追加は拒否する。開始点と統合先が run の途中で食い違うことを防ぐためである。- 指定したブランチは既存の複数リポジトリ trace の経路を通り、result に統合先ブランチと統合後の commit snapshot を記録する。
- specdojo:command-reference、specdojo:specdojo-config-reference、specdojo:branch-workflow-guide、CHANGELOG、pipeline state schema、実装、単体・統合テストを更新した。
- 残課題はない。runner コード変更後の実環境での
exec run --register確認は、親 runner が統合と検証を完了した後に PJR-JSEY として実施する。
5. 関連ドキュメント
- prj-0001:pjr-zdvq-product-repo-branch-strategy: 派生元の決定。
- specdojo:specdojo-config-reference:
repos[].integration_branch。 - [[prj-0002:pjr-hepk-lp-content]]:
specdojo-lpのmainに統合が並んだ項目。