glx merge-persons

Merge two person entities, keeping the first and folding in the second

Synopsis

Consolidate two person entities into one. The keep-id is retained; the drop-id's properties, notes, and cross-references are folded into it, then the drop-id person file is removed.

Property merging:

• Properties present only on drop are copied verbatim.
• Multi-value (list) properties are unioned with deep-equal deduplication.
• Single-value conflicts default to keep's value (recorded in the conflict report). Pass --keep-newest or --keep-oldest to resolve dated conflicts by date instead.

Notes are combined per --notes-strategy (default: append).

This is the natural follow-on to glx duplicates: once you've identified that two person records are the same individual, this command consolidates them in a single atomic operation.

glx merge-persons <keep-id> <drop-id> [flags]

Examples

  # Merge person-jungk-1750 into person-juncker-1750
  glx merge-persons person-juncker-1750 person-jungk-1750 --archive ./archive

  # Preview the merge
  glx merge-persons person-a person-b --archive ./archive --dry-run

  # Resolve dated conflicts by picking the later entry
  glx merge-persons person-a person-b --archive ./archive --keep-newest

  # Replace keep's notes with drop's
  glx merge-persons person-a person-b --archive ./archive --notes-strategy prefer-drop

Options

  -a, --archive string          Path to GLX archive (default ".")
      --dry-run                 Show what would change without writing
  -h, --help                    help for merge-persons
      --keep-newest             For conflicting temporal properties, keep the entry with the later date
      --keep-oldest             For conflicting temporal properties, keep the entry with the earlier date
      --notes-strategy string   How to combine notes: append | prefer-keep | prefer-drop (default "append")

Options inherited from parent commands

  -q, --quiet   Suppress non-error output (where supported)

SEE ALSO

• glx - GENEALOGIX CLI - Manage and validate genealogy archives