Struct Journal 

pub struct Journal { /* private fields */ }

In-memory journal with optional durable path.

Maturity: core

Implementations

impl Journal

pub const fn new(path: Option<PathBuf>) -> Self

Empty journal, optionally bound to a path for appends.

pub fn load(path: PathBuf) -> Result<Self, JournalError>

Load from jsonl path (missing file => empty bound journal).

Errors

Returns parse/IO/unsafe-restore errors. Torn final lines are repaired (completed with \n when valid JSON, otherwise truncated).

pub const fn len(&self) -> usize

Number of entries.

pub const fn is_empty(&self) -> bool

Empty check.

pub const fn bytes(&self) -> u64

Durable byte length (header + lines, after repairs).

pub fn agent_reservation_count(&self) -> u64

Count of recorded spawn_agent entries (reservation accounting helper).

pub fn covers(&self, seq: u64) -> bool

Whether seq is already covered.

pub fn replay( &self, seq: u64, kind: &str, hash: &str, ) -> Result<Option<Value>, JournalError>

Replay a covered call or return None to execute live.

Errors

Divergence when kind/hash mismatch.

pub fn record( &mut self, seq: u64, kind: &str, hash: String, result: Value, ) -> Result<(), JournalError>

Append a live result.

Errors

Full journal, sequence errors, or IO failures.

pub fn prune_trailing_host_error( &mut self, failure_detail: &str, ) -> Result<bool, JournalError>

Drop the trailing host-error sentinel when it matches failure_detail.

Used so a recoverable host failure can be retried on resume without replaying the same error. Safe to call repeatedly: each successful prune restores the prior entry’s line offset.

Errors

IO failures while truncating the durable file.

pub fn prune_trailing_host_errors( &mut self, failure_detail: &str, ) -> Result<usize, JournalError>

Drop trailing host-error sentinels while failure_detail matches the current last entry’s message (repeated prune).

Errors

IO failures while truncating.

pub fn path(&self) -> Option<&Path>

Optional durable path.

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

Entries as a slice (for inspection / tests).

Trait Implementations

impl Debug for Journal

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

Formats the value using the given formatter.

impl Default for Journal

fn default() -> Journal

Returns the “default value” for a type.