hakorune/docs/CURRENT_TASK.md

🎯 現在のタスク (2025-08-13 Native Nyash Phase 8 & AST→MIR完成)

🎯 2025-08-14 現在の進行状況

🚀 Native Nyash実装

• Phase 6: ✅ 完了（RefNew/RefGet/RefSet MIR命令実装）
• Phase 7: ✅ 完了（FutureNew/Await MIR命令実装）
• Phase 8.1: ✅ 完了（WASM基盤実装 - メモリ管理・ランタイム）
• Phase 8.2 PoC1: ✅ 完了（基本演算のMIR→WASM変換動作確認！）
  • PR #52マージ済み（2025-08-13）
  • 整数演算・print・return動作確認
  • 🌐 CLI統合完成: --compile-wasmオプション追加（2025-08-14）
  • 📦 Webブラウザ実行成功: Nyash→WASM→ブラウザ完全パイプライン
• Phase 8.2 PoC2: ✅ 完了（2025-08-14）
  • ⚡ ベンチマークシステム実装完成
  • 🏆 280倍パフォーマンス向上実証 (WASM vs Interpreter)
  • 📊 3バックエンド性能比較完全データ取得
• Phase 8.3: 🚧 進行中（Copilot作業）
  • Box操作のWASM対応（RefNew/RefGet/RefSet）
  • ⚠️ マージ競合注意: Claude追加機能との統合必要

📚 ドキュメント整備

• ✅ 実行バックエンド完全ガイド作成（2025-08-14）
  • インタープリター・VM・WASM の3実行方式統合ドキュメント
  • CLI使用方法・パフォーマンス比較・用途別推奨
• ✅ ベンチマーク機能ドキュメント追加（2025-08-14）
  • 実際の性能測定結果データ統合
  • --benchmark, --iterations オプション説明

🤝 Claude追加機能（2025-08-14実装）

⚡ ベンチマークシステム完全実装

追加ファイル:

• src/benchmarks.rs - ベンチマークフレームワーク（220行）
• benchmarks/bench_light.nyash - 軽量テスト（簡単算術）
• benchmarks/bench_medium.nyash - 中程度テスト（複合演算）
• benchmarks/bench_heavy.nyash - 重量テスト（50+演算）
• main.rs - CLI統合（--benchmark, --iterations）

機能詳細:

• 3つのバックエンド（Interpreter/VM/WASM）全自動比較
• 統計精度向上（指定回数実行・平均計算・速度比較）
• 詳細結果出力（実行時間・速度比・パフォーマンス解析）
• エラーハンドリング（ファイル不存在・実行失敗対応）

実証データ:

• WASM: 0.17ms平均（280倍高速化達成！）
• VM: 16.97ms平均（2.9倍高速化）
• Interpreter: 48.59ms平均（ベースライン）

🚨 Phase 8.3 Copilot協調戦略

競合回避ポイント:

1. ファイル競合予測:

   • src/main.rs - CLI引数パーサー（Claude修正済み）
   • src/lib.rs - benchmarksモジュール追加（Claude修正済み）
   • src/backend/wasm/ - WASM実装（Copilot修正予定）

2. マージ前確認必須:

   git status                 # 変更ファイル確認
   git diff HEAD~1           # Claude変更内容確認
   git log --oneline -5      # 最新commit履歴確認
   

3. 統合手順:

   • Phase 8.3 PR pull前にClaude変更をcommit
   • マージ競合発生時は機能優先度で解決
   • ベンチマーク機能維持を最優先
   • CLI統合は両機能を統合的に対応

協調実装推奨:

• ベンチマーク拡張: Phase 8.3のBox操作をベンチマーク対象に追加
• 性能検証: RefNew/RefGet/RefSetの性能影響測定
• ドキュメント統合: Box操作WASM対応の性能データ追加

📋 Phase 8.3 Issue #53詳細（Copilot担当）

実装範囲:

• RefNew/RefGet/RefSet WASMコード生成
• Box メモリレイアウト定義
• malloc/freeアロケータ改良
• NewBox MIR命令→WASM変換

成功基準（Copilot）:

• Box操作のend-to-end動作確認
• CI環境での全テストPASS
• --compile-wasmオプション正常動作
• 既存Phase 8.2互換性維持

Claude追加値（ベンチマーク活用）:

• 性能測定自動化: Copilot実装完了後、Box操作性能をベンチマーク自動測定
• 回帰テスト: 既存280倍高速化維持の検証
• Box操作ベンチマーク: bench_box_operations.nyash 新規作成検討

⚠️ 重要：AST→MIR Lowering未完成問題

🔍 現状分析 (2025-08-13)

MIR機能状況:

• ✅ MIR命令セット完成: 全Phase 6/7命令が実装済み・テストPASS
• ✅ VM実行エンジン完成: MIR→実行が正常動作
• ❌ AST→MIR変換部分実装: 限定的な構文のみ対応

動作テスト結果:

# ✅ 動作する構文
./target/release/nyash --dump-mir test_simple.nyash
# → 算術演算・print・return正常変換

# ❌ 未対応構文  
./target/release/nyash --dump-mir test_object.nyash
# → Error: BoxDeclaration support is currently limited to static box Main

./target/release/nyash --dump-mir test_nowait.nyash  
# → Error: Unsupported AST node type: Nowait

📋 AST→MIR Lowering 未実装リスト

• ユーザー定義Box: box DataBox { init { field } }
• オブジェクト生成: new DataBox()
• フィールドアクセス: obj.field
• フィールド代入: obj.field = value
• nowait構文: nowait f1 = 42
• await構文: await f1
• from構文: from Parent.method()
• override構文: override method() { ... }

🎯 実装戦略・優先順位

Phase 8と並行実装推奨:

1. Phase 8.1-8.2: WASM基盤・基本演算（現在動作する範囲）
2. AST→MIR拡張: オブジェクト操作対応
3. Phase 8.3: WASM オブジェクト操作実装
4. AST→MIR拡張: nowait/await対応
5. Phase 8.4: WASM Future操作実装

実装場所:

• src/mir/builder.rs:103 の build_expression() メソッド
• 特に Unsupported AST node type エラー箇所を拡張

🧪 ChatGPT5さんからの弱参照テスト追加タスク

実装予定のテスト（tests/integration_tests.rs）

• test_weak_field_cannot_finalize: weakフィールドに対して me.field.fini() を呼ぶとエラーになることを確認

  • コード: weak parent を持つ Child に対して me.parent.fini() を呼ぶ
  • 期待: 実行エラー（メッセージに "Cannot finalize weak field" を含む）

• test_usage_prohibited_after_fini: インスタンスを fini() 後にメソッド呼び出しすると使用禁止エラーになることを確認

• weak自動null化テスト

  • 親 p.fini() 後に c.isParentNull() が true になる

テスト実行のワークアラウンド

• 推奨: cargo test --tests -j32（examples除外）
• Windows向けexampleをビルド対象から一時外すか、CIのmatrixでexamplesをスキップ

追加検討事項

• weakの複数段/循環
• fini内でのカスケード順序検証

---

📋 以前の実装計画（参考）

📋 段階的実装計画（優先度順）

Phase 1: 基本型Box実装 (最優先)

1. FloatBox - 浮動小数点数Box 📊

• 依存: なし (f64の基本実装)
• 実装内容:
  • 基本値の保持・表示
  • 四則演算メソッド
  • 文字列変換
  • 比較演算子
• テスト:

  f = new FloatBox(3.14)
  print(f.add(2.86))  // 6.0
  print(f.toString()) // "3.14"
  

2. ArrayBoxの改良 - 配列機能の強化 📚

• 依存: 既存ArrayBox実装
• 追加機能:
  • sort()メソッド - 配列ソート
  • reverse()メソッド - 配列反転
  • indexOf()メソッド - 要素検索
  • slice()メソッド - 部分配列
• テスト:

  arr = new ArrayBox()
  arr.push(3); arr.push(1); arr.push(2)
  arr.sort()  // [1, 2, 3]
  

Phase 2: 演算子システム (高優先)

3. 基本演算子の改良 ➕➖✖️➗

• 依存: 既存の演算子実装
• 改良内容:
  • 型間演算の対応 (IntegerBox + FloatBox)
  • 文字列 + 数値の連結
  • より良いエラーメッセージ
• テスト:

  print(42 + 3.14)     // 45.14 (型変換)
  print("Value: " + 42) // "Value: 42"
  

4. 比較演算子の完全実装 🔍

• 実装内容:
  • ==, !=, <, >, <=, >= の完全対応
  • 型間比較のサポート
  • null比較の正しい動作
• テスト: 全ての型の組み合わせテスト

Phase 3: ユーティリティBox (中優先)

5. DateTimeBox - 日時操作 📅

• 依存: chrono crate (既存)
• 機能:
  • 現在時刻の取得
  • 日時の計算・比較
  • フォーマット変換
• テスト: 日時計算、文字列変換

6. FileBox - ファイル操作 📁

• 依存: std::fs
• 機能:
  • ファイル読み書き
  • 存在確認
  • ディレクトリ操作
• テスト: 基本的なファイル操作

🎯 今週の実装目標

今日 (2025-08-11): FloatBox実装

1. FloatBox構造体作成
2. 基本メソッド実装 (add, sub, mul, div)
3. Nyashからの使用テスト
4. インタープリター統合

明日: ArrayBox改良

1. sort()メソッド実装
2. reverse()メソッド実装
3. テストスクリプト作成・動作確認

明後日: 演算子改良

1. 型間演算の実装
2. エラーハンドリング改善
3. 包括的テスト

📊 実装ステータス

✅ 実装済み (Arc統一完了)

• StringBox, IntegerBox, BoolBox, NullBox
• ConsoleBox, MathBox, TimeBox, MapBox
• DebugBox, RandomBox, ArrayBox (基本)
• BufferBox, RegexBox, JSONBox, StreamBox

🚧 今回追加予定

• FloatBox (今日)
• ArrayBox改良 (明日)
• 演算子改良 (明後日)

📋 将来実装予定

• DateTimeBox, FileBox
• より複雑なBox (P2PBox等)

💭 重要な原則

1. 一つずつ確実に: 1つのBoxを完全に実装してから次へ
2. テストファースト: 必ずNyashスクリプトで動作確認
3. 段階的複雑化: シンプルから複雑へ
4. ビルド確認: 毎回cargo buildで確認
5. 依存関係注意: 複雑な依存は後回し

この方針で、確実で安定した実装を進めていきます！

---

最終更新: 2025-08-11 - シンプルBox段階実装方針決定！