📚 Phase 12: Nyashスクリプトプラグインシステム設計と埋め込みVM構想

## 主な成果
- Nyashスクリプトでプラグイン作成可能という革命的発見
- C ABI制約の分析と埋め込みVMによる解決策
- MIR/VM/JIT層での箱引数サポートの詳細分析

## ドキュメント作成
- Phase 12基本構想（README.md）
- Gemini/Codex先生の技術分析
- C ABIとの整合性問題と解決策
- 埋め込みVM実装ロードマップ
- 箱引数サポートの技術詳細

## 重要な洞察
- 制約は「リンク時にC ABI必要」のみ
- 埋め込みVMでMIRバイトコード実行により解決可能
- Nyashスクリプト→C ABIプラグイン変換が実現可能

Everything is Box → Everything is Plugin → Everything is Possible!

docs/development/roadmap/phases/phase-10.7/README.md

@@ -0,0 +1,148 @@
+# Phase 10.7 - True Python Native via Plugin Boxes
+
+## 🎯 概要
+
+PythonコードをNyashで**本当にネイティブ実行**する。CPythonへの依存なしに、Pythonコードが完全にNyash MIR/JIT経由で機械語として実行される。
+
+### 現状 vs 理想
+
+**現状（Phase 10.6）**: PyRuntimeBox → libpython呼び出し
+**理想（Phase 10.7）**: Python → Nyashスクリプト → MIR → ネイティブ
+
+## 🏗️ アーキテクチャ：トランスパイル方式
+
+```
+Python AST → CorePy IR → Nyash AST → Nyashスクリプト
+```
+
+### なぜトランスパイル？
+
+1. **透明性**: 生成コードが見える・デバッグできる・手を加えられる
+2. **既存資産活用**: Nyashコンパイラの最適化を自動享受
+3. **教育的価値**: PythonとNyashの対応が学習価値を持つ
+4. **段階的改善**: 生成コードの品質を徐々に向上
+
+### プラグインBox群
+
+- **PythonParserBox**: Python → AST変換
+- **PythonCompilerBox**: AST → Nyashスクリプト生成
+- **py_runtime.ny**: Pythonセマンティクス保持ライブラリ
+
+## ⚠️ All or Nothing設計（フォールバックなし）
+
+**コンパイルできる or できない の2択のみ**
+
+```nyash
+compiler = new PythonCompilerBox()
+result = compiler.compile(ast)
+
+if result.isOk() {
+    // 100%コンパイル成功 → ネイティブ実行
+    print("Success! Native execution ready.")
+} else {
+    // 未対応機能あり → 完全拒否
+    print("Cannot compile: " + result.getError())
+    print("Use PyRuntimeBox instead.")
+}
+```
+
+理由：開発時と本番時で挙動が変わるのは最悪の設計
+
+## 📋 実装フェーズ
+
+### Phase 10.7a - Parser Plugin（1週間）
+- PythonParserBoxの実装
+- Python AST → ASTBox変換
+- テレメトリー基盤
+
+### Phase 10.7b - Compiler Core（2週間）
+**Phase 1機能（必須）**
+- 関数定義、条件分岐、ループ
+- 演算子、関数呼び出し
+- Python固有：LEGB、デフォルト引数、for/else
+
+### Phase 10.7c - Validation & Testing（1週間）
+- コンパイル可能性の事前検証
+- Differential testing（CPythonと比較）
+- 明確なエラーメッセージ
+
+### Phase 10.7d - Coverage拡大（3-4週間）
+**Phase 2**: 例外処理、with文、comprehensions
+**Phase 3**: async/await、デコレータ、ジェネレータ
+
+## 🧪 py_runtime設計
+
+```nyash
+// Pythonセマンティクスを忠実に再現
+box PyRuntime {
+    py_truthy(x) {
+        // Python的真偽値判定
+        if x == null or x == false { return false }
+        if x.hasMethod("__bool__") { return x.__bool__() }
+        if x.hasMethod("__len__") { return x.__len__() != 0 }
+        return true
+    }
+    
+    py_getattr(obj, name) {
+        // ディスクリプタプロトコル、MRO探索
+    }
+    
+    py_call(f, args, kwargs) {
+        // デフォルト引数、*args/**kwargs処理
+    }
+}
+```
+
+## 📊 成功指標
+
+### Phase 1完了時
+```
+Compilable files: 15/100 (15%)
+Performance (numeric): 10x faster than CPython
+Correctness: 100% (differential testing)
+```
+
+### 最終目標（Phase 3）
+```
+Coverage: 95%+ of common patterns
+Performance: 5-20x faster
+Distribution: Single binary, no CPython
+```
+
+## 🚀 クイックスタート
+
+```bash
+# プラグイン作成
+cd plugins/
+cargo new nyash-python-parser-plugin --lib
+
+# 最小実装
+[dependencies]
+pyo3 = { version = "0.22", features = ["auto-initialize"] }
+nyash-plugin-sdk = { path = "../../crates/plugin-sdk" }
+
+# テスト実行
+cargo build --release
+../../target/release/nyash test_parser.nyash
+```
+
+## 💡 創造的可能性
+
+### ハイブリッドプログラミング
+```python
+@nyash.vectorize  # PythonデコレータがNyashのSIMD生成！
+def matrix_multiply(a, b):
+    return a @ b
+```
+
+### 言語の共進化
+- Nyashが「Pythonで最も使われるイディオム」から学習
+- Pythonに「Nyash-aware」コーディングスタイル誕生
+
+### 教育的インパクト
+左にPython、右にリアルタイムNyash変換のPlayground
+
+## 📚 参考資料
+
+- **archive/gemini-analysis-transpile-beauty.md** - 創造性分析
+- **archive/codex-analysis-technical-implementation.md** - 技術分析