docs: update file inventory and module header contracts

Refresh both AGENTS guides and clarify module purpose, usage, ownership, threading, return values and wire formats in headers. Remove the unused timeout_heap freed_count field and unimplemented getter.

src/routing_layer/topo_node_sqlite.h

@@ -1,3 +1,8 @@
+/* topo_node_sqlite — хранение подписанных снимков узлов, адресов, каналов и блоков мемберов в общей SQLite.
+ * Модель/проверка подписей/registry — topo_node и member_sync; этот модуль реализует SQL-операции в uasync-потоке.
+ * snapshot_put проверяет подпись и сохраняет только более свежий timestamp; node_load предпочитает snapshot.
+ * db/groups заимствованы. Возвращённый TOPO_NODE без registry ref: передать registry либо уничтожить через topo_node_destroy.
+ * Массивы out_ids/out_ch_ids/out_peers принадлежат вызывающему и освобождаются u_free. */
 #ifndef TOPO_NODE_SQLITE_H
 #define TOPO_NODE_SQLITE_H
 
@@ -101,8 +106,8 @@ void topo_node_sqlite_update_rtt(sqlite3* db, uint64_t node_id, uint16_t rtt);
  * @param groups нужен для выделения адресов из memory_pool
  * @return TOPO_NODE* или NULL если узел не найден/нет адресов
  *
- * Загружает pubkey, name из nodes, IPv4/UDP-адреса из node_addresses.
- * Вызывающий должен передать владение через topo_node_registry_acquire().
+ * Сначала загружает и проверяет подписанный snapshot; при его отсутствии собирает сведения nodes/node_addresses.
+ * Вызывающий передаёт владение через topo_node_registry_acquire() либо вызывает topo_node_destroy().
  */
 struct TOPO_NODE* topo_node_sqlite_node_load(sqlite3* db, struct TOPO_GROUPS* groups, uint64_t node_id);