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.
73 lines
2.3 KiB
Bash
Executable file
73 lines
2.3 KiB
Bash
Executable file
#!/bin/sh
|
|
# agent-fork-logger.sh — PreToolUse:Agent advisory hook (RULE 0.12).
|
|
#
|
|
# Reads the Agent tool invocation JSON from stdin and, if kei-ledger is on
|
|
# PATH, logs a fork row so the orchestrator can later validate the bundle.
|
|
# NEVER blocks: every exit path is `exit 0`. Hard-dependency absent (no jq,
|
|
# no kei-ledger, no git) → silent no-op.
|
|
|
|
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)"
|
|
|
|
# Extract subagent_type / prompt / isolation from the Agent tool_input.
|
|
subagent=$(printf '%s' "$input" | jq -r '.tool_input.subagent_type // empty' 2>/dev/null || true)
|
|
prompt=$(printf '%s' "$input" | jq -r '.tool_input.prompt // empty' 2>/dev/null || true)
|
|
isolation=$(printf '%s' "$input" | jq -r '.tool_input.isolation // empty' 2>/dev/null || true)
|
|
|
|
# No subagent name → not an agent call we know how to track.
|
|
if [ -z "$subagent" ]; then
|
|
exit 0
|
|
fi
|
|
|
|
# Spec fingerprint = first 16 hex chars of SHA-256(prompt).
|
|
spec_sha=$(printf '%s' "$prompt" | shasum -a 256 2>/dev/null | cut -c1-16)
|
|
spec_sha=${spec_sha:-unknown}
|
|
|
|
ts=$(date +%s)
|
|
agent_id="${subagent}-${ts}"
|
|
|
|
if [ "$isolation" = "worktree" ]; then
|
|
branch="agent/${subagent}-${ts}"
|
|
else
|
|
branch="inline-${subagent}-${ts}"
|
|
fi
|
|
|
|
# Current git branch (if we're inside a repo). Non-fatal if git absent.
|
|
current_branch=$(git rev-parse --abbrev-ref HEAD 2>/dev/null || echo none)
|
|
|
|
# If kei-ledger is unavailable, bail silently — the hook is advisory only.
|
|
command -v kei-ledger >/dev/null 2>&1 || exit 0
|
|
|
|
# Emit the fork row. Always exit 0 even if kei-ledger returns non-zero:
|
|
# the hook must never block an Agent invocation on ledger trouble.
|
|
kei-ledger fork "$agent_id" "$branch" \
|
|
--parent "$current_branch" \
|
|
--spec-sha "$spec_sha" \
|
|
>/dev/null 2>&1 || true
|
|
|
|
exit 0
|