@camstack/addon-post-analysis 1.2.652 → 1.2.653

package/CHANGELOG.md

@@ -7,6 +7,12 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [1.2.653] - 2026-10-30
+
+### Changed
+
+- A node that announced an update is no longer reported offline for 10 minutes; if it comes back nothing is sent, otherwise the offline says it went down while updating
+
 ## [1.2.652] - 2026-10-29
 
 ### Changed

package/dist/pipeline-analytics/index.js

@@ -9063,6 +9063,7 @@ var en_default = {
 	"system.node-offline.body.agent": "Agent {{nodeName}} is offline",
 	"system.node-offline.body.agent.connection-lost": "Agent {{nodeName}} lost its connection to the hub",
 	"system.node-offline.body.agent.shutdown": "Agent {{nodeName}} shut down",
+	"system.node-offline.body.agent.updating": "Agent {{nodeName}} went offline while updating and has not come back after {{graceMin}} minutes",
 	"system.node-inference-unavailable.title": "Node cannot infer — {{nodeId}}",
 	"system.node-inference-unavailable.body": "Node {{nodeId}} can no longer run inference — every enabled device is unavailable ({{devices}}). It will not receive cameras until one returns.",
 	"system.addon-crash-loop.title": "Addon crash-loop — {{nodeId}}",
@@ -9467,6 +9468,7 @@ var it_default = {
 	"system.node-offline.body.agent": "L'agent {{nodeName}} è offline",
 	"system.node-offline.body.agent.connection-lost": "L'agent {{nodeName}} ha perso la connessione con l'hub",
 	"system.node-offline.body.agent.shutdown": "L'agent {{nodeName}} si è spento",
+	"system.node-offline.body.agent.updating": "L'agent {{nodeName}} è andato offline durante un aggiornamento e non è tornato dopo {{graceMin}} minuti",
 	"system.node-inference-unavailable.title": "Nodo senza inferenza — {{nodeId}}",
 	"system.node-inference-unavailable.body": "Il nodo {{nodeId}} non può più eseguire inferenza — tutti i dispositivi abilitati non sono disponibili ({{devices}}). Non riceverà camere finché uno non torna disponibile.",
 	"system.addon-crash-loop.title": "Crash-loop addon — {{nodeId}}",
@@ -90273,13 +90275,17 @@ var DeviceLivenessHoldoff = class {
 	rememberIfAbsent(subject, state) {
 		if (!this.lastNotified.has(subject)) this.lastNotified.set(subject, state);
 	}
-	/** A real ledger flip. Starts / resets the trailing timer. */
-	arm(subject, incoming) {
+	/**
+	* A real ledger flip. Starts / resets the trailing timer. `delayMs` replaces
+	* the default delay for THIS arm only (a node's planned-update grace).
+	*/
+	arm(subject, incoming, delayMs) {
+		const delay = delayMs ?? this.delayMs;
 		this.pending.set(subject, incoming);
 		this.trackDeparture(subject, incoming);
 		const existing = this.timers.get(subject);
 		if (existing !== void 0) this.cancel(existing);
-		if (this.delayMs <= 0) {
+		if (delay <= 0) {
 			this.timers.delete(subject);
 			this.fire(subject);
 			return;
@@ -90287,7 +90293,7 @@ var DeviceLivenessHoldoff = class {
 		const id = this.schedule(() => {
 			this.timers.delete(subject);
 			this.fire(subject);
-		}, this.delayMs);
+		}, delay);
 		this.timers.set(subject, id);
 	}
 	dispose() {
@@ -92934,6 +92940,71 @@ var NcRuleStore = class NcRuleStore {
 	}
 };
 //#endregion
+//#region src/notification-center/planned-update-window.ts
+/**
+* A node that ANNOUNCED an update is expected to go offline — the window that
+* says so lives here.
+*
+* `system.restarting` becomes `node-updating` / `node-restarting`; the centre
+* records the announcement per node (RAM, refreshed by the event, never by a
+* read — D49). An offline for that node inside {@link PLANNED_UPDATE_OFFLINE_GRACE_MS}
+* of the announcement is held for the whole window instead of the usual 60 s
+* hold-off: back in time means no offline notification at all, not back means
+* one offline that says it happened during an update. A lost announcement
+* (events may be dropped, D8) simply behaves as before.
+*/
+/** How long after an announcement an offline is held, and how long the announcement counts. */
+var PLANNED_UPDATE_OFFLINE_GRACE_MS = 10 * 6e4;
+var NC_PLANNED_UPDATE_NODES_MAX = 256;
+var NcPlannedUpdateWindow = class {
+	graceMs;
+	/** Insertion-ordered: the oldest node is evicted first. */
+	announcedAt = /* @__PURE__ */ new Map();
+	/** When an offline was put on hold, per node. */
+	heldAt = /* @__PURE__ */ new Map();
+	constructor(graceMs = PLANNED_UPDATE_OFFLINE_GRACE_MS) {
+		this.graceMs = graceMs;
+	}
+	get windowMs() {
+		return this.graceMs;
+	}
+	get graceMinutes() {
+		return Math.round(this.graceMs / 6e4);
+	}
+	/** Feed every system subject the intake accepted; only the two announcements are kept. */
+	observe(system, atMs) {
+		if (system.kind !== "node-updating" && system.kind !== "node-restarting") return;
+		const nodeId = system.nodeId;
+		if (nodeId === void 0) return;
+		this.announcedAt.delete(nodeId);
+		this.announcedAt.set(nodeId, atMs);
+		while (this.announcedAt.size > NC_PLANNED_UPDATE_NODES_MAX) {
+			const oldest = this.announcedAt.keys().next();
+			if (oldest.done === true) break;
+			this.announcedAt.delete(oldest.value);
+		}
+	}
+	/** True when the node announced an update no longer than the window ago. */
+	isPlanned(nodeId, atMs) {
+		const at = this.announcedAt.get(nodeId);
+		return at !== void 0 && atMs - at <= this.graceMs;
+	}
+	/** An offline was put on hold for this node. */
+	hold(nodeId, atMs) {
+		this.heldAt.set(nodeId, atMs);
+	}
+	/**
+	* The node is back: seconds the held offline lasted, or `null` when no offline
+	* was held, or its window already ran out (the offline was sent).
+	*/
+	release(nodeId, atMs) {
+		const at = this.heldAt.get(nodeId);
+		if (at === void 0) return null;
+		this.heldAt.delete(nodeId);
+		return atMs - at < this.graceMs ? Math.round((atMs - at) / 1e3) : null;
+	}
+};
+//#endregion
 //#region src/notification-center/restart-supersede.ts
 /** How many landings are remembered — one per node per update, so a fleet's worth. */
 var NC_UPDATE_LANDINGS_MAX = 256;
@@ -101894,6 +101965,7 @@ function onSystemEvent(host, event) {
 	const system = incoming.subject.systemEvent;
 	if (system !== void 0) host.stateSummary.observeSystem(system, host.now());
 	if (system !== void 0) host.updateLandings.observe(system, host.now());
+	if (system !== void 0) host.plannedUpdates.observe(system, host.now());
 	const observation = system !== void 0 ? ledgeredLiveness(system) : null;
 	if (observation !== null) {
 		const previous = host.liveness.stateOf(observation.subject);
@@ -101920,7 +101992,11 @@ function onSystemEvent(host, event) {
 			});
 			return;
 		}
-		if (isDeviceLivenessKind(observation.kind) || isNodeLivenessKind(observation.kind)) {
+		if (isNodeLivenessKind(observation.kind) && system !== void 0) {
+			armNodeLiveness(host, holdoff, observation.subject, incoming, system);
+			return;
+		}
+		if (isDeviceLivenessKind(observation.kind)) {
 			holdoff.arm(observation.subject, incoming);
 			return;
 		}
@@ -101931,6 +102007,50 @@ function onSystemEvent(host, event) {
 	host.consumeEvent(incoming);
 }
 /**
+* Arm a node liveness flip. An OFFLINE of a node that announced an update is
+* held for the whole planned-update window and worded as such if it is still
+* sent; the node's return inside the window is logged and sends nothing (the
+* hold-off sees the state bounce back to the one last notified).
+*/
+function armNodeLiveness(host, holdoff, subject, incoming, system) {
+	const nodeId = system.nodeId;
+	const now = host.now();
+	if (nodeId === void 0) {
+		holdoff.arm(subject, incoming);
+		return;
+	}
+	const window = host.plannedUpdates;
+	if (system.kind === "node-offline" && window.isPlanned(nodeId, now)) {
+		window.hold(nodeId, now);
+		holdoff.arm(subject, withPlannedUpdateWording(incoming, system, window.graceMinutes), window.windowMs);
+		return;
+	}
+	if (system.kind === "node-online") {
+		const backAfterSec = window.release(nodeId, now);
+		if (backAfterSec !== null) host.logger.info(`node ${nodeId}: offline suppressed: planned update, back after ${backAfterSec}s`, { meta: {
+			nodeId,
+			backAfterSec
+		} });
+	}
+	holdoff.arm(subject, incoming);
+}
+function withPlannedUpdateWording(incoming, system, graceMin) {
+	return {
+		...incoming,
+		subject: {
+			...incoming.subject,
+			systemEvent: {
+				...system,
+				bodyKey: "system.node-offline.body.agent.updating",
+				textParams: {
+					...system.textParams,
+					graceMin: String(graceMin)
+				}
+			}
+		}
+	};
+}
+/**
 * One edge of an alert episode, from the bus or from the reconcile. The
 * ledger decides whether it is news; only news reaches the rules.
 */
@@ -105749,6 +105869,7 @@ var NotificationCenter = class {
 	stateSummary;
 	/** Every `server-updated` heard, so a stale `node-updating` is not sent after it (D723). */
 	updateLandings = new NcUpdateLandings();
+	plannedUpdates = new NcPlannedUpdateWindow();
 	/** States the `deviceState` rule gate reads. Refreshed on the reload tick;
 	*  read with no I/O on the persist hook. */
 	deviceStates;
@@ -107141,6 +107262,9 @@ var NotificationCenter = class {
 			get timelapseRules() {
 				return self.timelapseRules;
 			},
+			get plannedUpdates() {
+				return self.plannedUpdates;
+			},
 			get updateLandings() {
 				return self.updateLandings;
 			},

package/dist/pipeline-analytics/index.mjs

@@ -9055,6 +9055,7 @@ var en_default = {
 	"system.node-offline.body.agent": "Agent {{nodeName}} is offline",
 	"system.node-offline.body.agent.connection-lost": "Agent {{nodeName}} lost its connection to the hub",
 	"system.node-offline.body.agent.shutdown": "Agent {{nodeName}} shut down",
+	"system.node-offline.body.agent.updating": "Agent {{nodeName}} went offline while updating and has not come back after {{graceMin}} minutes",
 	"system.node-inference-unavailable.title": "Node cannot infer — {{nodeId}}",
 	"system.node-inference-unavailable.body": "Node {{nodeId}} can no longer run inference — every enabled device is unavailable ({{devices}}). It will not receive cameras until one returns.",
 	"system.addon-crash-loop.title": "Addon crash-loop — {{nodeId}}",
@@ -9459,6 +9460,7 @@ var it_default = {
 	"system.node-offline.body.agent": "L'agent {{nodeName}} è offline",
 	"system.node-offline.body.agent.connection-lost": "L'agent {{nodeName}} ha perso la connessione con l'hub",
 	"system.node-offline.body.agent.shutdown": "L'agent {{nodeName}} si è spento",
+	"system.node-offline.body.agent.updating": "L'agent {{nodeName}} è andato offline durante un aggiornamento e non è tornato dopo {{graceMin}} minuti",
 	"system.node-inference-unavailable.title": "Nodo senza inferenza — {{nodeId}}",
 	"system.node-inference-unavailable.body": "Il nodo {{nodeId}} non può più eseguire inferenza — tutti i dispositivi abilitati non sono disponibili ({{devices}}). Non riceverà camere finché uno non torna disponibile.",
 	"system.addon-crash-loop.title": "Crash-loop addon — {{nodeId}}",
@@ -90178,13 +90180,17 @@ var DeviceLivenessHoldoff = class {
 	rememberIfAbsent(subject, state) {
 		if (!this.lastNotified.has(subject)) this.lastNotified.set(subject, state);
 	}
-	/** A real ledger flip. Starts / resets the trailing timer. */
-	arm(subject, incoming) {
+	/**
+	* A real ledger flip. Starts / resets the trailing timer. `delayMs` replaces
+	* the default delay for THIS arm only (a node's planned-update grace).
+	*/
+	arm(subject, incoming, delayMs) {
+		const delay = delayMs ?? this.delayMs;
 		this.pending.set(subject, incoming);
 		this.trackDeparture(subject, incoming);
 		const existing = this.timers.get(subject);
 		if (existing !== void 0) this.cancel(existing);
-		if (this.delayMs <= 0) {
+		if (delay <= 0) {
 			this.timers.delete(subject);
 			this.fire(subject);
 			return;
@@ -90192,7 +90198,7 @@ var DeviceLivenessHoldoff = class {
 		const id = this.schedule(() => {
 			this.timers.delete(subject);
 			this.fire(subject);
-		}, this.delayMs);
+		}, delay);
 		this.timers.set(subject, id);
 	}
 	dispose() {
@@ -92839,6 +92845,71 @@ var NcRuleStore = class NcRuleStore {
 	}
 };
 //#endregion
+//#region src/notification-center/planned-update-window.ts
+/**
+* A node that ANNOUNCED an update is expected to go offline — the window that
+* says so lives here.
+*
+* `system.restarting` becomes `node-updating` / `node-restarting`; the centre
+* records the announcement per node (RAM, refreshed by the event, never by a
+* read — D49). An offline for that node inside {@link PLANNED_UPDATE_OFFLINE_GRACE_MS}
+* of the announcement is held for the whole window instead of the usual 60 s
+* hold-off: back in time means no offline notification at all, not back means
+* one offline that says it happened during an update. A lost announcement
+* (events may be dropped, D8) simply behaves as before.
+*/
+/** How long after an announcement an offline is held, and how long the announcement counts. */
+var PLANNED_UPDATE_OFFLINE_GRACE_MS = 10 * 6e4;
+var NC_PLANNED_UPDATE_NODES_MAX = 256;
+var NcPlannedUpdateWindow = class {
+	graceMs;
+	/** Insertion-ordered: the oldest node is evicted first. */
+	announcedAt = /* @__PURE__ */ new Map();
+	/** When an offline was put on hold, per node. */
+	heldAt = /* @__PURE__ */ new Map();
+	constructor(graceMs = PLANNED_UPDATE_OFFLINE_GRACE_MS) {
+		this.graceMs = graceMs;
+	}
+	get windowMs() {
+		return this.graceMs;
+	}
+	get graceMinutes() {
+		return Math.round(this.graceMs / 6e4);
+	}
+	/** Feed every system subject the intake accepted; only the two announcements are kept. */
+	observe(system, atMs) {
+		if (system.kind !== "node-updating" && system.kind !== "node-restarting") return;
+		const nodeId = system.nodeId;
+		if (nodeId === void 0) return;
+		this.announcedAt.delete(nodeId);
+		this.announcedAt.set(nodeId, atMs);
+		while (this.announcedAt.size > NC_PLANNED_UPDATE_NODES_MAX) {
+			const oldest = this.announcedAt.keys().next();
+			if (oldest.done === true) break;
+			this.announcedAt.delete(oldest.value);
+		}
+	}
+	/** True when the node announced an update no longer than the window ago. */
+	isPlanned(nodeId, atMs) {
+		const at = this.announcedAt.get(nodeId);
+		return at !== void 0 && atMs - at <= this.graceMs;
+	}
+	/** An offline was put on hold for this node. */
+	hold(nodeId, atMs) {
+		this.heldAt.set(nodeId, atMs);
+	}
+	/**
+	* The node is back: seconds the held offline lasted, or `null` when no offline
+	* was held, or its window already ran out (the offline was sent).
+	*/
+	release(nodeId, atMs) {
+		const at = this.heldAt.get(nodeId);
+		if (at === void 0) return null;
+		this.heldAt.delete(nodeId);
+		return atMs - at < this.graceMs ? Math.round((atMs - at) / 1e3) : null;
+	}
+};
+//#endregion
 //#region src/notification-center/restart-supersede.ts
 /** How many landings are remembered — one per node per update, so a fleet's worth. */
 var NC_UPDATE_LANDINGS_MAX = 256;
@@ -101799,6 +101870,7 @@ function onSystemEvent(host, event) {
 	const system = incoming.subject.systemEvent;
 	if (system !== void 0) host.stateSummary.observeSystem(system, host.now());
 	if (system !== void 0) host.updateLandings.observe(system, host.now());
+	if (system !== void 0) host.plannedUpdates.observe(system, host.now());
 	const observation = system !== void 0 ? ledgeredLiveness(system) : null;
 	if (observation !== null) {
 		const previous = host.liveness.stateOf(observation.subject);
@@ -101825,7 +101897,11 @@ function onSystemEvent(host, event) {
 			});
 			return;
 		}
-		if (isDeviceLivenessKind(observation.kind) || isNodeLivenessKind(observation.kind)) {
+		if (isNodeLivenessKind(observation.kind) && system !== void 0) {
+			armNodeLiveness(host, holdoff, observation.subject, incoming, system);
+			return;
+		}
+		if (isDeviceLivenessKind(observation.kind)) {
 			holdoff.arm(observation.subject, incoming);
 			return;
 		}
@@ -101836,6 +101912,50 @@ function onSystemEvent(host, event) {
 	host.consumeEvent(incoming);
 }
 /**
+* Arm a node liveness flip. An OFFLINE of a node that announced an update is
+* held for the whole planned-update window and worded as such if it is still
+* sent; the node's return inside the window is logged and sends nothing (the
+* hold-off sees the state bounce back to the one last notified).
+*/
+function armNodeLiveness(host, holdoff, subject, incoming, system) {
+	const nodeId = system.nodeId;
+	const now = host.now();
+	if (nodeId === void 0) {
+		holdoff.arm(subject, incoming);
+		return;
+	}
+	const window = host.plannedUpdates;
+	if (system.kind === "node-offline" && window.isPlanned(nodeId, now)) {
+		window.hold(nodeId, now);
+		holdoff.arm(subject, withPlannedUpdateWording(incoming, system, window.graceMinutes), window.windowMs);
+		return;
+	}
+	if (system.kind === "node-online") {
+		const backAfterSec = window.release(nodeId, now);
+		if (backAfterSec !== null) host.logger.info(`node ${nodeId}: offline suppressed: planned update, back after ${backAfterSec}s`, { meta: {
+			nodeId,
+			backAfterSec
+		} });
+	}
+	holdoff.arm(subject, incoming);
+}
+function withPlannedUpdateWording(incoming, system, graceMin) {
+	return {
+		...incoming,
+		subject: {
+			...incoming.subject,
+			systemEvent: {
+				...system,
+				bodyKey: "system.node-offline.body.agent.updating",
+				textParams: {
+					...system.textParams,
+					graceMin: String(graceMin)
+				}
+			}
+		}
+	};
+}
+/**
 * One edge of an alert episode, from the bus or from the reconcile. The
 * ledger decides whether it is news; only news reaches the rules.
 */
@@ -105654,6 +105774,7 @@ var NotificationCenter = class {
 	stateSummary;
 	/** Every `server-updated` heard, so a stale `node-updating` is not sent after it (D723). */
 	updateLandings = new NcUpdateLandings();
+	plannedUpdates = new NcPlannedUpdateWindow();
 	/** States the `deviceState` rule gate reads. Refreshed on the reload tick;
 	*  read with no I/O on the persist hook. */
 	deviceStates;
@@ -107046,6 +107167,9 @@ var NotificationCenter = class {
 			get timelapseRules() {
 				return self.timelapseRules;
 			},
+			get plannedUpdates() {
+				return self.plannedUpdates;
+			},
 			get updateLandings() {
 				return self.updateLandings;
 			},

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@camstack/addon-post-analysis",
-  "version": "1.2.652",
+  "version": "1.2.653",
   "description": "Post-Analysis bundle — enrichment, embedding-encoder, pipeline-analytics. Multi-entry npm package shipping addons that consume pipeline output.",
   "keywords": [
     "camstack",