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

@@ -1,4 +1,7 @@
-// firewall.h - Firewall rules for utun
+/* firewall — список разрешённых пар IPv4/порт из global_config, без изменения системного firewall.
+ * init/обнуление → load_rules (копия и сортировка правил) → check → free; контекст использует один поток.
+ * check: 1 разрешено, 0 запрещено; port=0 в правиле разрешает все порты IP, bypass_all разрешает всё.
+ * IP и порт передавать в host order, как в CFG_FIREWALL_RULE. */
 #ifndef FIREWALL_H
 #define FIREWALL_H