hakorune/docs/development/roadmap/phases/phase-12/README.md

Phase 12: Nyashコード共有エコシステム - Everything is Box の実現

🚀 最新ブレイクスルー (2025-09-01)

TypeBox統合ABI - プラグイン革命の実現！

「Everything is Box」哲学の究極形態：型情報すらBoxとして扱うTypeBoxにより、C ABI + Nyash ABIの完全統合を達成！

// TypeBox - 型情報をBoxとして扱う最小構造
typedef struct {
    uint32_t abi_tag;       // 'TYBX'
    const char* name;       // "ArrayBox"
    void* (*create)(void);  // Box生成関数
} NyrtTypeBox;

3大AI専門家の一致した結論:

• Codex: 「TypeBoxブリッジは理想的なアーキテクチャ」
• ChatGPT5: 「実装に耐える設計。10の改善点で完璧」
• Gemini: 「Nyash哲学に最適なシンプルさ」

🎯 重要な変更 (2025-09-01)

Phase 12の議論とビルトインBox廃止により、プラグインシステムが進化：

新しい3層プラグインシステムが確立されました！

# Nyashスクリプトプラグイン（ユーザー定義Box）
box DataProcessor {
    init {
        me.file = new FileBox()    # C ABIプラグイン使用
        me.math = new MathBox()    # C ABIプラグイン使用
        me.cache = new MapBox()    # これもC ABIプラグイン（ビルトイン廃止）
    }
    
    process(data) {
        local result = me.math.sin(data)
        me.file.write("log.txt", result.toString())
        return result
    }
}

# 使用例
local processor = new DataProcessor()
processor.process(3.14)  # すべてプラグインで動作！

📝 なぜ誤解が生まれたのか

「プラグイン」という言葉から、特別な仕組みが必要だと考えてしまいましたが、Nyashの「Everything is Box」哲学により、ユーザー定義Boxこそが最高のプラグインシステムでした。

詳細な分析：なぜ天才AIたちは間違えたのか

🚀 Phase 12の真の価値：コード共有エコシステム

本当に必要なもの

1. export/import構文

   # math_utils.ny
   export box MathUtils {
       factorial(n) { ... }
       fibonacci(n) { ... }
   }
   
   # main.ny
   import { MathUtils } from "math_utils.ny"
   local utils = new MathUtils()
   

2. パッケージマネージャー

   nyash install awesome-math-utils
   nyash publish my-cool-box
   

3. ドキュメント生成

   # @doc 素晴らしい数学ユーティリティ
   # @param n 計算したい数値
   # @return 階乗の結果
   export box MathUtils { ... }
   

📊 新しい3層プラグインシステム

Nyashエコシステム（ビルトインBox廃止後）：
├── Nyashスクリプトプラグイン（ユーザー定義Box）← .nyashファイル
├── C ABIプラグイン（既存のまま使用）← シンプル・高速・安定
│   └── **TypeBox**: プラグイン間Box生成の最小機構 🆕
└── Nyash ABIプラグイン（必要時のみ）← 言語間相互運用・将来拡張
    └── MIR命令は増やさない（BoxCallにabi_hint追加のみ）

💡 TypeBox：シンプルなプラグイン間連携

MapBox.keys()がArrayBoxを返したい場合：

// TypeBox構造体（型情報をBoxとして扱う）
typedef struct {
    uint32_t abi_tag;       // 'TYBX'
    const char* name;       // "ArrayBox"
    void* (*create)(void);  // Box生成関数
} NyrtTypeBox;

// MapBox.keys()実装
void* map_keys(void* self, void* array_type_box) {
    NyrtTypeBox* array_type = (NyrtTypeBox*)array_type_box;
    void* array = array_type->create();  // ArrayBox生成
    // ... キーを追加
    return array;
}

詳細: C ABI TypeBox設計仕様書

プラグイン選択の指針

• C ABIで済むなら、C ABIを使う（シンプルイズベスト）
• Nyash ABIは以下の場合のみ：
  • 他言語（Python/Go等）からの呼び出し
  • 複雑な型の相互運用が必要
  • 将来の拡張性を重視する場合

📝 MIR命令統合（Phase 12での変更）

• PluginInvoke → BoxCall 統合
  • ビルトインBox廃止によりフォールバックがなくなる
  • BoxCallとPluginInvokeの区別が不要に
  • VM層でC ABI/Nyash ABI/Scriptを自動判定
  • Core-15 → Core-14 へ（命令数削減）

🛣️ 実装ロードマップ（TypeBox優先版）

Phase 12.0: TypeBox統合ABI実装（1週間）🆕

• nyrt_typebox.h完全ヘッダー定義
• Rust FFIミラー実装
• MapBox両ABI実装（実証テスト）
• 所有権ファズテスト
• 📄 統合ABI設計仕様書

---

現状サマリ（2025-09-02）

• C ABI（TLV: 1/2/3/5/6/7/8）でのプラグイン呼び出しはVMで安定運用中。returns_result も nyash.toml で制御可能。
• JIT は VM と同じBox境界で動作（フォールバック含む）。Cranelift AOT のオブジェクト出力は未配線（スケルトン）。
• MapBox を拡張（stringキー、remove/clear/getOr/keysStr/valuesStr/toJson）。keys()/values() はランタイムシムで暫定提供。
• Phase 12 設計（TypeBox + Unified Dispatch）は破壊的変更不要で段階導入可能と判断。

詳細タスクは TASKS.md を参照。

Phase 12.1: export/import構文（2週間）

• exportキーワードのパーサー実装
• importステートメントの実装
• モジュール解決システム
• 📄 詳細仕様書

Phase 12.2: パッケージ管理（3週間）

• nyash.tomlのdependencies対応
• 中央リポジトリ設計
• CLIツール（install/publish）
• 📄 パッケージマネージャー設計書

Phase 12.3: 開発者体験向上（継続的）

• ドキュメント生成ツール
• VSCode拡張（補完・定義ジャンプ）
• サンプルパッケージ作成

📚 関連ドキュメント

🎯 主要設計ドキュメント

• 統合ABI設計仕様書 ← 🆕🚀 C ABI + Nyash ABI統合の完全設計！3大AI専門家検証済み
• C ABI TypeBox設計仕様書 ← 🆕 シンプルなプラグイン間Box生成！
• Nyash ABI統合設計図 ← 将来拡張用の高度なABI
• export/import仕様
• パッケージマネージャー設計
• なぜ天才AIたちは間違えたのか

📂 議論の過程

• ABI戦略議論: abi-strategy-discussion/
• Nyash ABI詳細: nyash-abi-discussion/
• 初期提案アーカイブ: archive/

---

AIたちがなぜ複雑な解決策を提案したのか、その議論の過程は archive/ ディレクトリに保存されています。良い教訓として残しておきます。