reminder ファミリー全体ロードマップ（cli / tap / server / dashboard）

[yancya]

これは何

reminder ファミリー4リポジトリの全体ロードマップ。各リポジトリの実行タスク issue はここから辿れる（本文末尾のリンク集参照。作成後に追記）。

対象リポジトリと現状

リポジトリ	役割	現状
reminder-cli	Swift 製 iCloud Reminders CLI。ファミリーの土台	v1.0.1（binary 配布に移行済み）。テストなし
homebrew-reminder-cli	Homebrew tap	⚠️ Formula が v1.0.0 のソースビルドのままで、本体の binary 配布方針と乖離
reminder-server (private)	cli をラップする REST API サーバー（Sinatra 4）	実装は動く状態だがほぼ全ファイル未コミット（消失リスク）
reminder-dashboard (private)	閲覧専用ダッシュボード構想	コミット 0。旧設計書と、reminder-server の重複コード（backend/）のみ

server / dashboard の統合判断（提案）

提案: reminder-server に統合し、dashboard はサルベージ後アーカイブ。

根拠:

• dashboard の backend/ は reminder-server の旧バージョンの重複（役割が完全に被っている）
• dashboard の設計書が想定する Node/Express + React + Vite スタックは未着手。閲覧専用 UI に SPA スタックは過剰
• reminder-server（Sinatra）が / で静的な閲覧 UI を配信すれば設計書の要件（一覧・詳細・フィルタ・ソート）は満たせる
• リポジトリが1つ減り、launchd 常駐・公開も1サービスで済む

代替案（分離維持）を選ぶ場合も、dashboard の backend/ 削除と設計書の全面書き直しは必須。判断はユーザーに委ねるが、タスク issue は統合前提で切ってある。

優先順位

P1 — 壊れている / 消失リスク

1. tap の Formula を v1.0.1 binary 配布に更新（homebrew-reminder-cli）
2. reminder-server の未コミット実装を commit & push（reminder-server）

P2 — 品質基盤（後方互換を守るための足場）
3. reminder-cli にテストスイート導入 + CI（reminder-cli）
4. reminder-server にテスト導入 + CI（reminder-server）
5. reminder-cli の変更系コマンドに --format json 追加（reminder-cli）
6. ↑完了後、reminder-server の正規表現パースを JSON 化（reminder-server）

P3 — 機能・運用
7. reminder-server を launchd 常駐 + tailnet 内公開に（reminder-server）
8. 閲覧ダッシュボード UI を reminder-server に実装（reminder-server）
9. reminder-cli に lists サブコマンド追加（reminder-cli）
10. リリース時の tap 自動更新（reminder-cli → homebrew-reminder-cli）

P4 — 整理
11. dashboard の未コミット資産の棚卸しと移管（reminder-dashboard）
12. dashboard リポジトリのアーカイブ判断（reminder-dashboard）

後方互換ポリシー（ファミリー共通）

• reminder-cli は日常運用（自動化スクリプト・server）から常用されているため、既存コマンドのデフォルト出力・既存フラグの挙動は変えない。機能追加はオプトイン（新フラグ・新サブコマンド）のみ
• バージョンは semver。出力フォーマット変更を伴う場合は minor 以上を上げる
• server の API は /api/v1 名前空間を維持。破壊的変更は /api/v2

タスク issue リンク集

reminder-cli

• テストスイート導入 + CI（swift test を回せるようにする） #4 — テストスイート導入 + CI（P2-3）
  • sub: テスト基盤導入: Package.swift に testTarget を追加し OutputFormatter の最初のテストを通す #8（テスト基盤）→ OutputFormatter・日付パース・ソート比較のユニットテスト拡充（必要なら純粋関数切り出し） #9（テスト拡充）→ GitHub Actions CI 新設（swift build + swift test）+ README Development 追記 #10（CI 新設）
• 変更系コマンド（create/update/complete/delete）に --format json を追加 #5 — 変更系コマンドに --format json（P2-5）
• lists サブコマンド追加（リマインダーリスト一覧の取得） #6 — lists サブコマンド追加（P3-9）
• リリース時に Homebrew tap の Formula を自動更新する #7 — リリース時の tap 自動更新（P3-10、close。push型からpull型に方針転換、後継は homebrew-reminder-cli#6）
  • sub: release.yml に tap Formula 自動更新ステップを実装（テンプレート全文生成方式） #11 / 【人間作業】TAP_GITHUB_TOKEN 用 Fine-grained PAT の発行とシークレット登録 #12 / tap 自動更新の end-to-end 検証（v1.1.0 リリースに同乗） #13 いずれもclose（push型前提のため不要に）
• Release v1.1.0: 変更系 --format json + lists サブコマンド（tap 自動更新の初回 e2e を兼ねる） #14 — Release v1.1.0 調整（変更系コマンド（create/update/complete/delete）に --format json を追加 #5 + lists サブコマンド追加（リマインダーリスト一覧の取得） #6 同乗。tap自動更新はpull型のため依存解消、tag pushはユーザー判断待ち）

homebrew-reminder-cli

• Formula を v1.0.1 バイナリ配布に更新する（現在 v1.0.0 ソースビルドのまま乖離） homebrew-reminder-cli#1 — Formula を v1.0.1 バイナリ配布に更新（P1-1・close済み）
• Formula 検証 CI を追加（brew audit / style / install / test） homebrew-reminder-cli#2 — Formula 検証 CI（P2 相当）
• Intel Mac (x86_64) 対応方針を決める homebrew-reminder-cli#3 — Intel Mac (x86_64) 対応方針の決定（P4 相当・方針決定は人間、homebrew#1 の後）
• スケジュールworkflowでreminder-cliの最新ReleaseをpollしてFormulaを自動更新する（pull型・secretless） homebrew-reminder-cli#6 — tap 自動更新（pull型・secretless、P3-10 の後継。旧 cli#7/release.yml に tap Formula 自動更新ステップを実装（テンプレート全文生成方式） #11/【人間作業】TAP_GITHUB_TOKEN 用 Fine-grained PAT の発行とシークレット登録 #12/tap 自動更新の end-to-end 検証（v1.1.0 リリースに同乗） #13、homebrew#4 の後継issue）
  • ⚠️ homebrew-reminder-cli#4（旧 push型の受け入れ整備）は前提が崩れているため要close判断（ユーザー未確認）

reminder-server（private）

• yancya/reminder-server#1 — 未コミット実装のコミット & push（P1-2・最優先）
• yancya/reminder-server#2 — テスト整備 + CI（P2-4）
• yancya/reminder-server#3 — launchd 常駐 + Tailscale VIP Service 化（P3-7）
• yancya/reminder-server#4 — 正規表現パースの JSON 化（P2-6、cli#5 に依存）
• yancya/reminder-server#5 — 閲覧ダッシュボード UI（P3-8、統合の受け皿）

reminder-dashboard（private）

• yancya/reminder-dashboard#1 — 未コミット資産の棚卸しと移管確認（P4-11）
• yancya/reminder-dashboard#2 — アーカイブ判断と実行（P4-12、ユーザー承認必須）

依存関係の要点

• cli#5（変更系 json）→ server#4（パース置換）
• server#5（UI）→ dashboard#1 → dashboard#2（アーカイブ）
• cli#4（テスト基盤）は cli#5 / cli#6 より先に着手推奨（いずれもclose済み）
• tap自動更新はpull型（homebrew#6）に方針転換。reminder-cli側の実装・secret登録は不要になった

[yancya]

reminder-cli 側マイルストーン系列（2026-07-10 計画セッションで整理）

各ステップは Sonnet 5 / Opus 4.8 が1セッションで完遂できる粒度に分解済み。

順	マイルストーン	issue	備考
M1	テスト基盤 + CI	#8 → #9 → #10（親 #4）	直列。M2 の前提
M2	v1.1.0 機能実装	#5, #6	相互独立・並行可（どちらも #8 完了が前提）
M3	tap 自動更新の実装	#11（親 #7）	homebrew-reminder-cli#1 完了が前提
M3'	PAT 発行・登録	#12	人間作業。他と無依存で今すぐ実施可
M4	v1.1.0 リリース	#14（#13 を兼ねる）	RC ワークフロー。tag push が tap 自動更新の初回 e2e になる

クリティカルパス: #8 → #9 → #10 → (#5 ∥ #6) → #14。#11・#12 は M1/M2 と並行で進められる。

[yancya]

reminder-server 側の実行計画を milestone 化した（2026-07-10）

最大目標 = 「iPad/iPhone から https://reminder.tail14ac5.ts.net/ でリマインダー閲覧ダッシュボードが使える」（P3-7 + P3-8 の合流点）。そこまでの筋道を reminder-server の milestones に落とした。各 issue は1セッション完遂粒度に分解済み。

順	Milestone	issues	備考
M1	品質基盤（テスト + CI）	server#2 = #12 → #13	依存なし・即着手可。全後続の TDD の足場
M2	tailnet 公開	server#3 = #6 → #7	#7 に人間作業あり（Tailscale コンソール承認・EventKit TCC・実機確認）
M3	閲覧ダッシュボード	server#5 = #8 → #9 → #10 / #11	M2 と並行可。M2+M3 完了で最大目標達成
M4	変更系の JSON 化	server#4	⚠️ cli#5 のリリース待ちでブロック中。前提: #13

• server#2 を sub-issue 分解（【人間作業】TAP_GITHUB_TOKEN 用 Fine-grained PAT の発行とシークレット登録 #12: テスト基盤+全エンドポイント rack-test / tap 自動更新の end-to-end 検証（v1.1.0 リリースに同乗） #13: Client 単体+CI+README）
• server#4 の「要確認」だった Client 実装の実態をコード確認して本文に反映（update/complete/delete は {id:} のみ返す簡易処理、execute は JSON 分岐既存 等）
• 下流: M3 完了 → dashboard#1（棚卸し）→ dashboard#2（アーカイブ、ユーザー承認必須）が解禁
• cli 側の推奨順は従来通り: cli#8/OutputFormatter・日付パース・ソート比較のユニットテスト拡充（必要なら純粋関数切り出し） #9/GitHub Actions CI 新設（swift build + swift test）+ README Development 追記 #10（テスト基盤）→ cli#5 → server M4 解禁