From 039b8fad2e919017ab87f51dc29e2531fb28582e Mon Sep 17 00:00:00 2001 From: Luke Curley Date: Mon, 19 Oct 2026 21:09:00 -0700 Subject: [PATCH 01/10] quest: record maintainer decisions on blocked quests - Abandon "A reset group keeps its header": lite-07's SUBSCRIBE_DROP (#5983) accounts for a reset that lost its header, for every publisher. - HLS failure signal becomes an implementation quest: a failed export answers its playlists and DASH manifest with a no-store 5xx. - E2EE rust-publish no longer waits on the dynamic-names design; fix the stale note that #5876 was held for it. Co-Authored-By: Claude Opus 5.5 --- quest/m1/README.md | 2 +- quest/m1/archive/history-floor.md | 2 +- quest/m1/hls-failure-signal.md | 51 ++++++++++++------------- quest/m1/quic/README.md | 3 -- quest/m1/quic/group-reset.md | 63 ------------------------------- quest/m1/sink-restart-follow.md | 2 +- quest/m1/subscribe-drop.md | 3 -- quest/m2/e2ee/README.md | 4 +- quest/m2/e2ee/dynamic-names.md | 5 ++- quest/m2/e2ee/rust-publish.md | 12 +++--- 10 files changed, 38 insertions(+), 109 deletions(-) delete mode 100644 quest/m1/quic/group-reset.md diff --git a/quest/m1/README.md b/quest/m1/README.md index 383519dbdcc..126bc09e2d5 100644 --- a/quest/m1/README.md +++ b/quest/m1/README.md @@ -114,7 +114,7 @@ lands before the cut. - [Received timestamps are media time](/quest/m1/lite-time-provenance.md) - a received timed track's timestamps are media time, so the rewind check can run across hops - [WebGPU on Safari](/quest/m1/webgpu-safari.md) - the WebGPU renderer is verified on Safari 26 for macOS and iOS - [HLS export drains after End](/quest/m1/hls-export-end-drain.md) - a cleanly ended broadcast still exports its retained segments -- [Plan: HLS export failure signal](/quest/m1/hls-failure-signal.md) - decide what players see when the exporter's timeline fails, live or history, so a truncated recording never looks complete +- [A failed HLS export answers with an error](/quest/m1/hls-failure-signal.md) - playlists and the DASH manifest answer a no-store 5xx once the timeline fails, so a truncated recording never looks complete - [Close tail drain](/quest/m1/close-tail-drain.md) - after a peer close, subscribers read the group streams their transport already delivered instead of aborting them, so a finished tail arrives on every version - [Binding linger](/quest/m1/linger-ffi.md) - `moq-ffi` and every binding finish a broadcast cleanly, so subscribers drain it until its media is stale - [JS linger](/quest/m1/linger-js.md) - `js/net` finishes a broadcast cleanly like Rust, and `@moq/publish` uses it when a source stops diff --git a/quest/m1/archive/history-floor.md b/quest/m1/archive/history-floor.md index dafdddb9f08..2db8414f7c0 100644 --- a/quest/m1/archive/history-floor.md +++ b/quest/m1/archive/history-floor.md @@ -38,5 +38,5 @@ stored segment, and a hole after it still fails. ## Related -- [HLS failure signal](/quest/m1/hls-failure-signal.md) - the other history-mode gap left by #5236 +- [Failed HLS exports error](/quest/m1/hls-failure-signal.md) - the other history-mode gap left by #5236 - [DVR rewind](/quest/m2/archive-dvr.md) - seeks through the same bounded archive diff --git a/quest/m1/hls-failure-signal.md b/quest/m1/hls-failure-signal.md index c9a5b5b5721..6c384d532bf 100644 --- a/quest/m1/hls-failure-signal.md +++ b/quest/m1/hls-failure-signal.md @@ -1,35 +1,34 @@ -# [S] Plan: HLS export failure signal +# [S] A failed HLS export answers with an error ## Goal -Decide what an HLS or DASH player sees when the exporter's timeline fails, in -both live and history mode, so a truncated recording never looks complete. -The output is an implementation quest, or a recorded reason to keep today's -behaviour. +Once an exporter's timeline fails, in live or history mode, its media +playlists and the DASH manifest answer a 5xx with `Cache-Control: no-store` +instead of ending with `EXT-X-ENDLIST`, so a truncated recording never looks +complete and no CDN caches a short one. `EXT-X-ENDLIST` and the DASH static +manifest stay reserved for a clean finish. A rendition whose own timeline +fails errors only its own playlist, so players can switch to a sibling. ## Plan -Today any timeline failure ends every playlist like a clean finish -(`EXT-X-ENDLIST`; see `watch_timeline` in `rs/moq-hls/src/export/mod.rs`), -because a window left live would freeze players with no signal. A rendition -whose own timeline fails ends the same way. In history mode -(`export::Config::history`), a missing or corrupt stored timeline group after -group 0 therefore ends a playlist that lists only the records before it, -indistinguishable from a complete recording. Found by the Codex review of -#5236, which deferred it here. - -Options to weigh: - -- Keep `EXT-X-ENDLIST` for a clean finish only, and answer a failed export's - playlist with an HTTP error once it fails, so players and CDNs stop rather - than cache a short recording. -- In history mode only, clear the partial listing on failure (an ended, - empty playlist), leaving live mode as it is. -- Keep listing what resolved, and mark the failure in band, if HLS or DASH - has a tag players honour for it. - -Cover live and history alike, and the DASH manifest, which shares the -windows. Test a mid-history group that fails to FETCH or decode. +Decided by the maintainer on 2026-10-19, over clearing a history playlist to +an ended empty one (still reads as finished) and an in-band marker (HLS and +DASH have none; `EXT-X-GAP` needs durations a failed timeline cannot give). + +Today `watch_timeline` (`rs/moq-hls/src/export/mod.rs`) ends every playlist +through `renditions::Fanout::finish` on success and failure alike. Give the +feed a failed state beside `ended`, set it on a timeline error, and have the +playlist and manifest routes (`rs/moq-hls/src/server/routes.rs`) answer the +existing no-store error response for a failed feed. Late-created renditions +start failed like they start ended. Segments already listed may stay +fetchable; only the listings refuse. + +Test a mid-history group that fails to FETCH or decode, a live timeline +error, a single failed rendition beside a healthy one, and the DASH manifest. +Update `doc/` where it describes how an export ends. + +Public API: none expected. Wire: none; HTTP responses change for a failed +export. ## Related diff --git a/quest/m1/quic/README.md b/quest/m1/quic/README.md index 77cd236d029..68268eb2c0d 100644 --- a/quest/m1/quic/README.md +++ b/quest/m1/quic/README.md @@ -65,9 +65,6 @@ cache limits remain separate; bitrate pacing composes with this memory cap. - [Regression net](/quest/m1/quic/coverage/README.md) - benchmarks, fuzzing, characterization tests, and a seeded simulation, so later QUIC changes see every behavior or cost change - [Bound message assembly](/quest/m1/quic/receive-memory.md) - complete headers and frames return credit, and receiver priority cancellation restores progress -- [A reset group keeps its header](/quest/m1/quic/group-reset.md) - a lite - publisher resets a group with `RESET_STREAM_AT`, so its subscriber drops the - tail grace ## Related diff --git a/quest/m1/quic/group-reset.md b/quest/m1/quic/group-reset.md deleted file mode 100644 index 2754f19bdea..00000000000 --- a/quest/m1/quic/group-reset.md +++ /dev/null @@ -1,63 +0,0 @@ -# [M] A reset group keeps its header - -## Goal - -A moq-lite publisher on a native QUIC or WebTransport stack resets a group -stream with `RESET_STREAM_AT`, still delivering the group header, so the -subscriber can always tell which group the reset belongs to. A subscriber -that knows its publisher does this stops waiting out the tail grace for -groups whose reset lost the header (`rs/moq-net/src/tail.rs`, -`js/net/src/tail.ts`). Subscribers whose publisher cannot do it, such as a -browser, keep the grace. - -## Plan - -Split from the transport half, which landed in `moq-quic`, -`moq_tokio::quic::web`, and moq-uring's WebTransport adapter (#5690). There, -`SendStream::reset_at(offset, code)` sends `RESET_STREAM_AT` with that -offset as the Reliable Size. A peer without the extension instead gets a plain -`RESET_STREAM` once it has acknowledged the data before the checkpoint, a round -trip later. The WebTransport adapters already keep their own stream header -this way. - -That fallback is weaker than it looks. An ACK only means the peer's QUIC stack -holds the bytes, not that its application read them, and RFC 9000 lets a -receiver discard unread data on `RESET_STREAM`. The WebTransport header -survives because receiving stacks parse it on arrival. A MoQ group header is -read by the application, so check whether Chrome hands it to JS when a plain -`RESET_STREAM` follows the ACK, and treat a peer without `reset_stream_at` as -unable to keep the header unless it does. - -- Give moq-net's `transport::poll::SendStream` a reset that keeps the first - `offset` bytes, matching `moq-quic`'s `reset_at(offset, code)`. Decided - 2026-10-17 on #5817: a byte offset rather than a `Checkpoint` handle; an - offset past the written data panics instead of being unrepresentable. - Implement it in the moq-tokio and - moq-uring adapters. Backends that cannot do it (browser, qmux, iroh) report - that rather than silently sending a plain reset. -- The lite publisher checkpoints right after writing a group header and - resets the group from that checkpoint. -- QUIC negotiation alone cannot drop the grace. A peer's stack can advertise - `reset_stream_at` while its application never sends one, as a browser - publisher whose WebTransport API has no reliable reset. Dropping the grace - on negotiation would hang the tail. So the publisher declares it with a - MoQ-level signal, per session, since each relay hop re-serves groups on its - own streams. Open: the signal's shape (a SETUP parameter or a version - feature), and how it composes with SUBSCRIBE_DROP, which already names a - group reset before its header on lite-05 and later. Any wire change updates - `drafts/draft-lcurley-moq-lite.md`. -- Remove the grace for subscriptions on sessions that declare it, in Rust and - `@moq/net`. Datagram holes still wait out the grace. - -Test a group reset before any payload with and without the signal, both -directions between Rust and `@moq/net`, and through a relay hop. Cover it in -the Chrome wasm harness and the native interop matrix, which the transport -half did not reach. - -## Related - -- [SUBSCRIBE_DROP accounts for every group](/quest/m1/subscribe-drop.md) - a - DROP covers a reset whose header was lost; a reset that keeps its header acts - as a one-group drop -- [qmux on the QUIC stream state machine](/quest/m2/quic-qmux.md) - qmux reuses - `moq-quic`'s reset state diff --git a/quest/m1/sink-restart-follow.md b/quest/m1/sink-restart-follow.md index dde69b0bdee..a0e7a48a2c6 100644 --- a/quest/m1/sink-restart-follow.md +++ b/quest/m1/sink-restart-follow.md @@ -18,7 +18,7 @@ and fix the rest the same way: - `export hls`: `moq-hls`'s server resolves per request; check that a restart moves new requests to the new instance and how a playlist marks the break (`EXT-X-DISCONTINUITY`). Coordinate with - [HLS export failure signal](/quest/m1/hls-failure-signal.md). + [Failed HLS exports error](/quest/m1/hls-failure-signal.md). - `export rtmp`, `export srt`, `export rtc`, both `--listen` (per-viewer streams in `moq-rtmp`, `moq-srt`, `moq-rtc`) and `--connect` (one push). SRT already rides the TS follower (`--linger`, `--stitch`); confirm its diff --git a/quest/m1/subscribe-drop.md b/quest/m1/subscribe-drop.md index e7d8b0fe76f..96b341b9eaf 100644 --- a/quest/m1/subscribe-drop.md +++ b/quest/m1/subscribe-drop.md @@ -30,9 +30,6 @@ Decided: - lite-07 restores SUBSCRIBE_DROP and removes `Stream Count`. With every sequence accounted for, the count is redundant; one mechanism instead of two. A reset whose header may be lost is covered by a DROP. -- A reliable reset ([A reset group keeps its header](/quest/m1/quic/group-reset.md)) - that keeps the stream header acts as a one-group drop, an optimization over - sending the DROP. - Publishers send SUBSCRIBE_DROP on lite-05 and lite-06 too: for every group in range they won't deliver (expired, deprioritized, or reset without its header delivered) and for every explicit gap. Publishers that skip sequences diff --git a/quest/m2/e2ee/README.md b/quest/m2/e2ee/README.md index 1df2f6637e4..f53a1d2a40e 100644 --- a/quest/m2/e2ee/README.md +++ b/quest/m2/e2ee/README.md @@ -46,7 +46,7 @@ The Rust and TypeScript cores expose the same surface, and nothing else: ### Dynamic names -Decided with the maintainer on 2026-10-17: physical names are a one-way hash, so a publisher cannot answer a request for a name it never declared. [Dynamic names](/quest/m2/e2ee/dynamic-names.md) designs that before any implementation, and [#5876](https://github.com/moq-dev/moq/pull/5876) (the broadcast wrappers, whose `reserve_track` covers only names declared in advance) is held until it decides. +Decided with the maintainer on 2026-10-17: physical names are a one-way hash, so a publisher cannot answer a request for a name it never declared. [Dynamic names](/quest/m2/e2ee/dynamic-names.md) designs that before any implementation. The broadcast wrappers merged in [#5876](https://github.com/moq-dev/moq/pull/5876) with `reserve_track`, which covers names declared in advance; that is every track the Rust publishers serve, so nothing else waits on the design (maintainer, 2026-10-19). ## Required @@ -55,7 +55,7 @@ Decided with the maintainer on 2026-10-17: physical names are a one-way hash, so semantic catalog in E2EE mode - [Dynamic names](/quest/m2/e2ee/dynamic-names.md) - a reviewed design for answering requests for undeclared track names, split into implementation - quests; #5876 waits on it + quests - [Refuse a re-created track](/quest/m2/e2ee/reopen.md) - a name the producer already carried fails loudly - [Encrypted consumer shape](/quest/m2/e2ee/consumer.md) - one consumer shape, the producer's mirror, shared by browser, CLI, and FFI - [Encrypted browser components](/quest/m2/e2ee/browser.md) - browser publish diff --git a/quest/m2/e2ee/dynamic-names.md b/quest/m2/e2ee/dynamic-names.md index b88c9e3b541..cb9c67ef6da 100644 --- a/quest/m2/e2ee/dynamic-names.md +++ b/quest/m2/e2ee/dynamic-names.md @@ -20,8 +20,9 @@ Decided with the maintainer on 2026-10-17: - Design-only, with a design-review gate: open the PR as a draft and get the maintainer's approval of the choice before any implementation quest starts. -- [#5876](https://github.com/moq-dev/moq/pull/5876) (the e2ee broadcast - wrappers, with `reserve_track`) is held until this quest decides. +- Nothing waits on it (maintainer, 2026-10-19): the broadcast wrappers + merged in [#5876](https://github.com/moq-dev/moq/pull/5876), and the Rust + publishers declare every track they serve. Background: a physical track name is a one-way HKDF of the semantic name (the draft's Key Derivation section). Only the CDN sees physical names, and a diff --git a/quest/m2/e2ee/rust-publish.md b/quest/m2/e2ee/rust-publish.md index f53958a9a70..00eeae5805c 100644 --- a/quest/m2/e2ee/rust-publish.md +++ b/quest/m2/e2ee/rust-publish.md @@ -11,14 +11,12 @@ The reusable crypto crate remains independent of Hang and codec-specific publish Publishers use `Credential::produce()` and its `generation::Producer`; the producing/consuming split landed separately in #5313. -- After the dynamic-name design is approved, adapt mux, video, audio, - timeline, and catalog publishers to its chosen naming contract. - Applications keep semantic track names; the e2ee broadcast wrappers own +- Adapt mux, video, audio, timeline, and catalog publishers to the e2ee + broadcast wrappers (`create_track`, `reserve_track`). Every track these + publishers serve is declared in advance, so this does not wait on the + [dynamic names](/quest/m2/e2ee/dynamic-names.md) design (maintainer, + 2026-10-19). Applications keep semantic track names; the wrappers own their translation to physical names, as the epic specifies. - Derive the protected catalog name from its well-known logical role, then put media roles, codecs, quality, timelines, and custom-track mappings only inside the encrypted catalog. - Encrypt both Hang catalog representations and encrypt or suppress the MSF catalog. Compress protected catalog bodies before encryption and retain ordinary plaintext publication unchanged outside E2EE mode. - Cover every current Rust importer and capture path so a convenience API cannot silently recreate `.avc3`, `.opus`, timeline, or other semantic suffixes. - -## Required - -- [Dynamic names](/quest/m2/e2ee/dynamic-names.md) - the maintainer approves the naming design before implementation starts From f4083b40bebef3417fdc8cde1f3c0e2e32a54ce3 Mon Sep 17 00:00:00 2001 From: Luke Curley Date: Mon, 19 Oct 2026 21:12:27 -0700 Subject: [PATCH 02/10] quest: cover rendition-local HLS timeline failures Co-Authored-By: Claude Opus 5.5 --- quest/m1/hls-failure-signal.md | 23 ++++++++++++++++------- 1 file changed, 16 insertions(+), 7 deletions(-) diff --git a/quest/m1/hls-failure-signal.md b/quest/m1/hls-failure-signal.md index 6c384d532bf..abe8d0254b3 100644 --- a/quest/m1/hls-failure-signal.md +++ b/quest/m1/hls-failure-signal.md @@ -15,13 +15,22 @@ Decided by the maintainer on 2026-10-19, over clearing a history playlist to an ended empty one (still reads as finished) and an in-band marker (HLS and DASH have none; `EXT-X-GAP` needs durations a failed timeline cannot give). -Today `watch_timeline` (`rs/moq-hls/src/export/mod.rs`) ends every playlist -through `renditions::Fanout::finish` on success and failure alike. Give the -feed a failed state beside `ended`, set it on a timeline error, and have the -playlist and manifest routes (`rs/moq-hls/src/server/routes.rs`) answer the -existing no-store error response for a failed feed. Late-created renditions -start failed like they start ended. Segments already listed may stay -fetchable; only the listings refuse. +Failures take two paths today, and both end the playlist as finished: + +- The shared reference timeline: `watch_timeline` + (`rs/moq-hls/src/export/mod.rs`) calls `renditions::Fanout::finish` on + success and failure alike. Give the feed a failed state beside `ended`, set + on a timeline error; late-created renditions start failed like they start + ended. +- A rendition's own timeline: `watch_spans` calls `Spans::fail` + (`rs/moq-hls/src/export/spans.rs`), and `Rendition::snapshot_as` + (`rendition.rs`) folds a failed last row into `finished`. Expose that + rendition-local failure to the playlist route instead of rendering + `EXT-X-ENDLIST`. + +The playlist and manifest routes (`rs/moq-hls/src/server/routes.rs`) answer +the existing no-store error response for either failure. Segments already +listed may stay fetchable; only the listings refuse. Test a mid-history group that fails to FETCH or decode, a live timeline error, a single failed rendition beside a healthy one, and the DASH manifest. From 72f102546783766a7beacbed492e82a347007113 Mon Sep 17 00:00:00 2001 From: Luke Curley Date: Mon, 19 Oct 2026 22:04:30 -0700 Subject: [PATCH 03/10] quest: the interop runner approval is granted; only the release remains Co-Authored-By: Claude Opus 5.5 --- quest/m3/README.md | 2 +- quest/m3/interop-runner-approval.md | 32 ++++++++++++++++------------- 2 files changed, 19 insertions(+), 15 deletions(-) diff --git a/quest/m3/README.md b/quest/m3/README.md index 8e545ba22b1..00e5db6741f 100644 --- a/quest/m3/README.md +++ b/quest/m3/README.md @@ -66,6 +66,6 @@ m4's upstream waits in here and moved m2 work with no consumer. - [Paced replay](/quest/m3/archive-paced-replay.md) - an archive consumer pushes stored groups to live subscribers on one shared clock, so any live player plays it - [Encoder feedback](/quest/m3/stats-encoder-feedback.md) - a Rust encoder reads its viewers' feedback and adapts its bitrate -- [Interop runner withdraws before disconnecting](/quest/m3/interop-runner-approval.md) - condition: the maintainer approves posting and a released moq-tokio and @moq/net carry close() withdrawals +- [Interop runner withdraws before disconnecting](/quest/m3/interop-runner-approval.md) - condition: a released moq-tokio and @moq/net carry close() withdrawals; then the runner's moq.dev clients switch to close() - [Safari ships the WebKit 319818 fix](/quest/m3/webkit-319818.md) - the Safari release the gate admits - [Safari WebTransport](/quest/m3/safari-webtransport.md) - WebKit browsers return to WebTransport once WebKit 319818 ships fixed diff --git a/quest/m3/interop-runner-approval.md b/quest/m3/interop-runner-approval.md index 0296364f325..bd821b5e395 100644 --- a/quest/m3/interop-runner-approval.md +++ b/quest/m3/interop-runner-approval.md @@ -2,22 +2,26 @@ ## Goal -Condition: the maintainer approves changing moq-interop-runner -(englishm/moq-interop-runner, outside this repository), and a released -moq-tokio and `@moq/net` carry the session `close()` that withdraws this -session's announcements before disconnecting. Then post the one-line change: -a completed publish in the runner calls `close()` instead of aborting, so a -subsequent run can publish the same namespace without an already-published -error. +Condition: a released moq-tokio and `@moq/net` carry the session `close()` +that withdraws this session's announcements before disconnecting. Then the +moq.dev clients in englishm/moq-interop-runner (`builds/moq-dev-rs`, +`builds/moq-dev-js`) bump to that release and end each publishing session +with `close()` instead of aborting. -Check: ask the maintainer, or look for the approval on the runner's -repository, and read the moq-tokio and `@moq/net` changelogs for a release -with the withdrawing `close()`. Delete this quest once the change is posted. +Check: read the moq-tokio and `@moq/net` changelogs for a release with the +withdrawing `close()`. Delete this quest once the runner change is posted. ## Plan -The runner found this in [#4209](https://github.com/moq-dev/moq/pull/4209). -Exercise successive runs against the same relay before posting. +The maintainer approved changing the runner on 2026-10-19. +[englishm/moq-interop-runner#167](https://github.com/englishm/moq-interop-runner/pull/167) +moved both clients to the latest releases (moq-tokio 0.19.28, `@moq/net` +0.4.4) and kept their teardown, because 0.19.28's `close()` does not withdraw +announcements and adds about 500 ms per session against a distant relay, +which pushed `announce-subscribe` past its 3 s budget. -Decided 2026-10-08: the graceful-close quest folds in here as one condition -quest, since the runner change is one line once both conditions hold. +The stale namespace that motivated this ([#4209](https://github.com/moq-dev/moq/pull/4209): +a publisher that aborts without PUBLISH_NAMESPACE_DONE blocks the next run's +publish) no longer reproduces against imquic or any other public relay as of +2026-10-19, so this is cleanup rather than a fix. Re-measure `close()`'s cost +against imquic before switching, and keep each test inside its budget. From c91ea62944eda5066f5bbde427422e99ca79204c Mon Sep 17 00:00:00 2001 From: Luke Curley Date: Mon, 19 Oct 2026 22:08:44 -0700 Subject: [PATCH 04/10] quest: cover retained HLS references, keep DASH up for local failures, narrow the e2ee unblock Co-Authored-By: Claude Opus 5.5 --- quest/m1/hls-failure-signal.md | 22 ++++++++++++++++------ quest/m2/e2ee/README.md | 2 +- quest/m2/e2ee/dynamic-names.md | 9 ++++++--- 3 files changed, 23 insertions(+), 10 deletions(-) diff --git a/quest/m1/hls-failure-signal.md b/quest/m1/hls-failure-signal.md index abe8d0254b3..526ff793841 100644 --- a/quest/m1/hls-failure-signal.md +++ b/quest/m1/hls-failure-signal.md @@ -22,18 +22,28 @@ Failures take two paths today, and both end the playlist as finished: success and failure alike. Give the feed a failed state beside `ended`, set on a timeline error; late-created renditions start failed like they start ended. +- A retained past reference: in history mode `watch_catalog` keeps old + reference watchers after a handoff, and when one errors `watch_timeline` + takes the `finish(...) == false` branch and retires its rows + (`renditions.pop`), so the recording loses a prefix and still ends as + complete. Mark the feed failed there too instead of only retiring the rows. - A rendition's own timeline: `watch_spans` calls `Spans::fail` (`rs/moq-hls/src/export/spans.rs`), and `Rendition::snapshot_as` (`rendition.rs`) folds a failed last row into `finished`. Expose that rendition-local failure to the playlist route instead of rendering `EXT-X-ENDLIST`. -The playlist and manifest routes (`rs/moq-hls/src/server/routes.rs`) answer -the existing no-store error response for either failure. Segments already -listed may stay fetchable; only the listings refuse. - -Test a mid-history group that fails to FETCH or decode, a live timeline -error, a single failed rendition beside a healthy one, and the DASH manifest. +The media playlist routes (`rs/moq-hls/src/server/routes.rs`) answer the +existing no-store error response for any of these failures. The DASH manifest +is broadcast-wide, so it answers that error only for a shared or retained +reference failure; a rendition-local failure omits that representation and +keeps its siblings available. Segments already listed may stay fetchable; +only the listings refuse. + +Test a mid-history group that fails to FETCH or decode, a retained reference +failing after a handoff, a live timeline error, a single failed rendition +beside a healthy one (its playlist errors, the sibling's and the DASH +manifest's do not), and the DASH manifest after a shared failure. Update `doc/` where it describes how an export ends. Public API: none expected. Wire: none; HTTP responses change for a failed diff --git a/quest/m2/e2ee/README.md b/quest/m2/e2ee/README.md index f53a1d2a40e..fcddde7b7e7 100644 --- a/quest/m2/e2ee/README.md +++ b/quest/m2/e2ee/README.md @@ -46,7 +46,7 @@ The Rust and TypeScript cores expose the same surface, and nothing else: ### Dynamic names -Decided with the maintainer on 2026-10-17: physical names are a one-way hash, so a publisher cannot answer a request for a name it never declared. [Dynamic names](/quest/m2/e2ee/dynamic-names.md) designs that before any implementation. The broadcast wrappers merged in [#5876](https://github.com/moq-dev/moq/pull/5876) with `reserve_track`, which covers names declared in advance; that is every track the Rust publishers serve, so nothing else waits on the design (maintainer, 2026-10-19). +Decided with the maintainer on 2026-10-17: physical names are a one-way hash, so a publisher cannot answer a request for a name it never declared. [Dynamic names](/quest/m2/e2ee/dynamic-names.md) designs that before any implementation. The broadcast wrappers merged in [#5876](https://github.com/moq-dev/moq/pull/5876) with `reserve_track`, which covers names declared in advance; that is every track the Rust publishers serve, so [rust-publish](/quest/m2/e2ee/rust-publish.md) does not wait on the design (maintainer, 2026-10-19). [Reopen](/quest/m2/e2ee/reopen.md) and the [consumer shape](/quest/m2/e2ee/consumer.md) still do. ## Required diff --git a/quest/m2/e2ee/dynamic-names.md b/quest/m2/e2ee/dynamic-names.md index cb9c67ef6da..bbbdc45b4df 100644 --- a/quest/m2/e2ee/dynamic-names.md +++ b/quest/m2/e2ee/dynamic-names.md @@ -20,9 +20,12 @@ Decided with the maintainer on 2026-10-17: - Design-only, with a design-review gate: open the PR as a draft and get the maintainer's approval of the choice before any implementation quest starts. -- Nothing waits on it (maintainer, 2026-10-19): the broadcast wrappers - merged in [#5876](https://github.com/moq-dev/moq/pull/5876), and the Rust - publishers declare every track they serve. +- The Rust publishers do not wait on it (maintainer, 2026-10-19): the + broadcast wrappers merged in [#5876](https://github.com/moq-dev/moq/pull/5876), + and [rust-publish](/quest/m2/e2ee/rust-publish.md) declares every track it + serves. [Reopen](/quest/m2/e2ee/reopen.md) and the + [consumer shape](/quest/m2/e2ee/consumer.md) still wait, since the chosen + mapping can change the physical names they handle. Background: a physical track name is a one-way HKDF of the semantic name (the draft's Key Derivation section). Only the CDN sees physical names, and a From 61233fa567be266ccd4031e605a4d46ccb0e706c Mon Sep 17 00:00:00 2001 From: Luke Curley Date: Mon, 19 Oct 2026 22:11:26 -0700 Subject: [PATCH 05/10] quest: a failed HLS export surfaces through the public API too Co-Authored-By: Claude Opus 5.5 --- quest/m1/hls-failure-signal.md | 11 +++++++++-- 1 file changed, 9 insertions(+), 2 deletions(-) diff --git a/quest/m1/hls-failure-signal.md b/quest/m1/hls-failure-signal.md index 526ff793841..251530fc702 100644 --- a/quest/m1/hls-failure-signal.md +++ b/quest/m1/hls-failure-signal.md @@ -46,8 +46,15 @@ beside a healthy one (its playlist errors, the sibling's and the DASH manifest's do not), and the DASH manifest after a shared failure. Update `doc/` where it describes how an export ends. -Public API: none expected. Wire: none; HTTP responses change for a failed -export. +Embedders that skip the server router read the same failure from the public +API: `Rendition::playlist` (already a `Result`) returns an error for a failed +feed, and `Broadcaster::manifest` changes from `Option` to a `Result`, +so a failed shared timeline differs from a manifest that is not listable yet. +The routes map those errors to the 5xx. + +Public API: breaking, `export::Broadcaster::manifest` returns a `Result`, and +a new `Error` variant for a failed timeline; add a `MIGRATE.md` entry. Wire: +none; HTTP responses change for a failed export. ## Related From 0b91665d01ace684439fedf46c0788fb2c1e3214 Mon Sep 17 00:00:00 2001 From: Luke Curley Date: Mon, 19 Oct 2026 22:14:49 -0700 Subject: [PATCH 06/10] quest: every public HLS listing accessor reports a failed timeline Co-Authored-By: Claude Opus 5.5 --- quest/m1/hls-failure-signal.md | 18 ++++++++++-------- 1 file changed, 10 insertions(+), 8 deletions(-) diff --git a/quest/m1/hls-failure-signal.md b/quest/m1/hls-failure-signal.md index 251530fc702..52270db457b 100644 --- a/quest/m1/hls-failure-signal.md +++ b/quest/m1/hls-failure-signal.md @@ -47,14 +47,16 @@ manifest's do not), and the DASH manifest after a shared failure. Update `doc/` where it describes how an export ends. Embedders that skip the server router read the same failure from the public -API: `Rendition::playlist` (already a `Result`) returns an error for a failed -feed, and `Broadcaster::manifest` changes from `Option` to a `Result`, -so a failed shared timeline differs from a manifest that is not listable yet. -The routes map those errors to the 5xx. - -Public API: breaking, `export::Broadcaster::manifest` returns a `Result`, and -a new `Error` variant for a failed timeline; add a `MIGRATE.md` entry. Wire: -none; HTTP responses change for a failed export. +API: every public accessor that renders a listing reports it as an error, so a +failed timeline differs from a listing that is not available yet. Today those +are `Broadcaster::manifest` and `Rendition::media_playlist` (both +`Option`, becoming `Result>`) and `Rendition::playlist` +(already a `Result`). The routes map those errors to the 5xx. + +Public API: breaking, `export::Broadcaster::manifest` and +`export::Rendition::media_playlist` return a `Result`, and a new `Error` +variant for a failed timeline; add a `MIGRATE.md` entry. Wire: none; HTTP +responses change for a failed export. ## Related From 24c323e3f4dc86c0c761106c3f7b1ebd285c7581 Mon Sep 17 00:00:00 2001 From: Luke Curley Date: Mon, 19 Oct 2026 22:20:24 -0700 Subject: [PATCH 07/10] quest: a failed timeline under a ranged HLS clip is a 5xx, not 416 Co-Authored-By: Claude Opus 5.5 --- quest/m1/hls-failure-signal.md | 9 +++++++-- 1 file changed, 7 insertions(+), 2 deletions(-) diff --git a/quest/m1/hls-failure-signal.md b/quest/m1/hls-failure-signal.md index 52270db457b..1b81bd992b0 100644 --- a/quest/m1/hls-failure-signal.md +++ b/quest/m1/hls-failure-signal.md @@ -40,7 +40,8 @@ reference failure; a rendition-local failure omits that representation and keeps its siblings available. Segments already listed may stay fetchable; only the listings refuse. -Test a mid-history group that fails to FETCH or decode, a retained reference +Test a mid-history group that fails to FETCH or decode, a ranged clip over a +failed timeline (5xx, not 416), a retained reference failing after a handoff, a live timeline error, a single failed rendition beside a healthy one (its playlist errors, the sibling's and the DASH manifest's do not), and the DASH manifest after a shared failure. @@ -51,7 +52,11 @@ API: every public accessor that renders a listing reports it as an error, so a failed timeline differs from a listing that is not available yet. Today those are `Broadcaster::manifest` and `Rendition::media_playlist` (both `Option`, becoming `Result>`) and `Rendition::playlist` -(already a `Result`). The routes map those errors to the 5xx. +(already a `Result`). The routes map those errors to the 5xx. This includes the ranged history +path: `snapshot_range` turns a failed timeline into `Error::RangeUnavailable`, +which answers 416 as if the client asked for a bad range; it returns the +failed-timeline error instead. Audit every snapshot path for the same fold +rather than relying on this list. Public API: breaking, `export::Broadcaster::manifest` and `export::Rendition::media_playlist` return a `Result`, and a new `Error` From 68ac6b19f5b563f8b85d2c26a2a1ecc0e2816b5a Mon Sep 17 00:00:00 2001 From: Luke Curley Date: Mon, 19 Oct 2026 22:25:19 -0700 Subject: [PATCH 08/10] quest: scope the HLS DASH error, dynamic-name gate, and runner deletion check Co-Authored-By: Claude Opus 5.5 --- quest/m1/README.md | 2 +- quest/m1/hls-failure-signal.md | 2 +- quest/m2/e2ee/README.md | 2 +- quest/m2/e2ee/dynamic-names.md | 2 +- quest/m3/interop-runner-approval.md | 3 ++- 5 files changed, 6 insertions(+), 5 deletions(-) diff --git a/quest/m1/README.md b/quest/m1/README.md index b2e20721612..626f826bfaf 100644 --- a/quest/m1/README.md +++ b/quest/m1/README.md @@ -114,7 +114,7 @@ lands before the cut. - [Received timestamps are media time](/quest/m1/lite-time-provenance.md) - a received timed track's timestamps are media time, so the rewind check can run across hops - [WebGPU on Safari](/quest/m1/webgpu-safari.md) - the WebGPU renderer is verified on Safari 26 for macOS and iOS - [HLS export drains after End](/quest/m1/hls-export-end-drain.md) - a cleanly ended broadcast still exports its retained segments -- [A failed HLS export answers with an error](/quest/m1/hls-failure-signal.md) - playlists and the DASH manifest answer a no-store 5xx once the timeline fails, so a truncated recording never looks complete +- [A failed HLS export answers with an error](/quest/m1/hls-failure-signal.md) - playlists answer a no-store 5xx once their timeline fails, and so does the DASH manifest for a shared reference failure, so a truncated recording never looks complete - [Close tail drain](/quest/m1/close-tail-drain.md) - after a peer close, subscribers read the group streams their transport already delivered instead of aborting them, so a finished tail arrives on every version - [Binding linger](/quest/m1/linger-ffi.md) - `moq-ffi` and every binding finish a broadcast cleanly, so subscribers drain it until its media is stale - [JS linger](/quest/m1/linger-js.md) - `js/net` finishes a broadcast cleanly like Rust, and `@moq/publish` uses it when a source stops diff --git a/quest/m1/hls-failure-signal.md b/quest/m1/hls-failure-signal.md index 1b81bd992b0..85b16f8022d 100644 --- a/quest/m1/hls-failure-signal.md +++ b/quest/m1/hls-failure-signal.md @@ -15,7 +15,7 @@ Decided by the maintainer on 2026-10-19, over clearing a history playlist to an ended empty one (still reads as finished) and an in-band marker (HLS and DASH have none; `EXT-X-GAP` needs durations a failed timeline cannot give). -Failures take two paths today, and both end the playlist as finished: +Failures take three paths today, and both end the playlist as finished: - The shared reference timeline: `watch_timeline` (`rs/moq-hls/src/export/mod.rs`) calls `renditions::Fanout::finish` on diff --git a/quest/m2/e2ee/README.md b/quest/m2/e2ee/README.md index fcddde7b7e7..df91601822e 100644 --- a/quest/m2/e2ee/README.md +++ b/quest/m2/e2ee/README.md @@ -46,7 +46,7 @@ The Rust and TypeScript cores expose the same surface, and nothing else: ### Dynamic names -Decided with the maintainer on 2026-10-17: physical names are a one-way hash, so a publisher cannot answer a request for a name it never declared. [Dynamic names](/quest/m2/e2ee/dynamic-names.md) designs that before any implementation. The broadcast wrappers merged in [#5876](https://github.com/moq-dev/moq/pull/5876) with `reserve_track`, which covers names declared in advance; that is every track the Rust publishers serve, so [rust-publish](/quest/m2/e2ee/rust-publish.md) does not wait on the design (maintainer, 2026-10-19). [Reopen](/quest/m2/e2ee/reopen.md) and the [consumer shape](/quest/m2/e2ee/consumer.md) still do. +Decided with the maintainer on 2026-10-17: physical names are a one-way hash, so a publisher cannot answer a request for a name it never declared. [Dynamic names](/quest/m2/e2ee/dynamic-names.md) designs that before any dynamic-name implementation. The broadcast wrappers merged in [#5876](https://github.com/moq-dev/moq/pull/5876) with `reserve_track`, which covers names declared in advance; that is every track the Rust publishers serve, so [rust-publish](/quest/m2/e2ee/rust-publish.md) does not wait on the design (maintainer, 2026-10-19). [Reopen](/quest/m2/e2ee/reopen.md) and the [consumer shape](/quest/m2/e2ee/consumer.md) still do. ## Required diff --git a/quest/m2/e2ee/dynamic-names.md b/quest/m2/e2ee/dynamic-names.md index bbbdc45b4df..1116777c747 100644 --- a/quest/m2/e2ee/dynamic-names.md +++ b/quest/m2/e2ee/dynamic-names.md @@ -2,7 +2,7 @@ ## Goal -A written design, approved by the maintainer before any implementation, for +A written design, approved by the maintainer before any dynamic-name implementation, for how an e2ee publisher answers a request for a track name it never declared. It compares at least three options against the threat model of [draft-lcurley-moq-e2ee](/drafts/draft-lcurley-moq-e2ee.md): diff --git a/quest/m3/interop-runner-approval.md b/quest/m3/interop-runner-approval.md index bd821b5e395..7b27f81424a 100644 --- a/quest/m3/interop-runner-approval.md +++ b/quest/m3/interop-runner-approval.md @@ -9,7 +9,8 @@ moq.dev clients in englishm/moq-interop-runner (`builds/moq-dev-rs`, with `close()` instead of aborting. Check: read the moq-tokio and `@moq/net` changelogs for a release with the -withdrawing `close()`. Delete this quest once the runner change is posted. +withdrawing `close()`. Delete this quest once the runner's moq.dev clients use that release's +`close()`. ## Plan From 1c1c4fbd836e07cae9cd93183a9404649cea9065 Mon Sep 17 00:00:00 2001 From: Luke Curley Date: Mon, 19 Oct 2026 22:32:24 -0700 Subject: [PATCH 09/10] quest: a failed HLS timeline wakes pending playlist requests Co-Authored-By: Claude Opus 5.5 --- quest/m1/hls-failure-signal.md | 8 ++++++-- 1 file changed, 6 insertions(+), 2 deletions(-) diff --git a/quest/m1/hls-failure-signal.md b/quest/m1/hls-failure-signal.md index 85b16f8022d..0a4c93edad2 100644 --- a/quest/m1/hls-failure-signal.md +++ b/quest/m1/hls-failure-signal.md @@ -31,7 +31,10 @@ Failures take three paths today, and both end the playlist as finished: (`rs/moq-hls/src/export/spans.rs`), and `Rendition::snapshot_as` (`rendition.rs`) folds a failed last row into `finished`. Expose that rendition-local failure to the playlist route instead of rendering - `EXT-X-ENDLIST`. + `EXT-X-ENDLIST`. `Rendition::playlist` waits in `playable()` (and then + `init()`), which watch only the live window, so the failure must also wake + those waits: otherwise a request pending before the first row times out as a + 404, and a router-free caller waits forever. The media playlist routes (`rs/moq-hls/src/server/routes.rs`) answer the existing no-store error response for any of these failures. The DASH manifest @@ -41,7 +44,8 @@ keeps its siblings available. Segments already listed may stay fetchable; only the listings refuse. Test a mid-history group that fails to FETCH or decode, a ranged clip over a -failed timeline (5xx, not 416), a retained reference +failed timeline (5xx, not 416), a playlist request already pending when the +timeline fails before its first row, a retained reference failing after a handoff, a live timeline error, a single failed rendition beside a healthy one (its playlist errors, the sibling's and the DASH manifest's do not), and the DASH manifest after a shared failure. From c33aa29cdb3e616a6c29ec853cf868e27bde314b Mon Sep 17 00:00:00 2001 From: Luke Curley Date: Tue, 20 Oct 2026 13:00:28 -0700 Subject: [PATCH 10/10] quest: scope the HLS manifest error to reference failures Co-Authored-By: Claude Opus 5.5 --- quest/m1/hls-failure-signal.md | 7 +++++-- 1 file changed, 5 insertions(+), 2 deletions(-) diff --git a/quest/m1/hls-failure-signal.md b/quest/m1/hls-failure-signal.md index 0a4c93edad2..9ed656d9cc9 100644 --- a/quest/m1/hls-failure-signal.md +++ b/quest/m1/hls-failure-signal.md @@ -15,7 +15,7 @@ Decided by the maintainer on 2026-10-19, over clearing a history playlist to an ended empty one (still reads as finished) and an in-band marker (HLS and DASH have none; `EXT-X-GAP` needs durations a failed timeline cannot give). -Failures take three paths today, and both end the playlist as finished: +Failures take three paths today, and all three end the playlist as finished: - The shared reference timeline: `watch_timeline` (`rs/moq-hls/src/export/mod.rs`) calls `renditions::Fanout::finish` on @@ -56,7 +56,10 @@ API: every public accessor that renders a listing reports it as an error, so a failed timeline differs from a listing that is not available yet. Today those are `Broadcaster::manifest` and `Rendition::media_playlist` (both `Option`, becoming `Result>`) and `Rendition::playlist` -(already a `Result`). The routes map those errors to the 5xx. This includes the ranged history +(already a `Result`). `Broadcaster::manifest` errors only for a shared or +retained reference failure; a failed rendition drops from the manifest while its +own `Rendition` accessors error. The routes map those errors to the 5xx. This +includes the ranged history path: `snapshot_range` turns a failed timeline into `Error::RangeUnavailable`, which answers 416 as if the client asked for a bad range; it returns the failed-timeline error instead. Audit every snapshot path for the same fold