@camstack/addon-post-analysis 1.2.208 → 1.2.210

package/dist/{dist-CoLA3NHh.js → dist-FHSaZkf_.js}

@@ -7854,6 +7854,85 @@ var CameraSwitchGroupSchema = object({
 */
 var DETECTION_PIPELINE_CAP_NAME = "detection-pipeline";
 /**
+* Debug-note archive — the durable corpus of what operators asked to be
+* checked, and the ONE thing about a debug note that outlives its track.
+*
+* D353 bound `debugNote` to the `debug` flag: turning the flag off clears the
+* note in the same statement, so a track can never present a question without
+* the flag that explains it. That invariant is right and stays. Its side
+* effect was not: the act of REVIEWING a debug set destroyed every note in it,
+* and the notes that survived a sweep aged out with their tracks anyway. On
+* 2026-09-08 the notes from one morning's review — 25 to 27 of them — were
+* already unreadable by the afternoon, leaving 11.
+*
+* So the clear now ARCHIVES first (D405). A row here is:
+*
+*  - written ONLY by the hub, from `applyTrackFlags`, immediately before the
+*    note is cleared off the track row;
+*  - keyed by ITS OWN id, derived from `(sourceTrackId, note)` so reviewing
+*    the same track twice cannot double the corpus;
+*  - NOT a track row, NOT subject to track retention, and NOT a durability pin
+*    on anything — the track it names is expected to be gone.
+*
+* `sourceTrackId` is deliberately not called `trackId`. The analytics
+* retention model derives track OWNERSHIP from a declared `trackId` column
+* (`collection-classification.ts`), and a row that the cascade would delete
+* with its track is exactly the row this table exists to keep. The name says
+* PROVENANCE — the same distinction the stationary registry draws for the same
+* reason.
+*/
+/**
+* How many archived notes the cluster keeps, across every camera.
+*
+* GLOBAL, not per-device, and a COUNT, not an age. Both halves are deliberate:
+*
+*  - A per-device bound multiplies by the fleet — 30 cameras at 500 each is
+*    15 000 rows to protect a corpus that only ever gets read fleet-wide (the
+*    thing being mined is "what keeps going wrong", not "what goes wrong on
+*    617"). One global ceiling is one number to reason about.
+*  - An AGE bound would delete the corpus for being old, which is the failure
+*    being fixed: a note from six months ago is the most valuable row in the
+*    table precisely because the pattern it describes has had time to repeat.
+*
+* The number is sized off the measured rate. The 2026-09-08 sweep produced
+* 25–27 notes; call a heavy day 100. 5 000 rows is roughly fifty such days,
+* and at the observed rate (a few sweeps a week) several years. The cost is
+* bounded by construction: a note is capped at `MAX_TRACK_DEBUG_NOTE_LEN`
+* (500 chars) and the metadata beside it is under 100 bytes, so the ceiling is
+* ~3 MB of text and the realistic occupancy is well under 1 MB — against a
+* `tracks` table measured at 4.6 MB for a single 501-row page.
+*/
+var MAX_ARCHIVED_DEBUG_NOTES = 5e3;
+/** One archived note — the operator's words plus enough context to find what
+*  they were looking at, after the track itself is gone. */
+var ArchivedDebugNoteSchema = object({
+	/** Archive row id. Derived from `(sourceTrackId, note)`, so re-archiving the
+	*  same sentence about the same track lands on the row already there. */
+	id: string(),
+	/** The operator's own words, verbatim. */
+	note: string(),
+	/** The camera. Required — every question here is asked per-camera. */
+	deviceId: number().int(),
+	/** The track the note was written on. PROVENANCE, not ownership: the track
+	*  is expected to be gone, and this row is not a reference to it. */
+	sourceTrackId: string(),
+	/** Epoch ms the note was moved here, i.e. when the operator reviewed it. */
+	archivedAt: number().int(),
+	/** The track's `firstSeen`, when the row still knew it; `null` otherwise. */
+	trackStartedAt: number().int().nullable(),
+	/** The track's detector class (`person`, `car`, …); `null` when unknown. */
+	trackClass: string().nullable(),
+	/** The track's display label at review time; `null` when it had none. */
+	trackLabel: string().nullable()
+});
+/** Query input for `listArchivedDebugNotes` — newest first, one camera or all. */
+var ArchivedDebugNoteQueryInputSchema = object({
+	/** Restrict to a single camera; omit for every row. */
+	deviceId: number().int().optional(),
+	/** Max rows returned, newest-first. */
+	limit: number().int().min(1).max(1e3).optional()
+});
+/**
 * Ops-log — the durable, append-only operations audit shared by the
 * recordings and events management surfaces.
 *
@@ -16600,14 +16679,14 @@ var alarmPanelCapability = {
 			code: string().min(1).optional()
 		}), _void(), {
 			kind: "mutation",
-			auth: "admin"
+			auth: "protected"
 		}),
 		disarm: method(object({
 			deviceId: number().int().nonnegative(),
 			code: string().min(1).optional()
 		}), _void(), {
 			kind: "mutation",
-			auth: "admin"
+			auth: "protected"
 		}),
 		/**
 		* Force the panel into the `triggered` state — used by HA
@@ -16618,7 +16697,7 @@ var alarmPanelCapability = {
 		*/
 		trigger: method(object({ deviceId: number().int().nonnegative() }), _void(), {
 			kind: "mutation",
-			auth: "admin"
+			auth: "protected"
 		})
 	},
 	status: {
@@ -21389,6 +21468,31 @@ var pipelineAnalyticsCapability = {
 			flags: TrackFlagsPatchSchema
 		}), TrackFlagsSchema, { kind: "mutation" }),
 		/**
+		* The archived debug notes, newest first — the corpus of what operators
+		* have asked to be checked, across tracks that no longer exist (D405).
+		*
+		* `setTrackFlags` writes it: a patch carrying `debug: false` still clears
+		* the note off the track row in the same statement (D353's invariant is
+		* untouched), but the note is APPENDED here first. That is the whole point
+		* — before D405, finishing a review destroyed every note written during it,
+		* and the ones that survived aged out with their tracks. This method is the
+		* only way to read what was kept.
+		*
+		* `auth: 'protected'`, matching `setTrackFlags` next door and for the same
+		* reason: the notes are written from the viewer, by an authenticated
+		* non-admin session, and a corpus only an admin can read is a corpus the
+		* person who wrote it cannot use. It carries operator prose about cameras
+		* and nothing else — no media, no paths, no identities beyond a track's
+		* own display label.
+		*
+		* Newest-first, capped by `limit` (default
+		* {@link ARCHIVED_DEBUG_NOTES_DEFAULT_LIMIT}), optionally one camera. The
+		* table itself is bounded by row count, not by age — see
+		* {@link MAX_ARCHIVED_DEBUG_NOTES} for why an age clock would be the wrong
+		* bound for exactly this data.
+		*/
+		listArchivedDebugNotes: method(ArchivedDebugNoteQueryInputSchema, array(ArchivedDebugNoteSchema).readonly(), { kind: "query" }),
+		/**
 		* Durable event-store footprint for the management UI: event rows
 		* (motion + object + audio) counted per camera + total, plus the
 		* event-owned media bytes on disk per camera + total. Stat/count-based,
@@ -25795,7 +25899,7 @@ var brightnessCapability = {
 		percentage: number().min(0).max(100)
 	}), _void(), {
 		kind: "mutation",
-		auth: "admin"
+		auth: "protected"
 	}) },
 	events: { 
 	/**
@@ -25828,7 +25932,7 @@ onBrightnessChanged: { data: object({
 };
 DeviceType.Button, method(object({ deviceId: number().int().nonnegative() }), _void(), {
 	kind: "mutation",
-	auth: "admin"
+	auth: "protected"
 });
 /**
 * camera-credentials — device-scoped cap exposing the camera's network
@@ -26020,28 +26124,28 @@ var climateControlCapability = {
 			mode: HvacModeSchema
 		}), _void(), {
 			kind: "mutation",
-			auth: "admin"
+			auth: "protected"
 		}),
 		setFanMode: method(object({
 			deviceId: number().int().nonnegative(),
 			fanMode: string().min(1)
 		}), _void(), {
 			kind: "mutation",
-			auth: "admin"
+			auth: "protected"
 		}),
 		setPreset: method(object({
 			deviceId: number().int().nonnegative(),
 			preset: string().min(1)
 		}), _void(), {
 			kind: "mutation",
-			auth: "admin"
+			auth: "protected"
 		}),
 		setTarget: method(object({
 			deviceId: number().int().nonnegative(),
 			target: number()
 		}), _void(), {
 			kind: "mutation",
-			auth: "admin"
+			auth: "protected"
 		}),
 		setTargetRange: method(object({
 			deviceId: number().int().nonnegative(),
@@ -26049,28 +26153,28 @@ var climateControlCapability = {
 			targetHigh: number()
 		}), _void(), {
 			kind: "mutation",
-			auth: "admin"
+			auth: "protected"
 		}),
 		setTargetHumidity: method(object({
 			deviceId: number().int().nonnegative(),
 			targetHumidity: number().min(0).max(100)
 		}), _void(), {
 			kind: "mutation",
-			auth: "admin"
+			auth: "protected"
 		}),
 		setSwingVertical: method(object({
 			deviceId: number().int().nonnegative(),
 			on: boolean()
 		}), _void(), {
 			kind: "mutation",
-			auth: "admin"
+			auth: "protected"
 		}),
 		setSwingHorizontal: method(object({
 			deviceId: number().int().nonnegative(),
 			on: boolean()
 		}), _void(), {
 			kind: "mutation",
-			auth: "admin"
+			auth: "protected"
 		})
 	},
 	status: {
@@ -26170,7 +26274,7 @@ var colorCapability = {
 		color: ColorInputSchema
 	}), _void(), {
 		kind: "mutation",
-		auth: "admin"
+		auth: "protected"
 	}) },
 	events: { 
 	/**
@@ -26499,7 +26603,7 @@ var controlCapability = {
 		control: ControlSetValueInputSchema
 	}), _void(), {
 		kind: "mutation",
-		auth: "admin"
+		auth: "protected"
 	}) },
 	status: {
 		schema: ControlStatusSchema,
@@ -26545,29 +26649,29 @@ var coverCapability = {
 	methods: {
 		open: method(object({ deviceId: number().int().nonnegative() }), _void(), {
 			kind: "mutation",
-			auth: "admin"
+			auth: "protected"
 		}),
 		close: method(object({ deviceId: number().int().nonnegative() }), _void(), {
 			kind: "mutation",
-			auth: "admin"
+			auth: "protected"
 		}),
 		stop: method(object({ deviceId: number().int().nonnegative() }), _void(), {
 			kind: "mutation",
-			auth: "admin"
+			auth: "protected"
 		}),
 		setPosition: method(object({
 			deviceId: number().int().nonnegative(),
 			position: number().min(0).max(100)
 		}), _void(), {
 			kind: "mutation",
-			auth: "admin"
+			auth: "protected"
 		}),
 		setTiltPosition: method(object({
 			deviceId: number().int().nonnegative(),
 			tiltPosition: number().min(0).max(100)
 		}), _void(), {
 			kind: "mutation",
-			auth: "admin"
+			auth: "protected"
 		})
 	},
 	status: {
@@ -27389,28 +27493,28 @@ var fanControlCapability = {
 			percentage: number().min(0).max(100)
 		}), _void(), {
 			kind: "mutation",
-			auth: "admin"
+			auth: "protected"
 		}),
 		setPreset: method(object({
 			deviceId: number().int().nonnegative(),
 			preset: string().min(1)
 		}), _void(), {
 			kind: "mutation",
-			auth: "admin"
+			auth: "protected"
 		}),
 		setDirection: method(object({
 			deviceId: number().int().nonnegative(),
 			direction: FanDirectionSchema
 		}), _void(), {
 			kind: "mutation",
-			auth: "admin"
+			auth: "protected"
 		}),
 		setOscillating: method(object({
 			deviceId: number().int().nonnegative(),
 			oscillating: boolean()
 		}), _void(), {
 			kind: "mutation",
-			auth: "admin"
+			auth: "protected"
 		})
 	},
 	status: {
@@ -27632,21 +27736,21 @@ var humidifierCapability = {
 			on: boolean()
 		}), _void(), {
 			kind: "mutation",
-			auth: "admin"
+			auth: "protected"
 		}),
 		setTargetHumidity: method(object({
 			deviceId: number().int().nonnegative(),
 			humidity: number().min(0).max(100)
 		}), _void(), {
 			kind: "mutation",
-			auth: "admin"
+			auth: "protected"
 		}),
 		setMode: method(object({
 			deviceId: number().int().nonnegative(),
 			mode: string().min(1)
 		}), _void(), {
 			kind: "mutation",
-			auth: "admin"
+			auth: "protected"
 		})
 	},
 	status: {
@@ -28347,15 +28451,15 @@ var lawnMowerControlCapability = {
 	methods: {
 		startMowing: method(object({ deviceId: number().int().nonnegative() }), _void(), {
 			kind: "mutation",
-			auth: "admin"
+			auth: "protected"
 		}),
 		pause: method(object({ deviceId: number().int().nonnegative() }), _void(), {
 			kind: "mutation",
-			auth: "admin"
+			auth: "protected"
 		}),
 		dock: method(object({ deviceId: number().int().nonnegative() }), _void(), {
 			kind: "mutation",
-			auth: "admin"
+			auth: "protected"
 		})
 	},
 	status: {
@@ -28640,18 +28744,18 @@ var lockControlCapability = {
 			code: string().min(1).optional()
 		}), _void(), {
 			kind: "mutation",
-			auth: "admin"
+			auth: "protected"
 		}),
 		unlock: method(object({
 			deviceId: number().int().nonnegative(),
 			code: string().min(1).optional()
 		}), _void(), {
 			kind: "mutation",
-			auth: "admin"
+			auth: "protected"
 		}),
 		open: method(object({ deviceId: number().int().nonnegative() }), _void(), {
 			kind: "mutation",
-			auth: "admin"
+			auth: "protected"
 		})
 	},
 	status: {
@@ -28754,65 +28858,65 @@ var mediaPlayerCapability = {
 	methods: {
 		play: method(object({ deviceId: number().int().nonnegative() }), _void(), {
 			kind: "mutation",
-			auth: "admin"
+			auth: "protected"
 		}),
 		pause: method(object({ deviceId: number().int().nonnegative() }), _void(), {
 			kind: "mutation",
-			auth: "admin"
+			auth: "protected"
 		}),
 		stop: method(object({ deviceId: number().int().nonnegative() }), _void(), {
 			kind: "mutation",
-			auth: "admin"
+			auth: "protected"
 		}),
 		next: method(object({ deviceId: number().int().nonnegative() }), _void(), {
 			kind: "mutation",
-			auth: "admin"
+			auth: "protected"
 		}),
 		previous: method(object({ deviceId: number().int().nonnegative() }), _void(), {
 			kind: "mutation",
-			auth: "admin"
+			auth: "protected"
 		}),
 		seek: method(object({
 			deviceId: number().int().nonnegative(),
 			positionMs: number().int().nonnegative()
 		}), _void(), {
 			kind: "mutation",
-			auth: "admin"
+			auth: "protected"
 		}),
 		setVolume: method(object({
 			deviceId: number().int().nonnegative(),
 			volumeLevel: number().min(0).max(100)
 		}), _void(), {
 			kind: "mutation",
-			auth: "admin"
+			auth: "protected"
 		}),
 		setMute: method(object({
 			deviceId: number().int().nonnegative(),
 			muted: boolean()
 		}), _void(), {
 			kind: "mutation",
-			auth: "admin"
+			auth: "protected"
 		}),
 		setShuffle: method(object({
 			deviceId: number().int().nonnegative(),
 			shuffle: boolean()
 		}), _void(), {
 			kind: "mutation",
-			auth: "admin"
+			auth: "protected"
 		}),
 		setRepeat: method(object({
 			deviceId: number().int().nonnegative(),
 			repeat: MediaPlayerRepeatSchema
 		}), _void(), {
 			kind: "mutation",
-			auth: "admin"
+			auth: "protected"
 		}),
 		selectSource: method(object({
 			deviceId: number().int().nonnegative(),
 			source: string().min(1)
 		}), _void(), {
 			kind: "mutation",
-			auth: "admin"
+			auth: "protected"
 		}),
 		playMedia: method(object({
 			deviceId: number().int().nonnegative(),
@@ -28823,7 +28927,7 @@ var mediaPlayerCapability = {
 			mediaType: string().min(1)
 		}), _void(), {
 			kind: "mutation",
-			auth: "admin"
+			auth: "protected"
 		})
 	},
 	status: {
@@ -30416,27 +30520,27 @@ var petFeederCapability = {
 			hopper2: gramsPortion.optional()
 		}), _void(), {
 			kind: "mutation",
-			auth: "admin"
+			auth: "protected"
 		}),
 		/** Cancel an in-progress manual feed. */
 		cancelFeed: method(object({ deviceId: number().int().nonnegative() }), _void(), {
 			kind: "mutation",
-			auth: "admin"
+			auth: "protected"
 		}),
 		/** Reset the desiccant "days remaining" counter after replacing it. */
 		resetDesiccant: method(object({ deviceId: number().int().nonnegative() }), _void(), {
 			kind: "mutation",
-			auth: "admin"
+			auth: "protected"
 		}),
 		/** Mark a hopper as refilled (D4H/D4S/D4SH). */
 		markFoodReplenished: method(object({ deviceId: number().int().nonnegative() }), _void(), {
 			kind: "mutation",
-			auth: "admin"
+			auth: "protected"
 		}),
 		/** Call the pet with the recorded prompt (D3). */
 		callPet: method(object({ deviceId: number().int().nonnegative() }), _void(), {
 			kind: "mutation",
-			auth: "admin"
+			auth: "protected"
 		}),
 		/** Play a stored sound by id (D3 / D4H / D4SH). */
 		playSound: method(object({
@@ -30444,7 +30548,7 @@ var petFeederCapability = {
 			soundId: number().int().nonnegative()
 		}), _void(), {
 			kind: "mutation",
-			auth: "admin"
+			auth: "protected"
 		}),
 		/** Toggle the child-lock (manual-lock) setting. */
 		setChildLock: method(object({
@@ -30452,7 +30556,7 @@ var petFeederCapability = {
 			on: boolean()
 		}), _void(), {
 			kind: "mutation",
-			auth: "admin"
+			auth: "protected"
 		}),
 		/** Toggle the front indicator light. */
 		setIndicatorLight: method(object({
@@ -30460,7 +30564,7 @@ var petFeederCapability = {
 			on: boolean()
 		}), _void(), {
 			kind: "mutation",
-			auth: "admin"
+			auth: "protected"
 		}),
 		/** Toggle the dispense chime. */
 		setFeedSound: method(object({
@@ -30468,7 +30572,7 @@ var petFeederCapability = {
 			on: boolean()
 		}), _void(), {
 			kind: "mutation",
-			auth: "admin"
+			auth: "protected"
 		}),
 		/** Set the speaker / prompt volume level. */
 		setVolume: method(object({
@@ -30476,7 +30580,7 @@ var petFeederCapability = {
 			level: number().int().nonnegative()
 		}), _void(), {
 			kind: "mutation",
-			auth: "admin"
+			auth: "protected"
 		})
 	},
 	status: {
@@ -32831,7 +32935,7 @@ var switchCapability = {
 		on: boolean()
 	}), _void(), {
 		kind: "mutation",
-		auth: "admin"
+		auth: "protected"
 	}) },
 	events: { onStateChanged: { data: object({
 		deviceId: number(),
@@ -33819,30 +33923,30 @@ var vacuumControlCapability = {
 	methods: {
 		start: method(object({ deviceId: number().int().nonnegative() }), _void(), {
 			kind: "mutation",
-			auth: "admin"
+			auth: "protected"
 		}),
 		pause: method(object({ deviceId: number().int().nonnegative() }), _void(), {
 			kind: "mutation",
-			auth: "admin"
+			auth: "protected"
 		}),
 		stop: method(object({ deviceId: number().int().nonnegative() }), _void(), {
 			kind: "mutation",
-			auth: "admin"
+			auth: "protected"
 		}),
 		returnToBase: method(object({ deviceId: number().int().nonnegative() }), _void(), {
 			kind: "mutation",
-			auth: "admin"
+			auth: "protected"
 		}),
 		locate: method(object({ deviceId: number().int().nonnegative() }), _void(), {
 			kind: "mutation",
-			auth: "admin"
+			auth: "protected"
 		}),
 		setFanSpeed: method(object({
 			deviceId: number().int().nonnegative(),
 			speed: string().min(1)
 		}), _void(), {
 			kind: "mutation",
-			auth: "admin"
+			auth: "protected"
 		})
 	},
 	status: {
@@ -33886,22 +33990,22 @@ var valveCapability = {
 	methods: {
 		open: method(object({ deviceId: number().int().nonnegative() }), _void(), {
 			kind: "mutation",
-			auth: "admin"
+			auth: "protected"
 		}),
 		close: method(object({ deviceId: number().int().nonnegative() }), _void(), {
 			kind: "mutation",
-			auth: "admin"
+			auth: "protected"
 		}),
 		stop: method(object({ deviceId: number().int().nonnegative() }), _void(), {
 			kind: "mutation",
-			auth: "admin"
+			auth: "protected"
 		}),
 		setPosition: method(object({
 			deviceId: number().int().nonnegative(),
 			position: number().min(0).max(100)
 		}), _void(), {
 			kind: "mutation",
-			auth: "admin"
+			auth: "protected"
 		})
 	},
 	status: {
@@ -34000,21 +34104,21 @@ var waterHeaterCapability = {
 			temp: number().finite()
 		}), _void(), {
 			kind: "mutation",
-			auth: "admin"
+			auth: "protected"
 		}),
 		setOperationMode: method(object({
 			deviceId: number().int().nonnegative(),
 			mode: string().min(1)
 		}), _void(), {
 			kind: "mutation",
-			auth: "admin"
+			auth: "protected"
 		}),
 		setAway: method(object({
 			deviceId: number().int().nonnegative(),
 			on: boolean()
 		}), _void(), {
 			kind: "mutation",
-			auth: "admin"
+			auth: "protected"
 		})
 	},
 	status: {
@@ -39060,6 +39164,12 @@ Object.freeze({
 		addonId: null,
 		access: "view"
 	},
+	"pipelineAnalytics.listArchivedDebugNotes": {
+		capName: "pipeline-analytics",
+		capScope: "device",
+		addonId: null,
+		access: "view"
+	},
 	"pipelineAnalytics.listEventKinds": {
 		capName: "pipeline-analytics",
 		capScope: "device",
@@ -42847,6 +42957,11 @@ Object.freeze({
 		form: "array",
 		optional: true
 	}],
+	"pipelineAnalytics.listArchivedDebugNotes": [{
+		name: "deviceId",
+		form: "single",
+		optional: true
+	}],
 	"pipelineAnalytics.listEventKinds": [{
 		name: "deviceId",
 		form: "single",
@@ -44779,6 +44894,12 @@ Object.defineProperty(exports, "AUDIO_MACRO_LABELS", {
 		return AUDIO_MACRO_LABELS;
 	}
 });
+Object.defineProperty(exports, "ArchivedDebugNoteSchema", {
+	enumerable: true,
+	get: function() {
+		return ArchivedDebugNoteSchema;
+	}
+});
 Object.defineProperty(exports, "BaseAddon", {
 	enumerable: true,
 	get: function() {
@@ -44893,6 +45014,12 @@ Object.defineProperty(exports, "MACRO_LABELS", {
 		return MACRO_LABELS;
 	}
 });
+Object.defineProperty(exports, "MAX_ARCHIVED_DEBUG_NOTES", {
+	enumerable: true,
+	get: function() {
+		return MAX_ARCHIVED_DEBUG_NOTES;
+	}
+});
 Object.defineProperty(exports, "MediaFileKindEnum", {
 	enumerable: true,
 	get: function() {

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-CoLA3NHh.js");
+const require_dist = require("../dist-FHSaZkf_.js");
 let node_fs = require("node:fs");
 node_fs = require_dist.__toESM(node_fs);
 let node_path = require("node:path");