feat: add expected recipient reporting

src/email_connect/config.py

@@ -22,6 +22,8 @@ class ScanConfig:
     mode: str = "incremental"
     max_messages_per_run: int = 5000
     since: str | None = None
+    range_from: str | None = None
+    range_to: str | None = None
     include_seen: bool = True
     mark_seen: bool = False
     store_raw_headers: bool = True
@@ -47,6 +49,12 @@ class SourceConfig:
     fixture_dir: str | None = None
 
 
+@dataclass(frozen=True)
+class ExpectedRecipientsConfig:
+    path: str | None = None
+    csv_column: str = "email"
+
+
 @dataclass(frozen=True)
 class AppConfig:
     mailbox: MailboxConfig
@@ -54,6 +62,7 @@ class AppConfig:
     storage: StorageConfig
     reports: ReportsConfig
     source: SourceConfig = SourceConfig()
+    expected_recipients: ExpectedRecipientsConfig = ExpectedRecipientsConfig()
 
 
 def load_config(path: str | Path) -> AppConfig:
@@ -63,6 +72,7 @@ def load_config(path: str | Path) -> AppConfig:
     storage = data.get("storage", {})
     reports = data.get("reports", {})
     source = data.get("source", {})
+    expected_recipients = data.get("expected_recipients", {})
     return AppConfig(
         mailbox=MailboxConfig(
             id=str(mailbox.get("id", "return-mailbox-default")),
@@ -78,6 +88,8 @@ def load_config(path: str | Path) -> AppConfig:
             mode=str(scan.get("mode", "incremental")),
             max_messages_per_run=int(scan.get("max_messages_per_run", 5000)),
             since=scan.get("since"),
+            range_from=scan.get("from") or scan.get("range_from"),
+            range_to=scan.get("to") or scan.get("range_to"),
             include_seen=bool(scan.get("include_seen", True)),
             mark_seen=bool(scan.get("mark_seen", False)),
             store_raw_headers=bool(scan.get("store_raw_headers", True)),
@@ -92,6 +104,10 @@ def load_config(path: str | Path) -> AppConfig:
             timestamp_timezone=str(reports.get("timestamp_timezone", "UTC")),
         ),
         source=SourceConfig(fixture_dir=source.get("fixture_dir")),
+        expected_recipients=ExpectedRecipientsConfig(
+            path=expected_recipients.get("path"),
+            csv_column=str(expected_recipients.get("csv_column", "email")),
+        ),
     )