legacy hook 経路（Claude Code < 2.1.89 対応）の退役 — 2026-10 以降の最初の minor

[okash1n]

背景

#120（v0.70.0）で legacy hook 経路の退役マイルストーンを宣言した。Claude Code 2.1.89（2026-04 リリース）未満向けの legacy フラグメント生成は、CLI 自動更新により対象人口が急速に縮小しているが、ピン留め環境向けガードレールとして当面維持する。

退役条件

2.1.89 リリースから 6 ヶ月後（2026-10）以降の最初の minor リリースで「サポート最小 Claude Code バージョン >= 2.1.89」を宣言し、以下を削除する。

削除対象

• features/auto-update/hooks.legacy.json
• features/pr-creation-log/hooks.legacy.json
• lib/deploy.sh の _claude_cli_semver / _claude_supports_async_hooks / _versioned_hooks_fragment（fragment 取得は hooks.json 直接参照に簡約。_claude_supports_async_hooks を将来の別バージョンゲートに使う場合は残置可）
• features/auto-update/scripts/auto-update.sh の AUTO_UPDATE_LEGACY / LEGACY_CACHE_FILE / LEGACY_CACHE_TTL / _auto_update_legacy_cache_fresh / _auto_update_touch_legacy_cache
• features/pr-creation-log/scripts/log-pr.sh の PR_CREATION_LOG_LEGACY 分岐
• lib/update.sh の require_session_end 分岐（常に true 化）
• 対応する legacy テストケース（test-runtime-hooks.sh / test-pr-creation-log.sh / test-auto-update.sh / test-hook-fixtures.sh）

削除後も 1〜2 リリース残すもの

• .starter-kit-update-cache の掃除コード（setup.sh / uninstall.sh / lib/dryrun.sh / lib/deploy.sh cleanup_paths）— 旧環境の残骸掃除のため

削除時の追随

• README.md の互換性記述を宣言済み最小バージョン表記へ更新

Refs #120 #121

[loadbalance-sudachi-kun]

ステータス確認（2026-08-20・定期チェック）

退役条件「2.1.89 リリース（2026-04）から 6 ヶ月後 = 2026-10 以降の最初の minor リリース」は未到来のため、今回は着手しない（defer 継続）。

• 削除対象一覧（hooks.legacy.json ×2 / lib/deploy.sh の _claude_cli_semver 系 / auto-update・pr-creation-log の LEGACY 分岐 / lib/update.sh の require_session_end 分岐 / legacy テストケース）は現行 main でも本文記載のまま有効であることを確認済み。
• 次アクション: 2026-10 以降の最初の minor リリースに同梱。その際 README の互換性記述を「サポート最小 Claude Code >= 2.1.89」へ更新し、.starter-kit-update-cache 掃除コードは 1〜2 リリース残置する。

[loadbalance-sudachi-kun]

現状確認（2026-08-31）

退役条件は「2.1.89 リリース（2026-04）から 6 ヶ月後（2026-10）以降の最初の minor リリース」。現時点は 2026-08-31 で、条件成立まで約 1 ヶ月あるため、本 issue はまだ着手しない。

補足として、条件成立時に確認しておくとよい点を記録しておく。

• 現行の開発環境の CLI は 2.1.251 で、閾値の 2.1.89 を大きく上回っている。ただし退役条件はピン留め環境向けの猶予として暦ベースで定義されているため、手元のバージョンが進んでいることは着手の根拠にならない
• _claude_supports_async_hooks は lib/update.sh の _check_auto_update_health からも参照されている（require_session_end の判定）。legacy 経路の削除時にこの分岐（常に true 化）を忘れないこと。auto-update hook が登録済みでも「自動更新は無効です」と誤警告される（jq -e の複数出力による順序依存） #161 の修正でこの関数の周辺に手を入れているため、マージ後の状態を基準に差分を取ること
• 削除対象に挙がっている _versioned_hooks_fragment（lib/deploy.sh）は、hooks.json と hooks.legacy.json を選択する唯一の経路。tests/unit/test-auto-update.sh の legacy ケース（2.1.88 を返す mock CLI を PATH に置くもの）がこれに依存している
• hooks.legacy.json と hooks.json はエントリの形が異なるため、CLI を 2.1.89 の境界をまたいで更新した既存インストールでは、非対話更新で kit の hook エントリが重複する（_merge_arrays_3way の完全一致比較 + 無条件 union） #163（_merge_arrays_3way の完全一致比較）と同じ経路で hook が重複しうる。legacy 退役の作業前に 非対話更新で kit の hook エントリが重複する（_merge_arrays_3way の完全一致比較 + 無条件 union） #163 が入っていることを前提にするのが安全