distributor/docs/roadmap/reconcile-state.md

# Reconcile-State Roadmap

Current destination state repair behavior is documented in:

- `docs/cli.md`
- `docs/operations.md`
- `docs/troubleshooting.md`
- `docs/integrations/destination-state.md`
- `docs/internal/app.md`
- `docs/internal/state.md`
- `docs/internal/storage.md`

## Current Scope

Current scope includes:

- `distributor reconcile-state --config <path> --pipeline <id>
  --destination <id>`;
- read-only inspection with `--dry-run`;
- default apply behavior when `--dry-run` is omitted;
- shared-root owner-scoped repair;
- shared-root all-owner repair with `--all-owners`;
- text and JSON reports.

Reconcile-state removes records for missing managed outputs from valid
destination state. It reports unmanaged entries but does not delete destination
files, adopt unmanaged entries, validate output digests, or repair invalid
state JSON.

## Deferred Work

Deferred state repair work:

- unmanaged-file adoption workflow;
- digest-audit mode;
- explicit invalid-state repair workflow;
- whole-config repair command.