Add explicit force replacement workflow

internal/publish/plan.go

@@ -20,6 +20,7 @@ const (
 	ActionSkipDestinationNewer Action = "skip_destination_newer"
 	ActionFailConflict         Action = "fail_conflict"
 	ActionFailUnmanaged        Action = "fail_unmanaged"
+	ActionForceReplace         Action = "force_replace"
 )
 
 type Request struct {
@@ -34,6 +35,7 @@ type Request struct {
 	Transformers          TransformerResolver
 	Transfer              config.TransferPolicy
 	DistributorVersion    string
+	Force                 bool
 }
 
 type TransformerResolver interface {
@@ -48,6 +50,7 @@ type Plan struct {
 	DestinationBundlePath string
 	Action                Action
 	Reason                string
+	Force                 bool
 	Outputs               []Output
 	ExistingState         *state.DistributorState
 }
@@ -75,7 +78,7 @@ func Build(ctx context.Context, req Request) (Plan, error) {
 		return Plan{}, err
 	}
 	comparison := state.Compare(req.SourceBundle.Manifest, req.PipelineID, req.DestinationID, status)
-	action, reason := actionForComparison(comparison, req.Transfer)
+	action, reason := actionForComparison(comparison, req.Transfer, req.Force)
 	plan := Plan{
 		PipelineID:            req.PipelineID,
 		DestinationID:         req.DestinationID,
@@ -84,6 +87,7 @@ func Build(ctx context.Context, req Request) (Plan, error) {
 		DestinationBundlePath: req.DestinationBundlePath,
 		Action:                action,
 		Reason:                reason,
+		Force:                 action == ActionForceReplace,
 		Outputs:               outputs,
 		ExistingState:         status.State,
 	}
@@ -112,13 +116,24 @@ func validateRequest(req Request) error {
 	return nil
 }
 
-func actionForComparison(comparison state.Comparison, transfer config.TransferPolicy) (Action, string) {
+func actionForComparison(comparison state.Comparison, transfer config.TransferPolicy, force bool) (Action, string) {
 	switch comparison.Outcome {
 	case state.OutcomeDestinationAbsent:
 		return ActionPublishNew, comparison.Reason
 	case state.OutcomeDestinationUnmanaged:
+		if force {
+			return ActionForceReplace, "forced replacement of unmanaged destination content"
+		}
 		return ActionFailUnmanaged, comparison.Reason
-	case state.OutcomeInvalidState, state.OutcomeIdentityMismatch, state.OutcomeSameCreatedConflict, state.OutcomeDifferentSourceConflict:
+	case state.OutcomeInvalidState:
+		return ActionFailConflict, comparison.Reason
+	case state.OutcomeIdentityMismatch, state.OutcomeSameCreatedConflict, state.OutcomeDifferentSourceConflict:
+		if transfer.OnConflict == config.TransferActionReplace {
+			if force {
+				return ActionForceReplace, "forced replacement of conflicting destination state: " + comparison.Reason
+			}
+			return ActionFailConflict, "destination conflict replacement requires --force"
+		}
 		return ActionFailConflict, comparison.Reason
 	case state.OutcomeSameSource:
 		if transfer.OnDestinationSame == config.TransferActionFail {
@@ -131,6 +146,12 @@ func actionForComparison(comparison state.Comparison, transfer config.TransferPo
 		}
 		return ActionReplaceOlder, comparison.Reason
 	case state.OutcomeDestinationNewer:
+		if transfer.OnDestinationNewer == config.TransferActionReplace {
+			if force {
+				return ActionForceReplace, "forced replacement of newer destination state"
+			}
+			return ActionFailConflict, "destination is newer and replacement requires --force"
+		}
 		if transfer.OnDestinationNewer == config.TransferActionFail {
 			return ActionFailConflict, "destination is newer and transfer policy requires failure"
 		}