@miller-tech/uap 1.13.12 → 1.13.13

package/dist/types/config.d.ts

@@ -1272,7 +1272,7 @@ export declare const ModelConfigSchema: z.ZodObject<{
 }, "strip", z.ZodTypeAny, {
     id: string;
     name: string;
-    provider: "custom" | "anthropic" | "deepseek" | "openai" | "zhipu" | "ollama";
+    provider: "anthropic" | "deepseek" | "openai" | "zhipu" | "ollama" | "custom";
     apiModel: string;
     maxContextTokens: number;
     capabilities: string[];
@@ -1283,7 +1283,7 @@ export declare const ModelConfigSchema: z.ZodObject<{
 }, {
     id: string;
     name: string;
-    provider: "custom" | "anthropic" | "deepseek" | "openai" | "zhipu" | "ollama";
+    provider: "anthropic" | "deepseek" | "openai" | "zhipu" | "ollama" | "custom";
     apiModel: string;
     endpoint?: string | undefined;
     apiKeyEnvVar?: string | undefined;
@@ -1303,12 +1303,12 @@ export declare const RoutingRuleSchema: z.ZodObject<{
     priority: number;
     complexity?: "low" | "medium" | "high" | "critical" | undefined;
     keywords?: string[] | undefined;
-    taskType?: "planning" | "coding" | "refactoring" | "bug-fix" | "review" | "documentation" | undefined;
+    taskType?: "planning" | "review" | "coding" | "refactoring" | "bug-fix" | "documentation" | undefined;
 }, {
     targetRole: "planner" | "executor" | "reviewer" | "fallback";
     complexity?: "low" | "medium" | "high" | "critical" | undefined;
     keywords?: string[] | undefined;
-    taskType?: "planning" | "coding" | "refactoring" | "bug-fix" | "review" | "documentation" | undefined;
+    taskType?: "planning" | "review" | "coding" | "refactoring" | "bug-fix" | "documentation" | undefined;
     priority?: number | undefined;
 }>;
 export declare const MultiModelSchema: z.ZodObject<{
@@ -1328,7 +1328,7 @@ export declare const MultiModelSchema: z.ZodObject<{
     }, "strip", z.ZodTypeAny, {
         id: string;
         name: string;
-        provider: "custom" | "anthropic" | "deepseek" | "openai" | "zhipu" | "ollama";
+        provider: "anthropic" | "deepseek" | "openai" | "zhipu" | "ollama" | "custom";
         apiModel: string;
         maxContextTokens: number;
         capabilities: string[];
@@ -1340,7 +1340,7 @@ export declare const MultiModelSchema: z.ZodObject<{
     }, {
         id: string;
         name: string;
-        provider: "custom" | "anthropic" | "deepseek" | "openai" | "zhipu" | "ollama";
+        provider: "anthropic" | "deepseek" | "openai" | "zhipu" | "ollama" | "custom";
         apiModel: string;
         endpoint?: string | undefined;
         apiKeyEnvVar?: string | undefined;
@@ -1377,12 +1377,12 @@ export declare const MultiModelSchema: z.ZodObject<{
         priority: number;
         complexity?: "low" | "medium" | "high" | "critical" | undefined;
         keywords?: string[] | undefined;
-        taskType?: "planning" | "coding" | "refactoring" | "bug-fix" | "review" | "documentation" | undefined;
+        taskType?: "planning" | "review" | "coding" | "refactoring" | "bug-fix" | "documentation" | undefined;
     }, {
         targetRole: "planner" | "executor" | "reviewer" | "fallback";
         complexity?: "low" | "medium" | "high" | "critical" | undefined;
         keywords?: string[] | undefined;
-        taskType?: "planning" | "coding" | "refactoring" | "bug-fix" | "review" | "documentation" | undefined;
+        taskType?: "planning" | "review" | "coding" | "refactoring" | "bug-fix" | "documentation" | undefined;
         priority?: number | undefined;
     }>, "many">>;
     costOptimization: z.ZodOptional<z.ZodObject<{
@@ -1443,7 +1443,7 @@ export declare const MultiModelSchema: z.ZodObject<{
     models: (string | {
         id: string;
         name: string;
-        provider: "custom" | "anthropic" | "deepseek" | "openai" | "zhipu" | "ollama";
+        provider: "anthropic" | "deepseek" | "openai" | "zhipu" | "ollama" | "custom";
         apiModel: string;
         maxContextTokens: number;
         capabilities: string[];
@@ -1465,7 +1465,7 @@ export declare const MultiModelSchema: z.ZodObject<{
         priority: number;
         complexity?: "low" | "medium" | "high" | "critical" | undefined;
         keywords?: string[] | undefined;
-        taskType?: "planning" | "coding" | "refactoring" | "bug-fix" | "review" | "documentation" | undefined;
+        taskType?: "planning" | "review" | "coding" | "refactoring" | "bug-fix" | "documentation" | undefined;
     }[] | undefined;
     costOptimization?: {
         enabled: boolean;
@@ -1492,7 +1492,7 @@ export declare const MultiModelSchema: z.ZodObject<{
     models?: (string | {
         id: string;
         name: string;
-        provider: "custom" | "anthropic" | "deepseek" | "openai" | "zhipu" | "ollama";
+        provider: "anthropic" | "deepseek" | "openai" | "zhipu" | "ollama" | "custom";
         apiModel: string;
         endpoint?: string | undefined;
         apiKeyEnvVar?: string | undefined;
@@ -1512,7 +1512,7 @@ export declare const MultiModelSchema: z.ZodObject<{
         targetRole: "planner" | "executor" | "reviewer" | "fallback";
         complexity?: "low" | "medium" | "high" | "critical" | undefined;
         keywords?: string[] | undefined;
-        taskType?: "planning" | "coding" | "refactoring" | "bug-fix" | "review" | "documentation" | undefined;
+        taskType?: "planning" | "review" | "coding" | "refactoring" | "bug-fix" | "documentation" | undefined;
         priority?: number | undefined;
     }[] | undefined;
     costOptimization?: {
@@ -2583,7 +2583,7 @@ export declare const AgentContextConfigSchema: z.ZodObject<{
         }, "strip", z.ZodTypeAny, {
             id: string;
             name: string;
-            provider: "custom" | "anthropic" | "deepseek" | "openai" | "zhipu" | "ollama";
+            provider: "anthropic" | "deepseek" | "openai" | "zhipu" | "ollama" | "custom";
             apiModel: string;
             maxContextTokens: number;
             capabilities: string[];
@@ -2595,7 +2595,7 @@ export declare const AgentContextConfigSchema: z.ZodObject<{
         }, {
             id: string;
             name: string;
-            provider: "custom" | "anthropic" | "deepseek" | "openai" | "zhipu" | "ollama";
+            provider: "anthropic" | "deepseek" | "openai" | "zhipu" | "ollama" | "custom";
             apiModel: string;
             endpoint?: string | undefined;
             apiKeyEnvVar?: string | undefined;
@@ -2632,12 +2632,12 @@ export declare const AgentContextConfigSchema: z.ZodObject<{
             priority: number;
             complexity?: "low" | "medium" | "high" | "critical" | undefined;
             keywords?: string[] | undefined;
-            taskType?: "planning" | "coding" | "refactoring" | "bug-fix" | "review" | "documentation" | undefined;
+            taskType?: "planning" | "review" | "coding" | "refactoring" | "bug-fix" | "documentation" | undefined;
         }, {
             targetRole: "planner" | "executor" | "reviewer" | "fallback";
             complexity?: "low" | "medium" | "high" | "critical" | undefined;
             keywords?: string[] | undefined;
-            taskType?: "planning" | "coding" | "refactoring" | "bug-fix" | "review" | "documentation" | undefined;
+            taskType?: "planning" | "review" | "coding" | "refactoring" | "bug-fix" | "documentation" | undefined;
             priority?: number | undefined;
         }>, "many">>;
         costOptimization: z.ZodOptional<z.ZodObject<{
@@ -2698,7 +2698,7 @@ export declare const AgentContextConfigSchema: z.ZodObject<{
         models: (string | {
             id: string;
             name: string;
-            provider: "custom" | "anthropic" | "deepseek" | "openai" | "zhipu" | "ollama";
+            provider: "anthropic" | "deepseek" | "openai" | "zhipu" | "ollama" | "custom";
             apiModel: string;
             maxContextTokens: number;
             capabilities: string[];
@@ -2720,7 +2720,7 @@ export declare const AgentContextConfigSchema: z.ZodObject<{
             priority: number;
             complexity?: "low" | "medium" | "high" | "critical" | undefined;
             keywords?: string[] | undefined;
-            taskType?: "planning" | "coding" | "refactoring" | "bug-fix" | "review" | "documentation" | undefined;
+            taskType?: "planning" | "review" | "coding" | "refactoring" | "bug-fix" | "documentation" | undefined;
         }[] | undefined;
         costOptimization?: {
             enabled: boolean;
@@ -2747,7 +2747,7 @@ export declare const AgentContextConfigSchema: z.ZodObject<{
         models?: (string | {
             id: string;
             name: string;
-            provider: "custom" | "anthropic" | "deepseek" | "openai" | "zhipu" | "ollama";
+            provider: "anthropic" | "deepseek" | "openai" | "zhipu" | "ollama" | "custom";
             apiModel: string;
             endpoint?: string | undefined;
             apiKeyEnvVar?: string | undefined;
@@ -2767,7 +2767,7 @@ export declare const AgentContextConfigSchema: z.ZodObject<{
             targetRole: "planner" | "executor" | "reviewer" | "fallback";
             complexity?: "low" | "medium" | "high" | "critical" | undefined;
             keywords?: string[] | undefined;
-            taskType?: "planning" | "coding" | "refactoring" | "bug-fix" | "review" | "documentation" | undefined;
+            taskType?: "planning" | "review" | "coding" | "refactoring" | "bug-fix" | "documentation" | undefined;
             priority?: number | undefined;
         }[] | undefined;
         costOptimization?: {
@@ -3092,7 +3092,7 @@ export declare const AgentContextConfigSchema: z.ZodObject<{
         models: (string | {
             id: string;
             name: string;
-            provider: "custom" | "anthropic" | "deepseek" | "openai" | "zhipu" | "ollama";
+            provider: "anthropic" | "deepseek" | "openai" | "zhipu" | "ollama" | "custom";
             apiModel: string;
             maxContextTokens: number;
             capabilities: string[];
@@ -3114,7 +3114,7 @@ export declare const AgentContextConfigSchema: z.ZodObject<{
             priority: number;
             complexity?: "low" | "medium" | "high" | "critical" | undefined;
             keywords?: string[] | undefined;
-            taskType?: "planning" | "coding" | "refactoring" | "bug-fix" | "review" | "documentation" | undefined;
+            taskType?: "planning" | "review" | "coding" | "refactoring" | "bug-fix" | "documentation" | undefined;
         }[] | undefined;
         costOptimization?: {
             enabled: boolean;
@@ -3353,7 +3353,7 @@ export declare const AgentContextConfigSchema: z.ZodObject<{
         models?: (string | {
             id: string;
             name: string;
-            provider: "custom" | "anthropic" | "deepseek" | "openai" | "zhipu" | "ollama";
+            provider: "anthropic" | "deepseek" | "openai" | "zhipu" | "ollama" | "custom";
             apiModel: string;
             endpoint?: string | undefined;
             apiKeyEnvVar?: string | undefined;
@@ -3373,7 +3373,7 @@ export declare const AgentContextConfigSchema: z.ZodObject<{
             targetRole: "planner" | "executor" | "reviewer" | "fallback";
             complexity?: "low" | "medium" | "high" | "critical" | undefined;
             keywords?: string[] | undefined;
-            taskType?: "planning" | "coding" | "refactoring" | "bug-fix" | "review" | "documentation" | undefined;
+            taskType?: "planning" | "review" | "coding" | "refactoring" | "bug-fix" | "documentation" | undefined;
             priority?: number | undefined;
         }[] | undefined;
         costOptimization?: {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@miller-tech/uap",
-  "version": "1.13.12",
+  "version": "1.13.13",
   "description": "Autonomous AI agent memory system with CLAUDE.md protocol enforcement",
   "type": "module",
   "main": "dist/index.js",

package/templates/hooks/loop-protection.sh

@@ -0,0 +1,250 @@
+#!/usr/bin/env bash
+# ============================================================
+# UAP Loop Protection & Token Budget Circuit Breaker
+# ============================================================
+# Shared library sourced by all UAP hooks.
+# Tracks hook invocation frequency and detects runaway loops
+# that waste tokens (and money) by emitting the same system
+# reminders, build-gate warnings, or compliance blocks
+# hundreds of times in a single session.
+#
+# MECHANISM:
+#   - Maintains a lightweight state file per session
+#   - Counts hook invocations per type within sliding windows
+#   - Suppresses redundant output after thresholds are hit
+#   - Logs suppressed events for post-mortem analysis
+#   - Provides hard circuit-breaker after extreme loop counts
+#
+# USAGE (source from any hook script):
+#   source "$(dirname "$0")/loop-protection.sh"
+#   if lp_should_suppress "post-tool-use-edit-write"; then
+#     exit 0  # skip output, loop detected
+#   fi
+#   lp_record_invocation "post-tool-use-edit-write"
+#
+# CONFIGURATION (environment variables):
+#   UAP_LP_DISABLED=1           Disable loop protection entirely
+#   UAP_LP_SOFT_LIMIT=15        Warn after N invocations per hook (default: 15)
+#   UAP_LP_HARD_LIMIT=50        Suppress output after N (default: 50)
+#   UAP_LP_CIRCUIT_BREAK=200    Hard stop — emit circuit breaker msg (default: 200)
+#   UAP_LP_WINDOW_SECS=300      Sliding window in seconds (default: 300 = 5 min)
+#   UAP_LP_DEDUP_SECS=5         Min seconds between identical outputs (default: 5)
+# ============================================================
+
+# Guard against re-sourcing
+if [ "${_UAP_LOOP_PROTECTION_LOADED:-}" = "1" ]; then
+  return 0 2>/dev/null || true
+fi
+_UAP_LOOP_PROTECTION_LOADED=1
+
+# --- Configuration ---
+LP_DISABLED="${UAP_LP_DISABLED:-0}"
+LP_SOFT_LIMIT="${UAP_LP_SOFT_LIMIT:-15}"
+LP_HARD_LIMIT="${UAP_LP_HARD_LIMIT:-50}"
+LP_CIRCUIT_BREAK="${UAP_LP_CIRCUIT_BREAK:-200}"
+LP_WINDOW_SECS="${UAP_LP_WINDOW_SECS:-300}"
+LP_DEDUP_SECS="${UAP_LP_DEDUP_SECS:-5}"
+
+# --- State file location ---
+LP_PROJECT_DIR="${CLAUDE_PROJECT_DIR:-${FACTORY_PROJECT_DIR:-${CURSOR_PROJECT_DIR:-.}}}"
+LP_STATE_DIR="${LP_PROJECT_DIR}/.uap/loop-protection"
+LP_SESSION_ID="${UAP_SESSION_ID:-${SESSION_ID:-default}}"
+LP_STATE_FILE="${LP_STATE_DIR}/session-${LP_SESSION_ID}.state"
+LP_LOG_FILE="${LP_STATE_DIR}/loop-events.log"
+
+# --- Ensure state directory exists ---
+_lp_init() {
+  if [ "$LP_DISABLED" = "1" ]; then
+    return 0
+  fi
+  mkdir -p "$LP_STATE_DIR" 2>/dev/null || true
+}
+
+# --- Get current epoch seconds (portable) ---
+_lp_now() {
+  date +%s 2>/dev/null || echo "0"
+}
+
+# --- Read counter for a hook type from state file ---
+# Format: hook_type|count|first_ts|last_ts|suppressed_count
+_lp_read_state() {
+  local hook_type="$1"
+  if [ ! -f "$LP_STATE_FILE" ]; then
+    echo "0|0|0|0"
+    return
+  fi
+  local line
+  line=$(grep "^${hook_type}|" "$LP_STATE_FILE" 2>/dev/null | tail -1)
+  if [ -z "$line" ]; then
+    echo "0|0|0|0"
+    return
+  fi
+  echo "$line" | cut -d'|' -f2-5
+}
+
+# --- Write/update counter for a hook type ---
+_lp_write_state() {
+  local hook_type="$1"
+  local count="$2"
+  local first_ts="$3"
+  local last_ts="$4"
+  local suppressed="$5"
+
+  # Atomic update: remove old line, append new
+  if [ -f "$LP_STATE_FILE" ]; then
+    grep -v "^${hook_type}|" "$LP_STATE_FILE" > "${LP_STATE_FILE}.tmp" 2>/dev/null || true
+    mv "${LP_STATE_FILE}.tmp" "$LP_STATE_FILE" 2>/dev/null || true
+  fi
+  echo "${hook_type}|${count}|${first_ts}|${last_ts}|${suppressed}" >> "$LP_STATE_FILE"
+}
+
+# --- Log a loop event for post-mortem ---
+_lp_log_event() {
+  local level="$1"
+  local hook_type="$2"
+  local message="$3"
+  local now
+  now=$(_lp_now)
+  echo "${now}|${level}|${hook_type}|${message}" >> "$LP_LOG_FILE" 2>/dev/null || true
+}
+
+# ============================================================
+# PUBLIC API
+# ============================================================
+
+# Check if a hook invocation should be suppressed.
+# Returns 0 (true/suppress) if the hook has been called too many times.
+# Returns 1 (false/allow) if the hook should proceed normally.
+lp_should_suppress() {
+  local hook_type="${1:-unknown}"
+
+  if [ "$LP_DISABLED" = "1" ]; then
+    return 1  # don't suppress
+  fi
+
+  _lp_init
+
+  local state
+  state=$(_lp_read_state "$hook_type")
+  local count first_ts last_ts suppressed
+  count=$(echo "$state" | cut -d'|' -f1)
+  first_ts=$(echo "$state" | cut -d'|' -f2)
+  last_ts=$(echo "$state" | cut -d'|' -f3)
+  suppressed=$(echo "$state" | cut -d'|' -f4)
+
+  local now
+  now=$(_lp_now)
+
+  # Reset window if first_ts is too old
+  if [ "$first_ts" != "0" ] && [ $((now - first_ts)) -gt "$LP_WINDOW_SECS" ]; then
+    count=0
+    first_ts="$now"
+    suppressed=0
+  fi
+
+  # Dedup: if called within LP_DEDUP_SECS of last call, always suppress
+  if [ "$last_ts" != "0" ] && [ $((now - last_ts)) -lt "$LP_DEDUP_SECS" ]; then
+    suppressed=$((suppressed + 1))
+    _lp_write_state "$hook_type" "$count" "$first_ts" "$now" "$suppressed"
+    return 0  # suppress (dedup)
+  fi
+
+  # Check thresholds
+  if [ "$count" -ge "$LP_CIRCUIT_BREAK" ]; then
+    # Circuit breaker: emit ONE final warning then suppress everything
+    if [ "$suppressed" -eq 0 ] || [ $((count % LP_CIRCUIT_BREAK)) -eq 0 ]; then
+      _lp_log_event "CIRCUIT_BREAK" "$hook_type" "count=${count} in window"
+    fi
+    suppressed=$((suppressed + 1))
+    _lp_write_state "$hook_type" "$count" "$first_ts" "$now" "$suppressed"
+    return 0  # suppress
+  fi
+
+  if [ "$count" -ge "$LP_HARD_LIMIT" ]; then
+    # Hard limit: suppress output, log
+    if [ $((count % 10)) -eq 0 ]; then
+      _lp_log_event "HARD_LIMIT" "$hook_type" "count=${count} suppressed=${suppressed}"
+    fi
+    suppressed=$((suppressed + 1))
+    _lp_write_state "$hook_type" "$count" "$first_ts" "$now" "$suppressed"
+    return 0  # suppress
+  fi
+
+  return 1  # allow
+}
+
+# Record a hook invocation (call AFTER producing output).
+lp_record_invocation() {
+  local hook_type="${1:-unknown}"
+
+  if [ "$LP_DISABLED" = "1" ]; then
+    return 0
+  fi
+
+  _lp_init
+
+  local state
+  state=$(_lp_read_state "$hook_type")
+  local count first_ts last_ts suppressed
+  count=$(echo "$state" | cut -d'|' -f1)
+  first_ts=$(echo "$state" | cut -d'|' -f2)
+  last_ts=$(echo "$state" | cut -d'|' -f3)
+  suppressed=$(echo "$state" | cut -d'|' -f4)
+
+  local now
+  now=$(_lp_now)
+
+  # Reset window if expired
+  if [ "$first_ts" = "0" ] || [ $((now - first_ts)) -gt "$LP_WINDOW_SECS" ]; then
+    count=1
+    first_ts="$now"
+    suppressed=0
+  else
+    count=$((count + 1))
+  fi
+
+  _lp_write_state "$hook_type" "$count" "$first_ts" "$now" "$suppressed"
+
+  # Emit warnings at soft limit
+  if [ "$count" -eq "$LP_SOFT_LIMIT" ]; then
+    _lp_log_event "SOFT_LIMIT" "$hook_type" "count=${count} - approaching rate limit"
+    echo "[UAP-LOOP-PROTECTION] Hook '${hook_type}' has fired ${count} times in ${LP_WINDOW_SECS}s. Output will be suppressed after ${LP_HARD_LIMIT} to prevent token waste." >&2
+  fi
+}
+
+# Get the circuit breaker warning message (for hooks that want to emit it).
+lp_circuit_breaker_message() {
+  local hook_type="${1:-unknown}"
+  local state
+  state=$(_lp_read_state "$hook_type")
+  local count
+  count=$(echo "$state" | cut -d'|' -f1)
+  local suppressed
+  suppressed=$(echo "$state" | cut -d'|' -f4)
+
+  echo "[UAP-CIRCUIT-BREAKER] Hook '${hook_type}' triggered ${count} times (${suppressed} suppressed). This is a runaway loop. Review your approach — repeated hook warnings are consuming tokens without progress."
+}
+
+# Get loop protection stats as a summary string.
+lp_stats() {
+  if [ ! -f "$LP_STATE_FILE" ]; then
+    echo "No loop protection data for this session."
+    return
+  fi
+  echo "=== UAP Loop Protection Stats ==="
+  while IFS='|' read -r hook count first_ts last_ts suppressed; do
+    echo "  ${hook}: ${count} calls, ${suppressed} suppressed"
+  done < "$LP_STATE_FILE"
+  echo "================================="
+}
+
+# Reset state for a specific hook or all hooks.
+lp_reset() {
+  local hook_type="${1:-}"
+  if [ -z "$hook_type" ]; then
+    rm -f "$LP_STATE_FILE" 2>/dev/null || true
+  elif [ -f "$LP_STATE_FILE" ]; then
+    grep -v "^${hook_type}|" "$LP_STATE_FILE" > "${LP_STATE_FILE}.tmp" 2>/dev/null || true
+    mv "${LP_STATE_FILE}.tmp" "$LP_STATE_FILE" 2>/dev/null || true
+  fi
+}

package/templates/hooks/post-compact.sh

@@ -5,6 +5,15 @@
 # Always exits 0 (never blocks).
 set -euo pipefail
 
+# --- Loop Protection: suppress if compaction is happening in rapid succession ---
+HOOK_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+if [ -f "${HOOK_DIR}/loop-protection.sh" ]; then
+  source "${HOOK_DIR}/loop-protection.sh"
+  if lp_should_suppress "post-compact"; then
+    exit 0
+  fi
+fi
+
 PROJECT_DIR="${CLAUDE_PROJECT_DIR:-${FACTORY_PROJECT_DIR:-${CURSOR_PROJECT_DIR:-.}}}"
 DB_PATH="${PROJECT_DIR}/agents/data/memory/short_term.db"
 COORD_DB="${PROJECT_DIR}/agents/data/coordination/coordination.db"
@@ -108,4 +117,9 @@ fi
 
 output+="</system-reminder>"$'\n'
 
+# --- Record invocation for loop tracking ---
+if type lp_record_invocation &>/dev/null; then
+  lp_record_invocation "post-compact"
+fi
+
 echo "$output"

package/templates/hooks/post-tool-use-edit-write.sh

@@ -6,6 +6,16 @@
 # Always exits 0 (never blocks).
 set -euo pipefail
 
+# --- Loop Protection: suppress output if firing too fast ---
+HOOK_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+if [ -f "${HOOK_DIR}/loop-protection.sh" ]; then
+  source "${HOOK_DIR}/loop-protection.sh"
+  if lp_should_suppress "post-tool-edit-write"; then
+    cat > /dev/null  # drain stdin
+    exit 0
+  fi
+fi
+
 # Read tool input from stdin (JSON)
 INPUT=$(cat)
 
@@ -35,4 +45,9 @@ if [ ! -f "${BACKUP_DIR}/${RELATIVE_PATH}" ] 2>/dev/null; then
   fi
 fi
 
+# --- Record invocation for loop tracking ---
+if type lp_record_invocation &>/dev/null; then
+  lp_record_invocation "post-tool-edit-write"
+fi
+
 exit 0

package/templates/hooks/pre-compact.sh

@@ -7,6 +7,15 @@
 # Fails safely - never blocks the agent.
 set -euo pipefail
 
+# --- Loop Protection: suppress if compaction is looping ---
+HOOK_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+if [ -f "${HOOK_DIR}/loop-protection.sh" ]; then
+  source "${HOOK_DIR}/loop-protection.sh"
+  if lp_should_suppress "pre-compact"; then
+    exit 0
+  fi
+fi
+
 PROJECT_DIR="${CLAUDE_PROJECT_DIR:-${FACTORY_PROJECT_DIR:-${CURSOR_PROJECT_DIR:-.}}}"
 DB_PATH="${PROJECT_DIR}/agents/data/memory/short_term.db"
 COORD_DB="${PROJECT_DIR}/agents/data/coordination/coordination.db"

package/templates/hooks/pre-tool-use-bash.sh

@@ -5,6 +5,12 @@
 # Enforces: iac-pipeline-enforcement, worktree-enforcement, git safety policies.
 set -euo pipefail
 
+# --- Loop Protection: track frequency of blocking events ---
+HOOK_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+if [ -f "${HOOK_DIR}/loop-protection.sh" ]; then
+  source "${HOOK_DIR}/loop-protection.sh"
+fi
+
 # Read tool input from stdin (JSON)
 INPUT=$(cat)
 

package/templates/hooks/pre-tool-use-edit-write.sh

@@ -5,6 +5,12 @@
 # Enforces: worktree-file-guard, worktree-enforcement policies.
 set -euo pipefail
 
+# --- Loop Protection: track frequency of blocking events ---
+HOOK_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+if [ -f "${HOOK_DIR}/loop-protection.sh" ]; then
+  source "${HOOK_DIR}/loop-protection.sh"
+fi
+
 # Read tool input from stdin (JSON)
 INPUT=$(cat)
 
@@ -40,5 +46,9 @@ if echo "$FILE_PATH" | grep -q '\.worktrees/'; then
 fi
 
 # BLOCK: path is outside worktrees and not exempt
+# Record the block event for loop detection
+if type lp_record_invocation &>/dev/null; then
+  lp_record_invocation "pre-tool-edit-block"
+fi
 echo '{"decision":"block","reason":"WORKTREE POLICY VIOLATION: File path is outside .worktrees/. All edits must target files inside a worktree. Run: uap worktree create <slug> then edit files in .worktrees/NNN-<slug>/. See policies/worktree-file-guard.md"}' >&2
 exit 2