@camstack/addon-post-analysis 1.2.290 → 1.2.291

package/dist/{clip-model-registry--sFeijO7.js → clip-model-registry-CTY5co6P.js}

@@ -23215,7 +23215,15 @@ var RebuildObjectEmbeddingsInput = object({
 	* force is logged at start and finish so a deliberately slow pass reads
 	* differently from a stalled one.
 	*/
-	pacingMs: number().int().nonnegative().optional()
+	pacingMs: number().int().nonnegative().optional(),
+	/**
+	* Re-embed ONLY the tracks whose vector is ALREADY in the pinned model's
+	* space (D664) — the in-space skip inverted. It exists to redo vectors
+	* written from the wrong box, which a normal pass would skip as done
+	* forever. Requires `maxTracks`: a forced pass without a bound is refused
+	* (`force-requires-max-tracks`).
+	*/
+	force: boolean().optional()
 });
 /**
 * Result of emptying the CLIP index.
@@ -23251,6 +23259,7 @@ var WipeObjectEmbeddingsResultSchema = object({
 *    - `reads-disagree` — the two reads named different choices.
 *  - `not-a-clip-model` — the CONFIRMED id has no CLIP metadata, so there is no
 *    index to fill and no dimension to check against (D649).
+*  - `force-requires-max-tracks` — `force: true` with no `maxTracks` (D664).
 */
 var RebuildObjectEmbeddingsRefusalSchema = _enum([
 	"stores-unavailable",
@@ -23258,7 +23267,8 @@ var RebuildObjectEmbeddingsRefusalSchema = _enum([
 	"method-unavailable",
 	"read-failed",
 	"reads-disagree",
-	"not-a-clip-model"
+	"not-a-clip-model",
+	"force-requires-max-tracks"
 ]);
 /**
 * Acknowledgement that a rebuild STARTED.
@@ -23283,11 +23293,32 @@ var RebuildStatusSchema = object({
 	running: boolean(),
 	scanned: number(),
 	rebuilt: number(),
-	/** Tracks whose key frame is gone — nothing to re-embed from. */
+	/** Tracks whose key frame is gone — nothing to re-embed from. Pixels ONLY:
+	*  `missingEvent` is its own field since D664, never summed in. */
 	missingKeyFrame: number(),
-	/** Tracks with no usable detection box. */
+	/** Tracks with no object event at all (D664). */
+	missingEvent: number(),
+	/** Tracks with no box measured on the pixels to cut — see `boxSource.refused`. */
 	missingBbox: number(),
 	/**
+	* Which rule placed each judged track's box (D664): the key frame row's own
+	* `subjectBox`, `track.positions` at exactly its instant (older key frames),
+	* the event box (a key frame recovered from the recording, at the event's
+	* instant), or `refused` by name — the reasons are in the tagged log lines.
+	*/
+	boxSource: object({
+		subjectBox: number(),
+		positions: number(),
+		event: number(),
+		refused: number()
+	}),
+	/** Tracks skipped because their vector is already in the pinned space. */
+	alreadyInSpace: number(),
+	/** Whether the current / last pass was a `force` pass; `null` before any (D664). */
+	force: boolean().nullable(),
+	/** In-space tracks a `force` pass selected for re-embedding. */
+	forcedInSpace: number(),
+	/**
 	* Tracks an executing node REFUSED rather than broke on — an unreadable key
 	* frame, a step that threw. Separate from `failed` because the remedy is
 	* different, and because a whole camera silently contributing zero vectors

package/dist/{clip-model-registry-CoYBCvtr.mjs → clip-model-registry-Cudz--Ql.mjs}

@@ -23184,7 +23184,15 @@ var RebuildObjectEmbeddingsInput = object({
 	* force is logged at start and finish so a deliberately slow pass reads
 	* differently from a stalled one.
 	*/
-	pacingMs: number().int().nonnegative().optional()
+	pacingMs: number().int().nonnegative().optional(),
+	/**
+	* Re-embed ONLY the tracks whose vector is ALREADY in the pinned model's
+	* space (D664) — the in-space skip inverted. It exists to redo vectors
+	* written from the wrong box, which a normal pass would skip as done
+	* forever. Requires `maxTracks`: a forced pass without a bound is refused
+	* (`force-requires-max-tracks`).
+	*/
+	force: boolean().optional()
 });
 /**
 * Result of emptying the CLIP index.
@@ -23220,6 +23228,7 @@ var WipeObjectEmbeddingsResultSchema = object({
 *    - `reads-disagree` — the two reads named different choices.
 *  - `not-a-clip-model` — the CONFIRMED id has no CLIP metadata, so there is no
 *    index to fill and no dimension to check against (D649).
+*  - `force-requires-max-tracks` — `force: true` with no `maxTracks` (D664).
 */
 var RebuildObjectEmbeddingsRefusalSchema = _enum([
 	"stores-unavailable",
@@ -23227,7 +23236,8 @@ var RebuildObjectEmbeddingsRefusalSchema = _enum([
 	"method-unavailable",
 	"read-failed",
 	"reads-disagree",
-	"not-a-clip-model"
+	"not-a-clip-model",
+	"force-requires-max-tracks"
 ]);
 /**
 * Acknowledgement that a rebuild STARTED.
@@ -23252,11 +23262,32 @@ var RebuildStatusSchema = object({
 	running: boolean(),
 	scanned: number(),
 	rebuilt: number(),
-	/** Tracks whose key frame is gone — nothing to re-embed from. */
+	/** Tracks whose key frame is gone — nothing to re-embed from. Pixels ONLY:
+	*  `missingEvent` is its own field since D664, never summed in. */
 	missingKeyFrame: number(),
-	/** Tracks with no usable detection box. */
+	/** Tracks with no object event at all (D664). */
+	missingEvent: number(),
+	/** Tracks with no box measured on the pixels to cut — see `boxSource.refused`. */
 	missingBbox: number(),
 	/**
+	* Which rule placed each judged track's box (D664): the key frame row's own
+	* `subjectBox`, `track.positions` at exactly its instant (older key frames),
+	* the event box (a key frame recovered from the recording, at the event's
+	* instant), or `refused` by name — the reasons are in the tagged log lines.
+	*/
+	boxSource: object({
+		subjectBox: number(),
+		positions: number(),
+		event: number(),
+		refused: number()
+	}),
+	/** Tracks skipped because their vector is already in the pinned space. */
+	alreadyInSpace: number(),
+	/** Whether the current / last pass was a `force` pass; `null` before any (D664). */
+	force: boolean().nullable(),
+	/** In-space tracks a `force` pass selected for re-embedding. */
+	forcedInSpace: number(),
+	/**
 	* Tracks an executing node REFUSED rather than broke on — an unreadable key
 	* frame, a step that threw. Separate from `failed` because the remedy is
 	* different, and because a whole camera silently contributing zero vectors

package/dist/embedding-encoder/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--sFeijO7.js");
+const require_clip_model_registry = require("../clip-model-registry-CTY5co6P.js");
 let node_fs = require("node:fs");
 node_fs = require_clip_model_registry.__toESM(node_fs);
 let node_path = require("node:path");

package/dist/embedding-encoder/index.mjs

@@ -1,4 +1,4 @@
-import { Bn as normalizeNodeId, Ht as embeddingRequirementsUnavailableError, Rt as embeddingEncoderCapability, Vt as embeddingRequirementsFailedError, a as CLIP_EMBEDDING_STEP_ID, c as resolveClusterModelPin, ft as PoolMemoryWatchdog, i as CLIP_TEXT_MODELS, jn as BaseAddon, mn as resolvePoolMemoryPolicy, n as DEFAULT_CLIP_MODEL, r as CLIP_IMAGE_MODELS, sn as parseProcStatus, t as BUILTIN_CLIP_MODELS, zt as embeddingModelFailedError } from "../clip-model-registry-CoYBCvtr.mjs";
+import { Bn as normalizeNodeId, Ht as embeddingRequirementsUnavailableError, Rt as embeddingEncoderCapability, Vt as embeddingRequirementsFailedError, a as CLIP_EMBEDDING_STEP_ID, c as resolveClusterModelPin, ft as PoolMemoryWatchdog, i as CLIP_TEXT_MODELS, jn as BaseAddon, mn as resolvePoolMemoryPolicy, n as DEFAULT_CLIP_MODEL, r as CLIP_IMAGE_MODELS, sn as parseProcStatus, t as BUILTIN_CLIP_MODELS, zt as embeddingModelFailedError } from "../clip-model-registry-Cudz--Ql.mjs";
 import { createRequire } from "node:module";
 import * as fs from "node:fs";
 import * as path$1 from "node:path";

package/dist/pipeline-analytics/{_virtual_mf-localSharedImportMap___mfe_internal__addon_pipeline_analytics_widgets-r3ZZOSzj.mjs → _virtual_mf-localSharedImportMap___mfe_internal__addon_pipeline_analytics_widgets-CBHxwCSj.mjs}

@@ -18,7 +18,7 @@ var e = {
 	},
 	"@camstack/types": {
 		name: "@camstack/types",
-		version: "1.2.266",
+		version: "1.2.267",
 		scope: ["default"],
 		loaded: !1,
 		from: "addon_pipeline_analytics_widgets",

package/dist/pipeline-analytics/{hostInit-PoeIZAFx.mjs → hostInit-DSKT2dE4.mjs}

@@ -36,7 +36,7 @@ async function r() {
 				}
 			},
 			"@camstack/types": {
-				version: "1.2.266",
+				version: "1.2.267",
 				scope: "default",
 				shareConfig: {
 					singleton: !0,

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--sFeijO7.js");
+const require_clip_model_registry = require("../clip-model-registry-CTY5co6P.js");
 let node_fs = require("node:fs");
 node_fs = require_clip_model_registry.__toESM(node_fs, 1);
 let node_path = require("node:path");
@@ -39677,7 +39677,12 @@ var RebuildInputSchema = require_clip_model_registry.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: require_clip_model_registry.number().int().nonnegative().optional()
+	pacingMs: require_clip_model_registry.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: require_clip_model_registry.boolean().optional()
 });
 var RebuildStartedSchema = require_clip_model_registry.object({
 	started: require_clip_model_registry.boolean(),
@@ -39697,7 +39702,20 @@ var RebuildStatusSchema = require_clip_model_registry.object({
 	scanned: require_clip_model_registry.number(),
 	rebuilt: require_clip_model_registry.number(),
 	missingKeyFrame: require_clip_model_registry.number(),
+	/** No object event at all — its own number since D664. */
+	missingEvent: require_clip_model_registry.number(),
 	missingBbox: require_clip_model_registry.number(),
+	/** Which rule placed each judged track's box (D664). */
+	boxSource: require_clip_model_registry.object({
+		subjectBox: require_clip_model_registry.number(),
+		positions: require_clip_model_registry.number(),
+		event: require_clip_model_registry.number(),
+		refused: require_clip_model_registry.number()
+	}),
+	alreadyInSpace: require_clip_model_registry.number(),
+	/** Whether the current / last pass was a `force` pass (D664). */
+	force: require_clip_model_registry.boolean().nullable(),
+	forcedInSpace: require_clip_model_registry.number(),
 	/** Refused by the executing node (unreadable key frame / bad box), not broken. */
 	notRunnable: require_clip_model_registry.number(),
 	/** The pass STOPPED: no node in the cluster could serve the pinned model. */
@@ -40972,7 +40990,7 @@ function toPixelBox(b) {
 		h: b.height
 	};
 }
-function refused(reason, detail) {
+function refused$1(reason, detail) {
 	return {
 		kind: "refused",
 		reason,
@@ -41000,8 +41018,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) {
@@ -41010,13 +41028,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,
@@ -41027,10 +41045,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,
@@ -53746,11 +53764,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;
@@ -62453,6 +62470,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.
 *
@@ -62468,6 +62505,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;
@@ -62478,6 +62523,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) {
@@ -62485,9 +62536,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;
 			}
@@ -62503,6 +62559,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";
@@ -62521,6 +62578,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) {
@@ -62532,10 +62608,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
@@ -62603,6 +62675,9 @@ async function rebuildObjectEmbeddings(deps, options = {}) {
 				recoveredKeyFrame,
 				missingEvent,
 				missingBbox,
+				boxSource: boxSourceCounts(),
+				forcedInSpace,
+				skippedOutOfSpace,
 				alreadyInSpace,
 				notRunnable,
 				noCapableNode,
@@ -62626,6 +62701,10 @@ async function rebuildObjectEmbeddings(deps, options = {}) {
 		recoveredKeyFrame,
 		missingEvent,
 		missingBbox,
+		boxSource: boxSourceCounts(),
+		force,
+		forcedInSpace,
+		skippedOutOfSpace,
 		alreadyInSpace,
 		notRunnable,
 		noCapableNode,
@@ -62640,6 +62719,9 @@ async function rebuildObjectEmbeddings(deps, options = {}) {
 		recoveredKeyFrame,
 		missingEvent,
 		missingBbox,
+		boxSource: boxSourceCounts(),
+		forcedInSpace,
+		skippedOutOfSpace,
 		alreadyInSpace,
 		notRunnable,
 		noCapableNode,
@@ -73038,6 +73120,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.
 *
@@ -73045,7 +73179,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);
@@ -73053,26 +73188,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
@@ -83621,7 +83774,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",
@@ -97208,6 +97361,15 @@ var PipelineAnalyticsAddon = class PipelineAnalyticsAddon extends require_clip_m
 				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 } });
@@ -97251,16 +97413,17 @@ var PipelineAnalyticsAddon = class PipelineAnalyticsAddon extends require_clip_m
 			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);
@@ -97286,7 +97449,8 @@ var PipelineAnalyticsAddon = class PipelineAnalyticsAddon extends require_clip_m
 				if (split === null) return null;
 				return {
 					outOfSpace: split.outOfSpaceIds,
-					alreadyInSpace: split.inSpace
+					alreadyInSpace: split.inSpace,
+					inSpace: split.inSpaceIds
 				};
 			},
 			logger: {
@@ -97298,6 +97462,7 @@ var PipelineAnalyticsAddon = class PipelineAnalyticsAddon extends require_clip_m
 			running: true,
 			modelId,
 			index,
+			force,
 			startedAtMs: Date.now(),
 			progress: {
 				scanned: 0,
@@ -97306,6 +97471,14 @@ var PipelineAnalyticsAddon = class PipelineAnalyticsAddon extends require_clip_m
 				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,
@@ -97313,6 +97486,7 @@ var PipelineAnalyticsAddon = class PipelineAnalyticsAddon extends require_clip_m
 			}
 		};
 		rebuildObjectEmbeddings(deps, {
+			force,
 			...input.maxTracks !== void 0 ? { maxTracks: input.maxTracks } : {},
 			...input.pacingMs !== void 0 ? { pacingMs: input.pacingMs } : {},
 			onProgress: (progress) => {
@@ -97324,6 +97498,7 @@ var PipelineAnalyticsAddon = class PipelineAnalyticsAddon extends require_clip_m
 				running: false,
 				modelId,
 				index,
+				force,
 				startedAtMs: this.rebuildState.startedAtMs ?? Date.now(),
 				finishedAtMs: Date.now(),
 				progress: outcome,
@@ -97339,6 +97514,7 @@ var PipelineAnalyticsAddon = class PipelineAnalyticsAddon extends require_clip_m
 				running: false,
 				modelId,
 				index,
+				force,
 				startedAtMs: this.rebuildState.startedAtMs ?? Date.now(),
 				finishedAtMs: Date.now(),
 				error: String(err)
@@ -97353,7 +97529,8 @@ var PipelineAnalyticsAddon = class PipelineAnalyticsAddon extends require_clip_m
 			modelId,
 			index,
 			deviceId: input.deviceId ?? "all",
-			maxTracks: input.maxTracks ?? "unbounded"
+			maxTracks: input.maxTracks ?? "unbounded",
+			force
 		} });
 		return {
 			started: true,
@@ -98355,8 +98532,18 @@ var PipelineAnalyticsAddon = class PipelineAnalyticsAddon extends require_clip_m
 			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,

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-CoYBCvtr.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,
@@ -72962,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.
 *
@@ -72969,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);
@@ -72977,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
@@ -83545,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",
@@ -97132,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 } });
@@ -97175,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);
@@ -97210,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: {
@@ -97222,6 +97386,7 @@ var PipelineAnalyticsAddon = class PipelineAnalyticsAddon extends BaseAddon {
 			running: true,
 			modelId,
 			index,
+			force,
 			startedAtMs: Date.now(),
 			progress: {
 				scanned: 0,
@@ -97230,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,
@@ -97237,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) => {
@@ -97248,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,
@@ -97263,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)
@@ -97277,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,
@@ -98279,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,

package/dist/pipeline-analytics/remoteEntry.js

@@ -30,7 +30,7 @@ async function d(e) {
 	}
 }
 async function f() {
-	return l ||= d(() => import("./_virtual_mf-localSharedImportMap___mfe_internal__addon_pipeline_analytics_widgets-r3ZZOSzj.mjs")).catch((e) => {
+	return l ||= d(() => import("./_virtual_mf-localSharedImportMap___mfe_internal__addon_pipeline_analytics_widgets-CBHxwCSj.mjs")).catch((e) => {
 		throw l = void 0, e;
 	}), l;
 }

package/package.json

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