PJR-0163 register addのID採番方式見直しと統合ブランチ予約のfetch同期
1. 概要
PJR-IDの採番を数字4桁の連番から、曖昧文字・母音を一部除いた英大文字+数字4桁のランダムIDへ変更する。統合ブランチworktreeへの予約経路(reservePjrIdOnIntegration)はそのまま維持し、予約直前にfetch+ff-only mergeを自動実行して他マシンとの採番ズレを軽減する。push はspecdojoに含めず人間が明示実行する。衝突検知・復旧は新規フォーマットを作らず既存のregister renumberを流用する。
register add を worktree 側から実行して即座に起票したいが、統合ブランチが未同期だと別マシンとの並行起票でIDが衝突しうる。数字4桁連番の代替として検討したダミーID・案3（1項目1ファイル化）・数字乱数（4桁/5桁）はいずれも過剰な改修範囲か実用に耐えない衝突確率だったため、既存の統合ブランチ予約経路（prj-0001:pjr-0138-register-add-on-integration-branch）を維持したまま、ID の文字種変更と fetch 同期の自動化で残存リスクを縮小する。
2. 完了条件
- PJR-ID の乱数部分が、数字4桁から曖昧文字（
ILOU）を除いた32文字セット（英大文字+数字、単一ケース）による4桁のランダムIDへ変更されている。 - 生成した候補が既存IDまたは簡易な不適切語ブロックリストに一致する場合、再抽選してから採用する。
register addが統合ブランチへルーティングする際（--reserve相当の経路）、書き込み前に統合ブランチの worktree でgit fetchとgit merge --ff-onlyを自動実行し、ローカルのpjr-index.mdを最新化してから採番する。- fetch が失敗した場合（オフライン等）は既定で警告のみを表示して処理を継続する。厳密な同期を要求する
--strict-sync相当のオプションで、失敗時に処理を中断できる。 - 統合ブランチが origin から分岐している（ff-only 不可）場合は、書き込みを行わずにエラーで終了し、手動解決を促すメッセージを表示する。
git pushはspecdojoに組み込まず、統合ブランチの worktree パスを返す読み取り専用コマンド（例:register where --integration）とそれを使う npm script（素の git コマンド）側に委譲する。- 衝突が発生した場合の検知・復旧は新規フォーマットを作らず、既存の
register renumber・validate:schema:pjr-indexをそのまま利用できる（ID正規表現PJR-\d{4}を新しい文字種へ拡張するのみ）。 - ID正規表現を参照している箇所（
src/register.ts、src/exec-register.ts、tools/docs/src/remark-md-content.tsなど）が新しい文字種に対応し、既存テストと新規テストが green である。 - 運用ガイド（
register-operation-guide.md4.3節）とコマンドリファレンスに、新しいID形式・fetch自動同期・register where --integrationの使い方が反映されている。
3. 作業内容
| No | 作業 | 担当 | 状態 | メモ |
|---|---|---|---|---|
| 1 | ID生成ロジックを数字4桁連番から英数字4桁ランダムへ変更する | ARC | done | 曖昧文字（I/L/O/U）除外の32文字セット、不適切語ブロックリストと再抽選を実装 |
| 2 | ID正規表現を参照する全箇所を新しい文字種に対応させる | ARC | done | src/register.ts（PJR_ID_RE）、src/exec-register.ts、remark-md-content.ts、pjr-index schema |
| 3 | 統合ブランチ予約経路に fetch + ff-only merge の自動実行を追加する | ARC | done | 失敗時は警告継続、分岐時はエラー中断、--strict-sync で厳密同期 |
| 4 | 統合ブランチworktreeのパスを返す読み取り専用コマンドを追加する | ARC | done | register where --integration を追加。push/pullはspecdojoに含めない |
| 5 | pull/push用のnpm script（素のgitコマンド）を整備する | ARC | done | register:sync-pull / register:sync-push を追加 |
| 6 | 自動テストを追加し、運用ガイド・コマンドリファレンスへ反映する | ARC | done | ID生成・fetch同期・分岐時エラーの代表ケースを検証。ガイド4.3節とリファレンスへ反映 |
4. 対応結果
- ID採番を数字4桁連番から、曖昧文字（
I/L/O/U）を除いた32文字セット（英大文字+数字）による4桁ランダムIDへ変更した（generatePjrId）。生成候補が既存IDまたは不適切語ブロックリストに一致した場合は再抽選する。 - ID正規表現の正本を
src/register.tsのPJR_ID_REに集約し、src/exec-register.tsは同定数を import、tools/docs/src/remark-md-content.tsとpjr-index-content.schema.yamlは同一パターンへ拡張した。旧来の数字4桁IDも新パターンに一致するため後方互換。 - 統合ブランチ予約経路（
reservePjrIdOnIntegration）に、採番直前のgit fetch+git merge --ff-only自動同期（syncIntegrationWorktree）を追加した。fetch失敗は既定で警告継続、--strict-syncで中断、origin分岐（ff不可）は書き込み前にエラー終了する。 - 読み取り専用の
register where --integrationコマンドと、それを使う npm script（register:sync-pull/register:sync-push）を追加した。git pushは specdojo に組み込まず人間が明示実行する。 - 衝突検知・復旧は新規フォーマットを作らず、既存の
register renumberとvalidate:schema:pjr-indexをそのまま利用できる（ID正規表現の拡張のみ）。