Generate OpenAPI definitions automatically from Go code

There is an openAPI definition available in the repository, but there is nothing checking that it is maintained up to date with the actual implementation.

Consider strategies to maintain this definition updated.

Start by locating the repository's existing OpenAPI definition and the Go implementation it describes, then compare how each is maintained today. Research generation and validation strategies that could keep the definition aligned with the implementation. Done means the repository has an agreed, repeatable way to detect or generate updates automatically.

Written by the indexing model from the issue text.