plan-rename — Plan Mode Session Auto-Rename Hook

Plan Mode 結束時自動從計畫的 H1 標題重新命名 session，並透過 sidecar 機制在 compaction 後自動修復名稱。

How It Works

三個 shell 腳本協作：

1. plan-rename-hook.sh（PreToolUse ExitPlanMode）：擷取計畫 H1 標題，寫入 sidecar 備份檔（pending: true）。不直接寫入 JSONL — 避免使用者 reject plan 時產生閃爍
2. plan-rename-guard.sh（Stop hook）：每次 Claude 回應後檢查：
   • Phase 1 — Pending 確認：sidecar pending 時，掃描 JSONL 確認 ExitPlanMode 是否被 accept。被 reject 則跳過，accepted 才寫入 custom-title
   • Phase 2 — 兜底修復：sidecar confirmed 但 JSONL 缺少 custom-title 時，重新注入（安全網，正常情況由 compact hook 處理）
3. plan-rename-compact.sh（SessionStart compact）：compaction 後專門觸發：
   • 讀取 confirmed sidecar → 掃描 JSONL 尾部 → 缺少 custom-title 則重新注入
   • 順帶清理 mtime > 30 天的 sidecar（跳過 _pending_*）

流程圖