da0f2cb42b
10 hooks get 21-line guard block: env-var short-circuit, 4 profiles (full/advisory-off/minimal/off), per-hook disable. Safety-critical preserved in 'minimal': no-hand-edit-agents, assemble-validate, git-pre-commit-genesis. Advisory off list: recurrence-suggest, citation-verify, error-spike-detector, milestone-commit-hook. skills/hooks-control/SKILL.md — click-only toggle emitting shell export commands. README +27 LOC 'Runtime hook controls' section with examples.
81 lines
2.4 KiB
Bash
Executable file
81 lines
2.4 KiB
Bash
Executable file
#!/bin/sh
|
|
# milestone-commit-hook.sh — PostToolUse:Bash hook (RULE 0.14).
|
|
#
|
|
# On `git commit -m "feat..."` / `refactor:` / `git merge`: call
|
|
# `kei-memory analyze --last 1 --summary` and append to audit-backlog.md.
|
|
# NEVER blocks: every exit path is `exit 0`. Silent-first: prompts only
|
|
# activate after 10 sessions are in the memory store.
|
|
|
|
command -v jq >/dev/null 2>&1 || exit 0
|
|
|
|
# --- RUNTIME CONTROLS (v0.14.2) ---
|
|
_hook_name="$(basename "$0" .sh)"
|
|
case "${KEI_DISABLED_HOOKS:-}" in
|
|
*"$_hook_name"*|*all*) exit 0 ;;
|
|
esac
|
|
case "${KEI_HOOK_PROFILE:-full}" in
|
|
off) exit 0 ;;
|
|
minimal)
|
|
case "$_hook_name" in
|
|
no-github-push|genesis-leak-guard|no-hand-edit-agents|secrets-guard|assemble-validate|git-pre-commit-genesis) ;;
|
|
*) exit 0 ;;
|
|
esac
|
|
;;
|
|
advisory-off)
|
|
case "$_hook_name" in
|
|
recurrence-suggest|citation-verify|error-spike-detector|milestone-commit-hook) exit 0 ;;
|
|
esac
|
|
;;
|
|
full|*) ;;
|
|
esac
|
|
# --- end runtime controls ---
|
|
|
|
set -eu
|
|
|
|
input="$(cat)"
|
|
|
|
cmd=$(printf '%s' "$input" | jq -r '.tool_input.command // empty' 2>/dev/null || true)
|
|
[ -z "$cmd" ] && exit 0
|
|
|
|
# Detect milestone commits — feat: / refactor: / merge commits. Case-sensitive
|
|
# on the conventional-commit prefix so we don't false-fire on "feature-" docs.
|
|
case "$cmd" in
|
|
*"git commit"*"-m"*"\"feat"[:\ ]*|\
|
|
*"git commit"*"-m"*"\"refactor"[:\ ]*|\
|
|
*"git merge"*)
|
|
;;
|
|
*)
|
|
exit 0
|
|
;;
|
|
esac
|
|
|
|
backlog="${HOME}/.claude/memory/audit-backlog.md"
|
|
mkdir -p "$(dirname "$backlog")" 2>/dev/null || exit 0
|
|
|
|
# Ensure the header + session_count counter exist.
|
|
if [ ! -f "$backlog" ]; then
|
|
{
|
|
printf '# Audit Backlog\n\n'
|
|
printf '<!-- session_count: 0 -->\n\n'
|
|
} > "$backlog"
|
|
fi
|
|
|
|
# Read current session_count (silent-first threshold).
|
|
session_count=$(grep -Eo 'session_count: [0-9]+' "$backlog" 2>/dev/null | head -1 | awk '{print $2}')
|
|
session_count=${session_count:-0}
|
|
|
|
# Append the summary line if kei-memory is present.
|
|
ts=$(date -u +%Y-%m-%dT%H:%M)
|
|
if command -v kei-memory >/dev/null 2>&1; then
|
|
summary=$(kei-memory analyze --last 1 --summary 2>/dev/null || true)
|
|
if [ -n "$summary" ]; then
|
|
printf -- '- [MILESTONE %s] %s' "$ts" "$summary" >> "$backlog"
|
|
fi
|
|
fi
|
|
|
|
# Advisory stderr reminder only after silent-first threshold.
|
|
if [ "$session_count" -ge 10 ]; then
|
|
printf 'kei-memory: audit backlog has unreviewed items (%s)\n' "$backlog" >&2
|
|
fi
|
|
|
|
exit 0
|