Kept rows → content → files → fingerprint; reuses an existing snapshot with the same content hash, else writes files
and row. Only the assembled rows the carver gave a role are in the snapshot: a row it left out (a date carve's row
on or after holdoutEnd) is in no file and no count of the row; the unit read's counts are unchanged.
ProtectedBuildThe snapshot content: header, matrix rows (+ incumbent/slice cells), manifest in matrix order, provenance.
ProtectedFingerprintThe content hash and the feature schema it covers. The provenance file is not an input (it records when each value was computed, so identical data would otherwise hash differently on every assembly); its own hash is stored on the row and verified when the files are read back.
ProtectedSaveThe MJ: ML Training Snapshots row with every count the gates read, or the failed Save's CompleteMessage.
ProtectedSnapshotThe snapshot another build saved with the same content hash while this one was writing. A failed save is resolved by re-reading rather than by reading the error text: when a snapshot with this hash now exists, the unique content hash is what refused this row, and that snapshot is the one identical content resolves to. When none exists, the save failed for another reason and that reason is thrown.
ProtectedWriteThe three write-once files, uploaded in parallel (independent objects) under the content-hash prefix. The keys are deterministic and the stores accept identical bytes under an existing key, so a build that failed after writing, or lost the content-hash race, leaves the same objects a later build of the same content reuses.
The provenance file is outside the content hash (it records when each value was computed), so identical content
can carry different provenance bytes; its object is keyed by its own SHA-256 so each version gets its own object.
A build that loses the content-hash race can therefore leave one provenance object no snapshot references (the
row references the winner's). Readers reach every file through the row's file IDs and the MJ: Files row's
stored key, never by rebuilding a key.
StaticKeptThe build input over the rows the carver kept: the assembled rows that have a role, in their assembled order. The matrix, manifest, provenance, slice and incumbent cells and the class balance all read the kept rows only.
StaticManifestThe series a manifest row belongs to. A forecast unit of kind grain has one row per period of a single series, so
every row carries one series key: the unit's grain entity name (the unit's single series). Every other unit keeps
the row's entity key (the grain record for a grain unit, the grain foreign key for a grain-x-periods unit), so
a grain-x-periods forecast keeps one series per grain record, which the protocol rules refuse at bind time.
StaticSliceWhether a protocol's slice field can be written: it names an assembled feature column, or a field every given unit row carries. Training checks it before the as-of assembly (over every unit row) and the builder again when it writes the column (over the assembled rows), with this one rule.
Builds Training Snapshots; stateless, construct once and reuse.