@camstack/addon-post-analysis 1.2.362 → 1.2.364

package/dist/pipeline-analytics/index.js

@@ -64878,6 +64878,22 @@ var TrackResidentState = class {
 	size() {
 		return this.residents.size;
 	}
+	/** Residents whose last frame stamp is older than `olderThanMs` (a resident
+	*  never stamped is not listed: it carries no clock to judge). The host
+	*  subtracts the ids a live tracker still carries — what remains is a record
+	*  nothing will ever close. */
+	idleResidents(olderThanMs) {
+		const idle = [];
+		for (const [trackId, resident] of this.residents) {
+			const at = resident.lastFrameAt;
+			if (at !== void 0 && at < olderThanMs) idle.push({
+				trackId,
+				deviceId: resident.deviceId,
+				lastFrameAt: at
+			});
+		}
+		return idle;
+	}
 	trackIdsForDevice(deviceId) {
 		const ids = [];
 		for (const [trackId, resident] of this.residents) if (resident.deviceId === deviceId) ids.push(trackId);
@@ -64888,7 +64904,7 @@ var TrackResidentState = class {
 	observeBestFrame(deviceId, trackId, confidence, timestamp, edgeClear, centerScore, containment, sizeScore, squareFraction, semantic, canvasFill) {
 		const id = this.liveId(deviceId, trackId);
 		if (id === void 0) return false;
-		this.open(deviceId, id);
+		if (this.ensure(deviceId, id, "bestShot", "observeBestFrame") === void 0) return false;
 		const isNewBest = this.bestFrameTracker.observe(id, confidence, timestamp, edgeClear, centerScore, containment, sizeScore, squareFraction, semantic, canvasFill);
 		if (isNewBest) this.bestShotHolder.delete(id);
 		return isNewBest;
@@ -93487,6 +93503,8 @@ function planeRunsStationary(source) {
 */
 var SuppressedBirthRegistry = class {
 	byDevice = /* @__PURE__ */ new Map();
+	/** Rejected ids whose per-frame skip has already been reported once. */
+	skipReported = /* @__PURE__ */ new Map();
 	/** Record that this birth was rejected; later frames must not re-upsert it. */
 	reject(deviceKey, trackId) {
 		let ids = this.byDevice.get(deviceKey);
@@ -93500,12 +93518,31 @@ var SuppressedBirthRegistry = class {
 		return this.byDevice.get(deviceKey)?.has(trackId) === true;
 	}
 	/**
+	* True the FIRST time a rejected id's frame work is skipped (so the host logs
+	* one line per id, not one per frame); false afterwards.
+	*/
+	firstSkip(deviceKey, trackId) {
+		let ids = this.skipReported.get(deviceKey);
+		if (!ids) {
+			ids = /* @__PURE__ */ new Set();
+			this.skipReported.set(deviceKey, ids);
+		}
+		if (ids.has(trackId)) return false;
+		ids.add(trackId);
+		return true;
+	}
+	/**
 	* Forget every rejected id the tracker is no longer carrying.
 	*
 	* Called once per frame with the ids present THIS frame. An id absent from
 	* that set can never be upserted again, so holding it serves nothing.
 	*/
 	retain(deviceKey, currentTrackIds) {
+		const reported = this.skipReported.get(deviceKey);
+		if (reported) {
+			for (const id of reported) if (!currentTrackIds.has(id)) reported.delete(id);
+			if (reported.size === 0) this.skipReported.delete(deviceKey);
+		}
 		const ids = this.byDevice.get(deviceKey);
 		if (!ids) return;
 		for (const id of ids) if (!currentTrackIds.has(id)) ids.delete(id);
@@ -93518,6 +93555,7 @@ var SuppressedBirthRegistry = class {
 	/** Drop a device's memory wholesale (device removed / pipeline reset). */
 	clearDevice(deviceKey) {
 		this.byDevice.delete(deviceKey);
+		this.skipReported.delete(deviceKey);
 	}
 };
 //#endregion
@@ -110800,6 +110838,8 @@ var NO_PUBLICATION = {
 };
 /** How often the resident-vs-live-track heartbeat line is written. */
 var RESIDENT_HEARTBEAT_INTERVAL_MS = 5 * 6e4;
+/** A resident idle this long that nothing carries is an orphan. */
+var RESIDENT_ORPHAN_IDLE_MS = 2 * 6e4;
 /**
 * A tRPC-shaped router or procedure reached by DYNAMIC name off `ctx.api`.
 *
@@ -115362,13 +115402,29 @@ var PipelineAnalyticsAddon = class PipelineAnalyticsAddon extends require_clip_m
 		this.residentHeartbeatAt = now;
 		let liveTracks = 0;
 		for (const ids of this.lastActiveTrackIds.values()) liveTracks += ids.size;
+		const orphans = this.orphanResidents(now);
 		const mem = process.memoryUsage();
 		this.ctx.logger.info("analytics resident heartbeat", { meta: {
 			residents: this.residents.size(),
 			liveTracks,
+			orphans: orphans.length,
+			orphanSamples: orphans.slice(0, 3).map((o) => ({
+				trackId: o.trackId,
+				deviceId: o.deviceId
+			})),
 			externalNonBufferMb: Math.max(0, Math.round((mem.external - mem.arrayBuffers) / 1048576))
 		} });
 	}
+	/** Residents neither active in the TrackStore nor carried by the tracker
+	*  (`lastActiveTrackIds`) whose last frame is older than the orphan window:
+	*  a record no sweep can ever close. Healthy value: 0. */
+	orphanResidents(now) {
+		return this.residents.idleResidents(now - RESIDENT_ORPHAN_IDLE_MS).filter((r) => {
+			if (this.trackStore?.peekActive(r.trackId) !== null) return false;
+			for (const ids of this.lastActiveTrackIds.values()) if (ids.has(r.trackId)) return false;
+			return true;
+		});
+	}
 	/** Periodic sweeps — TTL promotion + retention/stationary aging. */
 	startSweepTimers() {
 		this.ttlSweepTimer = setInterval(() => {
@@ -116489,7 +116545,10 @@ var PipelineAnalyticsAddon = class PipelineAnalyticsAddon extends require_clip_m
 		}
 		if (result.rawTrackedDetections.length > 0) {
 			const { minHits } = await this.resolveDeviceDetectionSensitivitySettings(deviceId);
-			for (const rt of result.rawTrackedDetections) if (rt.trackAge >= minHits) this.residents.markConfirmed(deviceId, rt.trackId);
+			for (const rt of result.rawTrackedDetections) {
+				if (this.suppressedBirths.isRejected(key, rt.trackId)) continue;
+				if (rt.trackAge >= minHits) this.residents.markConfirmed(deviceId, rt.trackId);
+			}
 		}
 		const log = this.ctx.logger.withTags({ deviceId });
 		const prevIds = this.lastActiveTrackIds.get(key) ?? /* @__PURE__ */ new Set();
@@ -116505,6 +116564,7 @@ var PipelineAnalyticsAddon = class PipelineAnalyticsAddon extends require_clip_m
 				positionsCount: positionsCountById.get(id) ?? 1
 			});
 			if (this.startedBirths.hasStarted(key, id)) continue;
+			if (this.suppressedBirths.isRejected(key, id)) continue;
 			if (appearance === "resurrection") {
 				log.info("track resumed", {
 					tags: { deviceId },
@@ -116528,6 +116588,7 @@ var PipelineAnalyticsAddon = class PipelineAnalyticsAddon extends require_clip_m
 		}
 		for (const id of this.deferredBirths.deferredIds(key)) {
 			if (bornCandidates.some((c) => c.id === id)) continue;
+			if (this.suppressedBirths.isRejected(key, id)) continue;
 			const t = result.tracked.find((x) => x.trackId === id);
 			if (t) bornCandidates.push({
 				id,
@@ -116589,6 +116650,19 @@ var PipelineAnalyticsAddon = class PipelineAnalyticsAddon extends require_clip_m
 				} });
 				continue;
 			}
+			if (this.suppressedBirths.isRejected(key, id)) {
+				this.deferredBirths.resolve(key, id);
+				this.birthEvidence.resolve(key, id);
+				log.info("late birth verdict ignored — the birth was already suppressed", {
+					tags: { deviceId },
+					meta: {
+						trackId: id,
+						className: t.className,
+						verdict: outcome.confirmed.has(id) ? "confirmed" : "suppressed"
+					}
+				});
+				continue;
+			}
 			this.recordBirthDecision({
 				deviceId,
 				trackId: id,
@@ -116775,6 +116849,25 @@ var PipelineAnalyticsAddon = class PipelineAnalyticsAddon extends require_clip_m
 		this.deferredBirths.retain(key, currentTrackIds);
 		this.birthEvidence.retain(key, currentTrackIds);
 		this.lastActiveTrackIds.set(key, currentTrackIds);
+		const rejectedThisFrame = /* @__PURE__ */ new Set();
+		for (const t of result.tracked) {
+			if (!this.suppressedBirths.isRejected(key, t.trackId)) continue;
+			rejectedThisFrame.add(t.trackId);
+			if (this.suppressedBirths.firstSkip(key, t.trackId)) log.info("frame work skipped — the track birth was suppressed", {
+				tags: { deviceId },
+				meta: {
+					trackId: t.trackId,
+					className: t.className
+				}
+			});
+		}
+		if (rejectedThisFrame.size > 0) result = {
+			...result,
+			tracked: result.tracked.filter((t) => !rejectedThisFrame.has(t.trackId)),
+			rawTrackedDetections: result.rawTrackedDetections.filter((rt) => !rejectedThisFrame.has(rt.trackId)),
+			objectEvents: result.objectEvents.filter((e) => e.trackId === void 0 || !rejectedThisFrame.has(e.trackId)),
+			appearanceEvents: result.appearanceEvents.filter((e) => e.trackId === void 0 || !rejectedThisFrame.has(e.trackId))
+		};
 		if (currentTrackIds.size > 0) this.lastTrackActivityMs.set(deviceId, Date.now());
 		const stationarySettings = this.stationarySettingsFromCache(deviceId);
 		const packageSettings = this.packageDropSettingsFromCache(deviceId);

package/dist/pipeline-analytics/index.mjs

@@ -64834,6 +64834,22 @@ var TrackResidentState = class {
 	size() {
 		return this.residents.size;
 	}
+	/** Residents whose last frame stamp is older than `olderThanMs` (a resident
+	*  never stamped is not listed: it carries no clock to judge). The host
+	*  subtracts the ids a live tracker still carries — what remains is a record
+	*  nothing will ever close. */
+	idleResidents(olderThanMs) {
+		const idle = [];
+		for (const [trackId, resident] of this.residents) {
+			const at = resident.lastFrameAt;
+			if (at !== void 0 && at < olderThanMs) idle.push({
+				trackId,
+				deviceId: resident.deviceId,
+				lastFrameAt: at
+			});
+		}
+		return idle;
+	}
 	trackIdsForDevice(deviceId) {
 		const ids = [];
 		for (const [trackId, resident] of this.residents) if (resident.deviceId === deviceId) ids.push(trackId);
@@ -64844,7 +64860,7 @@ var TrackResidentState = class {
 	observeBestFrame(deviceId, trackId, confidence, timestamp, edgeClear, centerScore, containment, sizeScore, squareFraction, semantic, canvasFill) {
 		const id = this.liveId(deviceId, trackId);
 		if (id === void 0) return false;
-		this.open(deviceId, id);
+		if (this.ensure(deviceId, id, "bestShot", "observeBestFrame") === void 0) return false;
 		const isNewBest = this.bestFrameTracker.observe(id, confidence, timestamp, edgeClear, centerScore, containment, sizeScore, squareFraction, semantic, canvasFill);
 		if (isNewBest) this.bestShotHolder.delete(id);
 		return isNewBest;
@@ -93392,6 +93408,8 @@ function planeRunsStationary(source) {
 */
 var SuppressedBirthRegistry = class {
 	byDevice = /* @__PURE__ */ new Map();
+	/** Rejected ids whose per-frame skip has already been reported once. */
+	skipReported = /* @__PURE__ */ new Map();
 	/** Record that this birth was rejected; later frames must not re-upsert it. */
 	reject(deviceKey, trackId) {
 		let ids = this.byDevice.get(deviceKey);
@@ -93405,12 +93423,31 @@ var SuppressedBirthRegistry = class {
 		return this.byDevice.get(deviceKey)?.has(trackId) === true;
 	}
 	/**
+	* True the FIRST time a rejected id's frame work is skipped (so the host logs
+	* one line per id, not one per frame); false afterwards.
+	*/
+	firstSkip(deviceKey, trackId) {
+		let ids = this.skipReported.get(deviceKey);
+		if (!ids) {
+			ids = /* @__PURE__ */ new Set();
+			this.skipReported.set(deviceKey, ids);
+		}
+		if (ids.has(trackId)) return false;
+		ids.add(trackId);
+		return true;
+	}
+	/**
 	* Forget every rejected id the tracker is no longer carrying.
 	*
 	* Called once per frame with the ids present THIS frame. An id absent from
 	* that set can never be upserted again, so holding it serves nothing.
 	*/
 	retain(deviceKey, currentTrackIds) {
+		const reported = this.skipReported.get(deviceKey);
+		if (reported) {
+			for (const id of reported) if (!currentTrackIds.has(id)) reported.delete(id);
+			if (reported.size === 0) this.skipReported.delete(deviceKey);
+		}
 		const ids = this.byDevice.get(deviceKey);
 		if (!ids) return;
 		for (const id of ids) if (!currentTrackIds.has(id)) ids.delete(id);
@@ -93423,6 +93460,7 @@ var SuppressedBirthRegistry = class {
 	/** Drop a device's memory wholesale (device removed / pipeline reset). */
 	clearDevice(deviceKey) {
 		this.byDevice.delete(deviceKey);
+		this.skipReported.delete(deviceKey);
 	}
 };
 //#endregion
@@ -110705,6 +110743,8 @@ var NO_PUBLICATION = {
 };
 /** How often the resident-vs-live-track heartbeat line is written. */
 var RESIDENT_HEARTBEAT_INTERVAL_MS = 5 * 6e4;
+/** A resident idle this long that nothing carries is an orphan. */
+var RESIDENT_ORPHAN_IDLE_MS = 2 * 6e4;
 /**
 * A tRPC-shaped router or procedure reached by DYNAMIC name off `ctx.api`.
 *
@@ -115267,13 +115307,29 @@ var PipelineAnalyticsAddon = class PipelineAnalyticsAddon extends BaseAddon {
 		this.residentHeartbeatAt = now;
 		let liveTracks = 0;
 		for (const ids of this.lastActiveTrackIds.values()) liveTracks += ids.size;
+		const orphans = this.orphanResidents(now);
 		const mem = process.memoryUsage();
 		this.ctx.logger.info("analytics resident heartbeat", { meta: {
 			residents: this.residents.size(),
 			liveTracks,
+			orphans: orphans.length,
+			orphanSamples: orphans.slice(0, 3).map((o) => ({
+				trackId: o.trackId,
+				deviceId: o.deviceId
+			})),
 			externalNonBufferMb: Math.max(0, Math.round((mem.external - mem.arrayBuffers) / 1048576))
 		} });
 	}
+	/** Residents neither active in the TrackStore nor carried by the tracker
+	*  (`lastActiveTrackIds`) whose last frame is older than the orphan window:
+	*  a record no sweep can ever close. Healthy value: 0. */
+	orphanResidents(now) {
+		return this.residents.idleResidents(now - RESIDENT_ORPHAN_IDLE_MS).filter((r) => {
+			if (this.trackStore?.peekActive(r.trackId) !== null) return false;
+			for (const ids of this.lastActiveTrackIds.values()) if (ids.has(r.trackId)) return false;
+			return true;
+		});
+	}
 	/** Periodic sweeps — TTL promotion + retention/stationary aging. */
 	startSweepTimers() {
 		this.ttlSweepTimer = setInterval(() => {
@@ -116394,7 +116450,10 @@ var PipelineAnalyticsAddon = class PipelineAnalyticsAddon extends BaseAddon {
 		}
 		if (result.rawTrackedDetections.length > 0) {
 			const { minHits } = await this.resolveDeviceDetectionSensitivitySettings(deviceId);
-			for (const rt of result.rawTrackedDetections) if (rt.trackAge >= minHits) this.residents.markConfirmed(deviceId, rt.trackId);
+			for (const rt of result.rawTrackedDetections) {
+				if (this.suppressedBirths.isRejected(key, rt.trackId)) continue;
+				if (rt.trackAge >= minHits) this.residents.markConfirmed(deviceId, rt.trackId);
+			}
 		}
 		const log = this.ctx.logger.withTags({ deviceId });
 		const prevIds = this.lastActiveTrackIds.get(key) ?? /* @__PURE__ */ new Set();
@@ -116410,6 +116469,7 @@ var PipelineAnalyticsAddon = class PipelineAnalyticsAddon extends BaseAddon {
 				positionsCount: positionsCountById.get(id) ?? 1
 			});
 			if (this.startedBirths.hasStarted(key, id)) continue;
+			if (this.suppressedBirths.isRejected(key, id)) continue;
 			if (appearance === "resurrection") {
 				log.info("track resumed", {
 					tags: { deviceId },
@@ -116433,6 +116493,7 @@ var PipelineAnalyticsAddon = class PipelineAnalyticsAddon extends BaseAddon {
 		}
 		for (const id of this.deferredBirths.deferredIds(key)) {
 			if (bornCandidates.some((c) => c.id === id)) continue;
+			if (this.suppressedBirths.isRejected(key, id)) continue;
 			const t = result.tracked.find((x) => x.trackId === id);
 			if (t) bornCandidates.push({
 				id,
@@ -116494,6 +116555,19 @@ var PipelineAnalyticsAddon = class PipelineAnalyticsAddon extends BaseAddon {
 				} });
 				continue;
 			}
+			if (this.suppressedBirths.isRejected(key, id)) {
+				this.deferredBirths.resolve(key, id);
+				this.birthEvidence.resolve(key, id);
+				log.info("late birth verdict ignored — the birth was already suppressed", {
+					tags: { deviceId },
+					meta: {
+						trackId: id,
+						className: t.className,
+						verdict: outcome.confirmed.has(id) ? "confirmed" : "suppressed"
+					}
+				});
+				continue;
+			}
 			this.recordBirthDecision({
 				deviceId,
 				trackId: id,
@@ -116680,6 +116754,25 @@ var PipelineAnalyticsAddon = class PipelineAnalyticsAddon extends BaseAddon {
 		this.deferredBirths.retain(key, currentTrackIds);
 		this.birthEvidence.retain(key, currentTrackIds);
 		this.lastActiveTrackIds.set(key, currentTrackIds);
+		const rejectedThisFrame = /* @__PURE__ */ new Set();
+		for (const t of result.tracked) {
+			if (!this.suppressedBirths.isRejected(key, t.trackId)) continue;
+			rejectedThisFrame.add(t.trackId);
+			if (this.suppressedBirths.firstSkip(key, t.trackId)) log.info("frame work skipped — the track birth was suppressed", {
+				tags: { deviceId },
+				meta: {
+					trackId: t.trackId,
+					className: t.className
+				}
+			});
+		}
+		if (rejectedThisFrame.size > 0) result = {
+			...result,
+			tracked: result.tracked.filter((t) => !rejectedThisFrame.has(t.trackId)),
+			rawTrackedDetections: result.rawTrackedDetections.filter((rt) => !rejectedThisFrame.has(rt.trackId)),
+			objectEvents: result.objectEvents.filter((e) => e.trackId === void 0 || !rejectedThisFrame.has(e.trackId)),
+			appearanceEvents: result.appearanceEvents.filter((e) => e.trackId === void 0 || !rejectedThisFrame.has(e.trackId))
+		};
 		if (currentTrackIds.size > 0) this.lastTrackActivityMs.set(deviceId, Date.now());
 		const stationarySettings = this.stationarySettingsFromCache(deviceId);
 		const packageSettings = this.packageDropSettingsFromCache(deviceId);

package/package.json

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