Lint-clean OpenAPI 3.1 documentation

OpenAPI 3.1 contract with three operations, reusable schemas, response examples, a readable reference, sample requests, and zero Spectral lint findings.