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.
casesis the repository the examples are drawn from: every operation’s examples are its capability’s benchmark cases against that index;Nonerenders 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.