@camstack/addon-post-analysis 1.2.177 → 1.2.179

package/dist/{dist-B1cFmGC0.mjs → dist-NBkMwEZ0.mjs}

@@ -13236,6 +13236,24 @@ method(_void(), _void(), { kind: "mutation" }), method(_void(), _void(), { kind:
 	kind: "mutation",
 	auth: "admin"
 });
+/**
+* Device Manager capability — hub-side singleton that unifies device persistence,
+* live registry access, and all management operations into a single tRPC surface.
+*
+* Replaces:
+*   - `device-persistence` capability (persistence methods absorbed here)
+*   - `device-management.router.ts` (deleted in Phase 2)
+*   - `device-ops.router.ts` (compat layer — deleted; device-provider ops absorbed here)
+*
+* All device provider addons (rtsp, onvif, frigate, …) are hub-local: they may
+* fork into separate processes but never run on remote cluster agents. Therefore:
+*   - No nodeId routing needed — this is a pure hub singleton.
+*   - The hub's DeviceRegistry is the single source of truth for all live devices.
+*   - No shadow registry or cross-node aggregation required.
+*
+* Forked workers register devices back to the hub via `ctx.devices`
+* (DeviceManagerApi → ctx.api.deviceManager.registerDevice), same as today.
+*/
 /** One child-placement directive on a container's `childLayout`. Structurally
 *  identical to `ChildLayoutEntry` in `device-management.ts` — the cap wire
 *  shape for the same field. The child is identified by its re-sync-stable
@@ -19626,6 +19644,9 @@ var RetrainStatusSchema = _enum([
 *
 * `debug` does NOT pin; it is attention, not durability.
 *
+* `debugNote` is the operator's own words about WHAT should be checked on this
+* track, and it lives and dies with `debug` — see {@link MAX_TRACK_DEBUG_NOTE_LEN}.
+*
 * `favourited` IS a BOOLEAN pin (durability bit), not a retrain lifecycle.
 * A favourited track is skipped by retention the same way `staging` is, but
 * it does not enter `none|staging|trained` and has no staging budget.
@@ -19636,6 +19657,21 @@ var TrackFlagFields = {
 	markForTrain: boolean().optional(),
 	/** Operator marked this track for diagnostic attention. */
 	debug: boolean().optional(),
+	/**
+	* What the operator wants CHECKED on this track, in their own words.
+	*
+	* The flag alone says "look at this" and nothing about what for; a debug set
+	* reviewed hours later is a list of tracks with no question attached. Bound
+	* to `debug` on the WRITE side — the body clears it when `debug` goes off,
+	* and refuses it on a track whose debug is off — so a note can never outlive
+	* the attention it belongs to.
+	*
+	* `''` is a real value ("marked, nothing to add"); the ABSENT key means
+	* "leave whatever is stored alone", which is what lets a surface turn debug
+	* on without a note (a cancelled prompt) and what lets it edit the note
+	* without touching the flag.
+	*/
+	debugNote: string().max(500).optional(),
 	/** Operator favourited this track. Pins it against pruning. */
 	favourited: boolean().optional()
 };
@@ -19662,6 +19698,12 @@ var TrackFlagsSchema = object({
 	trackId: string(),
 	markForTrain: boolean(),
 	debug: boolean(),
+	/** The note as it STANDS after the write — never absent here (a track with no
+	*  note reports `''`), for the same reason the booleans are required: a
+	*  surface that has just written must be able to render the note it now owns
+	*  without a re-fetch, and an absent key would read as "unchanged" on a
+	*  screen that has no previous value to keep. */
+	debugNote: string(),
 	favourited: boolean(),
 	/** The lifecycle state the boolean was derived from. Required here (unlike on
 	*  a track row) because this shape is only ever produced by the write body,
@@ -20954,11 +20996,20 @@ var pipelineAnalyticsCapability = {
 		* staging is a deliberate action of the retrain page, which is also the only
 		* thing that produces `trained` in the first place.
 		*
-		* Returns the RESOLVED state of both flags (absent → `false`) plus the
-		* `retrainStatus` they were derived from, so a caller can drive its toggle
-		* — and render a `trained` badge — without a re-fetch. Rejects an unknown
-		* track, a new staging mark on a device already holding its full budget, and
-		* any `markForTrain` write against a trained track.
+		* `debugNote` is the operator's sentence about WHAT to check on this track,
+		* and it is bound to `debug`: writing `debug: false` clears it in the same
+		* statement, and a note sent for a track whose debug is off (and is not
+		* being turned on) is DROPPED with a warning rather than stored where
+		* nothing will ever read it. An omitted `debugNote` leaves the stored one
+		* alone — which is what lets a surface turn debug on when the operator
+		* declined to type anything, without that refusal costing them the flag.
+		*
+		* Returns the RESOLVED state of all three flags (absent → `false`) plus the
+		* note (absent → `''`) and the `retrainStatus` they were derived from, so a
+		* caller can drive its toggle — and render a `trained` badge — without a
+		* re-fetch. Rejects an unknown track, a new staging mark on a device already
+		* holding its full budget, and any `markForTrain` write against a trained
+		* track.
 		*/
 		setTrackFlags: method(object({
 			/** Log/audit scope only — the trackId is globally unique on its own. */

package/dist/{dist-BfdKgU7-.js → dist-QJ8XSy0F.js}

@@ -13267,6 +13267,24 @@ method(_void(), _void(), { kind: "mutation" }), method(_void(), _void(), { kind:
 	kind: "mutation",
 	auth: "admin"
 });
+/**
+* Device Manager capability — hub-side singleton that unifies device persistence,
+* live registry access, and all management operations into a single tRPC surface.
+*
+* Replaces:
+*   - `device-persistence` capability (persistence methods absorbed here)
+*   - `device-management.router.ts` (deleted in Phase 2)
+*   - `device-ops.router.ts` (compat layer — deleted; device-provider ops absorbed here)
+*
+* All device provider addons (rtsp, onvif, frigate, …) are hub-local: they may
+* fork into separate processes but never run on remote cluster agents. Therefore:
+*   - No nodeId routing needed — this is a pure hub singleton.
+*   - The hub's DeviceRegistry is the single source of truth for all live devices.
+*   - No shadow registry or cross-node aggregation required.
+*
+* Forked workers register devices back to the hub via `ctx.devices`
+* (DeviceManagerApi → ctx.api.deviceManager.registerDevice), same as today.
+*/
 /** One child-placement directive on a container's `childLayout`. Structurally
 *  identical to `ChildLayoutEntry` in `device-management.ts` — the cap wire
 *  shape for the same field. The child is identified by its re-sync-stable
@@ -19657,6 +19675,9 @@ var RetrainStatusSchema = _enum([
 *
 * `debug` does NOT pin; it is attention, not durability.
 *
+* `debugNote` is the operator's own words about WHAT should be checked on this
+* track, and it lives and dies with `debug` — see {@link MAX_TRACK_DEBUG_NOTE_LEN}.
+*
 * `favourited` IS a BOOLEAN pin (durability bit), not a retrain lifecycle.
 * A favourited track is skipped by retention the same way `staging` is, but
 * it does not enter `none|staging|trained` and has no staging budget.
@@ -19667,6 +19688,21 @@ var TrackFlagFields = {
 	markForTrain: boolean().optional(),
 	/** Operator marked this track for diagnostic attention. */
 	debug: boolean().optional(),
+	/**
+	* What the operator wants CHECKED on this track, in their own words.
+	*
+	* The flag alone says "look at this" and nothing about what for; a debug set
+	* reviewed hours later is a list of tracks with no question attached. Bound
+	* to `debug` on the WRITE side — the body clears it when `debug` goes off,
+	* and refuses it on a track whose debug is off — so a note can never outlive
+	* the attention it belongs to.
+	*
+	* `''` is a real value ("marked, nothing to add"); the ABSENT key means
+	* "leave whatever is stored alone", which is what lets a surface turn debug
+	* on without a note (a cancelled prompt) and what lets it edit the note
+	* without touching the flag.
+	*/
+	debugNote: string().max(500).optional(),
 	/** Operator favourited this track. Pins it against pruning. */
 	favourited: boolean().optional()
 };
@@ -19693,6 +19729,12 @@ var TrackFlagsSchema = object({
 	trackId: string(),
 	markForTrain: boolean(),
 	debug: boolean(),
+	/** The note as it STANDS after the write — never absent here (a track with no
+	*  note reports `''`), for the same reason the booleans are required: a
+	*  surface that has just written must be able to render the note it now owns
+	*  without a re-fetch, and an absent key would read as "unchanged" on a
+	*  screen that has no previous value to keep. */
+	debugNote: string(),
 	favourited: boolean(),
 	/** The lifecycle state the boolean was derived from. Required here (unlike on
 	*  a track row) because this shape is only ever produced by the write body,
@@ -20985,11 +21027,20 @@ var pipelineAnalyticsCapability = {
 		* staging is a deliberate action of the retrain page, which is also the only
 		* thing that produces `trained` in the first place.
 		*
-		* Returns the RESOLVED state of both flags (absent → `false`) plus the
-		* `retrainStatus` they were derived from, so a caller can drive its toggle
-		* — and render a `trained` badge — without a re-fetch. Rejects an unknown
-		* track, a new staging mark on a device already holding its full budget, and
-		* any `markForTrain` write against a trained track.
+		* `debugNote` is the operator's sentence about WHAT to check on this track,
+		* and it is bound to `debug`: writing `debug: false` clears it in the same
+		* statement, and a note sent for a track whose debug is off (and is not
+		* being turned on) is DROPPED with a warning rather than stored where
+		* nothing will ever read it. An omitted `debugNote` leaves the stored one
+		* alone — which is what lets a surface turn debug on when the operator
+		* declined to type anything, without that refusal costing them the flag.
+		*
+		* Returns the RESOLVED state of all three flags (absent → `false`) plus the
+		* note (absent → `''`) and the `retrainStatus` they were derived from, so a
+		* caller can drive its toggle — and render a `trained` badge — without a
+		* re-fetch. Rejects an unknown track, a new staging mark on a device already
+		* holding its full budget, and any `markForTrain` write against a trained
+		* track.
 		*/
 		setTrackFlags: method(object({
 			/** Log/audit scope only — the trackId is globally unique on its own. */

package/dist/embedding-encoder/index.js

@@ -2,7 +2,7 @@ Object.defineProperties(exports, {
 	__esModule: { value: true },
 	[Symbol.toStringTag]: { value: "Module" }
 });
-const require_dist = require("../dist-BfdKgU7-.js");
+const require_dist = require("../dist-QJ8XSy0F.js");
 let node_fs = require("node:fs");
 node_fs = require_dist.__toESM(node_fs);
 let node_path = require("node:path");

package/dist/embedding-encoder/index.mjs

@@ -1,4 +1,4 @@
-import { At as BaseAddon, F as PoolMemoryWatchdog, St as resolvePoolMemoryPolicy, at as embeddingEncoderCapability, gt as parseProcStatus, ut as hfModelUrl } from "../dist-B1cFmGC0.mjs";
+import { At as BaseAddon, F as PoolMemoryWatchdog, St as resolvePoolMemoryPolicy, at as embeddingEncoderCapability, gt as parseProcStatus, ut as hfModelUrl } from "../dist-NBkMwEZ0.mjs";
 import { createRequire } from "node:module";
 import * as fs from "node:fs";
 import * as path$1 from "node:path";

package/dist/pipeline-analytics/{_virtual_mf-localSharedImportMap___mfe_internal__addon_pipeline_analytics_widgets-MvTzBID6.mjs → _virtual_mf-localSharedImportMap___mfe_internal__addon_pipeline_analytics_widgets-BL6jNwq1.mjs}

@@ -3,7 +3,7 @@ import "./dist-CYZr2fwk.mjs";
 var e = {
 	"@camstack/sdk": {
 		name: "@camstack/sdk",
-		version: "1.2.66",
+		version: "1.2.67",
 		scope: ["default"],
 		loaded: !1,
 		from: "addon_pipeline_analytics_widgets",
@@ -18,7 +18,7 @@ var e = {
 	},
 	"@camstack/types": {
 		name: "@camstack/types",
-		version: "1.2.146",
+		version: "1.2.147",
 		scope: ["default"],
 		loaded: !1,
 		from: "addon_pipeline_analytics_widgets",
@@ -33,7 +33,7 @@ var e = {
 	},
 	"@camstack/ui-library": {
 		name: "@camstack/ui-library",
-		version: "1.2.112",
+		version: "1.2.113",
 		scope: ["default"],
 		loaded: !1,
 		from: "addon_pipeline_analytics_widgets",

package/dist/pipeline-analytics/{hostInit-DhLjhqAY.mjs → hostInit-z4IKWrJu.mjs}

@@ -36,7 +36,7 @@ async function r() {
 				}
 			},
 			"@camstack/types": {
-				version: "1.2.146",
+				version: "1.2.147",
 				scope: "default",
 				shareConfig: {
 					singleton: !0,
@@ -45,7 +45,7 @@ async function r() {
 				}
 			},
 			"@camstack/sdk": {
-				version: "1.2.66",
+				version: "1.2.67",
 				scope: "default",
 				shareConfig: {
 					singleton: !0,
@@ -81,7 +81,7 @@ async function r() {
 				}
 			},
 			"@camstack/ui-library": {
-				version: "1.2.112",
+				version: "1.2.113",
 				scope: "default",
 				shareConfig: {
 					singleton: !0,

package/dist/pipeline-analytics/index.js

@@ -2,7 +2,7 @@ Object.defineProperties(exports, {
 	__esModule: { value: true },
 	[Symbol.toStringTag]: { value: "Module" }
 });
-const require_dist = require("../dist-BfdKgU7-.js");
+const require_dist = require("../dist-QJ8XSy0F.js");
 let node_fs = require("node:fs");
 node_fs = require_dist.__toESM(node_fs, 1);
 let node_path = require("node:path");
@@ -35839,16 +35839,43 @@ function positionsIntersectZone(positions, frameWidth, frameHeight, zone) {
 	}, zone.points)) return true;
 	return false;
 }
+//#endregion
+//#region src/pipeline-analytics/track-lifecycle.ts
+/** Minimum confidence increase (vs last emit) that counts as a material
+*  improvement. */
+var UPDATE_MIN_CONF_DELTA = .1;
+/** Debounce floor between two `update` emits for the same track (ms). */
+var UPDATE_MIN_INTERVAL_MS = 4e3;
+/** Minimum fractional bbox-area growth (vs last emit) counted as a
+*  materially larger representative crop (e.g. 0.15 = 15% bigger). */
+var UPDATE_MIN_CROP_AREA_GROWTH = .15;
+/**
+* The label a `phase:'update'` SIGNAL and PAYLOAD carry, resolved from its
+* two possible sources in order: this frame's tiered patch (the frame path
+* wrote a label this very frame), then the track ROW's stored display label
+* (`subLabel ?? label`, as `trackStore.peekActive` exposes it).
+*
+* The fallback is not a nicety. The face recognizer assigns an identity over
+* the async detail plane and writes it to the row (`applyLabelCandidate`) —
+* never into a frame patch — so a signal reading only the patch can never
+* fire the identity trigger for a recognised face. Measured on the live hub
+* (2026-09-05, device 590): six of six face identities reached Home
+* Assistant only on the `end` event at track close + sweep (~lastSeen+33 s),
+* zero during the track's life, while the subject was still on camera.
+*/
+function resolveLifecycleUpdateLabel(labelPatch, storedDisplayLabel) {
+	return patchDisplayLabel(labelPatch) ?? storedDisplayLabel;
+}
 var DEFAULT_UPDATE_GATE_CONFIG = {
-	minConfDelta: .1,
-	minIntervalMs: 4e3,
-	minCropAreaGrowth: .15
+	minConfDelta: UPDATE_MIN_CONF_DELTA,
+	minIntervalMs: UPDATE_MIN_INTERVAL_MS,
+	minCropAreaGrowth: UPDATE_MIN_CROP_AREA_GROWTH
 };
 /**
 * Decide whether a `phase:'update'` event should fire this frame.
 *
 * Priority of triggers: newly-resolved identity/plate > confidence
-* improvement > materially larger crop. All triggers are debounced by
+* improvement > newly-entered zone > materially larger crop. All triggers are debounced by
 * `minIntervalMs` relative to the last emit. Deltas are measured against
 * the LAST-EMITTED memory, so a run of sub-threshold new-bests accumulates
 * and fires once it crosses `minConfDelta`.
@@ -35856,22 +35883,32 @@ var DEFAULT_UPDATE_GATE_CONFIG = {
 function evaluateTrackLifecycleUpdate(signal, memory, config) {
 	const identityTrigger = signal.label !== void 0 && signal.label !== "" && (memory === void 0 || memory.lastLabel !== signal.label);
 	const confidenceTrigger = signal.isNewBest && (memory === void 0 || signal.confidence - memory.lastConfidence >= config.minConfDelta);
+	const zoneTrigger = signal.zonesVisitedCount !== void 0 && memory?.lastZonesVisitedCount !== void 0 && signal.zonesVisitedCount > memory.lastZonesVisitedCount;
 	const cropTrigger = signal.bboxArea !== void 0 && memory?.lastBboxArea !== void 0 && memory.lastBboxArea > 0 && signal.bboxArea >= memory.lastBboxArea * (1 + config.minCropAreaGrowth);
-	const reason = identityTrigger ? "identity" : confidenceTrigger ? "confidence" : cropTrigger ? "crop" : void 0;
-	const keptMemory = memory ?? {
+	const reason = identityTrigger ? "identity" : confidenceTrigger ? "confidence" : zoneTrigger ? "zone" : cropTrigger ? "crop" : void 0;
+	const keptMemory = memory === void 0 ? {
 		lastConfidence: signal.confidence,
-		lastEmitAt: signal.now
-	};
+		lastEmitAt: signal.now,
+		...signal.zonesVisitedCount !== void 0 ? { lastZonesVisitedCount: signal.zonesVisitedCount } : {}
+	} : memory.lastZonesVisitedCount === void 0 && signal.zonesVisitedCount !== void 0 ? {
+		...memory,
+		lastZonesVisitedCount: signal.zonesVisitedCount
+	} : memory;
 	if (reason === void 0) return {
 		emit: false,
 		memory: keptMemory
 	};
 	if (memory !== void 0 && signal.now - memory.lastEmitAt < config.minIntervalMs) return {
 		emit: false,
-		memory
+		suppressed: reason,
+		memory: {
+			...keptMemory,
+			suppressedSinceEmit: (keptMemory.suppressedSinceEmit ?? 0) + 1
+		}
 	};
 	const nextLabel = signal.label ?? memory?.lastLabel;
 	const nextBboxArea = signal.bboxArea ?? memory?.lastBboxArea;
+	const nextZonesCount = signal.zonesVisitedCount ?? memory?.lastZonesVisitedCount;
 	return {
 		emit: true,
 		reason,
@@ -35879,7 +35916,8 @@ function evaluateTrackLifecycleUpdate(signal, memory, config) {
 			lastConfidence: memory === void 0 ? signal.confidence : Math.max(memory.lastConfidence, signal.confidence),
 			lastEmitAt: signal.now,
 			...nextLabel !== void 0 ? { lastLabel: nextLabel } : {},
-			...nextBboxArea !== void 0 ? { lastBboxArea: nextBboxArea } : {}
+			...nextBboxArea !== void 0 ? { lastBboxArea: nextBboxArea } : {},
+			...nextZonesCount !== void 0 ? { lastZonesVisitedCount: nextZonesCount } : {}
 		}
 	};
 }
@@ -39490,6 +39528,10 @@ var TRACKS_COLUMNS = [
 		name: "debug",
 		type: "BOOLEAN"
 	},
+	{
+		name: "debugNote",
+		type: "TEXT"
+	},
 	{
 		name: "favourited",
 		type: "BOOLEAN"
@@ -39685,6 +39727,7 @@ function cloneTrack(t) {
 			markForTrain: t.retrainStatus === "staging"
 		} : {},
 		...t.debug !== void 0 ? { debug: t.debug } : {},
+		...t.debugNote !== void 0 ? { debugNote: t.debugNote } : {},
 		...t.favourited !== void 0 ? { favourited: t.favourited } : {},
 		...t.hasFace !== void 0 ? { hasFace: t.hasFace } : {},
 		...t.hasEmbeddedFace !== void 0 ? { hasEmbeddedFace: t.hasEmbeddedFace } : {},
@@ -39921,7 +39964,8 @@ var TrackStore = class {
 	* Cheap read of an active track's promotion-relevant fields WITHOUT the deep
 	* clone `getActiveByTrack` does — the returned `positions` is the live
 	* internal array (read-only; callers must not mutate). Feeds the per-frame
-	* stationary-promotion check, called at inference fps. Null if unknown/expired.
+	* stationary-promotion check AND the lifecycle update gate, both called at
+	* inference fps. Null if unknown/expired.
 	*/
 	peekActive(trackId) {
 		const t = this.active.get(trackId);
@@ -39929,6 +39973,7 @@ var TrackStore = class {
 		return {
 			firstSeen: t.firstSeen,
 			positions: t.positions,
+			zonesVisitedCount: t.zonesVisited.length,
 			...displayLabel(t) !== void 0 ? { label: displayLabel(t) } : {}
 		};
 	}
@@ -40073,12 +40118,14 @@ var TrackStore = class {
 		const nextStatus = patch.markForTrain === void 0 ? void 0 : patch.markForTrain ? "staging" : "none";
 		if (nextStatus !== void 0) data["retrainStatus"] = nextStatus;
 		if (patch.debug !== void 0) data["debug"] = patch.debug;
+		if (patch.debugNote !== void 0) data["debugNote"] = patch.debugNote;
 		if (patch.favourited !== void 0) data["favourited"] = patch.favourited;
 		if (Object.keys(data).length === 0) return;
 		const active = this.active.get(trackId);
 		if (active) {
 			if (nextStatus !== void 0) active.retrainStatus = nextStatus;
 			if (patch.debug !== void 0) active.debug = patch.debug;
+			if (patch.debugNote !== void 0) active.debugNote = patch.debugNote;
 			if (patch.favourited !== void 0) active.favourited = patch.favourited;
 		}
 		try {
@@ -40281,6 +40328,7 @@ var TrackStore = class {
 		if (active) return {
 			retrainStatus: active.retrainStatus ?? "none",
 			debug: active.debug === true,
+			debugNote: active.debugNote ?? "",
 			favourited: active.favourited === true
 		};
 		const persisted = await this.getPersistedByTrackId(trackId);
@@ -40288,6 +40336,7 @@ var TrackStore = class {
 		return {
 			retrainStatus: persisted.retrainStatus ?? "none",
 			debug: persisted.debug === true,
+			debugNote: persisted.debugNote ?? "",
 			favourited: persisted.favourited === true
 		};
 	}
@@ -41187,6 +41236,7 @@ var TrackStore = class {
 				...t.audioLabels !== void 0 ? { audioLabels: [...t.audioLabels] } : {},
 				...t.retrainStatus !== void 0 ? { retrainStatus: t.retrainStatus } : {},
 				...t.debug !== void 0 ? { debug: t.debug } : {},
+				...t.debugNote !== void 0 ? { debugNote: t.debugNote } : {},
 				...t.favourited !== void 0 ? { favourited: t.favourited } : {},
 				...t.hasFace !== void 0 ? { hasFace: t.hasFace } : {},
 				...t.hasEmbeddedFace !== void 0 ? { hasEmbeddedFace: t.hasEmbeddedFace } : {},
@@ -41245,6 +41295,7 @@ var TrackStore = class {
 		const audioLabels = readAudioLabels(data["audioLabels"]);
 		const retrainParsed = require_dist.RetrainStatusSchema.safeParse(data["retrainStatus"]);
 		const debug = data["debug"];
+		const debugNote = data["debugNote"];
 		const favourited = data["favourited"];
 		const hasFace = data["hasFace"];
 		/** Same read as `hasFace` — NULL / missing stays ABSENT, never `false`.
@@ -41293,6 +41344,7 @@ var TrackStore = class {
 				markForTrain: retrainParsed.data === "staging"
 			} : {},
 			...typeof debug === "boolean" ? { debug } : {},
+			...typeof debugNote === "string" ? { debugNote } : {},
 			...typeof favourited === "boolean" ? { favourited } : {},
 			...typeof hasFace === "boolean" ? { hasFace } : {},
 			...typeof hasEmbeddedFace === "boolean" ? { hasEmbeddedFace } : {},
@@ -54864,6 +54916,47 @@ var TrackAlreadyTrainedError = class extends Error {
 	}
 };
 /**
+* The `debugNote` half of the patch — `{}` when nothing should be written.
+*
+* The note is not an independent column: it is the operator's sentence about
+* why `debug` is on, so it exists exactly as long as the flag does. Three
+* cases, and the order matters:
+*
+*  1. **`debug: false` in the patch → the note is CLEARED**, whatever the
+*     caller sent with it. A note surviving the flag is a leftover that reads
+*     as a live request, and the invariant belongs here rather than in the
+*     three surfaces that write this patch — one of which is a browser grid
+*     that has no note UI at all and would never think to clear it.
+*  2. **No note in the patch → nothing is written.** This is what makes a
+*     cancelled prompt free: the app turns debug on, the operator declines to
+*     type, and the flag still lands. Refusing to write a note must never cost
+*     the capture that was asked for.
+*  3. **A note, on a track whose debug is off and is not being turned on →
+*     DROPPED.** Storing it would put the operator's words somewhere no reader
+*     of a debug set will ever look. Dropped work is logged, per-camera: a
+*     branch that silently discards a sentence is indistinguishable from one
+*     that stored it.
+*
+* `''` is a WRITE, not an absence — clearing a note the operator no longer
+* stands behind is a real edit.
+*/
+function resolveNotePatch(deps, input, current) {
+	if (input.flags.debug === false) return { debugNote: "" };
+	if (input.flags.debugNote === void 0) return {};
+	if (!(input.flags.debug === true || current.debug)) {
+		deps.logger.warn("setTrackFlags dropped a debug note — the track is not flagged for debug", {
+			tags: { deviceId: input.deviceId },
+			meta: {
+				deviceId: input.deviceId,
+				trackId: input.trackId,
+				noteLength: input.flags.debugNote.length
+			}
+		});
+		return {};
+	}
+	return { debugNote: input.flags.debugNote };
+}
+/**
 * Apply a partial flag patch and report the RESOLVED state of both flags.
 *
 * Existence is checked BEFORE the write: a patch against a track that no longer
@@ -54924,7 +55017,8 @@ async function applyTrackFlags(deps, input) {
 	const patch = {
 		...input.flags.markForTrain !== void 0 ? { markForTrain: input.flags.markForTrain } : {},
 		...input.flags.debug !== void 0 ? { debug: input.flags.debug } : {},
-		...input.flags.favourited !== void 0 ? { favourited: input.flags.favourited } : {}
+		...input.flags.favourited !== void 0 ? { favourited: input.flags.favourited } : {},
+		...resolveNotePatch(deps, input, current)
 	};
 	if (Object.keys(patch).length > 0) await store.setFlags(input.trackId, patch);
 	const retrainStatus = patch.markForTrain === void 0 ? current.retrainStatus : patch.markForTrain ? "staging" : "none";
@@ -54932,6 +55026,7 @@ async function applyTrackFlags(deps, input) {
 		trackId: input.trackId,
 		markForTrain: retrainStatus === "staging",
 		debug: patch.debug ?? current.debug,
+		debugNote: patch.debugNote ?? current.debugNote,
 		favourited: patch.favourited ?? current.favourited,
 		retrainStatus
 	};
@@ -58661,6 +58756,13 @@ var ANALYTICS_COLLECTIONS = [
 			kind: "never-orphaned",
 			why: "declares `sourceTrackId`, which is a REFERENCE and not ownership — a parked object outliving the track that first saw it is the entire purpose of the registry. It has its own TTL sweep keyed on OBSERVED frame time, not wall clock. Classified by hand precisely because the derivation must not see it."
 		}
+	},
+	{
+		collection: STATIONARY_EVIDENCE_COLLECTION,
+		classification: {
+			kind: "never-orphaned",
+			why: "the candidate half of the registry above, and it inherits that entry's argument for the same reason: `sourceTrackId` is the PROVENANCE of whichever track happened to be looking, never ownership. It cannot be `track-owned` on the behaviour, not merely on the name — a candidate is fed by a SUCCESSION of tracks (`StationaryEvidenceLedger.observe` re-binds under D280, and `retainTracks` drops a binding the moment the tracker forgets the track) while the row itself survives, because agreement accumulating ACROSS tracks is the whole measurement. Cascading it on the first contributor's eviction would delete evidence still being gathered by tracks alive right now. Its bounds are its own and stay inside D61's one-clock rule: a candidate untouched for EVIDENCE_WINDOW_MS (6h) is dropped by `expire`, on the next OBSERVATION of that device and against the frame timestamp — the same observed-time clock the registry uses, never wall clock and never a sweep; a device is capped at EVIDENCE_MAX_CANDIDATES_PER_DEVICE (512, least-recently-touched evicted); a promotion deletes the candidate the instant the registry entry is born, so the two tables cannot both hold the object; and `clearDevice` takes the rest when a camera is removed. Deliberately NOT `owner-indirection`: that kind enrols a collection into `auditableCollections()`, and the audit has a resolver only for `pipeline-analytics:media`."
+		}
 	}
 ];
 /** The collections the orphan audit actually scans — everything with an owner. */
@@ -71158,15 +71260,41 @@ var PipelineAnalyticsAddon = class PipelineAnalyticsAddon extends require_dist.B
 	*/
 	maybeEmitTrackLifecycleUpdate(deviceId, t, timestamp, isNewBest) {
 		const memory = this.residents.lifecycleUpdateMem(t.trackId);
+		/**
+		* The signal's label reads the frame patch AND the track row: the face
+		* recognizer writes a recognised identity to the ROW over the async
+		* detail plane, never into a frame patch, and a patch-only read left the
+		* identity trigger unable to fire for a face — every face name reached
+		* the export surfaces only on the `end` event, ~30 s after the subject
+		* left the frame (measured live 2026-09-05).
+		*/
+		const peeked = this.trackStore?.peekActive(t.trackId);
+		const label = resolveLifecycleUpdateLabel(t.labelPatch, peeked?.label);
 		const decision = evaluateTrackLifecycleUpdate({
 			isNewBest,
 			confidence: t.confidence,
 			now: timestamp,
-			...patchDisplayLabel(t.labelPatch) !== void 0 ? { label: patchDisplayLabel(t.labelPatch) } : {},
+			...label !== void 0 ? { label } : {},
+			...peeked !== null && peeked !== void 0 ? { zonesVisitedCount: peeked.zonesVisitedCount } : {},
 			bboxArea: t.bbox.w * t.bbox.h
 		}, memory, DEFAULT_UPDATE_GATE_CONFIG);
 		this.residents.setLifecycleUpdateMem(deviceId, t.trackId, decision.memory);
-		if (!decision.emit) return;
+		if (!decision.emit) {
+			/**
+			* Dropped for cadence (debounce) — counted, never silent. The count
+			* since the last emit rides the memory and this line; a throttle
+			* with no ledger is how a 30 s delivery delay stayed invisible.
+			*/
+			if (decision.suppressed !== void 0) this.ctx.logger.debug("lifecycle update suppressed (debounce)", {
+				tags: { deviceId },
+				meta: {
+					trackId: t.trackId,
+					reason: decision.suppressed,
+					suppressedSinceEmit: decision.memory.suppressedSinceEmit ?? 0
+				}
+			});
+			return;
+		}
 		const track = this.trackStore?.getActiveByTrack(t.trackId);
 		const keyFrameMediaKey = this.residents.keyFrameKey(t.trackId);
 		const payload = buildTrackLifecyclePayload({
@@ -71178,7 +71306,7 @@ var PipelineAnalyticsAddon = class PipelineAnalyticsAddon extends require_dist.B
 			bestConfidence: t.confidence,
 			firstSeen: track?.firstSeen ?? timestamp,
 			lastSeen: track?.lastSeen ?? timestamp,
-			...patchDisplayLabel(t.labelPatch) !== void 0 ? { label: patchDisplayLabel(t.labelPatch) } : {},
+			...label !== void 0 ? { label } : {},
 			...t.plateText !== void 0 ? { plateText: t.plateText } : {},
 			...track?.zonesVisited !== void 0 ? { zonesVisited: track.zonesVisited } : {},
 			...track?.totalDistance !== void 0 ? { totalDistance: track.totalDistance } : {},

package/dist/pipeline-analytics/index.mjs

@@ -1,4 +1,4 @@
-import { $ as audioModeOf, A as NcSnoozeSchema, At as BaseAddon, B as SCENE_DEFAULT_UNCOVERED_POLICY, Bt as boolean, C as NcConditionDescriptorSchema, Ct as sceneMonitorCapability, D as NcRuleTargetSchema, Dt as videoclipsCapability, E as NcRuleSchema, Et as vectorDimFromBase64, Ft as isDeviceScopedCap, G as TimelapseRulePatchSchema, Gt as partialRecord, H as SceneMonitorSchema, Ht as literal, I as RECORDING_EXPORT_MAX_READ_BYTES, It as nodePin, J as VISIT_MERGE_GAP_MS, Jt as unknown, K as TimelapseRuleSchema, Kt as record, L as RetrainStatusSchema, Lt as sleep$1, M as NcSystemEventKindSchema, Mt as DeviceType, N as NcTaxonomySchema, Nt as createEvent, O as NcScheduleSchema, Ot as zoneAnalyticsCapability, P as OpsLogEntrySchema, Pt as hydrateSchema, Q as audioMetricsCapability, Rt as _enum, S as NC_TAXONOMY, T as NcRulePatchSchema, Tt as systemEventFilterApplies, U as TIMELAPSE_DENSE_FLOOR_SEC, Ut as number, V as SCENE_DIVERGED, Vt as discriminatedUnion, W as TimelapseRuleInputSchema, Wt as object, X as alarmPanelCapability, Y as addonWidgetsSourceCapability, Yt as EventCategory, Z as assertTimelapseCadences, _ as MediaFileKindEnum, _t as pickClusterStepModels, a as DEFAULT_EVENT_COLOR, b as NC_DEFAULT_SNOOZE_MINUTES, bt as readDeviceStateFrom, c as DETECTION_MACRO_CLASSES, ct as faceGalleryCapability, d as EVENT_KIND_BY_CAP, dt as isDetectionMacroClass, et as buildEventKindDescriptor, f as EVENT_PAD_MS, ft as isScheduleActive, g as MACRO_LABELS, h as LabelAttributionSchema, ht as notificationRulesCapability, i as COCO_TO_MACRO, it as deriveRecordingMode, j as NcSnoozeSuppressedSchema, jt as CamProfileSchema, k as NcSnoozeInputSchema, kt as errMsg, lt as failureContributionCapability, m as FailureCounters, mt as kebabToCamel, n as BaseDevice, nt as customAction, ot as encodeVectorBase64, p as FULL_IMAGE_BBOX, pt as isSourceCap, q as TrackSourceSchema, qt as string, r as CLUSTER_MODEL_SCOPED_STEPS, rt as defineCustomActions, st as evaluateSensorEdge, t as AUDIO_MACRO_LABELS, tt as cosineSimilarity$1, u as DeclaredDevices, v as NC_ALARM_SYSTEM_EVENT_KINDS, vt as pipelineAnalyticsCapability, w as NcRuleInputSchema, wt as subKindsOf, xt as readTimelapseGeneratedAt, y as NC_CONDITION_CATALOG, yt as plateGalleryCapability, z as SCENE_DEFAULT_ANCHOR_THRESHOLD, zt as array } from "../dist-B1cFmGC0.mjs";
+import { $ as audioModeOf, A as NcSnoozeSchema, At as BaseAddon, B as SCENE_DEFAULT_UNCOVERED_POLICY, Bt as boolean, C as NcConditionDescriptorSchema, Ct as sceneMonitorCapability, D as NcRuleTargetSchema, Dt as videoclipsCapability, E as NcRuleSchema, Et as vectorDimFromBase64, Ft as isDeviceScopedCap, G as TimelapseRulePatchSchema, Gt as partialRecord, H as SceneMonitorSchema, Ht as literal, I as RECORDING_EXPORT_MAX_READ_BYTES, It as nodePin, J as VISIT_MERGE_GAP_MS, Jt as unknown, K as TimelapseRuleSchema, Kt as record, L as RetrainStatusSchema, Lt as sleep$1, M as NcSystemEventKindSchema, Mt as DeviceType, N as NcTaxonomySchema, Nt as createEvent, O as NcScheduleSchema, Ot as zoneAnalyticsCapability, P as OpsLogEntrySchema, Pt as hydrateSchema, Q as audioMetricsCapability, Rt as _enum, S as NC_TAXONOMY, T as NcRulePatchSchema, Tt as systemEventFilterApplies, U as TIMELAPSE_DENSE_FLOOR_SEC, Ut as number, V as SCENE_DIVERGED, Vt as discriminatedUnion, W as TimelapseRuleInputSchema, Wt as object, X as alarmPanelCapability, Y as addonWidgetsSourceCapability, Yt as EventCategory, Z as assertTimelapseCadences, _ as MediaFileKindEnum, _t as pickClusterStepModels, a as DEFAULT_EVENT_COLOR, b as NC_DEFAULT_SNOOZE_MINUTES, bt as readDeviceStateFrom, c as DETECTION_MACRO_CLASSES, ct as faceGalleryCapability, d as EVENT_KIND_BY_CAP, dt as isDetectionMacroClass, et as buildEventKindDescriptor, f as EVENT_PAD_MS, ft as isScheduleActive, g as MACRO_LABELS, h as LabelAttributionSchema, ht as notificationRulesCapability, i as COCO_TO_MACRO, it as deriveRecordingMode, j as NcSnoozeSuppressedSchema, jt as CamProfileSchema, k as NcSnoozeInputSchema, kt as errMsg, lt as failureContributionCapability, m as FailureCounters, mt as kebabToCamel, n as BaseDevice, nt as customAction, ot as encodeVectorBase64, p as FULL_IMAGE_BBOX, pt as isSourceCap, q as TrackSourceSchema, qt as string, r as CLUSTER_MODEL_SCOPED_STEPS, rt as defineCustomActions, st as evaluateSensorEdge, t as AUDIO_MACRO_LABELS, tt as cosineSimilarity$1, u as DeclaredDevices, v as NC_ALARM_SYSTEM_EVENT_KINDS, vt as pipelineAnalyticsCapability, w as NcRuleInputSchema, wt as subKindsOf, xt as readTimelapseGeneratedAt, y as NC_CONDITION_CATALOG, yt as plateGalleryCapability, z as SCENE_DEFAULT_ANCHOR_THRESHOLD, zt as array } from "../dist-NBkMwEZ0.mjs";
 import { t as __exportAll } from "../embedding-encoder/index.mjs";
 import * as fs from "node:fs";
 import { promises } from "node:fs";
@@ -35814,16 +35814,43 @@ function positionsIntersectZone(positions, frameWidth, frameHeight, zone) {
 	}, zone.points)) return true;
 	return false;
 }
+//#endregion
+//#region src/pipeline-analytics/track-lifecycle.ts
+/** Minimum confidence increase (vs last emit) that counts as a material
+*  improvement. */
+var UPDATE_MIN_CONF_DELTA = .1;
+/** Debounce floor between two `update` emits for the same track (ms). */
+var UPDATE_MIN_INTERVAL_MS = 4e3;
+/** Minimum fractional bbox-area growth (vs last emit) counted as a
+*  materially larger representative crop (e.g. 0.15 = 15% bigger). */
+var UPDATE_MIN_CROP_AREA_GROWTH = .15;
+/**
+* The label a `phase:'update'` SIGNAL and PAYLOAD carry, resolved from its
+* two possible sources in order: this frame's tiered patch (the frame path
+* wrote a label this very frame), then the track ROW's stored display label
+* (`subLabel ?? label`, as `trackStore.peekActive` exposes it).
+*
+* The fallback is not a nicety. The face recognizer assigns an identity over
+* the async detail plane and writes it to the row (`applyLabelCandidate`) —
+* never into a frame patch — so a signal reading only the patch can never
+* fire the identity trigger for a recognised face. Measured on the live hub
+* (2026-09-05, device 590): six of six face identities reached Home
+* Assistant only on the `end` event at track close + sweep (~lastSeen+33 s),
+* zero during the track's life, while the subject was still on camera.
+*/
+function resolveLifecycleUpdateLabel(labelPatch, storedDisplayLabel) {
+	return patchDisplayLabel(labelPatch) ?? storedDisplayLabel;
+}
 var DEFAULT_UPDATE_GATE_CONFIG = {
-	minConfDelta: .1,
-	minIntervalMs: 4e3,
-	minCropAreaGrowth: .15
+	minConfDelta: UPDATE_MIN_CONF_DELTA,
+	minIntervalMs: UPDATE_MIN_INTERVAL_MS,
+	minCropAreaGrowth: UPDATE_MIN_CROP_AREA_GROWTH
 };
 /**
 * Decide whether a `phase:'update'` event should fire this frame.
 *
 * Priority of triggers: newly-resolved identity/plate > confidence
-* improvement > materially larger crop. All triggers are debounced by
+* improvement > newly-entered zone > materially larger crop. All triggers are debounced by
 * `minIntervalMs` relative to the last emit. Deltas are measured against
 * the LAST-EMITTED memory, so a run of sub-threshold new-bests accumulates
 * and fires once it crosses `minConfDelta`.
@@ -35831,22 +35858,32 @@ var DEFAULT_UPDATE_GATE_CONFIG = {
 function evaluateTrackLifecycleUpdate(signal, memory, config) {
 	const identityTrigger = signal.label !== void 0 && signal.label !== "" && (memory === void 0 || memory.lastLabel !== signal.label);
 	const confidenceTrigger = signal.isNewBest && (memory === void 0 || signal.confidence - memory.lastConfidence >= config.minConfDelta);
+	const zoneTrigger = signal.zonesVisitedCount !== void 0 && memory?.lastZonesVisitedCount !== void 0 && signal.zonesVisitedCount > memory.lastZonesVisitedCount;
 	const cropTrigger = signal.bboxArea !== void 0 && memory?.lastBboxArea !== void 0 && memory.lastBboxArea > 0 && signal.bboxArea >= memory.lastBboxArea * (1 + config.minCropAreaGrowth);
-	const reason = identityTrigger ? "identity" : confidenceTrigger ? "confidence" : cropTrigger ? "crop" : void 0;
-	const keptMemory = memory ?? {
+	const reason = identityTrigger ? "identity" : confidenceTrigger ? "confidence" : zoneTrigger ? "zone" : cropTrigger ? "crop" : void 0;
+	const keptMemory = memory === void 0 ? {
 		lastConfidence: signal.confidence,
-		lastEmitAt: signal.now
-	};
+		lastEmitAt: signal.now,
+		...signal.zonesVisitedCount !== void 0 ? { lastZonesVisitedCount: signal.zonesVisitedCount } : {}
+	} : memory.lastZonesVisitedCount === void 0 && signal.zonesVisitedCount !== void 0 ? {
+		...memory,
+		lastZonesVisitedCount: signal.zonesVisitedCount
+	} : memory;
 	if (reason === void 0) return {
 		emit: false,
 		memory: keptMemory
 	};
 	if (memory !== void 0 && signal.now - memory.lastEmitAt < config.minIntervalMs) return {
 		emit: false,
-		memory
+		suppressed: reason,
+		memory: {
+			...keptMemory,
+			suppressedSinceEmit: (keptMemory.suppressedSinceEmit ?? 0) + 1
+		}
 	};
 	const nextLabel = signal.label ?? memory?.lastLabel;
 	const nextBboxArea = signal.bboxArea ?? memory?.lastBboxArea;
+	const nextZonesCount = signal.zonesVisitedCount ?? memory?.lastZonesVisitedCount;
 	return {
 		emit: true,
 		reason,
@@ -35854,7 +35891,8 @@ function evaluateTrackLifecycleUpdate(signal, memory, config) {
 			lastConfidence: memory === void 0 ? signal.confidence : Math.max(memory.lastConfidence, signal.confidence),
 			lastEmitAt: signal.now,
 			...nextLabel !== void 0 ? { lastLabel: nextLabel } : {},
-			...nextBboxArea !== void 0 ? { lastBboxArea: nextBboxArea } : {}
+			...nextBboxArea !== void 0 ? { lastBboxArea: nextBboxArea } : {},
+			...nextZonesCount !== void 0 ? { lastZonesVisitedCount: nextZonesCount } : {}
 		}
 	};
 }
@@ -39465,6 +39503,10 @@ var TRACKS_COLUMNS = [
 		name: "debug",
 		type: "BOOLEAN"
 	},
+	{
+		name: "debugNote",
+		type: "TEXT"
+	},
 	{
 		name: "favourited",
 		type: "BOOLEAN"
@@ -39660,6 +39702,7 @@ function cloneTrack(t) {
 			markForTrain: t.retrainStatus === "staging"
 		} : {},
 		...t.debug !== void 0 ? { debug: t.debug } : {},
+		...t.debugNote !== void 0 ? { debugNote: t.debugNote } : {},
 		...t.favourited !== void 0 ? { favourited: t.favourited } : {},
 		...t.hasFace !== void 0 ? { hasFace: t.hasFace } : {},
 		...t.hasEmbeddedFace !== void 0 ? { hasEmbeddedFace: t.hasEmbeddedFace } : {},
@@ -39896,7 +39939,8 @@ var TrackStore = class {
 	* Cheap read of an active track's promotion-relevant fields WITHOUT the deep
 	* clone `getActiveByTrack` does — the returned `positions` is the live
 	* internal array (read-only; callers must not mutate). Feeds the per-frame
-	* stationary-promotion check, called at inference fps. Null if unknown/expired.
+	* stationary-promotion check AND the lifecycle update gate, both called at
+	* inference fps. Null if unknown/expired.
 	*/
 	peekActive(trackId) {
 		const t = this.active.get(trackId);
@@ -39904,6 +39948,7 @@ var TrackStore = class {
 		return {
 			firstSeen: t.firstSeen,
 			positions: t.positions,
+			zonesVisitedCount: t.zonesVisited.length,
 			...displayLabel(t) !== void 0 ? { label: displayLabel(t) } : {}
 		};
 	}
@@ -40048,12 +40093,14 @@ var TrackStore = class {
 		const nextStatus = patch.markForTrain === void 0 ? void 0 : patch.markForTrain ? "staging" : "none";
 		if (nextStatus !== void 0) data["retrainStatus"] = nextStatus;
 		if (patch.debug !== void 0) data["debug"] = patch.debug;
+		if (patch.debugNote !== void 0) data["debugNote"] = patch.debugNote;
 		if (patch.favourited !== void 0) data["favourited"] = patch.favourited;
 		if (Object.keys(data).length === 0) return;
 		const active = this.active.get(trackId);
 		if (active) {
 			if (nextStatus !== void 0) active.retrainStatus = nextStatus;
 			if (patch.debug !== void 0) active.debug = patch.debug;
+			if (patch.debugNote !== void 0) active.debugNote = patch.debugNote;
 			if (patch.favourited !== void 0) active.favourited = patch.favourited;
 		}
 		try {
@@ -40256,6 +40303,7 @@ var TrackStore = class {
 		if (active) return {
 			retrainStatus: active.retrainStatus ?? "none",
 			debug: active.debug === true,
+			debugNote: active.debugNote ?? "",
 			favourited: active.favourited === true
 		};
 		const persisted = await this.getPersistedByTrackId(trackId);
@@ -40263,6 +40311,7 @@ var TrackStore = class {
 		return {
 			retrainStatus: persisted.retrainStatus ?? "none",
 			debug: persisted.debug === true,
+			debugNote: persisted.debugNote ?? "",
 			favourited: persisted.favourited === true
 		};
 	}
@@ -41162,6 +41211,7 @@ var TrackStore = class {
 				...t.audioLabels !== void 0 ? { audioLabels: [...t.audioLabels] } : {},
 				...t.retrainStatus !== void 0 ? { retrainStatus: t.retrainStatus } : {},
 				...t.debug !== void 0 ? { debug: t.debug } : {},
+				...t.debugNote !== void 0 ? { debugNote: t.debugNote } : {},
 				...t.favourited !== void 0 ? { favourited: t.favourited } : {},
 				...t.hasFace !== void 0 ? { hasFace: t.hasFace } : {},
 				...t.hasEmbeddedFace !== void 0 ? { hasEmbeddedFace: t.hasEmbeddedFace } : {},
@@ -41220,6 +41270,7 @@ var TrackStore = class {
 		const audioLabels = readAudioLabels(data["audioLabels"]);
 		const retrainParsed = RetrainStatusSchema.safeParse(data["retrainStatus"]);
 		const debug = data["debug"];
+		const debugNote = data["debugNote"];
 		const favourited = data["favourited"];
 		const hasFace = data["hasFace"];
 		/** Same read as `hasFace` — NULL / missing stays ABSENT, never `false`.
@@ -41268,6 +41319,7 @@ var TrackStore = class {
 				markForTrain: retrainParsed.data === "staging"
 			} : {},
 			...typeof debug === "boolean" ? { debug } : {},
+			...typeof debugNote === "string" ? { debugNote } : {},
 			...typeof favourited === "boolean" ? { favourited } : {},
 			...typeof hasFace === "boolean" ? { hasFace } : {},
 			...typeof hasEmbeddedFace === "boolean" ? { hasEmbeddedFace } : {},
@@ -54790,6 +54842,47 @@ var TrackAlreadyTrainedError = class extends Error {
 	}
 };
 /**
+* The `debugNote` half of the patch — `{}` when nothing should be written.
+*
+* The note is not an independent column: it is the operator's sentence about
+* why `debug` is on, so it exists exactly as long as the flag does. Three
+* cases, and the order matters:
+*
+*  1. **`debug: false` in the patch → the note is CLEARED**, whatever the
+*     caller sent with it. A note surviving the flag is a leftover that reads
+*     as a live request, and the invariant belongs here rather than in the
+*     three surfaces that write this patch — one of which is a browser grid
+*     that has no note UI at all and would never think to clear it.
+*  2. **No note in the patch → nothing is written.** This is what makes a
+*     cancelled prompt free: the app turns debug on, the operator declines to
+*     type, and the flag still lands. Refusing to write a note must never cost
+*     the capture that was asked for.
+*  3. **A note, on a track whose debug is off and is not being turned on →
+*     DROPPED.** Storing it would put the operator's words somewhere no reader
+*     of a debug set will ever look. Dropped work is logged, per-camera: a
+*     branch that silently discards a sentence is indistinguishable from one
+*     that stored it.
+*
+* `''` is a WRITE, not an absence — clearing a note the operator no longer
+* stands behind is a real edit.
+*/
+function resolveNotePatch(deps, input, current) {
+	if (input.flags.debug === false) return { debugNote: "" };
+	if (input.flags.debugNote === void 0) return {};
+	if (!(input.flags.debug === true || current.debug)) {
+		deps.logger.warn("setTrackFlags dropped a debug note — the track is not flagged for debug", {
+			tags: { deviceId: input.deviceId },
+			meta: {
+				deviceId: input.deviceId,
+				trackId: input.trackId,
+				noteLength: input.flags.debugNote.length
+			}
+		});
+		return {};
+	}
+	return { debugNote: input.flags.debugNote };
+}
+/**
 * Apply a partial flag patch and report the RESOLVED state of both flags.
 *
 * Existence is checked BEFORE the write: a patch against a track that no longer
@@ -54850,7 +54943,8 @@ async function applyTrackFlags(deps, input) {
 	const patch = {
 		...input.flags.markForTrain !== void 0 ? { markForTrain: input.flags.markForTrain } : {},
 		...input.flags.debug !== void 0 ? { debug: input.flags.debug } : {},
-		...input.flags.favourited !== void 0 ? { favourited: input.flags.favourited } : {}
+		...input.flags.favourited !== void 0 ? { favourited: input.flags.favourited } : {},
+		...resolveNotePatch(deps, input, current)
 	};
 	if (Object.keys(patch).length > 0) await store.setFlags(input.trackId, patch);
 	const retrainStatus = patch.markForTrain === void 0 ? current.retrainStatus : patch.markForTrain ? "staging" : "none";
@@ -54858,6 +54952,7 @@ async function applyTrackFlags(deps, input) {
 		trackId: input.trackId,
 		markForTrain: retrainStatus === "staging",
 		debug: patch.debug ?? current.debug,
+		debugNote: patch.debugNote ?? current.debugNote,
 		favourited: patch.favourited ?? current.favourited,
 		retrainStatus
 	};
@@ -58587,6 +58682,13 @@ var ANALYTICS_COLLECTIONS = [
 			kind: "never-orphaned",
 			why: "declares `sourceTrackId`, which is a REFERENCE and not ownership — a parked object outliving the track that first saw it is the entire purpose of the registry. It has its own TTL sweep keyed on OBSERVED frame time, not wall clock. Classified by hand precisely because the derivation must not see it."
 		}
+	},
+	{
+		collection: STATIONARY_EVIDENCE_COLLECTION,
+		classification: {
+			kind: "never-orphaned",
+			why: "the candidate half of the registry above, and it inherits that entry's argument for the same reason: `sourceTrackId` is the PROVENANCE of whichever track happened to be looking, never ownership. It cannot be `track-owned` on the behaviour, not merely on the name — a candidate is fed by a SUCCESSION of tracks (`StationaryEvidenceLedger.observe` re-binds under D280, and `retainTracks` drops a binding the moment the tracker forgets the track) while the row itself survives, because agreement accumulating ACROSS tracks is the whole measurement. Cascading it on the first contributor's eviction would delete evidence still being gathered by tracks alive right now. Its bounds are its own and stay inside D61's one-clock rule: a candidate untouched for EVIDENCE_WINDOW_MS (6h) is dropped by `expire`, on the next OBSERVATION of that device and against the frame timestamp — the same observed-time clock the registry uses, never wall clock and never a sweep; a device is capped at EVIDENCE_MAX_CANDIDATES_PER_DEVICE (512, least-recently-touched evicted); a promotion deletes the candidate the instant the registry entry is born, so the two tables cannot both hold the object; and `clearDevice` takes the rest when a camera is removed. Deliberately NOT `owner-indirection`: that kind enrols a collection into `auditableCollections()`, and the audit has a resolver only for `pipeline-analytics:media`."
+		}
 	}
 ];
 /** The collections the orphan audit actually scans — everything with an owner. */
@@ -71084,15 +71186,41 @@ var PipelineAnalyticsAddon = class PipelineAnalyticsAddon extends BaseAddon {
 	*/
 	maybeEmitTrackLifecycleUpdate(deviceId, t, timestamp, isNewBest) {
 		const memory = this.residents.lifecycleUpdateMem(t.trackId);
+		/**
+		* The signal's label reads the frame patch AND the track row: the face
+		* recognizer writes a recognised identity to the ROW over the async
+		* detail plane, never into a frame patch, and a patch-only read left the
+		* identity trigger unable to fire for a face — every face name reached
+		* the export surfaces only on the `end` event, ~30 s after the subject
+		* left the frame (measured live 2026-09-05).
+		*/
+		const peeked = this.trackStore?.peekActive(t.trackId);
+		const label = resolveLifecycleUpdateLabel(t.labelPatch, peeked?.label);
 		const decision = evaluateTrackLifecycleUpdate({
 			isNewBest,
 			confidence: t.confidence,
 			now: timestamp,
-			...patchDisplayLabel(t.labelPatch) !== void 0 ? { label: patchDisplayLabel(t.labelPatch) } : {},
+			...label !== void 0 ? { label } : {},
+			...peeked !== null && peeked !== void 0 ? { zonesVisitedCount: peeked.zonesVisitedCount } : {},
 			bboxArea: t.bbox.w * t.bbox.h
 		}, memory, DEFAULT_UPDATE_GATE_CONFIG);
 		this.residents.setLifecycleUpdateMem(deviceId, t.trackId, decision.memory);
-		if (!decision.emit) return;
+		if (!decision.emit) {
+			/**
+			* Dropped for cadence (debounce) — counted, never silent. The count
+			* since the last emit rides the memory and this line; a throttle
+			* with no ledger is how a 30 s delivery delay stayed invisible.
+			*/
+			if (decision.suppressed !== void 0) this.ctx.logger.debug("lifecycle update suppressed (debounce)", {
+				tags: { deviceId },
+				meta: {
+					trackId: t.trackId,
+					reason: decision.suppressed,
+					suppressedSinceEmit: decision.memory.suppressedSinceEmit ?? 0
+				}
+			});
+			return;
+		}
 		const track = this.trackStore?.getActiveByTrack(t.trackId);
 		const keyFrameMediaKey = this.residents.keyFrameKey(t.trackId);
 		const payload = buildTrackLifecyclePayload({
@@ -71104,7 +71232,7 @@ var PipelineAnalyticsAddon = class PipelineAnalyticsAddon extends BaseAddon {
 			bestConfidence: t.confidence,
 			firstSeen: track?.firstSeen ?? timestamp,
 			lastSeen: track?.lastSeen ?? timestamp,
-			...patchDisplayLabel(t.labelPatch) !== void 0 ? { label: patchDisplayLabel(t.labelPatch) } : {},
+			...label !== void 0 ? { label } : {},
 			...t.plateText !== void 0 ? { plateText: t.plateText } : {},
 			...track?.zonesVisited !== void 0 ? { zonesVisited: track.zonesVisited } : {},
 			...track?.totalDistance !== void 0 ? { totalDistance: track.totalDistance } : {},

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-MvTzBID6.mjs")).catch((e) => {
+	return l ||= d(() => import("./_virtual_mf-localSharedImportMap___mfe_internal__addon_pipeline_analytics_widgets-BL6jNwq1.mjs")).catch((e) => {
 		throw l = void 0, e;
 	}), l;
 }

package/package.json

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