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/gmail.py

@@ -15,14 +15,15 @@ It is the only place in the codebase where:
 All Gmail-specific behavior must be strictly contained within this module.
 """
 
-from typing import Iterator, Dict, Any
+from collections.abc import Iterator
+from typing import Any
 
 from googleapiclient.discovery import build
 from googleapiclient.errors import HttpError
 
 from mail_intake.adapters.base import MailIntakeAdapter
-from mail_intake.exceptions import MailIntakeAdapterError
 from mail_intake.auth.base import MailIntakeAuthProvider
+from mail_intake.exceptions import MailIntakeAdapterError
 
 
 class MailIntakeGmailAdapter(MailIntakeAdapter):
@@ -71,10 +72,6 @@ class MailIntakeGmailAdapter(MailIntakeAdapter):
         """
         Lazily initialize and return the Gmail API service client.
 
-        Returns:
-            Any:
-                Initialized Gmail API service instance.
-
         Raises:
             MailIntakeAdapterError:
                 If the Gmail service cannot be initialized.
@@ -89,7 +86,7 @@ class MailIntakeGmailAdapter(MailIntakeAdapter):
                 ) from exc
         return self._service
 
-    def iter_message_refs(self, query: str) -> Iterator[Dict[str, str]]:
+    def iter_message_refs(self, query: str) -> Iterator[dict[str, str]]:
         """
         Iterate over message references matching the query.
 
@@ -98,7 +95,7 @@ class MailIntakeGmailAdapter(MailIntakeAdapter):
                 Gmail search query string.
 
         Yields:
-            Dict[str, str]:
+            dict[str, str]:
                 Dictionaries containing ``message_id`` and ``thread_id``.
 
         Raises:
@@ -107,9 +104,7 @@ class MailIntakeGmailAdapter(MailIntakeAdapter):
         """
         try:
             request = (
-                self.service.users()
-                .messages()
-                .list(userId=self._user_id, q=query)
+                self.service.users().messages().list(userId=self._user_id, q=query)
             )
 
             while request is not None:
@@ -121,18 +116,14 @@ class MailIntakeGmailAdapter(MailIntakeAdapter):
                         "thread_id": msg["threadId"],
                     }
 
-                request = (
-                    self.service.users()
-                    .messages()
-                    .list_next(request, response)
-                )
+                request = self.service.users().messages().list_next(request, response)
 
         except HttpError as exc:
             raise MailIntakeAdapterError(
                 "Gmail API error while listing messages"
             ) from exc
 
-    def fetch_message(self, message_id: str) -> Dict[str, Any]:
+    def fetch_message(self, message_id: str) -> dict[str, Any]:
         """
         Fetch a full Gmail message by message ID.
 
@@ -141,7 +132,7 @@ class MailIntakeGmailAdapter(MailIntakeAdapter):
                 Gmail message identifier.
 
         Returns:
-            Dict[str, Any]:
+            dict[str, Any]:
                 Provider-native Gmail message payload.
 
         Raises:
@@ -160,7 +151,7 @@ class MailIntakeGmailAdapter(MailIntakeAdapter):
                 f"Gmail API error while fetching message {message_id}"
             ) from exc
 
-    def fetch_thread(self, thread_id: str) -> Dict[str, Any]:
+    def fetch_thread(self, thread_id: str) -> dict[str, Any]:
         """
         Fetch a full Gmail thread by thread ID.
 
@@ -169,7 +160,7 @@ class MailIntakeGmailAdapter(MailIntakeAdapter):
                 Gmail thread identifier.
 
         Returns:
-            Dict[str, Any]:
+            dict[str, Any]:
                 Provider-native Gmail thread payload.
 
         Raises: