Struct DurableTraceJournal 

pub struct DurableTraceJournal { /* private fields */ }

Durable, per-workspace persistence layer for execution traces.

Implementations

impl DurableTraceJournal

pub fn open( root: &Path, config: JournalConfig, ) -> Result<Self, TraceJournalError>

Opens (or creates) a durable trace journal rooted at root, using the real system clock for segment rollover/retention timing.

Errors

See Self::open_with_clock.

pub fn open_with_clock( root: &Path, config: JournalConfig, clock: Arc<dyn BrokerClock>, ) -> Result<Self, TraceJournalError>

As Self::open, with an injectable clock for deterministic tests.

Errors

Returns TraceJournalError::Journal when the journal cannot be opened, including when a completed (non-final) on-disk record is corrupt (spec 066 FR-009: fail loudly rather than silently discard). Returns TraceJournalError::Deserialize when a durably-recorded trace record cannot be parsed back during the open-time recovery scan.

pub fn recovery_report(&self) -> &TraceRecoveryReport

Deterministic evidence of what survived recovery when this journal was opened (FR-003).

pub fn record( &mut self, public: &PublicTraceEntry, private: Option<&PrivateTraceEntry>, ) -> Result<String, TraceJournalError>

Durably appends one trace record, fsync-committed before returning (FR-001). Returns the journal cursor for the appended record.

Errors

Returns TraceJournalError when the durable write fails.

pub fn prune(&mut self) -> Result<TracePrunedEvidence, TraceJournalError>

Reclaims retained trace history past the configured age/size bounds, deterministic oldest segment first, never touching the active (currently-being-written) segment (FR-005).

Errors

Returns TraceJournalError when a segment cannot be removed.