Enum GitError 

pub enum GitError {
    WorktreeCreation {
        reason: String,
    },
    WorktreePathExists {
        path: PathBuf,
    },
    WorktreeNotFound {
        path: PathBuf,
    },
    MutationDenied {
        state: WorktreeState,
    },
    PathConfinementViolation {
        path: PathBuf,
        root: PathBuf,
    },
    DirtyWorktree {
        path: PathBuf,
    },
    DetachedHead {
        path: PathBuf,
    },
    InvalidGitIndirection {
        path: PathBuf,
    },
    CleanupBlocked {
        reason: String,
    },
    MergePrecheckFailed {
        reason: String,
    },
    TargetRefStale {
        expected: String,
        actual: String,
    },
    MergeConflict {
        count: usize,
    },
    HookRejected {
        hook: String,
        stderr: String,
    },
    MergeLockUnavailable {
        branch: String,
    },
    MergeVerifyFailed {
        reason: String,
    },
    InvalidMergeState {
        state: MergeState,
    },
    UninitializedSubmodule {
        path: String,
    },
    DirtySubmodule {
        path: String,
    },
    SubmodulePolicyViolation {
        path: String,
        reason: String,
    },
    ForbiddenOperation {
        operation: ForbiddenOp,
    },
    InterruptedOperation {
        operation: InterruptedOp,
        path: PathBuf,
    },
    RecoveryFailed {
        reason: String,
    },
    RefNotFound {
        refspec: String,
    },
    BranchAlreadyExists {
        branch: String,
    },
    CommandFailed {
        exit_code: i32,
        stderr: String,
    },
    Io(Error),
    Transition(TransitionError),
    Exec(ExecError),
}

Top-level error type for all git-plane operations.

Variants

WorktreeCreation

Failed to create a worktree (Section 12.2).

Fields

reason: String

WorktreePathExists

Worktree path already exists on disk.

Fields

path: PathBuf

WorktreeNotFound

Worktree not found at expected path.

Fields

path: PathBuf

MutationDenied

A command tried to mutate the repository from an invalid worktree state. Section 12.3: mutations denied in WtUnbound/WtClosed/WtCleanupPending.

Fields

state: WorktreeState

PathConfinementViolation

Path traversal outside worktree root detected (Section 12.3).

Fields

path: PathBuf

root: PathBuf

DirtyWorktree

The worktree has uncommitted changes when a clean state is required.

Fields

path: PathBuf

DetachedHead

Detached HEAD without explicit override policy (Section 12.3).

Fields

path: PathBuf

InvalidGitIndirection

The .git indirection file is missing or invalid (Section 12.2 step 5).

Fields

path: PathBuf

CleanupBlocked

Cleanup preconditions not met (Section 12.11).

Fields

reason: String

MergePrecheckFailed

Merge precheck failed (Section 12.6).

Fields

reason: String

TargetRefStale

Target ref moved since precheck — must restart (Section 12.8 step 2).

Fields

expected: String

actual: String

MergeConflict

Merge conflicts detected (Section 12.7, 12.9).

Fields

count: usize

HookRejected

A git hook rejected the merge commit (e.g. commit-msg, pre-commit). Distinct from MergeConflict — the merge content was clean but a hook blocked the commit.

Fields

hook: String

stderr: String

MergeLockUnavailable

Could not acquire merge lock for the target branch (Section 12.8).

Fields

branch: String

MergeVerifyFailed

Merge verification failed after apply (Section 12.8 step 4).

Fields

reason: String

InvalidMergeState

Merge operation attempted in an invalid merge state.

Fields

state: MergeState

UninitializedSubmodule

Uninitialized submodule detected before task start.

Fields

path: String

DirtySubmodule

Dirty submodule detected before merge.

Fields

path: String

SubmodulePolicyViolation

Submodule update violates the configured policy mode.

Fields

path: String

reason: String

ForbiddenOperation

A forbidden git operation was attempted without policy approval.

Fields

operation: ForbiddenOp

InterruptedOperation

An interrupted git operation was detected on recovery.

Fields

operation: InterruptedOp

path: PathBuf

RecoveryFailed

Recovery action failed.

Fields

reason: String

RefNotFound

A ref (branch/tag/sha) could not be resolved.

Fields

refspec: String

BranchAlreadyExists

Branch already exists when expecting to create a new one.

Fields

branch: String

CommandFailed

Git command returned a non-zero exit code.

Fields

exit_code: i32

stderr: String

Io(Error)

I/O error from filesystem or process operations.

Transition(TransitionError)

State transition error from yarli-core.

Exec(ExecError)

Exec error from yarli-exec command runner.

Trait Implementations

impl Debug for GitError

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

Formats the value using the given formatter.

impl Display for GitError

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

Formats the value using the given formatter.

impl Error for GitError

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<Error> for GitError

fn from(source: Error) -> Self

Converts to this type from the input type.

impl From<ExecError> for GitError

fn from(source: ExecError) -> Self

Converts to this type from the input type.

impl From<TransitionError> for GitError

fn from(source: TransitionError) -> Self

Converts to this type from the input type.