generalize checkpoint ref reconciliation

Reconcile disconnected metadata against the ref being synced so custom checkpoint refs preserve local data before rebasing.

Rename push sync helpers around ref terminology and refresh stale explain/doc references.