@ -0,0 +1,134 @@
---
Status: Ready
Scope: code+tests+docs（
Related:
- docs/development/current/main/phases/phase-29ao/README.md
- tools/smokes/v2/profiles/integration/joinir/phase29ae_regression_pack_vm.sh
- tools/smokes/v2/profiles/integration/apps/phase286_pattern5_break_vm.sh
- src/mir/builder/control_flow/joinir/patterns/router.rs
- src/mir/builder/control_flow/plan/normalizer/pattern5_infinite_early_exit.rs
- src/mir/builder/control_flow/plan/facts/pattern5_infinite_early_exit_facts.rs
---
# Phase 29ao P25: strict/dev Pattern5 (Infinite Early-Exit) を Facts→CorePlan で shadow adopt
Date: 2025-12-30
Status: Ready for execution
Goal: Pattern5（ ） （ ） （
## 背景
- P17/P23/P24 で Pattern1/3/7 を strict/dev のみ Facts→CorePlan へ寄せた。
- Pattern5 は回帰ゲート（ ）
- P16 で Pattern5 の exit join を `Frag.block_params + EdgeArgs` へ移しているため、ここを adopt 対象にすると “CorePlan化の実地” が進む。
## 非目的
- release 既定経路の変更
- Pattern5 の対応範囲拡張（
- 新しい env var/恒常ログの追加
- DomainPlan の撤去（段階移行中）
## 実装方針
### 1) Facts→CorePlan の入口を PlanNormalizer に追加（ ）
対象:
- `src/mir/builder/control_flow/plan/normalizer/mod.rs`
- `src/mir/builder/control_flow/plan/normalizer/pattern5_infinite_early_exit.rs`
追加:
- `pub(in crate::mir::builder) fn normalize_pattern5_infinite_early_exit_from_facts(...) -> Result<Option<CorePlan>, String>`
仕様:
- `CanonicalLoopFacts.facts.pattern5_infinite_early_exit` が `Some` のときだけ `Some(CorePlan)` を返す
- それ以外は `Ok(None)` （ ）
- 実装は “薄い変換” のみ:
- `Pattern5InfiniteEarlyExitFacts -> Pattern5InfiniteEarlyExitPlan` を機械的に詰め替える
- 既存の `normalize_pattern5_infinite_early_exit(builder, Pattern5InfiniteEarlyExitPlan, ctx)` を呼ぶ
- Pattern5 のロジックは再実装しない（ ）
擬似コード:
```rust
pub ( in crate ::mir ::builder ) fn normalize_pattern5_infinite_early_exit_from_facts (
builder : & mut MirBuilder ,
facts : & CanonicalLoopFacts ,
ctx : & LoopPatternContext ,
) -> Result < Option < CorePlan > , String > {
let Some ( p5 ) = facts . facts . pattern5_infinite_early_exit . as_ref () else { return Ok ( None ); };
let parts = Pattern5InfiniteEarlyExitPlan {
loop_var : p5 . loop_var . clone (),
exit_kind : p5 . exit_kind ,
exit_condition : p5 . exit_condition . clone (),
exit_value : p5 . exit_value . clone (),
carrier_var : p5 . carrier_var . clone (),
carrier_update : p5 . carrier_update . clone (),
loop_increment : p5 . loop_increment . clone (),
};
Ok ( Some ( Self ::normalize_pattern5_infinite_early_exit ( builder , parts , ctx ) ? ))
}
```
### 2) router の strict/dev shadow adopt を Pattern5 に拡張
対象:
- `src/mir/builder/control_flow/joinir/patterns/router.rs`
方針:
- `DomainPlan::Pattern5InfiniteEarlyExit(_)` を選んだとき、strict/dev では adopt を “強制” する
- facts が無い/矛盾する場合は `Err(...)` （
- release 既定は従来通り `lower_via_plan(builder, domain_plan, ctx)` へ
擬似コード:
```rust
if strict_or_dev && matches! ( domain_plan , DomainPlan ::Pattern5InfiniteEarlyExit ( _ )) {
let facts = outcome . facts . as_ref (). ok_or ( "pattern5 strict/dev adopt failed: facts missing" ) ? ;
if facts . facts . pattern5_infinite_early_exit . is_none () {
return Err ( "pattern5 strict/dev adopt failed: facts mismatch" . to_string ());
}
let core = PlanNormalizer ::normalize_pattern5_infinite_early_exit_from_facts ( builder , facts , ctx ) ?
. ok_or ( "pattern5 strict/dev adopt failed: compose rejected" ) ? ;
PlanVerifier ::verify ( & core ) ? ;
return PlanLowerer ::lower ( builder , core , ctx );
}
```
注意:
- 新ログは増やさない（
### 3) strict/dev gate を regression pack に追加（新 smoke 1 本）
現状の `phase286_pattern5_break_vm.sh` は strict を付けていないため、P25 の adopt 経路が回帰ゲートで踏まれない。
そこで “strict shadow adopt” 専用の smoke を追加して pack に組み込む。
追加ファイル:
- `tools/smokes/v2/profiles/integration/joinir/phase29ao_pattern5_strict_shadow_vm.sh`
内容:
- fixture: `apps/tests/phase286_pattern5_break_min.hako`
- `NYASH_DISABLE_PLUGINS=1` + `HAKO_JOINIR_STRICT=1` で VM 実行
- 期待: 出力が `3` （または `RC: 3` ）を含む
pack へ追加:
- `tools/smokes/v2/profiles/integration/joinir/phase29ae_regression_pack_vm.sh` に
`run_filter "pattern5_strict_shadow_vm" "phase29ao_pattern5_strict_shadow_vm"` を追加
docs 更新:
- `docs/development/current/main/phases/phase-29ae/README.md` に pack 項目として追記
## テスト（必須）
- `cargo build --release`
- `./tools/smokes/v2/run.sh --profile quick`
- `./tools/smokes/v2/profiles/integration/joinir/phase29ae_regression_pack_vm.sh`
## docs 更新
- `docs/development/current/main/phases/phase-29ao/README.md` （
- `docs/development/current/main/10-Now.md` / `docs/development/current/main/30-Backlog.md` / `CURRENT_TASK.md`
- （必要なら）`docs/development/current/main/design/coreplan-migration-roadmap-ssot.md` の “Current/Next” も更新
## コミット
- `git add -A`
- `git commit -m "phase29ao(p25): strict/dev adopt pattern5 from facts"`
