#!/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