Struct TxLog 

pub struct TxLog {
    pub session_id: String,
    pub project_path: String,
    pub started_at: String,
    pub ended_at: Option<String>,
    /* private fields */
}

Transaction log container

Fields

session_id: String

Session metadata

project_path: String

Absolute (or workspace-relative) project root path the session operates on.

started_at: String

Session start time, ISO 8601 string.

ended_at: Option<String>

Session end time, ISO 8601 string; None while the session is still active.

Implementations

impl TxLog

pub fn new() -> Self

Create a new empty log

pub fn with_project(project_path: impl Into<String>) -> Self

Create with project path

pub fn push(&mut self, entry: TxEntry)

Add an entry to the log

pub fn log(&mut self, action: TxAction) -> u64

Create and add a new entry

pub fn entries(&self) -> &[TxEntry]

Get all entries

pub fn get(&self, id: u64) -> Option<&TxEntry>

Get entry by ID

pub fn len(&self) -> usize

Number of entries

pub fn is_empty(&self) -> bool

Check if empty

pub fn iter(&self) -> impl Iterator<Item = &TxEntry>

Iterate over entries

pub fn iter_replayable(&self) -> impl Iterator<Item = &TxEntry>

Iterate over replayable entries only

pub fn iter_mutations(&self) -> impl Iterator<Item = &TxEntry>

Iterate over mutation entries only

pub fn mutations_affecting(&self, symbol: &SymbolPath) -> Vec<&TxEntry>

Get mutations affecting a specific symbol

Returns all mutation entries where affected_symbols contains the given symbol or one of its ancestors.

pub fn mutations_affecting_subtree(&self, symbol: &SymbolPath) -> Vec<&TxEntry>

Get mutations affecting a symbol and all its descendants

Returns all mutation entries where affected_symbols contains any symbol in the subtree rooted at the given symbol.

pub fn entries_since_checkpoint(&self, checkpoint_name: &str) -> Vec<&TxEntry>

Get entries since a checkpoint

pub fn last_n(&self, n: usize) -> &[TxEntry]

Get the last N entries

pub fn end_session(&mut self)

Mark session as ended

pub fn summary(&self) -> TxSummary

Generate summary

pub fn dump_json(&self, path: &Path) -> Result<()>

Dump to JSON file

pub fn dump_json_compact(&self, path: &Path) -> Result<()>

Dump to compact JSON (single line)

pub fn load_json(path: &Path) -> Result<Self>

Load from JSON file

pub fn to_json(&self) -> Result<String, Error>

Convert to JSON string

pub fn from_json(json: &str) -> Result<Self, Error>

Parse from JSON string

Trait Implementations

impl Clone for TxLog

fn clone(&self) -> TxLog

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for TxLog

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

Formats the value using the given formatter.

impl Default for TxLog

fn default() -> Self

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for TxLog

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for TxLog

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

where __S: Serializer,

Serialize this value into the given Serde serializer.