@camstack/addon-pipeline 1.2.315 → 1.2.316

package/dist/recorder/index.js

@@ -3,8 +3,8 @@ Object.defineProperties(exports, {
 	[Symbol.toStringTag]: { value: "Module" }
 });
 const require_chunk = require("../chunk-emK7D4bc.js");
-const require_dist = require("../dist-sCjZdzKn.js");
-const require_node = require("../node-D4xdwpPU.js");
+const require_dist = require("../dist-BB9ZzZuv.js");
+const require_node = require("../node-bfUE4LH0.js");
 const require_hub_hostname = require("../hub-hostname-DAJXlOgV.js");
 const require_restream_intent = require("../restream-intent-7uDNqMKs.js");
 const require_retire_root_keys = require("../retire-root-keys-Csb8z2f3.js");
@@ -19,32 +19,32 @@ let node_v8 = require("node:v8");
 node_v8 = require_chunk.__toESM(node_v8);
 //#region src/recorder/event-capture.ts
 /**
-* La sottoscrizione motion del recorder: bus → `onTrigger(deviceId, atMs)`.
+* The recorder's motion subscription: bus → `onTrigger(deviceId, atMs)`.
 *
-* ## Cosa NON c'è più qui (2026-08-29)
+* ## What is NOT here any more (2026-08-29)
 *
-* Fino al 2026-08-29 questo file costruiva anche un `EventMarker` per evento e
-* lo spingeva in un `EventMap` per-device — annotazioni di playback in RAM, con
-* dentro il payload `regions` grezzo del provider. `EventMap.events()` e
-* `EventMap.prune()` non avevano **nessun chiamante in tutto il repo**: la
-* mappa veniva solo scritta, e cresceva con l'uptime del runner.
+* Until 2026-08-29 this file also built an `EventMarker` per event and
+* pushed it into a per-device `EventMap` — playback annotations in RAM, with
+* the provider's raw `regions` payload inside. `EventMap.events()` and
+* `EventMap.prune()` had **no caller in the whole repo**: the
+* map was only written, and grew with the runner's uptime.
 *
-* È stata cancellata, non cablata, e la ragione è nel suo stesso header: la
-* timeline che l'operatore vede viene dalle righe durabili di
-* `pipelineAnalytics` (`getMotionEvents`/`getObjectEvents`/`getAudioEvents`), i
-* marker non erano esposti su nessuna cap (`recording.getPlaybackManifest`
-* restituisce solo URL di playlist) e ADR-0194 aveva già rifiutato
-* esplicitamente di costruirci sopra il reconcile dei trigger, perché una
-* struttura in RAM non sopravvive né alla perdita dell'evento né al respawn del
-* runner. Un lettore non è mai esistito e non ne era previsto uno: tenerla
-* sarebbe stato "un residuo che descrive il design giusto", cioè una verifica
-* che non verifica niente.
+* It was deleted, not wired, and the reason is in its own header: the
+* timeline the operator sees comes from the durable rows of
+* `pipelineAnalytics` (`getMotionEvents`/`getObjectEvents`/`getAudioEvents`), the
+* markers were not exposed on any cap (`recording.getPlaybackManifest`
+* returns only playlist URLs) and ADR-0194 had already explicitly refused
+* to build the trigger reconcile on top of it, because an
+* in-RAM structure survives neither the loss of the event nor the respawn of the
+* runner. A reader never existed and none was planned: keeping it
+* would have been "a leftover that describes the right design", i.e. a check
+* that checks nothing.
 *
-* Quello che resta è l'unica cosa che qualcuno leggeva davvero: il fronte di
-* salita della motion che apre una finestra della banda `events` (B3).
+* What remains is the only thing anyone really read: the rising edge of
+* the motion that opens a window of the `events` band (B3).
 */
-/** Solo il fronte `detected: true` è un trigger. Il fronte di discesa non apre
-*  niente — la finestra la chiude il post-buffer, non l'evento. */
+/** Only the `detected: true` edge is a trigger. The falling edge opens
+*  nothing — the window is closed by the post-buffer, not by the event. */
 function isMotionTrigger(data) {
 	return data.detected;
 }
@@ -542,40 +542,40 @@ var MfraTableStore = class {
 //#endregion
 //#region src/recorder/object-trigger.ts
 /**
-* Il gate fra `pipeline-analytics.detection-event` e "apri una finestra di
-* registrazione".
-*
-* Fratello di `recorder/event-capture.ts` e per lo stesso motivo: la qualifica
-* ha dei rami, e un ramo che scarta lavoro senza dirlo è indistinguibile da una
-* funzione mai cablata. Ogni verdetto negativo NOMINA il motivo, e il chiamante
-* lo logga.
-*
-* Puro: nessun bus, nessun orologio, nessuna config. La scelta di QUALI classi
-* ascoltare è della banda (`bandTriggerSources`); qui si decide solo se
-* l'evento è una detection utilizzabile e di che macro classe è.
-*
-* ## Perché la forma è DISCRIMINATA su `kind` (2026-08-29)
-*
-* Fino al 2026-08-29 questo file dichiarava UNA sola forma piatta — quella
-* dell'evento `object` — e la pretendeva da OGNI payload del topic. Ma
-* `EventCategory.PipelineAnalyticsDetectionEvent` è un topic condiviso da tre
-* emettitori in `addon-post-analysis/src/pipeline-analytics/index.ts`: object
-* (`className`, `source`, `confidence`, `zones`), motion e audio — e motion e
-* audio non portano `className`, perché non ne hanno una. Il risultato misurato:
-* `malformed` su **394 righe campionate su 394**, a 3.3–3.9 eventi/s, per
-* settimane. `malformed` significa "l'emettitore è andato in deriva" ed era
-* invece il traffico normale del topic; l'unico secchio che poteva segnalare
-* una vera rottura di protocollo era saturo al 100% di eventi sani, quindi
-* inservibile — ed è stato letto come "il trigger object non ha mai funzionato".
-*
-* Quindi: si valida prima la BUSTA comune (`deviceId`, `kind`, `timestamp`),
-* poi si discrimina su `kind`, e solo il ramo `object` pretende i campi
-* dell'object. Un `object` senza `className` resta un difetto e ha il suo nome
-* (`malformed-object`), distinto da una busta illeggibile.
-*/
-/** Il `kind` dell'unico ramo del topic che può aprire una finestra. */
+* The gate between `pipeline-analytics.detection-event` and "open a
+* recording window".
+*
+* Sibling of `recorder/event-capture.ts` and for the same reason: the qualification
+* has branches, and a branch that discards work without saying so is indistinguishable from a
+* function that was never wired. Every negative verdict NAMES the reason, and the caller
+* logs it.
+*
+* Pure: no bus, no clock, no config. The choice of WHICH classes to
+* listen to belongs to the band (`bandTriggerSources`); here we only decide whether
+* the event is a usable detection and which macro class it is.
+*
+* ## Why the shape is DISCRIMINATED on `kind` (2026-08-29)
+*
+* Until 2026-08-29 this file declared ONE flat shape — that
+* of the `object` event — and demanded it from EVERY payload of the topic. But
+* `EventCategory.PipelineAnalyticsDetectionEvent` is a topic shared by three
+* emitters in `addon-post-analysis/src/pipeline-analytics/index.ts`: object
+* (`className`, `source`, `confidence`, `zones`), motion and audio — and motion and
+* audio do not carry `className`, because they have none. The measured result:
+* `malformed` on **394 sampled rows out of 394**, at 3.3–3.9 events/s, for
+* weeks. `malformed` means "the emitter has drifted" and was
+* instead the normal traffic of the topic; the only bucket that could signal
+* a real protocol break was saturated at 100% with healthy events, hence
+* useless — and it was read as "the object trigger never worked".
+*
+* So: first the common ENVELOPE is validated (`deviceId`, `kind`, `timestamp`),
+* then we discriminate on `kind`, and only the `object` branch demands the fields
+* of the object. An `object` without `className` remains a defect and has its own name
+* (`malformed-object`), distinct from an unreadable envelope.
+*/
+/** The `kind` of the only branch of the topic that can open a window. */
 var OBJECT_EVENT_KIND = "object";
-/** Type guard, non cast: `event.data` è `unknown` finché non passa di qui. */
+/** Type guard, not cast: `event.data` is `unknown` until it passes through here. */
 function isDetectionEventEnvelope(value) {
 	if (typeof value !== "object" || value === null) return false;
 	if (!("deviceId" in value) || typeof value.deviceId !== "number") return false;
@@ -585,7 +585,7 @@ function isDetectionEventEnvelope(value) {
 	if (!Number.isFinite(value.timestamp) || value.timestamp <= 0) return false;
 	return true;
 }
-/** I campi che SOLO il ramo object porta. Chiamata dopo la busta. */
+/** The fields that ONLY the object branch carries. Called after the envelope. */
 function isObjectDetectionEventData(value) {
 	if (!("className" in value) || typeof value.className !== "string") return false;
 	if ("source" in value && value.source !== void 0 && typeof value.source !== "string") return false;
@@ -622,9 +622,9 @@ function qualifyObjectTrigger(data) {
 }
 //#endregion
 //#region src/recorder/object-trigger-health.ts
-/** Ampiezza della finestra di aggregazione. Un minuto: abbastanza corto perché
-*  la riga arrivi entro il primo minuto di un deploy rotto, abbastanza lungo
-*  perché a 4 eventi/s il campione sia significativo. */
+/** Width of the aggregation window. One minute: short enough for
+*  the line to arrive within the first minute of a broken deploy, long enough
+*  for the sample to be significant at 4 events/s. */
 var OBJECT_TRIGGER_HEALTH_WINDOW_MS = 6e4;
 function emptyTally$2() {
 	return {
@@ -660,10 +660,10 @@ var ObjectTriggerHealth = class {
 		this.minSample = minSample;
 	}
 	/**
-	* Registra un verdetto e, se la finestra si è chiusa con questo evento,
-	* restituisce i report da stampare (e riapre la finestra). Nessun timer:
-	* il feed viaggia a ~4/s, quindi la chiusura arriva sempre in tempo, e una
-	* finestra che non si chiude è una finestra in cui non è successo nulla.
+	* Records a verdict and, if the window closed with this event,
+	* returns the reports to print (and reopens the window). No timer:
+	* the feed runs at ~4/s, so the close always arrives in time, and a
+	* window that does not close is a window in which nothing happened.
 	*/
 	record(verdict, nowMs) {
 		const reports = this.windowStartMs !== null && nowMs - this.windowStartMs >= this.windowMs ? this.drain(nowMs) : [];
@@ -694,7 +694,7 @@ var ObjectTriggerHealth = class {
 		this.buckets.set(key, fresh);
 		return fresh;
 	}
-	/** Chiude la finestra e restituisce un report per secchio non vuoto. */
+	/** Closes the window and returns one report per non-empty bucket. */
 	drain(nowMs) {
 		const windowMs = this.windowStartMs === null ? 0 : nowMs - this.windowStartMs;
 		const out = [];
@@ -3227,29 +3227,29 @@ var macrotask$2 = () => new Promise((resolve) => {
 //#endregion
 //#region src/recorder/sensor-trigger.ts
 /**
-* Da `DeviceStateChanged` a "quali camere devono registrare".
-*
-* Due responsabilità, entrambe in RAM e nessuna durevole:
-*  - la MEMORIA del fronte, per `(deviceId, capName)`, che rende `false→true`
-*    distinguibile da una ri-emissione. Il predicato è `evaluateSensorEdge`
-*    (`@camstack/types`) — la stessa tabella `SOURCE_CAP_ACTIVE_FIELD` del
-*    campanello composto e del bridge camera-sensors, non una copia;
-*  - l'INDICE INVERSO sorgente→camere, uno stato rispecchiato aggiornato FUORI
-*    dal percorso dell'evento (D49): `setBindings` è chiamato al boot dalle
-*    config già lette e a ogni `onConfigChanged`, che è un'RPC. Una lettura
-*    fallibile sul percorso del trigger potrebbe rispondere "nessuno ascolta"
-*    e perdere l'episodio, che è il fallimento contro cui D49 è scritta.
-*
-* L'ordine dei controlli è deliberato: `DeviceStateChanged` viaggia a ritmo di
-* bus su tutta la flotta (batteria, la `motion` nativa di ogni camera, la
-* connettività). L'indice inverso è una `Map.get` senza allocazioni e va per
-* primo; il fronte — che legge due tabelle e la slice — viene dopo. È la stessa
-* scelta che post-analysis scrive per la sua sottoscrizione: *"the
+* From `DeviceStateChanged` to "which cameras must record".
+*
+* Two responsibilities, both in RAM and neither durable:
+*  - the edge MEMORY, per `(deviceId, capName)`, which makes `false→true`
+*    distinguishable from a re-emission. The predicate is `evaluateSensorEdge`
+*    (`@camstack/types`) — the same `SOURCE_CAP_ACTIVE_FIELD` table as the
+*    composite doorbell and the camera-sensors bridge, not a copy;
+*  - the INVERSE INDEX source→cameras, a mirrored state refreshed OFF
+*    the event path (D49): `setBindings` is called at boot from the
+*    already-read configs and on every `onConfigChanged`, which is an RPC. A
+*    fallible read on the trigger path could answer "nobody listens"
+*    and lose the episode, which is the failure D49 is written against.
+*
+* The order of the checks is deliberate: `DeviceStateChanged` travels at bus
+* rate across the whole fleet (battery, every camera's native `motion`,
+* connectivity). The inverse index is an allocation-free `Map.get` and goes
+* first; the edge — which reads two tables and the slice — comes after. It is the same
+* choice post-analysis makes for its subscription: *"the
 * EVENT_KIND_BY_CAP gate runs FIRST so non-sensor cap churn exits before any
 * async work"*.
 *
-* Puro rispetto al mondo: nessun bus, nessun logger, nessun orologio proprio.
-* Il chiamante logga il verdetto — un ramo che non accende nulla lo DICE.
+* Pure with respect to the world: no bus, no logger, no clock of its own.
+* The caller logs the verdict — a branch that lights nothing SAYS so.
 */
 /**
 * Type GUARD, not a cast: `event.data` is `unknown`, and a version-skewed
@@ -3298,7 +3298,7 @@ function buildSensorTriggerBindings(configs) {
 	return index;
 }
 var SensorTriggerRouter = class {
-	/** sourceDeviceId → camere la cui config lo nomina. */
+	/** sourceDeviceId → cameras whose config names it. */
 	bindings = /* @__PURE__ */ new Map();
 	/** Ultimo booleano osservato, per `${deviceId}:${capName}`. */
 	lastValues = /* @__PURE__ */ new Map();
@@ -3311,15 +3311,15 @@ var SensorTriggerRouter = class {
 		this.freshnessMs = options.firstSightingFreshnessMs ?? 3e4;
 	}
 	/**
-	* Sostituisce l'indice inverso. NON tocca `lastValues`: un sensore tolto e
-	* rimesso in una banda deve ritrovare il suo livello precedente, altrimenti
-	* la prima slice dopo il rientro sarebbe una "prima osservazione" e un
-	* contatto rimasto aperto tutto il tempo diventerebbe un fronte alto.
+	* Replaces the inverse index. Does NOT touch `lastValues`: a sensor removed and
+	* put back into a band must find its previous level again, otherwise
+	* the first slice after the return would be a "first observation" and a
+	* contact left open the whole time would become a rising edge.
 	*/
 	setBindings(bindings) {
 		this.bindings = bindings;
 	}
-	/** Quali sorgenti l'indice contiene ora — per la riga di log al boot. */
+	/** Which sources the index holds now — for the log line at boot. */
 	listenedSourceIds() {
 		return [...this.bindings.keys()];
 	}
@@ -14538,10 +14538,10 @@ function eventsBandCanEverDemand(band) {
 	return bandTriggerSources(band).length > 0 && resolveBandBufferMs(band).postMs > 0;
 }
 /**
-* La chiave sotto cui una sorgente conserva le sue finestre. È anche la stringa
-* che compare nei log — quattro sorgenti che aprono la stessa finestra senza
-* dire chi è stato rendono impossibile rispondere a "perché questa camera
-* registra tanto" — quindi è leggibile per progetto.
+* The key under which a source keeps its windows. It is also the string
+* that appears in the logs — four sources opening the same window without
+* saying who did it make it impossible to answer "why does this camera
+* record so much" — so it is readable by design.
 */
 function triggerKey(source) {
 	switch (source.kind) {
@@ -14556,18 +14556,18 @@ function triggerKey(source) {
 *  band never allocates a new one per call. */
 var SIGNAL_SOURCES = Object.freeze([{ kind: "signal" }]);
 /**
-* LE sorgenti che questa banda ascolta — l'unico posto dove i `triggers` di
-* una banda diventano `TriggerSource[]`.
+* THE sources this band listens to — the only place where a band's `triggers`
+* become `TriggerSource[]`.
 *
-* Prima erano CINQUE copie dello stesso if-ladder motion/audio
+* Before there were FIVE copies of the same motion/audio if-ladder
 * (`eventsBandCanEverDemand`, `eventsBandDemanded`, `segmentRetainedForEvents`,
-* `segmentMissedByMs`, `eventsWindowCloseMs`), che con quattro sorgenti
-* sarebbero diventate cinque scale a quattro rami. `RecordingController`
-* (`reportUnrecordable`, la riconciliazione durevole) legge la stessa lista.
+* `segmentMissedByMs`, `eventsWindowCloseMs`), which with four sources
+* would have become five four-branch ladders. `RecordingController`
+* (`reportUnrecordable`, the durable reconciliation) reads the same list.
 *
-* Una chiave in {@link UNFED_TRIGGER_KEYS} non produce sorgenti: la banda che
-* ascolta solo quella "non può mai chiedere", ed è così che il recorder la
-* denuncia invece di restare zitto.
+* A key in {@link UNFED_TRIGGER_KEYS} produces no sources: the band that
+* listens only to it "can never demand", and that is how the recorder
+* reports it instead of staying silent.
 */
 function bandTriggerSources(band) {
 	if (band.deviceSignal === true) return SIGNAL_SOURCES;
@@ -21145,15 +21145,15 @@ var RecorderV2Addon = class extends require_dist.BaseAddon {
 	eventUnsub = null;
 	/**
 	* Unsubscribe handle for the `PipelineAudioInferenceResult` audio-level
-	* subscription — the feed `audioThresholdDbfs` was missing (D62, Traccia 0
-	* of `docs/design/plans/2026-08-26-trigger-detection-e-sensori.md`). Kept
+	* subscription — the feed `audioThresholdDbfs` was missing (D62, Track 0
+	* of `docs/design/plans/2026-08-26-detection-triggers-and-sensors.md`). Kept
 	* separate from `eventUnsub` (a distinct bus category) but guarded and torn
 	* down the same way, idempotent re-entry included.
 	*/
 	audioTriggerUnsub = null;
 	/**
 	* Unsubscribe handle for the `PipelineAnalyticsDetectionEvent` subscription —
-	* the feed behind `RecordingTriggers.objectClasses` (Traccia A of the same
+	* the feed behind `RecordingTriggers.objectClasses` (Track A of the same
 	* plan). Same guard/teardown discipline as the two above.
 	*/
 	detectionTriggerUnsub = null;
@@ -21167,7 +21167,7 @@ var RecorderV2Addon = class extends require_dist.BaseAddon {
 	detectionTriggerHealth = new ObjectTriggerHealth();
 	/**
 	* Unsubscribe handle for the `DeviceStateChanged` subscription — the feed
-	* behind `RecordingTriggers.sensorDeviceIds` (Traccia B).
+	* behind `RecordingTriggers.sensorDeviceIds` (Track B).
 	*/
 	sensorTriggerUnsub = null;
 	/**