kuilt-bolt/us.tractat.kuilt.bolt/ReplayScope

ReplayScope

sealed interface ReplayScope

Which frames a Bolt.replay should yield.

Two of these are cursors (All, FromOffset) and two are queries (Arrived, InsertsAbove). The distinction matters: only a cursor is safe to resume from, because only a cursor is guaranteed to be total over the frames it has not yet seen.

Inheritors

Types

All

data object All : ReplayScope

Every frame in the archive, oldest first.

Arrived

data class Arrived(val from: Instant, val untilExclusive: Instant) : ReplayScope

Every frame whose arrival timestamp is in [from, untilExclusive).

FromOffset

data class FromOffset(val offset: Long) : ReplayScope

Every frame at or after offset — the resume cursor.

InsertsAbove

data class InsertsAbove(val floor: VersionVector) : ReplayScope

Every frame carrying at least one Insert whose Dot is strictly above floor for its author — a query over the archive's causal coverage.