jdx_diff
Compare two JVM artifacts (old vs. candidate) to detect public-API changes and named binary-compatibility breaks, ordered with breaking changes first.
Instructions
What changed between two artifacts? Public-API diff with named binary-compatibility rules (MEMBER_REMOVED, RETURN_TYPE_CHANGED, ...), most breaking first. query is the OLD artifact and new the candidate; each is a jar, class dir, glob, or Maven coordinate. Exits 0 whenever the comparison ran.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"query": "<query>",
"new": "<new>"
},
"name": "jdx_diff"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| new | Yes | The NEW (candidate) artifact, compared against `query`. | |
| limit | No | Maximum rows shown (default 200); the rest become a truncation footer. | |
| query | Yes | The OLD (baseline) artifact: jar file, class directory, glob, or group:artifact:version. | |
| failOn | No | none (default, always 0), breaking (exit 1 on a breaking change) or any (exit 1 on any difference). | |
| severity | No | How much to print: all (default), suspicious (breaking and suspicious), or breaking only. The tally always describes everything. | |
| workspace | No | Named workspace to answer from (default: the workspace the server was started with). Stored workspaces only. | |
| visibility | No | public (default: public and protected declarations) or all (every declared type and member). | |
| includeSynthetic | No | Compare bridge/synthetic members too, hidden by default. |