# gRPC advanced capability support matrix Every capability in `:grpc-advanced:*`, its grade, and what it would take to raise it. `GrpcAdvancedSupportMatrix` is the machine-readable form; `GrpcAdvancedCapability.defaultGrade` carries the same values. All capabilities are off by default. Flags are `app.grpc.advanced..enabled`. ## Grades | Grade | May start | Production needs a separate approval | | --- | --- | --- | | `ADVANCED_STABLE` | Yes | No | | `EXPERIMENTAL` | Yes | Yes | | `WATCH` | No | — | | `DISABLED` | No | — | ## Capabilities | Capability | Flag | Grade | Real infrastructure its evidence needs | | --- | --- | --- | --- | | Protobuf Edition 2024 | `edition-2024` | `ADVANCED_STABLE` | — | | Protobuf Edition 2026 | `edition-2026` | `WATCH` | — | | Client streaming | `client-streaming` | `ADVANCED_STABLE` | — | | Bidirectional streaming | `bidi-streaming` | `ADVANCED_STABLE` | — | | Manual flow control | `manual-flow-control` | `ADVANCED_STABLE` | — | | Read-only unary hedging | `hedging` | `EXPERIMENTAL` | — | | Custom name resolver | `custom-resolver` | `ADVANCED_STABLE` | — | | Custom load balancer | `custom-load-balancer` | `EXPERIMENTAL` | — | | Proxyless xDS | `xds` | `EXPERIMENTAL` | xDS control plane | | gRPC-Web | `grpc-web` | `ADVANCED_STABLE` | gRPC-Web proxy | | Servlet HTTP/2 | `servlet-compat` | `ADVANCED_STABLE` (flag only; no Servlet transport code since 2026-09-25) | Servlet container | | Spring Integration bridge | `integration-bridge` | `ADVANCED_STABLE` | — | | Reactor adapter | `reactor` | `ADVANCED_STABLE` | — | | Kotlin coroutine / Flow | `kotlin` | `ADVANCED_STABLE` | Kotlin toolchain | | Channelz / CSDS diagnostics | `channel-diagnostics` | `ADVANCED_STABLE` | — | ## What the grades mean here, concretely **Grade is a statement about the contract, not about a deployment.** Every capability's contract is implemented and tested in this repository. What no capability has is evidence from a real deployment: `GrpcAdvancedPromotionEvidence` for each one is empty, and no promotion has been granted. **Four capabilities cannot produce meaningful evidence here at all**, because the infrastructure they need is absent (gRPC-Web proxy, Servlet container, xDS control plane, Kotlin toolchain), and a suite that runs without its infrastructure passes and establishes nothing. **Kotlin is the sharpest case.** This repository has no Kotlin toolchain, so Kotlin is not supportable here until one exists. Only the Java-side coroutine cancellation bridge (`GrpcCoroutineContextBridge`) is implemented and tested; there is no compile lane. ## Promotion thresholds | To | Soak | Also required | | --- | --- | --- | | `ADVANCED_STABLE` | 7 days | compatibility evidence, security review, fault evidence, performance evidence, ADR, runbook, real-environment test | | Stable default | 30 days | all of the above, plus a dependency, security and operational-cost review | `WATCH` becomes `EXPERIMENTAL` before anything else. Promotions are independent: promoting one capability changes no other's grade.