feat: harden public OpenAI API contracts

2026-09-07 14:25:48 +08:00
parent 8025ed8aa0
commit 2649d64b55
36 changed files with 16643 additions and 236 deletions
@@ -0,0 +1,11 @@
+# Public API contract snapshots
+
+These generated files define **OpenAI-compatible subset v1**:
+
+- `openapi.json` describes public and admin HTTP routes.
+- `openai-realtime-client-events.schema.json` validates accepted Realtime events.
+- `openai-realtime-server-events.schema.json` validates the common server-event envelope, supported event names, and extension version.
+
+From the repository root, run `make contract-snapshots` after an intentional contract change. The contract
+test fails when generated output differs, so snapshot changes must be reviewed
+alongside implementation and documentation changes.