docs(src): fix CommentChecker findings across src/ — 1,032 → 5 (all false positives)
Comment/XML-doc changes only, no code logic: - strip project-tracking references (WP*, P*-*, row-NN, #NN, Task N) from comments, keeping the explanatory rationale - add missing summaries, <param>, <returns>, <typeparam> and <inheritdoc/> - replace misused <inheritdoc/> with real docs; where <inheritdoc/> was combined with useful remarks, move the rationale into // comments - drop stale replicationActor <param> on DeploymentManagerActor ctor Remaining 5 are false positives (CWE-1236 x2, failures-1, year-0001, M365). Build 0 errors / 0 warnings.
This commit is contained in:
@@ -310,6 +310,7 @@ public class ScriptRuntimeContext
|
||||
/// <see cref="CreateChildContextForSharedScript"/>, so an inline shared script shares its
|
||||
/// caller's line cap and anchor. Null (the default) creates this run's own logger.
|
||||
/// </param>
|
||||
/// <param name="fileReader">Host-mediated reader backing the script <c>Files</c> global; null disables file access.</param>
|
||||
public ScriptRuntimeContext(
|
||||
IActorRef instanceActor,
|
||||
SharedScriptLibrary sharedScriptLibrary,
|
||||
@@ -422,6 +423,9 @@ public class ScriptRuntimeContext
|
||||
/// Wraps a trace sink so a throwing observer can neither fail the script call nor skip the
|
||||
/// durable audit write that follows it. Null in, null out — an untraced run allocates nothing.
|
||||
/// </summary>
|
||||
/// <param name="sink">The trace sink to wrap, or null for an untraced run.</param>
|
||||
/// <param name="logger">Logger used to report a rejecting sink.</param>
|
||||
/// <returns>The guarded sink, or null when <paramref name="sink"/> is null.</returns>
|
||||
internal static Action<AuditEvent>? GuardTraceSink(Action<AuditEvent>? sink, ILogger logger)
|
||||
{
|
||||
if (sink is null) return null;
|
||||
@@ -973,7 +977,7 @@ public class ScriptRuntimeContext
|
||||
.ConfigureAwait(false)).Matched;
|
||||
|
||||
/// <summary>
|
||||
/// Reset-aware handshake (Gitea #36, design 2026-09-10 §5) backing the nine-argument
|
||||
/// Reset-aware handshake (design 2026-09-10 §5) backing the nine-argument
|
||||
/// <c>Attributes.WriteBatchAndWaitAsync</c> overload. Legs, in a FIXED order:
|
||||
/// (1) write <paramref name="resetAttr"/>=<paramref name="resetEncoded"/> through
|
||||
/// <see cref="SetAttribute"/> (throws on a device-write failure, like the batch leg);
|
||||
@@ -986,7 +990,7 @@ public class ScriptRuntimeContext
|
||||
/// Why the reset must be OBSERVED before the trigger is written: a subscription reports a
|
||||
/// change from the last reported value, so a device that flips reset→done inside one
|
||||
/// sampling interval never reports the reset — the cached previous-run "done" value would
|
||||
/// then satisfy the response wait instantly (the #36 race), and an edge-triggered wait
|
||||
/// then satisfy the response wait instantly (the stale-echo race), and an edge-triggered wait
|
||||
/// would never resolve at all. Holding the trigger until the echo lands makes the existing
|
||||
/// level-triggered fast-path correct again. Each leg is already a traced Flow Debugger
|
||||
/// step, so a traced run shows all four.
|
||||
@@ -1006,7 +1010,7 @@ public class ScriptRuntimeContext
|
||||
/// <param name="resetAttr">Scope-resolved attribute written FIRST (usually the response attribute).</param>
|
||||
/// <param name="resetEncoded">
|
||||
/// Codec-encoded reset value the device must echo before anything else is written. NON-NULL by
|
||||
/// contract: a null would write an empty string on leg 1 and then give the leg-2 waiter a null
|
||||
/// contract: a null would write an empty string on leg 1 and then give the second-leg waiter a null
|
||||
/// target — "any change" — which fast-paths on the stale cached value and reinstates the very
|
||||
/// race this overload exists to close. The accessor rejects a null reset value before it gets here.
|
||||
/// </param>
|
||||
|
||||
Reference in New Issue
Block a user