@camstack/addon-post-analysis 1.2.361 → 1.2.363

package/dist/pipeline-analytics/index.js

@@ -64653,6 +64653,11 @@ var LATE_ABSORBED_WORK_SAMPLE_MS = 6e4;
 /** Absorbed ids remembered after their survivor closed, so late work for
 *  them is refused rather than resurrected (oldest forgotten first). */
 var MAX_RETIRED_ABSORBED_IDS = 4096;
+/** Closed track ids remembered (oldest forgotten first) so an async completion
+*  settling AFTER `close` is refused instead of re-creating a resident nothing
+*  would ever close. Track ids are unique per birth; 16384 covers hours of
+*  settling at the busiest observed birth rate. */
+var MAX_CLOSED_TRACK_IDS = 16384;
 var TrackResidentState = class {
 	hooks;
 	residents = /* @__PURE__ */ new Map();
@@ -64694,6 +64699,8 @@ var TrackResidentState = class {
 	bestShotHolder = /* @__PURE__ */ new Map();
 	/** Absorbed id → survivor id, for survivors that already closed (bounded). */
 	retired = /* @__PURE__ */ new Map();
+	/** Ids closed by `close` (bounded FIFO). Only `open` — a birth — clears one. */
+	closedIds = /* @__PURE__ */ new Set();
 	/** Per device: start of the current late-work sample window, and how many
 	*  refusals it has swallowed since the last sampled call. */
 	lateWorkSample = /* @__PURE__ */ new Map();
@@ -64707,7 +64714,13 @@ var TrackResidentState = class {
 	/** Idempotently create the track's resident record (deviceId travels with
 	*  it so device teardown can enumerate its tracks). */
 	open(deviceId, trackId) {
-		this.ensure(deviceId, trackId);
+		this.closedIds.delete(trackId);
+		this.ensure(deviceId, trackId, "general", "open");
+	}
+	/** True while the track owns a live resident (its survivor's, when absorbed).
+	*  Async completions check this before doing work for a track. */
+	isLive(trackId) {
+		return this.residents.has(this.canonical(trackId));
 	}
 	/**
 	* Get-or-create the resident record (every mutator routes through this so
@@ -64718,15 +64731,19 @@ var TrackResidentState = class {
 	* An absorbed id whose survivor already closed is refused. `undefined` =
 	* refused (sampled through `onLateAbsorbedWork`); nothing is created.
 	*/
-	ensure(deviceId, trackId, kind = "general") {
+	ensure(deviceId, trackId, kind = "general", write = "ensure") {
 		const retiredInto = this.retired.get(trackId);
 		if (retiredInto !== void 0) {
-			this.refuseLateWork(deviceId, trackId, retiredInto, "survivor-closed");
+			this.refuseLateWork(deviceId, trackId, retiredInto, "survivor-closed", write);
+			return;
+		}
+		if (this.closedIds.has(trackId)) {
+			this.refuseLateWork(deviceId, trackId, trackId, "track-closed", write);
 			return;
 		}
 		const survivorId = this.aliases.get(trackId);
 		if (survivorId !== void 0 && kind === "bestShot" && (this.bestShotHolder.get(survivorId) ?? survivorId) !== trackId) {
-			this.refuseLateWork(deviceId, trackId, survivorId, "losing-shot");
+			this.refuseLateWork(deviceId, trackId, survivorId, "losing-shot", write);
 			return;
 		}
 		const id = survivorId ?? trackId;
@@ -64741,10 +64758,10 @@ var TrackResidentState = class {
 	liveId(deviceId, trackId) {
 		const retiredInto = this.retired.get(trackId);
 		if (retiredInto === void 0) return this.canonical(trackId);
-		this.refuseLateWork(deviceId, trackId, retiredInto, "survivor-closed");
+		this.refuseLateWork(deviceId, trackId, retiredInto, "survivor-closed", "liveId");
 	}
 	/** Count a refused late write; hand the host one sampled line per window. */
-	refuseLateWork(deviceId, trackId, survivorId, reason) {
+	refuseLateWork(deviceId, trackId, survivorId, reason, write) {
 		const now = Date.now();
 		const sample = this.lateWorkSample.get(deviceId);
 		if (sample !== void 0 && now - sample.at < LATE_ABSORBED_WORK_SAMPLE_MS) {
@@ -64761,7 +64778,8 @@ var TrackResidentState = class {
 			trackId,
 			survivorId,
 			reason,
-			refused
+			refused,
+			write
 		});
 	}
 	/**
@@ -64781,6 +64799,12 @@ var TrackResidentState = class {
 			mediaId: resident.keyFrameMediaId
 		});
 		this.hooks.onClose?.(trackId);
+		this.closedIds.add(trackId);
+		while (this.closedIds.size > MAX_CLOSED_TRACK_IDS) {
+			const oldest = this.closedIds.values().next().value;
+			if (oldest === void 0) break;
+			this.closedIds.delete(oldest);
+		}
 		const absorbed = this.absorbedBy.get(trackId);
 		this.bestShotHolder.delete(trackId);
 		if (absorbed !== void 0) {
@@ -64848,11 +64872,28 @@ var TrackResidentState = class {
 		this.aliases.clear();
 		this.bestShotHolder.clear();
 		this.retired.clear();
+		this.closedIds.clear();
 		this.lateWorkSample.clear();
 	}
 	size() {
 		return this.residents.size;
 	}
+	/** Residents whose last frame stamp is older than `olderThanMs` (a resident
+	*  never stamped is not listed: it carries no clock to judge). The host
+	*  subtracts the ids a live tracker still carries — what remains is a record
+	*  nothing will ever close. */
+	idleResidents(olderThanMs) {
+		const idle = [];
+		for (const [trackId, resident] of this.residents) {
+			const at = resident.lastFrameAt;
+			if (at !== void 0 && at < olderThanMs) idle.push({
+				trackId,
+				deviceId: resident.deviceId,
+				lastFrameAt: at
+			});
+		}
+		return idle;
+	}
 	trackIdsForDevice(deviceId) {
 		const ids = [];
 		for (const [trackId, resident] of this.residents) if (resident.deviceId === deviceId) ids.push(trackId);
@@ -64863,7 +64904,7 @@ var TrackResidentState = class {
 	observeBestFrame(deviceId, trackId, confidence, timestamp, edgeClear, centerScore, containment, sizeScore, squareFraction, semantic, canvasFill) {
 		const id = this.liveId(deviceId, trackId);
 		if (id === void 0) return false;
-		this.open(deviceId, id);
+		if (this.ensure(deviceId, id, "bestShot", "observeBestFrame") === void 0) return false;
 		const isNewBest = this.bestFrameTracker.observe(id, confidence, timestamp, edgeClear, centerScore, containment, sizeScore, squareFraction, semantic, canvasFill);
 		if (isNewBest) this.bestShotHolder.delete(id);
 		return isNewBest;
@@ -64930,7 +64971,7 @@ var TrackResidentState = class {
 			...observed,
 			trackId: id
 		};
-		this.open(deviceId, id);
+		if (this.ensure(deviceId, id, "general", "observeObjectEmbeddingBest") === void 0) return false;
 		const modelId = obs.embeddingModelId ?? "";
 		let selector = this.objectEmbeddingBestSelectors.get(modelId);
 		if (selector === void 0) {
@@ -64947,7 +64988,7 @@ var TrackResidentState = class {
 		return this.residents.get(this.canonical(trackId))?.keyFrameMediaId ?? this.deferredKeyFrameKeys.get(trackId)?.mediaId;
 	}
 	setKeyFrameMediaId(deviceId, trackId, mediaId) {
-		const resident = this.ensure(deviceId, trackId, "bestShot");
+		const resident = this.ensure(deviceId, trackId, "bestShot", "setKeyFrameMediaId");
 		if (resident !== void 0) resident.keyFrameMediaId = mediaId;
 	}
 	/** Settle the keyFrame-id drop (called once the face recognizer's
@@ -64963,7 +65004,7 @@ var TrackResidentState = class {
 		return this.residents.get(this.canonical(trackId))?.lastFrameAt;
 	}
 	setLastFrameAt(deviceId, trackId, atMs) {
-		const resident = this.ensure(deviceId, trackId);
+		const resident = this.ensure(deviceId, trackId, "general", "setLastFrameAt");
 		if (resident !== void 0) resident.lastFrameAt = atMs;
 	}
 	anyFirstFramePending() {
@@ -64983,7 +65024,7 @@ var TrackResidentState = class {
 	}
 	/** A `firstFrame` write landed for this track (see {@link TrackResident.firstFrameLanded}). */
 	markFirstFrameLanded(deviceId, trackId) {
-		const resident = this.ensure(deviceId, trackId);
+		const resident = this.ensure(deviceId, trackId, "general", "markFirstFrameLanded");
 		if (resident !== void 0) resident.firstFrameLanded = true;
 	}
 	isFirstFrameLanded(trackId) {
@@ -64993,7 +65034,7 @@ var TrackResidentState = class {
 		return this.residents.get(this.canonical(trackId))?.thumbnailLanded ?? false;
 	}
 	markThumbnailLanded(deviceId, trackId) {
-		const resident = this.ensure(deviceId, trackId, "bestShot");
+		const resident = this.ensure(deviceId, trackId, "bestShot", "markThumbnailLanded");
 		if (resident !== void 0) resident.thumbnailLanded = true;
 	}
 	/**
@@ -65040,14 +65081,14 @@ var TrackResidentState = class {
 	* spend one of the track's three retries.
 	*/
 	noteKeyFrameAttempt(deviceId, trackId, atMs, retry) {
-		const resident = this.ensure(deviceId, trackId, "bestShot");
+		const resident = this.ensure(deviceId, trackId, "bestShot", "noteKeyFrameAttempt");
 		if (resident === void 0) return;
 		resident.keyFrameLastAttemptAt = atMs;
 		if (retry) resident.keyFrameRetries += 1;
 	}
 	/** A `keyFrame` write landed — sticky, and the end of the retry path. */
 	markKeyFrameLanded(deviceId, trackId) {
-		const resident = this.ensure(deviceId, trackId, "bestShot");
+		const resident = this.ensure(deviceId, trackId, "bestShot", "markKeyFrameLanded");
 		if (resident !== void 0) resident.keyFrameLanded = true;
 	}
 	lifecycleUpdateMem(trackId) {
@@ -65100,7 +65141,7 @@ var TrackResidentState = class {
 	/** Retain the FIRST detection-raster crop per track (zero-media fallback);
 	*  a later frame never overwrites an existing one. */
 	retainRasterFallback(deviceId, trackId, fallback) {
-		const resident = this.ensure(deviceId, trackId);
+		const resident = this.ensure(deviceId, trackId, "general", "retainRasterFallback");
 		if (resident !== void 0 && resident.rasterFallback === void 0) resident.rasterFallback = fallback;
 	}
 };
@@ -93462,6 +93503,8 @@ function planeRunsStationary(source) {
 */
 var SuppressedBirthRegistry = class {
 	byDevice = /* @__PURE__ */ new Map();
+	/** Rejected ids whose per-frame skip has already been reported once. */
+	skipReported = /* @__PURE__ */ new Map();
 	/** Record that this birth was rejected; later frames must not re-upsert it. */
 	reject(deviceKey, trackId) {
 		let ids = this.byDevice.get(deviceKey);
@@ -93475,12 +93518,31 @@ var SuppressedBirthRegistry = class {
 		return this.byDevice.get(deviceKey)?.has(trackId) === true;
 	}
 	/**
+	* True the FIRST time a rejected id's frame work is skipped (so the host logs
+	* one line per id, not one per frame); false afterwards.
+	*/
+	firstSkip(deviceKey, trackId) {
+		let ids = this.skipReported.get(deviceKey);
+		if (!ids) {
+			ids = /* @__PURE__ */ new Set();
+			this.skipReported.set(deviceKey, ids);
+		}
+		if (ids.has(trackId)) return false;
+		ids.add(trackId);
+		return true;
+	}
+	/**
 	* Forget every rejected id the tracker is no longer carrying.
 	*
 	* Called once per frame with the ids present THIS frame. An id absent from
 	* that set can never be upserted again, so holding it serves nothing.
 	*/
 	retain(deviceKey, currentTrackIds) {
+		const reported = this.skipReported.get(deviceKey);
+		if (reported) {
+			for (const id of reported) if (!currentTrackIds.has(id)) reported.delete(id);
+			if (reported.size === 0) this.skipReported.delete(deviceKey);
+		}
 		const ids = this.byDevice.get(deviceKey);
 		if (!ids) return;
 		for (const id of ids) if (!currentTrackIds.has(id)) ids.delete(id);
@@ -93493,6 +93555,7 @@ var SuppressedBirthRegistry = class {
 	/** Drop a device's memory wholesale (device removed / pipeline reset). */
 	clearDevice(deviceKey) {
 		this.byDevice.delete(deviceKey);
+		this.skipReported.delete(deviceKey);
 	}
 };
 //#endregion
@@ -110773,6 +110836,10 @@ var NO_PUBLICATION = {
 	url: null,
 	artifactId: null
 };
+/** How often the resident-vs-live-track heartbeat line is written. */
+var RESIDENT_HEARTBEAT_INTERVAL_MS = 5 * 6e4;
+/** A resident idle this long that nothing carries is an orphan. */
+var RESIDENT_ORPHAN_IDLE_MS = 2 * 6e4;
 /**
 * A tRPC-shaped router or procedure reached by DYNAMIC name off `ctx.api`.
 *
@@ -111853,12 +111920,13 @@ var PipelineAnalyticsAddon = class PipelineAnalyticsAddon extends require_clip_m
 			this.parkedFrames?.adopt(survivorId, absorbedId, bestShotFrom);
 		},
 		onLateAbsorbedWork: (work) => {
-			this.ctx.logger.info("track resident: late work under an absorbed track id refused", {
+			this.ctx.logger.info("track resident: late work after close refused", {
 				tags: { deviceId: work.deviceId },
 				meta: {
 					trackId: work.trackId,
 					survivorId: work.survivorId,
 					reason: work.reason,
+					kind: work.write,
 					refused: work.refused
 				}
 			});
@@ -115322,11 +115390,47 @@ var PipelineAnalyticsAddon = class PipelineAnalyticsAddon extends require_clip_m
 		this.releaseProxy(deviceId);
 		this.notificationCenter?.onDeviceDeleted(deviceId);
 	}
+	/** Wall-clock of the last resident heartbeat line. */
+	residentHeartbeatAt = 0;
+	/**
+	* Resident records vs live tracks, once per interval: a resident count that
+	* climbs past the live-track count is the signature of a record nothing
+	* closes (the late-completion ghost fixed 2026-10-14).
+	*/
+	logResidentHeartbeat(now) {
+		if (now - this.residentHeartbeatAt < RESIDENT_HEARTBEAT_INTERVAL_MS) return;
+		this.residentHeartbeatAt = now;
+		let liveTracks = 0;
+		for (const ids of this.lastActiveTrackIds.values()) liveTracks += ids.size;
+		const orphans = this.orphanResidents(now);
+		const mem = process.memoryUsage();
+		this.ctx.logger.info("analytics resident heartbeat", { meta: {
+			residents: this.residents.size(),
+			liveTracks,
+			orphans: orphans.length,
+			orphanSamples: orphans.slice(0, 3).map((o) => ({
+				trackId: o.trackId,
+				deviceId: o.deviceId
+			})),
+			externalNonBufferMb: Math.max(0, Math.round((mem.external - mem.arrayBuffers) / 1048576))
+		} });
+	}
+	/** Residents neither active in the TrackStore nor carried by the tracker
+	*  (`lastActiveTrackIds`) whose last frame is older than the orphan window:
+	*  a record no sweep can ever close. Healthy value: 0. */
+	orphanResidents(now) {
+		return this.residents.idleResidents(now - RESIDENT_ORPHAN_IDLE_MS).filter((r) => {
+			if (this.trackStore?.peekActive(r.trackId) !== null) return false;
+			for (const ids of this.lastActiveTrackIds.values()) if (ids.has(r.trackId)) return false;
+			return true;
+		});
+	}
 	/** Periodic sweeps — TTL promotion + retention/stationary aging. */
 	startSweepTimers() {
 		this.ttlSweepTimer = setInterval(() => {
 			this.sweepExpiredTracks();
 			this.runPackageStillnessSweep(Date.now());
+			this.logResidentHeartbeat(Date.now());
 		}, TTL_SWEEP_INTERVAL_MS);
 		this.faceReembedAutoTimer = setInterval(() => {
 			this.maybeAutoReembedFaces().then(() => this.faceAlignmentJobs?.maybeAutoRunPhotoPass());
@@ -116441,7 +116545,10 @@ var PipelineAnalyticsAddon = class PipelineAnalyticsAddon extends require_clip_m
 		}
 		if (result.rawTrackedDetections.length > 0) {
 			const { minHits } = await this.resolveDeviceDetectionSensitivitySettings(deviceId);
-			for (const rt of result.rawTrackedDetections) if (rt.trackAge >= minHits) this.residents.markConfirmed(deviceId, rt.trackId);
+			for (const rt of result.rawTrackedDetections) {
+				if (this.suppressedBirths.isRejected(key, rt.trackId)) continue;
+				if (rt.trackAge >= minHits) this.residents.markConfirmed(deviceId, rt.trackId);
+			}
 		}
 		const log = this.ctx.logger.withTags({ deviceId });
 		const prevIds = this.lastActiveTrackIds.get(key) ?? /* @__PURE__ */ new Set();
@@ -116727,6 +116834,25 @@ var PipelineAnalyticsAddon = class PipelineAnalyticsAddon extends require_clip_m
 		this.deferredBirths.retain(key, currentTrackIds);
 		this.birthEvidence.retain(key, currentTrackIds);
 		this.lastActiveTrackIds.set(key, currentTrackIds);
+		const rejectedThisFrame = /* @__PURE__ */ new Set();
+		for (const t of result.tracked) {
+			if (!this.suppressedBirths.isRejected(key, t.trackId)) continue;
+			rejectedThisFrame.add(t.trackId);
+			if (this.suppressedBirths.firstSkip(key, t.trackId)) log.info("frame work skipped — the track birth was suppressed", {
+				tags: { deviceId },
+				meta: {
+					trackId: t.trackId,
+					className: t.className
+				}
+			});
+		}
+		if (rejectedThisFrame.size > 0) result = {
+			...result,
+			tracked: result.tracked.filter((t) => !rejectedThisFrame.has(t.trackId)),
+			rawTrackedDetections: result.rawTrackedDetections.filter((rt) => !rejectedThisFrame.has(rt.trackId)),
+			objectEvents: result.objectEvents.filter((e) => e.trackId === void 0 || !rejectedThisFrame.has(e.trackId)),
+			appearanceEvents: result.appearanceEvents.filter((e) => e.trackId === void 0 || !rejectedThisFrame.has(e.trackId))
+		};
 		if (currentTrackIds.size > 0) this.lastTrackActivityMs.set(deviceId, Date.now());
 		const stationarySettings = this.stationarySettingsFromCache(deviceId);
 		const packageSettings = this.packageDropSettingsFromCache(deviceId);
@@ -116986,17 +117112,21 @@ var PipelineAnalyticsAddon = class PipelineAnalyticsAddon extends require_clip_m
 					}),
 					holdKeys: heldCaptureKeys,
 					staleAfterMs: ENRICHMENT_CAPTURE_STALE_MS,
-					exec: () => pinnedFramePromise.then((pinnedFrame) => dispatcher.captureForFrame({
-						deviceId,
-						frameHandle,
-						events: eventTargets,
-						trackFrames: firstFrameTargets,
-						snapshots: snapshotTargets,
-						cropPadding: mediaSettings.cropPadding,
-						rasterFallbackWantedTrackIds,
-						rasterFallbackCandidates,
-						...pinnedFrame !== null ? { pinnedFrame } : {}
-					})).then((res) => {
+					exec: () => pinnedFramePromise.then((pinnedFrame) => {
+						const liveWanted = /* @__PURE__ */ new Set();
+						for (const id of rasterFallbackWantedTrackIds) if (this.residents.isLive(id)) liveWanted.add(id);
+						return dispatcher.captureForFrame({
+							deviceId,
+							frameHandle,
+							events: eventTargets,
+							trackFrames: firstFrameTargets,
+							snapshots: snapshotTargets,
+							cropPadding: mediaSettings.cropPadding,
+							rasterFallbackWantedTrackIds: liveWanted,
+							rasterFallbackCandidates: rasterFallbackCandidates.filter((c) => this.residents.isLive(c.trackId)),
+							...pinnedFrame !== null ? { pinnedFrame } : {}
+						});
+					}).then((res) => {
 						for (const rf of res.rasterFallbacks) this.residents.retainRasterFallback(deviceId, rf.trackId, {
 							jpeg: rf.jpeg,
 							timestamp: rf.timestamp

package/dist/pipeline-analytics/index.mjs

@@ -64609,6 +64609,11 @@ var LATE_ABSORBED_WORK_SAMPLE_MS = 6e4;
 /** Absorbed ids remembered after their survivor closed, so late work for
 *  them is refused rather than resurrected (oldest forgotten first). */
 var MAX_RETIRED_ABSORBED_IDS = 4096;
+/** Closed track ids remembered (oldest forgotten first) so an async completion
+*  settling AFTER `close` is refused instead of re-creating a resident nothing
+*  would ever close. Track ids are unique per birth; 16384 covers hours of
+*  settling at the busiest observed birth rate. */
+var MAX_CLOSED_TRACK_IDS = 16384;
 var TrackResidentState = class {
 	hooks;
 	residents = /* @__PURE__ */ new Map();
@@ -64650,6 +64655,8 @@ var TrackResidentState = class {
 	bestShotHolder = /* @__PURE__ */ new Map();
 	/** Absorbed id → survivor id, for survivors that already closed (bounded). */
 	retired = /* @__PURE__ */ new Map();
+	/** Ids closed by `close` (bounded FIFO). Only `open` — a birth — clears one. */
+	closedIds = /* @__PURE__ */ new Set();
 	/** Per device: start of the current late-work sample window, and how many
 	*  refusals it has swallowed since the last sampled call. */
 	lateWorkSample = /* @__PURE__ */ new Map();
@@ -64663,7 +64670,13 @@ var TrackResidentState = class {
 	/** Idempotently create the track's resident record (deviceId travels with
 	*  it so device teardown can enumerate its tracks). */
 	open(deviceId, trackId) {
-		this.ensure(deviceId, trackId);
+		this.closedIds.delete(trackId);
+		this.ensure(deviceId, trackId, "general", "open");
+	}
+	/** True while the track owns a live resident (its survivor's, when absorbed).
+	*  Async completions check this before doing work for a track. */
+	isLive(trackId) {
+		return this.residents.has(this.canonical(trackId));
 	}
 	/**
 	* Get-or-create the resident record (every mutator routes through this so
@@ -64674,15 +64687,19 @@ var TrackResidentState = class {
 	* An absorbed id whose survivor already closed is refused. `undefined` =
 	* refused (sampled through `onLateAbsorbedWork`); nothing is created.
 	*/
-	ensure(deviceId, trackId, kind = "general") {
+	ensure(deviceId, trackId, kind = "general", write = "ensure") {
 		const retiredInto = this.retired.get(trackId);
 		if (retiredInto !== void 0) {
-			this.refuseLateWork(deviceId, trackId, retiredInto, "survivor-closed");
+			this.refuseLateWork(deviceId, trackId, retiredInto, "survivor-closed", write);
+			return;
+		}
+		if (this.closedIds.has(trackId)) {
+			this.refuseLateWork(deviceId, trackId, trackId, "track-closed", write);
 			return;
 		}
 		const survivorId = this.aliases.get(trackId);
 		if (survivorId !== void 0 && kind === "bestShot" && (this.bestShotHolder.get(survivorId) ?? survivorId) !== trackId) {
-			this.refuseLateWork(deviceId, trackId, survivorId, "losing-shot");
+			this.refuseLateWork(deviceId, trackId, survivorId, "losing-shot", write);
 			return;
 		}
 		const id = survivorId ?? trackId;
@@ -64697,10 +64714,10 @@ var TrackResidentState = class {
 	liveId(deviceId, trackId) {
 		const retiredInto = this.retired.get(trackId);
 		if (retiredInto === void 0) return this.canonical(trackId);
-		this.refuseLateWork(deviceId, trackId, retiredInto, "survivor-closed");
+		this.refuseLateWork(deviceId, trackId, retiredInto, "survivor-closed", "liveId");
 	}
 	/** Count a refused late write; hand the host one sampled line per window. */
-	refuseLateWork(deviceId, trackId, survivorId, reason) {
+	refuseLateWork(deviceId, trackId, survivorId, reason, write) {
 		const now = Date.now();
 		const sample = this.lateWorkSample.get(deviceId);
 		if (sample !== void 0 && now - sample.at < LATE_ABSORBED_WORK_SAMPLE_MS) {
@@ -64717,7 +64734,8 @@ var TrackResidentState = class {
 			trackId,
 			survivorId,
 			reason,
-			refused
+			refused,
+			write
 		});
 	}
 	/**
@@ -64737,6 +64755,12 @@ var TrackResidentState = class {
 			mediaId: resident.keyFrameMediaId
 		});
 		this.hooks.onClose?.(trackId);
+		this.closedIds.add(trackId);
+		while (this.closedIds.size > MAX_CLOSED_TRACK_IDS) {
+			const oldest = this.closedIds.values().next().value;
+			if (oldest === void 0) break;
+			this.closedIds.delete(oldest);
+		}
 		const absorbed = this.absorbedBy.get(trackId);
 		this.bestShotHolder.delete(trackId);
 		if (absorbed !== void 0) {
@@ -64804,11 +64828,28 @@ var TrackResidentState = class {
 		this.aliases.clear();
 		this.bestShotHolder.clear();
 		this.retired.clear();
+		this.closedIds.clear();
 		this.lateWorkSample.clear();
 	}
 	size() {
 		return this.residents.size;
 	}
+	/** Residents whose last frame stamp is older than `olderThanMs` (a resident
+	*  never stamped is not listed: it carries no clock to judge). The host
+	*  subtracts the ids a live tracker still carries — what remains is a record
+	*  nothing will ever close. */
+	idleResidents(olderThanMs) {
+		const idle = [];
+		for (const [trackId, resident] of this.residents) {
+			const at = resident.lastFrameAt;
+			if (at !== void 0 && at < olderThanMs) idle.push({
+				trackId,
+				deviceId: resident.deviceId,
+				lastFrameAt: at
+			});
+		}
+		return idle;
+	}
 	trackIdsForDevice(deviceId) {
 		const ids = [];
 		for (const [trackId, resident] of this.residents) if (resident.deviceId === deviceId) ids.push(trackId);
@@ -64819,7 +64860,7 @@ var TrackResidentState = class {
 	observeBestFrame(deviceId, trackId, confidence, timestamp, edgeClear, centerScore, containment, sizeScore, squareFraction, semantic, canvasFill) {
 		const id = this.liveId(deviceId, trackId);
 		if (id === void 0) return false;
-		this.open(deviceId, id);
+		if (this.ensure(deviceId, id, "bestShot", "observeBestFrame") === void 0) return false;
 		const isNewBest = this.bestFrameTracker.observe(id, confidence, timestamp, edgeClear, centerScore, containment, sizeScore, squareFraction, semantic, canvasFill);
 		if (isNewBest) this.bestShotHolder.delete(id);
 		return isNewBest;
@@ -64886,7 +64927,7 @@ var TrackResidentState = class {
 			...observed,
 			trackId: id
 		};
-		this.open(deviceId, id);
+		if (this.ensure(deviceId, id, "general", "observeObjectEmbeddingBest") === void 0) return false;
 		const modelId = obs.embeddingModelId ?? "";
 		let selector = this.objectEmbeddingBestSelectors.get(modelId);
 		if (selector === void 0) {
@@ -64903,7 +64944,7 @@ var TrackResidentState = class {
 		return this.residents.get(this.canonical(trackId))?.keyFrameMediaId ?? this.deferredKeyFrameKeys.get(trackId)?.mediaId;
 	}
 	setKeyFrameMediaId(deviceId, trackId, mediaId) {
-		const resident = this.ensure(deviceId, trackId, "bestShot");
+		const resident = this.ensure(deviceId, trackId, "bestShot", "setKeyFrameMediaId");
 		if (resident !== void 0) resident.keyFrameMediaId = mediaId;
 	}
 	/** Settle the keyFrame-id drop (called once the face recognizer's
@@ -64919,7 +64960,7 @@ var TrackResidentState = class {
 		return this.residents.get(this.canonical(trackId))?.lastFrameAt;
 	}
 	setLastFrameAt(deviceId, trackId, atMs) {
-		const resident = this.ensure(deviceId, trackId);
+		const resident = this.ensure(deviceId, trackId, "general", "setLastFrameAt");
 		if (resident !== void 0) resident.lastFrameAt = atMs;
 	}
 	anyFirstFramePending() {
@@ -64939,7 +64980,7 @@ var TrackResidentState = class {
 	}
 	/** A `firstFrame` write landed for this track (see {@link TrackResident.firstFrameLanded}). */
 	markFirstFrameLanded(deviceId, trackId) {
-		const resident = this.ensure(deviceId, trackId);
+		const resident = this.ensure(deviceId, trackId, "general", "markFirstFrameLanded");
 		if (resident !== void 0) resident.firstFrameLanded = true;
 	}
 	isFirstFrameLanded(trackId) {
@@ -64949,7 +64990,7 @@ var TrackResidentState = class {
 		return this.residents.get(this.canonical(trackId))?.thumbnailLanded ?? false;
 	}
 	markThumbnailLanded(deviceId, trackId) {
-		const resident = this.ensure(deviceId, trackId, "bestShot");
+		const resident = this.ensure(deviceId, trackId, "bestShot", "markThumbnailLanded");
 		if (resident !== void 0) resident.thumbnailLanded = true;
 	}
 	/**
@@ -64996,14 +65037,14 @@ var TrackResidentState = class {
 	* spend one of the track's three retries.
 	*/
 	noteKeyFrameAttempt(deviceId, trackId, atMs, retry) {
-		const resident = this.ensure(deviceId, trackId, "bestShot");
+		const resident = this.ensure(deviceId, trackId, "bestShot", "noteKeyFrameAttempt");
 		if (resident === void 0) return;
 		resident.keyFrameLastAttemptAt = atMs;
 		if (retry) resident.keyFrameRetries += 1;
 	}
 	/** A `keyFrame` write landed — sticky, and the end of the retry path. */
 	markKeyFrameLanded(deviceId, trackId) {
-		const resident = this.ensure(deviceId, trackId, "bestShot");
+		const resident = this.ensure(deviceId, trackId, "bestShot", "markKeyFrameLanded");
 		if (resident !== void 0) resident.keyFrameLanded = true;
 	}
 	lifecycleUpdateMem(trackId) {
@@ -65056,7 +65097,7 @@ var TrackResidentState = class {
 	/** Retain the FIRST detection-raster crop per track (zero-media fallback);
 	*  a later frame never overwrites an existing one. */
 	retainRasterFallback(deviceId, trackId, fallback) {
-		const resident = this.ensure(deviceId, trackId);
+		const resident = this.ensure(deviceId, trackId, "general", "retainRasterFallback");
 		if (resident !== void 0 && resident.rasterFallback === void 0) resident.rasterFallback = fallback;
 	}
 };
@@ -93367,6 +93408,8 @@ function planeRunsStationary(source) {
 */
 var SuppressedBirthRegistry = class {
 	byDevice = /* @__PURE__ */ new Map();
+	/** Rejected ids whose per-frame skip has already been reported once. */
+	skipReported = /* @__PURE__ */ new Map();
 	/** Record that this birth was rejected; later frames must not re-upsert it. */
 	reject(deviceKey, trackId) {
 		let ids = this.byDevice.get(deviceKey);
@@ -93380,12 +93423,31 @@ var SuppressedBirthRegistry = class {
 		return this.byDevice.get(deviceKey)?.has(trackId) === true;
 	}
 	/**
+	* True the FIRST time a rejected id's frame work is skipped (so the host logs
+	* one line per id, not one per frame); false afterwards.
+	*/
+	firstSkip(deviceKey, trackId) {
+		let ids = this.skipReported.get(deviceKey);
+		if (!ids) {
+			ids = /* @__PURE__ */ new Set();
+			this.skipReported.set(deviceKey, ids);
+		}
+		if (ids.has(trackId)) return false;
+		ids.add(trackId);
+		return true;
+	}
+	/**
 	* Forget every rejected id the tracker is no longer carrying.
 	*
 	* Called once per frame with the ids present THIS frame. An id absent from
 	* that set can never be upserted again, so holding it serves nothing.
 	*/
 	retain(deviceKey, currentTrackIds) {
+		const reported = this.skipReported.get(deviceKey);
+		if (reported) {
+			for (const id of reported) if (!currentTrackIds.has(id)) reported.delete(id);
+			if (reported.size === 0) this.skipReported.delete(deviceKey);
+		}
 		const ids = this.byDevice.get(deviceKey);
 		if (!ids) return;
 		for (const id of ids) if (!currentTrackIds.has(id)) ids.delete(id);
@@ -93398,6 +93460,7 @@ var SuppressedBirthRegistry = class {
 	/** Drop a device's memory wholesale (device removed / pipeline reset). */
 	clearDevice(deviceKey) {
 		this.byDevice.delete(deviceKey);
+		this.skipReported.delete(deviceKey);
 	}
 };
 //#endregion
@@ -110678,6 +110741,10 @@ var NO_PUBLICATION = {
 	url: null,
 	artifactId: null
 };
+/** How often the resident-vs-live-track heartbeat line is written. */
+var RESIDENT_HEARTBEAT_INTERVAL_MS = 5 * 6e4;
+/** A resident idle this long that nothing carries is an orphan. */
+var RESIDENT_ORPHAN_IDLE_MS = 2 * 6e4;
 /**
 * A tRPC-shaped router or procedure reached by DYNAMIC name off `ctx.api`.
 *
@@ -111758,12 +111825,13 @@ var PipelineAnalyticsAddon = class PipelineAnalyticsAddon extends BaseAddon {
 			this.parkedFrames?.adopt(survivorId, absorbedId, bestShotFrom);
 		},
 		onLateAbsorbedWork: (work) => {
-			this.ctx.logger.info("track resident: late work under an absorbed track id refused", {
+			this.ctx.logger.info("track resident: late work after close refused", {
 				tags: { deviceId: work.deviceId },
 				meta: {
 					trackId: work.trackId,
 					survivorId: work.survivorId,
 					reason: work.reason,
+					kind: work.write,
 					refused: work.refused
 				}
 			});
@@ -115227,11 +115295,47 @@ var PipelineAnalyticsAddon = class PipelineAnalyticsAddon extends BaseAddon {
 		this.releaseProxy(deviceId);
 		this.notificationCenter?.onDeviceDeleted(deviceId);
 	}
+	/** Wall-clock of the last resident heartbeat line. */
+	residentHeartbeatAt = 0;
+	/**
+	* Resident records vs live tracks, once per interval: a resident count that
+	* climbs past the live-track count is the signature of a record nothing
+	* closes (the late-completion ghost fixed 2026-10-14).
+	*/
+	logResidentHeartbeat(now) {
+		if (now - this.residentHeartbeatAt < RESIDENT_HEARTBEAT_INTERVAL_MS) return;
+		this.residentHeartbeatAt = now;
+		let liveTracks = 0;
+		for (const ids of this.lastActiveTrackIds.values()) liveTracks += ids.size;
+		const orphans = this.orphanResidents(now);
+		const mem = process.memoryUsage();
+		this.ctx.logger.info("analytics resident heartbeat", { meta: {
+			residents: this.residents.size(),
+			liveTracks,
+			orphans: orphans.length,
+			orphanSamples: orphans.slice(0, 3).map((o) => ({
+				trackId: o.trackId,
+				deviceId: o.deviceId
+			})),
+			externalNonBufferMb: Math.max(0, Math.round((mem.external - mem.arrayBuffers) / 1048576))
+		} });
+	}
+	/** Residents neither active in the TrackStore nor carried by the tracker
+	*  (`lastActiveTrackIds`) whose last frame is older than the orphan window:
+	*  a record no sweep can ever close. Healthy value: 0. */
+	orphanResidents(now) {
+		return this.residents.idleResidents(now - RESIDENT_ORPHAN_IDLE_MS).filter((r) => {
+			if (this.trackStore?.peekActive(r.trackId) !== null) return false;
+			for (const ids of this.lastActiveTrackIds.values()) if (ids.has(r.trackId)) return false;
+			return true;
+		});
+	}
 	/** Periodic sweeps — TTL promotion + retention/stationary aging. */
 	startSweepTimers() {
 		this.ttlSweepTimer = setInterval(() => {
 			this.sweepExpiredTracks();
 			this.runPackageStillnessSweep(Date.now());
+			this.logResidentHeartbeat(Date.now());
 		}, TTL_SWEEP_INTERVAL_MS);
 		this.faceReembedAutoTimer = setInterval(() => {
 			this.maybeAutoReembedFaces().then(() => this.faceAlignmentJobs?.maybeAutoRunPhotoPass());
@@ -116346,7 +116450,10 @@ var PipelineAnalyticsAddon = class PipelineAnalyticsAddon extends BaseAddon {
 		}
 		if (result.rawTrackedDetections.length > 0) {
 			const { minHits } = await this.resolveDeviceDetectionSensitivitySettings(deviceId);
-			for (const rt of result.rawTrackedDetections) if (rt.trackAge >= minHits) this.residents.markConfirmed(deviceId, rt.trackId);
+			for (const rt of result.rawTrackedDetections) {
+				if (this.suppressedBirths.isRejected(key, rt.trackId)) continue;
+				if (rt.trackAge >= minHits) this.residents.markConfirmed(deviceId, rt.trackId);
+			}
 		}
 		const log = this.ctx.logger.withTags({ deviceId });
 		const prevIds = this.lastActiveTrackIds.get(key) ?? /* @__PURE__ */ new Set();
@@ -116632,6 +116739,25 @@ var PipelineAnalyticsAddon = class PipelineAnalyticsAddon extends BaseAddon {
 		this.deferredBirths.retain(key, currentTrackIds);
 		this.birthEvidence.retain(key, currentTrackIds);
 		this.lastActiveTrackIds.set(key, currentTrackIds);
+		const rejectedThisFrame = /* @__PURE__ */ new Set();
+		for (const t of result.tracked) {
+			if (!this.suppressedBirths.isRejected(key, t.trackId)) continue;
+			rejectedThisFrame.add(t.trackId);
+			if (this.suppressedBirths.firstSkip(key, t.trackId)) log.info("frame work skipped — the track birth was suppressed", {
+				tags: { deviceId },
+				meta: {
+					trackId: t.trackId,
+					className: t.className
+				}
+			});
+		}
+		if (rejectedThisFrame.size > 0) result = {
+			...result,
+			tracked: result.tracked.filter((t) => !rejectedThisFrame.has(t.trackId)),
+			rawTrackedDetections: result.rawTrackedDetections.filter((rt) => !rejectedThisFrame.has(rt.trackId)),
+			objectEvents: result.objectEvents.filter((e) => e.trackId === void 0 || !rejectedThisFrame.has(e.trackId)),
+			appearanceEvents: result.appearanceEvents.filter((e) => e.trackId === void 0 || !rejectedThisFrame.has(e.trackId))
+		};
 		if (currentTrackIds.size > 0) this.lastTrackActivityMs.set(deviceId, Date.now());
 		const stationarySettings = this.stationarySettingsFromCache(deviceId);
 		const packageSettings = this.packageDropSettingsFromCache(deviceId);
@@ -116891,17 +117017,21 @@ var PipelineAnalyticsAddon = class PipelineAnalyticsAddon extends BaseAddon {
 					}),
 					holdKeys: heldCaptureKeys,
 					staleAfterMs: ENRICHMENT_CAPTURE_STALE_MS,
-					exec: () => pinnedFramePromise.then((pinnedFrame) => dispatcher.captureForFrame({
-						deviceId,
-						frameHandle,
-						events: eventTargets,
-						trackFrames: firstFrameTargets,
-						snapshots: snapshotTargets,
-						cropPadding: mediaSettings.cropPadding,
-						rasterFallbackWantedTrackIds,
-						rasterFallbackCandidates,
-						...pinnedFrame !== null ? { pinnedFrame } : {}
-					})).then((res) => {
+					exec: () => pinnedFramePromise.then((pinnedFrame) => {
+						const liveWanted = /* @__PURE__ */ new Set();
+						for (const id of rasterFallbackWantedTrackIds) if (this.residents.isLive(id)) liveWanted.add(id);
+						return dispatcher.captureForFrame({
+							deviceId,
+							frameHandle,
+							events: eventTargets,
+							trackFrames: firstFrameTargets,
+							snapshots: snapshotTargets,
+							cropPadding: mediaSettings.cropPadding,
+							rasterFallbackWantedTrackIds: liveWanted,
+							rasterFallbackCandidates: rasterFallbackCandidates.filter((c) => this.residents.isLive(c.trackId)),
+							...pinnedFrame !== null ? { pinnedFrame } : {}
+						});
+					}).then((res) => {
 						for (const rf of res.rasterFallbacks) this.residents.retainRasterFallback(deviceId, rf.trackId, {
 							jpeg: rf.jpeg,
 							timestamp: rf.timestamp

package/package.json

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