Refactor: code quality, performance, and feature improvements

scripts/__init__.py

@@ -1,11 +1,30 @@
 """
 scripts package - AdGuard Home Blocklist Compiler
 
+A high-performance blocklist compiler that merges 80+ DNS blocklists into a single,
+deduplicated output optimized for AdGuard Home.
+
 Modules:
-    downloader: Download blocklists with ETag/Last-Modified caching
-    cleaner: Clean and validate rules for AGH compatibility
-    compiler: Modifier-aware deduplication
-    pipeline: Main processing pipeline
+    downloader: Async blocklist downloader with ETag/Last-Modified caching
+    cleaner: Rule filtering and validation for AdGuard Home compatibility
+    compiler: Format compression and modifier-aware deduplication engine
+    pipeline: Main processing pipeline orchestrator
+
+Example:
+    >>> from scripts.pipeline import process_files
+    >>> stats = process_files("lists/_raw", "lists/merged.txt")
 """
 
-__version__ = "1.0.0"
+from typing import Final
+
+__version__: Final[str] = "1.4.0"
+__author__: Final[str] = "MissionWAR"
+
+__all__ = [
+    "__version__",
+    "__author__",
+    "downloader",
+    "cleaner", 
+    "compiler",
+    "pipeline",
+]