https://sow.pgsty.com/tags/compatibility/ Recent content in compatibility on SOW Hugo en Fri, 28 Aug 2026 00:00:00 +0000 https://sow.pgsty.com/blog/design/single-payload/ Wed, 05 Aug 2026 00:00:00 +0000 https://sow.pgsty.com/blog/design/single-payload/ <p>This decision was drafted on 2026-08-05 during the pre-v0.2 release design consolidation and shipped in SOW v0.2.0 on 2026-08-08. It remains the layout contract in v0.3 and v0.4. It records an architecture choice, not a blanket compatibility claim: protocol closure, ordinary package clients, mirror tools, static hosting, and object storage are verified as separate evidence layers.</p> <h2 id="decision">Decision </h2> <p>Each SOW Repository owns one public tree:</p> <div class="td-code td-code--untitled" id="td-code-d78f7449-fence-0" data-td-code data-td-code-auto-id data-td-language="text" data-td-line-count="5"> <div class="td-code__viewport" id="td-code-d78f7449-fence-0-viewport" data-td-code-viewport><div class="highlight"><pre tabindex="0" class="chroma"><code class="language-text" data-lang="text"><span class="line"><span class="cl">&lt;repository&gt;/ </span></span><span class="line"><span class="cl"> pool/ # canonical package bytes </span></span><span class="line"><span class="cl"> dists/ </span></span><span class="line"><span class="cl"> &lt;dist&gt;/ </span></span><span class="line"><span class="cl"> &lt;architecture&gt;/ # protocol metadata only</span></span></code></pre></div></div> </div> <p>A Package Object has one canonical payload path inside one Repository. Adding the same object to several Dists or architecture views adds membership and metadata references; it does not create another canonical package file.</p>