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/credentials/redis.py

@@ -24,8 +24,8 @@ Credential validation, refresh, rotation, and acquisition remain the
 responsibility of authentication provider implementations.
 """
 
-
-from typing import Optional, TypeVar, Callable
+from collections.abc import Callable
+from typing import Any, TypeVar
 
 from mail_intake.credentials.store import CredentialStore
 
@@ -57,30 +57,27 @@ class RedisCredentialStore(CredentialStore[T]):
 
     def __init__(
         self,
-        redis_client,
+        redis_client: Any,
         key: str,
         serialize: Callable[[T], bytes],
         deserialize: Callable[[bytes], T],
-        ttl_seconds: Optional[int] = None,
+        ttl_seconds: int | None = None,
     ):
         """
         Initialize a Redis-backed credential store.
 
         Args:
             redis_client (Any):
-                An initialized Redis client instance (for example, ``redis.Redis`` or a compatible interface) used to communicate with the Redis server.
-
+                Initialized Redis client instance used for persistence.
             key (str):
-                The Redis key under which credentials are stored. Callers are responsible for applying appropriate namespacing to avoid collisions.
-
+                Storage key under which credentials are persisted.
             serialize (Callable[[T], bytes]):
-                A callable that converts a credential object of type ``T`` into a ``bytes`` representation suitable for storage in Redis.
-
+                Callable that encodes credentials to bytes for storage.
             deserialize (Callable[[bytes], T]):
-                A callable that converts a ``bytes`` payload retrieved from Redis back into a credential object of type ``T``.
-
-            ttl_seconds (Optional[int]):
-                Optional time-to-live (TTL) for the stored credentials, expressed in seconds. When provided, Redis will automatically expire the stored credentials after the specified duration. If ``None``, credentials are stored without an expiration.
+                Callable that decodes stored bytes back into credentials.
+            ttl_seconds (int | None):
+                Optional time-to-live in seconds after which stored
+                credentials expire automatically. ``None`` disables expiry.
         """
         self.redis = redis_client
         self.key = key
@@ -88,12 +85,12 @@ class RedisCredentialStore(CredentialStore[T]):
         self.deserialize = deserialize
         self.ttl_seconds = ttl_seconds
 
-    def load(self) -> Optional[T]:
+    def load(self) -> T | None:
         """
         Load credentials from Redis.
 
         Returns:
-            Optional[T]:
+            T | None:
                 An instance of type `T` if credentials are present and
                 successfully deserialized; otherwise `None`.