A zero-dependency CLI that audits JSON Merge Patch documentation.

It checks RFC 7396 media type, PATCH endpoint behavior, null deletion, omitted-field semantics, array replacement, before/patch/after examples, validation, ETag/If-Match concurrency, idempotency, errors, JSON Patch distinction, patchable field allowlists, authorization/mass-assignment safety, audit logs, and SDK usage.

npx api-json-merge-patch-doctor docs/patch.md

• application/merge-patch+json / RFC 7396
• PATCH endpoint behavior
• null removes fields
• omitted fields stay unchanged
• arrays are replaced whole
• before/patch/after examples
• validation after merge
• ETag / If-Match concurrency
• idempotency
• error examples
• JSON Merge Patch vs JSON Patch
• patchable field allowlist
• authorization and mass assignment safety
• audit/change logs
• SDK/client usage

api-json-merge-patch-doctor docs/patch.md --min-score 85

MIT