# Changelog

All notable changes to this package are documented in this file.

The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).

## [Unreleased]

## [1.2.709] - 2026-11-15

### Changed

- Rebuilt against updated dependencies.

## [1.2.708] - 2026-11-15

### Changed

- A plate whose sharper read missed its live crop keeps the earlier crop, and a plate saved with no crop now records why; saved vehicle and person samples list a mediaId or a key frame with its box so every sample can be drawn, and a sample can be moved to another vehicle or person

## [1.2.707] - 2026-11-15

### Changed

- A sensor, button or lock notification is titled with the device and its state, and a camera going offline or coming back is titled with its name.

## [1.2.706] - 2026-11-14

### Changed

- A grouped burst of one kind is titled with what happened — devices back online, low batteries, consumables to replace, critical alerts — instead of the section or the rule name.

## [1.2.705] - 2026-11-14

### Fixed

- A grouped burst of alerts is titled with its rule name instead of ": 2"

## [1.2.704] - 2026-11-14

### Added

- Notification Center can now author rules on a storage drain's progress and completion events (#538).

## [1.2.703] - 2026-11-13

### Changed

- Detection notifications are titled with the subject and the place, not the rule name.
- Grouped device, node and update notifications are titled with the count, not the rule name.
- Notification copy names the event: a timelapse window, a low consumable, a disarm, a device command and a finished appliance cycle.
- An update restart and its return send no push, and history keeps the title and body that were sent.
- A node that does not come back within 10 minutes of an update restart is notified once.

## [1.2.702] - 2026-11-13

### Changed

- Notifications name an Energy system device by its type

## [1.2.701] - 2026-11-13

### Changed

- A post-analysis restart no longer sends a 'back online' push for devices whose offline was never notified (an offline younger than the 5-minute hold-off hydrates as a silent bounce).

## [1.2.700] - 2026-11-13

### Changed

- A notification rule saved with the retired thermostat device type matches climate devices again

## [1.2.699] - 2026-11-12

### Changed

- The snooze exemption for alarm rules reads the vocabulary action of an Action's command steps.
- Notifications about a device that hangs off another one name it with its parent, e.g. 'Battery (System)': battery, offline/online, commands, consumables, alarm sensors and the state summary
- A device's label in a notification is one parenthesis: 'Battery (System · Sensor)', never 'Battery (System) (Sensor)'.
- A detection, timelapse or digest notification names a child device with its parent too: 'Battery (System)'.
- A low-battery alert on a device that no longer has a battery (the Enpal storage battery) closes by itself, silently, after two refreshes agree.
- A child sensor's notification title names its parent too, and a device's own parenthesis is no longer mistaken for its parent.

## [1.2.698] - 2026-11-12

### Changed

- Notification rules can match a settled device command (device-command), with English and Italian texts.
- A notification about a device shows the device type beside its name.

## [1.2.697] - 2026-11-12

### Added

- System-event rules send one summary when several devices change within a few seconds.

## [1.2.696] - 2026-11-12

### Changed

- The stream-health intake comment now states that a battery connection error is emitted only after the broker has held it for the sustained window, for the whole camera.

## [1.2.695] - 2026-11-12

### Changed

- A large parked car stays parked when its box covers the centre of a smaller parked car.

### Fixed

- A large vehicle passing in front of a small parked car no longer marks that car as departed.

## [1.2.694] - 2026-11-12

### Changed

- Rebuilt against updated dependencies.

## [1.2.693] - 2026-11-10

### Changed

- A rule's per-target settings (priority, text, schedule, picture kind, buttons) now apply to every delivery the rule makes: event alerts, summaries, timelapses and calendar digests.

## [1.2.692] - 2026-11-10

### Changed

- A rule's targets each have their own settings: title and body, priority and an active schedule; a target outside its schedule is skipped and logged, and every target receives only the fields its notifier delivers.
- A title-only target (Alexa) whose rendered title is empty now speaks the rule's body, cut to the title limit, instead of nothing.

## [1.2.691] - 2026-11-10

### Changed

- A summary or timelapse notification no longer evaluates braces that sit inside a camera name or the AI sentence: only the text you wrote is rendered as a device template

## [1.2.690] - 2026-11-10

### Changed

- Notification rules and buttons run Actions from the Actions page; existing rule actions and sequences are converted to Actions on the first start
- A rule fire's Action that presses the alarm panel is attributed to that fire; an Action press with no fire is refused while the arm excludes sensors

## [1.2.689] - 2026-11-09

### Changed

- Notification rule titles and bodies may carry device value templates

## [1.2.688] - 2026-11-09

### Changed

- Internal: the instance form comments and specs follow the one instance door

## [1.2.687] - 2026-11-08

### Changed

- Alarm panel integration is seeded through the single instance create door

## [1.2.686] - 2026-11-08

### Changed

- The Notification Center integration now keeps an instance record under its registry id

## [1.2.685] - 2026-11-08

### Changed

- Comments and the addon template no longer name the retired addon-level settings hooks; they point at the scoped settings API.

## [1.2.684] - 2026-11-07

### Changed

- A sensor notification without a custom title is now titled with the sensor's name instead of the rule's, and a battery camera that answers awake with no or an old picture is woken once for the linked still

## [1.2.683] - 2026-11-07

### Changed

- System-event rules send per delivery mode (start, clear, schedule); existing rules keep their behaviour and a migration rewrites them

## [1.2.682] - 2026-11-07

### Changed

- The default Italian title of an appliance finished notification reads "<name> ha finito"

## [1.2.681] - 2026-11-07

### Changed

- Fleet-default analytics settings no longer offer the per-camera tracking-tape switch, so one click cannot arm continuous recording on every camera.

## [1.2.680] - 2026-11-07

### Fixed

- A Correct / Wrong tap on a detection notification now saves the frame you were shown as a retraining example, so the track appears on the Training page and in the viewer; taps already made are backfilled at the next boot

## [1.2.679] - 2026-11-07

### Changed

- Pipeline analytics retires its stale face-threshold keys through a one-time ledger migration.
- Face rescore interval and cluster model pin are read from the orchestrator's scoped cluster values (same keys, same refresh)

## [1.2.678] - 2026-11-07

### Changed

- The face matching form's derived suggestion floor is also served through the scoped settings overlay; the readout is unchanged.

## [1.2.677] - 2026-11-07

### Changed

- The notification centre reads its targets from the instances of notification-output
- Notification and retrain AI-profile reads go through the AI profile instances.

## [1.2.676] - 2026-11-06

### Changed

- Rebuilt against updated dependencies.

## [1.2.675] - 2026-11-06

### Changed

- Notification targets are instances of the notification function: Telegram, Home Assistant, Alexa and the rest keep their ids, switches and secrets, and rules naming them keep dispatching

## [1.2.674] - 2026-11-06

### Changed

- A supply that reports only a fill level now raises low at 10% or less and empty at 0
- Detection verdicts sent from notification buttons are shown again in the retrain view after the analytics runner restarts

## [1.2.673] - 2026-11-06

### Changed

- A node going offline for a planned update is now notified ("restarting for an update") instead of silenced, so its back-online always has its offline, even across a notification-center restart
- A finished appliance cycle whose run was aborted, used almost no energy or lasted under three minutes is no longer notified; the drop is logged.

## [1.2.672] - 2026-11-06

### Changed

- The crash-loop notification names the core block or addon and the real cause.

## [1.2.671] - 2026-11-06

### Changed

- Stored media can be counted per storage location (rows, bytes, unstamped, unknown location) for the support report

## [1.2.670] - 2026-11-05

### Changed

- Fixed: the face-recognition switch and the parked-object suppression switch shared one setting, so turning one on or off flipped the other; each now has its own setting, and your current choice is carried into both
- The analytics settings are now declared per capability (face recognition under face-gallery, the rest under pipeline-analytics); the form you see is unchanged

## [1.2.669] - 2026-11-05

### Changed

- Embedding encoder model setting is declared on the cluster hook; the form and stored value are unchanged.

## [1.2.668] - 2026-11-05

### Changed

- The finish notification's cycle facts match a run that ended up to 30 minutes before the announcement

## [1.2.667] - 2026-11-03

### Changed

- A package delivery with no stored key frame now writes its picture once, so a rule asking for an image no longer ships text-only.
- An appliance cycle that started before a restart now raises its finished notification: the transition gate seeds its last running state from history instead of dropping the first off.

### Fixed

- A sensor notification now wakes a sleeping battery camera even when its snapshot state could not be read, so the alarm keeps its picture; the read failure is now logged with its cause
- A sensor notification now re-polls a linked camera whose first frame is older than the event, instead of dropping it, for up to a few seconds

## [1.2.666] - 2026-11-02

### Changed

- An alarm triggered by a sensor now names the location and what changed: "Intrusione: Lavanderia — Serratura lavanderia aperta", one entry per device
- A sensor slice that passes the transition gate is now logged at debug with its device, state word and change time, so an unexplained alarm names its slice
- A lock whose first reading was a stale open word or had no change time no longer turns the real locked word into a transition after a provider restart
- Enum sensors no longer trigger notification rules on every refresh: only a changed value counts.

## [1.2.665] - 2026-11-02

### Changed

- A finished-cycle notification whose custom template drops the run summary is now logged once per rule; the cycle default text is served to editors
- A parcel the model sees inside a scene-difference zone now opens a candidate, a lower-confidence continuing box keeps it alive, and a day-to-IR switch no longer blinds the scene check
- A courier who never became a tracked person no longer blocks a parcel delivery: person-sized motion beside the drop-off zone backs the candidate

## [1.2.664] - 2026-11-02

### Changed

- A package notification's still is now taken from a live camera frame when the look frame's handle has expired, so parcel notifications on cameras like 615 carry their picture again.

## [1.2.663] - 2026-11-02

### Changed

- A sensor or alarm notification now wakes a sleeping battery camera once, waits up to 15 s for its still, and a rule can opt out

## [1.2.662] - 2026-11-01

### Changed

- An appliance that finishes its cycle now notifies by default as "<Device> ha terminato dopo N minuti", and the text can carry the energy used
- The appliance finish notification reads the recorded run, so duration and energy survive a restart.

## [1.2.661] - 2026-11-01

### Changed

- A capture request now expires exactly at its deadline instead of one millisecond after, so an abandoned confirmation crop no longer holds the head of the lane and sheds key frames.
- Notification templates: {{camera}} is now {{device}}. Your saved rules, timelapse captions and text overrides are rewritten once at the first start; {{camera}} keeps rendering in a template an older app still writes

## [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

- A still object whose notification was delivered is no longer discarded while its Correct/Wrong buttons are valid, so the verdict tap finds its track.

## [1.2.657] - 2026-11-01

### Changed

- Declares the minimum CamStack server it needs; the Addons page shows a held update as requires server >= X

## [1.2.656] - 2026-10-31

### Changed

- A lock reporting door-open counts as an opening for the alarm.

## [1.2.655] - 2026-10-31

### Changed

- A verdict tapped after the track is gone keeps the notified subject on the stored still; new "Wrong label, class OK" button on detection notifications
- Notification sequences accept a device-domain target and are rewritten to the target shape once at start
- Sun times moved to the shared time module (no behaviour change)

## [1.2.654] - 2026-10-30

### Changed

- A camera you switched off is no longer listed as offline in the state summary and no longer sends an offline notification
- A package-delivered notification now carries a picture of the parcel and its gif, even when the parcel was spotted without a track and the AI confirm took several seconds

## [1.2.653] - 2026-10-30

### Changed

- A node that announced an update is no longer reported offline for 10 minutes; if it comes back nothing is sent, otherwise the offline says it went down while updating

## [1.2.652] - 2026-10-29

### Changed

- Node update notifications for the desktop app and the container image keep their own slot, so they never swallow a server update on the same node

## [1.2.651] - 2026-10-29

### Changed

- The live detection overlay no longer shows boxes from replayed pre-roll frames

## [1.2.650] - 2026-10-28

### Changed

- A Correct/Wrong tap on a notification whose track has already been discarded now still saves a training frame from the recording, into the Notification verdicts collection.

## [1.2.649] - 2026-10-28

### Changed

- The Notification center now appears under System on the Integrations page
- A notification rule passes the delivery parameters its target's notifier declares (such as Echo mode and volume) along with the message.

## [1.2.648] - 2026-10-28

### Changed

- Battery alerts, state summaries and analytics history read device values by their quantity name after the field rename

## [1.2.647] - 2026-10-28

### Changed

- The parked-object appeared/departed event now names the zones the object is in

## [1.2.646] - 2026-10-28

### Changed

- Rebuilt against updated dependencies.

## [1.2.645] - 2026-10-28

### Fixed

- A track read now answers only for the camera it was asked under

## [1.2.644] - 2026-10-27

### Changed

- Rebuilt against updated dependencies.

## [1.2.643] - 2026-10-27

### Added

- Post-Analysis: Post-Analysis bundle — enrichment, embedding-encoder, pipeline-analytics. Multi-entry npm package shipping addons that consume pipeline output.
- Provides the addons Embedding Encoder, Pipeline Analytics.
