git-workflow 0.8.1

Git guardrails for AI coding agents - safe git workflows with clear state feedback
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
71
72

//! Working directory state

use crate::git;

/// State of the working directory
#[derive(Debug, Clone, PartialEq, Eq)]
pub enum WorkingDirState {
    /// No uncommitted changes and no untracked files
    Clean,
    /// Has unstaged changes only
    HasUnstagedChanges,
    /// Has staged changes only
    HasStagedChanges,
    /// Has both staged and unstaged changes
    HasMixedChanges,
    /// Has untracked files only (no staged or unstaged tracked changes)
    HasUntrackedFiles,
}

impl WorkingDirState {
    /// Detect the current working directory state
    ///
    /// Untracked files count as "not clean": leaving them out caused `gw pause`
    /// to skip the WIP commit (and switch home) when the only work was new,
    /// unstaged files — silently leaving them behind. Tracked changes take
    /// precedence for the description; untracked-only maps to `HasUntrackedFiles`.
    pub fn detect() -> Self {
        let has_unstaged = git::has_unstaged_changes();
        let has_staged = git::has_staged_changes();
        let has_untracked = git::has_untracked_files();

        match (has_unstaged, has_staged) {
            (true, true) => WorkingDirState::HasMixedChanges,
            (true, false) => WorkingDirState::HasUnstagedChanges,
            (false, true) => WorkingDirState::HasStagedChanges,
            (false, false) => {
                if has_untracked {
                    WorkingDirState::HasUntrackedFiles
                } else {
                    WorkingDirState::Clean
                }
            }
        }
    }

    /// Check if the working directory is clean (no tracked changes, no untracked files)
    pub fn is_clean(&self) -> bool {
        matches!(self, WorkingDirState::Clean)
    }

    /// Whether there are tracked changes (staged and/or unstaged), ignoring
    /// untracked files.
    pub fn has_tracked_changes(&self) -> bool {
        matches!(
            self,
            WorkingDirState::HasUnstagedChanges
                | WorkingDirState::HasStagedChanges
                | WorkingDirState::HasMixedChanges
        )
    }

    /// Get a human-readable description
    pub fn description(&self) -> &'static str {
        match self {
            WorkingDirState::Clean => "clean",
            WorkingDirState::HasUnstagedChanges => "has unstaged changes",
            WorkingDirState::HasStagedChanges => "has staged changes",
            WorkingDirState::HasMixedChanges => "has staged and unstaged changes",
            WorkingDirState::HasUntrackedFiles => "has untracked files",
        }
    }
}