docs(comments): strip internal task/milestone/bundle bookkeeping from code comments

Remove project bookkeeping citations from shipped code comments across the
solution: hyphenated task IDs (WP-14, StoreAndForward-025), milestone/task/
issue refs (M3, Task 4, Audit Log #23, #21), Bundle X task-bundle labels,
and C/D/K/S/T phase labels.

Comment text only — no code logic, string/log literals, or XML-doc structure
changed. Genuine descriptions are preserved (only the citation is stripped),
and technical lookalikes are retained (UTF-8, SHA-256, T00:00:00, M365,
UTC-5, pre-C4/pre-C5 schema versions). Flagged by the new CommentChecker
TaskReferenceInComment / TrackingReferenceInComment checks plus targeted
grep passes; full solution builds clean, append-only guard tests pass.
This commit is contained in:
Joseph Doherty
2026-07-07 11:03:26 -04:00
parent 67005ca4c0
commit 9cff87fe85
435 changed files with 2338 additions and 2547 deletions
@@ -27,7 +27,7 @@ public class SiteStorageService
/// <summary>
/// Creates a new (unopened) SQLite connection against the site database.
/// Exposed so site-local repositories can open their own connections without
/// reaching into private state via reflection (SiteRuntime-006). The caller owns
/// reaching into private state via reflection. The caller owns
/// the connection and is responsible for opening and disposing it.
/// </summary>
/// <returns>A new, unopened <see cref="SqliteConnection"/> against the site database.</returns>
@@ -437,7 +437,7 @@ public class SiteStorageService
_logger.LogDebug("Cleared static overrides for {Instance}", instanceName);
}
// ── Task 14: Native Alarm State store (read-only mirror of source A&C conditions) ──
// ── Native Alarm State store (read-only mirror of source A&C conditions) ──
/// <summary>
/// Inserts or updates a single mirrored native alarm condition, keyed by
@@ -550,7 +550,7 @@ public class SiteStorageService
_logger.LogDebug("Cleared native alarm state for {Instance}", instanceName);
}
// ── WP-33: Shared Script CRUD ──
// ── Shared Script CRUD ──
/// <summary>
/// Stores or updates a shared script. Uses UPSERT semantics.
@@ -613,7 +613,7 @@ public class SiteStorageService
return results;
}
// ── WP-33: External System CRUD ──
// ── External System CRUD ──
/// <summary>
/// Stores or updates an external system definition.
@@ -651,7 +651,7 @@ public class SiteStorageService
await command.ExecuteNonQueryAsync();
}
// ── WP-33: Database Connection CRUD ──
// ── Database Connection CRUD ──
/// <summary>
/// Stores or updates a database connection definition.
@@ -686,10 +686,10 @@ public class SiteStorageService
await command.ExecuteNonQueryAsync();
}
// ── WP-33: Notification List CRUD ──
// ── Notification List CRUD ──
/// <summary>
/// DeploymentManager-025 / SiteRuntime-031: notification delivery is central-only.
/// Notification delivery is central-only.
/// Sites store-and-forward notifications to the central cluster and never deliver
/// over SMTP, so notification lists and SMTP configuration must never live on a
/// site. This purges every row from the site-local <c>notification_lists</c> and
@@ -738,7 +738,7 @@ public class SiteStorageService
await command.ExecuteNonQueryAsync();
}
// ── WP-33: SMTP Configuration CRUD ──
// ── SMTP Configuration CRUD ──
/// <summary>
/// Stores or updates an SMTP configuration.
@@ -887,7 +887,7 @@ public class DeployedInstance
}
/// <summary>
/// Represents a shared script stored locally in SQLite (WP-33).
/// Represents a shared script stored locally in SQLite.
/// </summary>
public class StoredSharedScript
{
@@ -937,6 +937,6 @@ public class StoredDataConnectionDefinition
}
/// <summary>
/// A single mirrored native alarm condition row from the site-local <c>native_alarm_state</c> table (Task 14).
/// A single mirrored native alarm condition row from the site-local <c>native_alarm_state</c> table.
/// </summary>
public record NativeAlarmRow(string SourceReference, string ConditionJson, DateTimeOffset LastTransitionAt);