Files
hakorune/lang/c-abi
nyash-codex 301b1d212a Phase 21.2 Complete: VM Adapter正規実装 + devブリッジ完全撤去
## 🎉 Phase 21.2完全達成

###  実装完了
- VM static box 永続化(singleton infrastructure)
- devブリッジ完全撤去(adapter_dev.rs削除、by-name dispatch削除)
- .hako正規実装(MirCallV1Handler, AbiAdapterRegistry等)
- text-merge経路完全動作
- 全phase2120 adapter reps PASS(7テスト)

### 🐛 バグ修正
1. strip_local_decl修正
   - トップレベルのみlocal削除、メソッド内は保持
   - src/runner/modes/common_util/hako.rs:29

2. static box フィールド永続化
   - MirInterpreter singleton storage実装
   - me parameter binding修正(1:1マッピング)
   - getField/setField string→singleton解決
   - src/backend/mir_interpreter/{mod,exec,handlers/boxes_object_fields}.rs

3. Map.len alias rc=0修正
   - [map/missing]パターン検出でnull扱い(4箇所)
   - lang/src/vm/boxes/mir_call_v1_handler.hako:91-93,131-133,151-153,199-201

### 📁 主要変更ファイル

#### Rust(VM Runtime)
- src/backend/mir_interpreter/mod.rs - static box singleton storage
- src/backend/mir_interpreter/exec.rs - parameter binding fix
- src/backend/mir_interpreter/handlers/boxes_object_fields.rs - singleton resolution
- src/backend/mir_interpreter/handlers/calls.rs - dev bridge removal
- src/backend/mir_interpreter/utils/mod.rs - adapter_dev module removal
- src/backend/mir_interpreter/utils/adapter_dev.rs - DELETED (7555 bytes)
- src/runner/modes/vm.rs - static box declaration collection
- src/runner/modes/common_util/hako.rs - strip_local_decl fix
- src/instance_v2.rs - Clone implementation

#### Hako (.hako実装)
- lang/src/vm/boxes/mir_call_v1_handler.hako - [map/missing] detection
- lang/src/vm/boxes/abi_adapter_registry.hako - NEW (adapter registry)
- lang/src/vm/helpers/method_alias_policy.hako - method alias support

#### テスト
- tools/smokes/v2/profiles/quick/core/phase2120/s3_vm_adapter_*.sh - 7 new tests

### 🎯 テスト結果
```
 s3_vm_adapter_array_len_canary_vm.sh
 s3_vm_adapter_array_len_per_recv_canary_vm.sh
 s3_vm_adapter_array_length_alias_canary_vm.sh
 s3_vm_adapter_array_size_alias_canary_vm.sh
 s3_vm_adapter_map_len_alias_state_canary_vm.sh
 s3_vm_adapter_map_length_alias_state_canary_vm.sh
 s3_vm_adapter_map_size_struct_canary_vm.sh
```

環境フラグ: HAKO_ABI_ADAPTER=1 HAKO_ABI_ADAPTER_DEV=0

### 🏆 設計品質
-  ハードコード禁止(AGENTS.md 5.1)完全準拠
-  構造的・一般化設計(特定Box名のif分岐なし)
-  後方互換性保持(既存コード破壊ゼロ)
-  text-merge経路(.hako依存関係正しくマージ)

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

Co-Authored-By: Claude <noreply@anthropic.com>
2025-11-07 19:32:44 +09:00
..

C ABI Kernel — Minimal Shim for Phase 20.9

Responsibility

  • Provide a portable, minimal C ABI surface used by the LLVM line.
  • Readonly GC externs first (hako_gc_stats, hako_gc_roots_snapshot), plus memory/console/time/local-env helpers.

Inputs/Outputs

  • In: Extern calls from Hakorune code compiled to LLVM (llvmlite harness / ny-llvmc).
  • Out: Simple values (i64) or newly allocated char* (caller frees with hako_mem_free).

Contracts

  • Ownership: char* returns are callee-owned; free via hako_mem_free().
  • Alignment: pointers from hako_mem_alloc/realloc satisfy max_align_t.
  • Thread-safety: memory API and read-only helpers are thread-safe.
  • Diagnostics: use short, stable messages (NOT_FOUND/UNSUPPORTED/VALIDATION) via TLS hako_last_error when applicable.
    • Missing env key: hako_env_local_get returns NULL and sets NOT_FOUND.
    • LLVM lowering emits a short warn (stderr) on missing; return handle remains 0.

Layout

  • include/ — public headers (hako_hostbridge.h mirror or thin wrapper)
  • shims/ — libc-backed reference implementation for canaries (hako_kernel.c)

Guards

  • No Rust modules or cargo manifests under lang/.
  • No parsing or codegen here; this is a plain ABI surface.

Build (example)

cc -I../../include -shared -fPIC -o libhako_kernel_shim.so shims/hako_kernel.c

Link (LLVM canary)

  • Use rpath + -L to locate libhako_kernel_shim.so at runtime.
  • Example flags: -L$ROOT/target/release -Wl,-rpath,$ROOT/target/release -lhako_kernel_shim

APIs (Phase 20.9)

  • Memory: hako_mem_alloc/realloc/free
  • GC (readonly): hako_gc_stats, hako_gc_roots_snapshot
  • Console: hako_console_log/warn/error (void sideeffect; returns 0)
  • Time: hako_time_now_ms
  • Local env: hako_env_local_get (caller frees via hako_mem_free)

Notes

  • Future control hooks (hako_gc_collect/start/stop) are defined but gated; do not silently succeed.
  • Platform CRT note: Only hako_mem_free() may be used to free memory obtained from any hako_* API to avoid CRT boundary issues (Windows msvcrt/ucrt, macOS libc).