tomoaki/hakorune
1
0
Fork 0
Code Issues Pull Requests Actions 1 Packages Projects Releases Wiki Activity
Files
a4d014a8141fd0b4adbeed2e1c5d1b71821e959b
hakorune/docs/reference/invariants.md
Selfhosting Dev c8063c9e41 pyvm: split op handlers into ops_core/ops_box/ops_ctrl; add ops_flow + intrinsic; delegate vm.py without behavior change 
net-plugin: modularize constants (consts.rs) and sockets (sockets.rs); remove legacy commented socket code; fix unused imports
mir: move instruction unit tests to tests/mir_instruction_unit.rs (file lean-up); no semantic changes
runner/pyvm: ensure using pre-strip; misc docs updates

Build: cargo build ok; legacy cfg warnings remain as before
2025-09-21 08:53:00 +09:00

1.6 KiB
Raw Blame History

Nyash Invariants (Spec)

This document lists non‑negotiable invariants the implementation preserves across backends. They’re used as a contract for testing and design.

Core

  • PHI hygiene
    • No empty PHI nodes are emitted in LLVM IR (temporary safety valve exists behind NYASH_LLVM_SANITIZE_EMPTY_PHI=1).
    • All PHIs appear at the beginning of a basic block.
  • Match/Peek
    • A match scrutinee is evaluated exactly once, bound to an internal gensym.
    • Guard conditions are logically conjoined with the arm predicate; fallthrough reaches the next arm.
  • Exceptions
    • Exceptions follow “scope first” semantics. Postfix catch/cleanup normalize to a single TryCatch block around the immediately‑preceding expression.
  • LoopForm
    • Loop bodies may be normalized where safe to a stable order: non‑assign statements then assign statements. No semantic reorder is performed when a non‑assign appears after any assign.
    • Carrier analysis emits observation hints only (zero runtime cost).
    • Break/continue lowering is unified via LoopBuilder; nested bare blocks inside loops are handled consistently (Program nodes recurse into loop‑aware lowering).
  • Scope
    • Enter/Leave scope events are observable through MIR hints; they do not affect program semantics.

Observability

  • MIR hints can be traced via NYASH_MIR_HINTS (pipe style): trace|scope|join|loop|phi or jsonl=path|loop.
  • Golden/Smoke tests cover representative invariants.

Backends

  • PyVM and LLVM share semantics; PyVM prioritizes clarity over performance.
  • Cranelift/WASM routes inherit the same invariants when enabled.