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

docs/mcp/modules/openapi_first.codegen.json

@@ -0,0 +1,23 @@
+{
+  "module": "openapi_first.codegen",
+  "content": {
+    "path": "openapi_first.codegen",
+    "docstring": "# Summary\n\nCore logic for generating Python source code from OpenAPI specifications.\n\nThis module provides reusable utilities for code generation, specifically\ngenerating Pydantic models and route handler stubs from OpenAPI 3.x schema\ndefinitions.",
+    "objects": {
+      "generate_routes": {
+        "name": "generate_routes",
+        "kind": "function",
+        "path": "openapi_first.codegen.generate_routes",
+        "signature": "generate_routes(spec_path: Path, output_dir: Path, *, use_models: bool = False, models_module: str = 'models', inject_request: bool = False, package: bool = False, template_style: bool = False)",
+        "docstring": "Generate route handler stubs from an OpenAPI specification.\n\nCreates one route module per resource in *output_dir*. Resources are\nderived from the first path segment (e.g. ``/pets`` and ``/pets/{id}``\nboth group under ``pets``) and sanitized to valid module identifiers.\n\nArgs:\n    spec_path (Path):\n        Path to the OpenAPI specification file (YAML or JSON).\n    output_dir (Path):\n        Directory where the generated route files are written.\n        Created automatically if it does not exist.\n    use_models (bool, optional):\n        If ``True``, import Pydantic models from *models_module*\n        for request-body schemas referenced via ``$ref``.\n    models_module (str, optional):\n        Dotted Python module path from which to import models\n        (e.g. ``\"models\"``, ``\"app.models\"``).\n    inject_request (bool, optional):\n        If ``True``, prepend ``request: Request`` to every handler so the\n        stub can later resolve services from ``request.app.state``.\n    package (bool, optional):\n        If ``True``, emit ``<resource>/routes.py`` packages (each with an\n        ``__init__.py``) instead of flat ``<resource>.py`` modules.\n    template_style (bool, optional):\n        If ``True``, emit ``async def`` handlers with a JSON body parameter\n        named ``body`` (the standards-template convention) plus a\n        service-resolution hint comment, instead of sync ``def`` handlers\n        taking ``payload``.\n\nReturns:\n    list[Path]:\n        Absolute paths of every generated route file.\n\nRaises:\n    OpenAPISpecLoadError:\n        If the spec cannot be loaded or validated.\n    ValueError:\n        If any operation is missing ``operationId``."
+      },
+      "generate_models": {
+        "name": "generate_models",
+        "kind": "function",
+        "path": "openapi_first.codegen.generate_models",
+        "signature": "generate_models(spec_path: Path, output_path: Path, pydantic_version: int = 2) -> None",
+        "docstring": "Generate Pydantic models from an OpenAPI specification.\n\nArgs:\n    spec_path (Path):\n        Path to the OpenAPI specification file (YAML or JSON).\n    output_path (Path):\n        Path where the generated Python code should be written.\n    pydantic_version (int, optional):\n        The Pydantic version to target (1 or 2). Defaults to 2.\n\nNotes:\n    **Reusability:**\n        This function is designed to be used by the CLI and can be\n        exposed as an MCP tool without modification."
+      }
+    }
+  }
+}