From ee3fb3d6b7f7bf596dc4077615601c965e15bc92 Mon Sep 17 00:00:00 2001
From: Claude <developers@lethean.io>
Date: Thu, 2 Apr 2026 12:20:36 +0100
Subject: [PATCH] ax(node): replace prose comment with usage example on
 rebuildKDTree

AX principle 2: comments show HOW (usage example), not WHAT
(which the function name already says).

Co-Authored-By: Charon <charon@lethean.io>
---
 pkg/node/peer.go | 3 +--
 1 file changed, 1 insertion(+), 2 deletions(-)

diff --git a/pkg/node/peer.go b/pkg/node/peer.go
index 3265c75..e897b31 100644
--- a/pkg/node/peer.go
+++ b/pkg/node/peer.go
@@ -556,8 +556,7 @@ func (r *PeerRegistry) Count() int {
 	return len(r.peers)
 }
 
-// rebuildKDTree rebuilds the KD-tree from current peers.
-// Must be called with lock held.
+// r.rebuildKDTree() // called after AddPeer, UpdatePeer, RemovePeer, UpdateMetrics — lock must be held
 func (r *PeerRegistry) rebuildKDTree() {
 	if len(r.peers) == 0 {
 		r.kdTree = nil