PJR-0XXZ pjr-indexへ登録日列を追加しタイムゾーン設定を導入する
1. 概要
pjr-index.mdにはID採番順序が失われた(英数字ランダムID化)ため起票順を追える列がない。登録日列(YYYY-MM-DD)を追加し、register add実行時に自動記入する。日付計算はOS/コンテナのTZに依存させず、SpecDojoRunConfigに registerdate_timezone(既定UTC)を追加してIntl.DateTimeFormatで明示解決する。既存の完了日デフォルトも同じヘルパーへ統一する。手動でpjr-index.mdを直接編集する場合は不明なら_TODOのままでよい(既存の担当・期限と同じ運用)。
prj-0001:pjr-0163-register-add-id-fetch でPJR-IDを数字4桁連番から英数字4桁ランダムへ変更した結果、ID自体から起票の前後関係を読み取れなくなった。pjr-index.mdには登録日に相当する列がなく、追記方式による行の物理的な並び順だけが起票順の手がかりになっている。行順は現行のregister add（追記）・register renumber・状態遷移コマンド（同一行を書き換えるのみで並べ替えない）では崩れないことを確認済みだが、手動編集や将来の並べ替えに対して脆弱なため、明示的な「登録日」列を追加する。日付計算はOS/コンテナのタイムゾーン設定に依存させず、プロジェクト設定で明示的に指定できるようにする。
2. 完了条件
pjr-index.mdの登録項目一覧に「登録日」列（YYYY-MM-DD、時刻・タイムゾーン表記なし）が追加され、pjr-rulebook・スキーマに反映されている。register add実行時に登録日が自動記入される。SpecDojoRunConfig（src/specdojo-config.ts）にregister_date_timezone（IANAタイムゾーン名、既定値UTC）を追加し、.specdojo/specdojo.config.jsonのprojects.<project-id>.run配下で設定できる。- 日付生成は
Intl.DateTimeFormatのtimeZoneオプション等でタイムゾーンを明示指定し、実行環境のOS/コンテナのTZ環境変数には依存しない共通ヘルパーとして実装されている。 - 既存の「完了日」のデフォルト生成（現状UTC固定の
new Date().toISOString().slice(0, 10)）も同じ共通ヘルパーに統一され、登録日・完了日で計算基準が一致している。 pjr-index.mdを直接手編集する場合、登録日が不明なら空欄にせず_TODO_と書けばよい（既存の担当・期限と同じ運用）ことが運用ガイドに明記されている。- 既存項目（登録日列を持たない過去の行）に対する移行方針（例: 一律
_TODO_、または取得可能な場合はgit履歴から補完するか等）が決まっている。 - 自動テストで、タイムゾーン設定あり/なし双方の日付生成、登録日列の自動記入、完了日との整合が確認できる。
- 運用ガイド・コマンドリファレンス・config関連ドキュメントに変更点が反映されている。
3. 作業内容
| No | 作業 | 担当 | 状態 | メモ |
|---|---|---|---|---|
| 1 | pjr-index.md・schema・rulebookへ「登録日」列を追加する | ARC | done | 担当と期限の間へYYYY-MM-DD形式の列を追加 |
| 2 | SpecDojoRunConfigへregister_date_timezone（既定UTC）を追加する | ARC | done | register_integration_branchと同じ配置・記述スタイル |
| 3 | タイムゾーン明示指定の共通日付ヘルパーを実装し、登録日・完了日双方へ適用する | ARC | done | src/register-date.tsに集約、Intl.DateTimeFormat使用 |
| 4 | 既存項目の移行方針を決めて適用する | ARC | done | 過去分は一律_TODO_（正確な起票日は復元しない） |
| 5 | 自動テストを追加し、運用ガイド・コマンドリファレンスへ反映する | ARC | done | 手動編集時の_TODO_運用も明記 |
4. 対応結果
pjr-index.mdの登録項目一覧に「登録日」列（担当と期限の間、YYYY-MM-DDまたは未確定は_TODO_）を追加し、pjr-index-content.schema.yaml（optional_columns・column_rules）とpjr-rulebook（標準列・記述ガイド）、pjr-index-template.mdに反映した。SpecDojoRunConfigへregister_date_timezone（IANAタイムゾーン名、既定UTC）を追加し、.specdojo/specdojo.config.jsonのprojects.<project-id>.run配下で設定できるようにした。- タイムゾーンを
Intl.DateTimeFormatのtimeZoneオプションで明示解決する共通ヘルパーsrc/register-date.ts（formatDateInTimeZone/todayInTimeZone/resolveRegisterDateTimeZone）を新設し、OS/コンテナのTZ環境変数に依存させない。 register addは登録日を自動記入（--registeredで上書き可）し、register close/register rejectの完了日デフォルトも同じヘルパーへ統一して計算基準を一致させた（従来のnew Date().toISOString().slice(0,10)固定UTCを置換）。- 既存全行（列導入前の過去分）は一律
_TODO_で移行し、手動編集時も不明なら_TODO_とする運用をregister-operation-guide・command-referenceへ明記した。 - タイムゾーン設定あり/なし双方の日付生成、登録日列の自動記入・列位置、登録日と完了日の計算基準一致を自動テスト（
register-date.test.tsほか）で確認した。