standardize packaging, tooling, docs, CI, and licensing

mail_intake/models/message.py

@@ -13,7 +13,6 @@ provider-specific fields or semantics.
 
 from dataclasses import dataclass
 from datetime import datetime
-from typing import Optional, Dict
 
 
 @dataclass(frozen=True)
@@ -54,7 +53,7 @@ class MailIntakeMessage:
     Sender email address.
     """
 
-    from_name: Optional[str]
+    from_name: str | None
     """
     Optional human-readable sender name.
     """
@@ -74,7 +73,7 @@ class MailIntakeMessage:
     Short provider-supplied preview snippet of the message.
     """
 
-    raw_headers: Dict[str, str]
+    raw_headers: dict[str, str]
     """
     Normalized mapping of message headers (header name → value).
     """

mail_intake/models/message.pyi

@@ -1,14 +1,24 @@
 from datetime import datetime
-from typing import Optional, Dict
 
 class MailIntakeMessage:
     message_id: str
     thread_id: str
     timestamp: datetime
     from_email: str
-    from_name: Optional[str]
+    from_name: str | None
     subject: str
     body_text: str
     snippet: str
-    raw_headers: Dict[str, str]
-    def __init__(self, message_id: str, thread_id: str, timestamp: datetime, from_email: str, from_name: Optional[str], subject: str, body_text: str, snippet: str, raw_headers: Dict[str, str]) -> None: ...
+    raw_headers: dict[str, str]
+    def __init__(
+        self,
+        message_id: str,
+        thread_id: str,
+        timestamp: datetime,
+        from_email: str,
+        from_name: str | None,
+        subject: str,
+        body_text: str,
+        snippet: str,
+        raw_headers: dict[str, str],
+    ) -> None: ...

mail_intake/models/thread.py

@@ -12,7 +12,6 @@ for higher-level correspondence workflows.
 
 from dataclasses import dataclass, field
 from datetime import datetime
-from typing import List, Set
 
 from mail_intake.models.message import MailIntakeMessage
 
@@ -42,12 +41,12 @@ class MailIntakeThread:
     Normalized subject line used to group related messages.
     """
 
-    participants: Set[str] = field(default_factory=set)
+    participants: set[str] = field(default_factory=set)
     """
     Set of unique participant email addresses observed in the thread.
     """
 
-    messages: List[MailIntakeMessage] = field(default_factory=list)
+    messages: list[MailIntakeMessage] = field(default_factory=list)
     """
     Ordered list of messages belonging to this thread.
     """

mail_intake/models/thread.pyi

@@ -1,12 +1,19 @@
 from datetime import datetime
-from typing import List, Set, Optional
+
 from .message import MailIntakeMessage
 
 class MailIntakeThread:
     thread_id: str
     normalized_subject: str
-    participants: Set[str]
-    messages: List[MailIntakeMessage]
-    last_activity_at: Optional[datetime]
-    def __init__(self, thread_id: str, normalized_subject: str, participants: Set[str] = ..., messages: List[MailIntakeMessage] = ..., last_activity_at: Optional[datetime] = ...) -> None: ...
+    participants: set[str]
+    messages: list[MailIntakeMessage]
+    last_activity_at: datetime | None
+    def __init__(
+        self,
+        thread_id: str,
+        normalized_subject: str,
+        participants: set[str] = ...,
+        messages: list[MailIntakeMessage] = ...,
+        last_activity_at: datetime | None = ...,
+    ) -> None: ...
     def add_message(self, message: MailIntakeMessage) -> None: ...