Struct Entry 

pub struct Entry {
    pub ts: String,
    pub event: String,
    pub head: String,
    pub branch: String,
    pub by: String,
    pub session: Option<String>,
    pub payload: BTreeMap<String, Value>,
}

One line of the record, as a reader sees it.

The envelope is typed and the payload is left as it was written: a reader of one event knows its own keys, and this type may not grow a field every time an event does.

use majordomus_cli::ledger::Entry;
let e: Entry = serde_json::from_str(
    r#"{"ts":"2026-09-11T12:00:00Z","event":"plan_done","head":"abc","branch":"master",
        "by":"majordomus/0.5.0","issue":"I0001"}"#).unwrap();
assert_eq!(e.event, "plan_done");
assert!(e.session.is_none(), "no episode was open when this was written");
// Everything the envelope does not name stays in the payload, whatever the event is.
assert_eq!(e.payload["issue"], "I0001");

Fields

ts: String

When it happened.

event: String

The event name, from the vocabulary.

head: String

The commit the checkout was at.

branch: String

The branch it was on.

by: String

What wrote it: majordomus/<version>.

session: Option<String>

The episode it belongs to, when there was one.

payload: BTreeMap<String, Value>

Everything else the line carried.

Trait Implementations

impl Clone for Entry

fn clone(&self) -> Entry

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Entry

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for Entry

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for Entry

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

where __S: Serializer,

Serialize this value into the given Serde serializer.