diff --git a/quest/m0/README.md b/quest/m0/README.md index c349fd57fa1..5fbe20f5ae7 100644 --- a/quest/m0/README.md +++ b/quest/m0/README.md @@ -26,6 +26,7 @@ edge, which embeds moq-relay; it moved there on 2026-09-28. - [Interop and Video pass on main](/quest/m0/interop-green/README.md) - the scheduled Interop and Video workflows pass, so red means a new break - [Release shutdown backport](/quest/m0/ffi-shutdown-backport.md) - `release` publishes a non-breaking moq-ffi with an async `drain()` and qmux sessions on the QUIC stream limit - [Backport @moq/flate bounds](/quest/m0/backport-flate-budget.md) - `@moq/flate` on `release` stops inflating past its cap and stops pinning pako scratch +- [Backport audio groupDuration](/quest/m0/backport-audio-group-duration.md) - `@moq/publish` 0.5.4 on `release` can pack several Opus frames per group, making Cloudflare's relay drop audio less often - [Resolve the remaining external Smoke interoperability failures](/quest/m0/smoke-released.md) - every external Docker interop cell in Smoke passes, fixed at its cause - [CI cost and latency](/quest/m0/ci/README.md) - cloud CI runs only in a batched merge gate as one `just ci` pass per batch, expensive checks run nightly and gate `release`, caches move to R2, and runners are chosen last - [More tests under load](/quest/m0/test-flakes-2/README.md) - load-only and queue failures, one quest per flake, fixed at the cause, since each one fails a whole batch diff --git a/quest/m0/backport-audio-group-duration.md b/quest/m0/backport-audio-group-duration.md new file mode 100644 index 00000000000..03e9066002b --- /dev/null +++ b/quest/m0/backport-audio-group-duration.md @@ -0,0 +1,41 @@ +# [S] Backport the audio groupDuration to release + +## Goal + +`@moq/publish` on `release` gains `Audio.Encoder`'s `groupDuration`, as +[moq-dev/moq#4910](https://github.com/moq-dev/moq/pull/4910) added on main, +and publishes it as 0.5.4 (npm has up to 0.5.3). A publisher can then pack +several Opus frames per group. On relays that end a subscription when a newer +group starts while an older one is still arriving +([cloudflare/moq-rs#238](https://github.com/cloudflare/moq-rs/issues/238)), +that makes the bug rarer but does not avoid it: congestion near a group +boundary can still trigger it. + +## Plan + +Decided 2026-10-29 (maintainer): backport #4910 as-is with its default of 0, +one group per frame, the same as main. Why: per-frame groups let audio frames +be reordered and dropped independently, and a longer group costs some audio +quality, so it stays opt-in. The reporter measured that 250 to 1000 ms works on +Cloudflare's relay. + +Decided 2026-10-29 (maintainer): leave the catalog `description` re-subscribe +reported in the same issue alone on `release`. Why: main already probes the Opus +description before advertising the rendition, so the next major release carries +the fix. + +Port the `js/publish/src/audio/encoder.ts` change and its tests onto +`release`'s encoder: validate `groupDuration` in the config effect like +`fade`, open a group on the first frame at least `groupDuration` past the +open group's start, and reset the start at a discontinuity. Update +`release`'s `doc/lib/js/publish.md` and `js/publish/README.md` if they +document the encoder's props, and the API report if `release` keeps one. +Skip #4910's Rust `moq-audio`, bench, and Nightly changes. Bump +`@moq/publish` to 0.5.4 in `js/publish/package.json` and `bun.lock`. + +Public API: additive (`groupDuration` on `Audio.Encoder` and its props). Wire: +none. + +## Closes + +- [#7267](https://github.com/moq-dev/moq/issues/7267) - groupDuration ships in an npm release