@camstack/addon-post-analysis 1.2.210 → 1.2.211

package/dist/pipeline-analytics/index.js

@@ -34569,6 +34569,37 @@ var TWO_WHEELERS = new Set([
 function intersection(a, b) {
 	return Math.max(0, Math.min(a.x + a.w, b.x + b.w) - Math.max(a.x, b.x)) * Math.max(0, Math.min(a.y + a.h, b.y + b.h) - Math.max(a.y, b.y));
 }
+/**
+* The FOLDED subject's box: the union of the rider and the machine.
+*
+* The fold's whole claim is that the two halves are ONE subject. Until
+* 2026-09-08 the box that survived the fold was the MACHINE's alone, so every
+* consumer that cuts pixels from `TrackedDetectionOut.bbox` — the best-shot
+* thumbnail, `wideCentralSquareLayout`'s central square, the close-time
+* keyFrame→thumbnail derive — framed a motorcycle with its rider's head cut
+* off. Operator, device 617, tracks `7f50622b` and `9cbc4791`, three minutes
+* apart: "motocicli e veicoli a due ruote devono includere il conducente nel
+* keyframe" (D407).
+*
+* This is the ONE place the folded subject's rectangle is formed, and it is
+* formed BEFORE the tracker — so no crop path derives a second rectangle
+* (D52 stays intact: `deriveDetailCropRect` is still the only detail-crop
+* derivation, and it now receives a subject box that already holds the rider).
+* Pure geometry: a strict union, never a pad — the fold widens the subject, it
+* never moves it.
+*/
+function riderSubjectBox(person, vehicle) {
+	const x = Math.min(person.x, vehicle.x);
+	const y = Math.min(person.y, vehicle.y);
+	const right = Math.max(person.x + person.w, vehicle.x + vehicle.w);
+	const bottom = Math.max(person.y + person.h, vehicle.y + vehicle.h);
+	return {
+		x,
+		y,
+		w: right - x,
+		h: bottom - y
+	};
+}
 /** True when `vehicle` is a two-wheeler that `person` is riding. */
 function isRiderPair(person, vehicle) {
 	if (person.macroClass !== "person") return false;
@@ -36335,17 +36366,64 @@ var FrameProcessor = class {
 		const foldByVehicleBbox = /* @__PURE__ */ new Map();
 		if (riderPairs.length > 0) {
 			const riderIdx = new Set(riderPairs.map((p) => Number(p.personId)));
+			/**
+			* Move every bbox-OBJECT-keyed side table from the machine's box to the
+			* folded subject's box (D407).
+			*
+			* This file carries frame-local facts across the tracker by bbox-object
+			* REFERENCE (`labelsByBbox`, `embeddingByBbox`, `maskByBbox`, …); the
+			* tracker then assigns `track.bbox = det.bbox`, and the emit block below
+			* reads every one of those maps with `td.bbox`. Widening the subject
+			* therefore means the widened box must inherit the machine's entries —
+			* otherwise a folded rider silently loses its vehicle-classifier label
+			* ("Motorcycle"), its mask, its plate read and its source id. One place,
+			* exhaustive, next to the maps it moves.
+			*/
+			const adoptSubjectBox = (from, to) => {
+				const labels = labelsByBbox.get(from);
+				if (labels !== void 0) labelsByBbox.set(to, labels);
+				const tier = originalClassTierByBbox.get(from);
+				if (tier !== void 0) originalClassTierByBbox.set(to, tier);
+				const embedding = embeddingByBbox.get(from);
+				if (embedding !== void 0) embeddingByBbox.set(to, embedding);
+				const mask = maskByBbox.get(from);
+				if (mask !== void 0) maskByBbox.set(to, mask);
+				const plate = plateByBbox.get(from);
+				if (plate !== void 0) plateByBbox.set(to, plate);
+				const faceBbox = faceBboxByBbox.get(from);
+				if (faceBbox !== void 0) faceBboxByBbox.set(to, faceBbox);
+				const faceSize = nativeFaceSizeByBbox.get(from);
+				if (faceSize !== void 0) nativeFaceSizeByBbox.set(to, faceSize);
+				const alignedCrop = faceAlignedCropByBbox.get(from);
+				if (alignedCrop !== void 0) faceAlignedCropByBbox.set(to, alignedCrop);
+				const sourceId = sourceIdByBbox.get(from);
+				if (sourceId !== void 0) {
+					sourceIdByBbox.set(to, sourceId);
+					firstLevelBboxById.set(sourceId, to);
+				}
+			};
+			/** Folded vehicles, by their index in `filteredDetections`. */
+			const foldedVehicles = /* @__PURE__ */ new Map();
 			for (const p of riderPairs) {
-				const vehicle = filteredDetections[Number(p.vehicleId)];
-				if (vehicle === void 0) continue;
-				foldByVehicleBbox.set(vehicle.bbox, {
+				const vehicleIdx = Number(p.vehicleId);
+				const vehicle = filteredDetections[vehicleIdx];
+				const person = filteredDetections[Number(p.personId)];
+				if (vehicle === void 0 || person === void 0) continue;
+				const subjectBox = riderSubjectBox(person.bbox, vehicle.bbox);
+				adoptSubjectBox(vehicle.bbox, subjectBox);
+				const folded = {
+					...vehicle,
+					bbox: subjectBox
+				};
+				foldedVehicles.set(vehicleIdx, folded);
+				foldByVehicleBbox.set(subjectBox, {
 					overlap: p.overlap,
-					personScore: filteredDetections[Number(p.personId)]?.score ?? 0,
+					personScore: person.score,
 					vehicleScore: vehicle.score,
 					vehicleClass: vehicle.originalClass ?? "two-wheeler"
 				});
 			}
-			filteredDetections = filteredDetections.filter((_, i) => !riderIdx.has(i));
+			filteredDetections = filteredDetections.map((d, i) => foldedVehicles.get(i) ?? d).filter((_, i) => !riderIdx.has(i));
 		}
 		const gate = this.stationaryGate ? this.stationaryGate.filter({
 			detections: filteredDetections,
@@ -49068,10 +49146,9 @@ var FaceRecognizer = class {
 			margin: settings.margin,
 			minIdentitySamples: settings.minIdentitySamples
 		}) : /* @__PURE__ */ new Map();
-		if (this.deps.onSemanticMatch !== void 0) for (const c of matchCandidates) {
+		if (this.deps.onSemanticFace !== void 0) for (const c of matchCandidates) {
 			const match = matches.get(c.trackId);
-			if (match === void 0) continue;
-			this.deps.onSemanticMatch({
+			this.deps.onSemanticFace({
 				deviceId: input.deviceId,
 				trackId: c.trackId,
 				timestamp: input.timestamp,
@@ -49079,8 +49156,10 @@ var FaceRecognizer = class {
 				frameHeight: input.frameHeight,
 				bbox: c.bbox,
 				confidence: c.confidence,
-				matchScore: match.score,
-				identityId: match.identityId,
+				...match !== void 0 ? {
+					matchScore: match.score,
+					identityId: match.identityId
+				} : {},
 				...input.frameHandle !== void 0 ? { frameHandle: input.frameHandle } : {}
 			});
 		}
@@ -53427,6 +53506,19 @@ var DeferredBirthRegistry = class {
 	}
 };
 //#endregion
+//#region src/pipeline-analytics/pipeline/detail-semantic-gate.ts
+/** The detail `className` whose result IS the recognition. */
+var PLATE_CLASS = "plate";
+/**
+* The moment `className`'s detail result earns the semantic tier.
+*
+* `recognition` — promote as soon as the result exists (the plate read).
+* `label-write` — promote only once the track ACCEPTED the label.
+*/
+function detailSemanticTrigger(className) {
+	return className === PLATE_CLASS ? "recognition" : "label-write";
+}
+//#endregion
 //#region src/pipeline-analytics/pipeline/dropout-skip.ts
 function shouldSkipDropoutFrame(activeTrackCount, detectionCount, consecutiveSkips, cfg) {
 	if (!cfg.enabled) return false;
@@ -71126,18 +71218,18 @@ var PipelineAnalyticsAddon = class PipelineAnalyticsAddon extends require_dist.B
 			},
 			getKeyFrameMediaKey: (trackId) => this.residents.keyFrameKey(trackId),
 			emitFaceGalleryChanged: (payload) => this.emitFaceGalleryChanged(payload),
-			onSemanticMatch: (match) => this.promoteSemanticRecognition({
-				deviceId: match.deviceId,
-				trackId: match.trackId,
-				timestamp: match.timestamp,
-				bbox: match.bbox,
-				frameWidth: match.frameWidth,
-				frameHeight: match.frameHeight,
-				kind: "face",
-				score: match.matchScore,
-				confidence: match.confidence,
-				...match.frameHandle !== void 0 ? { frameHandle: match.frameHandle } : {}
-			}),
+			onSemanticFace: (face) => this.promoteSemanticRecognition({
+				deviceId: face.deviceId,
+				trackId: face.trackId,
+				timestamp: face.timestamp,
+				bbox: face.bbox,
+				frameWidth: face.frameWidth,
+				frameHeight: face.frameHeight,
+				kind: face.identityId !== void 0 ? "face" : "face-visible",
+				score: face.matchScore ?? face.confidence,
+				confidence: face.confidence,
+				...face.frameHandle !== void 0 ? { frameHandle: face.frameHandle } : {}
+			}, face.identityId !== void 0 ? "identified" : "evidence"),
 			onLiveHierarchy: (input) => this.requestTrackHierarchy(input),
 			logger: logger.child("FaceRecognizer")
 		});
@@ -74153,10 +74245,12 @@ var PipelineAnalyticsAddon = class PipelineAnalyticsAddon extends require_dist.B
 							} } : {}
 						});
 					}
+					if (detailSemanticTrigger(d.className) === "recognition") this.promoteSemanticRecognition(semanticFrameForDetailAttribution(deviceId, trackId, d, frame), "identified");
 				}
 				const resolved = d.className === "plate" ? this.plateRecognizer?.resolveLabelWithVehicle(d.label, d.score) ?? null : { text: d.label };
 				if (resolved !== null && resolved.text !== void 0) {
-					if ((await this.applyTrackEnrichmentLabel(deviceId, trackId, resolved.text, d, frame.timestamp, resolved.vehicleId)).trackWritten) this.promoteSemanticRecognition(semanticFrameForDetailAttribution(deviceId, trackId, d, frame));
+					const applied = await this.applyTrackEnrichmentLabel(deviceId, trackId, resolved.text, d, frame.timestamp, resolved.vehicleId);
+					if (detailSemanticTrigger(d.className) === "label-write" && applied.trackWritten) this.promoteSemanticRecognition(semanticFrameForDetailAttribution(deviceId, trackId, d, frame), "identified");
 				}
 			} else if (d.className === "plate") this.failureReport.notePlateRead(deviceId, d.bbox === void 0 ? REASON_NO_BBOX : REASON_EMPTY_READ);
 		} catch (err) {
@@ -74597,8 +74691,8 @@ var PipelineAnalyticsAddon = class PipelineAnalyticsAddon extends require_dist.B
 	*  when it wins and the frame's pixels are still reachable. Callers: the
 	*  FaceRecognizer's per-frame auto-match, and `routeDetailResults`' plate /
 	*  fine-classification attribution. */
-	promoteSemanticRecognition(input) {
-		this.recognizedTrackIds.add(input.trackId);
+	promoteSemanticRecognition(input, origin) {
+		if (origin === "identified") this.recognizedTrackIds.add(input.trackId);
 		const ctx = this.ctxIfReady;
 		if (ctx === null) return;
 		promoteSemanticBestFrame({

package/dist/pipeline-analytics/index.mjs

@@ -34544,6 +34544,37 @@ var TWO_WHEELERS = new Set([
 function intersection(a, b) {
 	return Math.max(0, Math.min(a.x + a.w, b.x + b.w) - Math.max(a.x, b.x)) * Math.max(0, Math.min(a.y + a.h, b.y + b.h) - Math.max(a.y, b.y));
 }
+/**
+* The FOLDED subject's box: the union of the rider and the machine.
+*
+* The fold's whole claim is that the two halves are ONE subject. Until
+* 2026-09-08 the box that survived the fold was the MACHINE's alone, so every
+* consumer that cuts pixels from `TrackedDetectionOut.bbox` — the best-shot
+* thumbnail, `wideCentralSquareLayout`'s central square, the close-time
+* keyFrame→thumbnail derive — framed a motorcycle with its rider's head cut
+* off. Operator, device 617, tracks `7f50622b` and `9cbc4791`, three minutes
+* apart: "motocicli e veicoli a due ruote devono includere il conducente nel
+* keyframe" (D407).
+*
+* This is the ONE place the folded subject's rectangle is formed, and it is
+* formed BEFORE the tracker — so no crop path derives a second rectangle
+* (D52 stays intact: `deriveDetailCropRect` is still the only detail-crop
+* derivation, and it now receives a subject box that already holds the rider).
+* Pure geometry: a strict union, never a pad — the fold widens the subject, it
+* never moves it.
+*/
+function riderSubjectBox(person, vehicle) {
+	const x = Math.min(person.x, vehicle.x);
+	const y = Math.min(person.y, vehicle.y);
+	const right = Math.max(person.x + person.w, vehicle.x + vehicle.w);
+	const bottom = Math.max(person.y + person.h, vehicle.y + vehicle.h);
+	return {
+		x,
+		y,
+		w: right - x,
+		h: bottom - y
+	};
+}
 /** True when `vehicle` is a two-wheeler that `person` is riding. */
 function isRiderPair(person, vehicle) {
 	if (person.macroClass !== "person") return false;
@@ -36310,17 +36341,64 @@ var FrameProcessor = class {
 		const foldByVehicleBbox = /* @__PURE__ */ new Map();
 		if (riderPairs.length > 0) {
 			const riderIdx = new Set(riderPairs.map((p) => Number(p.personId)));
+			/**
+			* Move every bbox-OBJECT-keyed side table from the machine's box to the
+			* folded subject's box (D407).
+			*
+			* This file carries frame-local facts across the tracker by bbox-object
+			* REFERENCE (`labelsByBbox`, `embeddingByBbox`, `maskByBbox`, …); the
+			* tracker then assigns `track.bbox = det.bbox`, and the emit block below
+			* reads every one of those maps with `td.bbox`. Widening the subject
+			* therefore means the widened box must inherit the machine's entries —
+			* otherwise a folded rider silently loses its vehicle-classifier label
+			* ("Motorcycle"), its mask, its plate read and its source id. One place,
+			* exhaustive, next to the maps it moves.
+			*/
+			const adoptSubjectBox = (from, to) => {
+				const labels = labelsByBbox.get(from);
+				if (labels !== void 0) labelsByBbox.set(to, labels);
+				const tier = originalClassTierByBbox.get(from);
+				if (tier !== void 0) originalClassTierByBbox.set(to, tier);
+				const embedding = embeddingByBbox.get(from);
+				if (embedding !== void 0) embeddingByBbox.set(to, embedding);
+				const mask = maskByBbox.get(from);
+				if (mask !== void 0) maskByBbox.set(to, mask);
+				const plate = plateByBbox.get(from);
+				if (plate !== void 0) plateByBbox.set(to, plate);
+				const faceBbox = faceBboxByBbox.get(from);
+				if (faceBbox !== void 0) faceBboxByBbox.set(to, faceBbox);
+				const faceSize = nativeFaceSizeByBbox.get(from);
+				if (faceSize !== void 0) nativeFaceSizeByBbox.set(to, faceSize);
+				const alignedCrop = faceAlignedCropByBbox.get(from);
+				if (alignedCrop !== void 0) faceAlignedCropByBbox.set(to, alignedCrop);
+				const sourceId = sourceIdByBbox.get(from);
+				if (sourceId !== void 0) {
+					sourceIdByBbox.set(to, sourceId);
+					firstLevelBboxById.set(sourceId, to);
+				}
+			};
+			/** Folded vehicles, by their index in `filteredDetections`. */
+			const foldedVehicles = /* @__PURE__ */ new Map();
 			for (const p of riderPairs) {
-				const vehicle = filteredDetections[Number(p.vehicleId)];
-				if (vehicle === void 0) continue;
-				foldByVehicleBbox.set(vehicle.bbox, {
+				const vehicleIdx = Number(p.vehicleId);
+				const vehicle = filteredDetections[vehicleIdx];
+				const person = filteredDetections[Number(p.personId)];
+				if (vehicle === void 0 || person === void 0) continue;
+				const subjectBox = riderSubjectBox(person.bbox, vehicle.bbox);
+				adoptSubjectBox(vehicle.bbox, subjectBox);
+				const folded = {
+					...vehicle,
+					bbox: subjectBox
+				};
+				foldedVehicles.set(vehicleIdx, folded);
+				foldByVehicleBbox.set(subjectBox, {
 					overlap: p.overlap,
-					personScore: filteredDetections[Number(p.personId)]?.score ?? 0,
+					personScore: person.score,
 					vehicleScore: vehicle.score,
 					vehicleClass: vehicle.originalClass ?? "two-wheeler"
 				});
 			}
-			filteredDetections = filteredDetections.filter((_, i) => !riderIdx.has(i));
+			filteredDetections = filteredDetections.map((d, i) => foldedVehicles.get(i) ?? d).filter((_, i) => !riderIdx.has(i));
 		}
 		const gate = this.stationaryGate ? this.stationaryGate.filter({
 			detections: filteredDetections,
@@ -48994,10 +49072,9 @@ var FaceRecognizer = class {
 			margin: settings.margin,
 			minIdentitySamples: settings.minIdentitySamples
 		}) : /* @__PURE__ */ new Map();
-		if (this.deps.onSemanticMatch !== void 0) for (const c of matchCandidates) {
+		if (this.deps.onSemanticFace !== void 0) for (const c of matchCandidates) {
 			const match = matches.get(c.trackId);
-			if (match === void 0) continue;
-			this.deps.onSemanticMatch({
+			this.deps.onSemanticFace({
 				deviceId: input.deviceId,
 				trackId: c.trackId,
 				timestamp: input.timestamp,
@@ -49005,8 +49082,10 @@ var FaceRecognizer = class {
 				frameHeight: input.frameHeight,
 				bbox: c.bbox,
 				confidence: c.confidence,
-				matchScore: match.score,
-				identityId: match.identityId,
+				...match !== void 0 ? {
+					matchScore: match.score,
+					identityId: match.identityId
+				} : {},
 				...input.frameHandle !== void 0 ? { frameHandle: input.frameHandle } : {}
 			});
 		}
@@ -53353,6 +53432,19 @@ var DeferredBirthRegistry = class {
 	}
 };
 //#endregion
+//#region src/pipeline-analytics/pipeline/detail-semantic-gate.ts
+/** The detail `className` whose result IS the recognition. */
+var PLATE_CLASS = "plate";
+/**
+* The moment `className`'s detail result earns the semantic tier.
+*
+* `recognition` — promote as soon as the result exists (the plate read).
+* `label-write` — promote only once the track ACCEPTED the label.
+*/
+function detailSemanticTrigger(className) {
+	return className === PLATE_CLASS ? "recognition" : "label-write";
+}
+//#endregion
 //#region src/pipeline-analytics/pipeline/dropout-skip.ts
 function shouldSkipDropoutFrame(activeTrackCount, detectionCount, consecutiveSkips, cfg) {
 	if (!cfg.enabled) return false;
@@ -71052,18 +71144,18 @@ var PipelineAnalyticsAddon = class PipelineAnalyticsAddon extends BaseAddon {
 			},
 			getKeyFrameMediaKey: (trackId) => this.residents.keyFrameKey(trackId),
 			emitFaceGalleryChanged: (payload) => this.emitFaceGalleryChanged(payload),
-			onSemanticMatch: (match) => this.promoteSemanticRecognition({
-				deviceId: match.deviceId,
-				trackId: match.trackId,
-				timestamp: match.timestamp,
-				bbox: match.bbox,
-				frameWidth: match.frameWidth,
-				frameHeight: match.frameHeight,
-				kind: "face",
-				score: match.matchScore,
-				confidence: match.confidence,
-				...match.frameHandle !== void 0 ? { frameHandle: match.frameHandle } : {}
-			}),
+			onSemanticFace: (face) => this.promoteSemanticRecognition({
+				deviceId: face.deviceId,
+				trackId: face.trackId,
+				timestamp: face.timestamp,
+				bbox: face.bbox,
+				frameWidth: face.frameWidth,
+				frameHeight: face.frameHeight,
+				kind: face.identityId !== void 0 ? "face" : "face-visible",
+				score: face.matchScore ?? face.confidence,
+				confidence: face.confidence,
+				...face.frameHandle !== void 0 ? { frameHandle: face.frameHandle } : {}
+			}, face.identityId !== void 0 ? "identified" : "evidence"),
 			onLiveHierarchy: (input) => this.requestTrackHierarchy(input),
 			logger: logger.child("FaceRecognizer")
 		});
@@ -74079,10 +74171,12 @@ var PipelineAnalyticsAddon = class PipelineAnalyticsAddon extends BaseAddon {
 							} } : {}
 						});
 					}
+					if (detailSemanticTrigger(d.className) === "recognition") this.promoteSemanticRecognition(semanticFrameForDetailAttribution(deviceId, trackId, d, frame), "identified");
 				}
 				const resolved = d.className === "plate" ? this.plateRecognizer?.resolveLabelWithVehicle(d.label, d.score) ?? null : { text: d.label };
 				if (resolved !== null && resolved.text !== void 0) {
-					if ((await this.applyTrackEnrichmentLabel(deviceId, trackId, resolved.text, d, frame.timestamp, resolved.vehicleId)).trackWritten) this.promoteSemanticRecognition(semanticFrameForDetailAttribution(deviceId, trackId, d, frame));
+					const applied = await this.applyTrackEnrichmentLabel(deviceId, trackId, resolved.text, d, frame.timestamp, resolved.vehicleId);
+					if (detailSemanticTrigger(d.className) === "label-write" && applied.trackWritten) this.promoteSemanticRecognition(semanticFrameForDetailAttribution(deviceId, trackId, d, frame), "identified");
 				}
 			} else if (d.className === "plate") this.failureReport.notePlateRead(deviceId, d.bbox === void 0 ? REASON_NO_BBOX : REASON_EMPTY_READ);
 		} catch (err) {
@@ -74523,8 +74617,8 @@ var PipelineAnalyticsAddon = class PipelineAnalyticsAddon extends BaseAddon {
 	*  when it wins and the frame's pixels are still reachable. Callers: the
 	*  FaceRecognizer's per-frame auto-match, and `routeDetailResults`' plate /
 	*  fine-classification attribution. */
-	promoteSemanticRecognition(input) {
-		this.recognizedTrackIds.add(input.trackId);
+	promoteSemanticRecognition(input, origin) {
+		if (origin === "identified") this.recognizedTrackIds.add(input.trackId);
 		const ctx = this.ctxIfReady;
 		if (ctx === null) return;
 		promoteSemanticBestFrame({

package/package.json

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