@camstack/addon-post-analysis 1.2.626 → 1.2.628

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-FGmg0uYz.js");
+const require_clip_model_registry = require("../clip-model-registry-CK0QHBLo.js");
 let node_fs = require("node:fs");
 node_fs = require_clip_model_registry.__toESM(node_fs, 1);
 let node_path = require("node:path");
@@ -9913,7 +9913,6 @@ var SCENE_LATCH_SPEC = {
 	fromRecord: latchFromRecord,
 	deviceIdOf: (row) => row.deviceId
 };
-SCENE_LATCH_SPEC.fromRecord, SCENE_LATCH_SPEC.toValue, SCENE_LATCH_SPEC.deviceIdOf;
 /**
 * The two ledgers behind one façade. Callers never see the split, but they can
 * never accidentally write one when they meant the other either: the config
@@ -16404,6 +16403,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 +16455,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 +16498,8 @@ var TRACK_MERGE_KEYS = [
 	"hasRider",
 	"closedReason",
 	"provenance",
+	"openedPlacement",
+	"closedPlacement",
 	"movedProbe",
 	"keptAtPromotion"
 ];
@@ -16821,7 +16836,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 +16991,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 +17141,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 +17159,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 +17185,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 +18940,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 +19007,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 +19061,9 @@ var TrackStore = class {
 			...typeof frameWidth === "number" && typeof frameHeight === "number" ? {
 				frameWidth,
 				frameHeight
-			} : {}
+			} : {},
+			...openedPlacement.success ? { openedPlacement: openedPlacement.data } : {},
+			...closedPlacement.success ? { closedPlacement: closedPlacement.data } : {}
 		});
 	}
 };
@@ -22287,6 +22327,8 @@ function proposalOrigin(source, index, facts) {
 		...facts.modelId !== void 0 ? { modelId: facts.modelId } : {}
 	};
 }
+//#endregion
+//#region src/pipeline-analytics/retrain/retrain-taxonomy.ts
 var MACRO_SET = new Set([
 	"person",
 	"vehicle",
@@ -25867,7 +25909,6 @@ var NC_ALERTS_SPEC = {
 	equalFact: (held, incoming) => held.alerting === incoming.alerting,
 	deviceIdOf: (row) => deviceIdOf(row.subject)
 };
-NC_ALERTS_SPEC.fromRecord, NC_ALERTS_SPEC.toValue, NC_ALERTS_SPEC.deviceIdOf;
 /**
 * Which row the boot settle keeps for one subject observed inside the window
 * (D698's rule, applied to the alert ledger).
@@ -30600,7 +30641,6 @@ var NC_DEVICE_PRUNES_SPEC = {
 	deviceIdOf: (row) => row.subjectKind === "device" ? Number(row.subject) : void 0,
 	loadLimit: LOAD_LIMIT$1
 };
-NC_DEVICE_PRUNES_SPEC.fromRecord, NC_DEVICE_PRUNES_SPEC.toValue, NC_DEVICE_PRUNES_SPEC.deviceIdOf;
 /** The outcomes that mean "this last reference was already dealt with". */
 var KEPT_OUTCOMES = new Set(["kept-disabled", "kept"]);
 var NcPruneLedger = class {
@@ -45607,7 +45647,6 @@ var NC_ALERT_EPISODES_SPEC = {
 		};
 	}
 };
-NC_ALERT_EPISODES_SPEC.fromRecord, NC_ALERT_EPISODES_SPEC.toValue;
 var NcAlertEpisodeLedger = class {
 	ledger;
 	constructor(deps) {
@@ -45765,6 +45804,8 @@ function occupancyClassWarning(className) {
 	if (className === void 0 || require_clip_model_registry.isDetectionMacroClass(className)) return null;
 	return `⚠ “${className}” is a sub-type, not a macro class: this counter is always 0 (use ${[...require_clip_model_registry.DETECTION_MACRO_CLASSES].join(" / ")})`;
 }
+//#endregion
+//#region src/notification-center/occupancy-store.ts
 /**
 * The mechanics, declared once.
 *
@@ -45916,7 +45957,6 @@ function recordToRow(key, data) {
 		updatedAt
 	};
 }
-NC_OCCUPANCY_SPEC.fromRecord, NC_OCCUPANCY_SPEC.toValue, NC_OCCUPANCY_SPEC.deviceIdOf;
 //#endregion
 //#region src/notification-center/outbox.ts
 /**
@@ -48387,7 +48427,6 @@ var NC_SNOOZES_SPEC = {
 	},
 	loadLimit: 1e3
 };
-NC_SNOOZES_SPEC.fromRecord, NC_SNOOZES_SPEC.toValue;
 var NcSnoozeStore = class {
 	windows;
 	/** The `snooze-suppressed` records kind (events.db): the counters. */
@@ -52485,7 +52524,6 @@ var NC_SYSTEM_STATE_SPEC = {
 	},
 	deviceIdOf: (row) => row.deviceId
 };
-NC_SYSTEM_STATE_SPEC.fromRecord, NC_SYSTEM_STATE_SPEC.toValue, NC_SYSTEM_STATE_SPEC.deviceIdOf;
 /** The hub's own node id when an update row names none. */
 var HUB_NODE = "hub";
 function isUpdateTarget(value) {
@@ -53571,6 +53609,8 @@ var NcStateSummaryScheduler = class {
 		}
 	}
 };
+//#endregion
+//#region src/notification-center/state-summary/state-summary-stamps.ts
 var SPEC = {
 	collection: "notification-center:state-summary-stamps",
 	columns: [
@@ -53618,7 +53658,6 @@ var SPEC = {
 	},
 	loadLimit: 1e4
 };
-SPEC.fromRecord, SPEC.toValue;
 var NcStateSummaryStampStore = class {
 	ledger;
 	constructor(deps) {
@@ -74847,8 +74886,8 @@ var TrackCloser = class {
 			}
 		});
 	}
-	/** Emit the deprecated thin `TrackEnded` alias + the unified lifecycle
-	*  `end` event (the FULL final summary — fires ONCE per real track). */
+	/** Emit the thin `TrackEnded` event + the unified lifecycle `end` event
+	*  (the FULL final summary — fires ONCE per real track). */
 	emitEndEvents(t, duration, trackerPeakConfidence, keyFrameMediaId, summary) {
 		this.deps.emitTrackEnded({
 			deviceId: t.deviceId,
@@ -74889,6 +74928,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
@@ -79164,22 +79213,22 @@ function buildTapeDeleteDeps(src) {
 		removeFile: src.removeFile
 	};
 }
-function unavailable(reason) {
+function unavailable$1(reason) {
 	return {
 		status: "unavailable",
 		reason
 	};
 }
 async function releaseOrUnavailable(deps, tapeId, queue) {
-	if (typeof deps === "string") return unavailable(deps);
+	if (typeof deps === "string") return unavailable$1(deps);
 	return queue.run((signal) => releaseTape(deps, tapeId, signal), { name: "release" });
 }
 async function deleteOrUnavailable(deps, tapeId, queue) {
-	if (typeof deps === "string") return unavailable(deps);
+	if (typeof deps === "string") return unavailable$1(deps);
 	return queue.run((signal) => deleteTape(deps, tapeId, signal), { name: "delete" });
 }
 async function reconcileOrUnavailable(deps, queue) {
-	if (typeof deps === "string") return unavailable(deps);
+	if (typeof deps === "string") return unavailable$1(deps);
 	return queue.run((signal) => reconcileTapePins(deps, signal), { name: "reconcile" });
 }
 /**
@@ -83743,6 +83792,9 @@ function isConfirmationCompatible(trackClassName, detectionMacroClass) {
 	if (track === "other" || det === "other") return true;
 	return track === det;
 }
+function isSessionDetectorUnavailable(answer) {
+	return answer !== null && "unavailable" in answer;
+}
 var undecided = (candidate, reason) => ({
 	trackId: candidate.trackId,
 	verdict: "undecided",
@@ -83765,7 +83817,7 @@ async function runConfirmation(candidate, config, deps, exhausted) {
 	const carried = candidate.evidenceCrop ?? null;
 	if (carried) {
 		const verdict = await measure(candidate, carried, config, deps, "carried");
-		if (verdict.verdict === "confirmed" || verdict.reason === "redetect-error") return verdict;
+		if (verdict.verdict === "confirmed" || verdict.reason === "redetect-error" || verdict.reason === "session-device-unavailable") return verdict;
 	}
 	let crop = await deps.fetchCrop(candidate);
 	let cropSource = "native";
@@ -83787,11 +83839,14 @@ async function measure(candidate, crop, config, deps, cropSource) {
 	deps.keepCrop?.(candidate, crop, cropSource);
 	const detections = await deps.redetect(crop);
 	if (detections === null) return undecided(candidate, "redetect-error");
+	if (isSessionDetectorUnavailable(detections)) return undecided(candidate, "session-device-unavailable");
 	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;
+	} else if (d.refusedByDetectorFloor !== true) {
+		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");
@@ -83799,7 +83854,7 @@ async function measure(candidate, crop, config, deps, cropSource) {
 	return {
 		trackId: candidate.trackId,
 		verdict: confirmed ? "confirmed" : "suppressed",
-		reason: confirmed ? "confirmed" : "suppressed",
+		reason: confirmed ? "confirmed" : suppressionReason(best, bestIncompatible),
 		className: candidate.className,
 		appliedMinConfidence: bar,
 		cropSource,
@@ -83812,6 +83867,16 @@ async function measure(candidate, crop, config, deps, cropSource) {
 	};
 }
 /**
+* Why a measured native crop said no — first matching rule wins (D922). The
+* best compatible box is under the gate's bar either way; `below-detector-floor`
+* says the detector's own floor had refused it too (D925).
+*/
+function suppressionReason(best, bestIncompatible) {
+	if (best !== void 0) return best.refusedByDetectorFloor === true ? "below-detector-floor" : "scored-below-threshold";
+	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
 * box is scaled into the crop's frame rectangle — the one derivation the
@@ -86557,11 +86622,9 @@ function faceSizeScore(detectionFrameShortSidePx) {
 	return detectionFrameShortSidePx / FACE_SIZE_SCORE_REFERENCE_PX;
 }
 //#endregion
-//#region src/pipeline-analytics/face-identity-retraction.ts
+//#region src/pipeline-analytics/face-recognizer.ts
 /** The recognizer's step id — the attribution a face identity label carries. */
 var FACE_RECOGNIZER_STEP_ID = "face-recognizer";
-//#endregion
-//#region src/pipeline-analytics/face-recognizer.ts
 /** At most one "dropping imageless track" log per this interval, per recognizer. */
 var FACE_IMAGELESS_LOG_THROTTLE_MS = 6e4;
 /** At most one 'embedding magnitude' sample line per device per this interval. */
@@ -93000,11 +93063,119 @@ function buildBirthDecisionRecord(input) {
 		decidedByBirthEvidence: input.decidedByBirthEvidence,
 		bestScore: input.bestScore ?? null,
 		appliedMinConfidence: input.appliedMinConfidence ?? null,
+		cropSource: input.cropSource ?? null,
+		detectorModelId: input.detector?.modelId ?? null,
+		detectorDeviceKey: input.detector?.deviceKey ?? null,
+		detectorNodeId: input.detector?.nodeId ?? 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/confirmation-session-detector.ts
+/**
+* The detector the birth confirmation gate re-judges a birth WITH: the
+* session's own (D925).
+*
+* A birth is a claim made by one detector — the root model of the session that
+* produced the frame, on the inference-device pool it ran on. The gate asks
+* whether that claim holds on better pixels, so it must ask the SAME detector:
+* a different model has a different score scale and a different floor, and its
+* "no" says nothing about the claim. It used to ask the node's global default
+* (`getGlobalSteps`), which on a Coral node meant a CPU `yolov9t` re-judging an
+* `edgetpu` model's births.
+*
+* The identity rides the frame result (`rootStepId` / `rootModelId` /
+* `rootDeviceKey`, stamped by the executor with what it RAN), and the node is
+* the frame handle's — the same node the crop is cut on, so no new bytes cross
+* anywhere.
+*
+* When that detector cannot answer — no identity on the frame (an onboard
+* detector), the device in backoff or failed, or the executor running anything
+* other than exactly that model on exactly that pool — the answer is
+* `session-device-unavailable`: NO measurement. The gate defers the birth and
+* admits it once the deferral is exhausted. Another model is never asked.
+*
+* PURE apart from the injected `run`, so the matrix is testable without an
+* executor.
+*/
+/** The session detector named by a frame, or `null` when the frame names none in full. */
+function sessionDetectorOf(frame, nodeId) {
+	const { rootStepId, rootModelId, rootDeviceKey } = frame;
+	if (!rootStepId || !rootModelId || !rootDeviceKey || !nodeId) return null;
+	return {
+		stepId: rootStepId,
+		modelId: rootModelId,
+		deviceKey: rootDeviceKey,
+		nodeId
+	};
+}
+/**
+* The executor's refusal of a device it will not dispatch to: the liveness
+* refusal (`InferenceDeviceUnusableError`), a device key whose backend this
+* node does not know, or a pinned pool that cannot serve. Read from the
+* message because the error crosses a process boundary without its class.
+*/
+var DEVICE_REFUSAL = /inference device ".+" is (failed|backoff)|unknown backend|device-not-servable|model-not-servable/;
+/** Re-detect a crop with the session detector, or say why it could not. */
+async function redetectWithSessionDetector(detector, cropJpeg, deviceId, run) {
+	if (detector === null) return unavailable("the frame names no session detector");
+	let result;
+	try {
+		result = await run({
+			steps: [{
+				addonId: detector.stepId,
+				modelId: detector.modelId,
+				enabled: true
+			}],
+			image: new Uint8Array(cropJpeg),
+			deviceId,
+			plane: "frame",
+			deviceKey: detector.deviceKey
+		}, detector.nodeId);
+	} catch (err) {
+		const message = require_clip_model_registry.errMsg(err);
+		if (DEVICE_REFUSAL.test(message)) return unavailable(message);
+		return {
+			answer: null,
+			error: message
+		};
+	}
+	if (result !== null && (result.rootModelId !== detector.modelId || result.rootDeviceKey !== detector.deviceKey)) return unavailable(`ran ${result.rootModelId ?? "an unnamed model"} on ${result.rootDeviceKey ?? "an unnamed pool"}, not ${detector.modelId} on ${detector.deviceKey}`);
+	return { answer: toConfirmationDetections(result) };
+}
+function unavailable(detail) {
+	return { answer: {
+		unavailable: "session-device-unavailable",
+		detail
+	} };
+}
+//#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 —
@@ -93914,7 +94085,6 @@ var PHANTOM_CELLS_SPEC = {
 	},
 	deviceIdOf: (row) => row.deviceId
 };
-PHANTOM_CELLS_SPEC.fromRecord, PHANTOM_CELLS_SPEC.toValue, PHANTOM_CELLS_SPEC.deviceIdOf;
 /**
 * The durable cell memory. Reads answer from RAM only (D49) — a gate that
 * consulted SQLite would be a gate that fails when SQLite is slow.
@@ -94114,7 +94284,6 @@ var PACKAGE_BACKGROUND_SPEC = {
 	},
 	deviceIdOf: (row) => row.deviceId
 };
-PACKAGE_BACKGROUND_SPEC.fromRecord, PACKAGE_BACKGROUND_SPEC.toValue, PACKAGE_BACKGROUND_SPEC.deviceIdOf;
 /**
 * The durable ghost-cycle memory. Reads answer from RAM only (D49); writes go
 * write-behind — a lost write costs one under-counted cycle, which is the
@@ -96679,7 +96848,6 @@ var STATIONARY_EVIDENCE_SPEC = {
 	},
 	deviceIdOf: (row) => row.deviceId
 };
-STATIONARY_EVIDENCE_SPEC.fromRecord, STATIONARY_EVIDENCE_SPEC.toValue, STATIONARY_EVIDENCE_SPEC.deviceIdOf;
 var StationaryEvidenceLedger = class {
 	ledger;
 	spec = STATIONARY_EVIDENCE_SPEC;
@@ -97214,7 +97382,6 @@ var STATIONARY_SPEC = {
 	fromRecord: rowToEntry,
 	deviceIdOf: (entry) => entry.deviceId
 };
-STATIONARY_SPEC.fromRecord, STATIONARY_SPEC.toValue, STATIONARY_SPEC.deviceIdOf;
 var StationaryObjectRegistry = class {
 	/** Entry ids per device — an INDEX over the ledger's mirror, not a second
 	*  copy of it. The entries themselves live in exactly one place. */
@@ -113295,9 +113462,6 @@ var KEYFRAME_CROP_MIN_SUBJECT_IOU = .5;
 *  evidence" and the temporal bound takes over. */
 var KEYFRAME_CROP_MAX_SAMPLE_GAP_MS = 1e3;
 var SETTINGS_CACHE_TTL_MS = 5e3;
-/** TTL for the per-node confirmation-gate detector-step cache (the node's
-*  default object-detector step rarely changes). */
-var CONFIRMATION_DETECTOR_CACHE_TTL_MS = 6e4;
 /** Padding applied to a birth box before re-detecting it — a little context
 *  around the subject improves the confirmation detector's recall. */
 var CONFIRMATION_CROP_PADDING = .15;
@@ -114085,11 +114249,6 @@ var PipelineAnalyticsAddon = class PipelineAnalyticsAddon extends require_clip_m
 	trackingSettingsCache = this.settingsCaches.registerDeviceCache("tracking", SETTINGS_CACHE_TTL_MS);
 	/** Per-device confirmation-gate settings cache (default off), TTL-mirrored. */
 	confirmationGateSettingsCache = this.settingsCaches.registerDeviceCache("confirmation-gate", SETTINGS_CACHE_TTL_MS);
-	/** Per-node detector-step cache for the confirmation gate's re-detection —
-	*  the node's default root object-detector reduced to a single childless
-	*  step, resolved lazily from `pipelineExecutor.getGlobalSteps` and reused.
-	*  NOT part of the settings-cache hub: node-keyed, not device-keyed. */
-	confirmationDetectorStepByNode = /* @__PURE__ */ new Map();
 	faceSettingsCache = this.settingsCaches.registerDeviceCache("face", SETTINGS_CACHE_TTL_MS);
 	/** GLOBAL face-recognition master switch (addon store), TTL-cached. */
 	faceGlobalEnabledCache = this.settingsCaches.registerGlobalCache("face-global-enabled", SETTINGS_CACHE_TTL_MS);
@@ -118359,7 +118518,6 @@ var PipelineAnalyticsAddon = class PipelineAnalyticsAddon extends require_clip_m
 		this.settingsCaches.clearAll();
 		this.rawDeviceBlobMirror.invalidateAll();
 		this.rawGlobalStoreMirror.invalidate();
-		this.confirmationDetectorStepByNode.clear();
 		this.trackStore?.clearAll();
 		this.stationaryRegistry = null;
 		this.bindingCache?.clearAll();
@@ -118465,7 +118623,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 +118897,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 +119084,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 +119109,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);
 		}
@@ -119015,6 +119175,7 @@ var PipelineAnalyticsAddon = class PipelineAnalyticsAddon extends require_clip_m
 			this.birthEvidence.remember(key, id, Buffer.from(t.birthEvidence.jpegBase64, "base64"), exhaustionNowMs);
 		}
 		const withBirthEvidence = /* @__PURE__ */ new Set();
+		const sessionDetector = frameHandle ? sessionDetectorOf(frame, frameHandle.nodeId) : null;
 		const run = await this.confirmTrackBirths(bornCandidates.map(({ id, t }) => {
 			const evidenceCrop = this.birthEvidence.get(key, id, exhaustionNowMs);
 			if (evidenceCrop !== null) withBirthEvidence.add(id);
@@ -119030,7 +119191,9 @@ var PipelineAnalyticsAddon = class PipelineAnalyticsAddon extends require_clip_m
 			source,
 			frameHandle,
 			frameWidth: result.frameWidth,
-			frameHeight: result.frameHeight
+			frameHeight: result.frameHeight,
+			sessionDetector,
+			attemptsFor: (trackId) => this.deferredBirths.attemptsFor(key, trackId)
 		}, exhaustedIds);
 		const outcome = run.outcome;
 		const gateNowMs = Date.now();
@@ -119085,6 +119248,7 @@ var PipelineAnalyticsAddon = class PipelineAnalyticsAddon extends require_clip_m
 				matchedThisFrame: t.matchedThisFrame,
 				birthEvidenceAvailable: withBirthEvidence.has(id),
 				decision: run.decisions.get(id),
+				sessionDetector,
 				decidedAtMs: gateNowMs,
 				firstSeen: this.trackStore?.peekActive(id)?.firstSeen ?? null
 			});
@@ -119144,16 +119308,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: {
@@ -119845,88 +120018,30 @@ var PipelineAnalyticsAddon = class PipelineAnalyticsAddon extends require_clip_m
 		return this.confirmationGateSettingsCache.get(deviceId, (id) => this.readDeviceSettings(id, resolveConfirmationGateSettings));
 	}
 	/**
-	* Narrowed, version-skew-safe handle onto the `pipelineExecutor` cap — same
-	* structural-cast pattern as the `pipelineRunner` handle above. A node whose
-	* executor predates these methods simply yields `undefined`, and the
-	* confirmation gate then fails open (allows the birth).
+	* Re-run object detection on a confirmation crop JPEG with the SESSION'S
+	* detector (D925): the root model the birth's frame ran, on the device pool
+	* it ran on, pinned to that frame's node — the node the crop is cut on, so
+	* no new bytes cross anywhere. A session detector that cannot answer is
+	* `session-device-unavailable` (no measurement, the birth defers); another
+	* model is never asked. An inference failure is `null` (`redetect-error`).
 	*/
-	pipelineExecutorApi() {
-		const api = this.ctx?.api;
-		if (!api) return void 0;
-		return api.pipelineExecutor;
-	}
-	/**
-	* Resolve (and cache) the confirmation gate's re-detection step for a node:
-	* the node's DEFAULT root object-detector (from `getGlobalSteps`) reduced to a
-	* single CHILDLESS step, so the confirmation run does detection ONLY — no
-	* crop/classifier subtree. Cached per node (TTL) since the node default rarely
-	* changes. `null` ⇒ no detector available ⇒ the gate fails open.
-	*/
-	async resolveConfirmationDetectorStep(nodeId) {
-		const now = Date.now();
-		const cached = this.confirmationDetectorStepByNode.get(nodeId);
-		if (cached && now < cached.expiresAt) return cached.step;
-		let step = null;
-		const executor = this.pipelineExecutorApi();
-		if (executor?.getGlobalSteps) try {
-			const steps = await executor.getGlobalSteps.query(void 0, require_clip_model_registry.nodePin(nodeId));
-			const detector = steps?.find((s) => s.slot === "detector" && s.enabled) ?? steps?.find((s) => s.slot === "detector");
-			if (detector) step = {
-				addonId: detector.addonId,
-				...detector.modelId ? { modelId: detector.modelId } : {},
-				enabled: true
-			};
-		} catch (err) {
-			this.ctx.logger.debug("confirmation gate: getGlobalSteps failed", { meta: {
-				nodeId,
-				error: require_clip_model_registry.errMsg(err)
-			} });
-		}
-		this.confirmationDetectorStepByNode.set(nodeId, {
-			step,
-			expiresAt: now + CONFIRMATION_DETECTOR_CACHE_TTL_MS
+	async redetectCropForConfirmation(detector, deviceId, cropJpeg) {
+		const outcome = await redetectWithSessionDetector(detector, cropJpeg, deviceId, (request, nodeId) => this.ctx.api.pipelineExecutor.runPipeline.mutate({
+			...request,
+			steps: [...request.steps]
+		}, require_clip_model_registry.nodePin(nodeId)));
+		if (outcome.error !== void 0) this.ctx.logger.warn("confirmation gate: re-detection failed — birth deferred", {
+			tags: { deviceId },
+			meta: {
+				error: outcome.error,
+				...detector !== null ? {
+					modelId: detector.modelId,
+					deviceKey: detector.deviceKey,
+					node: detector.nodeId
+				} : {}
+			}
 		});
-		return step;
-	}
-	/**
-	* Re-run object detection on a confirmation crop JPEG via the frame-owning
-	* node's `pipelineExecutor` (pinned by `nodeId`, matching the native-crop
-	* fetch). Returns the crop's detections, or `null` on any unavailability /
-	* error so the gate fails open.
-	*/
-	async redetectCropForConfirmation(nodeId, deviceId, cropJpeg) {
-		const step = await this.resolveConfirmationDetectorStep(nodeId);
-		if (!step) return null;
-		const executor = this.pipelineExecutorApi();
-		if (!executor?.runPipeline) return null;
-		try {
-			const result = 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
-				} } : {}
-			}));
-		} catch (err) {
-			this.ctx.logger.debug("confirmation gate: re-detection failed — fail-open", {
-				tags: { deviceId },
-				meta: { error: require_clip_model_registry.errMsg(err) }
-			});
-			return null;
-		}
+		return outcome.answer;
 	}
 	/**
 	* Confirm a batch of track-birth candidates before they are created. Returns
@@ -119980,6 +120095,8 @@ var PipelineAnalyticsAddon = class PipelineAnalyticsAddon extends require_clip_m
 			reason: decision?.reason ?? null,
 			bestScore: decision?.bestScore ?? null,
 			appliedMinConfidence: decision?.appliedMinConfidence ?? null,
+			cropSource: decision?.cropSource ?? null,
+			detector: decision !== void 0 && (decision.cropSource !== void 0 || decision.reason === "session-device-unavailable") ? input.sessionDetector ?? null : null,
 			decidedAtMs: input.decidedAtMs,
 			firstSeen: input.firstSeen,
 			motionOnsetAtMs,
@@ -120017,7 +120134,7 @@ var PipelineAnalyticsAddon = class PipelineAnalyticsAddon extends require_clip_m
 			});
 			return allConfirmed();
 		}
-		const nodeId = frameHandle.nodeId;
+		const { sessionDetector } = params;
 		const candidateNativeRecovery = /* @__PURE__ */ new Map();
 		for (const c of candidates) if (c.nativeRecovery !== void 0) candidateNativeRecovery.set(c.trackId, c.nativeRecovery);
 		return {
@@ -120044,7 +120161,7 @@ var PipelineAnalyticsAddon = class PipelineAnalyticsAddon extends require_clip_m
 						h: candidate.bbox.h
 					}, frameWidth, frameHeight, CONFIRMATION_CROP_PADDING, candidate.trackId, CONFIRMATION_CROP_MAX_WIDTH);
 				},
-				redetect: (cropJpeg) => this.redetectCropForConfirmation(nodeId, deviceId, cropJpeg),
+				redetect: (cropJpeg) => this.redetectCropForConfirmation(sessionDetector, deviceId, cropJpeg),
 				keepCrop: (candidate, cropJpeg) => {
 					offeredCrops.set(candidate.trackId, cropJpeg);
 				},
@@ -120069,6 +120186,12 @@ var PipelineAnalyticsAddon = class PipelineAnalyticsAddon extends require_clip_m
 						reason: decision.reason,
 						className: decision.className,
 						...decision.bestScore !== void 0 ? { bestScore: decision.bestScore } : {},
+						...sessionDetector !== null ? {
+							modelId: sessionDetector.modelId,
+							deviceKey: sessionDetector.deviceKey,
+							node: sessionDetector.nodeId
+						} : {},
+						attempts: params.attemptsFor(decision.trackId),
 						...decision.bestIncompatibleClass !== void 0 ? {
 							bestIncompatibleClass: decision.bestIncompatibleClass,
 							bestIncompatibleScore: decision.bestIncompatibleScore