@camstack/addon-post-analysis 1.2.213 → 1.2.214

package/dist/pipeline-analytics/{_virtual_mf-localSharedImportMap___mfe_internal__addon_pipeline_analytics_widgets-CxVox7bu.mjs → _virtual_mf-localSharedImportMap___mfe_internal__addon_pipeline_analytics_widgets-TUlCd-Zk.mjs}

@@ -3,7 +3,7 @@ import "./dist-CYZr2fwk.mjs";
 var e = {
 	"@camstack/sdk": {
 		name: "@camstack/sdk",
-		version: "1.2.92",
+		version: "1.2.93",
 		scope: ["default"],
 		loaded: !1,
 		from: "addon_pipeline_analytics_widgets",
@@ -18,7 +18,7 @@ var e = {
 	},
 	"@camstack/types": {
 		name: "@camstack/types",
-		version: "1.2.172",
+		version: "1.2.173",
 		scope: ["default"],
 		loaded: !1,
 		from: "addon_pipeline_analytics_widgets",
@@ -33,7 +33,7 @@ var e = {
 	},
 	"@camstack/ui-library": {
 		name: "@camstack/ui-library",
-		version: "1.2.140",
+		version: "1.2.141",
 		scope: ["default"],
 		loaded: !1,
 		from: "addon_pipeline_analytics_widgets",

package/dist/pipeline-analytics/{hostInit-BSVhT9bi.mjs → hostInit-CN3MIGfb.mjs}

@@ -36,7 +36,7 @@ async function r() {
 				}
 			},
 			"@camstack/types": {
-				version: "1.2.172",
+				version: "1.2.173",
 				scope: "default",
 				shareConfig: {
 					singleton: !0,
@@ -45,7 +45,7 @@ async function r() {
 				}
 			},
 			"@camstack/sdk": {
-				version: "1.2.92",
+				version: "1.2.93",
 				scope: "default",
 				shareConfig: {
 					singleton: !0,
@@ -81,7 +81,7 @@ async function r() {
 				}
 			},
 			"@camstack/ui-library": {
-				version: "1.2.140",
+				version: "1.2.141",
 				scope: "default",
 				shareConfig: {
 					singleton: !0,

package/dist/pipeline-analytics/index.js

@@ -10,6 +10,7 @@ let node_path$1 = require_dist.__toESM(node_path, 1);
 node_path = require_dist.__toESM(node_path);
 let node_crypto = require("node:crypto");
 let node_child_process = require("node:child_process");
+let _camstack_system_addon_utils = require("@camstack/system/addon-utils");
 let sharp = require("sharp");
 sharp = require_dist.__toESM(sharp);
 let node_os = require("node:os");
@@ -49560,6 +49561,87 @@ var FaceRecognizer = class {
 		}
 	}
 };
+/** Read the window. Pure — this is the judgement the module exists to make. */
+function lagVerdict(report) {
+	const bus = report.busLagMaxMs;
+	if (bus === null) return "unknown";
+	return bus >= 5e3 ? "starved" : "delivered-on-time";
+}
+/** Does this window need an operator's eyes? Unknown never counts as alarming
+*  — that is the fabricated verdict D8 forbids. */
+function isAlarmingLagReport(report) {
+	const bus = report.busLagMaxMs;
+	const capture = report.captureLagMaxMs;
+	return bus !== null && bus >= 5e3 || capture !== null && capture >= 5e3;
+}
+/**
+* Folds per-frame delivery lag into per-device windows.
+*
+* Not a logger: it returns the line to write (or null) and the caller decides
+* level and tags. That keeps the throttle — the part that can wreck the frame
+* path — testable without a logger fake.
+*/
+var FrameLagObserver = class {
+	windows = /* @__PURE__ */ new Map();
+	/**
+	* Fold one inference result into `deviceId`'s window.
+	*
+	* @param now Receipt time, read by the caller once at handler entry.
+	* @param emittedAt Runner-side emit stamp; undefined ⇒ unknown (D8).
+	* @param capturedAt Frame shm-commit stamp; undefined ⇒ unknown.
+	* @returns The closed window when this frame ends one, else null.
+	*/
+	observe(deviceId, now, emittedAt, capturedAt) {
+		const existing = this.windows.get(deviceId);
+		const w = existing ?? {
+			startedAt: now,
+			frames: 0,
+			busMax: null,
+			busMin: null,
+			busUnknown: 0,
+			captureMax: null,
+			captureUnknown: 0
+		};
+		if (existing === void 0) this.windows.set(deviceId, w);
+		w.frames += 1;
+		if (typeof emittedAt === "number") {
+			const busLag = now - emittedAt;
+			if (w.busMax === null || busLag > w.busMax) w.busMax = busLag;
+			if (w.busMin === null || busLag < w.busMin) w.busMin = busLag;
+		} else w.busUnknown += 1;
+		if (typeof capturedAt === "number") {
+			const captureLag = now - capturedAt;
+			if (w.captureMax === null || captureLag > w.captureMax) w.captureMax = captureLag;
+		} else w.captureUnknown += 1;
+		if (existing !== void 0 && now - w.startedAt < 3e4) return null;
+		const report = {
+			deviceId,
+			frames: w.frames,
+			busLagMaxMs: w.busMax,
+			busLagMinMs: w.busMin,
+			busLagUnknownFrames: w.busUnknown,
+			captureLagMaxMs: w.captureMax,
+			captureLagUnknownFrames: w.captureUnknown,
+			windowMs: now - w.startedAt
+		};
+		w.startedAt = now;
+		w.frames = 0;
+		w.busMax = null;
+		w.busMin = null;
+		w.busUnknown = 0;
+		w.captureMax = null;
+		w.captureUnknown = 0;
+		return report;
+	}
+	/** Drop a device's window (unbound camera, shutdown). */
+	forget(deviceId) {
+		this.windows.delete(deviceId);
+	}
+	/** Drop every window. */
+	clear() {
+		this.windows.clear();
+	}
+};
 //#endregion
 //#region src/pipeline-analytics/location-aware-media-storage.ts
 /**
@@ -70729,6 +70811,22 @@ var PipelineAnalyticsAddon = class PipelineAnalyticsAddon extends require_dist.B
 	*  a ≤640 RAM fallback (`tier: 'ram-fullframe'`). Null until init completes. */
 	getNativeKeyFrameRgb = null;
 	shuttingDown = false;
+	/**
+	* Per-device delivery-lag windows, folded at `handleInferenceResult` entry.
+	* The instrument that tells a late DELIVERY (starved) apart from a slow
+	* `processFrame` (waiting) — see `frame-lag-observer.ts`. Costs one map read
+	* and ~10 numeric ops per frame, and writes one line per device per 30 s.
+	*/
+	frameLag = new FrameLagObserver();
+	/**
+	* Stops the GC-attributing stall monitor armed in {@link onInitialize}.
+	*
+	* The other half of the frame-lag line: that one says whether the events
+	* arrived late, this one says whether THIS loop was blocked while they did.
+	* The 5-minute `[mem]` heartbeat cannot see a 10 s freeze — it fired at
+	* dt = 300020 / 300066 / 299991 ms straight through the 2026-09-09 silences.
+	*/
+	stopStallMonitor = null;
 	/** True only on the cluster's designated post-processing node. When false the
 	*  addon subscribes to NOTHING — fully inert (no event/media generation). */
 	isPostProcessingNode = true;
@@ -70947,6 +71045,7 @@ var PipelineAnalyticsAddon = class PipelineAnalyticsAddon extends require_dist.B
 		super({});
 	}
 	async onInitialize() {
+		this.stopStallMonitor = (0, _camstack_system_addon_utils.startEventLoopStallMonitor)(this.ctx.logger);
 		const rawApi = this.ctx.api;
 		if (!rawApi) throw new Error("pipeline-analytics requires ctx.api (device-manager + settings-store)");
 		const api = censusApi(rawApi, this.readCensus);
@@ -73451,6 +73550,10 @@ var PipelineAnalyticsAddon = class PipelineAnalyticsAddon extends require_dist.B
 	}
 	async onShutdown() {
 		this.shuttingDown = true;
+		if (this.stopStallMonitor) {
+			this.stopStallMonitor();
+			this.stopStallMonitor = null;
+		}
 		this.sceneEngine?.stop();
 		this.sceneEngine = null;
 		if (this.sceneReloadTimer !== null) {
@@ -73495,6 +73598,7 @@ var PipelineAnalyticsAddon = class PipelineAnalyticsAddon extends require_dist.B
 		this.overlaySynthesisWarnAt.clear();
 		this.processors.clear();
 		this.lastActiveTrackIds.clear();
+		this.frameLag.clear();
 		this.lastFrameDimsByDevice.clear();
 		this.dropoutSkipsByKey.clear();
 		this.residents.clearAll();
@@ -73534,6 +73638,23 @@ var PipelineAnalyticsAddon = class PipelineAnalyticsAddon extends require_dist.B
 	async handleInferenceResult(data) {
 		if (this.shuttingDown) return;
 		const { deviceId, frame } = data;
+		const lag = this.frameLag.observe(deviceId, Date.now(), data.emittedAt, data.capturedAt);
+		if (lag !== null) {
+			const verdict = lagVerdict(lag);
+			(isAlarmingLagReport(lag) ? this.ctx.logger.warn.bind(this.ctx.logger) : this.ctx.logger.info.bind(this.ctx.logger))("pipeline-analytics frame lag", {
+				tags: { deviceId },
+				meta: {
+					verdict,
+					frames: lag.frames,
+					windowMs: lag.windowMs,
+					busLagMaxMs: lag.busLagMaxMs,
+					busLagMinMs: lag.busLagMinMs,
+					busLagUnknownFrames: lag.busLagUnknownFrames,
+					captureLagMaxMs: lag.captureLagMaxMs,
+					captureLagUnknownFrames: lag.captureLagUnknownFrames
+				}
+			});
+		}
 		await this.processFrame(deviceId, frame, "pipeline", data.frameHandle, data.detailSteps);
 	}
 	/**

package/dist/pipeline-analytics/index.mjs

@@ -6,6 +6,7 @@ import * as path$1 from "node:path";
 import path from "node:path";
 import { createHash, createHmac, randomUUID, timingSafeEqual } from "node:crypto";
 import { execFile } from "node:child_process";
+import { startEventLoopStallMonitor } from "@camstack/system/addon-utils";
 import sharp from "sharp";
 import os from "node:os";
 import { Buffer as Buffer$1 } from "node:buffer";
@@ -49486,6 +49487,87 @@ var FaceRecognizer = class {
 		}
 	}
 };
+/** Read the window. Pure — this is the judgement the module exists to make. */
+function lagVerdict(report) {
+	const bus = report.busLagMaxMs;
+	if (bus === null) return "unknown";
+	return bus >= 5e3 ? "starved" : "delivered-on-time";
+}
+/** Does this window need an operator's eyes? Unknown never counts as alarming
+*  — that is the fabricated verdict D8 forbids. */
+function isAlarmingLagReport(report) {
+	const bus = report.busLagMaxMs;
+	const capture = report.captureLagMaxMs;
+	return bus !== null && bus >= 5e3 || capture !== null && capture >= 5e3;
+}
+/**
+* Folds per-frame delivery lag into per-device windows.
+*
+* Not a logger: it returns the line to write (or null) and the caller decides
+* level and tags. That keeps the throttle — the part that can wreck the frame
+* path — testable without a logger fake.
+*/
+var FrameLagObserver = class {
+	windows = /* @__PURE__ */ new Map();
+	/**
+	* Fold one inference result into `deviceId`'s window.
+	*
+	* @param now Receipt time, read by the caller once at handler entry.
+	* @param emittedAt Runner-side emit stamp; undefined ⇒ unknown (D8).
+	* @param capturedAt Frame shm-commit stamp; undefined ⇒ unknown.
+	* @returns The closed window when this frame ends one, else null.
+	*/
+	observe(deviceId, now, emittedAt, capturedAt) {
+		const existing = this.windows.get(deviceId);
+		const w = existing ?? {
+			startedAt: now,
+			frames: 0,
+			busMax: null,
+			busMin: null,
+			busUnknown: 0,
+			captureMax: null,
+			captureUnknown: 0
+		};
+		if (existing === void 0) this.windows.set(deviceId, w);
+		w.frames += 1;
+		if (typeof emittedAt === "number") {
+			const busLag = now - emittedAt;
+			if (w.busMax === null || busLag > w.busMax) w.busMax = busLag;
+			if (w.busMin === null || busLag < w.busMin) w.busMin = busLag;
+		} else w.busUnknown += 1;
+		if (typeof capturedAt === "number") {
+			const captureLag = now - capturedAt;
+			if (w.captureMax === null || captureLag > w.captureMax) w.captureMax = captureLag;
+		} else w.captureUnknown += 1;
+		if (existing !== void 0 && now - w.startedAt < 3e4) return null;
+		const report = {
+			deviceId,
+			frames: w.frames,
+			busLagMaxMs: w.busMax,
+			busLagMinMs: w.busMin,
+			busLagUnknownFrames: w.busUnknown,
+			captureLagMaxMs: w.captureMax,
+			captureLagUnknownFrames: w.captureUnknown,
+			windowMs: now - w.startedAt
+		};
+		w.startedAt = now;
+		w.frames = 0;
+		w.busMax = null;
+		w.busMin = null;
+		w.busUnknown = 0;
+		w.captureMax = null;
+		w.captureUnknown = 0;
+		return report;
+	}
+	/** Drop a device's window (unbound camera, shutdown). */
+	forget(deviceId) {
+		this.windows.delete(deviceId);
+	}
+	/** Drop every window. */
+	clear() {
+		this.windows.clear();
+	}
+};
 //#endregion
 //#region src/pipeline-analytics/location-aware-media-storage.ts
 /**
@@ -70655,6 +70737,22 @@ var PipelineAnalyticsAddon = class PipelineAnalyticsAddon extends BaseAddon {
 	*  a ≤640 RAM fallback (`tier: 'ram-fullframe'`). Null until init completes. */
 	getNativeKeyFrameRgb = null;
 	shuttingDown = false;
+	/**
+	* Per-device delivery-lag windows, folded at `handleInferenceResult` entry.
+	* The instrument that tells a late DELIVERY (starved) apart from a slow
+	* `processFrame` (waiting) — see `frame-lag-observer.ts`. Costs one map read
+	* and ~10 numeric ops per frame, and writes one line per device per 30 s.
+	*/
+	frameLag = new FrameLagObserver();
+	/**
+	* Stops the GC-attributing stall monitor armed in {@link onInitialize}.
+	*
+	* The other half of the frame-lag line: that one says whether the events
+	* arrived late, this one says whether THIS loop was blocked while they did.
+	* The 5-minute `[mem]` heartbeat cannot see a 10 s freeze — it fired at
+	* dt = 300020 / 300066 / 299991 ms straight through the 2026-09-09 silences.
+	*/
+	stopStallMonitor = null;
 	/** True only on the cluster's designated post-processing node. When false the
 	*  addon subscribes to NOTHING — fully inert (no event/media generation). */
 	isPostProcessingNode = true;
@@ -70873,6 +70971,7 @@ var PipelineAnalyticsAddon = class PipelineAnalyticsAddon extends BaseAddon {
 		super({});
 	}
 	async onInitialize() {
+		this.stopStallMonitor = startEventLoopStallMonitor(this.ctx.logger);
 		const rawApi = this.ctx.api;
 		if (!rawApi) throw new Error("pipeline-analytics requires ctx.api (device-manager + settings-store)");
 		const api = censusApi(rawApi, this.readCensus);
@@ -73377,6 +73476,10 @@ var PipelineAnalyticsAddon = class PipelineAnalyticsAddon extends BaseAddon {
 	}
 	async onShutdown() {
 		this.shuttingDown = true;
+		if (this.stopStallMonitor) {
+			this.stopStallMonitor();
+			this.stopStallMonitor = null;
+		}
 		this.sceneEngine?.stop();
 		this.sceneEngine = null;
 		if (this.sceneReloadTimer !== null) {
@@ -73421,6 +73524,7 @@ var PipelineAnalyticsAddon = class PipelineAnalyticsAddon extends BaseAddon {
 		this.overlaySynthesisWarnAt.clear();
 		this.processors.clear();
 		this.lastActiveTrackIds.clear();
+		this.frameLag.clear();
 		this.lastFrameDimsByDevice.clear();
 		this.dropoutSkipsByKey.clear();
 		this.residents.clearAll();
@@ -73460,6 +73564,23 @@ var PipelineAnalyticsAddon = class PipelineAnalyticsAddon extends BaseAddon {
 	async handleInferenceResult(data) {
 		if (this.shuttingDown) return;
 		const { deviceId, frame } = data;
+		const lag = this.frameLag.observe(deviceId, Date.now(), data.emittedAt, data.capturedAt);
+		if (lag !== null) {
+			const verdict = lagVerdict(lag);
+			(isAlarmingLagReport(lag) ? this.ctx.logger.warn.bind(this.ctx.logger) : this.ctx.logger.info.bind(this.ctx.logger))("pipeline-analytics frame lag", {
+				tags: { deviceId },
+				meta: {
+					verdict,
+					frames: lag.frames,
+					windowMs: lag.windowMs,
+					busLagMaxMs: lag.busLagMaxMs,
+					busLagMinMs: lag.busLagMinMs,
+					busLagUnknownFrames: lag.busLagUnknownFrames,
+					captureLagMaxMs: lag.captureLagMaxMs,
+					captureLagUnknownFrames: lag.captureLagUnknownFrames
+				}
+			});
+		}
 		await this.processFrame(deviceId, frame, "pipeline", data.frameHandle, data.detailSteps);
 	}
 	/**

package/dist/pipeline-analytics/remoteEntry.js

@@ -30,7 +30,7 @@ async function d(e) {
 	}
 }
 async function f() {
-	return l ||= d(() => import("./_virtual_mf-localSharedImportMap___mfe_internal__addon_pipeline_analytics_widgets-CxVox7bu.mjs")).catch((e) => {
+	return l ||= d(() => import("./_virtual_mf-localSharedImportMap___mfe_internal__addon_pipeline_analytics_widgets-TUlCd-Zk.mjs")).catch((e) => {
 		throw l = void 0, e;
 	}), l;
 }

package/package.json

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