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

Phase 12 Task Board (v2 - セルフホスティング対応)

Status: Tier-0 完了（vtable雛形 + レジストリ + VM優先経路）。次は Tier-1 の最小Nyash ABIサンプル実装へ。

目的: C ABI を壊さず、TypeBox + 統一ディスパッチで Nyash ABI を段階導入。MIR→VM→JIT を「綺麗な箱」で統一。最終的にRust依存を排除し、セルフホスティングを実現。

Tier-0（直近・安全に積める）

• MapBoxの実用拡張（stringキー/便利API）
• keys()/values() 実装（ArrayBox返却に更新）
• TypeBoxレジストリ（雛形）
  • Box名/FQN、type_id、メソッド表（静的スロット）を登録（src/runtime/type_registry.rs）
  • 既存 nyash.toml → TypeBoxInfo 変換層は別途（未着手）
• 統一ディスパッチ層（VM・雛形）
  • NYASH_ABI_VTABLE=1 で vtable優先のVM経路を有効化（fallbackはC ABI/TLV）。
  • Array/Map/String/Instance の主要メソッドを最小カバレッジで処理（try_boxcall_vtable_stub）。
  • 所有権・セーフポイントのガードは既存Barrier呼び出しで一部対応（MAY_BLOCK等は今後拡張）。
  • プラグインテスター更新（v2ローダに対応）: src/bin/test_plugin_loader_v2.rs

Tier-1（実証）

• Nyash ABI vtable の最小サンプル（1プラグイン・1メソッド）
  • 例: MapBox.getS(name) を Nyash ABI で直接返却
  • 単体テスト（VM/JIT）
• JIT側：統一ディスパッチthunkを呼ぶ経路を追加（フォールバックでも可）
• 互換テスト: C ABI と Nyash ABI が同一結果になる差分テスト

Tier-2（強化）

• NyashValueインライン（i64/bool）の高速化
• 例外/エラーの完全変換（panic→nyrt_err）
• 所有権契約の遵守（TRANSFER/BORROW/CLONE）
• keys()/values() の正式実装（ArrayBox返却）
  • 採用: ランタイムで ArrayBox を構築（src/boxes/map_box.rs）

Tier-3（セルフホスティング）🔥新規

• Nyash ABI C実装の開始
  • nyash_abi_provider.h定義（16バイトアライメント）
  • C Shim実装（Rust FFI経由）
  • 基本型実装（Tagged Pointers対応）
  • アトミック参照カウント実装
  • 弱参照による循環参照対策
• セレクターキャッシング実装
  • lookup_selector API
  • JIT統合（vtable_slot直接呼び出し）
• 適合性テストスイート構築
  • Rust/C実装の差分テスト
  • パフォーマンス測定（1.5x以内）

ドキュメント/管理

• UNIFIED-ABI-DESIGN.md の「最小導入プロファイル」明記
• VM/JIT実装メモ（統一ディスパッチの呼出し順）
• リファクタリング計画（>1000行ファイルの分割方針）

既知のやり残し（Phase 12 関連）

• TypeBoxレジストリ/統一ディスパッチのコード未導入
• Nyash ABI vtableの実装サンプル未着手
• 既存プラグインの対応（TypeBox vtable移行 or 互換レイヤ継続）
• GCセーフポイントのMAY_BLOCK以外の一般化
• keys()/values() の正式ArrayBox返却（現状はシム）
• AOT(LLVM)のbuild失敗（nyrt借用修正、後回し方針）
• Nyash ABI C実装（セルフホスティングの要）🔥新規

Doneの定義（Phase 12 - 更新版）

1. TypeBoxレジストリと統一ディスパッチがVMに入り、C ABI互換で全プラグインが動作
2. 1プラグインでNyash ABIの成功パスが通る（VM/JIT）
3. keys()/values() が ArrayBox 返却で安定
4. 基本の所有権・セーフポイントルールが守られる
5. Nyash ABI C実装の基礎が動作し、セルフホスティングへの道筋が明確🔥新規