@camstack/addon-post-analysis 1.2.198 → 1.2.200

package/dist/pipeline-analytics/index.js

@@ -12814,6 +12814,23 @@ function recordToRow$2(subject, data) {
 	};
 }
 //#endregion
+//#region src/notification-center/no-match-report-key.ts
+/**
+* Stand-in for "this subject named no class". A distinct token rather than an
+* empty string so a class-less subject occupies its own bucket instead of
+* sharing one with every other class-less kind by accident.
+*/
+var NO_CLASSES = "∅";
+/**
+* The bucket key. Stable across calls, insensitive to class ORDER, DUPLICATES
+* and CASE — a detector that re-orders its class list, repeats one, or changes
+* its capitalisation must not fork the bucket and double the log volume.
+*/
+function noMatchReportKey(subject) {
+	const classes = [...new Set(subject.classNames.map((c) => c.toLowerCase()))].sort();
+	return `${subject.deviceId}|${subject.kind}|${classes.length > 0 ? classes.join(",") : NO_CLASSES}`;
+}
+//#endregion
 //#region src/notification-center/occupancy-watcher.ts
 /** Sentinel key segments for the "no zone" (whole-frame) and "no class" scopes. */
 var FRAME_SCOPE = "@frame";
@@ -21945,10 +21962,15 @@ var NotificationCenter = class NotificationCenter {
 	* which leaves those notifications text-only rather than broken.
 	*/
 	stills;
-	/** Per-device rate limit for the "matched NO rule" report — see `reportNoMatch`. */
+	/**
+	* Rate limit for the "matched NO rule" report — see `reportNoMatch`. Keyed by
+	* {@link noMatchReportKey} (device + subject kind + class set), NOT by device:
+	* a person's verdict must never consume the window a cat's verdict needed on
+	* the same camera ([D390]).
+	*/
 	lastNoMatchReportAt = /* @__PURE__ */ new Map();
 	noMatchSuppressed = /* @__PURE__ */ new Map();
-	/** Same rate-limit pair for the per-camera mute drop — see `reportMutedDrop`. */
+	/** Same rate-limit pair, same key, for the per-camera mute drop — see `reportMutedDrop`. */
 	lastMutedReportAt = /* @__PURE__ */ new Map();
 	mutedSuppressed = /* @__PURE__ */ new Map();
 	/**
@@ -24719,14 +24741,19 @@ var NotificationCenter = class NotificationCenter {
 	* is identical: "why did this camera not notify me?".
 	*/
 	reportMutedDrop(subject, kind, now) {
-		const last = this.lastMutedReportAt.get(subject.deviceId) ?? 0;
-		const suppressed = this.mutedSuppressed.get(subject.deviceId) ?? 0;
+		const bucket = noMatchReportKey({
+			deviceId: subject.deviceId,
+			kind,
+			classNames: subject.classNames
+		});
+		const last = this.lastMutedReportAt.get(bucket) ?? 0;
+		const suppressed = this.mutedSuppressed.get(bucket) ?? 0;
 		if (now - last < NO_MATCH_REPORT_INTERVAL_MS) {
-			this.mutedSuppressed.set(subject.deviceId, suppressed + 1);
+			this.mutedSuppressed.set(bucket, suppressed + 1);
 			return;
 		}
-		this.lastMutedReportAt.set(subject.deviceId, now);
-		this.mutedSuppressed.set(subject.deviceId, 0);
+		this.lastMutedReportAt.set(bucket, now);
+		this.mutedSuppressed.set(bucket, 0);
 		this.logger.info("notifications muted for this camera — event dropped before rule evaluation", {
 			tags: { deviceId: subject.deviceId },
 			meta: {
@@ -24738,16 +24765,23 @@ var NotificationCenter = class NotificationCenter {
 			}
 		});
 	}
-	/** See the call site. Bounded to one line per device per window. */
+	/** See the call site. Bounded to one line per {@link noMatchReportKey} bucket
+	*  per window — device, subject kind and class set, so one subject's verdict
+	*  cannot stand in for another's on the same camera ([D390]). */
 	reportNoMatch(subject, kind, rejections, now) {
-		const last = this.lastNoMatchReportAt.get(subject.deviceId) ?? 0;
-		const suppressed = this.noMatchSuppressed.get(subject.deviceId) ?? 0;
+		const bucket = noMatchReportKey({
+			deviceId: subject.deviceId,
+			kind,
+			classNames: subject.classNames
+		});
+		const last = this.lastNoMatchReportAt.get(bucket) ?? 0;
+		const suppressed = this.noMatchSuppressed.get(bucket) ?? 0;
 		if (now - last < NO_MATCH_REPORT_INTERVAL_MS) {
-			this.noMatchSuppressed.set(subject.deviceId, suppressed + 1);
+			this.noMatchSuppressed.set(bucket, suppressed + 1);
 			return;
 		}
-		this.lastNoMatchReportAt.set(subject.deviceId, now);
-		this.noMatchSuppressed.set(subject.deviceId, 0);
+		this.lastNoMatchReportAt.set(bucket, now);
+		this.noMatchSuppressed.set(bucket, 0);
 		this.logger.info("event matched NO rule", {
 			tags: { deviceId: subject.deviceId },
 			meta: {
@@ -34027,6 +34061,22 @@ function pairRiders(detections) {
 	}
 	return pairs;
 }
+/** Per-(stage, gate) counter + sampling decision. One instance per tracker, so
+*  the counts are per camera and per detection source. */
+var LooseBindSampler = class {
+	counts = /* @__PURE__ */ new Map();
+	/** Increment the (stage, gate) counter and answer with the running total when
+	*  this decision should be reported, or `undefined` when it is sampled out. */
+	next(stage, gate) {
+		const key = `${stage}|${gate}`;
+		const count = (this.counts.get(key) ?? 0) + 1;
+		this.counts.set(key, count);
+		if (count === 1 || count % 50 === 0) return count;
+	}
+	reset() {
+		this.counts.clear();
+	}
+};
 //#endregion
 //#region src/pipeline-analytics/pipeline/tracker/rescue-growth.ts
 /**
@@ -34084,22 +34134,6 @@ function growthAdjacentMatch(track, det, ctx) {
 	const dc = bboxCentroid(det);
 	return Math.hypot(tc.x - dc.x, tc.y - dc.y) <= GROWTH_CENTROID_FACTOR * Math.hypot(track.w, track.h);
 }
-/** Per-(stage, gate) counter + sampling decision. One instance per tracker, so
-*  the counts are per camera and per detection source. */
-var LooseBindSampler = class {
-	counts = /* @__PURE__ */ new Map();
-	/** Increment the (stage, gate) counter and answer with the running total when
-	*  this decision should be reported, or `undefined` when it is sampled out. */
-	next(stage, gate) {
-		const key = `${stage}|${gate}`;
-		const count = (this.counts.get(key) ?? 0) + 1;
-		this.counts.set(key, count);
-		if (count === 1 || count % 50 === 0) return count;
-	}
-	reset() {
-		this.counts.clear();
-	}
-};
 /** Per-reason counter + sampling decision. One instance per tracker, so the
 *  counts are per camera and per detection source. */
 var SpawnRefusalSampler = class {
@@ -34243,7 +34277,35 @@ var SortTracker = class SortTracker {
 				againstTrackClass: extra.against.class
 			} : {},
 			refusalCount,
-			sampledEvery: 10
+			sampledEvery: 10,
+			...extra.droppedTrackId !== void 0 ? { droppedTrackId: extra.droppedTrackId } : {},
+			...extra.trackLifeMs !== void 0 ? { trackLifeMs: extra.trackLifeMs } : {}
+		});
+	}
+	/**
+	* Report a TRACK that ends having emitted nothing — the last silent branch
+	* on the detection→position path (D391).
+	*
+	* The subject is the track, not one box, so the record carries the track's
+	* own last class/score/bbox: those ARE the detection that fed it last, and
+	* they are what an operator matches against the recovery line that produced
+	* it. Reported once (`lossReported`) and only where the track can no longer
+	* come back — a graveyarded track may still resurrect, and a line about work
+	* that was not lost is worse than no line.
+	*/
+	reportTrackLoss(track) {
+		if (track.emitted || track.lossReported) return;
+		track.lossReported = true;
+		this.reportRefusal("unconfirmed-spawn-lost", {
+			class: track.class,
+			originalClass: track.originalClass,
+			score: track.score,
+			bbox: track.bbox
+		}, {
+			threshold: this.config.minHits,
+			measured: track.hits,
+			droppedTrackId: track.id,
+			trackLifeMs: track.lastSeen - track.firstSeen
 		});
 	}
 	/** Emit one salvage decision, subject to {@link LOOSE_BIND_LOG_SAMPLE_EVERY}.
@@ -34438,7 +34500,22 @@ var SortTracker = class SortTracker {
 			}
 			const streak = (this.dupStreaks.get(key) ?? 0) + 1;
 			if (streak >= this.config.dedupMergeFrames) {
-				dropIds.add(SortTracker.duplicateLoser(a, b).id);
+				const loser = SortTracker.duplicateLoser(a, b);
+				const winner = loser === a ? b : a;
+				dropIds.add(loser.id);
+				this.reportRefusal("merged-duplicate", {
+					class: loser.class,
+					originalClass: loser.originalClass,
+					score: loser.score,
+					bbox: loser.bbox
+				}, {
+					threshold: this.config.dedupMergeIou,
+					measured: iou$3(a.bbox, b.bbox),
+					against: winner,
+					droppedTrackId: loser.id,
+					trackLifeMs: loser.lastSeen - loser.firstSeen
+				});
+				loser.lossReported = true;
 				this.dupStreaks.delete(key);
 			} else this.dupStreaks.set(key, streak);
 		}
@@ -34620,6 +34697,7 @@ var SortTracker = class SortTracker {
 				track.lost = true;
 				track.lostAt = timestamp;
 				track.resurrectable = false;
+				this.reportTrackLoss(track);
 				this.lostTracks.push(track);
 			} else alive.push(track);
 			this.tracks = alive;
@@ -34631,11 +34709,15 @@ var SortTracker = class SortTracker {
 				track.lost = true;
 				track.lostAt = track.lastSeen;
 				track.resurrectable = false;
+				this.reportTrackLoss(track);
 				this.lostTracks.push(track);
 			} else alive.push(track);
 			this.tracks = alive;
 		}
-		this.lostTracks = this.lostTracks.filter((t) => timestamp - t.lostAt <= this.config.resurrectionWindowMs);
+		const stillResurrectable = [];
+		for (const t of this.lostTracks) if (timestamp - t.lostAt <= this.config.resurrectionWindowMs) stillResurrectable.push(t);
+		else this.reportTrackLoss(t);
+		this.lostTracks = stillResurrectable;
 		const used = /* @__PURE__ */ new Set();
 		const matchedTracks = /* @__PURE__ */ new Set();
 		const matched = /* @__PURE__ */ new Map();
@@ -34833,12 +34915,15 @@ var SortTracker = class SortTracker {
 				lost: false,
 				lostAt: 0,
 				resurrectable: true,
-				classVotes: new Map([[det.class, det.score > 0 ? det.score : Number.EPSILON]])
+				classVotes: new Map([[det.class, det.score > 0 ? det.score : Number.EPSILON]]),
+				emitted: false,
+				lossReported: false
 			});
 		}
 		this.tracks = surviving;
 		this.resolveDuplicates();
 		return this.tracks.filter((t) => this.isConfirmedForEmit(t)).map((t) => {
+			t.emitted = true;
 			const scene = resurrectedScene.get(t);
 			return {
 				class: this.resolveReportedClass(t),
@@ -35206,6 +35291,10 @@ var FrameProcessor = class {
 	*/
 	reportedRefusalByTrack = /* @__PURE__ */ new Map();
 	zoneEngine = new ZoneEngine();
+	/** Sink + sampler for the drops this stage owns (the detection-stage zone
+	*  filter). Shares the tracker's vocabulary — see {@link SpawnRefusalReason}. */
+	spawnRefusalObserver = null;
+	zoneRefusalSampler = new SpawnRefusalSampler();
 	/** Optional stationary-object gate (parked-object suppression). Null until
 	*  the addon wires it via {@link setStationaryGate}. */
 	stationaryGate = null;
@@ -35300,6 +35389,7 @@ var FrameProcessor = class {
 	*/
 	setSpawnRefusalObserver(observer) {
 		this.tracker.setSpawnRefusalObserver(observer);
+		this.spawnRefusalObserver = observer;
 	}
 	setBindObserver(observer) {
 		this.tracker.setBindObserver(observer);
@@ -35309,6 +35399,32 @@ var FrameProcessor = class {
 	dropTrack(trackId) {
 		this.tracker.dropTrack(trackId);
 	}
+	/**
+	* Say which detections a detection-stage zone rule excluded (D391).
+	*
+	* `filterDetections` has always ANSWERED this — it returns `excluded` — and
+	* this stage dropped the answer on the floor, so a camera whose subject the
+	* rules exclude was indistinguishable in the log from a camera whose tracker
+	* ate it. Sampled like every other refusal: an excluded box is excluded on
+	* every frame of a passage.
+	*/
+	reportZoneFiltered(excluded) {
+		const observer = this.spawnRefusalObserver;
+		if (!observer || excluded.length === 0) return;
+		for (const fd of excluded) {
+			const refusalCount = this.zoneRefusalSampler.next("zone-filtered");
+			if (refusalCount === void 0) continue;
+			observer({
+				reason: "zone-filtered",
+				detClass: fd.detection.class,
+				detScore: fd.detection.score,
+				bbox: fd.detection.bbox,
+				...fd.detection.nativeRecovery !== void 0 ? { nativeRecoveryScore: fd.detection.nativeRecovery.score } : {},
+				refusalCount,
+				sampledEvery: 10
+			});
+		}
+	}
 	process(input) {
 		const { timestamp, frame } = input;
 		const frameWidth = frame.width;
@@ -35394,7 +35510,8 @@ var FrameProcessor = class {
 				}
 			});
 		}
-		const { passed } = this.zoneEngine.filterDetections(flatDetections, this.zones, this.detectionRules, frameWidth, frameHeight, (fd) => fd.detection.class);
+		const { passed, excluded } = this.zoneEngine.filterDetections(flatDetections, this.zones, this.detectionRules, frameWidth, frameHeight, (fd) => fd.detection.class);
+		this.reportZoneFiltered(excluded);
 		let filteredDetections = passed.map((fd) => fd.detection);
 		const riderPairs = pairRiders(filteredDetections.map((d, i) => ({
 			id: String(i),
@@ -74304,7 +74421,7 @@ var PipelineAnalyticsAddon = class PipelineAnalyticsAddon extends require_dist.B
 				});
 			});
 			p.setSpawnRefusalObserver((record) => {
-				this.ctx.logger.info("tracker: detection dropped — no track was born from it", {
+				this.ctx.logger.info("tracker: detection dropped — nothing downstream received it", {
 					tags: { deviceId },
 					meta: {
 						source,

package/dist/pipeline-analytics/index.mjs

@@ -12807,6 +12807,23 @@ function recordToRow$2(subject, data) {
 	};
 }
 //#endregion
+//#region src/notification-center/no-match-report-key.ts
+/**
+* Stand-in for "this subject named no class". A distinct token rather than an
+* empty string so a class-less subject occupies its own bucket instead of
+* sharing one with every other class-less kind by accident.
+*/
+var NO_CLASSES = "∅";
+/**
+* The bucket key. Stable across calls, insensitive to class ORDER, DUPLICATES
+* and CASE — a detector that re-orders its class list, repeats one, or changes
+* its capitalisation must not fork the bucket and double the log volume.
+*/
+function noMatchReportKey(subject) {
+	const classes = [...new Set(subject.classNames.map((c) => c.toLowerCase()))].sort();
+	return `${subject.deviceId}|${subject.kind}|${classes.length > 0 ? classes.join(",") : NO_CLASSES}`;
+}
+//#endregion
 //#region src/notification-center/occupancy-watcher.ts
 /** Sentinel key segments for the "no zone" (whole-frame) and "no class" scopes. */
 var FRAME_SCOPE = "@frame";
@@ -21923,10 +21940,15 @@ var NotificationCenter = class NotificationCenter {
 	* which leaves those notifications text-only rather than broken.
 	*/
 	stills;
-	/** Per-device rate limit for the "matched NO rule" report — see `reportNoMatch`. */
+	/**
+	* Rate limit for the "matched NO rule" report — see `reportNoMatch`. Keyed by
+	* {@link noMatchReportKey} (device + subject kind + class set), NOT by device:
+	* a person's verdict must never consume the window a cat's verdict needed on
+	* the same camera ([D390]).
+	*/
 	lastNoMatchReportAt = /* @__PURE__ */ new Map();
 	noMatchSuppressed = /* @__PURE__ */ new Map();
-	/** Same rate-limit pair for the per-camera mute drop — see `reportMutedDrop`. */
+	/** Same rate-limit pair, same key, for the per-camera mute drop — see `reportMutedDrop`. */
 	lastMutedReportAt = /* @__PURE__ */ new Map();
 	mutedSuppressed = /* @__PURE__ */ new Map();
 	/**
@@ -24697,14 +24719,19 @@ var NotificationCenter = class NotificationCenter {
 	* is identical: "why did this camera not notify me?".
 	*/
 	reportMutedDrop(subject, kind, now) {
-		const last = this.lastMutedReportAt.get(subject.deviceId) ?? 0;
-		const suppressed = this.mutedSuppressed.get(subject.deviceId) ?? 0;
+		const bucket = noMatchReportKey({
+			deviceId: subject.deviceId,
+			kind,
+			classNames: subject.classNames
+		});
+		const last = this.lastMutedReportAt.get(bucket) ?? 0;
+		const suppressed = this.mutedSuppressed.get(bucket) ?? 0;
 		if (now - last < NO_MATCH_REPORT_INTERVAL_MS) {
-			this.mutedSuppressed.set(subject.deviceId, suppressed + 1);
+			this.mutedSuppressed.set(bucket, suppressed + 1);
 			return;
 		}
-		this.lastMutedReportAt.set(subject.deviceId, now);
-		this.mutedSuppressed.set(subject.deviceId, 0);
+		this.lastMutedReportAt.set(bucket, now);
+		this.mutedSuppressed.set(bucket, 0);
 		this.logger.info("notifications muted for this camera — event dropped before rule evaluation", {
 			tags: { deviceId: subject.deviceId },
 			meta: {
@@ -24716,16 +24743,23 @@ var NotificationCenter = class NotificationCenter {
 			}
 		});
 	}
-	/** See the call site. Bounded to one line per device per window. */
+	/** See the call site. Bounded to one line per {@link noMatchReportKey} bucket
+	*  per window — device, subject kind and class set, so one subject's verdict
+	*  cannot stand in for another's on the same camera ([D390]). */
 	reportNoMatch(subject, kind, rejections, now) {
-		const last = this.lastNoMatchReportAt.get(subject.deviceId) ?? 0;
-		const suppressed = this.noMatchSuppressed.get(subject.deviceId) ?? 0;
+		const bucket = noMatchReportKey({
+			deviceId: subject.deviceId,
+			kind,
+			classNames: subject.classNames
+		});
+		const last = this.lastNoMatchReportAt.get(bucket) ?? 0;
+		const suppressed = this.noMatchSuppressed.get(bucket) ?? 0;
 		if (now - last < NO_MATCH_REPORT_INTERVAL_MS) {
-			this.noMatchSuppressed.set(subject.deviceId, suppressed + 1);
+			this.noMatchSuppressed.set(bucket, suppressed + 1);
 			return;
 		}
-		this.lastNoMatchReportAt.set(subject.deviceId, now);
-		this.noMatchSuppressed.set(subject.deviceId, 0);
+		this.lastNoMatchReportAt.set(bucket, now);
+		this.noMatchSuppressed.set(bucket, 0);
 		this.logger.info("event matched NO rule", {
 			tags: { deviceId: subject.deviceId },
 			meta: {
@@ -34002,6 +34036,22 @@ function pairRiders(detections) {
 	}
 	return pairs;
 }
+/** Per-(stage, gate) counter + sampling decision. One instance per tracker, so
+*  the counts are per camera and per detection source. */
+var LooseBindSampler = class {
+	counts = /* @__PURE__ */ new Map();
+	/** Increment the (stage, gate) counter and answer with the running total when
+	*  this decision should be reported, or `undefined` when it is sampled out. */
+	next(stage, gate) {
+		const key = `${stage}|${gate}`;
+		const count = (this.counts.get(key) ?? 0) + 1;
+		this.counts.set(key, count);
+		if (count === 1 || count % 50 === 0) return count;
+	}
+	reset() {
+		this.counts.clear();
+	}
+};
 //#endregion
 //#region src/pipeline-analytics/pipeline/tracker/rescue-growth.ts
 /**
@@ -34059,22 +34109,6 @@ function growthAdjacentMatch(track, det, ctx) {
 	const dc = bboxCentroid(det);
 	return Math.hypot(tc.x - dc.x, tc.y - dc.y) <= GROWTH_CENTROID_FACTOR * Math.hypot(track.w, track.h);
 }
-/** Per-(stage, gate) counter + sampling decision. One instance per tracker, so
-*  the counts are per camera and per detection source. */
-var LooseBindSampler = class {
-	counts = /* @__PURE__ */ new Map();
-	/** Increment the (stage, gate) counter and answer with the running total when
-	*  this decision should be reported, or `undefined` when it is sampled out. */
-	next(stage, gate) {
-		const key = `${stage}|${gate}`;
-		const count = (this.counts.get(key) ?? 0) + 1;
-		this.counts.set(key, count);
-		if (count === 1 || count % 50 === 0) return count;
-	}
-	reset() {
-		this.counts.clear();
-	}
-};
 /** Per-reason counter + sampling decision. One instance per tracker, so the
 *  counts are per camera and per detection source. */
 var SpawnRefusalSampler = class {
@@ -34218,7 +34252,35 @@ var SortTracker = class SortTracker {
 				againstTrackClass: extra.against.class
 			} : {},
 			refusalCount,
-			sampledEvery: 10
+			sampledEvery: 10,
+			...extra.droppedTrackId !== void 0 ? { droppedTrackId: extra.droppedTrackId } : {},
+			...extra.trackLifeMs !== void 0 ? { trackLifeMs: extra.trackLifeMs } : {}
+		});
+	}
+	/**
+	* Report a TRACK that ends having emitted nothing — the last silent branch
+	* on the detection→position path (D391).
+	*
+	* The subject is the track, not one box, so the record carries the track's
+	* own last class/score/bbox: those ARE the detection that fed it last, and
+	* they are what an operator matches against the recovery line that produced
+	* it. Reported once (`lossReported`) and only where the track can no longer
+	* come back — a graveyarded track may still resurrect, and a line about work
+	* that was not lost is worse than no line.
+	*/
+	reportTrackLoss(track) {
+		if (track.emitted || track.lossReported) return;
+		track.lossReported = true;
+		this.reportRefusal("unconfirmed-spawn-lost", {
+			class: track.class,
+			originalClass: track.originalClass,
+			score: track.score,
+			bbox: track.bbox
+		}, {
+			threshold: this.config.minHits,
+			measured: track.hits,
+			droppedTrackId: track.id,
+			trackLifeMs: track.lastSeen - track.firstSeen
 		});
 	}
 	/** Emit one salvage decision, subject to {@link LOOSE_BIND_LOG_SAMPLE_EVERY}.
@@ -34413,7 +34475,22 @@ var SortTracker = class SortTracker {
 			}
 			const streak = (this.dupStreaks.get(key) ?? 0) + 1;
 			if (streak >= this.config.dedupMergeFrames) {
-				dropIds.add(SortTracker.duplicateLoser(a, b).id);
+				const loser = SortTracker.duplicateLoser(a, b);
+				const winner = loser === a ? b : a;
+				dropIds.add(loser.id);
+				this.reportRefusal("merged-duplicate", {
+					class: loser.class,
+					originalClass: loser.originalClass,
+					score: loser.score,
+					bbox: loser.bbox
+				}, {
+					threshold: this.config.dedupMergeIou,
+					measured: iou$3(a.bbox, b.bbox),
+					against: winner,
+					droppedTrackId: loser.id,
+					trackLifeMs: loser.lastSeen - loser.firstSeen
+				});
+				loser.lossReported = true;
 				this.dupStreaks.delete(key);
 			} else this.dupStreaks.set(key, streak);
 		}
@@ -34595,6 +34672,7 @@ var SortTracker = class SortTracker {
 				track.lost = true;
 				track.lostAt = timestamp;
 				track.resurrectable = false;
+				this.reportTrackLoss(track);
 				this.lostTracks.push(track);
 			} else alive.push(track);
 			this.tracks = alive;
@@ -34606,11 +34684,15 @@ var SortTracker = class SortTracker {
 				track.lost = true;
 				track.lostAt = track.lastSeen;
 				track.resurrectable = false;
+				this.reportTrackLoss(track);
 				this.lostTracks.push(track);
 			} else alive.push(track);
 			this.tracks = alive;
 		}
-		this.lostTracks = this.lostTracks.filter((t) => timestamp - t.lostAt <= this.config.resurrectionWindowMs);
+		const stillResurrectable = [];
+		for (const t of this.lostTracks) if (timestamp - t.lostAt <= this.config.resurrectionWindowMs) stillResurrectable.push(t);
+		else this.reportTrackLoss(t);
+		this.lostTracks = stillResurrectable;
 		const used = /* @__PURE__ */ new Set();
 		const matchedTracks = /* @__PURE__ */ new Set();
 		const matched = /* @__PURE__ */ new Map();
@@ -34808,12 +34890,15 @@ var SortTracker = class SortTracker {
 				lost: false,
 				lostAt: 0,
 				resurrectable: true,
-				classVotes: new Map([[det.class, det.score > 0 ? det.score : Number.EPSILON]])
+				classVotes: new Map([[det.class, det.score > 0 ? det.score : Number.EPSILON]]),
+				emitted: false,
+				lossReported: false
 			});
 		}
 		this.tracks = surviving;
 		this.resolveDuplicates();
 		return this.tracks.filter((t) => this.isConfirmedForEmit(t)).map((t) => {
+			t.emitted = true;
 			const scene = resurrectedScene.get(t);
 			return {
 				class: this.resolveReportedClass(t),
@@ -35181,6 +35266,10 @@ var FrameProcessor = class {
 	*/
 	reportedRefusalByTrack = /* @__PURE__ */ new Map();
 	zoneEngine = new ZoneEngine();
+	/** Sink + sampler for the drops this stage owns (the detection-stage zone
+	*  filter). Shares the tracker's vocabulary — see {@link SpawnRefusalReason}. */
+	spawnRefusalObserver = null;
+	zoneRefusalSampler = new SpawnRefusalSampler();
 	/** Optional stationary-object gate (parked-object suppression). Null until
 	*  the addon wires it via {@link setStationaryGate}. */
 	stationaryGate = null;
@@ -35275,6 +35364,7 @@ var FrameProcessor = class {
 	*/
 	setSpawnRefusalObserver(observer) {
 		this.tracker.setSpawnRefusalObserver(observer);
+		this.spawnRefusalObserver = observer;
 	}
 	setBindObserver(observer) {
 		this.tracker.setBindObserver(observer);
@@ -35284,6 +35374,32 @@ var FrameProcessor = class {
 	dropTrack(trackId) {
 		this.tracker.dropTrack(trackId);
 	}
+	/**
+	* Say which detections a detection-stage zone rule excluded (D391).
+	*
+	* `filterDetections` has always ANSWERED this — it returns `excluded` — and
+	* this stage dropped the answer on the floor, so a camera whose subject the
+	* rules exclude was indistinguishable in the log from a camera whose tracker
+	* ate it. Sampled like every other refusal: an excluded box is excluded on
+	* every frame of a passage.
+	*/
+	reportZoneFiltered(excluded) {
+		const observer = this.spawnRefusalObserver;
+		if (!observer || excluded.length === 0) return;
+		for (const fd of excluded) {
+			const refusalCount = this.zoneRefusalSampler.next("zone-filtered");
+			if (refusalCount === void 0) continue;
+			observer({
+				reason: "zone-filtered",
+				detClass: fd.detection.class,
+				detScore: fd.detection.score,
+				bbox: fd.detection.bbox,
+				...fd.detection.nativeRecovery !== void 0 ? { nativeRecoveryScore: fd.detection.nativeRecovery.score } : {},
+				refusalCount,
+				sampledEvery: 10
+			});
+		}
+	}
 	process(input) {
 		const { timestamp, frame } = input;
 		const frameWidth = frame.width;
@@ -35369,7 +35485,8 @@ var FrameProcessor = class {
 				}
 			});
 		}
-		const { passed } = this.zoneEngine.filterDetections(flatDetections, this.zones, this.detectionRules, frameWidth, frameHeight, (fd) => fd.detection.class);
+		const { passed, excluded } = this.zoneEngine.filterDetections(flatDetections, this.zones, this.detectionRules, frameWidth, frameHeight, (fd) => fd.detection.class);
+		this.reportZoneFiltered(excluded);
 		let filteredDetections = passed.map((fd) => fd.detection);
 		const riderPairs = pairRiders(filteredDetections.map((d, i) => ({
 			id: String(i),
@@ -74230,7 +74347,7 @@ var PipelineAnalyticsAddon = class PipelineAnalyticsAddon extends BaseAddon {
 				});
 			});
 			p.setSpawnRefusalObserver((record) => {
-				this.ctx.logger.info("tracker: detection dropped — no track was born from it", {
+				this.ctx.logger.info("tracker: detection dropped — nothing downstream received it", {
 					tags: { deviceId },
 					meta: {
 						source,

package/package.json

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