kuilt-raft/us.tractat.kuilt.raft/Committed

Committed

sealed interface Committed

One ordered instruction in the committed stream delivered to a consumer's state machine.

A reset (Install) always arrives in order relative to the Entrys around it: apply nothing with index <= snapshot.throughIndex after an install, and miss nothing before it. This in-order guarantee is why the stream is a single sealed type rather than two parallel flows.

Every committed index is accounted for. An Entry carries an application command to apply; an Internal marks a committed index whose entry is raft's own bookkeeping and carries no payload at all. Folding both advances a state machine's applied prefix exactly as fast as RaftNode.commitIndex, which is what makes the applied prefix comparable to RaftNode.readIndex's fence (#1718).

Inheritors

Entry

Internal

Install

Types

Entry

data class Entry(val entry: LogEntry) : Committed

Apply this committed application entry.

Install

data class Install(val snapshot: Snapshot) : Committed

Discard current state and reset the state machine to snapshot. Rare — only after a real install.

Internal

data class Internal(val index: Long) : Committed

A committed index raft withheld from the application: the internal §5.4.2 election no-op (LogEntry.isNoOp) or a §6 membership-change entry (LogEntry.config).