UOR Resolvers

IRI
https://uor.foundation/resolver/
Prefix
resolver:
Space
bridge
Comment
Type resolution strategies implementing the partition map Π : T_n → Part(R_n). Resolvers transform type declarations into ring partitions.

This is a bridge-space namespace in the Resolve stage of the PRISM pipeline. It provides the resolution infrastructure — queries, partitions, observables, proofs, derivations, and traces that transform inputs into certified results.

Learn more: Pipeline Overview · Resolution & Queries

Class hierarchy
Class hierarchy for UOR Resolvers namespace Resolver DihedralFactor CanonicalFormR EvaluationReso ResolutionStat RefinementSugg ComplexityClas CechNerve CompletenessRe WittLevelResol SessionResolve TypeSynthesisR ConstraintSear IncrementalCom LiftRefinement MonodromyResol JacobianGuided SuperpositionR GroundingAware GeodesicValida MeasurementRes TowerCompleten ExecutionPolic ExecutionPolic HomotopyResolv ModuliResolver

Imports

Classes

NameSubclass OfDisjoint WithComment
ResolverThingResolutionState, RefinementSuggestionA strategy for resolving a type declaration into a partition of the ring. The kernel dispatches to a specific resolver based on the type's structure.
DihedralFactorizationResolverResolverResolves types by factoring the ring under dihedral group action. Identifies orbits under D_{2^n} to determine irreducibility boundaries.
CanonicalFormResolverResolverResolves types by computing canonical forms via term rewriting. Applies the critical identity and normalization rules to reduce terms to unique canonical representatives.
EvaluationResolverResolverResolves types by direct evaluation: applies operations to enumerate ring elements and classify them as irreducible, reducible, unit, or exterior.
ResolutionStateThingResolver, RefinementSuggestionThe current state of an iterative resolution: tracks how many iterations have been performed, whether the resolution is complete, and the current site deficit.
RefinementSuggestionThingResolver, ResolutionStateA suggestion from the resolver for how to refine an incomplete resolution: which metric axis to explore, which class to narrow to, and which sites to target.
ComplexityClassThingA computational complexity classification for resolvers. Each resolver's asymptotic runtime is typed as a named ComplexityClass individual rather than a free string.
CechNerveThing, SimplicialComplex, KanComplexThe simplicial complex whose vertices are constraints and where a k-simplex exists iff the corresponding k+1 constraints have nonempty intersection. The nerve's topology governs resolution convergence: trivial homology ↔ smooth convergence, non-trivial homology ↔ potential stalls.
CompletenessResolverResolverA specialisation of Resolver driving the completeness certification loop. Accepts a CompletenessCandidate, runs the ψ-pipeline (reading nerveEulerCharacteristic from ResolutionState), and either issues a CompletenessCertificate or produces a RefinementSuggestion.
WittLevelResolverResolverA Resolver parameterised by quantum level. The same resolver strategy runs at any quantum level n ≥ 1 by substituting the appropriate R_n ring.
SessionResolverResolverA Resolver that maintains a BindingAccumulator across multiple RelationQuery evaluations. The top-level resolver for multi-turn Prism deployments.
TypeSynthesisResolverResolverA Resolver that runs the ψ-pipeline in inverse mode. Accepts a TypeSynthesisGoal and returns a TypeSynthesisResult. Internally maintains a ConstraintSearchState tracking which constraint combinations have been explored and which Betti profiles they realise.
ConstraintSearchStateThingInternal resolver state tracking the boundary of explored constraint combinations during synthesis. Carries exploredCount, currentCandidate, and a link to the best SynthesisSignature achieved so far.
IncrementalCompletenessResolverResolverA Resolver that determines whether a CompleteType T at Q_n lifts to a CompleteType at Q_{n+1} without re-running the full ψ-pipeline from scratch. It computes the SpectralSequencePage sequence, reads the LiftObstruction, and either confirms the lift or returns a LiftRefinementSuggestion.
LiftRefinementSuggestionRefinementSuggestionA RefinementSuggestion produced when a WittLift has a non-trivial LiftObstruction. Specialises RefinementSuggestion with liftSitePosition (the new bit position n+1) and obstructionClass.
MonodromyResolverResolverA Resolver that computes the HolonomyGroup of a ConstrainedType by enumerating closed paths in the constraint nerve and accumulating DihedralElement values. Outputs a MonodromyClass and classifies the type as FlatType or TwistedType.
JacobianGuidedResolverResolverA resolver that uses the Jacobian matrix to guide constraint selection, implementing DC_10: select the constraint that maximises total curvature reduction.
SuperpositionResolverResolverA resolver that handles superposed site states, computing amplitudes and determining when superposition collapses to a classical site assignment (Amendment 32).
GroundingAwareResolverResolverA resolver that exploits accumulated session bindings at full saturation (σ = 1) to provide O(1) resolution via direct coordinate reads (SC_5).
GeodesicValidatorResolverA resolver that validates whether a ComputationTrace satisfies the dual geodesic condition (AR_1-ordered and DC_10-selected). Produces GeodesicViolation individuals on failure.
MeasurementResolverResolverA resolver that handles projective collapse of SuperposedSiteState components. Issues MeasurementCertificate upon successful collapse with QM_1 verification.
TowerCompletenessResolverResolverA Resolver that constructs a LiftChain from liftSourceLevel to an arbitrary liftTargetLevel Q_k by iterating IncrementalCompletenessResolver step by step.
ExecutionPolicyThingResolver, ResolutionState, RefinementSuggestionA strategy class that defines how a SessionResolver orders pending RelationQuery instances for dispatch. The policy reads the targetSite.freeRank of each pending query and applies an ordering function.
ExecutionPolicyKindThingA typed controlled vocabulary for ExecutionPolicy individuals. Follows the SessionBoundaryType pattern: a single class with named individuals rather than a subclass hierarchy.
HomotopyResolverResolverA resolver that runs the extended ψ-pipeline (ψ_7–ψ_9) to compute the full homotopy type of a CechNerve. Returns HomotopyGroup observables and PostnikovTruncation records.
ModuliResolverResolverA resolver that computes the local structure of the moduli space at a given CompleteType: constructs the DeformationComplex, determines the HolonomyStratum, and computes tangent/obstruction dimensions.

Properties

NameKindFunctionalDomainRangeComment
inputTypeObjecttrueResolverTypeDefinitionThe type of input this resolver accepts.
outputTypeObjecttrueResolverPartitionThe type of output this resolver produces. For all UOR resolvers, the output is a partition:Partition.
strategyObjecttrueResolverTermExpressionA human-readable description of the resolution strategy this resolver implements.
resolutionStateObjecttrueResolverResolutionStateThe current resolution state of this resolver.
isCompleteDatatypetrueResolutionStatebooleanWhether this resolution is complete: all sites are pinned and the partition is fully determined.
iterationCountDatatypetrueResolutionStatenonNegativeIntegerThe number of refinement iterations performed so far.
siteDeficitObjecttrueResolutionStateFreeRankThe site budget showing the remaining unpinned sites. When all sites are pinned, the deficit is zero and resolution is complete.
suggestionObjectfalseResolutionStateRefinementSuggestionA refinement suggestion for advancing this resolution.
suggestedAxisObjecttrueRefinementSuggestionMetricAxisThe metric axis this suggestion recommends exploring.
suggestedClassObjecttrueRefinementSuggestionClassThe constraint class this suggestion recommends applying.
targetSitesObjectfalseRefinementSuggestionSiteIndexThe site coordinates this suggestion targets for pinning.
convergenceRateDatatypetrueResolutionStatedecimalThe rate at which sites are being pinned per iteration. A higher rate indicates faster convergence toward a complete resolution.
hasComplexityClassObjecttrueResolverComplexityClassThe computational complexity class of this resolver. Replaces the string-valued resolver:complexity property.
cechNerveObjecttrueResolutionStateCechNerveThe constraint nerve associated with this resolution state.
residualEntropyDatatypetrueResolutionStatedecimalThe residual Shannon entropy of the resolution state: S = freeRank × ln 2. Measures remaining uncertainty.
topologicallyCompleteDatatypetrueResolutionStatebooleanWhether all Betti numbers of the constraint nerve are zero, indicating no topological obstructions to resolution.
nerveEulerCharacteristicDatatypetrueResolutionStateintegerThe Euler characteristic χ(N(C)) of the active constraint nerve at this resolution state. IT_7d requires this value to equal n (the quantum level) for resolution to be complete. Cached here to avoid recomputing the full ψ pipeline on each iteration check.
completenessTargetObjecttrueCompletenessResolverCompletenessCandidateThe CompletenessCandidate this resolver is certifying.
quantumLevelObjecttrueWittLevelResolverWittLevelThe quantum level this resolver instance is configured for.
sessionAccumulatorObjecttrueSessionResolverBindingAccumulatorThe BindingAccumulator this session resolver maintains across multiple RelationQuery evaluations.
synthesisGoalObjecttrueTypeSynthesisResolverTypeSynthesisGoalThe goal this type synthesis resolver is working to achieve.
exploredCountDatatypetrueConstraintSearchStatenonNegativeIntegerNumber of constraint combinations evaluated so far during synthesis.
currentCandidateObjecttrueConstraintSearchStateConstrainedTypeThe type candidate currently being evaluated during synthesis.
liftTargetObjecttrueIncrementalCompletenessResolverWittLiftThe WittLift this incremental completeness resolver is evaluating.
liftSitePositionObjecttrueLiftRefinementSuggestionSiteIndexThe new site position at Q_{n+1} that the lift refinement suggestion targets.
obstructionClassObjecttrueLiftRefinementSuggestionLiftObstructionClassThe obstruction class this lift refinement suggestion is designed to kill.
monodromyTargetObjecttrueMonodromyResolverConstrainedTypeThe type whose holonomy this monodromy resolver is computing.
holonomyResultObjecttrueMonodromyResolverHolonomyGroupThe HolonomyGroup produced by this monodromy resolver run.
guidingJacobianObjecttrueResolutionStateJacobianThe Jacobian observable guiding constraint selection at this resolution state (DC_10).
usedGroundingDatatypetrueGroundingAwareResolverbooleanWhether this resolver used the saturation shortcut (SC_5) to bypass the ψ-pipeline and return a direct coordinate read.
validateGeodesicObjecttrueGeodesicValidatorGeodesicTraceThe GeodesicTrace being validated by this GeodesicValidator.
collapseAmplitudeDatatypetrueMeasurementResolverdecimalThe amplitude of the SuperposedSiteState prior to projective collapse by this MeasurementResolver.
collapsedSiteDatatypetrueMeasurementResolvernonNegativeIntegerThe site index that was collapsed (pinned to a classical value) by the projective measurement.
measurementOutcomeDatatypetrueMeasurementResolvernonNegativeIntegerThe classical value obtained from the projective collapse. Either 0 or 1 for a single-site measurement.
amplitudeVectorDatatypetrueSuperpositionResolverdecimalThe amplitude vector of all branches maintained by this SuperpositionResolver during ψ-pipeline traversal. Encoded as a comma-separated list of decimal amplitudes. Must satisfy Σ|αᵢ|² = 1 (QM_5) after normalization.
priorAmplitudeVectorDatatypetrueMeasurementResolverdecimalThe full vector of all branch amplitudes before projective collapse. Recorded by the MeasurementResolver to enable Born rule verification (QM_5): P(outcome k) = |α_k|².
towerSourceLevelObjecttrueTowerCompletenessResolverWittLevelThe level at which the tower starts.
towerTargetLevelObjecttrueTowerCompletenessResolverWittLevelThe level to which the tower is being built.
currentChainObjecttrueTowerCompletenessResolverLiftChainThe LiftChain under construction.
towerStepResolverObjecttrueTowerCompletenessResolverIncrementalCompletenessResolverThe IncrementalCompletenessResolver used for each single-step lift.
executionPolicyObjecttrueSessionResolverExecutionPolicyThe ordering strategy this resolver applies to pending queries. Defaults to FifoPolicy if unset.
homotopyTargetObjecttrueHomotopyResolverCechNerveThe CechNerve whose homotopy type this resolver computes.
homotopyResultObjectfalseHomotopyResolverHomotopyGroupA HomotopyGroup observable produced by this resolver.
moduliTargetObjecttrueModuliResolverCompleteTypeThe CompleteType whose local moduli structure this resolver computes.
moduliDeformationObjecttrueModuliResolverDeformationComplexThe DeformationComplex constructed by this resolver.
dispatchTableObjecttrueResolverDispatchTableThe dispatch table governing resolver selection for this resolver class.
resolverPredicateObjecttrueResolverTypePredicateThe predicate that selects this specific resolver. When the predicate evaluates to true on an input type, this resolver is chosen.

Named Individuals

NameTypeComment
ConstantTimeComplexityClassO(1) complexity — the resolver runs in constant time regardless of ring size.
LogarithmicTimeComplexityClassO(log n) complexity — the resolver runs in logarithmic time in the quantum level.
LinearTimeComplexityClassO(n) complexity — the resolver runs in time linear in the quantum level.
ExponentialTimeComplexityClassO(2^n) complexity — the resolver runs in time exponential in the quantum level.
FifoPolicyExecutionPolicyKindProcess queries in arrival order. The implicit pre-Amendment 48 behavior.
MinFreeCountFirstExecutionPolicyKindProcess the query with the smallest targetSite.freeRank first. Favors cheapest resolutions, accelerating early grounding gain.
MaxFreeCountFirstExecutionPolicyKindProcess the query with the largest targetSite.freeRank first. Favors hardest resolutions, maximizing information gain per step.
DisjointFirstExecutionPolicyKindProcess queries whose targetSite is disjoint from all other pending queries' site sets first. Minimizes contention when operating against a SharedContext.