Skip to content

openregs replay

Re-run the transform over stored snapshots, rewriting only what changed.

Re-read every snapshot one source has captured, push it through the current parse and normalize with no network access at all, and reconcile the result with the canon: units whose Akoma Ntoso output actually changed are rewritten and stamped with the new transform_version, units it re-emits identically are left untouched, and a replay diff report names the difference. SOURCES.lock is never written — a replay learns nothing new about where bytes came from.

openregs replay [-h] --source <source_id> [--offline] [--config <path>]
[--state-dir <path>] [--canon <path>] [--report <path>]
Option
--source <source_id>re-run every capture this source archived (required)
--offlineseal this process against the network for the whole run. A replay never fetches; the seal makes a run that somehow tried die instead of succeeding
--config <path>read this source configuration instead of config/sources.yaml
--state-dir <path>read the snapshot store under here instead of state/
--canon <path>rewrite units in this canon instead of the one belonging to the source’s regime
--report <path>write the replay diff report here instead of <state-dir>/replay/<source>.replay.yaml

Rendered from openregs/openregs@cbe9615:tooling/openregs/cli/main.py