Reconify Docs

Audit and Deterministic Runs

Add run provenance and stable ordering for audit workflows.

Use --audit to embed run provenance in structured output.

reconify reconcile \
  --config reconify.yaml \
  --pair bank_vs_stripe \
  --format json \
  --audit \
  --out results.audit.json

Audit mode includes:

  • run ID
  • UTC timestamp
  • tool version
  • left and right file paths
  • SHA-256 file hashes
  • pair config snapshot

--audit is supported for json, json-stream, and ndjson.

Deterministic output

Use --deterministic with --format json for stable section ordering:

reconify reconcile \
  --config reconify.yaml \
  --pair bank_vs_stripe \
  --format json \
  --audit \
  --deterministic \
  --audit-fixed-timestamp "2026-01-01T00:00:00Z" \
  --out results.audit.json

Without --audit-fixed-timestamp, audit timestamps and run IDs still vary between runs.

NDJSON audit behavior

For NDJSON, run_info is emitted as the first line when --audit is set.

On this page