hakorune/docs/development/current/main/phases/phase-92

Phase 92: Lowering (ConditionalStep / P5b Escape)

Status

• ✅ P0: Contract + skeleton-to-lowering wiring (foundations)
• ✅ P1: Boxification / module isolation (ConditionalStep emitter)
• ✅ P2: Pattern2 へ配線 + body-local 条件式サポート
• ✅ P3: BodyLocal 1変数（read-only）を Pattern2 条件で許可（Fail-Fast）
• ✅ P4: E2E固定（最小）+ 回帰最小化（unit + integration smoke）
• ⏸️ P5: P5b “完全E2E” は promotion 拡張後

Goal

• Phase 91 で認識した P5b（escape skip: +1 / +2 の条件付き更新）を、JoinIR lowering まで落とせるようにする。
• 既定挙動は不変。Fail-Fast を維持し、未対応は理由付きで止める。

P0（完了）

• P0-1: ConditionalStep 契約（SSOT）
  • 実装/記録: src/mir/loop_canonicalizer/skeleton_types.rs（契約コメント）
  • 記録（歴史）: docs/development/current/main/phases/phase-92/p0-2-skeleton-to-context.md
• P0-2: Skeleton → lowering への配線（Option A）
  • LoopPatternContext に skeleton を optional に通した（後に P1 で境界を整理）
• P0-3: ConditionalStep を JoinIR（Select 等）で表現する基盤を追加

P1（完了）: 箱化・モジュール化

• ConditionalStep lowering を 1 箱に隔離
  • src/mir/join_ir/lowering/common/conditional_step_emitter.rs
  • src/mir/join_ir/lowering/common.rs から export
• 目的: Pattern2 本体を肥大化させず、条件付き更新の責務を emitter に閉じ込める
• 境界の整理（SSOT）
  • routing 層から skeleton を取り除き、Pattern2 側で skeleton/recognizer 情報の取得を内部化
  • recognizer は cond/delta 抽出に限定（スコープ/寿命の判断を混ぜない）
• E2E fixture
  • test_pattern5b_escape_minimal.hako は用意済み（body-local 対応後に実行固定）

P2（完了）: Pattern2 へ配線 + 条件式の body-local 対応

• ConditionalStep の lowering を Pattern2 から emitter に委譲（Pattern2 の肥大化を防ぐ）
• 条件式の値解決に LoopBodyLocalEnv を追加し、ConditionEnv → LoopBodyLocalEnv の優先順位で解決
• break guard の lowering 順序を修正し、body-local 初期化の後に条件式を lower（ch == ... などを解決）

P3（完了）: BodyLocal 1変数（read-only）を条件式で許可（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(...) で理由付き停止

P4（完了）: E2E固定（最小）+ 回帰最小化

• unit: src/mir/join_ir/lowering/condition_lowerer.rs に body-local 解決のユニットテストを追加
• integration smoke: tools/smokes/v2/profiles/integration/apps/phase92_pattern2_baseline.sh
  • Case A: apps/tests/loop_min_while.hako（既存 Pattern2Break の退行チェック）
  • Case B: apps/tests/phase92_conditional_step_minimal.hako（ConditionalStep の最小確認）
• 詳細ログ（歴史）:
  • docs/development/current/main/phases/phase-92/P4-E2E-PLAN.md
  • docs/development/current/main/phases/phase-92/P4-COMPLETION.md

Follow-up（Phase 93）

• Trim の is_ch_match など「ConditionOnly（PHIで運ばない派生値）」を毎イテレーション再計算する Derived Slot を追加（初回値固定の根治）。
  • docs/development/current/main/phases/phase-93/README.md

Acceptance

• NYASH_JOINIR_DEV=1 HAKO_JOINIR_STRICT=1 で parity が green のまま
• E2E が 1 本通る（最初は VM でOK）
• 既定挙動不変（フラグOFFで無影響）