@camstack/addon-post-analysis 1.2.669 → 1.2.671

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-BhKHkBsg.js");
 let node_fs = require("node:fs");
 node_fs = require_clip_model_registry.__toESM(node_fs, 1);
 let node_path = require("node:path");
@@ -16773,6 +16773,68 @@ var MediaStore = class MediaStore {
 		};
 	}
 	/**
+	* Rows and bytes per asked storage location, the unstamped (NULL) rows, the
+	* rows naming a location that was NOT asked about, and the total.
+	*
+	* Same statements as {@link footprintByLocation} (one aggregate over
+	* `idx_media_location_size` per location, one for NULL) plus one unfiltered
+	* aggregate for the total (a covering-index scan, O(rows)); the unlisted
+	* remainder is the difference, relative to the ids ASKED, so a row stamped with
+	* a deleted location is counted without a distinct walk only when the caller
+	* asked for every live location. A read that fails THROWS — never a zero.
+	*/
+	async censusByLocation(locationIds) {
+		const fields = [{
+			as: "bytes",
+			field: "sizeBytes",
+			op: "sum"
+		}];
+		const locations = [];
+		let knownRows = 0;
+		let knownBytes = 0;
+		for (const locationId of locationIds) {
+			const agg = await this.store.aggregate.query({
+				collection: MEDIA_COLLECTION,
+				fields: [...fields],
+				filter: { where: { locationId } }
+			});
+			const bytes = agg.values["bytes"] ?? 0;
+			locations.push({
+				locationId,
+				rows: agg.count,
+				bytes
+			});
+			knownRows += agg.count;
+			knownBytes += bytes;
+		}
+		const nullAgg = await this.store.aggregate.query({
+			collection: MEDIA_COLLECTION,
+			fields: [...fields],
+			filter: { where: { locationId: null } }
+		});
+		const totalAgg = await this.store.aggregate.query({
+			collection: MEDIA_COLLECTION,
+			fields: [...fields]
+		});
+		const nullBytes = nullAgg.values["bytes"] ?? 0;
+		const totalBytes = totalAgg.values["bytes"] ?? 0;
+		return {
+			locations,
+			unstamped: {
+				rows: nullAgg.count,
+				bytes: nullBytes
+			},
+			unlisted: {
+				rows: Math.max(0, totalAgg.count - knownRows - nullAgg.count),
+				bytes: Math.max(0, totalBytes - knownBytes - nullBytes)
+			},
+			total: {
+				rows: totalAgg.count,
+				bytes: totalBytes
+			}
+		};
+	}
+	/**
 	* The media footprint broken down by KIND — fleet-wide, or for one camera.
 	*
 	* `footprintByDevice` answers "how much is where"; this answers "how much is
@@ -52541,7 +52603,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 +52705,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 +56724,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 +56851,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
@@ -71545,7 +71732,6 @@ Object.freeze({
 	"addon-routes": ["getRoutes"],
 	"addon-widgets-source": ["listWidgets"],
 	"board-key-source": ["listSources"],
-	"broker": ["list", "listProviders"],
 	"calendar-source": ["listCalendars", "listEvents"],
 	"custom-model-registry": ["listModels"],
 	"data-store-provider": ["histogram", "query"],
@@ -72092,7 +72278,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 +72305,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 +72716,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 +72929,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 +72950,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 +73009,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 +73589,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 +73687,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 +124267,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 +124644,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 +127223,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 +129567,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: [],
@@ -132734,6 +132924,10 @@ var PipelineAnalyticsAddon = class PipelineAnalyticsAddon extends require_clip_m
 		} });
 		return { jobId };
 	}
+	/** Stored media per storage location (see the cap): indexed aggregates, no walk. */
+	async getMediaLocationCensus(input) {
+		return this.requireMediaStore().censusByLocation(input.locationIds);
+	}
 	/**
 	* How many media / retrain rows still carry no `locationId`.
 	*
@@ -132937,8 +133131,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 +133163,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 +133189,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({