#!/bin/sh # bd-hooks-version: 0.30.0 # # bd (beads) pre-commit hook # # This hook ensures that any pending bd issue changes are flushed to # .beads/issues.jsonl before the commit is created, preventing the # race condition where daemon auto-flush fires after the commit. # # When sync-branch is configured in config.yaml, .beads changes are committed # to a separate branch via worktree, so auto-staging is skipped. # # Installation: # cp examples/git-hooks/pre-commit .git/hooks/pre-commit # chmod +x .git/hooks/pre-commit # # Or use the install script: # examples/git-hooks/install.sh # Check if bd is available if ! command -v bd >/dev/null 2>&1; then echo "Warning: bd command not found, skipping pre-commit flush" >&2 exit 0 fi # Check if we're in a bd workspace if [ ! -d .beads ]; then # Not a bd workspace, nothing to do 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 flush and auto-staging # Changes are synced to the separate branch via 'bd sync' exit 0 fi # Flush pending changes to JSONL # Use --flush-only to skip git operations (we're already in a git hook) # Suppress output unless there's an error # Note: We warn but don't fail - this allows commits to proceed even if # beads has issues (e.g., user removed .beads from their branch) if ! bd sync --flush-only >/dev/null 2>&1; then echo "Warning: Failed to flush bd changes to JSONL" >&2 echo "Run 'bd sync --flush-only' manually to diagnose" >&2 # Don't block the commit - user may have removed beads or have other issues fi # Stage all tracked JSONL files (beads.jsonl, issues.jsonl for backward compat, deletions.jsonl for deletion propagation) # git add is harmless if file doesn't exist for f in .beads/beads.jsonl .beads/issues.jsonl .beads/deletions.jsonl; do [ -f "$f" ] && git add "$f" 2>/dev/null || true done exit 0