From 618c3da3fff444c9b16b9ea38243c5521546f2cd Mon Sep 17 00:00:00 2001 From: Luke Curley Date: Wed, 28 Oct 2026 00:33:39 -0700 Subject: [PATCH 1/3] chore(quest): claim quest/m1/upgrade-guide-facts.md Quest-Claim: ca7272a362ba3985 From 5686ed75b9f1ab4f08b1b0ac61107456d22f55b0 Mon Sep 17 00:00:00 2001 From: Luke Curley Date: Wed, 28 Oct 2026 00:40:07 -0700 Subject: [PATCH 2/3] docs: align upgrade notes with supported behavior Co-Authored-By: Codex --- quest/m1/README.md | 1 - quest/m1/upgrade-guide-facts.md | 30 ------------------------------ 2 files changed, 31 deletions(-) delete mode 100644 quest/m1/upgrade-guide-facts.md diff --git a/quest/m1/README.md b/quest/m1/README.md index c8fd34f95eb..b2286bc593f 100644 --- a/quest/m1/README.md +++ b/quest/m1/README.md @@ -137,7 +137,6 @@ removed). - [Moxygen minimal interop](/quest/m1/smoke-moxygen.md) - waiting on Moxygen to send a registered filter type, then the smoke lane stops hiding its failure - [Moxygen pin bump](/quest/m1/moxygen-pin-bump.md) - waiting on moxygen#264, then the TRACK_STATUS patch is dropped - [Broadcast lifecycle](/quest/m1/broadcast-lifecycle/README.md) - broadcasts are online or offline with no finished state in moq-net, finished-broadcast retention is a fixed moq-mux policy, and each linger timer has one meaning -- [Upgrade notes match the code](/quest/m1/upgrade-guide-facts.md) - the upgrade and CLI migration guides stop promising drafts 19-21, capped grants, and an ignored `MOQ_EPOCH` - [A smaller, safer API than release](/quest/m1/api-audit/README.md) - every surface added since release has a consumer or is gone, overlapping operations are collapsed, names mirror across Rust, JS, and the bindings, and every break says how to migrate - [moq-transport 18 and 22 only](/quest/m1/ietf-drop/README.md) - drafts 14-17 and 19-21 are deleted from Rust, JS, tests, interop lanes, and docs, removing the legacy control-stream adapter and its request limit - [moq-quic's API improves on quinn's](/quest/m1/quic-api/README.md) - moq-quic and both QUIC drivers ship one mirrored API: `send::`/`recv::` namespaces, one error per direction, consuming terminal operations, plain configs, no quinn baggage diff --git a/quest/m1/upgrade-guide-facts.md b/quest/m1/upgrade-guide-facts.md deleted file mode 100644 index d4845012675..00000000000 --- a/quest/m1/upgrade-guide-facts.md +++ /dev/null @@ -1,30 +0,0 @@ -# [XS] Upgrade notes match the code - -## Goal - -The upgrade guide and the CLI migration guide stop promising behavior the -code refuses: moq-transport drafts 18 and 22 only, no capped grants, and a -`MOQ_EPOCH` that stops startup. - -## Plan - -Decided 2026-10-27 (maintainer), from an external release-to-main audit. -Each is a fact an earlier change made stale. - -- `doc/setup/upgrade.md` says Rust and JavaScript speak drafts "18 through - 22"; `rs/moq-net/src/ietf/version.rs` has only `Draft18` and `Draft22`. -- `doc/setup/upgrade.md`'s "Capped grants need upgraded verifiers" bullet - describes a `rate` cap that moq-auth now refuses as an object role - (`rs/moq-auth/MIGRATE.md`). Replace it with the true rule: uncapped tokens - keep their format, and an object role is refused. -- `rs/moq-cli/MIGRATE.md` says `MOQ_EPOCH` is ignored, but `check_env` - (`rs/moq-tokio/src/cli/env.rs`) refuses every undeclared `MOQ_*` - variable. Keep the refusal (fail loud) and say startup stops until the - variable is removed. -- Grep the other `MIGRATE.md` files and `doc/` for removed `MOQ_*` - variables described as ignored and fix them the same way. - -Collapsing intermediate entries stays with the -[migration audit](/quest/m2/release/migrate-audit.md). - -Public API: none. Wire: none. From 56de18a8e70b60260c12d08a26d501ea9fee69ab Mon Sep 17 00:00:00 2001 From: Luke Curley Date: Wed, 28 Oct 2026 00:41:15 -0700 Subject: [PATCH 3/3] docs: correct draft support, auth roles, and removed variables Co-Authored-By: Codex --- doc/setup/upgrade.md | 11 +++++------ rs/moq-cli/MIGRATE.md | 2 +- rs/moq-relay/MIGRATE.md | 3 ++- 3 files changed, 8 insertions(+), 8 deletions(-) diff --git a/doc/setup/upgrade.md b/doc/setup/upgrade.md index ee1ecd9583b..50a71ce7f5e 100644 --- a/doc/setup/upgrade.md +++ b/doc/setup/upgrade.md @@ -43,9 +43,9 @@ These land with the next breaking release. Mixed versions only differ in how an unset priority ranks against a set one, so upgrade publishers and players in either order. - **moq-transport drafts 14 through 17 are dropped.** Rust and JavaScript - speak moq-transport drafts 18 through 22 only, and the `moql` SETUP + speak moq-transport drafts 18 and 22 only, and the `moql` SETUP negotiates moq-lite only. A peer that offers nothing newer fails - to connect instead of falling back, so move such peers to draft 18 or a + to connect instead of falling back, so move such peers to draft 18, draft 22, or a moq-lite version before upgrading what they connect to. - **WebSocket needs a QMux subprotocol** (#6231). Relays answer a WebSocket upgrade that offers no `qmux-NN` subprotocol with 400 instead of falling back @@ -57,10 +57,9 @@ These land with the next breaking release. - **Auth requests name `webtransport`** (#5293). Relays report a WebTransport session as `webtransport` instead of `quic`, and older auth servers reject the new value, so upgrade auth servers before relays. -- **Capped grants need upgraded verifiers** (#5697). A token whose `publish` - or `subscribe` carries a `rate` cap encodes that role as an object, which - released verifiers reject, so upgrade every auth server and verifier before - issuing capped tokens. +- **Auth roles are pattern arrays.** Uncapped tokens and grants keep their + format. An object role, including one with a `rate` cap, is refused; use + pattern arrays for `publish` and `subscribe`. - **HLS records replace archive timelines.** The hang catalog's root `archive` section is gone. A video or audio rendition carries its own `hls` field naming a `.hls` record track, which Rust publishers write by default. diff --git a/rs/moq-cli/MIGRATE.md b/rs/moq-cli/MIGRATE.md index 6571f46ad7f..3fe84c972cf 100644 --- a/rs/moq-cli/MIGRATE.md +++ b/rs/moq-cli/MIGRATE.md @@ -51,7 +51,7 @@ If your auth server can take longer than the handshake timeout allows, raise `-- ### `--epoch` is removed (#5967) -Remove `--epoch` and `MOQ_EPOCH`: `--epoch` is now an unknown flag, and `MOQ_EPOCH` is ignored. +Remove `--epoch` and `MOQ_EPOCH`: either stops startup as an unknown flag or environment variable. Every `moq` run mints its own epoch, so two importers fed one stream publish two instances, and the newest wins new requests. To fail over between them, follow restarts: `export ts --stitch` switches programs, and players follow the announced restart. Other consumers, such as `export ts --passthrough`, end with the instance they read. diff --git a/rs/moq-relay/MIGRATE.md b/rs/moq-relay/MIGRATE.md index 9423d0aa6a0..bd005003de3 100644 --- a/rs/moq-relay/MIGRATE.md +++ b/rs/moq-relay/MIGRATE.md @@ -152,7 +152,8 @@ Each used to be ignored: drop it, or add the listener it configures. ### `--cluster-mesh` and `--cluster-linger` are unknown flags (#4818) -They, TOML `mesh` and `linger`, and `MOQ_CLUSTER_MESH` / `MOQ_CLUSTER_LINGER` are no longer read. +Remove the flags, TOML `mesh` and `linger`, and `MOQ_CLUSTER_MESH` / `MOQ_CLUSTER_LINGER`. +The removed environment variables stop startup rather than being ignored. List every peer with `--cluster-connect` or `--cluster-connect-api`. In Rust, `cluster::Config` has no `mesh` or `linger` field.