@camstack/addon-post-analysis 1.2.115 → 1.2.116

package/dist/pipeline-analytics/index.js

@@ -15139,21 +15139,29 @@ function selectSummaryTiles(candidates, opts) {
 	};
 }
 /**
+* Ranked leftover after the quota pass — refill a mosaic that dropped
+* duplicate frames or missing crops without walking the same track twice.
+*/
+function remainingSummaryCandidates(kept, taken, rank) {
+	const takenIds = new Set(taken.map((c) => c.trackId));
+	return kept.filter((c) => !takenIds.has(c.trackId)).toSorted(byRankDesc(rank));
+}
+/**
 * The media a tile is drawn from, best first.
 *
-* `groupCrop` heads the ladder: it is the group's own clean wide-central-square
-* over the union bbox, and a drawn rectangle is a permanent lie in a digest
-* tile. Singletons have no groupCrop and fall through to the member ladder.
-* `fullFrameBoxed` and `firstFrame` stay absent for the same reason.
+* For a group: `groupCrop` (union crop, the group's own blob) then
+* `nativeFrame` (pointer at the anchor's clean keyFrame). A digest of a
+* cohort may show the native still when the crop was not written; a
+* member's `keyFrame` listed as itself stays off this ladder so tracker
+* ID churn cannot refill a mosaic with eleven driveways. Boxed frames stay
+* absent: a drawn rectangle is a permanent lie in a digest tile.
 */
 var SUMMARY_MEDIA_LADDER = [
 	"groupCrop",
-	"keyFrameSmall",
-	"keyFrame",
-	"snapshot",
-	"fullFrame",
+	"nativeFrame",
+	"thumbnail",
 	"thumbnailSmall",
-	"thumbnail"
+	"snapshot"
 ];
 /**
 * Pick ONE media row for a track — the cheap question first (index rows only),
@@ -15171,6 +15179,13 @@ function pickSummaryMedia(rows, aroundMs) {
 	}
 	return null;
 }
+/**
+* Same camera, same wall-clock second → same JPEG. Tracker ID churn
+* otherwise fills a mosaic with eleven copies of one driveway still.
+*/
+function frameDedupeKey(deviceId, mediaTimestamp) {
+	return `${deviceId}:${Math.floor(mediaTimestamp / 1e3)}`;
+}
 //#endregion
 //#region src/notification-center/summary/summary-window.ts
 /**
@@ -15470,7 +15485,12 @@ var NcSummaryProducer = class {
 					droppedStationary: filtered.droppedStationary
 				};
 			}
-			const loaded = await this.loadTiles(rule, selection.tiles);
+			const loaded = await this.loadTiles({
+				rule,
+				preferred: selection.tiles,
+				refill: remainingSummaryCandidates(filtered.kept, selection.tiles, rule.rank),
+				maxTiles: rule.maxTiles
+			});
 			const detections = countDetections({ tracks: selection.tiles.map((t) => ({
 				firstSeen: t.firstSeen,
 				lastSeen: t.lastSeen,
@@ -15528,7 +15548,7 @@ var NcSummaryProducer = class {
 				tiles: loaded.length,
 				cameras: new Set(loaded.map((t) => t.candidate.deviceId)).size,
 				camerasDropped: selection.camerasDropped,
-				droppedNoMedia: selection.tiles.length - loaded.length,
+				droppedNoMedia: Math.max(0, rule.maxTiles - loaded.length),
 				mosaicBytes: mosaic.bytes,
 				mosaicPublished: mosaic.ref !== null,
 				enqueued,
@@ -15592,10 +15612,18 @@ var NcSummaryProducer = class {
 		}
 		return all;
 	}
-	/** One blob per tile — the cheap question (index rows) always first. */
-	async loadTiles(rule, tiles) {
+	/** One blob per tile — the cheap question (index rows) always first.
+	*  Duplicate camera-seconds are skipped so tracker ID churn cannot paint
+	*  the same driveway eleven times; leftover ranked candidates refill. */
+	async loadTiles(input) {
 		const out = [];
-		for (const candidate of tiles) {
+		const seenFrames = /* @__PURE__ */ new Set();
+		const seenIds = /* @__PURE__ */ new Set();
+		const queue = [...input.preferred, ...input.refill];
+		for (const candidate of queue) {
+			if (out.length >= input.maxTiles) break;
+			if (seenIds.has(candidate.trackId)) continue;
+			seenIds.add(candidate.trackId);
 			const tags = { deviceId: candidate.deviceId };
 			try {
 				const rows = await this.deps.listMediaInfo(candidate.trackId);
@@ -15604,25 +15632,38 @@ var NcSummaryProducer = class {
 					this.deps.logger.debug("summary tile dropped: the track carries no clean media", {
 						tags,
 						meta: {
-							ruleId: rule.id,
+							ruleId: input.rule.id,
 							trackId: candidate.trackId,
 							mediaRows: rows.length
 						}
 					});
 					continue;
 				}
+				const frameKey = frameDedupeKey(candidate.deviceId, picked.timestamp);
+				if (seenFrames.has(frameKey)) {
+					this.deps.logger.debug("summary tile dropped: same frame as an earlier tile", {
+						tags,
+						meta: {
+							ruleId: input.rule.id,
+							trackId: candidate.trackId,
+							frameKey
+						}
+					});
+					continue;
+				}
 				const jpeg = await this.deps.readMedia(picked.key);
 				if (jpeg === null || jpeg.byteLength === 0) {
 					this.deps.logger.debug("summary tile dropped: the media blob could not be read", {
 						tags,
 						meta: {
-							ruleId: rule.id,
+							ruleId: input.rule.id,
 							trackId: candidate.trackId,
 							mediaKey: picked.key
 						}
 					});
 					continue;
 				}
+				seenFrames.add(frameKey);
 				out.push({
 					candidate,
 					jpeg
@@ -15631,7 +15672,7 @@ var NcSummaryProducer = class {
 				this.deps.logger.warn("summary tile dropped: reading its media threw", {
 					tags,
 					meta: {
-						ruleId: rule.id,
+						ruleId: input.rule.id,
 						trackId: candidate.trackId,
 						error: String(err)
 					}
@@ -40294,7 +40335,7 @@ function aggregateGroupClasses(tracks) {
 }
 function toGroupRecord(input) {
 	const { className, classes } = aggregateGroupClasses(input.tracks);
-	const mediaId = input.group.mediaKey ?? (input.group.memberCount === 1 ? input.memberTrackIds[0] : null);
+	const mediaId = input.group.mediaKey ?? input.group.nativeKey ?? (input.group.memberCount === 1 ? input.memberTrackIds[0] : null);
 	return {
 		id: input.group.id,
 		deviceId: input.group.deviceId,
@@ -40373,71 +40414,36 @@ async function buildGroupRecord(ports, group) {
 		eventMediaBaseUrl: ports.eventMediaBaseUrl()
 	});
 }
-//#endregion
-//#region src/pipeline-analytics/group/group-crop.ts
-/** Always containSubject: true. Never the 0.5 delivered threshold. */
-function groupWideCentralSquareLayout(unionBbox, frame) {
-	return wideCentralSquareLayout(unionBbox, frame, { containSubject: true });
-}
-async function cropGroupFromRgb(rgb, frameWidth, frameHeight, unionBbox) {
-	const layout = groupWideCentralSquareLayout(unionBbox, {
-		W: frameWidth,
-		H: frameHeight
+/**
+* Gallery and digest read the same ladder: groupCrop, then the native-frame
+* pointer, then member subject crops. A multi with no crop still has a
+* picture if the sealer stored `nativeKey`.
+*/
+function digestMediaRows(input) {
+	const owned = [];
+	if (input.mediaKey !== null && input.mediaKey.length > 0) owned.push({
+		key: input.mediaKey,
+		kind: "groupCrop",
+		timestamp: input.timestamp
 	});
-	const { crop: slab } = await extractCrop(rgb, frameWidth, frameHeight, layout.fetch);
-	return composeWideCentralSquareThumbnail(slab, layout);
+	if (input.nativeKey !== null && input.nativeKey.length > 0) owned.push({
+		key: input.nativeKey,
+		kind: "nativeFrame",
+		timestamp: input.timestamp
+	});
+	if (owned.length > 0) return owned;
+	return input.memberRows;
 }
 var MATCH_WINDOW_MS = 1e3;
 var MOVE_EPS = .35;
+/** Live-assigner window: same predicate, recent positions only. */
+var LIVE_WINDOW_MS = 3e3;
 /** Registry stationary is out; audio has no bbox and is never a member or a singleton. */
 function isEligibleMember(track) {
 	if (track.closedReason === "stationary-promotion") return false;
 	if (track.className === "audio") return false;
 	return true;
 }
-function temporallyOverlap(a, b, slackMs) {
-	return a.firstSeen <= b.lastSeen + slackMs && b.firstSeen <= a.lastSeen + slackMs;
-}
-/** Connected components of temporal overlap (+ slack) per camera. */
-function sessionsOf(tracks) {
-	const byDevice = /* @__PURE__ */ new Map();
-	for (const t of tracks) {
-		const list = byDevice.get(t.deviceId);
-		if (list) list.push(t);
-		else byDevice.set(t.deviceId, [t]);
-	}
-	const sessions = [];
-	for (const deviceTracks of byDevice.values()) {
-		const n = deviceTracks.length;
-		const parent = deviceTracks.map((_, i) => i);
-		const find = (i) => {
-			let cur = i;
-			while (parent[cur] !== cur) cur = parent[cur];
-			let walk = i;
-			while (parent[walk] !== cur) {
-				const next = parent[walk];
-				parent[walk] = cur;
-				walk = next;
-			}
-			return cur;
-		};
-		const union = (i, j) => {
-			const ri = find(i);
-			const rj = find(j);
-			if (ri !== rj) parent[ri] = rj;
-		};
-		for (let i = 0; i < n; i++) for (let j = i + 1; j < n; j++) if (temporallyOverlap(deviceTracks[i], deviceTracks[j], 3e3)) union(i, j);
-		const buckets = /* @__PURE__ */ new Map();
-		for (let i = 0; i < n; i++) {
-			const root = find(i);
-			const bucket = buckets.get(root);
-			if (bucket) bucket.push(deviceTracks[i]);
-			else buckets.set(root, [deviceTracks[i]]);
-		}
-		sessions.push(...buckets.values());
-	}
-	return sessions;
-}
 function diag(bbox) {
 	return Math.hypot(bbox.w, bbox.h);
 }
@@ -40459,9 +40465,21 @@ function meanDiag(positions) {
 	for (const p of positions) sum += diag(p.bbox);
 	return sum / positions.length;
 }
-function netDisplacement(track) {
-	const first = track.positions[0];
-	const last = track.positions[track.positions.length - 1];
+function vecLen(v) {
+	return Math.hypot(v.x, v.y);
+}
+function cosine(a, b) {
+	const la = vecLen(a);
+	const lb = vecLen(b);
+	if (la === 0 || lb === 0) return 1;
+	return (a.x * b.x + a.y * b.y) / (la * lb);
+}
+function positionsInWindow(track, start, end) {
+	return track.positions.filter((p) => p.timestamp >= start && p.timestamp <= end);
+}
+function windowDisplacement(positions) {
+	const first = positions[0];
+	const last = positions[positions.length - 1];
 	if (!first || !last) return {
 		x: 0,
 		y: 0
@@ -40473,24 +40491,19 @@ function netDisplacement(track) {
 		y: b.y - a.y
 	};
 }
-function vecLen(v) {
-	return Math.hypot(v.x, v.y);
-}
-function cosine(a, b) {
-	const la = vecLen(a);
-	const lb = vecLen(b);
-	if (la === 0 || lb === 0) return 1;
-	return (a.x * b.x + a.y * b.y) / (la * lb);
-}
-function relativeMotion(track) {
-	const mean = meanDiag(track.positions);
+function windowRelativeMotion(positions) {
+	const mean = meanDiag(positions);
 	if (mean <= 0) return 0;
-	return vecLen(netDisplacement(track)) / mean;
+	return vecLen(windowDisplacement(positions)) / mean;
 }
-/** A ~ B iff cohesion ≥ 0.5 AND NOT (both move AND cos < 0.3). */
-function pairTogether(a, b) {
-	const overlapStart = Math.max(a.firstSeen, b.firstSeen);
-	const overlapEnd = Math.min(a.lastSeen, b.lastSeen);
+/**
+* Same cohesion + crossing veto as {@link pairTogether}, over `[now − 3 s, now]`.
+* Displacement/cosine use the window, not the whole track.
+*/
+function pairTogetherNow(a, b, now) {
+	const start = now - LIVE_WINDOW_MS;
+	const overlapStart = Math.max(a.firstSeen, b.firstSeen, start);
+	const overlapEnd = Math.min(a.lastSeen, b.lastSeen, now);
 	if (overlapEnd < overlapStart) return false;
 	let joint = 0;
 	let close = 0;
@@ -40507,55 +40520,245 @@ function pairTogether(a, b) {
 	}
 	if (joint === 0) return false;
 	if (close / joint < .5) return false;
-	const aMoves = relativeMotion(a) >= MOVE_EPS;
-	const bMoves = relativeMotion(b) >= MOVE_EPS;
-	if (aMoves && bMoves && cosine(netDisplacement(a), netDisplacement(b)) < .3) return false;
+	const wa = positionsInWindow(a, start, now);
+	const wb = positionsInWindow(b, start, now);
+	const aMoves = windowRelativeMotion(wa) >= MOVE_EPS;
+	const bMoves = windowRelativeMotion(wb) >= MOVE_EPS;
+	if (aMoves && bMoves && cosine(windowDisplacement(wa), windowDisplacement(wb)) < .3) return false;
 	return true;
 }
-function clusterGroups(tracks) {
-	const eligible = tracks.filter(isEligibleMember);
-	const out = [];
-	for (const session of sessionsOf(eligible)) {
-		const pairable = [];
-		for (const t of session) if (t.positions.length < 2) out.push({
-			deviceId: t.deviceId,
-			memberTrackIds: [t.trackId]
-		});
-		else pairable.push(t);
-		if (pairable.length === 0) continue;
-		const parent = pairable.map((_, i) => i);
-		const find = (i) => {
-			let cur = i;
-			while (parent[cur] !== cur) cur = parent[cur];
-			let walk = i;
-			while (parent[walk] !== cur) {
-				const next = parent[walk];
-				parent[walk] = cur;
-				walk = next;
-			}
-			return cur;
-		};
-		const union = (i, j) => {
-			const ri = find(i);
-			const rj = find(j);
-			if (ri !== rj) parent[ri] = rj;
-		};
-		for (let i = 0; i < pairable.length; i++) for (let j = i + 1; j < pairable.length; j++) if (pairTogether(pairable[i], pairable[j])) union(i, j);
-		const buckets = /* @__PURE__ */ new Map();
-		for (let i = 0; i < pairable.length; i++) {
-			const root = find(i);
-			const bucket = buckets.get(root);
-			const id = pairable[i].trackId;
-			if (bucket) bucket.push(id);
-			else buckets.set(root, [id]);
-		}
-		const deviceId = pairable[0].deviceId;
-		for (const memberTrackIds of buckets.values()) out.push({
-			deviceId,
-			memberTrackIds
+var GroupLiveAssigner = class {
+	nextId;
+	snapshots = /* @__PURE__ */ new Map();
+	groups = /* @__PURE__ */ new Map();
+	membership = /* @__PURE__ */ new Map();
+	/** `${trackId}>${groupId}` → first instant the join predicate held. */
+	joinSince = /* @__PURE__ */ new Map();
+	/** trackId → first instant they failed pair against every remaining member. */
+	leaveSince = /* @__PURE__ */ new Map();
+	constructor(nextId = () => (0, node_crypto.randomUUID)()) {
+		this.nextId = nextId;
+	}
+	observe(track, now) {
+		this.snapshots.set(track.trackId, track);
+		if (!isEligibleMember(track)) {
+			this.removeFromGroup(track.trackId);
+			return;
+		}
+		if (!this.membership.has(track.trackId)) this.birthSingleton(track, now);
+		this.considerLeave(track, now);
+		const groupId = this.membership.get(track.trackId);
+		const group = groupId !== void 0 ? this.groups.get(groupId) : void 0;
+		if (group) for (const id of [...group.members]) {
+			if (id === track.trackId) continue;
+			const snap = this.snapshots.get(id);
+			if (snap) this.considerLeave(snap, now);
+		}
+		this.considerJoin(track, now);
+	}
+	groupOf(trackId) {
+		return this.membership.get(trackId);
+	}
+	snapshot(trackId) {
+		return this.snapshots.get(trackId);
+	}
+	liveGroups() {
+		return [...this.groups.values()].map((g) => this.toLive(g));
+	}
+	idleGroups(now, idleMs) {
+		return this.liveGroups().filter((g) => now >= g.lastActiveAt + idleMs);
+	}
+	drop(ids) {
+		for (const id of ids) {
+			const g = this.groups.get(id);
+			if (!g) continue;
+			for (const member of g.members) this.membership.delete(member);
+			this.groups.delete(id);
+		}
+	}
+	birthSingleton(track, now) {
+		const id = this.nextId();
+		this.groups.set(id, {
+			id,
+			deviceId: track.deviceId,
+			openedAt: now,
+			members: new Set([track.trackId])
 		});
+		this.membership.set(track.trackId, id);
 	}
-	return out;
+	considerLeave(track, now) {
+		const groupId = this.membership.get(track.trackId);
+		if (groupId === void 0) return;
+		const group = this.groups.get(groupId);
+		if (!group || group.members.size < 2) {
+			this.leaveSince.delete(track.trackId);
+			return;
+		}
+		if ([...group.members].filter((id) => id !== track.trackId).some((id) => {
+			const other = this.snapshots.get(id);
+			return other !== void 0 && pairTogetherNow(track, other, now);
+		})) {
+			this.leaveSince.delete(track.trackId);
+			return;
+		}
+		const since = this.leaveSince.get(track.trackId) ?? now;
+		this.leaveSince.set(track.trackId, since);
+		if (now - since < 3e3) return;
+		this.peel(track, now);
+	}
+	peel(track, now) {
+		this.removeFromGroup(track.trackId);
+		this.leaveSince.delete(track.trackId);
+		this.birthSingleton(track, now);
+	}
+	considerJoin(track, now) {
+		const mineId = this.membership.get(track.trackId);
+		if (mineId === void 0) return;
+		const mine = this.groups.get(mineId);
+		if (!mine || mine.members.size !== 1) {
+			this.clearJoinClocks(track.trackId);
+			return;
+		}
+		let best;
+		for (const group of this.groups.values()) {
+			if (group.id === mineId || group.deviceId !== track.deviceId) continue;
+			let gap = Number.POSITIVE_INFINITY;
+			let together = false;
+			for (const memberId of group.members) {
+				const other = this.snapshots.get(memberId);
+				if (!other) continue;
+				if (pairTogetherNow(track, other, now)) {
+					together = true;
+					gap = Math.min(gap, centroidGap(track, other, now));
+				}
+			}
+			if (!together) continue;
+			if (best === void 0 || gap < best.gap) best = {
+				groupId: group.id,
+				gap
+			};
+		}
+		if (best === void 0) {
+			this.clearJoinClocks(track.trackId);
+			return;
+		}
+		const key = `${track.trackId}>${best.groupId}`;
+		for (const existing of [...this.joinSince.keys()]) if (existing.startsWith(`${track.trackId}>`) && existing !== key) this.joinSince.delete(existing);
+		const since = this.joinSince.get(key) ?? now;
+		this.joinSince.set(key, since);
+		if (now - since < 1500) return;
+		this.absorb(track.trackId, mineId, best.groupId);
+	}
+	absorb(trackId, fromId, intoId) {
+		const into = this.groups.get(intoId);
+		if (!into) return;
+		into.members.add(trackId);
+		this.membership.set(trackId, intoId);
+		this.groups.delete(fromId);
+		this.clearJoinClocks(trackId);
+		this.leaveSince.delete(trackId);
+	}
+	removeFromGroup(trackId) {
+		const groupId = this.membership.get(trackId);
+		this.membership.delete(trackId);
+		this.clearJoinClocks(trackId);
+		this.leaveSince.delete(trackId);
+		if (groupId === void 0) return;
+		const group = this.groups.get(groupId);
+		if (!group) return;
+		group.members.delete(trackId);
+		if (group.members.size === 0) this.groups.delete(groupId);
+	}
+	clearJoinClocks(trackId) {
+		for (const key of [...this.joinSince.keys()]) if (key.startsWith(`${trackId}>`)) this.joinSince.delete(key);
+	}
+	toLive(group) {
+		let lastActiveAt = group.openedAt;
+		for (const id of group.members) {
+			const snap = this.snapshots.get(id);
+			if (snap && snap.lastSeen > lastActiveAt) lastActiveAt = snap.lastSeen;
+		}
+		return {
+			id: group.id,
+			deviceId: group.deviceId,
+			memberTrackIds: [...group.members],
+			openedAt: group.openedAt,
+			lastActiveAt
+		};
+	}
+};
+function centroidGap(a, b, now) {
+	const pa = a.positions.reduce((best, p) => Math.abs(p.timestamp - now) < Math.abs(best.timestamp - now) ? p : best, a.positions[0]);
+	const pb = b.positions.reduce((best, p) => Math.abs(p.timestamp - now) < Math.abs(best.timestamp - now) ? p : best, b.positions[0]);
+	if (!pa || !pb) return Number.POSITIVE_INFINITY;
+	const ca = bboxCentroid(pa.bbox);
+	const cb = bboxCentroid(pb.bbox);
+	return Math.hypot(ca.x - cb.x, ca.y - cb.y);
+}
+//#endregion
+//#region src/pipeline-analytics/group/group-session.ts
+/** Same idle as the notification burst (`NC_GROUP_DEFAULT_IDLE_SEC`). */
+var GROUP_SESSION_IDLE_MS = 3e4;
+//#endregion
+//#region src/pipeline-analytics/group/group-live-buffer.ts
+function toGroupableTrack(track) {
+	return {
+		trackId: track.trackId,
+		deviceId: track.deviceId,
+		className: track.className,
+		firstSeen: track.firstSeen,
+		lastSeen: track.lastSeen,
+		positions: track.positions.map((p) => ({
+			...p,
+			bbox: { ...p.bbox }
+		})),
+		...track.closedReason !== void 0 ? { closedReason: track.closedReason } : {}
+	};
+}
+var GroupLiveBuffer = class {
+	assigner;
+	primed = /* @__PURE__ */ new Set();
+	constructor(nextId) {
+		this.assigner = new GroupLiveAssigner(nextId);
+	}
+	observe(track, now) {
+		this.assigner.observe(track, now);
+	}
+	groupOf(trackId) {
+		return this.assigner.groupOf(trackId);
+	}
+	snapshot(trackId) {
+		return this.assigner.snapshot(trackId);
+	}
+	liveGroups() {
+		return this.assigner.liveGroups();
+	}
+	idleGroups(now, idleMs = GROUP_SESSION_IDLE_MS) {
+		return this.assigner.idleGroups(now, idleMs);
+	}
+	drop(ids) {
+		this.assigner.drop(ids);
+	}
+	isPrimed(deviceId) {
+		return this.primed.has(deviceId);
+	}
+	markPrimed(deviceId) {
+		this.primed.add(deviceId);
+	}
+};
+//#endregion
+//#region src/pipeline-analytics/group/group-crop.ts
+/** Always containSubject: true. Never the 0.5 delivered threshold. */
+function groupWideCentralSquareLayout(unionBbox, frame) {
+	return wideCentralSquareLayout(unionBbox, frame, { containSubject: true });
+}
+async function cropGroupFromRgb(rgb, frameWidth, frameHeight, unionBbox) {
+	const layout = groupWideCentralSquareLayout(unionBbox, {
+		W: frameWidth,
+		H: frameHeight
+	});
+	const { crop: slab } = await extractCrop(rgb, frameWidth, frameHeight, layout.fetch);
+	return composeWideCentralSquareThumbnail(slab, layout);
 }
 //#endregion
 //#region src/pipeline-analytics/group/group-instant.ts
@@ -40572,6 +40775,7 @@ function clusterGroups(tracks) {
 *
 * Retrospective. No new capture path.
 */
+var GROUP_MEDIA_MATCH_MS = 2e3;
 function nearest(positions, t, windowMs) {
 	let best;
 	let bestDt = windowMs + 1;
@@ -40680,55 +40884,85 @@ function chooseAnchorTrackId(members, ownsCleanFrame) {
 		return life !== 0 ? life : a.trackId.localeCompare(b.trackId);
 	})[0].trackId;
 }
-//#endregion
-//#region src/pipeline-analytics/group/group-session.ts
 /**
-* Session close → sealed groups. A group is born here, never live.
-*
-* Session = temporal chain + 3 s slack, per camera. Close = every overlapping
-* track is persisted AND the newest lastSeen is older than the idle cutoff
-* (the Phase-1 burst's 30 s, reused — not a second clock).
+* The RGB source for a group crop is a full native frame. Thumbnails are
+* already single-subject crops and cannot substitute for union-bbox geometry.
 *
-* Merge and split cannot occur: connected components of a closed session is a
-* partition. Say it out loud so a later live-group attempt does not reach
-* for them here.
+* Prefer a keyFrame within {@link GROUP_MEDIA_MATCH_MS} of the chosen instant;
+* if none, take the nearest keyFrame anyway — dropping the crop because the
+* best-shot was 3 s off the instant is how a recognised person left the
+* digest with no crop.
 */
-/** Same idle as the notification burst (`NC_GROUP_DEFAULT_IDLE_SEC`). */
-var GROUP_SESSION_IDLE_MS = 3e4;
-function overlaps(a, b) {
-	return a.firstSeen <= b.lastSeen + 3e3 && b.firstSeen <= a.lastSeen + 3e3;
+function pickCleanPixelRow(rows, instantMs) {
+	const ranked = (maxDt) => {
+		const candidates = [];
+		for (const row of rows) {
+			const rank = row.kind === "keyFrame" ? 0 : row.kind === "keyFrameSmall" ? 1 : -1;
+			if (rank < 0) continue;
+			const dt = Math.abs(row.timestamp - instantMs);
+			if (maxDt !== null && dt > maxDt) continue;
+			candidates.push({
+				key: row.key,
+				dt,
+				rank
+			});
+		}
+		return candidates.toSorted((a, b) => a.rank - b.rank || a.dt - b.dt)[0];
+	};
+	const near = ranked(GROUP_MEDIA_MATCH_MS);
+	if (near !== void 0) return {
+		key: near.key,
+		usedFallback: false
+	};
+	const any = ranked(null);
+	if (any === void 0) return null;
+	return {
+		key: any.key,
+		usedFallback: true
+	};
 }
-function sessionSpan(tracks) {
+//#endregion
+//#region src/pipeline-analytics/group/group-live-replay.ts
+function sliceTrackAt(track, now) {
+	const positions = track.positions.filter((p) => p.timestamp <= now);
+	const last = positions[positions.length - 1];
 	return {
-		firstSeen: Math.min(...tracks.map((t) => t.firstSeen)),
-		lastSeen: Math.max(...tracks.map((t) => t.lastSeen))
+		...track,
+		lastSeen: last?.timestamp ?? track.firstSeen,
+		positions
 	};
 }
-/**
-* Sessions whose members are all in `closed` and whose newest lastSeen is
-* older than `idleMs`. An overlapping ACTIVE track keeps the session open.
-*/
-function sessionsReadyToSeal(closed, active, now, idleMs = GROUP_SESSION_IDLE_MS) {
-	const byDevice = /* @__PURE__ */ new Map();
-	for (const t of closed) {
-		const list = byDevice.get(t.deviceId);
-		if (list) list.push(t);
-		else byDevice.set(t.deviceId, [t]);
-	}
-	const ready = [];
-	for (const [deviceId, tracks] of byDevice) {
-		const deviceActive = active.filter((a) => a.deviceId === deviceId);
-		for (const session of sessionsOf(tracks)) {
-			const span = sessionSpan(session);
-			if (now < span.lastSeen + idleMs) continue;
-			if (deviceActive.some((a) => overlaps(span, a))) continue;
-			ready.push(session);
+function replayInto(tracks, observer) {
+	const events = [];
+	const byId = /* @__PURE__ */ new Map();
+	for (const track of tracks) {
+		byId.set(track.trackId, track);
+		if (track.positions.length === 0) {
+			events.push({
+				t: track.lastSeen,
+				trackId: track.trackId
+			});
+			continue;
 		}
+		for (const p of track.positions) events.push({
+			t: p.timestamp,
+			trackId: track.trackId
+		});
+	}
+	events.sort((a, b) => a.t - b.t || a.trackId.localeCompare(b.trackId));
+	let lastKey = "";
+	for (const e of events) {
+		const key = `${e.trackId}@${e.t}`;
+		if (key === lastKey) continue;
+		lastKey = key;
+		const track = byId.get(e.trackId);
+		if (!track) continue;
+		observer.observe(sliceTrackAt(track, e.t), e.t);
 	}
-	return ready;
 }
-function partitionsForSealedSessions(closed, active, now, idleMs = GROUP_SESSION_IDLE_MS) {
-	return clusterGroups(sessionsReadyToSeal(closed, active, now, idleMs).flat());
+function replayLive(tracks, assigner = new GroupLiveAssigner()) {
+	replayInto(tracks, assigner);
+	return assigner;
 }
 //#endregion
 //#region src/pipeline-analytics/group/group-sealer.ts
@@ -40736,9 +40970,9 @@ var DEFAULT_FRAME = {
 	width: 640,
 	height: 360
 };
-var SEAL_LOOKBACK_MS = 10 * 6e4;
-var BACKFILL_LOOKBACK_MS = 2880 * 6e4;
 var QUERY_LIMIT = 2e3;
+/** Crash recover: replay this camera only, on its next activity. */
+var GROUP_CRASH_LOOKBACK_MS = 2 * 6e4;
 function toInstant(t) {
 	return {
 		trackId: t.trackId,
@@ -40752,93 +40986,130 @@ function toInstant(t) {
 		confidence: t.importance
 	};
 }
+function toSealer(track) {
+	return {
+		trackId: track.trackId,
+		deviceId: track.deviceId,
+		className: track.className,
+		firstSeen: track.firstSeen,
+		lastSeen: track.lastSeen,
+		positions: track.positions,
+		...track.closedReason !== void 0 ? { closedReason: track.closedReason } : {}
+	};
+}
 var GroupSealer = class {
 	deps;
 	constructor(deps) {
 		this.deps = deps;
 	}
-	async sealRecent() {
-		const now = this.deps.now();
-		return this.sealSince(now - SEAL_LOOKBACK_MS, now);
+	async flushIdle(buffer, now = this.deps.now()) {
+		let written = 0;
+		for (const group of buffer.idleGroups(now, GROUP_SESSION_IDLE_MS)) if (await this.persistLiveGroup(group, buffer)) {
+			buffer.drop([group.id]);
+			written += 1;
+		}
+		return written;
 	}
-	async backfill() {
+	/**
+	* First activity on camera D after a crash: replay 2 minutes of that camera
+	* into the live buffer, persist whoever is already idle, keep the rest in RAM.
+	*/
+	async recoverCamera(deviceId, buffer) {
+		if (buffer.isPrimed(deviceId)) return 0;
 		const now = this.deps.now();
-		return this.sealSince(now - BACKFILL_LOOKBACK_MS, now);
-	}
-	async sealSince(since, now) {
-		let written = 0;
-		let devices;
 		try {
-			devices = await this.deps.trackStore.listDeviceIds();
+			replayInto(await this.deps.trackStore.queryHistorical({
+				deviceId,
+				since: now - GROUP_CRASH_LOOKBACK_MS,
+				until: now,
+				limit: QUERY_LIMIT,
+				projection: "full"
+			}), buffer);
 		} catch (err) {
-			this.deps.logger.warn("group sealer: listDeviceIds failed", { meta: { error: String(err) } });
-			return 0;
+			this.deps.logger.warn("group sealer: lookback failed", {
+				tags: { deviceId },
+				meta: { error: String(err) }
+			});
+		} finally {
+			buffer.markPrimed(deviceId);
 		}
-		for (const deviceId of devices) try {
-			written += await this.sealDevice(deviceId, since, now);
+		return this.flushIdle(buffer, now);
+	}
+	/**
+	* Seal ONE camera over a caller-owned window via live replay.
+	*
+	* This is how a digest recovers groups without a boot scan: the producer
+	* already knows the window. Walking every camera for 48h at initialize()
+	* is what wedged hub-main.
+	*/
+	async sealWindow(deviceId, since, until) {
+		try {
+			const closed = await this.deps.trackStore.queryHistorical({
+				deviceId,
+				since,
+				until,
+				limit: QUERY_LIMIT,
+				projection: "full"
+			});
+			if (closed.length === 0) return 0;
+			const already = new Set((await this.deps.groupStore.membersOfTracks(closed.map((t) => t.trackId))).map((m) => m.trackId));
+			const pending = closed.filter((t) => !already.has(t.trackId));
+			if (pending.length === 0) return 0;
+			const assigner = replayLive(pending);
+			const now = this.deps.now();
+			const byId = new Map(pending.map((t) => [t.trackId, t]));
+			let written = 0;
+			for (const group of assigner.idleGroups(now, GROUP_SESSION_IDLE_MS)) {
+				const members = group.memberTrackIds.map((id) => byId.get(id)).filter((t) => t !== void 0);
+				if (members.length === 0) continue;
+				try {
+					await this.persistPartition(members, group.openedAt);
+					written += 1;
+				} catch (err) {
+					this.deps.logger.warn("group sealer: persist failed", {
+						tags: { deviceId },
+						meta: {
+							members: members.map((m) => m.trackId),
+							error: String(err)
+						}
+					});
+				}
+			}
+			return written;
 		} catch (err) {
 			this.deps.logger.warn("group sealer: device failed", {
 				tags: { deviceId },
 				meta: { error: String(err) }
 			});
+			return 0;
 		}
-		return written;
 	}
-	async sealDevice(deviceId, since, now) {
-		const closed = await this.deps.trackStore.queryHistorical({
-			deviceId,
-			since,
-			until: now,
-			limit: QUERY_LIMIT,
-			projection: "full"
-		});
-		if (closed.length === 0) return 0;
-		const already = new Set((await this.deps.groupStore.membersOfTracks(closed.map((t) => t.trackId))).map((m) => m.trackId));
-		const pending = closed.filter((t) => !already.has(t.trackId));
-		if (pending.length === 0) return 0;
-		const active = this.deps.trackStore.getActive(deviceId).map((t) => ({
-			deviceId,
-			firstSeen: t.firstSeen,
-			lastSeen: t.lastSeen
-		}));
-		const partitions = partitionsForSealedSessions(pending.map(toInstant), active, now, GROUP_SESSION_IDLE_MS);
-		if (partitions.length === 0) {
-			if (pending.filter((t) => t.closedReason !== "stationary-promotion" && t.className !== "audio").length === 0 && pending.length > 0) this.deps.logger.info("group session produced no groups", {
+	async persistLiveGroup(group, buffer) {
+		const deviceId = group.deviceId;
+		const snaps = group.memberTrackIds.map((id) => buffer.snapshot(id)).filter((t) => t !== void 0);
+		if (snaps.length === 0) return true;
+		const already = new Set((await this.deps.groupStore.membersOfTracks(snaps.map((t) => t.trackId))).map((m) => m.trackId));
+		const pending = snaps.filter((t) => !already.has(t.trackId)).map(toSealer);
+		if (pending.length === 0) return true;
+		try {
+			await this.persistPartition(pending, group.openedAt);
+			return true;
+		} catch (err) {
+			this.deps.logger.warn("group sealer: persist failed", {
 				tags: { deviceId },
 				meta: {
-					dropped: pending.length,
-					reason: "no-eligible-members"
+					members: pending.map((m) => m.trackId),
+					error: String(err)
 				}
 			});
-			return 0;
-		}
-		const byId = new Map(pending.map((t) => [t.trackId, t]));
-		let written = 0;
-		for (const part of partitions) {
-			const members = part.memberTrackIds.map((id) => byId.get(id)).filter((t) => t !== void 0);
-			if (members.length === 0) continue;
-			if (members.every((m) => already.has(m.trackId))) continue;
-			try {
-				await this.persistPartition(members);
-				written += 1;
-			} catch (err) {
-				this.deps.logger.warn("group sealer: persist failed", {
-					tags: { deviceId },
-					meta: {
-						members: members.map((m) => m.trackId),
-						error: String(err)
-					}
-				});
-			}
+			return false;
 		}
-		return written;
 	}
-	async persistPartition(members) {
+	async persistPartition(members, openedAt) {
 		const deviceId = members[0].deviceId;
 		const frame = this.deps.frameDims(deviceId) ?? DEFAULT_FRAME;
 		const instantMembers = members.map(toInstant);
 		const instant = chooseGroupInstant(instantMembers, frame);
-		const openedAt = Math.min(...members.map((m) => m.firstSeen));
 		const closedAt = Math.max(...members.map((m) => m.lastSeen));
 		const timestamp = instant?.timestamp ?? closedAt;
 		const mediaInfos = await Promise.all(members.map(async (m) => ({
@@ -40874,8 +41145,17 @@ var GroupSealer = class {
 			nativeKey
 		});
 		if (members.length < 2 || instant === null) return;
-		const source = await this.pickCleanPixels(mediaInfos, timestamp);
-		if (source === null) return;
+		const source = await this.pickCleanPixels(mediaInfos, timestamp, deviceId);
+		if (source === null) {
+			this.deps.logger.info("group sealer: no clean pixels for crop", {
+				tags: { deviceId },
+				meta: {
+					groupId: draft.id,
+					members: members.map((m) => m.trackId)
+				}
+			});
+			return;
+		}
 		try {
 			const raw = await (0, sharp.default)(source.jpeg).removeAlpha().raw().toBuffer({ resolveWithObject: true });
 			if (raw.info.channels !== 3) return;
@@ -40905,21 +41185,16 @@ var GroupSealer = class {
 			});
 		}
 	}
-	async pickCleanPixels(mediaInfos, instantMs) {
-		const candidates = [];
-		for (const info of mediaInfos) for (const row of info.rows) {
-			const rank = row.kind === "keyFrame" ? 0 : row.kind === "keyFrameSmall" ? 1 : -1;
-			if (rank < 0) continue;
-			const dt = Math.abs(row.timestamp - instantMs);
-			if (dt > 2e3) continue;
-			candidates.push({
-				key: row.key,
-				dt,
-				rank
-			});
-		}
-		const chosen = candidates.toSorted((a, b) => a.rank - b.rank || a.dt - b.dt)[0];
-		if (chosen === void 0) return null;
+	async pickCleanPixels(mediaInfos, instantMs, deviceId) {
+		const chosen = pickCleanPixelRow(mediaInfos.flatMap((info) => info.rows), instantMs);
+		if (chosen === null) return null;
+		if (chosen.usedFallback) this.deps.logger.info("group sealer: crop pixels not within 2s of instant, using nearest keyFrame", {
+			tags: { deviceId },
+			meta: {
+				instantMs,
+				mediaKey: chosen.key
+			}
+		});
 		const file = await this.deps.mediaStore.getByKey(chosen.key);
 		if (file === null) return null;
 		return { jpeg: Buffer.from(file.base64, "base64") };
@@ -40947,8 +41222,8 @@ var GroupSealer = class {
 */
 /**
 * @durable class=ledger owner=pipeline-analytics
-*   write="one row per co-moving group at session close — sealed, never live.
-*     Membership is a partition of one camera's eligible tracks. mediaKey is
+*   write="one row per co-moving group, sealed at idle — never a live row.
+*     Membership is the RAM members at persist, not a session partition. mediaKey is
 *     the group's own crop; nativeKey is a POINTER to the anchor member's
 *     keyFrame, nulled if that member is deleted alone. anchorTrackId and
 *     nativeKey are the only fields rewritten after birth."
@@ -49350,10 +49625,21 @@ var TrackStore = class {
 	* in-memory dedup (the query cap has no DISTINCT); best-effort.
 	*/
 	async listDeviceIds() {
+		return this.collectDeviceIds(0);
+	}
+	/**
+	* Distinct deviceIds with a persisted track whose `lastSeen` is at least
+	* `since`. The group sealer's 10-minute window. Walking from epoch 0 is how
+	* `sealRecent` wedged hub-main every TTL sweep.
+	*/
+	async listDeviceIdsSince(since) {
+		return this.collectDeviceIds(Math.max(0, Math.floor(since)));
+	}
+	async collectDeviceIds(fromLastSeen) {
 		const seenDevices = /* @__PURE__ */ new Set();
 		const seenIds = /* @__PURE__ */ new Set();
 		const PAGE = 500;
-		let cursor = 0;
+		let cursor = fromLastSeen;
 		try {
 			for (;;) {
 				const rows = await this.store.query.query({
@@ -56740,6 +57026,9 @@ var PipelineAnalyticsAddon = class PipelineAnalyticsAddon extends require_dist.B
 	plateStore = null;
 	groupStore = null;
 	groupSealer = null;
+	groupLive = null;
+	/** Serialise first-activity lookback per camera, then observe in order. */
+	groupObserveTail = /* @__PURE__ */ new Map();
 	plateRecognizer = null;
 	objectEmbeddingStore = null;
 	/** Live state of the detached embedding rebuild — see `rebuildObjectEmbeddings`. */
@@ -58064,6 +58353,7 @@ var PipelineAnalyticsAddon = class PipelineAnalyticsAddon extends require_dist.B
 			media: mediaStore
 		});
 		this.groupStore = groupStore;
+		this.groupLive = new GroupLiveBuffer();
 		this.groupSealer = new GroupSealer({
 			trackStore,
 			groupStore,
@@ -58078,9 +58368,6 @@ var PipelineAnalyticsAddon = class PipelineAnalyticsAddon extends require_dist.B
 			},
 			now: () => Date.now()
 		});
-		this.groupSealer.backfill().catch((err) => {
-			logger.warn("group sealer backfill failed", { meta: { error: require_dist.errMsg(err) } });
-		});
 		return {
 			trackStore,
 			mediaStore,
@@ -58523,6 +58810,7 @@ var PipelineAnalyticsAddon = class PipelineAnalyticsAddon extends require_dist.B
 	buildSummaryPorts(stores) {
 		return {
 			listTracks: async ({ deviceId, sinceMs, untilMs, limit }) => {
+				await this.groupSealer?.sealWindow(deviceId, sinceMs, untilMs);
 				const groups = await stores.groupStore.listOverlapping({
 					deviceId,
 					sinceMs,
@@ -58566,21 +58854,26 @@ var PipelineAnalyticsAddon = class PipelineAnalyticsAddon extends require_dist.B
 			},
 			listMediaInfo: async (id) => {
 				const group = await stores.groupStore.get(id);
-				if (group?.mediaKey) return [{
-					key: group.mediaKey,
-					kind: "groupCrop",
-					timestamp: group.timestamp
-				}];
-				if (group && group.memberCount === 1) {
-					const memberId = (await stores.groupStore.listMembers(group.id))[0]?.trackId;
-					if (!memberId) return [];
-					return (await stores.mediaStore.listInfoByOwner("track", memberId)).map((r) => ({
+				if (group) {
+					if (group.mediaKey || group.nativeKey) return digestMediaRows({
+						mediaKey: group.mediaKey,
+						nativeKey: group.nativeKey,
+						timestamp: group.timestamp,
+						memberRows: []
+					});
+					const members = await stores.groupStore.listMembers(group.id);
+					const memberRows = (await Promise.all(members.map((m) => stores.mediaStore.listInfoByOwner("track", m.trackId)))).flatMap((rows) => rows.map((r) => ({
 						key: r.key,
 						kind: r.kind,
 						timestamp: r.timestamp
-					}));
+					})));
+					return digestMediaRows({
+						mediaKey: group.mediaKey,
+						nativeKey: group.nativeKey,
+						timestamp: group.timestamp,
+						memberRows
+					});
 				}
-				if (group) return [];
 				return (await stores.mediaStore.listInfoByOwner("track", id)).map((r) => ({
 					key: r.key,
 					kind: r.kind,
@@ -59826,6 +60119,7 @@ var PipelineAnalyticsAddon = class PipelineAnalyticsAddon extends require_dist.B
 				state: t.state
 			});
 			positionsCountById.set(t.trackId, upserted.positions.length);
+			this.enqueueLiveGroup(upserted, result.timestamp);
 		}
 		if (result.rawTrackedDetections.length > 0) {
 			const { minHits } = await this.resolveDeviceDetectionSensitivitySettings(deviceId);
@@ -61749,7 +62043,28 @@ var PipelineAnalyticsAddon = class PipelineAnalyticsAddon extends require_dist.B
 	async sweepExpiredTracks() {
 		if (this.shuttingDown || !this.trackStore) return;
 		await this.trackCloser.sweep();
-		this.groupSealer?.sealRecent();
+		if (this.isPostProcessingNode && this.groupLive) this.groupSealer?.flushIdle(this.groupLive);
+	}
+	/** Hub-only: assign this sighting in RAM. First activity on a camera
+	*  replays 2 minutes of that camera (crash recover), then observe is sync. */
+	enqueueLiveGroup(track, now) {
+		if (!this.isPostProcessingNode || !this.groupLive) return;
+		const deviceId = track.deviceId;
+		const snapshot = toGroupableTrack(track);
+		if (this.groupLive.isPrimed(deviceId)) {
+			this.groupLive.observe(snapshot, now);
+			return;
+		}
+		const next = (this.groupObserveTail.get(deviceId) ?? Promise.resolve()).then(async () => {
+			if (this.groupLive && this.groupSealer && !this.groupLive.isPrimed(deviceId)) await this.groupSealer.recoverCamera(deviceId, this.groupLive);
+			this.groupLive?.observe(snapshot, now);
+		}).catch((err) => {
+			this.ctx.logger.warn("group live observe failed", {
+				tags: { deviceId },
+				meta: { error: String(err) }
+			});
+		});
+		this.groupObserveTail.set(deviceId, next);
 	}
 	/** Unified retention (Phase 1): earliest retained footage per device — the
 	*  follow-recordings cutoff source. Cached 10 min: availability answers in
@@ -62394,6 +62709,16 @@ var PipelineAnalyticsAddon = class PipelineAnalyticsAddon extends require_dist.B
 		};
 		if (plausible) this.stationaryRegistry?.promote(entry);
 		processor.dropTrack(track.trackId);
+		const peek = this.trackStore?.peekActive(track.trackId);
+		if (peek) this.enqueueLiveGroup(toGroupableTrack({
+			trackId: track.trackId,
+			deviceId,
+			className: track.className,
+			firstSeen: peek.firstSeen,
+			lastSeen: timestamp,
+			positions: peek.positions,
+			closedReason: "stationary-promotion"
+		}), timestamp);
 		this.trackStore?.closeActive(track.trackId, "stationary-promotion").catch((err) => {
 			this.ctx.logger.warn("stationary promotion: closing the source track failed — its media, events and vector are now unowned", {
 				tags: { deviceId },