Repository navigation
Spring Boot Tools v0.4.0 keeps 16 shared skills and seven MCP tools for Claude Code and Codex. Claude Code registers seven specialist agents and four hooks. This release applies a full audit of the runtime, hooks, MCP server, Codex adapter, skills, agents, evaluations and documentation.
Changes
- Security: project discovery no longer uses an ancestor build directory, wrapper or wrapper configuration (
.mvn/**,gradle/wrapper/*,gradle.properties) that another user can write; refusals are reported indiscoveryWarnings, with guidance for WSL drives mounted withoutmetadata. - Installation:
package.jsonand the lockfile moved to the plugin root, so marketplace installs now get the MCP dependencies automatically.fast-xml-parserupdated to 5.12.0;npm auditis clean. - MCP:
actuator_healthandopenapi_endpointsaccept only loopback hosts and report the real HTTP failure cause. POM values stay text (1.10is no longer1.1), CDATA stays literal, symlinked plugin paths connect, and builds stop when the server is closed. - Runtime and hooks: build state and locks live in
~/.cache/spring-boot-tools/with a private fallback. Guards flag only introduced literals, ask instead of deny in test paths and cover more destructive DDL and secret keys. The Stop hook verifies and warns without blocking whenstop_hook_activeis set. - Codex: JDK, Maven, Gradle and proxy variables are forwarded to the MCP process.
- Guidance: skills corrected against current sources (Spring Cloud Contract matchers, CORS bean name, API versioning, Boot 3→4 starter renames including Flyway/Liquibase, Jackson 3, support dates, CI action and image versions). Skill triggers narrowed for generic Java.
sb-architectandsb-api-designerare read-only and return their documents. - Evaluations: fixed cases that could not pass, per-criterion graders, skill-activation checks, tolerant report parsing and six new cases (not run against a model).
Upgrade and compatibility
Breaking: actuator_health and openapi_endpoints refuse non-loopback hosts. sb-architect and sb-api-designer no longer write files. Build state from earlier versions is ignored.
Update the installed plugin and restart the host. Marketplace installs install the MCP dependencies automatically. A checkout used with --plugin-dir, or a marketplace added from a local path, needs npm ci in the plugin root; remove a leftover mcp-server/node_modules (the installation doctor warns about it).
Requirements remain Node.js 20.3+, npm, Python 3.11+, Bash and Linux/macOS/WSL. The uid running the host should have a user database entry and a writable home; otherwise state falls back to a private directory in the temporary directory.
Claude Code marketplace installation:
claude plugin marketplace add https://github.com/alefiengo/spring-boot-tools
claude plugin install spring-boot-tools@spring-boot-tools-marketplaceFollow the Codex setup for its launcher and workspace configuration. Claude hooks, specialist registrations and Java LSP are not registered on Codex.
Validation and limits
Local Linux/WSL2 validation passed: 11 deterministic suites (also the Python suites on Python 3.11); real Maven 3.10.0 and Gradle 9.8.1 fixtures with JDK 25; extracted Java examples, including those changed in this release, with smoke tests, Pact compatibility (additive change accepted, breaking change rejected) and a local Gatling run; strict manifest, skill and agent validation; syntax checks; installation doctor; Codex CLI 0.167.0 protocol loading without model turns; a Claude Code 2.1.322 marketplace install that created root node_modules and connected the server; npm audit with zero vulnerabilities.
Not run: macOS (stopping a build after its hook is killed is Linux-only) and paid model evaluations. See the attached validation report.
README · Changelog · Release procedure · Security
Full changelog: v0.3.0...v0.4.0