chore: export openapi schema (#3419)

- Exports OpenAPI schema as a YAML file inside new `schemas` directory.
- Adds a `hatch` command to accomplish this.
- Adds CI to ensure that the exported schema is up to date with the code.