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
@@ -817,8 +817,8 @@ public class NotificationOutboxActor : ReceiveActor, IWithTimers
// Central dispatch is a system identity per the Actor-column spec —
// there is no per-call authenticated user for automatic delivery. An
// operator-initiated transition (Retry/Discard) passes actorOverride
// so the row is attributable to the person who un-parked/cancelled it
// (Task 13). The originating script is still captured on SourceScript.
// so the row is attributable to the person who un-parked/cancelled it.
// The originating script is still captured on SourceScript.
actor: actorOverride ?? SystemActor,
target: notification.ListName,
correlationId: correlationId,
@@ -1102,8 +1102,8 @@ public class NotificationOutboxActor : ReceiveActor, IWithTimers
// Operator re-queued a parked notification. Emit a Submitted NotifyDeliver
// row attributing the un-park to the operator — otherwise the lifecycle
// reads Parked → Attempted → Delivered with no record of who un-parked it
// (Task 13). Best-effort: audit failure never aborts the retry.
// reads Parked → Attempted → Delivered with no record of who un-parked it.
// Best-effort: audit failure never aborts the retry.
await EmitRetrySubmittedAuditAsync(notification, DateTimeOffset.UtcNow, request.RequestedBy);
return new RetryNotificationResponse(request.CorrelationId, Success: true, ErrorMessage: null);
@@ -1178,7 +1178,7 @@ public class NotificationOutboxActor : ReceiveActor, IWithTimers
// Delivered/Parked emissions; the row carries no error message because
// the discard is an operator-driven cancellation, not a delivery error.
// The operator identity is stamped as Actor so the cancellation is
// attributable (Task 13).
// attributable.
await EmitTerminalAuditAsync(
notification, DateTimeOffset.UtcNow, errorMessage: null, actorOverride: request.RequestedBy);
@@ -40,7 +40,13 @@ public sealed class SmsOptions
/// </summary>
public sealed class SmsOptionsValidator : IValidateOptions<SmsOptions>
{
/// <inheritdoc />
/// <summary>
/// Validates that a bound <see cref="SmsOptions"/> instance is usable, failing
/// fast at startup if any value is not strictly positive.
/// </summary>
/// <param name="name">The named options instance being validated, or <c>null</c> for the default instance.</param>
/// <param name="options">The bound <see cref="SmsOptions"/> instance to validate.</param>
/// <returns>A successful result, or a failure result listing every invalid field.</returns>
public ValidateOptionsResult Validate(string? name, SmsOptions options)
{
ArgumentNullException.ThrowIfNull(options);