dtourolle
1d56517f07
Traceability Validation / Check Requirement Traces (pull_request) Successful in 11s
Rust becomes the single owner of which stream to play — direct play or
transcode, at what ceiling, over what transport — and hands every player
backend a self-describing StreamSelection instead of a bare URL. mpv,
ExoPlayer and the HTML5/hls.js path all consume one decision rather than
three places re-deriving it.
The motivating leak is concrete. VideoPlayer.svelte determines transport with
`currentStreamUrl.includes(".m3u8")`, in two places, for a URL Rust
constructed and therefore already knows the shape of. That is the boundary
rule in miniature: not item-type taxonomy, but the same error of
reconstructing a domain fact in the presentation layer because the wire shape
did not carry it. A tagged Transport enum deletes it.
The design line, which ExoPlayer forces: Rust decides *what stream*, the
player decides *how to deliver it*. ExoPlayer has genuine adaptive track
selection; this spec must not reimplement or fight it. Rust only adapts where
the player cannot (mpv) and the server actually offers a ladder.
Six phases, and phase 1 stands alone as pure ownership movement with no
behaviour change. Phase 4 (direct-play negotiation) is what removes the
transcode and unblocks the Linux native-video work. Phase 5 (adaptation) is
gated on counting EXT-X-STREAM-INF entries in a real playlist — the
acceptance criteria require that count be recorded before it is either
started or dropped.
Takes DR-121 from read-through-media-cache.md, which specced Rust-owned
quality reporting but never built it; that spec keeps its capture half.
60 lines
2.1 KiB
Markdown
60 lines
2.1 KiB
Markdown
# Summary
|
|
|
|
[Introduction](README.md)
|
|
|
|
# Requirements & Traceability
|
|
|
|
- [Requirements Specification](requirements.md)
|
|
- [Traceability Matrix](traceability.md)
|
|
- [Traceability CI](traceability-ci.md)
|
|
- [Traces Quick Reference](traces-quick-ref.md)
|
|
|
|
# Architecture
|
|
|
|
- [Overview](architecture/README.md)
|
|
- [Rust Backend](architecture/01-rust-backend.md)
|
|
- [Svelte Frontend](architecture/02-svelte-frontend.md)
|
|
- [Data Flow](architecture/03-data-flow.md)
|
|
- [Type Sync & Threading](architecture/04-type-sync-and-threading.md)
|
|
- [Platform Backends](architecture/05-platform-backends.md)
|
|
- [Downloads & Offline](architecture/06-downloads-and-offline.md)
|
|
- [Connectivity](architecture/07-connectivity.md)
|
|
- [Database Design](architecture/08-database-design.md)
|
|
- [Security](architecture/09-security.md)
|
|
|
|
# UX
|
|
|
|
- [UX Flows](ux-flows.md)
|
|
|
|
# Specs — Pending Work
|
|
|
|
- [Specs Index](specs/README.md)
|
|
- [Spec Template](specs/SPEC-TEMPLATE.md)
|
|
- [Spec Review Checklist](specs/SPEC-REVIEW-CHECKLIST.md)
|
|
- [Playback Backend Unification](specs/playback-backend-unification.md)
|
|
- [Linux Native Video Spike](specs/linux-native-video-spike.md)
|
|
- [Backend-Owned Stream Selection](specs/backend-owned-stream-selection.md)
|
|
- [Player Facade Enforcement](specs/player-facade-enforcement.md)
|
|
- [Windows Native Audio Backend](specs/windows-native-audio-backend.md)
|
|
- [libmpv2 Migration](specs/libmpv2-migration.md)
|
|
- [Read-Through Media Cache](specs/read-through-media-cache.md)
|
|
- [Scoped Search](specs/scoped-search.md)
|
|
- [Scoped Search Boundary](specs/scoped-search-boundary.md)
|
|
- [Scoped Search Boundary — Implementation](specs/scoped-search-boundary-implementation.md)
|
|
- [Frontend Domain Model](specs/frontend-domain-model.md)
|
|
- [Build Provenance](specs/build-provenance.md)
|
|
|
|
# Build & Release
|
|
|
|
- [Build & Release](build/build-release.md)
|
|
- [Release Checklist](release-checklist.md)
|
|
- [Desktop Packaging](build/build-desktop-packages.md)
|
|
- [Windows Build](build/build-windows.md)
|
|
- [Defect Windows](defect-windows.md)
|
|
- [Docker](build/docker.md)
|
|
- [Builder Image](build/build-builder-image.md)
|
|
|
|
---
|
|
|
|
[Rust API Reference (rustdoc)](api-redirect.md)
|