Struct EventLogger 

pub struct EventLogger { /* private fields */ }

Logger that writes events to a JSONL file.

Implementations

impl EventLogger

pub const DEFAULT_PATH: &'static str = ".ralph/events.jsonl"

Default path for the events file.

pub fn new(path: impl Into<PathBuf>) -> Self

Creates a new event logger.

The .ralph/ directory is created if it doesn’t exist.

pub fn default_path() -> Self

Creates a logger with the default path.

pub fn from_context(context: &LoopContext) -> Self

Creates a logger using the events path from a LoopContext.

This reads the timestamped events path from the marker file if it exists, falling back to the default events path. This ensures the logger writes to the correct location when running in a worktree or other isolated workspace.

pub fn log(&mut self, record: &EventRecord) -> Result<()>

Logs an event record.

Uses a single write_all call to ensure the JSON line is written atomically. This prevents corruption when multiple processes append to the same file concurrently (e.g., during parallel merge queue processing).

pub fn log_event( &mut self, iteration: u32, hat: &str, event: &Event, triggered: Option<&HatId>, ) -> Result<()>

Convenience method to log an event directly.

pub fn path(&self) -> &Path

Returns the path to the log file.