API Reference Freshness Checker

Compare a complete source/OpenAPI operation export with a complete reference export. Removed or changed parameters, missing sections and stale structured examples produce actionable findings. Explicitly illustrative pseudocode is excluded from example comparison. Offline, read-only Node.js 22+ tool with no dependencies.

node bin/api-reference-freshness-checker.mjs --root examples/pass --source source.json --reference reference.json
node bin/api-reference-freshness-checker.mjs --root examples/fail --source source.json --reference reference.json
npm run check

The first command exits 0. The second exits 1 with parameter-removed; its source export no longer declares a parameter shown in the reference. Unknown, partial, malformed or over-limit evidence exits 2 as incomplete and never passes. src/index.mjs exports TOOL_ID and evaluateReference for direct use. See schema, rules and limits.