flybrain/docs/design
acamilo 24ba933500 docs: PROF-02a and RT-01a, the legacy Game Boy composition on the session framework
The operator decided on 2026-09-23 to port the live fly onto the session framework in full.
New contract legacy-gameboy-v1: the profile gameboy-legacy-fafb-v783-v1, the proof that the
legacy f64 frame clock equals the rational one, the step-by-step placement of step_frame in
lockstep-v1, the readout context (location allowed and declared), the channels decision, the
memory-image inspection and ROM AssetRef, the environment (one no-button setup frame, u8->f32
audio, DC blocker at the edge, gameboy-slots-v1), the pokered-macros-v1 executor as one object
with its task, the legacy-ratchet-rollback-v1 policy, the composition digest carrying decoder
and macro-channel configuration, legacy-transient-reset restore semantics, sugar admission with
a one-commit lag, and FLYSIM01 as format of record until RETIRE-01. PROF-02b is a stub.

Dated amendments, each citing the decision, where earlier text kept the legacy loop outside
lockstep or had no place for it: workers-v1 (telemetry, Initialize, executor, episode request
kind, admission, new section 7 extension methods), step-v1 (rollback edge, Phase B/C, clock,
episode policy, sugar lag), state-media-v1 (audio, memory-image retention, restore semantics,
format of record, section 7 ratchet), README section 4, implementation.md (AGENT-01 and ENV-01
unblocked), the MaleCNS backlog (FOUNDATION-02 split, RUNTIME-01 contract) and analysis (5.2,
5.4), and readout.md (where the location comes from).
2026-09-23 08:32:05 +00:00
..
session-framework docs: PROF-02a and RT-01a, the legacy Game Boy composition on the session framework 2026-09-23 08:32:05 +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 rewards: a catch reward, adapter v6 with a v5 migration, and a rung restart 2026-09-22 17:30:00 +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: macros.md 12.20, macros-wram.md section 11, the row 56 audit 2026-09-23 01:17:33 +00:00
macros.md docs: macros.md 12.20, macros-wram.md section 11, the row 56 audit 2026-09-23 01:17:33 +00:00
malecns-modular-implementation.md docs: PROF-02a and RT-01a, the legacy Game Boy composition on the session framework 2026-09-23 08:32:05 +00:00
malecns-modular-sessions.md docs: PROF-02a and RT-01a, the legacy Game Boy composition on the session framework 2026-09-23 08:32:05 +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