运行 document-sync 示例

验证 Rust Process 与 Bun 实现共享命名依赖和同一个 Contract。

这个完整源码示例把同一个文档从 source Store 读出并写入 destination Store。一个 Bundle 包含 Rust Process 和 TypeScript Bun 两个可替换实现，由 Host 选择其中一个。Agent ToolProvider 调用 document-sync；两个 Store 是测试 Host 内的 Native Provider，并不是另一个需要部署的存储服务。

获取并构建

需要 Git、Bun、Rust 工具链和 npm/npx。下面固定到已验收的示例提交，保留其 Cargo 和 Bun lockfile。首次 Request 交付与后续交互扩展使用不同版本组，不能混用版本表。

git clone https://github.com/LioRael/lenso-examples.git
cd lenso-examples
git checkout c709647
cd fixtures/vnext-plugin-authoring-v2
bun install --cwd typescript --frozen-lockfile
cargo test --locked --workspace
npx --yes @lenso/cli@0.16.1 plugin check --repo-root . --json
npx --yes @lenso/cli@0.16.1 plugin pack --repo-root . --output document-sync.lenso-plugin --json

plugin check 检查两个实现的 Contract 一致，pack 生成 Bundle schema 4 归档。 Rust Process 产物依赖本机目标；以下安装验收使用 macOS ARM64，其他目标须先核实支持。

验证普通 App 安装流程

npx --yes @lenso/cli@0.16.1 app build \
  --source acceptance/host.ts --target aarch64-apple-darwin --out /tmp/document-sync-host
npx --yes @lenso/cli@0.16.1 plugins add document-sync.lenso-plugin --root /tmp/document-sync-host
npx --yes @lenso/cli@0.16.1 app show --root /tmp/document-sync-host --json
npx --yes @lenso/cli@0.16.1 plugins remove example.document-sync --root /tmp/document-sync-host
npx --yes @lenso/cli@0.16.1 app check --root /tmp/document-sync-host

输出目录必须尚不存在。这里验证构建、归档准入、安装、检查和移除；app show 不是执行同步的证明。真实执行由前面的 process_sync 集成测试覆盖，它通过 Agent ToolProvider 的 catalog/execute 调用，观察一次 Store 读取和一次写入，并关闭 App。

运行同一条 Bun 调用链

从生成的 Bundle 中解出 implementations/typescript-bun/plugin.js，将绝对路径传给测试：

unzip -q document-sync.lenso-plugin "implementations/typescript-bun/*" -d /tmp/document-sync-bun
LENSO_DOCUMENT_SYNC_BUN_ARTIFACT=/tmp/document-sync-bun/implementations/typescript-bun/plugin.js \
  cargo test -p lenso-vnext-plugin-authoring-v2 --test process_sync \
  typescript_bun_syncs_through_the_same_named_host_dependencies -- --ignored

这一步仍由 Rust 测试 Host 启动 Bun Plugin，不等同于启动 TypeScript 声明的 Host。测试还覆盖交换 source/destination、两个名字绑定同一个 Store、归档摘要篡改和不支持的 Profile。失败构造、取消后仍在执行、stop 失败及清理边界的证据由各运行时仓库维护，不应声称本示例独自覆盖所有故障。

继续阅读命名依赖选择和TypeScript Host。完整版本与验收映射见 ACCEPTANCE.md。