Add Spectral schemas to the Registry

[kinlane]

May I suggest adding the following API schema to the registry by default -- selfishly so I can link to your version of them when talking about the schema registry.

• Spectral Rules - https://github.com/stoplightio/spectral/blob/develop/packages/core/src/ruleset/meta/rule.schema.json
• Spectral Rulesets - https://github.com/stoplightio/spectral/blob/develop/packages/core/src/ruleset/meta/ruleset.schema.json
• Vacuum Rules - https://github.com/daveshanley/vacuum/blob/main/rulesets/schemas/rule.schema.json
• Vacuum Rulesets - https://github.com/daveshanley/vacuum/blob/main/rulesets/schemas/ruleset.schema.json
• APIs.json - https://github.com/apis-json/api-json/blob/develop/spec/schema_0.19.yml

[jviotti]

Absolutely! I'll aim to connect them all today and let you know

[jviotti]

@kinlane Here you have APIs.json (pretty easy to integrate, well done!)

https://schemas.sourcemeta.com/apis-json

And the latest version of Vacuum. I'll add the previous version throughout the day:

https://schemas.sourcemeta.com/pb33f/vacuum

[jviotti]

The Spectral ones are a bit more tricky. Their schemas seems to have some issues that choke my (pretty strict) tooling. A good stress test nevertheless. I'll aim to make them work today.

[jviotti]

@kinlane Also, completely aside, but I might send a couple of PRs to the APIs.json schema for bumping up the quality of schemas, integrate linting, etc. In the short-term future, I will be extending the registry to perform automatic health analysis of all the ingested schemas and score them. The scoring will be public and will affect i.e. the search result priority, etc so will make sure you get a 100% score ;)

[kinlane]

You are the best. An understood on the challenges with Spectral -- I've had same. I also agree on low quality of APIs.json schema, but also repo. On my list to improve and invest in. Any help is always appreciated. Thankful for this work.

[jviotti]

@kinlane Any time! As a minor update, ALL versions of Vacuum are up: https://schemas.sourcemeta.com/pb33f/vacuum. I'll be looking more into Spectral next.

[jviotti]

As another update, looks like there are indeed various problems with the Spectral schemas and are not valid Draft 7 schemas. I'll file an issue, as I don't think there is any reasonable way to coerce them to work as-is.

[kinlane]

I am glad you hit the same wall with it. I found it was a very complex, weird, and difficult to work with.

[jviotti]

@kinlane Here is the upstream issue: stoplightio/spectral#2787. Nothing unfixable. Just minor things! Hopefully we get it fixed soon. Thanks for raising this!

[jviotti]

I sent a PR: stoplightio/spectral#2788

[bavulapati]

@jviotti I sent a PR to fix the CI failures on your spectral PR.
PTAL.

[jviotti]

Awesome! Thanks! Please send it over upstream (to Spectral) rather than my fork, so we can properly fix it there!