Struct ScopeFixture 

pub struct ScopeFixture { /* private fields */ }

Init-time accumulator for consumer-declared pulls.

Holds an Arc<PolydatProgram> clone of the per-template canonical kernel’s program (SRD 16 §“Per-Scope Canonical Kernel Cache”). The program carries every fact this fixture needs at registration time — the output map, input definitions, and auto-extern-provisioned externs — so no per-fiber state is touched until the sealed PullPlan is resolved at cycle time. Each consumer registers names via register_pull; the fixture deduplicates by name and yields a stable PullHandle for each unique registration.

Implementations

impl ScopeFixture

pub fn new(program: Arc<PolydatProgram>) -> Self

Open a new fixture against a per-template canonical program. The Arc clone is cheap; the activity construction loop typically already holds the program for adapter dispatch and bind-plan synthesis.

pub fn program(&self) -> &Arc<PolydatProgram>

The program this fixture is scoped against. Useful for consumers that need to inspect the manifest (e.g. type- aware strict parsing).

pub fn register_pull(&mut self, name: &str) -> Result<PullHandle, String>

Register a name. Resolves it against the program’s output map (folded constants) first, then against find_input (extern slots, capture inputs, coordinates).

Returns a memoized handle. Re-registering the same name returns the existing handle — registrations are idempotent.

Errors when the program does not know the name. The Polydat compiler is responsible for provisioning every name referenced anywhere in the op template (op fields and params; SRD 16 §“Auto-Extern Generation”). An unknown name here therefore signals a workload bug — typically a reference to a binding that was never declared, or a typo that the compiler should have already caught.

pub fn seal(self) -> PullPlan

Seal and yield the immutable plan. The plan owns its own Arc<PolydatProgram> clone, so cycle-time resolve only needs the per-fiber state.