Files
hakorune/docs/development/selfhosting/quickstart.md
nyash-codex a7dbc15878 feat(joinir): Phase 240-EX - Pattern2 header condition ExprLowerer integration
Implementation:
- Add make_pattern2_scope_manager() helper for DRY
- Header conditions use ExprLowerer for supported patterns
- Legacy fallback for unsupported patterns
- Fail-Fast on supported patterns that fail

Tests:
- 4 new tests (all pass)
- test_expr_lowerer_supports_simple_header_condition_i_less_literal
- test_expr_lowerer_supports_header_condition_var_less_var
- test_expr_lowerer_header_condition_generates_expected_instructions
- test_pattern2_header_condition_via_exprlowerer

Also: Archive old phase documentation (34k lines removed)

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

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2025-12-11 00:33:04 +09:00

2.7 KiB
Raw Blame History

Status: SSOT, Active

SelfHosting Quickstart (Phase 15 — Resume)

This note shows how to run the Nyash selfhost compiler MVP to emit MIR(JSON v0) and execute it with the current VM line. The flow keeps defaults unchanged and uses small, optin flags for development.

Layout (migrated)

  • Compiler entry (StageB): lang/src/compiler/entry/compiler_stageb.hako
  • Compiler entry (compat, StageA/AOT): lang/src/compiler/entry/compiler.hako
  • Shared helpers live under lang/src/shared/
  • VM/Core live under lang/src/vm/

Run the selfhost compiler

Compile a minimal program (string embedded in the compiler) and print JSON v0:

./target/release/nyash lang/src/compiler/entry/compiler_stageb.hako -- --stage3 --source 'static box Main { main() { return 7 } }'

ENV → child args (透過):

  • NYASH_NY_COMPILER_MIN_JSON=1-- --min-json
  • NYASH_SELFHOST_READ_TMP=1-- --read-tmp (reads tmp/ny_parser_input.ny)
  • NYASH_NY_COMPILER_STAGE3=1-- --stage3 (Stage3 surface enable)
  • NYASH_NY_COMPILER_CHILD_ARGS="..." → passes extra args verbatim

Examples:

NYASH_NY_COMPILER_MIN_JSON=1 ./target/release/nyash lang/src/compiler/entry/compiler_stageb.hako -- --stage3 --source 'static box Main { main() { return 1+2 } }' > /tmp/out.json
NYASH_SELFHOST_READ_TMP=1 ./target/release/nyash lang/src/compiler/entry/compiler_stageb.hako -- --min-json --stage3

Execute MIR(JSON v0)

Use the VM line (Rust) or PyVM harness as needed.

Rust VM (default):

./target/release/nyash --backend vm apps/examples/json_query/main.hako

PyVM reference (when verifying parity):

NYASH_VM_USE_PY=1 ./target/release/nyash --backend vm apps/examples/json_query/main.hako

LLVM harness (llvmlite):

NYASH_LLVM_USE_HARNESS=1 ./target/release/nyash --backend llvm apps/examples/json_query/main.hako

Notes:

  • For selfhost emitted JSON, route the file to your runner pipeline or a small loader script (dev only). Keep defaults unchanged in CI (no new jobs required).

Oneshot dev smoke

Run a minimal endtoend smoke that tries to emit JSON (besteffort) and verifies VM outputs match with Known rewrite ON/OFF:

tools/selfhost_smoke.sh

It does not modify defaults and is safe to run locally.

Flags (dev)

  • Known rewrite default ON (userbox only, strict guards): NYASH_REWRITE_KNOWN_DEFAULT=0|1
  • Router trace: NYASH_ROUTER_TRACE=1
  • KPI sampling: NYASH_DEBUG_KPI_KNOWN=1 (+ NYASH_DEBUG_SAMPLE_EVERY=N)
  • Local SSA trace: NYASH_LOCAL_SSA_TRACE=1

Acceptance (P6 resume)

  • quick/integration remain green.
  • Minimal selfhost emit→execute path PASS in a dev job (no CI change).
  • No default behavior changes; all diagnostics under env flags.