docs/Proposals.md
WASI APIs are developed as proposals. These proposals go through 5 phases of development (following the WASI Subgroup's Phase Process).
You can learn more about contributing new proposals (and other ways to contribute) in our Contributing guide.
| Proposal | Champion | Versions |
|---|
| Proposal | Champion | Versions |
|---|
| Proposal | Champion | Versions |
|---|---|---|
| I/O | Dan Gohman | |
| Clocks | Dan Gohman, Colin Murphy | |
| Random | Dan Gohman, Roman Volosatovs | |
| Filesystem | Dan Gohman, Victor Adossi | |
| Sockets | Dave Bakker | |
| CLI | Dan Gohman, Lann Martin | |
| HTTP | Piotr Sikora, Jiaxiao Zhou, Dan Chiarlone, David Justice, Luke Wagner |
| Proposal | Champion | Versions |
|---|---|---|
| Clocks: Timezone | Dan Gohman, Colin Murphy | |
| CLI: Exit With Code | Dan Gohman, Lann Martin | |
| HTTP: Informational Outbound Response | Piotr Sikora, Jiaxiao Zhou, Dan Chiarlone, David Justice, Luke Wagner | |
| I2C | Friedrich Vandenberghe, Merlijn Sebrechts, Maximilian Seidler | |
| Key-value Store | Jiaxiao Zhou, Dan Chiarlone, David Justice | |
| Machine Learning (wasi-nn) | Andrew Brown and Mingqiu Sun | |
| Runtime Config | Jiaxiao Zhou, Dan Chiarlone, David Justice | |
| GFX | Mendy Berger, Sean Isom | |
| Messaging | Jiaxiao Zhou, Dan Chiarlone, David Justice, Taylor Thomas |
| Proposal | Champion | Versions |
|---|---|---|
| Blob Store | Jiaxiao Zhou, Dan Chiarlone, David Justice | |
| Crypto | Frank Denis and Daiki Ueno | |
| GPIO | Merlijn Sebrechts, Maximilian Seidler | |
| Distributed Lock Service | Jiaxiao Zhou, Dan Chiarlone, David Justice | |
| Logging | Dan Gohman | |
| Observe | Caleb Schoepp | |
| Parallel | Andrew Brown | |
| Pattern Match | Jianjun Zhu | |
| SPI | Merlijn Sebrechts | |
| SQL | Jiaxiao Zhou, Dan Chiarlone, David Justice | |
| SQL Embed | Robin Brown | |
| Threads | Alexandru Ene, Marcin Kolny, Andrew Brown | |
| TLS | Joel Dice, Dave Bakker, James Sturtevant | |
| URL | Radu Matei | |
| USB | Wouter Hennen, Warre Dujardin, Merlijn Sebrechts | |
| OTel | Caleb Schoepp, Andrew Steurer |
Note: The pre-proposal phase is simply meant as a way to share ideas. This means that there may be overlap between pre-proposals. It also means that the WASI subgroup has not yet decided that the pre-proposal is in scope for WASI.
| Proposal | Champion | Versions |
|---|---|---|
| proxy-wasm/spec (will advance as multiple, smaller proposals) | Piotr Sikora |
Once a proposal reaches Phase 3, we expect the champions to start creating releases, following the conventions of semantic versioning (semver). Releases for active proposals are linked in the chart above.
Proposals remain in the 0.x semver range until they reach Phase 5 and are fully standardized. At that point, a 1.0 release should be made available.
For some APIs, it makes sense to add new features after the API itself has reached Phase 5. These feature additions should go through the same standardization process. Once they have reached Phase 5, the minor version number of the release should be incremented.
Some APIs may require backwards-incompatible changes over time. In these cases, we allow proposals to increment the major version number only if the old API can be implemented in terms of the new API. As part of the new version, champions are expected to provide a tool that enables this backwards-compatibility. If that is not possible, then a new API proposal with a new name should be started. The original API can then be deprecated over time if it makes sense to do so.