Skip to content

decision

5 pages
  • Coordinated Publication Decision

    By Vonng In Design 296 words 2 min

    VonngDesignpublishtransactionobject-storagedecision

    Coordinated Publication Decision

    SOW 0.4.0 kept the native filesystem and r2 publication backends. An earlier proposal used rclone and added remote audit and preview commands. The native design was selected because SOW needs to track each conditional write and its result. Current …

    SOW 0.4.0 kept the native filesystem and r2 publication backends. An earlier proposal used rclone and added remote audit and preview commands. The native design was selected because SOW needs to track each conditional write and its result. Current …

  • SOW Design Evolution: From Route Graphs to the Repository Core

    By Vonng In Design 859 words 5 min

    VonngDesignarchitecturerepositorymigrationdecision

    SOW Design Evolution: From Route Graphs to the Repository Core

    SOW moved from a Git-based distribution control plane in v0.1 to a repository engine in v0.2. This article traces that change and the refinements through v0.5.0. Version numbers below refer to released Git tags. Some archived plans used “v0.2” and …

    SOW moved from a Git-based distribution control plane in v0.1 to a repository engine in v0.2. This article traces that change and the refinements through v0.5.0. Version numbers below refer to released Git tags. Some archived plans used “v0.2” and …

  • Why SOW Uses One Payload Tree per Repository

    By Vonng In Design 686 words 4 min

    VonngDesignrepositorypoolrpmaptcompatibilitydecision

    Why SOW Uses One Payload Tree per Repository

    This decision was drafted on 2026-08-05 and shipped in SOW v0.2.0 on 2026-08-08. SOW 0.5.0 still uses this layout. Each Repository stores one package tree and lets its distribution views reference that tree. Decision Each SOW Repository owns one …

    This decision was drafted on 2026-08-05 and shipped in SOW v0.2.0 on 2026-08-08. SOW 0.5.0 still uses this layout. Each Repository stores one package tree and lets its distribution views reference that tree. Decision Each SOW Repository owns one …

  • The v0.2 Reset: Plain and Managed Instead of a Universal Control Plane

    By Vonng In Design 1188 words 6 min

    VonngDesignhistoryv0.2plainmanagedarchitecturedecision

    The v0.2 Reset: Plain and Managed Instead of a Universal Control Plane

    On 2026-07-31, after sealing the v0.1 source baseline, SOW began a product reset. The goal was a small repository engine that could replace Pigsty’s daily package-build workflow. It kept the earlier lessons about integrity and recovery while removing …

    On 2026-07-31, after sealing the v0.1 source baseline, SOW began a product reset. The goal was a small repository engine that could replace Pigsty’s daily package-build workflow. It kept the earlier lessons about integrity and recovery while removing …

  • SOW v0.1 Decision Ledger: What Survived and What Was Retired

    By Vonng In Design 1389 words 7 min

    VonngDesignhistoryv0.1adrdecisionmigration

    SOW v0.1 Decision Ledger: What Survived and What Was Retired

    The v0.1.0 tag contains 44 architecture decision records (ADRs), numbered 0001 through 0045; 0006 is absent. Each ADR records a problem, the decision made at the time, and the conditions that implementation had to meet. This table shows what happened …

    The v0.1.0 tag contains 44 architecture decision records (ADRs), numbered 0001 through 0045; 0006 is absent. Each ADR records a problem, the decision made at the time, and the conditions that implementation had to meet. This table shows what happened …