@camstack/addon-post-analysis 1.2.204 → 1.2.205

package/dist/pipeline-analytics/index.js

@@ -46115,6 +46115,8 @@ function detailsCarryEnrichment(details) {
 }
 /** Throttle for the per-device "detail call failed" warn — one line / minute. */
 var FAIL_WARN_THROTTLE_MS = 6e4;
+/** How often a camera reports the coasted frames its detail plane ignored (D397). */
+var COASTED_REPORT_INTERVAL_MS = 6e4;
 var TrackDetailDispatcher = class {
 	deps;
 	devices = /* @__PURE__ */ new Map();
@@ -46148,6 +46150,11 @@ var TrackDetailDispatcher = class {
 	*  already has state is never reset. */
 	onFrame(deviceId, trackId, announce, frame, nowMs) {
 		if (this.disposed) return;
+		if (frame.matchedThisFrame === false) {
+			const known = this.devices.get(deviceId);
+			if (known) known.coastedFramesIgnored += 1;
+			return;
+		}
 		const dev = this.devices.get(deviceId);
 		if (!dev || !dev.tracks.has(trackId)) {
 			if (announce.length > 0) this.onTrackStarted(deviceId, trackId, frame.className, announce, frame, nowMs);
@@ -46158,6 +46165,16 @@ var TrackDetailDispatcher = class {
 		const requests = dev.scheduler.onCandidateImproved(trackId, nowMs);
 		this.enqueue(deviceId, dev, requests);
 	}
+	/**
+	* Coasted frames ignored for one device since this dispatcher started.
+	*
+	* Exposed rather than logged from here: the dispatcher has no cadence of its
+	* own to report on, and the addon already emits a per-camera line where this
+	* belongs beside the numbers it explains.
+	*/
+	coastedFramesIgnored(deviceId) {
+		return this.devices.get(deviceId)?.coastedFramesIgnored ?? 0;
+	}
 	/** A track ended (durable TTL expiry): drop its scheduler + frame state. Any
 	*  queued request for it is discarded at dequeue. */
 	onTrackEnded(deviceId, trackId) {
@@ -46186,6 +46203,11 @@ var TrackDetailDispatcher = class {
 				tracks: /* @__PURE__ */ new Map(),
 				candidateBest: new BestDetectionTracker(CANDIDATE_IMPROVE_POLICY),
 				queue: [],
+				coastedFramesIgnored: 0,
+				coastedReportedAt: {
+					count: 0,
+					at: Date.now()
+				},
 				inFlight: 0,
 				timer: null,
 				lastFailWarnAt: 0,
@@ -46209,9 +46231,42 @@ var TrackDetailDispatcher = class {
 	}
 	tick(deviceId, dev) {
 		if (this.disposed) return;
-		const requests = dev.scheduler.tick(Date.now());
+		const now = Date.now();
+		this.reportCoasted(deviceId, dev, now);
+		const requests = dev.scheduler.tick(now);
 		this.enqueue(deviceId, dev, requests);
 	}
+	/**
+	* Say how many coasted frames this camera's detail plane ignored (D397),
+	* once per {@link COASTED_REPORT_INTERVAL_MS}, and only when there were any.
+	*
+	* Per camera and per interval rather than per frame: a coasting track offers
+	* one of these several times a second, and the question this answers is
+	* always "why is 617 worse than 615?".
+	*/
+	reportCoasted(deviceId, dev, now) {
+		const ignored = dev.coastedFramesIgnored - dev.coastedReportedAt.count;
+		if (ignored <= 0) {
+			dev.coastedReportedAt = {
+				count: dev.coastedFramesIgnored,
+				at: now
+			};
+			return;
+		}
+		if (now - dev.coastedReportedAt.at < COASTED_REPORT_INTERVAL_MS) return;
+		this.deps.logger.info("detail dispatch: coasted frames ignored — the subject was not observed in them", {
+			tags: { deviceId },
+			meta: {
+				ignored,
+				windowMs: now - dev.coastedReportedAt.at,
+				liveTracks: dev.tracks.size
+			}
+		});
+		dev.coastedReportedAt = {
+			count: dev.coastedFramesIgnored,
+			at: now
+		};
+	}
 	enqueue(deviceId, dev, requests) {
 		if (requests.length === 0) return;
 		for (const r of requests) dev.queue.push(r);
@@ -71666,6 +71721,7 @@ var PipelineAnalyticsAddon = class PipelineAnalyticsAddon extends require_dist.B
 					className: t.className,
 					confidence: t.confidence,
 					timestamp: result.timestamp,
+					...t.matchedThisFrame !== void 0 ? { matchedThisFrame: t.matchedThisFrame } : {},
 					...frameHandle !== void 0 ? {
 						frameHandle,
 						nodeId: frameHandle.nodeId

package/dist/pipeline-analytics/index.mjs

@@ -46041,6 +46041,8 @@ function detailsCarryEnrichment(details) {
 }
 /** Throttle for the per-device "detail call failed" warn — one line / minute. */
 var FAIL_WARN_THROTTLE_MS = 6e4;
+/** How often a camera reports the coasted frames its detail plane ignored (D397). */
+var COASTED_REPORT_INTERVAL_MS = 6e4;
 var TrackDetailDispatcher = class {
 	deps;
 	devices = /* @__PURE__ */ new Map();
@@ -46074,6 +46076,11 @@ var TrackDetailDispatcher = class {
 	*  already has state is never reset. */
 	onFrame(deviceId, trackId, announce, frame, nowMs) {
 		if (this.disposed) return;
+		if (frame.matchedThisFrame === false) {
+			const known = this.devices.get(deviceId);
+			if (known) known.coastedFramesIgnored += 1;
+			return;
+		}
 		const dev = this.devices.get(deviceId);
 		if (!dev || !dev.tracks.has(trackId)) {
 			if (announce.length > 0) this.onTrackStarted(deviceId, trackId, frame.className, announce, frame, nowMs);
@@ -46084,6 +46091,16 @@ var TrackDetailDispatcher = class {
 		const requests = dev.scheduler.onCandidateImproved(trackId, nowMs);
 		this.enqueue(deviceId, dev, requests);
 	}
+	/**
+	* Coasted frames ignored for one device since this dispatcher started.
+	*
+	* Exposed rather than logged from here: the dispatcher has no cadence of its
+	* own to report on, and the addon already emits a per-camera line where this
+	* belongs beside the numbers it explains.
+	*/
+	coastedFramesIgnored(deviceId) {
+		return this.devices.get(deviceId)?.coastedFramesIgnored ?? 0;
+	}
 	/** A track ended (durable TTL expiry): drop its scheduler + frame state. Any
 	*  queued request for it is discarded at dequeue. */
 	onTrackEnded(deviceId, trackId) {
@@ -46112,6 +46129,11 @@ var TrackDetailDispatcher = class {
 				tracks: /* @__PURE__ */ new Map(),
 				candidateBest: new BestDetectionTracker(CANDIDATE_IMPROVE_POLICY),
 				queue: [],
+				coastedFramesIgnored: 0,
+				coastedReportedAt: {
+					count: 0,
+					at: Date.now()
+				},
 				inFlight: 0,
 				timer: null,
 				lastFailWarnAt: 0,
@@ -46135,9 +46157,42 @@ var TrackDetailDispatcher = class {
 	}
 	tick(deviceId, dev) {
 		if (this.disposed) return;
-		const requests = dev.scheduler.tick(Date.now());
+		const now = Date.now();
+		this.reportCoasted(deviceId, dev, now);
+		const requests = dev.scheduler.tick(now);
 		this.enqueue(deviceId, dev, requests);
 	}
+	/**
+	* Say how many coasted frames this camera's detail plane ignored (D397),
+	* once per {@link COASTED_REPORT_INTERVAL_MS}, and only when there were any.
+	*
+	* Per camera and per interval rather than per frame: a coasting track offers
+	* one of these several times a second, and the question this answers is
+	* always "why is 617 worse than 615?".
+	*/
+	reportCoasted(deviceId, dev, now) {
+		const ignored = dev.coastedFramesIgnored - dev.coastedReportedAt.count;
+		if (ignored <= 0) {
+			dev.coastedReportedAt = {
+				count: dev.coastedFramesIgnored,
+				at: now
+			};
+			return;
+		}
+		if (now - dev.coastedReportedAt.at < COASTED_REPORT_INTERVAL_MS) return;
+		this.deps.logger.info("detail dispatch: coasted frames ignored — the subject was not observed in them", {
+			tags: { deviceId },
+			meta: {
+				ignored,
+				windowMs: now - dev.coastedReportedAt.at,
+				liveTracks: dev.tracks.size
+			}
+		});
+		dev.coastedReportedAt = {
+			count: dev.coastedFramesIgnored,
+			at: now
+		};
+	}
 	enqueue(deviceId, dev, requests) {
 		if (requests.length === 0) return;
 		for (const r of requests) dev.queue.push(r);
@@ -71592,6 +71647,7 @@ var PipelineAnalyticsAddon = class PipelineAnalyticsAddon extends BaseAddon {
 					className: t.className,
 					confidence: t.confidence,
 					timestamp: result.timestamp,
+					...t.matchedThisFrame !== void 0 ? { matchedThisFrame: t.matchedThisFrame } : {},
 					...frameHandle !== void 0 ? {
 						frameHandle,
 						nodeId: frameHandle.nodeId

package/package.json

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