Enum VcsError 

pub enum VcsError {
    HashMismatch {
        expected: SnapshotId,
        actual: SnapshotId,
    },
    UncommittedChanges {
        count: usize,
    },
    InvalidSnapshotId(String),
    InvalidBranchName(String),
    InvalidRemoteName(String),
    Storage(String),
    Json(Error),
    Io(Error),
    Internal(String),
}

Errors that can occur in the khive VCS layer (snapshot hashing, NDJSON sync, remote fetch).

Variants

HashMismatch

The archive stored at the remote has a different hash than expected. Indicates corruption or tampering.

Fields

expected: SnapshotId

actual: SnapshotId

UncommittedChanges

checkout was blocked because there are uncommitted changes. Pass force: true to discard them.

Fields

count: usize

InvalidSnapshotId(String)

A SnapshotId string failed validation.

InvalidBranchName(String)

A branch name failed validation (must match ^[a-zA-Z0-9_-]{1,64}$).

InvalidRemoteName(String)

A remote name failed validation (must be a single path segment matching [A-Za-z0-9._-]+, and not . or ..). Rejected before any filesystem path is built from it, to prevent path traversal into .khive/kg/remotes/.

Storage(String)

An underlying storage operation failed.

Json(Error)

JSON serialization or deserialization failed.

Io(Error)

An I/O operation failed (file system).

Internal(String)

An unexpected internal error.

Trait Implementations

impl Debug for VcsError

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

Formats the value using the given formatter.

impl Display for VcsError

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

Formats the value using the given formatter.

impl Error for VcsError

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 VcsError

fn from(source: Error) -> Self

Converts to this type from the input type.

impl From<Error> for VcsError

fn from(source: Error) -> Self

Converts to this type from the input type.

impl From<RuntimeError> for VcsError

fn from(e: RuntimeError) -> Self

Converts to this type from the input type.