KeiSeiKit-1.0/hooks/no-hand-edit-agents.sh
Parfii-bot 16d4b48c77 fix(hooks): guard against missing jq; drop UUOC
All three hooks used `set -eu` + `cat | jq …`. Without jq installed, jq
would fail and `-e` would abort the hook → non-zero exit → Claude Code
refuses Edit/Write/Bash system-wide. Now each hook probes for jq BEFORE
`set -eu` and exits 0 silently if absent. Also dropped the useless `cat |`
pipe — `jq -r` reads stdin directly.

Companion: install.sh jq check upgraded from warn to hard `exit 1` because
without jq the hooks are dead weight; message states jq is required on
any machine that will activate the hooks.
2026-04-21 02:55:07 +08:00

45 lines
1.4 KiB
Bash
Executable file

#!/usr/bin/env bash
# PreToolUse(Edit|Write) — block hand-editing generated agent .md files.
#
# Generated files start with: <!-- GENERATED by _assembler ...
# Edit the manifest at _manifests/<name>.toml instead.
#
# Override: set AGENT_MIGRATION=1 in env to allow hand edits (migration / emergency).
#
# Stdin: JSON with tool_input.file_path
# Silent fall-through if jq is absent; otherwise `set -eu` would abort and
# Claude Code would refuse Edit/Write system-wide.
command -v jq >/dev/null 2>&1 || exit 0
set -eu
[ "${AGENT_MIGRATION:-0}" = "1" ] && exit 0
FILE=$(jq -r '.tool_input.file_path // empty')
[ -n "$FILE" ] || exit 0
# Only care about files directly under ~/.claude/agents/*.md
# (not blocks/, manifests/, assembler/, template, generated preview)
case "$FILE" in
"$HOME/.claude/agents/_"*) exit 0 ;;
"$HOME/.claude/agents/"*.md) ;;
*) exit 0 ;;
esac
# Detect generated marker in the first 10 lines
if [ -f "$FILE" ] && head -10 "$FILE" | grep -q 'GENERATED by _assembler'; then
NAME=$(basename "$FILE" .md)
echo "[no-hand-edit-agents] BLOCKED: $FILE is generated." >&2
echo "" >&2
echo "Edit the manifest instead:" >&2
echo " ~/.claude/agents/_manifests/$NAME.toml" >&2
echo "" >&2
echo "Or edit a shared block:" >&2
echo " ~/.claude/agents/_blocks/<block>.md" >&2
echo "" >&2
echo "Override (emergency only): export AGENT_MIGRATION=1" >&2
exit 1
fi
exit 0