flybrain/docs/design
acamilo f043cd79c0 docs(session-framework): seed derivation v1 and the FLYSESS1 checkpoint envelope
Two specifications CONTRACT-01 owes the slices that cannot be built without them.

seed-derivation-v1: the versioned derivation of independent per-agent seeds from a recorded
master seed and stable agent ids, the exact hashed material, the lane rule that keeps a seed
away from zero (the pinned kernel RNG is an xorshift, whose state must not be zero), the
properties a composition may rely on, and the test vectors both languages reproduce.

checkpoint-envelope-v1: the exact byte layout of the new envelope per state-media-v1 section
4, with the header, canonical-JSON manifest, 112-byte payload table entries, eight-byte
aligned payloads and the digest footer; the manifest field set; what a reader enforces and in
what order; and the durable commit sequence of section 6, whose commit point is the store
manifest rename. FLYSIM01 is unchanged, refused at the magic, and stays separately readable.

Both are specifications with fixtures, not the store: generations, rotation, the capture
queue and the restore flow remain STATE-01.
2026-09-22 12:47:48 +00:00
..
session-framework docs(session-framework): seed derivation v1 and the FLYSESS1 checkpoint envelope 2026-09-22 12:47:48 +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): index the flybus communications bus 2026-09-22 03:47:44 +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 flybrain v0.4.0: public tree (history retained privately) 2026-09-21 15:09:46 +00:00
macros-wram.md docs: macros.md section 15 and the WRAM table behind it 2026-09-22 04:21:54 +00:00
macros.md docs: section 12.11, and rows 44 to 47 of the trap audit 2026-09-22 09:07: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