GRM-33: feat: add mandatory PR review step to workflow

src/gitea_runner_manager/api_clients.py

@@ -126,6 +126,37 @@ class GiteaClient:
         r = self._request("GET", f"/pulls/{pr_number}")
         return r.json()
 
+    def get_pr_files(self, pr_number: str | int) -> list[dict[str, Any]]:
+        """Fetch the list of files changed in a pull request."""
+        r = self._request("GET", f"/pulls/{pr_number}/files")
+        return r.json()
+
+    def get_pr_commits(self, pr_number: str | int) -> list[dict[str, Any]]:
+        """Fetch the commits included in a pull request."""
+        r = self._request("GET", f"/pulls/{pr_number}/commits")
+        return r.json()
+
+    def create_review(
+        self,
+        pr_number: str | int,
+        event: str = "COMMENT",
+        body: str = "",
+        comments: list[dict[str, Any]] | None = None,
+    ) -> dict[str, Any]:
+        """Post a review on a pull request.
+
+        Args:
+            event: ``APPROVE``, ``REQUEST_CHANGES``, or ``COMMENT``.
+            body: Top-level review body text.
+            comments: Line-level comments with ``path``, ``body``,
+                      ``new_position`` (and optionally ``old_position``).
+        """
+        payload: dict[str, Any] = {"event": event, "body": body}
+        if comments:
+            payload["comments"] = comments
+        r = self._request("POST", f"/pulls/{pr_number}/reviews", json=payload)
+        return r.json()
+
     def create_release(
         self,
         tag: str,
@@ -167,6 +198,11 @@ class VikunjaClient:
         r = self._request("GET", "/tasks", params=params)
         return r.json()
 
+    def get_task(self, task_id: int) -> dict[str, Any]:
+        """Fetch a single task by its numeric ID."""
+        r = self._request("GET", f"/tasks/{task_id}")
+        return r.json()
+
     def list_project_tasks(self, project_id: int, **params: Any) -> list[dict[str, Any]]:
         """List tasks in a specific project (more efficient than listing all tasks)."""
         r = self._request("GET", f"/projects/{project_id}/tasks", params=params)