Run the Matcher

Against the interview fixtures

uv run mercury match interview/mercury-customers.json interview/third-party-banks.json

Expected output:

Total matches: 6
Total mismatches: 3

Link 1: Match
Link 2: Mismatch
Link 3: Match
Link 4: Mismatch
Link 5: Match
Link 6: Match
Link 7: Match
Link 8: Match
Link 9: Mismatch

Against any pair of input files

The subcommand takes two positional arguments:

uv run mercury match path/to/customers.json path/to/banks.json

Both must exist and be readable. Input schemas are validated by Pydantic (mercury.models) — a malformed record raises before any scoring runs.

Discovery

uv run mercury --help          # top-level
uv run mercury match --help    # subcommand flags
uv run mercury --version       # installed version

Behavior details

See scoring-combiner for the decision rule, and scoring-phone / scoring-email / scoring-name / scoring-nicknames for per-field semantics. The overall approach and F&S comparison live in matching-approach.