distributor/docs/roadmap/reconciliation.md

# Reconciliation Roadmap

Current destination reconciliation behavior is documented in:

- `docs/config.md`
- `docs/operations.md`
- `docs/integrations/destination-state.md`
- `docs/internal/publish.md`
- `docs/internal/state.md`

## Current Scope

Current scope includes destination `reconciliation.mode` values:

- `replace`: the managed output set is reconciled to the newly planned outputs.
- `merge`: omitted managed outputs are retained, and planned paths may overwrite
  only paths already recorded as managed.

`replace` is the default. Merge mode does not adopt unmanaged content and does
not let producers choose destination reconciliation policy.

## Deferred Work

No additional reconciliation-specific work is planned here. Related deferred
work is tracked in:

- `docs/roadmap/future.md`
- `docs/roadmap/prune.md`