docs: describe resident component architecture

Document the Host-owned event/effect flow, revision-scoped resource supervision, endpoint policy, versioned resident WIT dependency, and the resident-probe packaging command.
2026-07-30 07:40:11 +08:00
parent 572fed47b4
commit a5718da1da
2 changed files with 32 additions and 0 deletions
@@ -156,6 +156,7 @@ url = "http://127.0.0.1:8080"
 [dependencies]
 "wasmeld:service" = "0.1.0"
 "wasmeld:kv" = "0.1.0"
+"wasmeld:resident" = "0.1.0"

 [replace."wasmeld:service"]
 path = "../../wit/service"
@@ -164,6 +165,11 @@ path = "../../wit/service"
 依赖解析结果写入 `wit.lock`，源码开发时应提交该文件。解析出的 `wit/deps/` 是生成目录，
 不应提交。

+普通请求型 Component 只需要 `wasmeld:service`。需要接收 Host 定时器、网络流、UDP、
+消息订阅或扩展 source 事件时，再依赖并导出 `wasmeld:resident/actor@0.1.0`；例如
+`components/resident-probe`。`resident` 是独立版本化 package，不会把所有 Host 能力
+合并到基础 service world。
+
 同步依赖：

 ```bash