可观测与审计

用 status 查看状态，check 校验仓库，changes 查看文件变化，log 读取操作历史。

这些命令不修改仓库内容。

查看状态

sow status -r demo

结果包含期望状态修订号、构建快照、脏 Dist、待构建包的数量与字节数、写锁状态及 ready_to_copy。

status 报告状态，不计算公开文件哈希。dirty 状态运行 build； recovering 或 error 状态按诊断及恢复流程处理。 交付前运行 check。

校验仓库

sow check -r demo

正常检查报告九层：

布局转换未完成时，改为报告 config、state、public-modes、layout-transition。 按 repo migrate 的说明完成或中止迁移。

check 忽略缓存指纹，读取每份唯一物理包并计算哈希，不修复文件。 即使上一构建快照仍一致，脏仓库或恢复中的仓库也不能通过交付检查。

比较构建快照

sow changes -r demo
sow changes 0 -r demo
sow changes 42 -r demo --json

不传基线时与上一构建快照比较；基线 0 列出当前完整目录；基线 42 与已记录构建快照 42 比较。 各行按适用情况包含动作、阶段、仓库相对路径、大小和 SHA-256。

该比较不检查发布目标。用 sow publish TARGET 更新目标并继续中断传输， 用目标 GC 回收远端对象。

保留构建快照与回收无用包

retain add 只接受当前构建快照。若 status 显示构建快照为 42，应在后续构建替换它之前保留：

sow retain add 42 -r demo
sow retain ls -r demo

命令校验该构建快照，保存元数据与引用；包文件仍由共享包池保存。 不再需要构建快照 42 时，用 sow retain rm 42 -r demo 移除保留记录， 再用 sow gc -r demo 回收无用字节。若 retain rm 或 gc 中途中断，重新执行同一命令即可继续完成已记录的计划。本地 gc 要求仓库为 clean；有待构建变更时先构建。 期望成员、已构建成员、为旧客户端保留的成员记录，以及保留构建快照、恢复或发布状态 仍需使用的包都会保留。完整规则见 gc。

普通构建保留的前一代元数据与显式保留功能相互独立。 目标清理使用 sow gc TARGET：filesystem 目标在缓存宽限期后支持条件删除， R2 目标只报告候选，不执行删除。

查看与导出日志

sow log -r demo
sow log OPERATION -r demo
sow log export operations.jsonl -r demo
sow log prune 2026-01-01 -r demo

日志记录操作状态、时间、包处理结果，以及适用的成员与文件变化。 操作详情还可能包含构建进度事件。

log export 将 JSON Lines 写入新文件或 stdout。log prune 接受日期或 RFC 3339 时间戳， 删除符合条件的终态审计记录。恢复所需记录和构建快照清单会保留。

脚本接口见 JSON 输出，中断处理见 事务与恢复。