flybrain/docs/design
acamilo 079842f818 media: no best-effort defaults in the audio path
Review round two.

A restored timeline refuses a declared stream with no recorded sample
position instead of resuming it at zero, which would have restarted the
episode's audio clock silently.

A declared stream that produces no chunk for a transition now fails the
step. The contract does not say a chunk must exist; this slice requires
one, because a silently missing chunk cannot be told from a lost one.
Boundary 0 is exempt: no interval precedes it.

The fresh-epoch discontinuity refusal is dropped rather than written into
the amendment. Only the restore direction is stated, and sections 6 and 7
both have a fresh timeline publishing a discontinuity after a recovery or
a reset, so refusing the flag at an origin contradicted them. The dated
amendment now says the requirement is one-directional.

A snapshot with an unreadable chunk, or one whose handle is not attached,
is now unreadable as a whole rather than quietly carrying less audio than
was published. ViewPipeline::is_bootstrap_repeat is removed.

New tests: a missing chunk fails the step, restored timelines need every
declared stream's position, and a 7 Hz world's seven chunks sum to exactly
one second of 48 kHz samples. The bus-conformance reconnect row also cites
the test that actually replaces an incarnation.
2026-09-22 15:15:06 +00:00
..
session-framework media: no best-effort defaults in the audio path 2026-09-22 15:15:06 +00:00
animation.md flybrain v0.4.0: public tree (history retained privately) 2026-09-21 15:09:46 +00:00
describe-tab.md stage(describe): the public repo URL on the card 2026-09-22 02:08:31 +00:00
fly-avatar.md flybrain v0.4.0: public tree (history retained privately) 2026-09-21 15:09:46 +00:00
flybus.md docs(design): a bus-v1 conformance report, and the amendments it asks for 2026-09-22 12:07:11 +00:00
flysim.md flybrain v0.4.0: public tree (history retained privately) 2026-09-21 15:09:46 +00:00
gameboy-theme.md flybrain v0.4.0: public tree (history retained privately) 2026-09-21 15:09:46 +00:00
gpu.md flybrain v0.4.0: public tree (history retained privately) 2026-09-21 15:09:46 +00:00
infra.md flybrain v0.4.0: public tree (history retained privately) 2026-09-21 15:09:46 +00:00
ladder.md docs: sections 12.13 to 12.16, and the stall window's second signal 2026-09-22 13:12:31 +00:00
macros-wram.md docs: section 12.12, the nurse's box 2026-09-22 10:39:15 +00:00
macros.md traps: both hunt arms, and row 54 -- the cycle that replaced the one this branch closed 2026-09-22 14:23:00 +00:00
malecns-modular-implementation.md docs(design): session-framework specs (bus-v1, ipc-v1, step-v1, workers-v1, publishing-v1, state-media-v1) and the MaleCNS modular-session plans 2026-09-22 11:01:55 +00:00
malecns-modular-sessions.md docs(design): session-framework specs (bus-v1, ipc-v1, step-v1, workers-v1, publishing-v1, state-media-v1) and the MaleCNS modular-session plans 2026-09-22 11:01:55 +00:00
melee-framework-audit.md docs(design): session-framework specs (bus-v1, ipc-v1, step-v1, workers-v1, publishing-v1, state-media-v1) and the MaleCNS modular-session plans 2026-09-22 11:01:55 +00:00
platformer.md flybrain v0.4.0: public tree (history retained privately) 2026-09-21 15:09:46 +00:00
room-escape.md flybrain v0.4.0: public tree (history retained privately) 2026-09-21 15:09:46 +00:00
stage-bridge.md flybrain v0.4.0: public tree (history retained privately) 2026-09-21 15:09:46 +00:00