74 lines
3.3 KiB
Bash
Executable File
74 lines
3.3 KiB
Bash
Executable File
#!/usr/bin/env bash
|
||
# Stop hook — ヘルプ／更新履歴の更新もれを知らせる（警告のみ・非ブロック）。
|
||
#
|
||
# フィーチャーブランチに「ユーザー向けのコード変更」が commit 済みなのに、
|
||
# ヘルプ (ui/src/content/help/) と更新履歴 (00-changelog.md) が未更新のとき、
|
||
# 目に見える警告を 1 つ出すだけ。作業はブロックしない（更新するかは開発者が判断）。
|
||
#
|
||
# 設計メモ:
|
||
# - main/master では何もしない（トランク自体には enforce しない）
|
||
# - 判定は base ブランチとの "commit 済み差分" のみ。編集途中（未コミット）では黙る
|
||
# - ヒューリスティックなので、内部リファクタ等で誤検知したら無視してよい
|
||
|
||
# `set -e` は使わない（[ ... ] && exit の評価で意図せず抜けるのを避けるため）。
|
||
|
||
ROOT="$(cd "$(dirname "${BASH_SOURCE[0]}")/.." 2>/dev/null && pwd)"
|
||
[ -n "$ROOT" ] || exit 0
|
||
cd "$ROOT" 2>/dev/null || exit 0
|
||
|
||
git rev-parse --is-inside-work-tree >/dev/null 2>&1 || exit 0
|
||
|
||
BRANCH="$(git rev-parse --abbrev-ref HEAD 2>/dev/null)"
|
||
case "$BRANCH" in
|
||
main|master|HEAD|"") exit 0 ;;
|
||
esac
|
||
|
||
# 差分の基準ブランチを決める。
|
||
BASE=""
|
||
for ref in origin/main main origin/master master; do
|
||
if git rev-parse --verify --quiet "$ref" >/dev/null 2>&1; then
|
||
BASE="$ref"
|
||
break
|
||
fi
|
||
done
|
||
[ -n "$BASE" ] || exit 0
|
||
|
||
# このブランチが base に対して触ったファイル（commit 済みのみ）。
|
||
CHANGED="$(git diff --name-only "$BASE"...HEAD 2>/dev/null)"
|
||
[ -n "$CHANGED" ] || exit 0
|
||
|
||
CHANGELOG="ui/src/content/help/00-changelog.md"
|
||
|
||
changelog_touched=0
|
||
user_facing=0
|
||
while IFS= read -r f; do
|
||
[ -n "$f" ] || continue
|
||
case "$f" in
|
||
"$CHANGELOG") changelog_touched=1 ;;
|
||
esac
|
||
case "$f" in
|
||
*.test.ts|*.test.tsx|*.spec.ts) ;; # テストは対象外
|
||
ui/src/content/help/*) ;; # ヘルプ本文そのものは対象外
|
||
ui/src/i18n/*) ;; # 文言だけの変更は対象外
|
||
ui/src/*|src/*|pieces/*) user_facing=1 ;; # ユーザーに影響しうるコード
|
||
esac
|
||
done <<< "$CHANGED"
|
||
|
||
# ユーザー向け変更が無い、または更新履歴を既に更新済みなら何も言わない。
|
||
[ "$user_facing" -eq 1 ] || exit 0
|
||
[ "$changelog_touched" -eq 0 ] || exit 0
|
||
|
||
MSG="📝 ヘルプ未更新のお知らせ: ブランチ '${BRANCH}' に機能コードの変更がありますが、更新履歴 (${CHANGELOG}) は未更新です。ユーザー向けの変更なら、該当するヘルプ (ui/src/content/help/*.md) と更新履歴に追記してください。内部リファクタ等で不要なら無視して構いません。"
|
||
|
||
# 可視の警告として出すだけ（decision を設定しないので stop はブロックしない）。
|
||
# Stop フックは stdout の JSON `systemMessage` のみを画面に出す（stderr は出ない）ため、
|
||
# 必ず stdout に JSON を書く。
|
||
if command -v python3 >/dev/null 2>&1; then
|
||
printf '{"systemMessage": %s}\n' "$(MSG="$MSG" python3 -c 'import json,os; print(json.dumps(os.environ["MSG"]))')"
|
||
else
|
||
# python3 が無い環境向けフォールバック。" と \ を手でエスケープして stdout に出す。
|
||
esc="$(printf '%s' "$MSG" | sed 's/\\/\\\\/g; s/"/\\"/g')"
|
||
printf '{"systemMessage": "%s"}\n' "$esc"
|
||
fi
|
||
exit 0
|