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: 1 addition & 0 deletions quest/m0/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -44,6 +44,7 @@ a published `@moq/watch` break.
## Required

- [Request caps](/quest/m0/request-caps.md) - lite message sizes, IETF request IDs, and per-session announces and subscriptions are bounded
- [Prefix route fronts](/quest/m0/prefix-route-fronts.md) - a prefix route cannot be made to mint one front per requested path
- [qmux credit](/quest/m0/qmux-credit.md) - qmux returns connection credit for dropped and stopped streams and delivers its close frame, on both lines
- [Wildcard](/quest/m0/wildcard/README.md) - a relay resolves subscriptions against advertised prefixes, a service claims the prefix it could serve and refuses the rest instead of enumerating broadcasts, and the browser player treats a covering claim as availability
- [Broadcast epochs](/quest/m0/broadcast-epoch/README.md) - every first-party publisher that can restart mints a fresh `@<uuidv7>` epoch, viewers follow the newest live one, and bare names still resolve on every version
Expand Down
26 changes: 26 additions & 0 deletions quest/m0/prefix-route-fronts.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,26 @@
# [S] Prefix routes mint bounded fronts

## Goal

A peer requesting arbitrary paths under a prefix route cannot make an origin
mint one front, driver task, and upstream request per distinct path. The
number of fronts a prefix route can create is bounded, and a request past the
bound is refused rather than queued.

## Plan

Found while landing shared fronts (#4922, merged): viewers share one front
per path, but an optimistic resolve under a prefix route still mints a front
for every distinct requested path while the route stands. That cost is per path,
not per viewer, so a single session can amplify it by naming paths.

- Decide the bound (per route, per session, or both) and what a refusal looks
like on each wire version; reuse the refusal shapes
[Request caps](/quest/m0/request-caps.md) settles.
- Cover it with a test that requests many distinct covered paths and checks
the front count stays bounded, and extend the origin benchmark with a
distinct-path axis.

## Required

- [Request caps](/quest/m0/request-caps.md) - settles the refusal shapes reused here
8 changes: 7 additions & 1 deletion quest/m1/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -40,7 +40,6 @@ blocks. The quests that gated m0 lines moved under them.
- [Cluster routing](/quest/m1/cluster-routing/README.md) - any node routes toward a broadcast's origin over CDN and P2P links alike, with per-origin routes and path-less announces
- [One route cost](/quest/m1/route-cost.md) - Warm and Cold collapse to one static route cost
- [Track tail interop](/quest/m1/track-tail-interop.md) - a Rust publisher ending a track with a group in flight is read to its end by the JS subscriber, and the reverse, in `just test interop`
- [Request linger](/quest/m1/request-linger.md) - an upstream FETCH or SUBSCRIBE outlives its last reader by a short linger, so quick re-requests don't churn upstream
- [Flat questlines](/quest/m1/quest-flat-lines.md) - moq pins the current quest CLI, lands its questline branches on main, and retires them
- [moq-bot may push workflow changes](/quest/m1/bot-workflows-permission.md) - condition: the maintainer grants moq-bot's GitHub App the `workflows` permission, so back-merges carrying workflow changes go through
- [Binding audio delay](/quest/m1/binding-surface.md) - moq-ffi and every wrapper configure and observe audio playout delay
Expand All @@ -49,23 +48,30 @@ blocks. The quests that gated m0 lines moved under them.
- [Delete the live marker](/quest/m1/announce-live-removal.md) - announce streams yield only route events; the `Live` marker and its hold machinery are gone
- [WebTransport close backends](/quest/m1/wt-close-backends.md) - web-transport-noq and -quinn keep the session alive while closing, and iroh's client reads a capsule close
- [Enabled flag](/quest/m1/catalog-enabled.md) - one `enabled` rendition flag replaces `stalled` and pausing, and the flapping encoder-lag detector is deleted
- [Hang changelog](/quest/m1/hang-changelog-04.md) - the hang draft lists under -03 only what -03 published
- [SUBSCRIBE_DROP](/quest/m1/subscribe-drop.md) - every stream group in a lite subscription arrives or is dropped by name, and lite-07 drops its stream count for it
- [#2991](/quest/m1/2991-net-coalesce-dynamic-tracks-and-preserve-sequences-across.md) - one dynamic producer per track name in both languages, with the sequence namespace surviving a replacement
- [Subscribe ranges](/quest/m1/subscribe-ranges/README.md) - a lite-07 SUBSCRIBE asks for past and live ranges in either order and replaces FETCH; relays fill misses by range, including over moq-transport
- [Live media time](/quest/m1/subscribe-live-time.md) - re-scoped against `set_live`: a lite-07 SUBSCRIBE_OK carries the publisher's current media time only if a reader still needs it
- [Cross-relay bursts re-run](/quest/m1/cross-relay-bursts.md) - condition: the #4349 reporter re-runs their A/B/C comparison against current cdn.moq.pro
- [Flapping peer drill](/quest/m1/cross-relay-flap-drill.md) - the cluster burst drill survives a flapping peer link, the regression for 0.15.6 route-flap drops
- [Untimed lite-07](/quest/m1/lite-untimed.md) - lite-07 carries an untimed track in both languages; lite-05/06 write send time
- [Finalize moq-lite-07](/quest/m1/lite07-finalize.md) - when the maintainer cuts it, lite-07 negotiates as `moq-lite-07` and the next release ships it
- [Late lower groups](/quest/m1/lite-late-lower-group.md) - a moq-lite subscriber with a floor receives a group created below the first served one, as moq-transport does
- [JSON stream budget](/quest/m1/json-stream-budget.md) - an oversized JSON stream record is refused without ending the log, and a JS subscribe to a gone track answers NotFound
- [Flate stream budget](/quest/m1/flate-stream-budget.md) - a flate stream refuses an oversized append without ending, sharing one DEFLATE bound with json
- [JS track takeover](/quest/m1/js-track-takeover.md) - JS `createTrack` answers a queued request and continues its sequences, as Rust does
- [A watch and publish release ships assets()](/quest/m1/assets-release.md) - the release that lets the sites host the worklets
- [Dogfood hosted worklets](/quest/m1/dogfood-assets.md) - moq.dev and the moq.pro dashboard host the worklets and call `assets()` after the release
- [More tests under load](/quest/m1/test-flakes-2/README.md) - the second round of load-only failures, one quest per flake, fixed at the cause
- [moq-uring tests under load](/quest/m1/uring-tests-under-load.md) - uring tests pass while parallel checks share locked memory
- [Media audio-tone check](/quest/m1/media-audio-tone.md) - the media lane's audio-tone check passes under load, fixed at its cause
- [CI runner stalls](/quest/m1/ci-runner-stalls.md) - the 0.4 to 0.8 s freezes of both interop tracks on CI are attributed from a week of nightlies and fixed or told apart from playback bugs
- [Subscriber max-delay](/quest/m1/subscriber-max-delay.md) - subscriber staleness becomes `max_delay`; publisher retention stays `max_age`
- [Wire compatibility](/quest/m1/wire-compat.md) - a nightly run tests this checkout against the last published release for tokens, session wire, and catalog/container
- [Same-epoch importers](/quest/m1/hop-aligned-import.md) - importers sharing one `--epoch` and fed one stream publish identical groups and timestamps, so failover between a redundant pair survives
- [Auth client CA](/quest/m1/relay-auth-client-ca.md) - `auth::Config::validate` and `init` take the client-CA flag, so no caller can skip the check
- [Refuse ignored TLS config](/quest/m1/refuse-ignored-tls.md) - TLS options no listener would use fail at load instead of being ignored
- [TS stats module](/quest/m1/ts-stats-module.md) - the TS stats types move under `ts::stats` as `Snapshot` and `Stream`, with an owned `track`
- [cpal loads libasound at runtime](/quest/m1/cpal-alsa-runtime.md) - condition: a cpal release whose Linux build carries no load-time libasound requirement
- [Audio capture without ALSA link](/quest/m1/capture-alsa-link.md) - moq-audio capture and playback build on Linux without linking libasound
Expand Down
15 changes: 15 additions & 0 deletions quest/m1/cross-relay-flap-drill.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,15 @@
# [S] Cluster drill with a flapping peer link

## Goal

The two-relay burst drill also runs with the peer link flapping mid-burst,
and every group still arrives or fails by name within its bound. This is the
regression for the route-flap drops the 0.15.6 tree showed in #4349, which
current `main` no longer reproduces in a mock.

## Plan

Extend `bursts_cross_a_cluster` (#4920, `rs/moq-relay/tests/drills.rs`) rather
than adding a harness: flap the shaped peer link during a burst, keep strict
grading, and add a drill mutation proving the flap is graded. A moq-transport
peer link variant is optional; add it only if it is cheap here.
33 changes: 33 additions & 0 deletions quest/m1/flate-stream-budget.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,33 @@
# [S] A flate stream refuses an oversized append without ending

## Goal

`moq-flate` and `@moq/flate` `stream` mode refuse an append that cannot fit
the group budget with `GroupTooLarge` and leave the log intact, compressed or
not, as JSON streams do after #4911. In deflate mode, a payload beyond the
decoder's frame size limit is also refused before encoding without ending the
log.

## Plan

Flate's stream mode rides one group, like JSON's, so it has the same hole.
Move the DEFLATE worst-case bound (`deflateBound` / `deflate_bound`) from json
into flate and have json reuse it, so the bound and its tests live in one
place per language. Rust's helper is private; JS's is exported from its
encoder module, so expose only what json needs from flate.

The decoder-size check only runs in deflate mode (`self.flate.is_some()` in
`rs/moq-flate/src/stream/producer.rs`, `this.#flate &&` in
`js/flate/src/stream/producer.ts`). Refusing it without ending the track
deliberately reverses both producers' current behavior and their comments,
which treat it as terminal like any other lost record; update those comments.

Check both limits before mutating the compression window. A refusal leaves
prior records readable and allows a later fitting append; a failed write
after encoding still aborts, as JSON does. Mirror #4911's tests in both
compression modes, including the decoder-size refusal, and document the
budget and refusal behavior in the flate library docs.

## Required

- [JSON stream budget](/quest/m1/json-stream-budget.md) - #4911 provides the preflight budget model and DEFLATE bound
19 changes: 19 additions & 0 deletions quest/m1/hang-changelog-04.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,19 @@
# [XS] Hang draft changelog matches what -03 published

## Goal

The `drafts/draft-lcurley-moq-hang.md` changelog lists under -03 only what the
published -03 contains. Entries that landed after publication move to the
existing -04 section.

## Plan

Compare every -03 entry against the published
[draft-lcurley-moq-hang-03](https://www.ietf.org/archive/id/draft-lcurley-moq-hang-03.txt),
including its body and changelog; do not rely on an illustrative list of late
entries. The root `clock` section already shipped in -03 and stays there.
Run `just drafts check`. This corrects attribution, not the format.

## Required

- [Enabled flag](/quest/m1/catalog-enabled.md) - land after #4915's draft changelog edit to avoid conflicting changes
30 changes: 30 additions & 0 deletions quest/m1/js-track-takeover.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,30 @@
# [S] JS createTrack takes over a queued request

## Goal

In `@moq/net`, `createTrack` and `insertTrack` on a name with a queued or
pending request answer that request and continue the name's group and
datagram sequences, as Rust's `create_track` does, instead of throwing
`duplicate track`. The per-name sequence map stays bounded without forgetting
sequences that were written within the broadcast.

## Plan

Decided 2026-10-06 while settling #4929: that PR coalesces JS publishing-side
subscriptions per name and accepts the `duplicate track` throw for now; this
quest brings JS to parity. Drop unused entries only when no track holds them
and they never saw a write. Written sequence state survives until the
broadcast ends: evicting it and restarting under the same name would reuse
content identities and stall resumed readers.

Bound admission of additional names if retaining their sequence state would
exceed the map's bound; settle the refusal surface during implementation.
Starting sequences over requires a new broadcast. Test queued-request
takeover, explicit sequence advancement, replacement continuity, and bounded
name admission. Update the JS net docs for the behavior change.

Public API: behavior change in `@moq/net` only. Wire: none.

## Required

- [Dynamic track identity](/quest/m1/2991-net-coalesce-dynamic-tracks-and-preserve-sequences-across.md) - #4929 provides coalesced requests and the shared sequence namespace
23 changes: 23 additions & 0 deletions quest/m1/media-audio-tone.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,23 @@
# [S] Media audio-tone check holds under load

## Goal

The `just test media` audio-tone check passes under load, fixed at its cause.
It failed with 66 of 75 samples audible in #4719's runs and 72 of 81 in
the 2026-10-06 late-join loops (#4914), and passed on rerun.

## Plan

First decide whether the missing samples are real playback (a stall,
underrun, or late start the check correctly catches) or how the check samples
the tone. Reproduce it looped under synthetic CPU load (approved by the
maintainer for these runs) before changing anything, and don't widen the
window or lower the agreement threshold to hide the symptom. Keep this
standalone because its root cause is independent of the late-join regression;
apply the load-flake questline's cause-first rules and include it in the final
loaded check.

## Related

- [More tests under load](/quest/m1/test-flakes-2/README.md) - shares the loaded-check validation
- [Media late join](/quest/m1/test-flakes-2/media-late-join.md) - shares the media fixture, but tracks a separate failure
6 changes: 4 additions & 2 deletions quest/m1/perf/demand-aggregate.md
Original file line number Diff line number Diff line change
Expand Up @@ -30,8 +30,9 @@ readers, so `js/net/src/track.ts` keeps its fold.
- Bench first, in `rs/moq-net/benches/track.rs` (decided 2026-10-06): make
`track_subscriber_join` and `track_subscriber_churn` measure per-operation
cost swept over the readers already on the track (1, 100, 1k, 10k), and add a
preference-update sweep over the same axis. `viewers.rs` `viewer_join` is
the end-to-end check.
preference-update sweep over the same axis, including a leave by the reader
that holds a field's extreme. `viewers.rs` `viewer_join` is the end-to-end
check.
- A unit test checks the counted aggregate against a full fold across random
subscribe, update, and drop sequences.

Expand All @@ -40,3 +41,4 @@ Public API: none expected. Wire: none.
## Related

- [Front deadlines](/quest/m1/front-deadline-index.md) - the per-track half of a front's cost; this is the per-reader half
- [Subscribe ranges](/quest/m1/subscribe-ranges/model.md) - changes what the aggregate holds; whichever lands second adapts
19 changes: 19 additions & 0 deletions quest/m1/refuse-ignored-tls.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,19 @@
# [S] TLS settings that would be ignored are refused at load

## Goal

A relay or `moq` CLI config that sets a TLS option the configured listeners
would never use fails at load with an error naming the option, instead of
starting and silently ignoring it. Known cases: `tls.peers` on a server with
no QUIC listener, and `web.https.root` without `web.https.listen`.

## Plan

Same class of bug as the listener client CA that #4912 proposes refusing in
`moq_tokio::Server::build`. Audit the other TLS and listener options for
settings that only take effect on a listener that may not exist, and refuse
each where the config is assembled. TOML cannot express clap's `requires`, so
the check belongs in validation, not in the flag definitions.

Public API: none. Behavior: configs that relied on an ignored option now fail
to start, so note it in `doc/setup/upgrade.md`.
27 changes: 0 additions & 27 deletions quest/m1/request-linger.md

This file was deleted.

1 change: 1 addition & 0 deletions quest/m1/test-flakes-2/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -32,3 +32,4 @@ Public API: none. Wire: none.

- [Subscription cut by disconnect](/quest/m1/test-flakes-2/subscription-cut.md) - a publisher disconnect never ends a subscription clean
- [Media late join](/quest/m1/test-flakes-2/media-late-join.md) - `just test media` late join stays within one GOP, or the regression is fixed
- [Relay restart rebind](/quest/m1/test-flakes-2/relay-restart-rebind.md) - the crash drill restarts on its original UDP address under concurrent load
49 changes: 49 additions & 0 deletions quest/m1/test-flakes-2/relay-restart-rebind.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,49 @@
# [S] Relay crash drill rebinds its address under load

## Goal

`relay_killed_mid_group_aborts_then_resumes` reliably restarts its relay on
its original UDP address in the concurrent real-QUIC suite. The intermittent
`Address already in use` failure is reproduced and fixed at its cause,
while the interrupted group's failure and both clients' reconnect assertions
remain meaningful.

## Plan

Found during #4928's loaded `just check` on 2026-10-06, in unchanged code:
the impaired lane failed to load the replacement relay after recording that
the interrupted group aborted. Seed `16515990072133439138` failed in the
suite but passed alone, and a later full check passed. A passing rerun is
not evidence that the cause is gone.

- Measure first the likeliest cause: the relay's first port comes from
`relay_config(None)`, so it is ephemeral, and it sits unbound between
`RelayHost::kill` and the restart. The kill sends no CONNECTION_CLOSE, so
clients only notice the loss by timeout, and in that window another test's
`bind(0)` under load can take the port.
- Reproduce under concurrent checks and capture which socket owns the address
between `RelayHost::kill` and restart. Distinguish that competing ephemeral
bind from retained ownership after runtime shutdown; do not assume the seed
alone reproduces a scheduling race.
- Fix the ownership or allocation race at its source. Fixture-level fixes are
in scope, such as a stable client-facing address (a forwarder, for
example) so the restarted relay can take a fresh port. Preserve the crash
semantics and real reconnect coverage; retrying the bind, sleeping,
widening timeouts, or substituting graceful shutdown stay out.
- Follow this questline's event-based testing rules. Add a regression that
fails without the fix and run the existing drill in both lanes through CI.
Coordinate with the socket-close work if the cause is in the endpoint;
do not expand this quest into that API refactor without evidence.

Decided during the 2026-10-06 quest-complete sweep: the maintainer selected
separate investigation, then authorized the recommended course unattended.
Keep #4928's documentation correction focused. This is an m1 child of the
existing load-flake questline because it shares that validation goal.

Public API: none expected. Wire: none. Any discovered product impact belongs
in the implementation PR's Impact section. No new user-facing guide is needed
for this fixture investigation; update any comments the fix makes stale inline.

## Related

- [Socket close](/quest/m2/noq-socket-close.md) - replaces the closable socket wrapper, rather than assuming runtime shutdown released it
Loading
Loading