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>
This commit is contained in:
2025-12-22 13:57:33 +09:00
parent 9a76a199ee
commit 03aa54a422
13 changed files with 559 additions and 65 deletions

View File

@ -1,6 +1,30 @@
# Self Current Task — Now (main)
## Current: Phase 276P0)— Quick Win 改善型取得SSOT化
## Current: Phase 277P2)— PHI関連環境変数の統合・整理
- 目的: PHI関連環境変数を **8個 → 3個** に統合してユーザビリティ向上・保守性向上
- 完了日: 2025-12-22
- 達成内容:
-`debug_helper.py` 作成環境変数チェックのSSOT
- ✅ 3つの統合関数実装:
- `is_phi_debug_enabled()`: 一般デバッグLLVM_PHI_DEBUG + PHI_TYPE_DEBUG + PHI_ORDERING_DEBUG 統合)
- `is_phi_trace_enabled()`: 詳細トレースLLVM_TRACE_PHI + LLVM_VMAP_TRACE 統合)
- `is_phi_strict_enabled()`: 厳格モード(既存維持)
- ✅ 全PHI関連ファイル修正完了9ファイル:
- `phi_wiring/wiring.py`, `phi_wiring/tagging.py`, `phi_wiring/common.py`
- `phi_placement.py`, `trace.py`, `instructions/phi.py`
- `resolver.py`, `utils/values.py`, `builders/block_lower.py`
- ✅ 後方互換性対応非推奨警告付き、Phase 278で削除予定
- ✅ ドキュメント更新:
- `docs/reference/environment-variables.md` に詳細セクション追加
- 使用例・出力例・移行ガイド記載
- 効果:
- ユーザビリティ向上(覚える変数 8個→3個
- ドキュメント簡潔化(環境変数セクションが短く)
- 保守性向上関連設定が1つに
- SSOT原則適用環境変数チェックロジック統一
## 2025-12-22: Phase 276P0— Quick Win 改善型取得SSOT化
- 目的: Phase 275 P0 完了後の堅牢性改善デバッグコード削減・型取得ロジックSSOT化・警告強化
- 完了ドキュメント: `docs/development/current/main/phases/phase-276/P0-COMPLETION.md`