Improve docs and security defaults

src/core/providers/enhanced_provider.py

@@ -37,7 +37,10 @@ from .base_provider import Loader
 
 
 class EnhancedAniWorldLoader(Loader):
-    """Enhanced AniWorld loader with comprehensive error handling."""
+    """Aniworld provider with retry and recovery strategies.
+
+    Also exposes metrics hooks for download statistics.
+    """
     
     def __init__(self):
         super().__init__()
@@ -211,7 +214,9 @@ class EnhancedAniWorldLoader(Loader):
         if not word or not word.strip():
             raise ValueError("Search term cannot be empty")
         
-        search_url = f"{self.ANIWORLD_TO}/ajax/seriesSearch?keyword={quote(word)}"
+        search_url = (
+            f"{self.ANIWORLD_TO}/ajax/seriesSearch?keyword={quote(word)}"
+        )
         
         try:
             return self._fetch_anime_list_with_recovery(search_url)
@@ -250,7 +255,9 @@ class EnhancedAniWorldLoader(Loader):
         
         clean_text = response_text.strip()
         
-        # Try multiple parsing strategies
+        # Try multiple parsing strategies. We progressively relax the parsing
+        # requirements to handle HTML-escaped payloads, stray BOM markers, and
+        # control characters injected by the upstream service.
         parsing_strategies = [
             lambda text: json.loads(html.unescape(text)),
             lambda text: json.loads(text.encode('utf-8').decode('utf-8-sig')),