hakorune/docs/development/current/main/phase26-HC-normalized-pattern1-bridge.md

Status: Active
Scope: Phase 26‑H.C ― Normalized JoinIR (Pattern1) を MIR に落とす最小ブリッジの設計と比較テスト計画（dev専用）。

Phase 26‑H.C 指示書 — Normalized→MIR ブリッジ（Pattern1 最小）＋比較テスト

ゴール

• Normalized JoinIR（NormalizedModule）から MIR への「本物のブリッジ」を、Pattern1 最小ケースだけで実装する。
• Structured→MIR と Structured→Normalized→MIR の結果が一致することをテストで確認する（dev 専用、CLI はまだ触らない）。

A. Normalized→Structured or Normalized→MIR の経路方針

• Option 1: Normalized→Structured→既存 MIR ブリッジ
  • 長所: 既存の JoinIR→MIR パイプラインを再利用できる。
  • 短所: フェーズが一段増える（Normalized→Structured が joinir→joinir の一歩になる）。
• Option 2: Normalized→MIR を直接作るミニブリッジ（Pattern1 限定） ←今回これを優先
  • 長所: TailCall/Env をそのまま MIR に落とす感触を掴める。
  • 短所: 一部ロジックが JoinIR→MIR と重複する。
• どちらを選んでも「Pattern1 最小ケース限定」「テスト専用 helper」とする（本番パスへは配線しない）。今回は Option 2 で進め、必要があれば Option 1 のスケルトンも残す。

B. Normalized→Structured ミニ変換（Option 1 採用時のメモ）

• 追加場所: src/mir/join_ir/normalized.rs
• API 例: pub fn normalize_pattern1_to_structured(norm: &NormalizedModule) -> JoinModule
• 制約: norm.phase == JoinIrPhase::Normalized、関数は 1 つ（loop_step + 仮の k_exit 程度）を想定。
• 変換の要点:
  • EnvLayout の fields から JoinFunction の params を再構成（最小なら1引数でも可）。
  • JpInst::Let → JoinInst::Compute(MirLikeInst::Const/BinOp/UnaryOp/Compare) に戻す。
  • TailCallFn/TailCallKont/If を Pattern1 が生成していた JoinInst::Call/Jump/Ret 相当に戻す。
  • NormalizedModule.entry を JoinModule.entry に写す。
• NormalizedModule.structured_backup は比較用に残すが、ブリッジでは本体から再構成する。

C. Normalized→MIR ミニブリッジ（今回の主経路: Option 2）

• 追加ファイル案: src/mir/join_ir/lowering/normalized_pattern1_to_mir.rs
• API 例:

  pub fn lower_normalized_pattern1_to_mir(norm: &NormalizedModule) -> crate::mir::Module { ... }
  

• 最低限やること:
  • EnvLayout の 1 フィールドを MIR のループ変数に対応させる。
  • JpFunction 本体を 1 ブロック or 小ブロック列に変換（Let→MIR Assign/Compute、TailCallFn→ループ末尾 Jump 等）。
  • Pattern1 の loop_min_while 相当が生成していた MIR と構造的に一致するかをテストで確認。
• ガード: dev/テスト専用 helper から明示的に呼ぶ。ランナー/CLI には配線しない。

D. 比較用テストの追加

• テストファイル案: tests/normalized_pattern1_bridge.rs
• シナリオ:
  1. Structured JoinIR (Pattern1: loop_min_while 相当) を既存 lowerer で生成。
  2. そのコピーを normalize_pattern1_minimal に通し NormalizedModule を得る。
  3. 既存経路: Structured → 既存 JoinIR→MIR ブリッジ → 実行 or MIR dump。
  4. 新経路: Structured → Normalized → （C のブリッジ）→ MIR → 実行 or MIR dump。
  5. 比較:
     • 実行結果一致（RC + stdout）。
     • 余裕があれば MIR の基本ブロック数や命令種も比較し、構造乖離がないことを確認。
• テスト名例:
  • test_normalized_pattern1_minimal_roundtrip
  • test_normalized_pattern1_exec_result_matches_structured

E. ガードと完了条件

• ガード:
  • 新ブリッジはテスト専用（ランナー/CLI からは呼ばない）。
  • JoinModule.phase が Structured のままでも既存経路は従来どおり動作。
  • Normalized 経路は dev/テスト専用 helper からのみ呼ぶ。
• 完了条件:
  • NormalizedModule から MIR を生成する経路（Option 2）が 1 本通る。
  • Pattern1 最小ケースで Structured→MIR と Structured→Normalized→MIR が同じ結果になるテストが緑。
  • 既存 cargo test --release が 0 FAIL のまま。