distributor/docs/roadmap/multipipeline.md

Multi-Pipeline Shared Root Roadmap

Current shared-root destination state behavior is documented in:

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

Current Scope

Current scope includes state.mode: shared_root for destinations that intentionally share one destination root across multiple pipeline/destination owners.

Shared-root state:

• records owner identity by both pipeline_id and destination_id;
• records each managed output with its owner and compact source identity;
• preserves unrelated owners during owner-scoped publish, state repair, and pruning;
• rejects implicit takeover of another owner path;
• treats unmanaged storage content as unmanaged unless explicit forced replacement is selected where supported.

Deferred Work

No additional shared-root publishing work is planned here. Related deferred work is tracked in:

• docs/roadmap/future.md
• docs/roadmap/reconcile-state.md
• docs/roadmap/prune.md