docs/exp/SER009.md
RESPite.Transports.DuplexTransport (and TransportReceiver) are an experimental transport
abstraction: staged-and-flushed outbound (the transport itself is the IBufferWriter<byte>), push
inbound with transport-owned memory, and an explicit batch-end notification. They exist to let
alternative IO engines plug in beneath the library (see Tunnel.ConnectTransportAsync) without being
constrained to Stream or pipe semantics.
This API is not intended for external use at this time. It exists to support internal experimentation with alternative transports, and is public only because a seam has to be public to be implemented. Specifically:
[Experimental] diagnostic (SER009) is the enforcement mechanism: suppressing it is you
signing up to the above.If a transport seam useful beyond this experiment emerges, it will be stabilised deliberately — with
its own announcement and a removed [Experimental] marker — rather than by this surface quietly
hardening into a contract.