glx merge

Merge another archive into the destination archive

Synopsis

Combine two GLX archives by merging all content from the source into the destination. Duplicate or conflicting items (entities, vocabularies, property definitions, and metadata) are reported and skipped (the destination version is kept).

For multi-file archives, media binaries referenced by source Media entities are copied from the source's media/files/ into the destination's media/files/ after the entity merge. Source files whose content matches an identically-named binary already in the destination are skipped; collisions with different-content destination files are resolved by renaming the source copy (e.g. photo.jpg -> photo-2.jpg) and rewriting the merged Media entity's URI to match. Single-file destinations cannot hold binaries -- if the source has any, a warning is printed and the merged Media URIs will dangle.

Use --preview to see what would happen without modifying any files, including cross-archive duplicate person detection.

glx merge <source> [flags]

Examples

  # Merge another archive into the current one
  glx merge ./other-archive/ --into ./my-archive/

  # Preview merge with duplicate detection
  glx merge ./other-archive/ --into ./my-archive/ --preview

  # Preview with custom similarity threshold
  glx merge ./other-archive/ --into ./my-archive/ --preview --threshold 0.8

Options

  -h, --help              help for merge
      --into string       Destination archive path (default ".")
      --preview           Show detailed merge preview with duplicate detection
      --threshold float   Similarity threshold for duplicate detection in preview (0.0-1.0) (default 0.6)

Options inherited from parent commands

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

SEE ALSO

• glx - GENEALOGIX CLI - Manage and validate genealogy archives