flybrain/docs/design
acamilo 57de8126d5 fix(session-types): check the rational addition, and hold the schema set to the readers list
Two fixes from the independent review of f043cd7.

RationalNs::checked_add cross-multiplied into u128 and then added without a check. Each
product fits, but their sum does not: two reduced fractions near the U64 maximum add to about
2^129, which panics in debug and wraps in release, after which the reduction returns a
confidently wrong rational. Every multiplication and the addition now go through a checked
path, as ipc-v1 section 2 requires, with a fixture row and a test that reaches the overflow
rather than the "does not fit U64" reduction limit.

The schema-set test checked fourteen hardcoded type names, so a new payload type could have
shipped outside contractDigest. It now iterates the readers own list, all fifty of them.

Also amends ipc-v1 section 5, dated: Worker.Acknowledge carries req-<U64> request ids, not
arbitrary Ids, because the serial watermark rule in that same section cannot reject reuse
after acknowledgment unless the acknowledged id carries its serial.
2026-09-22 13:12:59 +00:00
..
session-framework fix(session-types): check the rational addition, and hold the schema set to the readers list 2026-09-22 13:12:59 +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