Enum BranchError 

pub enum BranchError {
    InvalidConfig(String),
    PermissionDenied(String),
    WorkspaceIsolationViolation {
        expected: Uuid,
        found: Uuid,
    },
    InvalidBranchName(String),
    BranchLimitExceeded,
    Database(Error),
    Migration(MigrateError),
    Io(Error),
    Serialization(Error),
    BranchNotFound(Uuid),
    BranchAlreadyExists(String),
    BranchNotActive {
        id: Uuid,
        status: String,
    },
    SnapshotFailed {
        branch_id: Uuid,
        reason: String,
    },
    SnapshotCorrupt {
        branch_id: Uuid,
        path: PathBuf,
    },
    SnapshotHashMissing {
        branch_id: Uuid,
        path: PathBuf,
    },
    MergeConflictUnresolved {
        entity_ids: Vec<String>,
    },
    MergeIncompatibleBase {
        ours: Uuid,
        theirs: Uuid,
        reason: String,
    },
    DagCycle {
        from: Uuid,
        to: Uuid,
    },
    CycleDetected {
        from: Uuid,
        to: Uuid,
    },
    DagNodeNotFound(Uuid),
    DiffFailed {
        branch_a: Uuid,
        branch_b: Uuid,
        reason: String,
    },
    CommitValidationFailed {
        branch_id: Uuid,
        violations: Vec<String>,
    },
    SandboxError(String),
    MetricsError(String),
    NamingError(String),
    OrphanedSnapshot(PathBuf),
}

Enumerates errors produced by branching, snapshotting, merging, and metrics code.

Variants

InvalidConfig(String)

Indicates a runtime configuration is invalid.

PermissionDenied(String)

Indicates permission checks denied the operation.

WorkspaceIsolationViolation

Indicates branch data escaped workspace-scoped query isolation.

Fields

expected: Uuid

The expected workspace id configured for this engine.

found: Uuid

The unexpected workspace id returned by persistence.

InvalidBranchName(String)

Indicates a branch name failed strict path-safe validation.

BranchLimitExceeded

Indicates the workspace has reached its configured branch limit.

Database(Error)

Wraps SQLx database failures.

Migration(MigrateError)

Wraps SQLx migration failures.

Io(Error)

Wraps filesystem errors.

Serialization(Error)

Wraps JSON serialization errors.

BranchNotFound(Uuid)

Indicates a branch lookup failed.

BranchAlreadyExists(String)

Indicates a workspace already has a branch with the same logical name.

BranchNotActive

Indicates an operation requires an active branch.

Fields

id: Uuid

The branch identifier that failed the active-state check.

status: String

The current lifecycle status string for the branch.

SnapshotFailed

Indicates snapshot creation or restore failed.

Fields

branch_id: Uuid

The branch identifier associated with the snapshot failure.

reason: String

The human-readable failure reason.

SnapshotCorrupt

Indicates a snapshot file failed integrity validation.

Fields

branch_id: Uuid

The branch identifier associated with the corrupt snapshot.

path: PathBuf

The path to the corrupt snapshot file.

SnapshotHashMissing

Indicates a required snapshot hash sidecar file is missing.

Fields

branch_id: Uuid

The branch identifier associated with the missing hash sidecar.

path: PathBuf

The path to the expected sidecar hash file.

MergeConflictUnresolved

Indicates merge conflicts were not fully resolved.

Fields

entity_ids: Vec<String>

The entity identifiers that still have unresolved conflicts.

MergeIncompatibleBase

Indicates two branches cannot be merged with the selected base.

Fields

ours: Uuid

The local branch identifier.

theirs: Uuid

The incoming branch identifier.

reason: String

The reason the base is incompatible.

DagCycle

Indicates a lineage edge would create a DAG cycle.

Fields

from: Uuid

The proposed source branch id.

to: Uuid

The proposed destination branch id.

CycleDetected

Indicates a branch operation would introduce a lineage cycle.

Fields

from: Uuid

The proposed source branch id.

to: Uuid

The proposed destination branch id.

DagNodeNotFound(Uuid)

Indicates a DAG node lookup failed.

DiffFailed

Indicates diff extraction failed.

Fields

branch_a: Uuid

The first branch identifier in the failed diff.

branch_b: Uuid

The second branch identifier in the failed diff.

reason: String

The human-readable diff failure reason.

CommitValidationFailed

Indicates a selective commit failed validation.

Fields

branch_id: Uuid

The branch identifier whose commit was rejected.

violations: Vec<String>

The list of validation violations.

SandboxError(String)

Indicates sandbox execution failed.

MetricsError(String)

Indicates metrics handling failed.

NamingError(String)

Indicates a branch name failed validation.

OrphanedSnapshot(PathBuf)

Indicates an orphaned snapshot path was encountered.

Implementations

impl BranchError

pub fn is_not_found(&self) -> bool

Returns true if this error indicates a missing branch or DAG node.

pub fn is_merge_conflict(&self) -> bool

Returns true if this error represents an unresolved merge conflict.

pub fn is_snapshot_error(&self) -> bool

Returns true if this error belongs to the snapshot subsystem.

pub fn is_dag_error(&self) -> bool

Returns true if this error belongs to DAG management.

Trait Implementations

impl Debug for BranchError

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

Formats the value using the given formatter.

impl Display for BranchError

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

Formats the value using the given formatter.

impl Error for BranchError

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<BranchError> for BranchConfigError

fn from(source: BranchError) -> Self

Converts to this type from the input type.

impl From<Error> for BranchError

fn from(source: Error) -> Self

Converts to this type from the input type.

impl From<Error> for BranchError

fn from(source: Error) -> Self

Converts to this type from the input type.

impl From<Error> for BranchError

fn from(source: Error) -> Self

Converts to this type from the input type.

impl From<MigrateError> for BranchError

fn from(source: MigrateError) -> Self

Converts to this type from the input type.