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

@@ -2,7 +2,10 @@
  * @file json_flat.h
  * @brief Парсер плоского JSON без вложенности: {"key":"value",...}
  *
- * Только строковые значения. Callback получает полные строки без обрезания.
+ * Только строковые значения и обычные escapes; \uXXXX не поддерживается.
+ * Callback получает полные key/value, действительные только до его возврата.
+ * parse возвращает 0 при успехе/остановке callback, -1 при ошибке; остановка не проверяет остаток ввода.
+ * get ищет первый ключ и копирует значение с NUL, при малом буфере обрезает; 0 найден, -1 ошибка/нет ключа.
  */
 
 #ifndef JSON_FLAT_H