#!/bin/bash #============================================================================== # commit-msg hook # Conventional Commits 형식 검증 (한/영 혼용 지원) #============================================================================== COMMIT_MSG_FILE="$1" COMMIT_MSG=$(cat "$COMMIT_MSG_FILE") # Merge 커밋은 검증 건너뜀 if echo "$COMMIT_MSG" | head -1 | grep -qE "^Merge "; then exit 0 fi # Revert 커밋은 검증 건너뜀 if echo "$COMMIT_MSG" | head -1 | grep -qE "^Revert "; then exit 0 fi # Conventional Commits 정규식 # type(scope): subject # - type: feat|fix|docs|style|refactor|test|chore|ci|perf (필수) # - scope: 괄호 제외 모든 문자 허용 — 한/영/숫자/특수문자 (선택) # - subject: 1자 이상 (길이는 바이트 기반 별도 검증) PATTERN='^(feat|fix|docs|style|refactor|test|chore|ci|perf)(\([^)]+\))?: .+$' MAX_SUBJECT_BYTES=200 # UTF-8 한글(3byte) 허용: 72문자 ≈ 최대 216byte FIRST_LINE=$(head -1 "$COMMIT_MSG_FILE") if ! echo "$FIRST_LINE" | grep -qE "$PATTERN"; then echo "" echo "╔══════════════════════════════════════════════════════════════╗" echo "║ 커밋 메시지가 Conventional Commits 형식에 맞지 않습니다 ║" echo "╚══════════════════════════════════════════════════════════════╝" echo "" echo " 올바른 형식: type(scope): subject" echo "" echo " type (필수):" echo " feat — 새로운 기능" echo " fix — 버그 수정" echo " docs — 문서 변경" echo " style — 코드 포맷팅" echo " refactor — 리팩토링" echo " test — 테스트" echo " chore — 빌드/설정 변경" echo " ci — CI/CD 변경" echo " perf — 성능 개선" echo "" echo " scope (선택): 한/영 모두 가능" echo " subject (필수): 1~72자, 한/영 모두 가능" echo "" echo " 예시:" echo " feat(auth): JWT 기반 로그인 구현" echo " fix(배치): 야간 배치 타임아웃 수정" echo " docs: README 업데이트" echo " chore: Gradle 의존성 업데이트" echo "" echo " 현재 메시지: $FIRST_LINE" echo "" exit 1 fi # 길이 검증 (바이트 기반 — UTF-8 한글 허용) MSG_LEN=$(echo -n "$FIRST_LINE" | wc -c | tr -d ' ') if [ "$MSG_LEN" -gt "$MAX_SUBJECT_BYTES" ]; then echo "" echo " ✗ 커밋 메시지가 너무 깁니다 (${MSG_LEN}바이트, 최대 ${MAX_SUBJECT_BYTES})" echo " 현재 메시지: $FIRST_LINE" echo "" exit 1 fi