feat: Add FastAPI API documentation with XLS-80 endpoint descriptions

- Add api/docs.py with comprehensive API description and tag metadata
- Integrate OpenAPI docs at /docs and /redoc endpoints
- Configure endpoint tags for Public, Permissioned Domains, Admin, Monitoring
- Fix multi-line import syntax in main.py
- Remove htmlcov from tracking, disable HTML coverage reports
- Clean repository language distribution (100% Python)

Author: Will Flores

api/docs.py

@@ -0,0 +1,66 @@
+"""
+API Documentation Configuration
+"""
+
+DESCRIPTION = """
+# Ward Protocol API
+
+**Ward Protocol** is the first institutional insurance layer for XRP Ledger DeFi lending, 
+featuring XLS-80 Permissioned Domains for compliance-ready capital deployment.
+
+## Features
+
+### Permissioned Domains (XLS-80)
+- Create institutional compliance domains
+- Manage credential-based access control
+- Verify domain membership
+
+### XLS-70 Credentials
+- Issue and verify credentials
+- Cached verification for performance
+- Support for multiple credential types
+
+### Insurance Pools
+- Monitor vault health
+- Automated coverage deployment
+- Real-time risk assessment
+
+## Authentication
+
+All endpoints require API key authentication via `X-API-Key` header.
+
+**Example:**
+```bash
+curl -H "X-API-Key: your_key_here" https://api.wardprotocol.org/domains
+```
+
+## Rate Limits
+
+- Public endpoints: 100 requests/minute
+- Authenticated endpoints: 1000 requests/minute
+- Admin endpoints: Unlimited
+
+## Support
+
+- Documentation: https://github.com/wflores9/ward-protocol
+- Issues: https://github.com/wflores9/ward-protocol/issues
+"""
+
+TAGS_METADATA = [
+    {
+        "name": "Public",
+        "description": "Public endpoints - no authentication required"
+    },
+    {
+        "name": "Permissioned Domains",
+        "description": "XLS-80 Permissioned Domains management. Control institutional access via credentials."
+    },
+    {
+        "name": "Admin",
+        "description": "Administrative endpoints - requires admin API key with full permissions"
+    },
+    {
+        "name": "Monitoring",
+        "description": "Health checks and system monitoring"
+    }
+]

main.py

@@ -1,4 +1,5 @@
 from fastapi import FastAPI, HTTPException, Depends, Request
+from api.docs import DESCRIPTION, TAGS_METADATA
 from fastapi.middleware.cors import CORSMiddleware
 from slowapi.middleware import SlowAPIMiddleware
 from slowapi.errors import RateLimitExceeded
@@ -41,10 +42,11 @@
 
 app = FastAPI(
     title="Ward Protocol API",
-    description="Institutional Insurance for XRPL DeFi Lending - Enterprise Grade",
-    version="1.0.0",
-    docs_url="/docs" if os.getenv("DEBUG", "false").lower() == "true" else None,
-    redoc_url="/redoc" if os.getenv("DEBUG", "false").lower() == "true" else None
+    description=DESCRIPTION,
+    version="0.1.0",
+    openapi_tags=TAGS_METADATA,
+    docs_url="/docs",
+    redoc_url="/redoc"
 )
 
 app.add_middleware(SecurityHeadersMiddleware)

main.py.backup

@@ -9,7 +9,6 @@ addopts =
     --cov=core
     --cov=main
     --cov-report=term-missing
-    --cov-report=html
     --strict-markers
 markers =
     unit: Unit tests