git-claw 0.3.3

Deterministic git worktree orchestration engine for developers and AI agents
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70

//! Infrastructure error types.

use thiserror::Error;

#[derive(Error, Debug)]
pub enum GitError {
    #[error("Not a git repository (or any of the parent directories)")]
    NotAGitRepository,

    #[error("Git command failed ({command}): {message}")]
    CommandFailed { command: String, message: String },

    #[error("Failed to execute git process: {0}")]
    ProcessFailed(#[from] std::io::Error),
}

#[derive(Error, Debug, PartialEq, Eq)]
pub enum LockError {
    #[error("Timed out waiting to acquire advisory lock at '{path}' after {timeout_secs}s")]
    Timeout { path: String, timeout_secs: u64 },

    #[error("Failed to open or create lock file at '{path}': {message}")]
    IoError { path: String, message: String },
}

#[derive(Error, Debug)]
pub enum RegistryError {
    #[error("Failed to read registry at '{path}': {source}")]
    IoError {
        path: String,
        #[source]
        source: std::io::Error,
    },

    #[error("Failed to parse registry JSON at '{path}': {source}")]
    JsonError {
        path: String,
        #[source]
        source: serde_json::Error,
    },
}

#[derive(Error, Debug)]
pub enum WorktreeError {
    #[error("Failed to create worktree at '{path}': {message}")]
    CreationFailed { path: String, message: String },

    #[error("Failed to remove worktree at '{path}': {message}")]
    RemovalFailed { path: String, message: String },

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

    #[error("Worktree directory already exists: '{0}'")]
    DirectoryAlreadyExists(String),

    #[error("I/O error during worktree operation: {0}")]
    IoError(#[from] std::io::Error),
}

#[derive(Error, Debug)]
pub enum HookError {
    #[error("Hook execution failed: {0}")]
    ExecutionFailed(String),

    #[error(
        "Pre-finish hook '{hook}' failed with exit code {code}; aborting (use --force to override)"
    )]
    PreFinishFailed { hook: String, code: i32 },
}