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/u_async.h

@@ -1,6 +1,8 @@
-// uasync.h
-
-// модуль асинхронных операций. добавляем сокеты и таймауты и mainloop их обслуживает.
+/* Цикл событий одного потока: сокеты (epoll/poll/select), таймеры и FIFO call_soon.
+ * create → регистрация callbacks → poll/mainloop → destroy вне callbacks после остановки владельцев.
+ * Таймауты задаются в timebase 0.1мс; arg принадлежит вызывающему, освобождает его callback/владелец.
+ * API сокетов/таймеров используется в потоке loop. Из другого потока — post/post_reserved и wakeup;
+ * публикация не продлевает время жизни ua/arg, их освобождение нужно согласовать с остановкой producers. */
 
 #ifndef UASYNC_H
 #define UASYNC_H