diff --git a/quest/m1/announce-takeover.md b/quest/m1/announce-takeover.md index e7f7a7618ca..c9db540f92d 100644 --- a/quest/m1/announce-takeover.md +++ b/quest/m1/announce-takeover.md @@ -58,11 +58,17 @@ this quest removes the predecessor machinery and grows to [XL]. `lite/announce.ts` and `lite/subscriber.ts`. Remove the takeover sections from `drafts/draft-lcurley-moq-lite.md`, `doc/concept/identity.md` and `doc/concept/moq-lite.md`. -- **Inheriting the instance.** `request.route(options)` from - [One Route handle](/quest/m1/api-audit/route/handle.md) creates the - path's exact route under the prefix route's instance by default, and the - answer it gives the waiting request is that route's broadcast. A job - that serves a held broadcast through `Request::serve` +- **Inheriting the instance.** Decided 2026-11-03 (maintainer, on + [moq-dev/moq#7770](https://github.com/moq-dev/moq/pull/7770)): + `request.route(options)` from + [One Route handle](/quest/m1/api-audit/route/handle.md) mints a fresh + instance by default, and ending a job leaves its prefix route open, with + no history of ended paths. Carrying the prefix route's instance onto the + path's exact route, so that the answer the waiting request gets is that + route's broadcast, is this quest's change, and it must keep those + properties: a restarted job still gets a fresh instance, and job + lifetimes stay independent without per-path history of ended jobs. + A job that serves a held broadcast through `Request::serve` never announces an exact route, so it needs none of this. - **One stream per path and instance.** A claim may answer a path under its instance only while that stream is live. Once the job's route ends, @@ -144,7 +150,7 @@ beyond [Instance and epoch](https://github.com/moq-dev/moq/pull/7489)'s fields. ## Required -- [One Route handle](/quest/m1/api-audit/route/handle.md) - `request.route` creates the exact route under the claim's instance +- [One Route handle](/quest/m1/api-audit/route/handle.md) - `request.route` creates the path's exact route, minting a fresh instance by default ## Related diff --git a/quest/m1/api-audit/route/handle.md b/quest/m1/api-audit/route/handle.md index 2df9273eb47..adf63a37a88 100644 --- a/quest/m1/api-audit/route/handle.md +++ b/quest/m1/api-audit/route/handle.md @@ -64,11 +64,25 @@ JS and the bindings identical. - **Prefix routes.** A prefix route yields requests, and each one is answered by `serve(consumer)`, by `route(options)`, or by `reject`. `route(options)` creates the path's - exact `Route`, which inherits the prefix route's instance by default so - that the reader continues (see [announce takeover](/quest/m1/announce-takeover.md)). - A prefix route takes cost and auth as an exact one does, so claims can - be priced. Today `Requests::route()` is always the default and - `update_route` is crate-private. + exact `Route`. A prefix route takes cost and auth as an exact one does, + so claims can be priced. Today `Requests::route()` is always the default + and `update_route` is crate-private. +- **A job's instance.** ✅ Decided 2026-11-03 (maintainer, on + [moq-dev/moq#7770](https://github.com/moq-dev/moq/pull/7770)): + `request.route(options)` mints a fresh instance by default, as + `Request::prepare` does today, so a job that ends and restarts beneath + the same prefix gets a new instance for its restarted sequences. An + explicit stable instance in the options is only for a caller that + continues its sequences. Ending a job's route withdraws only that path: + the prefix route stays open and keeps answering later requests, each + with its own job lifetime, and the origin keeps no history of ended + paths. The existing predecessor handling stays until + [announce takeover](/quest/m1/announce-takeover.md) replaces it, and + that quest owns continuing the claim's readers on the job's route. + Rejected: inheriting the prefix route's instance by default and making + the prefix terminal once a materialized job ends, which would change + long-lived services; and inheriting it with automatic restarts, which + needs ended-path history or a retirement design this quest does not own. - **Visibility, not unannounced broadcasts.** Callers that fill the catalog first (`moq-cli` hls, rtsp and publish; moq-mux `ts/programs.rs`) or announce after SDP (`moq-rtc/server/whip.rs`) create