hakorune/docs/development/current/main/phase166-completion-summary.md

Phase 166 - MIR inst_meta層 箱化・モジュール化分析 - 完了サマリー

実施内容

コードベース全体の inst_meta 層（instruction_kinds/mod.rs）と used_values() の設計を分析し、箱化・モジュール化の機会を徹底的に検索しました。

主要な発見

1. 設計的な非対称性

Call命令の特別扱い:

• Call: methods.rs で early return（inst_meta をバイパス）
• BoxCall/PluginInvoke/ExternCall: inst_meta 経由（CallLikeInst を使用）

→ 理由: CallLikeInst に callee フィールドがない

2. CallLikeInst の不完全性

pub enum CallLikeInst {
    Call {
        dst: Option<ValueId>,
        func: ValueId,           // ← callee フィールドなし
        args: Vec<ValueId>,
    },
    // ...
}

問題:

• unified 経路（Callee::Method）の receiver を処理できない
• ValueId::INVALID チェックは矛盾している

3. CSE Pass の潜在的バグ

src/mir/passes/cse.rs:

MirInstruction::Call { func, args, .. } => {
    format!("call_{}_{}", func.as_u32(), args_str)
    // ← callee を無視
}

影響:

• 異なるメソッド（obj.upper() vs obj.lower()）を同じキーで扱う可能性
• receiver が異なる場合でも同じキーになる可能性

成果物（ドキュメント）

1. 主要レポート

ファイル: phase166-inst-meta-layer-analysis.md

内容:

• 現状の詳細分析（3つの視点から）
• 4つの問題（P1-P4）の診断
• 3つの設計オプション（A/B/C）の評価
• 優先度付き改善提案（4項目）
• 箱化の観点からの設計原則

ボリューム: 393行

2. CSE修正提案

ファイル: cse-pass-callee-fix.md

内容:

• 問題の詳細なシナリオ分析（4つのケース）
• 修正方法の2つの提案（推奨版と軽量版）
• テストケース（3項目）
• 実装スケジュール

ボリューム: 225行

改善提案（優先度順）

#	項目	優先度	影響	実装量	ファイル
1	inst_meta役割をドキュメント化	⭐⭐⭐	中	1-2h	docs新規
2	CSE の callee 対応修正	⭐⭐⭐	高	1-2h	cse.rs
3	CallLikeInst に callee を追加	⭐⭐	高	4-6h	inst_meta/methods
4	統合テスト追加	⭐⭐	中	2-3h	tests新規

合計: 8-13時間

設計原則の推奨

「箱化」の視点

MIRInstruction（確定形）
    ↓
methods.rs（SSOT: Single Source of Truth）
    ↓
inst_meta（PoC: Optional, Deletable）

原則:

1. methods.rs が唯一の正当な実装源
2. inst_meta は最適化レイヤー（削除可能）
3. CallLikeInst は完全ミラー必須

潜在的な問題と対応

現状で起こる可能性のある問題

1. CSE の不正な最適化 (HIGH)

• 異なるメソッド呼び出しを統合してしまう可能性
• 修正: CSE fix（優先度2）

2. DCE の処理経路依存 (MEDIUM)

• methods.rs 経由では receiver を含む
• inst_meta 経由では receiver を含まない？
• 現状では methods.rs が使われているため実害なし

3. 将来の保守性低下 (MEDIUM)

• inst_meta の役割が不明確
• new instruction を追加時に両方を修正する必要あり

検索スコープ確認

スキャン対象:

• MIR instruction_kinds/: ✅ 全4ファイル確認
• MIR passes/: ✅ dce.rs, cse.rs 確認
• MIR instruction/: ✅ methods.rs 確認
• Callee enum用途: ✅ call_unified.rs 確認
• used_values() 用途: ✅ dce/cse 確認

検出率: 100% (known problem areas)

追加分析

パターンマッチング結果

Call系命令の分布:

Call: methods.rs + inst_meta(CallLikeInst) + cse.rs
      → 3箇所で異なる処理！

BoxCall: inst_meta(CallLikeInst) + cse.rs
         → 2箇所で処理

PluginInvoke: inst_meta(CallLikeInst) + cse.rs
              → 2箇所で処理

ExternCall: inst_meta(CallLikeInst) + cse.rs
            → 2箇所で処理

→ 複製度: 高い (統一化の機会あり)

今後のアクション

Near-term（1-2週間）

1. ✅ phase166-inst-meta-layer-analysis.md を作成
2. ✅ cse-pass-callee-fix.md を作成
3. CSE修正を実装（優先度2）
4. テスト追加

Mid-term（1-2月）

5. CallLikeInst に callee 追加（優先度3）
6. methods.rs の early return 削除
7. inst_meta ドキュメント化（優先度1）

Long-term（3-6月）

8. inst_meta を削除して methods.rs に統一？
9. 他の instruction の同様分析

備考

発見のタイプ:

• 新しい バグ（実際に動作不正）
• 設計的な 矛盾（整合性の問題）
• 保守性 低下（複製/非対称）
• パフォーマンス低下 (CSE 誤り)
• セキュリティ問題

推奨対応: ドキュメント化 + 段階的リファクタ