refactor: update remote tag fetching behaviour so it uses api instead of shallow clone

src/git_flow/remote/base.py

@@ -1,5 +1,7 @@
 from abc import ABC, abstractmethod
 
+import re
+
 import giturlparse
 import requests
 
@@ -72,6 +74,12 @@ class RemoteAPI(ABC):
         viejo), sin depender del historial local."""
         pass
 
+    @abstractmethod
+    def list_tags(self, suffix: str = "") -> list[str]:
+        """Nombres de los tags del repositorio, sin orden garantizado. `suffix` es solo una pista
+        para que la API filtre; el filtrado definitivo se hace en `get_latest_tag`."""
+        pass
+
     @abstractmethod
     def get_endpoint(self, resource: str) -> str:
         pass
@@ -91,13 +99,33 @@ class RemoteAPI(ABC):
 
         return response
 
-    def get_all_pages(self, url: str, page_size: int = 50) -> list:
+    def get_latest_tag(self, suffix: str = "") -> str | None:
+        """Tag SemVer más alto (vX.Y.Z + suffix exacto), o None si no hay ninguno."""
+        pattern = re.compile(rf"^v(\d+)\.(\d+)\.(\d+){re.escape(suffix)}$")
+        versions = {}
+
+        for name in self.list_tags(suffix):
+            match = pattern.match(name)
+
+            if match:
+                versions[tuple(map(int, match.groups()))] = name
+
+        return versions[max(versions)] if versions else None
+
+    def get_all_pages(
+        self,
+        url: str,
+        page_size: int = 50,
+        params: dict | None = None,
+        size_param: str = "per_page",
+    ) -> list:
         """Recorre un endpoint paginado por número de página (page / per_page)."""
         items: list = []
         page = 1
 
         while True:
-            batch = self.get_json(url, {"page": page, "per_page": page_size}).json()
+            query = {**(params or {}), "page": page, size_param: page_size}
+            batch = self.get_json(url, query).json()
             items += batch
 
             if len(batch) < page_size: