Create tests/test_adapter_contract.py

tests/test_adapter_contract.py

@@ -0,0 +1,43 @@
+import inspect
+import asyncio
+import pytest
+from typing import Dict, List
+
+from ingest.generic_public_foia import GenericFOIAAdapter
+from ingest.registry import get_all_adapters
+
+
+@pytest.mark.asyncio
+async def test_adapters_implement_search():
+    """
+    Every adapter must implement an async search() method.
+    """
+    adapters = get_all_adapters()
+
+    assert adapters, "No adapters registered"
+
+    for name, adapter in adapters.items():
+        assert isinstance(adapter, GenericFOIAAdapter), f"{name} not subclassing GenericFOIAAdapter"
+
+        method = adapter.search
+        assert callable(method), f"{name}.search is not callable"
+        assert inspect.iscoroutinefunction(method), f"{name}.search must be async"
+
+
+@pytest.mark.asyncio
+async def test_search_returns_list_of_dicts():
+    """
+    search() must always return List[Dict], even on failure.
+    """
+    adapters = get_all_adapters()
+
+    for name, adapter in adapters.items():
+        try:
+            results = await adapter.search("test")
+        except Exception as e:
+            pytest.fail(f"{name}.search() raised exception: {e}")
+
+        assert isinstance(results, list), f"{name}.search did not return a list"
+
+        for r in results:
+            assert isinstance(r, dict), f"{name} returned non-dict result"