docs(tests): fix CommentChecker findings across tests/ — 13,392 → 0 (repo-wide scan clean)

Comment/XML-doc changes only:
- add summaries to ~10k test methods, fixtures, fakes and helpers
  (+ <param> on theories, <returns> on async Task methods,
  <inheritdoc/> on interface implementations the checker can resolve)
- strip ~2.6k project-tracking references (WP*, P*-*, row-NN, Task N,
  #NN, Component-0NN) from comments, keeping the explanatory text;
  reword false positives in comments only
- real docs on fakes implementing BCL/library interfaces
  (IDisposable, ILogger, IOptionsMonitor, IAsyncLifetime)
- reword the last 5 src/ false positives (CWE-1236, failures-1,
  year-0001, M365)

Only non-comment edits: four one-line nested classes split across lines
so members can carry docs. Build 0 errors / 0 warnings.
This commit is contained in:
Joseph Doherty
2026-10-07 15:05:49 -04:00
parent 0ffd4bdbea
commit 513fa1aa16
998 changed files with 17896 additions and 2395 deletions
@@ -11,7 +11,7 @@ namespace ZB.MOM.WW.ScadaBridge.CentralUI.Tests.Components.Audit;
/// <summary>
/// bUnit tests for <see cref="ExecutionDetailModal"/> (Execution-Tree Node Detail
/// Modal, Task 3). The modal opens on an execution-tree node double-click: given
/// Modal). The modal opens on an execution-tree node double-click: given
/// an <c>ExecutionId</c> it loads that execution's audit rows via
/// <see cref="IAuditLogQueryService"/> and shows a list → per-row detail.
///
@@ -24,6 +24,7 @@ public class ExecutionDetailModalTests : BunitContext
private readonly IAuditLogQueryService _service;
private readonly List<(AuditLogQueryFilter Filter, AuditLogPaging? Paging)> _calls = new();
/// <summary>Initializes a new instance of the <c>ExecutionDetailModalTests</c> class.</summary>
public ExecutionDetailModalTests()
{
_service = Substitute.For<IAuditLogQueryService>();
@@ -66,6 +67,7 @@ public class ExecutionDetailModalTests : BunitContext
});
}
/// <summary>Verifies that closed modal renders nothing and does not query.</summary>
[Fact]
public void ClosedModal_RendersNothing_AndDoesNotQuery()
{
@@ -79,6 +81,7 @@ public class ExecutionDetailModalTests : BunitContext
Assert.Empty(_calls);
}
/// <summary>Verifies that open transition queries by execution id with page size 100.</summary>
[Fact]
public void OpenTransition_QueriesByExecutionId_WithPageSize100()
{
@@ -101,6 +104,7 @@ public class ExecutionDetailModalTests : BunitContext
Assert.Equal(100, _calls[0].Paging!.PageSize);
}
/// <summary>Verifies that still open non open parameter change does not requery.</summary>
[Fact]
public void StillOpen_NonOpenParameterChange_DoesNotRequery()
{
@@ -119,6 +123,7 @@ public class ExecutionDetailModalTests : BunitContext
Assert.Single(_calls);
}
/// <summary>Verifies that multi row renders list view with one button per row.</summary>
[Fact]
public void MultiRow_RendersListView_WithOneButtonPerRow()
{
@@ -138,6 +143,7 @@ public class ExecutionDetailModalTests : BunitContext
Assert.Empty(cut.FindAll("[data-test=\"drawer-fields\"]"));
}
/// <summary>Verifies that multi row click row shows audit event detail.</summary>
[Fact]
public void MultiRow_ClickRow_ShowsAuditEventDetail()
{
@@ -158,6 +164,7 @@ public class ExecutionDetailModalTests : BunitContext
Assert.NotNull(cut.Find("[data-test=\"execution-detail-back\"]"));
}
/// <summary>Verifies that multi row back control returns to list.</summary>
[Fact]
public void MultiRow_BackControl_ReturnsToList()
{
@@ -180,6 +187,7 @@ public class ExecutionDetailModalTests : BunitContext
Assert.Empty(cut.FindAll("[data-test=\"drawer-fields\"]"));
}
/// <summary>Verifies that single row opens straight to detail no back control.</summary>
[Fact]
public void SingleRow_OpensStraightToDetail_NoBackControl()
{
@@ -197,6 +205,7 @@ public class ExecutionDetailModalTests : BunitContext
Assert.Empty(cut.FindAll("[data-test=\"execution-detail-back\"]"));
}
/// <summary>Verifies that zero row shows friendly empty state.</summary>
[Fact]
public void ZeroRow_ShowsFriendlyEmptyState()
{
@@ -211,6 +220,7 @@ public class ExecutionDetailModalTests : BunitContext
Assert.Contains("This execution emitted no audit rows.", empty.TextContent);
}
/// <summary>Verifies that query throws shows inline error state does not rethrow.</summary>
[Fact]
public void QueryThrows_ShowsInlineErrorState_DoesNotRethrow()
{
@@ -228,6 +238,7 @@ public class ExecutionDetailModalTests : BunitContext
Assert.Contains("db is down", error.TextContent);
}
/// <summary>Verifies that close button raises on close.</summary>
[Fact]
public void CloseButton_RaisesOnClose()
{
@@ -245,6 +256,7 @@ public class ExecutionDetailModalTests : BunitContext
Assert.True(closed);
}
/// <summary>Verifies that backdrop click raises on close.</summary>
[Fact]
public void BackdropClick_RaisesOnClose()
{
@@ -262,6 +274,7 @@ public class ExecutionDetailModalTests : BunitContext
Assert.True(closed);
}
/// <summary>Verifies that escape key raises on close.</summary>
[Fact]
public void EscapeKey_RaisesOnClose()
{
@@ -279,6 +292,7 @@ public class ExecutionDetailModalTests : BunitContext
Assert.True(closed);
}
/// <summary>Verifies that header shows short execution id and row count.</summary>
[Fact]
public void Header_ShowsShortExecutionId_AndRowCount()
{