spotlight-validator
A browser governance playground — lint, explore, and edit, with no backend.
spotlight-validator runs the published @spotlight-rules/spotlight-* engine
entirely in your browser — paste or load an artifact and see governance findings
instantly. It's powered by Spotlight, not a hosted service: nothing is sent to a server to lint.
What it does
- Eleven artifact types — APIs.json, OpenAPI, MCP, Arazzo, AsyncAPI, JSON Schema, JSON Structure, JSON-LD, Plans, Rate Limits, and FinOps.
- Search APIs.io and load real artifacts straight into the editor as a first-class consumer of the APIs.io API.
- Best-of-breed rules compiled from the first-party API Evangelist ruleset plus public, redistribution-compatible Spectral rulesets — grouped by the experience they improve (documentation, security, error-handling, consistency, …).
- Results grouped and explorable — collapse by experience area, hover a finding for its full description, and jump to the line it applies to.
- Edit rules live — override, disable, or re-enable any rule; a Rules tab lists every rule per artifact with enable/disable toggles.
- Local-first persistence — your artifacts and rule overrides autosave to your browser; a Config tab holds keys for upcoming Save-to-Git and AI features.
- YAML ⇄ JSON toggle that converts the artifact in place.
The rules
Every rule it applies is documented in spotlight-spec — browse the full catalog by artifact, each with its tags, where it applies, and a detail page.