Specification

Suluk is a candidate exploration of OpenAPI v4.0 "Moonwalk" — an independent, single-contributor draft of the next OpenAPI. It is not the official specification and not SIG-ratified. This section is the specification itself: the object model, request signatures, parameters, responses, schemas, components, and security.

• The Specification — the full candidate document (sections 1–9).
• Design notes — Signatures · Templating · Parameters · Collections.
• Conformance — the valid/invalid test corpus + runner.
• Confidence & Soft Points — the honestly-low-ceiling parts.
• Reference Core — Rust — the suluk-core performance implementation.
• Moonwalk Priors — the upstream OAI source these decisions inherit from.

Associated files

• Meta-schema — v4-meta-schema.json
• TypeScript types — v4-types.ts (the v4 document object model)
• Example document — petstore.suluk.yaml
• Conformance corpus — conformance/

The specification is a projection of the decision ledger (ADRs, C001–C053), not the source of truth — see Architecture.