hakorune/docs/development/roadmap/phases/phase-21.6-solidification/CHECKLIST.md

Phase 21.6 — Solidification Checklist

Acceptance (all must be green on this host)
- Parser(Stage‑B): loop JSON canary PASS (no empty body; cond = Compare <, lhs=Var i, rhs=Var n|Int const)
- MirBuilder(delegate): MIR(JSON) for minimal loop contains only control‑flow ops (const/phi/compare/branch/binop/jump/ret)
- VM: MIR(JSON) for minimal loop returns 10
- ny‑llvmc(crate) EXE: returns 10

Canaries to run
- bash tools/dev/stageb_loop_json_canary.sh
- bash tools/dev/phase216_chain_canary.sh
- bash tools/dev/phase216_chain_canary_return.sh
- bash tools/dev/phase216_chain_canary_binop.sh
- bash tools/dev/phase216_chain_canary_loop.sh
- bash tools/dev/phase216_chain_canary_call.sh (Phase 21.6 extension)

Guardrails
- No default behavior changes; all aids behind env toggles.
- Logs quiet; tags/dev traces are opt‑in.
- No llvmlite in default chain; crate backend is main line.

Rollback
- Parser fallback in parse_loop is conservative; remove after VM/gpos fix lands.
- Keep canaries; they protect against regressions.

## Phase 21.6 Call Support Extension

**Toggles**:
- `HAKO_STAGEB_FUNC_SCAN=1`: Enable function definition scanning in Stage-B
- `HAKO_MIR_BUILDER_FUNCS=1`: Enable function definition lowering in MirBuilder (unused - Rust delegate used)

**Implementation**:
1. Stage-B function scanner extracts `method <name>(params){ body }` definitions
2. Stage-B injects `defs` array into Program(JSON v0)
3. Rust delegate (src/runner/json_v0_bridge/) processes `defs` and generates MIR functions
4. Function names are qualified as `Box.method` (e.g., `Main.add`)

**Current Status**:
- ✅ Stage-B scanning implemented (compiler_stageb.hako)
- ✅ Rust delegate defs processing implemented (ast.rs, lowering.rs)
- ✅ MIR functions generated with correct signatures and bodies
- ⚠️  Call resolution incomplete: calls still use dynamic string lookup ("add") instead of static Main.add reference

**Next Steps for Call Completion**:
- Need to resolve Call("add") → Call(Main.add) at lowering time
- Implement call target resolution in json_v0_bridge/lowering.rs
- Update Call instruction to use function reference instead of string
- Alternative: use MirCall with Callee::Function for local calls

**撤去条件 (Removal Criteria)**:
- After Phase 22 introduces proper local function scoping with Callee typed calls
- Or when unified with broader namespace/using system Phase 15.5+