From b07394447fe9667dc23784f1378f3bb14c09b586 Mon Sep 17 00:00:00 2001
From: Joseph Doherty <dohejw01@gmail.com>
Date: Fri, 11 Sep 2026 09:52:34 -0400
Subject: [PATCH] feat(commons): IsMesReportable on TemplateAlarm,
 ResolvedAlarm; IsMesReportableOverride on InstanceAlarmOverride

Claude-Session: https://claude.ai/code/session_01Y5ef34iUUMjmwnMpL9xgmB
---
 .../Entities/Instances/InstanceAlarmOverride.cs            | 5 +++++
 .../Entities/Templates/TemplateAlarm.cs                    | 7 +++++++
 .../Types/Flattening/FlattenedConfiguration.cs             | 2 ++
 3 files changed, 14 insertions(+)

diff --git a/src/ZB.MOM.WW.ScadaBridge.Commons/Entities/Instances/InstanceAlarmOverride.cs b/src/ZB.MOM.WW.ScadaBridge.Commons/Entities/Instances/InstanceAlarmOverride.cs
index b07eedeb..71650a90 100644
--- a/src/ZB.MOM.WW.ScadaBridge.Commons/Entities/Instances/InstanceAlarmOverride.cs
+++ b/src/ZB.MOM.WW.ScadaBridge.Commons/Entities/Instances/InstanceAlarmOverride.cs
@@ -43,6 +43,11 @@ public class InstanceAlarmOverride
     /// </summary>
     public int? PriorityLevelOverride { get; set; }
 
+    /// <summary>
+    /// Replaces the alarm's <c>IsMesReportable</c> flag when set. <c>null</c> = keep inherited.
+    /// </summary>
+    public bool? IsMesReportableOverride { get; set; }
+
     /// <summary>
     /// Initializes a new alarm override for the specified alarm.
     /// </summary>
diff --git a/src/ZB.MOM.WW.ScadaBridge.Commons/Entities/Templates/TemplateAlarm.cs b/src/ZB.MOM.WW.ScadaBridge.Commons/Entities/Templates/TemplateAlarm.cs
index baa80c3f..60413577 100644
--- a/src/ZB.MOM.WW.ScadaBridge.Commons/Entities/Templates/TemplateAlarm.cs
+++ b/src/ZB.MOM.WW.ScadaBridge.Commons/Entities/Templates/TemplateAlarm.cs
@@ -16,6 +16,13 @@ public class TemplateAlarm
     public int PriorityLevel { get; set; }
     /// <summary>When true, this alarm is locked and cannot be overridden in derived templates.</summary>
     public bool IsLocked { get; set; }
+    /// <summary>
+    /// When true, the alarm is reported to MES by the alarm-status API
+    /// (<c>IsFlaggedForMES</c> on the legacy contract). Default false. Overridable per
+    /// instance via <see cref="ZB.MOM.WW.ScadaBridge.Commons.Entities.Instances.InstanceAlarmOverride.IsMesReportableOverride"/>
+    /// unless the alarm is locked.
+    /// </summary>
+    public bool IsMesReportable { get; set; }
     /// <summary>Type of trigger condition that activates this alarm.</summary>
     public AlarmTriggerType TriggerType { get; set; }
     /// <summary>JSON-serialized trigger configuration specific to the <see cref="TriggerType"/>.</summary>
diff --git a/src/ZB.MOM.WW.ScadaBridge.Commons/Types/Flattening/FlattenedConfiguration.cs b/src/ZB.MOM.WW.ScadaBridge.Commons/Types/Flattening/FlattenedConfiguration.cs
index 6f468538..934a9a75 100644
--- a/src/ZB.MOM.WW.ScadaBridge.Commons/Types/Flattening/FlattenedConfiguration.cs
+++ b/src/ZB.MOM.WW.ScadaBridge.Commons/Types/Flattening/FlattenedConfiguration.cs
@@ -123,6 +123,8 @@ public sealed record ResolvedAlarm
     public int PriorityLevel { get; init; }
     /// <summary>Gets whether the alarm is locked.</summary>
     public bool IsLocked { get; init; }
+    /// <summary>Gets whether the alarm is reported to MES (template value after any instance override).</summary>
+    public bool IsMesReportable { get; init; }
     /// <summary>Gets the trigger type.</summary>
     public string TriggerType { get; init; } = string.Empty;