beads/examples/git-hooks/pre-push at main · objectiveous/beads · GitHub

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
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
#!/usr/bin/env sh
# bd-hooks-version: 0.22.2
#
# bd (beads) pre-push hook
#
# This hook prevents pushing stale JSONL by:
# 1. Flushing any pending in-memory changes to JSONL (if bd available)
# 2. Checking for uncommitted changes (staged, unstaged, untracked, deleted)
# 3. Failing the push with clear instructions if changes found
#
# When sync-branch is configured in config.yaml, .beads changes are committed
# to a separate branch via worktree, so the uncommitted check is skipped.
#
# The pre-commit hook already exports changes, but this catches:
# - Changes made between commit and push
# - Pending debounced flushes (5s daemon delay)
#
# Installation:
#   cp examples/git-hooks/pre-push .git/hooks/pre-push
#   chmod +x .git/hooks/pre-push
#
# Or use the install script:
#   examples/git-hooks/install.sh

# Check if we're in a bd workspace
if [ ! -d .beads ]; then
    # Not a bd workspace, nothing to do
    exit 0
fi

# Skip if bd sync is already in progress (GH#532: prevents circular error)
# bd sync sets this env var when pushing from worktree
if [ -n "$BD_SYNC_IN_PROGRESS" ]; then
    exit 0
fi

# Check if sync-branch is configured in config.yaml or env var
# If so, .beads changes go to a separate branch via worktree, not the current branch
SYNC_BRANCH="${BEADS_SYNC_BRANCH:-}"
if [ -z "$SYNC_BRANCH" ] && [ -f .beads/config.yaml ]; then
    # Extract sync-branch value from YAML (handles quoted and unquoted values)
    # Use head -1 to only take first match if file is malformed
    SYNC_BRANCH=$(grep -E '^sync-branch:' .beads/config.yaml 2>/dev/null | head -1 | sed 's/^sync-branch:[[:space:]]*//' | sed 's/^["'"'"']//' | sed 's/["'"'"']$//')
fi
if [ -n "$SYNC_BRANCH" ]; then
    # sync-branch is configured, skip .beads uncommitted check
    # Changes are synced to the separate branch, not this one
    exit 0
fi

# Optionally flush pending bd changes so they surface in JSONL
# This prevents the race where a debounced flush lands after the check
if command -v bd >/dev/null 2>&1; then
    bd sync --flush-only >/dev/null 2>&1 || true
fi

# Collect all tracked or existing JSONL files (beads.jsonl, issues.jsonl for backward compat, deletions.jsonl for deletion propagation)
FILES=""
for f in .beads/beads.jsonl .beads/issues.jsonl .beads/deletions.jsonl; do
    # Include file if it exists in working tree OR is tracked by git (even if deleted)
    if git ls-files --error-unmatch "$f" >/dev/null 2>&1 || [ -f "$f" ]; then
        FILES="$FILES $f"
    fi
done

# Check for any uncommitted changes using porcelain status
# This catches: staged, unstaged, untracked, deleted, renamed, and conflicts
if [ -n "$FILES" ]; then
    # shellcheck disable=SC2086
    if [ -n "$(git status --porcelain -- $FILES 2>/dev/null)" ]; then
        echo "❌ Error: Uncommitted changes detected" >&2
        echo "" >&2
        echo "Before pushing, ensure all changes are committed. This includes:" >&2
        echo "  • bd JSONL updates (run 'bd sync')" >&2
        echo "  • any other modified files (run 'git status' to review)" >&2
        echo "" >&2

        # Check if bd is available and offer auto-sync
        if command -v bd >/dev/null 2>&1; then
            # Check if we're in an interactive terminal
            if [ -t 0 ]; then
                echo "Would you like to run 'bd sync' now to commit and push these changes? [y/N]" >&2
                read -r response
                case "$response" in
                    [yY][eE][sS]|[yY])
                        echo "" >&2
                        echo "Running: bd sync" >&2
                        if bd sync; then
                            echo "" >&2
                            echo "✓ Sync complete. Continuing with push..." >&2
                            exit 0
                        else
                            echo "" >&2
                            echo "❌ Sync failed. Push aborted." >&2
                            exit 1
                        fi
                        ;;
                    *)
                        echo "" >&2
                        echo "Push aborted. Run 'bd sync' manually when ready:" >&2
                        echo "" >&2
                        echo "  bd sync" >&2
                        echo "  git push" >&2
                        echo "" >&2
                        exit 1
                        ;;
                esac
            else
                # Non-interactive: just show the message
                echo "Run 'bd sync' to commit these changes:" >&2
                echo "" >&2
                echo "  bd sync" >&2
                echo "" >&2
                exit 1
            fi
        else
            # bd not available, fall back to manual git commands
            echo "Please commit the updated JSONL before pushing:" >&2
            echo "" >&2
            # shellcheck disable=SC2086
            echo "  git add $FILES" >&2
            echo '  git commit -m "Update bd JSONL"' >&2
            echo "  git push" >&2
            echo "" >&2
            exit 1
        fi
    fi
fi

exit 0