feat: support linting (opinionated) spec generation

[lrstanley]

Could use something like this for an automated approach, but may be painful for users:

https://github.com/IBM/openapi-validator

Could also have some of our own builtin, with a configuration option which allows enforcing? Things like:

• All schemas, edges, fields must have a comment
• All fields must have an example
• ??