Files
hakorune/docs/development/current/main/phases/phase-92/P4-E2E-PLAN.md

94 lines
3.6 KiB
Markdown
Raw Normal View History

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>
2025-12-16 21:37:07 +09:00
# 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実装時に達成します。