fix(openapi): address CodeRabbit review nits

Use stable repo-root docs path for FAQ route and enforce exactly-two
standards via marshmallow Length validation on map analysis queries.

Co-authored-by: Cursor <cursoragent@cursor.com>

Author: northdpole

application/web/openapi_schemas.py

@@ -74,12 +74,17 @@ class MapAnalysisQuerySchema(Schema):
     standard = fields.List(
         fields.Str(),
         required=True,
+        validate=validate.Length(min=2, max=2),
         metadata={"description": "Exactly two standard names"},
     )
 
 
 class MapAnalysisWeakLinksQuerySchema(Schema):
-    standard = fields.List(fields.Str(), required=True)
+    standard = fields.List(
+        fields.Str(),
+        required=True,
+        validate=validate.Length(min=2, max=2),
+    )
     key = fields.Str(required=True, metadata={"description": "Gap-analysis cache key"})
 
 

application/web/web_main.py

@@ -659,14 +659,17 @@ def page_not_found(e) -> Any:
     return "Resource Not found", 404
 
 
+_REPO_ROOT = os.path.abspath(
+    os.path.join(os.path.dirname(os.path.realpath(__file__)), "..", "..")
+)
+_DOCS_DIR = os.path.join(_REPO_ROOT, "docs")
+
+
 @app.route("/docs/faq.md", methods=["GET"])
 def faq_markdown() -> Any:
     """Serve FAQ markdown for the in-app docs page."""
     return send_from_directory(
-        directory=os.path.join(
-            os.path.dirname(os.path.realpath(__file__)),
-            "../../docs",
-        ),
+        directory=_DOCS_DIR,
         path="faq.md",
         mimetype="text/markdown; charset=utf-8",
     )