Changes
GET /v1/states/{factStateVersionId}/change Returns a deterministic classification of what changed relative to the prior exact state — never a raw text diff.
Response — RealityChangeClassificationV1
Transition kind (RealityTransitionKind):
INITIAL— first observed state, nothing to compare against.NO_SEMANTIC_CHANGE— a new state was recorded, but nothing meaningful changed.SEMANTIC_CHANGE— something meaningful changed.
Change dimensions (RealityChangeDimension), when semantic:
VALUE_CHANGEDSTATUS_CHANGEDASSURANCE_CHANGEDAUTHORITY_CHANGED
Why this over a diff
A deterministic classification lets you route on it (page a human only for SEMANTIC_CHANGE on VALUE_CHANGED, say) instead of re-reading every revision.