flybrain/docs/design
acamilo c3bda90b82 test(flybus): prove the two section 9 rows a review found cited but unproven
An independent review of 4f44894 accepted the audit with two required evidence
changes, neither of which needed a code change.

"Classification is not a topic-name heuristic" cited a lane-order test that
never varies a topic name. The row is now conforms-by-construction, naming the
four scheduler functions that read only the queue an item sits in, and
a_topic_named_like_a_notice_is_still_classified_as_topic_data publishes on
topics called call.failed, route.removed and subscription.closed and asserts
each arrives as a topic.message delivery with its payload intact.

"A latest subscriber never causes BACKPRESSURE" cited a bounded-mode test and
the ignored measurement. a_latest_subscriber_never_refuses_a_publication floods
one unconsumed latest slot with 100 publications of 60 KB, six times the
per-client bounded byte pool, and asserts none is refused, 98 coalesce, the
queue stays at one and the credit never comes back. That row also underwrites
the byte-budget deviation and the first contradiction.

Both tests run over both transports.

The coordinator resolved both contradictions in the spec rather than the code,
so bus-v1 carries them as dated amendments with one line of reason each: the
section 9 table row becomes "Per-client ordinary bounded queued envelope bytes"
with a new "Latest subscription slots | subscriptions x 64 KiB" row, and the
section 2 sketch drops the budget argument and shows the deadline at the caller.
With the amended wording the byte-budget row conforms, so the report's counts
are 178 / 9 / 1 fixed / 7, and the crate README's differences 4 and 8 say they
no longer differ.
2026-09-22 12:39:07 +00:00
..
session-framework test(flybus): prove the two section 9 rows a review found cited but unproven 2026-09-22 12:39:07 +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 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