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

Status: Active
Date: 2025-12-22
Scope: Pattern6/7 を Frag + emit_frag() へ段階吸収（pattern列挙の増殖を止める）
Related:

• Design SSOT: docs/development/current/main/design/edgecfg-fragments.md
• Phase 269（Pattern8 Frag）: docs/development/current/main/phases/phase-269/README.md
• Phase 270（Pattern9 bridge）: docs/development/current/main/phases/phase-270/README.md

Phase 272（P0）: Pattern6/7 を Frag+emit_frag へ吸収（段階適用）

ステータス

• P0.1（Pattern6）: ✅ 完了（Frag+emit_frag 経路へ移行）
• P0.2（Pattern7）: ✅ 完了（Frag+emit_frag 経路へ移行）

目的

• Pattern6/7（scan系）の CFG 構築を “pattern番号ごとの推測分岐” から外し、**EdgeCFG Frag 合成（ExitKind/wires/branches）**に収束させる。
• terminator emission を SSOT（emit_frag()）へ集約し、block の successors/preds 同期漏れを構造で防ぐ。

スコープ境界

✅ 触る

• src/mir/builder/control_flow/joinir/patterns/pattern6_scan_with_init.rs
• src/mir/builder/control_flow/joinir/patterns/pattern7_split_scan.rs
• src/mir/builder/emission/（Pattern8 と同じ “薄い入口” の追加）

❌ 触らない

• merge/EdgeCFG plumbing（Phase 260-268 の SSOT は維持）
• cf_loop の非JoinIR経路追加（JoinIR-only hard-freeze 維持）
• by-name ハードコード（Box名/Pattern名文字列での分岐増殖など）

入口SSOT（fixture/smoke）

Pattern6（index_of）

• fixture: apps/tests/phase254_p0_index_of_min.hako（exit=1）
• smoke (VM): tools/smokes/v2/profiles/integration/apps/phase254_p0_index_of_vm.sh

Pattern7（split）

• fixture: apps/tests/phase256_p0_split_min.hako（exit=3）
• smoke (VM): tools/smokes/v2/profiles/integration/apps/phase256_p0_split_vm.sh

方針（P0）

P0 は “両方一気に” ではなく、以下の順で段階適用する。

1. Pattern6 を Frag + emit_frag() に切り替え（wiring を SSOT 化）
2. Pattern7 を Frag + emit_frag() に切り替え（副作用 push を含む）
3. 旧 JoinIR 経路の撤去条件が満たせた時点で削除（本READMEに明記）

実装ガイド（共通）

• PHI は block 先頭（after existing phis）へ挿入し、入力を [(pred_bb, val)] の形で固定する:
  • crate::mir::ssot::cf_common::insert_phi_at_head_spanned
• terminator emission は crate::mir::builder::control_flow::edgecfg::api::emit_frag に集約する。
• Pattern8 の構造（参考）:
  • emission 入口: src/mir/builder/emission/loop_predicate_scan.rs

P0.1: Pattern6（index_of）— Frag 化

狙い

• loop 骨格（header/body/step/after + early return）を Frag に落とし、Jump/Branch/Return を emit_frag() に集約する。

実装結果（✅ 完了）

• emission 入口を新設し、Pattern6 の terminator emission を emit_frag()（SSOT）へ集約
  • 新規: src/mir/builder/emission/loop_scan_with_init.rs
  • 更新: src/mir/builder/emission/mod.rs
• Pattern6 の JoinIRConversionPipeline 経路を撤去し、Frag 経路へ切り替え
  • 更新: src/mir/builder/control_flow/joinir/patterns/pattern6_scan_with_init.rs
• P0 スコープ:
  • forward scan（step=1）のみ適用
  • reverse/dynamic needle 等は Ok(None) で不適用（既定挙動不変）
• 旧 DCE 対策（exit PHI 用の post-loop guard）を撤去（Frag が Return を直接 emit するため）

最小 CFG 形（forward scan）

• blocks: header, body, step, after, ret_found
• header:
  • i_current = phi [i_init, preheader], [i_next, step_bb]
  • cond_loop = (i_current < len)
  • branch: true→body, false→after
• body:
  • ch = s.substring(i_current, i_current+1)
  • cond_match = (ch == needle)
  • branch: true→ret_found, false→step
• step:
  • i_next = i_current + 1
  • jump: →header
• ret_found:
  • wire: Return(i_current)
• after:
  • P0 では return -1 を既存 AST lowering に任せてもよい（after を current_block にする）

受け入れ

• cargo test -p nyash-rust --lib --release
• HAKORUNE_BIN=./target/release/hakorune bash tools/smokes/v2/profiles/integration/apps/phase254_p0_index_of_vm.sh

追加の検証（推奨）

• NYASH_VM_DUMP_MIR=1 ./target/release/hakorune --backend vm apps/tests/phase254_p0_index_of_min.hako で PHI/terminator を確認（任意）

P0.2: Pattern7（split）— Frag 化

狙い

• Pattern7 の terminator 配線（if/loop の遷移）を Frag に集約し、副作用（result.push）を含む形でも CFG を壊さない。

注意点（Fail-Fast）

• carriers が複数（i, start）なので、header の PHI を 2 本（以上）で SSA を閉じる必要がある。
• result.push は副作用なので、block 配置（評価順）を壊さない（P0は固定形のみ受理）。

実装結果（✅ 完了）

• Pattern7 の JoinIRConversionPipeline 経路を撤去し、Frag+emit_frag 経路へ切り替え
  • 更新: src/mir/builder/control_flow/joinir/patterns/pattern7_split_scan.rs
• emission 入口を新設し、terminator emission を emit_frag()（SSOT）へ集約
  • 新規: src/mir/builder/emission/loop_split_scan.rs
  • 更新: src/mir/builder/emission/mod.rs
• CFG 形（P0）:
  • blocks: header, body, then, else, step, after（+ 入口 preheader）
  • header: PHI（i_current, start_current） + loop condition
  • body: delimiter match check
  • then: result.push(segment) + start_next_then 計算（dominance 安全）
  • else: i_next_else = i_current + 1
  • step: PHI（i_next, start_next） + jump header
• Compare は CompareOp::Le（i <= limit）を使用（固定形）

リファクタ結果（共通SSOT）

Phase 272 P0.2 完了後、Pattern6/7/8 の重複を以下へ収束した（仕様不変）:

• PHI 挿入の薄いラッパ: src/mir/builder/emission/phi.rs
• variable_map の fail-fast 取得: src/mir/builder/variable_context.rs（require(name, ctx)）
• can_lower の戦略メモ: src/mir/builder/control_flow/joinir/patterns/router.rs（CanLowerStrategy）

受け入れ

• HAKORUNE_BIN=./target/release/hakorune bash tools/smokes/v2/profiles/integration/apps/phase256_p0_split_vm.sh
  • PASS（exit=3）
  • MIR 形（PHI/Branch/Jump/BoxCall(push)）を目視確認できること（任意）

Next（planned）: Phase 273（design-first）— Pattern を Plan Extractor に降格して裾広がりを止める

Phase 272（P0）で “terminator SSOT（emit_frag）へ寄せる” を完了したら、次は上流の収束（compiler flow の一本化）を行う。

• 相談メモ（外部レビュー用）: docs/development/current/main/investigations/phase-272-frag-plan-architecture-consult.md
• ねらい:
  • Pattern = Plan 抽出（pure） に降格（builder を触らない）
  • Plan = seq/if/loop/exit/effect/let の固定語彙（増殖しない）
  • PlanLowerer が block/value/phi を作る唯一の箱（emit_frag は SSOT のまま）
• 受け入れ（最小）:
  • extractor が next_block_id/next_value_id/insert_phi_* を呼ばない（純関数）
  • Plan→Frag→emit_frag の本線が 1 本になる（pattern番号列挙を中心にしない）

旧 JoinIR 経路の撤去条件（SSOT）

旧 JoinIRConversionPipeline 系の経路を削るのは、以下を満たした後に行う。

1. Pattern6/7 の fixture/smoke が Frag 経路で PASS
2. tools/smokes/v2/run.sh --profile quick が悪化しない
3. router から該当 pattern の “旧経路” が消せる（最小差分で削除可能）

テスト手順（固定）

1. cargo build --release
2. cargo test -p nyash-rust --lib --release
3. HAKORUNE_BIN=./target/release/hakorune bash tools/smokes/v2/profiles/integration/apps/phase254_p0_index_of_vm.sh
4. HAKORUNE_BIN=./target/release/hakorune bash tools/smokes/v2/profiles/integration/apps/phase256_p0_split_vm.sh