@camstack/addon-post-analysis 1.2.178 → 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");
@@ -39528,6 +39528,10 @@ var TRACKS_COLUMNS = [
 		name: "debug",
 		type: "BOOLEAN"
 	},
+	{
+		name: "debugNote",
+		type: "TEXT"
+	},
 	{
 		name: "favourited",
 		type: "BOOLEAN"
@@ -39723,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 } : {},
@@ -40113,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 {
@@ -40321,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);
@@ -40328,6 +40336,7 @@ var TrackStore = class {
 		return {
 			retrainStatus: persisted.retrainStatus ?? "none",
 			debug: persisted.debug === true,
+			debugNote: persisted.debugNote ?? "",
 			favourited: persisted.favourited === true
 		};
 	}
@@ -41227,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 } : {},
@@ -41285,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`.
@@ -41333,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 } : {},
@@ -54904,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
@@ -54964,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";
@@ -54972,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
 	};
@@ -58701,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. */

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";
@@ -39503,6 +39503,10 @@ var TRACKS_COLUMNS = [
 		name: "debug",
 		type: "BOOLEAN"
 	},
+	{
+		name: "debugNote",
+		type: "TEXT"
+	},
 	{
 		name: "favourited",
 		type: "BOOLEAN"
@@ -39698,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 } : {},
@@ -40088,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 {
@@ -40296,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);
@@ -40303,6 +40311,7 @@ var TrackStore = class {
 		return {
 			retrainStatus: persisted.retrainStatus ?? "none",
 			debug: persisted.debug === true,
+			debugNote: persisted.debugNote ?? "",
 			favourited: persisted.favourited === true
 		};
 	}
@@ -41202,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 } : {},
@@ -41260,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`.
@@ -41308,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 } : {},
@@ -54830,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
@@ -54890,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";
@@ -54898,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
 	};
@@ -58627,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. */

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.178",
+  "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",