cc-safe-setup 3.5.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/examples/session-handoff.sh

@@ -0,0 +1,106 @@
+#!/bin/bash
+# ================================================================
+# session-handoff.sh — Auto-save session state for next session
+# ================================================================
+# PURPOSE:
+#   When a Claude Code session ends (Stop event), automatically
+#   captures the current state and writes a handoff file that the
+#   next session can read to resume work.
+#
+#   Solves the "I forgot what I was doing" problem after /compact
+#   or session restart.
+#
+# TRIGGER: Stop
+# MATCHER: ""
+#
+# WHAT IT CAPTURES:
+#   - Current git branch and uncommitted changes
+#   - Last 5 commands from shell history
+#   - Modified files (git diff --stat)
+#   - Current working directory
+#   - Timestamp
+#
+# OUTPUT: ~/.claude/session-handoff.md
+#   Next session can read this to understand where the last one left off.
+#
+# CONFIGURATION:
+#   CC_HANDOFF_FILE — path to handoff file
+#     default: ~/.claude/session-handoff.md
+# ================================================================
+
+HANDOFF="${CC_HANDOFF_FILE:-$HOME/.claude/session-handoff.md}"
+
+# Detect project directory from recent tool calls
+PROJECT_DIR=""
+if [ -d ".git" ]; then
+    PROJECT_DIR="$(pwd)"
+elif [ -f "$HOME/.claude/projects" ]; then
+    PROJECT_DIR=$(ls -td "$HOME/.claude/projects/"*/ 2>/dev/null | head -1)
+fi
+
+{
+    echo "# Session Handoff"
+    echo ""
+    echo "**Last session ended:** $(date -Iseconds)"
+    echo ""
+
+    # Git state
+    if command -v git &>/dev/null && [ -d ".git" ]; then
+        BRANCH=$(git branch --show-current 2>/dev/null || echo "unknown")
+        echo "## Git State"
+        echo "- Branch: \`$BRANCH\`"
+
+        MODIFIED=$(git diff --stat 2>/dev/null | tail -1)
+        if [ -n "$MODIFIED" ]; then
+            echo "- Changes: $MODIFIED"
+            echo ""
+            echo "### Modified files"
+            echo '```'
+            git diff --name-only 2>/dev/null | head -10
+            echo '```'
+        else
+            echo "- Changes: clean working tree"
+        fi
+
+        STAGED=$(git diff --cached --stat 2>/dev/null | tail -1)
+        if [ -n "$STAGED" ]; then
+            echo "- Staged: $STAGED"
+        fi
+
+        LAST_COMMIT=$(git log --oneline -1 2>/dev/null)
+        echo "- Last commit: $LAST_COMMIT"
+        echo ""
+    fi
+
+    # Recent blocked commands (if any)
+    BLOCK_LOG="$HOME/.claude/blocked-commands.log"
+    if [ -f "$BLOCK_LOG" ]; then
+        RECENT_BLOCKS=$(tail -3 "$BLOCK_LOG" 2>/dev/null)
+        if [ -n "$RECENT_BLOCKS" ]; then
+            echo "## Recent Blocks"
+            echo '```'
+            echo "$RECENT_BLOCKS"
+            echo '```'
+            echo ""
+        fi
+    fi
+
+    # Session errors
+    ERROR_LOG="$HOME/.claude/session-errors.log"
+    if [ -f "$ERROR_LOG" ]; then
+        RECENT_ERRORS=$(tail -3 "$ERROR_LOG" 2>/dev/null)
+        if [ -n "$RECENT_ERRORS" ]; then
+            echo "## Recent Errors"
+            echo '```'
+            echo "$RECENT_ERRORS"
+            echo '```'
+            echo ""
+        fi
+    fi
+
+    echo "---"
+    echo "*Auto-generated by session-handoff hook. Read this at session start to resume.*"
+
+} > "$HANDOFF"
+
+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,7 +1,7 @@
 {
   "name": "cc-safe-setup",
-  "version": "3.5.0",
-  "description": "One command to make Claude Code safe for autonomous operation. 8 built-in hooks + 33 examples. Create, audit, lint, diff, share, watch, learn. 2,500+ daily npm downloads.",
+  "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": {
     "cc-safe-setup": "index.mjs"