zoriya/v10
1
0
Fork 0
mirror of https://github.com/zoriya/v10.git synced 2026-08-16 02:45:09 +00:00
Code Issues Packages Projects Releases Wiki Activity

docs(spf): add live-presentation-modeling design doc

Browse Source 
Companion to presentation-modeling.md for streams that change over
time (live / DVR / event). Spine is a category decomposition that
keeps data separated by change-rate and consumer: content snapshot
(snapshot/merge segment identity via media-sequence + URL/byteRange),
streamType, completeness-as-duration, refetch policy as its own
category, the PROGRAM-DATE-TIME sync anchor, and the derived consumer
surface. Captures the debated decisions and open questions; scopes to
sliding-window live (LL-HLS / DVR / discontinuity / timestampOffset
deferred). Adds the reciprocal companion link in presentation-modeling.md.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
This commit is contained in:
Christian Pillsbury
2026-06-25 09:58:44 -07:00
co-authored by Claude Opus 4.8
parent a74b8c0993
commit 820f6fe45c
2 changed files with 381 additions and 0 deletions
Download Patch File Download Diff File Expand all files Collapse all files
internal/design/spf/presentation-modeling.md
+5
View File
@@ -559,6 +559,11 @@ file format-specific architectural docs as siblings to this one
presentation
- [text-track-architecture.md](./text-track-architecture.md) — peer
architectural doc (text-track-specific deep-dive)
- [live-presentation-modeling.md](./live-presentation-modeling.md) —
companion that extends this model for presentations that *change over
time* (live / DVR / event): the snapshot/merge segment model,
`streamType`, refetch policy as a distinct category, and the PDT sync
anchor. This doc covers the one-shot / VOD snapshot
- [conventions/signals.md](./conventions/signals.md) — pipeline-pattern
multi-writer slot convention (`state.presentation` is the canonical
worked example)