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. **マージ前確認必須:**
   ```bash
   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変換部分実装**: 限定的な構文のみ対応

**動作テスト結果:**
```bash
# ✅ 動作する構文
./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の基本実装)
- **実装内容**:
  - 基本値の保持・表示
  - 四則演算メソッド
  - 文字列変換
  - 比較演算子
- **テスト**: 
  ```nyash
  f = new FloatBox(3.14)
  print(f.add(2.86))  // 6.0
  print(f.toString()) // "3.14"
  ```

##### 2. **ArrayBoxの改良** - 配列機能の強化 📚
- **依存**: 既存ArrayBox実装
- **追加機能**:
  - sort()メソッド - 配列ソート
  - reverse()メソッド - 配列反転
  - indexOf()メソッド - 要素検索
  - slice()メソッド - 部分配列
- **テスト**:
  ```nyash
  arr = new ArrayBox()
  arr.push(3); arr.push(1); arr.push(2)
  arr.sort()  // [1, 2, 3]
  ```

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

##### 3. **基本演算子の改良** ➕➖✖️➗
- **依存**: 既存の演算子実装
- **改良内容**:
  - 型間演算の対応 (IntegerBox + FloatBox)
  - 文字列 + 数値の連結
  - より良いエラーメッセージ
- **テスト**:
  ```nyash
  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<Mutex>統一完了)
- 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段階実装方針決定！