docs: add OpenAPI-first wiki (overview, components, use cases for templates/client/codegen, design, security, error handling, testing) and refresh lib docs index

openapi_first/templates/health_app/__init__.py

@@ -24,15 +24,15 @@ Scaffolding via CLI
 Create a new OpenAPI-first health check service using the bundled
 template:
 
-    openapi-first health_app
+    openapi-first scaffold health_app
 
 Create the service in a custom directory:
 
-    openapi-first health_app my-health-service
+    openapi-first scaffold health_app my-health-service
 
 List all available application templates:
 
-    openapi-first --list
+    openapi-first scaffold --list
 
 The CLI copies template files verbatim into the target directory.
 No code is generated or modified beyond the copied scaffold.

openapi_first/templates/health_app/routes.py

@@ -13,7 +13,7 @@ This module serves solely as an operationId namespace.
 """
 
 
-def get_health():
+def get_health() -> dict:
     """
     Health check operation handler.