Struct Envelope 

pub struct Envelope {
    pub schema_version: u32,
    pub producer: String,
    pub producer_model_family: String,
    pub staged_at: Timestamp,
    pub batch_id: Option<String>,
}

Change-set-level metadata block. Carries producer identity and model family; individual ops never reference it and stay producer-agnostic.

Fields

schema_version: u32

NDJSON-delta format version this envelope was staged under.

producer: String

Opaque producer identity token (interactive agent id, pipeline name, …).

producer_model_family: String

Opaque producer model family token, read by the cross-family review gate.

staged_at: Timestamp

Wall-clock time the change-set was staged, supplied by the caller.

batch_id: Option<String>

Opaque producer-assigned batch identifier. When present, a commit landing this change-set uses it verbatim as the provenance trailer; when absent, the committing tool derives a deterministic fallback from producer and staged_at instead. Optional because the identifier is opaque producer-internal tracking — a producer without its own batching model is not forced to invent one.

Implementations

impl Envelope

pub fn new( producer: impl Into<String>, producer_model_family: impl Into<String>, staged_at: Timestamp, ) -> Self

Construct an envelope stamped with CURRENT_SCHEMA_VERSION and no batch_id.

pub fn with_batch_id(self, batch_id: impl Into<String>) -> Self

Attach a producer-assigned batch identifier.

Trait Implementations

impl Clone for Envelope

fn clone(&self) -> Envelope

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Envelope

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for Envelope

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl PartialEq for Envelope

fn eq(&self, other: &Envelope) -> bool

Equality operator ==.

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

Inequality operator !=.

impl Serialize for Envelope

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

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for Envelope