@camstack/addon-post-analysis 1.2.102 → 1.2.103

package/dist/pipeline-analytics/index.js

@@ -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",
@@ -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;
@@ -40544,6 +40561,24 @@ function buildRecordedStillPorts(input) {
 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.
@@ -43724,6 +43759,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({
@@ -45371,7 +45447,7 @@ var TrackStore = class {
 			maxX: envMaxX,
 			maxY: envMaxY
 		} : null;
-		return {
+		return normalizeAudioTrackClass({
 			trackId: id,
 			deviceId: Number(data["deviceId"]),
 			className: String(data["className"]),
@@ -45402,7 +45478,7 @@ var TrackStore = class {
 			...closedReason !== void 0 ? { closedReason } : {},
 			observations,
 			...envelope !== null ? { envelope } : {}
-		};
+		});
 	}
 };
 //#endregion
@@ -47735,7 +47811,7 @@ var AudioMarkerProjector = class {
 				cameraId: deviceId,
 				sourceDeviceId: deviceId,
 				source: "audio",
-				kind: "audio",
+				kind: AUDIO_TRACK_CLASS,
 				timestamp: timestampMs,
 				...audioLabels !== void 0 ? { audioLabels } : {}
 			});
@@ -48943,6 +49019,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 +49078,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 +49117,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 +50684,125 @@ function evaluatePeriodicSnapshot(input) {
 		movedFraction
 	};
 }
+/** Where the completion marker lives — the collection `runLabelTierMigration`
+*  already established for exactly this. */
+var AUDIO_CLASS_MIGRATION_MARKER_COLLECTION = "pipeline-analytics:migrations";
+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 +53221,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 +53240,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 +56522,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

@@ -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",
@@ -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;
@@ -40484,6 +40501,24 @@ function buildRecordedStillPorts(input) {
 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.
@@ -43664,6 +43699,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({
@@ -45311,7 +45387,7 @@ var TrackStore = class {
 			maxX: envMaxX,
 			maxY: envMaxY
 		} : null;
-		return {
+		return normalizeAudioTrackClass({
 			trackId: id,
 			deviceId: Number(data["deviceId"]),
 			className: String(data["className"]),
@@ -45342,7 +45418,7 @@ var TrackStore = class {
 			...closedReason !== void 0 ? { closedReason } : {},
 			observations,
 			...envelope !== null ? { envelope } : {}
-		};
+		});
 	}
 };
 //#endregion
@@ -47675,7 +47751,7 @@ var AudioMarkerProjector = class {
 				cameraId: deviceId,
 				sourceDeviceId: deviceId,
 				source: "audio",
-				kind: "audio",
+				kind: AUDIO_TRACK_CLASS,
 				timestamp: timestampMs,
 				...audioLabels !== void 0 ? { audioLabels } : {}
 			});
@@ -48883,6 +48959,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 +49018,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 +49057,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 +50624,125 @@ function evaluatePeriodicSnapshot(input) {
 		movedFraction
 	};
 }
+/** Where the completion marker lives — the collection `runLabelTierMigration`
+*  already established for exactly this. */
+var AUDIO_CLASS_MIGRATION_MARKER_COLLECTION = "pipeline-analytics:migrations";
+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 +53161,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 +53180,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 +56462,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/package.json

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