PJR-5B42 別のリポジトリの project の登録簿へ起票できるようにする
1. 概要
PJR-W93C は同じリポジトリの中の project に限られる。設定で別のリポジトリの project を別名付きで宣言し、register add でその別名を指定すると、相手のリポジトリの specdojo を起動して起票させる。project ID の衝突を別名で避け、orchestrator launch で相手のリポジトリへの編集を許可する
2. 完了条件
- 次の版の範囲とする（2026-10-22、利用者が承認。案 A: 相手のリポジトリの CLI に任せる）。
specdojo.config.jsonに、別のリポジトリの project を別名付きで宣言できる（例:external_projectsの下に、別名ごとに相手のリポジトリのパスと相手の project ID）。キーの名前と形は設計で決め、result に理由を書く。別名は、自分のprojectsの ID と重なってはならず、重なれば設定の検証で止める。register add --project <別名> --commitで、相手のリポジトリの中にある specdojo（相手のリポジトリのnode_modules/.bin/specdojoなど）を起動し、相手の project ID で起票させる。相手の版・形式・名簿・記帳の枠は相手の CLI に任せ、こちらの CLI は相手の登録簿のファイルを直接書かない。相手の統合ブランチの解決は相手の CLI（0.4.2 の W93C の動き）に任せる。- 相手のリポジトリがない、相手に specdojo が入っていない、相手の版が W93C より古い、
--commitがない、の場合は、何もせずに理由を示して止まる。相手の起票が失敗したときは、相手の出力をそのまま示す。push はしない。 --from <別名>:PJR-XXXXで、別のリポジトリの項目を起票の元として指せる。項目があるかは相手の CLI で確かめる。記録する値の形（別名で残すか、相手の project ID で残すか）は設計で決め、result に理由を書く。orchestrator launchが、宣言した別のリポジトリにもreposと同じく--add-dirと編集の許可を付ける。- 別のリポジトリへの状態遷移（close など）は対象外とし、相手のリポジトリで行うよう案内して止める。
- specdojo:register-operation-guide・specdojo:command-reference・specdojo:specdojo-config-reference に、宣言の仕方・起票の仕方・制約を書く。
- 単体テストで、設定の検証（別名の重なり）と、相手の CLI を起動する引数の組み立てを確かめる。統合テストで、2 つの一時のリポジトリ（両方に specdojo を入れたもの）を用意し、片方から他方へ起票して、相手のリポジトリの統合ブランチに 1 件の commit で記帳されること、元のリポジトリが変わらないこと、相手に specdojo がないときに止まることを確かめる。
- 作業を終える前に、
npm run typecheck・npm run lint:ts・npm run test:unitを実行して通す。 - 親の検証（lint-ts・lint-fm・lint-md・typecheck・test-unit・test-integration・validate-schema）が通る。
- register のコードを変えるため、統合の後に
exec run --registerを 1 回流して動作を確かめる（PJR-JSEY）。 - CHANGELOG の
## [Unreleased]の節に書く（なければ作る）。公開済みの版の節は変えない。
3. 作業内容
| No | 作業 | 担当 | 状態 | メモ |
|---|---|---|---|---|
| 1 | 別のリポジトリの project の登録簿へ起票できるようにする | DEV | done | 次の版 |
4. 対応結果
- トップレベルの
external_projectsを「別名をキー、pathとproject_idを値」とする対応表として追加した。別名でローカルの project ID との衝突を避けつつ、相手の実 project ID を明示でき、複数の外部リポジトリも追加しやすいためこの形とした。 register add --project <別名> --commitは、相手のnode_modules/.bin/specdojoが 0.4.2 以上であることを確認してから、相手の実 project ID で起票を委譲する。相手のファイルは呼び出し元から直接変更せず、出力と失敗時の終了コードも相手の CLI から引き継ぐ。--from <別名>:PJR-XXXXは<相手の project ID>:PJR-XXXXへ変換して渡す。別名は呼び出し元の設定に閉じた識別子であり、相手側が参照を検証でき、設定名を変更しても記録の意味が変わらない実 project ID を正本として残すためである。orchestrator launchの編集許可へ、選択 project のreposに加えて宣言済みの外部リポジトリを追加した。外部 project の状態遷移は委譲せず、相手のリポジトリでの実行を案内する。- 設定 schema、設定リファレンス、CLI コマンドリファレンス、登録簿運用ガイド、CHANGELOG を更新し、設定検証・引数組み立て・起票委譲・編集許可のテストを追加した。
- 残課題はない。統合後に PJR-JSEY で
exec run --registerを実行する確認は runner とオーケストレーターが行う。
5. 関連ドキュメント
- PJR-W93C（同じリポジトリの中の別の project への起票）
- PJR-SAZC（
orchestrator launchによるreposの許可）