hakorune/docs/development/current/main/phase84-index.md

Phase 84: PHI 型推論完全箱化プロジェクト — 完全ガイド

📚 ドキュメント索引

Phase 84-3 完了報告（最新）

1. Phase 84-3 サマリー ⭐ 最優先

   • 削減実績: 9件 → 4件（56%削減）
   • PhiTypeResolver 実装成果
   • Phase 84-4 への推奨

2. 残り 4件の完全調査

   • 各テストの詳細分析
   • 失敗パターン分類
   • なぜ PhiTypeResolver で解決できないか

3. Phase 84-4 実装推奨

   • BoxCall 型情報登録の実装方法
   • dev フォールバック実装
   • Await 型情報特殊処理

Phase 84-2 記録（参考）

4. Case D 残り 9件の調査

   • Phase 84-2 時点の分析
   • GroupA/B/C 分類
   • CopyTypePropagator 実装提案

5. Phase 84-2 詳細分析

   • 12件 → 9件削減の詳細
   • テスト別失敗パターン

初期調査（アーカイブ）

6. Case D インデックス
   • Phase 84-1 の初期調査
   • 12件の失敗パターン発見

🎯 Phase 84 の全体像

目標

if_phi.rs レガシーフォールバックの完全削除

• 初期状態: 12件の Case D 失敗
• 現在: 4件（67%削減達成）
• 最終目標: 0件（100%削減）

実装ロードマップ

Phase 82: フォールバック検出実装
  ↓ (Case D: 12件検出)
Phase 84-1: 初期調査・パターン分類
  ↓
Phase 84-2: CopyTypePropagator 実装
  ↓ (12件 → 9件, 25%削減)
Phase 84-3: PhiTypeResolver 実装 ✅ 完了
  ↓ (9件 → 4件, 56%削減)
Phase 84-4: BoxCall/Await 型情報登録 ⏳ 次のステップ
  ↓ (4件 → 0件 目標)
Phase 84-5: if_phi.rs 完全削除
  ↓
✨ 型推論システム完全箱化達成

📊 削減実績の詳細

Phase 別削減内訳

Phase	実装内容	削減件数	残存件数	削減率	累積削減率
Phase 82	初期検出	-	12件	-	-
Phase 84-2	CopyTypePropagator	3件	9件	25%	25%
Phase 84-3	PhiTypeResolver	5件	4件	56%	67%
Phase 84-4	BoxCall/Await 型登録	4件（目標）	0件（目標）	100%	100%

パターン別解決状況

パターン	件数（初期）	Phase 84-2 後	Phase 84-3 後	Phase 84-4 目標
GroupA: Loop 制御フロー	7件	7件	0件 ✅	0件
GroupB: Stage1Cli 複雑型推論	2件	2件	2件	0件 🎯
GroupC: await 特殊構文	1件	1件	1件	0件 🎯
GroupD: QMark 特殊構文	0件	0件	1件（新規）	0件 🎯
合計	10件	10件	4件	0件

🔬 技術的成果

Phase 84-3 で実装した箱

PhiTypeResolver (src/mir/phi_core/phi_type_resolver.rs)

責務: PHI + Copy グラフを辿って、安全に型を決められるときだけ MirType を返す

アルゴリズム:

1. DFS/BFS で root から探索開始
2. Copy → src へ進む
3. Phi → 各 incoming ValueId へ進む
4. それ以外（Const/Call/BoxCall/NewBox...）は base 定義
5. base_types 集合を収集し、1 種類なら返す

安全装置:

• visited セットで同じ ValueId を 2 回以上辿らない（ループ防止）
• 探索上限で打ち切り（max_visits）

箱理論の実現

[型生成レイヤー] - 型を作る
  ├─ emit_const()
  ├─ emit_box_call()       ← Phase 84-4-B で型登録を追加
  └─ build_await_expression() ← Phase 84-4-C で型登録を追加

[型伝播レイヤー] - 型を広げる
  ├─ CopyTypePropagator    ← Phase 84-2
  └─ PhiTypeResolver       ← Phase 84-3 ✅

[統合レイヤー] - 全体を調整
  └─ GenericTypeResolver

[レガシー] - 削除予定
  └─ if_phi.rs フォールバック ← Phase 84-5 で削除

🎯 Phase 84-4 実装ガイド

推奨実装順序

ステップ1: dev フォールバック（0.5日）

目的: 開発環境の即座のアンブロック

実装: src/mir/builder/lifecycle.rs

if should_enable_dev_fallback() {
    if is_base_definition_with_missing_type(function, ret_val) {
        return Ok(MirType::Unknown);
    }
}

環境変数: NYASH_PHI_DEV_FALLBACK=1

ステップ2: BoxCall 型情報登録（1-2日）

目的: GroupB（2件）+ GroupD（1件）の根本解決

実装: src/mir/builder/builder_calls.rs

pub fn emit_box_call(...) -> Result<ValueId, String> {
    let dst = self.next_value_id();
    self.emit_instruction(MirInstruction::BoxCall { ... })?;

    // 新機能: 戻り値型を推論して登録
    if let Some(ret_ty) = self.infer_boxcall_return_type(box_val, method, &args) {
        self.value_types.insert(dst, ret_ty);
    }

    Ok(dst)
}

ステップ3: Await 型情報特殊処理（0.5日）

目的: GroupC（1件）の暫定解決

実装: src/mir/builder/stmts.rs

pub(super) fn build_await_expression(...) -> Result<ValueId, String> {
    let result_id = self.next_value_id();

    // 新機能: Unknown として型登録
    self.value_types.insert(result_id, MirType::Unknown);

    self.emit_instruction(MirInstruction::Await { ... })?;
    Ok(result_id)
}

検証方法

# ステップ1 完了確認
NYASH_PHI_DEV_FALLBACK=1 NYASH_PHI_FALLBACK_DISABLED=1 cargo test --release --lib 2>&1 | grep "Case D"
# 期待: 出力なし

# ステップ2 完了確認
NYASH_PHI_FALLBACK_DISABLED=1 cargo test --release --lib 2>&1 | grep "Case D" | wc -l
# 期待: 1（await のみ）

# ステップ3 完了確認
NYASH_PHI_FALLBACK_DISABLED=1 cargo test --release --lib 2>&1 | grep "Case D" | wc -l
# 期待: 0（全件解決）

📝 関連ファイル

実装ファイル

• src/mir/phi_core/phi_type_resolver.rs - Phase 84-3 実装
• src/mir/phi_core/copy_type_propagator.rs - Phase 84-2 実装
• src/mir/join_ir/lowering/generic_type_resolver.rs - 統合調整
• src/mir/builder/lifecycle.rs - 型推論エントリーポイント
• src/mir/join_ir/lowering/if_phi.rs - 削除予定レガシー

Phase 84-4 で修正するファイル

• src/mir/builder/lifecycle.rs - dev フォールバック追加
• src/mir/builder/builder_calls.rs - BoxCall 型登録追加
• src/mir/builder/stmts.rs - Await 型登録追加

🚀 次のアクション

優先度1: Phase 84-4-A 実装（即実装推奨）

目的: 開発環境の即座のアンブロック

実装時間: 0.5日

参考: Phase 84-4 実装推奨

優先度2: Phase 84-4-B 実装（根本解決）

目的: BoxCall 型情報の完全追跡

実装時間: 1-2日

参考: Phase 84-4 実装推奨

優先度3: Phase 84-4-C 実装（完全解決）

目的: Await 型情報の暫定対応

実装時間: 0.5日

参考: Phase 84-4 実装推奨

Phase 84-5: if_phi.rs 削除（最終ゴール）

前提条件: Phase 84-4 完了（Case D = 0件）

実装内容:

1. src/mir/join_ir/lowering/if_phi.rs 完全削除（約 300行）
2. GenericTypeResolver の if_phi 呼び出し削除
3. lifecycle.rs の Case D 処理を全て削除
4. ドキュメント更新: Phase 82-84 完了宣言

📈 進捗追跡

現在の状態

• ✅ Phase 82: フォールバック検出実装
• ✅ Phase 84-1: 初期調査・パターン分類
• ✅ Phase 84-2: CopyTypePropagator 実装（25%削減）
• ✅ Phase 84-3: PhiTypeResolver 実装（56%削減）
• ⏳ Phase 84-4: BoxCall/Await 型情報登録（次のステップ）
• 🎯 Phase 84-5: if_phi.rs 完全削除（最終ゴール）

削減進捗

12件 ████████████ 100%
     ▼ Phase 84-2 (-25%)
 9件 █████████    75%
     ▼ Phase 84-3 (-44%)
 4件 ████         33%
     ▼ Phase 84-4 (-33% 目標)
 0件              0% ✨ 完全達成

🎉 まとめ

Phase 84-3 の偉業:

• ✅ PhiTypeResolver 実装完了
• ✅ 56%削減達成（9件 → 4件）
• ✅ GroupA（Loop 制御フロー）完全解決
• ✅ 箱理論に基づく型推論システムの明確化

Phase 84-4 への期待:

• 🎯 BoxCall/Await 型情報登録による根本解決
• 🎯 残り 4件の完全解決（67% → 100%）
• 🎯 if_phi.rs レガシー削除準備完了

Phase 84 プロジェクトの意義:

• 🎯 型推論システムの完全箱化
• 🎯 レガシーフォールバック根絶
• 🎯 保守性・拡張性・パフォーマンスの飛躍的向上

次のステップ: Phase 84-4 実装推奨を参照して実装開始！