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,
        files: Vec<String>,
        excluded_files: Vec<ExcludedFile>,
    },
    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,
    },
    GitAuthConfigured,
    PushExecuted {
        remote: String,
        branch: String,
        commit_sha: String,
        result: ProcessExecutionResult,
    },
    PushCompleted {
        remote: String,
        branch: String,
        commit_sha: String,
    },
    PushFailed {
        remote: String,
        branch: String,
        error: String,
    },
    PullRequestCreated {
        url: String,
        number: u32,
    },
    PullRequestFailed {
        error: String,
    },
    GenerationFailed {
        reason: String,
    },
    Skipped {
        reason: String,
    },
    PreTerminationSafetyCheckPassed,
    PreTerminationUncommittedChangesDetected {
        file_count: usize,
    },
    ResidualFilesFound {
        files: Vec<String>,
        pass: u8,
    },
    ResidualFilesNone,
}

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.

files: Vec<String>

Optional list of files to selectively commit.

Empty means commit all changed files. Defaults to empty for backward compatibility with old checkpoints.

excluded_files: Vec<ExcludedFile>

Files excluded from this commit with documented reasons.

Audit/observability metadata only — does not affect commit execution. Defaults to empty for backward compatibility with old checkpoints.

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.

GitAuthConfigured

Git authentication configured successfully for remote operations.

PushExecuted

Push to remote executed (boundary emits raw process output).

Domain-shaped execution outcome carrying the raw git push result. The reducer/orchestrator interprets this outcome and emits policy-level success/failure events (PushCompleted/PushFailed).

Fields

remote: String

branch: String

commit_sha: String

result: ProcessExecutionResult

Raw process execution result from git push. Contains exit code, stdout, and stderr for policy interpretation.

PushCompleted

Push to remote completed successfully.

Fields

remote: String

branch: String

commit_sha: String

PushFailed

Push to remote failed.

Fields

remote: String

branch: String

error: String

PullRequestCreated

Pull request created successfully.

Fields

url: String

number: u32

PullRequestFailed

Pull request creation failed.

Fields

error: String

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.

PreTerminationSafetyCheckPassed

Pre-termination commit safety check completed successfully.

Emitted after Effect::CheckUncommittedChangesBeforeTermination when the working directory is clean, allowing termination to proceed.

PreTerminationUncommittedChangesDetected

Pre-termination commit safety check detected uncommitted changes.

This is not a terminal error: the reducer must route back through the commit phase so the changes are committed (or explicitly skipped).

Fields

file_count: usize

Number of lines in git status --porcelain output.

ResidualFilesFound

Residual uncommitted files detected after a selective commit pass.

When pass is below the configured retry limit, triggers the next automatic commit retry pass. When pass reaches the final retry pass, the files are carried forward to the next cycle.

Fields

files: Vec<String>

Repo-relative paths of remaining dirty files.

pass: u8

Which pass just completed (1 = first pass, 2 = second pass).

ResidualFilesNone

No residual uncommitted files detected after a commit pass.

Pipeline may proceed normally; working tree is clean.

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.