hakorune/docs/development/roadmap/phases/phase-12/abi-strategy-discussion/final-implementation-decision.md

BoxCall拡張によるABI戦略 - 最終実装決定 (2025-09-01)

🎯 両先生の回答から得た重要な洞察

Gemini先生の誤解が示す重要な点

• 先生は「BoxCall = Boxを渡す」と誤解
• しかし、この誤解がabi_stableの重要性を教えてくれた
• 将来的にRustトレイトオブジェクトを扱う際の指針に

Codex先生の実践的分析

1. abi_hintは実は不要かもしれない

   • VM実行時にtype_idから判定可能
   • プラグインローダーが型情報を保持
   • MIR層を汚さない

2. 既存実装への影響最小化

   • TypeMetaにABI情報を含める
   • nyash.tomlから読み込み済み
   • VM側で判定するだけ

🚀 最終実装方針

Option A: 最小限実装（推奨）

// MIR層：変更なし！
MirInstruction::BoxCall {
    receiver: Value,
    method: String,
    args: Vec<Value>,
    // abi_hint不要！
}

// VM層：型判定でABI選択
fn execute_boxcall(...) {
    let type_id = receiver.get_type_id();
    
    // プラグインローダーから型情報取得
    if let Some(plugin_info) = get_plugin_info(type_id) {
        match plugin_info.abi {
            "c" => call_c_abi(...),
            "nyash" => call_nyash_abi(...),
            _ => fallback_to_c_abi(...),
        }
    }
}

Option B: 明示的ヒント（将来の拡張性）

// MIR層：最小限の拡張
MirInstruction::BoxCall {
    receiver: Value,
    method: String,
    args: Vec<Value],
    metadata: Option<u32>, // 汎用メタデータ（ABIヒント含む）
}

📊 比較表

観点	Option A（最小限）	Option B（ヒント付き）
MIR変更	なし ✅	最小限
実装工数	1週間	2週間
JIT最適化	VM時判定	ビルド時判定可能
将来拡張	型情報経由	メタデータ活用

🎯 結論：Option Aで始める

理由

1. 80/20ルール: まず動くものを作る
2. MIR無変更: 15命令の美しさ維持 → さらに14命令へ（PluginInvoke統合）
3. 段階的進化: 必要になったらOption Bへ

Phase 12での追加統合

• PluginInvoke → BoxCall 完全統合
  • ビルトインBox廃止により区別が不要
  • VM層でのABI判定で十分
  • Core-15 → Core-14 への削減

実装ステップ（1週間）

Day 1-2: nyash.toml拡張
  - abi: "c" | "nyash" field追加
  - プラグインローダー対応

Day 3-4: VM実行時分岐
  - execute_boxcall内でABI判定
  - NyashValue pack/unpack実装

Day 5-6: テスト・ベンチマーク
  - 同一機能の2種類プラグイン
  - 性能比較測定

Day 7: 判断
  - データに基づく方向性決定
  - Option B移行の必要性評価

💡 深い洞察

「abi_hintは不要」という発見が示すもの：

• 型システムが既に十分な情報を持っている
• MIRは純粋な意図の表現で良い
• 実行時の賢い判断に任せる

これこそ「Everything is Box」の真髄 - Boxが自分の実装方法を知っている！

🚀 次のアクション

1. nyash.tomlパーサーにabi field追加
2. プラグインローダーでABI情報保持
3. VM execute_boxcallで分岐実装
4. 最小限のテストプラグイン作成

---

最小限から始めて、データで判断する。これがNyashの道。