cadrumo.domain.calculations.registry.handoffs module

Declared consumption channels for cross-model relation-prefill handoffs.

A handoff is a coordinate in the registry: the source and target ModeloRevision a value crosses between, resolved against the RegistrySnapshot the authority compiled. This module names the closed set of channels through which a folded value reaches the casilla that consumes it, so “which model feeds which, and how” is a declared fact rather than one re-derived per caller.

class RelationConsumptionChannelKind(*values)[source]

Bases: StrEnum

How a relation-prefill binding’s value reaches the target that consumes it.

PRIMARY_BINDING
ALTERNATE_BINDING
FORMULA_BINDING
RelationConsumptionChannel

Canonical closed channels through which a folded value feeds a casilla.

alias of Literal[PRIMARY_BINDING, ALTERNATE_BINDING, FORMULA_BINDING]

relation_consumption_index(revision)[source]

Return the binding channels that consume relation-prefill values.

Core types: ModeloRevision.

Return type:

_RelationConsumptionIndex

Parameters:

revision (ModeloRevision)

relation_consumption_channels(binding_id, index)[source]

Return every declared channel that consumes binding_id in stable order.

An empty result means the binding is declared but nothing reads it, which is the orphan condition consumers report rather than tolerate.

Return type:

tuple[Literal[<RelationConsumptionChannelKind.PRIMARY_BINDING: 'primary_binding'>, <RelationConsumptionChannelKind.ALTERNATE_BINDING: 'alternate_binding'>, <RelationConsumptionChannelKind.FORMULA_BINDING: 'formula_binding'>], ...]

Parameters:
  • binding_id (BindingId)

  • index (_RelationConsumptionIndex)