From d7b0a97e0da69559c431db4dfbd264f0daeda136 Mon Sep 17 00:00:00 2001 From: Luke Curley Date: Thu, 29 Oct 2026 22:52:09 -0700 Subject: [PATCH 1/4] chore(quest): claim quest/m0/backport-audio-group-duration.md Quest-Claim: 1c7b3859be939d0e From ac60292d3a126219a60204a0dfdbaaac35d7a273 Mon Sep 17 00:00:00 2001 From: Luke Curley Date: Thu, 29 Oct 2026 23:35:26 -0700 Subject: [PATCH 2/4] quest: record the groupDuration backport PR and the taken 0.5.4 Co-Authored-By: Claude Opus 5.5 --- quest/m0/backport-audio-group-duration.md | 15 ++++++++++++--- 1 file changed, 12 insertions(+), 3 deletions(-) diff --git a/quest/m0/backport-audio-group-duration.md b/quest/m0/backport-audio-group-duration.md index 03e9066002b..410703e182d 100644 --- a/quest/m0/backport-audio-group-duration.md +++ b/quest/m0/backport-audio-group-duration.md @@ -4,8 +4,8 @@ `@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 +and publishes it in the next `@moq/publish` release after 0.5.4. 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 @@ -31,11 +31,20 @@ 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`. +`@moq/publish` in `js/publish/package.json` and `bun.lock`. Public API: additive (`groupDuration` on `Audio.Encoder` and its props). Wire: none. +Status 2026-10-30: the code backport is +[moq-dev/moq#7290](https://github.com/moq-dev/moq/pull/7290), without a version +bump. 0.5.4 is no longer available: +[moq-dev/moq#7276](https://github.com/moq-dev/moq/pull/7276) bumped +`@moq/publish` to 0.5.4 on `release` for the Opus DTX backport alone, and Release +JS published it to npm. What remains is to merge #7290, then bump `@moq/publish` +on `release` (version and timing are the maintainer's call) and confirm npm +carries `groupDuration`. + ## Closes - [#7267](https://github.com/moq-dev/moq/issues/7267) - groupDuration ships in an npm release From 67563173f019e46f91b57c397224c57fa77894e5 Mon Sep 17 00:00:00 2001 From: Luke Curley Date: Sun, 1 Nov 2026 21:06:02 -0800 Subject: [PATCH 3/4] quest: groupDuration waits on the maintainer's 0.5.5 cut #7290 merged into release unbumped; npm's latest @moq/publish is still 0.5.4, which lacks groupDuration. Rewrite the quest to the remaining condition: the maintainer's combined cut publishes 0.5.5, then delete it. Co-Authored-By: Claude Opus 5.5 --- quest/m0/README.md | 2 +- quest/m0/backport-audio-group-duration.md | 68 +++++++++++++---------- 2 files changed, 39 insertions(+), 31 deletions(-) diff --git a/quest/m0/README.md b/quest/m0/README.md index 7cefe94a3d2..3d056c753d5 100644 --- a/quest/m0/README.md +++ b/quest/m0/README.md @@ -24,7 +24,7 @@ edge, which embeds moq-relay; it moved there on 2026-09-28. - [Release credential leaks](/quest/m0/security-audit/README.md) - tokens stay out of logs and outbound HTTP clients verify their peer, on `main` and `release` - [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 - [Publish the release line's drain() wrappers](/quest/m0/ffi-shutdown-backport.md) - Python `moq-rs` 0.5.2 and Dart `moq` 0.1.1 reach PyPI and pub.dev from `release` -- [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 +- [Publish the audio groupDuration backport](/quest/m0/backport-audio-group-duration.md) - `@moq/publish` 0.5.5 reaches npm from `release` and can pack several Opus frames per group, making Cloudflare's relay drop audio less often - [Backport the SETUP-path and iroh-key fixes](/quest/m0/backport-security-fixes.md) - `release` refuses a conflicting SETUP Path and keeps persisted iroh keys private, in one patch release - [Backport the joined-head FETCH race fix](/quest/m0/backport-fill-head-race.md) - a `release` relay stops FETCHing a group head its own SUBSCRIBE is bringing, which left live readers hanging - [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 diff --git a/quest/m0/backport-audio-group-duration.md b/quest/m0/backport-audio-group-duration.md index 410703e182d..5264d6815cc 100644 --- a/quest/m0/backport-audio-group-duration.md +++ b/quest/m0/backport-audio-group-duration.md @@ -1,50 +1,58 @@ -# [S] Backport the audio groupDuration to release +# [XS] Publish the audio groupDuration backport ## 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 in the next `@moq/publish` release after 0.5.4. 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 +`@moq/publish` 0.5.5 is on npm and carries `Audio.Encoder`'s `groupDuration`, +which [moq-dev/moq#7290](https://github.com/moq-dev/moq/pull/7290) backported +to `release` from main's +[moq-dev/moq#4910](https://github.com/moq-dev/moq/pull/4910). 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. +Check: `npm view @moq/publish@0.5.5 version` prints 0.5.5, and the published +package's audio encoder accepts `groupDuration` (for example, +`npm pack @moq/publish@0.5.5`, unpack it, and grep `package/audio` for it; +0.5.4 has no match). Then delete this quest and close the issue. + +This waits on the maintainer: the code is already on `release`, so it needs a +version bump and publish, not code. Agents do not bump versions or cut +releases. + ## 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 +Status (checked 2026-11-02): #7290 merged into `release` on 2026-10-30 +unbumped. `release`'s `js/publish/package.json` is still 0.5.4, and npm's +latest is 0.5.4 (published 2026-10-30 for the Opus DTX backport alone), so +0.5.4 does not carry `groupDuration`. + +Decided 2026-10-30 (maintainer): `@moq/publish` 0.5.5 carries `groupDuration` +in the next combined patch cut on `release`, which the maintainer cuts, along +with the other `release` backports and the +[drain() wrapper publishes](/quest/m0/ffi-shutdown-backport.md). Bumping +`js/publish/package.json` (and `bun.lock`) on `release` makes Release JS +publish on the push. + +Decided 2026-10-29 (maintainer): the backport keeps #4910's 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` in `js/publish/package.json` and `bun.lock`. +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. Public API: additive (`groupDuration` on `Audio.Encoder` and its props). Wire: none. -Status 2026-10-30: the code backport is -[moq-dev/moq#7290](https://github.com/moq-dev/moq/pull/7290), without a version -bump. 0.5.4 is no longer available: -[moq-dev/moq#7276](https://github.com/moq-dev/moq/pull/7276) bumped -`@moq/publish` to 0.5.4 on `release` for the Opus DTX backport alone, and Release -JS published it to npm. What remains is to merge #7290, then bump `@moq/publish` -on `release` (version and timing are the maintainer's call) and confirm npm -carries `groupDuration`. - ## Closes - [#7267](https://github.com/moq-dev/moq/issues/7267) - groupDuration ships in an npm release + +## Related + +- [Publish the release line's drain() wrappers](/quest/m0/ffi-shutdown-backport.md) - ships in the same combined cut From 88f135fb0ee16589dfec648a6862afc50e3bd49a Mon Sep 17 00:00:00 2001 From: Luke Curley Date: Thu, 5 Nov 2026 23:51:03 -0800 Subject: [PATCH 4/4] quest: delete backport-audio-group-duration; @moq/publish 0.5.5 is on npm Co-Authored-By: Claude Opus 5.5 --- quest/m0/README.md | 1 - quest/m0/backport-audio-group-duration.md | 58 ----------------------- 2 files changed, 59 deletions(-) delete mode 100644 quest/m0/backport-audio-group-duration.md diff --git a/quest/m0/README.md b/quest/m0/README.md index 151d078a4c5..4a6b08de893 100644 --- a/quest/m0/README.md +++ b/quest/m0/README.md @@ -29,7 +29,6 @@ edge, which embeds moq-relay; it moved there on 2026-09-28. - [Nightly passes on main](/quest/m0/nightly/README.md) - the scheduled Nightly passes end to end, so red means a new break - [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 - [Publish the release line's drain() wrappers](/quest/m0/ffi-shutdown-backport.md) - Dart `moq` 0.1.1 reaches pub.dev from `release` -- [Publish the audio groupDuration backport](/quest/m0/backport-audio-group-duration.md) - `@moq/publish` 0.5.5 reaches npm from `release` and can pack several Opus frames per group, making Cloudflare's relay drop audio less often - [CI cost and latency](/quest/m0/ci/README.md) - cloud CI runs only in GitHub's merge queue, one tested entry at a time, 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 drops a queued PR - [Agent build output can't fill the desktop's disk](/quest/m0/agent-disk-budget.md) - finished agent checkouts reclaim their mbx targets automatically, so parallel agent builds stop filling the root disk diff --git a/quest/m0/backport-audio-group-duration.md b/quest/m0/backport-audio-group-duration.md deleted file mode 100644 index 5264d6815cc..00000000000 --- a/quest/m0/backport-audio-group-duration.md +++ /dev/null @@ -1,58 +0,0 @@ -# [XS] Publish the audio groupDuration backport - -## Goal - -`@moq/publish` 0.5.5 is on npm and carries `Audio.Encoder`'s `groupDuration`, -which [moq-dev/moq#7290](https://github.com/moq-dev/moq/pull/7290) backported -to `release` from main's -[moq-dev/moq#4910](https://github.com/moq-dev/moq/pull/4910). 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. - -Check: `npm view @moq/publish@0.5.5 version` prints 0.5.5, and the published -package's audio encoder accepts `groupDuration` (for example, -`npm pack @moq/publish@0.5.5`, unpack it, and grep `package/audio` for it; -0.5.4 has no match). Then delete this quest and close the issue. - -This waits on the maintainer: the code is already on `release`, so it needs a -version bump and publish, not code. Agents do not bump versions or cut -releases. - -## Plan - -Status (checked 2026-11-02): #7290 merged into `release` on 2026-10-30 -unbumped. `release`'s `js/publish/package.json` is still 0.5.4, and npm's -latest is 0.5.4 (published 2026-10-30 for the Opus DTX backport alone), so -0.5.4 does not carry `groupDuration`. - -Decided 2026-10-30 (maintainer): `@moq/publish` 0.5.5 carries `groupDuration` -in the next combined patch cut on `release`, which the maintainer cuts, along -with the other `release` backports and the -[drain() wrapper publishes](/quest/m0/ffi-shutdown-backport.md). Bumping -`js/publish/package.json` (and `bun.lock`) on `release` makes Release JS -publish on the push. - -Decided 2026-10-29 (maintainer): the backport keeps #4910's 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. - -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 - -## Related - -- [Publish the release line's drain() wrappers](/quest/m0/ffi-shutdown-backport.md) - ships in the same combined cut