Struct RunJournal 

pub struct RunJournal {
    pub run_id: String,
    pub export_name: String,
    pub entries: Vec<JournalEntry>,
}

Canonical in-memory record of a pipeline run.

Accumulated during execution via record(). Query methods let callers answer the four DoD questions without iterating entries directly.

Fields

run_id: String

export_name: String

entries: Vec<JournalEntry>

All events in insertion order.

Implementations

impl RunJournal

pub fn new(run_id: impl Into<String>, export_name: impl Into<String>) -> Self

pub fn record(&mut self, event: RunEvent)

Append an event with the current UTC timestamp.

pub fn plan_snapshot(&self) -> Option<&PlanSnapshot>

Returns the plan snapshot recorded at the start of the run.

pub fn files(&self) -> Vec<&JournalEntry>

All FileWritten entries, in the order files were committed.

pub fn retries(&self) -> Vec<&JournalEntry>

All RetryAttempted entries.

pub fn chunk_events(&self) -> Vec<&JournalEntry>

All chunk lifecycle entries (ChunkStarted, ChunkCompleted, ChunkFailed).

pub fn longest_chunk_ms(&self) -> Option<i64>

The longest single-chunk wall time in milliseconds, if derivable.

Pairs each ChunkStarted with its ChunkCompleted by chunk_index (robust to the interleaving the parallel runners produce) and returns the largest gap. This is the #5 source-harm lever — how long one chunk query, and the snapshot / locks it holds, stayed open — made measurable.

None when no pair is found: a non-chunked run, or a parallel runner that records ChunkCompleted in a single post-scope batch (so no real per-chunk start time exists). The sequential and checkpoint paths timestamp each event as it happens, so they yield true per-chunk timings.

pub fn quality_issues(&self) -> Vec<&JournalEntry>

All QualityIssue entries (both FAIL and WARN severity).

pub fn schema_changes(&self) -> Vec<&JournalEntry>

All SchemaChanged entries.

pub fn warnings(&self) -> Vec<&JournalEntry>

All Warning and PlanWarning entries.

pub fn final_outcome(&self) -> Option<&JournalEntry>

The last RunCompleted entry, or None if the run has not yet finished.

Trait Implementations

impl Clone for RunJournal

fn clone(&self) -> RunJournal

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for RunJournal

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for RunJournal

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for RunJournal

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

where __S: Serializer,

Serialize this value into the given Serde serializer.