refactor(kpi): K4/K10/K12 review fixups — test data-race + faulted-tick liveness, dead-branch/unused removal, NaN-guard assertions, value clamp + doc

2026-06-17 20:15:47 -04:00
parent 5613a5efb7
commit cb2a516187
6 changed files with 105 additions and 39 deletions
@@ -27,7 +27,8 @@ public static class KpiSeriesBucketer
    ///   An <see cref="IReadOnlyList{T}"/> of at most <paramref name="maxPoints"/> bucketed points,
    ///   ordered by <see cref="KpiSeriesPoint.BucketStartUtc"/> ascending.
    ///   Returns <paramref name="raw"/> unchanged (same reference) when
-    ///   <c>raw.Count &lt;= maxPoints</c>.
+    ///   <c>raw.Count &lt;= maxPoints</c>; callers must not mutate the underlying
+    ///   collection in that case, as it is the same object passed in.
    /// </returns>
    /// <exception cref="ArgumentOutOfRangeException">
    ///   Thrown when <paramref name="maxPoints"/> &lt; 2 or