@camstack/system 1.2.332 → 1.2.334

package/dist/builtins/system-config/system-config.addon.mjs

@@ -1,4 +1,4 @@
-import { Hn as errMsg, Un as BaseAddon, rr as hydrateSchema } from "../../dist-BEPK2RUO.mjs";
+import { Hn as errMsg, Un as BaseAddon, rr as hydrateSchema } from "../../dist-COj36Fwm.mjs";
 //#region src/builtins/system-config/system-config.addon.ts
 /**
 * Built-in `system-config` addon — Phase 4 of the settings redesign.

package/dist/builtins/winston-logging/index.js

@@ -3,7 +3,7 @@ Object.defineProperties(exports, {
 	[Symbol.toStringTag]: { value: "Module" }
 });
 const require_chunk = require("../../chunk-Cek0wNdY.js");
-const require_dist = require("../../dist-CH3jfPMi.js");
+const require_dist = require("../../dist-Ex-rbzic.js");
 const require_formatter = require("../../formatter-DqAKDlvN.js");
 let node_path = require("node:path");
 node_path = require_chunk.__toESM(node_path);

package/dist/builtins/winston-logging/index.mjs

@@ -1,4 +1,4 @@
-import { Un as BaseAddon, Vt as logDestinationCapability } from "../../dist-BEPK2RUO.mjs";
+import { Un as BaseAddon, Vt as logDestinationCapability } from "../../dist-COj36Fwm.mjs";
 import { t as formatLogLine } from "../../formatter-B7qW8bPJ.mjs";
 import * as path$1 from "node:path";
 import path from "node:path";

package/dist/{child-cap-dispatch-93MfsaZL.js → child-cap-dispatch-Cy56Y66E.js}

@@ -1,4 +1,5 @@
 const require_chunk = require("./chunk-Cek0wNdY.js");
+const require_dist = require("./dist-Ex-rbzic.js");
 const require_proc_stat = require("./proc-stat-DL-WUOhl.js");
 require("./hub-cap-forward-DmHNjbB0.js");
 let node_crypto = require("node:crypto");
@@ -8527,6 +8528,11 @@ async function answerClaimedGetStatus(resolve, call) {
 	if (answer.kind === "unclaimed") return null;
 	return { slice: answer.kind === "claimed" ? answer.slice : null };
 }
+/** The source every runner lifecycle event this registry emits carries. */
+var LIFECYCLE_SOURCE = {
+	type: "core",
+	id: "local-child-registry"
+};
 function readFanoutMode() {
 	const raw = process.env.CAMSTACK_UDS_EVENT_FANOUT;
 	if (raw === "shadow" || raw === "broadcast") return raw;
@@ -8557,6 +8563,9 @@ var LocalChildRegistry = class {
 	server;
 	onUnownedCall;
 	logger;
+	lifecycleEvents;
+	/** Per childId: the incarnation `WorkerOnline` was last said for. */
+	announcedIncarnation = /* @__PURE__ */ new Map();
 	getActiveSingletonAddonId;
 	resolveChildIdForAddon;
 	/** This node's own Moleculer nodeId (see {@link LocalChildRegistryOptions.ownNodeId}). */
@@ -8618,6 +8627,7 @@ var LocalChildRegistry = class {
 			this.server = opts.server;
 			this.onUnownedCall = opts.onUnownedCall;
 			this.logger = opts.logger;
+			this.lifecycleEvents = opts.lifecycleEvents;
 			this.getActiveSingletonAddonId = opts.getActiveSingletonAddonId;
 			this.resolveChildIdForAddon = opts.resolveChildIdForAddon;
 			this.ownNodeId = opts.ownNodeId;
@@ -9132,6 +9142,33 @@ var LocalChildRegistry = class {
 	async close() {
 		await this.server.close();
 	}
+	/** `WorkerOnline`, once per incarnation: a re-register of the same connection says nothing. */
+	announceOnline(childId, incarnation) {
+		const events = this.lifecycleEvents;
+		if (events === void 0 || this.announcedIncarnation.get(childId) === incarnation) return;
+		this.announcedIncarnation.set(childId, incarnation);
+		const workerId = `${events.parentNodeId()}/${childId}`;
+		this.emitLifecycle(events, require_dist.createEvent(require_dist.EventCategory.WorkerOnline, LIFECYCLE_SOURCE, { workerId }), incarnation);
+	}
+	/** `WorkerOffline` for the LIVE connection's close (a superseded close never reaches here). */
+	announceOffline(childId, incarnation) {
+		const events = this.lifecycleEvents;
+		if (events === void 0) return;
+		this.announcedIncarnation.delete(childId);
+		const workerId = `${events.parentNodeId()}/${childId}`;
+		this.emitLifecycle(events, require_dist.createEvent(require_dist.EventCategory.WorkerOffline, LIFECYCLE_SOURCE, { workerId }), incarnation);
+	}
+	emitLifecycle(events, event, incarnation) {
+		try {
+			events.emit(event);
+		} catch (err) {
+			this.logger?.info("runner lifecycle event could not be emitted", {
+				category: event.category,
+				incarnation,
+				error: err instanceof Error ? err.message : String(err)
+			});
+		}
+	}
 	onConnection(channel) {
 		let childId = null;
 		const incarnation = this.nextIncarnation++;
@@ -9187,6 +9224,7 @@ var LocalChildRegistry = class {
 				});
 				this.invalidateCapIndex();
 				this.logPatternSet(msg.childId, eventPatterns);
+				this.announceOnline(msg.childId, incarnation);
 				this.registeredHandler({
 					childId: msg.childId,
 					caps: msg.caps,
@@ -9286,6 +9324,7 @@ var LocalChildRegistry = class {
 			this.actionCensus.forget(childId);
 			this.loggedPatternSet.delete(childId);
 			this.goneHandler(childId, incarnation);
+			this.announceOffline(childId, incarnation);
 		});
 	}
 };

package/dist/{child-cap-dispatch-kLIiU1CG.mjs → child-cap-dispatch-Dmo2YJFe.mjs}

@@ -1,3 +1,4 @@
+import { $n as createEvent, mr as EventCategory$1 } from "./dist-COj36Fwm.mjs";
 import { a as parseProcStat, i as nodeProcReader } from "./proc-stat-CbC55Kqi.mjs";
 import "./hub-cap-forward-BdT320dq.mjs";
 import * as crypto$1 from "node:crypto";
@@ -8524,6 +8525,11 @@ async function answerClaimedGetStatus(resolve, call) {
 	if (answer.kind === "unclaimed") return null;
 	return { slice: answer.kind === "claimed" ? answer.slice : null };
 }
+/** The source every runner lifecycle event this registry emits carries. */
+var LIFECYCLE_SOURCE = {
+	type: "core",
+	id: "local-child-registry"
+};
 function readFanoutMode() {
 	const raw = process.env.CAMSTACK_UDS_EVENT_FANOUT;
 	if (raw === "shadow" || raw === "broadcast") return raw;
@@ -8554,6 +8560,9 @@ var LocalChildRegistry = class {
 	server;
 	onUnownedCall;
 	logger;
+	lifecycleEvents;
+	/** Per childId: the incarnation `WorkerOnline` was last said for. */
+	announcedIncarnation = /* @__PURE__ */ new Map();
 	getActiveSingletonAddonId;
 	resolveChildIdForAddon;
 	/** This node's own Moleculer nodeId (see {@link LocalChildRegistryOptions.ownNodeId}). */
@@ -8615,6 +8624,7 @@ var LocalChildRegistry = class {
 			this.server = opts.server;
 			this.onUnownedCall = opts.onUnownedCall;
 			this.logger = opts.logger;
+			this.lifecycleEvents = opts.lifecycleEvents;
 			this.getActiveSingletonAddonId = opts.getActiveSingletonAddonId;
 			this.resolveChildIdForAddon = opts.resolveChildIdForAddon;
 			this.ownNodeId = opts.ownNodeId;
@@ -9129,6 +9139,33 @@ var LocalChildRegistry = class {
 	async close() {
 		await this.server.close();
 	}
+	/** `WorkerOnline`, once per incarnation: a re-register of the same connection says nothing. */
+	announceOnline(childId, incarnation) {
+		const events = this.lifecycleEvents;
+		if (events === void 0 || this.announcedIncarnation.get(childId) === incarnation) return;
+		this.announcedIncarnation.set(childId, incarnation);
+		const workerId = `${events.parentNodeId()}/${childId}`;
+		this.emitLifecycle(events, createEvent(EventCategory$1.WorkerOnline, LIFECYCLE_SOURCE, { workerId }), incarnation);
+	}
+	/** `WorkerOffline` for the LIVE connection's close (a superseded close never reaches here). */
+	announceOffline(childId, incarnation) {
+		const events = this.lifecycleEvents;
+		if (events === void 0) return;
+		this.announcedIncarnation.delete(childId);
+		const workerId = `${events.parentNodeId()}/${childId}`;
+		this.emitLifecycle(events, createEvent(EventCategory$1.WorkerOffline, LIFECYCLE_SOURCE, { workerId }), incarnation);
+	}
+	emitLifecycle(events, event, incarnation) {
+		try {
+			events.emit(event);
+		} catch (err) {
+			this.logger?.info("runner lifecycle event could not be emitted", {
+				category: event.category,
+				incarnation,
+				error: err instanceof Error ? err.message : String(err)
+			});
+		}
+	}
 	onConnection(channel) {
 		let childId = null;
 		const incarnation = this.nextIncarnation++;
@@ -9184,6 +9221,7 @@ var LocalChildRegistry = class {
 				});
 				this.invalidateCapIndex();
 				this.logPatternSet(msg.childId, eventPatterns);
+				this.announceOnline(msg.childId, incarnation);
 				this.registeredHandler({
 					childId: msg.childId,
 					caps: msg.caps,
@@ -9283,6 +9321,7 @@ var LocalChildRegistry = class {
 			this.actionCensus.forget(childId);
 			this.loggedPatternSet.delete(childId);
 			this.goneHandler(childId, incarnation);
+			this.announceOffline(childId, incarnation);
 		});
 	}
 };

package/dist/{composition-sources-BpyaHvoR.mjs → composition-sources-BWautla8.mjs}

@@ -1,4 +1,4 @@
-import { Hn as errMsg, In as compositionSourceKey } from "./dist-BEPK2RUO.mjs";
+import { Hn as errMsg, In as compositionSourceKey } from "./dist-COj36Fwm.mjs";
 //#region src/builtins/core-blocks/composition-sources.ts
 /**
 * Describe what a composition reads and writes for SAVE-time validation

package/dist/{composition-sources-DK--XR5V.js → composition-sources-BuIRUkTE.js}

@@ -1,4 +1,4 @@
-const require_dist = require("./dist-CH3jfPMi.js");
+const require_dist = require("./dist-Ex-rbzic.js");
 //#region src/builtins/core-blocks/composition-sources.ts
 /**
 * Describe what a composition reads and writes for SAVE-time validation

package/dist/{dist-BEPK2RUO.mjs → dist-COj36Fwm.mjs}

@@ -3521,7 +3521,7 @@ function errMsg(err) {
 	return String(err);
 }
 //#endregion
-//#region ../types/dist/composition-43aqsZQj.mjs
+//#region ../types/dist/composition-D7ULvLdD.mjs
 var AUDIO_ENCODER_BY_CODEC = {
 	opus: "libopus",
 	aac: "aac",
@@ -3967,20 +3967,20 @@ function portable(target) {
 }
 portable("linux64"), portable("linuxarm64"), portable("macarm64"), portable("mac64");
 /**
-* LA tabella "quale booleano di questo tipo di device conta come ALTO", e il
-* valutatore puro del suo FRONTE.
+* THE table "which boolean of this device type counts as HIGH", and the
+* pure evaluator of its EDGE.
 *
-* UNA tabella per tutti quelli che chiedono "questo device è ALTO?": il
-* trigger `RecordingTriggers.sensorDeviceIds` del recorder, i marker dei
-* sensori della post-analysis, il bridge camera-sensors dell'orchestratore e
-* le sorgenti di un campanello composto (`doorbellFeatureSources`, D671).
-* Una seconda copia divergerebbe alla prima cap aggiunta, e il sintomo — "il
-* sensore fa suonare il campanello ma non registra" — è esattamente D62.
+* ONE table for everyone who asks "is this device HIGH?": the
+* recorder's `RecordingTriggers.sensorDeviceIds` trigger, the post-analysis
+* sensor markers, the orchestrator's camera-sensors bridge and
+* the sources of a composite doorbell (`doorbellFeatureSources`, D671).
+* A second copy would diverge at the first cap added, and the symptom — "the
+* sensor rings the doorbell but does not record" — is exactly D62.
 *
-* ⚠ NON è `DEVICE_STATE_READERS` (`catalogs/device-state-vocabulary.ts`), e le
-* due non vanno unificate: quella risponde a "qual è la PAROLA di stato per una
-* regola" (e include `presence`, `cover`, `alarm-panel`), questa a "qual è il
-* booleano il cui FRONTE conta". Vocabolari deliberatamente diversi.
+* ⚠ NOT `DEVICE_STATE_READERS` (`catalogs/device-state-vocabulary.ts`), and the
+* two must not be unified: that one answers "what is the state WORD for a
+* rule" (and includes `presence`, `cover`, `alarm-panel`), this one "which
+* boolean's EDGE counts". Deliberately different vocabularies.
 */
 /**
 * Known binary / switch source caps → the boolean slice field whose
@@ -6149,22 +6149,22 @@ var CLASS_MAP_MACRO_TARGETS = [
 	"package"
 ];
 /**
-* Le macro classi di PRIMO LIVELLO: quelle che un object detector emette e che
-* un operatore può selezionare.
+* The FIRST-LEVEL macro classes: those an object detector emits and that
+* an operator can select.
 *
-* Sono le tre offerte dallo step `object-detection`
+* They are the three offered by the `object-detection` step
 * (`addon-pipeline/src/detection-pipeline/registry/step-definitions.ts`,
-* `enabledMacroClasses`). `package` sta in {@link CLASS_MAP_MACRO_TARGETS} e in
-* `MACRO_LABELS` — è una macro vera — ma NON qui: appartiene allo step
-* `package-detection`, la cui abilitazione è guidata dalle zone, e offrire la
-* stessa parola due volte ha già fatto accendere a un operatore il proxy COCO
+* `enabledMacroClasses`). `package` is in {@link CLASS_MAP_MACRO_TARGETS} and in
+* `MACRO_LABELS` — it is a true macro — but NOT here: it belongs to the step
+* `package-detection`, whose enablement is driven by zones, and offering the
+* same word twice has already made an operator turn on the COCO proxy
 * (suitcase/backpack/handbag) lasciando spento il detector dedicato.
 *
-* UNA lista. Prima di oggi le stesse tre erano scritte a mano nell'offerta
-* dello step e una seconda volta come union `FirstLevelMacro`
-* (`types/detection.ts`); una terza copia per il trigger di registrazione
-* (`RecordingTriggers.objectClasses`) avrebbe reso invisibile la divergenza
-* successiva.
+* ONE list. Before today the same three were hand-written in the step's offer
+* and a second time as the union `FirstLevelMacro`
+* (`types/detection.ts`); a third copy for the recording trigger
+* (`RecordingTriggers.objectClasses`) would have made the later divergence
+* invisible.
 */
 var FIRST_LEVEL_MACRO_CLASSES = [
 	"person",
@@ -6229,17 +6229,17 @@ var RecordingStorageModeSchema = z.enum([
 	"on-device-decision"
 ]);
 /**
-* Le macro classi che possono aprire una finestra di registrazione — le stesse
-* tre offerte dallo step `object-detection`, da UNA lista
+* The macro classes that can open a recording window — the same
+* three offered by the `object-detection` step, from ONE list
 * ({@link FIRST_LEVEL_MACRO_CLASSES}).
 */
 var RecordingObjectTriggerClassSchema = z.enum(FIRST_LEVEL_MACRO_CLASSES);
 /**
-* True quando `values` non ripete un elemento.
+* True when `values` does not repeat an element.
 *
-* Un duplicato non è innocuo: ogni voce di `objectClasses` / `sensorDeviceIds`
-* diventa una SORGENTE in `bandTriggerSources`, e la stessa sorgente due volte
-* conterebbe due volte le sue finestre in `segmentMissedByMs`.
+* A duplicate is not harmless: every entry of `objectClasses` / `sensorDeviceIds`
+* becomes a SOURCE in `bandTriggerSources`, and the same source twice
+* would count its windows twice in `segmentMissedByMs`.
 */
 var noDuplicates = (values) => new Set(values).size === values.length;
 /** Which detectors trigger an `events`-mode band. */
@@ -6247,34 +6247,34 @@ var RecordingTriggersSchema = z.object({
 	motion: z.boolean().optional(),
 	audioThresholdDbfs: z.number().optional(),
 	/**
-	* Le macro classi la cui detection apre una finestra. ASSENTE = la sorgente
-	* non è ascoltata; un array VUOTO è rifiutato, perché "banda events, trigger
-	* object acceso, nessuna classe" è la stessa forma "abilitata e non registra
-	* nulla, per sempre" contro cui è scritto `eventsBandCanEverDemand`.
+	* The macro classes whose detection opens a window. ABSENT = the source
+	* is not listened to; an EMPTY array is rejected, because "events band, object
+	* trigger on, no class" is the same shape "enabled and records
+	* nothing, forever" that `eventsBandCanEverDemand` is written against.
 	*
-	* Il segnale letto è GIÀ FILTRATO: solo detection `source: 'pipeline'`, cioè
-	* quelle che hanno attraversato `enabledMacroClasses`, i
-	* `minConfidence<Macro>` e il full-frame guard. L'AI a bordo camera
-	* (`source: 'onboard'`) non attraversa nessuno di quei gate e NON apre
-	* finestre — vedi `recorder/object-trigger.ts`.
+	* The signal read is ALREADY FILTERED: only `source: 'pipeline'` detections, i.e.
+	* those that went through `enabledMacroClasses`, the
+	* `minConfidence<Macro>` and the full-frame guard. The camera's onboard AI
+	* (`source: 'onboard'`) goes through none of those gates and does NOT open
+	* windows — see `recorder/object-trigger.ts`.
 	*/
 	objectClasses: z.array(RecordingObjectTriggerClassSchema).min(1).refine(noDuplicates, { message: "objectClasses must not repeat a class" }).optional(),
 	/**
-	* I device LINKED il cui FRONTE ALTO apre una finestra. Assente = la sorgente
-	* non è ascoltata; un array vuoto è rifiutato per la stessa ragione di
+	* The LINKED devices whose RISING EDGE opens a window. Absent = the source
+	* is not listened to; an empty array is rejected for the same reason as
 	* `objectClasses`.
 	*
-	* Sono id di device SORGENTE, non camere: la banda li nomina, quindi il
-	* percorso caldo (`DeviceStateChanged`, a ritmo di bus su tutta la flotta)
-	* non fa RPC. L'OFFERTA da cui l'operatore li sceglie è un'altra domanda, e
-	* si risolve con `deviceManager.getLinkedDevices` + `getBindingsBatch` per
-	* device (D12) — mai un elenco globale di cap.
+	* These are SOURCE device ids, not cameras: the band names them, so the
+	* hot path (`DeviceStateChanged`, at bus rate across the whole fleet)
+	* does no RPC. The OFFER from which the operator picks them is another question, and
+	* is resolved with `deviceManager.getLinkedDevices` + `getBindingsBatch` per
+	* device (D12) — never a global list of caps.
 	*
-	* Cosa vuol dire "alto" dipende dal TIPO di device e non è deciso qui:
-	* `SOURCE_CAP_ACTIVE_FIELD` (`catalogs/sensor-active-state.ts`) è LA tabella,
-	* la stessa del campanello composto (D671). Ed è il FRONTE, non
-	* il livello: un contatto trovato già aperto al riavvio del runner non fa
-	* registrare.
+	* What "high" means depends on the device TYPE and is not decided here:
+	* `SOURCE_CAP_ACTIVE_FIELD` (`catalogs/sensor-active-state.ts`) is THE table,
+	* the same one as the composite doorbell (D671). And it is the EDGE, not
+	* the level: a contact found already open at runner restart does not
+	* record.
 	*/
 	sensorDeviceIds: z.array(z.number().int().positive()).min(1).max(16).refine(noDuplicates, { message: "sensorDeviceIds must not repeat a device" }).optional()
 });
@@ -7545,7 +7545,7 @@ var DecoderSessionConfigSchema = z.object({
 * - **VALUE** — at which level, for which scope, until when. That stays ONE
 *   thing: the logging settings document on the `system` cap. Two authorities
 *   over the values is the exact defect
-*   `docs/design/plans/2026-08-26-logging-per-componente.md` was written to
+*   `docs/design/plans/2026-08-26-per-component-logging.md` was written to
 *   remove; re-introducing it from the cure side would be grotesque.
 *
 * Nothing in this file reads a clock, an env var or a store. The registry is
@@ -13660,7 +13660,7 @@ var dataStoreProviderCapability = {
 			*
 			* ⚠ An earlier version of this comment blamed Zod stripping, and that
 			* was wrong — corrected 2026-08-26 after the hop map
-			* (`docs/design/2026-08-26-mappa-hop-argomenti.md`) traced the path.
+			* (`docs/design/2026-08-26-topic-hop-map.md`) traced the path.
 			* There is **no Zod parse at all** between the door and the engine: the
 			* dispatcher forwards the payload verbatim and UDS carries it whole. A
 			* field declared here reaches `SqliteSettingsBackend` either way.
@@ -14746,7 +14746,17 @@ function siteZoneKey(label) {
 var ProviderStatusSchema = z.object({
 	connected: z.boolean(),
 	deviceCount: z.number(),
-	error: z.string().optional()
+	error: z.string().optional(),
+	/**
+	* `'orchestrator'`: this provider writes NO camera's `motion` runtime slice
+	* — the orchestrator is its only writer (D696). Set by `BaseDeviceProvider`,
+	* which every provider bundles, so only a provider BUILT from D696-amended
+	* code says it. ABSENT means an older provider that may still write it (raw
+	* VMD writes, a boot seed), and the orchestrator's provider gate keeps that
+	* provider's cameras unwritten (`camera-sensors/motion-slice-provider-gate.ts`)
+	* — the provider twin of the runner's `getLocalLoad().motionSliceWriter`.
+	*/
+	motionSliceWriter: z.literal("orchestrator").optional()
 });
 z.object({
 	externalId: z.string(),
@@ -15937,7 +15947,7 @@ var deviceManagerCapability = {
 		* sources could be switched off without switching off the rest (D556, then
 		* D555's re-key by source). The operator removed the whole idea the same
 		* day: *"tutti i providers funzionano sempre, non serve
-		* disattivarli/attivarli … loro vivono lì"* (D557 amended, third). A
+		* disattivarli/attivarli … loro vivono lì"* [all the providers always work, there is no need to deactivate/activate them … they live there] (D557 amended, third). A
 		* collection cap's providers are a DERIVED set — every addon that provides
 		* the cap for this device type, computed on every read and persisted
 		* nowhere — so there is nothing here to activate, and a verb that accepted
@@ -16789,7 +16799,7 @@ var embeddingEncoderCapability = {
 * per-device window, `KeyFrameCaptureLog`, `bumpCropMetric`. Every one of them
 * ends in a log line, and a log line is the thing the operator asked to stop
 * needing: *"possiamo armare questi errori intanto? Così al prossimo giro
-* ricontrolliamo tutti questi punti"*. Reading them meant grepping Loki and
+* ricontrolliamo tutti questi punti"* [can we instrument these errors in the meantime? That way next round we recheck all these points]. Reading them meant grepping Loki and
 * hand-correlating timestamps, which is how a 22% thumbnail gap and a 3-hour
 * media blackout were both diagnosed. The counters stay; this is where they can
 * be READ.
@@ -23060,14 +23070,14 @@ var TrackSchema = z.object({
 	* `derive-returned-null tile=standin`,
 	* `native-tile tile=native no-key-frame-at-close`, …) written at close and
 	* CLEARED by the late-keyFrame upgrade when a native tile lands after all.
-	* The operator-facing answer to "perché manca l'immagine?" on a track whose
+	* The operator-facing answer to "perché manca l'immagine?" [why is the image missing?] on a track whose
 	* tile is a face/plate stand-in, a raster crop, or an icon.
 	*
 	* **`no-key-frame-at-close` (D400).** The line used to be written ONLY when
 	* the TILE ranked below native, so a track whose thumbnail landed natively
 	* while its key frame missed carried no reason at all — three of the four
 	* `MISSING_KEYFRAME` tracks in the 2026-09-07 operator audit were exactly
-	* that shape, and their "niente ultimo" had no cause anywhere on the row.
+	* that shape, and their "niente ultimo" [no last frame] had no cause anywhere on the row.
 	* The key frame is the head of a cascade (`keyFrame ⇒ keyFrameSmall ⇒ the
 	* lastFrame copy source`), so its absence is now on this line whatever the
 	* tile ended up being.
@@ -23154,7 +23164,7 @@ var MotionEventSchema = z.object({
 	/**
 	* Ms offsets from `timestamp` (the episode's own first rising edge, so the
 	* first entry is always `0`) of every genuine off→on transition the
-	* episode saw — "ogni evento on si deve salvare" (D475). NOT one entry per
+	* episode saw — "ogni evento on si deve salvare" [every ON event must be saved] (D475). NOT one entry per
 	* push: a firmware source that keepalives at ~1 Hz for the whole burst
 	* (Reolink, Hikvision) produces exactly one edge; a source that reports an
 	* explicit `false` mid-episode and then resumes before the quiet window
@@ -30483,7 +30493,7 @@ var ClipPlaybackSchema = z.object({
 * **One authorised yes is one wake.** `next-natural` — take the clip the next
 * time the camera is awake for its own reasons — is deliberately not a member:
 * it was proposed, it is free on the battery, and the operator declined it on
-* 2026-09-20 (*"Quando un export viene richiesto si sveglia la camera."*,
+* 2026-09-20 (*"Quando un export viene richiesto si sveglia la camera."* [When an export is requested the camera wakes up],
 * D558 "Considered and not taken").
 */
 var ClipWakeSchema = z.enum(["authorised"]);
@@ -30728,7 +30738,7 @@ var videoclipsCapability = {
 	* **It is a SECTION of the Recording tab, at the end of it — not a tab of
 	* its own.** It shipped as a `clips` top-tab and the operator rejected the
 	* placement: *"utilizzerei la stessa tab recordings, lì abbiamo già tutto il
-	* necessario, una nuova sezione alla fine per le clips"*. The Recording tab
+	* necessario, una nuova sezione alla fine per le clips"* [I would use the same recordings tab, there we already have everything necessary, a new section at the end for the clips]. The Recording tab
 	* already holds the recorder's panel, the schedule bands and the unified
 	* retention policy; footage the camera itself holds is the same question,
 	* asked of a different store. `order: 100` puts it after all of them with
@@ -30789,7 +30799,7 @@ var videoclipsCapability = {
 			* It replaced `sources?: string[]`, a VIEW filter over source ids that
 			* assumed the answer was a fan-out over everything a camera has. The
 			* operator settled otherwise on 2026-09-20 — *"l'utilizzatore è uno
-			* solo"* — so the list is asked of one provider at a time and there is
+			* solo"* [there is only one user] — so the list is asked of one provider at a time and there is
 			* nothing to filter out of it.
 			*/
 			provider: z.string().min(1)
@@ -36456,7 +36466,7 @@ authKey: z.string().optional() }), z.object({
 */
 /**
 * How long after a camera's last rising edge `pipeline-analytics` closes the
-* motion EPISODE row it kept open for it (D475) — "il delay della cap", in
+* motion EPISODE row it kept open for it (D475) — "il delay della cap" [the cap's delay], in
 * the operator's words. One authority for the whole system: the writer of a
 * `Camera` device's slice (the orchestrator, D696) writes this SAME constant
 * in `autoClearAfterMs` while `detected: true` (never a camera's own clock —
@@ -40079,7 +40089,7 @@ var ReadGopBytesResultSchema = z.object({
 /**
 * A time WINDOW of one finalized segment, cut by byte range — the multi-GOP
 * twin of {@link ReadGopBytesResultSchema}'s single instant. Built for the
-* replay clip's `recording` source (`docs/design/plans/2026-08-26-replay-clip-su-pipeline.md`):
+* replay clip's `recording` source (`docs/design/plans/2026-08-26-clip-replay-on-pipeline.md`):
 * a replay needs several seconds of native pixels, not one frame.
 *
 * `ok.data` is standalone-demuxable, same as a GOP read. `ok.reachesRequestedEnd`
@@ -43031,7 +43041,7 @@ var systemCapability = {
 		*
 		* This is the surface the operator asked for on 2026-08-28 (*"possiamo
 		* armare questi errori intanto? Così al prossimo giro ricontrolliamo tutti
-		* questi punti"*). Before it, four live failure modes could only be counted
+		* questi punti"* [can we instrument these errors in the meantime? That way next round we recheck all these points]). Before it, four live failure modes could only be counted
 		* by grepping Loki and hand-correlating timestamps, which is exactly how a
 		* 22% thumbnail gap and a 3-hour media blackout were diagnosed — twice.
 		*
@@ -57853,7 +57863,7 @@ var PreviewTextField = z.string().max(200);
 * Whether the notification's preview is a STILL or a short animation.
 *
 * The operator's ask, verbatim: *"inviato come gif o video (come per le altre
-* rule)"* — the other rules already offer an animated preview, and a ten-hour
+* rule)"* [sent as a gif or video (as for the other rules)] — the other rules already offer an animated preview, and a ten-hour
 * night reads better as three seconds of motion than as one frame of it. Both
 * modes get the SAME treatment (blurred frame, large centred title); `'gif'`
 * simply applies it to a dozen frames sampled across the render and assembles