SubMiner/changes/launcher-sync-command.md

type: added area: launcher

• Added subminer sync <host> to merge immersion stats and watch history between two machines over SSH. Each side snapshots its database (VACUUM INTO), snapshots are exchanged with scp, and each machine merges the other's data as an insert-only union keyed on session UUIDs / video keys / series title keys, so re-syncing is idempotent and nothing is double-counted. Lifetime totals and daily/monthly rollups are updated incrementally (history older than the session retention window is preserved); remote-only historical rollups are copied only when they do not conflict with retained local session history. subminer sync --snapshot <file> and subminer sync --merge <file> expose the underlying steps for manual transfers. The command refuses to run while the stats daemon or a live mpv session is active (--force overrides), ignores stale mpv socket files, keeps the guard in place through local/remote merges, supplies standard SubMiner and Bun paths to non-interactive SSH commands, verifies the remote launcher starts, reports remote stderr on failures, and aborts on stats schema version mismatches.