Delegate top-level adapter imports to adapters package.

Keep lazy loading in adapters/__init__.py as the single place to register new adapters.

Co-authored-by: Cursor <[email protected]>

python_repositories/adapters/__init__.py

@@ -9,10 +9,14 @@ from __future__ import annotations
 import importlib
 from typing import TYPE_CHECKING
 
+# Adapters are imported only for static type checkers; runtime loading is deferred below.
 if TYPE_CHECKING:
     from .minio_adapter import MinioAdapter
     from .redis_adapter import RedisAdapter
 
+# Map public adapter names to their defining module and class.
+# Each adapter module fails fast with an install hint if its extra is missing.
+# When adding a new adapter, update this dict and __all__ only.
 _LAZY_EXPORTS = {
     "RedisAdapter": (".redis_adapter", "RedisAdapter"),
     "MinioAdapter": (".minio_adapter", "MinioAdapter"),
@@ -25,6 +29,7 @@ __all__ = [
 
 
 def __getattr__(name: str) -> object:
+    """Load an adapter on first access so the base package installs without backend clients."""
     if name in _LAZY_EXPORTS:
         module_path, attr = _LAZY_EXPORTS[name]
         module = importlib.import_module(module_path, __package__)
@@ -33,4 +38,5 @@ def __getattr__(name: str) -> object:
 
 
 def __dir__() -> list[str]:
+    """Expose lazy adapter names in tab completion and dir()."""
     return sorted(__all__)