docs(dma): record the upstream references behind the shared-memory direction - #256
Merged
Conversation
…rection FIND-DMA-SHM-CANONICAL-001 recorded the design reference (cpetig/wasm-shm-test) but not the question it answers, so the artifact could not say WHY the direction matters to us. Added: Luke Wagner, "Does the Component Model Require Extra Copying?" https://youtu.be/YZG7waS2XZg That question is not academic on an 8 KB part -- a copy at the seam is a copy we cannot afford. It is why own<dma-buffer> is specified as a TRANSFER, attach/detach carrying it, rather than a hand-off plus memcpy. Our contribution is an answer that is verified rather than argued: the Kani-proven ownership FSM, on silicon, in 220 B. Also recorded for timing: the Component Model 1.0 roadmap (Eric Gregory, 2026-06-08) places shared-everything threads AFTER 1.0 -- "these advancements also pave the road for shared-everything threads later". The general mechanism is future work while our specific verified instance exists now, which is the window in which contributing it is worth anything. Both references were checked against their sources rather than recalled: the roadmap article is by Eric Gregory and contains no substantive shared-memory content beyond that forward reference, and the talk title and speaker were read from the video page. rivet validate: PASS, 333 warnings, unchanged. Co-Authored-By: Claude Opus 5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_011QG86sovTbfnPNY9SfhSmo
Codecov Report✅ All modified and coverable lines are covered by tests. 📢 Thoughts on this report? Let us know! |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
FIND-DMA-SHM-CANONICAL-001recorded the design reference (cpetig/wasm-shm-test) but not the question it answers — so the artifact could not say why the direction matters to us.Added
Luke Wagner — "Does the Component Model Require Extra Copying?" (https://youtu.be/YZG7waS2XZg)
That question is not academic on an 8 KB part: a copy at the seam is a copy we cannot afford. It is precisely why
own<dma-buffer>is specified as a transfer — attach/detach carry it — rather than a hand-off plusmemcpy. Our contribution to it is an answer that is verified rather than argued: the Kani-proven ownership FSM, on silicon, in 220 B.Timing. The Component Model 1.0 roadmap (Eric Gregory, 2026-06-08) places shared-everything threads after 1.0 — "these advancements also pave the road for shared-everything threads later." The general mechanism is future work; our specific verified instance exists now. That gap is the window in which contributing it is worth something.
Verification
Both references were checked against their sources rather than recalled:
rivet validate: PASS, 333 warnings, unchanged.Related
The same two references now appear as the outlook on slide 12 of the Wasm Research Day deck (
pulseengine.eu, branchtalk/wasm-research-day-2026), which is where the question gets asked in front of the people who can answer it.