Add ReuseLastSuccessfulBuild for snapshot dependencies and push locally cached images

Add ReuseLastSuccessfulBuild property to AdditionalCiBuildConfiguration to allow
snapshot dependencies to accept the last successful build regardless of source
revision. Also push locally cached Docker images to registry when not yet uploaded.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

Author: gfraiteur

src/PostSharp.Engineering.BuildTools/ContinuousIntegration/Model/AdditionalCiBuildConfiguration.cs

@@ -26,6 +26,13 @@ public abstract class AdditionalCiBuildConfiguration
     /// </summary>
     public BuildConfiguration? BuildSnapshotDependency { get; init; }
 
+    /// <summary>
+    /// Gets or sets a value indicating whether the snapshot dependency should accept the last successful build
+    /// regardless of the current source snapshot. When <c>true</c>, TeamCity will reuse the last successful build
+    /// of the dependency instead of requiring a build from the exact same source revision.
+    /// </summary>
+    public bool ReuseLastSuccessfulBuild { get; init; }
+
     public bool OnlyCheckoutEngineering { get; init; }
 
     protected AdditionalCiBuildConfiguration( string id, string name )

src/PostSharp.Engineering.BuildTools/ContinuousIntegration/Model/PowershellAdditionalCiBuildConfiguration.cs

@@ -54,8 +54,10 @@ internal override TeamCityBuildConfiguration TeamCityBuildConfiguration(
                 .ToList();
 
             // Create snapshot dependencies for all transitive dependencies
+            var reuseBuilds = this.ReuseLastSuccessfulBuild ? ReuseBuilds.Successful : ReuseBuilds.Default;
+
             snapshotDependencies =
-                [new TeamCitySnapshotDependency( buildConfiguration.ObjectName, false, $"+:{buildArtifactsDirectory}/**/*=>{buildArtifactsDirectory}" )];
+                [new TeamCitySnapshotDependency( buildConfiguration.ObjectName, false, $"+:{buildArtifactsDirectory}/**/*=>{buildArtifactsDirectory}", ReuseBuilds: reuseBuilds )];
 
             snapshotDependencies.AddRange(
                 dependencies.Select( d => new TeamCitySnapshotDependency(

src/PostSharp.Engineering.BuildTools/ContinuousIntegration/TeamCity/TeamCityBuildConfiguration.cs

@@ -308,10 +308,17 @@ void AddBuildStep( BuildStep newStep )
                         _ => throw new ArgumentOutOfRangeException()
                     };
 
+                    var reuseBuildsLine = dependency.ReuseBuilds switch
+                    {
+                        ReuseBuilds.Successful => $"\n                     reuseBuilds = ReuseBuilds.SUCCESSFUL",
+                        ReuseBuilds.Any => $"\n                     reuseBuilds = ReuseBuilds.ANY",
+                        _ => ""
+                    };
+
                     writer.WriteLine(
                         $@"        dependency({objectName}) {{
             snapshot {{
-                     onDependencyFailure = FailureAction.{failureAction}
+                     onDependencyFailure = FailureAction.{failureAction}{reuseBuildsLine}
             }}" );
 
                     if ( dependency.ArtifactRules != null )

src/PostSharp.Engineering.BuildTools/ContinuousIntegration/TeamCity/TeamCitySnapshotDependency.cs

@@ -1,17 +1,25 @@
-// Copyright (c) SharpCrafters s.r.o. See the LICENSE.md file in the root directory of this repository root for details.
-
-namespace PostSharp.Engineering.BuildTools.ContinuousIntegration.TeamCity;
-
-internal record TeamCitySnapshotDependency(
-    string ObjectId,
-    bool IsAbsoluteId,
-    string? ArtifactRules = null,
-    FailureAction FailureAction = FailureAction.FailToStart );
-
-internal enum FailureAction
-{
-    FailToStart,
-    AddProblem,
-    Ignore,
-    Cancel
+// Copyright (c) SharpCrafters s.r.o. See the LICENSE.md file in the root directory of this repository root for details.
+
+namespace PostSharp.Engineering.BuildTools.ContinuousIntegration.TeamCity;
+
+internal record TeamCitySnapshotDependency(
+    string ObjectId,
+    bool IsAbsoluteId,
+    string? ArtifactRules = null,
+    FailureAction FailureAction = FailureAction.FailToStart,
+    ReuseBuilds ReuseBuilds = ReuseBuilds.Default );
+
+internal enum FailureAction
+{
+    FailToStart,
+    AddProblem,
+    Ignore,
+    Cancel
+}
+
+internal enum ReuseBuilds
+{
+    Default,
+    Successful,
+    Any
 }