feat(quic): add qlog observer infrastructure for interop diagnostics
Hooks every QUIC protocol decision (packets sent / received / dropped,
TLS key updates, transport params, ALPN, loss detection, PTO, close)
into a [QlogObserver] interface. Production callers default to
[QlogObserver.NoOp] (zero allocation, single virtual call); the
:quic interop runner wires a [QlogWriter] writing JSON-NDJSON
(qlog 0.3 / JSON-SEQ format) to `<QLOGDIR>/client.sqlog`, consumable
by qvis (https://qvis.quictools.info/) and Wireshark. Goal: every
interop-runner test failure produces a qlog file the operator can
drop into qvis to see exactly what we did differently from the spec.
Hooked call sites:
- QuicConnection.start → connection_started, parameters_set(local), version_information
- QuicConnection.close → connection_closed(local)
- QuicConnection.markClosedExternally → connection_closed(remote)
- QuicConnection.applyPeerTransportParameters → parameters_set(remote)
- QuicConnection.tlsListener (handshake/app keys) → security:key_updated
- QuicConnection.tlsListener (handshake done) → alpn_information
- QuicConnectionWriter.buildLongHeaderFromFrames → packet_sent (initial / handshake)
- QuicConnectionWriter.buildApplicationPacket → packet_sent (1-rtt)
- QuicConnectionWriter.buildBestLevelPacket → packet_sent (close-path)
- QuicConnectionParser.feedLongHeaderPacket → packet_received / packet_dropped
- QuicConnectionParser.feedShortHeaderPacket → packet_received / packet_dropped
- QuicConnectionParser AckFrame loss-detect → recovery:packet_lost
- QuicConnectionDriver.sendLoop PTO branch → recovery:loss_timer_updated (pto)
Claude
cfc305feb3