chore(release): 0.0.7

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.7

openapi_first/app.py

@@ -34,6 +34,8 @@ Notes:
 
 import os
 import re
+from types import ModuleType
+from typing import Any
 
 from fastapi import FastAPI
 
@@ -46,8 +48,10 @@ _env_pattern = re.compile(r"\{(\w+)\}")
 
 def _resolve_env(value: str) -> str:
     """Replace {ENV_VAR} placeholders with values from os.environ."""
+
     def _replace(m: re.Match) -> str:
         return os.environ.get(m.group(1), m.group(0))
+
     return _env_pattern.sub(_replace, value)
 
 
@@ -66,6 +70,23 @@ class OpenAPIFirstApp(FastAPI):
     """
     FastAPI application enforcing OpenAPI-first design.
 
+    Args:
+        openapi_path (str):
+            Filesystem path to the OpenAPI 3.x specification file. This
+            specification is treated as the authoritative API contract.
+        routes_module (ModuleType):
+            Python module containing handler functions whose names correspond
+            exactly to OpenAPI ``operationId`` values.
+        **fastapi_kwargs (Any):
+            Additional keyword arguments passed directly to
+            ``fastapi.FastAPI`` (e.g., title, version, middleware, lifespan
+            handlers).
+
+    Raises:
+        OpenAPIFirstError:
+            If the OpenAPI specification is invalid, or if any declared
+            ``operationId`` does not have a corresponding handler function.
+
     Notes:
         **Responsibilities:**
 
@@ -88,7 +109,7 @@ class OpenAPIFirstApp(FastAPI):
 
     Example:
         ```python
-        from openapi_first import OpenAPIFirstApp
+        from openapi_first.app import OpenAPIFirstApp
         import app.routes as routes
 
         app = OpenAPIFirstApp(
@@ -103,29 +124,9 @@ class OpenAPIFirstApp(FastAPI):
         self,
         *,
         openapi_path: str,
-        routes_module,
-        **fastapi_kwargs,
+        routes_module: ModuleType,
+        **fastapi_kwargs: Any,
     ):
-        """
-        Initialize the application.
-
-        Args:
-            openapi_path (str):
-                Filesystem path to the OpenAPI 3.x specification file. This
-                specification is treated as the authoritative API contract.
-            routes_module (module):
-                Python module containing handler functions whose names correspond
-                exactly to OpenAPI ``operationId`` values.
-            **fastapi_kwargs (Any):
-                Additional keyword arguments passed directly to
-                ``fastapi.FastAPI`` (e.g., title, version, middleware, lifespan
-                handlers).
-
-        Raises:
-            OpenAPIFirstError:
-                If the OpenAPI specification is invalid, or if any declared
-                ``operationId`` does not have a corresponding handler function.
-        """
         # Initialize FastAPI normally
         super().__init__(**fastapi_kwargs)