diff --git a/quest/m2/README.md b/quest/m2/README.md index 7cc126a2241..d4de0062915 100644 --- a/quest/m2/README.md +++ b/quest/m2/README.md @@ -73,7 +73,6 @@ lite-07; bitrate enforcement is not part of this release. - [GPU CI](/quest/m2/gpu-ci.md) - NVIDIA tests gate the merge queue on a self-hosted GPU runner VM, and `just rs nvidia` runs them locally instead of skipping - [Vendor-free CARLA bridge](/quest/m2/carla-bridge.md) - the CARLA demo's GPU bridge lets moq-video pick the encoder, and its stand-in test runs on AMD as well as NVIDIA - [Probe](/quest/m2/probe/README.md) - a session probes up to the bitrate it wants to send or receive, so a stopped simulcast rendition resumes and a viewer up-switches; the browser pads where native sessions retransmit -- [Failed groups reach the publisher](/quest/m2/group-failed.md) - Rust and both JS publishers surface a group whose delivery a subscriber's stream gave up on, with one shape - [Media stats](/quest/m2/stats/README.md) - publishers announce a stats track in the catalog, viewers answer a soliciting catalog through a per-catalog `.echo` broadcast, and one model turns both into a health verdict and a preflight report - [Perf](/quest/m2/perf/README.md) - eliminate measured hot-path costs across moq-uring, kio, and the moq-net model - [Wire stats](/quest/m2/wire-stats/README.md) - `Presence` counts each root's transport bytes on the wire, `wire_tx` and `wire_rx`, from QUIC, WebSocket, and embedder gateway sources diff --git a/quest/m2/group-failed.md b/quest/m2/group-failed.md deleted file mode 100644 index 7108bfc559f..00000000000 --- a/quest/m2/group-failed.md +++ /dev/null @@ -1,38 +0,0 @@ -# [M] Publishers learn which groups failed to deliver - -## Goal - -A publisher can observe a group it produced whose delivery a subscriber's -stream gave up on (reset as `Old`, evicted, or the stream failed), with one -shape in Rust `moq-net` and in both `js/net` publishers, lite and IETF. - -## Plan - -Decided with the maintainer on 2026-10-20, from -[#6059](https://github.com/moq-dev/moq/pull/6059), which dropped JS -`Track.Producer.failed` because Rust had no counterpart and it covered only -the lite publisher. - -- Name the consumer first, such as an encoder that forces a keyframe or a - stats counter, and let it decide what the notification carries. If none - exists by the time this starts, propose deleting the quest. -- Return a handle or an event stream, not a callback. -- A relay fans a track out to many subscribers, and a hostile subscriber can - fail streams on purpose. Coalesce per group, keyed by the publisher's track - and the group's sequence (the track belongs to one broadcast instance), so - N subscribers or retries failing one group cost one event, and benchmark - the path swept over subscribers and groups. -- Coalescing per group still leaves one notification per distinct sequence, - so a subscriber that fails every live group while the consumer is slow or - absent would grow an event queue. Keep what a track retains bounded - whatever the notification carries: coalesced latest state (such as the - newest failed sequence and a count since the last read), not a queue. -- Carry it through moq-ffi and the bindings only once a binding consumer - asks. - -Tests on mock time, Rust and JS: a group reset as `Old`, an evicted group, and -a failed stream each surface once, on lite and IETF, and a long run of -distinct failed groups with no consumer reading keeps the track's retained -state constant. - -Public API: new, mirrored across Rust and JS. Wire: none.