Enum CommitError 

pub enum CommitError {
    Validation(String),
    StoreWrite(StorageError),
    MessageVersionConflict {
        thread_id: String,
        expected: u64,
        actual: u64,
    },
    EventAppend(EventStoreError),
    OutboxInsert(OutboxError),
    Commit(String),
    ScopeMismatch(String),
}

Failure surface for CommitCoordinator::commit_checkpoint.

Any variant aborts the transaction. The runtime treats this as terminal for the current run per ADR-0036 D6.

Variants

Validation(String)

Plan failed pre-commit validation.

StoreWrite(StorageError)

ThreadRunStore checkpoint write failed.

MessageVersionConflict

A version-guarded committed message append found a stale expected version — the committed log advanced under the writer. The caller reloads, re-merges its delta, recomputes the range, and retries (ADR-0042 A).

Fields

thread_id: String

expected: u64

actual: u64

EventAppend(EventStoreError)

EventStore::append failed for a staged draft.

OutboxInsert(OutboxError)

Inline-writer outbox insert failed.

Commit(String)

Backend-level commit error (transaction commit failure, network).

ScopeMismatch(String)

Builder-time scope mismatch detected at runtime.

Implementations

impl CommitError

pub fn reclassify_append_conflict(self, thread_id: &str) -> CommitError

Reclassify a wrapped store-level StorageError::VersionConflict from an append commit into the message-level CommitError::MessageVersionConflict carrying thread_id, so the append retry path can distinguish a stale version (reload-merge-retry) from other store-write failures (abort). Other errors pass through unchanged (ADR-0042 A).

Trait Implementations

impl Debug for CommitError

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

Formats the value using the given formatter.

impl Display for CommitError

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

Formats the value using the given formatter.

impl Error for CommitError

fn source(&self) -> Option<&(dyn Error + 'static)>

Returns the lower-level source of this error, if any.

fn description(&self) -> &str

👎Deprecated since 1.42.0:

use the Display impl or to_string()

fn cause(&self) -> Option<&dyn Error>

👎Deprecated since 1.33.0:

replaced by Error::source, which can support downcasting

fn provide<'a>(&'a self, request: &mut Request<'a>)

🔬This is a nightly-only experimental API. (error_generic_member_access)

Provides type-based access to context intended for error reports.

impl From<EventStoreError> for CommitError

fn from(source: EventStoreError) -> CommitError

Converts to this type from the input type.

impl From<OutboxError> for CommitError

fn from(source: OutboxError) -> CommitError

Converts to this type from the input type.

impl From<StorageError> for CommitError

fn from(source: StorageError) -> CommitError

Converts to this type from the input type.