Skip to main content

Module openapi

Module openapi 

Source
Expand description

The OpenAPI projection: an OpenAPI 3.1 document built from the registry and nothing else. operationId is the canonical id; every operation carries the canonical id, kind, stability, policies and the other projections as x-majordomus-* extensions so that a reader can reconcile it against MCP and the CLI. The tags are the modules; the examples are the capabilities’ own benchmark cases, so an operation without an example is an operation without a case, and the executable will not compile in that state; the error responses are the statuses the router maps crate::capability::CapabilityError to, by kind. Deterministic: every map is sorted, nothing carries a timestamp.

Constants§

OAS_DIALECT
The schema dialect declared: OpenAPI 3.1’s base dialect, which is JSON Schema 2020-12 plus the OAS vocabulary, and the only value Swagger UI accepts without a warning.
OPENAPI_VERSION
The OpenAPI version emitted.

Functions§

document
The OpenAPI document of the registry. cases is the repository the examples are drawn from: every operation’s examples are its capability’s benchmark cases against that index; None renders the document without examples, for a registry that has no repository behind it. Fails only on a schema component name defined twice with different content.
infrastructure_routes
The routes that are the projection’s own rather than capabilities, read from the surfaces that declare them: where each answers, what it is, and whether a publication can carry it.
render
Serialise deterministically, pretty, with a trailing newline.