@camstack/addon-post-analysis 1.2.117 → 1.2.118

package/dist/pipeline-analytics/index.js

@@ -2,7 +2,7 @@ Object.defineProperties(exports, {
 	__esModule: { value: true },
 	[Symbol.toStringTag]: { value: "Module" }
 });
-const require_dist = require("../dist-Dk-BdVHw.js");
+const require_dist = require("../dist-CO6pe7bi.js");
 let node_fs = require("node:fs");
 node_fs = require_dist.__toESM(node_fs, 1);
 let node_path = require("node:path");
@@ -25924,7 +25924,7 @@ var CLASS_RANK_VEHICLE = .8;
 var CLASS_RANK_ANIMAL = .5;
 var CLASS_RANK_DEFAULT = .25;
 var PERSON_CLASSES = new Set(["person", "face"]);
-var VEHICLE_CLASSES = new Set([
+var VEHICLE_CLASSES$1 = new Set([
 	"vehicle",
 	"car",
 	"truck",
@@ -25955,7 +25955,7 @@ function clamp01$1(x) {
 function classRank(className) {
 	const c = className.toLowerCase();
 	if (PERSON_CLASSES.has(c)) return 1;
-	if (VEHICLE_CLASSES.has(c)) return CLASS_RANK_VEHICLE;
+	if (VEHICLE_CLASSES$1.has(c)) return CLASS_RANK_VEHICLE;
 	if (ANIMAL_CLASSES.has(c)) return CLASS_RANK_ANIMAL;
 	return CLASS_RANK_DEFAULT;
 }
@@ -26558,7 +26558,7 @@ var FaceGalleryProvider = class {
 		const identities = await this.identityStore.listIdentities();
 		const nameMap = new Map(identities.map((i) => [i.id, i.name]));
 		const identityName = face.recognizedIdentityId ? nameMap.get(face.recognizedIdentityId) : void 0;
-		const base64 = await this.faceCropBase64(face);
+		const cropUrl = this.cropUrlFor(face);
 		return {
 			faceId: face.id,
 			deviceId: face.deviceId,
@@ -26567,7 +26567,7 @@ var FaceGalleryProvider = class {
 			...face.recognizedIdentityId != null ? { recognizedIdentityId: face.recognizedIdentityId } : {},
 			...identityName !== void 0 ? { identityName } : {},
 			assigned: face.assigned,
-			...base64 !== void 0 ? { base64 } : {},
+			...cropUrl !== void 0 ? { cropUrl } : {},
 			...face.faceBbox !== void 0 ? { faceBbox: face.faceBbox } : {},
 			...face.keyFrameMediaKey !== void 0 ? { keyFrameMediaKey: face.keyFrameMediaKey } : {},
 			...face.bestMatchScore != null ? { bestMatchScore: face.bestMatchScore } : {},
@@ -29687,9 +29687,15 @@ var TrackCloser = class {
 			await this.suppressZeroMedia(t.deviceId, t.trackId);
 			return;
 		}
-		if (outcome === "raster-fallback" && closure?.rasterFallback) await this.commitRasterFallback(t, closure.rasterFallback.jpeg, closure.rasterFallback.timestamp);
+		let thumbnailLanded = ownedMedia.some((m) => m.kind === "thumbnail");
+		if (outcome === "raster-fallback" && closure?.rasterFallback) {
+			await this.commitRasterFallback(t, closure.rasterFallback.jpeg, closure.rasterFallback.timestamp);
+			thumbnailLanded = true;
+		}
 		await this.maybePromoteLastFrame(t, ownedMedia);
-		await this.maybeDeriveThumbnailFromKeyFrame(t, ownedMedia);
+		const hasRasterFallback = closure?.rasterFallback !== void 0;
+		if (!thumbnailLanded) thumbnailLanded = await this.maybeDeriveThumbnailFromKeyFrame(t, ownedMedia, hasRasterFallback);
+		if (!thumbnailLanded && closure?.rasterFallback) await this.commitRasterFallback(t, closure.rasterFallback.jpeg, closure.rasterFallback.timestamp);
 		this.deps.logger.info("track ended", {
 			tags: { deviceId: t.deviceId },
 			meta: {
@@ -29807,14 +29813,23 @@ var TrackCloser = class {
 	* and the rate could only ever be counted from the database, after the fact.
 	* A branch that drops work silently reads as "never happened".
 	*/
-	async maybeDeriveThumbnailFromKeyFrame(t, ownedMedia) {
-		if (ownedMedia.some((m) => m.kind === "thumbnail")) return;
+	async maybeDeriveThumbnailFromKeyFrame(t, ownedMedia, hasRasterFallback) {
+		if (ownedMedia.some((m) => m.kind === "thumbnail")) return true;
 		const derive = this.deps.deriveThumbnailFromKeyFrame;
-		if (!derive) return this.logNoThumbnailAtClose(t, "derive-not-wired");
+		if (!derive) {
+			if (!hasRasterFallback) this.logNoThumbnailAtClose(t, "derive-not-wired");
+			return false;
+		}
 		const keyFrame = ownedMedia.find((m) => m.kind === "keyFrame");
-		if (!keyFrame) return this.logNoThumbnailAtClose(t, "no-key-frame");
+		if (!keyFrame) {
+			if (!hasRasterFallback) this.logNoThumbnailAtClose(t, "no-key-frame");
+			return false;
+		}
 		const bestSeen = this.deps.residents.bestSeenBbox(t.trackId);
-		if (!bestSeen) return this.logNoThumbnailAtClose(t, "no-best-seen-bbox");
+		if (!bestSeen) {
+			if (!hasRasterFallback) this.logNoThumbnailAtClose(t, "no-best-seen-bbox");
+			return false;
+		}
 		try {
 			const derived = await derive({
 				mediaKey: keyFrame.key,
@@ -29826,17 +29841,23 @@ var TrackCloser = class {
 				},
 				frameWidth: bestSeen.frameWidth,
 				frameHeight: bestSeen.frameHeight,
-				timestamp: bestSeen.timestamp
+				timestamp: keyFrame.timestamp
 			});
-			if (!derived) return this.logNoThumbnailAtClose(t, "derive-returned-null", { keyFrameKey: keyFrame.key });
+			if (!derived) {
+				if (!hasRasterFallback) this.logNoThumbnailAtClose(t, "derive-returned-null", { keyFrameKey: keyFrame.key });
+				return false;
+			}
 			const mediaStore = this.deps.mediaStore();
-			if (!mediaStore) return this.logNoThumbnailAtClose(t, "no-media-store");
+			if (!mediaStore) {
+				if (!hasRasterFallback) this.logNoThumbnailAtClose(t, "no-media-store");
+				return false;
+			}
 			await mediaStore.put({
 				deviceId: t.deviceId,
 				ownerKind: "track",
 				ownerId: t.trackId,
 				kind: "thumbnail",
-				timestamp: bestSeen.timestamp,
+				timestamp: keyFrame.timestamp,
 				data: derived.thumbnail
 			});
 			await mediaStore.put({
@@ -29844,7 +29865,7 @@ var TrackCloser = class {
 				ownerKind: "track",
 				ownerId: t.trackId,
 				kind: "thumbnailSmall",
-				timestamp: bestSeen.timestamp,
+				timestamp: keyFrame.timestamp,
 				data: derived.thumbnailSmall
 			});
 			this.deps.logger.info("thumbnail derived from keyFrame at close (no live best-shot landed)", {
@@ -29855,6 +29876,7 @@ var TrackCloser = class {
 					skewMs: derived.skewMs
 				}
 			});
+			return true;
 		} catch (err) {
 			this.deps.logger.debug("close-time keyFrame thumbnail derive failed", {
 				tags: { deviceId: t.deviceId },
@@ -29863,10 +29885,11 @@ var TrackCloser = class {
 					error: String(err)
 				}
 			});
-			this.logNoThumbnailAtClose(t, "derive-threw", {
+			if (!hasRasterFallback) this.logNoThumbnailAtClose(t, "derive-threw", {
 				keyFrameKey: keyFrame.key,
 				error: String(err)
 			});
+			return false;
 		}
 	}
 	/**
@@ -30736,6 +30759,7 @@ var PlateGalleryProvider = class {
 	logger;
 	refreshGallery;
 	emitPlateGalleryChanged;
+	eventMediaBaseUrl;
 	constructor(deps) {
 		this.plateStore = deps.plateStore;
 		this.vehicleStore = deps.vehicleStore;
@@ -30745,6 +30769,7 @@ var PlateGalleryProvider = class {
 		this.logger = deps.logger;
 		this.refreshGallery = deps.refreshGallery;
 		this.emitPlateGalleryChanged = deps.emitPlateGalleryChanged;
+		this.eventMediaBaseUrl = deps.eventMediaBaseUrl;
 	}
 	/** Best-effort emit — never allowed to fail the mutation it follows. */
 	safeEmitPlateGalleryChanged(payload) {
@@ -30752,6 +30777,12 @@ var PlateGalleryProvider = class {
 			this.emitPlateGalleryChanged(payload);
 		} catch {}
 	}
+	cropUrlFor(plate) {
+		if (plate.mediaKey === void 0 || plate.mediaKey === "") return void 0;
+		const base = this.eventMediaBaseUrl();
+		if (base === null) return void 0;
+		return `${base}/${encodeURIComponent(plate.mediaKey)}`;
+	}
 	async plateCropBase64(plate) {
 		if (plate.mediaKey) {
 			const m = await this.mediaStore.getByKey(plate.mediaKey);
@@ -30760,8 +30791,9 @@ var PlateGalleryProvider = class {
 		const media = await this.mediaStore.listByOwner("plate", plate.id);
 		return media.length > 0 ? media[0].base64 : void 0;
 	}
-	async toPlateInfo(plate, nameMap) {
-		const base64 = await this.plateCropBase64(plate);
+	async toPlateInfo(plate, nameMap, opts) {
+		const base64 = opts?.includeCrops ?? true ? await this.plateCropBase64(plate) : void 0;
+		const cropUrl = this.cropUrlFor(plate);
 		const vehicleName = plate.recognizedVehicleId != null ? nameMap?.get(plate.recognizedVehicleId) : void 0;
 		return {
 			plateId: plate.id,
@@ -30776,7 +30808,8 @@ var PlateGalleryProvider = class {
 			...vehicleName !== void 0 ? { vehicleName } : {},
 			...plate.plateBbox !== void 0 ? { plateBbox: plate.plateBbox } : {},
 			...plate.keyFrameMediaKey !== void 0 ? { keyFrameMediaKey: plate.keyFrameMediaKey } : {},
-			...base64 !== void 0 ? { base64 } : {}
+			...base64 !== void 0 ? { base64 } : {},
+			...cropUrl !== void 0 ? { cropUrl } : {}
 		};
 	}
 	async vehicleNameMap() {
@@ -30795,7 +30828,7 @@ var PlateGalleryProvider = class {
 		const plate = await this.plateStore.get(`plate-${input.trackId}`);
 		if (!plate || plate.deviceId !== input.deviceId) return null;
 		const nameMap = await this.vehicleNameMap();
-		return this.toPlateInfo(plate, nameMap);
+		return this.toPlateInfo(plate, nameMap, { includeCrops: false });
 	}
 	async getPlateMedia(input) {
 		return (await this.mediaStore.listByOwner("plate", input.plateId)).map((m) => ({
@@ -35936,6 +35969,19 @@ function createEventMediaHandler(deps) {
 	};
 }
 //#endregion
+//#region src/pipeline-analytics/copy-face-crop-preview.ts
+var TRACK_PREVIEW_KINDS = new Set(["thumbnail", "thumbnailSmall"]);
+async function copyFaceCropIfTrackHasNoThumbnail(store, input) {
+	if ((await store.listTrackMedia(input.trackId)).some((m) => TRACK_PREVIEW_KINDS.has(m.kind))) return false;
+	await store.putTrackThumbnail({
+		deviceId: input.deviceId,
+		trackId: input.trackId,
+		timestamp: input.timestamp,
+		data: input.crop
+	});
+	return true;
+}
+//#endregion
 //#region src/pipeline-analytics/event-thumbnail-resolver.ts
 /** Pick an event-OWNED media blob: the tight `crop`, else the native-res boxed
 *  `fullFrameBoxed`, else any available file. Both preferred kinds are RETIRED
@@ -35944,29 +35990,47 @@ function createEventMediaHandler(deps) {
 function pickEventOwnedMedia(files) {
 	return files.find((f) => f.kind === "crop") ?? files.find((f) => f.kind === "fullFrameBoxed") ?? files[0];
 }
-/** Pick a track's fallback media in the shared cadence-preference order the
-*  KeyEvent path uses: `thumbnailSmall` (480 fast-load) → best `thumbnail` →
-*  rolling `lastFrame` → `firstFrame` → newest `snapshot` → any track blob.
-*  Undefined when the track owns no media. */
+/** Pick a track's fallback media when no subject crop exists: `thumbnailSmall`
+*  → `thumbnail` → native `keyFrameSmall`/`keyFrame`/`fullFrame` → rolling
+*  `lastFrame` → `firstFrame` → newest `snapshot` → any blob. A full frame
+*  beats a class icon. Undefined when the owner has no media. */
 function pickTrackFallbackMedia(files) {
-	return files.find((f) => f.kind === "thumbnailSmall") ?? files.find((f) => f.kind === "thumbnail") ?? files.find((f) => f.kind === "lastFrame") ?? files.find((f) => f.kind === "firstFrame") ?? [...files].reverse().find((f) => f.kind === "snapshot") ?? files[files.length - 1];
+	return files.find((f) => f.kind === "thumbnailSmall") ?? files.find((f) => f.kind === "thumbnail") ?? files.find((f) => f.kind === "keyFrameSmall") ?? files.find((f) => f.kind === "keyFrame") ?? files.find((f) => f.kind === "fullFrame") ?? files.find((f) => f.kind === "lastFrame") ?? files.find((f) => f.kind === "firstFrame") ?? [...files].reverse().find((f) => f.kind === "snapshot") ?? files[files.length - 1];
 }
 /**
-* Crop-forced resolution (the `?kind=crop` reel/timeline path). Prefer a CLEAN
-* (never-boxed) frame via the injected `pickClean`; when the track owns NO clean
-* frame at all — the regression class created by retiring `crop`/`fullFrame`
-* production (2026-07-21), leaving degenerate tracks with only boxed
-* `lastFrame`/`snapshot`/`firstFrame` — degrade to ANY track media rather than
-* returning undefined. A boxed frame (with the target's box drawn) is a real
-* preview; an empty tile is not. Clean is always tried FIRST so the common case
-* still serves an unboxed tile. Undefined only when the owner has NO media.
+* Crop-forced resolution (the `?kind=crop` / `?kind=thumbnailSmall` reel path).
+*
+* Ladder: body crop (track/event thumbnail) → tight face/plate crop → any
+* remaining image (keyFrame / lastFrame / …). The class icon is only honest
+* when the owner has no stored bytes at all.
 *
 * `pickClean` is injected because the clean-kind picker (`pickCleanMedia`) lives
 * in the addon `index.ts` over the concrete `MediaFileKind` set; this keeps the
 * composition pure + unit-testable here.
 */
-function resolveCropForcedMedia(files, pickClean) {
-	return pickClean(files) ?? pickTrackFallbackMedia(files);
+function resolveCropForcedMedia(files, pickClean, detailFiles = []) {
+	return pickClean(files) ?? pickClean(detailFiles) ?? pickTrackFallbackMedia([...files, ...detailFiles]);
+}
+/**
+* Event + track media (the body/scene) and face/plate media (the detail
+* crops). Face rows live under `face-${trackId}`; a track can close with
+* `hasEmbeddedFace` and ZERO track files (0e343f86).
+*/
+async function collectCropForcedMedia(source, id) {
+	const eventFiles = await source.listByOwner("event", id);
+	const trackFiles = await source.listByOwner("track", id);
+	const ownerTrackId = trackFiles.length === 0 ? await source.getTrackIdForEvent(id) : null;
+	const owningTrackFiles = ownerTrackId === null ? [] : await source.listByOwner("track", ownerTrackId);
+	const trackId = ownerTrackId ?? id;
+	const [faceFiles, plateFiles] = await Promise.all([source.listByOwner("face", `face-${trackId}`), source.listByOwner("plate", `plate-${trackId}`)]);
+	return {
+		bodyFiles: [
+			...eventFiles,
+			...trackFiles,
+			...owningTrackFiles
+		],
+		detailFiles: [...faceFiles, ...plateFiles]
+	};
 }
 /**
 * Resolve the default-path media for an event id: the event's own media when it
@@ -35980,6 +36044,14 @@ async function resolveDefaultEventMedia(deps) {
 	return pickTrackFallbackMedia(await deps.listTrackMedia(trackId)) ?? null;
 }
 //#endregion
+//#region src/pipeline-analytics/ensure-track-hierarchy.ts
+async function ensureTrackHierarchyMedia(deps, input) {
+	const tasks = [];
+	if (!deps.isThumbnailLanded(input.trackId)) tasks.push(deps.captureBodyThumbnail(input));
+	if (!deps.isKeyFrameLanded(input.trackId)) tasks.push(deps.captureKeyFrame(input));
+	await Promise.all(tasks);
+}
+//#endregion
 //#region src/pipeline-analytics/face-settings.ts
 /**
 * Per-device face-recognition settings. Cascade: a per-device override on top
@@ -36498,6 +36570,21 @@ var FaceRecognizer = class {
 					...held,
 					crop
 				});
+				if (crop !== void 0 && input.frameHandle !== void 0) this.deps.onLiveHierarchy?.({
+					deviceId: input.deviceId,
+					trackId: c.trackId,
+					timestamp: input.timestamp,
+					bodyBbox: {
+						x: c.bbox.x,
+						y: c.bbox.y,
+						w: c.bbox.w,
+						h: c.bbox.h
+					},
+					frameWidth: input.frameWidth,
+					frameHeight: input.frameHeight,
+					cropPadding: input.cropPadding,
+					frameHandle: input.frameHandle
+				});
 				this.deps.logger.debug("face: best-face held", {
 					tags: {
 						deviceId: input.deviceId,
@@ -36647,6 +36734,22 @@ var FaceRecognizer = class {
 			});
 			return;
 		}
+		try {
+			await this.deps.copyCropToTrackPreview?.({
+				deviceId,
+				trackId,
+				crop: held.crop,
+				timestamp: held.timestamp
+			});
+		} catch (err) {
+			this.deps.logger.debug("face: track preview copy failed", {
+				tags: { deviceId },
+				meta: {
+					trackId,
+					error: String(err)
+				}
+			});
+		}
 		const keyFrameMediaKey = this.deps.getKeyFrameMediaKey?.(trackId);
 		try {
 			await this.deps.faceStore.insert({
@@ -44227,6 +44330,12 @@ var PlateRecognizer = class {
 			text: c.plateText,
 			score: c.plateScore,
 			bbox: c.plateBbox,
+			bodyBbox: {
+				x: c.bbox.x,
+				y: c.bbox.y,
+				w: c.bbox.w,
+				h: c.bbox.h
+			},
 			timestamp: input.timestamp,
 			frameWidth: input.frameWidth,
 			frameHeight: input.frameHeight,
@@ -44300,6 +44409,16 @@ var PlateRecognizer = class {
 				}
 			});
 		}
+		if (crop !== void 0 && input.frameHandle !== void 0 && input.bodyBbox !== void 0) this.deps.onLiveHierarchy?.({
+			deviceId: input.deviceId,
+			trackId: input.trackId,
+			timestamp: input.timestamp,
+			bodyBbox: input.bodyBbox,
+			frameWidth: input.frameWidth,
+			frameHeight: input.frameHeight,
+			cropPadding: input.cropPadding,
+			frameHandle: input.frameHandle
+		});
 		this.bestPlate.set(input.trackId, {
 			text: input.text,
 			score: input.score,
@@ -48334,14 +48453,23 @@ function isAfterCursor(row, cursor) {
 	if (row.lastSeen < cursor.lastSeen) return true;
 	return row.lastSeen === cursor.lastSeen && row.id < cursor.trackId;
 }
+var VEHICLE_CLASSES = new Set([
+	"vehicle",
+	"car",
+	"truck",
+	"bus"
+]);
+function motionlessMaxPxForClass(className) {
+	return VEHICLE_CLASSES.has(className.toLowerCase()) ? 8 : 40;
+}
 function netDisplacementPx(positions) {
 	const first = positions[0];
 	const last = positions[positions.length - 1];
 	if (!first || !last) return 0;
 	return Math.hypot(last.x - first.x, last.y - first.y);
 }
-function isShortMotionlessTrack(lifeMs, movedPx) {
-	return lifeMs <= 25e3 && movedPx <= 8;
+function isShortMotionlessTrack(lifeMs, movedPx, className) {
+	return lifeMs <= 25e3 && movedPx <= motionlessMaxPxForClass(className);
 }
 //#endregion
 //#region src/pipeline-analytics/store/track-store.ts
@@ -48925,7 +49053,7 @@ var TrackStore = class {
 		for (const [trackId, t] of this.active) {
 			if (nowMs - t.lastSeen < this.config.ttlMs) continue;
 			t.active = false;
-			if (t.positions.length > 0 && isShortMotionlessTrack(t.lastSeen - t.firstSeen, netDisplacementPx(t.positions))) t.closedReason = "stationary-promotion";
+			if (t.positions.length > 0 && isShortMotionlessTrack(t.lastSeen - t.firstSeen, netDisplacementPx(t.positions), t.className)) t.closedReason = "stationary-promotion";
 			const record = cloneTrack(t);
 			try {
 				await this.persistCompleted(record);
@@ -56931,10 +57059,12 @@ var CONFIRMATION_CROP_MAX_WIDTH = 320;
 *  a late confirmation is still worth running; see `DEFAULT_CAPTURE_PRIORITY`). */
 var ENRICHMENT_CAPTURE_STALE_MS = 3e3;
 /** Reconcile cadence for the per-device `zones` / `zoneRules` slice handles.
-*  The `device.state-changed` push doesn't reliably reach a forked child, so
-*  each cached proxy re-pulls both slices on this timer (see ensureProxy) —
-*  a zone drawn in the editor shows up in per-zone stats within one tick. */
-var ZONE_SLICE_RECONCILE_MS = 3e4;
+*  The `device.state-changed` push reaches a forked child through
+*  `createEventBusSliceSource` (the DeviceProxy no longer waits on
+*  `live.onEvent`). Events are still lossy telemetry (D8); this timer
+*  is the RPC reconcile, not the mechanism. Five minutes matches the
+*  viewer's `RECONCILE_MS`. */
+var ZONE_SLICE_RECONCILE_MS = 3e5;
 /** How often the evaluating node re-reads the central scene set. */
 var SCENE_RELOAD_INTERVAL_MS = 3e4;
 /** How long the install coordinates are trusted between settings reads. */
@@ -56998,38 +57128,31 @@ var MOTION_EVENT_HEARTBEAT_MS = 5e3;
 *
 * `thumbnail` joined the clean set on 2026-07-17: the track best-thumbnail is
 * now a subject-centered crop (event-media-dispatcher), and for DEGENERATE
-* tracks (no object event → no `crop`) it is the ONLY subject-centered media —
-* without it a crop-forced request degraded to the `keyFrame` FULL FRAME,
-* which is how 65% of the timeline tiles rendered as whole scenes. It sits
-* right after a real `crop`, before the full-scene `fullFrame`/`keyFrame`.
-*
-* `keyFrameSmall` (the 960px no-box downscale of the best-shot `keyFrame`)
-* joined the clean set on 2026-07-21 so a crop-forced request can degrade to it
-* for tracks whose only clean media is the small key frame; it sits last
-* (fullest-scene, but subject-centered enough to serve as a reasonable fallback
-* over 404). The retired-but-still-stored kinds (`crop`) stay listed so old rows
-* keep resolving.
+* tracks (no object event → no `crop`) it is the ONLY subject-centered media.
+*
+* Full-scene kinds (`fullFrame`, `keyFrame`, `keyFrameSmall`) stay out of
+* this list so a crop is preferred when one exists. `resolveCropForcedMedia`
+* then falls through to those full-scene kinds — a keyFrame beats an icon.
+* An *explicit* `?kind=keyFrame` / `?kind=snapshot` still matches exactly, so
+* videoclips and other kind-specific fetches keep working.
+*
+* The retired-but-still-stored kind (`crop`) stays listed so old rows resolve.
 */
 var CLEAN_MEDIA_KINDS = [
 	"crop",
 	"thumbnail",
-	"thumbnailSmall",
-	"fullFrame",
-	"keyFrame",
-	"keyFrameSmall"
+	"thumbnailSmall"
 ];
 /**
-* Pick a CLEAN (never boxed) media file for a crop-forced request: the exact
-* `preferKind` if it is itself clean and present, else the first available
-* {@link CLEAN_MEDIA_KINDS} frame. Returns undefined when only boxed / no media
-* exists (caller 404s → the viewer shows an icon).
+* Pick media for a crop-forced request: the exact `preferKind` when present
+* (so `?kind=snapshot` still serves a snapshot), else the first available
+* subject crop in {@link CLEAN_MEDIA_KINDS}. Returns undefined when no crop
+* is in the list — the caller then falls through to any remaining image
+* (`resolveCropForcedMedia`); the class icon is only for a total miss.
 */
 function pickCleanMedia(files, preferKind) {
-	const isClean = (k) => CLEAN_MEDIA_KINDS.includes(k);
-	if (isClean(preferKind)) {
-		const exact = files.find((f) => f.kind === preferKind);
-		if (exact) return exact;
-	}
+	const exact = files.find((f) => f.kind === preferKind);
+	if (exact) return exact;
 	for (const kind of CLEAN_MEDIA_KINDS) {
 		const found = files.find((f) => f.kind === kind);
 		if (found) return found;
@@ -58493,6 +58616,19 @@ var PipelineAnalyticsAddon = class PipelineAnalyticsAddon extends require_dist.B
 				}, trackId);
 			},
 			markEmbeddedFace: (trackId) => stores.trackStore.markEmbeddedFace(trackId),
+			copyCropToTrackPreview: async (input) => {
+				await copyFaceCropIfTrackHasNoThumbnail({
+					listTrackMedia: (trackId) => stores.mediaStore.listByOwner("track", trackId),
+					putTrackThumbnail: (put) => stores.mediaStore.put({
+						deviceId: put.deviceId,
+						ownerKind: "track",
+						ownerId: put.trackId,
+						kind: "thumbnail",
+						timestamp: put.timestamp,
+						data: put.data
+					})
+				}, input);
+			},
 			getKeyFrameMediaKey: (trackId) => this.residents.keyFrameKey(trackId),
 			emitFaceGalleryChanged: (payload) => this.emitFaceGalleryChanged(payload),
 			onSemanticMatch: (match) => this.promoteSemanticRecognition({
@@ -58507,6 +58643,7 @@ var PipelineAnalyticsAddon = class PipelineAnalyticsAddon extends require_dist.B
 				confidence: match.confidence,
 				...match.frameHandle !== void 0 ? { frameHandle: match.frameHandle } : {}
 			}),
+			onLiveHierarchy: (input) => this.requestTrackHierarchy(input),
 			logger: logger.child("FaceRecognizer")
 		});
 		this.faceRecognizer.refreshGallery();
@@ -58539,6 +58676,7 @@ var PipelineAnalyticsAddon = class PipelineAnalyticsAddon extends require_dist.B
 			deriveCropFromKeyFrame,
 			getKeyFrameMediaKey: (trackId) => this.residents.keyFrameKey(trackId),
 			emitPlateGalleryChanged: (payload) => this.emitPlateGalleryChanged(payload),
+			onLiveHierarchy: (input) => this.requestTrackHierarchy(input),
 			logger: logger.child("PlateRecognizer")
 		});
 		this.plateRecognizer.refreshGallery();
@@ -59908,6 +60046,7 @@ var PipelineAnalyticsAddon = class PipelineAnalyticsAddon extends require_dist.B
 			refreshGallery: () => {
 				this.plateRecognizer?.refreshGallery();
 			},
+			eventMediaBaseUrl: () => this.eventMediaBaseUrl,
 			emitPlateGalleryChanged: (payload) => this.emitPlateGalleryChanged(payload)
 		});
 		return [
@@ -60964,7 +61103,7 @@ var PipelineAnalyticsAddon = class PipelineAnalyticsAddon extends require_dist.B
 		if (!first) return;
 		const lifeMs = track.lastSeen - track.firstSeen;
 		const moved = netDisplacementPx(track.positions ?? []);
-		if (!isShortMotionlessTrack(lifeMs, moved)) {
+		if (!isShortMotionlessTrack(lifeMs, moved, track.className)) {
 			this.phantomCells?.noteMovingClose({
 				deviceId: track.deviceId,
 				className: track.className,
@@ -61082,6 +61221,7 @@ var PipelineAnalyticsAddon = class PipelineAnalyticsAddon extends require_dist.B
 					}, d.score, d.label, frame.timestamp);
 					if (this.plateRecognizer) {
 						const mediaSettings = await this.resolveDeviceMediaSettings(deviceId);
+						const body = this.residents.bestSeenBbox(trackId);
 						await this.plateRecognizer.observePlateRead({
 							deviceId,
 							trackId,
@@ -61097,7 +61237,13 @@ var PipelineAnalyticsAddon = class PipelineAnalyticsAddon extends require_dist.B
 							frameWidth: frame.frameWidth,
 							frameHeight: frame.frameHeight,
 							cropPadding: mediaSettings.cropPadding,
-							...frame.frameHandle !== void 0 ? { frameHandle: frame.frameHandle } : {}
+							...frame.frameHandle !== void 0 ? { frameHandle: frame.frameHandle } : {},
+							...body !== void 0 ? { bodyBbox: {
+								x: body.x,
+								y: body.y,
+								w: body.w,
+								h: body.h
+							} } : {}
 						});
 					}
 				}
@@ -61398,6 +61544,51 @@ var PipelineAnalyticsAddon = class PipelineAnalyticsAddon extends require_dist.B
 			}
 		}).catch(() => {})));
 	}
+	/**
+	* A face or plate crop just landed from a still-live handle. Fill the
+	* missing parent rungs — person/vehicle thumbnail (display crop, same
+	* surface that produced the detail) and native keyFrame — so Events never
+	* has a child crop without a body and a scene.
+	*/
+	requestTrackHierarchy(input) {
+		ensureTrackHierarchyMedia({
+			isThumbnailLanded: (trackId) => this.residents.isThumbnailLanded(trackId),
+			isKeyFrameLanded: (trackId) => this.residents.keyFrameCapture(trackId).landed,
+			captureBodyThumbnail: (req) => this.captureHierarchyBodyThumbnail(req),
+			captureKeyFrame: async (req) => {
+				await this.persistKeyFrames(req.deviceId, req.timestamp, [{
+					trackId: req.trackId,
+					retry: false
+				}], req.frameHandle);
+			}
+		}, input);
+	}
+	async captureHierarchyBodyThumbnail(input) {
+		const displayCrop = this.captureDisplayCropFn;
+		const mediaStore = this.mediaStore;
+		if (!displayCrop || !mediaStore) return;
+		await this.captureScheduler.request({
+			deviceId: input.deviceId,
+			trackId: input.trackId,
+			kind: "thumbnail",
+			coalesceKey: captureCoalesceKey(input.deviceId, "thumbnail", `${input.trackId}:hierarchy`),
+			staleAfterMs: ENRICHMENT_CAPTURE_STALE_MS,
+			exec: async () => {
+				if (this.residents.isThumbnailLanded(input.trackId)) return;
+				const jpeg = await displayCrop(input.frameHandle, input.bodyBbox, input.frameWidth, input.frameHeight, input.cropPadding, input.trackId);
+				if (!jpeg) return;
+				await mediaStore.put({
+					deviceId: input.deviceId,
+					ownerKind: "track",
+					ownerId: input.trackId,
+					kind: "thumbnail",
+					timestamp: input.timestamp,
+					data: jpeg
+				});
+				this.residents.markThumbnailLanded(input.deviceId, input.trackId);
+			}
+		}).catch(() => {});
+	}
 	/** Attribution-time SEMANTIC best-shot promotion (D-semantic-bestshot,
 	*  2026-08-21; see `pipeline/semantic-promotion.ts`): offer a frame from
 	*  which a recognition SUCCEEDED to the best-frame ranking with the
@@ -62903,15 +63094,11 @@ var PipelineAnalyticsAddon = class PipelineAnalyticsAddon extends require_dist.B
 	* applies to the very next frame even when frames stop briefly
 	* (e.g. during binding flips).
 	*
-	* RECONCILE: the push channel behind `subscribe` (`device.state-changed`
-	* via `live.onEvent`) does not reliably reach a forked addon child — a
-	* zone created AFTER the proxy's cold read stayed invisible until the
-	* addon respawned (live-diagnosed on device 617, 2026-07-16: zone slice
-	* populated hub-side, `zones: []` in every snapshot). Events are lossy
-	* telemetry (D8); the durable channel is RPC + reconcile — so each
-	* proxy also refreshes its two slices on a slow timer. `refresh()`
-	* round-trips `deviceState.getCapSlice` and fans out through the SAME
-	* subscribe callbacks above, so a zone edit lands within one interval.
+	* RECONCILE: the push channel behind `subscribe` is `device.state-changed`
+	* via the addon's `ctx.eventBus` (`createEventBusSliceSource`). That
+	* declares UDS interest so the parent actually fans the slice here. Events
+	* remain lossy (D8); `refresh()` round-trips `deviceState.getCapSlice` on
+	* this timer as the backstop.
 	*/
 	async ensureProxy(deviceId) {
 		const cached = this.proxies.get(deviceId);
@@ -64842,14 +65029,11 @@ var PipelineAnalyticsAddon = class PipelineAnalyticsAddon extends require_dist.B
 	async readEventThumbnail(id, preferKind) {
 		const eventFiles = await (this.mediaStore?.listByOwner("event", id) ?? Promise.resolve([]));
 		if (preferKind !== void 0 && preferKind.length > 0) {
-			const trackFiles = await (this.mediaStore?.listByOwner("track", id) ?? Promise.resolve([]));
-			const ownerTrackId = trackFiles.length === 0 ? await (this.eventStore?.getTrackIdForEvent(id) ?? Promise.resolve(null)) : null;
-			const owningTrackFiles = ownerTrackId === null ? [] : await (this.mediaStore?.listByOwner("track", ownerTrackId) ?? Promise.resolve([]));
-			const chosen = resolveCropForcedMedia([
-				...eventFiles,
-				...trackFiles,
-				...owningTrackFiles
-			], (files) => pickCleanMedia(files, preferKind));
+			const layers = await collectCropForcedMedia({
+				listByOwner: (ownerKind, ownerId) => this.mediaStore?.listByOwner(ownerKind, ownerId) ?? Promise.resolve([]),
+				getTrackIdForEvent: (eventId) => this.eventStore?.getTrackIdForEvent(eventId) ?? Promise.resolve(null)
+			}, id);
+			const chosen = resolveCropForcedMedia(layers.bodyFiles, (files) => pickCleanMedia(files, preferKind), layers.detailFiles);
 			if (!chosen) return null;
 			return {
 				bytes: Buffer.from(chosen.base64, "base64"),