Struct CallFrame 

pub struct CallFrame {
    pub return_ip: usize,
    pub base_pointer: usize,
    pub locals_count: usize,
    pub function_id: Option<u16>,
    pub upvalues: Option<Vec<u64>>,
    pub blob_hash: Option<FunctionHash>,
    pub closure_heap_bits: Option<u64>,
    pub closure_heap_kind: Option<NativeKind>,
}

Call frame for function calls

Fields

return_ip: usize

Return address

base_pointer: usize

Base pointer into the unified value stack where this frame’s locals start

locals_count: usize

Number of locals

function_id: Option<u16>

Function index

upvalues: Option<Vec<u64>>

Upvalues captured by this closure (None for regular functions).

SURFACE (phase-2c): the legacy shape_value::Upvalue carrier was deleted during the strict-typing bulldozer (the v1 ValueWord-tagged closure-capture word). The replacement is the v2 typed closure surface (shape_value::v2::closure_raw::OwnedClosureBlock / ClosureLayout), but the wiring through CallFrame is part of the §2.7.8 / Q10 cell-storage extension scheduled for B6-variables-loadptr / B7-closure-cells. Until then this field is a Vec<u64> of raw-bit captures, matching the existing layout in closure_raw::ClosureCell. Consumers in executor/variables/mod.rs, executor/gc_integration.rs, executor/state_builtins/introspection.rs, and crates/shape-vm/ src/remote.rs are pre-existing Wave-α-broken and migrate together with this surface — see ADR-006 §2.7.4 deferral pattern.

blob_hash: Option<FunctionHash>

Content hash of the function blob being executed (for content-addressed state capture). None for programs compiled without content-addressed metadata.

closure_heap_bits: Option<u64>

WB2.3 retain-on-read: optional owning ValueWord bits for the closure HeapValue that backs this frame’s upvalues. When the frame is a closure call, CaptureKind::OwnedMutable / Shared captures in upvalues are raw *mut ValueWord / *const SharedCell pointer bits into this block’s allocation — the frame must hold this share so the block outlives the callee’s pointer dereferences.

None for regular function calls and host-closure calls. Released via drop_with_kind(bits, kind) on frame-pop (see op_return / op_return_value cleanup) using the lockstep closure_heap_kind companion below.

closure_heap_kind: Option<NativeKind>

ADR-006 §2.7.8 / Q10 — lockstep NativeKind companion for closure_heap_bits. Both fields are Some together or None together at every observable boundary; mixed states are a bug. When closure_heap_bits = Some(bits), this carries the NativeKind that the teardown path (op_return / op_return_value) feeds into drop_with_kind(bits, kind) — replacing the forbidden vw_drop(bits) (§2.7.7 #8) and the forbidden Bool-default fallback (§2.7.7 #9). For closure calls the kind is NativeKind::Ptr(HeapKind::Closure) (the closure_heap_bits always come from a TAG_HEAP ValueWord pointing to a HeapValue::ClosureRaw).

Trait Implementations

impl Debug for CallFrame

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.