docs: regenerate API reference version summaries

Author: huv1k

scripts/generate_openapi_reference.py

@@ -673,18 +673,34 @@ def add_operation_ids(spec: dict[str, Any]) -> None:
         print(f"==> Added {count} operationIds to envd endpoints")
 
 
-VERSIONED_PLATFORM_PATH_RE = re.compile(r"^/(v\d+)(?:/|$)", re.IGNORECASE)
+VERSIONED_PLATFORM_SEGMENT_RE = re.compile(r"^(v\d+)([A-Za-z][^/]*)?$", re.IGNORECASE)
+
+
+def extract_leading_version_label(ep_path: str) -> str | None:
+    """Return `vN` for a versioned leading path segment like `v2` or `v2templates`."""
+    first_segment = ep_path.lstrip("/").split("/", 1)[0]
+    match = VERSIONED_PLATFORM_SEGMENT_RE.match(first_segment)
+    if not match:
+        return None
+    return match.group(1).lower()
+
+
+def split_leading_version_segment(segment: str) -> tuple[str | None, str | None]:
+    """Split `vNfoo` into (`VN`, `foo`) and `vN` into (`VN`, None)."""
+    match = VERSIONED_PLATFORM_SEGMENT_RE.match(segment)
+    if not match:
+        return None, None
+    return match.group(1).upper(), match.group(2)
 
 
 def normalize_versioned_summaries(spec: dict[str, Any]) -> int:
     """Append `(vN)` to versioned platform endpoint summaries when missing."""
     count = 0
     for ep_path, path_item in spec.get("paths", {}).items():
-        match = VERSIONED_PLATFORM_PATH_RE.match(ep_path)
-        if not match:
+        version_label = extract_leading_version_label(ep_path)
+        if not version_label:
             continue
 
-        version_label = match.group(1).lower()
         for method in ("get", "post", "put", "patch", "delete", "head", "options"):
             op = path_item.get(method)
             if not op:
@@ -907,6 +923,14 @@ def _singularize(word: str) -> str:
             i = 0
             while i < len(raw_segments):
                 seg = raw_segments[i]
+                if i == 0:
+                    detected_version, remainder = split_leading_version_segment(seg)
+                    if detected_version:
+                        version_suffix = detected_version
+                        if remainder:
+                            parts.append(remainder)
+                        i += 1
+                        continue
                 if seg in ("v2", "v3"):
                     version_suffix = seg.upper()
                     i += 1