Files
hakorune/docs/development/roadmap/phases/phase-21.6-solidification

Phase 21.6 — Solidification (Hakoruneonly chain)

Goal

  • Develop and validate the full chain using Hakorune only: Parser(StageB) → MirBuilder (selfhostfirst) → VM → nyllvmc(crate) object/exe.
  • Stop optimizations until the chain is green and repeatable on this host.

Scope

  • Parser(StageB): JSON v0 correctness for control flow, call/method, literals.
  • MirBuilder: stable MIR(JSON) emission (no spurious newbox/MapBox in loop JsonFrag path when not intended).
  • VM: execute MIR(JSON) deterministically; stats/dev toggles optional.
  • nyllvmc(crate): build obj/exe from MIR(JSON); no llvmlite dependency in the default path.

Default Policy

  • Defaults remain unchanged for users. All bringup aids behind env toggles.
  • Logs quiet by default. Dev tags require explicit env.
  • Rust layer is used for diagnosis only; development proceeds via Hakorune scripts.

Env Toggles (recommended dev)

  • HAKO_SELFHOST_BUILDER_FIRST=1
  • NYASH_USE_NY_COMPILER=0 (alias of NYASH_DISABLE_NY_COMPILER)
  • HAKO/NYASH_ENABLE_USING=1
  • NYASH_PARSER_STAGE3=1, HAKO_PARSER_STAGE3=1
  • NYASH_LLVM_BACKEND=crate
  • Optional (debug): HAKO_MIR_BUILDER_LOOP_FORCE_JSONFRAG=1, HAKO_MIR_BUILDER_JSONFRAG_NORMALIZE=1

How to run (chain E2E)

  1. Emit MIR(JSON):
    • bash tools/hakorune_emit_mir.sh input.hako /tmp/out.json
  2. Build EXE (crate):
    • NYASH_LLVM_BACKEND=crate bash tools/ny_mir_builder.sh --in /tmp/out.json --emit exe -o a.out
  3. Run + check rc:
    • ./a.out; echo $?

Canaries

  • tools/dev/stageb_loop_json_canary.sh — Program(JSON) shape for loop(i<n){i=i+1}
  • tools/dev/phase216_chain_canary.sh — endtoend EXE rc=10 for minimal loop

Removal Plan for temporary parser fallback

  • Once VM/gpos interaction is fixed and parser emits correct loop JSON without guards, remove the conservative fallback in ParserControlBox.parse_loop.