@camstack/addon-post-analysis 1.2.295 → 1.2.297

package/dist/pipeline-analytics/index.js

@@ -2,7 +2,7 @@ Object.defineProperties(exports, {
 	__esModule: { value: true },
 	[Symbol.toStringTag]: { value: "Module" }
 });
-const require_clip_model_registry = require("../clip-model-registry-Dxlc9JV3.js");
+const require_clip_model_registry = require("../clip-model-registry-BTpYUJzK.js");
 let node_fs = require("node:fs");
 node_fs = require_clip_model_registry.__toESM(node_fs, 1);
 let node_path = require("node:path");
@@ -47053,10 +47053,127 @@ function pairRiders(detections) {
 	}
 	return pairs;
 }
+/**
+* Floor on the predictive-drift clamp, in box sides.
+*
+* The scaled term collapses at short intervals — at the 56 ms minimum measured
+* on camera 615 it is 0.11 sides — and a clamp that tight turns ordinary
+* detector box jitter into a refused match. A quarter of a side is slack, not
+* travel.
+*/
+var DRIFT_MIN_SIDES = .25;
+/**
+* Re-acquisition reach, in box DIAGONALS per second.
+*
+* Answers `267840a1` again, on the gate that actually refused it: 908.4 px of
+* centroid travel in 880 ms against a `hypot(513.6, 721.2)` = 885.5 px diagonal
+* is 1.166 diagonals per second. 1.5 clears it with ~29 % margin and is
+* physically bounded — 1.5 of a subject's own body-diagonal per second is a
+* brisk run, and being scale-free it means the same thing for a far-field
+* person with a 90-px box as for a near one with a 900-px box.
+*
+* The number it replaces (`rescueCentroidFactor` 0.75 × diagonal, flat) was
+* doing two jobs at once: at a 2135 ms poll gap it was far too tight to bridge
+* a walking subject, and at a 150 ms burst interval it was loose enough to hand
+* one subject's id to another 452 px away (track `27855a56`, a second car, at
+* IoU 0.058). One number, two opposite failures.
+*/
+var REACH_DIAGONALS_PER_SEC = 1.5;
+/**
+* Floor on the re-acquisition reach, in box diagonals.
+*
+* Deliberately TIGHTER than the 0.75 flat factor it replaces. At a 150 ms burst
+* interval the scaled term is 0.225 diagonals; the floor lifts it to 0.3, which
+* is 221 px on `27855a56`'s 738-px diagonal — comfortably below the 452 px that
+* bought that track a second car. A short gap is evidence that the subject
+* cannot have gone far, and the gate now says so.
+*/
+var REACH_MIN_DIAGONALS = .3;
+/**
+* Ceiling on the re-acquisition reach, in box diagonals.
+*
+* `REACH_DIAGONALS_PER_SEC × BUDGET_CEILING_MS`. A subject unseen for the full
+* `maxMissedMs` gets 1.5 diagonals of reach, not 6.
+*/
+var REACH_MAX_DIAGONALS = 1.5;
+function clampRange(value, min, max) {
+	return Math.max(min, Math.min(max, value));
+}
+/**
+* How far a coasting box's velocity extrapolation may carry it on one axis.
+*
+* `side` is the box's width for the x drift and its height for the y drift, so
+* the allowance keeps the same meaning for a tall person and a wide car.
+*/
+function driftAllowancePx(side, elapsedMs) {
+	const elapsed = Math.max(0, elapsedMs);
+	return clampRange(side * 2 * (elapsed / 1e3), side * DRIFT_MIN_SIDES, side * 2);
+}
+/**
+* How far from where a track is EXPECTED a detection may sit and still be
+* claimed as that track by the loose (rescue / resurrection) reach clause.
+*
+* Scale-free: the budget is a multiple of the track's own diagonal, so it does
+* not have to know the frame size, the camera, or how far away the subject is.
+*/
+function reacquireReachPx(bbox, elapsedMs) {
+	const diag = Math.hypot(bbox.w, bbox.h);
+	const elapsed = Math.max(0, elapsedMs);
+	return clampRange(diag * REACH_DIAGONALS_PER_SEC * (elapsed / 1e3), diag * REACH_MIN_DIAGONALS, diag * REACH_MAX_DIAGONALS);
+}
+/**
+* Resurrection reach, in box DIAGONALS per second of gap (D665).
+*
+* A corpse is reached only after `maxMissedMs` (4 s) without a box, so the
+* rescue rate above — which is at its 1.5-diagonal ceiling by 1 s — says
+* nothing useful here. A subject the detector has not boxed for four seconds
+* is, on this fleet's evidence, one that stood still or stood half-hidden,
+* not one striding across the frame (a striding person is detected): 0.25
+* diagonals per second is a slow walk for a mid-field person and a pause for
+* a near one. At the 4 s floor of the graveyard band it gives 1.0 diagonal;
+* camera 590's refused returns sat at 1.05–1.82× the old flat 0.75 reach,
+* i.e. 0.79–1.37 diagonals, which this covers from about 5.5 s of gap.
+*/
+var RESURRECTION_REACH_DIAGONALS_PER_SEC = .25;
+/** Never tighter than the flat `rescueCentroidFactor` default it replaces. */
+var RESURRECTION_REACH_MIN_DIAGONALS = .75;
+/**
+* How far from a corpse's last box a detection may sit and still resurrect it
+* on the proximity clause, for a corpse last seen `gapMs` ago.
+*/
+function resurrectionReachPx(bbox, gapMs) {
+	const diag = Math.hypot(bbox.w, bbox.h);
+	return clampRange(diag * RESURRECTION_REACH_DIAGONALS_PER_SEC * (Math.max(0, gapMs) / 1e3), diag * RESURRECTION_REACH_MIN_DIAGONALS, diag * 2);
+}
+/**
+* The classes D665's two relaxations are for: the low-score continuation tier
+* and the time-scaled resurrection gate. Defined ONCE, here, and read by both
+* (`low-score-continuation.ts`, `SortTracker.resurrectionTimeScaledFor`),
+* because the argument for each is the same argument about the same subjects
+* (D665, D678).
+*
+* D665 grew the graveyard reach with the gap on the argument that a subject
+* nobody has boxed for more than 4 s stood still or stood half-hidden — true
+* of a person and of an animal, and what the refused returns on camera 590
+* were. A car does not stand half-hidden for ten seconds and then reappear
+* one and a half diagonals away: the next car arrives. Camera 617,
+* 2026-09-28 08:47:32Z: a car at the gate inherited the id of the car that
+* had left the lot 9.85 s earlier, 1.51 diagonals away. A `vehicle` corpse
+* keeps the flat `rescueCentroidFactor` reach and the plausible-birth veto
+* it had before D665 — the same exclusion D665 made for the low-score tier,
+* where a sub-floor box on a parked car beside a passing one is the D410 hop.
+*/
+var LINGERING_SUBJECT_CLASSES = new Set(["person", "animal"]);
+/** Larger area / smaller area; `Infinity` when either box is empty. */
+function boxAreaRatio(a, b) {
+	const areaA = a.w * a.h;
+	const areaB = b.w * b.h;
+	const smaller = Math.min(areaA, areaB);
+	return smaller > 0 ? Math.max(areaA, areaB) / smaller : Number.POSITIVE_INFINITY;
+}
 //#endregion
 //#region src/pipeline-analytics/pipeline/tracker/low-score-continuation.ts
 var LOW_SCORE_CONTINUATION_FLOOR_DEFAULT = .35;
-var LOW_SCORE_CONTINUATION_CLASSES = new Set(["person", "animal"]);
 /** `[x1, y1, x2, y2]` (the discard trail's tuple) → the tracker's rectangle. */
 function toRect(bbox) {
 	const [x1, y1, x2, y2] = bbox;
@@ -47077,7 +47194,7 @@ function selectLowScoreContinuations(discarded, floor) {
 	for (const d of discarded) {
 		if (d.reason !== "below-threshold") continue;
 		if (d.score < floor) continue;
-		if (!LOW_SCORE_CONTINUATION_CLASSES.has(d.macroClass)) continue;
+		if (!LINGERING_SUBJECT_CLASSES.has(d.macroClass)) continue;
 		const bbox = toRect(d.bbox);
 		if (bbox.w <= 0 || bbox.h <= 0) continue;
 		out.push({
@@ -47158,10 +47275,12 @@ function newTrackId() {
 *  the counts are per camera and per detection source. */
 var LooseBindSampler = class {
 	counts = /* @__PURE__ */ new Map();
-	/** Increment the (stage, gate) counter and answer with the running total when
-	*  this decision should be reported, or `undefined` when it is sampled out. */
-	next(stage, gate) {
-		const key = `${stage}|${gate}`;
+	/** Increment the (stage, gate, refusal) counter and answer with the running
+	*  total when this decision should be reported, or `undefined` when it is
+	*  sampled out. The refusal is part of the key so a rare refusal is not
+	*  sampled away behind a frequent one on the same gate. */
+	next(stage, gate, refusal) {
+		const key = `${stage}|${gate}|${refusal ?? ""}`;
 		const count = (this.counts.get(key) ?? 0) + 1;
 		this.counts.set(key, count);
 		if (count === 1 || count % 50 === 0) return count;
@@ -47170,98 +47289,6 @@ var LooseBindSampler = class {
 		this.counts.clear();
 	}
 };
-/**
-* Floor on the predictive-drift clamp, in box sides.
-*
-* The scaled term collapses at short intervals — at the 56 ms minimum measured
-* on camera 615 it is 0.11 sides — and a clamp that tight turns ordinary
-* detector box jitter into a refused match. A quarter of a side is slack, not
-* travel.
-*/
-var DRIFT_MIN_SIDES = .25;
-/**
-* Re-acquisition reach, in box DIAGONALS per second.
-*
-* Answers `267840a1` again, on the gate that actually refused it: 908.4 px of
-* centroid travel in 880 ms against a `hypot(513.6, 721.2)` = 885.5 px diagonal
-* is 1.166 diagonals per second. 1.5 clears it with ~29 % margin and is
-* physically bounded — 1.5 of a subject's own body-diagonal per second is a
-* brisk run, and being scale-free it means the same thing for a far-field
-* person with a 90-px box as for a near one with a 900-px box.
-*
-* The number it replaces (`rescueCentroidFactor` 0.75 × diagonal, flat) was
-* doing two jobs at once: at a 2135 ms poll gap it was far too tight to bridge
-* a walking subject, and at a 150 ms burst interval it was loose enough to hand
-* one subject's id to another 452 px away (track `27855a56`, a second car, at
-* IoU 0.058). One number, two opposite failures.
-*/
-var REACH_DIAGONALS_PER_SEC = 1.5;
-/**
-* Floor on the re-acquisition reach, in box diagonals.
-*
-* Deliberately TIGHTER than the 0.75 flat factor it replaces. At a 150 ms burst
-* interval the scaled term is 0.225 diagonals; the floor lifts it to 0.3, which
-* is 221 px on `27855a56`'s 738-px diagonal — comfortably below the 452 px that
-* bought that track a second car. A short gap is evidence that the subject
-* cannot have gone far, and the gate now says so.
-*/
-var REACH_MIN_DIAGONALS = .3;
-/**
-* Ceiling on the re-acquisition reach, in box diagonals.
-*
-* `REACH_DIAGONALS_PER_SEC × BUDGET_CEILING_MS`. A subject unseen for the full
-* `maxMissedMs` gets 1.5 diagonals of reach, not 6.
-*/
-var REACH_MAX_DIAGONALS = 1.5;
-function clampRange(value, min, max) {
-	return Math.max(min, Math.min(max, value));
-}
-/**
-* How far a coasting box's velocity extrapolation may carry it on one axis.
-*
-* `side` is the box's width for the x drift and its height for the y drift, so
-* the allowance keeps the same meaning for a tall person and a wide car.
-*/
-function driftAllowancePx(side, elapsedMs) {
-	const elapsed = Math.max(0, elapsedMs);
-	return clampRange(side * 2 * (elapsed / 1e3), side * DRIFT_MIN_SIDES, side * 2);
-}
-/**
-* How far from where a track is EXPECTED a detection may sit and still be
-* claimed as that track by the loose (rescue / resurrection) reach clause.
-*
-* Scale-free: the budget is a multiple of the track's own diagonal, so it does
-* not have to know the frame size, the camera, or how far away the subject is.
-*/
-function reacquireReachPx(bbox, elapsedMs) {
-	const diag = Math.hypot(bbox.w, bbox.h);
-	const elapsed = Math.max(0, elapsedMs);
-	return clampRange(diag * REACH_DIAGONALS_PER_SEC * (elapsed / 1e3), diag * REACH_MIN_DIAGONALS, diag * REACH_MAX_DIAGONALS);
-}
-/**
-* Resurrection reach, in box DIAGONALS per second of gap (D665).
-*
-* A corpse is reached only after `maxMissedMs` (4 s) without a box, so the
-* rescue rate above — which is at its 1.5-diagonal ceiling by 1 s — says
-* nothing useful here. A subject the detector has not boxed for four seconds
-* is, on this fleet's evidence, one that stood still or stood half-hidden,
-* not one striding across the frame (a striding person is detected): 0.25
-* diagonals per second is a slow walk for a mid-field person and a pause for
-* a near one. At the 4 s floor of the graveyard band it gives 1.0 diagonal;
-* camera 590's refused returns sat at 1.05–1.82× the old flat 0.75 reach,
-* i.e. 0.79–1.37 diagonals, which this covers from about 5.5 s of gap.
-*/
-var RESURRECTION_REACH_DIAGONALS_PER_SEC = .25;
-/** Never tighter than the flat `rescueCentroidFactor` default it replaces. */
-var RESURRECTION_REACH_MIN_DIAGONALS = .75;
-/**
-* How far from a corpse's last box a detection may sit and still resurrect it
-* on the proximity clause, for a corpse last seen `gapMs` ago.
-*/
-function resurrectionReachPx(bbox, gapMs) {
-	const diag = Math.hypot(bbox.w, bbox.h);
-	return clampRange(diag * RESURRECTION_REACH_DIAGONALS_PER_SEC * (Math.max(0, gapMs) / 1e3), diag * RESURRECTION_REACH_MIN_DIAGONALS, diag * 2);
-}
 //#endregion
 //#region src/pipeline-analytics/pipeline/tracker/rescue-growth.ts
 /**
@@ -47714,10 +47741,10 @@ var SortTracker = class SortTracker {
 	}
 	/** Emit one salvage decision, subject to {@link LOOSE_BIND_LOG_SAMPLE_EVERY}.
 	*  Nothing is computed when no observer is wired. */
-	reportBind(stage, gate, track, det, timestamp) {
+	reportBind(stage, gate, track, det, timestamp, refusal) {
 		const observer = this.bindObserver;
 		if (!observer) return;
-		const bindCount = this.bindSampler.next(stage, gate);
+		const bindCount = this.bindSampler.next(stage, gate, refusal);
 		if (bindCount === void 0) return;
 		const tc = bboxCentroid(track.bbox);
 		const dc = bboxCentroid(det.bbox);
@@ -47751,6 +47778,7 @@ var SortTracker = class SortTracker {
 			frameHeight: this.frameHeightPx,
 			dtMs: timestamp - track.lastSeen,
 			trackAgeMs: timestamp - track.firstSeen,
+			...refusal !== void 0 ? { refusal } : {},
 			bindCount,
 			sampledEvery: 50
 		});
@@ -48091,15 +48119,45 @@ var SortTracker = class SortTracker {
 	* was written for; not of the pass as it runs: on camera 590 (2026-09-27)
 	* 38% of all re-splits were PEOPLE returning after 4–12 s, further than the
 	* flat gate, with frames flowing the whole time. `resurrectionTimeScaled`
-	* off restores the flat gate.
+	* off restores the flat gate — and a `vehicle` corpse always has it (D678,
+	* {@link resurrectionTimeScaledFor}).
 	*/
 	reacquireReach(track, timestamp, pass) {
 		const diag = Math.hypot(track.bbox.w, track.bbox.h);
-		if (pass === "resurrection") return this.config.resurrectionTimeScaled ? resurrectionReachPx(track.bbox, timestamp - track.lastSeen) : this.config.rescueCentroidFactor * diag;
+		if (pass === "resurrection") return this.resurrectionTimeScaledFor(track.class) ? resurrectionReachPx(track.bbox, timestamp - track.lastSeen) : this.config.rescueCentroidFactor * diag;
 		if (!this.config.reacquireTimeScaled) return this.config.rescueCentroidFactor * diag;
 		return reacquireReachPx(track.bbox, timestamp - track.lastSeen);
 	}
 	/**
+	* Whether D665's graveyard gate — the reach that grows with the gap, and the
+	* plausible-birth veto lifted for a sole subject — applies to a corpse of
+	* `cls`. People and animals only (D678): a car gone for ten seconds did not
+	* stand half-hidden, the next one arrived.
+	*/
+	resurrectionTimeScaledFor(cls) {
+		return this.config.resurrectionTimeScaled && LINGERING_SUBJECT_CLASSES.has(cls);
+	}
+	/**
+	* The size check a PROXIMITY-only resurrection needs (D678), for a pair the
+	* loose gate accepted on its `centroid` clause and the plausible-birth veto
+	* let through.
+	*
+	* The `centroid` clause says where a box is and nothing about what it is;
+	* a box more than {@link RESURRECTION_MAX_AREA_RATIO} larger or smaller than
+	* the corpse's last box is refused on it, and the refusal is returned so the
+	* caller can name it. The pair may still bind on `growth`, the partial-crop
+	* rule whose whole subject IS a size change and which `looseMatch` would
+	* have reached had the centroid clause not answered first. With the default
+	* coast budget that never happens — `growth` refuses a pair more than
+	* `GROWTH_MAX_GAP_MS` (1 s) apart and a corpse has been unseen for
+	* `maxMissedMs` (4 s) — but `maxMissedMs` is a per-camera setting down to 0.
+	*/
+	proximitySizeVerdict(corpse, det, timestamp) {
+		if (boxAreaRatio(corpse.bbox, det.bbox) <= 2.5) return "centroid";
+		if (growthAdjacentMatch(corpse.bbox, det.bbox, this.growthContext(corpse, timestamp))) return "growth";
+		return "size-incompatible";
+	}
+	/**
 	* Whether a REACH bind would be unambiguous: this coasting track is the only
 	* subject of its association group the scene holds, and `det` is the only box
 	* of that group on the frame.
@@ -48513,13 +48571,26 @@ var SortTracker = class SortTracker {
 			let refused;
 			let refusedGate = "iou";
 			let refusedScore = -1;
+			let refusedBy = "crowd-guard";
 			for (const lost of this.lostTracks) {
 				if (!lost.resurrectable) continue;
 				if (timestamp - lost.lostAt > this.config.resurrectionWindowMs) continue;
-				const gate = this.looseMatch(lost, det, timestamp, "resurrection");
-				if (gate === null) continue;
-				const vetoLifted = gate === "centroid" && this.isPlausibleBirth(det, frameArea);
-				if (vetoLifted && !(this.config.resurrectionTimeScaled && this.isSoleSubjectResurrection(lost, det, detections, surviving, lowScore))) continue;
+				const loose = this.looseMatch(lost, det, timestamp, "resurrection");
+				if (loose === null) continue;
+				const vetoApplies = loose === "centroid" && this.isPlausibleBirth(det, frameArea);
+				if (vetoApplies && !(this.resurrectionTimeScaledFor(lost.class) && this.isSoleSubjectResurrection(lost, det, detections, surviving, lowScore))) continue;
+				const gate = loose === "centroid" ? this.proximitySizeVerdict(lost, det, timestamp) : loose;
+				if (gate === "size-incompatible") {
+					const score = iou$2(lost.bbox, det.bbox);
+					if (score > refusedScore) {
+						refused = lost;
+						refusedGate = "centroid";
+						refusedScore = score;
+						refusedBy = "size-incompatible";
+					}
+					continue;
+				}
+				const vetoLifted = vetoApplies && gate === "centroid";
 				const score = iou$2(lost.bbox, det.bbox);
 				const peers = this.sameClassPeerCount(lost, surviving);
 				if (this.config.resurrectionCrowdGuard && peers > 0 && score < this.config.resurrectionCrowdedIouThreshold) {
@@ -48527,6 +48598,7 @@ var SortTracker = class SortTracker {
 						refused = lost;
 						refusedGate = gate;
 						refusedScore = score;
+						refusedBy = "crowd-guard";
 					}
 					continue;
 				}
@@ -48539,7 +48611,7 @@ var SortTracker = class SortTracker {
 				}
 			}
 			if (!best) {
-				if (refused !== void 0) this.reportBind("resurrection-refused", refusedGate, refused, det, timestamp);
+				if (refused !== void 0) this.reportBind("resurrection-refused", refusedGate, refused, det, timestamp, refusedBy);
 				continue;
 			}
 			resurrectedScene.set(best, bestPeers > 0 ? "multi-subject" : bestVetoLifted ? "sole-subject-veto-lifted" : "sole-subject");
@@ -53218,6 +53290,17 @@ var MOTION_COLUMNS = [
 	{
 		name: "edges",
 		type: "TEXT"
+	}),
+	(
+	/**
+	* The first trigger of an ONBOARD episode (D672), JSON `{kind:'camera'} |
+	* {kind:'sensor',deviceId}`. Declared, or the backend drops it on write (see
+	* `durationMs`). Additive: the collection gains the column in place. Absent on
+	* a legacy / analyzer / device-activity row means NOT RECORDED.
+	*/
+	{
+		name: "triggeredBy",
+		type: "JSON"
 	})
 ];
 var OBJECT_COLUMNS = [
@@ -53353,7 +53436,8 @@ var AUDIO_COLUMNS = [
 var SLIM_MOTION_COLUMNS = [
 	"deviceId",
 	"timestamp",
-	"regionCount"
+	"regionCount",
+	"triggeredBy"
 ];
 /**
 * The columns `slimObject` reads — and ONLY those.
@@ -53706,13 +53790,14 @@ var EventStore = class {
 		});
 		if (q.projection === "slim") return rows.map((r) => slimMotion(Number(r.id), stripNulls$1(r.data)));
 		return rows.map((r) => {
-			const { edges: rawEdges, durationMs: rawDurationMs, ...data } = stripNulls$1(r.data);
+			const { edges: rawEdges, durationMs: rawDurationMs, triggeredBy: rawTriggeredBy, ...data } = stripNulls$1(r.data);
 			return {
 				id: Number(r.id),
 				kind: "motion",
 				...data,
 				...rawDurationMs !== void 0 ? { durationMs: rawDurationMs === OPEN_EPISODE_SENTINEL ? null : rawDurationMs } : {},
-				...rawEdges !== void 0 ? { edges: decodeMotionEdges(rawEdges) } : {}
+				...rawEdges !== void 0 ? { edges: decodeMotionEdges(rawEdges) } : {},
+				...storedTriggeredBy(rawTriggeredBy)
 			};
 		});
 	}
@@ -54432,13 +54517,20 @@ var EventStore = class {
 		}];
 	}
 };
+/** A stored trigger that parses, or nothing — never a guessed camera (D393). */
+function storedTriggeredBy(raw) {
+	if (raw === void 0) return {};
+	const parsed = require_clip_model_registry.MotionTriggeredBySchema.safeParse(raw);
+	return parsed.success ? { triggeredBy: parsed.data } : {};
+}
 function slimMotion(id, data) {
 	return {
 		id,
 		kind: "motion",
 		deviceId: data["deviceId"],
 		timestamp: data["timestamp"],
-		regionCount: data["regionCount"]
+		regionCount: data["regionCount"],
+		...storedTriggeredBy(data["triggeredBy"])
 	};
 }
 function slimObject(id, data) {
@@ -95472,6 +95564,11 @@ var PipelineAnalyticsAddon = class PipelineAnalyticsAddon extends require_clip_m
 		});
 		const regions = payload.regions ?? [];
 		if (detected) this.eventStore?.noteMotionSample(deviceId, regions.length, timestamp);
+		const provenance = payload.source === "onboard" ? require_clip_model_registry.readMotionTriggeredBy(payload.triggeredBy) : null;
+		if (detected && provenance?.malformed === true) this.ctx.logger.warn("onboard motion: triggeredBy malformed — read as the camera", {
+			tags: { deviceId },
+			meta: { triggeredBy: payload.triggeredBy }
+		});
 		await this.motionEpisodes?.observe(deviceId, payload.source, detected, timestamp, {
 			regionCount: regions.length,
 			regions: regions.map((r) => ({
@@ -95485,7 +95582,8 @@ var PipelineAnalyticsAddon = class PipelineAnalyticsAddon extends require_clip_m
 				intensity: r.intensity
 			})),
 			frameWidth: 0,
-			frameHeight: 0
+			frameHeight: 0,
+			...provenance !== null ? { triggeredBy: provenance.triggeredBy } : {}
 		});
 	}
 	/**