namespace ZB.MOM.WW.ScadaBridge.SiteCallAudit;

/// <summary>
/// Published on the actor system EventStream when a site's Site Call Audit
/// reconciliation puller transitions into or out of the "pinned" state — the
/// composite <c>(UpdatedAtUtc, TrackedOperationId)</c> keyset cursor could not
/// advance yet the site still reports <c>MoreAvailable=true</c>, so the backlog
/// tail cannot be drained. In practice this only happens against a legacy site
/// that ignores the <c>after_id</c> keyset field (a modern site drains a
/// single-timestamp burst via the id tiebreak). Mirrors
/// <c>SiteAuditTelemetryStalledChanged</c>: only transitions are published
/// (<c>Pinned=true</c> on latch, <c>Pinned=false</c> when progress resumes), so
/// a downstream health subscriber never sees a flood of redundant notifications.
/// The dead-end that the previous implementation only logged is now a
/// health-observable condition.
/// </summary>
/// <param name="SiteId">The site whose reconciliation cursor pinned (or unpinned).</param>
/// <param name="Pinned">True on entering the pinned state; false when the cursor makes progress again.</param>
public sealed record SiteCallReconciliationPinnedChanged(string SiteId, bool Pinned);