@camstack/addon-post-analysis 1.2.658 → 1.2.660

package/CHANGELOG.md

@@ -7,6 +7,18 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [1.2.660] - 2026-11-01
+
+### Changed
+
+- Rebuilt against updated dependencies.
+
+## [1.2.659] - 2026-11-01
+
+### Changed
+
+- Notification rules fire once per appliance start/finish (running-state flip), not on every status refresh
+
 ## [1.2.658] - 2026-11-01
 
 ### Changed

package/dist/{clip-model-registry-OHEqXA-p.mjs → clip-model-registry-D9BbIQ-h.mjs}

@@ -11832,7 +11832,7 @@ function sleep(ms) {
 	return new Promise((resolve) => setTimeout(resolve, Math.max(0, ms)));
 }
 //#endregion
-//#region ../types/dist/composition-BBzVf2xd.mjs
+//#region ../types/dist/composition-BiKWlUCc.mjs
 /**
 * Deterministic SHA-256 hash of an arbitrary serialisable value. The
 * canonical form sorts object keys alphabetically at every depth so two
@@ -12925,7 +12925,15 @@ var HelperSpecSchema = discriminatedUnion("kind", [
 		thresholdWatts: number().positive(),
 		startDwellMs: number().int().nonnegative(),
 		stopDwellMs: number().int().nonnegative(),
-		member: HelperMemberSchema
+		member: HelperMemberSchema,
+		/**
+		* The plug that powers the appliance (`switch.on`). Optional: when set, the
+		* composition carries a `power-source` feature, so the hub can cut and restore
+		* that plug (power-source link of a NEW-target composition).
+		*/
+		powerSwitch: HelperMemberSchema.optional(),
+		/** How long a forced restart keeps the plug off; the cap's default when unset. */
+		offSeconds: number().optional()
 	}),
 	object({
 		kind: literal("statistic"),
@@ -47717,6 +47725,117 @@ function actuator(input) {
 	};
 }
 new Map(GROUP_TEMPLATES.map((template) => [template.id, template]));
+var PowerSourceRefusalReasonSchema = _enum([
+	"no-power-source",
+	"switch-missing",
+	"switch-offline",
+	"switch-unknown",
+	"restart-in-progress",
+	"switch-call-failed"
+]);
+var PowerSourceActionResultSchema = discriminatedUnion("accepted", [object({ accepted: literal(true) }), object({
+	accepted: literal(false),
+	reason: PowerSourceRefusalReasonSchema,
+	/** One line for the operator, naming the switch. */
+	message: string()
+})]);
+var PowerSourceInfoSchema = object({
+	/** False when the device has no power source linked; the rest is then empty. */
+	linked: boolean(),
+	switchDeviceId: number().nullable(),
+	switchName: string().nullable(),
+	/** The switch's on/off state, or null when it is unknown. Never false for unknown (D393). */
+	switchOn: boolean().nullable(),
+	switchOnline: boolean().nullable(),
+	restartInProgress: boolean(),
+	offSeconds: number().int()
+});
+/** The composed slice: the switch state the link mirrors, plus the stored off time. */
+var PowerSourceStateSchema = object({
+	/** Null while the switch has not reported: unknown is never `false` (D393). */
+	switchOn: boolean().nullable(),
+	offSeconds: number().int(),
+	lastFetchedAt: number()
+});
+var POWER_SOURCE_DEVICE_TYPES = [
+	DeviceType.Gateway,
+	DeviceType.Hub,
+	DeviceType.Camera,
+	DeviceType.Sensor,
+	DeviceType.MediaPlayer,
+	DeviceType.Vacuum,
+	DeviceType.Generic,
+	DeviceType.Washer,
+	DeviceType.Dryer,
+	DeviceType.Dishwasher,
+	DeviceType.PetFountain,
+	DeviceType.Fan,
+	DeviceType.Humidifier,
+	DeviceType.Climate,
+	DeviceType.WaterHeater
+];
+var powerSourceCustomize = {
+	version: 1,
+	targets: [{
+		id: "switch",
+		cardinality: "scalar",
+		vocabulary: {
+			cap: "power-source",
+			stateField: "switchOn"
+		},
+		deviceTypes: POWER_SOURCE_DEVICE_TYPES,
+		apply: "add",
+		path: "switchOn",
+		sources: [{
+			kind: "switch",
+			transforms: [{ kind: "identity" }]
+		}],
+		companions: [{
+			kind: "constant",
+			path: "offSeconds",
+			value: 10,
+			when: "add"
+		}, {
+			kind: "clock",
+			path: "lastFetchedAt",
+			when: "always"
+		}],
+		sourceReport: { status: "assignment-status" }
+	}]
+};
+var deviceInput$1 = object({ deviceId: number().int().nonnegative() });
+var powerSourceCapability = {
+	name: "power-source",
+	scope: "device",
+	mode: "singleton",
+	deviceTypes: POWER_SOURCE_DEVICE_TYPES,
+	methods: {
+		getStatus: systemMethod(deviceInput$1, PowerSourceInfoSchema, { auth: "admin" }),
+		powerOn: systemMethod(deviceInput$1, PowerSourceActionResultSchema, {
+			kind: "mutation",
+			auth: "admin"
+		}),
+		powerOff: systemMethod(deviceInput$1, PowerSourceActionResultSchema, {
+			kind: "mutation",
+			auth: "admin"
+		}),
+		forceRestart: systemMethod(deviceInput$1, PowerSourceActionResultSchema, {
+			kind: "mutation",
+			auth: "admin"
+		})
+	},
+	runtimeState: PowerSourceStateSchema,
+	customize: powerSourceCustomize,
+	/**
+	* Runtime-state durability: **session** — mirrored from the linked switch on
+	* its next report; a restored value would outlive the reading it names.
+	*
+	* See `RuntimeStateDurability`. Enforced by
+	* `scripts/check-runtime-state-durability.ts`.
+	*/
+	durability: "session",
+	history: "none"
+};
 DeviceFeature.LightColorRgb, DeviceFeature.LightColorHsv, DeviceFeature.LightColorMired;
 DeviceType.Camera;
 `${COMPOSED_DEVICE_STABLE_ID_PREFIX}`;
@@ -53755,7 +53874,8 @@ var PALETTE_ENTRY_IDS = [
 	"switch",
 	"siren",
 	"button",
-	"doorbell"
+	"doorbell",
+	"appliance-cycle"
 ];
 var AUDIO_ENTRY_ID = "audio";
 /** Six rungs, quiet → loud. The opaque end is the entry's hex. */
@@ -53826,7 +53946,8 @@ var CAMSTACK_HEX = {
 	switch: "#7a812a",
 	siren: "#ac5d7f",
 	button: "#b276cd",
-	doorbell: "#0087ab"
+	doorbell: "#0087ab",
+	"appliance-cycle": "#2a8c8c"
 };
 var CAMSTACK_FALLBACK = [
 	"#b34dc7",
@@ -53891,7 +54012,8 @@ var HIGH_CONTRAST_HEX = {
 	switch: "#d05259",
 	siren: "#cd67b3",
 	button: "#c9746a",
-	doorbell: "#338eeb"
+	doorbell: "#338eeb",
+	"appliance-cycle": "#00848a"
 };
 var HIGH_CONTRAST_FALLBACK = [
 	"#817f3b",
@@ -53956,7 +54078,8 @@ var OKABE_ITO_HEX = {
 	switch: "#ad2c4e",
 	siren: "#348e08",
 	button: "#d27303",
-	doorbell: "#55770f"
+	doorbell: "#55770f",
+	"appliance-cycle": "#00737d"
 };
 var OKABE_ITO_FALLBACK = [
 	"#9a3784",
@@ -54166,6 +54289,7 @@ sub("switch", "control", "control", "switch", "Switch");
 sub("siren", "control", "control", "siren", "Siren");
 sub("button", "control", "control", "button", "Button");
 sub("doorbell", "control", "control", "doorbell", "Doorbell");
+sub("appliance-cycle", "control", "control", "switch", "Appliance cycle");
 for (const l of AUDIO_MACRO_LABELS) {
 	const kind = `audio-${l.id}`;
 	if (entries.has(kind)) continue;
@@ -56528,17 +56652,17 @@ var NC_CONDITION_CATALOG = [
 		options: [
 			{
 				value: "",
-				label: "It triggers and when it clears",
-				hint: "Every change: water detected, and back to dry."
+				label: "When it starts and when it finishes",
+				hint: "Every change: the alert itself, and the return to normal."
 			},
 			{
 				value: "raised",
-				label: "Only when it triggers",
+				label: "Only when it starts",
 				hint: "Water detected, smoke, a contact opening — never the return to normal."
 			},
 			{
 				value: "cleared",
-				label: "Only when it clears",
+				label: "Only when it finishes",
 				hint: "Back to dry, smoke gone, a contact closing — never the alert itself."
 			}
 		],
@@ -64596,7 +64720,8 @@ var CAP_TO_KIND = {
 	cover: "cover",
 	switch: "switch",
 	button: "button",
-	doorbell: "doorbell"
+	doorbell: "doorbell",
+	"running-state": "appliance-cycle"
 };
 function buildDescriptor(capName, kind) {
 	const t = EVENT_TAXONOMY[kind];
@@ -69052,19 +69177,19 @@ var RemoteSetConfigResultSchema = discriminatedUnion("status", [object({ status:
 	reason: _enum(["unknown-template", "not-a-media-player"]),
 	detail: string()
 })]);
-var deviceInput$1 = object({ deviceId: number().int().nonnegative() });
+var deviceInput = object({ deviceId: number().int().nonnegative() });
 DeviceType.MediaPlayer;
-method(deviceInput$1, RemoteConfigSchema, { auth: "admin" }), method(deviceInput$1.extend({ config: RemoteConfigSchema }), RemoteSetConfigResultSchema, {
+method(deviceInput, RemoteConfigSchema, { auth: "admin" }), method(deviceInput.extend({ config: RemoteConfigSchema }), RemoteSetConfigResultSchema, {
 	kind: "mutation",
 	auth: "admin"
-}), method(deviceInput$1, RemoteCommandListSchema, { auth: "protected" }), method(deviceInput$1.extend({
+}), method(deviceInput, RemoteCommandListSchema, { auth: "protected" }), method(deviceInput.extend({
 	role: RemoteRoleSchema,
 	/** Sends in a row (volume steps). */
 	repeat: number().int().min(1).max(50).default(1)
 }), RemoteSendResultSchema, {
 	kind: "mutation",
 	auth: "protected"
-}), method(deviceInput$1.extend({
+}), method(deviceInput.extend({
 	command: RemoteMediaCommandSchema,
 	muted: boolean().optional(),
 	source: string().optional(),
@@ -73509,117 +73634,6 @@ var lockControlCapability = {
 	*  whether persisting is worth a SQLite commit. */
 	volatileStateFields: ["lastChangedAt"]
 };
-var PowerSourceRefusalReasonSchema = _enum([
-	"no-power-source",
-	"switch-missing",
-	"switch-offline",
-	"switch-unknown",
-	"restart-in-progress",
-	"switch-call-failed"
-]);
-var PowerSourceActionResultSchema = discriminatedUnion("accepted", [object({ accepted: literal(true) }), object({
-	accepted: literal(false),
-	reason: PowerSourceRefusalReasonSchema,
-	/** One line for the operator, naming the switch. */
-	message: string()
-})]);
-var PowerSourceInfoSchema = object({
-	/** False when the device has no power source linked; the rest is then empty. */
-	linked: boolean(),
-	switchDeviceId: number().nullable(),
-	switchName: string().nullable(),
-	/** The switch's on/off state, or null when it is unknown. Never false for unknown (D393). */
-	switchOn: boolean().nullable(),
-	switchOnline: boolean().nullable(),
-	restartInProgress: boolean(),
-	offSeconds: number().int()
-});
-/** The composed slice: the switch state the link mirrors, plus the stored off time. */
-var PowerSourceStateSchema = object({
-	/** Null while the switch has not reported: unknown is never `false` (D393). */
-	switchOn: boolean().nullable(),
-	offSeconds: number().int(),
-	lastFetchedAt: number()
-});
-var POWER_SOURCE_DEVICE_TYPES = [
-	DeviceType.Gateway,
-	DeviceType.Hub,
-	DeviceType.Camera,
-	DeviceType.Sensor,
-	DeviceType.MediaPlayer,
-	DeviceType.Vacuum,
-	DeviceType.Generic,
-	DeviceType.Washer,
-	DeviceType.Dryer,
-	DeviceType.Dishwasher,
-	DeviceType.PetFountain,
-	DeviceType.Fan,
-	DeviceType.Humidifier,
-	DeviceType.Climate,
-	DeviceType.WaterHeater
-];
-var powerSourceCustomize = {
-	version: 1,
-	targets: [{
-		id: "switch",
-		cardinality: "scalar",
-		vocabulary: {
-			cap: "power-source",
-			stateField: "switchOn"
-		},
-		deviceTypes: POWER_SOURCE_DEVICE_TYPES,
-		apply: "add",
-		path: "switchOn",
-		sources: [{
-			kind: "switch",
-			transforms: [{ kind: "identity" }]
-		}],
-		companions: [{
-			kind: "constant",
-			path: "offSeconds",
-			value: 10,
-			when: "add"
-		}, {
-			kind: "clock",
-			path: "lastFetchedAt",
-			when: "always"
-		}],
-		sourceReport: { status: "assignment-status" }
-	}]
-};
-var deviceInput = object({ deviceId: number().int().nonnegative() });
-var powerSourceCapability = {
-	name: "power-source",
-	scope: "device",
-	mode: "singleton",
-	deviceTypes: POWER_SOURCE_DEVICE_TYPES,
-	methods: {
-		getStatus: systemMethod(deviceInput, PowerSourceInfoSchema, { auth: "admin" }),
-		powerOn: systemMethod(deviceInput, PowerSourceActionResultSchema, {
-			kind: "mutation",
-			auth: "admin"
-		}),
-		powerOff: systemMethod(deviceInput, PowerSourceActionResultSchema, {
-			kind: "mutation",
-			auth: "admin"
-		}),
-		forceRestart: systemMethod(deviceInput, PowerSourceActionResultSchema, {
-			kind: "mutation",
-			auth: "admin"
-		})
-	},
-	runtimeState: PowerSourceStateSchema,
-	customize: powerSourceCustomize,
-	/**
-	* Runtime-state durability: **session** — mirrored from the linked switch on
-	* its next report; a restored value would outlive the reading it names.
-	*
-	* See `RuntimeStateDurability`. Enforced by
-	* `scripts/check-runtime-state-durability.ts`.
-	*/
-	durability: "session",
-	history: "none"
-};
 /**
 * A monotonic total between resets (D944). Energy uses `power-meter.energy`
 * so dashboards keep one series; every other instantaneous reading lands here.
@@ -77221,6 +77235,10 @@ var RUNNING_DEVICE_TYPES = Object.values(DeviceType);
 /** Generic Customize target for the running boolean (D936). */
 var runningCustomize = {
 	version: 1,
+	overridable: [{
+		path: "running",
+		by: "running"
+	}],
 	targets: [{
 		id: "running",
 		cardinality: "scalar",
@@ -77278,7 +77296,7 @@ var runningCustomize = {
 				kind: "constant",
 				path: "phase",
 				value: null,
-				when: "always"
+				when: "add"
 			},
 			{
 				kind: "clock",
@@ -97392,7 +97410,8 @@ function isSystemDelivery(delivery) {
 *    picker authors.
 *
 * Callers resolve the ids via `deviceManager.listDeviceIdsByCaps` (max 16
-* names — `EVENTFUL_CAP_NAMES` is exactly 16) and must treat an unanswered
+* names per call — `EVENTFUL_CAP_NAMES` is longer than that, so ask through
+* {@link ruleDeviceCompatCapQueries}, which chunks it) and must treat an unanswered
 * read as "unknown", never as "no devices" (D315): this function only names
 * WHICH caps to ask for, not what to show while the answer is pending.
 */
@@ -97414,6 +97433,12 @@ function ruleDeviceCompatCapNames(kind) {
 * Named once, because a sensor rule's compatible set needs it (below).
 */
 var NC_CAMERA_SCOPE_CAP_NAME = "camera-streams";
+var MAX_CAPS_PER_QUERY = 16;
+function chunk(items, size) {
+	const out = [];
+	for (let i = 0; i < items.length; i += size) out.push(items.slice(i, i + size));
+	return out;
+}
 /**
 * Every capability QUERY whose union is the set of devices a rule of this kind
 * may be SCOPED to (`conditions.devices`) — what the save-time guard and the
@@ -97421,7 +97446,7 @@ var NC_CAMERA_SCOPE_CAP_NAME = "camera-streams";
 * entry. `null` exactly where {@link ruleDeviceCompatCapNames} is `null`.
 *
 * Several queries rather than one list because `listDeviceIdsByCaps` takes at
-* most 16 names and `EVENTFUL_CAP_NAMES` is already exactly 16.
+* most 16 names and `EVENTFUL_CAP_NAMES` is longer than that (chunked here).
 *
 * A `sensor` rule's set is the eventful devices PLUS every camera (fix round
 * 1, 2026-10-01): the engine matches a sensor rule scoped to a CAMERA — a
@@ -97432,7 +97457,8 @@ var NC_CAMERA_SCOPE_CAP_NAME = "camera-streams";
 function ruleDeviceCompatCapQueries(kind) {
 	const primary = ruleDeviceCompatCapNames(kind);
 	if (primary === null) return null;
-	return kind === "sensor" ? [primary, [NC_CAMERA_SCOPE_CAP_NAME]] : [primary];
+	const chunks = chunk(primary, MAX_CAPS_PER_QUERY);
+	return kind === "sensor" ? [...chunks, [NC_CAMERA_SCOPE_CAP_NAME]] : chunks;
 }
 /**
 * Which kind of rule is this?
@@ -98336,8 +98362,17 @@ function syncActiveAlarmProfileSettings(state, settings) {
 *
 * Pure, RN-safe: the viewer imports the support rule from here.
 */
+/**
+* Control caps that still have a raise and a clear an operator names: an
+* appliance cycle raises when it STARTS and clears when it FINISHES. Kept out
+* of `SOURCE_CAP_ACTIVE_FIELD` on purpose — that table also makes a device a
+* camera-sensor / recorder-trigger source, and a dishwasher is neither.
+*/
+var CYCLE_RAISED_FIELD_BY_CAP = { "running-state": "running" };
 /** Event kind → the boolean field of its cap slice that means "raised". */
 var NC_SENSOR_RAISED_FIELD_BY_KIND = Object.freeze(Object.fromEntries(Object.entries(EVENT_KIND_BY_CAP).flatMap(([capName, descriptor]) => {
+	const cycleField = CYCLE_RAISED_FIELD_BY_CAP[capName];
+	if (cycleField !== void 0) return [[descriptor.kind, cycleField]];
 	const field = SOURCE_CAP_ACTIVE_FIELD[capName];
 	if (field === void 0 || descriptor.category !== "sensor") return [];
 	return [[descriptor.kind, field]];
@@ -98358,6 +98393,98 @@ function sensorRaisedOf(kind, value) {
 	const raw = Object.entries(value).find(([key]) => key === field)?.[1];
 	return typeof raw === "boolean" ? raw : void 0;
 }
+Object.freeze({
+	contact: {
+		starts: {
+			en: "opened",
+			it: "si apre"
+		},
+		finishes: {
+			en: "closed",
+			it: "si chiude"
+		}
+	},
+	"motion-sensor": {
+		starts: {
+			en: "motion detected",
+			it: "movimento rilevato"
+		},
+		finishes: {
+			en: "motion stopped",
+			it: "movimento terminato"
+		}
+	},
+	smoke: {
+		starts: {
+			en: "smoke detected",
+			it: "fumo rilevato"
+		},
+		finishes: {
+			en: "smoke gone",
+			it: "fumo scomparso"
+		}
+	},
+	flood: {
+		starts: {
+			en: "water detected",
+			it: "acqua rilevata"
+		},
+		finishes: {
+			en: "dry again",
+			it: "di nuovo asciutto"
+		}
+	},
+	gas: {
+		starts: {
+			en: "gas detected",
+			it: "gas rilevato"
+		},
+		finishes: {
+			en: "gas gone",
+			it: "gas scomparso"
+		}
+	},
+	"carbon-monoxide": {
+		starts: {
+			en: "carbon monoxide detected",
+			it: "monossido rilevato"
+		},
+		finishes: {
+			en: "carbon monoxide gone",
+			it: "monossido scomparso"
+		}
+	},
+	vibration: {
+		starts: {
+			en: "vibration detected",
+			it: "vibrazione rilevata"
+		},
+		finishes: {
+			en: "vibration stopped",
+			it: "vibrazione terminata"
+		}
+	},
+	tamper: {
+		starts: {
+			en: "tampered with",
+			it: "manomesso"
+		},
+		finishes: {
+			en: "tamper cleared",
+			it: "manomissione rientrata"
+		}
+	},
+	"appliance-cycle": {
+		starts: {
+			en: "the cycle started",
+			it: "il ciclo parte"
+		},
+		finishes: {
+			en: "the cycle finished",
+			it: "il ciclo è terminato"
+		}
+	}
+});
 /**
 * An alert EPISODE as a notification subject.
 *
@@ -100077,6 +100204,7 @@ var EVENT_KIND_LABEL_KEYS = [
 	"siren",
 	"button",
 	"doorbell",
+	"appliance-cycle",
 	"audio-speech",
 	"audio-scream",
 	"audio-crying",
@@ -100284,6 +100412,10 @@ var EVENT_KIND_LABELS = {
 		en: "Doorbell",
 		it: "Campanello"
 	},
+	"appliance-cycle": {
+		en: "Appliance cycle",
+		it: "Ciclo elettrodomestico"
+	},
 	"audio-speech": {
 		en: "Speech",
 		it: "Voce"