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`