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.