Struct Envelope 

pub struct Envelope {
    pub ts: String,
    pub head: String,
    pub branch: String,
    pub by: String,
    pub session: Option<String>,
}

The computed half of a ledger line: what the writer knows and the event does not.

Every field here is computed and never authored, exactly as share/events.yaml says. It is passed in rather than gathered here, because a domain that shells out to git while holding the ledger’s lock holds it for a hundred milliseconds on a loaded machine.

use majordomus_cli::session::Envelope;

let envelope = Envelope {
    ts: "2026-09-11T11:02:35Z".into(), head: "1a651e64".into(),
    branch: "master".into(), by: "majordomus/0.5.0".into(),
    session: Some("s-20260910205542-e2a6".into()),
};
// a line carrying no session belongs to no episode, which is an answer and not a gap
assert!(envelope.session.is_some());

Fields

ts: String

When, RFC 3339 in UTC.

head: String

The commit the writer was on.

branch: String

The branch it was on.

by: String

The writer, majordomus/<version>.

session: Option<String>

The episode this line belongs to, when one is open. A line carrying no session id belongs to no episode, and that is the correct answer rather than a gap: work done outside an episode is attributed to nobody rather than to whoever had one open nearby.

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 Eq for Envelope

impl PartialEq for Envelope

fn eq(&self, other: &Envelope) -> 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 StructuralPartialEq for Envelope