/java-commit

description: Generates a Conventional Commits message for staged Java changes. Use when user asks to "write a commit message", "help me commit", "what should my commit say", "summarize my changes", "draft a commit", or "create commit message".
argument-hint: "[leave empty to use git diff, or describe the change]"

Generate a git commit message for the current Java changes. Use the Conventional Commits format tailored to Java/Spring projects.

Step 1 — Gather context

Run (or ask Claude to run): `git diff --staged --stat` to see which files changed. If nothing is staged, check `git diff --stat` for unstaged changes.

Step 2 — Analyse the changes

Based on the changed files, determine:

• **Type of change**: feat, fix, refactor, test, docs, chore, perf, security
• **Scope**: the Java package, module, or layer affected (e.g., `service`, `controller`, `repository`, `security`)
• **What changed**: specific class names, method names, or behaviours

Step 3 — Generate commit message

Use this format:

<type>(<scope>): <imperative summary under 72 chars>

[optional body — what changed and why, not how]

[optional footer — breaking changes, issue references]

Java-specific type rules:

• `feat`: new class, method, endpoint, or feature
• `fix`: bug fix in logic, null check, exception handling
• `refactor`: extract method, rename, restructure — no behaviour change
• `perf`: N+1 fix, index added, caching, virtual threads
• `test`: new or updated JUnit/Mockito/Testcontainers tests
• `security`: OWASP fix, auth change, secret handling improvement
• `chore`: dependency update, build config, version bump

Java-specific scope examples:

• `user-service`, `order-controller`, `payment-repository`
• `auth`, `security`, `jpa`, `api`, `dto`
• `pom`, `gradle`, `ci`

Examples:

feat(user-service): add findByEmail with case-insensitive search

Adds UserService.findByEmail() using Spring Data derived query.
Returns Optional<User> to handle missing users without null checks.

fix(order-controller): return 404 when order not found instead of 500

Previously threw NullPointerException when order ID did not exist.
Now throws ResourceNotFoundException mapped to 404 by GlobalExceptionHandler.

perf(product-repository): fix N+1 query with @EntityGraph on findAll

Each product was triggering a separate query for its category.
Added @EntityGraph(attributePaths = "category") to load in one JOIN.

refactor(auth-service): replace field injection with constructor injection

Removes @Autowired field injection on JwtTokenProvider and UserDetailsService.
Constructor injection makes dependencies explicit and improves testability.

Step 4 — Output

Provide: 1. The commit message (ready to copy) 2. The git command: `git commit -m "$(cat <<'EOF'\n[message]\nEOF\n)"`

If multiple logical changes are staged together, suggest splitting into separate commits.