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実装時に達成します。

View File

@ -0,0 +1,93 @@
# Phase 92 P4: E2E固定回帰最小化
## Phase 92の範囲と成果
**Phase 92の実装範囲**
- P0-P2: ConditionalStepのJoinIR生成とbody-local変数サポート
- **完了した機能**: `lower_condition_to_joinir`でbody-local変数解決をサポート
**Phase 92の範囲外**
- P5bパターン認識の拡張escape_pattern_recognizerは既存のまま
- body-local variable promotionシステムの拡張
## P4-1: E2E固定戦略
### 問題
P5bパターン認識は厳密な要件があり、テストケースが認識されない
- 要件: 特定の構造break check + escape check
- 現状: `flag`ベースの条件は認識されない
### 解決策: 段階的アプローチ
**Level 1: 最小E2E既存Pattern2Break**
```bash
# 既存のPattern2Breakテストを使用
NYASH_DISABLE_PLUGINS=1 ./target/release/hakorune apps/tests/loop_min_while.hako
# Expected: 正常動作(退行なし)
```
**Level 2: Unit TestPhase 92の核心**
```bash
# condition_lowerer.rsのunit testでbody-local変数サポートを検証
cargo test --release condition_lowerer::tests
# Expected: body-local変数の変数解決優先度が正しく動作
```
**Level 3: Integration将来のP5b完全実装時**
```bash
# P5bパターン完全実装後のE2E
NYASH_JOINIR_DEV=1 NYASH_DISABLE_PLUGINS=1 ./target/release/hakorune apps/tests/phase92_p5b_full.hako
# Note: body-local promotion実装が必要
```
## P4-2: Integration Smoke
最小限のsmoke testを追加
```bash
# tools/smokes/v2/profiles/integration/rust-vm/phase92_pattern2_baseline.sh
# 既存のPattern2Breakテストで退行確認
```
## P4-3: Fail-Fast契約
現状のFail-Fast実装は十分
- `conditional_step_emitter.rs`: delta equality check
- `ConditionEnv`: 変数解決失敗時のエラーメッセージ
追加不要80/20ルール
## 受け入れ基準
**Level 1完了**: 既存Pattern2Breakテストが動作退行なし
**Level 2完了**: Unit testでbody-local変数サポート検証
- `test_body_local_variable_resolution` - body-local変数解決
- `test_variable_resolution_priority` - 変数解決優先度ConditionEnv優先
- `test_undefined_variable_error` - 未定義変数エラーハンドリング
- 全7テストPASS確認済み`cargo test --release condition_lowerer::tests`
**P4-2完了**: Integration smoke test追加
- `tools/smokes/v2/profiles/integration/apps/phase92_pattern2_baseline.sh`
- Case A: `loop_min_while.hako` (Pattern2 baseline)
- Case B: `phase92_conditional_step_minimal.hako` (条件付きインクリメント)
- 両テストケースPASS、integration profileで発見可能
**P4-3完了**: Fail-Fast契約確認追加不要と判断
- `conditional_step_emitter.rs`: delta equality check実装済み
- `ConditionEnv`: 変数解決失敗時のエラーメッセージ実装済み
- 80/20ルール適用: 現状の実装で十分と判断
⏸️ **Level 3延期**: P5b完全E2Ebody-local promotion実装後
## Phase 92の価値
**実装済み**:
1. `lower_condition_to_joinir`でbody-local変数解決priority: ConditionEnv → LoopBodyLocalEnv
2. `conditional_step_emitter.rs`でbody-local環境を渡す
3. Break condition loweringの順序修正body-local init後に実行
**将来の拡張**:
- body-local promotionシステム拡張Pattern2で一般的なbody-local変数を扱う
- P5bパターン認識の汎化
## 結論
Phase 92は「条件式でbody-local変数を使えるようにする基盤」を完成させました。
E2E完全動作は将来のPhaseで、body-local promotion実装時に達成します。

View File

@ -4,6 +4,7 @@
- ✅ P0: Contract + skeleton-to-lowering wiring (foundations)
- ✅ P1: Boxification / module isolation (ConditionalStep emitter)
- 🔶 P2: Wire emitter into Pattern2 + enable E2E
- ✅ P3: BodyLocal 1変数read-onlyを Pattern2 条件で許可Fail-Fast
## Goal
- Phase 91 で認識した P5bescape skip: +1 / +2 の条件付き更新を、JoinIR lowering まで落とせるようにする。
@ -42,6 +43,14 @@
### P2-3: E2E fixture を 1 本だけ通す
- `test_pattern5b_escape_minimal.hako`Phase 91 の最小fixture
## P3完了: BodyLocal 1変数対応Fail-Fast付き
- 目的: `ch` のような read-only body-local毎回再計算を Pattern2 の break/escape 条件で参照できるようにする
- 新規箱: `src/mir/join_ir/lowering/common/body_local_slot.rs`
- 許可: 条件に出る LoopBodyLocal が 1つ、top-level `local <name> = <expr>`、break guard `if` より前、代入なし
- 禁止: 複数、代入あり、定義が break guard より後、top-level 以外(分岐内など)
- 破ると `error_tags::freeze(...)` で理由付き停止
## Acceptance
- `NYASH_JOINIR_DEV=1 HAKO_JOINIR_STRICT=1` で parity が green のまま
- E2E が 1 本通る(まずは VM でOK