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

Phase 29ai: Plan/Frag single-planner (Facts SSOT)

Goal: pattern 名による分岐を外部APIから消し、Facts（事実）→ Plan → Frag の導線を 1 本に収束させる（仕様不変）。

P0: LoopFacts SSOT + Single Planner skeleton

• 指示書: docs/development/current/main/phases/phase-29ai/P0-LOOPFACTS-SSOT-SINGLE-PLANNER-INSTRUCTIONS.md
• 追加される骨格（未接続・仕様不変）: src/mir/builder/control_flow/plan/{facts,normalize,planner,emit}/

P1: Planner candidate-set + Freeze SSOT

• 指示書: docs/development/current/main/phases/phase-29ai/P1-PLANNER-CANDIDATES-FREEZE-SSOT-INSTRUCTIONS.md
• ねらい: Ok(None) / Err(Freeze) の境界と “候補集合→一意化” をSSOT化（未接続のまま、仕様不変）

P2: SSOT Registry + Freeze Taxonomy（docs-only）

• 指示書: docs/development/current/main/phases/phase-29ai/P2-SSOT-REGISTRY-FREEZE-TAXONOMY-INSTRUCTIONS.md
• ねらい: “真実の所在” と Freeze 分類を1枚に固定して、後続実装の迷子を防ぐ（仕様不変）
• SSOT Registry: docs/development/current/main/design/planfrag-ssot-registry.md
• Freeze taxonomy: docs/development/current/main/design/planfrag-freeze-taxonomy.md

P3: Typed Freeze + CandidateSet implementation（code）

• 指示書: docs/development/current/main/phases/phase-29ai/P3-TYPED-FREEZE-CANDIDATESET-IMPLEMENTATION-INSTRUCTIONS.md
• ねらい: Planner の契約を型/候補集合で固定（Facts 未実装の間は未到達、仕様不変）

P4: First LoopFacts（Pattern6 scan-with-init）

• 指示書: docs/development/current/main/phases/phase-29ai/P4-FIRST-LOOPFACTS-PATTERN6-SCAN_WITH_INIT-INSTRUCTIONS.md
• ねらい: Facts→Planner を 1 ケースだけ前進（未接続のまま、仕様不変）

P5: Single-planner bridge（router → 1 entrypoint）

• 指示書: docs/development/current/main/phases/phase-29ai/P5-SINGLE-PLANNER-BRIDGE-ROUTER-INSTRUCTIONS.md
• ねらい: JoinIR の pattern ルーティングを外部APIから剥がし、入口を 1 本に収束（仕様不変）

Verification (SSOT)

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