Config Reference

Root

version: 1
timezone: "UTC"
index: {}
sources: {}
pairs: {}

Field	Required	Description
`version`	yes	Must be `1`.
`timezone`	no	IANA timezone for global context.
`index`	no	Right-side index backend settings.
`sources`	yes	Named source definitions.
`pairs`	yes	Named reconciliation pair definitions.

sources:
  bank:
    file_pattern: "data/bank/*.csv"
    parser: {}

Field	Required	Description
`file_pattern`	yes	Glob used when explicit file flags are not passed.
`parser`	yes	Parser configuration.

pairs:
  bank_vs_psp:
    left: bank
    right: psp
    date_window: "1d"
    amount_tolerance_minor: 0
    name_mode: "tokens"

Field	Required	Description
`left`	yes	Left source name.
`right`	yes	Right source name.
`date_window`	no	Day window such as `1d`, `2d`, or `7d`.
`amount_tolerance_minor`	no	Allowed amount difference in minor units. Must be `>= 0`.
`name_mode`	no	`none` or `tokens`.

left and right must reference existing sources and cannot be the same source.

index:
  backend: auto
  spill_dir: "/tmp/reconify"
  auto_max_right_file_mb: 2048

Field	Required	Description
`backend`	no	`memory`, `disk`, or `auto`; default is `memory`.
`spill_dir`	no	Directory for disk index files.
`auto_max_right_file_mb`	no	Threshold for `auto`; default behavior uses `2048` when unset or zero.