Struct WALFrame 

pub struct WALFrame<T> {
    pub t: WalTag,
    pub lifecycle: Lifecycle,
    pub path: String,
    pub change: BaseChange<T>,
    pub frame_seq: u64,
    pub frame_t_ns: u64,
    pub checksum: String,
    pub format_version: u32,
}

On-disk WAL frame (DS-14-storage Q1 lock).

Two seq fields and two timestamp fields are intentional:

• Self::frame_seq ≠ change.seq: latter is the bundle’s mutations cursor (DS-14 T1); former is the WAL tier’s own cursor (this record’s position in the WAL stream). Replay uses frame_seq for ordering; change.seq is only relevant for bundle-level cursor restoration.
• Self::frame_t_ns ≠ change.t_ns: latter is wall-clock at mutation entry; former is wall-clock at WAL-write time. Under debounced tiers they differ by debounce_ms.

The bridge wire format (DS-14 PART 5 worker bridge) is the schema-narrowed subset { t, lifecycle, path, change } — this struct is the persistence-tier superset (DS-14-storage L3 lock).

Fields

t: WalTag

Bridge tag — discriminator shared with the DS-14 worker-bridge wire format. Always "c"; allocated as String for parity with the TS wire shape (TS uses a literal "c" value).

lifecycle: Lifecycle

Lifecycle scope (DS-14 PART 4). Determines replay phase ordering.

path: String

Target node / bundle path (per-graph qualified path).

change: BaseChange<T>

DS-14 universal BaseChange<T> envelope — structure-tagged delta.

frame_seq: u64

WAL-tier monotonic cursor (uniquely owned by the WAL tier writer).

frame_t_ns: u64

Wall-clock at WAL-write time (matches wall_clock_ns()).

checksum: String

SHA-256 over the canonical-JSON of the frame body sans checksum, encoded as a 64-char lowercase hex string. Hex (vs raw bytes) keeps the wire format JSON-codec-friendly. M4.A parity-fixture asserts byte-equivalence against the TS impl.

format_version: u32

Codec version tag. All M4.A frames are implicitly version 1 (JSON codec). Defaults to 1 for backward-compatible deserialization of frames written before this field was added.

Trait Implementations

impl<T: Clone> Clone for WALFrame<T>

fn clone(&self) -> WALFrame<T>

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl<T: Debug> Debug for WALFrame<T>

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl<'de, T> Deserialize<'de> for WALFrame<T>

where T: Deserialize<'de>,

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl<T: PartialEq> PartialEq for WALFrame<T>

fn eq(&self, other: &WALFrame<T>) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl<T> Serialize for WALFrame<T>

where T: Serialize,

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl<T: Eq> Eq for WALFrame<T>

impl<T> StructuralPartialEq for WALFrame<T>