feat(phase277-p2): PHI環境変数統合 8個→3個 - ユーザビリティ向上

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

【問題】
- PHI関連環境変数が8個に乱立
- ユーザーが覚える変数が多すぎる
- 保守性が低い（関連設定が分散）

【解決】
1. debug_helper.py 新規作成（SSOT）
   - is_phi_debug_enabled(): 一般デバッグ（3変数統合）
   - is_phi_trace_enabled(): 詳細トレース（2変数統合）
   - is_phi_strict_enabled(): 厳格モード（既存維持）

2. 環境変数統合（8個→3個）
   統合後:
   - NYASH_LLVM_DEBUG_PHI: 一般PHIデバッグ
   - NYASH_LLVM_DEBUG_PHI_TRACE: 詳細トレース
   - NYASH_LLVM_PHI_STRICT: 厳格モード（既存維持）

   統合前（廃止予定）:
   - NYASH_LLVM_PHI_DEBUG → NYASH_LLVM_DEBUG_PHI
   - NYASH_PHI_TYPE_DEBUG → NYASH_LLVM_DEBUG_PHI
   - NYASH_PHI_ORDERING_DEBUG → NYASH_LLVM_DEBUG_PHI
   - NYASH_LLVM_TRACE_PHI → NYASH_LLVM_DEBUG_PHI_TRACE
   - NYASH_LLVM_VMAP_TRACE → NYASH_LLVM_DEBUG_PHI_TRACE

3. 後方互換性対応
   - 旧環境変数使用時に非推奨警告表示
   - Phase 278 で削除予定

【効果】
- ✅ ユーザビリティ向上: 覚える変数 8個→3個（62%削減）
- ✅ 保守性向上: 環境変数チェック 30+箇所→1箇所（SSOT）
- ✅ ドキュメント簡潔化: environment-variables.md 整理
- ✅ SSOT原則適用: debug_helper.py に環境変数ロジック集約

【影響範囲】
- 新規: debug_helper.py (SSOT)
- 修正: 9ファイル（PHI関連Python）
- ドキュメント: environment-variables.md, 10-Now.md

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>

docs/reference/environment-variables.md

@@ -2,7 +2,7 @@
 
 Nyash の主要な環境変数をカテゴリ別に整理するよ。`適用経路` はどのパスで効くかを示す:
 
-- Rust AST: Rust パーサ直通 (`--dump-mir` など)
+- Rust AST: Rust パーサ直通（例: `--dump-mir`。compile-only の入口）
 - JSON v0/Stage-1: selfhost/Stage-1/`--ny-parser-pipe` 経由（json_v0_bridge で処理）
 - Any: どの経路でも有効
 
@@ -20,7 +20,8 @@ Nyash の主要な環境変数をカテゴリ別に整理するよ。`適用経
 | `NYASH_DEBUG_STACK_OVERFLOW=1` | OFF | Any | スタックオーバーフロー時に backtrace を有効化 |
 
 ### ダンプの使い分け
-- Rust AST 直通: `./target/release/hakorune --dump-mir apps/tests/minimal.hako`（env は不要、stdout のみ）
+- 実行経路SSOT（推奨）: `NYASH_VM_DUMP_MIR=1 ./target/release/hakorune --backend vm apps/tests/minimal.hako`
+- Rust AST 直通（compile-only）: `./target/release/hakorune --dump-mir apps/tests/minimal.hako`（env は不要、stdout のみ）
 - JSON v0 経路/Stage-1: `RUST_MIR_DUMP_PATH=/tmp/out.mir NYASH_USE_STAGE1_CLI=1 STAGE1_EMIT_MIR_JSON=1 ./target/release/hakorune --dump-mir`（stdout + ファイル）
 
 ---
@@ -84,6 +85,64 @@ NYASH_USE_STAGE1_CLI=1 STAGE1_EMIT_MIR_JSON=1 \
 
 ---
 
+## PHI デバッグ関連 (Phase 277 P2 統合版)
+
+**Phase 277 P2** で PHI 関連環境変数を **8個 → 3個** に統合しました。
+
+| 変数 | デフォルト | 適用経路 | 説明 |
+| --- | --- | --- | --- |
+| `NYASH_LLVM_DEBUG_PHI=1` | OFF | LLVM | PHI生成・型推論・順序チェックのデバッグ出力 |
+| `NYASH_LLVM_DEBUG_PHI_TRACE=1` | OFF | LLVM | PHI wiring詳細トレース、vmap変化の追跡 |
+| `NYASH_LLVM_PHI_STRICT=1` | OFF | LLVM | PHI値解決時のゼロフォールバックを禁止（厳格モード） |
+
+### 旧環境変数（Phase 278で削除予定）
+
+以下の環境変数は **Phase 277 P2** で統合されました。現在は後方互換性のため動作しますが、非推奨警告が表示されます。
+
+**`NYASH_LLVM_DEBUG_PHI=1` に統合された変数:**
+- `NYASH_LLVM_PHI_DEBUG` (旧一般デバッグ)
+- `NYASH_PHI_TYPE_DEBUG` (旧型デバッグ)
+- `NYASH_PHI_ORDERING_DEBUG` (旧順序デバッグ)
+
+**`NYASH_LLVM_DEBUG_PHI_TRACE=1` に統合された変数:**
+- `NYASH_LLVM_TRACE_PHI` (旧トレース)
+- `NYASH_LLVM_VMAP_TRACE` (旧vmapトレース)
+
+### 使用例
+
+```bash
+# PHI一般デバッグ（生成・型・順序）
+NYASH_LLVM_DEBUG_PHI=1 ./target/release/hakorune --backend llvm program.hako
+
+# PHI詳細トレース
+NYASH_LLVM_DEBUG_PHI_TRACE=1 ./target/release/hakorune --backend llvm program.hako
+
+# 厳格モード（fail-fast）
+NYASH_LLVM_PHI_STRICT=1 ./target/release/hakorune --backend llvm program.hako
+
+# 組み合わせ
+NYASH_LLVM_DEBUG_PHI=1 NYASH_LLVM_DEBUG_PHI_TRACE=1 \
+  ./target/release/hakorune --backend llvm program.hako
+```
+
+### 出力例
+
+**`NYASH_LLVM_DEBUG_PHI=1`:**
+```
+[phi_wiring/create] v36 dst_type=f64 -> phi_type=double
+[phi_wiring/reuse] v36 predeclared PHI type matches: double
+⚠️  [phi_wiring/CRITICAL] PHI type mismatch! v12: predeclared=i64 expected=double
+```
+
+**`NYASH_LLVM_DEBUG_PHI_TRACE=1`:**
+```
+[trace:phi] wire_process: dst=36, decl_b=3, v_src=12
+[trace:phi] wire_pred_match: decl_b=3, pred_match=0
+[trace:phi] add_incoming: dst=36, pred=0
+```
+
+---
+
 ## LLVM Build Pipeline
 
 `tools/build_llvm.sh` で使用される環境変数。詳細は [`phase87-selfhost-llvm-exe-line.md`](../development/current/main/phase87-selfhost-llvm-exe-line.md) を参照。