cc-safe-setup 3.6.0 → 3.6.1

package/README.md

@@ -220,6 +220,9 @@ Or browse all available examples in [`examples/`](examples/):
 - **verify-before-commit.sh** — Block git commit when lint/test commands haven't been run ([#37818](https://github.com/anthropics/claude-code/issues/37818))
 - **hook-debug-wrapper.sh** — Wrap any hook to log input/output/exit code/timing to `~/.claude/hook-debug.log`
 - **loop-detector.sh** — Detect and break command repetition loops (warn at 3, block at 5 repeats)
+- **commit-quality-gate.sh** — Warn on vague commit messages ("update code"), long subjects, mega-commits
+- **session-handoff.sh** — Auto-save git state and session info to `~/.claude/session-handoff.md` on session end
+- **diff-size-guard.sh** — Warn/block when committing too many files at once (default: warn at 10, block at 50)
 
 ## Safety Checklist
 

package/examples/diff-size-guard.sh

@@ -0,0 +1,61 @@
+#!/bin/bash
+# ================================================================
+# diff-size-guard.sh — Warn on large uncommitted changes
+# ================================================================
+# PURPOSE:
+#   Claude Code can modify dozens of files in a single session
+#   without committing. By the time you notice, the diff is
+#   unmanageable. This hook warns when the working tree has
+#   too many changed files.
+#
+# TRIGGER: PreToolUse
+# MATCHER: "Bash"
+#
+# WHEN IT FIRES:
+#   On git commit — checks if the commit is too large
+#   Configurable thresholds via environment variables
+#
+# CONFIGURATION:
+#   CC_DIFF_WARN=10    — warn when staging 10+ files (default)
+#   CC_DIFF_BLOCK=50   — block when staging 50+ files (default)
+# ================================================================
+
+INPUT=$(cat)
+COMMAND=$(echo "$INPUT" | jq -r '.tool_input.command // empty' 2>/dev/null)
+
+if [[ -z "$COMMAND" ]]; then
+    exit 0
+fi
+
+# Only check git commit and git add
+if ! echo "$COMMAND" | grep -qE '^\s*git\s+(commit|add\s+(-A|--all|\.))'; then
+    exit 0
+fi
+
+# Check number of changed files
+if ! command -v git &>/dev/null || ! [ -d .git ]; then
+    exit 0
+fi
+
+WARN="${CC_DIFF_WARN:-10}"
+BLOCK="${CC_DIFF_BLOCK:-50}"
+
+# Count staged + unstaged changed files
+CHANGED=$(git diff --name-only HEAD 2>/dev/null | wc -l)
+STAGED=$(git diff --cached --name-only 2>/dev/null | wc -l)
+TOTAL=$((CHANGED + STAGED))
+
+if [ "$TOTAL" -ge "$BLOCK" ]; then
+    echo "BLOCKED: $TOTAL files changed — too large for one commit." >&2
+    echo "" >&2
+    echo "Break this into smaller, reviewable commits:" >&2
+    echo "  git add src/feature/ && git commit -m 'feat: add feature'" >&2
+    echo "  git add tests/ && git commit -m 'test: add feature tests'" >&2
+    echo "" >&2
+    echo "Set CC_DIFF_BLOCK to adjust the limit (current: $BLOCK)." >&2
+    exit 2
+elif [ "$TOTAL" -ge "$WARN" ]; then
+    echo "WARNING: $TOTAL files changed. Consider splitting into smaller commits." >&2
+fi
+
+exit 0

package/index.mjs

@@ -350,6 +350,9 @@ function examples() {
       'tmp-cleanup.sh': 'Clean up /tmp/claude-*-cwd files on session end',
       'hook-debug-wrapper.sh': 'Wrap any hook to log input/output/exit/timing',
       'loop-detector.sh': 'Detect and break command repetition loops',
+      'session-handoff.sh': 'Auto-save session state for next session resume',
+      'commit-quality-gate.sh': 'Warn on vague or too-long commit messages',
+      'diff-size-guard.sh': 'Warn/block on large diffs (10+ files warn, 50+ block)',
     },
   };
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "cc-safe-setup",
-  "version": "3.6.0",
+  "version": "3.6.1",
   "description": "One command to make Claude Code safe for autonomous operation. 8 built-in hooks + 34 examples. Create, audit, lint, diff, share, watch, learn. Session handoff, loop detection, commit quality gate.",
   "main": "index.mjs",
   "bin": {