git-commit-msg

#!/usr/bin/env bash
#
# git commit-msg hook: reject a commit whose message isn't a valid Conventional Commit.
#
# Install:
#   cp examples/git-commit-msg .git/hooks/commit-msg
#   chmod +x .git/hooks/commit-msg
#
# Git passes the path to the message file as $1 (usually .git/COMMIT_EDITMSG).
# commit-lint.js strips git's `#` comment lines and the verbose scissors section itself,
# so pointing straight at it is safe. Only error-level problems (bad type, malformed
# header, missing blank line) block the commit — length/style warnings do not.
# Bypass once with `git commit --no-verify` if you must.
#
# Assumes commit-lint.js is at the repo root. Change SCRIPTS_DIR if it lives elsewhere.

set -euo pipefail

SCRIPTS_DIR="${SCRIPTS_DIR:-$(git rev-parse --show-toplevel)}"
MSG_FILE="$1"

if ! node "$SCRIPTS_DIR/commit-lint.js" "$MSG_FILE"; then
  echo "✗ Commit message isn't a valid Conventional Commit — commit blocked."
  echo "  Format: type(scope)?: description   e.g.  feat(auth): add token refresh"
  echo "  Bypass once with 'git commit --no-verify' if you really must."
  exit 1
fi