Graft

SQLite 应用状态的版本管理。

Graft 为 SQLite 应用背后的状态增加 Git-like 历史。它把 SQLite 数据库和应用拥有的文件放进同一个仓库提交里，让一次 commit 表示应用可以打开的一个完整状态。

Git 可以保存 .sqlite 文件，但通常只能把它当作 opaque bytes。Graft 让 SQLite 数据库成为一等版本对象：可以 stage、commit、查看 row diff、合并兼容变化、解决结构化冲突，并恢复为数据库状态。

典型应用数据目录：

app-data/
  data.sqlite
  search.sqlite
  settings.json
  attachments/
    note-42.png
    contract.pdf

SQLite 继续负责读写、索引和事务。Graft 负责围绕这些状态建立历史：stage、 commit、branch、switch、row diff、restore、merge 和 remote sync。

从这里开始

Graft 是什么先理解它解决的问题和边界。

CLI 快速开始初始化仓库、提交数据、查看行级 diff、恢复状态。

SQLite 扩展把可选 Graft VFS 用作 SQLite 的 live page-storage 数据面。

应用状态演练把数据库、文件、分支、diff 和远端串起来。

跟踪数据库和文件理解 path kind、storage 和 staging。

用 JSON 构建应用 UI 用结构化输出做状态、diff、冲突和 payload 面板。

远端同步 push、fetch、pull、clone 和远端选择。

合并冲突使用行级自动合并和结构化冲突信息。