dead-code-cleanup

Repowise によるデッドコードのクリーンアップ

Repowise はグラフ分析によってデッドコードを検出します。LLM は不要で、テンプレートからレンダリングされた Wiki でも動作します。

ユーザーからデッドコード／未使用コードについて尋ねられた場合

get_dead_code() を呼び出すと、確信度の段階順に検出結果を取得できます。便利なパラメーター：

• safe_only=true — 削除しても安全であることが確認された検出結果のみ（確信度 >= 0.7）
• kind="unreachable_file" — インポーターのないファイル
• kind="unused_export" — 誰にも使われていない公開シンボル
• kind="zombie_package" — 利用者のいないモノレポのパッケージ
• directory="src/old/" — 特定のディレクトリに限定
• tier="high" — 確信度の高い検出結果のみ（>= 0.8）
• min_confidence=0.7 — リリースに向けたクリーンアップでは、基準値を引き上げます（デフォルトは 0.5）
• group_by="directory" または group_by="owner" — 結果をまとめ、デッドコードがどこに集中しているか、また誰が最も多く所有しているかを確認

検出結果の提示方法

• safe_to_delete: true の検出結果に限り、削除を提案します
• 確信度の低い検出結果は「削除するもの」ではなく、「調査候補」として提示します
• 動的に読み込まれるコード（プラグイン、ハンドラー、アダプター）はデッドコードとして検出される場合がありますが、実際にはそうではないこともあります。Repowise は一般的なパターンを除外しますが、例外もあります

削除する前に

1. ユーザーに確認します。ファイル／シンボル名、確信度スコア、Repowise がデッドコードと判断した理由を提示します。
2. 依存先を再確認するため、get_risk(targets=["path/to/file"]) を呼び出します。
3. 最近変更された「デッド」コードは誤検出の可能性が高くなります。検出結果に最近の Git の更新履歴がある場合は、その点を伝えます。

安全な削除の順序

1. まず到達不能なファイル（ファイル全体の削除で、最もすっきりします）
2. 次に未使用の内部シンボル
3. 最後に未使用のエクスポート（動的インポートの可能性があるため、誤検出のリスクが最も高くなります）