@camstack/addon-post-analysis 1.2.177 → 1.2.178

package/dist/pipeline-analytics/index.js

@@ -35839,16 +35839,43 @@ function positionsIntersectZone(positions, frameWidth, frameHeight, zone) {
 	}, zone.points)) return true;
 	return false;
 }
+//#endregion
+//#region src/pipeline-analytics/track-lifecycle.ts
+/** Minimum confidence increase (vs last emit) that counts as a material
+*  improvement. */
+var UPDATE_MIN_CONF_DELTA = .1;
+/** Debounce floor between two `update` emits for the same track (ms). */
+var UPDATE_MIN_INTERVAL_MS = 4e3;
+/** Minimum fractional bbox-area growth (vs last emit) counted as a
+*  materially larger representative crop (e.g. 0.15 = 15% bigger). */
+var UPDATE_MIN_CROP_AREA_GROWTH = .15;
+/**
+* The label a `phase:'update'` SIGNAL and PAYLOAD carry, resolved from its
+* two possible sources in order: this frame's tiered patch (the frame path
+* wrote a label this very frame), then the track ROW's stored display label
+* (`subLabel ?? label`, as `trackStore.peekActive` exposes it).
+*
+* The fallback is not a nicety. The face recognizer assigns an identity over
+* the async detail plane and writes it to the row (`applyLabelCandidate`) —
+* never into a frame patch — so a signal reading only the patch can never
+* fire the identity trigger for a recognised face. Measured on the live hub
+* (2026-09-05, device 590): six of six face identities reached Home
+* Assistant only on the `end` event at track close + sweep (~lastSeen+33 s),
+* zero during the track's life, while the subject was still on camera.
+*/
+function resolveLifecycleUpdateLabel(labelPatch, storedDisplayLabel) {
+	return patchDisplayLabel(labelPatch) ?? storedDisplayLabel;
+}
 var DEFAULT_UPDATE_GATE_CONFIG = {
-	minConfDelta: .1,
-	minIntervalMs: 4e3,
-	minCropAreaGrowth: .15
+	minConfDelta: UPDATE_MIN_CONF_DELTA,
+	minIntervalMs: UPDATE_MIN_INTERVAL_MS,
+	minCropAreaGrowth: UPDATE_MIN_CROP_AREA_GROWTH
 };
 /**
 * Decide whether a `phase:'update'` event should fire this frame.
 *
 * Priority of triggers: newly-resolved identity/plate > confidence
-* improvement > materially larger crop. All triggers are debounced by
+* improvement > newly-entered zone > materially larger crop. All triggers are debounced by
 * `minIntervalMs` relative to the last emit. Deltas are measured against
 * the LAST-EMITTED memory, so a run of sub-threshold new-bests accumulates
 * and fires once it crosses `minConfDelta`.
@@ -35856,22 +35883,32 @@ var DEFAULT_UPDATE_GATE_CONFIG = {
 function evaluateTrackLifecycleUpdate(signal, memory, config) {
 	const identityTrigger = signal.label !== void 0 && signal.label !== "" && (memory === void 0 || memory.lastLabel !== signal.label);
 	const confidenceTrigger = signal.isNewBest && (memory === void 0 || signal.confidence - memory.lastConfidence >= config.minConfDelta);
+	const zoneTrigger = signal.zonesVisitedCount !== void 0 && memory?.lastZonesVisitedCount !== void 0 && signal.zonesVisitedCount > memory.lastZonesVisitedCount;
 	const cropTrigger = signal.bboxArea !== void 0 && memory?.lastBboxArea !== void 0 && memory.lastBboxArea > 0 && signal.bboxArea >= memory.lastBboxArea * (1 + config.minCropAreaGrowth);
-	const reason = identityTrigger ? "identity" : confidenceTrigger ? "confidence" : cropTrigger ? "crop" : void 0;
-	const keptMemory = memory ?? {
+	const reason = identityTrigger ? "identity" : confidenceTrigger ? "confidence" : zoneTrigger ? "zone" : cropTrigger ? "crop" : void 0;
+	const keptMemory = memory === void 0 ? {
 		lastConfidence: signal.confidence,
-		lastEmitAt: signal.now
-	};
+		lastEmitAt: signal.now,
+		...signal.zonesVisitedCount !== void 0 ? { lastZonesVisitedCount: signal.zonesVisitedCount } : {}
+	} : memory.lastZonesVisitedCount === void 0 && signal.zonesVisitedCount !== void 0 ? {
+		...memory,
+		lastZonesVisitedCount: signal.zonesVisitedCount
+	} : memory;
 	if (reason === void 0) return {
 		emit: false,
 		memory: keptMemory
 	};
 	if (memory !== void 0 && signal.now - memory.lastEmitAt < config.minIntervalMs) return {
 		emit: false,
-		memory
+		suppressed: reason,
+		memory: {
+			...keptMemory,
+			suppressedSinceEmit: (keptMemory.suppressedSinceEmit ?? 0) + 1
+		}
 	};
 	const nextLabel = signal.label ?? memory?.lastLabel;
 	const nextBboxArea = signal.bboxArea ?? memory?.lastBboxArea;
+	const nextZonesCount = signal.zonesVisitedCount ?? memory?.lastZonesVisitedCount;
 	return {
 		emit: true,
 		reason,
@@ -35879,7 +35916,8 @@ function evaluateTrackLifecycleUpdate(signal, memory, config) {
 			lastConfidence: memory === void 0 ? signal.confidence : Math.max(memory.lastConfidence, signal.confidence),
 			lastEmitAt: signal.now,
 			...nextLabel !== void 0 ? { lastLabel: nextLabel } : {},
-			...nextBboxArea !== void 0 ? { lastBboxArea: nextBboxArea } : {}
+			...nextBboxArea !== void 0 ? { lastBboxArea: nextBboxArea } : {},
+			...nextZonesCount !== void 0 ? { lastZonesVisitedCount: nextZonesCount } : {}
 		}
 	};
 }
@@ -39921,7 +39959,8 @@ var TrackStore = class {
 	* Cheap read of an active track's promotion-relevant fields WITHOUT the deep
 	* clone `getActiveByTrack` does — the returned `positions` is the live
 	* internal array (read-only; callers must not mutate). Feeds the per-frame
-	* stationary-promotion check, called at inference fps. Null if unknown/expired.
+	* stationary-promotion check AND the lifecycle update gate, both called at
+	* inference fps. Null if unknown/expired.
 	*/
 	peekActive(trackId) {
 		const t = this.active.get(trackId);
@@ -39929,6 +39968,7 @@ var TrackStore = class {
 		return {
 			firstSeen: t.firstSeen,
 			positions: t.positions,
+			zonesVisitedCount: t.zonesVisited.length,
 			...displayLabel(t) !== void 0 ? { label: displayLabel(t) } : {}
 		};
 	}
@@ -71158,15 +71198,41 @@ var PipelineAnalyticsAddon = class PipelineAnalyticsAddon extends require_dist.B
 	*/
 	maybeEmitTrackLifecycleUpdate(deviceId, t, timestamp, isNewBest) {
 		const memory = this.residents.lifecycleUpdateMem(t.trackId);
+		/**
+		* The signal's label reads the frame patch AND the track row: the face
+		* recognizer writes a recognised identity to the ROW over the async
+		* detail plane, never into a frame patch, and a patch-only read left the
+		* identity trigger unable to fire for a face — every face name reached
+		* the export surfaces only on the `end` event, ~30 s after the subject
+		* left the frame (measured live 2026-09-05).
+		*/
+		const peeked = this.trackStore?.peekActive(t.trackId);
+		const label = resolveLifecycleUpdateLabel(t.labelPatch, peeked?.label);
 		const decision = evaluateTrackLifecycleUpdate({
 			isNewBest,
 			confidence: t.confidence,
 			now: timestamp,
-			...patchDisplayLabel(t.labelPatch) !== void 0 ? { label: patchDisplayLabel(t.labelPatch) } : {},
+			...label !== void 0 ? { label } : {},
+			...peeked !== null && peeked !== void 0 ? { zonesVisitedCount: peeked.zonesVisitedCount } : {},
 			bboxArea: t.bbox.w * t.bbox.h
 		}, memory, DEFAULT_UPDATE_GATE_CONFIG);
 		this.residents.setLifecycleUpdateMem(deviceId, t.trackId, decision.memory);
-		if (!decision.emit) return;
+		if (!decision.emit) {
+			/**
+			* Dropped for cadence (debounce) — counted, never silent. The count
+			* since the last emit rides the memory and this line; a throttle
+			* with no ledger is how a 30 s delivery delay stayed invisible.
+			*/
+			if (decision.suppressed !== void 0) this.ctx.logger.debug("lifecycle update suppressed (debounce)", {
+				tags: { deviceId },
+				meta: {
+					trackId: t.trackId,
+					reason: decision.suppressed,
+					suppressedSinceEmit: decision.memory.suppressedSinceEmit ?? 0
+				}
+			});
+			return;
+		}
 		const track = this.trackStore?.getActiveByTrack(t.trackId);
 		const keyFrameMediaKey = this.residents.keyFrameKey(t.trackId);
 		const payload = buildTrackLifecyclePayload({
@@ -71178,7 +71244,7 @@ var PipelineAnalyticsAddon = class PipelineAnalyticsAddon extends require_dist.B
 			bestConfidence: t.confidence,
 			firstSeen: track?.firstSeen ?? timestamp,
 			lastSeen: track?.lastSeen ?? timestamp,
-			...patchDisplayLabel(t.labelPatch) !== void 0 ? { label: patchDisplayLabel(t.labelPatch) } : {},
+			...label !== void 0 ? { label } : {},
 			...t.plateText !== void 0 ? { plateText: t.plateText } : {},
 			...track?.zonesVisited !== void 0 ? { zonesVisited: track.zonesVisited } : {},
 			...track?.totalDistance !== void 0 ? { totalDistance: track.totalDistance } : {},

package/dist/pipeline-analytics/index.mjs

@@ -35814,16 +35814,43 @@ function positionsIntersectZone(positions, frameWidth, frameHeight, zone) {
 	}, zone.points)) return true;
 	return false;
 }
+//#endregion
+//#region src/pipeline-analytics/track-lifecycle.ts
+/** Minimum confidence increase (vs last emit) that counts as a material
+*  improvement. */
+var UPDATE_MIN_CONF_DELTA = .1;
+/** Debounce floor between two `update` emits for the same track (ms). */
+var UPDATE_MIN_INTERVAL_MS = 4e3;
+/** Minimum fractional bbox-area growth (vs last emit) counted as a
+*  materially larger representative crop (e.g. 0.15 = 15% bigger). */
+var UPDATE_MIN_CROP_AREA_GROWTH = .15;
+/**
+* The label a `phase:'update'` SIGNAL and PAYLOAD carry, resolved from its
+* two possible sources in order: this frame's tiered patch (the frame path
+* wrote a label this very frame), then the track ROW's stored display label
+* (`subLabel ?? label`, as `trackStore.peekActive` exposes it).
+*
+* The fallback is not a nicety. The face recognizer assigns an identity over
+* the async detail plane and writes it to the row (`applyLabelCandidate`) —
+* never into a frame patch — so a signal reading only the patch can never
+* fire the identity trigger for a recognised face. Measured on the live hub
+* (2026-09-05, device 590): six of six face identities reached Home
+* Assistant only on the `end` event at track close + sweep (~lastSeen+33 s),
+* zero during the track's life, while the subject was still on camera.
+*/
+function resolveLifecycleUpdateLabel(labelPatch, storedDisplayLabel) {
+	return patchDisplayLabel(labelPatch) ?? storedDisplayLabel;
+}
 var DEFAULT_UPDATE_GATE_CONFIG = {
-	minConfDelta: .1,
-	minIntervalMs: 4e3,
-	minCropAreaGrowth: .15
+	minConfDelta: UPDATE_MIN_CONF_DELTA,
+	minIntervalMs: UPDATE_MIN_INTERVAL_MS,
+	minCropAreaGrowth: UPDATE_MIN_CROP_AREA_GROWTH
 };
 /**
 * Decide whether a `phase:'update'` event should fire this frame.
 *
 * Priority of triggers: newly-resolved identity/plate > confidence
-* improvement > materially larger crop. All triggers are debounced by
+* improvement > newly-entered zone > materially larger crop. All triggers are debounced by
 * `minIntervalMs` relative to the last emit. Deltas are measured against
 * the LAST-EMITTED memory, so a run of sub-threshold new-bests accumulates
 * and fires once it crosses `minConfDelta`.
@@ -35831,22 +35858,32 @@ var DEFAULT_UPDATE_GATE_CONFIG = {
 function evaluateTrackLifecycleUpdate(signal, memory, config) {
 	const identityTrigger = signal.label !== void 0 && signal.label !== "" && (memory === void 0 || memory.lastLabel !== signal.label);
 	const confidenceTrigger = signal.isNewBest && (memory === void 0 || signal.confidence - memory.lastConfidence >= config.minConfDelta);
+	const zoneTrigger = signal.zonesVisitedCount !== void 0 && memory?.lastZonesVisitedCount !== void 0 && signal.zonesVisitedCount > memory.lastZonesVisitedCount;
 	const cropTrigger = signal.bboxArea !== void 0 && memory?.lastBboxArea !== void 0 && memory.lastBboxArea > 0 && signal.bboxArea >= memory.lastBboxArea * (1 + config.minCropAreaGrowth);
-	const reason = identityTrigger ? "identity" : confidenceTrigger ? "confidence" : cropTrigger ? "crop" : void 0;
-	const keptMemory = memory ?? {
+	const reason = identityTrigger ? "identity" : confidenceTrigger ? "confidence" : zoneTrigger ? "zone" : cropTrigger ? "crop" : void 0;
+	const keptMemory = memory === void 0 ? {
 		lastConfidence: signal.confidence,
-		lastEmitAt: signal.now
-	};
+		lastEmitAt: signal.now,
+		...signal.zonesVisitedCount !== void 0 ? { lastZonesVisitedCount: signal.zonesVisitedCount } : {}
+	} : memory.lastZonesVisitedCount === void 0 && signal.zonesVisitedCount !== void 0 ? {
+		...memory,
+		lastZonesVisitedCount: signal.zonesVisitedCount
+	} : memory;
 	if (reason === void 0) return {
 		emit: false,
 		memory: keptMemory
 	};
 	if (memory !== void 0 && signal.now - memory.lastEmitAt < config.minIntervalMs) return {
 		emit: false,
-		memory
+		suppressed: reason,
+		memory: {
+			...keptMemory,
+			suppressedSinceEmit: (keptMemory.suppressedSinceEmit ?? 0) + 1
+		}
 	};
 	const nextLabel = signal.label ?? memory?.lastLabel;
 	const nextBboxArea = signal.bboxArea ?? memory?.lastBboxArea;
+	const nextZonesCount = signal.zonesVisitedCount ?? memory?.lastZonesVisitedCount;
 	return {
 		emit: true,
 		reason,
@@ -35854,7 +35891,8 @@ function evaluateTrackLifecycleUpdate(signal, memory, config) {
 			lastConfidence: memory === void 0 ? signal.confidence : Math.max(memory.lastConfidence, signal.confidence),
 			lastEmitAt: signal.now,
 			...nextLabel !== void 0 ? { lastLabel: nextLabel } : {},
-			...nextBboxArea !== void 0 ? { lastBboxArea: nextBboxArea } : {}
+			...nextBboxArea !== void 0 ? { lastBboxArea: nextBboxArea } : {},
+			...nextZonesCount !== void 0 ? { lastZonesVisitedCount: nextZonesCount } : {}
 		}
 	};
 }
@@ -39896,7 +39934,8 @@ var TrackStore = class {
 	* Cheap read of an active track's promotion-relevant fields WITHOUT the deep
 	* clone `getActiveByTrack` does — the returned `positions` is the live
 	* internal array (read-only; callers must not mutate). Feeds the per-frame
-	* stationary-promotion check, called at inference fps. Null if unknown/expired.
+	* stationary-promotion check AND the lifecycle update gate, both called at
+	* inference fps. Null if unknown/expired.
 	*/
 	peekActive(trackId) {
 		const t = this.active.get(trackId);
@@ -39904,6 +39943,7 @@ var TrackStore = class {
 		return {
 			firstSeen: t.firstSeen,
 			positions: t.positions,
+			zonesVisitedCount: t.zonesVisited.length,
 			...displayLabel(t) !== void 0 ? { label: displayLabel(t) } : {}
 		};
 	}
@@ -71084,15 +71124,41 @@ var PipelineAnalyticsAddon = class PipelineAnalyticsAddon extends BaseAddon {
 	*/
 	maybeEmitTrackLifecycleUpdate(deviceId, t, timestamp, isNewBest) {
 		const memory = this.residents.lifecycleUpdateMem(t.trackId);
+		/**
+		* The signal's label reads the frame patch AND the track row: the face
+		* recognizer writes a recognised identity to the ROW over the async
+		* detail plane, never into a frame patch, and a patch-only read left the
+		* identity trigger unable to fire for a face — every face name reached
+		* the export surfaces only on the `end` event, ~30 s after the subject
+		* left the frame (measured live 2026-09-05).
+		*/
+		const peeked = this.trackStore?.peekActive(t.trackId);
+		const label = resolveLifecycleUpdateLabel(t.labelPatch, peeked?.label);
 		const decision = evaluateTrackLifecycleUpdate({
 			isNewBest,
 			confidence: t.confidence,
 			now: timestamp,
-			...patchDisplayLabel(t.labelPatch) !== void 0 ? { label: patchDisplayLabel(t.labelPatch) } : {},
+			...label !== void 0 ? { label } : {},
+			...peeked !== null && peeked !== void 0 ? { zonesVisitedCount: peeked.zonesVisitedCount } : {},
 			bboxArea: t.bbox.w * t.bbox.h
 		}, memory, DEFAULT_UPDATE_GATE_CONFIG);
 		this.residents.setLifecycleUpdateMem(deviceId, t.trackId, decision.memory);
-		if (!decision.emit) return;
+		if (!decision.emit) {
+			/**
+			* Dropped for cadence (debounce) — counted, never silent. The count
+			* since the last emit rides the memory and this line; a throttle
+			* with no ledger is how a 30 s delivery delay stayed invisible.
+			*/
+			if (decision.suppressed !== void 0) this.ctx.logger.debug("lifecycle update suppressed (debounce)", {
+				tags: { deviceId },
+				meta: {
+					trackId: t.trackId,
+					reason: decision.suppressed,
+					suppressedSinceEmit: decision.memory.suppressedSinceEmit ?? 0
+				}
+			});
+			return;
+		}
 		const track = this.trackStore?.getActiveByTrack(t.trackId);
 		const keyFrameMediaKey = this.residents.keyFrameKey(t.trackId);
 		const payload = buildTrackLifecyclePayload({
@@ -71104,7 +71170,7 @@ var PipelineAnalyticsAddon = class PipelineAnalyticsAddon extends BaseAddon {
 			bestConfidence: t.confidence,
 			firstSeen: track?.firstSeen ?? timestamp,
 			lastSeen: track?.lastSeen ?? timestamp,
-			...patchDisplayLabel(t.labelPatch) !== void 0 ? { label: patchDisplayLabel(t.labelPatch) } : {},
+			...label !== void 0 ? { label } : {},
 			...t.plateText !== void 0 ? { plateText: t.plateText } : {},
 			...track?.zonesVisited !== void 0 ? { zonesVisited: track.zonesVisited } : {},
 			...track?.totalDistance !== void 0 ? { totalDistance: track.totalDistance } : {},

package/package.json

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