hakorune/docs/development/roadmap/phases/phase-11.8_mir_cleanup/README.md

Phase 11.8: MIR命令セット究極整理 - Core-13への道

🎯 概要

ChatGPT5さんの深い洞察「MIRは接着剤、Boxが世界」を実現する究極のMIR整理。 現在の26命令 → Core-15 → Core-14（Phase 12）→ **Core-13（最終目標）**への段階的削減。

基本哲学

• MIR = マイクロカーネル: 最小限の制御と計算のみ
• Box = すべての実データと操作: Everything is Box の究極形
• ExternCall = システムコール: 外界との最小インターフェース

📊 現状分析

現在のCore-15（Phase 11.7）

基本演算(5): Const, UnaryOp, BinOp, Compare, TypeOp
メモリ(2): Load, Store
制御(4): Branch, Jump, Return, Phi
Box(3): NewBox, BoxCall, PluginInvoke
配列(2): ArrayGet, ArraySet
外部(1): ExternCall

Core-14（Phase 12予定）

基本演算(5): Const, UnaryOp, BinOp, Compare, TypeOp
メモリ(2): Load, Store
制御(4): Branch, Jump, Return, Phi
Box(2): NewBox, BoxCall  ← PluginInvoke統合
配列(2): ArrayGet, ArraySet
外部(1): ExternCall

🚀 Core-13への道筋

Step 1: 配列操作のBoxCall統合（Core-14 → Core-12）

// 現在
%val = ArrayGet %arr, %idx
ArraySet %arr, %idx, %val

// 統合後
%val = BoxCall %arr, "get", [%idx]
BoxCall %arr, "set", [%idx, %val]

実装方針:

• Optimizer: ArrayGet/ArraySet → BoxCall 変換
• VM: 高頻度パスは内部最適化維持
• JIT: 既知型の場合はインライン展開

Step 2: Load/Store の再考（Core-12 → Core-11）

SSAの威力を活かす:

• ローカル変数のLoad/Store → SSA変数で代替
• 真に必要なのはBoxフィールドアクセスのみ
• それもBoxCall("getField"/"setField")で統合可能

// 現在
Store %slot, %value
%val = Load %slot

// SSA化
%val = %value  // 直接参照（Copyも実質不要）

Step 3: 定数統合とUnaryOp簡素化（Core-11 → Core-13）

Const統合案:

// 現在
Const::Integer(i64)
Const::Float(f64)
Const::Bool(bool)
Const::String(String)
Const::Null

// 統合後
Const { type: Type, value: u64 }  // 全て64bitに収める

UnaryOp削減:

• Neg → BinOp(Sub, 0, x)
• Not → BinOp(Xor, x, 1)
• BitNot → BinOp(Xor, x, -1)

🎯 最終形：Core-13

定数(1):
  - Const（統合型：i64/f64/bool/null/handle）

計算(2):
  - BinOp（Add/Sub/Mul/Div/Mod/And/Or/Xor/Shl/Shr）
  - Compare（Eq/Ne/Lt/Le/Gt/Ge）

制御(4):
  - Branch（条件分岐）
  - Jump（無条件ジャンプ）  
  - Phi（SSA合流）
  - Return（関数終了）

呼出(3):
  - Call（Nyash関数呼び出し）
  - BoxCall（Box操作統一）
  - ExternCall（環境アクセス）

メタ(3):
  - TypeOp（型チェック/キャスト）
  - Safepoint（GCセーフポイント）
  - Barrier（メモリバリア）

合計: 13命令

💡 なぜCore-13で十分なのか

1. チューリング完全性の保証

最小限必要なもの:

• 定数
• 算術演算
• 条件分岐
• ループ（Jump + Branch）
• 関数呼び出し

これらはすべてCore-13に含まれる。

2. Everything is Box の威力

// すべてがBoxCall経由
arr[0]           → BoxCall(arr, "get", [0])
arr[0] = 42      → BoxCall(arr, "set", [0, 42])
obj.field        → BoxCall(obj, "getField", ["field"])
obj.field = val  → BoxCall(obj, "setField", ["field", val])
weak.get()       → BoxCall(weak, "get", [])

3. SSAによるメモリ命令の削減

• 一時変数 → SSA変数（Load/Store不要）
• フィールド → BoxCall
• 配列要素 → BoxCall
• 真のメモリアクセスはBoxの中に隠蔽

📋 実装ロードマップ

ステータス（進捗メモ）

• 実装済み（トグルONで有効化）
  • Optimizer: ArrayGet/Set・RefGet/Set → BoxCall 変換（NYASH_MIR_ARRAY_BOXCALL, NYASH_MIR_REF_BOXCALL, NYASH_MIR_CORE13）
  • VM: BoxCall(setField)のWriteBarrier、Array/Instanceの軽量fast-path（by-name/slot併用）
  • 管理棟: 主要なMIR/GC/Optimizerフラグを config::env に集約
• 未了/次段
  • JIT: BoxCall fast-path の inlining（bounds/Barrier含む）
  • ベンチ追加とCIゲート（array/field/arithmetic_loop）
  • フィールドfast-pathのslot化（name→slot化の検討）
  • 直env参照の残りの段階移行（ログ用途は後段）

Phase 11.8.1: 準備と分析（1週間）

• 現在のMIR使用状況の詳細分析
• ArrayGet/ArraySet → BoxCall 変換の影響調査
• Load/Store 削除可能性の検証
• パフォーマンスベンチマーク基準値測定

Phase 11.8.2: ArrayGet/ArraySet統合（2週間）

• Optimizer: ArrayGet/ArraySet → BoxCall 変換パス
• VM: BoxCall("get"/"set") の最適化パス
• JIT: 既知ArrayBoxの特殊化維持
• テスト: 既存配列操作の回帰テスト

Phase 11.8.3: Load/Store削減（3週間）

• Builder: SSA最大活用でLoad/Store削減
• フィールドアクセス → BoxCall 変換
• VM/JIT: 最適化パスの調整
• ベンチマーク: パフォーマンス影響測定

Phase 11.8.4: 最終統合（2週間）

• Const型統合実装
• UnaryOp → BinOp 変換
• Core-13命令セット確定
• ドキュメント最終更新

⚠️ リスクと緩和策

パフォーマンスリスク

リスク: BoxCall統合によるオーバーヘッド 緩和策:

• VM層での型別最適化維持
• JIT時の積極的インライン展開
• 高頻度パスのNyRTシム化

互換性リスク

リスク: 既存MIRコードの非互換 緩和策:

• Rewriteパスで自動変換
• 段階的移行（警告→エラー）
• 環境変数でレガシーモード

複雑性リスク

リスク: BoxCallの過度な多重化 緩和策:

• 明確な命名規約（get/set/getField等）
• 型情報による静的検証強化
• デバッグ情報の充実

🎯 成功指標

1. 命令数: 26 → 13（50%削減）
2. パフォーマンス: ベンチマークで±5%以内
3. コードサイズ: MIRダンプサイズ20%削減
4. 保守性: 新Box追加時のMIR変更不要

📚 関連ドキュメント

• MIR Instruction Set
• Phase 12: PluginInvoke統合
• Everything is Box哲学

---

「少ないほど豊かである」- MIRは最小の接着剤、Boxが無限の世界を創る