设计

SOW 背后的架构决策：所有权、仓库布局、发布、兼容性与版本演进。

本节记录那些即使实现重写也应当保留的设计思路：SOW 在哪里划分所有权边界，哪些不变式保证仓库可以安全复制与发布，以及为什么某项兼容性取舍被接受或拒绝。

当前版本

本站持续维护的用户、参考与设计文档全部描述 SOW v0.2.0。单包体布局、发布目标、保留与垃圾回收、显式迁移以及 RPM 兼容导出都属于这一版本线。sow.cli/v1 这类 wire 标识与 sow/v3 配置 schema 独立演进，不是产品版本号。

权威与证据

这里的页面是持续维护的设计权威。历史 PRD、评审对话、ADR 与日期化验收报告可从 Git 历史和版本标签中查阅；它们仍能证明当时 revision 与环境里的事实，但不能悄悄重定义当前产品。

一项结论要依次经过不同证据层：

设计契约 -> 源码实现 -> 聚焦测试 -> 真实客户端/供应商证据 -> 发布

前一层通过，不代表后一层自动通过。兼容性设计与各版本发布说明都会明确写出最高验证层级。

SOW 用来约束所有权、派生状态、发布与证据的一组不变式。

连接软件包、Dist、Generation 与发布目标的对象模型和状态迁移。

v0.2.0 如何让每个 Repository 只有一条正典包体路径，并渲染纯元数据 APT/RPM 视图。

发布、恢复、保留与安全删除仓库对象的 target-scoped 状态机。

SOW 如何分别验证协议正确性、客户端行为、镜像工具、搬迁、HTTP 规范化与存储供应商语义。

从 v0.1.0 仓库实验、未正式发布的 C2 原型，到当前 v0.2.0 单包体架构的演进路径。