Skip to main content
Source baselineNereuscommit c820391dc1de·verified 2026-08-07·authority reader-facing-summary

State machines

These compact machines show durable lifecycle boundaries. Workflow status does not automatically change protocol visibility; the authority column remains decisive.

Stream​

ACTIVE permits append/read, SEALED permits historical read but blocks new append, DELETING blocks new ordinary operations, and DELETED is the logical terminal state while physical GC may continue.

Higher generation​

Only COMMITTED index publication makes a generation a reader candidate.

Physical Object root​

Object LIST discovers possible orphans but cannot authorize a transition. A deletion journal makes DELETING restartable after process or response failure.

Append outcome​

KNOWN_NOT_COMMITTED -> safe to start a new attempt
MAY_HAVE_COMMITTED -> recover the original attempt and suspend the stream lane
KNOWN_COMMITTED -> do not append again; finish index/Object completion or return the result

The outcome describes commit certainty and is orthogonal to timeout, fencing, and metadata-unavailable error codes.

Source anchors​