@camstack/addon-post-analysis 1.2.216 → 1.2.217

package/dist/pipeline-analytics/index.js

@@ -36091,6 +36091,17 @@ function mapObjectStateToTrackState(s) {
 		default: return "new";
 	}
 }
+/**
+* How long an identical refusal stays collapsed. A stationary subject is
+* refused on every analysed frame; at ~2 fps of analysis, 60 s turns a parked
+* car's 120 lines into one and still reports a subject that comes back later.
+*/
+var ZONE_REFUSAL_THROTTLE_MS = 6e4;
+/** Box quantisation for the collapse key: a subject that moves less than this
+*  is the same sighting for diagnostic purposes. */
+var ZONE_REFUSAL_BOX_CELL_PX = 64;
+/** Bound on the collapse map; stale keys are swept when it is exceeded. */
+var ZONE_REFUSAL_KEY_LIMIT = 512;
 var FrameProcessor = class {
 	deviceId;
 	/** Detection source this processor handles (`pipeline` | `onboard`).
@@ -36162,8 +36173,11 @@ var FrameProcessor = class {
 	* as before?" answered first. See `zone-detection-emits-without-a-track`.
 	*/
 	refusalsThisFrame = [];
-	/** Running count of events this path has produced — the volume measure. */
+	/** Running count of refusals-in-zone SEEN — never the throttled number. */
 	zoneRefusalEventCount = 0;
+	zoneRefusalObserver = null;
+	/** Last report time per collapsed key, for {@link ZONE_REFUSAL_THROTTLE_MS}. */
+	zoneRefusalLastReport = /* @__PURE__ */ new Map();
 	zoneRefusalSampler = new SpawnRefusalSampler();
 	/** Optional stationary-object gate (parked-object suppression). Null until
 	*  the addon wires it via {@link setStationaryGate}. */
@@ -36264,6 +36278,14 @@ var FrameProcessor = class {
 		this.tracker.setSpawnRefusalObserver(observer);
 		this.spawnRefusalObserver = observer;
 	}
+	/**
+	* Where a refused-inside-a-zone detection goes. Diagnostics only: this is
+	* deliberately NOT the event stream, so nothing downstream can alert on a
+	* box the confirmation gate threw away (D426).
+	*/
+	setZoneRefusalObserver(observer) {
+		this.zoneRefusalObserver = observer;
+	}
 	setBindObserver(observer) {
 		this.tracker.setBindObserver(observer);
 	}
@@ -36299,40 +36321,73 @@ var FrameProcessor = class {
 	* operator's own detection rules already said the box does not count on this
 	* camera, and re-admitting it here would overrule a decision they made.
 	*/
-	eventsForRefusedDetectionsInZones(timestamp, frame, frameWidth, frameHeight) {
+	/**
+	* Report every detection the tracker refused that fell INSIDE a watched
+	* zone. Diagnostics only — see the spec
+	* `zone-refusal-is-observed-never-notified` for the ten hours of production
+	* that decided this: 1473 of 1511 such refusals were one stationary parcel
+	* re-offered every frame, and both notifications this path ever produced
+	* were phantoms the confirmation gate had correctly rejected.
+	*
+	* Drains {@link refusalsThisFrame}. `zone-filtered` is skipped: a box the
+	* zone filter already removed was never in a zone.
+	*/
+	reportRefusedDetectionsInZones(timestamp, frameWidth, frameHeight) {
 		const refusals = this.refusalsThisFrame;
 		this.refusalsThisFrame = [];
-		if (refusals.length === 0 || this.zones.length === 0) return [];
-		const out = [];
+		if (refusals.length === 0 || this.zones.length === 0) return;
+		const observer = this.zoneRefusalObserver;
+		if (observer === null) return;
 		for (const r of refusals) {
 			if (r.reason === "zone-filtered") continue;
 			const { memberships } = this.zoneEngine.splitDetectionZones(r.bbox, this.zones, frameWidth, frameHeight, void 0, void 0, void 0, this.zoneMembershipMinOverlap);
 			if (memberships.length === 0) continue;
 			this.zoneRefusalEventCount += 1;
-			out.push({
-				id: (0, node_crypto.randomUUID)(),
-				kind: "object",
+			if (!this.shouldReportZoneRefusal(r, memberships, timestamp)) continue;
+			observer({
 				deviceId: this.deviceId,
 				timestamp,
-				frameId: frame.frameId,
 				className: r.detClass,
 				confidence: r.detScore,
 				bbox: r.bbox,
-				frameWidth,
-				frameHeight,
-				zones: memberships.map((m) => m.zoneId),
-				zoneOverlaps: memberships.map((m) => ({
+				reason: r.reason,
+				zones: memberships.map((m) => ({
 					zoneId: m.zoneId,
 					...m.zoneName === void 0 ? {} : { zoneName: m.zoneName },
 					overlapPct: Math.round(m.overlap * 1e3) / 10
 				})),
-				spawnRefused: r.reason
-			});
+				seenSoFar: this.zoneRefusalEventCount
+			});
+		}
+	}
+	/**
+	* Collapse identical refusals. A refused box is refused on EVERY analysed
+	* frame, so a subject that does not leave — the parcel at the door, the
+	* parked car — is an unbounded emitter. The key includes a coarse box, so a
+	* subject that actually moves keeps reporting while a stationary one does
+	* not.
+	*/
+	shouldReportZoneRefusal(r, memberships, timestamp) {
+		const cell = (v) => Math.round(v / ZONE_REFUSAL_BOX_CELL_PX);
+		const key = [
+			r.detClass,
+			r.reason,
+			memberships.map((m) => m.zoneId).join("+"),
+			cell(r.bbox.x),
+			cell(r.bbox.y),
+			cell(r.bbox.width),
+			cell(r.bbox.height)
+		].join("|");
+		const last = this.zoneRefusalLastReport.get(key);
+		if (last !== void 0 && timestamp - last < ZONE_REFUSAL_THROTTLE_MS) return false;
+		this.zoneRefusalLastReport.set(key, timestamp);
+		if (this.zoneRefusalLastReport.size > ZONE_REFUSAL_KEY_LIMIT) {
+			for (const [k, t] of this.zoneRefusalLastReport) if (timestamp - t >= ZONE_REFUSAL_THROTTLE_MS) this.zoneRefusalLastReport.delete(k);
 		}
-		return out;
+		return true;
 	}
-	/** How many zone-refusal events this processor has emitted — the measure that
-	*  says whether this path is a trickle or a storm. Read by the addon. */
+	/** How many refusals-in-zone this processor has SEEN — the measure that says
+	*  whether this path is a trickle or a storm, before any throttling. */
 	zoneRefusalEventsEmitted() {
 		return this.zoneRefusalEventCount;
 	}
@@ -36737,11 +36792,10 @@ var FrameProcessor = class {
 				frameHeight
 			};
 		};
-		const zoneRefusalEvents = this.eventsForRefusedDetectionsInZones(timestamp, frame, frameWidth, frameHeight);
+		this.reportRefusedDetectionsInZones(timestamp, frameWidth, frameHeight);
 		const withTrackId = rawEvents.filter((e) => e.detection.trackId);
 		const objectEvents = withTrackId.filter((e) => e.type !== "object.detected").map((e) => toObjectEvent(e));
 		const appearanceEvents = withTrackId.filter((e) => e.type === "object.detected").map((e) => toObjectEvent(e, "entered"));
-		objectEvents.push(...zoneRefusalEvents);
 		return {
 			deviceId: this.deviceId,
 			timestamp,
@@ -77554,6 +77608,15 @@ var PipelineAnalyticsAddon = class PipelineAnalyticsAddon extends require_dist.B
 					}
 				});
 			});
+			p.setZoneRefusalObserver((observation) => {
+				this.ctx.logger.info("detection refused inside a watched zone — not notified", {
+					tags: { deviceId },
+					meta: {
+						source,
+						...observation
+					}
+				});
+			});
 			p.setSpawnBesideCoastingObserver((record) => {
 				this.ctx.logger.info("tracker: new id minted beside a live coasting track", {
 					tags: { deviceId },

package/dist/pipeline-analytics/index.mjs

@@ -36066,6 +36066,17 @@ function mapObjectStateToTrackState(s) {
 		default: return "new";
 	}
 }
+/**
+* How long an identical refusal stays collapsed. A stationary subject is
+* refused on every analysed frame; at ~2 fps of analysis, 60 s turns a parked
+* car's 120 lines into one and still reports a subject that comes back later.
+*/
+var ZONE_REFUSAL_THROTTLE_MS = 6e4;
+/** Box quantisation for the collapse key: a subject that moves less than this
+*  is the same sighting for diagnostic purposes. */
+var ZONE_REFUSAL_BOX_CELL_PX = 64;
+/** Bound on the collapse map; stale keys are swept when it is exceeded. */
+var ZONE_REFUSAL_KEY_LIMIT = 512;
 var FrameProcessor = class {
 	deviceId;
 	/** Detection source this processor handles (`pipeline` | `onboard`).
@@ -36137,8 +36148,11 @@ var FrameProcessor = class {
 	* as before?" answered first. See `zone-detection-emits-without-a-track`.
 	*/
 	refusalsThisFrame = [];
-	/** Running count of events this path has produced — the volume measure. */
+	/** Running count of refusals-in-zone SEEN — never the throttled number. */
 	zoneRefusalEventCount = 0;
+	zoneRefusalObserver = null;
+	/** Last report time per collapsed key, for {@link ZONE_REFUSAL_THROTTLE_MS}. */
+	zoneRefusalLastReport = /* @__PURE__ */ new Map();
 	zoneRefusalSampler = new SpawnRefusalSampler();
 	/** Optional stationary-object gate (parked-object suppression). Null until
 	*  the addon wires it via {@link setStationaryGate}. */
@@ -36239,6 +36253,14 @@ var FrameProcessor = class {
 		this.tracker.setSpawnRefusalObserver(observer);
 		this.spawnRefusalObserver = observer;
 	}
+	/**
+	* Where a refused-inside-a-zone detection goes. Diagnostics only: this is
+	* deliberately NOT the event stream, so nothing downstream can alert on a
+	* box the confirmation gate threw away (D426).
+	*/
+	setZoneRefusalObserver(observer) {
+		this.zoneRefusalObserver = observer;
+	}
 	setBindObserver(observer) {
 		this.tracker.setBindObserver(observer);
 	}
@@ -36274,40 +36296,73 @@ var FrameProcessor = class {
 	* operator's own detection rules already said the box does not count on this
 	* camera, and re-admitting it here would overrule a decision they made.
 	*/
-	eventsForRefusedDetectionsInZones(timestamp, frame, frameWidth, frameHeight) {
+	/**
+	* Report every detection the tracker refused that fell INSIDE a watched
+	* zone. Diagnostics only — see the spec
+	* `zone-refusal-is-observed-never-notified` for the ten hours of production
+	* that decided this: 1473 of 1511 such refusals were one stationary parcel
+	* re-offered every frame, and both notifications this path ever produced
+	* were phantoms the confirmation gate had correctly rejected.
+	*
+	* Drains {@link refusalsThisFrame}. `zone-filtered` is skipped: a box the
+	* zone filter already removed was never in a zone.
+	*/
+	reportRefusedDetectionsInZones(timestamp, frameWidth, frameHeight) {
 		const refusals = this.refusalsThisFrame;
 		this.refusalsThisFrame = [];
-		if (refusals.length === 0 || this.zones.length === 0) return [];
-		const out = [];
+		if (refusals.length === 0 || this.zones.length === 0) return;
+		const observer = this.zoneRefusalObserver;
+		if (observer === null) return;
 		for (const r of refusals) {
 			if (r.reason === "zone-filtered") continue;
 			const { memberships } = this.zoneEngine.splitDetectionZones(r.bbox, this.zones, frameWidth, frameHeight, void 0, void 0, void 0, this.zoneMembershipMinOverlap);
 			if (memberships.length === 0) continue;
 			this.zoneRefusalEventCount += 1;
-			out.push({
-				id: randomUUID(),
-				kind: "object",
+			if (!this.shouldReportZoneRefusal(r, memberships, timestamp)) continue;
+			observer({
 				deviceId: this.deviceId,
 				timestamp,
-				frameId: frame.frameId,
 				className: r.detClass,
 				confidence: r.detScore,
 				bbox: r.bbox,
-				frameWidth,
-				frameHeight,
-				zones: memberships.map((m) => m.zoneId),
-				zoneOverlaps: memberships.map((m) => ({
+				reason: r.reason,
+				zones: memberships.map((m) => ({
 					zoneId: m.zoneId,
 					...m.zoneName === void 0 ? {} : { zoneName: m.zoneName },
 					overlapPct: Math.round(m.overlap * 1e3) / 10
 				})),
-				spawnRefused: r.reason
-			});
+				seenSoFar: this.zoneRefusalEventCount
+			});
+		}
+	}
+	/**
+	* Collapse identical refusals. A refused box is refused on EVERY analysed
+	* frame, so a subject that does not leave — the parcel at the door, the
+	* parked car — is an unbounded emitter. The key includes a coarse box, so a
+	* subject that actually moves keeps reporting while a stationary one does
+	* not.
+	*/
+	shouldReportZoneRefusal(r, memberships, timestamp) {
+		const cell = (v) => Math.round(v / ZONE_REFUSAL_BOX_CELL_PX);
+		const key = [
+			r.detClass,
+			r.reason,
+			memberships.map((m) => m.zoneId).join("+"),
+			cell(r.bbox.x),
+			cell(r.bbox.y),
+			cell(r.bbox.width),
+			cell(r.bbox.height)
+		].join("|");
+		const last = this.zoneRefusalLastReport.get(key);
+		if (last !== void 0 && timestamp - last < ZONE_REFUSAL_THROTTLE_MS) return false;
+		this.zoneRefusalLastReport.set(key, timestamp);
+		if (this.zoneRefusalLastReport.size > ZONE_REFUSAL_KEY_LIMIT) {
+			for (const [k, t] of this.zoneRefusalLastReport) if (timestamp - t >= ZONE_REFUSAL_THROTTLE_MS) this.zoneRefusalLastReport.delete(k);
 		}
-		return out;
+		return true;
 	}
-	/** How many zone-refusal events this processor has emitted — the measure that
-	*  says whether this path is a trickle or a storm. Read by the addon. */
+	/** How many refusals-in-zone this processor has SEEN — the measure that says
+	*  whether this path is a trickle or a storm, before any throttling. */
 	zoneRefusalEventsEmitted() {
 		return this.zoneRefusalEventCount;
 	}
@@ -36712,11 +36767,10 @@ var FrameProcessor = class {
 				frameHeight
 			};
 		};
-		const zoneRefusalEvents = this.eventsForRefusedDetectionsInZones(timestamp, frame, frameWidth, frameHeight);
+		this.reportRefusedDetectionsInZones(timestamp, frameWidth, frameHeight);
 		const withTrackId = rawEvents.filter((e) => e.detection.trackId);
 		const objectEvents = withTrackId.filter((e) => e.type !== "object.detected").map((e) => toObjectEvent(e));
 		const appearanceEvents = withTrackId.filter((e) => e.type === "object.detected").map((e) => toObjectEvent(e, "entered"));
-		objectEvents.push(...zoneRefusalEvents);
 		return {
 			deviceId: this.deviceId,
 			timestamp,
@@ -77480,6 +77534,15 @@ var PipelineAnalyticsAddon = class PipelineAnalyticsAddon extends BaseAddon {
 					}
 				});
 			});
+			p.setZoneRefusalObserver((observation) => {
+				this.ctx.logger.info("detection refused inside a watched zone — not notified", {
+					tags: { deviceId },
+					meta: {
+						source,
+						...observation
+					}
+				});
+			});
 			p.setSpawnBesideCoastingObserver((record) => {
 				this.ctx.logger.info("tracker: new id minted beside a live coasting track", {
 					tags: { deviceId },

package/package.json

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