hakorune/docs/development/roadmap/phases/phase-26-H/TASKS.md

Phase 26-H — JoinIR / 関数正規化 タスクチェックリスト

このフェーズは「設計＋ミニ実験」専用だよ。本線のスモーク／CI は既存の MIR/LoopForm 経路のまま維持しつつ、関数正規化（JoinIR/LoopFnIR）の足場を小さく固めることをゴールにする。

A. 設計ドキュメントまわり

• A-1: join-ir 設計の骨格を固める

  • docs/development/architecture/join-ir.md に:
    • 命令セット（call, ret, 必要なら jump）の最小定義を明記する
    • if / loop / break / continue / return → JoinIR の変換規則を列挙する
    • φ = 関数引数 / merge = join 関数 / loop = 再帰 + exit 継続 の対応表を書く
  • 26-H で「実装として本当に増やす箱」と、「概念ラベルとしてだけ残す箱」を分けてコメントしておく

• A-2: 26-H フェーズ README の整備

  • docs/development/roadmap/phases/phase-26-H/README.md に:
    • 現在の箱群（LoopForm/PHI/解析系）の棚卸し
    • 最終的に残したい箱セット（LoopForm 前段 + LoopFnIR/JoinIR + 最小解析箱）を 1 セクションでまとめる
    • 「このフェーズでは設計＋ミニ実験のみ、本線は既存ルート」というスコープ/制限を明記する

B. JoinIR 型・変換の最小実装

• B-1: JoinIR 型定義ファイルの追加

  • src/mir/join_ir.rs を追加し、以下を定義する（最小限でOK）:
    • JoinFunction（名前・引数・ブロック一覧）
    • JoinBlock（ラベルと命令列）
    • JoinInst（call/ret などのバリアント）
  • Debug/Display などダンプに必要な実装だけ付ける（最初は Debug だけでも可）

• B-2: LoopForm→JoinIR ミニ変換関数（1ケース用）

  • まずは 汎用変換ではなく、特定の小関数だけを対象にした試験的関数 を 1つ実装する:
    • 例: fn lower_simple_loop_to_joinir(mir: &MirModule, func_name: &str) -> Option<JoinFunction>
  • ルールは join-ir.md の「Loop→step/k_exit」変換に従って手作業気味でよい（このフェーズでは general solution を目指さない）

C. 最小 .hako + テスト（カナリア）

• C-1: 最小 JoinIR 用 .hako を追加

  • apps/tests/joinir_min_loop.hako（例）を作成:
    • 例: static box JoinIrMin { main() { var i = 0; loop(i < 3) { if i >= 2 { break } i = i + 1 } return i } }

• C-2: Rust テストで MIR→JoinIR ダンプを確認

  • src/tests/mir_joinir_min.rs（仮ファイル）を追加し:
    • 上記 .hako を AST→MIR までコンパイル
    • lower_simple_loop_to_joinir を呼んで JoinFunction を生成
    • eprintln!("{:?}", join_fn) などで形を確認（当面は assert よりも形の手動確認を重視）
  • テストは デフォルト ON でも軽い ことを確認（重ければ #[ignore] + 手動実行でもOK）

D. トグル付き実験フック

• D-1: 実験用トグルの追加
  • NYASH_JOINIR_EXPERIMENT=1 のときだけ JoinIR ダンプを有効にするパスを Runner 側に追加する（例: --debug-joinir-min に相乗りでも可）
  • トグル OFF のときは既存の MIR/LoopForm 経路しか走らないことを確認する

E. ループ/PHI ラインとの関係メモ

• E-1: 「どの箱が将来 JoinIR に吸収されるか」を一覧にする

  • loopform_ssot.md か 26-H README に:
    • Header/Exit PHI まわりの箱で、JoinIR 導入後に 不要or縮退 するもの
    • LoopForm / ControlForm は「前段の構造箱」として残すもの
    • 解析系（LoopVarClassBox / LoopExitLivenessBox など）のうち、JoinIR 後も必要なもの
      を簡易な表にして残す

• E-2: 「今はここまで、27.x でここまで」を線引きする

  • 26-H のスコープ: 設計＋最小 JoinIR ダンプ
  • 27.x 候補: JoinIR 経由で 1〜2 個の本番ループ（FuncScanner/Stage-B）を通す、PHI/ExitLiveness の一部を JoinIR 側に移す

---

このファイルは「26‑H でやることを一覧で見たいときのチェックリスト」として使ってね。
タスクが増えたら、このファイルに A/B/C… の形で足していく想定だよ。