📚 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/workbench/DECISIONS.md

@@ -0,0 +1,13 @@
+# DECISIONS (Phase 10.7)
+
+## 2025-08-30 — 二本立て運用（決定）
+- 決定: 現行の実行系（PyRuntimeBox, Plugin-First）は維持し、トランスパイル系（Python→Nyash）は All-or-Nothing で併走。
+- 代替案: トランスパイルの部分フォールバック（実行時にPyRuntimeへ落とす）。
+- 理由: 実行時の不一致/隠れ分岐を避ける。デプロイ時の挙動を単純に保つ。
+- 影響: 生成Nyashの品質責任はトランスパイラ側。利用者は明示的に系を選択。
+
+## 2025-08-30 — Parser/CompilerもプラグインBox（決定）
+- 決定: PythonParserBox/PythonCompilerBox としてプラグイン化し、CLIから呼び出す。
+- 代替案: コア組込み。
+- 理由: Plugin-First原則、配布容易性、差し替え性、隔離テスト。
+- 影響: plugins/ 以下に新規プラグインを追加。SDKの最小拡張が必要になる場合あり。

docs/development/roadmap/phases/phase-10.7/workbench/IR_SCHEMA_MIN.md

@@ -0,0 +1,39 @@
+# CorePy IR 最小スキーマ（C2草案）
+
+目的: Phase 1 の End-to-End を最短で通すための暫定IR。将来は構造化・拡張（with/try/comp/async等）。
+
+## JSON 形式（暫定）
+```json
+{
+  "module": {
+    "functions": [
+      {
+        "name": "main",                 // 省略可（既定: "main"）
+        "return_value": 0,               // 省略可（bodyと排他）
+        "body": [                        // 省略可（return_valueと排他）
+          { "Return": { "value": 0 } }
+        ]
+      }
+    ]
+  }
+}
+```
+
+ショートカット（デバッグ/ブリッジ用）
+```json
+{ "nyash_source": "static box Generated { main() { return 0 } }" }
+```
+
+## 変換規則（最小）
+- module.functions[0] だけを見る（複数関数は将来対応）
+- name があれば `static box Generated { <name>() { ... } }`
+- return_value が数値/文字列なら `return <value>` を生成
+- body があれば先頭の Return.value を探し、`return <value>` を生成
+- 上記が無ければ `return 0`
+
+## 将来（予約）
+- statements: If/While/For/Assign/Expr などの節を追加
+- expressions: BinOp/Call/Name/Constant などを構造化
+- functions配列の複数対応、クロージャは別Box化の方針を検討
+
+注意: All-or-Nothing 原則のもと、未対応ノードはCompiler側で明示的にエラーにする（現段階では未実装のため、return 0にフォールバックするが、C2終盤でStrict化する）。

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

@@ -0,0 +1,21 @@
+# Phase 10.7 Workbench
+
+このフォルダは Python Native（トランスパイル路線, All-or-Nothing）専用の作業台です。仕様・決定・スパイク・タスクをここに集約し、雑多にならないようにします。
+
+構成
+- TODO.md: 直近の作業キュー（小粒で管理）
+- DECISIONS.md: 決定事項（理由/代替案/影響）
+- SPIKES/: 検証スパイクの成果（小さなPoCやプロト）
+- notes-YYYYMMDD.md: 打合せ/検討メモ（必要に応じて）
+
+関連
+- 計画: ../PLAN.txt
+- 実装: ../implementation.md
+- テスト: ../testing-plan.md
+- 背景: ../README.md
+
+運用ルール（最小）
+- 一度に大きくしない（5〜30分単位の成果で刻む）
+- 決定は DECISIONS.md に残す（誰でも後から辿れる）
+- スパイクは SPIKES に隔離（本流に混ぜない）
+

docs/development/roadmap/phases/phase-10.7/workbench/TODO.md

@@ -0,0 +1,13 @@
+# TODO (Phase 10.7 Workbench)
+
+短期（C1〜C3に向けた小粒タスク）
+- [ ] C1: Parser plugin 雛形スケルトンを作る（pyo3, parse(code)->AstBox/to_json）
+- [ ] C1: Telemetry最小（node種別カウント, 未対応ノード列挙）
+- [ ] C2: CorePy IR最小スキーマ（JSON）を commit（with/async系は予約）
+- [ ] C2: IR→Nyash ASTの最小変換（def/if/for/while/return/算術/比較/呼出し）
+- [ ] C3: CLI隠しフラグ prototyping（--pyc/--pyc-native）
+- [ ] Docs: PLANとimplementationの差分同期（週次）
+
+メモ
+- All-or-Nothing原則：未対応は即Err（自動フォールバックなし）
+- 生成Nyashは現行AOT導線で配布可能（Strict）