Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
12 changes: 11 additions & 1 deletion quest/m1/poll-first/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -43,6 +43,17 @@ and their alternatives:
coloring only because its evented backend parks whole stacks. kio's `&Waiter`
parameter is the stackless half of that idea. Sans-IO is the other: the protocol
never does I/O and each runtime drives it.
- **Sans-IO compared** in [moq-dev/moq#7058](https://github.com/moq-dev/moq/pull/7058),
on the lite subscriber's upstream SUBSCRIBE (an unmerged prototype, since deleted).
moq-net already takes I/O through its transport traits and runs on any executor,
so sans-IO only buys a core without waiters. That core translated through rust2-ts
with 4 refusals, but the serve loop driving it still had 919, so translating a
session still waits on the model. Rules became plain `#[test]`s, while
interleaving bugs stay in driver tests. Compile cost and the benches were flat.
The cost is an effect enum per model touch (+206 lines on this path).
**Decided (maintainer, 2026-10-28):** moq-net's protocol core stays kio poll and
does not move toward sans-IO. Pull pure wire rules into plain functions where
that turns scripted async tests into plain ones, as ordinary refactors.
- **Gate the wrappers regardless** of the build measurement, because poll-first is
the style moq wants. kixelated/rust2's
[semantic API hash quest](https://github.com/kixelated/rust2/blob/main/quest/m3/api-cutoff.md)
Expand All @@ -65,6 +76,5 @@ and their alternatives:
- [kio::machine](/quest/m1/poll-first/machine.md) - kio's `macros` feature writes straight-line `poll_*` bodies, landing with the hand-written machines it replaces
- [Straight-line bodies become machines](/quest/m1/poll-first/machine-bodies.md) - moq-net's straight-line `async fn` bodies become `#[kio::machine]` polls
- [Generated async wrappers behind a feature](/quest/m1/poll-first/async-feature.md) - each library's `async fn` wrappers are generated from its `poll_*` signatures and compile only with its `async` feature
- [Sans-IO compared](/quest/m1/poll-first/sansio-compare.md) - one moq-net protocol path as a sans-IO core, compared with kio poll
- [Libraries spawn nothing](/quest/m1/poll-first/no-spawn.md) - web-async goes, and moq-ffi, moq-stats, moq-wasm and moq-relay's cluster and auth run as polled `kio::Tasks` children instead of spawned tasks
- [Incremental compilation for moq-net](/quest/m1/poll-first/incremental.md) - a one-line moq-net edit re-checks for less than a clean build
30 changes: 0 additions & 30 deletions quest/m1/poll-first/sansio-compare.md

This file was deleted.

1 change: 0 additions & 1 deletion quest/m1/quic-api/waits.md
Original file line number Diff line number Diff line change
Expand Up @@ -79,4 +79,3 @@ moq-quic's README fork list and describe migration in the PR's Impact section. W
- [Poll forms](/quest/m1/quic-api/poll.md) - the drivers' public poll forms forward to these
- [poll_acked](/quest/m2/quic-ack-hook.md) - its offset wait lives here
- [QUIC lock contention](/quest/m2/perf/quic-lock-contention.md) - profiles the lock these waits are registered under
- [Sans-IO compared](/quest/m1/poll-first/sansio-compare.md) - a core that owns kio waits but no I/O is a third data point
Loading