Zephr Docs

Beliefs

A belief is the unit of memory Zephr stores. It records something an agent has learned, rather than presenting that thing as bare truth.

Version chains

Every belief is carried through an immutable, verifiable version chain. Each new version of a belief is a distinct revision, and the chain records how versions supersede one another over time. zephr_verify checks the chain's integrity: the current-version pointer, contiguous revisions, and non-overlapping transaction intervals.

Review states

Beliefs move through review states. The Trust Firewall references these states to decide recall eligibility:

  • Unreviewed — captured but not yet confirmed or rejected.
  • Confirmed — accepted as valid by local review.
  • Rejected — reviewed and marked invalid.

Only confirmed and valid beliefs are eligible for recall by default. The Firewall's recallEligibleStates can only narrow this fixed core-eligible set — it never broadens retrieval.

Contradiction and supersession

Beliefs that contradict or supersede one another are tracked with directionality. zephr_recall returns contradiction belief IDs alongside ranked results, and zephr_why explains the directed relationships relative to a given belief.