Open source · Automation & Workflows

Event Schema Registry Linter

Lint event names, payload versions and compatibility rules in a small registry.

v0.1.0 · Node.js 22+ · MIT

Browse the public repository · View releases

Lint a directory of event declarations — names, owners, version sequences and versioned payload schemas — and check every version against the one before it under an explicitly chosen compatibility mode. Where a change breaks the mode, the report names the producers and consumers most likely to notice first, as candidates.

This walkthrough uses the tool's public README and checked-in example files. Run the command from a repository checkout with Node.js 22+.

Run the checked-in example

node bin/event-schema-registry-linter.mjs --registry examples/registry --config examples/linter.config.json

Read the result

stdout carries the report and nothing else; stderr carries diagnostics.

Scope

maxDepth 8, maxEvents 500, maxFields 500, maxFileBytes 262144, maxSchemaDepth 12, maxVersions 50, timeoutMs 10000. Each has a command-line flag. Exceeding one produces an incomplete report with a finding naming the limit — never a quietly shorter answer.