Skip to content

Self-evolving Context Database for AI Agents. Unify Agent Memory, Knowledge RAG and Skills.

7.1 KB
Raw Blame
//! Git module error types

use thiserror::Error;

/// Errors from ObjectStore operations
#[derive(Debug, Error)]
pub enum ObjectStoreError {
    /// Object not found
    #[error("object not found: {0}")]
    NotFound(gix_hash::ObjectId),

    /// I/O error
    #[error("i/o error: {0}")]
    Io(#[from] std::io::Error),

    /// Zlib decompression error
    #[error("zlib error: {0}")]
    Zlib(String),

    /// ObjectId mismatch (content integrity check failed)
    #[error("oid mismatch: expected {expected}, got {actual}")]
    OidMismatch {
        expected: gix_hash::ObjectId,
        actual: gix_hash::ObjectId,
    },

    /// Backend-specific error
    #[error("backend error: {0}")]
    Backend(String),

    /// Object retrieval exceeded the caller-provided byte budget.
    #[error("object read limit exceeded: {size} bytes exceeds limit {limit} bytes")]
    ReadLimitExceeded {
        /// Number of bytes observed or declared by the object.
        size: u64,
        /// Maximum number of bytes permitted by the caller.
        limit: u64,
    },
}

/// Errors from RefStore operations
#[derive(Debug, Error)]
pub enum RefStoreError {
    /// Ref not found
    #[error("ref not found: {0}")]
    NotFound(String),

    /// CAS conflict - expected value didn't match actual
    #[error("cas conflict: expected {expected:?}, actual {actual:?}")]
    Conflict {
        expected: Option<gix_hash::ObjectId>,
        actual: Option<gix_hash::ObjectId>,
    },

    /// Invalid ref name (failed validation)
    #[error("invalid ref name: {0}")]
    InvalidName(String),

    /// I/O error
    #[error("i/o error: {0}")]
    Io(#[from] std::io::Error),

    /// Backend-specific error
    #[error("backend error: {0}")]
    Backend(String),
}

/// Top-level Git service error
#[derive(Debug, Error)]
pub enum GitError {
    /// ObjectStore error
    #[error("object store error: {0}")]
    ObjectStore(#[from] ObjectStoreError),

    /// RefStore error
    #[error("ref store error: {0}")]
    RefStore(#[from] RefStoreError),

    /// Path not found in tree
    #[error("path not found in tree: {0}")]
    PathNotFound(String),

    /// Path exists in tree but resolves to a directory (tree), not a blob.
    /// Returned by `show()` when the caller asked for blob bytes at a path
    /// that turned out to be a subdirectory.
    #[error("path is a directory, not a file: {0}")]
    PathIsDirectory(String),

    /// `project_dir` is an empty / malformed path string.
    /// Same validation as `TreeEditor::upsert`: must be non-empty, no leading
    /// or trailing `/`, no empty components, no `.` / `..` / backslash /
    /// control char components.
    #[error("invalid project_dir: {0}")]
    InvalidProjectDir(String),

    /// A user-supplied relative path in `CommitRequest.paths` or
    /// `ShowRequest.path` failed validation. The Rust GitService is a native
    /// boundary (PyO3 bindings, future SDK callers), so it cannot rely on
    /// upstream HTTP / SDK layers to have already normalized away `..` /
    /// `\` / control chars. Rejected before any VFS or object-store I/O.
    #[error("invalid path: {0}")]
    InvalidPath(String),

    /// The requested `project_dir` does not resolve to a subtree in the
    /// referenced commit's tree (either the path is missing entirely or it
    /// resolves to a blob rather than a tree).
    #[error("project_dir {project_dir:?} not found as a subtree in commit {commit}")]
    SubtreeNotFoundInCommit {
        project_dir: String,
        commit: gix_hash::ObjectId,
    },

    /// Invalid account ID
    #[error("invalid account id: {0}")]
    InvalidAccountId(String),

    /// Concurrent commit conflict
    #[error("concurrent commit: ref {ref_name} changed during commit (expected {expected:?}, actual {actual:?})")]
    ConcurrentCommit {
        ref_name: String,
        expected: Option<gix_hash::ObjectId>,
        actual: Option<gix_hash::ObjectId>,
    },

    /// `restore()` advanced the branch ref to the new commit, but at least
    /// one per-path VFS write or delete failed afterwards. The branch ref
    /// already points at `new_commit_oid`; the caller must use the payload
    /// to drive reindex of the paths that did reach the VFS and report the
    /// failures to whoever needs to retry them.
    #[error(
        "restore writeback partial: {writes_failed} write(s) and {deletes_failed} delete(s) failed after ref advanced to {new_commit}",
        writes_failed = .0.failed_writes.len(),
        deletes_failed = .0.failed_deletes.len(),
        new_commit = .0.new_commit_oid,
    )]
    RestoreWritebackPartial(Box<crate::git::types::RestoreWritebackPartial>),

    /// Blob too large
    #[error("blob too large: {size} bytes exceeds limit {limit} bytes")]
    BlobTooLarge { size: u64, limit: u64 },

    /// Too many files in commit
    #[error("too many files: {count} exceeds limit {limit}")]
    TooManyFiles { count: usize, limit: usize },

    /// Too many unique paths in a filtered log request.
    #[error("too many log filter paths: {count} exceeds limit {limit}")]
    TooManyLogPaths { count: usize, limit: usize },

    /// A filtered log path has too many tree components.
    #[error("log filter path {path:?} has depth {depth}, exceeds limit {limit}")]
    LogPathTooDeep {
        path: String,
        depth: usize,
        limit: usize,
    },

    /// Filtered history still has uninspected commits after its scan budget.
    #[error(
        "snapshot log scan limit exceeded: scanned {scanned}/{max_scanned} commits, matched {matched}/{requested}"
    )]
    LogScanLimitExceeded {
        scanned: usize,
        max_scanned: usize,
        matched: usize,
        requested: usize,
    },

    /// `.ovgitignore` exceeds the configured size limit.
    #[error("ignore file too large: {path} is {size} bytes, limit {max} bytes")]
    IgnoreFileTooLarge {
        /// Account-relative path of the offending file.
        path: String,
        /// Observed size in bytes.
        size: u64,
        /// Configured maximum size in bytes.
        max: u64,
    },

    /// `.ovgitignore` is syntactically invalid or cannot be decoded.
    #[error("invalid ignore file {path}: {reason}")]
    InvalidIgnoreFile {
        /// Account-relative path of the offending file.
        path: String,
        /// Human-readable explanation of why parsing failed.
        reason: String,
    },

    /// Feature not enabled
    #[error("git feature not enabled")]
    FeatureDisabled,

    /// Corrupted object
    #[error("corrupted object: {0}")]
    CorruptedObject(String),

    /// No object matched the abbreviated OID prefix
    #[error("no commit found matching OID prefix {prefix}")]
    OidPrefixNotFound { prefix: String },

    /// Multiple objects matched the abbreviated OID prefix
    #[error("ambiguous OID prefix {prefix} matches {count} commits: {candidates}")]
    AmbiguousOid {
        prefix: String,
        count: usize,
        candidates: String,
    },

    /// Other error
    #[error("{0}")]
    Other(String),

    /// Vfs error wrapper
    #[error("vfs: {0}")]
    Vfs(String),
}

impl From<crate::core::errors::Error> for GitError {
    fn from(e: crate::core::errors::Error) -> Self {
        GitError::Vfs(e.to_string())
    }
}