UOR Conformance Shapes

IRI
https://uor.foundation/conformance/
Prefix
conformance:
Space
bridge
Comment
SHACL-equivalent constraint shapes defining what a Prism implementation must provide at each extension point. Machine-verifiable contracts.

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

Class hierarchy
Class hierarchy for UOR Conformance Shapes namespace Shape PropertyConstr WittLevelShape EffectShape ParallelShape StreamShape DispatchShape LeaseShape GroundingShape ValidationResu PredicateShape WitnessDatum GroundedCoordi GroundedTuple GroundedValueM ValidatedWrapp WitnessDerivat WitnessSiteBud ShapeViolation ViolationKind CompileUnitBui EffectDeclarat GroundingDecla DispatchDeclar LeaseDeclarati StreamDeclarat PredicateDecla ParallelDeclar WittLevelDecla MintingSession

Imports

Classes

NameSubclass OfDisjoint WithComment
ShapeThingA constraint shape that a Prism-declared extension must satisfy. Analogous to sh:NodeShape in SHACL.
PropertyConstraintThingA single required property within a shape: the property URI, its expected range, minimum and maximum cardinality.
WittLevelShapeShapeShape for declaring a new WittLevel beyond Q3.
EffectShapeShapeShape for declaring an ExternalEffect.
ParallelShapeShapeShape for declaring a ParallelProduct.
StreamShapeShapeShape for declaring a ProductiveStream (targets stream:Unfold, the coinductive constructor).
DispatchShapeShapeShape for declaring a new DispatchRule in a DispatchTable.
LeaseShapeShapeShape for declaring a Lease with LinearSite allocation.
GroundingShapeShapeShape for declaring a GroundingMap from surface data to the ring.
ValidationResultThingThe result of validating an extension against a shape: conforms (boolean), and violation details if non-conformant.
PredicateShapeShapeShape for user-declared predicates. Requires a bounded evaluator (termination witness) and input type declaration.
WitnessDatumThingOpaque ring element witness. Cannot be constructed outside the foundation crate — only produced by reduction evaluation or the two-phase minting boundary.
GroundedCoordinateThingBoundary crossing intermediate for a single grounded coordinate value. Not a WitnessDatum — must be validated and minted by the foundation.
GroundedTupleThingBoundary crossing intermediate for a fixed-size array of GroundedCoordinate values. Stack-resident, no heap allocation.
GroundedValueMarkerThingSealed marker trait class. Implemented only for GroundedCoordinate and GroundedTuple. Prevents downstream crates from substituting arbitrary types.
ValidatedWrapperThingGeneric validation-proof wrapper. Proves that the inner value was produced by the conformance checker, not fabricated by Prism code.
WitnessDerivationThingOpaque derivation trace that can only be extended by the rewrite engine. Records rewrite step count and root term content address.
WitnessSiteBudgetThingOpaque site budget that can only be decremented by PinningEffect and incremented by UnbindingEffect — never by direct mutation.
ShapeViolationReportThingStructured violation diagnostic carrying the shape IRI, constraint IRI, property IRI, expected range, cardinality bounds, and violation kind.
ViolationKindThingThe kind of shape violation: Missing, TypeMismatch, CardinalityViolation, ValueCheck, or LevelMismatch.
CompileUnitBuilderThingBuilder for CompileUnit admission. Collects rootTerm, quantumLevelCeiling, thermodynamicBudget, and targetDomains. Validates against CompileUnitShape.
EffectDeclarationThingBuilder for EffectShape. Collects effect name, target sites, budget delta, and commutation flag.
GroundingDeclarationThingBuilder for GroundingShape. Collects source type, ring mapping, and invertibility contract.
DispatchDeclarationThingBuilder for DispatchShape. Collects predicate, target resolver, and dispatch priority.
LeaseDeclarationThingBuilder for LeaseShape. Collects linear site and lease scope.
StreamDeclarationThingBuilder for StreamShape. Collects unfold seed, step term, and productivity witness.
PredicateDeclarationThingBuilder for PredicateShape. Collects input type, evaluator term, and termination witness.
ParallelDeclarationThingBuilder for ParallelShape. Collects site partition and disjointness witness.
WittLevelDeclarationThingBuilder for WittLevelShape. Collects declared bit width, cycle size, and predecessor level.
MintingSessionThingBoundary session state tracker. Records crossing count and idempotency flag for the two-phase minting boundary.

Properties

NameKindFunctionalDomainRangeComment
targetClassObjecttrueShapeClassThe OWL class that instances of this shape must belong to.
requiredPropertyObjectfalseShapePropertyConstraintA required property in this shape.
constraintPropertyObjecttruePropertyConstraintThingThe property URI that must be present.
constraintRangeObjecttruePropertyConstraintClassThe expected range of the required property.
validationShapeObjecttrueValidationResultShapeThe shape that was validated against.
validationTargetObjecttrueValidationResultThingThe instance that was validated.
minCountDatatypetruePropertyConstraintnonNegativeIntegerMinimum cardinality of the required property.
maxCountDatatypetruePropertyConstraintnonNegativeIntegerMaximum cardinality (0 = unbounded).
conformsDatatypetrueValidationResultbooleanTrue iff the target satisfies all constraints of the shape.
witnessLevelDatatypetrueWitnessDatumnonNegativeIntegerThe quantum level at which this witness datum was minted.
witnessBytesDatatypetrueWitnessDatumhexBinaryThe raw byte representation of this witness datum.
coordinateLevelObjecttrueGroundedCoordinateWittLevelThe quantum level tag of this grounded coordinate.
validatedInnerObjecttrueValidatedWrapperThingThe validated inner value wrapped by this proof.
shapeIriDatatypetrueShapeViolationReportstringIRI of the conformance:Shape that was validated against.
constraintIriDatatypetrueShapeViolationReportstringIRI of the specific PropertyConstraint that failed.
propertyIriDatatypetrueShapeViolationReportstringIRI of the property that was missing or invalid.
expectedRangeDatatypetrueShapeViolationReportstringThe expected range class IRI for the violated property.
violationMinCountDatatypetrueShapeViolationReportnonNegativeIntegerThe minimum cardinality from the violated constraint.
violationMaxCountDatatypetrueShapeViolationReportnonNegativeIntegerThe maximum cardinality from the violated constraint (0 = unbounded).
violationKindObjecttrueShapeViolationReportViolationKindThe kind of violation that occurred.
builderRootTermObjecttrueCompileUnitBuilderTermThe root term expression for the CompileUnit.
builderWittLevelCeilingObjecttrueCompileUnitBuilderWittLevelThe widest quantum level the computation may reference.
builderThermodynamicBudgetDatatypetrueCompileUnitBuilderdecimalLandauer-bounded energy budget in kBT ln 2 units.
builderTargetDomainsObjectfalseCompileUnitBuilderVerificationDomainVerification domains targeted by the CompileUnit.
effectNameDatatypetrueEffectDeclarationstringThe name of the declared effect.
targetSitesDatatypefalseEffectDeclarationnonNegativeIntegerSite coordinates this effect reads or writes.
budgetDeltaDatatypetrueEffectDeclarationintegerThe site budget delta (positive = increment, negative = decrement).
commutationFlagDatatypetrueEffectDeclarationbooleanWhether this effect commutes with effects on disjoint sites.
groundingSourceTypeObjecttrueGroundingDeclarationTypeDefinitionThe source type of incoming external data.
ringMappingDatatypetrueGroundingDeclarationstringDescription of the mapping from surface data to ring.
invertibilityContractDatatypetrueGroundingDeclarationbooleanWhether the grounding map is invertible.
dispatchPredicateObjecttrueDispatchDeclarationPredicateExpressionThe predicate expression guarding this dispatch rule.
targetResolverObjecttrueDispatchDeclarationResolverThe resolver to dispatch to when the predicate holds.
dispatchPriorityDatatypetrueDispatchDeclarationnonNegativeIntegerPriority ordering for this dispatch rule (lower = first).
linearSiteDatatypetrueLeaseDeclarationnonNegativeIntegerThe site coordinate allocated linearly by this lease.
leaseScopeDatatypetrueLeaseDeclarationstringThe scope within which this lease is valid.
unfoldSeedObjecttrueStreamDeclarationTermThe seed term for the stream unfold constructor.
stepTermObjecttrueStreamDeclarationTermThe step function term for the stream unfold.
productivityWitnessDatatypetrueStreamDeclarationstringEvidence that the stream is productive (always produces a next element).
predicateInputTypeObjecttruePredicateDeclarationTypeDefinitionThe input type for the declared predicate.
evaluatorTermObjecttruePredicateDeclarationTermThe evaluator term for the declared predicate.
terminationWitnessDatatypetruePredicateDeclarationstringEvidence that the predicate evaluator terminates on all inputs.
sitePartitionObjecttrueParallelDeclarationPartitionThe site partition for the parallel composition.
disjointnessWitnessDatatypetrueParallelDeclarationstringEvidence that the site partition components are pairwise disjoint.
declaredBitWidthDatatypetrueWittLevelDeclarationpositiveIntegerThe declared bit width for this quantum level.
declaredCycleSizeDatatypetrueWittLevelDeclarationnonNegativeIntegerThe declared number of ring states at this level.
predecessorLevelObjecttrueWittLevelDeclarationWittLevelThe predecessor quantum level in the chain.
sessionCrossingCountDatatypetrueMintingSessionnonNegativeIntegerTotal boundary crossings in this minting session.
sessionIsIdempotentDatatypetrueMintingSessionbooleanWhether applying this session's boundary effect twice equals applying it once.

Named Individuals

NameTypeComment
CompileUnitShapeShapeShape validating that a CompileUnit carries all required properties before reduction admission. The unitAddress property is NOT required — it is computed by stage_initialization after shape validation passes.
  • targetClass: CompileUnit
  • requiredProperty: compileUnit_rootTerm_constraint
  • requiredProperty: compileUnit_unitWittLevel_constraint
  • requiredProperty: compileUnit_thermodynamicBudget_constraint
  • requiredProperty: compileUnit_targetDomains_constraint
compileUnit_rootTerm_constraintPropertyConstraintExactly one root term is required. Range is schema:Term.
  • constraintProperty: rootTerm
  • constraintRange: Term
  • minCount: 1
  • maxCount: 1
compileUnit_unitWittLevel_constraintPropertyConstraintExactly one quantum level is required. Range is schema:WittLevel.
  • constraintProperty: unitWittLevel
  • constraintRange: WittLevel
  • minCount: 1
  • maxCount: 1
compileUnit_thermodynamicBudget_constraintPropertyConstraintExactly one thermodynamic budget is required. Shape validates presence and type; the BudgetSolvencyCheck preflight validates the value against the Landauer bound.
  • constraintProperty: thermodynamicBudget
  • constraintRange: decimal
  • minCount: 1
  • maxCount: 1
compileUnit_targetDomains_constraintPropertyConstraintAt least one target verification domain is required. maxCount 0 means unbounded.
  • constraintProperty: targetDomains
  • constraintRange: VerificationDomain
  • minCount: 1
  • maxCount: 0
MissingViolationKindRequired property was not set on the builder.
TypeMismatchViolationKindProperty was set but its value is not an instance of the constraintRange.
CardinalityViolationViolationKindCardinality violated: too few or too many values provided.
ValueCheckViolationKindValue-dependent check failed (Tier 2). For example, thermodynamic budget insufficient for Landauer bound.
LevelMismatchViolationKindA term's quantum level annotation exceeds the CompileUnit ceiling, or binary operation operands are at different levels without an intervening lift or project.