feat(plugin): Fix plugin BoxRef return and Box argument support

- Fixed deadlock in FileBox plugin copyFrom implementation (single lock)
- Added TLV Handle (tag=8) parsing in calls.rs for returned BoxRefs
- Improved plugin loader with config path consistency and detailed logging
- Fixed loader routing for proper Handle type_id/fini_method_id resolution
- Added detailed logging for TLV encoding/decoding in plugin_loader_v2

Test docs/examples/plugin_boxref_return.nyash now works correctly:
- cloneSelf() returns FileBox Handle properly
- copyFrom(Box) accepts plugin Box arguments
- Both FileBox instances close and fini correctly

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <noreply@anthropic.com>

docs/reference/boxes-system/box-reference.md

@@ -0,0 +1,270 @@
+# 📦 Nyash Box型完全リファレンス
+
+Nyashで利用できる全ビルトインBox型の完全API仕様書です。
+
+## 📋 Box型分類
+
+### 🎯 基本型Box（Primitive Boxes）
+
+#### StringBox
+文字列を扱う基本Box型。
+
+```nyash
+local str = "Hello, Nyash!"  // 自動的にStringBox
+local explicit = new StringBox("Explicit creation")
+
+// メソッド
+str.length()         // 文字数を取得
+str.toUpperCase()    // 大文字変換
+str.split(",")       // 文字列分割
+str.contains("Nya")  // 部分文字列検索
+```
+
+#### IntegerBox
+整数を扱う基本Box型。
+
+```nyash
+local num = 42              // 自動的にIntegerBox  
+local big = new IntegerBox(1000000)
+
+// メソッド
+num.add(10)          // 加算
+num.multiply(2)      // 乗算
+num.toString()       // 文字列変換
+num.isEven()         // 偶数判定
+```
+
+#### FloatBox
+浮動小数点数を扱うBox型。
+
+```nyash
+local pi = 3.14159          // 自動的にFloatBox
+local precise = new FloatBox(2.718281828)
+
+// メソッド
+pi.round(2)          // 小数点以下2桁に丸める
+pi.ceil()            // 切り上げ
+pi.floor()           // 切り下げ
+pi.toString()        // 文字列変換
+```
+
+#### BoolBox
+真偽値を扱うBox型。
+
+```nyash
+local flag = true           // 自動的にBoolBox
+local explicit = new BoolBox(false)
+
+// メソッド
+flag.toString()      // 文字列変換
+flag.not()           // 論理反転
+```
+
+#### NullBox
+null値を表すBox型。
+
+```nyash
+local empty = null          // NullBox
+local check = empty.isNull() // true
+```
+
+### 🔢 計算・データ処理系
+
+#### MathBox
+数学関数を提供するBox型。
+
+```nyash
+local math = new MathBox()
+
+// メソッド
+math.sin(pi/2)       // サイン関数
+math.cos(0)          // コサイン関数  
+math.sqrt(16)        // 平方根
+math.pow(2, 8)       // べき乗
+math.random()        // 乱数生成
+```
+
+#### ArrayBox
+配列操作を行うBox型。
+
+```nyash
+local arr = new ArrayBox()
+
+// メソッド
+arr.push("item")     // 要素追加
+arr.get(0)           // 要素取得
+arr.set(0, "new")    // 要素設定
+arr.length()         // 長さ取得
+arr.clear()          // 全削除
+```
+
+#### MapBox
+連想配列（辞書）操作を行うBox型。
+
+```nyash
+local map = new MapBox()
+
+// メソッド
+map.set("key", "value") // キー・値設定
+map.get("key")          // 値取得
+map.has("key")          // キー存在確認
+map.keys()              // 全キー取得
+map.clear()             // 全削除
+```
+
+### 🔗 通信・ネットワーク系
+
+#### P2PBox
+P2P通信を行うノードを表すBox。
+
+```nyash
+// コンストラクタ
+local node = new P2PBox(node_id, world)
+```
+
+**パラメータ:**
+- `node_id` (String): ノードの一意識別子
+- `world` (IntentBox): 参加する通信世界
+
+**メソッド:**
+
+##### send(intent, data, target)
+```nyash
+local result = node.send("greeting", message_data, "target_node_id")
+```
+- `intent` (String): メッセージの種類
+- `data` (Box): 送信するデータ
+- `target` (String): 送信先ノードID
+- **戻り値:** StringBox("sent")
+
+##### on(intent, callback)
+```nyash
+node.on("chat", callback_function)
+```
+- `intent` (String): 監視するメッセージ種類
+- `callback` (MethodBox): 受信時に呼ばれる関数
+
+##### off(intent)
+```nyash
+node.off("chat")
+```
+- `intent` (String): 解除するメッセージ種類
+
+#### SocketBox
+TCP/IPソケット通信を行うBox型。
+
+```nyash
+local socket = new SocketBox()
+
+// サーバーモード
+socket.listen(8080)      // ポート8080でリッスン
+socket.accept()          // 接続受け入れ
+
+// クライアントモード  
+socket.connect("localhost", 8080) // 接続
+socket.send("Hello")     // データ送信
+socket.receive()         // データ受信
+socket.close()           // 接続終了
+```
+
+### 🖥️ I/O・GUI系
+
+#### ConsoleBox
+基本的なコンソールI/Oを行うBox型。
+
+```nyash
+local console = new ConsoleBox()
+
+// メソッド
+console.log("message")   // 標準出力
+console.error("error")   // エラー出力
+console.input()          // 標準入力
+```
+
+#### FileBox
+ファイル操作を行うBox型（プラグイン対応）。
+
+```nyash
+local f = new FileBox("data.txt")
+
+// メソッド
+f.write("content")       // ファイル書き込み
+f.read()                 // ファイル読み込み
+f.exists()               // ファイル存在確認
+f.close()                // ファイル閉じる
+```
+
+#### EguiBox
+GUI開発を行うBox型。
+
+```nyash
+local app = new EguiBox()
+
+// メソッド
+app.setTitle("My App")   // タイトル設定
+app.setSize(800, 600)    // サイズ設定
+app.run()                // GUI実行
+```
+
+### 🎮 特殊・デバッグ系
+
+#### DebugBox
+デバッグ・イントロスペクション用Box型。
+
+```nyash
+local debug = new DebugBox()
+
+// メソッド
+debug.startTracking()    // メモリ追跡開始
+debug.trackBox(obj, "desc") // オブジェクト追跡
+debug.memoryReport()     // メモリレポート
+```
+
+#### RandomBox
+乱数生成専用Box型。
+
+```nyash
+local rand = new RandomBox()
+
+// メソッド
+rand.next()              // 0-1の乱数
+rand.nextInt(100)        // 0-99の整数乱数
+rand.nextFloat(10.0)     // 0-10の浮動小数点乱数
+```
+
+#### TimeBox
+時間・日付操作Box型。
+
+```nyash
+local time = new TimeBox()
+
+// メソッド
+time.now()               // 現在時刻取得
+time.format("YYYY-MM-DD") // 時刻フォーマット
+time.addDays(7)          // 日数加算
+```
+
+## 🔌 プラグインBox
+
+Nyashはプラグインシステムにより、新しいBox型を動的に追加できます。
+
+### プラグイン設定（nyash.toml）
+```toml
+[plugins]
+FileBox = "nyash-filebox-plugin"
+DatabaseBox = "nyash-db-plugin"
+```
+
+### 型情報管理
+```toml
+[plugins.FileBox.methods]
+write = { args = [{ from = "string", to = "bytes" }] }
+read = { args = [] }
+```
+
+**詳細**: [プラグインシステム](../plugin-system/)
+
+---
+
+**最終更新**: 2025年8月19日 - Box型リファレンス統合版
+**関連ドキュメント**: [Everything is Box哲学](everything-is-box.md) | [プラグインシステム](../plugin-system/)