tomoaki/hakorune
1
0
Fork 0
Code Issues Pull Requests Actions 1 Packages Projects Releases Wiki Activity
Files
d2972c1437fe34a56e3a784cd775e0bbb6423df4
hakorune/docs/development/current/main/phases/phase-92/P4-E2E-PLAN.md
nyash-codex d2972c1437 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

3.6 KiB
Raw Blame History

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）

# 既存のPattern2Breakテストを使用
NYASH_DISABLE_PLUGINS=1 ./target/release/hakorune apps/tests/loop_min_while.hako
# Expected: 正常動作（退行なし）

Level 2: Unit Test（Phase 92の核心）

# condition_lowerer.rsのunit testでbody-local変数サポートを検証
cargo test --release condition_lowerer::tests
# Expected: body-local変数の変数解決優先度が正しく動作

Level 3: Integration（将来のP5b完全実装時）

# 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を追加：

# 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完全E2E（body-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実装時に達成します。