Struct TraceWriter 

pub struct TraceWriter { /* private fields */ }

The rollout writer: feed it every engine Event; it materializes the file on Init (header + preamble message lines) and appends one message line per appended Message. All other event types are ignored — deltas are display-only and the report already has its own artifact (ADR-0014).

Implementations

impl TraceWriter

pub fn new(sessions_root: PathBuf, extras: TraceExtras) -> Self

A writer that will place rollouts under sessions_root (usually <locode home>/sessions). Nothing touches the disk until Init.

pub fn resume(path: PathBuf, sessions_root: PathBuf) -> Result<Self, String>

Reopen an existing rollout for appending (--continue/--resume, ADR-0024 §2.5): the torn tail is healed, and the session’s Init re-emission is ignored — the header and history are already on disk; only newly appended messages land (codex’s reopen-for-append).

Errors

When the file cannot be opened for appending.

pub fn on_event(&mut self, event: &Event)

Feed one engine event. Never fails — on the first IO error the writer disables itself (fetch the message via Self::take_error).

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

The open rollout path (after Init).

pub fn take_error(&mut self) -> Option<String>

The first IO error, if tracing failed (the caller surfaces it as a warning).

Trait Implementations

impl Debug for TraceWriter

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

Formats the value using the given formatter.