Release v3.8.31 — see CHANGELOG.md [3.8.31] for full notes and contributors.
Merged over known non-blocking reds (all correctness gates green): Integration Tests (2/2) is env/flaky (polls a real upstream batch that did not complete in the poll window); SonarQube/SonarCloud is the advisory server-side new-code quality gate. Unit (8 shards), Coverage, Node 22/24/26, Lint, PR Test Policy, Quality Ratchet, Docs-Strict, Quality-Extended and all 4 CodeQL analyses are green.
Reworks stream readiness as a ping/zombie filter instead of a semantic content
gate: downstream streaming is released as soon as any structured non-ping SSE
event arrives, replaying the buffered prefix. Removes the fixed 2s first-byte
cap (readiness now inherits REQUEST_TIMEOUT_MS unless STREAM_READINESS_TIMEOUT_MS
is set) so slow first-byte reasoning providers no longer false-504.
Combo stream quality stays strict: validateResponseQuality still requires an
actual content_block / known non-Claude payload before accepting a routed target.
Also normalizes multi-line data: framing, metadata-prefixed events, and final
events that arrive without a trailing blank line.
Integrated into release/v3.8.25.
Co-authored-by: R.D. <rogerproself@gmail.com>
