研究 rivet-dev/agent-os 虚拟文件系统方案，输出 rara 实现提案

[crrowbot]

背景

rivet-dev/agent-os 是一个用 WebAssembly + V8 isolates 构建的进程内 AI agent 操作系统。其虚拟文件系统采用三层 overlay 模型设计：

• Base filesystem：Alpine-like root snapshot，只读共享
• Writable overlay：per-VM 的写时复制层（COW）
• Mounted filesystems：可挂载 S3/GDrive/SQLite/host directory

核心机制：读穿透到 base，写先 copy 到 overlay，删除在 overlay 标记隐藏，新文件只在 overlay 创建。

目标

研究 agent-os 的虚拟文件系统方案，输出 rara 实现提案，包括：

1. 技术方案选型：overlay FS / copy-on-write snapshot / 其他
2. API 设计：如何给 agent 提供 /data 这样的虚拟挂载点
3. 与现有 ralph task agent 的整合点
4. 实现优先级和里程碑

参考资料

• rivet-dev/agent-os
• docs: docs/filesystem.mdx
• Rust kernel crates: crates/kernel/

输出

在 rara 的 GitHub 仓库创建一个 Architecture Decision Record (ADR) 或设计文档