#!/usr/bin/env bash # Install git hooks for the Headroom repo: # 1. pre-commit — repo pre-commit checks (ruff, mypy, sync-plugin-versions) # 2. commit-msg — conventional-commit enforcement via commitlint # 3. pre-push — full ci-precheck (cargo fmt/clippy/test + python suite) # # Why pre-push was added: the 2026-04-27 push hit five CI failures that could # all have been caught locally — cargo fmt drift, an x86_64-apple-darwin wheel # that the project doesn't actually need, missing Rust extension in two CI # lanes, and a commitlint warning treated as an error. # # Why pre-commit was added: PR #772 merged with inline-comment spacing and # import-order violations because the ruff pre-commit hook in # .pre-commit-config.yaml was never installed for contributors. # # Idempotent. Re-running is safe. Exits with an error when run outside a git # checkout. Works from linked worktrees too: there `.git` is a file, so the # hooks directory is resolved through git rather than assumed to be # `.git/hooks/`. set -euo pipefail cd "$(dirname "$0")/.." # Install only into the checkout this script belongs to. A source copy nested # inside another repository would otherwise resolve that repository's hooks. if [[ "$(git rev-parse --show-toplevel 2>/dev/null)" != "$(pwd -P)" ]]; then echo "error: $(pwd -P) is not the root of a git checkout — run from a Headroom git checkout" >&2 exit 1 fi # Ask git for the effective hooks directory. In a linked worktree `.git` is a # file and hooks live in the shared common dir, so `.git/hooks` doesn't exist. HOOKS_DIR="$(git rev-parse --git-path hooks)" mkdir -p "$HOOKS_DIR" if ! command -v npx &>/dev/null; then echo "error: npx not found — install Node 18+ before installing Headroom's git hooks." >&2 exit 1 fi HOOK_PATH="$HOOKS_DIR/pre-push" cat > "$HOOK_PATH" <<'HOOK_EOF' #!/usr/bin/env bash # Headroom pre-push hook — runs `make ci-precheck` so CI never finds a # bug a local check could have caught. # # Skip with: `git push --no-verify`. Use sparingly — every skip is a roll # of the dice on a CI break. set -euo pipefail remote="$1" url="$2" # git passes one line per ref on stdin. An all-zero local sha is a delete # (`git push --delete`): it sends no commits, so there is nothing to check. has_update=0 while IFS=' ' read -r local_ref local_sha remote_ref remote_sha; do if [[ "$local_sha" =~ ^0+$ ]]; then continue fi has_update=1 echo "── pre-push: running 'make ci-precheck' before pushing $local_ref → $remote_ref" done if [[ "$has_update" -eq 0 ]]; then exit 0 fi if [[ -z "${VIRTUAL_ENV:-}" ]]; then if [[ -f .venv/bin/activate ]]; then # shellcheck disable=SC1091 source .venv/bin/activate else echo "warn: no VIRTUAL_ENV set and no .venv/ found — python checks may use the wrong interpreter" >&2 fi fi if make ci-precheck; then exit 0 else echo "" echo "❌ pre-push: 'make ci-precheck' failed. Fix the issues above before pushing." echo " To bypass (NOT recommended): git push --no-verify" exit 1 fi HOOK_EOF chmod +x "$HOOK_PATH" echo "✅ installed: $HOOK_PATH" echo " Runs 'make ci-precheck' before every git push." echo " Bypass (use sparingly): git push --no-verify" # Install pre-commit hooks (repo checks on every commit). # Prefer the project venv over a global install so contributors always run the # pinned version. Resolution order: active $VIRTUAL_ENV → .venv → global PATH. PRE_COMMIT_BIN="" if [[ -n "${VIRTUAL_ENV:-}" && -x "${VIRTUAL_ENV}/bin/pre-commit" ]]; then PRE_COMMIT_BIN="${VIRTUAL_ENV}/bin/pre-commit" elif [[ -x .venv/bin/pre-commit ]]; then PRE_COMMIT_BIN=".venv/bin/pre-commit" elif command -v pre-commit &>/dev/null; then PRE_COMMIT_BIN="pre-commit" fi if [[ -n "$PRE_COMMIT_BIN" ]]; then "$PRE_COMMIT_BIN" install "$PRE_COMMIT_BIN" install --hook-type commit-msg echo "✅ installed: $HOOKS_DIR/pre-commit (repo pre-commit checks via pre-commit)" echo "✅ installed: $HOOKS_DIR/commit-msg (conventional commit enforcement via commitlint)" else echo "error: pre-commit not found — run 'pip install -e .[dev]' first, then re-run this script." >&2 exit 1 fi