hakorune/docs/development/current/main/phases/phase-267/README.md

Phase 267 — EdgeCFG Branch（BranchStub + emit_frag）

Status: Completed (P0) ✅ / P1 deferred ⏸️
SSOT (design): docs/development/current/main/design/edgecfg-fragments.md

ゴール

• Frag に **Branch（条件分岐）**を第一級で追加し、wires（Jump/Return）と同様に MIR terminator へ落とせる入口を作る
• 既存の JoinIR/NormalizedShadow/Pattern6/7/8 は触らず、BasicBlockId 層の test-only PoCで証明する

P0（完了）

実装

• BranchStub を追加（フラット構造: from/cond/then/else + edge-args）
  • src/mir/builder/control_flow/edgecfg/api/branch_stub.rs
• Frag に branches: Vec<BranchStub> を追加（Branch 専用）
  • wires は Jump/Return 専用のまま維持
  • src/mir/builder/control_flow/edgecfg/api/frag.rs
• compose::if_ が header→then/else の BranchStub を生成するように更新
  • src/mir/builder/control_flow/edgecfg/api/compose.rs
• emit_frag(function, frag) を追加（SSOT）
  • verify_frag_invariants_strict() を最初に実行
  • wires は emit_wires() を内部利用
  • branches は set_branch_with_edge_args() で terminator + successors を同期
  • 1 block = 1 terminator（wire/branch 重複）を Fail-Fast
  • src/mir/builder/control_flow/edgecfg/api/emit.rs

テスト

• emit_frag の Branch 生成・衝突検出、compose::if_ の BranchStub 生成を unit test で固定（lib tests PASS）

P1（見送り）

• “層を跨がない実適用”の候補調査を行い、現状は抽象化層（emit_conditional/emit_jump 等）へ委譲済みであるため、無理に差し替えず Phase 268 で体系的に適用する方針

次フェーズ（Phase 268）

• Branch の edge-args（then/else entry params）計算を含めた実戦投入
• JoinIR/NormalizedShadow/Pattern6/7/8 側へ段階的に適用（層境界を守る）