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
@@ -30,6 +30,7 @@ public class SiteCommunicationActorTransportTests : TestKit
return (actor, transport);
}
/// <summary>Verifies that a notification submit is delegated to the transport with the sender as the reply target.</summary>
[Fact]
public void NotificationSubmit_DelegatesToTransport_WithSenderAsReplyTo()
{
@@ -43,6 +44,7 @@ public class SiteCommunicationActorTransportTests : TestKit
Arg.Is<NotificationSubmit>(m => m.NotificationId == "notif-1"), Arg.Is(TestActor)));
}
/// <summary>Verifies that a notification status query is delegated to the transport with the sender as the reply target.</summary>
[Fact]
public void NotificationStatusQuery_DelegatesToTransport_WithSenderAsReplyTo()
{
@@ -54,6 +56,7 @@ public class SiteCommunicationActorTransportTests : TestKit
Arg.Is<NotificationStatusQuery>(m => m.NotificationId == "notif-1"), Arg.Is(TestActor)));
}
/// <summary>Verifies that an audit event ingest is delegated to the transport with the sender as the reply target.</summary>
[Fact]
public void IngestAuditEvents_DelegatesToTransport_WithSenderAsReplyTo()
{
@@ -64,6 +67,7 @@ public class SiteCommunicationActorTransportTests : TestKit
AwaitAssert(() => transport.Received(1).IngestAuditEvents(Arg.Any<IngestAuditEventsCommand>(), Arg.Is(TestActor)));
}
/// <summary>Verifies that a cached telemetry ingest is delegated to the transport with the sender as the reply target.</summary>
[Fact]
public void IngestCachedTelemetry_DelegatesToTransport_WithSenderAsReplyTo()
{
@@ -74,6 +78,7 @@ public class SiteCommunicationActorTransportTests : TestKit
AwaitAssert(() => transport.Received(1).IngestCachedTelemetry(Arg.Any<IngestCachedTelemetryCommand>(), Arg.Is(TestActor)));
}
/// <summary>Verifies that a site reconciliation request is delegated to the transport with the sender as the reply target.</summary>
[Fact]
public void ReconcileSite_DelegatesToTransport_WithSenderAsReplyTo()
{
@@ -86,6 +91,7 @@ public class SiteCommunicationActorTransportTests : TestKit
Arg.Is<ReconcileSiteRequest>(m => m.NodeId == "node-a"), Arg.Is(TestActor)));
}
/// <summary>Verifies that a site health report is delegated to the transport with the sender as the reply target.</summary>
[Fact]
public void ReportSiteHealth_DelegatesToTransport_WithSenderAsReplyTo()
{
@@ -98,6 +104,7 @@ public class SiteCommunicationActorTransportTests : TestKit
Arg.Is<SiteHealthReport>(m => m.SequenceNumber == 7), Arg.Is(TestActor)));
}
/// <summary>Verifies that a transport failure reply is routed back to the waiting sender.</summary>
[Fact]
public void TransportFailureReply_RoutesBackToTheWaitingSender()
{
@@ -122,6 +129,7 @@ public class SiteCommunicationActorTransportTests : TestKit
Assert.IsType<InvalidOperationException>(failure.Cause);
}
/// <summary>Verifies that an exception thrown by the transport during a heartbeat does not fault the actor.</summary>
[Fact]
public void HeartbeatTransportThrow_DoesNotFaultTheActor()
{