Enum Error 

pub enum Error {
    AlreadyExists {
        path: PathBuf,
    },
    NotAGitRepo {
        path: PathBuf,
    },
    InvalidRunId {
        run_id: String,
    },
    PathTooLong {
        path: PathBuf,
        length: usize,
        limit: usize,
    },
    Io {
        source: Error,
    },
    GitTimeout {
        args: Vec<String>,
        elapsed: Duration,
    },
    GitCommandFailed {
        args: Vec<String>,
        stderr: String,
    },
}

Variants

AlreadyExists

The target worktree directory already exists on disk, or git worktree add reported an existing path. Raised both from the pre-spawn exists() check and from the stderr classifier so a TOCTOU race between the two calls still surfaces as AlreadyExists rather than a generic GitCommandFailed.

Fields

path: PathBuf

NotAGitRepo

The volume root is not inside a git repository (or cannot reach .git). Plan-mandated preflight for omne run.

Fields

path: PathBuf

InvalidRunId

run_id contains characters that would let the worktree path escape .omne/wt/ (path separators, .., null, leading -). Raised before any filesystem or git call so no partial state leaks on rejection.

Fields

run_id: String

PathTooLong

Volume path is at or above PATH_LENGTH_ERROR characters. Windows-only concern in practice, but the threshold is platform-agnostic so tests behave the same on every host.

Note: this threshold measures the volume root only. Pipelines that write deeply-nested files inside the worktree can still blow past MAX_PATH even when the volume root passes preflight. The threshold exists to catch the most common failure mode (long user-profile paths), not to guarantee every downstream file operation stays under 260.

Fields

path: PathBuf

length: usize

limit: usize

Io

git could not be launched (missing binary, permission denied, etc). Distinct from GitCommandFailed (which is git itself returning non-zero).

Fields

source: Error

GitTimeout

git ran past GIT_TIMEOUT without exiting. The child is killed before this error is returned so no zombie subprocess leaks.

Fields

args: Vec<String>

elapsed: Duration

GitCommandFailed

git ran but exited non-zero. stderr is preserved verbatim for the command handler to surface.

Fields

args: Vec<String>

stderr: String

Trait Implementations

impl Debug for Error

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

Formats the value using the given formatter.

impl Display for Error

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

Formats the value using the given formatter.

impl Error for Error

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 CliError

fn from(source: Error) -> Self

Converts to this type from the input type.