Files
hakorune/lang
nyash-codex f4ae144559 fix(using): StringUtils using resolution - dual root cause fix
🎯 Phase 21.7++ - using StringUtils as StringUtils 完全動作化!

## Root Cause #1: TOML Parse Error (lang/src/llvm_ir/hako_module.toml)

**Problem:**
```toml
line 18: aot_prep = "boxes/aot_prep.hako"     # scalar
line 19: aot_prep.passes.strlen = "..."       # table - CONFLICT!
```
→ TOML parse error prevented ALL aliases from loading
→ populate_from_toml() returned Err, aliases.len() = 0

**Fix:**
Commented out conflicting line 18:
```toml
# aot_prep = "boxes/aot_prep.hako"  # Commented out: conflicts with aot_prep.passes.* below
aot_prep.passes.strlen = "boxes/aot_prep/passes/strlen.hako"
```

**Result:**
 populate_from_toml() succeeds
 4 aliases loaded including StringUtils → string_utils

## Root Cause #2: Missing Arity Suffix (src/backend/mir_interpreter/handlers/calls/global.rs)

**Problem:**
- MIR functions stored as "BoxName.method/arity"
- VM looked up "StringUtils.starts_with" (no arity)
- Function table had "StringUtils.starts_with/2" (with /2)
→ Lookup failed with "Unknown: StringUtils.starts_with"

**Fix:**
Auto-append arity from args.len() if missing:
```rust
let mut canonical = crate::mir::naming::normalize_static_global_name(func_name);

if !canonical.contains('/') {
    canonical = format!("{}/{}", canonical, args.len());
}
```

**Result:**
 "StringUtils.starts_with" + args.len()=2 → "StringUtils.starts_with/2"
 VM function lookup succeeds

## Debug Infrastructure

**Added comprehensive debug logging:**
1. src/runner/pipeline.rs:36-55 - NYASH_DEBUG_USING=1 for alias loading
2. src/backend/mir_interpreter/handlers/calls/global.rs:17-42 - NYASH_DEBUG_FUNCTION_LOOKUP=1 for VM lookup

## Test Coverage

**src/tests/json_lint_stringutils_min_vm.rs:**
- Rewrote to test arity auto-completion (not using resolution)
- Inlined StringUtils implementation to avoid pipeline dependency
- Tests that VM can call "StringUtils.starts_with" without arity suffix
-  Test passes

**CLI Verification:**
```bash
NYASH_PARSER_STAGE3=1 HAKO_PARSER_STAGE3=1 NYASH_DISABLE_PLUGINS=1 \
  ./target/release/hakorune apps/tests/json_lint_stringutils_min.hako
# Output: OK
# RC: 0
```

## Impact

-  using StringUtils as StringUtils fully functional
-  All using aliases load successfully
-  VM can find functions with/without arity suffix
-  No breaking changes to existing code
-  Debug logging for future troubleshooting

## Files Modified

- lang/src/llvm_ir/hako_module.toml (TOML fix)
- src/runner/pipeline.rs (debug logging)
- src/backend/mir_interpreter/handlers/calls/global.rs (arity fix + logging)
- src/tests/json_lint_stringutils_min_vm.rs (rewrite + enable)
- src/tests/mod.rs (register test)

Co-authored-by: Task Agent <task@anthropic.com>
Co-authored-by: Claude Code <claude@anthropic.com>
2025-11-22 01:21:38 +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)

Dev line (Stage1 core experimental)

  • Dev build: tools/selfhost/build_stage1.sh → produces target/selfhost/hakorune
  • Role:
    • Fast iteration用の Stage1 selfhost バイナリNy Executor / CLI 実験など)。
    • new CLI/runner 機能はまずこちらで開発・検証する。

Stable line (lang bin snapshot)

  • Stable binary: lang/bin/hakorune
  • Build (pure-lang launcher, legacy bring-up):
    • lang/build/build_runner.sh → produces lang/bin/hakorune
    • Requirements: LLVM 18 dev (llvm-config-18)
  • PolicyPhase 25.1 以降の想定):
    • target/selfhost/hakorune で十分に安定したら、その成果物を lang/bin/hakorune に昇格させる(手動コピー or 専用スクリプト)。
    • lang/bin/hakorune は「last known good」の Stage1 コア EXE として扱い、配布や外部からの参照時は原則こちらを基準にする。

Notes

  • lang/ 以下は「最終的に 1 つの Stage1 コア EXEhakoruneを構成するソース群」という前提で整理する。
  • target/selfhost/hakorune は開発中の最新版、lang/bin/hakorune は安定版スナップショットという役割分担にする。