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
5 changes: 5 additions & 0 deletions quest/m2/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -122,6 +122,7 @@ lite-07; bitrate enforcement is not part of this release.
- [Resume as producer replacement](/quest/m2/resume-redesign.md) - route changes replace the writer of one track state, deleting the per-reader resume path in Rust and JS
- [moq-transport requests end through one lease](/quest/m2/ietf-request-lease.md) - every IETF request ends through one polled lease, and the two 18k-line files split by mechanism
- [A moq-transport group head fills its hole in place](/quest/m2/ietf-fill-refill.md) - fills and joining FETCHes write into the tail's group, deleting the `Fill` handoff
- [Track publication is one state](/quest/m2/track-publication-state.md) - one enum replaces the published, staged, and claimed flags on `TrackState`
- [moq-transport hole markers](/quest/m2/ietf-hole-marker.md) - a negotiated extension names a SUBSCRIBE's holes, so our publishers answer multi-group FETCH from caches that know every group
- [Announce interest streams share one route table](/quest/m2/announce-interest-memory.md) - per-stream announce cost follows what is in flight, not every route
- [One relay serve path for every runtime](/quest/m2/relay-serve-path.md) - io_uring serves through the shared `Connection::serve` and config mapping
Expand All @@ -141,6 +142,8 @@ lite-07; bitrate enforcement is not part of this release.
- [Hang contribution references](/quest/m2/contribution-ref.md) - a catalog names a whole contribution broadcast that a player opens only when selected, backing moq.pro's composed rooms
- [Synced data playback](/quest/m2/watch-data-sync.md) - js/watch releases JSON and binary payloads on the media playhead, and a slow data track holds media back
- [Watch decode gate](/quest/m2/watch-decode-gate.md) - video lookahead stays encoded until it is near presentation, like audio
- [One support probe for watch audio and video](/quest/m2/watch-support-probe.md) - one probe helper with video's cache, and audio reports unsupported renditions
- [Shared fullscreen, formatters, and stats cards in @moq/ui](/quest/m2/ui-shared-controls.md) - watch and publish stop keeping copies of their shared controls
- [moqsrc A/V sync](/quest/m2/moqsrc-av-sync.md) - a nightly test measures A/V skew from `moqsrc` through clock-synced sinks
- [MP4 export](/quest/m2/mp4-export.md) - `moq export mp4 --output` records crash-safe fragments, then finishes a regular MP4 with moov at the end
- [Importers fill the VR fields](/quest/m2/mux-vr-fields.md) - MP4, Matroska, and Opus imports set the catalog's projection, stereo, and ambisonic layout
Expand Down Expand Up @@ -230,6 +233,7 @@ lite-07; bitrate enforcement is not part of this release.
- [Dependency and alternatives audit](/quest/m2/audit-deps.md) - dependencies are current, deduplicated, needed, and the best maintained option
- [Dead code and API surface audit](/quest/m2/audit-dead-code.md) - repeat the removal audit before the next major release
- [Typecheck with bun check](/quest/m2/bun-check.md) - workspace packages typecheck through bun once nixpkgs ships bun 1.4.4
- [Declare each check module once in the dispatcher](/quest/m2/dispatch-modules.md) - one registration call per module replaces its parallel tables
- [Upgrade Biome to 2.6](/quest/m2/biome-2-6.md) - the workspace runs Biome 2.6.4+ with its new formatters off and no file reformatted
- [Format YAML with Biome](/quest/m2/biome-yaml.md) - `just check` fails on unformatted YAML
- [Format Markdown with Biome](/quest/m2/biome-markdown.md) - Biome formats every Markdown file and remark is gone, landed in a quiet window
Expand All @@ -242,6 +246,7 @@ lite-07; bitrate enforcement is not part of this release.
- [Performance audit](/quest/m2/audit-perf.md) - benchmarks that regressed since the m1 run are explained, fixed, or planned, and unbenched hot paths get coverage
- [Simplification audit](/quest/m2/audit-simplify.md) - repeat the simplification audit, starting with the m1 leftovers, after the release ships
- [Upstream unknown-env option in usage-rs](/quest/m2/usage-unknown-env.md) - jdx/usage refuses unknown prefixed env vars, replacing the moq-tokio helper
- [Upstream single-declaration settings in usage-rs](/quest/m2/usage-settings-once.md) - waiting on approval to post, then jdx/usage builds the registry from Cli fields
- [Artifact size audit](/quest/m2/audit-size.md) - repeat the shipping, native, WASM and browser attribution after the release ships
- [Compile time audit](/quest/m2/audit-compile-time.md) - build-time hotspots are measured against the m1 baselines, starting with the transport share now that moq-net compiles once, and the worst are fixed or planned
- [Lint override and deprecation audit](/quest/m2/audit-lints.md) - repeat the suppression and deprecation audit after the release ships, starting with clippy on the macOS and Windows targets
Expand Down
26 changes: 26 additions & 0 deletions quest/m2/dispatch-modules.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,26 @@
# [M] Declare each check module once in the dispatcher

## Goal

`sh/dispatch.sh` declares each module in one `module` registration call
(scope pattern, tools, whether it compiles Rust, lane, runs alone) that fills
the tables it reads today, instead of listing the module separately in
`scope`, `tools`, `compiles`, `lane`, `alone`, and the lane order. Selection
and scheduling are unchanged. No public API or wire impact.

## Plan

Decided 2026-10-27 (maintainer interview, from the 2026-10-27 refactor audit):
stay in bash with a registration function; porting the dispatcher to Python
was declined.

- Keep each table's comment with the module it explains.
- Preserve the Bun lane (concurrent `bun install` breaks), the shared C++
build lane, and Dart running alone.
- Prove equivalence with the existing `sh/dispatch-query.test.py` and
`sh/changed.test.py`, plus a before/after diff of `just ci-select` output for
a few representative diffs.

## Related

- [The relay's NixOS module is tested](/quest/m2/nix-relay-module.md) - also edits the dispatcher's module map
28 changes: 28 additions & 0 deletions quest/m2/track-publication-state.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,28 @@
# [S] Track publication is one state

## Goal

`TrackState`'s `published`, `staged`, and `claimed` booleans
(`rs/moq-net/src/model/track.rs`) become one private enum, so a combination
the lifecycle never reaches, such as staged but unpublished, cannot be
represented. Each transition is one method that sets the whole state. No API
or wire impact.

## Plan

Decided 2026-10-27 (maintainer interview, from the 2026-10-27 refactor audit):
narrow to publication only. A broader split of `TrackState` by invariant was
declined; `info` stays separate because a reverse fetch installs it before
acceptance, and the `arrival` and `evict` indexes stay distinct.

- Today's transitions: `Request::claim` sets `claimed`; `Request::stage` sets
`published` (through `accept`) and `staged`; `Staged::commit` clears
`staged`. So the states are pending, claimed, staged, and published, and a
claimed request can still be staged and published.
- Readers: `poll_info` hides `info` while staged, and the reject check treats
anything but pending as answered.
- Waits for front eviction, which is rewriting the same file.

## Required

- [Front eviction](/quest/m1/unbounded-groups/front-eviction.md) - lands its `track.rs` rewrite first
27 changes: 27 additions & 0 deletions quest/m2/ui-shared-controls.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,27 @@
# [M] Shared fullscreen, formatters, and stats cards in @moq/ui

## Goal

`@moq/watch` and `@moq/publish` import their fullscreen controller,
fullscreen button, human-readable formatters, and stats card and row builders
from `@moq/ui` instead of each keeping a copy. Each panel keeps its own
metrics and subscriptions. Additive exports only; no wire impact.

## Plan

Decided 2026-10-27 (maintainer interview, from the 2026-10-27 refactor audit):
include the stats primitives, not just fullscreen and formatters.

- The two `ui/fullscreen.ts` copies differ only in comments and where
`enterPseudo`/`exitPseudo` are declared. The two `components/fullscreen-button.ts`
and `ui/format.ts` copies are near-identical; watch's `format.ts` adds
`formatMillis`.
- `card` and `line` in `js/watch/src/ui/stats.ts` and
`js/publish/src/ui/components/stats-tab.ts` are byte-identical. Move those
and the matching stats styles; leave `rate`, `track`, `trackActive`, and the
metric wiring in each package.
- The shared controller exposes its state as a signal instead of today's
`subscribe` listener set, per the repo's no-callback rule.
- Verify in a browser: real fullscreen, the iPhone pseudo-fullscreen class,
a rejected request (not a user gesture), and teardown removing the document
listeners.
28 changes: 28 additions & 0 deletions quest/m2/usage-settings-once.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,28 @@
# [S] Upstream single-declaration settings in usage-rs

## Goal

usage-rs ([jdx/usage](https://github.com/jdx/usage)) builds the settings
registry from `#[derive(Cli)]` fields that carry `setting = "key"`, so
`rs/moq-tokio/src/settings.rs` and `rs/moq-relay/src/settings.rs` (626 lines
declaring every merged flag a second time) are deleted after a bump. Source
presence, precedence, deprecated-name rejection, and provenance keep working.
CLI behavior and wire are unchanged.

## Plan

Waits on two outside conditions, in order:

1. The maintainer approves posting the proposal on jdx/usage. Decided
2026-10-27 (maintainer interview): ask before posting; no approval yet.
2. Upstream ships it. Check the issue and usage-rs releases.

Today `usage::Cli` and `usage::Config` reject each other's attributes, and
`Registry::drift` tests the two declarations agree. The Cli side already names
`env` and `setting` per field; the registry side adds the type and `parse`.
Propose inferring those from the field so one declaration serves both. If
upstream declines, delete this quest and keep the drift test.

## Related

- [Upstream unknown-env option in usage-rs](/quest/m2/usage-unknown-env.md) - another jdx/usage ask; file both together if both are approved
26 changes: 26 additions & 0 deletions quest/m2/watch-support-probe.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,26 @@
# [S] One support probe for watch audio and video

## Goal

The watch audio and video `Source`s probe rendition support through one
private helper that owns the race against an unsettled probe, the config-keyed
cache, `pending`, and abort. Audio gains video's cache and an `out.error` that
is `NotSupportedError` when no audio rendition is supported, and the bundled
UI's unsupported indicator reports an audio-only broadcast it cannot play.
Rendition selection stays separate per kind. Additive `@moq/watch` API; no
wire impact.

## Plan

Decided 2026-10-27 (maintainer interview, from the 2026-10-27 refactor audit):

- Audio exposes `out.error` like video, and the unsupported indicator is its
consumer: it fires when video is unsupported, or when the catalog has no
video and audio is unsupported.
- Video's `#runSupported` (`js/watch/src/video/source.ts`) caches per
rendition by `supportCacheKey` or the JSON config and sets the error; audio's
(`js/watch/src/audio/source.ts`) re-probes every run and only logs. The
helper takes video's behavior for both.
- Test a catalog replaced while a probe is pending, a probe that never
settles, a rejecting probe, and a catalog change that leaves configs
unchanged (served from cache).
Loading