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:
@@ -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);
|
||||
|
||||
Reference in New Issue
Block a user