Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
1 change: 0 additions & 1 deletion quest/m1/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -133,7 +133,6 @@ tracks, so per-group stats stop costing cluster announces.
- [Rust resume checks compression](/quest/m1/resume-compress.md) - a same-epoch route copy with a different `compress` is refused instead of corrupting framing
- [Rust resume backs single-route groups](/quest/m1/resume-handed-out.md) - a group first read from one route keeps the later copy that holds it, with a passthrough benchmark
- [WebGPU on Safari](/quest/m1/webgpu-safari.md) - the WebGPU renderer is verified on Safari 26 for macOS and iOS
- [Interop finish](/quest/m1/interop-finish.md) - the interop matrix proves a clean broadcast finish across implementations
- [Exporters follow a rendition to a new track](/quest/m1/export-rendition-rebind.md) - the fMP4, TS, MKV and FLV exporters rebuild a rendition whose resolved `track` or `broadcast` changes under the same ID
- [HLS cursor failure](/quest/m1/hls-segments-failure.md) - the export segment cursor returns a failed timeline as an error after draining, so a truncated recording never looks complete
- [Track live signal](/quest/m1/track-live.md) - a reader can wait for its track's feed to be live, so a player skips old cached groups while a fresh upstream subscription starts
Expand Down
19 changes: 0 additions & 19 deletions quest/m1/interop-finish.md

This file was deleted.

4 changes: 0 additions & 4 deletions quest/m1/release-audit/ffi-finished.md
Original file line number Diff line number Diff line change
Expand Up @@ -31,7 +31,3 @@ Measure retained resources as retired-track count grows; avoid a brittle RSS
threshold. No public API or wire change is expected. If FFI API shape changes,
update every binding consumer and migration entry together. Current consumers
are long-lived binding publishers that replace or retire audio tracks.

## Related

- [Interop finish](/quest/m1/interop-finish.md) - preserve delivery while releasing resources
1 change: 1 addition & 0 deletions quest/m2/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -215,6 +215,7 @@ ranked just below deterministic TS legs, which it requires.
- [Relay metrics through prometheus-client](/quest/m2/relay-prometheus-client.md) - `/metrics` renders through the maintained client with the same series
- [IETF request order](/quest/m2/ietf-request-order.md) - d14/15 requests take their ID after opening, legacy `control.sending()` races are gone, and SUBSCRIBE_NAMESPACE never closes over its own close
- [JS IETF request streams](/quest/m2/js-request-stream.md) - `RequestStream` owns deadlines and cancellation, and TRACK trailing bytes close the session like Rust
- [moq-transport finish interop](/quest/m2/ietf-finish.md) - the interop `finish` case runs on every even moq-transport draft instead of being skipped
- [Join after a quick finish](/quest/m2/ietf-join-after-finish.md) - a pre-draft-20 joining FETCH that arrives after its subscription finished is still answered, within a bound the peer already negotiates
- [ashpd uses maintained D-Bus crates](/quest/m2/ashpd-maintained.md) - wait for a stable zbus 6 port, then remove the portal dependency exceptions
- [Askama uses a maintained TOML parser](/quest/m2/askama-maintained.md) - wait for a stable parser migration, then remove the generator dependency exception
Expand Down
35 changes: 35 additions & 0 deletions quest/m2/ietf-finish.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,35 @@
# [M] moq-transport finish interop

## Goal

The interop `finish` case passes on every even moq-transport draft, not only
moq-lite: each reader that joins a finished broadcast during its linger gets
the whole ten-frame tail, natural media and catalog EOF, the exact broadcast's
withdrawal, and the publisher's later health broadcast through the same
session. Until then `interop.sh` records those cells as skipped; delete that
skip in `run_finishes` and its README note.

## Plan

Observed on 2026-10-22 with `just test interop --finish --all --versions ietf`
(lite passes 45/45):

- Drafts 14 to 19: late readers see the finished catalog end empty, a short
tail, or a refused joining FETCH (`publish done: internal error`). This is
the pre-draft-20 join after a finish, which
[join after a quick finish](/quest/m2/ietf-join-after-finish.md) fixes; rerun
these drafts once it lands.
- Drafts 20 and 22: several readers time out after the withdrawal (C and C++
on the health broadcast), JS readers see `publish done: internal error`, and
native JS refuses a "malformed request stream message" from the relay.
Reproduce each between two clients before fixing; they may be separate bugs.

A failing reader fails its whole publisher row, since the publisher waits for
every reader's acknowledgement, so judge each cell from its reader's log.

Public API: none. Wire: none expected; any fix that changes framing updates
its draft.

## Related

- [Join after a quick finish](/quest/m2/ietf-join-after-finish.md) - the pre-draft-20 half of this
4 changes: 4 additions & 0 deletions rs/moq-cli/Cargo.toml
Original file line number Diff line number Diff line change
Expand Up @@ -179,6 +179,10 @@ harness = false
name = "interop-tail"
path = "../../test/interop/clients/rust/tail.rs"

[[example]]
name = "interop-finish"
path = "../../test/interop/clients/rust/finish.rs"

[[example]]
name = "interop-audio"
path = "../../test/interop/clients/rust/audio.rs"
21 changes: 21 additions & 0 deletions test/interop/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -46,6 +46,27 @@ shutdown. No sleep stands in for drain completion. A missing group, error, or
stall fails the lane; the timeout only bounds failure. QUIC on localhost rarely
reorders, so the ordering race remains covered by transport unit tests.

The in-tree matrix also has a `finish` case. `just test interop --finish --all`
runs it alone. Readers establish their sessions first, then wait on a private
stdin barrier without subscribing to media. Each publisher imports ten nonempty
H.264 frames in one GOP (the browser encodes the same finite fixture), finishes
all media and its catalog, and obtains the normal broadcast finish handle. Only
then does the runner release readers. They require all ten frames, natural media
and catalog EOF, and the exact broadcast's announcement END. After the finish
handle's real linger expires, the publisher announces a separate untimed health
track. Reading its payload and clean EOF on the original session proves that
withdrawal was not a transport shutdown. The final FIFO acknowledgement permits
teardown only; it never ends the linger. Each publisher also measures monotonic
time from before creating its finish handle and refuses a zero linger or a wait
shorter than that handle promises, without a fixed duration or tolerance.

GStreamer checks the late tail alone. `moqsrc` keeps watching a finished
broadcast, since an announcement means online/offline, so it has no end,
withdrawal, or session to report. It joins once the broadcast has finished and
requires exactly ten nonempty video buffers; its cell passes with the end check
marked N/A. A pinned moq-transport pass records the case as skipped until
[`quest/m2/ietf-finish.md`](../../quest/m2/ietf-finish.md) makes it pass.

Every client closes its session on the way out: publishers stop when their input
ends (the browser on SIGTERM), and subscribers close once they have their frame.
After each publisher's round, the harness waits for the relay to log the close of
Expand Down
Loading
Loading