/v2 API surface for the Go scaffold. This
docs UI is generated from the same OpenAPI contracts that generate Go model
types:
openapi/openapi.public.yamlopenapi/openapi.ops.yaml
mint validate during build and again before serving the
local preview. That validation includes the OpenAPI files referenced by
docs.json, so API docs break loudly when the spec is invalid.
The current v2 phase is design-first. Generated server handlers are still out of
scope until product endpoints have real backing behavior.