Files
hakorune/src/mir/builder/rewrite
tomoaki f740e6542f feat(phase285): Complete weak reference implementation (VM + LLVM harness)
Phase 285LLVM-1.1 to 1.4 + weak reference infrastructure:

**LLVM Harness** (Phase 285LLVM-1.x):
- 285LLVM-1.1: User Box registration & debug output
- 285LLVM-1.2: WeakRef basic operations (identity deferred)
- 285LLVM-1.3: InstanceBox field access (getField/setField)
- 285LLVM-1.4: print Handle resolution (type tag propagation)

**VM Runtime** (nyash_kernel):
- FFI functions: nyrt_weak_new, nyrt_weak_to_strong, nyrt_weak_drop
  (crates/nyash_kernel/src/lib.rs: +209 lines)
- WeakRef plugin invoke support
  (crates/nyash_kernel/src/plugin/invoke.rs: +250 lines)
- weak_handles.rs: WeakRef handle registry (NEW)

**LLVM Python Backend**:
- WeakRef instruction lowering (weak.py: NEW)
- Entry point integration (entry.py: +93 lines)
- Instruction lowering (instruction_lower.py: +13 lines)
- LLVM harness runner script (tools/run_llvm_harness.sh: NEW)

**MIR & Runtime**:
- WeakRef emission & validation
- MIR JSON export for weak instructions
- Environment variable support (NYASH_WEAK_*, HAKO_WEAK_*)

**Documentation**:
- CLAUDE.md: Phase 285 completion notes
- LANGUAGE_REFERENCE_2025.md: Weak reference syntax
- 10-Now.md & 30-Backlog.md: Phase 285 status updates

Total: +864 lines, 24 files changed

SSOT: docs/reference/language/lifecycle.md
Related: Phase 285W-Syntax-0, Phase 285W-Syntax-0.1
2025-12-25 00:11:34 +09:00
..

rewrite — Known 経路の関数化 特殊規則P1

目的

  • Known 受け手のメソッド呼び出し obj.m(a) を関数呼び出し Class.m(me,obj,a) に正規化し、実行系を単純化する。
  • 表示系の特殊規則(toString / stringify → 規範 str)を一箇所に集約する(互換維持)。
  • 仕様は不変。Union は観測のみで、Known のみ関数化対象。

責務

  • known.rs: Known 経路の instance→function 正規化(ユーザー Box のみ、既存ガード尊重)。
  • special.rs: toString/stringifystr の早期処理Class.str/0 を優先、互換で stringify/0
    • equals/1 もここに集約Known 優先 → 一意候補のみ許容)。
  • 観測は observe 層に委譲resolve.choose など)。

非責務(禁止)

  • Union の強引な関数化Unknown/曖昧なものは扱わない)。
  • 起源付与/型推論の実施origin 層に限定)。
  • NYABI 呼び出しや VM 直接呼び出し。

API呼び出し側から

  • try_known_rewrite(builder, recv, class, method, args) -> Option<Result<ValueId,String>>
  • try_unique_suffix_rewrite(builder, recv, method, args) -> Option<Result<ValueId,String>>
  • try_known_or_unique(builder, recv, class_opt, method, args) -> Option<Result<ValueId,String>>
  • try_early_str_like(builder, recv, class_opt, method, arity) -> Option<Result<ValueId,String>>
  • try_special_equals(builder, recv, class_opt, method, args) -> Option<Result<ValueId,String>>

レイヤールール

  • Allowed: Builder のメタ参照/関数名生成、MirInstruction の生成(関数化結果)。
  • Forbidden: origin/observe のロジックを混在させない(必要時は呼び出しで連携)。

決定原則

  • Known のみ関数化(value_origin_newbox が根拠)。
  • 表示系は規範 str を優先、stringify は当面互換として許容。
  • すべての決定は dev 観測resolve.try/chooseで可視化し、挙動は不変。