# Rust Bridge Runtime

当前目录用于承载 Phase 1 的真实 Rust bridge/runtime 说明。

当前最小样板已经落到 workspace crate `rust/crates/bridge-runtime/`，职责是：

- 接收 Web 侧传入的 bridge context 与 command/query envelope
- 在 Rust 内完成协议校验、命令/查询映射与 Convex transport args 生成
- 把执行计划返回给 Next route，由 TS 仅负责 transport 调用 Convex

当前已接管的最小链路：

- `documents.content.get`
- `documents.title.update`
- `documents.save`

当前刻意保留在 TypeScript 的内容：

- Convex HTTP client 调用
- Next route 的认证、HTTP transport 与错误转译
- 现有 bridge log 写回

这样做的目的不是长期保留双层执行，而是先让 Web 真实进入 Rust 执行器，再在后续阶段继续把 transport 之外的剩余业务域收口到 Rust。