chore(quest): turn outside conditions into quests and bump quest

.claude/skills/quest-finish/SKILL.md → .claude/skills/quest-complete/SKILL.md

@@ -1,7 +1,7 @@
 ---
-name: quest-finish
+name: quest-complete
 description: Decide which open PRs to merge, then merge them in parallel.
 ---
 
-Run `quest skill finish` and follow its output.
+Run `quest skill complete` and follow its output.
 If `quest` is not installed, follow https://github.com/kixelated/quest/blob/main/SETUP.md first.

.claude/skills/quest-export/SKILL.md

@@ -0,0 +1,7 @@
+---
+name: quest-export
+description: Turn active quests into GitHub issues before leaving Quest. Use when the user invokes /quest-export or asks to export quests before removing Quest.
+---
+
+Run `quest skill export` and follow its output.
+If `quest` is not installed, follow https://github.com/kixelated/quest/blob/main/SETUP.md first.

.claude/skills/quest-import/SKILL.md

@@ -0,0 +1,7 @@
+---
+name: quest-import
+description: Import GitHub issues as quests.
+---
+
+Run `quest skill import` and follow its output.
+If `quest` is not installed, follow https://github.com/kixelated/quest/blob/main/SETUP.md first.

AGENTS.md

@@ -92,7 +92,7 @@ just fix          # Auto-fix lint/formatting, same scope
 
 These diff the branch against its base and only run the affected packages.
 
-When work mentions a quest, run `quest guide` and follow it.
+Quests: when work mentions a quest, run `quest guide` and follow it.
 The `quest` binary comes from the kixelated/quest flake input and serves the quest skills; change them upstream and bump the input.
 A quest deleted on `dev` is done, even while `main` still lists it.
 

flake.nix

@@ -27,7 +27,7 @@
     # The quest CLI, which also serves the quest guide and skills the stubs in
     # .claude/skills call. Bump the rev to upgrade them.
     quest = {
-      url = "github:kixelated/quest/8590d2a1ddd91c2f499adf37b78aad0d673e3228";
+      url = "github:kixelated/quest/362489bcf02833d8674cff339463b086442cf92d";
       inputs.nixpkgs.follows = "nixpkgs";
       inputs.flake-utils.follows = "flake-utils";
       inputs.crane.follows = "crane";

quest/README.md

@@ -16,10 +16,10 @@ offer. m4 waits on an upstream release. Priority is
 separate from branch targeting: published API and wire breaks still land on dev
 under the repository rules.
 
-A quest waiting on the outside world, in any milestone, states that condition
-as a plain-text `Required` bullet, so `quest ready` reports it blocked.
-`/quest-audit` re-checks those gates; when one clears, remove the bullet and
-move the quest to the milestone its priority belongs in.
+A quest waiting on the outside world, in any milestone, requires a small quest
+beside it that names the condition. That condition quest stays ready, so
+every `/quest-spawn` resurfaces it; when the condition clears, delete it and
+move the blocked quest to the milestone its priority belongs in.
 
 ## Required
 

quest/m1/README.md

@@ -36,6 +36,7 @@ QUIC studies there on that rule.
 - [IETF drain before close](/quest/m1/ietf-drain-before-close.md) - moq-transport sessions deliver finished tracks before a graceful close, as moq-lite does
 - [Close waits for the tail](/quest/m1/close-tail.md) - on lite-07, `close()` returns `Ok` only after each subscriber FINs its Subscribe Stream, having read the track to its end
 - [moq play drain tail](/quest/m1/play-drain-tail.md) - retired renditions and finite tracks play their last 10 ms of audio
+- [web-transport-moq 1.3.3 ships noq#24](/quest/m1/web-transport-moq-release.md) - the release that carries the close-capsule fix
 - [WebTransport close upstream](/quest/m1/wt-close-upstream.md) - web-transport-moq delivers the close capsule itself, and moq-tokio's `CLOSE_LINGER` is deleted
 - [Browser close code](/quest/m1/browser-close-code.md) - a playwright case proves the page reads a relay's close code and reason, on every web-transport backend
 - [Resumed groups](/quest/m1/resume-latest.md) - a half-delivered group ends once the new copy is past it, so a group-only reader never parks after a mid-group failover
@@ -49,6 +50,7 @@ QUIC studies there on that rule.
 - [Session death parity](/quest/m1/session-death.md) - a local close ends tracks cleanly in both languages, and JS group readers see the session's error on session death
 - [Watch and publish under CSP](/quest/m1/csp-assets.md) - blob workers stay the default; strict-CSP apps host the files and set a base URL
 - [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
+- [A week of nightly interop after #4529](/quest/m1/interop-week.md) - the nightly traces the stall diagnosis reads
 - [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
 - [Catalog estimate rate](/quest/m1/catalog-estimate-rate.md) - a rising `jitter`/`delay` estimate republishes the catalog at most once a second, in js/publish and moq-mux
 - [Rewind detail](/quest/m1/timestamp-rewind-detail.md) - a refused timestamp rewind names the frame's timestamp and the live edge
@@ -58,6 +60,7 @@ QUIC studies there on that rule.
 - [TS PSI reassembly](/quest/m1/ts-psi-reassembly.md) - `import ts` reads a PAT or PMT that spans packets or follows a nonzero pointer_field instead of aborting, and one corrupted section costs a repetition and a counted `CRC_error`, not the import
 - [TS damaged units](/quest/m1/ts-damaged-units.md) - one malformed PES or access unit is dropped, counted as `damaged`, and resynced at the next keyframe instead of ending the import
 - [RTMP interleaving](/quest/m1/rtmp-interleaving.md) - isolate partial messages before optimizing assembly copies
+- [Merge main into dev](/quest/m1/dev-sync.md) - dev picks up `ts::stats` from main
 - [TS stats module](/quest/m1/ts-stats-module.md) - on dev, the TS stats types move under `ts::stats` as `Snapshot` and `Stream`, with an owned `track`
 - [Same-hop importers](/quest/m1/hop-aligned-import.md) - importers fed one stream publish identical groups and timestamps, so failover between a redundant pair survives
 - [Audio capture without ALSA link](/quest/m1/capture-alsa-link.md) - moq-audio capture and playback build on Linux without linking libasound
@@ -86,6 +89,7 @@ QUIC studies there on that rule.
 - [Dropped sources](/quest/m1/dropped-sources.md) - track consumers see the producer's real error on every end path, never `Dropped`
 - [C++ through moq-ffi](/quest/m1/cpp/README.md) - generated C++ over moq-ffi with futures and expected-style errors, shipped as a tarball, vcpkg, and Conan, and adopted by the OBS plugin
 - [Generated C bindings](/quest/m1/c/README.md) - C generated from moq-ffi ships as `moq-c` 0.8.0 and replaces the hand-written libmoq
+- [dev's decoded-frame surface reaches main](/quest/m1/obs-decoded-surface.md) - the surface the OBS source decodes into is on main
 - [OBS native codecs](/quest/m1/obs-moq-video/README.md) - replace FFmpeg video and audio decoding with moq-video and moq-audio, deliver GPU frames, and use native audio/video encoders
 - [AudioToolbox decode](/quest/m1/audio-decode-audiotoolbox.md) - macOS and iOS decode HE-AAC, multichannel AAC, and what else the framework offers
 - [HE-AAC catalog output](/quest/m1/he-aac-catalog-output.md) - HE-AAC catalog entries name the output rate and layout, not the LC core
@@ -100,6 +104,7 @@ QUIC studies there on that rule.
 - [Opus mapping family](/quest/m1/opus-mapping-family.md) - on dev, the Opus head config keeps its mapping family only in `mapping`
 - [mp4-atom dOps mapping](/quest/m1/mp4-atom-dops-mapping.md) - a released mp4-atom reads and writes any `dOps` channel mapping family and table
 - [CMAF surround Opus](/quest/m1/cmaf-opus-surround.md) - fMP4 import and export carry an Opus channel mapping table
+- [A self-hosted NVIDIA runner is registered](/quest/m1/gpu-runner.md) - the maintainer registers the host that runs the NVIDIA tests
 - [GPU CI](/quest/m1/gpu-ci.md) - NVIDIA tests run nightly on a self-hosted GPU runner, and `just rs nvidia` runs them locally instead of skipping
 - [JS rendition ranking](/quest/m1/js-ranked.md) - `@moq/hang` ranks video renditions like Rust, and `@moq/watch`'s fallback uses it
 - [Audio rendition pick](/quest/m1/audio-ranked.md) - single-track FLV/RTMP and WHEP serve the best audio rendition, not the first by name

quest/m1/ci-runner-stalls.md

@@ -25,4 +25,4 @@ Public API: none. Wire: none.
 
 ## Required
 
-- A week of nightly interop runs on `main` after #4529, which adds the `delay` column these traces need
+- [A week of nightly interop after #4529](/quest/m1/interop-week.md) - the traces carry the `delay` column

quest/m1/dev-sync.md

@@ -0,0 +1,13 @@
+# [S] Merge main into dev
+
+## Goal
+
+`dev` contains `main` at or after
+[#4506](https://github.com/moq-dev/moq/pull/4506) (`c2e7b5815`), so dev has
+the `ts::stats` module the TS stats rename works on.
+
+## Plan
+
+Unlike the other outside conditions, this is work: a PR merging `main` into
+`dev` and resolving its conflicts. As of 2026-09-30 `main` is 130 commits
+ahead of `dev` and `dev` is 119 ahead of `main`.

quest/m1/gpu-ci.md

@@ -51,7 +51,7 @@ Public API: none. Wire: none.
 
 ## Required
 
-- A self-hosted runner is registered for moq-dev/moq on the maintainer's host, with the NVIDIA driver
+- [A self-hosted NVIDIA runner is registered](/quest/m1/gpu-runner.md) - the host the nightly job runs on
 
 ## Related
 

quest/m1/gpu-runner.md

@@ -0,0 +1,18 @@
+# [XS] A self-hosted NVIDIA runner is registered
+
+## Goal
+
+A self-hosted GitHub Actions runner is registered for moq-dev/moq on the
+maintainer's Linux host (RTX 3070 Ti), with the NVIDIA driver installed. This
+is a maintainer action: only someone with admin access to the repository and
+the host can do it.
+
+This quest tracks a condition outside the repository. When it holds, delete
+this quest and every `Required` entry that links it.
+
+## Plan
+
+As of 2026-09-30 `gh api repos/moq-dev/moq/actions/runners` lists none.
+Register it with the dedicated label and hardening that
+[GPU CI](/quest/m1/gpu-ci.md) describes, and share the registration with the
+io_uring runner the drain line plans.

quest/m1/interop-week.md

@@ -0,0 +1,16 @@
+# [XS] A week of nightly interop after #4529
+
+## Goal
+
+Seven nightly interop runs on `main` have completed since
+[#4529](https://github.com/moq-dev/moq/pull/4529) added the player's `delay`
+column to the interop trace.
+
+This quest tracks a condition outside the repository. When it holds, delete
+this quest and every `Required` entry that links it.
+
+## Plan
+
+#4529 merged on 2026-09-29 (`8b6abc0a1`). As of 2026-09-30 one scheduled
+`interop.yml` run on `main` includes it, so the seventh lands around
+2026-10-06. Check with `gh run list --workflow interop.yml --branch main`.

quest/m1/obs-decoded-surface.md

@@ -0,0 +1,14 @@
+# [XS] dev's decoded-frame surface reaches main
+
+## Goal
+
+`main` contains the moq-ffi decoded-frame surface from `dev`
+([#4094](https://github.com/moq-dev/moq/pull/4094), renamed in `97575f002`).
+
+This quest tracks a condition outside the repository. When it holds, delete
+this quest and every `Required` entry that links it.
+
+## Plan
+
+As of 2026-09-30 both are on `dev` only. Check with
+`git merge-base --is-ancestor 97575f002 origin/main`.

quest/m1/obs-moq-video/source.md

@@ -17,7 +17,7 @@ The MoQ source loads and plays supported video without FFmpeg's video libraries
 ## Required
 
 - [OBS migration](/quest/m1/cpp/obs.md) - the plugin is on the generated C++ before decode changes
-- dev's decoded-frame surface (#4094, 97575f002) reaches main
+- [dev's decoded-frame surface reaches main](/quest/m1/obs-decoded-surface.md) - the surface this decodes into
 
 ## Related
 

quest/m1/quic/README.md

@@ -9,9 +9,10 @@ quinn and not noq). One core serves the tokio backend, the thread-per-core
 BBR correctness, reliable stream resets, hierarchical stream scheduling with
 per-broadcast fairness, wider limits for relay peers, and endpoint sharding.
 Per-stream acknowledgment progress, per-stream deadlines, qmux on the shared
-stream state machine, and the experiments (GCC, receive timestamps, the egress
-profile, media probing, L4S, careful resume, deadline keep-alive) live in
-[m2](/quest/m2/README.md) and do not gate this line.
+stream state machine, and the experiments (the egress profile, media probing,
+L4S, careful resume, deadline keep-alive) live in [m2](/quest/m2/README.md);
+GCC with receive timestamps lives in [m3](/quest/m3/README.md). None of them
+gate this line.
 
 ## Plan
 
@@ -78,7 +79,5 @@ consumes them.
 - [L4S on the backbone](/quest/m2/quic-ecn.md) - an ECT(1) option in the fork, an `ecn` config knob, and a dualpi2 measurement
 - [Careful resume on reconnect](/quest/m2/quic-careful-resume.md) - a redial starts at the previous connection's rate
 - [Keep-alive by deadline](/quest/m2/quic-keep-alive.md) - a PING only when the idle deadline nears, no fixed timer
-- [Receive timestamps](/quest/m3/quic-receive-ts.md) - per-packet arrival
-  times for GCC and deadlines
-- [GCC egress experiment](/quest/m3/quic-gcc.md) - a measured verdict on
+- [GCC egress experiment](/quest/m3/quic-gcc.md) - receive timestamps and a measured verdict on
   WebRTC-style delay control

quest/m1/redirect-resolve.md

@@ -24,7 +24,8 @@ needs them. If a consumer turns up, the alternative is returning the same
 current addresses"), so empty and refused stay distinct. Removing or changing a published method is a break, so this
 targets `dev`; update `doc/lib/rs` if it mentions the method.
 
+Start by merging `main` into `dev` if `dev` does not have the drain line yet.
+
 ## Required
 
 - [Graceful relay drains](/quest/m1/drain/README.md) - the stricter `Connection` lands with the line
-- `dev` has merged `main` after the drain line lands

quest/m1/ts-stats-module.md

@@ -42,4 +42,4 @@ Public API: breaking renames in moq-mux. Wire: none.
 
 ## Required
 
-- `main` merged into `dev`, carrying #4506's `ts::stats` module (dev has none yet)
+- [Merge main into dev](/quest/m1/dev-sync.md) - carries #4506's `ts::stats` module

quest/m1/web-transport-moq-release.md

@@ -0,0 +1,16 @@
+# [XS] web-transport-moq 1.3.3 ships noq#24
+
+## Goal
+
+A `web-transport-moq` 1.3.x release on crates.io carries
+[moq-dev/noq#24](https://github.com/moq-dev/noq/pull/24), the close-capsule
+fix.
+
+This quest tracks a condition outside the repository. When it holds, delete
+this quest and every `Required` entry that links it.
+
+## Plan
+
+noq#24 merged into `release/1.3` on 2026-09-29. As of 2026-09-30 crates.io
+still has 1.3.2; the release PR is
+[moq-dev/noq#21](https://github.com/moq-dev/noq/pull/21).

quest/m1/wt-close-upstream.md

@@ -49,7 +49,7 @@ a moq.pro relay that the flood stops.
 
 ## Required
 
-- A `web-transport-moq` 1.3.x release that carries moq-dev/noq#24
+- [web-transport-moq 1.3.3 ships noq#24](/quest/m1/web-transport-moq-release.md) - the release to pin
 
 ## Related
 

quest/m2/one-port/README.md

@@ -78,7 +78,7 @@ pre-accepted streams can stand behind.
 
 - [UDP demux](/quest/m2/one-port/udp-demux.md) - one socket carries QUIC and STUN answers, with greasing off and a WebRTC hook for embedders
 - [TCP acceptor](/quest/m2/one-port/tcp-demux.md) - one listener carries TLS-terminated HTTP, RTMP, and RTMPS
-- [SRT on the shared socket](/quest/m2/one-port/srt-demux.md) - srt-tokio accepts a virtual socket and the flow table pins its 4-tuples
+- [SRT on the shared socket](/quest/m2/one-port/srt-demux.md) - moq-srt drives `srt-protocol` on demuxed packets and the flow table pins its 4-tuples
 
 ## Related
 

quest/m2/one-port/srt-demux.md

@@ -9,12 +9,12 @@ induction handshake.
 ## Plan
 
 `srt-tokio` 0.4 takes a `tokio::net::UdpSocket` in `bind_with_socket` and
-nothing more abstract. Preferred: an upstream PR giving `SrtListener` a
-socket trait (`poll_recv_from` and `poll_send_to`) that a real socket and our
-virtual socket both implement, then `moq_srt::Server` takes the virtual
-socket. Fallback if refused: `srt-protocol` is sans-io, so `moq-srt` drives
-its `Listen` and `Connection` state machines directly on fed packets, which
-is more code but removes the dependency on `srt-tokio`'s socket handling.
+nothing more abstract. Decided 2026-09-30: `srt-protocol` is sans-io, so
+`moq-srt` drives its `Listen` and `Connection` state machines directly on the
+demuxed packets. That is more code, but it removes the dependency on
+`srt-tokio`'s socket handling. An upstream socket trait was rejected:
+upstream (now rosalyntg/srt-rs) has not been pushed since 2024-05, and its
+maintainer said they do not actively support it.
 
 The demux side is the flow table from [UDP demux](/quest/m2/one-port/udp-demux.md):
 a 4-tuple already pinned to WebRTC (ICE succeeded) is never tested for SRT.
@@ -36,4 +36,3 @@ with a QUIC client active on the same port; a QUIC short header from a new
 ## Required
 
 - [UDP demux](/quest/m2/one-port/udp-demux.md)
-- srt-tokio accepts a caller-supplied socket abstraction upstream, or the sans-io fallback is chosen

quest/m2/quic-deadline.md

@@ -21,7 +21,7 @@ Implement in the fork.
 - On loss detection, before queueing a retransmission for a stream with a
   deadline, estimate the arrival instant as now plus the forward one-way
   delay. Start with `min_rtt / 2`, corrected by the peer's reported ACK delay;
-  the [receive-timestamps spike](/quest/m3/quic-receive-ts.md) replaces that
+  the [GCC experiment](/quest/m3/quic-gcc.md)'s receive timestamps replace that
   guess with a measured forward delay. If the estimate is past the deadline,
   reset the stream with a dedicated error code and drop its retransmit ranges,
   including bytes already lost, so flow control is returned in one step.
@@ -52,8 +52,8 @@ Decided in the 2026-09-30 audit: moved to m2. No m1 quest consumes it.
 
 ## Related
 
-- [Receive timestamps](/quest/m3/quic-receive-ts.md) - a measured forward
-  delay replaces the half-RTT estimate
+- [QUIC GCC](/quest/m3/quic-gcc.md) - its receive timestamps give a measured
+  forward delay that replaces the half-RTT estimate
 - [Discover media headroom](/quest/m2/quic-probe.md) - can reuse
   retransmission machinery if redundant capacity probes prove worthwhile
 - [noq#813](https://github.com/n0-computer/noq/issues/813) - the per-stream deadline proposal to n0

quest/m3/3201-moq-uring-use-sendmsg-zc-for-large-udp-gso-trains.md

@@ -41,7 +41,7 @@ ships in no package.
 
 ## Required
 
-- A physical-NIC remote peer to measure zero-copy sends against
+- [A physical-NIC peer for the zero-copy sweep](/quest/m3/zero-copy-peer.md) - loopback only measures the forced copy
 
 ## Closes