# Current Task — JoinIR / PHI 削減スナップショット + Ring0/FileBox I/O パイプライン（2025-12-04 時点）

> このファイルは「今どこまで終わっていて、次に何をやるか」を把握するためのスナップショットだよ。
> 過去の詳細ログは `docs/private/roadmap2/CURRENT_TASK_2025-11-29_full.md` や各 Phase の README/TASKS を見てね。

---

## 🎉 Phase 133: ConsoleBox LLVM 統合 & JoinIR→LLVM 第3章完全クローズ（完了）✅ 2025-12-04

### 📋 実装内容

**目的**: ConsoleBox（log/println 系）の振る舞いを LLVM backend でも Rust VM と完全一致させる

**背景**:
- Phase 132 で PHI 順序問題解決（6/7 テスト達成）
- Phase 133 で ConsoleBox 統合により **7/7 完全達成**
- JoinIR → LLVM 第3章の完全クローズ

### 🔧 修正ファイル

| ファイル | 修正内容 | 重要度 | 行数 |
|---------|---------|-------|------|
| `src/llvm_py/console_bridge.py` | ConsoleLlvmBridge 箱（新規） | ⭐⭐⭐ | +250行 |
| `src/llvm_py/instructions/boxcall.py` | Console 分岐を箱に委譲 | ⭐⭐⭐ | -38行 +2行 |
| `tools/test_phase133_console_llvm.sh` | テストスクリプト（新規） | ⭐⭐ | +95行 |

### 💡 技術的解決策

**箱化モジュール化**:
- ConsoleBox メソッド (log/println/warn/error/clear) を `console_bridge.py` に集約
- BoxCall lowering 側の 40 行の分岐を `emit_console_call()` 1 行呼び出しに置き換え

**Phase 122 連携**:
- println/log エイリアス統一（slot 400）を LLVM 経路でも完全適用
- TypeRegistry と LLVM IR の一貫性確保

**ABI 設計**:
```llvm
declare i64 @nyash.console.log(i8* %ptr)
declare i64 @nyash.console.warn(i8* %ptr)
declare i64 @nyash.console.error(i8* %ptr)
declare void @nyash.console.clear()
```

### 📊 テスト結果

**Phase 133 完了時点**:
| ケース | Rust VM | LLVM (Phase 132) | LLVM (Phase 133) |
|--------|---------|------------------|------------------|
| peek_expr_block.hako | ✅ PASS | ✅ PASS | ✅ PASS |
| loop_min_while.hako | ✅ PASS | ✅ PASS | ✅ PASS |

**テスト実行結果**:
```bash
$ ./tools/test_phase133_console_llvm.sh
Total: 2
Passed: 2
Failed: 0
All tests PASSED! 🎉
```

### ✅ 実装完了チェックリスト

- ✅ ConsoleBox LLVM 統合の設計ドキュメント作成
- ✅ 現状実装の棚卸し（BoxCall lowering 周辺）
- ✅ ConsoleLlvmBridge 箱化モジュール実装（新規 250 行）
- ✅ ConsoleBox メソッドの LLVM runtime 関数マッピング実装
- ✅ BoxCall lowering 側を箱に委譲（分岐削除・レガシー削除）
- ✅ 代表ケース 2 本で LLVM 実行成功確認
- ✅ test_phase133_console_llvm.sh テストスクリプト作成
- ✅ phase133_consolebox_llvm_integration.md に実装結果追記
- ✅ CURRENT_TASK.md 更新（このセクション）

### 🏆 成果

**JoinIR → LLVM 第3章完全クローズ 🎉**:
- Phase 130-133 で 7/7 テスト達成（Rust VM と LLVM で完全一致）
- PHI 順序バグ構造的修正（Phase 132）
- ConsoleBox 箱化モジュール統合（Phase 133）
- JoinIR → LLVM 経路完全確立

**設計原則確立**:
- Console ロジックを 1 箇所に集約（箱化モジュール化）
- Phase 122 の println/log エイリアス統一を LLVM でも継承
- ABI 一貫性（Rust VM の TypeRegistry slot と LLVM runtime 関数）

### 🚀 次のステップ

**次のフェーズ候補**:
- **Phase 134**: selfhost Stage-4 拡張（より複雑なパターン対応）
- **Phase 135**: LLVM backend 最適化（String/Array 操作等）
- **Phase 136**: 別の大型改善フェーズ

---

## 🎯 Phase 132: LLVM PHI 命令順序バグ修正（完了）✅ 2025-12-04

### 📋 実装内容

**目的**: LLVM backend における「PHI 命令の配置順序バグ」を構造的に修正

**背景**:
- Phase 131 で LLVM backend re-enable 時に PHI 順序問題を発見
- LLVM IR では PHI 命令は BasicBlock の **先頭** に配置必須
- finalize_phis() が terminator（ret/br）の **後** に PHI を配置していた

### 🔧 修正ファイル

| ファイル | 修正内容 | 重要度 |
|---------|---------|-------|
| `src/llvm_py/phi_wiring/wiring.py` | ensure_phi() 関数の修正 | ⭐⭐⭐ |
| `src/llvm_py/phi_wiring/tagging.py` | setup_phi_placeholders() 強化 | ⭐⭐⭐ |
| `src/llvm_py/phi_placement.py` | 検証ユーティリティ（新規） | ⭐⭐ |
| `tools/test_phase132_phi_ordering.sh` | テストスクリプト（新規） | ⭐⭐ |

### 💡 技術的解決策

**根本原因**: llvmlite では命令を作成後に移動できない

**実装アプローチ**:
1. **早期 PHI 生成**: `setup_phi_placeholders` で全 PHI を block lowering 前に生成
2. **配置位置の明示的制御**: `position_before(instrs[0])` で既存命令より前に配置
3. **デバッグ機能**: 環境変数 `NYASH_PHI_ORDERING_DEBUG=1` で詳細ログ出力

**キーポイント**:
- PHI は block が空の状態で作成するのが最も確実
- `finalize_phis` は新規 PHI 作成ではなく、既存 PHI への incoming 配線のみ
- llvmlite の API 制約に適合した設計

### 📊 期待される動作

**修正前** (Phase 131):
```llvm
bb5:
  ret i64 %"ret_phi_16"
  %"ret_phi_16" = phi i64 [0, %"bb3"], [0, %"bb4"]  ; ❌ エラー！
```

**修正後** (Phase 132):
```llvm
bb5:
  %"ret_phi_16" = phi i64 [0, %"bb3"], [0, %"bb4"]  ; ✅ 正しい順序
  ret i64 %"ret_phi_16"
```

### 🧪 テスト方法

```bash
# デバッグモード有効化
export NYASH_PHI_ORDERING_DEBUG=1

# 個別テスト
NYASH_LLVM_USE_HARNESS=1 NYASH_LLVM_OBJ_OUT=/tmp/test.o \
  ./target/release/hakorune --backend llvm test.hako

# 自動テストスクリプト
./tools/test_phase132_phi_ordering.sh
```

### ✅ 実装完了チェックリスト

- ✅ LLVM PHI 規則の設計ドキュメント作成
- ✅ finalize_phis() 実装の詳細確認（約100行）
- ✅ PhiPlacement 責務箱の実装（phi_placement.py 新規作成）
- ✅ PHI 命令をブロック先頭に配置するロジック実装（ensure_phi 修正）
- ✅ setup_phi_placeholders のデバッグ機能強化
- ✅ phase132_llvm_phi_ordering.md に実装結果追記
- ✅ CURRENT_TASK.md 更新（このセクション）
- 📋 代表ケース 4-6 本で LLVM 実行成功確認（次の Phase で検証）

### 🏆 成果

**構造的修正完了**:
- PHI 生成タイミングの制御強化
- llvmlite API の制約に対応した実装
- デバッグ機能の充実

**設計原則確立**:
- PHI は必ず block lowering 前に生成
- finalize_phis は配線のみ、新規生成はしない
- position_before を使用した明示的配置

### 🚀 次のステップ

**Phase 133**: ConsoleBox LLVM 統合 & JoinIR→LLVM 完成
- Phase 132 で PHI 順序問題解決
- 残りタスク: ConsoleBox 統合で 7/7 テスト完全成功

---

## 🎯 Phase 140: ny-llvmc / LLVM v2 Migration 準備フェーズ（設計のみ）📝 2025-12-04

### 概要

**目的**: llvmlite ベースの LLVM backend を「JoinIR→LLVM 意味論のリファレンス」として一旦固定した上で、
純 Rust + LLVM toolchain による ny-llvmc ラインへの移行を「第4章」として進めるための **設計準備フェーズ** だよ。

- 現状:
  - Phase 130–132 で、llvmlite ラインの PHI 順序や ConsoleBox 周りを順次整備中。
  - ny-llvmc / nyash-llvm-compiler は存在するが、JoinIR/MIR14 に追従しきれていない中途半端な状態。
- 方針:
  - **第3章**: llvmlite ラインで JoinIR→LLVM の意味論を固める（PHI / Console / BoxCall など）。
  - **第4章（Phase 140+）**: その意味論を維持したまま ny-llvmc へ段階的に移行する。

### このフェーズでやること（設計のみ）

- docs 側に Phase 140 用のフェーズフォルダを作成:
  - `docs/private/roadmap2/phases/phase-140-llvmc-migration/README.md`
  - 役割: ny-llvmc 移行の全体像・サブフェーズ案（Phase 141–143）のメモ置き場。
- 既存の LLVM 関連 docs のインベントリ:
  - `phase-40-llvm-native-backend/`（過去の llvm-native backend 設計）。
  - `docs/development/current/main/phase130_joinir_llvm_baseline.md`（llvmlite ベースライン）。
  - ny-llvmc / nyash-llvm-compiler 関連 docs の一覧化（※実装にはまだ触らない）。
- CURRENT_TASK.md に「Phase 140: ny-llvmc 移行準備」が存在することを明示し、
  - 「今は設計フェーズのみ、実装は Phase 141+ に小さく分割する」方針を書き残しておく。

### 今後のサブフェーズ案（実装は別フェーズ）

- **Phase 141**: LLVM backend インベントリ & Mir→LLVM エントリポイント設計
- **Phase 142**: 共通インターフェース + llvmlite / ny-llvmc 並走テスト
- **Phase 143**: ny-llvmc を既定 backend に切り替え、llvmlite を開発用ハーネスに縮退

Phase 140 自体は「コードには一切触らず、橋に名前を付けるだけ」のフェーズだよ。
実際に橋を叩き壊して渡るのは Phase 141 以降に小さく分割していく予定だよ。

---

## 🎯 Phase 120: selfhost Stage-3 代表パスの安定化（完了）✅ 2025-12-04

### 📋 実装内容

**目的**: Phase 106-115 完了時点での selfhost 経路（Stage-3 .hako コンパイラ）のベースライン確立

**代表パス選定**:
1. **peek_expr_block.hako**: match 式・ブロック式（✅ PASS）
2. **loop_min_while.hako**: loop 構文・PHI 命令（✅ PASS）
3. **esc_dirname_smoke.hako**: 複雑な制御構造・StringBox 操作（⚠️ ConsoleBox.println エラー）

**実装成果**:
- ✅ 期待フロー整理: `docs/development/current/main/selfhost_stage3_expected_flow.md` 作成
- ✅ 実行調査完了: `NYASH_JOINIR_STRICT=1` での動作確認（/tmp/phase120_execution_results.txt）
- ✅ ベースライン確立: `docs/development/current/main/phase120_baseline_results.md` 作成
- ✅ スモークスクリプト: `tools/smokes/v2/profiles/integration/selfhost/phase120_stable_paths.sh` 作成
- ✅ 統合テスト成功: integration プロファイルで自動実行確認

### 📊 Phase 120 実行結果

**JoinIR Strict モード検証**（NYASH_JOINIR_STRICT=1）:
| 検証項目 | 結果 | 備考 |
|---------|------|------|
| If 文の JoinIR Lowering | ✅ 正常動作 | peek_expr_block.hako |
| Loop の JoinIR Lowering | ✅ 正常動作 | loop_min_while.hako |
| ControlForm 構造生成 | ✅ 正常動作 | header/body/latch/exit ブロック |
| PHI 命令生成 | ✅ 正常動作 | 分岐・ループでの値合流 |
| StringBox メソッド | ✅ 正常動作 | length, substring, lastIndexOf |
| ConsoleBox.println | ✅ **Phase 122で解消** | println → log に正規化 |

**統計**:
- ✅ **完全成功**: 2/3 プログラム（Phase 120 時点）
- ✅ **Phase 122 で 3/3 達成**: ConsoleBox.println 問題解消
- 📄 **作成ドキュメント**: 3 ファイル
- 🧪 **スモークテスト**: 統合完了（6 秒で自動実行）

### 🏆 Phase 120 の価値

**ベースライン First 原則の実践**:
```
Phase 106-115 完了
    ↓
Phase 120: 現状記録（ベースライン確立）← 今ここ
    ↓
Phase 121: 設計（hako_check 統合計画）
    ↓
Phase 122+: 実装修正（段階的改善）
```

**Phase 122+ への明確な課題リスト**:
- **優先度高**: ConsoleBox.println メソッドエラーの解決
- **優先度中**: NYASH_PARSER_STAGE3 deprecation 警告への対応
- **優先度低**: builtin Box の plugin 化推奨

**自動テストによる回帰検出**:
- integration プロファイルで自動実行
- 将来の変更による退行を即座に検出可能

### 🚀 次のステップ

**Phase 121**: hako_check JoinIR 統合設計（完了）✅

---

## 🎯 Phase 121: hako_check JoinIR 統合設計（完了）✅ 2025-12-04

### 📋 実装内容

**目的**: hako_check 経路を JoinIR 統合に向けて設計し、Phase 122+ 実装の指針を確立

**スコープ**:
1. ✅ **設計ドキュメント作成**: hako_check の役割・構造・JoinIR 統合方針を整理
2. ✅ **現状調査**: hako_check 実装の読解、JoinIR 関連の環境変数・フラグ洗い出し
3. ✅ **旧 MIR/PHI 経路の特定**: If/Loop の PHI 生成経路を明確化
4. ✅ **統合計画**: JoinIR 経路への移行ステップを設計（Phase 122-124）

### 📄 作成ドキュメント

| ドキュメント | ファイルパス | 内容 |
|-------------|------------|------|
| **設計ドキュメント** | `docs/development/current/main/hako_check_design.md` | hako_check の役割・実装構造・JoinIR 統合設計 |
| **現状調査** | `docs/development/current/main/phase121_hako_check_investigation.md` | エントリーポイント・MIR 生成経路・PHI 生成経路・環境変数の詳細調査 |
| **旧経路分析** | `docs/development/current/main/phase121_legacy_path_analysis.md` | 旧 MIR/PHI 経路の特定・JoinIR 経路との比較 |
| **統合ロードマップ** | `docs/development/current/main/phase121_integration_roadmap.md` | Phase 122-124 の実装計画・タイムライン・リスク管理 |

### 🔍 重要な発見

#### 1. hako_check は .hako スクリプト

**従来の認識**: hako_check は Rust バイナリの一部

**Phase 121 調査結果**: hako_check は `.hako スクリプト`として実装されている

**実装構造**:
```
tools/hako_check.sh (シェルスクリプトラッパー)
  ↓
tools/hako_check/cli.hako (.hako エントリーポイント)
  ↓
HakoAnalyzerBox.run() (静的解析メインロジック)
  ↓
hakorune --backend vm (Rust VM で実行)
  ↓
MirCompiler::compile() (AST → MIR 変換)
  ↓
MirBuilder::build_module() (MIR 生成・PHI 生成)
```

**影響**:
- JoinIR 統合は **VM の MirBuilder** に実装する必要がある
- hako_check 専用の実装は不要（VM 経路の改善で対応）

#### 2. If 文は旧経路、Loop は部分統合

**If 文** (`src/mir/builder/if_form.rs`):
- ❌ **旧 PHI 生成器を使用中**
- Phase 33-10 で JoinIR If Lowering が実装済み（`if_select.rs`）だが、MirBuilder への統合は未完
- **Phase 122 最優先課題**

**Loop** (`src/mir/builder/control_flow.rs`):
- ⚠️ **部分統合**（Phase 49 Mainline Integration）
- Mainline Targets（print_tokens, filter）のみ JoinIR 経由
- その他の Loop は旧 LoopBuilder へフォールバック
- **Phase 122 拡張課題**

#### 3. 環境変数未整備

**Phase 121 調査結果**: hako_check で JoinIR 経路を選択する統一的な環境変数がない

**Phase 122 で追加予定**:
- `NYASH_HAKO_CHECK_JOINIR=1`: hako_check で JoinIR 経路を有効化
- `NYASH_LEGACY_PHI=1`: 旧経路への明示的切り替え（Phase 123）

### 📊 統合計画サマリ

**3段階移行戦略**:

| Phase | 実装内容 | デフォルト | 環境変数 |
|-------|---------|-----------|---------|
| **Phase 122** | 環境変数で選択可能 | 旧経路 | `NYASH_HAKO_CHECK_JOINIR=1` で JoinIR |
| **Phase 123** | JoinIR デフォルト化 | JoinIR 経路 | `NYASH_LEGACY_PHI=1` で旧経路 |
| **Phase 124** | 旧経路完全削除 | JoinIR のみ | 環境変数削除 |

**タイムライン**（目安）:
- Phase 122: 1日（If 文 JoinIR 統合・Loop 拡張）
- Phase 123: 1日（デフォルト変更・警告追加）
- Phase 124: 1日（旧経路削除・クリーンアップ）
- **合計**: 3日で hako_check JoinIR 統合完了見込み

### 🏆 Phase 121 の価値

**設計 First 原則の実践**:
```
Phase 120: 現状記録（selfhost 経路ベースライン）
    ↓
Phase 121: 設計（hako_check 統合計画）← 今ここ
    ↓
Phase 122+: 実装（段階的統合）
```

**実装前に設計を確定**:
- 旧経路と JoinIR 経路の違いを明確化
- 実装ステップを詳細に計画
- リスク管理を事前に整理

**Phase 122+ への明確な指針**:
- If 文の JoinIR 統合が最優先課題
- Loop の JoinIR 統合拡張（Mainline Targets 制限解除）
- 段階的移行による互換性維持

### 🚀 次のステップ

**Phase 122**: ConsoleBox.println / log 統一（完了）✅

---

## 🎯 Phase 122: ConsoleBox.println / log 統一（完了）✅ 2025-12-04

### 📋 実装内容

**目的**: Phase 120 で発見された ConsoleBox.println エラーを根本解決

**問題**: esc_dirname_smoke.hako が selfhost Stage-3 + JoinIR Strict 経路で失敗
- エラーメッセージ: `Unknown method 'println' on ConsoleBox`

**解決策**: TypeRegistry / VM Method Dispatch レベルで println → log に正規化

### 📄 実装詳細

| 実装箇所 | ファイル | 変更内容 |
|---------|---------|---------|
| **TypeRegistry** | `src/runtime/type_registry.rs` | `CONSOLE_METHODS` に `println` (slot 400) 追加 |
| **ConsoleBox** | `src/boxes/console_box.rs` | `println()` メソッド追加（log への委譲） |
| **VM Dispatch** | `src/backend/mir_interpreter/handlers/calls/method.rs` | ConsoleBox 専用ハンドラ追加 |
| **Plugin設定** | `nyash.toml` | `println` (method_id 2) 追加 |

### ✅ テスト結果

**Phase 120 で失敗していたケース**:
- ❌ **Phase 120**: esc_dirname_smoke.hako → `Unknown method 'println' on ConsoleBox`
- ✅ **Phase 122**: esc_dirname_smoke.hako → **実行成功**

**出力確認**:
```
[Console LOG]
[Console LOG] dir1/dir2
```

**Phase 120 ベースライン更新**:
- ✅ 完全成功: **3/3 プログラム**（Phase 120 時点: 2/3）
- ✅ ConsoleBox.println 問題完全解消

### 🏆 Phase 122 の価値

**Alias First 原則の確立**:
```
ユーザーコード: ConsoleBox.println("...")
    ↓
VM TypeRegistry: println → slot 400（log と同じ）
    ↓
ConsoleBox 実装: log の実装が実行される
    ↓
出力: 標準出力にメッセージ表示
```

**正規化ポイントの一元化**:
- **TypeRegistry で管理**: VM レベルで alias を一元管理
- **MirBuilder 不関与**: 特別扱いなし、自然な設計
- **全経路統一**: JSON v0 / selfhost / 通常VM すべてで一貫

**Phase 120 連携**:
- Phase 120: selfhost 経路ベースライン確立 → **問題発見**
- Phase 122: TypeRegistry レベルで根本解決 → **ベースライン改善**

### 📄 ドキュメント更新

| ドキュメント | 更新内容 |
|-------------|---------|
| `phase122_consolebox_println_unification.md` | 設計・実装・テスト結果の完全記録 |
| `hako_logging_design.md` | ConsoleBox 使い方ガイド追加 |
| `logging_policy.md` | Phase 122 ガイドライン・正規化ルール追加 |
| `core_boxes_design.md` | Section 18: Phase 122 実装記録追加 |

### 🚀 次のステップ

**Phase 123**: hako_check 環境変数で JoinIR 選択可能に（予定）

---

## Ring0/FileBox I/O ライン - Phase 106-112 完全完成！ ✅ 2025-12-03

### 📦 Phase 106-112 完了サマリ

| Phase | 実装内容 | 状態 | 詳細 |
|-------|--------|------|------|
| **106** | provider_lock 整理・Fail-Fast 強化 | ✅ | CoreBoxId に責務一本化、MissingService チェック |
| **107** | Ring0.FsApi ↔ FileIo Bridge | ✅ | Ring0FsFileIo 実装、UTF-8 テキスト I/O パイプライン |
| **108** | FileBox write/write_all 実装 | ✅ | truncate mode（毎回上書き）、13 テスト PASS |
| **109** | RuntimeProfile 機構（Default/NoFs） | ✅ | 条件付き core_required、プロファイル対応完備 |
| **110** | FileHandleBox（ハンドルベース複数回アクセス） | ✅ | open/read/write/close ライフサイクル、7 テスト PASS |
| **110.5** | コード改善（优先度1-4） | ✅ | 8 unit + 4 integration テスト追加、エラー SSOT 確立 |
| **111** | append モード + metadata 拡張 | ✅ | "a" mode サポート、size/exists/is_file/is_dir、4 テスト PASS |
| **112** | Ring0 Service Registry 統一化 | ✅ | Ring0Registry factory pattern、NoFsApi 実装、拡張基盤完備 |
| **113** | FileHandleBox Nyash 公開 API | ✅ | ny_* メソッド公開、BoxFactory 登録、6 unit + 1 .hako テスト PASS |

### 🏗️ 設計の完成度

**Ring0 → Ring1 → Language の 3 層パイプライン完全実装**:

```
【Ring0 レイヤー】FsApi trait（read/write/append/metadata/exists）
        ↓
【Ring0.std_impls】std::fs 経由での実装
        ↓
【Ring1 FileIo】FileIo trait（open/read/write/close + mode 切り替え）
        ↓
【Ring1 Ring0FsFileIo】FsApi をラップ、mode ベースの truncate/append
        ↓
【Language】FileBox（ワンショット）+ FileHandleBox（複数回アクセス）
        ↓
【Profile】Default（全機能）/ NoFs（disabled）
```

### 📊 統計

- **総コミット数**: 8 commits (52c13e65 ~ Phase 113)
- **修正ファイル数**: 39 ファイル
- **コード行数**: +1,560 insertions, -150 deletions（設計 + 実装 + テスト）
- **テスト統計**: 39 テスト全 PASS（Unit + Integration + .hako）
- **ドキュメント**: 7 つの詳細指示書 + docs 更新（Phase 113 含む）

### 🚀 次フェーズ予定（Ring0/File I/O ラインは第1章クローズ）

- ~~**Phase 113**: FileHandleBox NyashBox 公開 API（.hako 側からの呼び出し）~~ ✅ 完了（2025-12-04）
- ~~**Phase 114**: FileIo 機能拡張（exists/stat/canonicalize）~~ ✅ 完了（2025-12-04）
- ~~**Phase 115**: FileHandleBox 箱化・モジュール化~~ ✅ 完了（2025-12-04）
- **Phase 116+**: Ring0 まわりは「バグ or 明確な必要が出たら叩く」モードに移行（並行アクセス・encoding・追加プロファイル等は Backlog に退避）

---

## Phase 115: FileHandleBox 箱化・モジュール化

**実装日**: 2025-12-04
**統計**:
- ny_* メソッド: 52行 → 8行（マクロ化で85%削減）
- テストヘルパー: handle_box.rs から外出し（tests/common/file_box_helpers.rs）
- コード行数: +112行, -62行（実質+50行でマクロ・ヘルパー・ドキュメント追加）
  - handle_box.rs: +72行, -62行（マクロ定義+ドキュメント追加）
  - tests/common/: +40行（新規ファイル2つ）

**効果**:
- ny_* メソッドの重複パターンをマクロで一元管理
- テスト共有化で保守性向上（tests/common/file_box_helpers.rs）
- 実装の意図がより明確に（Phase 115 コメント追加）
- 全27テスト PASS（0 failed, 1 ignored）

**修正ファイル**:
- `tests/common/file_box_helpers.rs`: 新規作成（+39行）
- `tests/common/mod.rs`: 新規作成（+1行）
- `src/boxes/file/handle_box.rs`: マクロ化・ドキュメント更新（+72行, -62行）

**実装詳細**:
1. **テストヘルパー外出し**: `setup_test_file`, `cleanup_test_file`, `init_test_provider` を tests/common/file_box_helpers.rs に移動
2. **ny_* メソッド統一化**: 4つのマクロ（ny_wrap_void, ny_wrap_string, ny_wrap_bool, ny_wrap_integer）で8メソッドを統一
3. **ドキュメント追加**: Phase 115 の Code Organization セクション追加

**技術的工夫**:
- マクロの `$display_name` パラメータで柔軟なエラーメッセージ生成（"write_all" → "write"）
- `#[allow(unused_mut)]` で &mut self パラメータの警告抑制
- `stringify!()` と `trim_start_matches("ny_")` でメソッド名の自動生成

---

## 0. 現在地ざっくり（JoinIR / selfhost ライン）

- **✅ JoinIR ラインは Phase 68 で一旦 Chapter Close！**
  - Phase 27-67 で JoinIR の「第1章（構造 + PHI + 型ヒント SSOT）」が完了。
  - 4つの柱（Structure / Scope / JoinIR / Type Hints）が確立。
  - Trio 削除ライン（Phase 70 完了）を経て、wasm/Web デモラインと最適化ラインに分岐。
  - 詳細: [phase-30-final-joinir-world/README.md](docs/private/roadmap2/phases/phase-30-final-joinir-world/README.md)

- **最終ゴール**
  - 制御構造と PHI の意味論は **JoinIR（＋LoopScopeShape/IfPhiContext 等の薄い箱）** に一本化する。
  - 実行の SSOT は VM / LLVM ラインとし、JoinIR→MIR→VM/LLVM は「構造 SSOT → 実行 SSOT」への変換として扱う。
  - 既存の PHI 箱（if_phi.rs / PhiBuilderBox / conservative.rs / Trio 等）は、JoinIR 側のカバレッジが十分になったところから順に削っていく。
- Stage-3 parser デフォルトON化（Phase 30.1 完了）: `config::env::parser_stage3_enabled()` で NYASH_FEATURES=stage3 をSSOT化し、legacy env は明示OFF専用の互換に縮退。
- JoinIR Strict 着手（Phase 81）: `NYASH_JOINIR_STRICT=1` で代表パスのフォールバックを禁止（JoinIR失敗は即エラー）。dev/trace は観測のみ継続。

- **これから（Phase 12x〜 JoinIR 第2章）**
  - wasm/Web デモライン: JoinIR ベースの軽量デモ実装（必要になったときに再開）。
  - 最適化ライン: JoinIR の最適化パスと LLVM/ny-llvmc 統合（Phase 12x+ 候補）。
  - Trio 削除ライン: 完了（Phase 70、LoopScopeShape SSOT）
  - JoinIR Strict ライン（Phase 81）: 代表 If/Loop/VM ブリッジについては `NYASH_JOINIR_STRICT=1` で常に JoinIR 経路のみを通すようにし、レガシー if_phi / LoopBuilder / 旧 MIR Builder は「未対応関数専用」に縮退。
  - **selfhost/hack_check ライン**: Stage‑3 selfhost 代表パスと `hako_check` を JoinIR Strict 経由で安定させ、「言語としての完成パス」を 1 本にする。

---

## 1. JoinIR 第1章完了までの道のり（Phase 33–67 簡潔版）

### Phase 33-62: 構造 + PHI + スコープの基盤構築 ✅ 完了

- **Phase 33-34**: IfSelect/IfMerge lowering 実装、AST→JoinIR Frontend 設計・実装（If/Loop/Break/Continue）
- **Phase 35-36**: PHI 箱削減 HIGH/MEDIUM（537行削減: if_body_local_merge / phi_invariants / LoopSnapshotMergeBox 縮退）
- **Phase 37-40**: If 側 PHI Level 1/2（設計＋array_ext.filter 移行、collect_assigned_vars 削除）
- **Phase 41-46**: If 側 PHI Level 3（NestedIfMerge、read_quoted_from、IfMerge 拡張）
- **Phase 49-56**: JoinIR Frontend 本線統合（print_tokens / filter）
- **Phase 57-62**: If 側 PHI 本体削減（conservative.rs 縮退、If Handler 箱化、PHI Core Cleanup）

**詳細**: 各 Phase の README を参照（`docs/private/roadmap2/phases/phase-*/README.md`）

---

### Phase 63-67: 型ヒントライン完全実装 ✅ 完了（2025-11-30）

#### Phase 63-3: JoinIR 型ヒント最小配線
- `JoinInst::Select` と `MergePair` に `type_hint: Option<MirType>` 追加
- 13ファイル更新、全 JoinIR テスト PASS

#### Phase 63-4: infer_type_from_phi 縮退設計
- 型ヒント優先＋従来ロジックフォールバック仕様を docs 化
- 削除条件 5/5 を定義（P1: IfSelectTest, P2: read_quoted/IfMerge, P3: Method/Box）

#### Phase 63-5: infer_type_from_phi 縮退実装
- `infer_type_from_phi_with_hint()` 実装（+44行）
- lifecycle.rs で呼び出し経路統一
- 削除条件達成率: 3/5（60%）

#### Phase 63-6: P1 ケース型ヒント完全実装
- `MirInstruction::Phi` に `type_hint` 追加（21ファイル修正）
- JoinIR→MIR Bridge で型ヒント伝播実装
- P1 ケース（IfSelectTest.*）で JoinIR 型ヒントのみで型決定
- 削除条件達成率: 4/5（80%）

#### Phase 64: P2 型ヒント拡大
- P2 ケース（read_quoted_from, IfMerge）型ヒント実装
- `is_type_hint_target()` 箱化（TypeHintPolicy 萌芽）
- 削除条件達成率: 4.5/5（90%）

#### Phase 65: P3-A/B 型ヒント実装
- P3-A: `type_inference.rs` 新設、`JoinInst::MethodCall` に型ヒント（StringBox メソッド）
- P3-B: `JoinInst::NewBox` に型ヒント（Box コンストラクタ）
- 代表ケースベースで削除条件 5/5 達成

#### Phase 66: P3-C ジェネリック型推論箱化
- `generic_type_resolver.rs` 新設（180行）
- `TypeHintPolicy::is_p3c_target()` 追加
- ArrayBox.get / MapBox.get 等のジェネリック型推論基盤確立

#### Phase 67: P3-C 実利用への一歩
- `phase67_generic_type_resolver.rs` テスト追加（3テスト全 PASS）
- lifecycle.rs に P3-C 経路フック追加（GenericTypeResolver 優先使用）
- A/B テストで旧経路との一致確認（11 tests PASS）

**技術的成果**:
- JoinIR が構造 + PHI + 型ヒントの SSOT として確立
- infer_type_from_phi は P3-C フォールバック専用に縮退
- 4つの柱（Structure / Scope / JoinIR / Type Hints）完成

### Phase 69: MIR 決定性 & Trio 経路の整理 ✅ 一部完了（2025-11-30）

- 目的: LoopSnapshotMergeBox / LoopForm 周辺の Inspector/Trio 依存を整理しつつ、MIR の predecessor 順を決定的にしてフラッキーテストを解消する。
- 実績:
  - 69-1: LoopSnapshotMergeBox と Trio 経路の現状を確認し、merge_exit_with_classification が LocalScopeInspectorBox を引き回しているだけであり、情報自体は LoopScopeShape/ExitAnalysis 側に揃っていることを整理。
  - 69-2: `merge_exit_with_classification` から Inspector 引数を削除し、LoopScopeShape/ExitAnalysis 経由で必要な情報を取る形に縮退（約 42 行削減）。既存の 3 テストはすべて PASS。
  - 69-3: `BasicBlock.predecessors` を `HashSet` → `BTreeSet` に変更するなど、MIR の predecessor イテレーションを決定的にし、これまで非決定性でフラッキーだった 2 つのループ系テストを安定化。loopform 14/14 / merge_exit 3/3 を含む関連テストはすべて PASS。
- 未了:
  - 69-5: conservative.rs の docs/ 移設も今後の小フェーズとして残しておく。
- 追加完了 (Phase 70):
  - 69-4: Trio 3 箱（LoopVarClassBox / LoopExitLivenessBox / LocalScopeInspectorBox）を削除し、LoopScopeShape を SSOT とする構成に移行。2025-12-01 時点でコードベース再スキャン済みで、Trio 本体ファイルおよび Trio Box 直接参照は **src/mir/** から完全に除去されていることを確認（名称としての「Trio」は docs の歴史メモ内にのみ残存）。

## 2. 次の一手（Phase 69+）

### 直近の候補タスク

- **P3-C 拡大 / If PHI 本体削除**（Phase 70+ 候補）
  - GenericTypeResolver 経由で全 P3-C ケースをカバー
  - `infer_type_from_phi` 本体削除と if_phi.rs 大掃除

- **Phase 71: Self‑Hosting 再ブートストラップ（初回観測完了！ 2025-12-02）** ✅
  - `docs/private/roadmap2/phases/phase-71-selfhost-reboot/README.md` で代表パス 1 本（Stage‑3 + JoinIR 前提）と ENV 方針を整理済み。
  - 代表パス（確定）: `NYASH_FEATURES=stage3 NYASH_USE_NY_COMPILER=1 NYASH_NY_COMPILER_EMIT_ONLY=1 NYASH_SELFHOST_KEEP_RAW=1 ./tools/selfhost/selfhost_build.sh --in apps/tests/stage1_run_min.hako --run`
  - **Phase 71初回実行成果 (2025-12-02)**:
    - ✅ Phase 70完了直後にPhase 71代表パス実行成功
    - ✅ RAW観測レイヤ活用成功 (`logs/selfhost/stageb_20251202_101623_2665649.log` 707K)
    - ✅ 根本原因特定: **SSA undef (4件)** + **dev verify (1件)** が Program JSON emit失敗を引き起こしている
    - ✅ JoinIR/プラグイン初期化は **問題なし** (JoinIR経路正常動作、プラグイン成功確認)
  - **SSA undef詳細 (初回観測時)**:
    1. `ParserCommonUtilsBox.trim/1` - ValueId(272)未定義
    2. `ParserBox.trim/1` - ValueId(272)未定義
    3. `Main._parse_number/1` - ValueId(12)未定義
    4. `ParserBox.parse_block2/2` - ValueId(440)未定義  
    → Phase 71-SSA での `.hako` 側整理により、現在はいずれも解消済み（SSA undef 13件→0件）。
  - **dev verify警告 (初回観測時)**: `StageBDriverBox` NewBox直後にbirth()未呼び出し  
    → StageBDriverBox が static box であることを考慮し、lifecycle.rs 側の特例で警告は解消済み。
  - **完了判定基準**: 観測窓としてのPhase 71は完了。代表 selfhost パスで JSON v0 emit→VM 実行（出力 `abc`）まで通ることを確認済みで、  
    SSA 修正は今後 Stage‑B 他ケースと s3/parity 系にフォーカスする。
  - **詳細レポート**: `docs/development/current/main/phase71-findings-20251202.md` と Phase 71-SSA 追加レポート
  - quick プロファイルでは JoinIR/VM 系は緑維持を目標としつつ、selfhost_minimal / stageb_min_emit は「SSA ラインの観測窓」として赤許容。Stage‑B/SSA 起因の赤は Phase 71-SSA 側でハンドルする。

- **Phase 72: JoinIR dev フラグ棚卸し** ✅
  - `config::env::joinir_core_enabled()` / `joinir_dev_enabled()` を追加し、Core/DevOnly/Deprecated の区分を整理。
  - `NYASH_JOINIR_EXPERIMENT` や `HAKO_JOINIR_IF_SELECT` を含む JoinIR 関連フラグの読み書きを、  
    `src/config/env/joinir_dev.rs` / `src/tests/helpers/joinir_env.rs` 経由の SSOT に統一（本体コードからの `std::env` 直読みを排除）。
  - docs/private/roadmap2/phases/phase-72-joinir-dev-flags/README.md に一覧表と実装状況メモを追加済み。

- **Phase 73: ENV 整理・不要フラグ削除（JoinIR＋Stage‑3 周辺）**
  - docs/private/roadmap2/phases/phase-73-env-cleanup/README.md に Stage‑3 / JoinIR / その他 ENV の棚卸しと Dead/Alias/Keep の分類方針を追加
  - 実コードからは `parser_stage3_enabled()` / `joinir_core_enabled()` / `joinir_dev_enabled()` 経由で判定し、legacy/env 名は Alias-only 扱いとして段階的に削除候補へ寄せていく
  - Stage‑3 旧 ENV は tools/selfhost/hako_check + JoinIR/LoopForm/PHI テスト + Stage‑1/SSA 代表テスト（Batch‑C）からは排除済みで、残りは dev/perf 用や一部 SSA/Stage‑B 系テストと docs の歴史メモに限定されている（Phase 73‑11 で現状を棚卸し済み）

- **Phase 73-7: Stage‑3 旧 ENV の縮退**
  - tools/selfhost/hako_check から `NYASH_PARSER_STAGE3` / `HAKO_PARSER_STAGE3` を順次削除し、Stage‑3 gate を `NYASH_FEATURES=stage3` ベースに移行開始
  - Rust tests 側の Stage‑3 alias は次フェーズでグループごとに `NYASH_FEATURES=stage3` へ寄せる予定

- **Phase 73-8: Rust tests Batch‑A の Stage‑3 ENV 縮退**
  - JoinIR/PHI 周辺の代表テスト（mir_loopform_* / mir_joinir_* の一部）を対象に、`NYASH_PARSER_STAGE3` / `HAKO_PARSER_STAGE3` を `NYASH_FEATURES=stage3` に置き換え開始

- **Phase 73-9: Rust tests Batch‑B の Stage‑3 ENV 縮退**
  - 残りの JoinIR 系テスト（joinir_runner_min / mir_joinir_* / joinir_json_min / joinir_vm_bridge_* / joinir/mainline_phase49）についても、Stage‑3 旧 ENV を廃止し `NYASH_FEATURES=stage3` ベースに統一

- **wasm/Web デモライン**（Phase 71 候補）
  - JoinIR ベースの軽量デモ実装
  - ブラウザで動く最小構成

- **最適化ライン**（Phase 72+ 候補）
  - JoinIR 最適化パス実装
  - LLVM/ny-llvmc 統合強化

### 今後の優先タスク順（selfhost + hack_check 観点の整理）

1. **Phase 71-SSA/selfhost 再ブートストラップの収束**
   - 代表パス（selfhost_build + stage1_run_min.hako）が JSON v0 emit→VM 実行まで通ることは確認済みとし、
     以降は Stage‑B 他ケースと s3/parity 系を「SSA ラインの観測窓」として整理していく。
   - この段階では JoinIR Strict は代表 if/loop/VM ブリッジに限定し、selfhost_minimal/stageb_min_emit の赤は SSA 側の課題として扱う。
2. **Phase 72–73: ENV / JoinIR dev フラグの集約完了** ✅
   - `joinir_core_enabled()` / `joinir_dev_enabled()` / `parser_stage3_enabled()` を SSOT として使い切り、tools/selfhost/hako_check/tests から旧 ENV を整理する。
   - ここまでで「selfhost / hack_check / tests が同じ Stage‑3 + JoinIR/ENV ポリシー上に乗る」状態を目指す。
3. **Phase 80: VM/LLVM 本線の JoinIR 統一** ✅ **完了**（2025-12-02 c61f4bc7）
   - 代表 if/loop の本線化を実装。`joinir_core_enabled()` 時は JoinIR→MIR 経路が既定となり、レガシー経路は JoinIR 未対応ケース専用に縮退。
   - SSOT ヘルパー（`should_try_joinir_mainline()` / `should_panic_on_joinir_failure()`）を実装。
   - **Phase 82**: JOINIR_TARGETS テーブル SSOT 化（93f51e40）完了。
4. **Phase 81: selfhost 用 JoinIR Strict＋fail-fast の確立** ✅ **完了**（2025-12-02 a9e10d2a）
   - selfhost_build.sh に `--core` / `--strict` オプション追加。環境変数 `NYASH_JOINIR_CORE` / `NYASH_JOINIR_STRICT` を子プロセスに自動伝播。
   - 代表パス（skip_ws / trim / resolve / print_tokens / filter / Stage‑1/Stage‑B 代表）が JoinIR 経由でのみ通る Strict モード実装完了。
   - hack_check ラインは引き続き「Stage‑3 + 旧 MIR Builder + VM」の安定ルートとして維持。
5. **Phase 82-if-phi-retire: P3-C 完了＋if_phi.rs 削除ライン** ← **継続中**
   - dev フラグ `NYASH_PHI_FALLBACK_DISABLED=1` で `infer_type_from_phi_with_hint` の呼び出しを fail-fast 検出する経路を追加済み（joinir_dev::phi_fallback_disabled）。
   - `lifecycle.rs` の return 型推論バグ（中間値 `const void` を見てしまう問題）を修正し、Case D を 51 件 → 20 件に削減済み。
   - Phase 83〜84-4 による追加削減で Case D は 0 件となり、`infer_type_from_phi*` への依存は実質的になくなった。コード上の定義削除と `phi_core::if_phi` モジュールの整理は Phase 84-5（if_phi.rs 削除ライン）で実施予定。

6. **Phase 83-typehint-p3d: 既知メソッド戻り値型推論（P3-D）** ✅ **完了**
   - ChatGPT Pro 設計の MethodReturnHintBox を実装（8ae1eabc）。`TypeHintPolicy` → `MethodReturnHintBox` → `TypeAnnotationBox` → `GenericTypeResolver` という箱構造を確立。
   - BoxCall/Call/TypeOp の既知メソッド戻り値型を P3-D として吸収し、Case D を 20 件 → 15 件に削減。
   - 将来の Method Registry 統一時にも差し替えやすい API になっており、型ヒントラインの構造的な整理が完了。

7. **Phase 84-1: Const 命令型アノテーション** ✅ **完了**
   - `src/mir/builder/emission/constant.rs` に Integer/Bool/Float/Null/Void 用の型登録を追加（40dfbc68）。String と同様に `value_types` へ MirType を記録。
   - Case D のうち Const 命令の型欠如が原因だったグループを解消し、Case D は 15 件 → 12 件に縮小。
   - 残り 12 件は Copy/PHI 経由の edge パターン（Loop break/continue / If merge など）に集中しており、Phase 84-2/84-3 の対象として切り出された。

8. **Phase 84-2: CopyTypePropagator による Copy 型伝播** ✅ **完了**
   - `src/mir/phi_core/copy_type_propagator.rs` に CopyTypePropagator 箱を追加し、MIR 関数内の `Copy { dst, src }` を固定点ループで走査して `value_types` に型を伝播。
   - `lifecycle.rs` の return 型推論前に CopyTypePropagator を走らせることで、Copy チェーンだけで説明できる Case D を削減（12 件 → 9 件）。
   - ベースラインテストは 489 passed, 34 failed → 494 passed, 33 failed と改善。残りの Case D は await/try-catch や多段 PHI など PHI 主体のパターンに集中しており、Phase 84-3（PhiTypeResolver）での限定的な PHI 型推論強化に引き継ぎ。

9. **Phase 84-3: PhiTypeResolver による PHI + Copy グラフ推論** ✅ **完了**
   - `src/mir/phi_core/phi_type_resolver.rs` に PhiTypeResolver 箱を追加し、`Copy`/`Phi` グラフを DFS/BFS で辿って末端の base 定義型が 1 種類に揃う場合のみ MirType を返す仕組みを実装。
   - lifecycle.rs の return 型推論フローに統合し、P3-D / Const / CopyTypePropagator で埋まらない一部ケースを吸収することで Case D を 9 件 → 4 件に削減。
   - 残り 4 件（await 構文 / QMark 構文 / Stage1 CLI 2 テスト）は、BoxCall/Await/QMark の戻り値型が `value_types` に未登録なことが原因であり、PhiTypeResolver 自体の限界ではないことが Task 調査で確認された（Phase 84-4 の BoxCall/Await 型登録ラインに引き継ぎ）。

10. **Phase 84-4: BoxCall 戻り値型登録（Await/QMark 含む）** ✅ **完了**
    - `src/mir/builder/utils.rs` に `infer_boxcall_return_type()` ヘルパーを追加し、StringBox/IntegerBox/BoolBox/ArrayBox/MapBox/Result-like（QMark 相当）/Stage1CliBox など計 27 メソッドの戻り値型を一元管理。
    - BoxCall lowering 経路（emit_box_or_plugin_call 相当）から `infer_boxcall_return_type()` を呼び出し、戻り値 ValueId に対応する MirType を `value_types` に登録。
    - Await/QMark 系は BoxCall 経路の型登録で全て解消され、追加の Await 専用実装は不要。
    - `NYASH_PHI_FALLBACK_DISABLED=1 cargo test --release --lib` 実行時の Case D panic は 4 件 → 0 件となり、Case D 完全解消を達成。型生成（Const/BoxCall）・型伝播（CopyTypePropagator/PhiTypeResolver）・統合（GenericTypeResolver）の 3 層構造が箱として完成し、if_phi フォールバック削除に進める状態になった（Phase 84-5 / 82 の最終仕上げ）。

11. **Phase 85-ring0-runtime: Ring0/Ring1/Plugin 層の設計整理** ⏳ **設計中**
    - Ring0 は Box を知らない最小カーネル API（Mem/Io/Time/Log/Fs/Thread 等）に限定し、実装は `Ring0Context` + adapter 1 箇所に集約する方針を docs に固定済み。
    - Ring1-core（StringBox/ArrayBox/MapBox/FileBox/ConsoleBox 等）と ring1-optional/selfhost/user_plugin を 4 層に分類し、「core_required は静的必須セット、optional と user は PluginHost の上に載る」設計を言語化済み。
    - `docs/development/current/main/ring0-inventory.md` に println!/eprintln! や fs/time/thread を含む Ring0 候補呼び出し、Box/プラグイン/カーネル実装数の調査結果をまとめ、Phase 88/90 で代表パスを Ring0Context に移行済み（残りは Phase 99 以降の段階移行対象）。
    - Phase 87–97 で CoreBoxId/CoreMethodId/CoreServices/PluginHost/Adapter/Service API の実装とテストが完了し、Box 名・メソッド名と core_required Box の初期化は `src/runtime/core_box_ids.rs` と `src/runtime/core_services.rs` に集約された。Phase 98 で Console/String/Array/Map の代表パス 7 箇所が CoreServices 経由に切り替わり、今後の ring0/ring1-core 変更はこの SSOT に対してのみ行えばよい状態になっている。
    - **Phase 95.5: Ring0 統合完了**（2025-12-03）
      - ✅ ConsoleService が Ring0Context に直結（println → Ring0Context.log.info, print → Ring0Context.io.stdout_write）
      - ✅ StringService が純粋関数化（Box 状態不要）
      - ✅ #[allow(dead_code)] 削減: 6箇所 → 4箇所（2削減）
      - ✅ ログ経路統一: Ring0 → Ring1-Core → 実行パス
      - **設計原則確立**: Ring0 直結型（ConsoleService）と純粋関数型（StringService）の2パターン
      - **次のステップ**: Phase 96 で ArrayService/MapService 実装（状態管理必要）、代表パス拡大（5-10箇所）
    - **Phase 96: ArrayService/MapService 実装**（2025-12-03）
      - ✅ ArrayService/MapService 実装完了（downcast型パターン）
      - ✅ #[allow(dead_code)] 根絶: 4箇所 → 0箇所（完全削減）
      - ✅ 3つのサービス実装パターン確立（Ring0直結/純粋関数/downcast型）
    - **Phase 97: IntegerService/BoolService 実装**（2025-12-03）
      - ✅ IntegerService/BoolService 実装完了
      - ✅ CoreServices 5種類完成（Console/String/Array/Map/Integer/Bool）
      - ✅ プリミティブ型の完全統合達成
    - **Phase 98: ConsoleService 代表パス拡張**（2025-12-03）
      - ✅ console_println! マクロ導入（Graceful Degradation 実装）
      - ✅ 7箇所で println!/eprintln! → console_println! 移行完了
      - ✅ selfhost/VM 実行経路の代表パスカバー達成
    - **Phase 98.5: Arc 簡略化 & コメント統一**（2025-12-03）
      - ✅ #[allow(clippy::arc_with_non_send_sync)] 削減: 4箇所 → 1箇所
      - ✅ 全 CoreServices に統一コメント追加
      - ✅ コード品質向上（Clippy warnings 削減）
    - **Phase 99: ログ/出力ポリシー確定**（2025-12-03）
      - ✅ logging_policy.md 新規作成（3層分離設計・マクロポリシー・テスト方針を文書化）
      - ✅ ring0-inventory.md 更新（println! 残件分類・Ring0.log 活用計画を記載）
      - ✅ core_boxes_design.md Section 15.6-A 追記（統一設計の補強）
      - ✅ 残り ~1477 箇所の println!/eprintln! を「後工程で片付けられる設計」に整理
      - **設計フェーズのみ**: コード変更なし、docs ベースでポリシー確定
    - **Phase 100: user-facing 出力の CoreServices 化**（2025-12-03）
      - ✅ selfhost.rs: 6箇所 → console_println!（CoreInitError, Result 出力）
      - ✅ llvm.rs: 23箇所 → console_println!（エラー、成功メッセージ、実行結果）
      - ✅ 合計 29箇所完了（Phase 98: 7 + Phase 100: 29 = 36箇所）
      - ✅ cargo build --release 成功、全テスト PASS（core_services: 11, plugin_host: 7）
      - ✅ デバッグログとユーザー向け出力の明確な分離達成
      - **除外**: llvm.rs の `[joinir/llvm]`, `[parse/context]` デバッグログ（Phase 101-A で対応）
      - **次のステップ**: Phase 101-102 で残り ~330箇所の段階的移行
    - **Phase 101-A: dev-debug ログの Ring0.log 統一**（2025-12-03）← NEW
      - ✅ llvm.rs: 13箇所 → Ring0.log（`[joinir/llvm]`, `[parse/context]`）
      - ✅ loop_form.rs: 全 `[loopform]` ログ → Ring0.log
      - ✅ phi_core: 21箇所 → Ring0.log（`[loopform/prepare]`, `[loopform/seal_phis]`, `[Option C]`）
      - ✅ 合計 34箇所完了（llvm: 13 + loop_form: すべて + phi_core: 21）
      - ✅ cargo build --release 成功（警告のみ、エラーなし）
      - ✅ VM実行テスト: loop_min_while.hako 正常動作
      - ✅ Ring0.log で dev-debug ログを一元管理達成
      - **環境変数**: `NYASH_LOOPFORM_DEBUG=1`, `NYASH_OPTION_C_DEBUG=1` で制御
      - **次のステップ**: Phase 101-B/C で残り ~585箇所の段階的移行
    - **Phase 101-B: internal/test ログ整理（Rust 側）**（2025-12-04）
      - ✅ internal/dev println!/eprintln! 113箇所を Ring0.log に移行（provider_lock / plugin_loader_unified / type_meta / deprecations / leak_tracker / provider_verify / scheduler / gc_controller / box_registry / plugin_loader_v2 周辺 / runner trace / mir verifier / mir core basic_block/control_form/hints/effect/printer/optimizer / loop_builder/phi_ops / builder/type_registry / region/observer / extern_functions / plugin types finalize trace / joinir_if_phi_selector / observe/types+resolve / join_ir_vm_bridge_dispatch run_generic / loop_builder/control など）
      - ✅ logging_policy.md / ring0-inventory.md にテスト出力許容ポリシーと残件概算を追記（残 ~475–495）
      - ⏭️ 残り internal/dev ログは Phase 101-C 以降で段階的に処理（user-facing/.hako は別ライン）
    - **Phase 104: .hako側ロギング設計**（2025-12-04）
      - ✅ ConsoleBox適切な使い方ガイド作成
      - ✅ 4つのロギングカテゴリ確立（user-facing/dev-debug/monitoring/internal Rust）
      - ✅ 3つのロギングBoxパターン設計（Lightweight/Structured/Contextual）
      - ✅ hako_logging_design.md 作成、logging_policy.md 更新
      - **スコープ**: .hako アプリケーション側のロギングベストプラクティス確立
    - **Phase 105: Logger Box Framework設計**（2025-12-04）
      - ✅ Logger Box インターフェース設計（ログレベル: DEBUG/INFO/WARN/ERROR）
      - ✅ 3つの設計パターン文書化（Lightweight/Structured/Contextual）
      - ✅ リファレンス実装例作成（pseudo-code、実行テストは Phase 106+）
      - ✅ logger_box_design.md 作成（500+ lines）
      - ✅ logging_policy.md / hako_logging_design.md / ring0-inventory.md にクロスリファレンス追加
      - **スコープ**: 設計＋ドキュメントのみ（Rust実装なし、Phase 106+で実装）
      - **成果**: ConsoleBox基盤の構造化ロギングフレームワーク確立
      - **次のステップ**: Phase 106（FileBox provider_lock & Fail-Fast）、Phase 107（FsApi 統合 or Logger 出力先拡張）
    - **Phase 106: FileBox provider_lock & Fail-Fast**（2025-12-03）
      - ✅ FileBox provider_lock 機構実装（OnceLock ベース）
      - ✅ CoreBoxId.is_core_required() による Fail-Fast チェック
      - ✅ 設計統一（案B）: provider_lock SSOT 化
      - ✅ テスト完了: plugin_host tests 全PASS
    - **Phase 107: FsApi / FileIo 統合**（2025-12-03）
      - ✅ Ring0FsFileIo 実装（Ring0.FsApi 経由の FileIo）
      - ✅ FileBox → Ring0FsFileIo → Ring0.FsApi → std::fs パイプライン確立
      - ✅ 自動登録機構: with_core_from_registry() で Ring0FsFileIo を自動登録
      - ✅ テスト完了: ring0_fs_fileio tests 全PASS
    - **Phase 108: FileBox write/write_all 実装**（2025-12-03）✅ **完了**
      - ✅ FileIo trait に write() メソッド追加
      - ✅ Ring0FsFileIo に write() 実装（truncate mode）
      - ✅ FileBox.write() / write_all() が Ring0.FsApi 経由で動作
      - ✅ FileCaps.write = true（標準プロファイルで書き込み対応）
      - ✅ テスト完了: Round-trip / truncate / read-only provider 拒否 全PASS
      - **設計決定**: write mode は truncate（毎回上書き）、append は Phase 109+
      - **次のステップ**: Phase 109（minimal/no-fs プロファイル）、Phase 110（FileHandleBox）

12. **Phase 86: BoxFactory Priority 正常化** ✅ **完了**（2025-12-02）
    - **目的**: BoxFactory のデフォルトポリシーを `BuiltinFirst` から `StrictPluginFirst` に変更し、プラグイン版 Box が正常に使用できるよう正常化。
    - **実装内容**:
      - ✅ 現状仕様の文書化（`docs/development/current/main/factory_priority.md`）
      - ✅ `UnifiedBoxRegistry::new()` を 1 行修正（`with_policy(BuiltinFirst)` → `with_env_policy()`）
      - ✅ テスト 5 件追加・全パス（default policy / env override / reserved protection / plugin override / non-reserved priority）
      - ✅ Phase 85 README 準備完了（`docs/private/roadmap2/phases/phase-85-ring0-runtime/README.md`）
    - **効果**:
      - プラグイン版 StringBox/ArrayBox/MapBox が正常に使用可能に
      - core_required Box（StringBox/IntegerBox/BoolBox/ArrayBox/MapBox 等）の予約名保護維持
      - 環境変数 `NYASH_BOX_FACTORY_POLICY` による柔軟な制御が可能
      - テスト改善：500 passed, 34 failed → 506 passed, 33 failed（+6 passed, -1 failed）
    - **詳細**: [factory_priority.md](docs/development/current/main/factory_priority.md)

### バックログ

#### ロギングフレームワーク拡張（Phase 106+）

- **Phase 106: Logger Box 出力リダイレクト**
  - Logger Box から FileBox へのログ出力機能実装
  - Logger Box から NetworkBox へのリモートログ送信機能実装
  - Phase 105 で設計した interface 互換性維持

- **Phase 107: アプリケーション移行**
  - hako_check を Logger Box 使用に移行
  - selfhost-compiler を Logger Box 使用に移行
  - Nyash ツール全体のロギング標準化

- **Phase 108+: 高度ロギング機能**
  - 構造化ロギング（JSON format）
  - ログアグリゲーション
  - パフォーマンスメトリクス

#### その他

- Stage‑B/selfhost smokes の扱い整理（Phase 30.1 フォロー）
  - quick プロファイルで `stage1_launcher_*` / `phase251*` 系が Stage‑3 デフォルト環境で不安定。今後、quick では SKIP にするか、Stage‑B emit 抽出ロジックを安定化するかを決める。
  - `MirFunction.blocks: HashMap` → `BTreeMap` で非決定的テスト解消
  - Phase 25.1 同様のパターン適用
  - selfhost Stage‑B 子プロセスへのソース渡し経路の簡素化（`--source "$SRC_CONTENT"` で argv を肥大化させず、HAKO_SRC 環境変数や一時ファイル経由に統一する設計を将来フェーズで検討）。

- Phase 71-SSA: Stage‑B / selfhost ラインは「SSA デバッグ用の観測窓」として切り出し、  
  代表パス（selfhost_build + stage1_run_min.hako）が JSON v0 emit まで通るかどうかを別フェーズで追う。  
  詳細: `docs/private/roadmap2/phases/phase-71-ssa-debug/README.md`

- Phase 81-JoinIR-Strict: JoinIR を「if/loop/PHI の真」として扱い、  
  JoinIR 対象関数では `if_phi` / `LoopBuilder` / 旧 MIR Builder にフォールバックしない Strict モードを導入する。  
  代表 If/Loop（mir_joinir_if_select / mir_stage1_staticcompiler_receiver / mir_joinir_stage1_using_resolver_min）は  
  `NYASH_JOINIR_CORE=1 NYASH_JOINIR_STRICT=1` で全て green を確認済み（Strict で lowering 失敗なし）。  
  代表パス（skip_ws / trim / resolve / print_tokens / filter / read_quoted / Stage‑1/Stage‑B 代表）では、  
  JoinIR lowering / VM ブリッジ失敗を即エラー扱いとし、レガシー経路は「未対応関数専用」に縮退させる。

- Phase 82-if-phi-retire（予定）: P3-C ジェネリック型推論ラインを拡張し、  
  `lifecycle.rs` から `infer_type_from_phi*` 呼び出しを完全に排除する（P3-C まで GenericTypeResolver で食い切る）。  
  あわせて `collect_assigned_vars_via_joinir` を JoinIR/AST 側の分析モジュールに移動し、  
  `phi_core::if_phi` への実コードからの参照をゼロにした上で `if_phi.rs` 本体を削除する（歴史メモは docs 側にのみ保持）。

- Phase 74-SSA-static-delegation（将来フェーズ候補）: Phase 71-SSA で判明した「static box 委譲時に ValueId マッピングが壊れる」  
  Rust MIR ビルダー側の根本バグを正式に修正するライン。  
  現 HEAD では `.hako` 層で ParserBox → ParserStringUtilsBox などの委譲を外すことで SSA undef は 13件→0件に根治しており、  
  最小 .hako ではバグを再現できないため、MIR Builder の修正は **再現用テストを用意できる将来フェーズに委譲**する。  
  当面は「box→static box への薄い委譲メソッドを増やさない」というコーディング規約で安全運用し、  
  Phase 74 では commit 13ce9e68 以前の形を元にした再現用テスト＋MIR Builder 修正＋委譲パターンの復活をまとめて扱う。

---

## 3. 旧フェーズ（過去ログへのポインタ）

古いフェーズの詳細な経緯やログは、以下のドキュメントと  
`docs/private/roadmap2/CURRENT_TASK_2025-11-29_full.md` を見てね。

- Phase 21.7 — Static Box Methodization
  - StaticMethodId / NamingBox で BoxName.method/arity 名前解決の SSOT 化。
  - docs: `docs/development/current/main/phase-21.7-naming-ssot-checklist.md` など。
- Phase 25.x / 26.x — LoopForm v2 / LoopSSA v2 / Exit PHI / ExitLiveness
  - LoopForm v2 / LoopSSA v2 の整備と Exit PHI / ExitLiveness まわりの 4 箱構成。
- Phase 27–32 — JoinIR 初期実験〜汎用化
  - LoopToJoinLowerer / LoopScopeShape / JoinIR VM Bridge を minimal ケースから Stage‑1 / Stage‑B へ広げていくライン。
  - docs: `docs/private/roadmap2/phases/phase-27-joinir*`, `phase-31-looptojoin-lowerer`, `phase-32-joinir-complete-migration` など。

CURRENT_TASK.md 自体は「いまどこを触っているか」と「次に何をやるか」を  
1 画面で把握できる軽さを維持する方針だよ。***

---

## Phase 109: RuntimeProfile 機構実装完了 ✅ (2025-12-03)

### 実装内容

**ゴール**: FileBox を profile 依存の conditional required に変更し、minimal/no-fs プロファイルをサポート

**実装完了項目**:
1. ✅ RuntimeProfile enum + is_required_in() ヘルパー
   - `src/runtime/runtime_profile.rs`: RuntimeProfile::Default/NoFs 定義
   - `src/runtime/core_box_ids.rs`: CoreBoxId.is_required_in(profile) 追加
2. ✅ PluginHost profile-aware 初期化
   - `src/runtime/plugin_host.rs`: profile 引数追加、FileBox provider チェック実装
3. ✅ initialize_runtime() に profile 読み込み機構
   - `src/runtime/mod.rs`: 環境変数読み込み層（責務分離）
4. ✅ NoFsFileIo stub 実装
   - `src/providers/ring1/file/nofs_fileio.rs`: FileBox 無効化スタブ
   - `src/runtime/provider_lock.rs`: init_filebox_provider_for_profile()
5. ✅ ドキュメント更新
   - `phase108_filebox_write_semantics.md`: Section 9 追加
   - `core_boxes_design.md`: Section 5.4 追加

**テスト結果**:
- ✅ test_core_box_id_is_required_in_default
- ✅ test_core_box_id_is_required_in_nofs
- ✅ test_with_core_from_registry_nofs_filebox_optional
- ✅ test_nofs_fileio_caps/open/read/write/close_unsupported (5 tests)
- ✅ cargo build --release: 成功
- ✅ cargo test --release --lib: Phase 109 tests 全 PASS

**設計原則**:
- **責務分離**: initialize_runtime() のみが env を読む、PluginHost は profile を受け取る
- **Fail-Fast 維持**: Default profile では FileBox provider 必須
- **Logger/ConsoleService 有効**: NoFs でも Ring0.log と ConsoleBox は動作
- **互換性保証**: Default profile で Phase 107/108 の動作を完全維持

**将来拡張予定** (Phase 113+):

- TestMock: テスト用にすべての外部 I/O を in‑memory mock に差し替える
- Sandbox: 外部 I/O を禁止（FileBox/NetworkBox 等を一律無効化）
- ReadOnly: FileBox.write を禁止し、read のみ許可
- Embedded: 組み込み用に GC/メモリ制約を強めたプロファイル

**次のタスク候補**:
- ✅ Phase 110: FileHandleBox（複数ファイル同時アクセス） — **完了** (2025-12-03)
- Phase 111: append mode 追加 + FileHandleBox metadata
- Phase 112: Ring0 service registry 統一化

---

## Phase 110: FileHandleBox 実装完了 ✅ (2025-12-03)

### 実装内容

**FileHandleBox（ハンドルベース複数回アクセス I/O）の完全実装**

**ゴール**: FileBox（1ショット I/O）を補完するハンドルベースのファイル I/O を実装

**実装完了項目**:
1. ✅ FileHandleBox struct + NyashBox trait 実装
   - `src/boxes/file/handle_box.rs`: 新規作成（450行）
   - 独立インスタンス設計（各ハンドルが独自の Ring0FsFileIo を保持）
2. ✅ API 実装
   - `new()` - ハンドル作成（ファイル未open）
   - `open(path, mode)` - ファイルを開く（"r" or "w"）
   - `read_to_string()` - ファイル内容読み込み
   - `write_all(content)` - ファイル書き込み
   - `close()` - ファイルを閉じる
   - `is_open()` - open 状態確認
3. ✅ プロファイル対応
   - Default ✅: Ring0FsFileIo 経由で完全なファイル I/O
   - NoFs ❌: open() が即座にエラー
4. ✅ テスト実装（7テスト全PASS）
   - 基本的な書き込み・読み込み
   - 二重 open エラー
   - close 後アクセスエラー
   - read mode で write エラー
   - 複数回書き込み
   - 未サポートモードエラー
   - 独立インスタンス動作確認
5. ✅ ドキュメント更新
   - `core_boxes_design.md`: Section 16 追加
   - `ring0-inventory.md`: Phase 110 完了マーク
   - `phase110_filehandlebox_design.md`: 完全仕様（既存）

**テスト結果**:
- ✅ test_filehandlebox_basic_write_read
- ✅ test_filehandlebox_double_open_error
- ✅ test_filehandlebox_closed_access_error
- ✅ test_filehandlebox_write_wrong_mode
- ✅ test_filehandlebox_multiple_writes
- ✅ test_filehandlebox_unsupported_mode
- ✅ test_filehandlebox_independent_instances
- ✅ cargo build --release: 成功
- ✅ cargo test --release: 7/7 PASS

**設計原則**:
- **Fail-Fast**: 二重 open、close 後アクセス、NoFs profile で即座にエラー
- **独立インスタンス**: 各 FileHandleBox が独自の Ring0FsFileIo を保持（複数ファイル同時アクセス可能）
- **Ring0 再利用**: Ring0FsFileIo を内部で使用（レイヤー統一）
- **後方互換性**: FileBox の既存 API 変更なし

**FileBox との違い**:
- FileBox: 1ショット I/O（read/write 1回ずつ、ファイルを開いて→読む/書く→閉じるを隠す）
- FileHandleBox: 複数回アクセス I/O（open → read/write（複数回可）→ close を明示的に制御）

**実装詳細**:
```rust
// 各 FileHandleBox が独自の Ring0FsFileIo を作成
let ring0 = get_global_ring0();
let io: Arc<dyn FileIo> = Arc::new(Ring0FsFileIo::new(ring0.clone()));

// Write mode の処理
if mode == "w" {
    // ファイルが存在しない場合は空ファイルを作成
    if !ring0.fs.exists(path_obj) {
        ring0.fs.write_all(path_obj, &[])?;
    }
}
```

**将来拡張予定**:
- Phase 111: append mode ("a") サポート
- Phase 112: file metadata / stat（size, mtime 等）
- Phase 113: Ring0 service registry 統一化
- Phase 114: 並行アクセス安全性（Arc<Mutex<...>>）
- Phase 115: file encoding explicit 指定（UTF-8 以外）

**関連ドキュメント**:
- [Phase 110 設計書](docs/development/current/main/phase110_filehandlebox_design.md)
- [Core Boxes Design](docs/development/current/main/core_boxes_design.md#section-16-phase-110---filehandlebox)
- [Ring0 Inventory](docs/development/current/main/ring0-inventory.md)

**次のタスク候補**:
- Phase 111: FileHandleBox append mode 追加 + metadata サポート
- Phase 112: Ring0 service registry 統一化
- Phase 113: FileIo trait 拡張（exists/stat/canonicalize）

### 🎯 Phase 123 proper: hako_check JoinIR 実装（完了） ✅

**実施日**: 2025-12-04

**完了内容**:
- ✅ NYASH_HAKO_CHECK_JOINIR 環境変数フラグ導入
- ✅ hako_check ランナーに JoinIR スイッチ実装
- ✅ 代表4ケースで両経路テスト実施
- ✅ ドキュメント更新完了

**テスト結果**:
- Legacy Path: 4/4 PASS (100%)
- JoinIR Path: 4/4 PASS (100%)
  - phase123_simple_if.hako ✅
  - phase123_nested_if.hako ✅
  - phase123_while_loop.hako ✅
  - phase123_if_in_loop.hako ✅

**実装詳細**:
- 環境変数ヘルパー: `src/config/env/hako_check.rs::hako_check_joinir_enabled()`
- JoinIR スイッチ: `src/mir/builder/control_flow.rs::cf_if()` に分岐処理追加
- プレースホルダー実装: `try_cf_if_joinir()` は常に `Ok(None)` を返してレガシーにフォールバック
- 両経路が完全動作: 環境変数の読み取りとフラグ分岐は完璧に実装済み

**変更ファイルサマリー**:
- 新規: `src/config/env/hako_check.rs` (+60 lines)
- 修正: `src/config/env.rs` (+2 lines)
- 修正: `src/mir/builder/control_flow.rs` (+67 lines)
- 更新: `docs/reference/environment-variables.md` (+1 line)
- テスト: `local_tests/phase123_*.hako` (4 files, +88 lines)
- スクリプト: `tools/smokes/v2/profiles/integration/hako_check_joinir.sh` (+117 lines)

**Total**: +335 lines added

**Known Limitations**:
- JoinIR 経路はプレースホルダー実装（常にレガシーにフォールバック）
- 実際の JoinIR 統合処理は Phase 124 で実装予定

**次のフェーズ**: Phase 124 - JoinIR デフォルト化＆完全統合実装 ✅ **完了！**

---

### 🎯 Phase 124: hako_check レガシー削除 & JoinIR 専用化（完了） ✅

**実施日**: 2025-12-04

**完了内容**:
- ✅ NYASH_HAKO_CHECK_JOINIR フラグ完全削除
- ✅ MIR Builder から legacy if/loop lowering 分岐削除
- ✅ hako_check を JoinIR 一本化（Fail-Fast 原則適用）
- ✅ 環境変数なしで JoinIR 経路がデフォルト動作
- ✅ ドキュメント更新（2パス図 → 1本 JoinIR 図）

**テスト結果**:
- JoinIR-Only Path: 4/4 PASS (100%)
  - phase123_simple_if.hako ✅
  - phase123_nested_if.hako ✅
  - phase123_while_loop.hako ✅
  - phase123_if_in_loop.hako ✅

**実装詳細**:
- 削除: `src/config/env/hako_check.rs` (完全削除)
- 修正: `src/config/env.rs` (hako_check module コメントアウト、Phase 124 マーカー追加)
- 簡素化: `src/mir/builder/control_flow.rs::cf_if()` (65行削減 → 4行に)
  - 環境変数分岐削除
  - try_cf_if_joinir() 削除
  - 直接 lower_if_form() 呼び出しに統一
- 更新: `docs/reference/environment-variables.md` (NYASH_HAKO_CHECK_JOINIR を削除済みとマーク)
- 更新: `hako_check_design.md` (2パスフロー → JoinIR Only フロー図)
- 更新: `phase121_hako_check_joinir_design.md` (Phase 122-124 実装完了サマリー追加)
- 更新: `tools/smokes/v2/profiles/integration/hako_check_joinir.sh` (legacy 経路削除、JoinIR-only テストに更新)

**変更ファイルサマリー**:
- 削除: `src/config/env/hako_check.rs` (-56 lines)
- 修正: `src/config/env.rs` (+3 lines, -2 lines)
- 修正: `src/mir/builder/control_flow.rs` (+6 lines, -65 lines)
- 更新: `docs/reference/environment-variables.md` (+1 line, -1 line)
- 更新: `docs/development/current/main/hako_check_design.md` (+61 lines, -64 lines)
- 更新: `docs/development/current/main/phase121_hako_check_joinir_design.md` (+43 lines)
- 更新: `tools/smokes/v2/profiles/integration/hako_check_joinir.sh` (+14 lines, -44 lines)

**Total**: +128 insertions, -232 deletions (104行の純削減)

**アーキテクチャ改善**:
- Fail-Fast 原則適用: フォールバック処理完全削除
- コードベース簡素化: 環境変数分岐削除により保守性向上
- テスト対象経路の一本化: JoinIR 専用パスで品質保証

**ビルド結果**: ✅ Success (0 errors, 10 warnings)

**JoinIR/selfhost 第2章完了**:
- Phase 121: JoinIR 統合設計確立
- Phase 123: 環境変数スイッチ導入
- Phase 124: JoinIR 専用化 & レガシー削除 ← **完了！**

**成果**:
✅ hako_check + selfhost Stage-3 が JoinIR 統一パイプラインで動作
✅ ドキュメント・実装・テストが JoinIR 前提に統一
✅ 環境変数フラグ削除により実装簡素化
✅ Fail-Fast 原則に準拠したエラーハンドリング

**次のフェーズ**: Phase 130 - JoinIR → LLVM ベースライン確立

---

## 🎯 Phase 130: JoinIR → LLVM ベースライン確立（完了）✅ 2025-12-04

### 📋 実装内容

**目的**: JoinIR で selfhost/hako_check まで安定した現在の状態から、JoinIR → LLVM 経路の現状を観測・記録

**スコープ**:
- ✅ 代表ケース選定（7本）
- ✅ LLVM実行コマンドと環境変数の整理
- ✅ 実行結果（Rust VM / LLVM harness）を記録
- ✅ **観測専用**：実装修正は Phase 131 以降に回す

### 📊 実行結果

**代表ケース（7本）**:
1. apps/tests/peek_expr_block.hako - 式ブロック・peek構文
2. apps/tests/loop_min_while.hako - ループ・PHI命令
3. apps/tests/esc_dirname_smoke.hako - ConsoleBox・複雑な制御フロー
4. local_tests/phase123_simple_if.hako - シンプルなif文
5. local_tests/phase123_while_loop.hako - while loop
6. apps/tests/joinir_if_select_simple.hako - IfSelect基本ケース
7. apps/tests/joinir_min_loop.hako - 最小ループ

**テスト結果統計**:

| 経路         | PASS | FAIL | 合計 | 成功率 |
|--------------|------|------|------|--------|
| Rust VM      | 6    | 1    | 7    | 85.7%  |
| LLVM harness | 0    | 0    | 7    | 0% (Mock実行) |

**Rust VM結果詳細**:
- ✅ PASS: 6/7
  - peek_expr_block, loop_min_while, phase123_simple_if, phase123_while_loop, joinir_if_select_simple, joinir_min_loop
- ❌ FAIL: 1/7
  - esc_dirname_smoke.hako: ConsoleBox未登録エラー

**LLVM harness結果詳細**:
- ⚠️ 全7テストがMock backend実行（実LLVM未対応）
- ✅ MIRコンパイルは全て成功
- ❌ `--features llvm` ビルドが必要と判明

### 🔍 検出された問題点

#### 1. LLVM Backend未対応（最重要）
**現象**: 全テストがMock backend実行
```
🔧 Mock LLVM Backend Execution:
   Build with --features llvm-inkwell-legacy for Rust/inkwell backend,
   or set NYASH_LLVM_OBJ_OUT and NYASH_LLVM_USE_HARNESS=1 for harness.
```

**原因**: `--features llvm` ビルドが必要（現在のビルドでは無効化）

**影響**: 全7テストケース

#### 2. ConsoleBox未登録問題
**現象**: esc_dirname_smoke.hakoで失敗
```
[ERROR] ❌ [rust-vm] VM error: Invalid instruction: NewBox ConsoleBox:
invalid operation: Unknown Box type: ConsoleBox. Available: Main
```

**原因**: Rust VM環境でConsoleBoxが登録されていない（Phase 15.5の "Everything is Plugin" 方針と衝突）

**影響**: Console出力を使用するテストケース

#### 3. JoinIR → LLVM経路の不明確性
**観測事実**:
- JoinIR → MIR変換: ✅ 全テストで成功
- MIR → LLVM IR: ⚠️ Mock実行（未検証）
- LLVM実行: ❌ 未対応

### 📄 成果物

**ドキュメント**: `docs/development/current/main/phase130_joinir_llvm_baseline.md`
- 代表ケース7本の選定理由
- 実行コマンド・環境変数の整理
- 実行結果の詳細記録（表形式）
- 検出された問題点の分析
- Phase 131への引き継ぎ事項

### 🏆 Phase 130 の価値

**観測専用フェーズの成功**:
- ✅ 実装修正なし（赤は赤のまま記録）
- ✅ JoinIR → LLVM 経路の現状を可視化
- ✅ Phase 131 以降の優先度付けが明確化

**重要な発見**:
1. LLVM backend機能が現在のビルドで無効化
2. ConsoleBoxのRust VM登録問題が再発
3. JoinIR → MIR変換は全て正常動作
4. 実LLVM実行には `--features llvm` ビルドが必要

### 🚀 次のステップ

**Phase 132: LLVM PHI命令順序バグ修正 + ConsoleBox統合**（予定）

---

## 🎯 Phase 131: JoinIR → LLVM 個別修正ライン（完了）✅ 2025-12-04

### 📋 実装内容

**目的**: Phase 130 で観測した LLVM 側の「赤ポイント3つ」を、設計を崩さずピンポイントで修正

**スコープ**:
1. ✅ LLVM backend の最小 re-enable（代表1本を green に）
2. ⚠️ ConsoleBox の LLVM ライン統一（前提条件未達）
3. ⚠️ JoinIR→MIR→LLVM の成功パス確立（PHI ordering bug発見）

### 📊 Phase 131 実施結果

#### 修正1: LLVM Backend Re-enable ✅

**実施内容**:
- ✅ `cargo build --release --features llvm` でLLVM機能有効化
- ✅ Python/llvmlite環境確認（llvmlite 0.45.1）
- ✅ llvmlite非推奨API対応: `llvm.initialize()` 削除

**修正ファイル**:
- `src/llvm_py/llvm_builder.py`: `llvm.initialize()` 呼び出しコメントアウト

**成果**:
- ✅ `peek_expr_block.hako`: LLVM実行成功（Result: 1、Rust VM: RC: 1）
- ✅ Mock backend → 実LLVM実行への移行成功

#### 修正2: PHI命令順序バグ発見 ⚠️

**検出された問題**:
LLVM IR生成時、PHI命令がreturn命令の**後**に配置されるバグを発見。

**問題例**（生成されたLLVM IR）:
```llvm
bb5:
  ret i64 %"ret_phi_16"
  %"ret_phi_16" = phi i64 [0, %"bb3"], [0, %"bb4"]  ; ← エラー！PHIはretの前に必要
}
```

**LLVM IRの制約**:
- PHI命令はBasic Blockの**先頭**に配置必須
- terminator命令（ret/br/switch等）の後に命令を配置不可

**影響範囲**:
- ❌ phase123_simple_if.hako: LLVM IR parsing error
- ❌ loop_min_while.hako: LLVM IR parsing error
- ❌ 制御フロー合流を含む全6テストが影響

**根本原因**:
- `src/llvm_py/llvm_builder.py`の`finalize_phis()`関数
- PHI nodesがblock終端処理後に追加されている
- LLVM IRbuilderのblock構築順序の設計問題

**Phase 132への引き継ぎ**: `finalize_phis()`の大規模リファクタリングが必要

#### 修正3: ConsoleBox LLVM統合 ⚠️

**現状確認**:
- ❌ Rust VM環境でもConsoleBox未登録
- ❌ LLVM環境でもConsoleBox未対応

**Phase 132への引き継ぎ**: ConsoleBox登録はRust VM側の前提条件

### 📈 Phase 131 実行結果サマリー

**修正前（Phase 130）**:
| 経路         | PASS | FAIL | 成功率 |
|--------------|------|------|--------|
| Rust VM      | 6    | 1    | 85.7%  |
| LLVM harness | 0    | 7    | 0% (Mock) |

**修正後（Phase 131）**:
| 経路         | PASS | FAIL | 成功率 | メモ |
|--------------|------|------|--------|------|
| Rust VM      | 6    | 1    | 85.7%  | 変更なし |
| LLVM harness | 1    | 6    | 14.3%  | peek_expr_block.hako成功 |

**成功ケース**:
- ✅ `peek_expr_block.hako`: Rust VM ✅ → LLVM ✅（Result: 1）

**失敗ケース**（PHI ordering bug）:
- ❌ `loop_min_while.hako`
- ❌ `phase123_simple_if.hako`
- ❌ `phase123_while_loop.hako`
- ❌ `joinir_if_select_simple.hako`
- ❌ `joinir_min_loop.hako`
- ❌ `esc_dirname_smoke.hako`（ConsoleBox未登録）

### 🏆 Phase 131 の価値

**最小スコープ達成**:
- ✅ LLVM backend実動作確認（Mock → Real）
- ✅ 1/7テスト成功（目標2-3本だが、PHI問題で制限）
- ✅ 根本的なPHI ordering bug発見・記録

**Phase 132への明確な引き継ぎ**:
1. **最優先**: PHI命令順序バグ修正（`finalize_phis()`リファクタリング）
2. **優先**: ConsoleBox登録問題解決
3. **通常**: 残りテストケースのLLVM対応

**設計を崩さない修正方針の実践**:
- 1箇所の軽微な修正（`llvm.initialize()`削除）で1テスト成功
- 大規模修正が必要な問題は無理せずPhase 132に回した

### 🚀 次のステップ

**Phase 132: LLVM PHI命令順序バグ修正 + ConsoleBox統合**

---