@camstack/addon-post-analysis 1.2.669 → 1.2.670

package/dist/pipeline-analytics/index.js

@@ -2,7 +2,7 @@ Object.defineProperties(exports, {
 	__esModule: { value: true },
 	[Symbol.toStringTag]: { value: "Module" }
 });
-const require_clip_model_registry = require("../clip-model-registry-CbzBwacH.js");
+const require_clip_model_registry = require("../clip-model-registry-B3x4Npc9.js");
 let node_fs = require("node:fs");
 node_fs = require_clip_model_registry.__toESM(node_fs, 1);
 let node_path = require("node:path");
@@ -52541,7 +52541,7 @@ var FaceSettingsSchema = require_clip_model_registry.object({
 	* `resolveGlobalFaceEnabled` / `getDeviceSettingsContribution` (the field is
 	* stripped from the per-device schema).
 	*/
-	enabled: require_clip_model_registry.boolean().default(true),
+	faceRecognitionEnabled: require_clip_model_registry.boolean().default(true),
 	/**
 	* Cosine similarity (on L2-normalized embeddings) required to match. A
 	* property of ONE model's cosine space: it moves with the default model.
@@ -52643,7 +52643,7 @@ function resolveFaceSettings(raw) {
 		return parsed.success ? parsed.data : FACE_DEFAULTS[key];
 	};
 	return {
-		enabled: pick("enabled"),
+		faceRecognitionEnabled: pick("faceRecognitionEnabled"),
 		similarityThreshold: pick("similarityThreshold"),
 		margin: pick("margin"),
 		minFacePx: pick("minFacePx"),
@@ -56662,7 +56662,117 @@ async function migrateDeviceTemplateVariable(ports) {
 	};
 }
 //#endregion
-//#region src/migrations/index.ts
+//#region src/migrations/split-enabled-key.ts
+/**
+* The shared settings key `enabled` becomes two (D987, D986 §2).
+*
+* One key meant two things: "Face recognition on" and "Suppress parked objects". Toggling one
+* flipped the other. Each switch now has its own key. So today's behaviour does not change, the
+* value an install has stored under `enabled` is copied into BOTH new keys, and `enabled` is
+* deleted. That covers the cluster row (`addon-settings`) and every camera's own row
+* (`addon-device-settings`).
+*
+* A new key that already has a row is never overwritten (a seed never overwrites): it was written
+* by the build that reads it. The plan has nothing left to do once `enabled` is gone, so a rerun is
+* a no-op. A read that fails throws and nothing is written.
+*/
+var PIPELINE_ANALYTICS_ID = "pipeline-analytics";
+var RETIRED_ENABLED_KEY = "enabled";
+var NEW_KEYS = ["faceRecognitionEnabled", "stationarySuppressionEnabled"];
+/** The canonical settings table: one row per key, id `<addonId>.<key>`. */
+var SETTINGS_TABLE = "addon-settings";
+/** The per-device settings table: one row per field, id `<addonId>:<deviceId>.<field>`. */
+var DEVICE_SETTINGS_TABLE = "addon-device-settings";
+function clusterEdits(stored) {
+	if (!(RETIRED_ENABLED_KEY in stored)) return [];
+	const value = stored[RETIRED_ENABLED_KEY];
+	const rowId = (key) => `${PIPELINE_ANALYTICS_ID}.${key}`;
+	const missing = NEW_KEYS.filter((key) => !(key in stored));
+	const edits = [];
+	if (missing.length > 0) edits.push({
+		op: "setKeys",
+		scope: SETTINGS_TABLE,
+		values: Object.fromEntries(missing.map((key) => [rowId(key), {
+			addonId: PIPELINE_ANALYTICS_ID,
+			key,
+			value
+		}])),
+		precondition: require_clip_model_registry.preconditionOf(Object.fromEntries(missing.map((key) => [rowId(key), null])))
+	});
+	edits.push({
+		op: "deleteKeys",
+		scope: SETTINGS_TABLE,
+		keys: [rowId(RETIRED_ENABLED_KEY)],
+		precondition: require_clip_model_registry.preconditionOf({ [rowId(RETIRED_ENABLED_KEY)]: {
+			addonId: PIPELINE_ANALYTICS_ID,
+			key: RETIRED_ENABLED_KEY,
+			value
+		} })
+	});
+	return edits;
+}
+async function deviceEdits(ports) {
+	const ids = await ports.listDeviceIds();
+	if (ids.length === 0) return [];
+	const retired = await ports.readDeviceField(ids, RETIRED_ENABLED_KEY);
+	if (retired.size === 0) return [];
+	const carriers = [...retired.keys()];
+	const existing = /* @__PURE__ */ new Map();
+	for (const key of NEW_KEYS) existing.set(key, await ports.readDeviceField(carriers, key));
+	const rowId = (deviceId, field) => `${PIPELINE_ANALYTICS_ID}:${deviceId}.${field}`;
+	const created = {};
+	const retiredRows = {};
+	for (const [deviceId, value] of retired) {
+		for (const key of NEW_KEYS) {
+			if (existing.get(key)?.has(deviceId) === true) continue;
+			created[rowId(deviceId, key)] = {
+				addonId: PIPELINE_ANALYTICS_ID,
+				deviceId: String(deviceId),
+				key,
+				value
+			};
+		}
+		retiredRows[rowId(deviceId, RETIRED_ENABLED_KEY)] = {
+			addonId: PIPELINE_ANALYTICS_ID,
+			deviceId: String(deviceId),
+			key: RETIRED_ENABLED_KEY,
+			value
+		};
+	}
+	const edits = [];
+	const createdIds = Object.keys(created);
+	if (createdIds.length > 0) edits.push({
+		op: "setKeys",
+		scope: DEVICE_SETTINGS_TABLE,
+		values: created,
+		precondition: require_clip_model_registry.preconditionOf(Object.fromEntries(createdIds.map((id) => [id, null])))
+	});
+	edits.push({
+		op: "deleteKeys",
+		scope: DEVICE_SETTINGS_TABLE,
+		keys: Object.keys(retiredRows),
+		precondition: require_clip_model_registry.preconditionOf(retiredRows)
+	});
+	return edits;
+}
+/** Copy `enabled` into both new keys (cluster row and every camera's row) and delete it. */
+async function planSplitEnabledKey(ports) {
+	return { edits: [...clusterEdits(await ports.readStored([RETIRED_ENABLED_KEY, ...NEW_KEYS])), ...await deviceEdits(ports)] };
+}
+/**
+* The port's read over an addon's three-way key read: each of `keys` that has a row, raw. A key
+* the store could not answer for throws, so the migration fails instead of treating a failed read
+* as "nothing to move".
+*/
+async function readRawKeys(read, keys) {
+	const found = {};
+	for (const key of keys) {
+		const answer = await read(key);
+		if (answer.kind === "unreadable") throw new Error(`${PIPELINE_ANALYTICS_ID}: the setting ${key} cannot be read (${answer.reason})`);
+		if (answer.kind === "present") found[key] = answer.value;
+	}
+	return found;
+}
 /** The `pipeline-analytics` catalogue (D987): offered to the engine at the hub's boot. */
 var ADDON_MIGRATIONS = [{
 	meta: {
@@ -56679,6 +56789,21 @@ var ADDON_MIGRATIONS = [{
 		fixtureMark: "the rule name and the trigger conditions the migration does not know"
 	},
 	procedure: migrateDeviceTemplateVariable
+}, {
+	meta: {
+		id: "pipeline-analytics/2026-11-05-split-enabled-key",
+		owner: PIPELINE_ANALYTICS_ID,
+		level: "addon-state",
+		seq: 2,
+		dependsOn: [],
+		store: "settings",
+		scope: "cluster",
+		onFailure: "block-owner",
+		bodyKind: "plan",
+		description: "Split the shared `enabled` setting into faceRecognitionEnabled and stationarySuppressionEnabled, copying the stored value into both, for the cluster and for every camera",
+		fixtureMark: "a setting the migration does not know"
+	},
+	plan: planSplitEnabledKey
 }];
 //#endregion
 //#region src/pipeline-analytics/clip-space-plan.ts
@@ -72092,7 +72217,7 @@ var SensorTransitionGate = class {
 var StationarySettingsSchema = require_clip_model_registry.object({
 	/** Master switch. Off ⇒ this camera gathers no evidence and suppresses
 	*  nothing (every parked object keeps spawning normal tracks). */
-	enabled: require_clip_model_registry.boolean().default(true),
+	stationarySuppressionEnabled: require_clip_model_registry.boolean().default(true),
 	/** IoU at/above which a detection is the same parked object, unmoved →
 	*  suppress its spawn. `SUPPRESS_IOU`. */
 	suppressIou: require_clip_model_registry.number().min(.3).max(.9).default(SUPPRESS_IOU),
@@ -72119,7 +72244,7 @@ function resolveStationarySettings(raw) {
 		return parsed.success ? parsed.data : STATIONARY_DEFAULTS[key];
 	};
 	return {
-		enabled: pick("enabled"),
+		stationarySuppressionEnabled: pick("stationarySuppressionEnabled"),
 		suppressIou: pick("suppressIou"),
 		wakeAssocIou: pick("wakeAssocIou"),
 		sessionStillnessWindowMs: pick("sessionStillnessWindowMs"),
@@ -72530,10 +72655,10 @@ function buildDetectionSettingsSections() {
 			fields: [
 				{
 					type: "boolean",
-					key: "enabled",
+					key: "stationarySuppressionEnabled",
 					label: "Suppress parked objects",
 					description: "Promote a stopped object to a lightweight registry entry and suppress its detections from re-spawning tracks. Off = every parked object keeps spawning normal tracks on this camera.",
-					default: STATIONARY_DEFAULTS.enabled
+					default: STATIONARY_DEFAULTS.stationarySuppressionEnabled
 				},
 				{
 					type: "slider",
@@ -72743,8 +72868,6 @@ function retagRetentionSection(sections) {
 * model-substitution readout.
 */
 var SUGGESTION_THRESHOLD_READOUT_KEY = "suggestionThresholdReadout";
-/** `getGlobalSettings({ cap })` scope for the face matching form. */
-var FACE_GALLERY_SETTINGS_CAP = "face-gallery";
 var FACE_RECOGNITION_SECTION_ID = "face-recognition";
 /** Percent, at most one decimal, without a trailing `.0`. Cosines here are
 *  two-decimal operator values; `36.0%` reads like false precision. */
@@ -72766,7 +72889,7 @@ function formatSuggestionThresholdReadout(similarityThreshold) {
 * by each device's detection-pipeline steps, so a per-device toggle would be
 * misleading. Keyed by section id → set of field keys to drop.
 */
-var GLOBAL_ONLY_FIELDS = { "face-recognition": new Set(["enabled", SUGGESTION_THRESHOLD_READOUT_KEY]) };
+var GLOBAL_ONLY_FIELDS = { "face-recognition": new Set(["faceRecognitionEnabled", SUGGESTION_THRESHOLD_READOUT_KEY]) };
 /**
 * Whole sections that are cluster-wide (global page only) and must NOT appear
 * in a per-device contribution (D62: a per-camera field whose reader only ever
@@ -72825,8 +72948,8 @@ function stripDeviceOnlyFields(sections) {
 * in `BaseAddon.schema()`; the general sections below are followed by the
 * detection-knob sections in the original order.
 */
-function buildGlobalSettingsSchema(cap) {
-	return scopeGlobalSettingsToCap({ sections: [...[
+function buildGlobalSettingsSchema() {
+	return { sections: [...[
 		{
 			id: "cluster-post-processing",
 			title: "Cluster post-processing",
@@ -73405,10 +73528,10 @@ function buildGlobalSettingsSchema(cap) {
 			fields: [
 				{
 					type: "boolean",
-					key: "enabled",
+					key: "faceRecognitionEnabled",
 					label: "Face recognition on",
 					description: "Off stops face matching for every camera. On by default.",
-					default: FACE_DEFAULTS.enabled
+					default: FACE_DEFAULTS.faceRecognitionEnabled
 				},
 				{
 					type: "number",
@@ -73503,25 +73626,22 @@ function buildGlobalSettingsSchema(cap) {
 				}
 			]
 		}
-	], ...buildDetectionSettingsSections()] }, cap);
+	], ...buildDetectionSettingsSections()] };
+}
+/** The face matching form: the cluster form of `face-gallery`. */
+function buildFaceClusterSchema() {
+	return { sections: buildGlobalSettingsSchema().sections.filter((section) => section.id === FACE_RECOGNITION_SECTION_ID) };
+}
+/** The cluster-wide knobs of `pipeline-analytics`: the sections a camera never overrides. */
+function buildAnalyticsClusterSchema() {
+	return { sections: buildGlobalSettingsSchema().sections.filter((section) => GLOBAL_ONLY_SECTIONS.has(section.id)) };
 }
 /**
-* The `cap` argument on `getGlobalSettings` is how a page asks for ONE
-* capability's knobs instead of the addon's whole form. Pipeline → Cluster
-* → Settings asks for `face-gallery`; System → Settings omits `cap` and
-* still gets every section. An unknown cap is empty so this addon cannot
-* appear on a page that meant someone else.
+* The fleet defaults of `pipeline-analytics`: every knob a camera can override on its own form,
+* the face section excluded (it is the cluster form of `face-gallery`).
 */
-function scopeGlobalSettingsToCap(schema, cap) {
-	if (cap === void 0 || cap === "") return schema;
-	if (cap === FACE_GALLERY_SETTINGS_CAP) return {
-		...schema,
-		sections: schema.sections.filter((s) => s.id === FACE_RECOGNITION_SECTION_ID)
-	};
-	return {
-		...schema,
-		sections: []
-	};
+function buildAnalyticsDeviceDefaultsSchema() {
+	return { sections: buildGlobalSettingsSchema().sections.filter((section) => section.id !== FACE_RECOGNITION_SECTION_ID && !GLOBAL_ONLY_SECTIONS.has(section.id)) };
 }
 //#endregion
 //#region src/pipeline-analytics/store/embedding-json-conversion.ts
@@ -124086,7 +124206,7 @@ var PipelineAnalyticsAddon = class PipelineAnalyticsAddon extends require_clip_m
 	}
 	_faceGlobalEnabledState = null;
 	get faceGlobalEnabledState() {
-		if (!this._faceGlobalEnabledState) this._faceGlobalEnabledState = this.state("enabled", FaceSettingsSchema.shape.enabled, FACE_DEFAULTS.enabled);
+		if (!this._faceGlobalEnabledState) this._faceGlobalEnabledState = this.state("faceRecognitionEnabled", FaceSettingsSchema.shape.faceRecognitionEnabled, FACE_DEFAULTS.faceRecognitionEnabled);
 		return this._faceGlobalEnabledState;
 	}
 	constructor() {
@@ -124463,10 +124583,19 @@ var PipelineAnalyticsAddon = class PipelineAnalyticsAddon extends require_clip_m
 	/** The addon's migration catalogue (D987), bound to the notification kinds. */
 	async runTemplateMigrations() {
 		const records = this.requireRecords();
+		const settings = this.ctx.settings;
+		if (settings === void 0) throw new Error("the per-device settings store is unavailable");
 		const ports = {
 			rules: records.kind(ncRecordKinds["rules"]),
 			timelapseRules: records.kind(ncRecordKinds["timelapse-rules"]),
-			texts: records.kind(ncRecordKinds.texts)
+			texts: records.kind(ncRecordKinds.texts),
+			readStored: (keys) => readRawKeys((key) => this.readStoredGlobalKey(key), keys),
+			listDeviceIds: () => settings.listDeviceStoreIds(),
+			readDeviceField: async (deviceIds, field) => {
+				const found = /* @__PURE__ */ new Map();
+				for (const [deviceId, blob] of await settings.readDeviceStoreBatch(deviceIds)) if (field in blob) found.set(deviceId, blob[field]);
+				return found;
+			}
 		};
 		await this.runMigrations(require_clip_model_registry.defineAddonMigrations(ADDON_MIGRATIONS, ports));
 	}
@@ -127033,7 +127162,7 @@ var PipelineAnalyticsAddon = class PipelineAnalyticsAddon extends require_clip_m
 		const stationarySettings = this.stationarySettingsFromCache(deviceId);
 		const packageSettings = this.packageDropSettingsFromCache(deviceId);
 		const packageClasses = new Set(packageSettings.packageDropClassFilter);
-		if (planeRunsStationary(source) && this.stationaryRegistry && this.stationaryEvidence && stationarySettings.enabled) {
+		if (planeRunsStationary(source) && this.stationaryRegistry && this.stationaryEvidence && stationarySettings.stationarySuppressionEnabled) {
 			const evidence = this.stationaryEvidence;
 			for (const t of result.tracked) {
 				if (packageClasses.has(t.className)) continue;
@@ -129377,7 +129506,7 @@ var PipelineAnalyticsAddon = class PipelineAnalyticsAddon extends require_clip_m
 				const registry = this.stationaryRegistry;
 				p.setStationaryGate({ filter: (input) => {
 					const s = this.stationarySettingsFromCache(deviceId);
-					if (!s.enabled) return {
+					if (!s.stationarySuppressionEnabled) return {
 						suppressedIndices: /* @__PURE__ */ new Set(),
 						continuableIndices: /* @__PURE__ */ new Set(),
 						confirmed: [],
@@ -132937,8 +133066,25 @@ var PipelineAnalyticsAddon = class PipelineAnalyticsAddon extends require_clip_m
 		});
 		return await readWinningBlob(candidates, pick, readBlob);
 	}
-	globalSettingsSchema(cap) {
-		return this.schema(buildGlobalSettingsSchema(cap));
+	scopedSettingsCapabilities() {
+		return ["pipeline-analytics", "face-gallery"];
+	}
+	/**
+	* D986 M4. The face matching form is the cluster form of `face-gallery`; the cluster-wide knobs
+	* (post-processing node, index maintenance, device alerts, prune windows) are the cluster form
+	* of `pipeline-analytics`. A page asks for ONE capability's form, and System → Settings asks for
+	* all of them. The schemas are static; the only live value (the derived suggestion floor) is
+	* injected into the hydrate blob by `getGlobalSettings`.
+	*/
+	async clusterSettingsSchema(cap) {
+		if (cap === "face-gallery") return this.schema(buildFaceClusterSchema());
+		if (cap === "pipeline-analytics") return this.schema(buildAnalyticsClusterSchema());
+		return null;
+	}
+	/** The knobs a camera can override: stored as the fleet default, resolved per camera. */
+	async deviceDefaultsSchema(cap) {
+		if (cap === "pipeline-analytics") return this.schema(buildAnalyticsDeviceDefaultsSchema());
+		return null;
 	}
 	/**
 	* The only reason this is overridden: the face suggestion floor is DERIVED
@@ -132952,11 +133098,11 @@ var PipelineAnalyticsAddon = class PipelineAnalyticsAddon extends require_clip_m
 	* implies and has nothing to contradict it with. Everything else about this
 	* call is `BaseAddon`'s.
 	*
-	* (Fix round, L3.) `globalSettingsSchema()` is reused, untouched, by
+	* (Fix round, L3.) `buildGlobalSettingsSchema()` is reused, untouched, by
 	* `getDeviceSettingsContribution` below to build the PER-DEVICE form —
 	* `trackingTape` must stay there. So the strip happens here, on the result
 	* THIS method actually hands to the global settings page, never inside
-	* `globalSettingsSchema()` itself, which would also remove it from the
+	* `buildGlobalSettingsSchema()` itself, which would also remove it from the
 	* per-device form that shares the same base sections.
 	*/
 	async getGlobalSettings(overlay, cap, nodeId) {
@@ -132978,7 +133124,7 @@ var PipelineAnalyticsAddon = class PipelineAnalyticsAddon extends require_clip_m
 	}
 	async getDeviceSettingsContribution(input) {
 		if (!await this.isCameraDevice(input.deviceId)) return null;
-		const schema = this.globalSettingsSchema();
+		const schema = buildGlobalSettingsSchema();
 		const raw = await this.readDeviceBlob(input.deviceId);
 		const globalRaw = await this.rawGlobalStoreMirror.resolve();
 		const baseSections = schema ? hydrateWithInheritedGlobals({