mnote/rust/bridge

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。