chore(release): 0.0.3

Squash-merge lib-standardisation: adopt repo standards across packaging,
tooling, docs, and CI.

- standardize pyproject.toml (canonical packaging, lint config, extras, GSDFC pydoclint)
- add py.typed marker, modernize type hints and Google-style docstrings
- nest generated docs under docs/lib and docs/mcp; add hand-written wiki
- adopt standard Type A PyPI CI pipeline (tag==version guard + quality gate)
- promote generated CHANGELOG.md; bump version to 0.0.3

mail_intake/adapters/base.py

@@ -12,7 +12,8 @@ types or semantics should leak beyond implementations of this interface.
 """
 
 from abc import ABC, abstractmethod
-from typing import Iterator, Dict, Any
+from collections.abc import Iterator
+from typing import Any
 
 
 class MailIntakeAdapter(ABC):
@@ -32,7 +33,7 @@ class MailIntakeAdapter(ABC):
     """
 
     @abstractmethod
-    def iter_message_refs(self, query: str) -> Iterator[Dict[str, str]]:
+    def iter_message_refs(self, query: str) -> Iterator[dict[str, str]]:
         """
         Iterate over lightweight message references matching a query.
 
@@ -40,8 +41,12 @@ class MailIntakeAdapter(ABC):
             query (str):
                 Provider-specific query string used to filter messages.
 
+        Returns:
+            Iterator[dict[str, str]]:
+                An iterator over lightweight message reference dictionaries.
+
         Yields:
-            Dict[str, str]:
+            dict[str, str]:
                 Dictionaries containing message and thread identifiers.
 
         Notes:
@@ -63,7 +68,7 @@ class MailIntakeAdapter(ABC):
         raise NotImplementedError
 
     @abstractmethod
-    def fetch_message(self, message_id: str) -> Dict[str, Any]:
+    def fetch_message(self, message_id: str) -> dict[str, Any]:
         """
         Fetch a full raw message by message identifier.
 
@@ -72,13 +77,13 @@ class MailIntakeAdapter(ABC):
                 Provider-specific message identifier.
 
         Returns:
-            Dict[str, Any]:
+            dict[str, Any]:
                 Provider-native message payload (e.g., Gmail message JSON structure).
         """
         raise NotImplementedError
 
     @abstractmethod
-    def fetch_thread(self, thread_id: str) -> Dict[str, Any]:
+    def fetch_thread(self, thread_id: str) -> dict[str, Any]:
         """
         Fetch a full raw thread by thread identifier.
 
@@ -87,7 +92,7 @@ class MailIntakeAdapter(ABC):
                 Provider-specific thread identifier.
 
         Returns:
-            Dict[str, Any]:
+            dict[str, Any]:
                 Provider-native thread payload.
         """
         raise NotImplementedError