@camstack/addon-post-analysis 1.2.302 → 1.2.304

package/dist/pipeline-analytics/index.mjs

@@ -1,4 +1,4 @@
-import { $ as NC_CLIP_RETENTION_MAX_SEC, $n as subKindsOf, $t as TrackPuritySchema, A as EVENT_KIND_BY_CAP, An as isScheduleActive, Ar as object, B as MAX_ARCHIVED_DEBUG_NOTES, Bn as pipelineAnalyticsCapability, Bt as SCENE_DEFAULT_QUIET_SECONDS, C as DETECTION_PIPELINE_CAP_NAME, Cn as failureContributionCapability, Cr as sleep$1, Ct as NcSystemEventKindSchema, D as EMBEDDING_REQUIREMENTS_FAILED, Dn as isEventOwnerType, Dr as discriminatedUnion, Dt as NcTemplateVarDescriptorSchema, E as EMBEDDING_MODEL_FAILED, En as isDetectionMacroClass, Er as boolean, Et as NcTemplatePreviewSchema, F as FailureCounters, Fn as mayWriteToLocation, Fr as tuple, Ft as SCENE_CONFIRM_DEFAULT_MAX_IMAGE_PX, G as MOTION_CLOSE_AFTER_MS, Gn as resolveClipSearchMinScore, Gt as SetTrackPurityInputSchema, H as MAX_BIRTH_LATENCY_PROXY_MS, Hn as readDeviceStateFrom, Ht as SCENE_DIVERGED, I as LabelAttributionSchema, In as memoizePinnedFfmpeg, Ir as union, It as SCENE_CONFIRM_DEFAULT_TIMEOUT_MS, J as NC_ALARM_SYSTEM_EVENT_KINDS, Jn as ruleBelongsToAlarm$1, Jt as TIMELAPSE_DENSE_FLOOR_SEC, K as MediaFileKindEnum, Kn as resolveLocationMode, Kt as SetTrackPurityResultSchema, L as ListTrackRelationsInputSchema, Ln as notificationRulesCapability, Lr as unknown, Lt as SCENE_DEFAULT_ANCHOR_THRESHOLD, M as EXPORT_DENSE_MAX_RANGES, Mn as isSystemEventSummaryRule, Mr as record, Mt as RECORDING_SOURCE_CAMSTACK_ADDON, N as FIRST_LEVEL_MACRO_CLASSES, Nn as isVectorIndexDimConflict, Nr as strictObject, Nt as RebuildObjectEmbeddingsRefusalSchema, O as EMBEDDING_REQUIREMENTS_UNAVAILABLE, On as isKnownTemplateVar, Or as literal, Ot as OPS_LOG_DEFAULT_LIMIT, P as FULL_IMAGE_BBOX, Pn as kebabToCamel, Pr as string, Pt as RetrainStatusSchema, Q as NC_CLIP_PRE_ROLL_DEFAULT_SEC, Qn as storageOccupancyCapability, Qt as TimelapseRuleSchema, R as ListTrackRelationsResultSchema, Rn as occupancyScope, Rr as EventCategory, Rt as SCENE_DEFAULT_CHECK_INTERVAL_SEC, S as DETECTION_MACRO_CLASSES, Sn as faceGalleryCapability, St as NcSnoozeSuppressedSchema, T as DetectionSourceSchema, Tn as gifFromMp4Args, Tr as array, Tt as NcTemplatePreviewInputSchema, U as MAX_TRACK_PURITIES, Un as readMotionTriggeredBy, Ut as SCENE_RESET_RECAPTURES, V as MAX_BIRTH_DECISION_RECORDS, Vn as plateGalleryCapability, Vt as SCENE_DEFAULT_UNCOVERED_POLICY, W as MAX_TRACK_RELATIONS, Wn as readTimelapseGeneratedAt, Wt as SceneMonitorSchema, X as NC_AUDIO_CONFIRM_WINDOW_SEC_DEFAULT, Xn as sensorRaisedOf, Xt as TimelapseRuleInputSchema, Y as NC_AUDIO_CONFIRM_HITS_DEFAULT, Yn as sceneMonitorCapability, Yt as TRACK_RELATIONS_DEFAULT_LIMIT, Z as NC_CLIP_POST_ROLL_DEFAULT_SEC, Zn as servedTemplateVars, Zt as TimelapseRulePatchSchema, _ as ClearTrackRelationInputSchema, _n as embeddingRefusalOf, _r as customAction, _t as NcRuleTargetSchema, a as CLIP_EMBEDDING_STEP_ID, an as alarmPanelCapability, ar as templateVarsFor, at as NC_SNOOZE_MAX_MINUTES, b as DEFAULT_EVENT_COLOR, bn as encodeVectorBase64, br as isDeviceScopedCap, bt as NcSnoozeInputSchema, c as resolveClusterModelPin, cn as audioModeOf, cr as DEFAULT_FIRST_SIGHTING_FRESHNESS_MS, ct as NC_TAXONOMY, d as AlarmArmModeSchema, dn as cosineSimilarity$1, dr as isSourceCap, dt as NcAlarmSettingsPatchSchema, en as TrackRelationKindSchema, er as systemEventDeliveryProblems, et as NC_CONDITION_CATALOG, f as ArchivedDebugNoteSchema, fn as deriveRecordingMode, fr as DeviceType, ft as NcConditionDescriptorSchema, g as COCO_TO_MACRO, gr as createEvent, gt as NcRuleSchema, h as BirthDecisionRecordSchema, hr as CamProfileSchema, ht as NcRulePatchSchema, in as addonWidgetsSourceCapability, ir as templateCarriesSummary, it as NC_SENSOR_TRANSITION_KINDS, j as EVENT_OWNER_TYPES, jn as isSystemDelivery, jr as partialRecord, jt as RECORDING_EXPORT_MAX_READ_BYTES, k as EVENT_DENSITY_BATCH_MAX, kn as isMediaOwnerType, kr as number, kt as OpsLogEntrySchema, l as ARCHIVED_DEBUG_NOTES_DEFAULT_LIMIT, ln as buildEventKindDescriptor, lr as canonicalHash, lt as NC_TEMPLATE_VARS, m as BaseDevice, mn as describeSystemEventFamilyProblem, mr as BaseAddon, mt as NcRuleInputSchema, nn as TrackSideSchema, nr as systemEventFilterApplies, nt as NC_CONSUMABLE_SYSTEM_EVENT_KINDS, o as FACE_EMBEDDING_STEP_ID, on as assertTimelapseCadences, or as vectorDimFromBase64, ot as NC_SYSTEM_EVENT_KIND_GROUP_SPECS, p as BIRTH_DECISION_DEFAULT_LIMIT, pn as describeSystemEventDeliveryProblem, pr as errMsg, pt as NcConditionsSchema, q as MotionTriggeredBySchema, qt as SetTrackRelationInputSchema, rn as TrackSourceSchema, rr as systemEventSummaryScheduleOf, rt as NC_DEFAULT_SNOOZE_MINUTES, s as readClusterModelPinStrict, sn as audioMetricsCapability, sr as zoneAnalyticsCapability, st as NC_TANK_SYSTEM_EVENT_KINDS, t as BUILTIN_CLIP_MODELS, tn as TrackRelationSchema, tr as systemEventFamilyProblems, tt as NC_CONSUMABLE_LOW_PERCENT_DEFAULT, u as AUDIO_MACRO_LABELS, un as consumableLowPercentOf, ur as evaluateSensorEdge, ut as NcAlarmConfigSchema, v as ClearTrackRelationResultSchema, vr as defineCustomActions, vt as NcRuleUpdateInputSchema, w as DeclaredDevices, wn as gifDeriveSpeed, wr as _enum, wt as NcTaxonomySchema, x as DEFAULT_TIMELAPSE_PREVIEW_TEXT, xn as evictionPolicyOfLocation, xr as nodePin, xt as NcSnoozeSchema, y as CoverStateSchema, yr as hydrateSchema, yt as NcScheduleSchema, z as LockStateSchema, zt as SCENE_DEFAULT_OBSERVATION_SPACING_SEC } from "../clip-model-registry-BtY4fS3d.mjs";
+import { $ as NC_CLIP_RETENTION_MAX_SEC, $n as storageOccupancyCapability, $t as TrackPuritySchema, A as EVENT_KIND_BY_CAP, An as isMediaOwnerType, Ar as number, B as MAX_ARCHIVED_DEBUG_NOTES, Bt as SCENE_DEFAULT_QUIET_SECONDS, C as DETECTION_PIPELINE_CAP_NAME, Cn as failureContributionCapability, Ct as NcSystemEventKindSchema, D as EMBEDDING_REQUIREMENTS_FAILED, Dn as isDetectionMacroClass, Dr as boolean, Dt as NcTemplateVarDescriptorSchema, E as EMBEDDING_MODEL_FAILED, En as isAudioClassName, Er as array, Et as NcTemplatePreviewSchema, F as FailureCounters, Fn as kebabToCamel, Fr as string, Ft as SCENE_CONFIRM_DEFAULT_MAX_IMAGE_PX, G as MOTION_CLOSE_AFTER_MS, Gn as readTimelapseGeneratedAt, Gt as SetTrackPurityInputSchema, H as MAX_BIRTH_LATENCY_PROXY_MS, Hn as plateGalleryCapability, Ht as SCENE_DIVERGED, I as LabelAttributionSchema, In as mayWriteToLocation, Ir as tuple, It as SCENE_CONFIRM_DEFAULT_TIMEOUT_MS, J as NC_ALARM_SYSTEM_EVENT_KINDS, Jt as TIMELAPSE_DENSE_FLOOR_SEC, K as MediaFileKindEnum, Kn as resolveClipSearchMinScore, Kt as SetTrackPurityResultSchema, L as ListTrackRelationsInputSchema, Ln as memoizePinnedFfmpeg, Lr as union, Lt as SCENE_DEFAULT_ANCHOR_THRESHOLD, M as EXPORT_DENSE_MAX_RANGES, Mn as isSystemDelivery, Mr as partialRecord, Mt as RECORDING_SOURCE_CAMSTACK_ADDON, N as FIRST_LEVEL_MACRO_CLASSES, Nn as isSystemEventSummaryRule, Nr as record, Nt as RebuildObjectEmbeddingsRefusalSchema, O as EMBEDDING_REQUIREMENTS_UNAVAILABLE, On as isEventOwnerType, Or as discriminatedUnion, Ot as OPS_LOG_DEFAULT_LIMIT, P as FULL_IMAGE_BBOX, Pn as isVectorIndexDimConflict, Pr as strictObject, Pt as RetrainStatusSchema, Q as NC_CLIP_PRE_ROLL_DEFAULT_SEC, Qn as servedTemplateVars, Qt as TimelapseRuleSchema, R as ListTrackRelationsResultSchema, Rn as notificationRulesCapability, Rr as unknown, Rt as SCENE_DEFAULT_CHECK_INTERVAL_SEC, S as DETECTION_MACRO_CLASSES, Sn as faceGalleryCapability, Sr as nodePin, St as NcSnoozeSuppressedSchema, T as DetectionSourceSchema, Tn as gifFromMp4Args, Tr as _enum, Tt as NcTemplatePreviewInputSchema, U as MAX_TRACK_PURITIES, Un as readDeviceStateFrom, Ut as SCENE_RESET_RECAPTURES, V as MAX_BIRTH_DECISION_RECORDS, Vn as pipelineAnalyticsCapability, Vt as SCENE_DEFAULT_UNCOVERED_POLICY, W as MAX_TRACK_RELATIONS, Wn as readMotionTriggeredBy, Wt as SceneMonitorSchema, X as NC_AUDIO_CONFIRM_WINDOW_SEC_DEFAULT, Xn as sceneMonitorCapability, Xt as TimelapseRuleInputSchema, Y as NC_AUDIO_CONFIRM_HITS_DEFAULT, Yn as ruleBelongsToAlarm$1, Yt as TRACK_RELATIONS_DEFAULT_LIMIT, Z as NC_CLIP_POST_ROLL_DEFAULT_SEC, Zn as sensorRaisedOf, Zt as TimelapseRulePatchSchema, _ as ClearTrackRelationInputSchema, _n as embeddingRefusalOf, _r as createEvent, _t as NcRuleTargetSchema, a as CLIP_EMBEDDING_STEP_ID, an as alarmPanelCapability, ar as templateCarriesSummary, at as NC_SNOOZE_MAX_MINUTES, b as DEFAULT_EVENT_COLOR, bn as encodeVectorBase64, br as hydrateSchema, bt as NcSnoozeInputSchema, c as resolveClusterModelPin, cn as audioModeOf, cr as zoneAnalyticsCapability, ct as NC_TAXONOMY, d as AlarmArmModeSchema, dn as cosineSimilarity$1, dr as evaluateSensorEdge, dt as NcAlarmSettingsPatchSchema, en as TrackRelationKindSchema, er as subKindsOf, et as NC_CONDITION_CATALOG, f as ArchivedDebugNoteSchema, fn as deriveRecordingMode, fr as isSourceCap, ft as NcConditionDescriptorSchema, g as COCO_TO_MACRO, gr as CamProfileSchema, gt as NcRuleSchema, h as BirthDecisionRecordSchema, hr as BaseAddon, ht as NcRulePatchSchema, in as addonWidgetsSourceCapability, ir as systemEventSummaryScheduleOf, it as NC_SENSOR_TRANSITION_KINDS, j as EVENT_OWNER_TYPES, jn as isScheduleActive, jr as object, jt as RECORDING_EXPORT_MAX_READ_BYTES, k as EVENT_DENSITY_BATCH_MAX, kn as isKnownTemplateVar, kr as literal, kt as OpsLogEntrySchema, l as ARCHIVED_DEBUG_NOTES_DEFAULT_LIMIT, ln as buildEventKindDescriptor, lr as DEFAULT_FIRST_SIGHTING_FRESHNESS_MS, lt as NC_TEMPLATE_VARS, m as BaseDevice, mn as describeSystemEventFamilyProblem, mr as errMsg, mt as NcRuleInputSchema, nn as TrackSideSchema, nr as systemEventFamilyProblems, nt as NC_CONSUMABLE_SYSTEM_EVENT_KINDS, o as FACE_EMBEDDING_STEP_ID, on as assertTimelapseCadences, or as templateVarsFor, ot as NC_SYSTEM_EVENT_KIND_GROUP_SPECS, p as BIRTH_DECISION_DEFAULT_LIMIT, pn as describeSystemEventDeliveryProblem, pr as DeviceType, pt as NcConditionsSchema, q as MotionTriggeredBySchema, qn as resolveLocationMode, qt as SetTrackRelationInputSchema, rn as TrackSourceSchema, rr as systemEventFilterApplies, rt as NC_DEFAULT_SNOOZE_MINUTES, s as readClusterModelPinStrict, sn as audioMetricsCapability, sr as vectorDimFromBase64, st as NC_TANK_SYSTEM_EVENT_KINDS, t as BUILTIN_CLIP_MODELS, tn as TrackRelationSchema, tr as systemEventDeliveryProblems, tt as NC_CONSUMABLE_LOW_PERCENT_DEFAULT, u as AUDIO_MACRO_LABELS, un as consumableLowPercentOf, ur as canonicalHash, ut as NcAlarmConfigSchema, v as ClearTrackRelationResultSchema, vr as customAction, vt as NcRuleUpdateInputSchema, w as DeclaredDevices, wn as gifDeriveSpeed, wr as sleep$1, wt as NcTaxonomySchema, x as DEFAULT_TIMELAPSE_PREVIEW_TEXT, xn as evictionPolicyOfLocation, xr as isDeviceScopedCap, xt as NcSnoozeSchema, y as CoverStateSchema, yr as defineCustomActions, yt as NcScheduleSchema, z as LockStateSchema, zn as occupancyScope, zr as EventCategory, zt as SCENE_DEFAULT_OBSERVATION_SPACING_SEC } from "../clip-model-registry-DBKCbXPJ.mjs";
 import { t as __exportAll } from "../embedding-encoder/index.mjs";
 import * as fs$1 from "node:fs";
 import { createWriteStream, promises } from "node:fs";
@@ -14201,11 +14201,26 @@ function sortedSystemEvent(condition) {
 		...packageNames !== void 0 ? { packageNames: packageNames.toSorted(byValue) } : {}
 	};
 }
+/**
+* `zones` with its redundant quantifier dropped: `match: 'any'` says exactly
+* what an absent `match` says (D690 — the editors write `{ ids }`, the store
+* still holds `match: 'any'` on every rule written before). `'all'` is kept:
+* it IS a different rule.
+*/
+function canonicalZones(conditions) {
+	const zones = conditions.zones;
+	if (zones?.match !== "any") return conditions;
+	return {
+		...conditions,
+		zones: { ids: zones.ids }
+	};
+}
 /** The canonical form two conditions are compared in. */
 function conditionsFingerprint(conditions) {
-	const { systemEvent } = conditions;
-	return canonicalHash(systemEvent === void 0 ? conditions : {
-		...conditions,
+	const canonical = canonicalZones(conditions);
+	const { systemEvent } = canonical;
+	return canonicalHash(systemEvent === void 0 ? canonical : {
+		...canonical,
 		systemEvent: sortedSystemEvent(systemEvent)
 	});
 }
@@ -14214,7 +14229,8 @@ function conditionsFingerprint(conditions) {
 * (the normalisation the store applies on every write) and are compared
 * canonically: key order is irrelevant, an `undefined` key equals an absent
 * one, and the system-event `kinds` and id-list filters are compared as SETS.
-* Every other array keeps its order. A side that does not parse is treated as
+* Every other array keeps its order, and `zones.match: 'any'` equals an absent
+* `match`. A side that does not parse is treated as
 * a change, so it is judged rather than waved through.
 */
 function sameConditions(a, b) {
@@ -14259,7 +14275,7 @@ function assertPatchKeepsFamily(existing, patch) {
 * the offending kind or filter). Then rethrow. A refused save is dropped work,
 * and dropped work is never silent. Any other error passes through unlogged.
 */
-function logRefusal$3(check, ctx) {
+function logRefusal$4(check, ctx) {
 	try {
 		check();
 	} catch (err) {
@@ -14275,11 +14291,11 @@ function logRefusal$3(check, ctx) {
 }
 /** {@link assertRuleFamily}, logged. The create path of both routes. */
 function guardRuleFamily(rule, ctx) {
-	logRefusal$3(() => assertRuleFamily(rule), ctx);
+	logRefusal$4(() => assertRuleFamily(rule), ctx);
 }
 /** {@link assertPatchKeepsFamily}, logged. The update path of both routes. */
 function guardPatchFamily(existing, patch, ctx) {
-	logRefusal$3(() => assertPatchKeepsFamily(existing, patch), ctx);
+	logRefusal$4(() => assertPatchKeepsFamily(existing, patch), ctx);
 }
 //#endregion
 //#region src/notification-center/device-scope-guard.ts
@@ -14304,15 +14320,15 @@ function assertDevicesExcludeDelivery(rule) {
 	throw new NcDevicesExcludeRefusal(rule.delivery, excluded);
 }
 /** Run the check; a refusal is dropped work, so it is logged before it is rethrown. */
-function logRefusal$2(check, ctx) {
+function logRefusal$3(check, ctx) {
 	try {
 		check();
 	} catch (err) {
-		if (err instanceof NcDevicesExcludeRefusal) warnRefusal$1(ctx.logger, err, ctx);
+		if (err instanceof NcDevicesExcludeRefusal) warnRefusal$2(ctx.logger, err, ctx);
 		throw err;
 	}
 }
-function warnRefusal$1(logger, err, ctx) {
+function warnRefusal$2(logger, err, ctx) {
 	logger.warn("nc rule refused: devicesExclude on a system rule", { meta: {
 		...ctx.ruleId !== void 0 ? { ruleId: ctx.ruleId } : {},
 		by: ctx.by,
@@ -14322,7 +14338,7 @@ function warnRefusal$1(logger, err, ctx) {
 }
 /** The create path of both routes. */
 function guardRuleDevicesExclude(rule, ctx) {
-	logRefusal$2(() => assertDevicesExcludeDelivery(rule), ctx);
+	logRefusal$3(() => assertDevicesExcludeDelivery(rule), ctx);
 }
 /**
 * The update path of both routes: the MERGED rule is judged, and only when the
@@ -14332,7 +14348,7 @@ function guardPatchDevicesExclude(existing, patch, ctx) {
 	if (existing === null) return;
 	const merged = mergedFamilySubject(existing, patch);
 	if (merged === null) return;
-	logRefusal$2(() => assertDevicesExcludeDelivery(merged), ctx);
+	logRefusal$3(() => assertDevicesExcludeDelivery(merged), ctx);
 }
 //#endregion
 //#region src/notification-center/rule-summary-guard.ts
@@ -14390,7 +14406,7 @@ function mergedDeliverySubject(existing, patch, clear) {
 	};
 	return JUDGED_KEYS.some((key) => canonicalHash(merged[key] ?? null) !== canonicalHash(existing[key] ?? null)) ? merged : null;
 }
-function logRefusal$1(check, ctx) {
+function logRefusal$2(check, ctx) {
 	try {
 		check();
 	} catch (err) {
@@ -14404,14 +14420,14 @@ function logRefusal$1(check, ctx) {
 }
 /** The create path of both routes. */
 function guardRuleSystemEventDelivery(rule, ctx) {
-	logRefusal$1(() => assertSystemEventDelivery(rule), ctx);
+	logRefusal$2(() => assertSystemEventDelivery(rule), ctx);
 }
 /** The update path of both routes: the MERGED rule, when the patch changes what is judged. */
 function guardPatchSystemEventDelivery(existing, patch, clear, ctx) {
 	if (existing === null) return;
 	const merged = mergedDeliverySubject(existing, patch, clear);
 	if (merged === null) return;
-	logRefusal$1(() => assertSystemEventDelivery(merged), ctx);
+	logRefusal$2(() => assertSystemEventDelivery(merged), ctx);
 }
 //#endregion
 //#region src/notification-center/sensor-transition-guard.ts
@@ -14433,15 +14449,15 @@ function assertSensorTransitionDelivery(rule) {
 	throw new NcSensorTransitionRefusal(rule.delivery, transition);
 }
 /** Run the check; a refusal is dropped work, so it is logged before it is rethrown. */
-function logRefusal(check, ctx) {
+function logRefusal$1(check, ctx) {
 	try {
 		check();
 	} catch (err) {
-		if (err instanceof NcSensorTransitionRefusal) warnRefusal(ctx.logger, err, ctx);
+		if (err instanceof NcSensorTransitionRefusal) warnRefusal$1(ctx.logger, err, ctx);
 		throw err;
 	}
 }
-function warnRefusal(logger, err, ctx) {
+function warnRefusal$1(logger, err, ctx) {
 	logger.warn("nc rule refused: sensorTransition off a device-event rule", { meta: {
 		...ctx.ruleId !== void 0 ? { ruleId: ctx.ruleId } : {},
 		by: ctx.by,
@@ -14451,7 +14467,7 @@ function warnRefusal(logger, err, ctx) {
 }
 /** The create path of both routes. */
 function guardRuleSensorTransition(rule, ctx) {
-	logRefusal(() => assertSensorTransitionDelivery(rule), ctx);
+	logRefusal$1(() => assertSensorTransitionDelivery(rule), ctx);
 }
 /**
 * The update path of both routes: the MERGED rule is judged, and only when the
@@ -14462,7 +14478,92 @@ function guardPatchSensorTransition(existing, patch, ctx) {
 	if (existing === null) return;
 	const merged = mergedFamilySubject(existing, patch);
 	if (merged === null) return;
-	logRefusal(() => assertSensorTransitionDelivery(merged), ctx);
+	logRefusal$1(() => assertSensorTransitionDelivery(merged), ctx);
+}
+//#endregion
+//#region src/notification-center/detection-audio-guard.ts
+var NcDetectionAudioRefusal = class extends Error {
+	audioClasses;
+	constructor(audioClasses) {
+		super(`rule refused: a detection rule cannot name sounds (${audioClasses.join(", ")}) — create a Sound rule for them`);
+		this.name = "NcDetectionAudioRefusal";
+		this.audioClasses = audioClasses;
+	}
+};
+/**
+* The audio classes a DETECTION rule carries (include and exclude), in stored
+* order. Empty for a Sound rule (its `audio` condition owns its sounds) and for
+* a system rule (it has no class scope).
+*/
+function audioClassesOnDetectionRule(rule) {
+	if (isSystemDelivery(rule.delivery)) return [];
+	if (rule.conditions.audio !== void 0) return [];
+	return [...rule.conditions.classes ?? [], ...rule.conditions.classesExclude ?? []].filter(isAudioClassName);
+}
+function assertNoAudioClassOnDetectionRule(rule) {
+	const audioClasses = audioClassesOnDetectionRule(rule);
+	if (audioClasses.length > 0) throw new NcDetectionAudioRefusal(audioClasses);
+}
+/** Run the check; a refusal is dropped work, so it is logged before it is rethrown. */
+function logRefusal(check, ctx) {
+	try {
+		check();
+	} catch (err) {
+		if (err instanceof NcDetectionAudioRefusal) warnRefusal(ctx.logger, err, ctx);
+		throw err;
+	}
+}
+function warnRefusal(logger, err, ctx) {
+	logger.warn("nc rule refused: a detection rule names sounds", { meta: {
+		...ctx.ruleId !== void 0 ? { ruleId: ctx.ruleId } : {},
+		by: ctx.by,
+		audioClasses: err.audioClasses.join(", ")
+	} });
+}
+/** The create path of both routes. */
+function guardRuleDetectionAudio(rule, ctx) {
+	logRefusal(() => assertNoAudioClassOnDetectionRule(rule), ctx);
+}
+/**
+* The update path of both routes: the MERGED rule, only when the patch changes
+* it — and only the sounds the save ADDS. A legacy rule that already names a
+* sound stays editable (a threshold, a schedule, a zone); what is refused is
+* naming a new one.
+*/
+function guardPatchDetectionAudio(existing, patch, ctx) {
+	if (existing === null) return;
+	const merged = mergedFamilySubject(existing, patch);
+	if (merged === null) return;
+	const stored = new Set(audioClassesOnDetectionRule(existing).map(normalisedClass));
+	const added = audioClassesOnDetectionRule(merged).filter((name) => !stored.has(normalisedClass(name)));
+	if (added.length === 0) return;
+	logRefusal(() => {
+		throw new NcDetectionAudioRefusal(added);
+	}, ctx);
+}
+function normalisedClass(name) {
+	return name.trim().toLowerCase();
+}
+/**
+* The loader's half: every stored detection rule that names a sound is KEPT
+* (it loads and fires as it always did) and reported at WARN with its id —
+* once per rule per process, never on every reload tick. Returns the ids it
+* reported this time, for the caller's bookkeeping.
+*/
+function warnLegacyAudioClassRules(rules, alreadyWarned, logger) {
+	const reported = [];
+	for (const rule of rules) {
+		if (alreadyWarned.has(rule.id)) continue;
+		const audioClasses = audioClassesOnDetectionRule(rule);
+		if (audioClasses.length === 0) continue;
+		logger.warn("notification rule is a detection rule naming sounds — kept as it is; recreate it as a Sound rule", { meta: {
+			ruleId: rule.id,
+			name: rule.name,
+			audioClasses: audioClasses.join(", ")
+		} });
+		reported.push(rule.id);
+	}
+	return reported;
 }
 //#endregion
 //#region src/notification-center/occupancy-watcher.ts
@@ -17198,6 +17299,10 @@ function makeNcActionHandlers(deps) {
 				logger: deps.logger,
 				by: c.userId
 			});
+			guardRuleDetectionAudio(parsed, {
+				logger: deps.logger,
+				by: c.userId
+			});
 			guardRuleDevicesExclude(parsed, {
 				logger: deps.logger,
 				by: c.userId
@@ -17234,6 +17339,11 @@ function makeNcActionHandlers(deps) {
 				by: c.userId,
 				ruleId: input.ruleId
 			});
+			guardPatchDetectionAudio(existing, patch, {
+				logger: deps.logger,
+				by: c.userId,
+				ruleId: input.ruleId
+			});
 			guardPatchDevicesExclude(existing, patch, {
 				logger: deps.logger,
 				by: c.userId,
@@ -25397,6 +25507,8 @@ var NcRuleStore = class {
 	identityIdsByName;
 	/** Has a {@link load} ever completed? See the note there. */
 	loaded = false;
+	/** Legacy detection rules naming sounds already reported (D690) — once each. */
+	audioClassWarned = /* @__PURE__ */ new Set();
 	constructor(deps) {
 		this.store = deps.store;
 		this.ledger = new DurableLedger({
@@ -25431,6 +25543,7 @@ var NcRuleStore = class {
 	async load() {
 		await this.ledger.load();
 		if (this.ledger.hasAnswered()) this.loaded = true;
+		for (const id of warnLegacyAudioClassRules(this.ledger.snapshot(), this.audioClassWarned, this.logger)) this.audioClassWarned.add(id);
 		this.logger.debug("notification rules loaded", { meta: { rules: this.ledger.size } });
 	}
 	/**
@@ -33662,6 +33775,10 @@ var NotificationCenter = class NotificationCenter {
 					logger: this.logger,
 					by: caller.userId
 				});
+				guardRuleDetectionAudio(rule, {
+					logger: this.logger,
+					by: caller.userId
+				});
 				guardRuleDevicesExclude(rule, {
 					logger: this.logger,
 					by: caller.userId
@@ -33693,6 +33810,11 @@ var NotificationCenter = class NotificationCenter {
 					by: caller.userId,
 					ruleId
 				});
+				guardPatchDetectionAudio(existing, patch, {
+					logger: this.logger,
+					by: caller.userId,
+					ruleId
+				});
 				guardPatchDevicesExclude(existing, patch, {
 					logger: this.logger,
 					by: caller.userId,
@@ -67228,6 +67350,22 @@ function messageOf(err) {
 function isDetailNotAttachedRefusal(err) {
 	return messageOf(err).includes(DETAIL_NOT_ATTACHED_MARKER);
 }
+/**
+* The runner's TYPED handle-expired refusal (D688): the frame handle a dispatch
+* named is past the native lease age bound, and the registry will refuse it on
+* every later ask. TWIN of `addon-pipeline/src/pipeline-runner/detail-park.ts`
+* `DETAIL_HANDLE_EXPIRED_MARKER` — keep the two identical.
+*
+* Why the dispatcher cares: unlike not-attached this is about ONE handle, not
+* the session — the parked frame still serves — but the handle itself is
+* finished. Naming it again (next tick, or through the native-strict crop rung)
+* can only be refused again; on the live fleet that was ~7 refusals per handle.
+*/
+var DETAIL_HANDLE_EXPIRED_MARKER = "runDetailSubtree-refused:handle-expired";
+/** Did this `runDetailSubtree` error carry the runner's handle-expired marker? */
+function isDetailHandleExpiredRefusal(err) {
+	return messageOf(err).includes(DETAIL_HANDLE_EXPIRED_MARKER);
+}
 //#endregion
 //#region src/pipeline-analytics/detail-scheduler.ts
 /** Default backoff/period when a step's cadence omits `minIntervalMs`. */
@@ -67684,6 +67822,7 @@ var TrackDetailDispatcher = class {
 			className: frame.className
 		};
 		const steps = composeDetailSteps(req, (trackId) => this.deps.hasTrackLabel?.(trackId) ?? false);
+		let handleRefused = false;
 		if (frame.frameHandle !== void 0) try {
 			const primary = await this.deps.runDetailSubtree({
 				deviceId,
@@ -67697,7 +67836,10 @@ var TrackDetailDispatcher = class {
 				this.warnNotAttachedThrottled(deviceId, dev, req);
 				return null;
 			}
-			this.deps.logger.debug("detail primary call failed — trying frame fallback", {
+			if (isDetailHandleExpiredRefusal(err)) {
+				handleRefused = true;
+				this.retireRefusedHandle(deviceId, dev, req, frame);
+			} else this.deps.logger.debug("detail primary call failed — trying frame fallback", {
 				tags: { deviceId },
 				meta: {
 					trackId: req.trackId,
@@ -67747,7 +67889,7 @@ var TrackDetailDispatcher = class {
 				}
 			});
 		}
-		if (this.deps.captureCropBase64 !== void 0) try {
+		if (this.deps.captureCropBase64 !== void 0 && frame.frameHandle !== void 0 && !handleRefused) try {
 			const cropJpeg = await this.deps.captureCropBase64(frame);
 			if (cropJpeg !== null) {
 				const retry = await this.deps.runDetailSubtree({
@@ -67776,6 +67918,35 @@ var TrackDetailDispatcher = class {
 		return null;
 	}
 	/**
+	* The runner refused `frame`'s handle as past the lease age bound (D688).
+	* That verdict is final for the handle, so the track's stored association
+	* loses it: later dispatches skip rung 1 and the native-strict crop rung
+	* (both would name the same handle and be refused again — ~7 times per
+	* handle on the live fleet) and go straight to the parked frame, until a
+	* newly OBSERVED frame brings a fresh handle via {@link onFrame}.
+	*
+	* Only the refused handle is dropped: if a newer frame replaced it while the
+	* dispatch was in flight, that one stands. The line is therefore emitted once
+	* per (track, handle) — a concurrent dispatch refused on the same handle
+	* finds it already gone and says nothing.
+	*/
+	retireRefusedHandle(deviceId, dev, req, frame) {
+		const current = dev.tracks.get(req.trackId);
+		if (current === void 0 || current.frameHandle !== frame.frameHandle) return;
+		const { frameHandle: refused, ...withoutHandle } = current;
+		dev.tracks.set(req.trackId, withoutHandle);
+		this.deps.logger.info("detail dispatch: frame handle refused as expired — retired for this track, parked frame only until a fresh observation", {
+			tags: { deviceId },
+			meta: {
+				trackId: req.trackId,
+				stepId: req.stepId,
+				reason: "handle-expired",
+				handle: refused === void 0 ? null : `${refused.shmId}#${refused.slot}#${refused.seq}`,
+				parkedFrameRung: this.deps.captureParkedFrame !== void 0
+			}
+		});
+	}
+	/**
 	* The typed refusal is EXPECTED for a track that outlives the runner's
 	* detail park grace (a closing track's last dispatches), so it logs its own
 	* line — the reason is knowable, unlike the every-rung-missed warn — and

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

package/package.json

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