@camstack/addon-post-analysis 1.2.128 → 1.2.129

package/dist/pipeline-analytics/index.mjs

@@ -1,4 +1,4 @@
-import { $ as customAction, A as NcTaxonomySchema, At as sleep, B as TIMELAPSE_DENSE_FLOOR_SEC, Bt as string, C as NcRuleSchema, Ct as errMsg, D as NcSnoozeSchema, Dt as hydrateSchema, E as NcSnoozeInputSchema, Et as createEvent, Ft as literal, G as VISIT_MERGE_GAP_MS, H as TimelapseRulePatchSchema, Ht as EventCategory, I as SCENE_DEFAULT_ANCHOR_THRESHOLD, It as number, J as assertTimelapseCadences, K as addonWidgetsSourceCapability, L as SCENE_DEFAULT_UNCOVERED_POLICY, Lt as object, Mt as array, N as RECORDING_EXPORT_MAX_READ_BYTES, Nt as boolean, O as NcSnoozeSuppressedSchema, Ot as isDeviceScopedCap, P as RetrainStatusSchema, Pt as discriminatedUnion, Q as cosineSimilarity$1, R as SCENE_DIVERGED, Rt as partialRecord, S as NcRulePatchSchema, St as zoneAnalyticsCapability, T as NcScheduleSchema, Tt as DeviceType, U as TimelapseRuleSchema, V as TimelapseRuleInputSchema, Vt as unknown, W as TrackSourceSchema, X as audioModeOf, Y as audioMetricsCapability, Z as buildEventKindDescriptor, _ as NC_DEFAULT_SNOOZE_MINUTES, _t as sceneMonitorCapability, a as DEFAULT_EVENT_COLOR, b as NcConditionDescriptorSchema, bt as vectorDimFromBase64, ct as kebabToCamel, d as EVENT_PAD_MS, dt as pickClusterStepModels, et as defineCustomActions, f as FULL_IMAGE_BBOX, ft as pipelineAnalyticsCapability, g as NC_CONDITION_CATALOG, h as NC_ALARM_SYSTEM_EVENT_KINDS, ht as readTimelapseGeneratedAt, i as CLUSTER_MODEL_SCOPED_STEPS, it as faceGalleryCapability, j as OpsLogEntrySchema, jt as _enum, k as NcSystemEventKindSchema, kt as nodePin, l as DeclaredDevices, lt as notificationRulesCapability, m as MACRO_LABELS, mt as readDeviceStateFrom, n as AnalyticsGroupRecordSchema, ot as isDetectionMacroClass, p as LabelAttributionSchema, pt as plateGalleryCapability, q as alarmPanelCapability, r as BaseDevice, rt as encodeVectorBase64, s as DETECTION_MACRO_CLASSES, st as isScheduleActive, t as AnalyticsGroupDetailSchema, tt as deriveRecordingMode, u as EVENT_KIND_BY_CAP, vt as subKindsOf, w as NcRuleTargetSchema, wt as BaseAddon, x as NcRuleInputSchema, xt as videoclipsCapability, y as NC_TAXONOMY, yt as systemEventFilterApplies, z as SceneMonitorSchema, zt as record } from "../dist-CRDS5ykk.mjs";
+import { $ as customAction, A as NcTaxonomySchema, At as sleep, B as TIMELAPSE_DENSE_FLOOR_SEC, Bt as string, C as NcRuleSchema, Ct as errMsg, D as NcSnoozeSchema, Dt as hydrateSchema, E as NcSnoozeInputSchema, Et as createEvent, Ft as literal, G as VISIT_MERGE_GAP_MS, H as TimelapseRulePatchSchema, Ht as EventCategory, I as SCENE_DEFAULT_ANCHOR_THRESHOLD, It as number, J as assertTimelapseCadences, K as addonWidgetsSourceCapability, L as SCENE_DEFAULT_UNCOVERED_POLICY, Lt as object, Mt as array, N as RECORDING_EXPORT_MAX_READ_BYTES, Nt as boolean, O as NcSnoozeSuppressedSchema, Ot as isDeviceScopedCap, P as RetrainStatusSchema, Pt as discriminatedUnion, Q as cosineSimilarity$1, R as SCENE_DIVERGED, Rt as partialRecord, S as NcRulePatchSchema, St as zoneAnalyticsCapability, T as NcScheduleSchema, Tt as DeviceType, U as TimelapseRuleSchema, V as TimelapseRuleInputSchema, Vt as unknown, W as TrackSourceSchema, X as audioModeOf, Y as audioMetricsCapability, Z as buildEventKindDescriptor, _ as NC_DEFAULT_SNOOZE_MINUTES, _t as sceneMonitorCapability, a as DEFAULT_EVENT_COLOR, b as NcConditionDescriptorSchema, bt as vectorDimFromBase64, ct as kebabToCamel, d as EVENT_PAD_MS, dt as pickClusterStepModels, et as defineCustomActions, f as FULL_IMAGE_BBOX, ft as pipelineAnalyticsCapability, g as NC_CONDITION_CATALOG, h as NC_ALARM_SYSTEM_EVENT_KINDS, ht as readTimelapseGeneratedAt, i as CLUSTER_MODEL_SCOPED_STEPS, it as faceGalleryCapability, j as OpsLogEntrySchema, jt as _enum, k as NcSystemEventKindSchema, kt as nodePin, l as DeclaredDevices, lt as notificationRulesCapability, m as MACRO_LABELS, mt as readDeviceStateFrom, n as AnalyticsGroupRecordSchema, ot as isDetectionMacroClass, p as LabelAttributionSchema, pt as plateGalleryCapability, q as alarmPanelCapability, r as BaseDevice, rt as encodeVectorBase64, s as DETECTION_MACRO_CLASSES, st as isScheduleActive, t as AnalyticsGroupDetailSchema, tt as deriveRecordingMode, u as EVENT_KIND_BY_CAP, vt as subKindsOf, w as NcRuleTargetSchema, wt as BaseAddon, x as NcRuleInputSchema, xt as videoclipsCapability, y as NC_TAXONOMY, yt as systemEventFilterApplies, z as SceneMonitorSchema, zt as record } from "../dist-CGhP6T_c.mjs";
 import { t as __exportAll } from "../embedding-encoder/index.mjs";
 import * as fs from "node:fs";
 import { promises } from "node:fs";
@@ -27195,6 +27195,18 @@ var FaceGalleryProvider = class {
 * This module names that state (`model-mismatch`) so the UI can say "this face
 * is in an old feature space" instead of showing 0% and letting the operator
 * conclude the person is not there.
+*
+* ## `buildFaceRescoreReport` stays pure — the CALLER persists
+*
+* This function never touches the store; every input is passed in and nothing
+* is read or written (see its own doc below). The operator asked for this
+* exact recompute, though, and wants the answer to stick — so the ACTION that
+* wraps this report (`rescoreFaceForTrack` in `pipeline-analytics/index.ts`)
+* writes the result onto `Face.suggestedIdentityId` / `suggestedMatchScore`,
+* through `decideRescorePersistence` / `persistRescoreResult` below. That is
+* still not a background job — it is the SAME explicitly-requested call,
+* writing once. A `model-mismatch` report (`comparable: false`) is never
+* written: see `persistRescoreResult`.
 */
 /** The empty report every "cannot score" path returns, so shape never varies. */
 function emptyReport(verdict, input, comparable) {
@@ -27270,6 +27282,52 @@ function buildFaceRescoreReport(input) {
 		...best !== void 0 && second !== void 0 ? { runnerUpGap: best.score - second.score } : {}
 	};
 }
+/**
+* What `face.rescoreTrack` should PERSIST for a COMPARABLE report, decided as
+* its own pure function so the rule is directly testable — separated from the
+* class that owns the store I/O (`rescoreFaceForTrack` in
+* `pipeline-analytics/index.ts`), which only wires this answer to
+* `FaceStore.setSuggestion`.
+*
+* `null` covers every verdict OTHER than `auto-assignable` / `suggestion`, and
+* also an `auto-assignable` / `suggestion` verdict whose best-ranked row is
+* not itself ELIGIBLE (`identities` is ranked by raw score across every
+* comparable identity, eligible or not — see `buildFaceRescoreReport`). Every
+* one of those is a genuine "nothing to suggest right now": never an
+* assignment, and never the winner of an `ambiguous` verdict — the matcher
+* refused to pick one, so this function does not pick one either.
+*
+* Callers MUST gate on `report.comparable` before calling this — a
+* `model-mismatch` report has no verdict worth acting on; see
+* {@link persistRescoreResult}, which does that gating and is the one thing
+* `rescoreFaceForTrack` actually calls.
+*/
+function decideRescorePersistence(report) {
+	if (report.verdict !== "auto-assignable" && report.verdict !== "suggestion") return null;
+	const candidate = report.identities.find((row) => row.eligible);
+	return candidate === void 0 ? null : {
+		identityId: candidate.identityId,
+		score: candidate.score
+	};
+}
+/**
+* Persist `face.rescoreTrack`'s result onto the SUGGESTED tier — the ONE
+* write this explicitly-requested action makes, and the only place that
+* decides whether it happens at all.
+*
+* A non-comparable report (`model-mismatch`) short-circuits BEFORE
+* `ports.setSuggestion` is ever called: a cosine across model spaces is
+* well-formed noise, and persisting it would look exactly like a fresh,
+* meaningful read to every future reader of the row. This is the single most
+* load-bearing branch in this file — the regression it guards against writes
+* garbage that reads as data.
+*/
+async function persistRescoreResult(faceId, report, ports) {
+	if (!report.comparable) return "not-comparable";
+	const candidate = decideRescorePersistence(report);
+	await ports.setSuggestion(faceId, candidate);
+	return candidate !== null ? "written" : "cleared";
+}
 //#endregion
 //#region src/pipeline-analytics/face-rescore-actions.ts
 /**
@@ -27355,9 +27413,12 @@ var FaceReembedReportSchema = object({
 });
 var faceRescoreActions = defineCustomActions({ 
 /**
-* Read-only by default. `admin` because the report names every enrolled
-* person and how well an arbitrary face matches them — the gallery's shape,
-* which is not a viewer-level fact.
+* Persists its own result onto the SUGGESTED tier (`suggestedIdentityId` /
+* `suggestedMatchScore`) — never an assignment, never automatic; see
+* `rescoreFaceForTrack` in `pipeline-analytics/index.ts` and
+* `persistRescoreResult` in `face-rescore.ts`. `admin` because the report
+* also names every enrolled person and how well an arbitrary face matches
+* them — the gallery's shape, which is not a viewer-level fact.
 */
 "face.rescoreTrack": customAction(object({
 	deviceId: number().int(),
@@ -27375,8 +27436,10 @@ var faceRescoreActions = defineCustomActions({
 	/** The face's current assignment, so the UI can mark "already this person". */
 	assigned: boolean(),
 	assignedIdentityId: string().optional(),
-	/** What the track has been SHOWING until now — persisted at detection time.
-	*  Returned so the UI can put the stale number beside the fresh one. */
+	/** What the track has been SHOWING until now — read BEFORE this call
+	*  writes, so it is whatever a previous track close or a previous
+	*  `face.rescoreTrack` last persisted. Returned so the UI can put the stale
+	*  number beside the fresh one. */
 	storedSuggestedIdentityId: string().optional(),
 	storedSuggestedMatchScore: number().optional(),
 	verdict: FaceRescoreVerdictSchema,
@@ -29383,6 +29446,51 @@ var FrameProcessor = class {
 	}
 };
 //#endregion
+//#region src/pipeline-analytics/replay/frame-processor-pass.ts
+/**
+* Run a FRESH `FrameProcessor` over a fixed, ordered sequence of frames and
+* return the tracks it produced.
+*
+* No `TrackStore`, no bus, no media — a track here is a summary built
+* ENTIRELY from `FrameProcessor.process()`'s in-memory return value.
+*/
+function runFrameProcessorPass(input) {
+	const processor = new FrameProcessor(input.deviceId, {}, {}, {}, input.source);
+	if (input.zones !== void 0) processor.setZones(input.zones);
+	if (input.detectionRules !== void 0) processor.setDetectionRules(input.detectionRules);
+	if (input.zoneMembershipMinOverlap !== void 0) processor.setZoneMembershipMinOverlap(input.zoneMembershipMinOverlap);
+	const accum = /* @__PURE__ */ new Map();
+	for (const { timestamp, frame } of input.frames) {
+		const result = processor.process({
+			timestamp,
+			frame
+		});
+		for (const td of result.tracked) {
+			const existing = accum.get(td.trackId);
+			const matched = td.matchedThisFrame ? 1 : 0;
+			if (existing === void 0) accum.set(td.trackId, {
+				className: td.className,
+				firstSeenMs: timestamp,
+				lastSeenMs: timestamp,
+				bbox: { ...td.bbox },
+				framesMatched: matched
+			});
+			else {
+				existing.className = td.className;
+				existing.lastSeenMs = timestamp;
+				existing.framesMatched += matched;
+			}
+		}
+	}
+	return { tracks: [...accum.values()].map((t) => ({
+		className: t.className,
+		firstSeenMs: t.firstSeenMs,
+		lastSeenMs: t.lastSeenMs,
+		bbox: t.bbox,
+		framesMatched: t.framesMatched
+	})) };
+}
+//#endregion
 //#region src/pipeline-analytics/pipeline/semantic-detail-bbox.ts
 /** Which box the semantic best-shot should crop: a plate/face DETAIL box
 *  when we have one, otherwise the subject box. */
@@ -47566,6 +47674,37 @@ var FaceStore = class {
 		}
 	}
 	/**
+	* Persist a `face.rescoreTrack` result onto the SUGGESTED tier — the ONE
+	* write that explicitly-requested action makes. `suggestion: null` means
+	* the recompute found no candidate worth offering and CLEARS both columns
+	* (a genuine "the gallery has nothing for this face right now" result, not
+	* a no-op left at whatever they held before). Never touches `assigned` /
+	* `recognizedIdentityId` — a suggestion is never an assignment. The caller
+	* is responsible for never calling this with a non-comparable (`model-
+	* mismatch`) report; this method persists whatever it is given.
+	*/
+	async setSuggestion(faceId, suggestion) {
+		const data = suggestion === null ? {
+			suggestedIdentityId: null,
+			suggestedMatchScore: null
+		} : {
+			suggestedIdentityId: suggestion.identityId,
+			suggestedMatchScore: suggestion.score
+		};
+		try {
+			await this.store.update.mutate({
+				collection: FACES_COLLECTION,
+				id: faceId,
+				data
+			});
+		} catch (err) {
+			this.logger.warn("FaceStore.setSuggestion failed", { meta: {
+				faceId,
+				error: String(err)
+			} });
+		}
+	}
+	/**
 	* `TrackScopedStore` contract for the retention cascade: delete the buffered
 	* face rows of the given tracks that are NOT assigned. Reuses the EXACT
 	* `assigned` exemption that `prune`/`pruneAll` apply (see the
@@ -60475,6 +60614,21 @@ var PipelineAnalyticsAddon = class PipelineAnalyticsAddon extends BaseAddon {
 			...input.nodeId !== void 0 ? { nodeId: input.nodeId } : {}
 		});
 	}
+	/**
+	* The FrameProcessor pass of a replay run — see the cap doc on
+	* `runReplayFrameProcessor` for why this is not the `processFrame` method
+	* this addon deliberately does not have.
+	*
+	* `runFrameProcessorPass` is pure w.r.t. this addon's own state: it
+	* constructs a FRESH `FrameProcessor` and does not touch `this.trackStore`,
+	* `this.stationaryRegistry` or any other instance field — unlike
+	* `getOrCreateProcessor` (the production path), which wires both.
+	* `scripts/check-replay-isolation.ts` holds that boundary on the
+	* `replay/` directory this delegates into.
+	*/
+	async runReplayFrameProcessor(input) {
+		return runFrameProcessorPass(input);
+	}
 	async listRetrainAnnotations(input) {
 		return this.requireRetrain().listAnnotations(input.trackId);
 	}
@@ -65424,6 +65578,13 @@ var PipelineAnalyticsAddon = class PipelineAnalyticsAddon extends BaseAddon {
 	* See `face-rescore.ts` for why the number already on the track cannot answer
 	* that: it was computed during live detection and persisted at track close,
 	* so every enrolment made since is invisible to it.
+	*
+	* The report's result is PERSISTED (`persistRescoreResult`, below) onto
+	* `Face.suggestedIdentityId` / `suggestedMatchScore` — the SAME columns the
+	* live recognizer's suggestion band writes, so a reader never has to know
+	* whether a suggestion came from track close or from this button. Still
+	* never a background job: this write happens once, only because the
+	* operator asked THIS question right now.
 	*/
 	async rescoreFaceForTrack(input) {
 		const api = this.ctx.api;
@@ -65466,6 +65627,7 @@ var PipelineAnalyticsAddon = class PipelineAnalyticsAddon extends BaseAddon {
 			clusterModelId,
 			params
 		});
+		const persisted = await persistRescoreResult(faceId, report, { setSuggestion: (id, suggestion) => faceStore.setSuggestion(id, suggestion) });
 		this.ctx.logger.info("face rescore", {
 			tags: { deviceId: input.deviceId },
 			meta: {
@@ -65479,7 +65641,8 @@ var PipelineAnalyticsAddon = class PipelineAnalyticsAddon extends BaseAddon {
 				best: report.identities[0]?.name ?? null,
 				bestScore: report.identities[0]?.score ?? null,
 				storedSuggestion: face.suggestedMatchScore ?? null,
-				reembedded: reembed.succeeded
+				reembedded: reembed.succeeded,
+				persisted
 			}
 		});
 		return {

package/dist/pipeline-analytics/remoteEntry.js

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

package/package.json

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