UOR State

IRI
https://uor.foundation/state/
Prefix
state:
Space
user
Comment
Parameterized address spaces, context management, binding lifecycle, and state transitions. The user-space overlay onto the kernel's read-only ring substrate.

This is a user-space namespace in the Apply stage of the PRISM pipeline. It provides the application layer — types, morphisms, and state that parameterize the resolution pipeline.

Learn more: Pipeline Overview · Site Bundle Semantics

Class hierarchy
Class hierarchy for UOR State namespace Context Binding Frame Transition SessionBoundar Session BindingAccumul SessionBoundar GroundedContex GroundingWitne DomainGroundin GroundingPhase SharedContext ContextLease SessionComposi

Imports

Classes

NameSubclass OfDisjoint WithComment
ContextThingBinding, Frame, TransitionA bounded set of populated UOR addresses. The parameter space for a resolution cycle. Contexts hold bindings that map addresses to datum values.
BindingThingContext, Frame, TransitionThe association of a datum value with an address in a context. The write primitive: creating a binding populates an address.
FrameThingContext, Binding, TransitionThe visibility boundary determining which bindings are in scope for a given resolution. A frame is a view into a context: it selects which bindings the resolver sees.
TransitionThingContext, Binding, FrameA state change: the transformation of one context into another through binding or unbinding. The sequence of transitions is the application's computation history.
SessionBoundaryTypeThingA typed controlled vocabulary for session boundary reasons. Each individual names a specific reason a context-reset boundary was triggered during a multi-turn session.
SessionThingA bounded sequence of RelationQuery/response pairs sharing a common state:Context. Sessions are the unit of coherent multi-turn reasoning in Prism.
BindingAccumulatorThingThe mutable accumulator that appends state:Binding instances to a state:Context as each RelationQuery resolves. Tracks monotonic reduction of aggregate free site space.
SessionBoundaryThingMarks a context-reset event within a session stream. Records why the context was reset and provides a clean state:Context for subsequent queries.
GroundedContextContextA context that has reached full saturation: σ = 1, freeRank = 0, S = 0, T_ctx = 0 (SC_4). The ground state of the type system. All subsequent queries resolve in O(1) via SC_5.
GroundingWitnessThingStep-by-step evidence of the saturation process: records which bindings were applied, in what order, to reach full saturation.
DomainGroundingRecordThingAn informational/monitoring record tracking the saturation progress of a specific domain within a context. Carries no formal authority — purely observational.
GroundingPhaseThingA typed controlled vocabulary for the three phases of context saturation: Open (σ = 0), PartialGrounding (0 < σ < 1), and FullGrounding (σ = 1).
SharedContextContextA Context visible to more than one Session simultaneously. Holds a set of ContextLease instances that partition its site coordinates among active sessions. Lease disjointness (SR_9) prevents concurrent write conflicts.
ContextLeaseThingContext, Binding, Frame, TransitionA bounded, exclusive claim on a set of site coordinates within a SharedContext, held by exactly one Session. When the session closes or hits a SessionBoundary, the lease is released and its sites become available for re-leasing.
SessionCompositionThingRecords that a Session was formed by merging the binding sets of two or more predecessor sessions. Valid only if all predecessor binding sets pass the cross-session consistency check (SR_8). An invalid composition attempt produces a ContradictionBoundary on the target session.

Properties

NameKindFunctionalDomainRangeComment
addressObjecttrueBindingElementThe UOR address being bound in this binding.
contentObjecttrueBindingDatumThe datum value bound to the address in this binding.
boundTypeObjectfalseBindingTypeDefinitionThe type under which this binding's datum is resolved.
timestampDatatypetrueBindingdateTimeThe time at which this binding was created.
bindingObjectfalseContextBindingA binding held in this context.
capacityDatatypetrueContextpositiveIntegerThe maximum number of bindings this context can hold.
contentAddressDatatypetrueContextstringThe content-derived address of this context, uniquely identifying its current state in the UOR address space.
wittLengthDatatypetrueContextpositiveIntegerThe Witt level of this context's address space.
activeBindingsObjectfalseFrameBindingThe bindings currently in scope for this frame.
contextObjecttrueFrameContextThe context this frame is a view of.
constraintObjecttrueFrameConstraintThe type:Constraint determining which bindings from the context are visible in this frame. The resolver applies this constraint to filter the context's binding set, producing the frame's active bindings. An absent constraint means all bindings are visible.
fromObjecttrueTransitionContextThe context before this transition.
toObjecttrueTransitionContextThe context after this transition.
addedBindingsObjectfalseTransitionBindingBindings added to the context in this transition.
removedBindingsObjectfalseTransitionBindingBindings removed from the context in this transition.
traceObjecttrueTransitionComputationTraceThe computation trace recording the kernel operations that effected this state transition.
topologicalSnapshotObjecttrueTransitionTopologicalDeltaA snapshot of topological invariants at this transition point.
sessionBindingsObjecttrueSessionContextThe shared context holding all bindings accumulated across the queries in this session.
sessionQueriesDatatypetrueSessionnonNegativeIntegerThe number of RelationQuery evaluations completed in this session.
aggregateSiteDeficitObjecttrueBindingAccumulatorFreeRankThe aggregate FreeRank deficit across all accumulated bindings: the total remaining free sites that have not yet been closed by resolution. Decreases monotonically as the session progresses.
accumulatedBindingsObjectfalseBindingAccumulatorBindingA binding accumulated by this accumulator from a resolved RelationQuery.
boundaryReasonDatatypetrueSessionBoundarystringA human-readable description of why this session boundary was triggered.
boundaryTypeObjecttrueSessionBoundarySessionBoundaryTypeThe typed reason category for this session boundary.
priorContextObjecttrueSessionBoundaryContextThe state:Context that was active before this boundary reset.
freshContextObjecttrueSessionBoundaryContextThe clean state:Context produced after this boundary reset, ready for subsequent queries.
groundingDegreeDatatypetrueContextdecimalThe saturation degree σ ∈ \[0, 1\] of this context. Defined by SC_2: σ = (n − freeRank) / n.
contextTemperatureDatatypetrueContextdecimalThe context temperature T_ctx ∈ \[0, ln 2\]. Defined by SC_1: T_ctx = freeRank × ln 2 / n. At σ = 1, T_ctx = 0.
isGroundedDatatypetrueContextbooleanWhether this context has reached full saturation (σ = 1). Equivalent to freeRank = 0, S = 0, T_ctx = 0 per SC_4.
groundingPhaseObjecttrueContextGroundingPhaseThe current saturation phase of this context: Open, PartialGrounding, or FullGrounding.
groundingCertificateObjecttrueGroundedContextGroundingCertificateThe GroundingCertificate attesting that this context has reached full saturation.
witnessBindingObjectfalseGroundingWitnessBindingA binding that contributed to the saturation process, recorded in this GroundingWitness.
witnessStepDatatypetrueGroundingWitnessnonNegativeIntegerThe step index at which a particular binding was applied during the saturation process.
residualFreeCountDatatypetrueContextnonNegativeIntegerThe number of free (unbound) sites remaining in this context. At saturation, residualFreeCount = 0.
groundedContextObjecttrueDomainGroundingRecordGroundedContextThe GroundedContext that this DomainGroundingRecord monitors.
groundedDomainObjecttrueDomainGroundingRecordTypeDefinitionThe domain within the context being tracked by this DomainGroundingRecord.
domainFreeCountDatatypetrueDomainGroundingRecordnonNegativeIntegerThe number of free sites remaining in the specific domain tracked by this DomainGroundingRecord.
leasedSitesObjecttrueContextLeaseFreeRankThe subset of sites claimed by this lease. Must be disjoint from all other active leases on the same SharedContext (SR_9).
leaseHolderObjecttrueContextLeaseSessionThe Session that holds this lease.
leaseSetObjectfalseSharedContextContextLeaseA currently active ContextLease on this SharedContext.
composedFromObjectfalseSessionCompositionSessionA predecessor session contributing bindings to this composition. Non-functional: one composition may merge two or more sessions.
compositionCompatibleDatatypetrueSessionCompositionbooleanWhether all predecessor binding sets passed the SR_8 consistency check. If false, the composition is invalid and must not be used as a session context.
compositionResultObjecttrueSessionCompositionContextThe merged Context produced by a valid composition. Only present when compositionCompatible = true.
towerConsistencyVerifiedDatatypetrueSessionCompositionbooleanWhether the LiftChain tower consistency check (SR_8 parametric extension) was performed across all Q_0 through Q_k levels. Required for compositions involving sessions at Q_1 or higher.

Named Individuals

NameTypeComment
ExplicitResetSessionBoundaryTypeThe caller explicitly requested a context reset. All accumulated bindings are discarded.
ConvergenceBoundarySessionBoundaryTypeThe session resolver determined that no further queries can reduce the aggregate site deficit.
ContradictionBoundarySessionBoundaryTypeA new query produced a type contradiction with an accumulated binding. Context must reset before resolution can continue.
OpenGroundingPhaseThe context has σ = 0: no bindings accumulated, all sites are free. The initial phase of every session.
PartialGroundingGroundingPhaseThe context has 0 < σ < 1: some sites are pinned by accumulated bindings, but free sites remain. The accumulation phase.
FullGroundingGroundingPhaseThe context has σ = 1: all sites are pinned, freeRank = 0. The ground state. All subsequent queries resolve in O(1) via SC_5.
ground_stateGroundedContextThe canonical ground-state witness: a GroundedContext at σ = 1, freeRank = 0, T_ctx = 0, S = 0 (SC_4). Demonstrates that full saturation is achievable and O(1) resolution (SC_5) is realized.
  • groundingDegree: 1.0
  • contextTemperature: 0.0
  • isGrounded: true
  • residualFreeCount: 0
  • groundingPhase: FullGrounding