hakorune/docs/development/current/main/phases/phase-29an/P7-CANONICAL-LOOPFACTS-PROJECTIONS-INSTRUCTIONS.md

Status, Scope, Related

Status	Scope	Related
Active	code（仕様不変、normalize SSOT の段階強化）	docs/development/current/main/phases/phase-29an/README.md docs/development/current/main/design/coreplan-skeleton-feature-model.md docs/development/current/main/phases/phase-29ae/README.md

Phase 29an P7: CanonicalLoopFacts に skeleton/exit_usage の projection を追加（仕様不変）

Date: 2025-12-29
Status: Ready for execution
Scope: canonicalize_loop_facts を “将来の骨格/特徴合成” に耐える形へ寄せる（挙動不変）

Objective

• CanonicalLoopFacts に skeleton_kind / exit_usage の 投影(projection) を追加する
  • planner が facts.facts.* の深掘りをしなくても “骨格/特徴” の入口が 1 箇所に揃う
• 既存の候補生成・順序・ログ・エラー文字列は不変

Non-goals

• 新しい Freeze の発火（gate を壊さない）
• 候補の増減や優先順序変更
• facts の Ok(None) gate の変更

Implementation

Step 1: CanonicalLoopFacts を拡張（projection追加）

Update:

• src/mir/builder/control_flow/plan/normalize/canonicalize.rs

Change:

• struct CanonicalLoopFacts { pub facts: LoopFacts } に以下を追加
  • pub skeleton_kind: SkeletonKind
  • pub exit_usage: ExitUsageFacts

Populate:

• skeleton_kind = facts.skeleton.kind
• exit_usage = facts.features.exit_usage.clone()

注意:

• LoopFacts 側で skeleton/features は必須なので Option 剥がしは不要
• canonicalize_loop_facts は pure transform のまま（副作用/ログ禁止）

Step 2: planner の skeleton gate を projection へ寄せる（挙動不変）

Update:

• src/mir/builder/control_flow/plan/planner/build.rs

Change:

• facts.facts.skeleton.kind 参照を facts.skeleton_kind に置き換えるだけ（ロジック不変）

Step 3: unit tests（最低限）

Add tests in canonicalize.rs:

• canonicalize_loop_facts で skeleton_kind が Loop になる
• exit_usage が Facts 由来で投影されている（例: break/continue/return が立つ）

Verification（required）

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

Commit

• git add -A && git commit -m "phase29an(p7): add canonical projections for skeleton/features"