Struct JsonlWriter 

pub struct JsonlWriter { /* private fields */ }

Append-only writer for the events JSONL log. Holds an advisory cross-platform file lock around each append + fsync, so that concurrent producers (auto-capture hook + manual task-journal event + MCP server) cannot interleave bytes — O_APPEND alone is not atomic on Windows.

The trade-off: every append takes one syscall to acquire the lock and one more to release it. For a journal — which sees a handful of events per minute — this overhead is negligible and far cheaper than recovery from a corrupt JSONL line.

Implementations

impl JsonlWriter

pub fn open(path: impl AsRef<Path>) -> Result<Self>

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

pub fn flush_durable(&mut self) -> Result<()>

Force the file’s bytes through to durable storage. Holds the exclusive lock so no concurrent writer can sneak an append between us and the fsync.

pub fn path(&self) -> &Path