tomoaki/hakorune
1
0
Fork 0
Code Issues Pull Requests Actions 1 Packages Projects Releases Wiki Activity
Files
f07c2e787443279928cfc6e360e19aa5227328cb
hakorune/docs/development/current/main/phases/phase-277/P0-INSTRUCTIONS.md
tomoaki 757193891f feat(llvm/phi): Phase 277 P1 - fail-fast validation for PHI strict mode 
## Summary
Implemented fail-fast validation for PHI ordering and value resolution in strict mode.

## Changes

### P1-1: Strict mode for "PHI after terminator"
- File: `src/llvm_py/phi_wiring/wiring.py::ensure_phi`
- Behavior: `NYASH_LLVM_PHI_STRICT=1` → RuntimeError if PHI created after terminator
- Default: Warning only (no regression)

### P1-2: Strict mode for "fallback 0"
- File: `src/llvm_py/phi_wiring/wiring.py::wire_incomings`
- Behavior: Strict mode forbids silent fallback to 0 (2 locations)
  - Location 1: Unresolvable incoming value
  - Location 2: Type coercion failure
- Error messages point to next debug file: `llvm_builder.py::_value_at_end_i64`

### P1-3: Connect verify_phi_ordering() to execution path
- File: `src/llvm_py/builders/function_lower.py`
- Behavior: Verify PHI ordering after all instructions emitted
- Debug mode: Shows "✅ All N blocks have correct PHI ordering"
- Strict mode: Raises RuntimeError with block list if violations found

## Testing
✅ Test 1: strict=OFF - passes without errors
✅ Test 2: strict=ON - passes without errors (no violations in test fixtures)
✅ Test 3: debug mode - verify_phi_ordering() connected and running

## Scope
- LLVM harness (Python) changes only
- No new environment variables (uses existing 3 from Phase 277 P2)
- No JoinIR/Rust changes (root fix is Phase 279)
- Default behavior unchanged (strict mode opt-in)

## Next Steps
- Phase 278: Remove deprecated env var support
- Phase 279: Root fix - unify "2本のコンパイラ" pipelines

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

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
2025-12-22 14:48:37 +09:00

3.1 KiB
Raw Blame History

Phase 277 P0: PHI型推論 SSOT docs を完成させる（Claude Code 指示書）

Status: instructions / docs-only

目的:

  • PHI型推論（MIR→LLVM harness）の導線・責務・SSOT を 1本に固定し、次回のデバッグで迷子にならないようにする。

スコープ:

  • docs のみ（設計と導線の固定）
  • 実装変更・仕様変更は行わない

Non-goals:

  • “2本のコンパイラ（パイプライン差）” の根治（Phase 279）
  • env var 追加（禁止）

入口SSOT:

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

参照:

  • P0設計メモ: docs/development/current/main/phases/phase-277/P0-DESIGN.md
  • P2完了（env var 統合）: docs/development/current/main/phases/phase-277/P2-COMPLETION.md
  • env vars: docs/reference/environment-variables.md
  • type helper SSOT（Phase 276 P0）: src/llvm_py/phi_wiring/type_helper.py

Step 1: README を “PHI型推論の地図” にする

docs/development/current/main/phases/phase-277/README.md に以下の節を追加/更新して、READMEだけ読めば導線が分かる状態にする。

必須内容（短くてOK）:

  • 何が SSOT か（どのファイルが “決める” か）
  • どこが consumer か（LLVM harness が何を期待するか）
  • どこを見れば原因が特定できるか（迷子防止）

最低限の “責務マップ”:

  • MIR 側:
    • MirInstruction.dst_type（instruction-local）
    • propagated value_types（analysis）
    • PHI dst_type（PHI-local）
  • LLVM harness 側:
    • PHI env var SSOT: src/llvm_py/phi_wiring/debug_helper.py
    • 型取得 SSOT: src/llvm_py/phi_wiring/type_helper.py
    • PHI placeholder SSOT: src/llvm_py/phi_wiring/wiring.py::ensure_phi
    • 順序検証: src/llvm_py/phi_placement.py（現状は verify/report）

注意:

  • llvmlite は基本 “命令の並べ替え” ができないことを明記する（PHI-first は生成時に守る）。
  • “2本のパイプライン” 問題は Phase 279 へリンクし、P0 で根治しないことを明確化する。

Step 2: デバッグ導線（最小）を README に固定

README に以下を固定する（1〜2コマンドだけ、冗長にしない）:

  • 推奨 env var（Phase 277 P2 統合版）

    • NYASH_LLVM_DEBUG_PHI=1
    • NYASH_LLVM_DEBUG_PHI_TRACE=1
    • NYASH_LLVM_PHI_STRICT=1

  • 典型コマンド（例）

    • NYASH_LLVM_DEBUG_PHI=1 NYASH_LLVM_USE_HARNESS=1 ./target/release/hakorune --backend llvm apps/tests/<fixture>.hako

  • 失敗時の “次に見るファイル” を 1 行で指示（固定順）

    • type_helper.py → wiring.py → llvm_builder.py → resolver.py

Step 3: docs 整合チェック（最小）

確認:

  • docs/development/current/main/10-Now.md の “次にやる” が Phase 277 を指していること
  • docs/development/current/main/30-Backlog.md の Phase 277/278/279 が矛盾していないこと

Acceptance:

  • README が入口SSOTとして成立（READMEだけで導線が追える）
  • P0-DESIGN/P1-VALIDATION/P2-COMPLETION へリンクがある
  • 新しい env var を増やしていない