feat: generate swagger doc during release GitHub action

[jpmcb]

Just wondering if we can add an automated step to the release to generate the swagger.yml before deploying a new release?

Yeah, we need that: the generated swagger is new and is used to create the go-client (which in turn is used to create the pizza-cli). So really, there would just need to be a step that generates the swagger doc during release and commits it (probably as part of our releaser action)

Originally posted by @jpmcb in https://github.com/open-sauced/api/issues/316#issuecomment-1727947102