@camstack/addon-post-analysis 1.2.18 → 1.2.19

package/dist/pipeline-analytics/index.js

@@ -2302,16 +2302,28 @@ function resolveRuleThreshold(rule) {
 */
 var ZoneEngine = class {
 	/**
-	* Annotate a single detection with its zone memberships.
-	* Returns zones where the detection overlaps above any active
-	* rule's threshold (or the engine default if no rule sets one).
+	* Annotate a single detection with its zone memberships — every zone whose
+	* polygon the detection overlaps by MORE than `minOverlap` (0–1 fraction of
+	* the detection's own area).
+	*
+	* The previous version of this comment claimed memberships were returned
+	* "above any active rule's threshold"; they were not — the threshold was
+	* hardcoded to {@link MEMBERSHIP_MIN_OVERLAP} (zero) and no rule was ever
+	* consulted. Read the parameter, not this paragraph.
+	*
+	* `minOverlap` matters because membership is what lands on an event as
+	* `zones`, and a notification rule's `zones` condition is a plain set test
+	* over that field — so this, not the zone-RULE threshold, is what decides
+	* whether a zone-scoped notification fires. At the default of 0 a subject
+	* clipping a zone by one pixel counts as inside it (measured 2026-07-30: a
+	* dog overlapping `Aiuola` by 4.8% would have been stamped as in it).
 	*/
-	annotateDetection(bbox, zones, frameWidth, frameHeight, mask, maskWidth, maskHeight) {
+	annotateDetection(bbox, zones, frameWidth, frameHeight, mask, maskWidth, maskHeight, minOverlap = MEMBERSHIP_MIN_OVERLAP) {
 		const memberships = [];
 		for (const zone of zones) {
 			const pixelPolygon = zone.polygon.map((p) => normalizeToPixel(p, frameWidth, frameHeight));
 			const overlap = mask && maskWidth && maskHeight ? maskPolygonOverlap(mask, maskWidth, maskHeight, bbox, pixelPolygon, frameWidth, frameHeight) : bboxPolygonOverlap(bbox, pixelPolygon);
-			if (overlap > MEMBERSHIP_MIN_OVERLAP) memberships.push({
+			if (overlap > minOverlap) memberships.push({
 				zoneId: zone.id,
 				zoneName: zone.name,
 				overlap
@@ -2411,6 +2423,10 @@ var FrameProcessor = class {
 	* runners that haven't picked up the new gating yet.
 	*/
 	detectionRules;
+	/** See {@link setZoneMembershipMinOverlap}. 0 = any positive overlap. */
+	zoneMembershipMinOverlap;
+	/** See {@link getLastZoneOverlaps}. */
+	lastZoneOverlaps;
 	zoneEngine = new ZoneEngine();
 	/** Optional stationary-object gate (parked-object suppression). Null until
 	*  the addon wires it via {@link setStationaryGate}. */
@@ -2423,10 +2439,32 @@ var FrameProcessor = class {
 		this.eventEmitter = new DetectionEventEmitter(emitterConfig);
 		this.zones = [];
 		this.detectionRules = [];
+		this.zoneMembershipMinOverlap = 0;
+		this.lastZoneOverlaps = /* @__PURE__ */ new Map();
 	}
 	setZones(zones) {
 		this.zones = zones;
 	}
+	/**
+	* How much of a detection's box must lie inside a zone for the zone to be
+	* stamped onto it (0–1 fraction of the box's own area).
+	*
+	* DEFAULT 0 — byte-identical to the behaviour before 2026-07-31, where any
+	* positive overlap counted. Raising it is an operator decision and needs
+	* evidence: a bar set blind removes notifications silently, which is the
+	* failure mode this whole area keeps producing. {@link lastZoneOverlaps}
+	* exists so the distribution can be read before a number is picked.
+	*/
+	setZoneMembershipMinOverlap(minOverlap) {
+		this.zoneMembershipMinOverlap = Number.isFinite(minOverlap) && minOverlap >= 0 && minOverlap <= 1 ? minOverlap : 0;
+	}
+	/** Per-track zone memberships WITH their overlap fractions, from the most
+	*  recent frame. The engine computes these and the pipeline previously
+	*  discarded everything but the ids — which is why no amount of production
+	*  data could say how far inside the zone a notifying subject actually was. */
+	getLastZoneOverlaps() {
+		return this.lastZoneOverlaps;
+	}
 	setDetectionRules(rules) {
 		this.detectionRules = rules;
 	}
@@ -2537,11 +2575,14 @@ var FrameProcessor = class {
 		const objectStates = this.stateAnalyzer.analyze(trackedDetections, timestamp);
 		const rawEvents = this.eventEmitter.emit(trackedDetections, objectStates, [], [], String(this.deviceId));
 		const zonesByTrack = /* @__PURE__ */ new Map();
+		const overlapsByTrack = /* @__PURE__ */ new Map();
 		for (const td of trackedDetections) {
 			const m = maskByBbox.get(td.bbox);
-			const memberships = this.zoneEngine.annotateDetection(td.bbox, this.zones, frameWidth, frameHeight, m?.mask, m?.width, m?.height);
+			const memberships = this.zoneEngine.annotateDetection(td.bbox, this.zones, frameWidth, frameHeight, m?.mask, m?.width, m?.height, this.zoneMembershipMinOverlap);
 			zonesByTrack.set(td.trackId, memberships.map((m2) => m2.zoneId));
+			if (memberships.length > 0) overlapsByTrack.set(td.trackId, memberships);
 		}
+		this.lastZoneOverlaps = overlapsByTrack;
 		const tracked = trackedDetections.map((td) => {
 			const state = mapObjectStateToTrackState(objectStates.find((o) => o.trackId === td.trackId)?.state);
 			const label = resolveDetectionLabel({
@@ -4635,7 +4676,9 @@ var NcDispatcher = class {
 					ruleId: entry.ruleId,
 					target: target.name,
 					kind: target.kind,
-					recordKind: entry.recordKind
+					recordKind: entry.recordKind,
+					eventId: entry.recordId,
+					...entry.trackId !== void 0 ? { trackId: entry.trackId } : {}
 				}
 			});
 			return { ok: true };
@@ -4673,9 +4716,10 @@ var NcDispatcher = class {
 	async buildNotification(entry) {
 		const subject = entry.payload.subject;
 		const deviceName = await this.deps.getDeviceName(subject.deviceId).catch(() => null) ?? `camera ${subject.deviceId}`;
-		const vars = buildTemplateVars(entry, deviceName);
+		const zoneLabels = await resolveZoneLabels(this.deps.getZoneNames, subject.deviceId, subject.zones);
+		const vars = buildTemplateVars(entry, deviceName, zoneLabels);
 		const title = renderTemplate(entry.payload.template?.title, vars) ?? entry.payload.ruleName;
-		const body = renderTemplate(entry.payload.template?.body, vars) ?? defaultBody(entry, deviceName);
+		const body = renderTemplate(entry.payload.template?.body, vars) ?? defaultBody(entry, deviceName, zoneLabels);
 		const attachments = await this.withArtifactUrls(await this.resolveAttachments(entry));
 		const params = pickParams(entry.payload.params);
 		return {
@@ -4874,15 +4918,37 @@ var NcDispatcher = class {
 		return null;
 	}
 };
-function buildTemplateVars(entry, deviceName) {
+/**
+* Map admin zone IDs to their display names for rendering only.
+*
+* Order follows `zoneIds` (the order the track visited them), not the zone
+* catalog. Every failure mode degrades to the ID rather than dropping the
+* zone: an unknown id, a blank name, a throwing lookup, or no lookup wired at
+* all. A body that silently loses a zone is worse than one that shows a UUID.
+*/
+async function resolveZoneLabels(getZoneNames, deviceId, zoneIds) {
+	if (zoneIds.length === 0) return [];
+	if (getZoneNames === void 0) return [...zoneIds];
+	try {
+		const zones = await getZoneNames(deviceId);
+		const byId = new Map(zones.map((z) => [z.id, z.name]));
+		return zoneIds.map((id) => {
+			const name = byId.get(id);
+			return name !== void 0 && name.trim().length > 0 ? name : id;
+		});
+	} catch {
+		return [...zoneIds];
+	}
+}
+function buildTemplateVars(entry, deviceName, zoneLabels) {
 	const subject = entry.payload.subject;
 	const occupancy = subject.occupancy;
 	return {
 		camera: deviceName,
 		class: subject.className,
 		label: subject.label ?? "",
-		zones: subject.zones.join(", "),
-		zone: occupancy?.zone ?? subject.zones[0] ?? "",
+		zones: zoneLabels.join(", "),
+		zone: occupancy?.zone ?? zoneLabels[0] ?? "",
 		confidence: subject.confidence !== void 0 ? `${Math.round(subject.confidence * 100)}%` : "",
 		time: new Date(subject.timestamp).toLocaleTimeString(),
 		rule: entry.payload.ruleName,
@@ -4900,12 +4966,12 @@ function renderTemplate(template, vars) {
 	if (template === void 0 || template.trim().length === 0) return null;
 	return template.replace(/\{\{\s*(\w+)\s*\}\}/g, (_m, name) => vars[name] ?? "");
 }
-function defaultBody(entry, deviceName) {
+function defaultBody(entry, deviceName, zoneLabels) {
 	const subject = entry.payload.subject;
 	const occupancy = subject.occupancy;
 	if (occupancy !== void 0) return `${occupancy.zone ?? deviceName} ${occupancyOpWord(occupancy.occupied)} (${occupancy.count}/${occupancy.capacity})`;
 	const label = subject.label !== void 0 ? ` (${subject.label})` : "";
-	const zones = subject.zones.length > 0 ? ` in ${subject.zones.join(", ")}` : "";
+	const zones = zoneLabels.length > 0 ? ` in ${zoneLabels.join(", ")}` : "";
 	const suffix = entry.recordKind === "track-end" ? " — visit ended" : "";
 	return `${subject.className}${label} on ${deviceName}${zones}${suffix}`;
 }
@@ -6683,7 +6749,9 @@ var NotificationCenter = class NotificationCenter {
 						rule: rule.name,
 						kind,
 						failed: evaluation.failedCondition,
-						classes: subject.classNames
+						classes: subject.classNames,
+						eventId: subject.recordId,
+						...subject.trackId !== void 0 ? { trackId: subject.trackId } : {}
 					}
 				});
 				continue;
@@ -6695,7 +6763,9 @@ var NotificationCenter = class NotificationCenter {
 					meta: {
 						ruleId: rule.id,
 						rule: rule.name,
-						key
+						key,
+						eventId: subject.recordId,
+						...subject.trackId !== void 0 ? { trackId: subject.trackId } : {}
 					}
 				});
 				continue;
@@ -6706,7 +6776,11 @@ var NotificationCenter = class NotificationCenter {
 					ruleId: rule.id,
 					rule: rule.name,
 					kind,
-					targets: rule.targets.length
+					targets: rule.targets.length,
+					eventId: subject.recordId,
+					...subject.trackId !== void 0 ? { trackId: subject.trackId } : {},
+					...subject.confidence !== void 0 ? { confidence: subject.confidence } : {},
+					...subject.zones.length > 0 ? { zones: subject.zones } : {}
 				}
 			});
 			const userTargets = await this.resolveUserTargets(rule, subject.deviceId);
@@ -13853,6 +13927,23 @@ function resolveDetectionSensitivitySettings(raw) {
 	};
 }
 var TrackingSettingsSchema = require_dist.object({
+	/**
+	* How much of a detection's box must lie inside a zone (0-1 fraction of the
+	* box's own area) for that zone to be STAMPED onto the detection.
+	*
+	* This is the field a zone-scoped notification rule ultimately depends on: a
+	* rule's `zones` condition is a plain set test over the stamped zone ids, so
+	* a subject that merely clips a zone edge satisfies it. Measured on
+	* 2026-07-30: a dog overlapping `Aiuola` by 4.8% would have counted as
+	* inside it.
+	*
+	* DEFAULT 0 — byte-identical to the behaviour before 2026-07-31. Raising it
+	* is deliberately an operator decision: the overlap fractions are now logged
+	* (`zone membership` lines), so the bar can be chosen from the distribution
+	* instead of guessed. Distinct from a zone RULE's `bboxInclusionPct`, which
+	* gates the DETECTION stage, not what gets stamped.
+	*/
+	zoneMembershipMinOverlap: require_dist.number().min(0).max(1).default(0),
 	/** IoU required to match a (predicted) track to a detection. */
 	iouThreshold: require_dist.number().min(0).max(1).default(.3),
 	/** Wall-clock coasting budget (ms) before a missed track is dropped. Time-
@@ -13989,6 +14080,7 @@ function resolveTrackingSettings(raw) {
 	const maxMissedMs = raw.maxMissedMs !== void 0 ? s.maxMissedMs.catch(TRACKING_DEFAULTS.maxMissedMs).parse(raw.maxMissedMs) : raw.maxMissedFrames !== void 0 ? Math.round(maxMissedFrames * 133) : TRACKING_DEFAULTS.maxMissedMs;
 	const occlusionMaxMissedMs = raw.occlusionMaxMissedMs !== void 0 ? s.occlusionMaxMissedMs.catch(TRACKING_DEFAULTS.occlusionMaxMissedMs).parse(raw.occlusionMaxMissedMs) : raw.occlusionMaxMissedFrames !== void 0 ? Math.round(occlusionMaxMissedFrames * 133) : TRACKING_DEFAULTS.occlusionMaxMissedMs;
 	return {
+		zoneMembershipMinOverlap: s.zoneMembershipMinOverlap.catch(TRACKING_DEFAULTS.zoneMembershipMinOverlap).parse(raw.zoneMembershipMinOverlap),
 		iouThreshold: s.iouThreshold.catch(TRACKING_DEFAULTS.iouThreshold).parse(raw.iouThreshold),
 		maxMissedMs,
 		minTrackAgeMs: s.minTrackAgeMs.catch(TRACKING_DEFAULTS.minTrackAgeMs).parse(raw.minTrackAgeMs),
@@ -14043,7 +14135,11 @@ function resolveTrackingSettings(raw) {
 * low-res detection frame (a static "person" phantom, a parked-truck ghost, a
 * misclassified static object).
 *
-* Ships DORMANT: `enabled` defaults to `false`, so behaviour is byte-identical
+* ON by default (`enabled` defaults to TRUE). An earlier version of this line
+* said "Ships DORMANT: `enabled` defaults to `false`" — that was stale, and on
+* 2026-07-30 it nearly produced the conclusion that the gate was not running at
+* all. It is: it suppressed several phantom births on device 615 that same day.
+* Read the schema, not this paragraph. Historically the intent was byte-identical
 * to today until an operator opts in per camera. The gate is fail-OPEN — any
 * missing frame handle, unavailable inference cap, crop-fetch miss, re-detection
 * error, or timeout ALLOWS the birth (a real track is never suppressed because
@@ -14139,10 +14235,11 @@ function isConfirmationCompatible(trackClassName, detectionMacroClass) {
 	if (track === "other" || det === "other") return true;
 	return track === det;
 }
-var failOpen = (trackId, reason) => ({
-	trackId,
+var failOpen = (candidate, reason) => ({
+	trackId: candidate.trackId,
 	confirmed: true,
-	reason
+	reason,
+	className: candidate.className
 });
 function withTimeout(promise, timeoutMs) {
 	return new Promise((resolve, reject) => {
@@ -14158,23 +14255,34 @@ function withTimeout(promise, timeoutMs) {
 }
 async function runConfirmation(candidate, config, deps) {
 	const crop = await deps.fetchCrop(candidate);
-	if (!crop) return failOpen(candidate.trackId, "no-crop");
+	if (!crop) return failOpen(candidate, "no-crop");
 	const detections = await deps.redetect(crop);
-	if (detections === null) return failOpen(candidate.trackId, "redetect-error");
-	const confirmed = detections.some((d) => d.score >= config.minConfidence && isConfirmationCompatible(candidate.className, d.macroClass));
+	if (detections === null) return failOpen(candidate, "redetect-error");
+	let best;
+	let bestIncompatible;
+	for (const d of detections) if (isConfirmationCompatible(candidate.className, d.macroClass)) {
+		if (!best || d.score > best.score) best = d;
+	} else if (!bestIncompatible || d.score > bestIncompatible.score) bestIncompatible = d;
+	const confirmed = best !== void 0 && best.score >= config.minConfidence;
 	return {
 		trackId: candidate.trackId,
 		confirmed,
-		reason: confirmed ? "confirmed" : "suppressed"
+		reason: confirmed ? "confirmed" : "suppressed",
+		className: candidate.className,
+		...best ? { bestScore: best.score } : {},
+		...bestIncompatible ? {
+			bestIncompatibleClass: bestIncompatible.macroClass,
+			bestIncompatibleScore: bestIncompatible.score
+		} : {}
 	};
 }
 async function confirmOne(candidate, config, deps) {
 	const cropPx = Math.max(candidate.bbox.w, candidate.bbox.h);
-	if (config.minCropPx > 0 && cropPx < config.minCropPx) return failOpen(candidate.trackId, "below-min-crop");
+	if (config.minCropPx > 0 && cropPx < config.minCropPx) return failOpen(candidate, "below-min-crop");
 	try {
 		return await withTimeout(runConfirmation(candidate, config, deps), config.timeoutMs);
 	} catch {
-		return failOpen(candidate.trackId, "timeout");
+		return failOpen(candidate, "timeout");
 	}
 }
 /**
@@ -14357,8 +14465,23 @@ function resolveMediaSettings(raw) {
 * §3.3 draft said 45s).
 */
 var PackageDropSettingsSchema = require_dist.object({
-	/** Master switch — off by default; opt-in per camera (porch/door cams). */
-	packageDropEnabled: require_dist.boolean().default(false),
+	/**
+	* Explicit per-camera OFF. **On by default: the ZONE RULE is what enables
+	* package detection**, not a second switch.
+	*
+	* As an opt-in default-false this was a parallel source of truth. Device 615
+	* on 2026-07-30 had the zone (`Uscio`), an enabled `package`-stage zone rule
+	* (`Pacchetti`, classFilter `['package']`), and a notification rule on
+	* `delivery: 'package-event'` — three layers of operator intent, all defeated
+	* silently by a boolean none of them mentions.
+	*
+	* Defaulting to true costs nothing on cameras nobody configured:
+	* `PackageDropDetector.onAppeared` still returns early when the device has no
+	* enabled `package`-stage rule, so the work is a class check plus one cached
+	* lookup. Set this false to force the feature off on a camera that HAS a zone
+	* rule.
+	*/
+	packageDropEnabled: require_dist.boolean().default(true),
 	/**
 	* Minimum OBSERVED dwell (seconds, since first-seen) before a newly
 	* promoted stationary package counts as a delivery. Kills a bag briefly
@@ -19577,7 +19700,21 @@ function decodeEmbeddingBase64(base64) {
 	const view = new Float32Array(bytes.buffer, bytes.byteOffset, Math.floor(bytes.byteLength / 4));
 	return Array.from(view);
 }
+/** A track shorter than this is a candidate phantom, not a subject that came
+*  and went. Brackets the observed plant tracks (3.8-19.0 s). */
+var SHORT_TRACK_MAX_MS = 25e3;
+/** Total displacement under this is "did not move at all" (observed: 0-2.5 px). */
+var MOTIONLESS_MAX_PX = 8;
+/** Grid the spawn point is quantised to, so respawns whose boxes never repeat
+*  to the pixel still land in one cell. */
+var PHANTOM_CELL_PX = 32;
+/** How long a cell remembers its closes. */
+var PHANTOM_CELL_WINDOW_MS = 360 * 6e4;
 var PipelineAnalyticsAddon = class extends require_dist.BaseAddon {
+	/** Recent SHORT+MOTIONLESS track closes per `<device>:<class>:<cell>` —
+	*  see {@link noteShortMotionlessTrack}. Measurement only; each entry is
+	*  filtered against the 6-hour window on write, so it stays bounded. */
+	shortMotionlessCells = /* @__PURE__ */ new Map();
 	processors = /* @__PURE__ */ new Map();
 	trackStore = null;
 	/** Parked-object registry: promotes a track that stopped moving into a
@@ -19887,7 +20024,10 @@ var PipelineAnalyticsAddon = class extends require_dist.BaseAddon {
 					});
 				},
 				emitTrackLifecycle: (payload, timestampMs) => this.emitTrackLifecycle(payload, timestampMs),
-				onTrackClosed: (track, ownedMedia, info) => this.notificationCenter?.onTrackClosed(track, ownedMedia, info),
+				onTrackClosed: (track, ownedMedia, info) => {
+					this.noteShortMotionlessTrack(track);
+					return this.notificationCenter?.onTrackClosed(track, ownedMedia, info);
+				},
 				deriveThumbnailFromKeyFrame: async (input) => {
 					const derived = await deriveKeyFrameThumbnailJpeg({
 						...input,
@@ -20374,6 +20514,12 @@ var PipelineAnalyticsAddon = class extends require_dist.BaseAddon {
 				};
 			},
 			dispatcher: {
+				getZoneNames: async (deviceId) => {
+					return (await api.zones.listZones.query({ deviceId })).map((z) => ({
+						id: z.id,
+						name: z.name
+					}));
+				},
 				getZonePolygons: async (deviceId, zoneIds) => {
 					const zones = await api.zones.listZones.query({ deviceId });
 					const wanted = new Set(zoneIds);
@@ -20751,6 +20897,7 @@ var PipelineAnalyticsAddon = class extends require_dist.BaseAddon {
 		const liveRules = proxy?.state.zoneRules.value?.detection ?? [];
 		processor.setZones(liveZones);
 		processor.setDetectionRules(liveRules);
+		processor.setZoneMembershipMinOverlap(trk.zoneMembershipMinOverlap);
 		const result = processor.process({
 			timestamp: frame.timestamp,
 			frame
@@ -20981,7 +21128,29 @@ var PipelineAnalyticsAddon = class extends require_dist.BaseAddon {
 			} });
 		}
 		await Promise.all([...result.objectEvents, ...result.appearanceEvents].map((e) => this.eventStore.insertObject(e)));
-		if (this.notificationCenter !== null) for (const e of result.objectEvents) this.notificationCenter.onObjectEventPersisted(e);
+		if (this.notificationCenter !== null) {
+			const overlaps = processor.getLastZoneOverlaps();
+			for (const e of result.objectEvents) {
+				if (e.zones && e.zones.length > 0) {
+					const m = e.trackId ? overlaps.get(e.trackId) : void 0;
+					this.ctx.logger.info("zone membership stamped on event", {
+						tags: { deviceId },
+						meta: {
+							eventId: e.id,
+							trackId: e.trackId,
+							className: e.className,
+							minOverlap: trk.zoneMembershipMinOverlap,
+							zones: (m ?? []).map((z) => ({
+								id: z.zoneId,
+								name: z.zoneName,
+								overlapPct: Math.round(z.overlap * 1e3) / 10
+							}))
+						}
+					});
+				}
+				this.notificationCenter.onObjectEventPersisted(e);
+			}
+		}
 		const objectEmbeddingBests = [];
 		if (this.objectEmbeddingStore) for (const t of result.tracked) {
 			if (!isClipObjectEmbedding(t)) continue;
@@ -21333,19 +21502,28 @@ var PipelineAnalyticsAddon = class extends require_dist.BaseAddon {
 			}),
 			redetect: (cropJpeg) => this.redetectCropForConfirmation(nodeId, deviceId, cropJpeg),
 			onDecision: (decision) => {
+				const meta = {
+					trackId: decision.trackId,
+					reason: decision.reason,
+					className: decision.className,
+					...decision.bestScore !== void 0 ? { bestScore: decision.bestScore } : {},
+					...decision.bestIncompatibleClass !== void 0 ? {
+						bestIncompatibleClass: decision.bestIncompatibleClass,
+						bestIncompatibleScore: decision.bestIncompatibleScore
+					} : {},
+					minConfidence: config.minConfidence
+				};
 				if (!decision.confirmed) this.ctx.logger.info("confirmation gate: birth suppressed (false positive)", {
 					tags: { deviceId },
-					meta: {
-						trackId: decision.trackId,
-						reason: decision.reason
-					}
+					meta
 				});
 				else if (decision.reason !== "confirmed") this.ctx.logger.debug("confirmation gate: birth allowed (fail-open)", {
 					tags: { deviceId },
-					meta: {
-						trackId: decision.trackId,
-						reason: decision.reason
-					}
+					meta
+				});
+				else this.ctx.logger.info("confirmation gate: birth confirmed", {
+					tags: { deviceId },
+					meta
 				});
 			}
 		});
@@ -21362,6 +21540,48 @@ var PipelineAnalyticsAddon = class extends require_dist.BaseAddon {
 	async resolveDeviceStationarySettings(deviceId) {
 		return this.stationarySettingsCache.get(deviceId, (id) => this.readDeviceSettings(id, resolveStationarySettings));
 	}
+	/**
+	* Count SHORT + MOTIONLESS track closes per frame cell.
+	*
+	* The stationary registry cannot see this class of phantom. Promotion needs a
+	* track that has EXISTED for `PROMOTION_WINDOW_MS` (30 s), and these die long
+	* before: the dead ornamental grass on device 615 produced tracks of 3.8 s,
+	* 4.1 s, 6.5 s and 19.0 s with 0-2.5 px of total displacement, roughly
+	* fifteen of them in a day, all at the same spot. Each one is individually
+	* innocent; the RECURRENCE is the signal, and nothing survives a track death
+	* to notice it.
+	*
+	* Lowering the promotion window is not the fix — those 30 s exist so someone
+	* standing still at a door is not declared scenery.
+	*
+	* This is the measurement half: it establishes how often a cell repeats
+	* before any suppression is built, so "N closes in what window" comes from
+	* data rather than intuition. It suppresses NOTHING.
+	*/
+	noteShortMotionlessTrack(track) {
+		const lifeMs = track.lastSeen - track.firstSeen;
+		const moved = track.totalDistance ?? 0;
+		if (lifeMs > SHORT_TRACK_MAX_MS || moved > MOTIONLESS_MAX_PX) return;
+		const first = track.positions?.[0];
+		if (!first) return;
+		const cell = `${Math.round(first.x / PHANTOM_CELL_PX)},${Math.round(first.y / PHANTOM_CELL_PX)}`;
+		const key = `${track.deviceId}:${track.className}:${cell}`;
+		const now = Date.now();
+		const seen = this.shortMotionlessCells.get(key)?.filter((t) => now - t < PHANTOM_CELL_WINDOW_MS) ?? [];
+		seen.push(now);
+		this.shortMotionlessCells.set(key, seen);
+		this.ctx.logger.info("short motionless track closed", {
+			tags: { deviceId: track.deviceId },
+			meta: {
+				trackId: track.trackId,
+				className: track.className,
+				lifeMs,
+				movedPx: Math.round(moved * 10) / 10,
+				cell,
+				repeatsInWindow: seen.length
+			}
+		});
+	}
 	stationarySettingsFromCache(deviceId) {
 		return this.stationarySettingsCache.peek(deviceId) ?? STATIONARY_DEFAULTS;
 	}
@@ -21371,9 +21591,14 @@ var PipelineAnalyticsAddon = class extends require_dist.BaseAddon {
 	/**
 	* Resolve a device's ENABLED `package`-stage zone rules independent of the
 	* live frame path (mirrors `resolveDeviceZones`). Warms the proxy and,
-	* when the cached slice is empty, forces one refresh. The `package` slice
-	* is written by the orchestrator's package-stage provider (a later slice);
-	* until then this returns `[]` and no package events fire.
+	* when the cached slice is empty, forces one refresh.
+	*
+	* The `package` slice is written through the `zone-rules` capability
+	* (`zoneRules.setRules({stage:'package'})`), which is live. An earlier
+	* version of this comment claimed the provider did not exist yet and that
+	* "no package events fire" — that was stale, and believing it produced a
+	* confidently wrong diagnosis on 2026-07-30. An empty list here means the
+	* operator has drawn no package zone rule, nothing more.
 	*/
 	async resolveDevicePackageRules(deviceId) {
 		const proxy = await this.ensureProxy(deviceId);

package/dist/pipeline-analytics/index.mjs

@@ -2296,16 +2296,28 @@ function resolveRuleThreshold(rule) {
 */
 var ZoneEngine = class {
 	/**
-	* Annotate a single detection with its zone memberships.
-	* Returns zones where the detection overlaps above any active
-	* rule's threshold (or the engine default if no rule sets one).
+	* Annotate a single detection with its zone memberships — every zone whose
+	* polygon the detection overlaps by MORE than `minOverlap` (0–1 fraction of
+	* the detection's own area).
+	*
+	* The previous version of this comment claimed memberships were returned
+	* "above any active rule's threshold"; they were not — the threshold was
+	* hardcoded to {@link MEMBERSHIP_MIN_OVERLAP} (zero) and no rule was ever
+	* consulted. Read the parameter, not this paragraph.
+	*
+	* `minOverlap` matters because membership is what lands on an event as
+	* `zones`, and a notification rule's `zones` condition is a plain set test
+	* over that field — so this, not the zone-RULE threshold, is what decides
+	* whether a zone-scoped notification fires. At the default of 0 a subject
+	* clipping a zone by one pixel counts as inside it (measured 2026-07-30: a
+	* dog overlapping `Aiuola` by 4.8% would have been stamped as in it).
 	*/
-	annotateDetection(bbox, zones, frameWidth, frameHeight, mask, maskWidth, maskHeight) {
+	annotateDetection(bbox, zones, frameWidth, frameHeight, mask, maskWidth, maskHeight, minOverlap = MEMBERSHIP_MIN_OVERLAP) {
 		const memberships = [];
 		for (const zone of zones) {
 			const pixelPolygon = zone.polygon.map((p) => normalizeToPixel(p, frameWidth, frameHeight));
 			const overlap = mask && maskWidth && maskHeight ? maskPolygonOverlap(mask, maskWidth, maskHeight, bbox, pixelPolygon, frameWidth, frameHeight) : bboxPolygonOverlap(bbox, pixelPolygon);
-			if (overlap > MEMBERSHIP_MIN_OVERLAP) memberships.push({
+			if (overlap > minOverlap) memberships.push({
 				zoneId: zone.id,
 				zoneName: zone.name,
 				overlap
@@ -2405,6 +2417,10 @@ var FrameProcessor = class {
 	* runners that haven't picked up the new gating yet.
 	*/
 	detectionRules;
+	/** See {@link setZoneMembershipMinOverlap}. 0 = any positive overlap. */
+	zoneMembershipMinOverlap;
+	/** See {@link getLastZoneOverlaps}. */
+	lastZoneOverlaps;
 	zoneEngine = new ZoneEngine();
 	/** Optional stationary-object gate (parked-object suppression). Null until
 	*  the addon wires it via {@link setStationaryGate}. */
@@ -2417,10 +2433,32 @@ var FrameProcessor = class {
 		this.eventEmitter = new DetectionEventEmitter(emitterConfig);
 		this.zones = [];
 		this.detectionRules = [];
+		this.zoneMembershipMinOverlap = 0;
+		this.lastZoneOverlaps = /* @__PURE__ */ new Map();
 	}
 	setZones(zones) {
 		this.zones = zones;
 	}
+	/**
+	* How much of a detection's box must lie inside a zone for the zone to be
+	* stamped onto it (0–1 fraction of the box's own area).
+	*
+	* DEFAULT 0 — byte-identical to the behaviour before 2026-07-31, where any
+	* positive overlap counted. Raising it is an operator decision and needs
+	* evidence: a bar set blind removes notifications silently, which is the
+	* failure mode this whole area keeps producing. {@link lastZoneOverlaps}
+	* exists so the distribution can be read before a number is picked.
+	*/
+	setZoneMembershipMinOverlap(minOverlap) {
+		this.zoneMembershipMinOverlap = Number.isFinite(minOverlap) && minOverlap >= 0 && minOverlap <= 1 ? minOverlap : 0;
+	}
+	/** Per-track zone memberships WITH their overlap fractions, from the most
+	*  recent frame. The engine computes these and the pipeline previously
+	*  discarded everything but the ids — which is why no amount of production
+	*  data could say how far inside the zone a notifying subject actually was. */
+	getLastZoneOverlaps() {
+		return this.lastZoneOverlaps;
+	}
 	setDetectionRules(rules) {
 		this.detectionRules = rules;
 	}
@@ -2531,11 +2569,14 @@ var FrameProcessor = class {
 		const objectStates = this.stateAnalyzer.analyze(trackedDetections, timestamp);
 		const rawEvents = this.eventEmitter.emit(trackedDetections, objectStates, [], [], String(this.deviceId));
 		const zonesByTrack = /* @__PURE__ */ new Map();
+		const overlapsByTrack = /* @__PURE__ */ new Map();
 		for (const td of trackedDetections) {
 			const m = maskByBbox.get(td.bbox);
-			const memberships = this.zoneEngine.annotateDetection(td.bbox, this.zones, frameWidth, frameHeight, m?.mask, m?.width, m?.height);
+			const memberships = this.zoneEngine.annotateDetection(td.bbox, this.zones, frameWidth, frameHeight, m?.mask, m?.width, m?.height, this.zoneMembershipMinOverlap);
 			zonesByTrack.set(td.trackId, memberships.map((m2) => m2.zoneId));
+			if (memberships.length > 0) overlapsByTrack.set(td.trackId, memberships);
 		}
+		this.lastZoneOverlaps = overlapsByTrack;
 		const tracked = trackedDetections.map((td) => {
 			const state = mapObjectStateToTrackState(objectStates.find((o) => o.trackId === td.trackId)?.state);
 			const label = resolveDetectionLabel({
@@ -4629,7 +4670,9 @@ var NcDispatcher = class {
 					ruleId: entry.ruleId,
 					target: target.name,
 					kind: target.kind,
-					recordKind: entry.recordKind
+					recordKind: entry.recordKind,
+					eventId: entry.recordId,
+					...entry.trackId !== void 0 ? { trackId: entry.trackId } : {}
 				}
 			});
 			return { ok: true };
@@ -4667,9 +4710,10 @@ var NcDispatcher = class {
 	async buildNotification(entry) {
 		const subject = entry.payload.subject;
 		const deviceName = await this.deps.getDeviceName(subject.deviceId).catch(() => null) ?? `camera ${subject.deviceId}`;
-		const vars = buildTemplateVars(entry, deviceName);
+		const zoneLabels = await resolveZoneLabels(this.deps.getZoneNames, subject.deviceId, subject.zones);
+		const vars = buildTemplateVars(entry, deviceName, zoneLabels);
 		const title = renderTemplate(entry.payload.template?.title, vars) ?? entry.payload.ruleName;
-		const body = renderTemplate(entry.payload.template?.body, vars) ?? defaultBody(entry, deviceName);
+		const body = renderTemplate(entry.payload.template?.body, vars) ?? defaultBody(entry, deviceName, zoneLabels);
 		const attachments = await this.withArtifactUrls(await this.resolveAttachments(entry));
 		const params = pickParams(entry.payload.params);
 		return {
@@ -4868,15 +4912,37 @@ var NcDispatcher = class {
 		return null;
 	}
 };
-function buildTemplateVars(entry, deviceName) {
+/**
+* Map admin zone IDs to their display names for rendering only.
+*
+* Order follows `zoneIds` (the order the track visited them), not the zone
+* catalog. Every failure mode degrades to the ID rather than dropping the
+* zone: an unknown id, a blank name, a throwing lookup, or no lookup wired at
+* all. A body that silently loses a zone is worse than one that shows a UUID.
+*/
+async function resolveZoneLabels(getZoneNames, deviceId, zoneIds) {
+	if (zoneIds.length === 0) return [];
+	if (getZoneNames === void 0) return [...zoneIds];
+	try {
+		const zones = await getZoneNames(deviceId);
+		const byId = new Map(zones.map((z) => [z.id, z.name]));
+		return zoneIds.map((id) => {
+			const name = byId.get(id);
+			return name !== void 0 && name.trim().length > 0 ? name : id;
+		});
+	} catch {
+		return [...zoneIds];
+	}
+}
+function buildTemplateVars(entry, deviceName, zoneLabels) {
 	const subject = entry.payload.subject;
 	const occupancy = subject.occupancy;
 	return {
 		camera: deviceName,
 		class: subject.className,
 		label: subject.label ?? "",
-		zones: subject.zones.join(", "),
-		zone: occupancy?.zone ?? subject.zones[0] ?? "",
+		zones: zoneLabels.join(", "),
+		zone: occupancy?.zone ?? zoneLabels[0] ?? "",
 		confidence: subject.confidence !== void 0 ? `${Math.round(subject.confidence * 100)}%` : "",
 		time: new Date(subject.timestamp).toLocaleTimeString(),
 		rule: entry.payload.ruleName,
@@ -4894,12 +4960,12 @@ function renderTemplate(template, vars) {
 	if (template === void 0 || template.trim().length === 0) return null;
 	return template.replace(/\{\{\s*(\w+)\s*\}\}/g, (_m, name) => vars[name] ?? "");
 }
-function defaultBody(entry, deviceName) {
+function defaultBody(entry, deviceName, zoneLabels) {
 	const subject = entry.payload.subject;
 	const occupancy = subject.occupancy;
 	if (occupancy !== void 0) return `${occupancy.zone ?? deviceName} ${occupancyOpWord(occupancy.occupied)} (${occupancy.count}/${occupancy.capacity})`;
 	const label = subject.label !== void 0 ? ` (${subject.label})` : "";
-	const zones = subject.zones.length > 0 ? ` in ${subject.zones.join(", ")}` : "";
+	const zones = zoneLabels.length > 0 ? ` in ${zoneLabels.join(", ")}` : "";
 	const suffix = entry.recordKind === "track-end" ? " — visit ended" : "";
 	return `${subject.className}${label} on ${deviceName}${zones}${suffix}`;
 }
@@ -6677,7 +6743,9 @@ var NotificationCenter = class NotificationCenter {
 						rule: rule.name,
 						kind,
 						failed: evaluation.failedCondition,
-						classes: subject.classNames
+						classes: subject.classNames,
+						eventId: subject.recordId,
+						...subject.trackId !== void 0 ? { trackId: subject.trackId } : {}
 					}
 				});
 				continue;
@@ -6689,7 +6757,9 @@ var NotificationCenter = class NotificationCenter {
 					meta: {
 						ruleId: rule.id,
 						rule: rule.name,
-						key
+						key,
+						eventId: subject.recordId,
+						...subject.trackId !== void 0 ? { trackId: subject.trackId } : {}
 					}
 				});
 				continue;
@@ -6700,7 +6770,11 @@ var NotificationCenter = class NotificationCenter {
 					ruleId: rule.id,
 					rule: rule.name,
 					kind,
-					targets: rule.targets.length
+					targets: rule.targets.length,
+					eventId: subject.recordId,
+					...subject.trackId !== void 0 ? { trackId: subject.trackId } : {},
+					...subject.confidence !== void 0 ? { confidence: subject.confidence } : {},
+					...subject.zones.length > 0 ? { zones: subject.zones } : {}
 				}
 			});
 			const userTargets = await this.resolveUserTargets(rule, subject.deviceId);
@@ -13847,6 +13921,23 @@ function resolveDetectionSensitivitySettings(raw) {
 	};
 }
 var TrackingSettingsSchema = object({
+	/**
+	* How much of a detection's box must lie inside a zone (0-1 fraction of the
+	* box's own area) for that zone to be STAMPED onto the detection.
+	*
+	* This is the field a zone-scoped notification rule ultimately depends on: a
+	* rule's `zones` condition is a plain set test over the stamped zone ids, so
+	* a subject that merely clips a zone edge satisfies it. Measured on
+	* 2026-07-30: a dog overlapping `Aiuola` by 4.8% would have counted as
+	* inside it.
+	*
+	* DEFAULT 0 — byte-identical to the behaviour before 2026-07-31. Raising it
+	* is deliberately an operator decision: the overlap fractions are now logged
+	* (`zone membership` lines), so the bar can be chosen from the distribution
+	* instead of guessed. Distinct from a zone RULE's `bboxInclusionPct`, which
+	* gates the DETECTION stage, not what gets stamped.
+	*/
+	zoneMembershipMinOverlap: number().min(0).max(1).default(0),
 	/** IoU required to match a (predicted) track to a detection. */
 	iouThreshold: number().min(0).max(1).default(.3),
 	/** Wall-clock coasting budget (ms) before a missed track is dropped. Time-
@@ -13983,6 +14074,7 @@ function resolveTrackingSettings(raw) {
 	const maxMissedMs = raw.maxMissedMs !== void 0 ? s.maxMissedMs.catch(TRACKING_DEFAULTS.maxMissedMs).parse(raw.maxMissedMs) : raw.maxMissedFrames !== void 0 ? Math.round(maxMissedFrames * 133) : TRACKING_DEFAULTS.maxMissedMs;
 	const occlusionMaxMissedMs = raw.occlusionMaxMissedMs !== void 0 ? s.occlusionMaxMissedMs.catch(TRACKING_DEFAULTS.occlusionMaxMissedMs).parse(raw.occlusionMaxMissedMs) : raw.occlusionMaxMissedFrames !== void 0 ? Math.round(occlusionMaxMissedFrames * 133) : TRACKING_DEFAULTS.occlusionMaxMissedMs;
 	return {
+		zoneMembershipMinOverlap: s.zoneMembershipMinOverlap.catch(TRACKING_DEFAULTS.zoneMembershipMinOverlap).parse(raw.zoneMembershipMinOverlap),
 		iouThreshold: s.iouThreshold.catch(TRACKING_DEFAULTS.iouThreshold).parse(raw.iouThreshold),
 		maxMissedMs,
 		minTrackAgeMs: s.minTrackAgeMs.catch(TRACKING_DEFAULTS.minTrackAgeMs).parse(raw.minTrackAgeMs),
@@ -14037,7 +14129,11 @@ function resolveTrackingSettings(raw) {
 * low-res detection frame (a static "person" phantom, a parked-truck ghost, a
 * misclassified static object).
 *
-* Ships DORMANT: `enabled` defaults to `false`, so behaviour is byte-identical
+* ON by default (`enabled` defaults to TRUE). An earlier version of this line
+* said "Ships DORMANT: `enabled` defaults to `false`" — that was stale, and on
+* 2026-07-30 it nearly produced the conclusion that the gate was not running at
+* all. It is: it suppressed several phantom births on device 615 that same day.
+* Read the schema, not this paragraph. Historically the intent was byte-identical
 * to today until an operator opts in per camera. The gate is fail-OPEN — any
 * missing frame handle, unavailable inference cap, crop-fetch miss, re-detection
 * error, or timeout ALLOWS the birth (a real track is never suppressed because
@@ -14133,10 +14229,11 @@ function isConfirmationCompatible(trackClassName, detectionMacroClass) {
 	if (track === "other" || det === "other") return true;
 	return track === det;
 }
-var failOpen = (trackId, reason) => ({
-	trackId,
+var failOpen = (candidate, reason) => ({
+	trackId: candidate.trackId,
 	confirmed: true,
-	reason
+	reason,
+	className: candidate.className
 });
 function withTimeout(promise, timeoutMs) {
 	return new Promise((resolve, reject) => {
@@ -14152,23 +14249,34 @@ function withTimeout(promise, timeoutMs) {
 }
 async function runConfirmation(candidate, config, deps) {
 	const crop = await deps.fetchCrop(candidate);
-	if (!crop) return failOpen(candidate.trackId, "no-crop");
+	if (!crop) return failOpen(candidate, "no-crop");
 	const detections = await deps.redetect(crop);
-	if (detections === null) return failOpen(candidate.trackId, "redetect-error");
-	const confirmed = detections.some((d) => d.score >= config.minConfidence && isConfirmationCompatible(candidate.className, d.macroClass));
+	if (detections === null) return failOpen(candidate, "redetect-error");
+	let best;
+	let bestIncompatible;
+	for (const d of detections) if (isConfirmationCompatible(candidate.className, d.macroClass)) {
+		if (!best || d.score > best.score) best = d;
+	} else if (!bestIncompatible || d.score > bestIncompatible.score) bestIncompatible = d;
+	const confirmed = best !== void 0 && best.score >= config.minConfidence;
 	return {
 		trackId: candidate.trackId,
 		confirmed,
-		reason: confirmed ? "confirmed" : "suppressed"
+		reason: confirmed ? "confirmed" : "suppressed",
+		className: candidate.className,
+		...best ? { bestScore: best.score } : {},
+		...bestIncompatible ? {
+			bestIncompatibleClass: bestIncompatible.macroClass,
+			bestIncompatibleScore: bestIncompatible.score
+		} : {}
 	};
 }
 async function confirmOne(candidate, config, deps) {
 	const cropPx = Math.max(candidate.bbox.w, candidate.bbox.h);
-	if (config.minCropPx > 0 && cropPx < config.minCropPx) return failOpen(candidate.trackId, "below-min-crop");
+	if (config.minCropPx > 0 && cropPx < config.minCropPx) return failOpen(candidate, "below-min-crop");
 	try {
 		return await withTimeout(runConfirmation(candidate, config, deps), config.timeoutMs);
 	} catch {
-		return failOpen(candidate.trackId, "timeout");
+		return failOpen(candidate, "timeout");
 	}
 }
 /**
@@ -14351,8 +14459,23 @@ function resolveMediaSettings(raw) {
 * §3.3 draft said 45s).
 */
 var PackageDropSettingsSchema = object({
-	/** Master switch — off by default; opt-in per camera (porch/door cams). */
-	packageDropEnabled: boolean().default(false),
+	/**
+	* Explicit per-camera OFF. **On by default: the ZONE RULE is what enables
+	* package detection**, not a second switch.
+	*
+	* As an opt-in default-false this was a parallel source of truth. Device 615
+	* on 2026-07-30 had the zone (`Uscio`), an enabled `package`-stage zone rule
+	* (`Pacchetti`, classFilter `['package']`), and a notification rule on
+	* `delivery: 'package-event'` — three layers of operator intent, all defeated
+	* silently by a boolean none of them mentions.
+	*
+	* Defaulting to true costs nothing on cameras nobody configured:
+	* `PackageDropDetector.onAppeared` still returns early when the device has no
+	* enabled `package`-stage rule, so the work is a class check plus one cached
+	* lookup. Set this false to force the feature off on a camera that HAS a zone
+	* rule.
+	*/
+	packageDropEnabled: boolean().default(true),
 	/**
 	* Minimum OBSERVED dwell (seconds, since first-seen) before a newly
 	* promoted stationary package counts as a delivery. Kills a bag briefly
@@ -19571,7 +19694,21 @@ function decodeEmbeddingBase64(base64) {
 	const view = new Float32Array(bytes.buffer, bytes.byteOffset, Math.floor(bytes.byteLength / 4));
 	return Array.from(view);
 }
+/** A track shorter than this is a candidate phantom, not a subject that came
+*  and went. Brackets the observed plant tracks (3.8-19.0 s). */
+var SHORT_TRACK_MAX_MS = 25e3;
+/** Total displacement under this is "did not move at all" (observed: 0-2.5 px). */
+var MOTIONLESS_MAX_PX = 8;
+/** Grid the spawn point is quantised to, so respawns whose boxes never repeat
+*  to the pixel still land in one cell. */
+var PHANTOM_CELL_PX = 32;
+/** How long a cell remembers its closes. */
+var PHANTOM_CELL_WINDOW_MS = 360 * 6e4;
 var PipelineAnalyticsAddon = class extends BaseAddon {
+	/** Recent SHORT+MOTIONLESS track closes per `<device>:<class>:<cell>` —
+	*  see {@link noteShortMotionlessTrack}. Measurement only; each entry is
+	*  filtered against the 6-hour window on write, so it stays bounded. */
+	shortMotionlessCells = /* @__PURE__ */ new Map();
 	processors = /* @__PURE__ */ new Map();
 	trackStore = null;
 	/** Parked-object registry: promotes a track that stopped moving into a
@@ -19881,7 +20018,10 @@ var PipelineAnalyticsAddon = class extends BaseAddon {
 					});
 				},
 				emitTrackLifecycle: (payload, timestampMs) => this.emitTrackLifecycle(payload, timestampMs),
-				onTrackClosed: (track, ownedMedia, info) => this.notificationCenter?.onTrackClosed(track, ownedMedia, info),
+				onTrackClosed: (track, ownedMedia, info) => {
+					this.noteShortMotionlessTrack(track);
+					return this.notificationCenter?.onTrackClosed(track, ownedMedia, info);
+				},
 				deriveThumbnailFromKeyFrame: async (input) => {
 					const derived = await deriveKeyFrameThumbnailJpeg({
 						...input,
@@ -20368,6 +20508,12 @@ var PipelineAnalyticsAddon = class extends BaseAddon {
 				};
 			},
 			dispatcher: {
+				getZoneNames: async (deviceId) => {
+					return (await api.zones.listZones.query({ deviceId })).map((z) => ({
+						id: z.id,
+						name: z.name
+					}));
+				},
 				getZonePolygons: async (deviceId, zoneIds) => {
 					const zones = await api.zones.listZones.query({ deviceId });
 					const wanted = new Set(zoneIds);
@@ -20745,6 +20891,7 @@ var PipelineAnalyticsAddon = class extends BaseAddon {
 		const liveRules = proxy?.state.zoneRules.value?.detection ?? [];
 		processor.setZones(liveZones);
 		processor.setDetectionRules(liveRules);
+		processor.setZoneMembershipMinOverlap(trk.zoneMembershipMinOverlap);
 		const result = processor.process({
 			timestamp: frame.timestamp,
 			frame
@@ -20975,7 +21122,29 @@ var PipelineAnalyticsAddon = class extends BaseAddon {
 			} });
 		}
 		await Promise.all([...result.objectEvents, ...result.appearanceEvents].map((e) => this.eventStore.insertObject(e)));
-		if (this.notificationCenter !== null) for (const e of result.objectEvents) this.notificationCenter.onObjectEventPersisted(e);
+		if (this.notificationCenter !== null) {
+			const overlaps = processor.getLastZoneOverlaps();
+			for (const e of result.objectEvents) {
+				if (e.zones && e.zones.length > 0) {
+					const m = e.trackId ? overlaps.get(e.trackId) : void 0;
+					this.ctx.logger.info("zone membership stamped on event", {
+						tags: { deviceId },
+						meta: {
+							eventId: e.id,
+							trackId: e.trackId,
+							className: e.className,
+							minOverlap: trk.zoneMembershipMinOverlap,
+							zones: (m ?? []).map((z) => ({
+								id: z.zoneId,
+								name: z.zoneName,
+								overlapPct: Math.round(z.overlap * 1e3) / 10
+							}))
+						}
+					});
+				}
+				this.notificationCenter.onObjectEventPersisted(e);
+			}
+		}
 		const objectEmbeddingBests = [];
 		if (this.objectEmbeddingStore) for (const t of result.tracked) {
 			if (!isClipObjectEmbedding(t)) continue;
@@ -21327,19 +21496,28 @@ var PipelineAnalyticsAddon = class extends BaseAddon {
 			}),
 			redetect: (cropJpeg) => this.redetectCropForConfirmation(nodeId, deviceId, cropJpeg),
 			onDecision: (decision) => {
+				const meta = {
+					trackId: decision.trackId,
+					reason: decision.reason,
+					className: decision.className,
+					...decision.bestScore !== void 0 ? { bestScore: decision.bestScore } : {},
+					...decision.bestIncompatibleClass !== void 0 ? {
+						bestIncompatibleClass: decision.bestIncompatibleClass,
+						bestIncompatibleScore: decision.bestIncompatibleScore
+					} : {},
+					minConfidence: config.minConfidence
+				};
 				if (!decision.confirmed) this.ctx.logger.info("confirmation gate: birth suppressed (false positive)", {
 					tags: { deviceId },
-					meta: {
-						trackId: decision.trackId,
-						reason: decision.reason
-					}
+					meta
 				});
 				else if (decision.reason !== "confirmed") this.ctx.logger.debug("confirmation gate: birth allowed (fail-open)", {
 					tags: { deviceId },
-					meta: {
-						trackId: decision.trackId,
-						reason: decision.reason
-					}
+					meta
+				});
+				else this.ctx.logger.info("confirmation gate: birth confirmed", {
+					tags: { deviceId },
+					meta
 				});
 			}
 		});
@@ -21356,6 +21534,48 @@ var PipelineAnalyticsAddon = class extends BaseAddon {
 	async resolveDeviceStationarySettings(deviceId) {
 		return this.stationarySettingsCache.get(deviceId, (id) => this.readDeviceSettings(id, resolveStationarySettings));
 	}
+	/**
+	* Count SHORT + MOTIONLESS track closes per frame cell.
+	*
+	* The stationary registry cannot see this class of phantom. Promotion needs a
+	* track that has EXISTED for `PROMOTION_WINDOW_MS` (30 s), and these die long
+	* before: the dead ornamental grass on device 615 produced tracks of 3.8 s,
+	* 4.1 s, 6.5 s and 19.0 s with 0-2.5 px of total displacement, roughly
+	* fifteen of them in a day, all at the same spot. Each one is individually
+	* innocent; the RECURRENCE is the signal, and nothing survives a track death
+	* to notice it.
+	*
+	* Lowering the promotion window is not the fix — those 30 s exist so someone
+	* standing still at a door is not declared scenery.
+	*
+	* This is the measurement half: it establishes how often a cell repeats
+	* before any suppression is built, so "N closes in what window" comes from
+	* data rather than intuition. It suppresses NOTHING.
+	*/
+	noteShortMotionlessTrack(track) {
+		const lifeMs = track.lastSeen - track.firstSeen;
+		const moved = track.totalDistance ?? 0;
+		if (lifeMs > SHORT_TRACK_MAX_MS || moved > MOTIONLESS_MAX_PX) return;
+		const first = track.positions?.[0];
+		if (!first) return;
+		const cell = `${Math.round(first.x / PHANTOM_CELL_PX)},${Math.round(first.y / PHANTOM_CELL_PX)}`;
+		const key = `${track.deviceId}:${track.className}:${cell}`;
+		const now = Date.now();
+		const seen = this.shortMotionlessCells.get(key)?.filter((t) => now - t < PHANTOM_CELL_WINDOW_MS) ?? [];
+		seen.push(now);
+		this.shortMotionlessCells.set(key, seen);
+		this.ctx.logger.info("short motionless track closed", {
+			tags: { deviceId: track.deviceId },
+			meta: {
+				trackId: track.trackId,
+				className: track.className,
+				lifeMs,
+				movedPx: Math.round(moved * 10) / 10,
+				cell,
+				repeatsInWindow: seen.length
+			}
+		});
+	}
 	stationarySettingsFromCache(deviceId) {
 		return this.stationarySettingsCache.peek(deviceId) ?? STATIONARY_DEFAULTS;
 	}
@@ -21365,9 +21585,14 @@ var PipelineAnalyticsAddon = class extends BaseAddon {
 	/**
 	* Resolve a device's ENABLED `package`-stage zone rules independent of the
 	* live frame path (mirrors `resolveDeviceZones`). Warms the proxy and,
-	* when the cached slice is empty, forces one refresh. The `package` slice
-	* is written by the orchestrator's package-stage provider (a later slice);
-	* until then this returns `[]` and no package events fire.
+	* when the cached slice is empty, forces one refresh.
+	*
+	* The `package` slice is written through the `zone-rules` capability
+	* (`zoneRules.setRules({stage:'package'})`), which is live. An earlier
+	* version of this comment claimed the provider did not exist yet and that
+	* "no package events fire" — that was stale, and believing it produced a
+	* confidently wrong diagnosis on 2026-07-30. An empty list here means the
+	* operator has drawn no package zone rule, nothing more.
 	*/
 	async resolveDevicePackageRules(deviceId) {
 		const proxy = await this.ensureProxy(deviceId);

package/package.json

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