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.
2026-07-07 11:03:26 -04:00
parent 67005ca4c0
commit 9cff87fe85
435 changed files with 2338 additions and 2547 deletions
@@ -3,7 +3,7 @@ using ZB.MOM.WW.ScadaBridge.Commons.Entities.Kpi;
 namespace ZB.MOM.WW.ScadaBridge.Commons.Interfaces.Kpi;

 /// <summary>
-/// A DI-registered provider of KPI samples (M6 "KPI History &amp; Trends"),
+/// A DI-registered provider of KPI samples ("KPI History &amp; Trends"),
 /// implemented by each owning component and enumerated by the central recorder
 /// singleton at every sampling interval. The recorder stamps a single
 /// <c>capturedAtUtc</c>, fans out to every source's <see cref="CollectAsync"/>,
@@ -1,7 +1,7 @@
 namespace ZB.MOM.WW.ScadaBridge.Commons.Interfaces.Protocol;

 /// <summary>
-/// M7-B4 (T15): optional capability for an <see cref="IDataConnection"/>
+/// Optional capability for an <see cref="IDataConnection"/>
 /// implementation that supports a bounded recursive search of the server's
 /// address space. A complement to <see cref="IBrowsableDataConnection"/>:
 /// where browse walks one level at a time on user demand, search walks the
@@ -5,7 +5,7 @@ using ZB.MOM.WW.ScadaBridge.Commons.Types.Audit;
 namespace ZB.MOM.WW.ScadaBridge.Commons.Interfaces.Repositories;

 /// <summary>
-/// Append-only data access for the central <c>AuditLog</c> table (Audit Log #23).
+/// Append-only data access for the central <c>AuditLog</c> table.
 /// </summary>
 /// <remarks>
 /// <para>
@@ -65,7 +65,7 @@ public interface IAuditLogRepository
    /// EventId uniqueness — required by <see cref="InsertIfNotExistsAsync"/> —
    /// can be enforced cheaply). SQL Server rejects
    /// <c>ALTER TABLE … SWITCH PARTITION</c> while a non-aligned unique index
-    /// is present, so the M6 implementation drops the index, creates a staging
+    /// is present, so the implementation drops the index, creates a staging
    /// table with byte-identical schema, switches the partition's data into
    /// staging, drops staging (discarding the rows), and rebuilds the unique
    /// index. The CATCH branch guarantees the index is rebuilt even on partial
@@ -88,7 +88,7 @@ public interface IAuditLogRepository
    Task<long> SwitchOutPartitionAsync(DateTime monthBoundary, CancellationToken ct = default);

    /// <summary>
-    /// M5.5 (T3) per-channel retention override purge. Deletes <c>AuditLog</c> rows for a
+    /// Per-channel retention override purge. Deletes <c>AuditLog</c> rows for a
    /// single <paramref name="channel"/> (matched against the canonical
    /// <c>Category</c> column — the bare channel name, e.g. <c>ApiOutbound</c>) whose
    /// <c>OccurredAtUtc</c> is strictly older than <paramref name="threshold"/>, in
@@ -128,7 +128,7 @@ public interface IAuditLogRepository
    /// boundaries whose partitions contain only rows with
    /// <see cref="AuditEvent.OccurredAtUtc"/> strictly older than
    /// <paramref name="threshold"/>. Boundaries whose partition is empty are
-    /// excluded (a no-op switch is wasted work). Used by the M6 purge actor
+    /// excluded (a no-op switch is wasted work). Used by the purge actor
    /// to enumerate retention-eligible months on every tick.
    /// </summary>
    /// <param name="threshold">Only partitions whose data is entirely older than this UTC datetime are returned.</param>
@@ -139,7 +139,7 @@ public interface IAuditLogRepository
        CancellationToken ct = default);

    /// <summary>
-    /// Audit Log (#23) M7 Bundle E (T13) — returns aggregate counts over the
+    /// Returns aggregate counts over the
    /// trailing <paramref name="window"/> driving the central Health
    /// dashboard's Audit KPI tiles.
    /// </summary>
@@ -185,7 +185,7 @@ public interface IAuditLogRepository
        CancellationToken ct = default);

    /// <summary>
-    /// Audit Log ParentExecutionId feature (Task 8) — given any
+    /// Audit Log ParentExecutionId feature — given any
    /// <paramref name="executionId"/> in an execution chain, returns the whole
    /// chain rooted at the topmost ancestor: one <see cref="ExecutionTreeNode"/>
    /// per distinct execution, summarising its <c>AuditLog</c> rows. The Central
@@ -239,7 +239,7 @@ public interface IAuditLogRepository
    Task<IReadOnlyList<string>> GetDistinctSourceNodesAsync(CancellationToken ct = default);

    /// <summary>
-    /// M5.6 (T5) one-time operational backfill: sets <c>SourceNode</c> to
+    /// One-time operational backfill: sets <c>SourceNode</c> to
    /// <paramref name="sentinel"/> on every row where <c>SourceNode IS NULL</c>
    /// and <c>OccurredAtUtc &lt; <paramref name="before"/></c>, in bounded
    /// batches of <paramref name="batchSize"/> rows, looping until no further
@@ -107,7 +107,7 @@ public interface IDeploymentManagerRepository
    /// <returns>A task representing the asynchronous operation.</returns>
    Task DeleteSystemArtifactDeploymentAsync(int id, CancellationToken cancellationToken = default);

-    // WP-8: DeployedConfigSnapshot
+    // DeployedConfigSnapshot
    /// <summary>
    /// Gets the deployed config snapshot for an instance.
    /// </summary>
@@ -17,7 +17,7 @@ public interface IExternalSystemRepository
    /// Returns the external system with the given name, or <c>null</c> if no such
    /// system exists. A name-keyed lookup so hot-path resolution (e.g. a script's
    /// <c>ExternalSystem.Call()</c>) does not have to fetch every system and filter
-    /// in memory on each call (ExternalSystemGateway-011).
+    /// in memory on each call.
    /// </summary>
    /// <param name="name">The external system name.</param>
    /// <param name="cancellationToken">Cancellation token.</param>
@@ -68,7 +68,7 @@ public interface IExternalSystemRepository
    /// Returns the method with the given name belonging to the given external system,
    /// or <c>null</c> if no such method exists. A name-keyed lookup so hot-path
    /// resolution does not have to fetch every method of the system and filter in
-    /// memory on each call (ExternalSystemGateway-011).
+    /// memory on each call.
    /// </summary>
    /// <param name="externalSystemId">The external system ID.</param>
    /// <param name="methodName">The method name.</param>
@@ -121,8 +121,7 @@ public interface IExternalSystemRepository
    /// Returns the database connection definition with the given name, or <c>null</c>
    /// if no such connection exists. A name-keyed lookup so hot-path resolution (e.g.
    /// a script's <c>Database.Connection()</c> / <c>Database.CachedWrite()</c>) does
-    /// not have to fetch every connection and filter in memory on each call
-    /// (ExternalSystemGateway-011).
+    /// not have to fetch every connection and filter in memory on each call.
    /// </summary>
    /// <param name="name">The database connection name.</param>
    /// <param name="cancellationToken">Cancellation token.</param>
@@ -4,7 +4,7 @@ namespace ZB.MOM.WW.ScadaBridge.Commons.Interfaces.Repositories;

 public interface IInboundApiRepository
 {
-    // ApiKey persistence retired (re-arch C5): inbound API keys live in the shared
+    // ApiKey persistence retired: inbound API keys live in the shared
    // ZB.MOM.WW.Auth.ApiKeys SQLite store, not the SQL Server configuration DB. The
    // former GetApiKeyByIdAsync / GetAllApiKeysAsync / GetApiKeyByValueAsync /
    // AddApiKeyAsync / UpdateApiKeyAsync / DeleteApiKeyAsync / GetApprovedKeysForMethodAsync
@@ -4,7 +4,7 @@ using ZB.MOM.WW.ScadaBridge.Commons.Types.Kpi;
 namespace ZB.MOM.WW.ScadaBridge.Commons.Interfaces.Repositories;

 /// <summary>
-/// Data access for the central KPI-history backbone (M6 "KPI History &amp; Trends")
+/// Data access for the central KPI-history backbone ("KPI History &amp; Trends")
 /// — the tall / EAV <c>KpiSample</c> table in central MS SQL. Backs the recorder
 /// singleton's bulk write, the bucketed query path that feeds the reusable trend
 /// chart, and the retention purge. Implementation lives in the Configuration
@@ -3,10 +3,10 @@ using ZB.MOM.WW.ScadaBridge.Commons.Entities.SecuredWrites;
 namespace ZB.MOM.WW.ScadaBridge.Commons.Interfaces.Repositories;

 /// <summary>
-/// Operational-state data access for the central <c>PendingSecuredWrites</c> table
-/// (M7 OPC UA / MxGateway UX, Task T14b). One row per pending two-person secured
+/// Operational-state data access for the central <c>PendingSecuredWrites</c> table.
+/// One row per pending two-person secured
 /// write; rows are inserted at submission and mutated as the request is decided and
-/// executed. Mirrors the <c>SiteCalls</c> (Site Call Audit #22) repository shape.
+/// executed. Mirrors the <c>SiteCalls</c> repository shape.
 /// </summary>
 public interface ISecuredWriteRepository
 {
@@ -58,8 +58,8 @@ public interface ISecuredWriteRepository
    /// <summary>
    /// Atomically flips a row from <c>Pending</c> to <c>Approved</c>, stamping the
    /// verifier identity, comment, and decision time, but ONLY if the row is still
-    /// <c>Pending</c>. This is the compare-and-swap guard for the two-verifier race
-    /// (M7 / T14b): two verifiers may approve the same write concurrently, but the
+    /// <c>Pending</c>. This is the compare-and-swap guard for the two-verifier race:
+    /// two verifiers may approve the same write concurrently, but the
    /// conditional <c>WHERE Status='Pending'</c> guarantees exactly one wins. The
    /// loser observes <c>false</c> and must not relay the write.
    /// </summary>
@@ -3,10 +3,10 @@ using ZB.MOM.WW.ScadaBridge.Commons.Entities.Schemas;
 namespace ZB.MOM.WW.ScadaBridge.Commons.Interfaces.Repositories;

 /// <summary>
-/// Data access for the central <c>SharedSchemas</c> JSON-Schema library table
-/// (M9 template-level JSON-Schema library, Task T32a). One row per named schema; the
+/// Data access for the central <c>SharedSchemas</c> JSON-Schema library table.
+/// One row per named schema; the
 /// unique <see cref="SharedSchema.Name"/> is the lookup key used by the <c>lib:Name</c>
-/// <c>$ref</c> resolver (T32b).
+/// <c>$ref</c> resolver.
 /// </summary>
 public interface ISharedSchemaRepository
 {
@@ -5,15 +5,15 @@ using ZB.MOM.WW.ScadaBridge.Commons.Types.Audit;
 namespace ZB.MOM.WW.ScadaBridge.Commons.Interfaces.Repositories;

 /// <summary>
-/// Operational-state data access for the central <c>SiteCalls</c> table
-/// (Site Call Audit #22, Audit Log #23 M3 Bundle B). One row per
+/// Operational-state data access for the central <c>SiteCalls</c> table.
+/// One row per
 /// <see cref="TrackedOperationId"/>; sites remain the source of truth and this
 /// table is an eventually-consistent mirror fed by best-effort gRPC telemetry
 /// plus periodic reconciliation pulls.
 /// </summary>
 /// <remarks>
 /// <para>
-/// Unlike the partitioned append-only <c>AuditLog</c> (M1), this table holds
+/// Unlike the partitioned append-only <c>AuditLog</c>, this table holds
 /// mutable operational state. <see cref="UpsertAsync"/> is insert-if-not-exists
 /// then monotonic update — a status update with rank less than or equal to the
 /// stored status is a silent no-op so out-of-order telemetry, duplicate gRPC
@@ -21,8 +21,8 @@ public interface ITemplateEngineRepository
    /// Bulk variant of <see cref="GetTemplateWithChildrenAsync(int, CancellationToken)"/>
    /// that fetches every template whose <see cref="Template.Name"/> matches one of
    /// <paramref name="names"/> in a single SQL/EF query, eager-loading
-    /// Attributes / Alarms / Scripts / Compositions. Resolves the Transport-008
-    /// N+1 in <c>BundleImporter.PreviewAsync</c> — names that don't match an
+    /// Attributes / Alarms / Scripts / Compositions. Resolves the N+1
+    /// in <c>BundleImporter.PreviewAsync</c> — names that don't match an
    /// existing template are omitted from the result rather than producing a
    /// null entry, so callers should look up by name into the returned list.
    /// </summary>
@@ -3,12 +3,12 @@ using ZB.MOM.WW.Audit;
 namespace ZB.MOM.WW.ScadaBridge.Commons.Interfaces.Services;

 /// <summary>
-/// Boundary-side abstraction for emitting Audit Log (#23) events.
+/// Boundary-side abstraction for emitting Audit Log events.
 /// Implementations on the site write to local SQLite hot-path; on central they write to MS SQL directly.
 /// Failures must NEVER abort the user-facing action.
 /// </summary>
 /// <remarks>
-/// C3 (Task 2.5): the event type is the canonical <see cref="ZB.MOM.WW.Audit.AuditEvent"/>.
+/// The event type is the canonical <see cref="ZB.MOM.WW.Audit.AuditEvent"/>.
 /// The local seam is retained (rather than collapsed onto <c>ZB.MOM.WW.Audit.IAuditWriter</c>)
 /// so it stays a distinct DI binding from <see cref="ICentralAuditWriter"/> and so the many
 /// existing site/central implementations and test fakes keep their identity.
@@ -3,7 +3,7 @@ using ZB.MOM.WW.ScadaBridge.Commons.Types;
 namespace ZB.MOM.WW.ScadaBridge.Commons.Interfaces.Services;

 /// <summary>
-/// Audit Log #23 (M3 Bundle E — Tasks E4/E5): site-side hook the
+/// Site-side hook the
 /// store-and-forward retry loop invokes after every cached-call attempt and
 /// at terminal-state transitions, so the audit pipeline can emit
 /// <c>ApiCallCached</c>/<c>DbWriteCached</c> per-attempt rows and the
@@ -61,28 +61,28 @@ public interface ICachedCallLifecycleObserver
 /// <param name="DurationMs">Duration of the attempt in milliseconds (null when not measured).</param>
 /// <param name="SourceInstanceId">Originating instance, when known.</param>
 /// <param name="ExecutionId">
-/// Audit Log #23 (ExecutionId Task 4): the originating script execution's
+/// The originating script execution's
 /// per-run correlation id, threaded through the store-and-forward buffer from
 /// the cached-call enqueue path. The audit bridge stamps it onto the
 /// retry-loop <c>ApiCallCached</c>/<c>DbWriteCached</c> Attempted and
 /// <c>CachedResolve</c> rows so they correlate with the rest of the run.
-/// <c>null</c> for rows buffered before Task 4 (back-compat).
+/// <c>null</c> for rows buffered before this field was introduced (back-compat).
 /// </param>
 /// <param name="SourceScript">
-/// Audit Log #23 (ExecutionId Task 4): the originating script identifier,
+/// The originating script identifier,
 /// threaded alongside <paramref name="ExecutionId"/> so the retry-loop audit
 /// rows carry the same <c>SourceScript</c> provenance the script-side cached
 /// rows already do. <c>null</c> when not known.
 /// </param>
 /// <param name="ParentExecutionId">
-/// Audit Log #23 (ParentExecutionId Task 6): the <c>ExecutionId</c> of the
+/// The <c>ExecutionId</c> of the
 /// inbound-API request that spawned the originating script execution,
 /// threaded through the store-and-forward buffer alongside
 /// <paramref name="ExecutionId"/>. The audit bridge stamps it onto the
 /// retry-loop <c>ApiCallCached</c>/<c>DbWriteCached</c> Attempted and
 /// <c>CachedResolve</c> rows so they correlate back to the spawning run.
-/// <c>null</c> for a non-routed run and for rows buffered before Task 6
-/// (back-compat).
+/// <c>null</c> for a non-routed run and for rows buffered before this field
+/// was introduced (back-compat).
 /// </param>
 public sealed record CachedCallAttemptContext(
    TrackedOperationId TrackedOperationId,
@@ -3,8 +3,8 @@ using ZB.MOM.WW.ScadaBridge.Commons.Messages.Integration;
 namespace ZB.MOM.WW.ScadaBridge.Commons.Interfaces.Services;

 /// <summary>
-/// Site-side fan-out abstraction for cached-call lifecycle telemetry
-/// (Audit Log #23 / M3). One <see cref="CachedCallTelemetry"/> packet carries
+/// Site-side fan-out abstraction for cached-call lifecycle telemetry.
+/// One <see cref="CachedCallTelemetry"/> packet carries
 /// both an audit row and an operational <c>SiteCalls</c> upsert; the
 /// implementation routes the audit half through <see cref="IAuditWriter"/>
 /// and the operational half through the site-local tracking SQLite store.
@@ -12,7 +12,7 @@ namespace ZB.MOM.WW.ScadaBridge.Commons.Interfaces.Services;
 /// <remarks>
 /// <para>
 /// Defined in Commons so the script runtime (and the StoreAndForward retry
-/// loop, Bundle E4) can take a dependency on the abstraction rather than on
+/// loop) can take a dependency on the abstraction rather than on
 /// the concrete forwarder living inside <c>ZB.MOM.WW.ScadaBridge.AuditLog</c> — the
 /// existing dependency arrow runs from <c>SiteRuntime</c> to Commons, not to
 /// AuditLog.
@@ -25,26 +25,26 @@ public interface IDatabaseGateway
    /// Submits a SQL write to the store-and-forward engine for reliable delivery.
    /// </summary>
    /// <param name="trackedOperationId">
-    /// Audit Log #23 (M3): caller-supplied tracking id used as the
+    /// Caller-supplied tracking id used as the
    /// store-and-forward message id so the S&amp;F retry loop can read it
    /// back via <c>StoreAndForwardMessage.Id</c> and emit per-attempt /
    /// terminal cached-write telemetry under the same id. Defaults to
    /// <c>null</c> — when omitted the S&amp;F engine mints a fresh GUID and no
-    /// M3 telemetry is correlated (pre-M3 caller behaviour).
+    /// telemetry is correlated.
    /// </param>
    /// <param name="executionId">
-    /// Audit Log #23 (ExecutionId Task 4): the originating script execution's
+    /// The originating script execution's
    /// per-run correlation id. When the write is buffered on a transient
    /// failure this is threaded onto the S&amp;F message so the retry-loop
    /// cached-write audit rows carry it. <c>null</c> when not threaded.
    /// </param>
    /// <param name="sourceScript">
-    /// Audit Log #23 (ExecutionId Task 4): the originating script identifier,
+    /// The originating script identifier,
    /// threaded onto the buffered S&amp;F message alongside
    /// <paramref name="executionId"/>. <c>null</c> when not known.
    /// </param>
    /// <param name="parentExecutionId">
-    /// Audit Log #23 (ParentExecutionId Task 6): the <c>ExecutionId</c> of the
+    /// The <c>ExecutionId</c> of the
    /// inbound-API request that spawned the originating script execution.
    /// When the write is buffered on a transient failure this is threaded onto
    /// the S&amp;F message alongside <paramref name="executionId"/> so the
@@ -57,7 +57,7 @@ public interface IDatabaseGateway
    /// <param name="originInstanceName">Optional name of the instance that originated the write.</param>
    /// <param name="cancellationToken">Cancellation token for the buffering operation.</param>
    /// <returns>
-    /// M2.3 (#7): an <see cref="ExternalCallResult"/> mirroring the External-System
+    /// An <see cref="ExternalCallResult"/> mirroring the External-System
    /// API path (<c>IExternalSystemClient.CachedCallAsync</c>). The write is
    /// attempted immediately:
    /// <list type="bullet">
@@ -32,27 +32,27 @@ public interface IExternalSystemClient
    /// <param name="originInstanceName">The instance name originating the call, or null.</param>
    /// <param name="cancellationToken">Cancellation token.</param>
    /// <param name="trackedOperationId">
-    /// Audit Log #23 (M3): caller-supplied tracking id used as the
+    /// Caller-supplied tracking id used as the
    /// store-and-forward message id so the S&amp;F retry loop can read it
    /// back via <c>StoreAndForwardMessage.Id</c> and emit per-attempt /
    /// terminal cached-call telemetry under the same id. Defaults to
    /// <c>null</c> — when omitted the S&amp;F engine mints a fresh GUID and no
-    /// M3 telemetry is correlated (the legacy behaviour pre-M3 callers rely
+    /// telemetry is correlated (the legacy behaviour older callers rely
    /// on).
    /// </param>
    /// <param name="executionId">
-    /// Audit Log #23 (ExecutionId Task 4): the originating script execution's
+    /// The originating script execution's
    /// per-run correlation id. When the call is buffered on a transient
    /// failure this is threaded onto the S&amp;F message so the retry-loop
    /// cached-call audit rows carry it. <c>null</c> when not threaded.
    /// </param>
    /// <param name="sourceScript">
-    /// Audit Log #23 (ExecutionId Task 4): the originating script identifier,
+    /// The originating script identifier,
    /// threaded onto the buffered S&amp;F message alongside
    /// <paramref name="executionId"/>. <c>null</c> when not known.
    /// </param>
    /// <param name="parentExecutionId">
-    /// Audit Log #23 (ParentExecutionId Task 6): the <c>ExecutionId</c> of the
+    /// The <c>ExecutionId</c> of the
    /// inbound-API request that spawned the originating script execution.
    /// When the call is buffered on a transient failure this is threaded onto
    /// the S&amp;F message alongside <paramref name="executionId"/> so the
@@ -81,7 +81,7 @@ public record ExternalCallResult(
    string? ErrorMessage,
    bool WasBuffered = false)
 {
-    // Commons-021: thread-safe lazy parse — `Lazy<T>` with the default
+    // Thread-safe lazy parse — `Lazy<T>` with the default
    // `LazyThreadSafetyMode.ExecutionAndPublication` guarantees that two
    // concurrent readers see the same `DynamicJsonElement` instance, the
    // `JsonDocument.Parse` runs at most once, and the published value is
@@ -97,7 +97,7 @@ public record ExternalCallResult(
    /// <summary>
    /// Parsed response as a dynamic object. Returns null if ResponseJson is null or empty.
    /// Access properties directly: result.Response.result, result.Response.items[0].name, etc.
-    /// Thread-safe: concurrent readers share a single parsed instance (Commons-021).
+    /// Thread-safe: concurrent readers share a single parsed instance.
    /// </summary>
    public dynamic? Response => _response.Value;
 }
@@ -1,6 +1,6 @@
 using ZB.MOM.WW.ScadaBridge.Commons.Types;

-// Commons-018: physically lives under Interfaces/Services/ to match the
+// Physically lives under Interfaces/Services/ to match the
 // established subfolder convention (REQ-COM-5b), but the namespace stays
 // `ZB.MOM.WW.ScadaBridge.Commons.Interfaces` to avoid a cascading update to 9+ consumer
 // files across ZB.MOM.WW.ScadaBridge.SiteRuntime, ZB.MOM.WW.ScadaBridge.AuditLog and ZB.MOM.WW.ScadaBridge.Host.
@@ -12,7 +12,7 @@ namespace ZB.MOM.WW.ScadaBridge.Commons.Interfaces;
 /// Site-local source of truth for cached-operation tracking
 /// (<c>ExternalSystem.CachedCall</c> / <c>Database.CachedWrite</c>) — alongside the
 /// Store-and-Forward buffer, this is the row that <c>Tracking.Status(id)</c>
-/// reads (Audit Log #23 / M3). One row per <see cref="TrackedOperationId"/>;
+/// reads. One row per <see cref="TrackedOperationId"/>;
 /// terminal rows are purged after a configurable retention window
 /// (default 7 days).
 /// </summary>
@@ -120,7 +120,7 @@ public interface IOperationTrackingStore
        CancellationToken ct = default);

    /// <summary>
-    /// Reconciliation read (Site Call Audit #22): return tracking rows whose
+    /// Reconciliation read: return tracking rows whose
    /// <c>UpdatedAtUtc</c> is at or after <paramref name="sinceUtc"/> as
    /// <see cref="SiteCallOperational"/> projections, ordered by
    /// <c>UpdatedAtUtc</c> ascending and capped at <paramref name="batchSize"/>.
@@ -1,4 +1,4 @@
-// Commons-018: physically lives under Interfaces/Services/ to match the
+// Physically lives under Interfaces/Services/ to match the
 // established subfolder convention (REQ-COM-5b), but the namespace stays
 // `ZB.MOM.WW.ScadaBridge.Commons.Interfaces` to avoid a cascading update to consumers
 // across ZB.MOM.WW.ScadaBridge.AuditLog and ZB.MOM.WW.ScadaBridge.ConfigurationDatabase. Adopting
@@ -8,8 +8,8 @@ namespace ZB.MOM.WW.ScadaBridge.Commons.Interfaces;

 /// <summary>
 /// Abstraction over the central AuditLog partition-function roll-forward
-/// operation. M6-T5 introduces a daily-cadence hosted service
-/// (<c>AuditLogPartitionMaintenanceService</c>) that calls
+/// operation. A daily-cadence hosted service
+/// (<c>AuditLogPartitionMaintenanceService</c>) calls
 /// <see cref="EnsureLookaheadAsync"/> to make sure
 /// <c>pf_AuditLog_Month</c> always has at least <c>LookaheadMonths</c> of
 /// future boundaries available — otherwise inserts past the highest
@@ -5,7 +5,7 @@ namespace ZB.MOM.WW.ScadaBridge.Commons.Interfaces.Services;

 /// <summary>
 /// Site-local audit-log queue surface consumed by the site
-/// <c>SiteAuditTelemetryActor</c> drain loop and the M6
+/// <c>SiteAuditTelemetryActor</c> drain loop and the
 /// <c>SiteStreamGrpcServer.PullAuditEvents</c> reconciliation handler.
 /// Extracted from <c>SqliteAuditWriter</c> so both consumers can be
 /// unit-tested against a stub without touching SQLite; the
@@ -15,7 +15,7 @@ namespace ZB.MOM.WW.ScadaBridge.Commons.Interfaces.Services;
 /// <remarks>
 /// Lives in Commons (rather than alongside <c>SqliteAuditWriter</c> in
 /// <c>ZB.MOM.WW.ScadaBridge.AuditLog</c>) because <c>ZB.MOM.WW.ScadaBridge.Communication</c> — which
-/// hosts the M6 gRPC pull handler — must depend on this interface and
+/// hosts the gRPC pull handler — must depend on this interface and
 /// <c>ZB.MOM.WW.ScadaBridge.AuditLog</c> already depends on <c>ZB.MOM.WW.ScadaBridge.Communication</c>.
 /// Pulling the interface up to Commons breaks the would-be cycle while
 /// keeping the implementation in the AuditLog component.
@@ -34,7 +34,7 @@ public interface ISiteAuditQueue
    /// <see cref="MarkForwardedAsync"/> will yield the same rows again.
    /// </summary>
    /// <remarks>
-    /// AuditLog-001: cached-lifecycle audit kinds
+    /// Cached-lifecycle audit kinds
    /// (<see cref="ZB.MOM.WW.ScadaBridge.Commons.Types.Enums.AuditKind.CachedSubmit"/>,
    /// <see cref="ZB.MOM.WW.ScadaBridge.Commons.Types.Enums.AuditKind.ApiCallCached"/>,
    /// <see cref="ZB.MOM.WW.ScadaBridge.Commons.Types.Enums.AuditKind.DbWriteCached"/>,
@@ -51,7 +51,7 @@ public interface ISiteAuditQueue
    Task<IReadOnlyList<AuditEvent>> ReadPendingAsync(int limit, CancellationToken ct = default);

    /// <summary>
-    /// AuditLog-001: returns up to <paramref name="limit"/> rows in
+    /// Returns up to <paramref name="limit"/> rows in
    /// <see cref="ZB.MOM.WW.ScadaBridge.Commons.Types.Enums.AuditForwardState.Pending"/>
    /// whose audit kind belongs to the cached-call lifecycle
    /// vocabulary (<see cref="ZB.MOM.WW.ScadaBridge.Commons.Types.Enums.AuditKind.CachedSubmit"/>,
@@ -71,7 +71,7 @@ public interface ISiteAuditQueue
    /// transport specified in Component-AuditLog.md §"Cached Operations —
    /// Combined Telemetry": cached rows MUST flow with their matching
    /// <c>SiteCalls</c> upsert through one MS SQL transaction at central. The
-    /// pre-AuditLog-001 implementation drained cached rows through the
+    /// prior implementation drained cached rows through the
    /// audit-only path, leaving the operational half unsent and the central
    /// dual-write handler unreachable. Returning them via this dedicated read
    /// surface lets the new drain join with the tracking store before push.
@@ -93,7 +93,7 @@ public interface ISiteAuditQueue
    Task MarkForwardedAsync(IReadOnlyList<Guid> eventIds, CancellationToken ct = default);

    /// <summary>
-    /// M6 reconciliation-pull read surface: returns up to <paramref name="batchSize"/>
+    /// Reconciliation-pull read surface: returns up to <paramref name="batchSize"/>
    /// rows whose <see cref="AuditEvent.OccurredAtUtc"/> &gt;= <paramref name="sinceUtc"/>
    /// and whose <see cref="ZB.MOM.WW.ScadaBridge.Commons.Types.Enums.AuditForwardState"/> is still
    /// <see cref="ZB.MOM.WW.ScadaBridge.Commons.Types.Enums.AuditForwardState.Pending"/> or
@@ -115,7 +115,7 @@ public interface ISiteAuditQueue
        DateTime sinceUtc, int batchSize, CancellationToken ct = default);

    /// <summary>
-    /// M6 reconciliation-pull commit surface: flips the supplied EventIds to
+    /// Reconciliation-pull commit surface: flips the supplied EventIds to
    /// <see cref="ZB.MOM.WW.ScadaBridge.Commons.Types.Enums.AuditForwardState.Reconciled"/>,
    /// but ONLY for rows currently in
    /// <see cref="ZB.MOM.WW.ScadaBridge.Commons.Types.Enums.AuditForwardState.Pending"/> or
@@ -129,7 +129,7 @@ public interface ISiteAuditQueue
    Task MarkReconciledAsync(IReadOnlyList<Guid> eventIds, CancellationToken ct = default);

    /// <summary>
-    /// M6 Bundle E (T6) health-metric surface: returns a point-in-time snapshot
+    /// Health-metric surface: returns a point-in-time snapshot
    /// of the site queue's pending count + oldest pending timestamp + on-disk
    /// SQLite file size. Surfaced on
    /// <see cref="ZB.MOM.WW.ScadaBridge.Commons.Messages.Health.SiteHealthReport"/> as
@@ -5,7 +5,7 @@ namespace ZB.MOM.WW.ScadaBridge.Commons.Interfaces.Transport;
 /// audit log entries emitted by the audited repository methods invoked during
 /// ApplyAsync. AuditService reads this and stamps every AuditLogEntry it writes.
 /// <para>
-/// Thread-safety / concurrency contract (Transport-009): the in-tree
+/// Thread-safety / concurrency contract: the in-tree
 /// implementation backs <see cref="BundleImportId"/> with an
 /// <see cref="System.Threading.AsyncLocal{T}"/> so each logical asynchronous
 /// call chain — every distinct <c>BundleImporter.ApplyAsync</c> invocation —
@@ -30,7 +30,7 @@ public interface IBundleImporter
    /// <param name="ct">Cancellation token.</param>
    /// <param name="nameMap">
    /// The operator-supplied resolution of every source-environment site and connection
-    /// name the bundle references (M8 D1). Each entry is either
+    /// name the bundle references. Each entry is either
    /// <see cref="MappingAction.MapToExisting"/> (bind to an existing target site/connection)
    /// or <see cref="MappingAction.CreateNew"/> (create one from the bundle payload). A
    /// site or connection that the bundle references but that has no explicit entry here is
@@ -4,7 +4,7 @@ namespace ZB.MOM.WW.ScadaBridge.Commons.Interfaces.Transport;
 /// Computes the CURRENT flattened-config revision hash of a deployed instance —
 /// the same value the deployment pipeline produces and stores in
 /// <c>DeployedConfigSnapshot.RevisionHash</c>. Transport's bundle importer uses
-/// this to enumerate stale instances after a template overwrite (#16): an
+/// this to enumerate stale instances after a template overwrite: an
 /// instance is stale when its freshly-computed hash no longer matches the hash
 /// captured at deploy time.
 /// <para>