pub async fn build_openapi_document(state: &ApiState) -> Result<Value, Response>Expand description
Refresh, build, and gateway-augment the OpenAPI document, returning the
raw Value rather than a Response. openapi_json wraps this directly;
the composition root (apps/soma) also calls it so it can layer its own
route augmentation (e.g. Palette’s /v1/palette/*) on top without
soma-api depending on a peer product-surface crate.