Struct WrapReport 

pub struct WrapReport {
    pub schema: u32,
    pub session_ulid: String,
    pub started_at: DateTime<Utc>,
    pub ended_at: DateTime<Utc>,
    pub duration_secs: u64,
    pub total_events: u64,
    pub event_counts: EventCounts,
    pub top_commands: Vec<CommandCount>,
}

The wrap artifact as persisted to disk and printed as a line in the log.

#[serde(deny_unknown_fields)] is intentional on the reader side (not here) — a future wrap schema that drops a field would be a silent honesty regression if old tooling kept deserialising the old shape. For now the writer is the only producer, so no deny-unknown on this struct.

Fields

schema: u32

Schema version of this wrap. Bump on shape changes so a future reader can refuse an incompatible blob up front.

session_ulid: String

The session’s ULID. Matches the artifact filename so reading a wraps directory without loading JSON is possible.

started_at: DateTime<Utc>

Session start — ISO-8601 with zone.

ended_at: DateTime<Utc>

Session end — the timestamp the wrap is being generated at (the event-loop’s drive() returns and we snapshot Utc::now()). Not the last-event timestamp because the operator may have idled at the prompt for a while after the last command and that idle is still session time.

duration_secs: u64

Duration in seconds. Redundant with ended_at - started_at but materialised so a reader does not have to do the subtraction and does not have to agree on leap-second handling.

total_events: u64

Total events the store captured this session. Includes every line that hit SessionSink::push.

event_counts: EventCounts

Per-kind event counts. Stable insertion order: prompt, command, system, warn, alert, mode_change. A future kind added to EventKind surfaces as a zero here until the generator is updated (caught by the exhaustive-match test).

top_commands: Vec<CommandCount>

The top-N most-invoked slash commands this session. Computed from prompt events whose text starts with /. Ordered by descending count, then alphabetically on ties for determinism. N = 10 is the hard cap so a session that hammered /status does not bury the rest.

Trait Implementations

impl Clone for WrapReport

fn clone(&self) -> WrapReport

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for WrapReport

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for WrapReport

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl PartialEq for WrapReport

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

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

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl Eq for WrapReport

impl StructuralPartialEq for WrapReport