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 @@ -66,5 +66,6 @@ remain and no release waits on them.
- [Idle fronts](/quest/m0/idle-fronts.md) - a front nobody has read for the linger ends with its per-path state, so a standing claim stops accumulating fronts and sources
- [web-transport releases the qmux fixes](/quest/m0/qmux-credit-upstream.md) - waiting on moq-dev/web-transport#412 and #413 to merge and ship, which qmux credit bumps to
- [qmux credit](/quest/m0/qmux-credit.md) - qmux returns connection credit for dropped and stopped streams and delivers its close frame, on both lines
- [JS track takeover](/quest/m0/js-track-takeover.md) - JS `createTrack` answers a queued request and continues its sequences, as Rust does, so a re-announced `@moq/publish` catalog never restarts its groups
- [Broadcast epochs](/quest/m0/broadcast-epoch/README.md) - every first-party publisher that can restart mints a fresh route epoch, the newest wins a path, and only routes with the same epoch resume a subscription
- [moq-noq 2.0.2 on main](/quest/m0/noq-2.0.2.md) - `main` carries the max datagram size fix `release` gets in 1.3.4
14 changes: 9 additions & 5 deletions quest/m0/broadcast-epoch/publish-catalog-restart.md
Original file line number Diff line number Diff line change
Expand Up @@ -22,11 +22,15 @@ re-announce. `js/publish/src/broadcast.ts` mints the epoch once and keeps the
publisher across unannounce and announce on purpose, which points at
continuing the sequence.

#4929 (merged) made an on-demand producer continue a name's sequences
across replacements in both languages, but JS `createTrack` and
`insertTrack` still start at 0 (`doc/lib/js/net.md`). If this reproduces,
consider fixing it there, in `@moq/net`'s `createTrack`, so every JS
publisher continues the sequence, rather than in `@moq/publish` alone.
Decided 2026-10-08: the `@moq/net` fix belongs to
[JS track takeover](/quest/m0/js-track-takeover.md), so every JS publisher
continues a name's sequences; this quest does not fix `createTrack` itself.
Re-run the test once it lands and fix `@moq/publish` only if it still
restarts.

Public API: none expected. Wire: none.

## Required

- [JS track takeover](/quest/m0/js-track-takeover.md) - JS `createTrack` and `insertTrack` continue a name's sequences, which fixes the restart at its source

13 changes: 7 additions & 6 deletions quest/m0/broadcast-epoch/restart.md
Original file line number Diff line number Diff line change
Expand Up @@ -171,12 +171,13 @@ the downstream relay gets a `Restart` of `pool` (END then START on lite-06), dro
the nested paths, and the next subscribes reach the right workers, the moved
path on its new worker and the rest on theirs. Run `just drafts check` and `just test interop --all`.

Docs: open PR #5033 rewrites the publisher-restart docs to match today's
hard switch; land it first, then update `doc/concept/moq-lite.md` (publisher
epochs), the `doc/lib/{rs,js}` announce sections, and the gateway and
cluster pages under `doc/bin` wherever they still describe the hard switch
(a reconnect replacing the stale viewer, stale subscriptions ending with
`Unroutable`, a flapping lite-07 link cutting viewers).
Docs: #5033 (merged) rewrote the publisher-restart docs to match today's
hard switch. Update `doc/concept/moq-lite.md` (publisher epochs), the
`doc/lib/{rs,js}` announce sections, and every page that still describes the
hard switch (a reconnect replacing the stale viewer, stale subscriptions
ending with `Unroutable`, a flapping lite-07 link cutting viewers):
`doc/bin/rtmp.md`, `doc/bin/srt.md`, `doc/bin/cli.md`, and
`doc/setup/upgrade.md`.

Public API: breaking, a new `AnnounceEvent::Restart` variant (Rust) and
`"restart"` kind (JS). Wire: a new lite-07 announce message; older versions
Expand Down
12 changes: 7 additions & 5 deletions quest/m0/broadcast-epoch/stats-split.md
Original file line number Diff line number Diff line change
Expand Up @@ -96,10 +96,9 @@ Decided 2026-10-05 (planned from moq-dev/moq.pro#2202):
- **Sessions** (decided 2026-10-05). `sessions.json` is keyed by auth root
and loses pruned roots the same way, so fold per-tier `Presence` into the
totals (session counts) and serve per-root detail as a requested track,
the same model as prefix tracks. Open PR #5046 (session outcomes) adds to
`sessions.json`, which this retires; it is rewritten against these totals
and the per-root requested track, and lands after this (decided
2026-10-08).
the same model as prefix tracks.
[Session outcomes](/quest/m1/session-outcomes.md) Requires this and rides
these totals and the per-root requested track (decided 2026-10-08).
Comment thread
coderabbitai[bot] marked this conversation as resolved.
Resolved
- **Retire the map tracks** (`publisher.json`, `subscriber.json`,
`sessions.json`, and their `.json.z` siblings) in the same release. Decide
while implementing whether totals and prefix tracks keep `.json.z`
Expand All @@ -113,7 +112,9 @@ Decided 2026-10-05 (planned from moq-dev/moq.pro#2202):
same format it reads.

Decided 2026-10-08: if prefix tracks and self counters hold up the rest,
split them into a follow-up quest and land totals and sessions first. The
split them into a follow-up quest and land totals and sessions first; the
per-root requested track stays in the first release, since session outcomes
rides it and `sessions.json` retires with it. The
per-path map retirement moves with prefix tracks and self counters into that
follow-up: the maps are the only per-path source until prefix tracks exist,
and moq.pro's Broadcasts page reads prefix tracks the moment the maps retire,
Expand All @@ -130,4 +131,5 @@ customer stats feed serves this format summed across nodes.

- [Media stats](/quest/m1/stats/README.md) - publisher and viewer media stats
stay hang tracks, separate from the relay's stats
- [Session outcomes](/quest/m1/session-outcomes.md) - adds refusal and end counters to the totals and per-root track this introduces
- [QoS](/quest/m1/qos/README.md) - stats-split lands first; the egress lag histogram split out of #4133 requires it and rebases onto the totals and prefix tracks
Original file line number Diff line number Diff line change
Expand Up @@ -10,6 +10,10 @@ sequences that were written within the broadcast.

## Plan

Decided 2026-10-08: moved to m0, since
[publish catalog restart](/quest/m0/broadcast-epoch/publish-catalog-restart.md)
gates the release and its fix is this one.

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
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -11,18 +11,18 @@ sideways.
## Plan

The rest of #933 is done: the renderer applies `catalog.video.rotation`
(`js/watch/src/video/renderer.ts:187-198`) and file import rotates stored
footage (`js/publish/src/source/file.ts:283`, `:303-305`). Live camera capture
never sets the field.
(`#render` in `js/watch/src/video/renderer.ts`) and file import rotates stored footage
(`rotator` in `js/publish/src/source/file.ts`). Live camera capture never sets
the field.

- Add `rotation: Getter<number>` beside `flip` in the broadcast inputs
(`js/publish/src/broadcast.ts:25-26`) and write `section.rotation` next to
`section.flip` (`:178`).
- Add `rotation: Getter<number>` beside the `flip` input in
`js/publish/src/broadcast.ts` and write `section.rotation` next to
`section.flip`.
- Detect orientation in `js/publish/src/source/camera.ts` (the track's
settings, `screen.orientation`, or `VideoFrame.rotation`) and re-publish on
change.
- Wire the signal through `<moq-publish>` beside `#flip`
(`js/publish/src/element.ts:121-122`).
(`js/publish/src/element.ts`).
- `demo/web` sets neither `flip` nor `rotation`, so nothing changes there.

Additive on `@moq/publish`, so it lands on main.
Expand Down
14 changes: 7 additions & 7 deletions quest/m1/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -54,35 +54,35 @@ were done or not worth their cost.
- [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
- [lite-07 Live flag](/quest/m1/lite-live.md) - a separate `Live` field on lite-07 SUBSCRIBE, so merged floors never starve a subscriber; late lower groups build on it
- [Draft-20 FETCH](/quest/m1/ietf-fetch-location.md) - a draft-20+ FETCH within one group is served from its LOCATION_FILTER, as older drafts are
- [FETCH_OK properties](/quest/m1/fetch-ok-properties.md) - our FETCH_OK carries the track properties SUBSCRIBE_OK does, as draft 16+ requires
- [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
- [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
- [Cross-relay FETCH on any peer link](/quest/m1/ietf-peer-fetch-old.md) - a lite or moq-transport peer link serves held groups instead of refusing them as old, and the drill covers both
- [Untimed lite-07](/quest/m1/lite-untimed.md) - lite-07 carries an untimed track in both languages; lite-05/06 write send time
- [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
- [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
- [Media audio-tone check](/quest/m1/media-audio-tone.md) - the media lane's audio-tone check passes under load, fixed at its cause
- [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
- [FFI runtime](/quest/m1/ffi-runtime.md) - moq-ffi and moq-c drive moq on a multi-thread runtime instead of one thread
- [FFI runtime](/quest/m1/ffi-runtime.md) - moq-ffi drives moq on a multi-thread runtime instead of one thread
- [Audio group duration](/quest/m1/audio-group-duration.md) - audio groups span at least 20 ms by default, so small frames don't mint a group each
- [Browser interop cells](/quest/m1/interop-browser-timeouts.md) - `go -> js` and `python -> js` pass, fixed at the cause rather than by a longer timeout
- [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
- [Kotlin wrapper POMs](/quest/m1/kt-ffi-pom.md) - Maven builds of `dev.moq:moq` resolve a published moq-ffi instead of the missing `0.0.0-dev`
- [Homebrew moq-gst](/quest/m1/gst-brew-path.md) - `brew install moq-gst` installs the plugin from the tarball's `lib/gstreamer-1.0/`
- [Installable moq-gst](/quest/m1/gst-brew-path.md) - `brew install moq-gst` installs the plugin from the tarball's `lib/gstreamer-1.0/`, and the Nix package carries `x264enc`, `avenc_aac`, and `avdec_h264`
- [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
- [moq.sh deploys from CI](/quest/m1/moq-sh-deploy.md) - the first `release` run of the moq.sh workflow deploys with the Workers Editor token
- [Plan: untimed verbatim PES](/quest/m1/plan-ts-pes-untimed.md) - decide how a verbatim TS track carries a PES that has no PTS, then write the implementation quest
- [Data consumer timestamps](/quest/m1/data-consumer-timestamps.md) - json and binary consumers return each value's timestamp, in Rust and every binding; snapshots add `latest()` beside an in-order `next()`
- [JS data consumer timestamps](/quest/m1/js-data-consumer-timestamps.md) - @moq/json and @moq/flate consumers return each value's timestamp, with snapshot `next()` and `latest()`
- [Draft-20 FETCH](/quest/m1/ietf-fetch-location.md) - a draft-20+ FETCH within one group is served from its LOCATION_FILTER, as older drafts are
- [FETCH_OK properties](/quest/m1/fetch-ok-properties.md) - our FETCH_OK carries the track properties SUBSCRIBE_OK does, as draft 16+ requires
- [IETF object gaps](/quest/m1/ietf-object-gaps.md) - a gapped object ID is refused loudly like a subgroup in Rust and JS, and an overflowing one closes the session in Rust
- [JavaScript FETCH](/quest/m1/js-fetch.md) - browser publishers answer IETF FETCH through the JS ranges request surface
- [Relay session limits](/quest/m1/relay-session-limits.md) - moq-relay sets per-session request limits, tighter for clients than peers, and the bindings name a refused request
- [Churn with held subscriptions](/quest/m1/session-churn-held.md) - opening and closing a request costs the same with 1 or 1,024 held subscriptions
- [Catalog track identity](/quest/m1/catalog-tracks.md) - a track's codec and description never change for its name; resolution changes in band below ceilings fixed at creation, and anything else mints a new rendition or epoch
- [Archive](/quest/m1/archive/README.md) - record selected tracks to any object_store and replay them over FETCH or derived HLS; the catalog entry and format may break in place, since no archives exist
- [In-band auth](/quest/m1/auth/README.md) - a session tells its peer what it may publish and subscribe to, unions tokens presented in band, and fails loud on an out-of-scope publish
- [Claim epochs](/quest/m1/claim-epochs.md) - a lite-07 claim's answer carries its broadcast's epoch, so a worker restarting an output under an unchanged claim route is a new source; moved from m0 on 2026-10-08 since lite-07 is opt-in
Expand All @@ -106,10 +106,10 @@ were done or not worth their cost.
- [Own the QUIC stack](/quest/m1/quic/README.md) - quinn hard-forked in-tree as `moq-quic`, carrying BBR, reliable reset, hierarchical scheduling, peer limits, and endpoint sharding
- [QoS](/quest/m1/qos/README.md) - broadcast health: relay starvation and timeliness histograms
- [Session outcomes](/quest/m1/session-outcomes.md) - the relay's session stats count refusals by reason and ends by kind, per root and tier
- [Typed refusal reason](/quest/m1/refusal-reason.md) - an auth server's 403 names the reason (including `expired`) and the root and tier, so the relay's session outcomes count and attribute refusals
- [Catalog rendition IDs](/quest/m1/catalog-track-id.md) - catalog rendition keys become IDs unique across video and audio, with an optional `track` name, so one catalog lists renditions from several broadcasts
- [Media stats](/quest/m1/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
- [JS track handover](/quest/m1/js-group-handover.md) - a JS track subscription resumes across a route swap from the first frame it lacks, so `test/drain` passes at zero latency budget
- [JS startup hole](/quest/m1/js-startup-hole.md) - a `@moq/hang` consumer delivers its first live group at once, even when an empty group died before it
- [Drain handshakes](/quest/m1/drain-handshakes.md) - a drain GOAWAYs and waits for sessions still in their handshake instead of exiting under them
- [Transport upgrade](/quest/m1/transport-upgrade/README.md) - a session that came up over WebSocket moves to QUIC once the QUIC dial lands, handing over without dropping a group
- [Scope track priority](/quest/m1/track-priority-scope.md) - priority orders one owner's streams, and a shared cluster session is fair across tenants
Expand All @@ -132,7 +132,7 @@ were done or not worth their cost.
- [io_uring handshake deadline](/quest/m1/listener-deadlines.md) - the io_uring workers apply `listen.timeout` to the handshake
- [HTTP listener deadlines](/quest/m1/listener-deadlines-http.md) - the HTTPS and internal listeners drop a connection with no request in flight for `listen.timeout`
- [iroh keep-alive](/quest/m1/iroh-keep-alive.md) - the iroh backend honors `quic.keep_alive`
- [Rust papercuts](/quest/m1/papercuts-rs.md) - HTTP refusals are counted, a `u64::MAX` resume is unbounded, GOING_AWAY falls forward, and GRO stride 0 cannot panic
- [Rust papercuts](/quest/m1/papercuts-rs.md) - HTTP refusals are counted, and a `u64::MAX` resume is unbounded
- [JS papercuts](/quest/m1/papercuts-js.md) - IETF status 0 keeps the subgroup open, a muted rendition change settles, and bad element attributes warn
- [Front parking](/quest/m1/origin-front-parks.md) - an unroutable request waits on a front instead of re-asking on every route-table move
- [Route wakes](/quest/m1/route-wakes.md) - a route change wakes only the fronts it can move, so pool churn stops scaling with served paths
Expand Down
2 changes: 1 addition & 1 deletion quest/m1/archive/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -172,5 +172,5 @@ owned by that prerequisite, not duplicated in archive storage.

## Related

- [Catalog track identity](/quest/m2/catalog-tracks.md) - a track's definition never changes for its name, so any recorded catalog describes every group of the tracks it lists
- [Catalog track identity](/quest/m1/catalog-tracks.md) - a track's definition never changes for its name, so any recorded catalog describes every group of the tracks it lists
- [e2ee](/quest/m1/e2ee/README.md) - protected broadcasts are excluded initially
28 changes: 21 additions & 7 deletions quest/m1/archive/replay-catalog.md
Original file line number Diff line number Diff line change
Expand Up @@ -9,10 +9,24 @@ its recorded catalog live, stamped with the recording's `store` and `version`,
so an exporter in history mode treats its timeline as durable and lists past
`--window`. A `--follow` replay grows like an event playlist.

A track's definition never changes for its name
([Catalog track identity](/quest/m2/catalog-tracks.md)), so the newest
recorded catalog describes every group of the tracks it lists; nothing here
picks a catalog per group.
[Catalog track identity](/quest/m1/catalog-tracks.md) guarantees a track's
identity never changes for its name, and resolution changes in band below
its ceilings, so one catalog describes every group of the tracks it lists;
nothing here picks a catalog per group.

Decided 2026-10-08 (review): the catalog at the live edge is the union of
every rendition recorded, so a rendition removed mid-recording stays
discoverable; one no longer live is listed with `enabled: false`. VOD
consumers (HLS archive mode, DVR) list a rendition that has recorded media
regardless of `enabled`; live watch keeps filtering disabled ones. HLS
segments every playlist from one reference rendition (`reference()` in
`rs/moq-hls/src/export/mod.rs`), so when the reference's recording ends
while another continues, archive mode advances the reference to the
continuing one without dropping earlier rows, or the union stalls the
playlist at the old rendition's end. Paced
replay (m3) replays the catalog history instead. Test a rendition removed
before the recording ends, including the reference while another
continues: both the first segment and the tail stay listed.

## Plan

Expand All @@ -21,9 +35,8 @@ is FETCH-only, so a SUBSCRIBE to it on the replay broadcast never sees a group
and `moq-hls` never finds the `archive` entry. The HLS archive tests work around
this by hand-building a catalog.

- Republish each recorded catalog group live in its timeline's order, so the newest
one is at the live edge and a `--follow` replay picks up catalogs recorded
after it opened.
- Republish the recorded catalog live as that union, updated in timeline
order so a `--follow` replay picks up renditions recorded after it opened.
- Stamp `store` with the URL passed to `import archive`, and `version` with the
recording format. Refuse a URL carrying userinfo and strip its query so
credentials never land in a catalog, and let the importer opt out of
Expand Down Expand Up @@ -69,4 +82,5 @@ loudly on a recording with no catalog.

## Required

- [Catalog track identity](/quest/m1/catalog-tracks.md) - the guarantee that one recorded catalog describes every group
- [History from the start](/quest/m1/archive/replay-history.md) - history mode lists a recording from its start, which "lists the whole recording" needs
Loading
Loading