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_CHANGED
  • STATUS_CHANGED
  • ASSURANCE_CHANGED
  • AUTHORITY_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.