sow changes

sow changes 比较 Built Generation，输出物理的 Repository 相对文件差异。它不显示尚未构建的 Desired 变化，也不是远端事务协议。

语法

sow changes [BASE_GENERATION] [-C|--workdir DIR] [-r|--repo NAME] [--json]

该命令作用于整个 Repository，明确拒绝 -d/--dist。

输出

sow changes
base=4 generation=5 dirty=false
add	payload	pool/c/centos-release/centos-release-6-0.el6.centos.5.x86_64.rpm	19776	ffd9e7bd...
add	metadata	dists/el9/x86_64/repodata/5bc463cb...-primary.xml.gz	1460	5bc463cb...
update	pointer	dists/el9/x86_64/repodata/repomd.xml	1514	05d3d5bf...
delete	delete	dists/el9/x86_64/repodata/0df96f0b...-primary.xml.gz	0	

各列依次为操作、阶段、Repository 相对路径、大小、SHA-256。

阶段描述 SOW 如何构建本地 Generation。不要把单行直接重放到线上目录；应使用 sow publish，或先暂存完整副本再原子切换。

Base Generation

不带参数时，SOW 比较当前 Built Generation 与它的前一代。

BASE_GENERATION 是 0..当前代 范围内的十进制整数。Base 0 输出当前 Generation 的完整 交付清单，但不包含私有 sow.yml 与 .sow/。Base 等于当前代时输出空计划；从未构建的 Repository 同样输出空的 0 -> 0 计划。

sow changes 99
operation rejected: managed: operation rejected: base generation 99 is outside 0..2

dirty 与恢复状态

Desired 为 dirty 时，首行显示 dirty=true，但计划仍以当前 Built Generation 结束。私有 pending 包体尚不可交付，不会出现在结果中。

Repository 为 recovering 或 error 时，changes 拒绝输出计划，避免把待定文件动作误认为已完成 Generation。

示例

输出当前完整清单：

sow changes 0 -r pgsql --json > pgsql-current.json

生成 Repository 级计划后按路径筛选一个 Dist：

sow changes -r pgsql --json |
  jq '.result.changes[] | select(.path | startswith("dists/el9/"))'

退出码

参见

• sow build —— 创建下一代 Generation
• sow publish —— 使用受支持的发布协议
• sow log —— 语义 Operation 及其文件动作
• 仓库布局 —— 公开/私有路径边界