hakorune/docs/smokes.md

Smoke Matrix (Backends)

Policy

• PyVM: partial coverage only (no async/nowait/await/GC/sync). Used for semantics sanity.
• LLVM: full coverage via llvmlite harness. Preferred path for async/nowait and Stage-3 control-flow.
• JIT: not maintained for these smokes (skip).

Curated Smokes

• Core (LLVM): examples/llvm11_core_smoke.nyash
• Async (LLVM only):
  • apps/tests/async-await-min/main.nyash
  • apps/tests/async-spawn-instance/main.nyash
  • apps/tests/async-await-timeout-fixed/main.nyash (set NYASH_AWAIT_MAX_MS=100)

Runner Scripts

• tools/smokes/curated_llvm.sh [--phi-off]
  • --phi-off: enables NYASH_MIR_NO_PHI=1 + verifier relaxor.
• Archived (not maintained): see tools/smokes/archive/
  • smoke_phase_10_10.sh, smoke_vm_jit.sh, smoke_async_spawn.sh, jit_smoke.sh, aot_smoke_cranelift.sh
  • These target JIT/Cranelift-era flows. Use the curated LLVM runner instead.

Flags

• NYASH_LLVM_USE_HARNESS=1: use llvmlite harness for AOT.
• NYASH_MIR_NO_PHI=1 and NYASH_VERIFY_ALLOW_NO_PHI=1: PHI-less MIR (edge-copy) mode.

Notes

• Marked async smokes should not be run under PyVM/JIT.
• Legacy/archived smokes may exist; curated runner avoids them.