hakorune/docs/development/roadmap/phases/phase-25.2b/README.md

# Phase 25.2b — Lambda / FunctionBox Semantics (Planning)

Status: planning-only（将来フェーズ用のメモ／実装はまだ行わない）

## ゴール

- Phase 25.1b で selfhost builder の Program→MIR パリティが整ったあとに、Hakoru­ne 言語としてのラムダ式（`fn(x, y) { ... }` / `fn(x) expr`）の意味論を Rust VM / MIR / FunctionBox まで一貫させる。
- MirBuilder / selfhost コードから暫定的に排除している `fn` ベースの helper（`norm_if` など）を、正式なクロージャ意味論の上に戻せるようにする。
- Stage1/Stage0 の責務分離を崩さずに、「lambda を使う Hako コード」が hv1 VM / AOT でも安全に実行できる状態を作る。

## 現状（Phase 25.1b 前提）

- 構文／AST:
  - `docs/reference/language/LANGUAGE_REFERENCE_2025.md` に `fn(x, y) { ... }` / `fn(x) expr` のラムダ構文が記載済み。
  - Stage‑3 パーサは `fn` キーワードを認識し、AST 上では Lambda ノードを持っている（`exprs_lambda.rs` 前提）。
- MIR:
  - `src/mir/instruction.rs` に `MirInstruction::NewClosure { dst, params, body, captures, me }` が定義済み。
  - `src/mir/builder/exprs_lambda.rs` は AST ラムダを `NewClosure` に降ろし、`captures` / `me` 情報を構築する実装がある。
- 実行（VM）:
  - hv1 VM（`src/backend/mir_interpreter`）は `NewClosure` / `Callee::Closure` をまだ実装していない（catch-all で InvalidInstruction）。
  - `FunctionBox` / `ClosureEnv` は `src/boxes/function_box.rs` に存在し、手動で FunctionBox を作るテスト経路では動いている。
- selfhost 側:
  - Phase 25.1a/b では selfhost builder から `fn` を排除し、lambda なしでも Stage1 CLI を扱える Program→MIR ルートに集中する。

## 25.2b のスコープ（案）

- Rust VM:
  - `MirInstruction::NewClosure` を実装し、`FunctionBox` + `ClosureEnv` を構築する。
  - `execute_callee_call` に `Callee::Closure` / `Callee::Value` の処理を追加し、第一級関数呼び出しをサポートする。
- Hakorune selfhost:
  - selfhost builder (`MirBuilderBox` / `MirBuilderMinBox`) の helper の一部を lambda 版に戻し、`NewClosure` 経路が実際に踏まれるようにする（最初は dev トグル付きでもよい）。
  - Stage1 コードでの lambda 利用ポリシー（どの層で許可するか）を docs に明記する。
- テスト:
  - AST→MIR→VM で λ を含むケース（単純関数、captures、`me` 利用など）をカバーする canary を追加する。

このフェーズは「selfhost builder パリティ（25.1b）」完了後に着手する前提であり、本ドキュメントは計画メモのみとする。***