Kpa-clawbotandyou 30e7e9ae3c docs: document lock ordering for cacheMu and channelsCacheMu (#624) ...

## Summary

Documents the lock ordering for all five mutexes in `PacketStore`
(`store.go`) to prevent future deadlocks.

## What changed

Added a comment block above the `PacketStore` struct documenting:

- All 5 mutexes (`mu`, `cacheMu`, `channelsCacheMu`, `groupedCacheMu`,
`regionObsMu`)
- What each mutex guards
- The required acquisition order (numbered 1–5)
- The nesting relationships that exist today (`cacheMu →
channelsCacheMu` in `invalidateCachesFor` and `rebuildAnalyticsCaches`)
- Confirmation that no reverse ordering exists (no deadlock risk)

## Verification

- Grepped all lock acquisition sites to confirm no reverse nesting
exists
- `go build ./...` passes — documentation-only change

Fixes #413

---------

Co-authored-by: you <you@example.com>

2026-04-05 13:00:35 -07:00

..

testdata/golden

chore: normalize all files to LF line endings

2026-03-30 22:52:46 -07:00

advert_pubkey_test.go

perf: track advert pubkeys incrementally, eliminate per-request JSON parsing (#360) (#544)

2026-04-03 13:51:13 -07:00

backfill_async_test.go

perf: async chunked backfill — HTTP serves within 2 minutes (#612) (#614)

2026-04-05 09:49:39 -07:00

cache_invalidation_test.go

fix: rate-limit cache invalidation to prevent 0% hit rate (#533) (#546)

2026-04-03 13:53:58 -07:00

config_knobs_test.go

perf: async chunked backfill — HTTP serves within 2 minutes (#612) (#614)

2026-04-05 09:49:39 -07:00

config_test.go

chore: normalize all files to LF line endings

2026-03-30 22:52:46 -07:00

config.go

perf: async chunked backfill — HTTP serves within 2 minutes (#612) (#614)

2026-04-05 09:49:39 -07:00

coverage_test.go

perf: make txToMap observations lazy via ExpandObservations flag (#595)

2026-04-04 10:39:30 -07:00

db_test.go

feat(rf-health): M2 — airtime, error rate, battery charts with delta computation (#605)

2026-04-04 23:17:17 -07:00

db.go

feat(rf-health): M2 — airtime, error rate, battery charts with delta computation (#605)

2026-04-04 23:17:17 -07:00

decoder_test.go

fix: restore color-coded hex breakdown in packet detail (#329) (#500)

2026-04-02 16:54:59 -07:00

decoder.go

fix: restore color-coded hex breakdown in packet detail (#329) (#500)

2026-04-02 16:54:59 -07:00

eviction_test.go

fix: wire cacheTTL.analyticsHashSizes config to collision cache (#420) (#622)

2026-04-05 12:49:46 -07:00

geo_filter.go

feat: geo_filter enforcement, DB pruning, geofilter-builder tool, HB column (#215)

2026-03-31 01:10:56 -07:00

go.mod

feat: geo_filter enforcement, DB pruning, geofilter-builder tool, HB column (#215)

2026-03-31 01:10:56 -07:00

go.sum

feat: add Go web server (cmd/server/) — full API + WebSocket + static files

2026-03-27 01:16:59 -07:00

helpers_test.go

perf: replace O(n²) selection sort with sort.Slice (#354) (#542)

2026-04-03 13:11:59 -07:00

main.go

fix: wire cacheTTL.analyticsHashSizes config to collision cache (#420) (#622)

2026-04-05 12:49:46 -07:00

neighbor_api_test.go

feat: add distance column to neighbor table in node details (#617)

2026-04-05 12:33:23 -07:00

neighbor_api.go

feat: add distance column to neighbor table in node details (#617)

2026-04-05 12:33:23 -07:00

neighbor_debug_test.go

feat: affinity debugging tools (#482) — milestone 6 (#521)

2026-04-02 23:45:03 -07:00

neighbor_debug.go

feat: affinity debugging tools (#482) — milestone 6 (#521)

2026-04-02 23:45:03 -07:00

neighbor_graph_test.go

perf: optimize neighbor graph build (3 fixes for 30s+ CPU) (#562)

2026-04-04 01:25:51 -07:00

neighbor_graph.go

perf: async chunked backfill — HTTP serves within 2 minutes (#612) (#614)

2026-04-05 09:49:39 -07:00

neighbor_persist_test.go

feat: server-side hop resolution at ingest — resolved_path (#556)

2026-04-04 00:20:59 -07:00

neighbor_persist.go

perf: async chunked backfill — HTTP serves within 2 minutes (#612) (#614)

2026-04-05 09:49:39 -07:00

obs_dedup_test.go

perf: replace O(n²) observation dedup with map-based O(n) (#355) (#543)

2026-04-03 13:33:26 -07:00

parity_test.go

feat: implement packet store eviction/aging to prevent OOM (#273)

2026-03-30 03:42:11 +00:00

perfstats_race_test.go

fix: add mutex synchronization to PerfStats to eliminate data races (#469)

2026-04-01 19:26:11 -07:00

resolve_context_test.go

perf: resolve hops from in-memory prefix map instead of N+1 DB queries (#577)

2026-04-04 09:51:07 -07:00

routes_test.go

fix: wire cacheTTL.analyticsHashSizes config to collision cache (#420) (#622)

2026-04-05 12:49:46 -07:00

routes.go

perf: async chunked backfill — HTTP serves within 2 minutes (#612) (#614)

2026-04-05 09:49:39 -07:00

store.go

docs: document lock ordering for cacheMu and channelsCacheMu (#624)

2026-04-05 13:00:35 -07:00

types.go

perf: async chunked backfill — HTTP serves within 2 minutes (#612) (#614)

2026-04-05 09:49:39 -07:00

websocket_test.go

feat: implement packet store eviction/aging to prevent OOM (#273)

2026-03-30 03:42:11 +00:00

websocket.go

fix: graceful container shutdown for reliable deployments (#453)

2026-04-01 12:19:20 -07:00