Enum CommitEvent 

pub enum CommitEvent {
    GenerationStarted,
    DiffPrepared {
        empty: bool,
        content_id_sha256: String,
    },
    DiffFailed {
        error: String,
    },
    DiffInvalidated {
        reason: String,
    },
    PromptPrepared {
        attempt: u32,
    },
    AgentInvoked {
        attempt: u32,
    },
    CommitXmlExtracted {
        attempt: u32,
    },
    CommitXmlMissing {
        attempt: u32,
    },
    CommitXmlValidated {
        message: String,
        attempt: u32,
    },
    CommitXmlValidationFailed {
        reason: String,
        attempt: u32,
    },
    CommitXmlArchived {
        attempt: u32,
    },
    CommitXmlCleaned {
        attempt: u32,
    },
    MessageGenerated {
        message: String,
        attempt: u32,
    },
    MessageValidationFailed {
        reason: String,
        attempt: u32,
    },
    Created {
        hash: String,
        message: String,
    },
    GenerationFailed {
        reason: String,
    },
    Skipped {
        reason: String,
    },
}

Commit generation events.

Events related to commit message generation, validation, and creation. Commit generation occurs after development iterations and review fixes.

State Machine

NotStarted -> Generating -> Generated -> Committed
                   |              |
                   +--> (retry) --+
                   |
                   +--> Skipped

Emitted By

• Commit generation handlers in handler/commit/
• Commit message validation handlers
• Git commit handlers

Variants

GenerationStarted

Commit message generation started.

DiffPrepared

Commit diff computed for commit generation.

Emitted after preparing the diff that will be committed. The reducer uses the empty flag to decide whether to skip commit creation.

Fields

empty: bool

True when the diff is empty.

content_id_sha256: String

Content identifier (sha256 hex) of the prepared diff content.

This is used to guard against reusing stale materialized inputs when the diff content changes across checkpoints or retries.

DiffFailed

Commit diff computation failed.

Fields

error: String

The error message for the diff failure.

DiffInvalidated

Commit diff is no longer available and must be recomputed.

This is used for recoverability when .agent/tmp artifacts are cleaned between checkpoints or when required diff files go missing during resume.

Fields

reason: String

Reason for invalidation.

PromptPrepared

Commit prompt prepared for a commit attempt.

Fields

attempt: u32

The attempt number.

AgentInvoked

Commit agent invoked for a commit attempt.

Fields

attempt: u32

The attempt number.

CommitXmlExtracted

Commit message XML extracted for a commit attempt.

Fields

attempt: u32

The attempt number.

CommitXmlMissing

Commit message XML missing for a commit attempt.

Fields

attempt: u32

The attempt number.

CommitXmlValidated

Commit message XML validated successfully.

Fields

message: String

The generated commit message.

attempt: u32

The attempt number.

CommitXmlValidationFailed

Commit message XML validation failed.

Fields

reason: String

The reason for validation failure.

attempt: u32

The attempt number.

CommitXmlArchived

Commit message XML archived.

Fields

attempt: u32

The attempt number.

CommitXmlCleaned

Commit message XML cleaned before invoking the commit agent.

Fields

attempt: u32

The attempt number.

MessageGenerated

Commit message was generated.

Fields

message: String

The generated commit message.

attempt: u32

The attempt number.

MessageValidationFailed

Commit message validation failed.

Fields

reason: String

The reason for validation failure.

attempt: u32

The attempt number that failed.

Created

Commit was created successfully.

Fields

hash: String

The commit hash.

message: String

The commit message used.

GenerationFailed

Commit generation failed completely.

Fields

reason: String

The reason for failure.

Skipped

Commit was skipped (e.g., no changes to commit).

Fields

reason: String

The reason for skipping.

Trait Implementations

impl Clone for CommitEvent

fn clone(&self) -> CommitEvent

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for CommitEvent

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for CommitEvent

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for CommitEvent

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.