Skip to content

Glossary

TermMeaning
Architecture claimA reviewable statement in .shape about resources, components, effects, relations, or review context.
AttestationA documented reviewer decision that a governed source or bound review-surface change does not require a Shape update.
BindingA rule that couples changed paths, such as requiring docs changes when Shape-affecting code changes.
ComponentA named architectural boundary that owns resources, grants effects, and contains function summaries. Does not carry structural dependencies.
Complete effectsAn effect summary that claims to be exhaustive for a function.
DiagnosticA checker message explaining why a model failed.
EffectA declared operation such as Append<AuditEvent> or HardDelete<AuditEvent>.
EvidenceA source reference that supports an effect claim.
Final forbidA trait or rule constraint that cannot be overridden by a component grant.
Governed pathA source path covered by an implementation block.
HyperedgeA named structural link between two or more components or resources, declared as a relation.
HypercycleA cycle in the directed hypergraph, found by traversing relations according to their kind.
ImplementationA mapping from source paths to a component shape.
IncidenceThe vertex-to-hyperedge index that drives shp graph and hypercycle checks.
MemoryA typed design-memory declaration, usually for a refactor constraint.
RationaleA typed explanation for an intentional function shape.
ReevaluationA typed review record that can satisfy a guarded change.
Refactor constraintDesign context that makes a function shape refactor-sensitive.
RelationA top-level declaration describing a hyperedge with a kind, connects, optional roles, and optional summary.
Relation kindA label such as calls, callbacks, provides, or coordinated_call. Each kind declares arity and cycle traversal semantics.
ResourceA protected architectural target such as a table, stream, endpoint, bucket, or domain object.
Required descriptionA non-empty function description required by a function shape trait or explicit description required.
Shape updateA changed global .shape declaration that keeps the architecture model aligned with source changes.
Shape traitA function-level trait such as PreserveInline or RefactorSensitive that derives review obligations.
Source refA language-tagged path such as ts("src/audit/store.ts:8-14").
TraitA reusable set of allowed, required, or forbidden effect patterns.
Unknown effectsAn explicit marker that a function’s effects are not known yet.