Struct EventLog 

pub struct EventLog { /* private fields */ }

A long-lived writer for one run’s events.jsonl.

The file handle is kept open for the lifetime of the EventLog so appends avoid the per-call open + fsync parent-dir overhead. Only appends are performed; readers go through the free read_run function and open the file fresh.

Implementations

impl EventLog

pub fn for_run(volume_root: &Path, run_id: &str) -> Result<Self, Error>

Open (or create) the per-run log at .omne/var/runs/<run_id>/events.jsonl. Parent directories are created on demand.

pub fn path(&self) -> &Path

Path to the underlying events.jsonl. Exposed for tests and for callers that need to emit the path in a log line.

pub fn append(&self, event: &Event) -> Result<(), Error>

Append one event as a JSON line.

Acquires the per-instance mutex, then the cross-process fs2 advisory lock, writes exactly one line terminated by \n, flushes, and releases the advisory lock. The mutex is released when the guard drops.