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:
+14
-7
@@ -79,7 +79,7 @@ public partial class FlowDebugger : ComponentBase, IDisposable
|
||||
[Inject] private ISiteRepository SiteRepository { get; set; } = default!;
|
||||
/// <summary>
|
||||
/// Resolves <c>{"$ref":"lib:Name"}</c> nodes in a method's parameter schema so the raw-JSON
|
||||
/// escape hatch validates against the same resolved shape the form renders (#37).
|
||||
/// escape hatch validates against the same resolved shape the form renders.
|
||||
/// </summary>
|
||||
[Inject] private ISchemaLibraryQueryService SchemaLibrary { get; set; } = default!;
|
||||
[Inject] private SiteScopeService SiteScope { get; set; } = default!;
|
||||
@@ -154,7 +154,7 @@ public partial class FlowDebugger : ComponentBase, IDisposable
|
||||
private bool _scriptParamsValid;
|
||||
|
||||
/// <summary>
|
||||
/// Method entry (#37): the chosen method's resolved root schema (null when it declares no
|
||||
/// Method entry: the chosen method's resolved root schema (null when it declares no
|
||||
/// parameters or the definitions do not parse) and its top-level fields — the card renders
|
||||
/// only when there is at least one. The values live in <see cref="_methodParams"/>, the same
|
||||
/// coerced value tree <c>ParameterValueForm</c> emits for the script pane, so the request
|
||||
@@ -166,7 +166,7 @@ public partial class FlowDebugger : ComponentBase, IDisposable
|
||||
private bool _methodParamsValid;
|
||||
|
||||
/// <summary>
|
||||
/// Raw-JSON escape hatch for the whole method payload (#37): paste the exact body an
|
||||
/// Raw-JSON escape hatch for the whole method payload: paste the exact body an
|
||||
/// external caller would send. The text is parsed and schema-validated on every edit;
|
||||
/// only a valid document reaches <see cref="_methodParams"/>, which stays the single source
|
||||
/// of truth in both modes.
|
||||
@@ -214,6 +214,8 @@ public partial class FlowDebugger : ComponentBase, IDisposable
|
||||
/// on a step are NOT here — they are reported separately as
|
||||
/// <see cref="FlowGraph.UnattachedLogLines"/>.
|
||||
/// </summary>
|
||||
/// <param name="graph">The flow graph to count log lines in, or null.</param>
|
||||
/// <returns>The error, warning, info and total log-line counts.</returns>
|
||||
internal static (int Errors, int Warnings, int Info, int Total) CountLogs(FlowGraph? graph)
|
||||
{
|
||||
if (graph is null)
|
||||
@@ -706,7 +708,7 @@ public partial class FlowDebugger : ComponentBase, IDisposable
|
||||
// row the run did not already have, the page is no longer short of lines and the flag
|
||||
// clears. Until then it stays: the site's rows reach central's audit store by telemetry
|
||||
// 5-30 s later, so a refresh that adds nothing proves nothing.
|
||||
// Final review M7: read the OUTCOME's own flag — FlowDebugService copies the raw result's
|
||||
// Read the OUTCOME's own flag — FlowDebugService copies the raw result's
|
||||
// onto it precisely so a caller need not unwrap Raw, and reading Raw here left the record
|
||||
// member with no consumer.
|
||||
var logsTruncated = (_raw.LogsTruncated || outcome.LogsTruncated)
|
||||
@@ -721,6 +723,9 @@ public partial class FlowDebugger : ComponentBase, IDisposable
|
||||
=> events?.Count(FlowStepProjector.IsLogLine) ?? 0;
|
||||
|
||||
/// <summary>Preserves fresh Replay order, then appends live-only rows; duplicate event IDs use the fresh copy.</summary>
|
||||
/// <param name="known">Events already held by the page, or null.</param>
|
||||
/// <param name="fresh">Newly read Replay events, or null.</param>
|
||||
/// <returns>The merged event list.</returns>
|
||||
internal static IReadOnlyList<AuditEvent> MergeEvents(IReadOnlyList<AuditEvent>? known, IReadOnlyList<AuditEvent>? fresh)
|
||||
{
|
||||
var byId = new Dictionary<Guid, AuditEvent>();
|
||||
@@ -852,7 +857,7 @@ public partial class FlowDebugger : ComponentBase, IDisposable
|
||||
return (await SiteScope.PermittedSiteIdsAsync()).Contains(site.Id);
|
||||
}
|
||||
|
||||
/// <inheritdoc/>
|
||||
/// <summary>Cancels any pending outcome refresh when the component is disposed.</summary>
|
||||
public void Dispose() => CancelPendingRefresh();
|
||||
|
||||
private async Task LoadReplayAsync()
|
||||
@@ -972,7 +977,7 @@ public partial class FlowDebugger : ComponentBase, IDisposable
|
||||
}
|
||||
|
||||
/// <summary>
|
||||
/// Form ⇄ Raw JSON (#37). Entering raw mode seeds the editor from the current value tree so
|
||||
/// Form ⇄ Raw JSON. Entering raw mode seeds the editor from the current value tree so
|
||||
/// the operator edits what the form would have sent; leaving it re-mounts the form over the
|
||||
/// last VALID tree (the form is keyed on the method, and it is not rendered while raw mode is
|
||||
/// on, so it mounts fresh and re-reports validity from the tree).
|
||||
@@ -1054,6 +1059,7 @@ public partial class FlowDebugger : ComponentBase, IDisposable
|
||||
/// <c>ParameterValueForm</c> emits and what the raw editor parsed), or null when the method
|
||||
/// declares no parameters. Run is gated on validity, so nothing here re-checks the tree.
|
||||
/// </summary>
|
||||
/// <returns>The serialized parameters, or null when the method declares none.</returns>
|
||||
internal JsonElement? BuildParameters()
|
||||
=> _inputFields.Count == 0 ? null : JsonSerializer.SerializeToElement(_methodParams);
|
||||
|
||||
@@ -1062,6 +1068,7 @@ public partial class FlowDebugger : ComponentBase, IDisposable
|
||||
/// nothing. <c>ParameterValueForm</c> already emits the coerced value tree (scalars as
|
||||
/// bool/long/double/string, objects as dictionaries, lists as lists), so it serializes as-is.
|
||||
/// </summary>
|
||||
/// <returns>The serialized parameters, or null when the form produced nothing.</returns>
|
||||
internal JsonElement? BuildScriptParameters()
|
||||
=> _scriptParams.Count == 0 ? null : JsonSerializer.SerializeToElement(_scriptParams);
|
||||
|
||||
@@ -1092,7 +1099,7 @@ public partial class FlowDebugger : ComponentBase, IDisposable
|
||||
|
||||
/// <summary>
|
||||
/// Restores a persisted value tree only when it still validates against the method's current
|
||||
/// schema — a stale tree (the schema changed, or the pre-#37 flat string-per-field entry) is
|
||||
/// schema — a stale tree (the schema changed, or the older flat string-per-field entry) is
|
||||
/// dropped rather than painted into the form as errors.
|
||||
/// </summary>
|
||||
private async Task RestoreInputsAsync(int methodId)
|
||||
|
||||
+4
@@ -123,6 +123,10 @@ public partial class InstanceConfigure
|
||||
/// counts: it pins a reportable template alarm off for this instance, which is a
|
||||
/// real override and not the same as inheriting.
|
||||
/// </summary>
|
||||
/// <param name="overrideJson">The override JSON entered in the modal, if any.</param>
|
||||
/// <param name="priority">The priority override, if one was chosen.</param>
|
||||
/// <param name="mesReportable">The MES-reportable override, if one was chosen.</param>
|
||||
/// <returns><c>true</c> when the modal carries any override worth persisting; otherwise <c>false</c>.</returns>
|
||||
internal static bool HasOverrideDelta(string? overrideJson, int? priority, bool? mesReportable)
|
||||
=> !string.IsNullOrWhiteSpace(overrideJson) || priority.HasValue || mesReportable.HasValue;
|
||||
|
||||
|
||||
Reference in New Issue
Block a user