refactor: Major interpreter modularization and P2PBox enhancements

Major Interpreter Refactoring: - Split core.rs (373 lines removed) into focused modules - Split expressions/calls.rs (460 lines removed) into cleaner structure - Added new modules: calls.rs, errors.rs, eval.rs, methods_dispatch.rs, state.rs - Improved separation of concerns across interpreter components P2PBox Enhancements: - Added on_once() for one-time event handlers - Added off() for handler deregistration - Implemented handler flags with AtomicBool for thread-safe management - Added loopback testing cache (last_from, last_intent_name) - Improved Arc-based state sharing for transport and handlers Plugin Loader Unification (In Progress): - Created plugin_loader_unified.rs skeleton - Created plugin_ffi_common.rs for shared FFI utilities - Migration plan documented (2400 lines → 1100 lines target) MIR & VM Improvements: - Enhanced modularized MIR builder structure - Added BoxCall dispatch improvements - Better separation in builder modules Documentation Updates: - Added Phase 9.79a unified box dispatch plan - Created plugin loader migration plan - Updated CURRENT_TASK.md with latest progress All tests passing (180 tests) - ready for next phase of refactoring 🤖 Generated with Claude Code Co-Authored-By: Claude <noreply@anthropic.com>
2025-08-26 19:13:57 +09:00
parent bec61e38c5
commit 22212aa314
46 changed files with 2383 additions and 1438 deletions
--- a/docs/development/current/CURRENT_TASK.md
+++ b/docs/development/current/CURRENT_TASK.md
@ -1,475 +1,74 @@
-# 🎯 CURRENT TASK - 2025年8月26日（状況整理＆再起動ショートカット）
+# 🎯 CURRENT TASK - 2025-08-26（Context Reset / Fresh Focus）

-## ⏱️ 再開ショートカット（今日のフォーカス）
- フォーカス: VM比較経路の安定化後片付け + 1000行分解の下準備
- 目標: 一時ログ抑制・Phi正規化・基本ボックス統一（String/Bool）・VM分割の導線作成
- 参照: `docs/development/roadmap/phases/phase-9/phase_9_78h_mir_pipeline_stabilization.md`
+コンテキストを「0%」にリセットし、いま必要なことだけに集中するにゃ。

-### 直近の実行タスク（9.78h）
-1) 一時デバッグログの抑制（`NYASH_VM_DEBUG_*`のみ）
-   - 進捗: Runnerのバナー/プラグイン初期化ログは `NYASH_CLI_VERBOSE`/`NYASH_DEBUG_PLUGIN` のみで出力。
-           VMの逐次ログは `NYASH_VM_DEBUG[_EXEC|_CMP|_ANDOR|_PHI]` に限定。
-2) Phi正規化（LoopExecutorの借用衝突解消 → 正しい選択へ復帰）
-   - 進捗: VM側の選択を `previous_block` 基準に復帰（fallback: 先頭）。`NYASH_VM_DEBUG_PHI=1` でログ。
-   - 設計: docs/development/current/PHI_NORMALIZATION_PLAN.md を参照（段階プラン/次アクション）。
-3) 基本ボックス統一（StringBox/BoolBoxもre-export化）
-4) VM分割の導線（control_flow/dispatch/frameへ分離設計）
-   - 進捗: `src/backend/{control_flow.rs,dispatch.rs,frame.rs}` を追加（骨組み）。ビルド通過。
-5) 代表スナップショット追加（compare/loop/typeop_mixed）
+## ⏱️ 今日のフォーカス（Phase 9.79a: Unified Dispatch + P2P Polish）
+- 判断: 統一Box設計は「非侵襲のディスパッチ統一」から入る → P2PBox磨きを同時並行
+- 目的: ユニバーサルメソッド（toString/type/equals/clone）をVM/Interpreter前段で統一 + P2PBoxのmulti-node/async UX安定化

-### すぐ試せるコマンド
+### 直近の実行タスク（小さく早く）
+1) ユニバーサルメソッドの前段ディスパッチ（非侵襲）
+   - VM/Interpreterで`toString/type/equals/clone`を共通ヘルパにマップ（トレイト変更なし）
+2) P2PBox磨き（multi-node/async/解除）
+   - share/cloneセマンティクス：share=共有, clone=新規（実装済みの明文化）
+   - unregisterの安全化（endpoint一致 or refcount）
+   - onOnce/off のE2Eテスト追加
+   - VM表示整合（getLast*/debug_* の toString/Console）
+3) E2Eスモーク更新
+   - self→self, two-node ping-pong（安定）
+   - asyncデモ（TimeBox併用で確実に出力）
+
+### すぐ試せるコマンド（最小）
 ```bash
+# Rust（Release）
 cargo build --release -j32
-nyash --dump-mir --mir-verbose local_tests/typeop_is_as_func_poc.nyash | sed -n '1,160p'
-NYASH_OPT_DIAG_FAIL=1 nyash --dump-mir --mir-verbose local_tests/typeop_diag_fail.nyash || echo DIAG BLOCKED
-tools/ci_check_golden.sh  # 代表ケースのMIR含有チェック
+./target/release/nyash --help

-# 比較・論理のスモーク（VM）
-nyash --backend vm local_tests/compare_box_vm.nyash    # 期待: true
-nyash --backend vm local_tests/and_or_vm.nyash         # 期待: false\ntrue
-nyash --backend vm local_tests/and_or_truthy_vm.nyash  # 期待: false,true,false,true,false
+# Plugin デバッグ実行（任意）
+NYASH_DEBUG_PLUGIN=1 ./target/release/nyash --backend vm local_tests/extern_console_log.nyash || true
+
+# WASM（Web配布）
+cd projects/nyash-wasm && wasm-pack build --target web --out-dir pkg
 ```

-### 重要リンク（唯一参照/ゲート）
- 命令セット（唯一出典・26命令）: `docs/reference/mir/INSTRUCTION_SET.md`
- 9.78h（本フェーズ詳細）: `docs/development/roadmap/phases/phase-9/phase_9_78h_mir_pipeline_stabilization.md`
- 9.79（P2P本体 前提: 9.78h完了）: `docs/development/roadmap/phases/phase-9/phase_9_79_p2pbox_rebuild.md`
+## 現在の地図（Done / Doing / Next）
+
+### ✅ 完了
+- PluginHostファサード導入・移行（create/invoke/extern）
+- TLVヘッダ/引数/ハンドルの共通化（`plugin_ffi_common.rs`）
+- Interpreter分割の導線: `eval.rs` / `calls.rs` / `methods_dispatch.rs` 抽出
+- ログ静音の基盤: `idebug!`（NYASH_DEBUG=1 で有効）を calls/core/statements に適用
+- MIR modular builder ゲート追加（feature: `mir_modular_builder`）/ 整合パッチ投入
+
+### 🚧 進行中（小タスク）
+- Interpreterログ統一の残り（`delegation.rs` など）
+- PluginHost の `resolve_method` キャッシュ化（I/O削減）
+
+### ⏭️ 次アクション（今日～明日）
+- 9.79a-M1: ユニバーサル前段ディスパッチ（VM/Interpreter）/ 回帰確認
+- 9.79a-M2: P2P unregister安全化 + onOnce/off E2E + async安定
+- 9.79a-M3: VM表示整合/ Docs更新（言語ガイド・P2Pリファレンス）
+
+## 決定事項（Unified Box設計メモ）
+- ドキュメント: `docs/ideas/other/2025-08-25-unified-box-design-deep-analysis.md`
+- 判断: まずはディスパッチャ層でユニバーサルメソッドを統一（トレイト変更なし）
+- P2Pは共有セマンティクス（share=共有, clone=新規）を維持しつつ unregister 正式化へ
+
+## 参考リンク（唯一参照/ゲート）
+- MIR命令セット（26命令）: `docs/reference/mir/INSTRUCTION_SET.md`
+- Phase 9.79（P2P）: `docs/development/roadmap/phases/phase-9/phase_9_79_p2pbox_rebuild.md`
+- Phase 9.79a（Unified Dispatch + P2P Polish）: `docs/development/roadmap/phases/phase-9/phase_9_79a_unified_box_dispatch_and_p2p_polish.md`
+- Phase 9.78h（前段完了）: `docs/development/roadmap/phases/phase-9/phase_9_78h_mir_pipeline_stabilization.md`
 - Phase 10（Cranelift JIT主経路）: `docs/development/roadmap/phases/phase-10/phase_10_cranelift_jit_backend.md`

-### 🧩 今日の再開ポイント（2025-08-26）
- 完了（適度な分解）: runnerを`modes/`へ分離（mir/vm/llvm/bench/wasm/aot/common）、objectsを`objects/{ops,methods,fields}.rs`へ、VMに`frame.rs`/`control_flow::record_transition`/`dispatch::execute_instruction`導入。ログ抑制（NYASH_VM_DEBUG_* / NYASH_CLI_VERBOSE / NYASH_DEBUG_PLUGIN）、Phi正規化Step1（previous_block基準）。
- 次アクション（小さく前進）:
-  1) MIR26命令「総数一致」チェック（コード≡ドキュメント）
-  2) Loop SSA Step2（seal/pred更新のスケルトン＋Verifierのphi系文言強化）
-  3) 代表スナップショット再確認（TypeOp/extern_call/loop/await/boxcall）
- クイックコマンド: `cargo build --release -j32` → `nyash --backend vm local_tests/compare_box_vm.nyash` → `./tools/ci_check_golden.sh`
-
-
-## 🚨 現在の状況（2025-08-25）
-
-### ✅ 完了したタスク
-
-1. **✅ MIRビルダーリファクタリング完了🎉**（2025-08-25）
-   - mir/builder.rs: 1547行の大規模モジュール → **モジュール分割完了**
-   - 新構造: `src/mir/builder/` ディレクトリ
-     - `mod.rs`: 公開API定義
-     - `core.rs`: MirBuilder本体 + コア機能 (205行)
-     - `expressions.rs`: 式変換処理 (621行) - 18関数実装済み
-     - `statements.rs`: 文変換処理 (165行) - 6関数実装済み 
-     - `control_flow.rs`: 制御フロー構築 (194行) - 4関数実装済み
-     - `box_handlers.rs`: Box関連処理 (73行) - 2関数実装済み
-   - **ビルド確認**: 新構造でコンパイル正常完了 ✅
-   - **総移動関数数**: 30関数（ヘルパー関数含む）
-   - **行数削減**: 元の1547行から分割により読みやすさ大幅向上
-   - **コミット完了**: 
-     - Phase 3-5: cc2a5c2 (expressions.rs)
-     - Phase 6-8: 29af5e1 (statements/control_flow/box_handlers)
-
-2. **✅ VMモジュールのリファクタリング完了**（2025-08-25）
-   - execute_instruction関数を29個のハンドラーに分割
-   - vm_instructions.rsモジュール作成（487行）
-   - execute_instruction_old削除（691行削減）
-   - vm.rs: 2075行→1382行（33%削減）
-   
-### 🆕 進捗（2025-08-25 夜）
- VM and/or 対応の実装を追加（短絡評価は `as_bool()` 強制で統一、`BoxRef(IntegerBox)` の四則演算にも対応）。
- ゴールデン（TypeOp代表2ケース）は緑のまま、Optimizer診断（未lowering検知）も動作確認済み。
- ただし、VM実行時に `And` が `execute_binop` の短絡ルートに入らず、`execute_binary_op` の汎用経路で `Type error: Unsupported binary operation: And ...` が発生。
-  - 兆候: `NYASH_VM_DEBUG_ANDOR` のデバッグ出力が出ない＝`execute_binop` に入っていない、または別実装ルートを通過している可能性。
-  - 仮説: 古いVM経路の残存/リンク切替、もしくは実行時に別ビルド/別profileが使用されている。
-
-### 🆕 進捗（2025-08-26 早朝）
- and/or 真理値強制の最終化: `VMValue::as_bool()` を拡張（`BoxRef(IntegerBox)`→非0でtrue、`Void`→false）。
- テスト追加: `local_tests/and_or_truthy_vm.nyash`（期待: `false,true,false,true,false`）。緑を確認。
- 基本ボックス統一（第一弾）: `IntegerBox` を正典に一本化。
-  - `src/boxes/integer_box.rs` は `pub use crate::box_trait::IntegerBox;` に置換し、実体の二重化を排除。
- 既知の未解決: ループ比較で `BoxRef(IntegerBox) < BoxRef(IntegerBox)` が TypeError。
-  - 対応中: 比較前に i64 へ正規化するフォールバックをVMに実装（downcast→toString→parse）。
-  - 80/20ポリシー: 数値にパース可能なら比較継続、失敗時のみTypeError。
-
-### 🆕 進捗（2025-08-26 午前）
- TypeError（`And/Or` 経路）再発なしを確認（3スモーク緑: compare/and_or/and_or_truthy）。
- ログ抑制の徹底: Runner/VMのデバッグ出力を既定で静音、環境変数でのみ有効化。
- Phi正規化 Step1: `previous_block` によるPhi入力選択をVMに実装（`NYASH_VM_DEBUG_PHI=1`）。
- VM分割の骨組み: `control_flow.rs`/`dispatch.rs`/`frame.rs` 追加（今後段階移動）。
- レガシー削除: `src/mir/builder_old.rs`, `src/mir/builder.rs.backup`, `src/parser.rs.backup`, `src/instance.rs.backup`, `src/box_trait.rs.backup` を削除。
- objects.rs 分解 Step1: `execute_new` をヘルパ（三分割）へ抽出しスリム化（等価挙動）。
-   
-### 🎯 次の優先タスク（更新）
-
-1. **copilot_issues.txtの確認** 
-   - Phase 8.4: AST→MIR Lowering完全実装（最優先）
-   - Phase 8.5: MIRダイエット（35命令→20命令）
-   - Phase 8.6: VM性能改善（0.9倍 → 2倍以上）
-
-1.5 **VM実行経路の特定と修正（最優先）**
-   - `runner.rs → VM::execute_module → execute_instruction → execute_binop` の各段でデバッグログを追加し、`BinOp(And/Or)` がどこで分岐しているか特定。
-   - バイナリ一致確認: `strings` によるシグネチャ（デバッグ文字列）含有の照合で実行バイナリを同定。
-   - 代替経路の洗い出し: `src/` 全体で `execute_binop`/`And`/`Unsupported binary operation` を再走査し、影響箇所を一掃。
-   - 修正後、`local_tests/and_or_vm.nyash` で `false/true` の出力を確認。
-   - ルート確定: Compare経路はBuilder側のCast導線で安定。VM側は保険フォールバックを維持しつつ一時ログを抑制へ。
-1.6 **objects.rs 分解 Step2（安全にファイル分割）**
-   - `objects_impl.rs` を導入し、抽出済みヘルパを移動。本体は薄いラッパに。
-   - 以降: `objects/{fields.rs,methods.rs,ops.rs}` への段階分解。
-
-1.7 **runner.rs 分離**
-   - `init_bid_plugins` を `runner/plugin_init.rs` へ抽出。各モードを `runner/modes/*.rs` に。
-
-1.8 **VM分割の段階移動**
-   - ブロック遷移を `control_flow.rs`、フレーム状態を `frame.rs` に移し、`dispatch.rs` の導線を準備。
-
-2. **MIR26命令対応**
-   - TypeOp/WeakRef/Barrierのプリンタ拡張
-   - スナップショット整備（extern_call/loop/boxcall/typeop_mixed 追加済）
-   - vm-stats差分確認
-
-3. **Builder適用拡大**
-   - 言語 `is/as` 導線の実装
-   - 弱参照フィールドのWeakLoad/WeakNew対応
-   - 関数スタイル `isType/asType` の早期lowering強化
-
-## 🗺️ 計画の粒度（近々/中期/長期）
-
-### 近々（1–2週間）
- Loop SSA復帰: `loop_api` 小APIを活用し、Phi挿入・seal・predecessor更新を段階適用。簡易loweringを正しいSSAに置換。
- Builder移行完了: `builder.rs`の機能を`builder_modularized/*`へ移し切り、両者の差分（命令フィールド名・効果）を完全一致。
- TypeOp網羅: `is/as`/`isType/asType`の早期loweringを再点検、Optimizer診断（未lowering検出）を有効化し回帰を防止。
- 軽量スナップショット: MIRダンプ（verbose）に対する含有チェックを代表ケース（TypeOp/extern_call/loop/await/boxcall）へ拡張。
-
-### 中期（3–4週間）
- WeakRef/Barrier統合: lowering（WeakNew/WeakLoad/Barrier）導線を整理、統合命令フラグON/OFFでMIR差を固定化。Verifierに整合チェック追加。
- MIR26整合化: Printer/Verifier/Optimizerの26命令前提をそろえ、効果の表記・検証を強化。
- CLI分離テスト: ワークスペース分割 or lib/binaryテスト分離で、`cargo test -p core` のみで回る導線を確立（CLI構成変更で止まらない）。
- ResultBox移行: `box_trait::ResultBox` 参照を `boxes::ResultBox` へ一掃し、レガシー実装を段階的に削除。
-
-### 長期（Phase 8.4–8.6連動）
- AST→MIR Lowering完全化（8.4）: すべての言語要素を新MIRへ安定lower。未対応分岐をゼロに。
- MIRダイエット（8.5）: 命令の統一・簡素化（TypeOp/WeakRef/Barrierの統合効果）を活用し最小集合へ。
- VM性能改善（8.6）: Hot-path（BoxCall/Array/Map）高速化、And/OrのVM未実装の解消、BoxRef演算の抜けを補完。
-
-### Phase 10 着手ゲート（Cranelift前提条件）
- [ ] MIR26整合化完了（Printer/Verifier/Optimizerが26命令で一致・効果表記統一）
- [ ] Loop SSA復帰（Phi/Seal/Pred更新がVerifierで合格）
- [ ] TypeOp網羅（is/as/isType/asTypeの早期lowering＋Optimizer診断ONで回帰ゼロ）
- [ ] 軽量スナップショット緑（TypeOp/extern_call/loop/await/boxcall 代表ケース）
- [ ] P2PBox再設計（Phase 9.79）完了・E2Eパス
- [ ] CLI分離テスト（`cargo test -p core`）が安定実行
-
-### ⚠️ トラブルノート（VM and/or 追跡用）
- 症状: `--backend vm` で `And` が `execute_binop` の短絡パスを経由せず、`execute_binary_op` 汎用パスで `Type error`。
- 状況: `MIR --dump-mir` では `bb0: %X = %A And %B` を出力（BuilderはOK）。
- 差分検証: `execute_instruction`/`execute_binop` に挿入したデバッグ出力が未出力→実行経路の相違が濃厚。
- 対応: 実行バイナリの署名チェックとコードパスの網羅的ログ追加でルート確定→修正。
-
-### 🔧 再開ガイド（最短手順）
- ログ抑制: 一時ログはそのままでもOK。静かにしたい場合は `NYASH_VM_DEBUG_CMP=0 NYASH_VM_DEBUG_ANDOR=0` で実行。
- 検証: 上記スモーク3本（compare/and_or/and_or_truthy）→`tools/ci_check_golden.sh`。
- 進める順: Phi正規化 → String/Bool re-export → VM分割設計 → スナップショット追加。
-
-### ✅ 小タスク完了（2025-08-25 深夜）
- Verifier: Barrierの軽い文脈診断を追加（`NYASH_VERIFY_BARRIER_STRICT=1`で有効）。
- ResultBox移行TODOを追加（`docs/development/current/RESULTBOX_MIGRATION_TODO.md`）。
- VM: 旧`box_trait::ResultBox`扱いのデプリケーション警告を最小抑制（完全移行までの暫定）。
-
-### ✅ 小タスク完了（2025-08-26 早朝）
- VM: `as_bool()` の拡張（IntegerBox/ Void を真理値化）。
- テスト: `and_or_truthy_vm.nyash` 追加。
- 基本ボックス統一（第一弾）: `IntegerBox` 実体の一本化（re-export）。
-
-### ▶ リファクタリング開始（控えめ）
- 方針: 肥大化防止のため`src/backend/vm.rs`を2分割のみ実施。
-  - `vm_values.rs`: `execute_binary_op`/`execute_unary_op`/`execute_compare_op` を移動。
-  - `vm_boxcall.rs`: `call_box_method` を移動（`call_unified_method`は現状のまま）。
- 影響最小・挙動非変更で、可読性と責務分離を先行する。
-
-## 🧭 リファクタリングゴール（AI一目見て分かる導線）
-
-### 目的/原則
- 明確責務: 各モジュールが1行で説明できる目的・責務を持つ
- 入口統一: VM/MIRの読む順番が固定され、迷わない
- ファイル肥大防止: 1000行超は段階分割（まずVMホットパス）
- ドキュメント導線: quick-referenceで最短経路を提示
- 振る舞い不変: すべてのゴールデン/CIが緑
-
-### マイルストーン（受入基準）
- M1: VM導線完成（達成）
-  - vm.rs → vm_instructions.rs → vm_values.rs / vm_boxcall.rs / vm_stats.rs / vm_phi.rs
-  - code-map（docs/quick-reference/code-map.md）で入口と責務を明記
-  - 受入: build OK / golden 緑 / 実行変化なし
- M2: モジュールヘッダ（着手）
-  - Purpose/Responsibilities/Key APIs/Typical Callers を各VMモジュール先頭に追記
-  - 受入: 各モジュール先頭4行程度の要約とcode-mapの整合
- M3: 1000行級の導線整備（設計メモ）
-  - interpreter/plugin_loader.rs: v2主導の導線明文化（削除は後）
-  - interpreter/objects.rs: 可視性/フィールド/ライフサイクルの分割指針をTODO化
- M4: レガシー移行（土台）
-  - RESULTBOX_MIGRATION_TODOの維持、VMは新旧両対応のまま
-
-### 実行順（小さく確実に）
-1) M2ヘッダ追加（VM系）
-2) M3 plugin_loader 導線の明文化（コメント/TODO/コードマップ）
-3) M3 objects.rs 分割設計メモ
-4) 用語の統一・code-map追従
-5) golden + 重要E2Eを確認
-
-### ⚠️ MIRビルダー引き継ぎポイント（ChatGPT5さんへ）
- **状況**: MIRビルダーのモジュール化完了（Phase 1-8コミット済み）
- **問題**: MIR命令構造の変更により、expressions.rsでエラー発生
-  - `Call`命令: `function`→`func`, `arguments`→`args`
-  - `ArrayAccess`, `ArrayLiteral`, `Await`ノードが削除？
-  - effectsフィールドの有無が命令により異なる
-  - TypeOpKindのインポートパスエラー
-  - loop_builder.rsでのプライベートフィールドアクセス問題
- **現在の対応**: 
-  - builder_modularizedディレクトリに一時退避
-  - 元のbuilder.rsでフルビルド可能な状態に復帰
-  - ChatGPT5さんのMIR命令変更に合わせた調整が必要
-
-2. **VMの既知の問題**
-   - 論理演算子（and, or）がBinOpとして未実装
-   - エラー: `Type error: Unsupported binary operation: And on Bool(true) and Bool(false)`
-   - インタープリターでは動作するがVMで動作しない
-   - **新発見**: BoxRef(IntegerBox) + BoxRef(IntegerBox)のような演算も未対応
-     - execute_binary_opにBoxRef同士の演算ケースが不足
-
-## ✅ 直近の完了
-1. VMモジュールのリファクタリング完了（2025-08-25）
-   - execute_instruction関数を29個のハンドラーに分割
-   - vm_instructions.rsモジュール作成（487行）
-   - execute_instruction_old削除（691行削減）
-   - vm.rs: 2075行→1382行（33%削減）
-2. ドキュメント再編成の完了（構造刷新）
-2. VM×プラグインのE2E整備（FileBox/Net）
-   - FileBox: open/write/read, copyFrom(handle)（VM）
-   - Net: GET/POST（VM）、404/500（Ok(Response)）、unreachable（Err(ErrorBox)）
-3. VM命令カウンタ＋時間計測のCLI化（`--vm-stats`, `--vm-stats-json`）とJSON出力対応
-   - サンプル/スクリプト整備（tools/run_vm_stats.sh、local_tests/vm_stats_*.nyash）
-4. MIR if-merge 修正（retがphi dstを返す）＋ Verifier強化（mergeでのphi未使用検知、支配関係チェック導入）
-5. VMの健全化（分岐・比較・Result）
-   - Compare: Void/BoolのEq/Ne定義（順序比較はTypeError）
-   - Branch条件: `BoxRef(BoolBox)→bool`／`BoxRef(VoidBox)→false`／`Integer≠0→true`
-   - ResultBox: 新旧両実装への動的ディスパッチ統一（isOk/getValue/getError）
-6. VMビルトイン強化（Array/Map/Socket）
-   - ArrayBox/MapBox: 代表メソッドをVM統合ディスパッチで実装（push/get/set/size等）
-   - SocketBox: `acceptTimeout(ms)`（void）/ `recvTimeout(ms)`（空文字）を追加
-   - E2E追加: `socket_timeout_server.nyash` / `socket_timeout_client.nyash`
-7. E2E拡張（Net/Socket）
-   - HTTP: 大ボディ取得クライアント `local_tests/http_big_body_client.nyash`
-   - Socket: 反復タイムアウト検証 `local_tests/socket_repeated_timeouts.nyash`
-   - インタープリタ: SocketBoxの `acceptTimeout/recvTimeout` を結線
-8. VM/MIRの健全化（Builder/VM）
-   - Compare拡張: Float/Int-Float混在をサポート（Eq/Ne/Lt/Le/Gt/Ge）
-   - TypeOp(Check)最小意味論実装（Integer/Float/Bool/String/Void/Box名）
-   - ArrayGet/ArraySet（VM）本実装（ArrayBox.get/setへ橋渡し）
-   - Array/Mapをidentity扱い（clone_or_shareがshareを選択）
-   - BoxCallにArrayBox fast-path（BoxRefからget/set直呼び）
-   - me参照の安定化（fallback時に一度だけConstを発行しvariable_mapに保持）
-   - デバッグ: `NYASH_VM_DEBUG_BOXCALL=1` でBoxCallの受け手/引数/経路/結果型を標準エラーに出力
-9. ドキュメント追加・更新
-   - MIR→VMマッピング（分岐条件の動的変換、Void/Bool比較）
-   - VM README（SocketBoxタイムアウト/E2E導線・HTTP Result整理）
-   - 26命令ダイエット: PoCフラグと進捗追記（TypeOp/WeakRef/Barrier）
-10. CI: plugins E2E ジョブ（Linux）を追加
-
-### 📊 大規模ファイルのリファクタリング候補
-1. src/interpreter/objects.rs (1,272行) - オブジェクト処理の分割
-2. src/interpreter/plugin_loader.rs (1,217行) - v2があるので削除候補？
-3. src/interpreter/expressions/calls.rs (1,016行) - 関数呼び出し処理の分割
-
-## 🚧 次にやること（再開方針）
-
-1) MIR26 前進（短期）
-   - プリンタ拡張: `TypeOp/WeakRef/Barrier` を `--mir-verbose` に明示表示
-   - スナップショット整備: 代表ケースで flag ON/OFF のMIR差分固定化
-   - vm-stats差分: `weak_field_poc.nyash` 等で JSON 取得・比較（キー: TypeOp/WeakRef/Barrier）
- 注: `mir_typeop_poc` / `mir_refbarrier_unify_poc` は非推奨（no-op）。Builderは統合命令（TypeOp/WeakRef/Barrier）を常に生成する。Optimizerに旧命令→統合命令の正規化パスあり。
-
-2) Builder適用拡大（短期〜中期）
-   - 言語 `is/as` 導線（最小でも擬似ノード）→ `emit_type_check/emit_cast` へ配線
-   - 弱参照: 既存の `RefGet/RefSet` パスは弱フィールドで `WeakLoad/WeakNew`＋Barrier（flag ONで統合命令）
-   - 関数スタイル `isType/asType` の早期loweringを強化（`Literal("T")` と `new StringBox("T")` を確実に検出）
-   - `print(isType(...))` の未定義SSA回避（print直前で必ず `TypeOp` のdstを生成）
-
-補足: 近々/中期で並行対応する項目
- Loop SSA復帰（Phi挿入/Seal/Pred更新の段階適用、簡易loweringの置換）
- Builder移行完了（`builder.rs` → `builder_modularized/*`、命令フィールド名・効果の完全一致）
- CLI分離テスト導線（`cargo test -p core` 単独で回る構成）
- ResultBox移行（`box_trait::ResultBox` → `boxes::ResultBox`、レガシー段階削除）
-
-3) VM/Verifierの補強（中期）
-   - `TypeOp(Cast)` の数値キャスト（Int/Float）安全化、誤用時TypeError整備
-   - Verifierに26命令整合（Barrier位置、WeakRef整合、支配関係）チェックを追加
-
-4) VM×プラグインE2Eの維持（短期）
-   - HTTP/Socketの回帰確認（Void防御・遅延サーバ軽量化は済）
-   - 必要に応じて `VM_README.md` にTips追記
-
-5) BoxCall高速化（性能段階）
-   - `--vm-stats` ホットパス特定後、Fast-path/キャッシュ適用
-
-## 🐛 既知の問題（要フォロー）
- 関数スタイル `isType(value, "Integer")` が一部ケースで `TypeOp` にloweringされず、`print %X` が未定義参照になる事象
-  - 現状: `asType` は `typeop cast` に変換されるが、`isType` が欠落するケースあり
-  - 仮対処: Interpreterに `is/isType/as/asType` のフォールバックを実装済（実行エラー回避）
-  - 恒久対処（次回対応）:
-    - Builderの早期loweringをFunctionCall分岐で強化（`Literal`/`StringBox`両対応、`print(...)` 内でも確実にdst生成）
-    - Optimizerの安全ネット（BoxCall/Call→TypeOp）を `isType` パターンでも確実に発火させる（テーブル駆動の判定）
-
- 命令の二重化（Legacy vs Unified）
-  - 状況: `MirInstruction` に旧系（`TypeCheck/Cast/WeakNew/WeakLoad/BarrierRead/BarrierWrite`）と統合系（`TypeOp/WeakRef/Barrier`）が併存。
-  - リスク: ドキュメントは26命令（統合系）で凍結のため、実装との二重化がバグ温床に。
-  - 当面のガード: 26命令同期テストを追加（`src/mir/instruction_introspection.rs`）。ドキュメント≡実装名がズレたら赤。
-  - 次アクション:
-    1) Optimizer診断に「旧命令検出」フラグを追加（`NYASH_OPT_DIAG_FORBID_LEGACY=1`で旧命令が存在したら失敗）。
-    2) Printer/Verifier/Optimizerの表記・効果を統合側に寄せる（表示も統一）。
-    3) 段階的に旧命令をcfgで囲む or 内部で統合命令へアダプト（最終的に旧命令経路を削除）。
-
-## ⏸️ セッション再開メモ（次にやること）
- [ ] Builder: `extract_string_literal` の `StringBox`対応は導入済 → `FunctionCall` 早期loweringの再検証（`print(isType(...))` 直下）
- [ ] Optimizer: `Call` 形式（関数呼び出し）でも `isType/asType` を検出して `TypeOp(Check/Cast)` に置換する安全ネットの強化とテスト
- [ ] MIRダンプの確認：`local_tests/typeop_is_as_func_poc.nyash` に `typeop check/cast` が両方出ることを確認
- [ ] スナップショット化：`typeop_is_as_*_poc.nyash` のダンプを固定し回帰検出
-
-## ▶ 補助コマンド（検証系）
-```bash
-# リビルド
-cargo build --release -j32
-
-# 関数スタイルのMIRダンプ確認（isType/asType）
-./target/release/nyash --dump-mir --mir-verbose local_tests/typeop_is_as_func_poc.nyash | sed -n '1,200p'
-
-# メソッドスタイルのMIRダンプ確認（is/as）
-./target/release/nyash --dump-mir --mir-verbose local_tests/typeop_is_as_poc.nyash | sed -n '1,200p'
-```
-
-### 🆕 開発時の可視化・診断（最小追加）
- `--mir-verbose-effects`: MIRダンプ行末に効果カテゴリを表示（`pure|readonly|side`）
-  - 例: `nyash --dump-mir --mir-verbose --mir-verbose-effects local_tests/typeop_is_as_func_poc.nyash`
- `NYASH_OPT_DIAG_FAIL=1`: Optimizer診断で未lowering（`is|isType|as|asType`）検知時にエラー終了（CI向け）
-  - 例: `NYASH_OPT_DIAG_FAIL=1 nyash --dump-mir --mir-verbose local_tests/typeop_diag_fail.nyash`
- Builder生MIRスナップショット: `tools/snapshot_mir.sh <input.nyash> [output.txt]`
-  - 例: `tools/snapshot_mir.sh local_tests/typeop_is_as_func_poc.nyash docs/status/golden/typeop_is_as_func_poc.mir.txt`
- ゴールデン比較（ローカル/CI）: `tools/ci_check_golden.sh`（代表2ケースを比較）
-  - 例: `./tools/ci_check_golden.sh`（差分があれば非ゼロ終了）
-  
-補足: ASTの形状確認は `--dump-ast` を使用。
-
-#### 代表スナップショット対象（拡張）
- TypeOp系: `typeop_is_as_poc.nyash`, `typeop_is_as_func_poc.nyash`
- extern_call: `http_get_*.nyash`, `filebox_copy_from_handle.nyash`
- loop/await: `loop_phi_seal_poc.nyash`, `await_http_timeout_poc.nyash`
- boxcall: `array_map_fastpath_poc.nyash`, `boxcall_identity_share_poc.nyash`
-
-## ▶ 実行コマンド例
-
-計測実行:
-```bash
-tools/run_vm_stats.sh local_tests/vm_stats_http_ok.nyash vm_stats_ok.json
-tools/run_vm_stats.sh local_tests/vm_stats_http_err.nyash vm_stats_err.json
-tools/run_vm_stats.sh local_tests/vm_stats_http_404.nyash vm_stats_404.json
-tools/run_vm_stats.sh local_tests/vm_stats_http_500.nyash vm_stats_500.json
-```
-
-VM×プラグインE2E:
-```bash
-cargo test -q --features plugins e2e_interpreter_plugin_filebox_close_void
-cargo test -q --features plugins e2e_vm_plugin_filebox_close_void
-```
-
-MIR26 PoC（弱参照・Barrier統合）:
-```bash
-# 弱フィールドPoC（flag OFF: WeakNew/WeakLoad/BarrierRead/Write）
-NYASH_VM_STATS=1 NYASH_VM_STATS_JSON=1 ./target/release/nyash --backend vm --vm-stats --vm-stats-json local_tests/weak_field_poc.nyash > vm_stats_weak_default.json
-
-# flag ON: WeakRef/Barrier 統合
-cargo build --release --features mir_refbarrier_unify_poc -q
-NYASH_VM_STATS=1 NYASH_VM_STATS_JSON=1 ./target/release/nyash --backend vm --vm-stats --vm-stats-json local_tests/weak_field_poc.nyash > vm_stats_weak_unified.json
-```
-
-MIRダンプ（プリンタ拡張後の確認）:
-```bash
-./target/release/nyash --dump-mir --mir-verbose local_tests/weak_field_poc.nyash | sed -n '1,200p'
-```
-
-MIRダンプ/検証:
-```bash
-nyash --dump-mir --mir-verbose examples/plugin_box_sample.nyash
-nyash --verify examples/plugin_box_sample.nyash
-```
-
-## 🔭 26命令ターゲット（合意ドラフト）
- コア: Const / Copy / Load / Store / BinOp / UnaryOp / Compare / Jump / Branch / Phi / Return / Call / BoxCall / NewBox / ArrayGet / ArraySet / RefNew / RefGet / RefSet / Await / Print / ExternCall(最小) / TypeOp(=TypeCheck/Cast統合) / WeakRef(=WeakNew/WeakLoad統合) / Barrier(=Read/Write統合)
- メタ降格: Debug / Nop / Safepoint（ビルドモードで制御）
-
---
-最終更新: 2025年8月25日（MIR26整合確認・VM and/or実装・Loop補強・CLI分離テスト導線/ResultBox移行TODO追加／スナップショット最小運用）
-
-## 🔁 再起動後の再開手順（ショート）
-```bash
-# 1) ビルド
-cargo build --release -j32
-
-# 2) plugins E2E（Linux）
-cargo test --features plugins -q -- --nocapture
-
-# 3) VM Stats 代表値の再取得（任意）
-tools/run_vm_stats.sh local_tests/vm_stats_http_ok.nyash vm_stats_ok.json
-tools/run_vm_stats.sh local_tests/vm_stats_http_err.nyash vm_stats_err.json
-
-# 4) SocketBox タイムアウト確認（任意）
-./target/release/nyash local_tests/socket_timeout_server.nyash
-./target/release/nyash local_tests/socket_timeout_client.nyash
-
-# 5) 反復タイムアウト確認（任意）
-./target/release/nyash local_tests/socket_repeated_timeouts.nyash
-
-# 6) HTTP 大ボディ確認（任意）
-./target/release/nyash local_tests/http_big_body_client.nyash
-
-# 7) VM BoxCall デバッグ（任意）
-NYASH_VM_DEBUG_BOXCALL=1 ./target/release/nyash --backend vm local_tests/test_vm_array_getset.nyash
-```
- MIR26 整合（候補1）確認:
-  - Printer: `--mir-verbose-effects` の `pure|readonly|side` 表記と TypeOp/WeakRef/Barrier/ExternCall の表示が整合。
-  - Verifier: SSA/支配/CFG/merge-phi に加え WeakRef/Barrier の最小検証＋Strict Barrier診断を実装（環境変数でON）。
-  - Optimizer: 未lowering検知（is/as/isType/asType）をBoxCall/Call両経路で検出、`NYASH_OPT_DIAG_FAIL=1` と連携。
-  - 代表スナップショット: extern_call/loop/boxcall/typeop_mixed をCIに追加、全件緑。
-  - 注: WeakRef/Barrier の“統合”はPoCフラグで切替可能（レガシー命令も支援）—MIR26はドキュメントの正典、実装は互換を維持。
-
-
-## ✅ 本日の成果（9.78h）
- MIR26命令のコード≡ドキュメント同期テストを追加（tests/mir_instruction_set_sync.rs）→ 緑
- スナップショット安定化（tools/snapshot_mir.sh に静音フィルタ、golden全緑）
- Phi選択の委譲スケルトンをVMへ実装（LoopExecutor::execute_phi）
- ResultBox移行スイープ（VMのレガシーbox_trait::ResultBox経路を削除、boxes::ResultBoxに統一）
- VM BoxRef演算フォールバック拡張（toString→parse<i64>、比較/四則/混在を広くカバー）
- ロガー導入（環境変数ONでのみ出力）:
-  - NYASH_DEBUG_EFFECTS / NYASH_DEBUG_VERIFIER / NYASH_DEBUG_MIR_PRINTER / NYASH_DEBUG_TRYCATCH
-  - NYASH_VM_DEBUG_REF / NYASH_VM_DEBUG_BIN / 既存の NYASH_VM_DEBUG_* 系
- VMユーザBoxのBoxCallをInstance関数へ橋渡し（InstanceBox → Class.method/arity へ委譲）
-
-## 🧪 テスト概況（要点）
- 緑: 175件 / 赤: 1件（`mir::verification::tests::test_if_merge_uses_phi_not_predecessor`）
- 失敗要旨: Mergeブロックで前任値使用と判定（DominatorViolation/MergeUsesPredecessorValue）
- 生成MIR（CLI/Builder）はmergeにphiを含むため、Verifier側の検査条件かvariable_map束縛の拾い漏れの可能性。
-
-### デバッグ用コマンド（ログON例）
-```bash
-# Effects純度
-NYASH_DEBUG_EFFECTS=1 cargo test --lib mir::effect::tests::test_effect_mask_creation -- --nocapture
-
-# Verifier（phi/merge）
-NYASH_DEBUG_VERIFIER=1 cargo test --lib mir::verification::tests::test_if_merge_uses_phi_not_predecessor -- --nocapture
-
-# Try/CatchのLowering/Printer
-NYASH_DEBUG_TRYCATCH=1 NYASH_DEBUG_MIR_PRINTER=1 cargo test --lib mir::tests::test_try_catch_compilation -- --nocapture
-
-# VM 参照/演算
-NYASH_VM_DEBUG_REF=1 cargo test --lib backend::vm::tests::test_vm_user_box_birth_and_method -- --nocapture
-NYASH_VM_DEBUG_BIN=1 cargo test --lib tests::mir_vm_poc::test_boxref_arith -- --nocapture
-```
-
-## 🎯 次の着手（残1の精密駆逐）
-1) Verifierのmerge-phi検査を補強（phi dst/variable束縛の対応づけ強化 or 条件緩和の適用）
-2) Builderのvariable_map束縛拾い漏れがあれば補修（Program直下パターンの明示）
-3) 代表MIRダンプをfixture化して回帰チェック（phi存在の有無を機械判定）
+## Doneの定義（P2PBox 最小）
+- `LocalLoopback` で ping/pong が安定
+- P2PBox API（start/stop/send/broadcast/reply/on）が固まる
+- ResultBox経由でエラーが伝搬（E2E テスト含む）
+- ログは既定静音（環境変数でデバッグオン）
+
+## Parking Lot（後でやる）
+- NyashValue enum導入（即値最適化）
+- トレイト階層化（Comparable/Arithmetic etc.）
+- メタプログラミング・パイプライン演算子
+- `mir_modular_builder` をデフォルト化（パリティ後）
--- a/docs/development/current/PLUGIN_LOADER_MIGRATION_PLAN.md
+++ b/docs/development/current/PLUGIN_LOADER_MIGRATION_PLAN.md
@ -0,0 +1,116 @@
+# Plugin Loader Migration Plan
+
+## Overview
+Consolidate three plugin loader implementations into a single unified system.
+
+## Current State
+1. **plugin_loader_v2.rs** (906 lines) - Main BID-FFI plugin system
+2. **plugin_loader.rs** (1217 lines) - Builtin box dynamic loading
+3. **plugin_loader_legacy.rs** (299 lines) - Legacy host vtable system
+
+Total: ~2400 lines of code with significant duplication
+
+## Target State
+- **plugin_loader_unified.rs** - Single unified loader (~800 lines)
+- **plugin_ffi_common.rs** - Shared FFI utilities (~300 lines)
+- Total: ~1100 lines (55% reduction)
+
+## Migration Steps
+
+### Phase 1: Infrastructure (DONE)
+- [x] Create plugin_loader_unified.rs skeleton
+- [x] Create plugin_ffi_common.rs for shared types
+- [x] Update runtime/mod.rs
+- [x] Basic compilation check
+
+### Phase 2: Common Pattern Extraction
+- [ ] Extract TLV encoding/decoding to plugin_ffi_common
+- [ ] Extract handle management patterns
+- [ ] Extract memory management utilities
+- [ ] Extract error handling patterns
+
+### Phase 3: BID Plugin Migration
+- [ ] Port PluginBoxV2 implementation
+- [ ] Port BID FFI invoke mechanism
+- [ ] Port plugin loading logic
+- [ ] Port configuration parsing
+- [ ] Migrate tests
+
+### Phase 4: Builtin Plugin Migration
+- [ ] Port FileBoxProxy and related proxies
+- [ ] Port dynamic library loading for builtins
+- [ ] Port builtin-specific FFI patterns
+- [ ] Migrate feature flags handling
+
+### Phase 5: Legacy Plugin Migration
+- [ ] Port host vtable implementation
+- [ ] Port legacy box creation
+- [ ] Decide on deprecation timeline
+
+### Phase 6: Integration
+- [ ] Update all references to old loaders
+- [ ] Ensure backward compatibility
+- [ ] Performance benchmarking
+- [ ] Documentation update
+
+### Phase 7: Cleanup
+- [ ] Remove old plugin loaders
+- [ ] Remove redundant tests
+- [ ] Update CLAUDE.md
+- [ ] Final code review
+
+## Technical Decisions
+
+### Unified Plugin Type Detection
+```rust
+fn detect_plugin_type(path: &str) -> PluginType {
+    // 1. Check file extension (.bid, .legacy, .builtin)
+    // 2. Check nyash-box.toml for type field
+    // 3. Probe for known symbols
+    // 4. Default to BID
+}
+```
+
+### Handle Management Strategy
+- Use generic `PluginHandle<T>` for all plugin types
+- Centralized handle registry in plugin_ffi_common
+- Reference counting with Arc<Mutex<T>>
+
+### Error Handling
+- Convert all errors to Result<T, String> at boundaries
+- Plugin-specific errors wrapped with context
+- Consistent error messages across all plugin types
+
+## Risk Mitigation
+
+### Backward Compatibility
+- Keep old loaders under feature flags during migration
+- Provide compatibility shims if needed
+- Extensive testing with existing plugins
+
+### Performance
+- Benchmark before and after migration
+- Profile hot paths (box creation, method dispatch)
+- Optimize only after correctness verified
+
+### Testing Strategy
+1. Unit tests for each component
+2. Integration tests with real plugins
+3. E2E tests with full applications
+4. Regression tests for edge cases
+
+## Success Metrics
+- [ ] Code reduction: 50%+ fewer lines
+- [ ] All existing tests pass
+- [ ] No performance regression
+- [ ] Cleaner API surface
+- [ ] Better error messages
+- [ ] Easier to add new plugin types
+
+## Timeline
+- Phase 1-2: Day 1 (Today)
+- Phase 3-4: Day 2-3
+- Phase 5-6: Day 4
+- Phase 7: Day 5
+
+Total: 5 days for complete migration