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.
This walkthrough uses the tool's public README and checked-in example files. Run the command from a repository checkout with Node.js 22+; inspect the source before using it on your own files.
Run the checked-in example
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 checkRead the result
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 TOOLID and evaluateReference for direct use. See schema, rules and limits.
Where this check stops
This local walkthrough does not establish the state of a live production system or replace the limits documented in the repository.
Before adapting the command to your own workflow, review the accepted inputs, exit codes and safety boundaries in the README.
Compiled with AI assistance from checked-in public documentation and example scripts. Run the example and review the repository's current documentation before relying on its result.