fix: apply GSDFC docstring conformance, add minimal annotations to unannotated params (pydoclint zero); refresh lib/MCP docs

openapi_first/codegen_routes.py

@@ -1,4 +1,6 @@
 """
+# Summary
+
 Route handler code generation from OpenAPI specifications.
 
 This module generates Python route handler stubs from an OpenAPI 3.x
@@ -39,15 +41,15 @@ def generate_routes(
     and ``/pets/{id}`` both group under ``pets``).
 
     Args:
-        spec_path:
+        spec_path (Path):
             Path to the OpenAPI specification file (YAML or JSON).
-        output_dir:
+        output_dir (Path):
             Directory where the generated route files are written.
             Created automatically if it does not exist.
-        use_models:
+        use_models (bool, optional):
             If ``True``, import Pydantic models from *models_module*
             for request-body schemas referenced via ``$ref``.
-        models_module:
+        models_module (str, optional):
             Dotted Python module path from which to import models
             (e.g. ``"models"``, ``"app.models"``).