Entity / Expressions

When an expression fails or refuses

StageFailure modeCommon examples
Type checkCompile error at call siteMismatched field/value type or cross-Entity predicate
DefinitionThrows naming field or pathUncollated text comparison, Order on a path, >1,000 nodes
Server bootThrows naming queryReads unmapped column or unbound Entity
EvaluationRefusal with missing itemMissing Expr.viewer context, NaN, or unsupported operator
Browser JudgeUnknown with reasonUnheld row/field or server-only operator

Three cases to keep in mind:

  • Unknown on the page is safe: It prevents optimistic logic from showing a row the server would exclude.
  • ServerOnlyRules diagnostic: State invariants compile to SQL CHECK constraints via checkConstraints, whereas transition invariants (before + after) are enforced only by the server writer and log ServerOnlyRules once at boot (see examples/writes).
  • Query.unsupported: Inspects which operations a query requires that a given interpreter lacks, ensuring interpreters fail loudly instead of silently dropping clauses.