Alan-Jowett / sonde / 26616743597

82%

Build Type

push

github

Committed by web-flow

Commit Message

feat(gateway): periodic ACTUAL_STATE heartbeat (GW-2003 AC-8) (#1094)

* feat(gateway): periodic ACTUAL_STATE heartbeat (GW-2003 AC-8)

Add a 900-second periodic heartbeat to the gateway ACTUAL_STATE
re-emission task. This closes a reconciliation gap where gateway
desired state written by the SPA (e.g. \otation_payload\, salt,
recovered PSKs) could sit undelivered in Azure Tables indefinitely
because nothing triggered the gateway to emit ACTUAL_STATE and the
handler only runs reactively.

The heartbeat uses \	okio::time::interval_at\ (no immediate first
tick) with \MissedTickBehavior::Delay\, runs independently of
event-driven emissions, and cancels any active missing-hint debounce
when it fires.

Specification changes:
- GW-2003 AC-8: periodic heartbeat requirement
- Design §23.14: trigger source #4 (\heartbeat_interval\)
- Validation T-2014: periodic heartbeat test case
- Traceability: GW-2003 → T-2014

Closes the gap identified in the master key rotation flow where the
SPA → Azure Table → handler → gateway DESIRED_STATE path had no
periodic trigger.

Related: #1092 (gateway convergence UI)

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Signed-off-by: Alan Jowett <alan.jowett@microsoft.com>

* fix(gateway): reorder heartbeat arm before debounce in biased select

Move the heartbeat.tick() arm above the debounce-sleep arm in the
biased 	okio::select! so that when both futures are simultaneously
ready, the heartbeat fires first and cancels the pending debounce
(matching the design spec intent). This avoids a theoretical
duplicate emission in the astronomically rare simultaneous-ready case.

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

---------

Signed-off-by: Alan Jowett <alan.jowett@microsoft.com>
Co-authored-by: Alan Jowett <alan.jowett@microsoft.com>
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

Coverage Stats

0 of 15 new or added lines in 1 file covered. (0.0%)

1 existing line in 1 file now uncovered.

37920 of 46157 relevant lines covered (82.15%)

251.13 hits per line