factory-migrate

Documentation

Overview

factory-migrate re-emits the committed RFC-201 factory corpus from its seeds into the grouped `.yamsql` family-file format (RFC-201 §5.7).

Migration is BY RE-EMISSION, not by transliteration: every committed scenario is regenerated from its recorded (generator, seed, query, projection, date) recipe, executed against a real FDB through the same oracle pipeline that blessed it, and written through the new family writer. The old files' frozen rows are then compared VALUE-BY-VALUE against the re-emitted ones; any mismatch is a bug to root-cause, never to accept — same seed plus same oracle output must mean the same rows.

bazelisk run //cmd/factory-migrate -- \
  -old pkg/relational/conformance/factorycorpus/testdata \
  -out pkg/relational/conformance/factorycorpus/testdata.new \
  -census pkg/relational/conformance/factorycorpus/census_baseline.json

Exit codes: 0 = every scenario re-emitted and verified; 1 = a verification mismatch (details on stderr); 2 = infra failure.