https://sow.pgsty.com/tags/migration/ Recent content in migration on SOW Hugo en Fri, 28 Aug 2026 18:32:04 +0800 https://sow.pgsty.com/blog/release/sow-v0.4.0/ Mon, 24 Aug 2026 00:00:00 +0000 https://sow.pgsty.com/blog/release/sow-v0.4.0/ <p>SOW 0.4.0 is an integrity and recovery release for Managed repositories. It makes the deep checker&rsquo;s I/O contract explicit, prevents RPM trust from being assembled across unrelated keys, adds an audited way to correct mutable publication-target settings, and closes the remaining v0.3 migration and interrupted-publication gaps.</p> <p>Plain repository behavior and the public <code>pool/ + dists/</code> layout do not change.</p> <h2 id="upgrade-from-03">Upgrade from 0.3 </h2> <div class="td-callout td-callout--important" role="note"> <div class="td-callout__title"><i class="td-callout__icon fa-solid fa-circle-exclamation" aria-hidden="true"></i><span class="td-callout__label">Migrate every v0.3 Repository explicitly</span></div> <div class="td-callout__body"> <p>Stop all Workspace writers, back up the Workspace, install 0.4.0, and run <code>sow repo migrate REPOSITORY</code> once for each Repository before ordinary reads or writes. The migration is explicit and one-way; do not reopen a migrated database with SOW 0.3.</p> https://sow.pgsty.com/blog/design/evolution/ Mon, 10 Aug 2026 00:00:00 +0000 https://sow.pgsty.com/blog/design/evolution/ <p>This record dates to the 2026-08-10 consolidation of SOW around its Repository core. It distills the useful decisions from the earlier planning, ADR, review, migration, and verification trees without turning every intermediate artifact into maintained product documentation.</p> <p>Some sealed folders use “v0.2” and “v0.3” for consecutive pre-release design lines. The version labels below refer only to released Git tags: the C2 hardlink line was replaced before v0.2.0 was tagged.</p> <h2 id="the-short-history">The short history </h2> <div class="td-table-scroll td-table-scroll--static"> <table> <thead> <tr> <th scope="col">Line</th> <th scope="col">Design center</th> <th scope="col">Historical status</th> </tr> </thead> <tbody> <tr> <td>v0.1</td> <td>Git/CAS ownership, route-aware materialization, edge authorization, provider workflows, and Pigsty migration</td> <td>Released as v0.1.0; superseded</td> </tr> <tr> <td>v0.2</td> <td>Local Plain/Managed engine, Repository-scoped single-payload tree, metadata-only views, retained Generations, and target-scoped publication</td> <td>Released as v0.2.0; public layout remains current</td> </tr> <tr> <td>v0.3</td> <td>V1 removal, package-facts caching, one-pass Plain builds, and bounded payload commits</td> <td>Released as v0.3.0; same public layout</td> </tr> <tr> <td>v0.4</td> <td>Single-pass verification, independent RPM trust rings, explicit target rebind, and migration/recovery hardening</td> <td>Current released baseline when this record was updated</td> </tr> </tbody> </table> </div> <p>The exact code and claims for each released line remain available in the <a href="https://github.com/pgsty/sow/tree/v0.1.0">v0.1.0</a>, <a href="https://github.com/pgsty/sow/tree/v0.2.0">v0.2.0</a>, <a href="https://github.com/pgsty/sow/tree/v0.3.0">v0.3.0</a>, and <a href="https://github.com/pgsty/sow/tree/v0.4.0">v0.4.0</a> source tags.</p>