Struct CommitLogSession 

pub struct CommitLogSession { /* private fields */ }

Session tracker for commit generation logging.

Manages a unique run directory for a commit generation session, ensuring log files are organized and don’t overwrite each other.

Implementations

impl CommitLogSession

pub fn new(base_log_dir: &str, workspace: &dyn Workspace) -> Result<Self>

Create a new logging session using workspace abstraction.

Creates a unique run directory under the base log path.

Arguments

• base_log_dir - Base directory for commit logs (e.g., .agent/logs/commit_generation)
• workspace - The workspace to use for filesystem operations

pub fn noop() -> Self

Create a no-op logging session that discards all writes.

This is used as a fallback when all log directories fail to be created. The session will still track attempt numbers and provide a dummy run_dir, but writes will silently succeed without actually writing anything.

Returns

A CommitLogSession that uses /dev/null equivalent as its run directory.

pub fn is_noop(&self) -> bool

Check if this is a no-op session.

pub fn run_dir(&self) -> &Path

Get the path to the run directory.

pub const fn next_attempt_number(&mut self) -> usize

Get the next attempt number and increment the counter.

pub fn new_attempt(&mut self, agent: &str, strategy: &str) -> CommitAttemptLog

Create a new attempt log for this session.

Arguments

• agent - The agent being used
• strategy - The retry strategy being used

pub fn write_summary( &self, total_attempts: usize, final_outcome: &str, workspace: &dyn Workspace, ) -> Result<()>

Write summary file at end of session.

For noop sessions, this silently succeeds without writing anything.

Arguments

• total_attempts - Total number of attempts made
• final_outcome - Description of the final outcome
• workspace - The workspace to use for filesystem operations

Trait Implementations

impl Debug for CommitLogSession

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

Formats the value using the given formatter.