feat(kpi): GetLatestRollupHourAsync watermark seam for the backfill fast-path (plan R2-04 T2)

tests/ZB.MOM.WW.ScadaBridge.ConfigurationDatabase.Tests/Repositories/KpiHistoryRepositoryTests.cs

@@ -406,6 +406,29 @@ public class KpiHistoryRepositoryTests
         Assert.Empty(ctx.ChangeTracker.Entries<KpiSample>());
     }
 
+    [Fact]
+    public async Task GetLatestRollupHour_ReturnsNull_WhenNoRollupsExist()
+    {
+        await using var ctx = NewContext();
+        var repo = new KpiHistoryRepository(ctx);
+        Assert.Null(await repo.GetLatestRollupHourAsync());
+    }
+
+    [Fact]
+    public async Task GetLatestRollupHour_ReturnsNewestHourStart_AcrossAllSeries()
+    {
+        await using var ctx = NewContext();
+        var repo = new KpiHistoryRepository(ctx);
+        await repo.RecordSamplesAsync(new[]
+        {
+            Sample("NotificationOutbox", "queueDepth", "Global", null, 5, Base.AddMinutes(10)),
+            Sample("SiteCallAudit", "buffered", "Global", null, 2, Base.AddHours(3).AddMinutes(10)),
+        });
+        await repo.FoldHourlyRollupsAsync(Base, Base.AddHours(4));
+
+        Assert.Equal(Base.AddHours(3), await repo.GetLatestRollupHourAsync());
+    }
+
     // Local mirror of the repo's private hour-truncation, for cutoff assertions.
     private static DateTime TruncateHour(DateTime utc) =>
         new(utc.Year, utc.Month, utc.Day, utc.Hour, 0, 0, DateTimeKind.Utc);

tests/ZB.MOM.WW.ScadaBridge.KpiHistory.Tests/KpiHistoryRecorderActorTests.cs

@@ -191,6 +191,9 @@ public class KpiHistoryRecorderActorTests : TestKit
             lock (_gate) { _rollupPurgeCutoff = before; }
             return Task.CompletedTask;
         }
+
+        public Task<DateTime?> GetLatestRollupHourAsync(CancellationToken cancellationToken = default) =>
+            Task.FromResult<DateTime?>(null);
     }
 
     /// <summary>
@@ -237,6 +240,9 @@ public class KpiHistoryRecorderActorTests : TestKit
 
         public Task PurgeRollupsOlderThanAsync(DateTime before, CancellationToken cancellationToken = default) =>
             Task.CompletedTask;
+
+        public Task<DateTime?> GetLatestRollupHourAsync(CancellationToken cancellationToken = default) =>
+            Task.FromResult<DateTime?>(null);
     }
 
     /// <summary>
@@ -283,6 +289,9 @@ public class KpiHistoryRecorderActorTests : TestKit
 
         public Task PurgeRollupsOlderThanAsync(DateTime before, CancellationToken cancellationToken = default) =>
             Task.CompletedTask;
+
+        public Task<DateTime?> GetLatestRollupHourAsync(CancellationToken cancellationToken = default) =>
+            Task.FromResult<DateTime?>(null);
     }
 
     /// <summary>
@@ -340,6 +349,9 @@ public class KpiHistoryRecorderActorTests : TestKit
 
         public Task PurgeRollupsOlderThanAsync(DateTime before, CancellationToken cancellationToken = default) =>
             Task.CompletedTask;
+
+        public Task<DateTime?> GetLatestRollupHourAsync(CancellationToken cancellationToken = default) =>
+            Task.FromResult<DateTime?>(null);
     }
 
     private IServiceProvider BuildServiceProvider(