feat(joinir): Phase 92完了 - ConditionalStep + body-local変数サポート

## Phase 92全体の成果

**Phase 92 P0-P2**: ConditionalStep JoinIR生成とbody-local変数サポート
- ConditionalStep(条件付きキャリア更新)のJoinIR生成実装
- Body-local変数(ch等)の条件式での参照サポート
- 変数解決優先度: ConditionEnv → LoopBodyLocalEnv

**Phase 92 P3**: BodyLocalPolicyBox + 安全ガード
- BodyLocalPolicyDecision実装(Accept/Reject判定)
- BodyLocalSlot + DualValueRewriter(JoinIR/MIR二重書き込み)
- Fail-Fast契約(Cannot promote LoopBodyLocal検出)

**Phase 92 P4**: E2E固定+回帰最小化 (本コミット)
- Unit test 3本追加(body-local変数解決検証)
- Integration smoke追加(phase92_pattern2_baseline.sh、2ケースPASS)
- P4-E2E-PLAN.md、P4-COMPLETION.md作成

## 主要な実装

### ConditionalStep(条件付きキャリア更新)
- `conditional_step_emitter.rs`: JoinIR Select命令生成
- `loop_with_break_minimal.rs`: ConditionalStep検出と統合
- `loop_with_continue_minimal.rs`: Pattern4対応

### Body-local変数サポート
- `condition_lowerer.rs`: body-local変数解決機能
  - `lower_condition_to_joinir`: body_local_env パラメータ追加
  - 変数解決優先度実装(ConditionEnv優先)
  - Unit test 3本追加: 変数解決/優先度/エラー
- `header_break_lowering.rs`: break条件でbody-local変数参照
- 7ファイルで後方互換ラッパー(lower_condition_to_joinir_no_body_locals)

### Body-local Policy & Safety
- `body_local_policy.rs`: BodyLocalPolicyDecision(Accept/Reject)
- `body_local_slot.rs`: JoinIR/MIR二重書き込み
- `dual_value_rewriter.rs`: ValueId書き換えヘルパー

## テスト体制

### Unit Tests (+3)
- `test_body_local_variable_resolution`: body-local変数解決
- `test_variable_resolution_priority`: 変数解決優先度(ConditionEnv優先)
- `test_undefined_variable_error`: 未定義変数エラー
- 全7テストPASS(cargo test --release condition_lowerer::tests)

### Integration Smoke (+1)
- `phase92_pattern2_baseline.sh`:
  - Case A: loop_min_while.hako (Pattern2 baseline)
  - Case B: phase92_conditional_step_minimal.hako (条件付きインクリメント)
  - 両ケースPASS、integration profileで発見可能

### 退行確認
-  既存Pattern2Breakテスト正常(退行なし)
-  Phase 135 smoke正常(MIR検証PASS)

## アーキテクチャ設計

### 変数解決メカニズム
```rust
// Priority 1: ConditionEnv (loop params, captured)
if let Some(value_id) = env.get(name) { return Ok(value_id); }
// Priority 2: LoopBodyLocalEnv (body-local like `ch`)
if let Some(body_env) = body_local_env {
    if let Some(value_id) = body_env.get(name) { return Ok(value_id); }
}
```

### Fail-Fast契約
- Delta equality check (conditional_step_emitter.rs)
- Variable resolution error messages (ConditionEnv)
- Body-local promotion rejection (BodyLocalPolicyDecision::Reject)

## ドキュメント

- `P4-E2E-PLAN.md`: 3レベルテスト戦略(Level 1-2完了、Level 3延期)
- `P4-COMPLETION.md`: Phase 92完了報告
- `README.md`: Phase 92全体のまとめ

## 将来の拡張(Phase 92スコープ外)

- Body-local promotionシステム拡張
- P5bパターン認識の汎化(flagベース条件サポート)
- 完全なP5b E2Eテスト(body-local promotion実装後)

🎯 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
This commit is contained in:
nyash-codex
2025-12-16 21:37:07 +09:00
parent 568619df89
commit d2972c1437
43 changed files with 2615 additions and 980 deletions

View File

@ -0,0 +1,161 @@
# Phase 92 P4: E2E固定回帰最小化 - 完了報告
**実装日**: 2025-12-16
**戦略**: 3レベルテスト戦略P4-E2E-PLAN.md参照
---
## ✅ 完了タスク
### P4-1: E2E固定戦略3レベル実装
#### Level 1: 既存Pattern2Breakテストで退行確認
- **テスト**: `apps/tests/loop_min_while.hako`
- **結果**: ✅ PASS出力: 0, 1, 2
- **確認内容**: Phase 92の変更で既存Pattern2機能が壊れていないことを確認
#### Level 2: Unit Test追加Phase 92核心機能検証
- **ファイル**: `src/mir/join_ir/lowering/condition_lowerer.rs`
- **追加テスト**:
1. `test_body_local_variable_resolution` - body-local変数`ch`)の条件式での解決
2. `test_variable_resolution_priority` - ConditionEnv優先度の検証
3. `test_undefined_variable_error` - 未定義変数のエラーメッセージ検証
- **結果**: ✅ 全7テストPASS`cargo test --release condition_lowerer::tests`
#### Level 3: P5b完全E2E
- **状態**: ⏸️ 延期body-local promotion実装後
- **理由**: P5bパターン認識は厳密な要件があり、Phase 92スコープ外
- 要件: 特定構造break check + escape check
- `flag`ベースの条件は認識されない
- body-local promotion システムの拡張が必要
---
### P4-2: Integration Smoke Test追加 ✅
**ファイル**: `tools/smokes/v2/profiles/integration/apps/phase92_pattern2_baseline.sh`
**テストケース**:
- **Case A**: `loop_min_while.hako` - Pattern2 breakベースライン
- 期待出力: `0\n1\n2\n`
- 結果: ✅ PASS
- **Case B**: `phase92_conditional_step_minimal.hako` - 条件付きインクリメント
- 期待出力: `3\n`
- 結果: ✅ PASS
**発見可能性**: ✅ Integration profileで正常に発見
```bash
tools/smokes/v2/run.sh --profile integration --filter "phase92*" --dry-run
# → profiles/integration/apps/phase92_pattern2_baseline.sh
```
**実行結果**:
```
[INFO] PASS: 2, FAIL: 0
[PASS] phase92_pattern2_baseline: All tests passed
```
---
### P4-3: Fail-Fast契約確認 ✅
**結論**: 追加不要80/20ルール適用
**既存実装確認**:
1. **`conditional_step_emitter.rs`**:
- Delta equality check実装済み
- 条件分岐の両方のパスで同じdelta値を生成することを検証
2. **`ConditionEnv`**:
- 変数解決失敗時のエラーメッセージ実装済み
- `Variable '{name}' not found in ConditionEnv or LoopBodyLocalEnv`
3. **新規unit test**:
- `test_undefined_variable_error` - エラーハンドリングを検証
**判断**: 現状の実装で十分。追加のcontract_checks実装は不要。
---
## ✅ 受け入れ基準確認
### Phase 92 E2E smokeがPASS
-**Case A**: Pattern2 breakベースライン既存テスト退行なし
-**Case B**: 条件付きインクリメントPhase 92最小テスト
### 既存integration smokesで退行なし
-**Phase 135**: `trim_mir_verify.sh` - PASS確認済み
-**Phase 132/133**: デフォルト動作変更なしフラグOFF時
### デフォルト動作変更なし
- ✅ Phase 92の変更は既存コード経路に影響なし
-`lower_condition_to_joinir_no_body_locals`ラッパーで後方互換性確保
- ✅ body-local環境は`Option`で必要時のみ渡される
---
## Phase 92の成果まとめ
### 実装済み機能
1. **Body-local変数サポート**: 条件式で`ch`などのbody-local変数を参照可能
2. **変数解決優先度**: ConditionEnv → LoopBodyLocalEnv の明確な優先順位
3. **Break condition順序修正**: body-local init後にbreak conditionを評価
4. **ConditionalStep emission**: body-local環境を渡してJoinIR Select命令を生成
### テスト体制
- **Unit tests**: 7個condition_lowerer.rs- Phase 92核心機能を検証
- **Integration smoke**: 1個phase92_pattern2_baseline.sh- 2ケース
- **既存テスト**: 退行なし確認済み
### 将来の拡張Phase 92スコープ外
- Body-local promotionシステム拡張Pattern2で一般的なbody-local変数を扱う
- P5bパターン認識の汎化`flag`ベース条件もサポート)
- 完全なP5b E2Eテスト
---
## 技術的詳細
### 変数解決メカニズム
```rust
// Phase 92 P2-2: Variable resolution priority
// 1. ConditionEnv (loop parameters, captured variables)
if let Some(value_id) = env.get(name) {
return Ok(value_id);
}
// 2. LoopBodyLocalEnv (body-local variables like `ch`)
if let Some(body_env) = body_local_env {
if let Some(value_id) = body_env.get(name) {
return Ok(value_id);
}
}
Err(format!("Variable '{}' not found...", name))
```
### 後方互換性ラッパー
```rust
pub fn lower_condition_to_joinir_no_body_locals(
cond_ast: &ASTNode,
alloc_value: &mut dyn FnMut() -> ValueId,
env: &ConditionEnv,
) -> Result<(ValueId, Vec<JoinInst>), String> {
lower_condition_to_joinir(cond_ast, alloc_value, env, None)
}
```
全7ファイルで使用されているheader condition、legacy carrier update等
---
## 結論
**Phase 92 P4完了**
Phase 92は「条件式でbody-local変数を使えるようにする基盤」を完成させました。
-**P4-1**: 3レベルテスト戦略完了Level 1-2実装、Level 3延期
-**P4-2**: Integration smoke test 1本追加2ケースPASS
-**P4-3**: Fail-Fast契約確認追加不要
-**受け入れ基準**: 全達成
完全なP5b E2E動作は将来のPhaseで、body-local promotion実装時に達成します。