tomoaki/hakorune
1
0
Fork 0
Code Issues Pull Requests Actions 1 Packages Projects Releases Wiki Activity
Files
cb7021e166b101eabdce93e40d957d119e5916a9
hakorune/docs/tools/cli-options.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

2.0 KiB
Raw Blame History

Nyash CLI Options Quick Reference

最終更新: 2025-08-23

基本

  • file: 実行するNyashファイル（位置引数）
  • --backend {interpreter|vm|llvm}: 実行バックエンド選択（既定: interpreter）
  • --debug-fuel {N|unlimited}: パーサーのデバッグ燃料（無限ループ対策）

MIR関連

  • --dump-mir: MIRを出力（実行はしない / compile-only。実行経路SSOTの確認は NYASH_VM_DUMP_MIR=1 --backend vm を優先）
  • --verify: MIR検証を実施
  • --mir-verbose: 詳細MIR出力（統計など）

VM関連

  • --vm-stats: VM命令統計を有効化（NYASH_VM_STATS=1）
  • --vm-stats-json: VM統計をJSONで出力（NYASH_VM_STATS_JSON=1）

GC

  • --gc {auto|rc+cycle|minorgen|stw|rc|off}: GCモード（既定: auto → rc+cycle）
    • rc+cycle: 参照カウント + 循環回収（推奨・安定）
    • minorgen: 高速向けの軽量世代別（Gen‑0移動、上位非移動）
    • stw: 検証用の非移動Mark‑Sweep（開発者向け）
    • rc: 循環回収なしのRC（比較用）
    • off: 自己責任モード（循環はリーク）
  • 関連ENV
    • NYASH_GC_MODE（CLIが優先）
    • NYASH_GC_METRICS / NYASH_GC_METRICS_JSON
    • NYASH_GC_ALLOC_THRESHOLD
    • 詳細: docs/reference/runtime/gc.md

WASM/AOT

  • --compile-wasm: WATを出力
  • --compile-native / --aot: AOT実行ファイル出力（要wasm-backend）
  • --output, -o FILE: 出力先を指定

ベンチマーク

  • --benchmark: バックエンド比較ベンチを実行
  • --iterations N: ベンチ実行回数（既定: 10）

使用例

# インタープリターで実行
nyash program.hako

# VMで実行 + 統計をJSON出力
nyash --backend vm --vm-stats --vm-stats-json program.hako

# MIRを出力
nyash --dump-mir --mir-verbose program.hako

# ベンチマーク
nyash --benchmark --iterations 100

詳細は docs/reference/architecture/execution-backends.md も参照してください。

参考: nyash --help スナップショット

  • docs/tools/nyash-help.md