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

Phase 277: PHI関連改善シリーズ

概要

Phase 275/276で完了したFloat型PHI対応・型取得SSOT化の後続改善として、PHI関連の環境変数統合・ドキュメント整備を実施。

---

サブフェーズ一覧

Phase 277 P0: PHI型推論ドキュメント整備（予定）

• 目的: Phase 275/276で実装したPHI型推論ロジックのドキュメント化
• 内容:
  • MIR型伝播 → LLVM IR型生成のフロー図
  • type_helper.py の設計ドキュメント
  • PHI型推論のベストプラクティス

Phase 277 P1: PHI順序検証強化（予定）

• 目的: PHI命令の配置順序検証を強化
• 内容:
  • phi_placement.py の検証ロジック強化
  • LLVM IR仕様準拠チェック（PHI → 非PHI → terminator）
  • 順序違反時のエラーメッセージ改善

Phase 277 P2: PHI関連環境変数の統合・整理 ✅

完了日: 2025-12-22

• 目的: PHI関連環境変数を 8個 → 3個 に統合
• 完了ドキュメント: P2-COMPLETION.md
• 達成内容:
  • ✅ debug_helper.py 作成（環境変数チェックのSSOT）
  • ✅ 3つの統合関数実装（is_phi_debug_enabled 他）
  • ✅ 9ファイル修正完了（wiring.py, tagging.py 他）
  • ✅ 後方互換性対応（Phase 278で削除予定）
  • ✅ ドキュメント更新（environment-variables.md）
• 効果:
  • ユーザビリティ向上（覚える変数 8個→3個、62%削減）
  • 保守性向上（環境変数チェックのSSOT化）
  • ドキュメント簡潔化

---

統合後の環境変数（P2完了版）

# PHI一般デバッグ（生成・型推論・順序）
NYASH_LLVM_DEBUG_PHI=1

# PHI詳細トレース（wiring・vmap変化）
NYASH_LLVM_DEBUG_PHI_TRACE=1

# PHI厳格モード（ゼロフォールバック禁止）
NYASH_LLVM_PHI_STRICT=1

詳細: docs/reference/environment-variables.md の「PHI デバッグ関連」セクション

---

関連Phase

• Phase 275: Float型PHI対応（MIR型伝播 → LLVM IR double生成）
• Phase 276: 型取得SSOT化（type_helper.py）
• Phase 278: 後方互換性削除（旧環境変数サポート削除予定）

---

ファイル構成

phase-277/
├── README.md                 # 本ファイル（Phase 277概要）
├── P2-COMPLETION.md          # P2完了報告
├── P0-DESIGN.md              # P0設計ドキュメント（予定）
└── P1-VALIDATION.md          # P1検証強化ドキュメント（予定）

---

今後の予定

1. Phase 277 P0: PHI型推論ドキュメント整備
2. Phase 277 P1: PHI順序検証強化
3. Phase 278: 後方互換性削除

---

Phase 277 P2 完了！ 次はP0/P1の計画策定へ。