hakorune/docs/development/current/main/phase61-5-summary.md

Phase 61-5: If PHI 削減計画策定 - サマリー

目的

Phase 61-3 で JoinIR 経路による If-in-Loop PHI 生成が完全動作したため、既存の If PHI 関数群を整理し、削減計画を策定する。

---

実施内容（4ステップ完了）

Phase 61-5.1: If PHI 関数リスト作成 ✅

• 成果物: phase61-5-1-if-phi-function-list.md
• 内容: If PHI 関連の全関数を 3 カテゴリに分類
  • PhiBuilderBox系: 4関数（set_if_context, generate_if_phis 等）
  • JoinIR Lowering系: 14関数（try_lower_if_to_joinir, find_if_pattern 等）
  • 補助系: 8関数（IfPhiContext, PhiSpec, Conservative 等）
• 合計: 26関数をリスト化

Phase 61-5.2: JoinIR カバレッジ調査 ✅

• 成果物: phase61-5-2-if-phi-coverage-table.md
• 内容: 各関数の JoinIR カバレッジを調査
  • in_loop: 完全カバー済み（18関数）
  • partial: 部分カバー（5関数）
  • none: 未カバー（3関数）
• 重要発見: If-in-Loop PHI は JoinIR で 100% カバー達成済み

Phase 61-5.3: 優先度表作成 ✅

• 成果物: phase61-5-3-if-phi-priority-table.md
• 内容: カバレッジ調査を基に削減優先度を設定
  • P1（最優先）: 18関数 - 薄いラッパー、既に JoinIR で完全カバー
  • P2（次期候補）: 5関数 - JoinIR 拡張で統合可能
  • P3（将来候補）: 3関数 - 型システム統合待ち

Phase 61-5.4: 次フェーズ候補選定 ✅

• 成果物: phase61-5.4-next-phase-candidates.md
• 内容: Phase 61-6 で削減する 3 個の候補を選定
  1. set_if_context 削除（P1, 11行）- 最優先、最も安全
  2. If Lowering dev フラグ削除（P1, 15行）- デフォルト有効化
  3. A/B テスト観察関数削除（P2, 50行）- 最も削減効果が高い

---

Phase 61-6 実装計画

Wave 1: P1 薄いラッパー削除（26行削減）

1. set_if_context 削除
   • loop_builder/if_lowering.rs:259-262 で直接 IfPhiContext::for_loop_body() 呼び出しに置き換え
   • リスク: 低
2. If Lowering dev フラグ削除
   • joinir_if_select_enabled() チェック削除、デフォルト有効化
   • リスク: 中（全テスト PASS 必須）

Wave 2: P2 A/B テスト削除（50行削減）

1. extract_phi_spec_from_builder, compare_and_log_phi_specs 削除
   • if_lowering.rs の A/B 比較ロジック削除
   • if_phi_spec.rs は compute_phi_spec_from_joinir() のみ残す
   • リスク: 低（観察専用関数）

期待削減効果

• 合計: 76行削減
• JoinIR SSOT: PhiBuilderBox 経路の観察コード完全削除
• カバー率: If-in-Loop PHI 100% JoinIR 化完了

---

保留候補（Phase 61-7+ で検討）

P2 大型統合（145行削減見込み）

1. compute_modified_names_if: 変更変数検出を JoinIR に統合（~75行）
2. get_conservative_if_values: incoming 値解決を PhiSpec に移行（~70行）

保留理由

• Phase 61-6 では最小限の削除に集中（リスク最小化）
• P2 大型統合は Phase 61-7 で慎重に実装

---

技術的成果

1. If PHI 関数の完全インベントリ作成

• 26関数の全体像を把握
• 責務とカバレッジを明確化
• 削減優先度を定量的に決定

2. JoinIR カバレッジ 100% 達成確認

• If-in-Loop PHI は JoinIR で完全カバー
• PhiBuilderBox 経路は観察用のみ
• SSOT を JoinIR 側に完全移行済み

3. 段階的削減計画の確立

• P1（薄いラッパー）→ P2（統合）→ P3（型システム）の 3 段階
• Wave 1（26行）→ Wave 2（50行）→ Phase 61-7（145行）の段階的実装
• リスク最小化と削減効果のバランス

---

実装時の原則

1. Fail-Fast: エラーは即座に失敗、フォールバック禁止
2. 決定的順序: BTreeSet/BTreeMap で ValueId 割り当ての決定性保証
3. 箱理論: SSOT を JoinIR 側に寄せる、PhiBuilderBox は最小限に
4. テスト: 各ステップで全 JoinIR tests PASS を確認（268 tests）
5. ドキュメント: PHI_BOX_INVENTORY.md と CURRENT_TASK.md を更新

---

関連ドキュメント

Phase 61-5 成果物

• phase61-5-1-if-phi-function-list.md
• phase61-5-2-if-phi-coverage-table.md
• phase61-5-3-if-phi-priority-table.md
• phase61-5.4-next-phase-candidates.md

関連 Phase

• Phase 61-1: if_phi_context.rs - If PHI Context 設計
• Phase 61-2: if_phi_spec.rs - PHI Spec 抽象化
• Phase 61-3: if_in_loop/mod.rs - If-in-Loop PHI Emitter
• Phase 61-4: phase61-4-toplevel-if-design.md - Toplevel If PHI 設計
• PHI Inventory: PHI_BOX_INVENTORY.md

---

次のステップ

即座に実装可能（Phase 61-6）

1. set_if_context 削除（11行、リスク低）
2. If Lowering dev フラグ削除（15行、リスク中）
3. A/B テスト観察関数削除（50行、リスク低）

合計削減見込み: 76行

期待成果: JoinIR SSOT 確立、PhiBuilderBox 観察コード完全削除