Alan-Jowett / sonde / 25943429448

81%

Build Type

push

github

Committed by web-flow

Commit Message

feat(gateway): decoder BPF programs for APP_DATA enrichment (GW-1900-GW-1906) (#925)

* feat(gateway): decoder BPF programs for APP_DATA enrichment (GW-1900-GW-1906)

Implement gateway-side decoder BPF program support: optional SEC("decoder")
ELF sections are extracted, verified with a restricted DecoderPlatform, and
executed on APP_DATA messages to produce named sensor readings.

New modules:
- decoder_platform.rs: Prevail platform with restricted helpers (IDs 10,
  11, 16, 18). Uses data/end pointer pair context descriptor (16 bytes).
- decoder.rs: BPF execution engine using sonde-bpf. Thread-local state
  for emit_reading collection. Max 32 readings, 64-byte names, last-write-
  wins. 100k instruction budget. Runs via spawn_blocking.

Changes:
- ProgramRecord gains decoder_image: Option<Vec<u8>> field
- ingest_elf() extended with extract_decoder() for decoder section
  extraction, Prevail verification, and CBOR image construction
- HandlerMessage::Data and ConnectorOutboundMessage::AppData gain
  optional readings field at CBOR key 16
- handle_app_data_core() performs decoder enrichment before emitting to
  both handler and connector (GW-1903 AC-6)
- SQLite migration adds decoder_image column; state bundle export/import
  updated with key 7
- sonde_helpers.h gains decoder_context struct and emit_reading helper
- tmp102_sensor.c and sht40_sensor.c gain SEC("decoder") functions

Spec updates:
- decoder_context uses { input_data, input_end } (data/end pointer pair)
  instead of { input_data, input_len } for Prevail verifier compatibility.
  Updated bpf-environment.md, gateway-requirements.md, gateway-design.md.

Tests: 15 new tests in tests/decoder.rs covering T-1900, T-1900a/b/c,
T-1901, T-1901a/b, T-1903b/c, T-1904, T-1904a/b/c, T-1906, and handler
message roundtrip with readings.

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

* feat(gateway): log decoded APP_DATA reading... (continued)

Coverage Stats

533 of 765 new or added lines in 12 files covered. (69.67%)

9 existing lines in 3 files now uncovered.

34858 of 42091 relevant lines covered (82.82%)

257.94 hits per line