Files
hakorune/lang
nyash-codex f6c5dc9e43 Phase 22.x WIP: LLVM backend improvements + MIR builder enhancements
LLVM backend improvements:
- Add native LLVM backend support (NYASH_LLVM_BACKEND=native)
- Add crate backend selector with priority (crate > llvmlite)
- Add native_llvm_builder.py for native IR generation
- Add NYASH_LLVM_NATIVE_TRACE=1 for IR dump

MIR builder enhancements:
- Refactor lower_if_compare_* boxes for better code generation
- Refactor lower_return_* boxes for optimized returns
- Refactor lower_loop_* boxes for loop handling
- Refactor lower_method_* boxes for method calls
- Update pattern_util_box for better pattern matching

Smoke tests:
- Add phase2100 S3 backend selector tests (17 new tests)
- Add phase2120 native backend tests (4 new tests)
- Add phase2034 MIR builder internal tests (2 new tests)
- Add phase2211 TLV shim parity test

Documentation:
- Update ENV_VARS.md with LLVM backend variables
- Update CURRENT_TASK.md with progress
- Update README.md and CHANGELOG.md

Config:
- Add NYASH_LLVM_BACKEND env support in src/config/env.rs
- Update ny_mir_builder.sh for backend selection
- Update dispatch.rs for backend routing

Tools:
- Add tools/native_llvm_builder.py
- Update smokes/v2/profiles/quick/core/phase2100/run_all.sh

Known: Many Hako builder internal files modified for optimization
2025-11-09 23:40:36 +09:00
..

Hakorune Lang Line — Rust-less Kernel (C ABI)

Scope

  • This lang/ tree hosts the script-driven C ABI kernel artifacts for Phase 20.9+.
  • Goal: keep the runtime data plane callable without Rust on the hot path (Hakorune → LLVM → C ABI).

Principles

  • Separation: do not mix Rust crates or cargo-specific layout under this tree.
  • Ownership & ABI:
    • Any char* returned across the ABI is owned by the callee and must be freed via hako_mem_free().
    • Do not mix CRT free() across boundaries.
  • FailFast: no silent fallbacks. Missing symbols must be observable via short diagnostics.

Layout (initial)

  • c-abi/ — C shim(s) and headers for the minimal kernel surface
    • README.md — responsibilities, build notes, platform caveats
    • include/ — public headers (mirrored or thin wrappers)
    • shims/ — libc-backed shim(s) for canaries and local testing

Build & Link (dev)

  • C shim: build a shared library to satisfy symbols for the LLVM line canaries.
  • Link flags example:
    • Linux: -L$(pwd)/target/release -Wl,-rpath,$(pwd)/target/release -lhako_kernel_shim

NonGoals

  • Plugin loader, HostBridge router, Box/Type system — kept in Rust.

Selfhost Launcher (AOT)

  • Build: lang/build/build_runner.sh → produces lang/bin/hakorune
  • Requirements: LLVM 18 dev (llvm-config-18)
  • Run: lang/bin/hakorune

Notes

  • The launcher is minimal and prints a stable line [lang-launcher] hello.
  • This binary is a stepping stone towards a full selfhosted CLI built from Hakorune scripts.