Repository navigation
v0.3.3 - Position freshness
Added
position_freshattribute on the "outside usual area" sensor and the
device tracker, next toposition_age_seconds.truewhen the member's
position was recently confirmed,falsewhen PositionGuard is reporting
their last known place. If the API doesn't send the field, the attribute is
left out rather than set tofalse.
Changed
-
A member who goes quiet inside a saved area now stays
at_area. This is a
change in PositionGuard itself, live since September 19, and it shows up here
without any change to the integration: a phone that stops reporting while
inside a saved area used to go stale after about 50 minutes, which made the
"outside usual area" sensorunavailable. PositionGuard now keeps reporting
at_areafor up to 24 hours, and drops it on the first report from outside
the area. The sensor stays available andoffthrough that period.This changes behavior for existing automations. A sensor that used to go
unavailablewhen someone's phone went quiet at home will now stayoff.
If an automation should only act on a recently confirmed position, add a
condition onposition_freshbeingtrue, or onposition_age_seconds.Availability itself still follows the stale status only. A member who goes
quiet while away from every saved area still becomesunavailable, as in
0.3.2.
Fixed
- README: a stale "outside usual area" sensor was described as
off. It has
beenunavailablesince 0.3.2. To automate on staleness, read
safety_statuson the device tracker, which stays available and reads
stale. - Tests now pin both rules: a held
at_areamember stays available, and the
device tracker stays available withsafety_status: stale.
Requires
PositionGuard API, September 2026 or later, for position_fresh. Against an
older API the attribute is simply absent and everything else behaves as in
0.3.2.