perf(deploy): flatten-session caching, bulk DeploySiteAsync, paged management queries

2026-08-14 21:14:22 -04:00
parent ee193cd2bb
commit 48b3c40a7f
59 changed files with 3051 additions and 231 deletions
@@ -22,6 +22,48 @@ public interface IDeploymentManagerRepository
    /// <returns>A read-only list of all deployment records.</returns>
    Task<IReadOnlyList<DeploymentRecord>> GetAllDeploymentRecordsAsync(CancellationToken cancellationToken = default);
    /// <summary>
+    /// Database-side paged and filtered deployment query returning row summaries.
+    /// Backs the <c>QueryDeployments</c> management command, which previously
+    /// loaded the ENTIRE deployment-record table (insert-only, one row per deploy
+    /// attempt for the life of the system) and ignored the page arguments the CLI
+    /// was already sending.
+    /// </summary>
+    /// <param name="instanceId">Restrict to one instance's history, or <see langword="null"/> for all.</param>
+    /// <param name="status">Restrict to one deployment status, or <see langword="null"/> for all.</param>
+    /// <param name="instanceIdScope">
+    /// When non-null, restrict to these instance ids. Used to apply a site-scoped
+    /// user's permitted-site filter IN THE DATABASE rather than by loading every
+    /// record and every instance and filtering in memory.
+    /// </param>
+    /// <param name="skip">Rows to skip; negative values are floored at 0.</param>
+    /// <param name="take">Page size; non-positive or null returns every remaining row.</param>
+    /// <param name="cancellationToken">A cancellation token that can be used to cancel the operation.</param>
+    /// <returns>One page of deployment summaries, newest first.</returns>
+    Task<IReadOnlyList<Types.Deployment.DeploymentRecordSummary>> QueryDeploymentSummariesAsync(
+        int? instanceId,
+        DeploymentStatus? status,
+        IReadOnlyCollection<int>? instanceIdScope,
+        int skip,
+        int? take,
+        CancellationToken cancellationToken = default);
+    /// <summary>
+    /// Deletes TERMINAL deployment records (<see cref="DeploymentStatus.Success"/> /
+    /// <see cref="DeploymentStatus.Failed"/>) that completed before
+    /// <paramref name="cutoffUtc"/>, in one bounded batch.
+    ///
+    /// <para>
+    /// Non-terminal rows are never touched: an <c>InProgress</c> record is what the
+    /// query-before-redeploy reconciliation path reads to decide whether a prior
+    /// deploy actually landed at the site, so purging one by age would silently
+    /// disable that idempotency guard.
+    /// </para>
+    /// </summary>
+    /// <param name="cutoffUtc">Records completing before this instant are eligible.</param>
+    /// <param name="batchSize">Maximum rows deleted in this call.</param>
+    /// <param name="cancellationToken">A cancellation token that can be used to cancel the operation.</param>
+    /// <returns>The number of rows deleted; fewer than <paramref name="batchSize"/> means the sweep is complete.</returns>
+    Task<int> PurgeTerminalDeploymentRecordsAsync(DateTimeOffset cutoffUtc, int batchSize, CancellationToken cancellationToken = default);
+    /// <summary>
    /// Gets all deployment records for a specific instance.
    /// </summary>
    /// <param name="instanceId">The instance ID.</param>