cc-safe-setup 29.6.24 → 29.6.25

package/README.md

@@ -117,7 +117,7 @@ Install any of these: `npx cc-safe-setup --install-example <name>`
 | `--scan [--apply]` | Tech stack detection |
 | `--export / --import` | Team config sharing |
 | `--verify` | Test each hook |
-| `--install-example <name>` | Install from 445 examples |
+| `--install-example <name>` | Install from 446 examples |
 | `--examples [filter]` | Browse examples by keyword |
 | `--full` | All-in-one setup |
 | `--status` | Check installed hooks |

package/examples/api-overload-backoff.sh

@@ -0,0 +1,45 @@
+#!/bin/bash
+# api-overload-backoff.sh — Track API overload errors and enforce backoff
+#
+# Solves: 529 Overloaded errors causing session failures and wasted tokens.
+#         Multiple issues: #39743(24👍), #39763(18👍), #39745(14👍),
+#         #39767(11👍), #39747(8👍) — 75+ combined reactions.
+#         Users lose tokens on retries that hit the same overload.
+#
+# How it works: PostToolUse hook. Detects 529/overload errors in tool output.
+#               Tracks consecutive errors. After 3 consecutive 529s, warns
+#               to wait before retrying. After 5, suggests stopping the session.
+#
+# TRIGGER: PostToolUse  MATCHER: ""
+# ================================================================
+
+INPUT=$(cat)
+OUTPUT=$(echo "$INPUT" | jq -r '.tool_output // empty' 2>/dev/null)
+
+[ -z "$OUTPUT" ] && exit 0
+
+STATE="/tmp/cc-overload-count-$$"
+
+# Detect 529/overload patterns in output
+if echo "$OUTPUT" | grep -qiE '529|overloaded_error|overload|rate.limit.*exceeded'; then
+    # Increment counter
+    COUNT=1
+    [ -f "$STATE" ] && COUNT=$(( $(cat "$STATE") + 1 ))
+    echo "$COUNT" > "$STATE"
+
+    if [ "$COUNT" -ge 5 ]; then
+        echo "" >&2
+        echo "⚠ API OVERLOAD: $COUNT consecutive 529 errors detected." >&2
+        echo "The API is severely overloaded. Continuing will waste tokens." >&2
+        echo "Recommendation: Stop this session and retry in 10-15 minutes." >&2
+    elif [ "$COUNT" -ge 3 ]; then
+        echo "" >&2
+        echo "⚠ API OVERLOAD: $COUNT consecutive 529 errors." >&2
+        echo "Wait 30-60 seconds before the next action." >&2
+    fi
+else
+    # Reset counter on successful response
+    rm -f "$STATE" 2>/dev/null
+fi
+
+exit 0

package/examples/usage-cache-local.sh

@@ -0,0 +1,53 @@
+#!/bin/bash
+# usage-cache-local.sh — Cache usage info locally to avoid API calls
+#
+# Solves: Asking "how much budget have I used?" costs tokens itself (#39465, 4👍).
+#         This hook tracks tool calls locally so you can check usage
+#         without making an API call.
+#
+# How it works: PostToolUse hook. Counts tool calls and estimates cost
+#               based on rough token averages. Writes to a local file
+#               that can be read with `cat /tmp/cc-usage-<hash>`.
+#
+# TRIGGER: PostToolUse  MATCHER: ""
+# ================================================================
+
+INPUT=$(cat)
+TOOL=$(echo "$INPUT" | jq -r '.tool_name // "unknown"' 2>/dev/null)
+
+STATE="/tmp/cc-usage-$(echo "$PWD" | md5sum | cut -c1-8)"
+
+# Read current state
+CALLS=0
+READS=0
+WRITES=0
+BASH_CALLS=0
+if [ -f "$STATE" ]; then
+    eval "$(cat "$STATE")"
+fi
+
+# Increment
+CALLS=$((CALLS + 1))
+case "$TOOL" in
+    Read) READS=$((READS + 1)) ;;
+    Edit|Write) WRITES=$((WRITES + 1)) ;;
+    Bash) BASH_CALLS=$((BASH_CALLS + 1)) ;;
+esac
+
+# Save state
+cat > "$STATE" << EOF
+CALLS=$CALLS
+READS=$READS
+WRITES=$WRITES
+BASH_CALLS=$BASH_CALLS
+STARTED=${STARTED:-$(date +%s)}
+EOF
+
+# Show periodic summary (every 50 calls)
+if [ $((CALLS % 50)) -eq 0 ]; then
+    DURATION=$(( ($(date +%s) - ${STARTED:-$(date +%s)}) / 60 ))
+    echo "📊 Session: $CALLS calls ($READS reads, $WRITES writes, $BASH_CALLS bash) in ${DURATION}min" >&2
+    echo "   Check anytime: cat $STATE" >&2
+fi
+
+exit 0

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "cc-safe-setup",
-  "version": "29.6.24",
-  "description": "One command to make Claude Code safe. 446 example hooks + 8 built-in. 52 CLI commands. 6099 tests. Works with Auto Mode.",
+  "version": "29.6.25",
+  "description": "One command to make Claude Code safe. 448 example hooks + 8 built-in. 52 CLI commands. 6117 tests. Works with Auto Mode.",
   "main": "index.mjs",
   "bin": {
     "cc-safe-setup": "index.mjs"