[efiten]

Summary

Map side of uplink pings (ingestor side: #20). The Mobile RX coverage page gets an Uplink layer that shows, per hex, whether the mesh heard the companions that pinged there.

• GET /api/uplink-coverage (cmd/server/uplink_coverage.go), gated on clientUplink.enabled. Each ping gets a class:

  • both: a repeater re-broadcast was heard by the companion, and an observer received the ping
  • observed: an observer received it, no echo
  • echo: echo, but no observer received it
  • none: neither

  "Observer received it" means transmissions.hash matches the ping's hash. That hash comes from the echo, or from the ingestor's own decryption (client_uplink_tx). Per cell the endpoint returns the counts per class, the best class, the first-hop repeaters, the most observers reached, the longest path and the time of the last ping.

• /api/config/client exposes clientUplink; roles.js sets MC_CLIENT_UPLINK.

• rx-coverage.js:

  • an "Uplink" layer button, also shown without clientRfSamples
  • a four-class legend, with the caveat that "not received by an observer" can mean no observer is in range
  • a tooltip per cell
  • a layer=uplink deep link
  • theme-token colours (--nq-up-*), light and dark

Performance

One bbox query on client_uplink_pings (indexed on lat/lon and sent_at), plus one arrivals query per 500 distinct hashes over transmissions(hash) joined to observations(transmission_id), both indexed. Pings are rare (paced to at most 50 per hour per companion), so the row counts are small. Not benchmarked.

Test plan

• Go: class mapping, aggregation, endpoint (echo hash and tx hash, days window, no-position pings, 404 when off, 400 on a bad bbox, empty when the tables are absent). Full server suite passes.
• test-all.sh: all unit suites pass. New: test-rx-coverage-uplink.js.
• E2E test-rx-coverage-uplink-e2e.js against a static server with a mocked API: 3/3.
• XSS gate on rx-coverage.js and roles.js.
• Live, in the browser: the cell from the field ping cdrx ebd842fb (3 echoes, 17 observers) should show "both directions".

🤖 Generated with Claude Code