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
@@ -24,6 +24,11 @@ public sealed class AutoLoginAuthenticationHandler
private readonly TimeProvider _clock;
/// <summary>Initializes the handler with the scheme plumbing, the disable-login options, and the clock.</summary>
/// <param name="options">The authentication scheme options monitor.</param>
/// <param name="logger">The logger factory used by the base handler.</param>
/// <param name="encoder">The URL encoder used by the base handler.</param>
/// <param name="disableLoginOptions">The disable-login configuration, including the dev user to impersonate.</param>
/// <param name="clock">The time provider used to stamp the minted principal's refresh timestamp.</param>
public AutoLoginAuthenticationHandler(
IOptionsMonitor<AuthenticationSchemeOptions> options,
ILoggerFactory logger,
@@ -37,9 +42,14 @@ public sealed class AutoLoginAuthenticationHandler
}
/// <summary>No-op: auto-login writes no cookie, so an explicit sign-in has nothing to persist.</summary>
/// <param name="user">The principal that would be signed in.</param>
/// <param name="properties">Authentication properties that would accompany the sign-in.</param>
/// <returns>A task that represents the asynchronous operation.</returns>
public Task SignInAsync(ClaimsPrincipal user, AuthenticationProperties? properties) => Task.CompletedTask;
/// <summary>No-op: there is no auth cookie to clear; the next request re-authenticates via this handler.</summary>
/// <param name="properties">Authentication properties that would accompany the sign-out.</param>
/// <returns>A task that represents the asynchronous operation.</returns>
public Task SignOutAsync(AuthenticationProperties? properties) => Task.CompletedTask;
/// <inheritdoc />
@@ -10,6 +10,10 @@ namespace ZB.MOM.WW.ScadaBridge.Security.Auth;
/// </summary>
public static class DisableLoginGuard
{
/// <summary>Throws if <paramref name="disableLogin"/> is set outside Development without the explicit override acknowledgement.</summary>
/// <param name="disableLogin">The configured <see cref="AuthDisableLoginOptions.DisableLogin"/> flag value.</param>
/// <param name="environmentName">The current hosting environment name (e.g. <c>Development</c>).</param>
/// <param name="allowOutsideDevelopment">The configured <see cref="AuthDisableLoginOptions.AllowOutsideDevelopment"/> second acknowledgement flag.</param>
public static void Validate(bool disableLogin, string environmentName, bool allowOutsideDevelopment)
{
if (!disableLogin) return;