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

@@ -1,6 +1,10 @@
 #ifndef LL_QUEUE_H
 #define LL_QUEUE_H
 
+/* Очередь одного uasync-потока; наличие pthread-заголовков не делает её межпоточной.
+ * put может синхронно вызвать consumer/waiter. Держать владельцев живыми до завершения callbacks,
+ * waiter handle обнулять целиком и отменять до освобождения; entry и dgram освобождаются отдельно. */
+
 #ifdef __cplusplus
 extern "C" {
 #endif
@@ -306,7 +310,6 @@ void queue_waiter_cancel(struct ll_queue* q, struct queue_waiter_handle* h);
  * @brief Добавляет элемент в конец очереди (FIFO).
  * @param q очередь
  * @param entry элемент
- * @param id идентификатор для поиска
  * @return 0 — успех, -1 — превышен лимит (элемент освобождён)
  */
 int queue_data_put(struct ll_queue* q, struct ll_entry* entry);
@@ -315,7 +318,6 @@ int queue_data_put(struct ll_queue* q, struct ll_entry* entry);
  * @brief Добавляет элемент в начало очереди (LIFO, высокий приоритет).
  * @param q очередь
  * @param entry элемент
- * @param id идентификатор
  * @return 0 — успех, -1 — превышен лимит (элемент освобождён)
  */
 int queue_data_put_first(struct ll_queue* q, struct ll_entry* entry);