@camstack/addon-post-analysis 1.2.625 → 1.2.627

package/dist/pipeline-analytics/index.js

@@ -2,7 +2,7 @@ Object.defineProperties(exports, {
 	__esModule: { value: true },
 	[Symbol.toStringTag]: { value: "Module" }
 });
-const require_clip_model_registry = require("../clip-model-registry-Bz5VWLtO.js");
+const require_clip_model_registry = require("../clip-model-registry-RSxtlgdN.js");
 let node_fs = require("node:fs");
 node_fs = require_clip_model_registry.__toESM(node_fs, 1);
 let node_path = require("node:path");
@@ -16404,6 +16404,18 @@ function gapDistance(a, b) {
 	if (last === void 0 || first === void 0 || first.timestamp < last.timestamp) return 0;
 	return Math.sqrt((first.x - last.x) ** 2 + (first.y - last.y) ** 2);
 }
+/**
+* WHERE a fused track was detected (D683 L2 fusion): it OPENED where its
+* earliest-born piece opened and CLOSED where its latest-seen piece was last
+* sighted — the same span `firstSeen` / `lastSeen` take, decided by the times
+* rather than by which piece survived (an absorbed piece can overlap and end
+* first). The placements of the pieces in between are not kept: the row
+* answers "where did this subject start and end", and a hop in the middle is
+* the `inference device selection` log's to tell. A piece with no placement
+* never erases the other's.
+*/
+var earlierOpened = (a, b) => b.firstSeen < a.firstSeen ? b.openedPlacement ?? a.openedPlacement : a.openedPlacement ?? b.openedPlacement;
+var laterClosed = (a, b) => b.lastSeen >= a.lastSeen ? b.closedPlacement ?? a.closedPlacement : a.closedPlacement ?? b.closedPlacement;
 var TRACK_MERGE_RULES = {
 	trackId: survivor$1("trackId"),
 	deviceId: survivor$1("deviceId"),
@@ -16444,6 +16456,8 @@ var TRACK_MERGE_RULES = {
 	hasRider: either$1("hasRider"),
 	closedReason: survivor$1("closedReason"),
 	provenance: survivor$1("provenance"),
+	openedPlacement: earlierOpened,
+	closedPlacement: laterClosed,
 	movedProbe: mergedMovedProbe,
 	keptAtPromotion: (a, b) => a.keptAtPromotion === true || b.keptAtPromotion === true ? true : void 0
 };
@@ -16485,6 +16499,8 @@ var TRACK_MERGE_KEYS = [
 	"hasRider",
 	"closedReason",
 	"provenance",
+	"openedPlacement",
+	"closedPlacement",
 	"movedProbe",
 	"keptAtPromotion"
 ];
@@ -16821,7 +16837,15 @@ var TRACKS_COLUMNS = [
 	{
 		name: "observations",
 		type: "INTEGER"
-	})
+	}),
+	{
+		name: "openedPlacement",
+		type: "JSON"
+	},
+	{
+		name: "closedPlacement",
+		type: "JSON"
+	}
 ];
 /**
 * The columns `rowToTrack` reads, per projection — the SELECT list the store
@@ -16968,7 +16992,9 @@ function cloneTrack(t) {
 		...t.provenance !== void 0 ? {
 			frameWidth: t.provenance.frameWidth,
 			frameHeight: t.provenance.frameHeight
-		} : {}
+		} : {},
+		...t.openedPlacement !== void 0 ? { openedPlacement: { ...t.openedPlacement } } : {},
+		...t.closedPlacement !== void 0 ? { closedPlacement: { ...t.closedPlacement } } : {}
 	};
 }
 /** Ids per set-based `benchPinned` statement — well under SQLite's bound
@@ -17116,7 +17142,11 @@ var TrackStore = class {
 				active: true,
 				lastSnapshotAt: 0,
 				movedProbe: stepMovedProbe(EMPTY_MOVED_PROBE, params.position.bbox),
-				...params.provenance !== void 0 ? { provenance: params.provenance } : {}
+				...params.provenance !== void 0 ? { provenance: params.provenance } : {},
+				...params.placement !== void 0 ? {
+					openedPlacement: params.placement,
+					closedPlacement: params.placement
+				} : {}
 			};
 		}
 		const existing = this.active.get(params.trackId);
@@ -17130,6 +17160,7 @@ var TrackStore = class {
 			const last = existing.positions[existing.positions.length - 1];
 			const dist = last ? Math.sqrt((params.position.x - last.x) ** 2 + (params.position.y - last.y) ** 2) : 0;
 			existing.lastSeen = params.timestamp;
+			if (params.placement !== void 0) existing.closedPlacement = params.placement;
 			existing.totalDistance += dist;
 			existing.state = params.state;
 			existing.movedProbe = stepMovedProbe(existing.movedProbe, params.position.bbox);
@@ -17155,7 +17186,11 @@ var TrackStore = class {
 			active: true,
 			lastSnapshotAt: 0,
 			movedProbe: stepMovedProbe(EMPTY_MOVED_PROBE, params.position.bbox),
-			...params.provenance !== void 0 ? { provenance: params.provenance } : {}
+			...params.provenance !== void 0 ? { provenance: params.provenance } : {},
+			...params.placement !== void 0 ? {
+				openedPlacement: params.placement,
+				closedPlacement: params.placement
+			} : {}
 		};
 		this.active.set(params.trackId, fresh);
 		return fresh;
@@ -18906,7 +18941,9 @@ var TrackStore = class {
 					frameWidth: dims.w,
 					frameHeight: dims.h
 				} : {},
-				...t.modelId !== void 0 ? { modelId: t.modelId } : {}
+				...t.modelId !== void 0 ? { modelId: t.modelId } : {},
+				...t.openedPlacement !== void 0 ? { openedPlacement: t.openedPlacement } : {},
+				...t.closedPlacement !== void 0 ? { closedPlacement: t.closedPlacement } : {}
 			}
 		});
 	}
@@ -18971,6 +19008,8 @@ var TrackStore = class {
 		*  string read, absent stays absent. */
 		const previewMissReason = data["previewMissReason"];
 		const modelId = data["modelId"];
+		const openedPlacement = require_clip_model_registry.TrackPlacementSchema.safeParse(data["openedPlacement"]);
+		const closedPlacement = require_clip_model_registry.TrackPlacementSchema.safeParse(data["closedPlacement"]);
 		const frameWidth = data["frameWidth"];
 		const frameHeight = data["frameHeight"];
 		const envMinX = data["envMinX"];
@@ -19023,7 +19062,9 @@ var TrackStore = class {
 			...typeof frameWidth === "number" && typeof frameHeight === "number" ? {
 				frameWidth,
 				frameHeight
-			} : {}
+			} : {},
+			...openedPlacement.success ? { openedPlacement: openedPlacement.data } : {},
+			...closedPlacement.success ? { closedPlacement: closedPlacement.data } : {}
 		});
 	}
 };
@@ -74889,6 +74930,16 @@ function trackProvenanceOf(frame) {
 	};
 }
 //#endregion
+//#region src/pipeline-analytics/pipeline/track-placement.ts
+function trackPlacementOf(frame, nodeId) {
+	if (nodeId.length === 0) return void 0;
+	return {
+		nodeId,
+		...frame.rootDeviceKey !== void 0 && frame.rootDeviceKey.length > 0 ? { deviceKey: frame.rootDeviceKey } : {},
+		...frame.rootModelId !== void 0 && frame.rootModelId.length > 0 ? { modelId: frame.rootModelId } : {}
+	};
+}
+//#endregion
 //#region src/pipeline-analytics/pipeline/best-detection-tracker.ts
 /**
 * `BestDetectionTracker` — the SINGLE canonical policy for "the best detection
@@ -83789,21 +83840,30 @@ async function measure(candidate, crop, config, deps, cropSource) {
 	if (detections === null) return undecided(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;
+	let bestRefused;
+	for (const d of detections) {
+		const compatible = isConfirmationCompatible(candidate.className, d.macroClass);
+		if (d.refusedByDetectorFloor === true) {
+			if (compatible && (!bestRefused || d.score > bestRefused.score)) bestRefused = d;
+			continue;
+		}
+		if (compatible) {
+			if (!best || d.score > best.score) best = d;
+		} else if (!bestIncompatible || d.score > bestIncompatible.score) bestIncompatible = d;
+	}
 	const bar = barFor(candidate, config, deps);
 	const confirmed = best !== void 0 && best.score >= bar;
 	if (!confirmed && cropSource !== "native") return undecided(candidate, cropSource === "fallback" ? "fallback-inconclusive" : "carried-inconclusive");
 	const secondary = bestIncompatible ? promoteSecondary(candidate, bestIncompatible, bar, deps) : null;
+	const scored = best ?? bestRefused;
 	return {
 		trackId: candidate.trackId,
 		verdict: confirmed ? "confirmed" : "suppressed",
-		reason: confirmed ? "confirmed" : "suppressed",
+		reason: confirmed ? "confirmed" : suppressionReason(best, bestRefused, bestIncompatible),
 		className: candidate.className,
 		appliedMinConfidence: bar,
 		cropSource,
-		...best ? { bestScore: best.score } : {},
+		...scored ? { bestScore: scored.score } : {},
 		...bestIncompatible ? {
 			bestIncompatibleClass: bestIncompatible.macroClass,
 			bestIncompatibleScore: bestIncompatible.score
@@ -83811,6 +83871,13 @@ async function measure(candidate, crop, config, deps, cropSource) {
 		...secondary ? { secondary } : {}
 	};
 }
+/** Why a measured native crop said no — first matching rule wins (D922). */
+function suppressionReason(best, bestRefused, bestIncompatible) {
+	if (best !== void 0) return "scored-below-threshold";
+	if (bestRefused !== void 0) return "below-detector-floor";
+	if (bestIncompatible !== void 0) return "incompatible-class";
+	return "no-detection";
+}
 /**
 * The incompatible best becomes a secondary subject when it clears the SAME
 * bar the candidate faced and can be placed in the frame. The crop-normalised
@@ -93000,11 +93067,37 @@ function buildBirthDecisionRecord(input) {
 		decidedByBirthEvidence: input.decidedByBirthEvidence,
 		bestScore: input.bestScore ?? null,
 		appliedMinConfidence: input.appliedMinConfidence ?? null,
+		cropSource: input.cropSource ?? null,
 		firstSeen,
 		...latency
 	};
 }
 //#endregion
+//#region src/pipeline-analytics/confirmation-redetect-result.ts
+/** Map a re-detect result to the gate's input; `null` when it carried no detections array. */
+function toConfirmationDetections(result) {
+	const detections = result?.detections;
+	if (!result || !detections) return null;
+	const cropWidth = result.width ?? 0;
+	const cropHeight = result.height ?? 0;
+	const kept = detections.map((d) => ({
+		macroClass: d.macroClass,
+		score: d.score,
+		...d.bbox !== void 0 && cropWidth > 0 && cropHeight > 0 ? { bbox: {
+			x: d.bbox.x / cropWidth,
+			y: d.bbox.y / cropHeight,
+			w: d.bbox.width / cropWidth,
+			h: d.bbox.height / cropHeight
+		} } : {}
+	}));
+	const refused = (result.discarded ?? []).filter((d) => d.reason === "below-threshold").map((d) => ({
+		macroClass: d.macroClass,
+		score: d.score,
+		refusedByDetectorFloor: true
+	}));
+	return [...kept, ...refused];
+}
+//#endregion
 //#region src/pipeline-analytics/pipeline/birth-evidence-store.ts
 /**
 * The pixels a birth arrived with, held for as long as its deferral can last —
@@ -118465,7 +118558,7 @@ var PipelineAnalyticsAddon = class PipelineAnalyticsAddon extends require_clip_m
 				}
 			});
 		}
-		await this.processFrame(deviceId, frame, data.source ?? "pipeline", data.frameHandle, data.detailSteps, data.occasion ?? "session");
+		await this.processFrame(deviceId, frame, data.source ?? "pipeline", data.frameHandle, data.detailSteps, data.occasion ?? "session", data.nodeId);
 	}
 	/**
 	* Run one detection frame through the analysis layers for a given
@@ -118739,7 +118832,7 @@ var PipelineAnalyticsAddon = class PipelineAnalyticsAddon extends require_clip_m
 			}
 		});
 	}
-	async processFrame(deviceId, frame, source, rawFrameHandle, detailSteps, occasion = "session") {
+	async processFrame(deviceId, frame, source, rawFrameHandle, detailSteps, occasion = "session", producerNodeId = "") {
 		if (this.shuttingDown) return;
 		if (detailSteps !== void 0) this.detailStepsByDevice.set(deviceId, detailSteps);
 		if (!await this.bindingCache.isActive(deviceId)) {
@@ -118926,6 +119019,7 @@ var PipelineAnalyticsAddon = class PipelineAnalyticsAddon extends require_clip_m
 		const currentTrackIds = /* @__PURE__ */ new Set();
 		const positionsCountById = /* @__PURE__ */ new Map();
 		const provenance = trackProvenanceOf(frame);
+		const placement = trackPlacementOf(frame, producerNodeId);
 		for (const t of result.tracked) {
 			currentTrackIds.add(t.trackId);
 			if (this.suppressedBirths.isRejected(key, t.trackId)) continue;
@@ -118950,7 +119044,8 @@ var PipelineAnalyticsAddon = class PipelineAnalyticsAddon extends require_clip_m
 				},
 				zones: t.zones,
 				state: t.state,
-				...provenance !== void 0 ? { provenance } : {}
+				...provenance !== void 0 ? { provenance } : {},
+				...placement !== void 0 ? { placement } : {}
 			});
 			positionsCountById.set(t.trackId, upserted.positions.length);
 		}
@@ -119144,16 +119239,25 @@ var PipelineAnalyticsAddon = class PipelineAnalyticsAddon extends require_clip_m
 				processor.markSuppressed(id);
 				this.trackStore?.dropActive(id);
 				this.clearLiveTrackState(deviceId, id);
-				log.info("birth suppressed — track record retracted", { meta: {
-					trackId: id,
-					className: t.className,
-					source,
-					...wasDeferred ? {
-						wasDeferred,
-						deferredForMs,
-						deferredAttempts
-					} : {}
-				} });
+				const suppression = run.decisions.get(id);
+				log.info("birth suppressed — track record retracted", {
+					tags: { deviceId },
+					meta: {
+						trackId: id,
+						className: t.className,
+						source,
+						reason: suppression?.reason ?? null,
+						bestScore: suppression?.bestScore ?? null,
+						appliedMinConfidence: suppression?.appliedMinConfidence ?? null,
+						cropSource: suppression?.cropSource ?? null,
+						attempts: deferredAttempts,
+						...wasDeferred ? {
+							wasDeferred,
+							deferredForMs,
+							deferredAttempts
+						} : {}
+					}
+				});
 				continue;
 			}
 			if (wasDeferred && exhaustedIds.has(id)) log.warn("birth allowed unmeasured — deferral exhausted, no crop available", { meta: {
@@ -119900,26 +120004,12 @@ var PipelineAnalyticsAddon = class PipelineAnalyticsAddon extends require_clip_m
 		const executor = this.pipelineExecutorApi();
 		if (!executor?.runPipeline) return null;
 		try {
-			const result = await executor.runPipeline.mutate({
+			return toConfirmationDetections(await executor.runPipeline.mutate({
 				steps: [step],
 				image: new Uint8Array(cropJpeg),
 				deviceId,
 				plane: "frame"
-			}, require_clip_model_registry.nodePin(nodeId));
-			const detections = result?.detections;
-			if (!detections) return null;
-			const cropWidth = result.width ?? 0;
-			const cropHeight = result.height ?? 0;
-			return detections.map((d) => ({
-				macroClass: d.macroClass,
-				score: d.score,
-				...d.bbox !== void 0 && cropWidth > 0 && cropHeight > 0 ? { bbox: {
-					x: d.bbox.x / cropWidth,
-					y: d.bbox.y / cropHeight,
-					w: d.bbox.width / cropWidth,
-					h: d.bbox.height / cropHeight
-				} } : {}
-			}));
+			}, require_clip_model_registry.nodePin(nodeId)));
 		} catch (err) {
 			this.ctx.logger.debug("confirmation gate: re-detection failed — fail-open", {
 				tags: { deviceId },
@@ -119980,6 +120070,7 @@ var PipelineAnalyticsAddon = class PipelineAnalyticsAddon extends require_clip_m
 			reason: decision?.reason ?? null,
 			bestScore: decision?.bestScore ?? null,
 			appliedMinConfidence: decision?.appliedMinConfidence ?? null,
+			cropSource: decision?.cropSource ?? null,
 			decidedAtMs: input.decidedAtMs,
 			firstSeen: input.firstSeen,
 			motionOnsetAtMs,