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.
74 lines
2.4 KiB
Bash
Executable file
74 lines
2.4 KiB
Bash
Executable file
#!/bin/sh
|
|
# session-end-dump.sh — Stop event hook (RULE 0.14).
|
|
#
|
|
# On session end: save the transcript JSONL to ~/.claude/memory/traces/
|
|
# and call `kei-memory ingest` if the primitive is installed. NEVER blocks:
|
|
# every exit path is `exit 0`. No jq → silent no-op. No kei-memory → still
|
|
# saves the raw trace so later installs can back-fill.
|
|
|
|
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)"
|
|
|
|
session_id=$(printf '%s' "$input" | jq -r '.session_id // empty' 2>/dev/null || true)
|
|
transcript=$(printf '%s' "$input" | jq -r '.transcript_path // .transcript // empty' 2>/dev/null || true)
|
|
|
|
# Nothing to dump without an id — silent no-op.
|
|
if [ -z "$session_id" ]; then
|
|
exit 0
|
|
fi
|
|
|
|
# Destination dir for trace archives (created lazily).
|
|
traces_dir="${HOME}/.claude/memory/traces"
|
|
mkdir -p "$traces_dir" 2>/dev/null || exit 0
|
|
|
|
dest="${traces_dir}/${session_id}.jsonl"
|
|
|
|
# If Claude Code provides a transcript path, copy the JSONL to our store.
|
|
# If transcript is missing, leave dest un-created — analyzer falls back to
|
|
# no-op for that session and logs a zero-event row on next ingest.
|
|
if [ -n "$transcript" ] && [ -f "$transcript" ]; then
|
|
cp -f "$transcript" "$dest" 2>/dev/null || true
|
|
fi
|
|
|
|
# Best-effort ingest — advisory only; never blocks the session from ending.
|
|
if command -v kei-memory >/dev/null 2>&1 && [ -f "$dest" ]; then
|
|
kei-memory ingest \
|
|
--session-id "$session_id" \
|
|
--transcript "$dest" \
|
|
>/dev/null 2>&1 || true
|
|
fi
|
|
|
|
# v0.11 sleep-sync (RULE 0.15) — push traces to the user's memory-repo so a
|
|
# cloud agent can consolidate them overnight. Silent no-op when the primitive
|
|
# is absent or the user hasn't opted in via /sleep-setup.
|
|
sleep_sync="${HOME}/.claude/agents/_primitives/kei-sleep-sync.sh"
|
|
if [ -x "$sleep_sync" ]; then
|
|
"$sleep_sync" >/dev/null 2>&1 || true
|
|
fi
|
|
|
|
exit 0
|