Struct ParsingTraceLog 

pub struct ParsingTraceLog {
    pub attempt_number: usize,
    pub agent: String,
    pub strategy: String,
    pub raw_output: Option<String>,
    pub steps: Vec<ParsingTraceStep>,
    pub final_message: Option<String>,
    pub timestamp: DateTime<Local>,
}

Detailed parsing trace log for commit message extraction.

This log captures each step of the extraction process, showing:

• What extraction method was tried (XML, JSON, pattern-based)
• The exact content being processed at each step
• Validation results and why they passed/failed
• The final extracted message

This is separate from the attempt log and written to parsing_trace.log.

Fields

attempt_number: usize

Attempt number this trace belongs to

agent: String

Agent that generated the output

strategy: String

Strategy used

raw_output: Option<String>

Raw output from the agent

steps: Vec<ParsingTraceStep>

Individual parsing steps

final_message: Option<String>

Final extracted message (if any)

timestamp: DateTime<Local>

Timestamp when trace started

Implementations

impl ParsingTraceLog

pub fn new(attempt_number: usize, agent: &str, strategy: &str) -> Self

Create a new parsing trace log.

pub fn with_raw_output(self, output: &str) -> Self

Set the raw output from the agent (consuming builder).

pub fn add_step(self, step: ParsingTraceStep) -> Self

Add a parsing step to the trace.

pub fn with_final_message(self, message: &str) -> Self

Set the final extracted message (consuming builder).

pub fn write_to_workspace( &self, log_dir: &Path, workspace: &dyn Workspace, ) -> Result<PathBuf>

Write this trace to a file using workspace abstraction.

This is the architecture-conformant version that uses the workspace trait instead of direct filesystem access.

Arguments

• log_dir - Directory to write the trace file to (relative to workspace)
• workspace - The workspace to use for filesystem operations

Returns

Path to the written trace file on success.

Errors

Returns error if the operation fails.

Trait Implementations

impl Clone for ParsingTraceLog

fn clone(&self) -> ParsingTraceLog

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for ParsingTraceLog

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

Formats the value using the given formatter.