Struct ChangeEntry 

pub struct ChangeEntry<'a> {
    pub kind: MutationKind,
    pub entity: Option<&'a str>,
    pub actor: Actor,
    pub client: Option<&'a ClientId>,
    pub note: Option<&'a str>,
    pub logical_operation_id: Option<&'a str>,
    pub role: Role,
}

A single mutation event. Built at the call site in the filesystem engine (criterion 1’s wiring) and passed to append_change.

Fields

kind: MutationKind

entity: Option<&'a str>

Mem-relative entity id, or None for batch mutations.

actor: Actor

client: Option<&'a ClientId>

Optional caller identity (e.g. claude-code@2.1.0).

note: Option<&'a str>

Optional agent-authored provenance note. Whitespace-only values are treated as absent.

logical_operation_id: Option<&'a str>

Correlation id linking every commit produced by a single logical operation (notably multi-mem memstead_rename). None for single-call mutations that don’t participate in correlation. Round-trips through the JSONL wire shape; reader reconstructs the same value on read_provenance.

role: Role

Caller-declared role (agent-trust plan 13); Unspecified omits the field — absence recorded as absence.