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