@camstack/addon-post-analysis 1.2.289 → 1.2.291

package/dist/pipeline-analytics/index.mjs

@@ -1,4 +1,4 @@
-import { $ as NcRuleSchema, $n as EventCategory, $t as isSourceCap, A as LabelAttributionSchema, An as canonicalHash, At as audioMetricsCapability, B as NC_DEFAULT_SNOOZE_MINUTES, Bt as embeddingRefusalOf, C as EMBEDDING_REQUIREMENTS_FAILED, Cn as systemEventFilterApplies, Ct as TimelapseRuleInputSchema, D as FIRST_LEVEL_MACRO_CLASSES, Dn as vectorDimFromBase64, Dt as addonWidgetsSourceCapability, E as EVENT_OWNER_TYPES, En as templateVarsFor, Et as TrackSourceSchema, F as MOTION_CLOSE_AFTER_MS, Fn as customAction, Ft as deriveRecordingMode, G as NC_TAXONOMY, Gn as discriminatedUnion, Gt as evictionPolicyOfLocation, Hn as _enum, I as MediaFileKindEnum, In as defineCustomActions, It as describeSystemEventDeliveryProblem, J as NcAlarmSettingsPatchSchema, Jn as object, Jt as isDetectionMacroClass, K as NC_TEMPLATE_VARS, Kn as literal, Kt as faceGalleryCapability, L as NC_ALARM_SYSTEM_EVENT_KINDS, Ln as hydrateSchema, Lt as describeSystemEventFamilyProblem, M as MAX_ARCHIVED_DEBUG_NOTES, Mn as CamProfileSchema, Mt as buildEventKindDescriptor, N as MAX_BIRTH_DECISION_RECORDS, Nn as DeviceType, Nt as consumableLowPercentOf, O as FULL_IMAGE_BBOX, On as zoneAnalyticsCapability, Ot as alarmPanelCapability, Pn as createEvent, Pt as cosineSimilarity$1, Q as NcRulePatchSchema, Qn as unknown, Qt as isScheduleActive, R as NC_CONDITION_CATALOG, Rn as isDeviceScopedCap, S as EMBEDDING_MODEL_FAILED, Sn as systemEventFamilyProblems, St as TIMELAPSE_DENSE_FLOOR_SEC, T as EVENT_KIND_BY_CAP, Tn as templateCarriesSummary, Tt as TimelapseRuleSchema, U as NC_SYSTEM_EVENT_KIND_GROUP_SPECS, Un as array, Ut as encodeVectorBase64, V as NC_SENSOR_TRANSITION_KINDS, Vn as sleep$1, W as NC_TANK_SYSTEM_EVENT_KINDS, Wn as boolean, Wt as evaluateSensorEdge, X as NcConditionsSchema, Xn as record, Xt as isKnownTemplateVar, Y as NcConditionDescriptorSchema, Yn as partialRecord, Yt as isEventOwnerType, Z as NcRuleInputSchema, Zn as string, Zt as isMediaOwnerType, _n as sensorRaisedOf, a as CLIP_EMBEDDING_STEP_ID, an as notificationRulesCapability, at as NcSnoozeSuppressedSchema, bn as subKindsOf, bt as SCENE_DIVERGED, c as resolveClusterModelPin, cn as pipelineAnalyticsCapability, ct as NcTemplatePreviewInputSchema, d as ArchivedDebugNoteSchema, dn as readTimelapseGeneratedAt, dt as OpsLogEntrySchema, en as isSystemDelivery, et as NcRuleTargetSchema, f as BaseDevice, fn as resolveClipSearchMinScore, g as DEFAULT_EVENT_COLOR, gn as sceneMonitorCapability, gt as RetrainStatusSchema, h as CoverStateSchema, hn as ruleBelongsToAlarm$1, ht as RebuildObjectEmbeddingsRefusalSchema, in as mayWriteToLocation, it as NcSnoozeSchema, j as LockStateSchema, jn as BaseAddon, jt as audioModeOf, k as FailureCounters, kn as errMsg$1, kt as assertTimelapseCadences, l as AUDIO_MACRO_LABELS, ln as plateGalleryCapability, lt as NcTemplatePreviewSchema, m as COCO_TO_MACRO, mt as RECORDING_SOURCE_CAMSTACK_ADDON, nn as isVectorIndexDimConflict, nt as NcScheduleSchema, o as FACE_EMBEDDING_STEP_ID, on as occupancyScope, ot as NcSystemEventKindSchema, p as BirthDecisionRecordSchema, pn as resolveLocationMode, pt as RECORDING_EXPORT_MAX_READ_BYTES, q as NcAlarmConfigSchema, qn as number, qt as failureContributionCapability, rn as kebabToCamel, rt as NcSnoozeInputSchema, s as readClusterModelPinStrict, st as NcTaxonomySchema, t as BUILTIN_CLIP_MODELS, tn as isSystemEventSummaryRule, tt as NcRuleUpdateInputSchema, u as AlarmArmModeSchema, un as readDeviceStateFrom, ut as NcTemplateVarDescriptorSchema, vn as servedTemplateVars, vt as SCENE_DEFAULT_ANCHOR_THRESHOLD, w as EMBEDDING_REQUIREMENTS_UNAVAILABLE, wn as systemEventSummaryScheduleOf, wt as TimelapseRulePatchSchema, x as DeclaredDevices, xn as systemEventDeliveryProblems, xt as SceneMonitorSchema, y as DETECTION_MACRO_CLASSES, yn as storageOccupancyCapability, yt as SCENE_DEFAULT_UNCOVERED_POLICY, z as NC_CONSUMABLE_SYSTEM_EVENT_KINDS, zn as nodePin } from "../clip-model-registry-g3-Yz08Y.mjs";
+import { $ as NcRuleSchema, $n as EventCategory, $t as isSourceCap, A as LabelAttributionSchema, An as canonicalHash, At as audioMetricsCapability, B as NC_DEFAULT_SNOOZE_MINUTES, Bt as embeddingRefusalOf, C as EMBEDDING_REQUIREMENTS_FAILED, Cn as systemEventFilterApplies, Ct as TimelapseRuleInputSchema, D as FIRST_LEVEL_MACRO_CLASSES, Dn as vectorDimFromBase64, Dt as addonWidgetsSourceCapability, E as EVENT_OWNER_TYPES, En as templateVarsFor, Et as TrackSourceSchema, F as MOTION_CLOSE_AFTER_MS, Fn as customAction, Ft as deriveRecordingMode, G as NC_TAXONOMY, Gn as discriminatedUnion, Gt as evictionPolicyOfLocation, Hn as _enum, I as MediaFileKindEnum, In as defineCustomActions, It as describeSystemEventDeliveryProblem, J as NcAlarmSettingsPatchSchema, Jn as object, Jt as isDetectionMacroClass, K as NC_TEMPLATE_VARS, Kn as literal, Kt as faceGalleryCapability, L as NC_ALARM_SYSTEM_EVENT_KINDS, Ln as hydrateSchema, Lt as describeSystemEventFamilyProblem, M as MAX_ARCHIVED_DEBUG_NOTES, Mn as CamProfileSchema, Mt as buildEventKindDescriptor, N as MAX_BIRTH_DECISION_RECORDS, Nn as DeviceType, Nt as consumableLowPercentOf, O as FULL_IMAGE_BBOX, On as zoneAnalyticsCapability, Ot as alarmPanelCapability, Pn as createEvent, Pt as cosineSimilarity$1, Q as NcRulePatchSchema, Qn as unknown, Qt as isScheduleActive, R as NC_CONDITION_CATALOG, Rn as isDeviceScopedCap, S as EMBEDDING_MODEL_FAILED, Sn as systemEventFamilyProblems, St as TIMELAPSE_DENSE_FLOOR_SEC, T as EVENT_KIND_BY_CAP, Tn as templateCarriesSummary, Tt as TimelapseRuleSchema, U as NC_SYSTEM_EVENT_KIND_GROUP_SPECS, Un as array, Ut as encodeVectorBase64, V as NC_SENSOR_TRANSITION_KINDS, Vn as sleep$1, W as NC_TANK_SYSTEM_EVENT_KINDS, Wn as boolean, Wt as evaluateSensorEdge, X as NcConditionsSchema, Xn as record, Xt as isKnownTemplateVar, Y as NcConditionDescriptorSchema, Yn as partialRecord, Yt as isEventOwnerType, Z as NcRuleInputSchema, Zn as string, Zt as isMediaOwnerType, _n as sensorRaisedOf, a as CLIP_EMBEDDING_STEP_ID, an as notificationRulesCapability, at as NcSnoozeSuppressedSchema, bn as subKindsOf, bt as SCENE_DIVERGED, c as resolveClusterModelPin, cn as pipelineAnalyticsCapability, ct as NcTemplatePreviewInputSchema, d as ArchivedDebugNoteSchema, dn as readTimelapseGeneratedAt, dt as OpsLogEntrySchema, en as isSystemDelivery, et as NcRuleTargetSchema, f as BaseDevice, fn as resolveClipSearchMinScore, g as DEFAULT_EVENT_COLOR, gn as sceneMonitorCapability, gt as RetrainStatusSchema, h as CoverStateSchema, hn as ruleBelongsToAlarm$1, ht as RebuildObjectEmbeddingsRefusalSchema, in as mayWriteToLocation, it as NcSnoozeSchema, j as LockStateSchema, jn as BaseAddon, jt as audioModeOf, k as FailureCounters, kn as errMsg$1, kt as assertTimelapseCadences, l as AUDIO_MACRO_LABELS, ln as plateGalleryCapability, lt as NcTemplatePreviewSchema, m as COCO_TO_MACRO, mt as RECORDING_SOURCE_CAMSTACK_ADDON, nn as isVectorIndexDimConflict, nt as NcScheduleSchema, o as FACE_EMBEDDING_STEP_ID, on as occupancyScope, ot as NcSystemEventKindSchema, p as BirthDecisionRecordSchema, pn as resolveLocationMode, pt as RECORDING_EXPORT_MAX_READ_BYTES, q as NcAlarmConfigSchema, qn as number, qt as failureContributionCapability, rn as kebabToCamel, rt as NcSnoozeInputSchema, s as readClusterModelPinStrict, st as NcTaxonomySchema, t as BUILTIN_CLIP_MODELS, tn as isSystemEventSummaryRule, tt as NcRuleUpdateInputSchema, u as AlarmArmModeSchema, un as readDeviceStateFrom, ut as NcTemplateVarDescriptorSchema, vn as servedTemplateVars, vt as SCENE_DEFAULT_ANCHOR_THRESHOLD, w as EMBEDDING_REQUIREMENTS_UNAVAILABLE, wn as systemEventSummaryScheduleOf, wt as TimelapseRulePatchSchema, x as DeclaredDevices, xn as systemEventDeliveryProblems, xt as SceneMonitorSchema, y as DETECTION_MACRO_CLASSES, yn as storageOccupancyCapability, yt as SCENE_DEFAULT_UNCOVERED_POLICY, z as NC_CONSUMABLE_SYSTEM_EVENT_KINDS, zn as nodePin } from "../clip-model-registry-Cudz--Ql.mjs";
 import { t as __exportAll } from "../embedding-encoder/index.mjs";
 import * as fs from "node:fs";
 import { promises } from "node:fs";
@@ -39654,7 +39654,12 @@ var RebuildInputSchema = object({
 	* Milliseconds between tracks; omit for the default, `0` to run flat out.
 	* A rebuild shares hub-main's only thread with every live request.
 	*/
-	pacingMs: number().int().nonnegative().optional()
+	pacingMs: number().int().nonnegative().optional(),
+	/**
+	* Re-embed ONLY tracks already in the pinned space — to redo vectors cut
+	* from the wrong box (D664). Requires `maxTracks`.
+	*/
+	force: boolean().optional()
 });
 var RebuildStartedSchema = object({
 	started: boolean(),
@@ -39674,7 +39679,20 @@ var RebuildStatusSchema = object({
 	scanned: number(),
 	rebuilt: number(),
 	missingKeyFrame: number(),
+	/** No object event at all — its own number since D664. */
+	missingEvent: number(),
 	missingBbox: number(),
+	/** Which rule placed each judged track's box (D664). */
+	boxSource: object({
+		subjectBox: number(),
+		positions: number(),
+		event: number(),
+		refused: number()
+	}),
+	alreadyInSpace: number(),
+	/** Whether the current / last pass was a `force` pass (D664). */
+	force: boolean().nullable(),
+	forcedInSpace: number(),
 	/** Refused by the executing node (unreadable key frame / bad box), not broken. */
 	notRunnable: number(),
 	/** The pass STOPPED: no node in the cluster could serve the pinned model. */
@@ -40949,7 +40967,7 @@ function toPixelBox(b) {
 		h: b.height
 	};
 }
-function refused(reason, detail) {
+function refused$1(reason, detail) {
 	return {
 		kind: "refused",
 		reason,
@@ -40977,8 +40995,8 @@ function comparableFaces(input) {
 /** Refuse before choosing when nothing in the photo can become the sample. */
 function precondition(input) {
 	const enrollable = input.faces.filter((f) => f.enrollable && f.embedding !== void 0);
-	if (enrollable.length === 0) return refused("no-enrollable-face", `${input.faces.length} face(s) found, none enrollable (${input.faces.map((f) => f.refusedReason ?? "unknown").join(", ")})`);
-	if (!enrollable.some((f) => isEnrollableIn(f, input.modelId))) return refused("model-mismatch", `faces were embedded by ${[...new Set(enrollable.map((f) => f.modelId))].join(", ")}, the old sample by ${input.modelId} — re-embed the gallery first`);
+	if (enrollable.length === 0) return refused$1("no-enrollable-face", `${input.faces.length} face(s) found, none enrollable (${input.faces.map((f) => f.refusedReason ?? "unknown").join(", ")})`);
+	if (!enrollable.some((f) => isEnrollableIn(f, input.modelId))) return refused$1("model-mismatch", `faces were embedded by ${[...new Set(enrollable.map((f) => f.modelId))].join(", ")}, the old sample by ${input.modelId} — re-embed the gallery first`);
 	return null;
 }
 function chooseByIou(input, oldBox, scored) {
@@ -40987,13 +41005,13 @@ function chooseByIou(input, oldBox, scored) {
 		face,
 		iou: iou$3(box, toPixelBox(face.bbox))
 	})).filter((c) => c.iou >= PHOTO_REENROL_MIN_IOU);
-	if (overlapping.length === 0) return refused("no-iou-match", `no face overlaps the old box at IoU ≥ ${PHOTO_REENROL_MIN_IOU}`);
-	if (overlapping.length > 1) return refused("ambiguous", `${overlapping.length} faces overlap the old box (IoU ${overlapping.map((c) => c.iou.toFixed(2)).join(", ")})`);
+	if (overlapping.length === 0) return refused$1("no-iou-match", `no face overlaps the old box at IoU ≥ ${PHOTO_REENROL_MIN_IOU}`);
+	if (overlapping.length > 1) return refused$1("ambiguous", `${overlapping.length} faces overlap the old box (IoU ${overlapping.map((c) => c.iou.toFixed(2)).join(", ")})`);
 	const [only] = overlapping;
-	if (only === void 0) return refused("no-iou-match", "no overlapping face");
-	if (!isEnrollableIn(only.face, input.modelId)) return refused("no-enrollable-face", `the face on the old box is not enrollable (${only.face.refusedReason ?? `model ${only.face.modelId ?? "none"}`})`);
+	if (only === void 0) return refused$1("no-iou-match", "no overlapping face");
+	if (!isEnrollableIn(only.face, input.modelId)) return refused$1("no-enrollable-face", `the face on the old box is not enrollable (${only.face.refusedReason ?? `model ${only.face.modelId ?? "none"}`})`);
 	const cosine = scored.find((s) => s.face === only.face)?.cosine;
-	if (cosine === void 0 || cosine < .5) return refused("below-floor", `the overlapping face scores cosine ${cosine?.toFixed(3) ?? "n/a"} < ${PHOTO_REENROL_COSINE_FLOOR}`);
+	if (cosine === void 0 || cosine < .5) return refused$1("below-floor", `the overlapping face scores cosine ${cosine?.toFixed(3) ?? "n/a"} < ${PHOTO_REENROL_COSINE_FLOOR}`);
 	return {
 		kind: "chosen",
 		face: only.face,
@@ -41004,10 +41022,10 @@ function chooseByIou(input, oldBox, scored) {
 }
 function chooseByCosine(input, scored) {
 	const [best, runnerUp] = [...scored].toSorted((a, b) => b.cosine - a.cosine);
-	if (best === void 0) return refused("model-mismatch", "no face has a comparable vector");
-	if (best.cosine < .5) return refused("below-floor", `best cosine ${best.cosine.toFixed(3)} < ${PHOTO_REENROL_COSINE_FLOOR}`);
-	if (runnerUp !== void 0 && runnerUp.cosine >= .5 && best.cosine - runnerUp.cosine < .1) return refused("ambiguous", `two faces clear the floor within ${PHOTO_REENROL_AMBIGUITY_MARGIN}: ${best.cosine.toFixed(3)} vs ${runnerUp.cosine.toFixed(3)}`);
-	if (!isEnrollableIn(best.face, input.modelId)) return refused("ambiguous", `the closest face (cosine ${best.cosine.toFixed(3)}) is not enrollable (${best.face.refusedReason ?? "unknown"}) — the enrollable ones may be someone else`);
+	if (best === void 0) return refused$1("model-mismatch", "no face has a comparable vector");
+	if (best.cosine < .5) return refused$1("below-floor", `best cosine ${best.cosine.toFixed(3)} < ${PHOTO_REENROL_COSINE_FLOOR}`);
+	if (runnerUp !== void 0 && runnerUp.cosine >= .5 && best.cosine - runnerUp.cosine < .1) return refused$1("ambiguous", `two faces clear the floor within ${PHOTO_REENROL_AMBIGUITY_MARGIN}: ${best.cosine.toFixed(3)} vs ${runnerUp.cosine.toFixed(3)}`);
+	if (!isEnrollableIn(best.face, input.modelId)) return refused$1("ambiguous", `the closest face (cosine ${best.cosine.toFixed(3)}) is not enrollable (${best.face.refusedReason ?? "unknown"}) — the enrollable ones may be someone else`);
 	return {
 		kind: "chosen",
 		face: best.face,
@@ -53721,11 +53739,10 @@ var EventStore = class {
 		let entryId;
 		for (const row of rows) {
 			const bbox = row.data["bbox"];
-			if (bbox !== null && typeof bbox === "object") {
-				const bw = "w" in bbox && typeof bbox.w === "number" ? bbox.w : 0;
-				const bh = "h" in bbox && typeof bbox.h === "number" ? bbox.h : 0;
-				if (bw <= 0 || bh <= 0) continue;
-			}
+			if (bbox === null || typeof bbox !== "object") continue;
+			const bw = "w" in bbox && typeof bbox.w === "number" ? bbox.w : 0;
+			const bh = "h" in bbox && typeof bbox.h === "number" ? bbox.h : 0;
+			if (bw <= 0 || bh <= 0) continue;
 			const conf = typeof row.data["confidence"] === "number" ? row.data["confidence"] : 0;
 			if (conf > bestConf) {
 				bestConf = conf;
@@ -62377,6 +62394,26 @@ var EmbeddingDispatcher = class {
 		return this.pendingCrops.size;
 	}
 };
+//#endregion
+//#region src/pipeline-analytics/embedding-rebuild.ts
+/**
+* Track sources a rebuild never lists (D664). An audio track and a synthetic
+* sensor track have no object event and no subject to embed — on the live hub
+* 6,726 + 180 of 42,254 tracks — and walking them only inflated the skip
+* counters an operator reads to judge media coverage.
+*/
+var REBUILD_EXCLUDED_SOURCES = ["audio", "sensor"];
+/**
+* One page of the rebuild listing as a `queryRecentIds` query. Pure, so the
+* exclusion is assertable: dropping it would look identical in every result
+* except the skip counters.
+*/
+function rebuildTrackPageQuery(window) {
+	return {
+		...window,
+		excludeSources: REBUILD_EXCLUDED_SOURCES
+	};
+}
 /**
 * Re-embed every listed track from its key frame.
 *
@@ -62392,6 +62429,14 @@ async function rebuildObjectEmbeddings(deps, options = {}) {
 	let recoveredKeyFrame = 0;
 	let missingEvent = 0;
 	let missingBbox = 0;
+	let boxSubject = 0;
+	let boxPositions = 0;
+	let boxEvent = 0;
+	let boxRefused = 0;
+	let forcedInSpace = 0;
+	let skippedOutOfSpace = 0;
+	const refusalsByDevice = /* @__PURE__ */ new Map();
+	const force = options.force === true;
 	let alreadyInSpace = 0;
 	let notRunnable = 0;
 	let noCapableNode = 0;
@@ -62402,6 +62447,12 @@ async function rebuildObjectEmbeddings(deps, options = {}) {
 	let budgetExhausted = false;
 	/** Set when the cluster ran out of nodes — the pass stops, `complete` is false. */
 	let abandoned = null;
+	const boxSourceCounts = () => ({
+		subjectBox: boxSubject,
+		positions: boxPositions,
+		event: boxEvent,
+		refused: boxRefused
+	});
 	while (scanned < maxTracks && abandoned === null) {
 		const page = await deps.listTrackIdPage(cursor);
 		if (page.trackIds.length === 0) {
@@ -62409,9 +62460,14 @@ async function rebuildObjectEmbeddings(deps, options = {}) {
 			break;
 		}
 		let pageIds = page.trackIds;
+		let forcedPage = false;
 		if (deps.filterOutOfSpace) {
 			const split = await deps.filterOutOfSpace(page.trackIds);
-			if (split !== null) {
+			if (split !== null && force) {
+				skippedOutOfSpace += split.outOfSpace.length;
+				pageIds = split.inSpace;
+				forcedPage = true;
+			} else if (split !== null) {
 				alreadyInSpace += split.alreadyInSpace;
 				pageIds = split.outOfSpace;
 			}
@@ -62427,6 +62483,7 @@ async function rebuildObjectEmbeddings(deps, options = {}) {
 		const room = maxTracks - scanned;
 		const batch = pageIds.slice(0, Number.isFinite(room) ? room : void 0);
 		if (batch.length < pageIds.length) budgetExhausted = true;
+		if (forcedPage) forcedInSpace += batch.length;
 		for (const trackId of batch) {
 			if (!deps.canDispatch()) {
 				abandoned = "no node left in the rotation can serve the pinned model — stopped before loading any further media";
@@ -62445,6 +62502,25 @@ async function rebuildObjectEmbeddings(deps, options = {}) {
 						missingEvent += 1;
 						return;
 					}
+					if (source.bbox === null || source.bbox.w <= 0 || source.bbox.h <= 0) {
+						missingBbox += 1;
+						boxRefused += 1;
+						const reason = source.boxSource.kind === "refused" ? source.boxSource.reason : "degenerate-box";
+						const n = (refusalsByDevice.get(source.deviceId) ?? 0) + 1;
+						refusalsByDevice.set(source.deviceId, n);
+						if (n === 1 || n % 100 === 0) deps.logger.warn("embedding rebuild: no box measured on the key frame — track refused (D303)", {
+							tags: { deviceId: source.deviceId },
+							meta: {
+								trackId,
+								reason,
+								refusedOnThisCamera: n
+							}
+						});
+						return;
+					}
+					if (source.boxSource.kind === "subjectBox") boxSubject += 1;
+					else if (source.boxSource.kind === "positions") boxPositions += 1;
+					else boxEvent += 1;
 					let keyFrame = source.keyFrame;
 					let recovered = false;
 					if (keyFrame === null && deps.recoverKeyFrame) {
@@ -62456,10 +62532,6 @@ async function rebuildObjectEmbeddings(deps, options = {}) {
 						return;
 					}
 					if (recovered) recoveredKeyFrame += 1;
-					if (source.bbox === null || source.bbox.w <= 0 || source.bbox.h <= 0) {
-						missingBbox += 1;
-						return;
-					}
 					const outcome = await deps.embed(recovered ? {
 						...source,
 						keyFrame
@@ -62527,6 +62599,9 @@ async function rebuildObjectEmbeddings(deps, options = {}) {
 				recoveredKeyFrame,
 				missingEvent,
 				missingBbox,
+				boxSource: boxSourceCounts(),
+				forcedInSpace,
+				skippedOutOfSpace,
 				alreadyInSpace,
 				notRunnable,
 				noCapableNode,
@@ -62550,6 +62625,10 @@ async function rebuildObjectEmbeddings(deps, options = {}) {
 		recoveredKeyFrame,
 		missingEvent,
 		missingBbox,
+		boxSource: boxSourceCounts(),
+		force,
+		forcedInSpace,
+		skippedOutOfSpace,
 		alreadyInSpace,
 		notRunnable,
 		noCapableNode,
@@ -62564,6 +62643,9 @@ async function rebuildObjectEmbeddings(deps, options = {}) {
 		recoveredKeyFrame,
 		missingEvent,
 		missingBbox,
+		boxSource: boxSourceCounts(),
+		forcedInSpace,
+		skippedOutOfSpace,
 		alreadyInSpace,
 		notRunnable,
 		noCapableNode,
@@ -62920,8 +63002,6 @@ var FaceSettingsSchema = object({
 	*  (2026-07-23), then →0.12 (2026-08-18) alongside the threshold retune —
 	*  same story and the same recalibration plan as {@link similarityThreshold}. */
 	margin: number().min(0).max(1).default(.12),
-	/** Minimum face-detection confidence for a face to be considered. */
-	minFaceConfidence: number().min(0).max(1).default(.5),
 	/**
 	* Minimum face bbox size (px, shorter side, NATIVE scale when the runner
 	* measured it, else detection-frame space) for a face to be DETECTED and
@@ -63003,7 +63083,6 @@ function resolveFaceSettings(raw) {
 		enabled: pick("enabled"),
 		similarityThreshold: pick("similarityThreshold"),
 		margin: pick("margin"),
-		minFaceConfidence: pick("minFaceConfidence"),
 		minFacePx: pick("minFacePx"),
 		recognitionMinFacePx: pick("recognitionMinFacePx"),
 		minIdentitySamples: pick("minIdentitySamples"),
@@ -63076,6 +63155,17 @@ function deriveSuggestedBufferCap(bufferMaxPerDevice) {
 * it from a store.
 */
 var STORED_SUGGESTION_MIN_COSINE_KEY = "suggestionMinCosine";
+/** The settings key that held the retired recognizer face-confidence bar (D662). */
+var STORED_MIN_FACE_CONFIDENCE_KEY = "minFaceConfidence";
+/** Plan the removal of ONE retired key from a settings blob; `null` = absent. */
+function planRetiredKeyPurge(raw, key) {
+	const was = raw[key];
+	if (was === void 0) return null;
+	return {
+		was,
+		patch: { [key]: void 0 }
+	};
+}
 /**
 * Plan the removal of a persisted suggestion floor from one settings blob.
 *
@@ -63090,12 +63180,15 @@ var STORED_SUGGESTION_MIN_COSINE_KEY = "suggestionMinCosine";
 * serialisation the blob round-trips through.
 */
 function planStoredSuggestionPurge(raw) {
-	const was = raw[STORED_SUGGESTION_MIN_COSINE_KEY];
-	if (was === void 0) return null;
-	return {
-		was,
-		patch: { [STORED_SUGGESTION_MIN_COSINE_KEY]: void 0 }
-	};
+	return planRetiredKeyPurge(raw, STORED_SUGGESTION_MIN_COSINE_KEY);
+}
+/**
+* Plan the removal of a persisted `minFaceConfidence` (D662). Same contract as
+* {@link planStoredSuggestionPurge}: absence of the key is the marker, and the
+* patch unsets with `undefined`.
+*/
+function planStoredMinFaceConfidencePurge(raw) {
+	return planRetiredKeyPurge(raw, STORED_MIN_FACE_CONFIDENCE_KEY);
 }
 /**
 * Map a detection-frame face short side to the 0..1 `sizeScore` the
@@ -63384,7 +63477,7 @@ var FaceRecognizer = class {
 	async processFrame(input) {
 		const { settings } = input;
 		for (const t of input.tracked) if (t.resurrectionScene === "multi-subject") this.quarantineHeldFace(input.deviceId, t.trackId);
-		const candidates = input.tracked.filter((t) => Array.isArray(t.embedding) && t.embedding.length > 0 && typeof t.embeddingModelId === "string" && t.confidence >= settings.minFaceConfidence && (t.nativeFaceShortSidePx ?? (t.faceBbox ? Math.min(t.faceBbox.w, t.faceBbox.h) : void 0) ?? Number.POSITIVE_INFINITY) >= settings.minFacePx);
+		const candidates = input.tracked.filter((t) => Array.isArray(t.embedding) && t.embedding.length > 0 && typeof t.embeddingModelId === "string" && (t.nativeFaceShortSidePx ?? (t.faceBbox ? Math.min(t.faceBbox.w, t.faceBbox.h) : void 0) ?? Number.POSITIVE_INFINITY) >= settings.minFacePx);
 		if (candidates.length === 0) return;
 		this.deps.logger.debug("face: frame candidates", {
 			tags: { deviceId: input.deviceId },
@@ -72951,6 +73044,58 @@ function hasKeyFrame(source) {
 }
 //#endregion
 //#region src/pipeline-analytics/rebuild-source-loader.ts
+function refused(reason) {
+	return {
+		bbox: null,
+		boxSource: {
+			kind: "refused",
+			reason
+		}
+	};
+}
+function normaliseMeasured(box) {
+	if (box.frameWidth <= 0 || box.frameHeight <= 0 || box.w <= 0 || box.h <= 0) return null;
+	return {
+		x: box.x / box.frameWidth,
+		y: box.y / box.frameHeight,
+		w: box.w / box.frameWidth,
+		h: box.h / box.frameHeight
+	};
+}
+/**
+* The box measured on THIS key frame: its own `subjectBox`, else the track
+* position at exactly its instant, else a named refusal. Never another
+* frame's box (D303).
+*/
+async function keyFrameBox(deps, trackId, keyFrame) {
+	const own = (await deps.media.listSubjectBoxesByOwner("track", trackId)).find((row) => row.mediaId === keyFrame.mediaId);
+	if (own !== void 0) {
+		const bbox = normaliseMeasured(own.subjectBox);
+		if (bbox !== null) return {
+			bbox,
+			boxSource: { kind: "subjectBox" }
+		};
+	}
+	const track = await deps.tracks.getPersistedByTrackId(trackId);
+	if (track === null) return refused("track-row-missing");
+	const { frameWidth, frameHeight } = track;
+	if (frameWidth === void 0 || frameHeight === void 0) return refused("track-frame-size-unknown");
+	const at = track.positions.find((p) => p.timestamp === keyFrame.timestamp);
+	if (at === void 0) return refused("no-position-at-key-frame");
+	const bbox = normaliseMeasured({
+		...at.bbox,
+		frameWidth,
+		frameHeight
+	});
+	if (bbox === null) return refused("no-position-at-key-frame");
+	return {
+		bbox,
+		boxSource: { kind: "positions" }
+	};
+}
+function hasBox(event) {
+	return event.bbox !== void 0 && event.bbox.w > 0 && event.bbox.h > 0;
+}
 /**
 * Assemble one track's rebuild inputs, reading at most ONE blob.
 *
@@ -72958,7 +73103,8 @@ function hasKeyFrame(source) {
 * to describe, and the caller counts it. A track WITH an event but WITHOUT a
 * key frame still returns a source (with `keyFrame: null`) so the caller's
 * `missingKeyFrame` counter stays the one place that decision is made; no blob
-* is read in that case either.
+* is read in that case either. A key frame with no box measured on it returns
+* `bbox: null` and a named refusal, also without reading the blob.
 */
 async function loadRebuildSource(deps, trackId) {
 	const media = await deps.media.listInfoByOwner("track", trackId);
@@ -72966,26 +73112,44 @@ async function loadRebuildSource(deps, trackId) {
 	const cropInfo = media.find((m) => m.kind === "thumbnail");
 	const peak = await deps.events.peakForTrack(trackId);
 	const events = await deps.events.queryObjectByTrackIds([trackId]);
-	const best = events.find((e) => String(e.id) === peak.bestEventId) ?? events[0];
+	const best = events.find((e) => String(e.id) === peak.bestEventId) ?? events.find(hasBox) ?? events[0];
 	if (best === void 0) return null;
 	const common = {
 		trackId,
 		deviceId: best.deviceId,
-		timestamp: best.timestamp,
 		className: best.className,
 		confidence: best.confidence ?? 0,
-		bbox: normaliseEventBbox(best),
 		...cropInfo !== void 0 ? { mediaId: cropInfo.mediaId } : {}
 	};
-	if (keyFrameInfo === void 0) return {
+	if (keyFrameInfo === void 0) {
+		const bbox = normaliseEventBbox(best);
+		return {
+			...common,
+			timestamp: best.timestamp,
+			bbox,
+			boxSource: bbox !== null ? { kind: "event" } : {
+				kind: "refused",
+				reason: "event-without-box"
+			},
+			keyFrame: null
+		};
+	}
+	const box = await keyFrameBox(deps, trackId, keyFrameInfo);
+	const keyed = {
 		...common,
+		timestamp: keyFrameInfo.timestamp,
+		bbox: box.bbox,
+		boxSource: box.boxSource,
+		keyFrameMediaId: keyFrameInfo.mediaId
+	};
+	if (box.bbox === null) return {
+		...keyed,
 		keyFrame: null
 	};
 	const keyFrameFile = await deps.media.getById(keyFrameInfo.mediaId);
 	return {
-		...common,
-		keyFrame: keyFrameFile ? Buffer.from(keyFrameFile.base64, "base64") : null,
-		keyFrameMediaId: keyFrameInfo.mediaId
+		...keyed,
+		keyFrame: keyFrameFile ? Buffer.from(keyFrameFile.base64, "base64") : null
 	};
 }
 //#endregion
@@ -83534,7 +83698,7 @@ function buildGlobalSettingsSchema(cap) {
 					addonId: "pipeline-analytics",
 					action: "embedding.rebuildStatus",
 					buttonLabel: "Check progress",
-					successMessage: "{modelId} → {index}: indexed {indexed} · scanned {scanned} · rebuilt {rebuilt} · no key frame {missingKeyFrame} · not runnable {notRunnable} · failed {failed}"
+					successMessage: "{modelId} → {index}: indexed {indexed} · scanned {scanned} · rebuilt {rebuilt} · no key frame {missingKeyFrame} · no box {missingBbox} · no event {missingEvent} · not runnable {notRunnable} · failed {failed}"
 				},
 				{
 					type: "addon-action-button",
@@ -84086,16 +84250,6 @@ function buildGlobalSettingsSchema(cap) {
 					step: .01,
 					default: FACE_DEFAULTS.margin
 				},
-				{
-					type: "number",
-					key: "minFaceConfidence",
-					label: "Min face confidence",
-					description: "Minimum face-detection confidence (0–1) for a face to be considered.",
-					min: 0,
-					max: 1,
-					step: .05,
-					default: FACE_DEFAULTS.minFaceConfidence
-				},
 				{
 					type: "number",
 					key: "minFacePx",
@@ -94875,6 +95029,7 @@ var PipelineAnalyticsAddon = class PipelineAnalyticsAddon extends BaseAddon {
 			const deviceIds = await this.retentionDeviceIds();
 			await this.migrateRetiredRetentionSettings(deviceIds);
 			await this.purgeStoredSuggestionThreshold(deviceIds);
+			await this.purgeStoredMinFaceConfidence(deviceIds);
 			await this.runTrackRetentionSweep(deviceIds, now);
 			const eventStore = this.eventStore;
 			const sensorEventStore = this.sensorEventStore;
@@ -95002,6 +95157,80 @@ var PipelineAnalyticsAddon = class PipelineAnalyticsAddon extends BaseAddon {
 	*  this process, and which devices have. One announcement, not a heartbeat. */
 	storedSuggestionCheckedGlobal = false;
 	storedSuggestionCheckedDevices = /* @__PURE__ */ new Set();
+	storedMinFaceConfidenceCheckedGlobal = false;
+	storedMinFaceConfidenceCheckedDevices = /* @__PURE__ */ new Set();
+	/**
+	* One-time: announce the recognizer face-confidence bar D662 retired, then
+	* unset it — globally and per device. Same shape as
+	* {@link purgeStoredSuggestionThreshold}: absence of the key is the marker,
+	* the write goes through `updateGlobalSettings` / `writeDeviceStore`, and the
+	* patch unsets with `undefined`.
+	*
+	* Why it must leave the store and not merely go unread: the bar compared the
+	* DETECTOR's score without knowing which detector produced it, so its units
+	* changed under it when YuNet became the default (D645). A number left in the
+	* blob is an authority the next reader who greps for it would re-adopt — at a
+	* scale nobody can name. The hub carried an interim 0.85 set by hand on
+	* 2026-09-27; the one bar in force is now the detector model's own floor.
+	*/
+	async purgeStoredMinFaceConfidence(deviceIds) {
+		const settings = this.ctxIfReady?.settings;
+		if (!settings) return;
+		if (!this.storedMinFaceConfidenceCheckedGlobal) {
+			this.storedMinFaceConfidenceCheckedGlobal = true;
+			try {
+				const plan = planStoredMinFaceConfidencePurge(await this.resolveGlobalStore());
+				if (plan !== null) {
+					this.announceRetiredFaceConfidenceBar({
+						scope: "global",
+						was: plan.was
+					});
+					await this.updateGlobalSettings(plan.patch);
+				}
+			} catch (err) {
+				this.storedMinFaceConfidenceCheckedGlobal = false;
+				this.ctx.logger.warn("face confidence bar purge failed — will retry", { meta: {
+					scope: "global",
+					error: String(err)
+				} });
+			}
+		}
+		for (const deviceId of deviceIds) {
+			if (this.storedMinFaceConfidenceCheckedDevices.has(deviceId)) continue;
+			this.storedMinFaceConfidenceCheckedDevices.add(deviceId);
+			try {
+				const plan = planStoredMinFaceConfidencePurge(await this.readDeviceBlob(deviceId));
+				if (plan === null) continue;
+				this.announceRetiredFaceConfidenceBar({
+					scope: "device",
+					was: plan.was,
+					deviceId
+				});
+				await settings.writeDeviceStore(deviceId, plan.patch);
+				this.rawDeviceBlobMirror.invalidate(deviceId);
+			} catch (err) {
+				this.storedMinFaceConfidenceCheckedDevices.delete(deviceId);
+				this.ctx.logger.warn("face confidence bar purge failed — will retry", {
+					tags: { deviceId },
+					meta: {
+						scope: "device",
+						error: String(err)
+					}
+				});
+			}
+		}
+	}
+	announceRetiredFaceConfidenceBar(found) {
+		this.ctx.logger.warn("face confidence bar RETIRED — the detector model floor on the runner is the one bar now", {
+			...found.deviceId !== void 0 ? { tags: { deviceId: found.deviceId } } : {},
+			meta: {
+				scope: found.scope,
+				setting: STORED_MIN_FACE_CONFIDENCE_KEY,
+				wasSetTo: found.was,
+				why: "the recognizer compared the detector score without knowing which detector ran; after YuNet became the default its 0.5 was SCRFD’s bar on YuNet’s scale (D662)."
+			}
+		});
+	}
 	/**
 	* One-time: announce the suggestion floor D222 retired, then unset it —
 	* globally and per device.
@@ -97056,6 +97285,15 @@ var PipelineAnalyticsAddon = class PipelineAnalyticsAddon extends BaseAddon {
 				refusal: "stores-unavailable"
 			};
 		}
+		const force = input.force === true;
+		if (force && input.maxTracks === void 0) {
+			this.ctx.logger.warn("rebuildObjectEmbeddings: refusing a force pass with no maxTracks", { meta: { refusal: "force-requires-max-tracks" } });
+			return {
+				started: false,
+				alreadyRunning: false,
+				refusal: "force-requires-max-tracks"
+			};
+		}
 		const confirmation = await this.getClusterPinConfirmer(api, "clip-rebuild").confirm();
 		if (confirmation.kind === "refused") {
 			this.ctx.logger.warn("rebuildObjectEmbeddings: the cluster CLIP model is not confirmed — refusing to start a pass that cannot pin one", { meta: { refusal: confirmation.reason } });
@@ -97099,16 +97337,17 @@ var PipelineAnalyticsAddon = class PipelineAnalyticsAddon extends BaseAddon {
 			logger: this.ctx.logger
 		}));
 		const deps = {
-			listTrackIdPage: async (cursor) => trackStore.queryRecentIds({
+			listTrackIdPage: async (cursor) => trackStore.queryRecentIds(rebuildTrackPageQuery({
 				deviceIds,
 				...input.since !== void 0 ? { since: input.since } : {},
 				...input.until !== void 0 ? { until: input.until } : {},
 				...cursor !== null ? { cursor } : {},
 				limit: REBUILD_PAGE_SIZE
-			}),
+			})),
 			loadSource: (trackId) => loadRebuildSource({
 				media: mediaStore,
-				events: eventStore
+				events: eventStore,
+				tracks: trackStore
 			}, trackId),
 			recoverKeyFrame: async (source) => {
 				const recovered = await recordedStills.recover(source.deviceId, source.timestamp, RECOVERED_KEY_FRAME_MAX_WIDTH);
@@ -97134,7 +97373,8 @@ var PipelineAnalyticsAddon = class PipelineAnalyticsAddon extends BaseAddon {
 				if (split === null) return null;
 				return {
 					outOfSpace: split.outOfSpaceIds,
-					alreadyInSpace: split.inSpace
+					alreadyInSpace: split.inSpace,
+					inSpace: split.inSpaceIds
 				};
 			},
 			logger: {
@@ -97146,6 +97386,7 @@ var PipelineAnalyticsAddon = class PipelineAnalyticsAddon extends BaseAddon {
 			running: true,
 			modelId,
 			index,
+			force,
 			startedAtMs: Date.now(),
 			progress: {
 				scanned: 0,
@@ -97154,6 +97395,14 @@ var PipelineAnalyticsAddon = class PipelineAnalyticsAddon extends BaseAddon {
 				recoveredKeyFrame: 0,
 				missingEvent: 0,
 				missingBbox: 0,
+				boxSource: {
+					subjectBox: 0,
+					positions: 0,
+					event: 0,
+					refused: 0
+				},
+				forcedInSpace: 0,
+				skippedOutOfSpace: 0,
 				alreadyInSpace: 0,
 				notRunnable: 0,
 				noCapableNode: 0,
@@ -97161,6 +97410,7 @@ var PipelineAnalyticsAddon = class PipelineAnalyticsAddon extends BaseAddon {
 			}
 		};
 		rebuildObjectEmbeddings(deps, {
+			force,
 			...input.maxTracks !== void 0 ? { maxTracks: input.maxTracks } : {},
 			...input.pacingMs !== void 0 ? { pacingMs: input.pacingMs } : {},
 			onProgress: (progress) => {
@@ -97172,6 +97422,7 @@ var PipelineAnalyticsAddon = class PipelineAnalyticsAddon extends BaseAddon {
 				running: false,
 				modelId,
 				index,
+				force,
 				startedAtMs: this.rebuildState.startedAtMs ?? Date.now(),
 				finishedAtMs: Date.now(),
 				progress: outcome,
@@ -97187,6 +97438,7 @@ var PipelineAnalyticsAddon = class PipelineAnalyticsAddon extends BaseAddon {
 				running: false,
 				modelId,
 				index,
+				force,
 				startedAtMs: this.rebuildState.startedAtMs ?? Date.now(),
 				finishedAtMs: Date.now(),
 				error: String(err)
@@ -97201,7 +97453,8 @@ var PipelineAnalyticsAddon = class PipelineAnalyticsAddon extends BaseAddon {
 			modelId,
 			index,
 			deviceId: input.deviceId ?? "all",
-			maxTracks: input.maxTracks ?? "unbounded"
+			maxTracks: input.maxTracks ?? "unbounded",
+			force
 		} });
 		return {
 			started: true,
@@ -98203,8 +98456,18 @@ var PipelineAnalyticsAddon = class PipelineAnalyticsAddon extends BaseAddon {
 			running: state.running,
 			scanned: p?.scanned ?? 0,
 			rebuilt: p?.rebuilt ?? 0,
-			missingKeyFrame: (p?.missingKeyFrame ?? 0) + (p?.missingEvent ?? 0),
+			missingKeyFrame: p?.missingKeyFrame ?? 0,
+			missingEvent: p?.missingEvent ?? 0,
 			missingBbox: p?.missingBbox ?? 0,
+			boxSource: p?.boxSource ?? {
+				subjectBox: 0,
+				positions: 0,
+				event: 0,
+				refused: 0
+			},
+			alreadyInSpace: p?.alreadyInSpace ?? 0,
+			force: state.force ?? null,
+			forcedInSpace: p?.forcedInSpace ?? 0,
 			notRunnable: p?.notRunnable ?? 0,
 			noCapableNode: p?.noCapableNode ?? 0,
 			failed: p?.failed ?? 0,