Add claude-code-spring module: CLAUDE.md, a path-scoped rule, two skills, four hooks run against real hook JSON, project .mcp.json from the claude mcp CLI, and tests that lint the setup on Spring Boot 4.2.0

Co-Authored-By: Claude Sonnet 5.5 <[email protected]>
Claude-Session: https://claude.ai/code/session_017ic4b86yyhhudsSLnwNUFY
This commit is contained in:
Ankur Mhatre
2026-11-22 02:05:35 +05:30
co-authored by Claude Sonnet 5.5
parent a620d91d0a
commit 3aa20a1dce
40 changed files with 1175 additions and 0 deletions
@@ -0,0 +1,15 @@
// The same deny rules as guard-bash.sh, written as a JDK 25 compact source file (JEP 512, final in 25).
// Run by the hook as: java ${CLAUDE_PROJECT_DIR}/.claude/hooks/GuardBash.java
// It exists to measure what a JVM hook costs next to bash + jq. It does not parse JSON properly.
void main() throws Exception {
String in = new String(System.in.readAllBytes());
var m = java.util.regex.Pattern.compile("\"command\"\\s*:\\s*\"((?:[^\"\\\\]|\\\\.)*)\"").matcher(in);
String cmd = m.find() ? m.group(1) : "";
String reason = null;
if (cmd.contains("mvn deploy") || cmd.contains("mvn release:")) reason = "Publishing artifacts is a human decision.";
else if (cmd.contains("git push --force") || cmd.contains("git push -f")) reason = "Force-pushing is blocked in this project.";
else if (cmd.contains("rm -rf")) reason = "rm -rf is blocked.";
if (reason != null) {
System.out.println("{\"hookSpecificOutput\":{\"hookEventName\":\"PreToolUse\",\"permissionDecision\":\"deny\",\"permissionDecisionReason\":\"" + reason + "\"}}");
}
}
+23
View File
@@ -0,0 +1,23 @@
#!/bin/bash
# PreToolUse hook for the Bash tool. Reads the hook JSON on stdin (needs jq).
# Denies a few commands by returning a permissionDecision, which Claude sees as the reason.
COMMAND=$(jq -r '.tool_input.command // empty')
deny() {
jq -n --arg reason "$1" '{
hookSpecificOutput: {
hookEventName: "PreToolUse",
permissionDecision: "deny",
permissionDecisionReason: $reason
}
}'
exit 0
}
case "$COMMAND" in
*"mvn deploy"*|*"mvn release:"*) deny "Publishing artifacts is a human decision. Run mvn verify instead." ;;
*"git push --force"*|*"git push -f"*) deny "Force-pushing is blocked in this project." ;;
*"rm -rf"*) deny "rm -rf is blocked. Delete specific files instead." ;;
*"| sh"*|*"| bash"*) deny "Piping downloaded text into a shell is blocked." ;;
esac
exit 0
+22
View File
@@ -0,0 +1,22 @@
#!/bin/bash
# PreToolUse hook for Edit|Write|MultiEdit. Exit code 2 blocks the call and sends stderr to Claude.
INPUT=$(cat)
TOOL=$(echo "$INPUT" | jq -r '.tool_name // empty')
FILE=$(echo "$INPUT" | jq -r '.tool_input.file_path // empty')
# Production config is never edited by the agent.
case "$FILE" in
*application-prod.*|*/.env|*/.env.*)
echo "Blocked: $FILE is production configuration. Ask the user to change it." >&2
exit 2 ;;
esac
# An applied Flyway migration is immutable. Creating a new V<n> file is fine, changing an existing one is not.
case "$FILE" in
*/db/migration/V*.sql)
if [ "$TOOL" != "Write" ] || [ -e "$FILE" ]; then
echo "Blocked: $FILE is an existing Flyway migration. Add a new V<next>__*.sql file instead." >&2
exit 2
fi ;;
esac
exit 0
+18
View File
@@ -0,0 +1,18 @@
#!/bin/bash
# Stop hook. Refuses to let Claude finish while the full suite is red.
INPUT=$(cat)
if [ "$(echo "$INPUT" | jq -r '.stop_hook_active')" = "true" ]; then
exit 0 # we already pushed Claude back once this turn; let it stop and report
fi
ROOT="${CLAUDE_PROJECT_DIR:-$(pwd)}"
cd "$ROOT" || exit 0
OUT=$(mvn -B -q test 2>&1)
if [ $? -ne 0 ]; then
SUMMARY=$(echo "$OUT" | awk '/^\[ERROR\] (Failures|Errors):/{p=1} p{print} p&&/^\[ERROR\] Tests run:/{exit}' | head -20)
[ -z "$SUMMARY" ] && SUMMARY=$(echo "$OUT" | grep -E '^\[ERROR\]' | grep -v -E 'Help 1|re-run Maven|For more information|full stack trace|See .*surefire|MojoFailure|^\[ERROR\] *$' | head -8)
[ -z "$SUMMARY" ] && SUMMARY=$(echo "$OUT" | tail -8)
jq -n --arg r "The test suite is red. Fix it before finishing:
$SUMMARY" '{decision: "block", reason: $r}'
fi
exit 0
+30
View File
@@ -0,0 +1,30 @@
#!/bin/bash
# PostToolUse hook for Edit|Write|MultiEdit. Runs the test class that matches the edited Java file.
# Green: silent, exit 0. Red: failure lines on stderr and exit 2, which Claude Code shows to Claude.
INPUT=$(cat)
FILE=$(echo "$INPUT" | jq -r '.tool_input.file_path // empty')
case "$FILE" in *.java) ;; *) exit 0 ;; esac
BASE=$(basename "$FILE" .java)
case "$BASE" in
*Test) TESTCLASS="$BASE" ;;
*) TESTCLASS="${BASE}Test" ;;
esac
ROOT="${CLAUDE_PROJECT_DIR:-$(pwd)}"
cd "$ROOT" || exit 0
if ! find src/test -name "${TESTCLASS}.java" | grep -q .; then
exit 0 # no matching test class: nothing to run
fi
OUT=$(mvn -B -q test -Dtest="$TESTCLASS" -Dsurefire.failIfNoSpecifiedTests=false 2>&1)
STATUS=$?
if [ $STATUS -ne 0 ]; then
echo "Tests failed after editing $(basename "$FILE") ($TESTCLASS):" >&2
# Surefire's "Failures:" block carries the assertion messages (expected/actual); prefer it.
FOUND=$(echo "$OUT" | awk '/^\[ERROR\] (Failures|Errors):/{p=1} p{print} p&&/^\[ERROR\] Tests run:/{exit}' | head -20)
[ -z "$FOUND" ] && FOUND=$(echo "$OUT" | grep -E '^\[ERROR\]' | grep -v -E 'Help 1|re-run Maven|For more information|full stack trace|See .*surefire|MojoFailure|^\[ERROR\] *$' | head -15)
if [ -n "$FOUND" ]; then echo "$FOUND" >&2; else echo "$OUT" | tail -15 >&2; fi
exit 2
fi
exit 0