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.

lib/socket_compat.h

@@ -1,6 +1,7 @@
 /**
- * Socket compatibility layer for cross-platform support (POSIX / Windows)
- * MSYS2 UCRT64 compatible
+ * Единые socket_t, коды ошибок и wrappers сокетов POSIX/Windows (включая MSYS2 UCRT64).
+ * platform_init/cleanup обслуживают Winsock; UDP/nonblocking/options/sendto/recvfrom — операции ОС.
+ * Созданные сокеты закрывает владелец через socket_close_wrapper; event loop находится в u_async.h.
  */
 
 #ifndef SOCKET_COMPAT_H