mirror of
https://github.com/zoriya/v10.git
synced 2026-08-15 02:14:06 +00:00
Christian PillsburyandClaude Opus 4.8
6d26e083a5
Replace the per-type "Tier 1" / shared-min "Tier 2" split with one default `deriveSharedMinStartMediaTime`: relocate every track by the `min` across the selected A/V origins. Subsumes per-type — aligned origins reduce to each type's own, skewed origins keep every DTS >= 0 while preserving A/V skew, and a single selected type reduces to its own origin. Returns undefined until all selected types are discovered (shared-min barrier). `derivePerTypeStartMediaTime` stays as a barrier-free opt-out. The loader stamp is now tier-agnostic: `stampStartMediaTime` applies the same injected `derive` over `mediaContainerData` (not the raw own-origin), async with an `awaitDefined` holdback and liveness guard. Engines resolve one `deriveStartMediaTime` and feed it to both the reactor and `relocationPipelinesFor(type, derive)` so model and buffer agree. Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
Design Docs
Decisions you own — documented for posterity.
What Belongs Here
Design Docs are decisions you own. Write one when:
- Making architectural decisions in your area
- Choosing between implementation approaches
- Introducing design patterns others will follow
- Documenting internal APIs or component specs
When to Use RFC Instead
Use an RFC (rfc/) when:
- Changes public API surface
- Affects product direction
- Affects user-facing developer experience
- Significant changes to core architecture
- Hard to reverse once shipped
Rule of thumb: If you need someone else's approval, it's an RFC. If you're documenting your own decision, it's a Design Doc.
Format
---
status: decided
date: 2025-01-27
---
# Title
## Decision
What you decided. Be direct.
## Context
Why this came up. What problem triggered the decision.
## Alternatives Considered
- **Option A** — Why not chosen
- **Option B** — Why not chosen
## Rationale
Why this choice wins. Keep concise.
Status Values
| Status | Meaning |
|---|---|
draft |
Thinking through it, not final |
decided |
Decision made, documented |
implemented |
Built and shipped — kept for rationale |
superseded |
Replaced by another design doc |
Archive
archive/ contains design docs for fully implemented features where the "what" is now captured by the code itself. These docs are preserved for reference but are no longer actively maintained. Docs with high "why" value (decisions, rationale, alternatives) stay in the main directory with status: implemented.
File Naming
Use lowercase with hyphens:
queue-design.md
hook-naming.md
skin-theming.md