Skip to content

Releases

v0.4.0 — Audit hardening and root dependency installation

Choose a tag to compare

@alefiengo alefiengo released this 11 Nov 12:57
8e636af

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 in discoveryWarnings, with guidance for WSL drives mounted without metadata.
  • Installation: package.json and the lockfile moved to the plugin root, so marketplace installs now get the MCP dependencies automatically. fast-xml-parser updated to 5.12.0; npm audit is clean.
  • MCP: actuator_health and openapi_endpoints accept only loopback hosts and report the real HTTP failure cause. POM values stay text (1.10 is no longer 1.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 when stop_hook_active is 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-architect and sb-api-designer are 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-marketplace

Follow 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

v0.3.0 — Installation diagnostics and streamlined verification

Choose a tag to compare

@alefiengo alefiengo released this 01 Nov 02:34
ba3c6cf

Spring Boot Tools v0.3.0 keeps 16 shared skills and seven MCP tools for Claude Code and Codex. Claude Code registers seven specialist agents and four hooks.

Changes

  • Remove the redundant post-edit-compile marker hook. Stop verification fingerprints current inputs, including edits outside the host's Write/Edit tools. The legacy runtime mark action is deprecated and writes no state.
  • Share migration lint in the Python runtime, preserving the intentionally different hook warning and MCP error/risk policies.
  • Add an offline installation doctor and a documented host capability matrix. Check prerequisites, bundle versions, actual ESM dependency targets and optional project discovery without installing packages or running builds.
  • Add real Maven 3.10.0 / Gradle 9.8.1 workflow fixtures covering verification reuse, module/profile scope, fresh test reports, actual JUnit failures and external edits.
  • Add offline baseline/full/skill-or-agent ablation preparation, provenance and evidence comparisons. Refine instructions to respect application versions, architecture, database and test conventions.
  • Remove repository GitHub Actions workflows, required hosted checks and automatic Dependabot updates. Use documented local checks while keeping vulnerability alerts, secret scanning and PR/history protections.

Upgrade and compatibility

Update the installed plugin bundle and its locked MCP dependencies, then restart the host to reload registrations and the MCP server. Remove any manually copied post-edit-compile registration. Stop verification remains available on Claude Code; Codex verification remains explicit. The seven MCP tool names and existing initialization safeguards are unchanged.

Requirements remain Node.js 20.3+, npm, Python 3.11+, Bash and Linux/macOS/WSL. Application builds require a compatible JDK and Maven/Gradle. Initialization requires an absent target with an existing parent; existing projects and preexisting targets are preserved and refused.

Claude Code marketplace installation:

claude plugin marketplace add https://github.com/alefiengo/spring-boot-tools
claude plugin install spring-boot-tools@spring-boot-tools-marketplace

Run npm ci in the installed plugin's mcp-server/ directory. Follow the separate 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; real Maven and Gradle fixtures with JDK 25; extracted Java smoke/architecture examples and the local Pact/Gatling lifecycle; Codex CLI 0.166.0 protocol loading without model turns; installation doctor; syntax and strict manifest/skill/agent validation; npm audit with zero vulnerabilities. The plugin-directory validator additionally reports a non-blocking missing-icon warning for directory submission.

GitHub Actions did not run. macOS execution, production acceptance and live comparative model usefulness are not claimed. The offline ablation harness currently targets Claude skills/agents, not automatic hook/MCP/LSP removal or Codex model behavior. No paid model evaluations were performed. See the attached validation report for commands and environment.

README · Changelog · Release procedure · Security

Full changelog: v0.2.0...v0.3.0

v0.2.0 — Safe initialization and Codex support

Choose a tag to compare

@alefiengo alefiengo released this 01 Nov 01:42
49acb89

Spring Boot Tools now supports Claude Code and Codex with 16 shared skills and seven MCP tools.

Added

  • Explicit Spring Initializr project creation with existing-project protection, bounded ZIP validation, private staging and atomic publication.
  • Codex compatibility manifest, separate MCP configuration and a launcher preserving the application workspace.
  • Deterministic initialization and adapter regressions, isolated Codex protocol checks and a documented multi-agent maintenance workflow.

Fixed

  • Process-group cancellation, report collection/transport limits and structured error diagnostics.
  • Maven profile-module coordination, Gradle module mapping and source/report scans for build/target names.
  • Actuator health-document validation, JWT audiences, CI token permissions and coordinated migration verification.
  • Zod dependency vulnerability GHSA-mrhx-c7xc-m3w5 (updated to 4.6.7).

Validation

PR #2 was merged using an explicitly authorized exception to the required status checks because GitHub rejects workflow dispatch with Actions has been disabled for this user. GitHub CI did not run; Linux/macOS matrix validation is not claimed. The original main protection rules were restored and verified immediately after merge. This release targets merged commit 49acb8981bd9bc4277c140201defad340e957780. Local checks cover 11 suites, a real Initializr generation/refusal, Codex CLI 0.166.0 protocol loading without model turns, Java smoke tests, Pact compatibility and a local Gatling run. npm audit reports zero current vulnerabilities.

Requirements and compatibility

Node.js 20.3+, npm, Python 3.11+, Bash and Linux/macOS/WSL. Application builds require a compatible JDK and Maven/Gradle.

Initialization requires a nonexistent target with an existing parent. Existing projects and even empty preexisting targets are preserved and refused. Generation never executes builds.

Codex must use the documented launcher. Claude hooks, agents and Java LSP are not registered on Codex; full verification is explicit. Codex CLI 0.166.0 was checked; other CLI/desktop flows remain unvalidated. No paid behavioral evaluation or production acceptance is claimed.

Installation

Claude Code:

claude plugin marketplace add https://github.com/alefiengo/spring-boot-tools
claude plugin install spring-boot-tools@spring-boot-tools-marketplace

Install the server dependencies with npm ci in the plugin's mcp-server directory. For Codex, follow the separate launcher and local marketplace instructions in Codex setup.

See the README, changelog, audit and security policy.

Full changelog: v0.1.0...v0.2.0

v0.1.0 — Initial public version

Choose a tag to compare

@alefiengo alefiengo released this 07 Oct 16:48
c23a87b

First public version of Spring Boot Tools for Claude Code.

Included

  • 15 skills for Spring Boot development, testing, security, persistence, observability, performance and delivery.
  • Seven specialist agents with scoped design, review and test-writing roles.
  • Five hooks for configuration guards, migration lint and coordinated verification.
  • Six MCP tools for project inspection, builds, tests, migrations, OpenAPI and Actuator.
  • Shared Maven/Gradle discovery, project locking and verification reuse.
  • Deterministic regressions, executable Java/Pact/Gatling examples and behavioral evaluation fixtures.

Requirements

Node.js 20.3+, npm, Python 3.11+ and Bash on Linux, macOS or WSL. Application builds need a compatible JDK and Maven/Gradle. Java language-server diagnostics additionally need an installed jdtls launcher.

Installation

claude plugin marketplace add https://github.com/alefiengo/spring-boot-tools
claude plugin install spring-boot-tools@spring-boot-tools-marketplace

Install the server dependencies with npm ci in the installed plugin's mcp-server/ directory. See the README for local installation and usage, and SECURITY.md for trust boundaries and private reporting.