git-workflow 0.8.1

//! Custom error types for gw CLI

use thiserror::Error;

/// Result type alias for gw operations
pub type Result<T> = std::result::Result<T, GwError>;

/// Custom error type for gw CLI
#[derive(Error, Debug)]
pub enum GwError {
    #[error("Not in a git repository")]
    NotAGitRepository,

    #[error("Git command failed: {0}")]
    GitCommandFailed(String),

    #[error("Cannot switch to '{branch}' because it is checked out in another worktree{}", .path.as_deref().map(|p| format!(" ({p})")).unwrap_or_default())]
    BranchCheckedOutElsewhere {
        branch: String,
        path: Option<String>,
    },

    #[error("Branch '{0}' already exists")]
    BranchAlreadyExists(String),

    #[error("Branch '{0}' does not exist")]
    BranchNotFound(String),

    #[error("Cannot delete protected branch: {0}")]
    ProtectedBranch(String),

    #[error("Uncommitted changes detected. Commit or stash them first.")]
    UncommittedChanges,

    #[error("Branch '{0}' has {1} unpushed commit(s)")]
    UnpushedCommits(String, usize),

    #[error("Already on home branch '{0}'. Specify a branch to delete.")]
    AlreadyOnHomeBranch(String),

    #[error("Branch name is required")]
    BranchNameRequired,

    #[error("IO error: {0}")]
    Io(#[from] std::io::Error),

    #[error("Cannot undo: no commits to undo (initial commit or empty history)")]
    NothingToUndo,

    #[error("Worktree pool is not initialized. Run `gw worktree pool warm <n>` first.")]
    PoolNotInitialized,

    #[error("No available worktrees in the pool. Run `gw worktree pool warm <n>` to add more.")]
    PoolExhausted,

    #[error("Pool has {0} acquired worktree(s). Release them first or use --force.")]
    PoolHasAcquiredWorktrees(usize),

    #[error("No acquired worktrees to release. Nothing to do.")]
    PoolNoneAcquired,

    #[error("Worktree '{0}' not found in pool")]
    PoolWorktreeNotFound(String),

    #[error("Worktree '{0}' is not acquired")]
    PoolWorktreeNotAcquired(String),

    #[error("Worktree '{name}' is not in a clean state to return to the pool: {reason}")]
    PoolWorktreeDirty { name: String, reason: String },

    #[error(
        "No clean worktree available to acquire (all available worktrees are dirty). \
         Inspect them, then run `gw worktree pool drain --force` and `gw worktree pool warm <n>`."
    )]
    PoolNoCleanWorktree,

    #[error("Could not acquire pool lock within timeout")]
    PoolLockTimeout,

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