Global settings

Pair-wide safety switches and advanced guardrails.

Global settings apply to the whole pair.

They control planning safety, write verification, and delete propagation.

Settings

Normally it’s not needed to change any settings here. The defaults are just fine for most users.

• Dry run: plan only. No writes.

• Verify after write: re-check a small sample after writes.

• Drop guard: blocks destructive plans when the source snapshot is empty.

• Allow mass delete: allows bulk removals when needed.

• One-Way Remove mode (Deletions based on Source): controls how deletes behave in one-way pairs.

• Tombstone retention (days): keeps delete markers to avoid re-adding items.

• Include observed deletes: treats provider-side deletions as intentional.

Allow Mass Delete is enabled by default because it’s often needed for the very first sync.

Once your pairs are stable, you can disable it for extra safety.

You cannot enable both Mass Delete and Drop guard at the same time.

One-Way Remove mode (Deletions based on Source)

This setting controls how CrossWatch plans removals for one-way pairs.

It does nothing unless Remove is enabled for the feature.

Source (default)

• UI: Deletions based on Source = ON

• Config: one_way_remove_mode = "source_deletes"

• Deletes only when there is a known match between source and destination.

Mirror

• UI: Deletions based on Source = OFF

• Config: one_way_remove_mode = "mirror"

• Destination strictly follows source. This will delete destination-only items.

Mirror mode is destructive.

Use it only when you want strict mirroring. Normally you don't need this.

Blackbox (advanced)

Blackbox is a staging area for uncertain changes.

Use it when:

• IDs are unstable.

• Providers “flap” (adds keep reappearing).

• You want a cooldown before applying removals.

Blackbox settings

• Enabled

• Pair-scoped

• Promote after (days)

• Unresolved days

• Cooldown (days)