docs(xml): fill missing XML doc comments + strip task-tracking refs across src (fixdocs)

Add missing <summary>/<param>/<returns>/<typeparam> tags and switch
interface implementations to <inheritdoc/> across 106 files; strip
project bookkeeping identifiers (Task NN, #05-TNN, PLAN-04, StoreAndForward-0NN)
from shipped code comments while preserving the descriptive rationale.
Comment-only: zero code-logic lines changed; solution builds 0/0.

Claude-Session: https://claude.ai/code/session_01MtdgwpEeCUn6cUA5f1LMPj
This commit is contained in:
Joseph Doherty
2026-07-10 08:23:56 -04:00
parent 75007b9edd
commit 5a878b78d4
106 changed files with 580 additions and 180 deletions
@@ -99,6 +99,7 @@ public class StoreAndForwardService
private Func<bool>? _deliveryGate;
/// <summary>Installs the active-node delivery gate (see <see cref="_deliveryGate"/>).</summary>
/// <param name="gate">Predicate returning <c>true</c> when this node should run the retry sweep.</param>
public void SetDeliveryGate(Func<bool> gate) => _deliveryGate = gate;
/// <summary>
@@ -704,8 +705,8 @@ public class StoreAndForwardService
// Group due rows into per-(category,target) lanes. GroupBy is stable, so
// each lane preserves created_at-ASC (oldest-first) order. Lanes run
// concurrently up to SweepTargetParallelism, so one slow/dead target no
// longer blocks delivery to healthy ones (arch review 02, Performance #2);
// within a lane delivery stays strictly sequential (per-target FIFO).
// longer blocks delivery to healthy ones; within a lane delivery stays
// strictly sequential (per-target FIFO).
var lanes = messages
.GroupBy(m => (m.Category, m.Target))
.Select(g => g.ToList())
@@ -719,7 +720,7 @@ public class StoreAndForwardService
{
foreach (var message in lane)
{
// Task 8 short-circuit, per lane: one transient failure means
// Short-circuit, per lane: one transient failure means
// the target is down — skip the rest of this lane this sweep
// rather than burning a full timeout per remaining message.
// Skipped rows keep their RetryCount/LastAttemptAt untouched.
@@ -912,7 +913,7 @@ public class StoreAndForwardService
if (_observerPump is null)
{
// Not started: process inline (preserves pre-Task-19 test behavior).
// Not started: process inline (preserves prior test behavior).
return new ValueTask(work());
}