feat: add acknowledgedAt timestamp to notification status.

docs/develop/rest-api/notifications_api.md

@@ -103,6 +103,7 @@ The remaining properties indicate the actions that **HAVE been taken**:
 
 - `silenced` - `true` when the silence action has been taken
 - `acknowledged` - `true` when the acknowledge action has been taken
+- `acknowledgedAt` - timestamp indicating when the acknowledge action was taken
 
 ## Taking Action
 
@@ -328,6 +329,7 @@ The result of a successful clear request is that the:
 - `state` value is set to `normal`
 - `status.silenced` is set to `false`
 - `status.acknowledged` is set to `false`
+- `status.acknowledgedAt` is not present
 
 If the clear action is requested when the `status.canClear` property is `false`, the alarm will not be cleared and an ERROR response is returned to the requestor.
 
@@ -480,6 +482,7 @@ _Notification: after successful `acknowledge` request_
    "status": {
       "silenced": true,
       "acknowledged": true,
+      "acknowledgedAt": "2026-04-06T03:34:48.203Z",
       "canSilence": true,
       "canAcknow;edge": true,
       "canClear": true

packages/server-api/src/deltas.ts

@@ -210,6 +210,7 @@ export enum ALARM_METHOD {
 export interface AlarmStatus {
   silenced: boolean
   acknowledged: boolean
+  acknowledgedAt?: Timestamp
   canSilence: boolean
   canAcknowledge: boolean
   canClear: boolean

packages/server-api/src/typebox/protocol-schemas.ts

@@ -117,6 +117,12 @@ export const AlarmStatusSchema = Type.Object(
     acknowledged: Type.Boolean({
       description: 'Whether the alarm has been acknowledged'
     }),
+    acknowledgedAt: Type.Optional(
+      Type.String({
+        pattern: IsoTimePattern,
+        description: 'ISO 8601 timestamp when the alarm was acknowledged'
+      })
+    ),
     canSilence: Type.Boolean({
       description: 'Whether the alarm can be silenced'
     }),

src/api/notifications/alarm.ts

@@ -105,6 +105,7 @@ export class Alarm {
       this.value.state !== ALARM_STATE.normal
     ) {
       this.status.acknowledged = false
+      delete this.status.acknowledgedAt
       this.status.silenced = false
     }
 
@@ -113,8 +114,13 @@ export class Alarm {
       this.value &&
       'acknowledgeStatus' in this.value
     ) {
-      this.status.acknowledged =
-        this.value.acknowledgeStatus === 'Yes' ? true : false
+      if (this.value.acknowledgeStatus === 'Yes') {
+        this.status.acknowledgedAt = new Date().toISOString() as Timestamp
+        this.status.acknowledged = true
+      } else {
+        this.status.acknowledged = false
+        delete this.status.acknowledgedAt
+      }
     }
     if (
       !this.status.silenced &&
@@ -228,6 +234,7 @@ export class Alarm {
       throw new Error('Alarm already acknowledged!')
     }
     this.status.acknowledged = true
+    this.status.acknowledgedAt = new Date().toISOString() as Timestamp
     this.alignAlarmMethod()
     this.timeStamp()
   }
@@ -239,6 +246,7 @@ export class Alarm {
     this.value.state = ALARM_STATE.normal
     this.status.silenced = false
     this.status.acknowledged = false
+    delete this.status.acknowledgedAt
     this.timeStamp()
   }
 }