Alan-Jowett / sonde / 23503594350

82%

push

github

feat(gateway): add operational logging requirements and implementation (#463)

* feat(gateway): add operational logging requirements and implementation

Add GW-1300–GW-1302 requirements for structured operational logging,
corresponding design section (11A), and validation test cases
(T-1300–T-1303).

Engine lifecycle events logged at INFO level:
- PEER_REQUEST received/processed with
ode_id, key_hint, esult
- PEER_ACK sent with
ode_id
- WAKE received with
ode_id, seq, attery_mv
- COMMAND sent with
ode_id, command_type
- Session created/expired with
ode_id

Modem transport frame-level traces at DEBUG level:
- Frame received from modem with msg_type, peer_mac, len
- Frame sent to modem with msg_type, peer_mac, len

Fixes #459 (partial — gateway component)

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

* style: fix cargo fmt violations

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

* Address review findings for PR #463

- Rename \COMMAND sent\ log to \COMMAND selected\ (frame not yet sent)
- Rename \PEER_ACK sent\ log to \PEER_ACK frame encoded\ (transport send is later)
- Extract protocol \msg_type\ from frame header byte for modem debug logs
  instead of hardcoded \SEND_FRAME\/\RECV_FRAME\ strings
- Move send-path debug log after successful \send_encoded()\ call
- Add missing GW-1301 state transition logs: \modem serial connected\
  and \modem disconnecting\
- Update GW-1300 AC2/AC4, GW-1301 AC1 specs to match implementation
- Update design doc (11A.1, 11A.2, 11A.3) to match actual log messages
- Update T-1301 procedure to recommend deterministic clock
- Add logging integration tests (T-1300 through T-1303) using \#[traced_test]\

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

* Address review findings: deterministic time, structured assertions

- Replace tokio::time::sleep with pause()+advance() for deterministic
  session ex... (continued)

37 of 50 new or added lines in 4 files covered. (74.0%)

21514 of 25147 relevant lines covered (85.55%)

163.53 hits per line