hakorune/docs/development/current/main/phases/phase-29af/P4-LAYOUT-CONSISTENCY-CONTRACT-INSTRUCTIONS.md

Phase 29af P4: Layout Consistency Contract — Instructions

Status: Ready for execution
Scope: BoundaryCarrierLayout と LoopHeaderPhiInfo::carrier_order の整合を Fail-Fast で固定（仕様不変）

Goal

BoundaryCarrierLayout と header PHI の順序がズレたときに、merge 入口で早期に検知する。

Non-goals

• 挙動変更（release 既定挙動の変更）
• env var の追加
• fixture/smoke の増加

Implementation Steps

1. contract_checks にレイアウト整合性チェックを追加

   • src/mir/builder/control_flow/joinir/merge/contract_checks/header_phi_layout.rs
   • boundary の順序と header PHI の順序が一致することを strict/dev で検証

2. merge 入口でチェックを呼ぶ

   • src/mir/builder/control_flow/joinir/merge/coordinator.rs
   • prebuild_header_phis の直後で verify_header_phi_layout(...) を呼ぶ

3. boundary_hygiene を強化

   • src/mir/builder/control_flow/joinir/merge/contract_checks/boundary_hygiene.rs
   • carrier_info の順序と BoundaryCarrierLayout の順序が同名同順で一致することを検証

4. docs 更新

   • docs/development/current/main/phases/phase-29af/README.md
   • docs/development/current/main/10-Now.md
   • docs/development/current/main/30-Backlog.md

Verification

• cargo build --release
• ./tools/smokes/v2/run.sh --profile quick
• ./tools/smokes/v2/profiles/integration/joinir/phase29ae_regression_pack_vm.sh

Acceptance Criteria

• strict/dev でズレを Fail-Fast できる
• quick 154/154 PASS（不変）
• JoinIR regression pack が PASS