@camstack/addon-post-analysis 1.2.102 → 1.2.104

package/dist/{dist-CZm8slPB.mjs → dist-IZLiqXRa.mjs}

@@ -20739,6 +20739,7 @@ DeviceType.Camera, method(object({
 		isBattery: boolean(),
 		reason: _enum([
 			"disabled",
+			"offline",
 			"sleeping",
 			"unreachable",
 			"waking"
@@ -20784,9 +20785,17 @@ targets: array(object({
 	sleeping: boolean(),
 	/** Current device state rendered over the cached frame. State images
 	*  remain authoritative even when their photographic background is
-	*  old; null means the link must carry a current camera frame. */
+	*  old; null means the link must carry a current camera frame.
+	*
+	*  **This is the ONLY source a surface may derive an inactive tile
+	*  from.** A client that reads a device's `online`/`disabled` flags and
+	*  draws its own verdict will disagree with the pixels it is painting
+	*  — the frame comes from here, and so must the sentence over it
+	*  (D190). Pair with `ageMs` for the age of the photograph behind the
+	*  state. */
 	stateReason: _enum([
 		"disabled",
+		"offline",
 		"sleeping",
 		"unreachable",
 		"waking"

package/dist/{dist-BwxXdV9d.js → dist-KXhjlCmh.js}

@@ -20770,6 +20770,7 @@ DeviceType.Camera, method(object({
 		isBattery: boolean(),
 		reason: _enum([
 			"disabled",
+			"offline",
 			"sleeping",
 			"unreachable",
 			"waking"
@@ -20815,9 +20816,17 @@ targets: array(object({
 	sleeping: boolean(),
 	/** Current device state rendered over the cached frame. State images
 	*  remain authoritative even when their photographic background is
-	*  old; null means the link must carry a current camera frame. */
+	*  old; null means the link must carry a current camera frame.
+	*
+	*  **This is the ONLY source a surface may derive an inactive tile
+	*  from.** A client that reads a device's `online`/`disabled` flags and
+	*  draws its own verdict will disagree with the pixels it is painting
+	*  — the frame comes from here, and so must the sentence over it
+	*  (D190). Pair with `ageMs` for the age of the photograph behind the
+	*  state. */
 	stateReason: _enum([
 		"disabled",
+		"offline",
 		"sleeping",
 		"unreachable",
 		"waking"

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-BwxXdV9d.js");
+const require_dist = require("../dist-KXhjlCmh.js");
 let node_fs = require("node:fs");
 let node_fs$1 = require_dist.__toESM(node_fs, 1);
 node_fs = require_dist.__toESM(node_fs);

package/dist/embedding-encoder/index.mjs

@@ -1,4 +1,4 @@
-import { O as PoolMemoryWatchdog, Q as embeddingEncoderCapability, dt as resolvePoolMemoryPolicy, ot as parseProcStatus, tt as hfModelUrl, yt as BaseAddon } from "../dist-CZm8slPB.mjs";
+import { O as PoolMemoryWatchdog, Q as embeddingEncoderCapability, dt as resolvePoolMemoryPolicy, ot as parseProcStatus, tt as hfModelUrl, yt as BaseAddon } from "../dist-IZLiqXRa.mjs";
 import { createRequire } from "node:module";
 import * as fs from "node:fs";
 import "node:fs";

package/dist/pipeline-analytics/{_virtual_mf-localSharedImportMap___mfe_internal__addon_pipeline_analytics_widgets-MP5xue-m.mjs → _virtual_mf-localSharedImportMap___mfe_internal__addon_pipeline_analytics_widgets-D8fRo8aP.mjs}

@@ -18,7 +18,7 @@ var e = {
 	},
 	"@camstack/types": {
 		name: "@camstack/types",
-		version: "1.2.92",
+		version: "1.2.93",
 		scope: ["default"],
 		loaded: !1,
 		from: "addon_pipeline_analytics_widgets",

package/dist/pipeline-analytics/{hostInit-CkptLue6.mjs → hostInit-7agPxY0d.mjs}

@@ -36,7 +36,7 @@ async function r() {
 				}
 			},
 			"@camstack/types": {
-				version: "1.2.92",
+				version: "1.2.93",
 				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-BwxXdV9d.js");
+const require_dist = require("../dist-KXhjlCmh.js");
 let node_fs = require("node:fs");
 node_fs = require_dist.__toESM(node_fs, 1);
 let node_path = require("node:path");
@@ -8302,6 +8302,10 @@ var en_default = {
 		"one": "plate",
 		"other": "plates"
 	},
+	"class.audio": {
+		"one": "sound",
+		"other": "sounds"
+	},
 	"class.other": "{{name}}",
 	"group.others.person": {
 		"one": "{{count}} other person",
@@ -8520,6 +8524,10 @@ var it_default = {
 		"one": "targa",
 		"other": "targhe"
 	},
+	"class.audio": {
+		"one": "suono",
+		"other": "suoni"
+	},
 	"class.other": "{{name}}",
 	"group.others.person": {
 		"one": "{{count}} altra persona",
@@ -18163,7 +18171,7 @@ function applyTemplatePatch(merged, template) {
 	return withoutTemplate;
 }
 /** Narrowing guard — the persisted `rule` column is `unknown` until parsed. */
-function isRecord$1(value) {
+function isRecord$2(value) {
 	return typeof value === "object" && value !== null && !Array.isArray(value);
 }
 /**
@@ -18193,7 +18201,7 @@ function isRecord$1(value) {
 * the same reason.
 */
 function withCreatedAt(rowId, raw, synthesised, now) {
-	if (!isRecord$1(raw)) return raw;
+	if (!isRecord$2(raw)) return raw;
 	if (typeof raw["createdAt"] === "number") return raw;
 	const stamped = synthesised.get(rowId) ?? now();
 	synthesised.set(rowId, stamped);
@@ -25198,7 +25206,16 @@ function clamp01$1(x) {
 	if (x > 1) return 1;
 	return x;
 }
-/** Rank a class name into [0,1] by how event-worthy it is. Case-insensitive. */
+/**
+* Rank a class name into [0,1] by how event-worthy it is. Case-insensitive.
+*
+* `audio` falls through to {@link CLASS_RANK_DEFAULT} on purpose — a sound is
+* not a subject in frame. Before D189 an audio episode carried the HEARD class
+* here, so `dog`/`cat`/`animal` landed in {@link ANIMAL_CLASSES} and a bark
+* ranked as if an animal had walked past, while `speech` (500 of the 576 audio
+* rows measured live) already ranked default. That boost was an accident of the
+* class collision, not a decision. Pinned by `key-event-scoring.spec.ts`.
+*/
 function classRank(className) {
 	const c = className.toLowerCase();
 	if (PERSON_CLASSES.has(c)) return 1;
@@ -40540,10 +40557,38 @@ function buildRecordedStillPorts(input) {
 		})
 	};
 }
-/** Where the completion marker lives. */
+/**
+* Where the completion marker lives.
+*
+* @durable class=config owner=pipeline-analytics
+*   write="one marker row when a boot migration completes; overwritten only by
+*     a re-run of the same migration"
+*   loss="a re-scan of the analytics store on the next boot — idempotent,
+*     never destructive"
+*   retention="never pruned: one row per completed migration, bounded by the
+*     number of migrations ever written (two today)"
+*/
 var MIGRATION_MARKER_COLLECTION = "pipeline-analytics:migrations";
 var MIGRATION_MARKER_KEY = "label-tier-4g";
 /**
+* The owner declares its marker collection — like every other store in this
+* addon. KV shape (a single `data` column: `get`/`set` route the value as a
+* JSON blob; the engine adds the implicit `id` primary key). This declaration
+* never existed, so the engine refused every marker write, the catch below
+* warned, and every boot re-scanned the full analytics store — ~36k rows per
+* boot from the day the migration shipped.
+*/
+async function declareMigrationMarkers(store) {
+	await store.declareCollection.mutate({
+		collection: MIGRATION_MARKER_COLLECTION,
+		columns: [{
+			name: "data",
+			type: "TEXT",
+			notNull: true
+		}]
+	});
+}
+/**
 * The decision for ONE row, exposed so the rule is testable without a store.
 *
 * `null` = leave the row alone.
@@ -43702,11 +43747,11 @@ function rowToSensorEvent(id, data) {
 		deviceId: Number(data["deviceId"]),
 		sourceDeviceId: Number(data["sourceDeviceId"]),
 		kind: String(data["kind"]),
-		value: isRecord(value) ? value : null,
+		value: isRecord$1(value) ? value : null,
 		timestamp: Number(data["timestamp"])
 	};
 }
-function isRecord(x) {
+function isRecord$1(x) {
 	return x !== null && typeof x === "object" && !Array.isArray(x);
 }
 /**
@@ -43724,6 +43769,47 @@ function canRollbackSnapshot(mark, currentLastSnapshotAt) {
 	return mark.priorRollbacks < 3;
 }
 //#endregion
+//#region src/pipeline-analytics/store/audio-track-class.ts
+/** The taxonomy macro every audio-sourced track carries as its class. */
+var AUDIO_TRACK_CLASS = "audio";
+/**
+* True when this row predates the contract: audio-sourced, but carrying a
+* naked audio macro as its class.
+*
+* Deliberately NOT "className is in AUDIO_MACRO_LABELS" — an id added to the
+* vocabulary after a row was written would then read as modern forever. The
+* question is the simple one: is this an audio row that does not say `audio`?
+*/
+function isLegacyAudioTrackClass(track) {
+	return track.source === "audio" && track.className !== "audio";
+}
+/**
+* Bring a hydrated row up to the contract. Returns the SAME reference when
+* there is nothing to do, so the hot path (every non-audio track, and every
+* audio track written after this shipped) allocates nothing.
+*
+* The naked class is preserved as an `audioLabels` entry when — and only when
+* — the row carries none. On the 576 legacy rows measured on the live hub that
+* branch is unreachable (all of them have labels); it exists so the rewrite
+* can never be the step that DESTROYS the only copy of what was heard.
+*/
+function normalizeAudioTrackClass(track) {
+	if (!isLegacyAudioTrackClass(track)) return track;
+	const heard = {
+		label: track.className,
+		peakScore: 0,
+		count: 1,
+		firstAt: track.firstSeen,
+		lastAt: track.lastSeen
+	};
+	const audioLabels = track.audioLabels !== void 0 && track.audioLabels.length > 0 ? track.audioLabels : [heard];
+	return {
+		...track,
+		className: AUDIO_TRACK_CLASS,
+		audioLabels
+	};
+}
+//#endregion
 //#region src/pipeline-analytics/store/recent-cursor.ts
 function encodeRecentCursor(cursor) {
 	return Buffer.from(JSON.stringify({
@@ -44023,6 +44109,24 @@ var TRACKS_INDEXES = [{
 	name: "idx_tracks_device_firstSeen",
 	columns: ["deviceId", "firstSeen"]
 }];
+function isRecord(v) {
+	return typeof v === "object" && v !== null;
+}
+/** Validate the JSON column back into `Track.audioLabels` — a malformed row
+*  yields null rather than a lying shape (this column now carries the meaning
+*  of an audio row, D189; it must not be trusted by assertion). */
+function readAudioLabels(v) {
+	if (!Array.isArray(v)) return null;
+	const out = [];
+	for (const e of v) if (isRecord(e) && typeof e["label"] === "string" && typeof e["peakScore"] === "number" && typeof e["count"] === "number" && typeof e["firstAt"] === "number" && typeof e["lastAt"] === "number") out.push({
+		label: e["label"],
+		peakScore: e["peakScore"],
+		count: e["count"],
+		firstAt: e["firstAt"],
+		lastAt: e["lastAt"]
+	});
+	return out.length > 0 ? out : null;
+}
 /** Serialize the per-label aggregate map into the `Track.audioLabels`
 *  array shape, most-frequent label first. */
 function audioLabelsToArray(agg) {
@@ -45223,8 +45327,9 @@ var TrackStore = class {
 			});
 			const names = /* @__PURE__ */ new Set();
 			for (const r of rows) {
+				const isAudio = r.data["source"] === "audio";
 				const className = r.data["className"];
-				if (typeof className === "string" && className.length > 0) names.add(className);
+				if (typeof className === "string" && className.length > 0) names.add(isAudio ? AUDIO_TRACK_CLASS : className);
 				const classes = r.data["classes"];
 				if (Array.isArray(classes)) {
 					for (const c of classes) if (typeof c === "string" && c.length > 0) names.add(c);
@@ -45353,7 +45458,7 @@ var TrackStore = class {
 		const importance = data["importance"];
 		const bestEventId = data["bestEventId"];
 		const importanceReason = data["importanceReason"];
-		const audioLabels = data["audioLabels"];
+		const audioLabels = readAudioLabels(data["audioLabels"]);
 		const retrainParsed = require_dist.RetrainStatusSchema.safeParse(data["retrainStatus"]);
 		const debug = data["debug"];
 		const favourited = data["favourited"];
@@ -45371,7 +45476,7 @@ var TrackStore = class {
 			maxX: envMaxX,
 			maxY: envMaxY
 		} : null;
-		return {
+		return normalizeAudioTrackClass({
 			trackId: id,
 			deviceId: Number(data["deviceId"]),
 			className: String(data["className"]),
@@ -45402,7 +45507,7 @@ var TrackStore = class {
 			...closedReason !== void 0 ? { closedReason } : {},
 			observations,
 			...envelope !== null ? { envelope } : {}
-		};
+		});
 	}
 };
 //#endregion
@@ -47735,7 +47840,7 @@ var AudioMarkerProjector = class {
 				cameraId: deviceId,
 				sourceDeviceId: deviceId,
 				source: "audio",
-				kind: "audio",
+				kind: AUDIO_TRACK_CLASS,
 				timestamp: timestampMs,
 				...audioLabels !== void 0 ? { audioLabels } : {}
 			});
@@ -48943,6 +49048,23 @@ async function projectSensorMarkers(deps, data, timestamp) {
 * {@link isSpatialTrack}.
 */
 var DEFAULT_DEBOUNCE_MS = 1e4;
+/**
+* What the debounce treats as "the same event happening again".
+*
+* `(camera, kind)` — plus, for an audio row, the class HEARD. Since D189 every
+* audio row carries `kind: 'audio'` and puts the class on `audioLabels`, so
+* keying on `kind` alone would collapse this to one bucket per camera. The
+* episode hysteresis cools down PER CLASS, so a bark three seconds after speech
+* is a legitimate second episode — and a per-camera bucket would drop it.
+*
+* Only the FIRST label is used: a materialize carries the one class the episode
+* opened on. Joining all of them would make `[speech]` and `[speech, dog]`
+* different buckets, which is the opposite of what a debounce is for.
+*/
+function debounceKey(input) {
+	const heard = input.audioLabels?.[0]?.label;
+	return heard === void 0 ? `${input.cameraId}:${input.kind}` : `${input.cameraId}:${input.kind}:${heard}`;
+}
 /** A hanging snapshot cap must not stall the sensor state-change path. */
 var DEFAULT_SNAPSHOT_TIMEOUT_MS = 1e4;
 /** Distinguishes a snapshot-cap timeout from a fetch failure for reporting. */
@@ -48985,7 +49107,7 @@ var SyntheticTrackMaterializer = class {
 	snapshotTimeoutMs;
 	makeId;
 	now;
-	/** Last snapshot time per `${cameraId}:${kind}`. */
+	/** Last snapshot time per {@link debounceKey}. */
 	lastAt = /* @__PURE__ */ new Map();
 	constructor(deps) {
 		this.deps = deps;
@@ -49024,7 +49146,7 @@ var SyntheticTrackMaterializer = class {
 	* still lands a track (with no media) — it never blocks the durable record.
 	*/
 	async materialize(input) {
-		const key = `${input.cameraId}:${input.kind}`;
+		const key = debounceKey(input);
 		const last = this.lastAt.get(key);
 		if (last !== void 0 && this.now() - last < this.debounceMs) return null;
 		this.lastAt.set(key, this.now());
@@ -50591,6 +50713,126 @@ function evaluatePeriodicSnapshot(input) {
 		movedFraction
 	};
 }
+/** Where the completion marker lives — the SAME collection
+*  `runLabelTierMigration` owns and classifies; referencing the constant
+*  instead of repeating the literal keeps one declarer for the guards. */
+var AUDIO_CLASS_MIGRATION_MARKER_COLLECTION = MIGRATION_MARKER_COLLECTION;
+var AUDIO_CLASS_MIGRATION_MARKER_KEY = "audio-track-class-d189";
+/**
+* The decision for ONE stored row, exposed so the rule is testable without a
+* store. `null` = leave the row alone.
+*
+* Reads the RAW row rather than a hydrated `Track` on purpose: this is the
+* column the pass rewrites, and hydrating through `rowToTrack` would apply the
+* read-side normalization and hide the very rows it is looking for.
+*/
+function decideAudioClassRowMigration(data) {
+	if (data["source"] !== "audio") return null;
+	const className = data["className"];
+	if (typeof className !== "string" || className.length === 0) return null;
+	if (className === "audio") return null;
+	const stored = data["audioLabels"];
+	if (Array.isArray(stored) && stored.length > 0) return { className: AUDIO_TRACK_CLASS };
+	const firstSeen = typeof data["firstSeen"] === "number" ? data["firstSeen"] : 0;
+	return {
+		className: AUDIO_TRACK_CLASS,
+		audioLabels: [{
+			label: className,
+			peakScore: 0,
+			count: 1,
+			firstAt: firstSeen,
+			lastAt: typeof data["lastSeen"] === "number" ? data["lastSeen"] : firstSeen
+		}]
+	};
+}
+/**
+* Run the pass over the tracks collection, once.
+*
+* The marker short-circuits a completed migration; it is written only when the
+* pass did NOT truncate, so an interrupted run resumes on the next boot instead
+* of declaring itself done.
+*/
+async function runAudioTrackClassMigration(deps, collection) {
+	try {
+		const marker = await deps.store.get.query({
+			collection: AUDIO_CLASS_MIGRATION_MARKER_COLLECTION,
+			key: AUDIO_CLASS_MIGRATION_MARKER_KEY
+		});
+		if (marker !== null && marker !== void 0) return null;
+	} catch {}
+	let scanned = 0;
+	let rewritten = 0;
+	let labelsRecovered = 0;
+	let skipped = 0;
+	let offset = 0;
+	let truncated = false;
+	for (;;) {
+		if (scanned >= 2e5) {
+			truncated = true;
+			break;
+		}
+		const rows = await deps.store.query.query({
+			collection,
+			filter: {
+				limit: 500,
+				offset
+			}
+		});
+		if (rows.length === 0) break;
+		for (const row of rows) {
+			scanned++;
+			const patch = decideAudioClassRowMigration(row.data);
+			if (patch === null) {
+				skipped++;
+				continue;
+			}
+			const deviceId = typeof row.data["deviceId"] === "number" ? row.data["deviceId"] : void 0;
+			try {
+				await deps.store.update.mutate({
+					collection,
+					id: row.id,
+					data: patch
+				});
+				rewritten++;
+				if (patch["audioLabels"] !== void 0) labelsRecovered++;
+			} catch (err) {
+				deps.logger.warn("audio track class migration row failed", {
+					...deviceId !== void 0 ? { tags: { deviceId } } : {},
+					meta: {
+						collection,
+						id: row.id,
+						error: err instanceof Error ? err.message : String(err)
+					}
+				});
+				skipped++;
+			}
+		}
+		if (rows.length < 500) break;
+		offset += rows.length;
+	}
+	if (!truncated) try {
+		await deps.store.set.mutate({
+			collection: AUDIO_CLASS_MIGRATION_MARKER_COLLECTION,
+			key: AUDIO_CLASS_MIGRATION_MARKER_KEY,
+			value: {
+				completedAt: deps.now(),
+				rewritten
+			}
+		});
+	} catch (err) {
+		deps.logger.warn("audio track class migration marker failed", { meta: { error: err instanceof Error ? err.message : String(err) } });
+	}
+	const stats = {
+		collection,
+		scanned,
+		rewritten,
+		labelsRecovered,
+		skipped,
+		truncated
+	};
+	deps.logger.info("audio track class migration", { meta: { ...stats } });
+	return stats;
+}
 //#endregion
 //#region src/pipeline-analytics/store/object-embedding-store.ts
 /**
@@ -53009,7 +53251,8 @@ var PipelineAnalyticsAddon = class extends require_dist.BaseAddon {
 			AnalyticsLts.declare(api.settingsStore),
 			SceneStore.declare(api.settingsStore),
 			NotificationCenter.declare(api.settingsStore),
-			ViewerSettingsSnapshotStore.declare(api.settingsStore)
+			ViewerSettingsSnapshotStore.declare(api.settingsStore),
+			declareMigrationMarkers(api.settingsStore)
 		]);
 		this.viewerSettingsSnapshots = new ViewerSettingsSnapshotStore(api.settingsStore);
 		try {
@@ -53027,6 +53270,13 @@ var PipelineAnalyticsAddon = class extends require_dist.BaseAddon {
 		}, [TRACKS_COLLECTION, OBJECT_EVENTS_COLLECTION]).catch((err) => {
 			this.ctx.logger.warn("label tier migration failed — will retry next boot", { meta: { error: err instanceof Error ? err.message : String(err) } });
 		});
+		runAudioTrackClassMigration({
+			store: api.settingsStore,
+			logger: this.ctx.logger,
+			now: () => Date.now()
+		}, TRACKS_COLLECTION).catch((err) => {
+			this.ctx.logger.warn("audio track class migration failed — will retry next boot", { meta: { error: err instanceof Error ? err.message : String(err) } });
+		});
 	}
 	/** Event-media storage. By default it uses `ctx.kernel.storage`, rooted at
 	*  the node data dir (appData) → heavy thumbnail/track-frame churn hammers
@@ -56302,7 +56552,7 @@ var PipelineAnalyticsAddon = class extends require_dist.BaseAddon {
 				cameraId: input.deviceId,
 				sourceDeviceId: input.deviceId,
 				source: "audio",
-				kind: ref.className,
+				kind: AUDIO_TRACK_CLASS,
 				timestamp: input.timestamp,
 				audioLabels: [{
 					label: ref.className,

package/dist/pipeline-analytics/index.mjs

@@ -1,4 +1,4 @@
-import { $ as encodeVectorBase64, A as RetrainStatusSchema, At as literal, B as TrackSourceSchema, C as NcSnoozeSchema, Ct as isDeviceScopedCap, D as OpsLogEntrySchema, Dt as array, E as NcTaxonomySchema, Et as _enum, F as SceneMonitorSchema, Ft as string, G as audioMetricsCapability, H as addonWidgetsSourceCapability, I as TIMELAPSE_DENSE_FLOOR_SEC, It as unknown, J as cosineSimilarity$1, K as audioModeOf, L as TimelapseRuleInputSchema, Lt as EventCategory, M as SCENE_DEFAULT_ANCHOR_THRESHOLD, Mt as object, N as SCENE_DEFAULT_UNCOVERED_POLICY, Nt as partialRecord, Ot as boolean, P as SCENE_DIVERGED, Pt as record, R as TimelapseRulePatchSchema, S as NcSnoozeInputSchema, St as hydrateSchema, T as NcSystemEventKindSchema, Tt as sleep, U as alarmPanelCapability, V as VISIT_MERGE_GAP_MS, W as assertTimelapseCadences, X as defineCustomActions, Y as customAction, Z as deriveRecordingMode, _ as NcRuleInputSchema, _t as zoneAnalyticsCapability, at as notificationRulesCapability, b as NcRuleTargetSchema, bt as DeviceType, c as EVENT_PAD_MS, ct as plateGalleryCapability, d as NC_ALARM_SYSTEM_EVENT_KINDS, et as faceGalleryCapability, f as NC_CONDITION_CATALOG, ft as sceneMonitorCapability, g as NcConditionDescriptorSchema, gt as videoclipsCapability, h as NC_TAXONOMY, ht as vectorDimFromBase64, i as DETECTION_MACRO_CLASSES, it as kebabToCamel, jt as number, k as RECORDING_EXPORT_MAX_READ_BYTES, kt as discriminatedUnion, l as LabelAttributionSchema, lt as readDeviceStateFrom, mt as systemEventFilterApplies, n as DEFAULT_EVENT_COLOR, nt as isDetectionMacroClass, o as DeclaredDevices, p as NC_DEFAULT_SNOOZE_MINUTES, pt as subKindsOf, q as buildEventKindDescriptor, rt as isScheduleActive, s as EVENT_KIND_BY_CAP, st as pipelineAnalyticsCapability, t as BaseDevice, u as MACRO_LABELS, ut as readTimelapseGeneratedAt, v as NcRulePatchSchema, vt as errMsg, w as NcSnoozeSuppressedSchema, wt as nodePin, x as NcScheduleSchema, xt as createEvent, y as NcRuleSchema, yt as BaseAddon, z as TimelapseRuleSchema } from "../dist-CZm8slPB.mjs";
+import { $ as encodeVectorBase64, A as RetrainStatusSchema, At as literal, B as TrackSourceSchema, C as NcSnoozeSchema, Ct as isDeviceScopedCap, D as OpsLogEntrySchema, Dt as array, E as NcTaxonomySchema, Et as _enum, F as SceneMonitorSchema, Ft as string, G as audioMetricsCapability, H as addonWidgetsSourceCapability, I as TIMELAPSE_DENSE_FLOOR_SEC, It as unknown, J as cosineSimilarity$1, K as audioModeOf, L as TimelapseRuleInputSchema, Lt as EventCategory, M as SCENE_DEFAULT_ANCHOR_THRESHOLD, Mt as object, N as SCENE_DEFAULT_UNCOVERED_POLICY, Nt as partialRecord, Ot as boolean, P as SCENE_DIVERGED, Pt as record, R as TimelapseRulePatchSchema, S as NcSnoozeInputSchema, St as hydrateSchema, T as NcSystemEventKindSchema, Tt as sleep, U as alarmPanelCapability, V as VISIT_MERGE_GAP_MS, W as assertTimelapseCadences, X as defineCustomActions, Y as customAction, Z as deriveRecordingMode, _ as NcRuleInputSchema, _t as zoneAnalyticsCapability, at as notificationRulesCapability, b as NcRuleTargetSchema, bt as DeviceType, c as EVENT_PAD_MS, ct as plateGalleryCapability, d as NC_ALARM_SYSTEM_EVENT_KINDS, et as faceGalleryCapability, f as NC_CONDITION_CATALOG, ft as sceneMonitorCapability, g as NcConditionDescriptorSchema, gt as videoclipsCapability, h as NC_TAXONOMY, ht as vectorDimFromBase64, i as DETECTION_MACRO_CLASSES, it as kebabToCamel, jt as number, k as RECORDING_EXPORT_MAX_READ_BYTES, kt as discriminatedUnion, l as LabelAttributionSchema, lt as readDeviceStateFrom, mt as systemEventFilterApplies, n as DEFAULT_EVENT_COLOR, nt as isDetectionMacroClass, o as DeclaredDevices, p as NC_DEFAULT_SNOOZE_MINUTES, pt as subKindsOf, q as buildEventKindDescriptor, rt as isScheduleActive, s as EVENT_KIND_BY_CAP, st as pipelineAnalyticsCapability, t as BaseDevice, u as MACRO_LABELS, ut as readTimelapseGeneratedAt, v as NcRulePatchSchema, vt as errMsg, w as NcSnoozeSuppressedSchema, wt as nodePin, x as NcScheduleSchema, xt as createEvent, y as NcRuleSchema, yt as BaseAddon, z as TimelapseRuleSchema } from "../dist-IZLiqXRa.mjs";
 import { t as __exportAll } from "../embedding-encoder/index.mjs";
 import * as fs from "node:fs";
 import { promises } from "node:fs";
@@ -8295,6 +8295,10 @@ var en_default = {
 		"one": "plate",
 		"other": "plates"
 	},
+	"class.audio": {
+		"one": "sound",
+		"other": "sounds"
+	},
 	"class.other": "{{name}}",
 	"group.others.person": {
 		"one": "{{count}} other person",
@@ -8513,6 +8517,10 @@ var it_default = {
 		"one": "targa",
 		"other": "targhe"
 	},
+	"class.audio": {
+		"one": "suono",
+		"other": "suoni"
+	},
 	"class.other": "{{name}}",
 	"group.others.person": {
 		"one": "{{count}} altra persona",
@@ -18141,7 +18149,7 @@ function applyTemplatePatch(merged, template) {
 	return withoutTemplate;
 }
 /** Narrowing guard — the persisted `rule` column is `unknown` until parsed. */
-function isRecord$1(value) {
+function isRecord$2(value) {
 	return typeof value === "object" && value !== null && !Array.isArray(value);
 }
 /**
@@ -18171,7 +18179,7 @@ function isRecord$1(value) {
 * the same reason.
 */
 function withCreatedAt(rowId, raw, synthesised, now) {
-	if (!isRecord$1(raw)) return raw;
+	if (!isRecord$2(raw)) return raw;
 	if (typeof raw["createdAt"] === "number") return raw;
 	const stamped = synthesised.get(rowId) ?? now();
 	synthesised.set(rowId, stamped);
@@ -25176,7 +25184,16 @@ function clamp01$1(x) {
 	if (x > 1) return 1;
 	return x;
 }
-/** Rank a class name into [0,1] by how event-worthy it is. Case-insensitive. */
+/**
+* Rank a class name into [0,1] by how event-worthy it is. Case-insensitive.
+*
+* `audio` falls through to {@link CLASS_RANK_DEFAULT} on purpose — a sound is
+* not a subject in frame. Before D189 an audio episode carried the HEARD class
+* here, so `dog`/`cat`/`animal` landed in {@link ANIMAL_CLASSES} and a bark
+* ranked as if an animal had walked past, while `speech` (500 of the 576 audio
+* rows measured live) already ranked default. That boost was an accident of the
+* class collision, not a decision. Pinned by `key-event-scoring.spec.ts`.
+*/
 function classRank(className) {
 	const c = className.toLowerCase();
 	if (PERSON_CLASSES.has(c)) return 1;
@@ -40480,10 +40497,38 @@ function buildRecordedStillPorts(input) {
 		})
 	};
 }
-/** Where the completion marker lives. */
+/**
+* Where the completion marker lives.
+*
+* @durable class=config owner=pipeline-analytics
+*   write="one marker row when a boot migration completes; overwritten only by
+*     a re-run of the same migration"
+*   loss="a re-scan of the analytics store on the next boot — idempotent,
+*     never destructive"
+*   retention="never pruned: one row per completed migration, bounded by the
+*     number of migrations ever written (two today)"
+*/
 var MIGRATION_MARKER_COLLECTION = "pipeline-analytics:migrations";
 var MIGRATION_MARKER_KEY = "label-tier-4g";
 /**
+* The owner declares its marker collection — like every other store in this
+* addon. KV shape (a single `data` column: `get`/`set` route the value as a
+* JSON blob; the engine adds the implicit `id` primary key). This declaration
+* never existed, so the engine refused every marker write, the catch below
+* warned, and every boot re-scanned the full analytics store — ~36k rows per
+* boot from the day the migration shipped.
+*/
+async function declareMigrationMarkers(store) {
+	await store.declareCollection.mutate({
+		collection: MIGRATION_MARKER_COLLECTION,
+		columns: [{
+			name: "data",
+			type: "TEXT",
+			notNull: true
+		}]
+	});
+}
+/**
 * The decision for ONE row, exposed so the rule is testable without a store.
 *
 * `null` = leave the row alone.
@@ -43642,11 +43687,11 @@ function rowToSensorEvent(id, data) {
 		deviceId: Number(data["deviceId"]),
 		sourceDeviceId: Number(data["sourceDeviceId"]),
 		kind: String(data["kind"]),
-		value: isRecord(value) ? value : null,
+		value: isRecord$1(value) ? value : null,
 		timestamp: Number(data["timestamp"])
 	};
 }
-function isRecord(x) {
+function isRecord$1(x) {
 	return x !== null && typeof x === "object" && !Array.isArray(x);
 }
 /**
@@ -43664,6 +43709,47 @@ function canRollbackSnapshot(mark, currentLastSnapshotAt) {
 	return mark.priorRollbacks < 3;
 }
 //#endregion
+//#region src/pipeline-analytics/store/audio-track-class.ts
+/** The taxonomy macro every audio-sourced track carries as its class. */
+var AUDIO_TRACK_CLASS = "audio";
+/**
+* True when this row predates the contract: audio-sourced, but carrying a
+* naked audio macro as its class.
+*
+* Deliberately NOT "className is in AUDIO_MACRO_LABELS" — an id added to the
+* vocabulary after a row was written would then read as modern forever. The
+* question is the simple one: is this an audio row that does not say `audio`?
+*/
+function isLegacyAudioTrackClass(track) {
+	return track.source === "audio" && track.className !== "audio";
+}
+/**
+* Bring a hydrated row up to the contract. Returns the SAME reference when
+* there is nothing to do, so the hot path (every non-audio track, and every
+* audio track written after this shipped) allocates nothing.
+*
+* The naked class is preserved as an `audioLabels` entry when — and only when
+* — the row carries none. On the 576 legacy rows measured on the live hub that
+* branch is unreachable (all of them have labels); it exists so the rewrite
+* can never be the step that DESTROYS the only copy of what was heard.
+*/
+function normalizeAudioTrackClass(track) {
+	if (!isLegacyAudioTrackClass(track)) return track;
+	const heard = {
+		label: track.className,
+		peakScore: 0,
+		count: 1,
+		firstAt: track.firstSeen,
+		lastAt: track.lastSeen
+	};
+	const audioLabels = track.audioLabels !== void 0 && track.audioLabels.length > 0 ? track.audioLabels : [heard];
+	return {
+		...track,
+		className: AUDIO_TRACK_CLASS,
+		audioLabels
+	};
+}
+//#endregion
 //#region src/pipeline-analytics/store/recent-cursor.ts
 function encodeRecentCursor(cursor) {
 	return Buffer.from(JSON.stringify({
@@ -43963,6 +44049,24 @@ var TRACKS_INDEXES = [{
 	name: "idx_tracks_device_firstSeen",
 	columns: ["deviceId", "firstSeen"]
 }];
+function isRecord(v) {
+	return typeof v === "object" && v !== null;
+}
+/** Validate the JSON column back into `Track.audioLabels` — a malformed row
+*  yields null rather than a lying shape (this column now carries the meaning
+*  of an audio row, D189; it must not be trusted by assertion). */
+function readAudioLabels(v) {
+	if (!Array.isArray(v)) return null;
+	const out = [];
+	for (const e of v) if (isRecord(e) && typeof e["label"] === "string" && typeof e["peakScore"] === "number" && typeof e["count"] === "number" && typeof e["firstAt"] === "number" && typeof e["lastAt"] === "number") out.push({
+		label: e["label"],
+		peakScore: e["peakScore"],
+		count: e["count"],
+		firstAt: e["firstAt"],
+		lastAt: e["lastAt"]
+	});
+	return out.length > 0 ? out : null;
+}
 /** Serialize the per-label aggregate map into the `Track.audioLabels`
 *  array shape, most-frequent label first. */
 function audioLabelsToArray(agg) {
@@ -45163,8 +45267,9 @@ var TrackStore = class {
 			});
 			const names = /* @__PURE__ */ new Set();
 			for (const r of rows) {
+				const isAudio = r.data["source"] === "audio";
 				const className = r.data["className"];
-				if (typeof className === "string" && className.length > 0) names.add(className);
+				if (typeof className === "string" && className.length > 0) names.add(isAudio ? AUDIO_TRACK_CLASS : className);
 				const classes = r.data["classes"];
 				if (Array.isArray(classes)) {
 					for (const c of classes) if (typeof c === "string" && c.length > 0) names.add(c);
@@ -45293,7 +45398,7 @@ var TrackStore = class {
 		const importance = data["importance"];
 		const bestEventId = data["bestEventId"];
 		const importanceReason = data["importanceReason"];
-		const audioLabels = data["audioLabels"];
+		const audioLabels = readAudioLabels(data["audioLabels"]);
 		const retrainParsed = RetrainStatusSchema.safeParse(data["retrainStatus"]);
 		const debug = data["debug"];
 		const favourited = data["favourited"];
@@ -45311,7 +45416,7 @@ var TrackStore = class {
 			maxX: envMaxX,
 			maxY: envMaxY
 		} : null;
-		return {
+		return normalizeAudioTrackClass({
 			trackId: id,
 			deviceId: Number(data["deviceId"]),
 			className: String(data["className"]),
@@ -45342,7 +45447,7 @@ var TrackStore = class {
 			...closedReason !== void 0 ? { closedReason } : {},
 			observations,
 			...envelope !== null ? { envelope } : {}
-		};
+		});
 	}
 };
 //#endregion
@@ -47675,7 +47780,7 @@ var AudioMarkerProjector = class {
 				cameraId: deviceId,
 				sourceDeviceId: deviceId,
 				source: "audio",
-				kind: "audio",
+				kind: AUDIO_TRACK_CLASS,
 				timestamp: timestampMs,
 				...audioLabels !== void 0 ? { audioLabels } : {}
 			});
@@ -48883,6 +48988,23 @@ async function projectSensorMarkers(deps, data, timestamp) {
 * {@link isSpatialTrack}.
 */
 var DEFAULT_DEBOUNCE_MS = 1e4;
+/**
+* What the debounce treats as "the same event happening again".
+*
+* `(camera, kind)` — plus, for an audio row, the class HEARD. Since D189 every
+* audio row carries `kind: 'audio'` and puts the class on `audioLabels`, so
+* keying on `kind` alone would collapse this to one bucket per camera. The
+* episode hysteresis cools down PER CLASS, so a bark three seconds after speech
+* is a legitimate second episode — and a per-camera bucket would drop it.
+*
+* Only the FIRST label is used: a materialize carries the one class the episode
+* opened on. Joining all of them would make `[speech]` and `[speech, dog]`
+* different buckets, which is the opposite of what a debounce is for.
+*/
+function debounceKey(input) {
+	const heard = input.audioLabels?.[0]?.label;
+	return heard === void 0 ? `${input.cameraId}:${input.kind}` : `${input.cameraId}:${input.kind}:${heard}`;
+}
 /** A hanging snapshot cap must not stall the sensor state-change path. */
 var DEFAULT_SNAPSHOT_TIMEOUT_MS = 1e4;
 /** Distinguishes a snapshot-cap timeout from a fetch failure for reporting. */
@@ -48925,7 +49047,7 @@ var SyntheticTrackMaterializer = class {
 	snapshotTimeoutMs;
 	makeId;
 	now;
-	/** Last snapshot time per `${cameraId}:${kind}`. */
+	/** Last snapshot time per {@link debounceKey}. */
 	lastAt = /* @__PURE__ */ new Map();
 	constructor(deps) {
 		this.deps = deps;
@@ -48964,7 +49086,7 @@ var SyntheticTrackMaterializer = class {
 	* still lands a track (with no media) — it never blocks the durable record.
 	*/
 	async materialize(input) {
-		const key = `${input.cameraId}:${input.kind}`;
+		const key = debounceKey(input);
 		const last = this.lastAt.get(key);
 		if (last !== void 0 && this.now() - last < this.debounceMs) return null;
 		this.lastAt.set(key, this.now());
@@ -50531,6 +50653,126 @@ function evaluatePeriodicSnapshot(input) {
 		movedFraction
 	};
 }
+/** Where the completion marker lives — the SAME collection
+*  `runLabelTierMigration` owns and classifies; referencing the constant
+*  instead of repeating the literal keeps one declarer for the guards. */
+var AUDIO_CLASS_MIGRATION_MARKER_COLLECTION = MIGRATION_MARKER_COLLECTION;
+var AUDIO_CLASS_MIGRATION_MARKER_KEY = "audio-track-class-d189";
+/**
+* The decision for ONE stored row, exposed so the rule is testable without a
+* store. `null` = leave the row alone.
+*
+* Reads the RAW row rather than a hydrated `Track` on purpose: this is the
+* column the pass rewrites, and hydrating through `rowToTrack` would apply the
+* read-side normalization and hide the very rows it is looking for.
+*/
+function decideAudioClassRowMigration(data) {
+	if (data["source"] !== "audio") return null;
+	const className = data["className"];
+	if (typeof className !== "string" || className.length === 0) return null;
+	if (className === "audio") return null;
+	const stored = data["audioLabels"];
+	if (Array.isArray(stored) && stored.length > 0) return { className: AUDIO_TRACK_CLASS };
+	const firstSeen = typeof data["firstSeen"] === "number" ? data["firstSeen"] : 0;
+	return {
+		className: AUDIO_TRACK_CLASS,
+		audioLabels: [{
+			label: className,
+			peakScore: 0,
+			count: 1,
+			firstAt: firstSeen,
+			lastAt: typeof data["lastSeen"] === "number" ? data["lastSeen"] : firstSeen
+		}]
+	};
+}
+/**
+* Run the pass over the tracks collection, once.
+*
+* The marker short-circuits a completed migration; it is written only when the
+* pass did NOT truncate, so an interrupted run resumes on the next boot instead
+* of declaring itself done.
+*/
+async function runAudioTrackClassMigration(deps, collection) {
+	try {
+		const marker = await deps.store.get.query({
+			collection: AUDIO_CLASS_MIGRATION_MARKER_COLLECTION,
+			key: AUDIO_CLASS_MIGRATION_MARKER_KEY
+		});
+		if (marker !== null && marker !== void 0) return null;
+	} catch {}
+	let scanned = 0;
+	let rewritten = 0;
+	let labelsRecovered = 0;
+	let skipped = 0;
+	let offset = 0;
+	let truncated = false;
+	for (;;) {
+		if (scanned >= 2e5) {
+			truncated = true;
+			break;
+		}
+		const rows = await deps.store.query.query({
+			collection,
+			filter: {
+				limit: 500,
+				offset
+			}
+		});
+		if (rows.length === 0) break;
+		for (const row of rows) {
+			scanned++;
+			const patch = decideAudioClassRowMigration(row.data);
+			if (patch === null) {
+				skipped++;
+				continue;
+			}
+			const deviceId = typeof row.data["deviceId"] === "number" ? row.data["deviceId"] : void 0;
+			try {
+				await deps.store.update.mutate({
+					collection,
+					id: row.id,
+					data: patch
+				});
+				rewritten++;
+				if (patch["audioLabels"] !== void 0) labelsRecovered++;
+			} catch (err) {
+				deps.logger.warn("audio track class migration row failed", {
+					...deviceId !== void 0 ? { tags: { deviceId } } : {},
+					meta: {
+						collection,
+						id: row.id,
+						error: err instanceof Error ? err.message : String(err)
+					}
+				});
+				skipped++;
+			}
+		}
+		if (rows.length < 500) break;
+		offset += rows.length;
+	}
+	if (!truncated) try {
+		await deps.store.set.mutate({
+			collection: AUDIO_CLASS_MIGRATION_MARKER_COLLECTION,
+			key: AUDIO_CLASS_MIGRATION_MARKER_KEY,
+			value: {
+				completedAt: deps.now(),
+				rewritten
+			}
+		});
+	} catch (err) {
+		deps.logger.warn("audio track class migration marker failed", { meta: { error: err instanceof Error ? err.message : String(err) } });
+	}
+	const stats = {
+		collection,
+		scanned,
+		rewritten,
+		labelsRecovered,
+		skipped,
+		truncated
+	};
+	deps.logger.info("audio track class migration", { meta: { ...stats } });
+	return stats;
+}
 //#endregion
 //#region src/pipeline-analytics/store/object-embedding-store.ts
 /**
@@ -52949,7 +53191,8 @@ var PipelineAnalyticsAddon = class extends BaseAddon {
 			AnalyticsLts.declare(api.settingsStore),
 			SceneStore.declare(api.settingsStore),
 			NotificationCenter.declare(api.settingsStore),
-			ViewerSettingsSnapshotStore.declare(api.settingsStore)
+			ViewerSettingsSnapshotStore.declare(api.settingsStore),
+			declareMigrationMarkers(api.settingsStore)
 		]);
 		this.viewerSettingsSnapshots = new ViewerSettingsSnapshotStore(api.settingsStore);
 		try {
@@ -52967,6 +53210,13 @@ var PipelineAnalyticsAddon = class extends BaseAddon {
 		}, [TRACKS_COLLECTION, OBJECT_EVENTS_COLLECTION]).catch((err) => {
 			this.ctx.logger.warn("label tier migration failed — will retry next boot", { meta: { error: err instanceof Error ? err.message : String(err) } });
 		});
+		runAudioTrackClassMigration({
+			store: api.settingsStore,
+			logger: this.ctx.logger,
+			now: () => Date.now()
+		}, TRACKS_COLLECTION).catch((err) => {
+			this.ctx.logger.warn("audio track class migration failed — will retry next boot", { meta: { error: err instanceof Error ? err.message : String(err) } });
+		});
 	}
 	/** Event-media storage. By default it uses `ctx.kernel.storage`, rooted at
 	*  the node data dir (appData) → heavy thumbnail/track-frame churn hammers
@@ -56242,7 +56492,7 @@ var PipelineAnalyticsAddon = class extends BaseAddon {
 				cameraId: input.deviceId,
 				sourceDeviceId: input.deviceId,
 				source: "audio",
-				kind: ref.className,
+				kind: AUDIO_TRACK_CLASS,
 				timestamp: input.timestamp,
 				audioLabels: [{
 					label: ref.className,

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

package/package.json

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