Struct SessionJournal 

pub struct SessionJournal { /* private fields */ }

Thread-safe, append-only, hash-chained session journal.

Create one per session and share it (via Arc<SessionJournal>) with all guards that need session-aware context.

Implementations

impl SessionJournal

pub fn new(session_id: String) -> Self

Create a new empty journal for the given session.

pub fn session_id(&self) -> &str

Return the session identifier.

pub fn record(&self, params: RecordParams) -> Result<u64, SessionJournalError>

Append a new entry to the journal.

The entry is hash-chained to the previous entry. Returns the sequence number of the new entry.

pub fn data_flow(&self) -> Result<CumulativeDataFlow, SessionJournalError>

Return a snapshot of the cumulative data flow statistics.

pub fn tool_sequence(&self) -> Result<Vec<String>, SessionJournalError>

Return the ordered tool invocation sequence.

pub fn tool_counts(&self) -> Result<HashMap<String, u64>, SessionJournalError>

Return per-tool invocation counts.

pub fn len(&self) -> Result<usize, SessionJournalError>

Return the number of entries in the journal.

pub fn is_empty(&self) -> Result<bool, SessionJournalError>

Return whether the journal is empty.

pub fn entries(&self) -> Result<Vec<JournalEntry>, SessionJournalError>

Return a clone of all journal entries.

pub fn recent_entries( &self, n: usize, ) -> Result<Vec<JournalEntry>, SessionJournalError>

Return the most recent N entries (or all if fewer than N exist).

pub fn verify_integrity(&self) -> Result<(), SessionJournalError>

Verify the integrity of the hash chain.

Returns Ok(()) if all entries are correctly chained, or an error indicating where the chain breaks.

pub fn head_hash(&self) -> Result<String, SessionJournalError>

Return the hash of the most recent entry (or the zero hash if empty).

Trait Implementations

impl Debug for SessionJournal

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

Formats the value using the given formatter.