Add enforced V2 schemas, CBOR/COSE, and the optimized request path - #1408
Merged
crimson-knight merged 17 commits intoAug 13, 2026
Merged
Conversation
This was referenced Aug 13, 2026
crimson-knight
marked this pull request as ready for review
August 13, 2026 17:02
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
What changed
Compatibility
The existing
params.validationAPI remains functional and is only deprecated. This preserves the intended upgrade path: V1 applications can move to V2 first, then adopt controller schemas one action at a time. The docs state that removal will be no earlier than a later V2 minor such as 2.5, with the exact release announced separately.Why
The previous schema surface did not consistently enforce declared request contracts, did not validate response shape/status, and could not provide the typed contract needed for dependable OpenAPI generation. The optimized router work also lived on an older experimental line instead of the V2 release branch.
This PR makes the new contract real while preserving the old validation path for backwards compatibility.
Validation
See the human-readable Round 27 report for method, before/after results, evidence paths, and claim boundaries.
Benchmark boundary
This is a synthetic in-memory acknowledgement workload without a database, TLS termination, external services, HTML rendering, or public-internet latency. The Round 26 to Round 27 delta covers the complete integrated performance patch set, not the router alone.