feat(jira): add Jira Server/DC compatibility with API v2

The implementation now supports both Jira Cloud and Server/Data Center:

- Cloud (API v3): GET /rest/api/3/search/jql with cursor-based pagination
- Server/DC (API v2): POST /rest/api/2/search with offset-based pagination

The API version is auto-detected from the URL (atlassian.net = Cloud).

Added tests for Server/DC path including pagination.

Author: amargiovanni

src/github_analyzer/api/jira_client.py

@@ -366,24 +366,42 @@ def search_issues(
         date_str = since_date.strftime("%Y-%m-%d")
         jql = f"project in ({projects_jql}) AND updated >= '{date_str}' ORDER BY updated DESC"
 
-        # Use new /search/jql endpoint with cursor-based pagination
-        # See: https://developer.atlassian.com/changelog/#CHANGE-2046
+        # Use different endpoint/pagination based on API version
+        # - Cloud (v3): GET /search/jql with cursor-based pagination (nextPageToken)
+        # - Server/DC (v2): POST /search with offset-based pagination (startAt/total)
+        if self.api_version == "3":
+            yield from self._search_issues_cloud(jql)
+        else:
+            yield from self._search_issues_server(jql)
+
+    def _search_issues_cloud(self, jql: str) -> Iterator[JiraIssue]:
+        """Search issues using Jira Cloud API (v3).
+
+        Uses GET /rest/api/3/search/jql with cursor-based pagination.
+        See: https://developer.atlassian.com/changelog/#CHANGE-2046
+
+        Args:
+            jql: JQL query string.
+
+        Yields:
+            JiraIssue objects matching the criteria.
+        """
         max_results = 100
         next_page_token: str | None = None
 
         while True:
             params: dict[str, Any] = {
                 "jql": jql,
                 "maxResults": max_results,
-                "fields": "*all,-comment",  # All fields except comments (fetched separately)
+                "fields": "*all,-comment",
             }
 
             if next_page_token:
                 params["nextPageToken"] = next_page_token
 
             response = self._make_request(
                 "GET",
-                f"/rest/api/{self.api_version}/search/jql",
+                "/rest/api/3/search/jql",
                 params=params,
             )
 
@@ -398,6 +416,47 @@ def search_issues(
 
             next_page_token = response.get("nextPageToken")
 
+    def _search_issues_server(self, jql: str) -> Iterator[JiraIssue]:
+        """Search issues using Jira Server/Data Center API (v2).
+
+        Uses POST /rest/api/2/search with offset-based pagination.
+
+        Args:
+            jql: JQL query string.
+
+        Yields:
+            JiraIssue objects matching the criteria.
+        """
+        max_results = 100
+        start_at = 0
+
+        while True:
+            # Server API uses POST with JSON body
+            body = {
+                "jql": jql,
+                "startAt": start_at,
+                "maxResults": max_results,
+                "fields": ["*all", "-comment"],
+            }
+
+            response = self._make_request(
+                "POST",
+                "/rest/api/2/search",
+                data=body,
+            )
+
+            issues = response.get("issues", [])
+
+            for issue_data in issues:
+                yield self._parse_issue(issue_data)
+
+            # Check if more pages (offset-based pagination)
+            total = response.get("total", 0)
+            start_at += len(issues)
+
+            if start_at >= total or not issues:
+                break
+
     def _parse_issue(self, data: dict[str, Any]) -> JiraIssue:
         """Parse API response into JiraIssue.
 

tests/unit/api/test_jira_client.py

@@ -288,6 +288,79 @@ def test_search_issues_empty_project_keys(self, jira_config: JiraConfig) -> None
         assert issues == []
         mock_request.assert_not_called()
 
+    def test_search_issues_server_uses_post_search(self) -> None:
+        """search_issues uses POST /rest/api/2/search for Server/DC."""
+        from src.github_analyzer.api.jira_client import JiraClient, JiraIssue
+
+        # Server/DC config (non-atlassian.net URL)
+        server_config = JiraConfig(
+            jira_url="https://jira.company.com",
+            jira_email="test@company.com",
+            jira_api_token="test-token",
+        )
+        client = JiraClient(server_config)
+        assert client.api_version == "2"  # Verify it's detected as Server
+
+        since_date = datetime(2025, 11, 1, tzinfo=timezone.utc)
+
+        # Server API response format (offset-based pagination)
+        server_response = {
+            "startAt": 0,
+            "maxResults": 100,
+            "total": 2,
+            "issues": ISSUE_SEARCH_RESPONSE_PAGE_1["issues"],
+        }
+
+        with mock.patch.object(client, "_make_request") as mock_request:
+            mock_request.return_value = server_response
+            issues = list(client.search_issues(["PROJ"], since_date))
+
+        assert len(issues) == 2
+        assert all(isinstance(i, JiraIssue) for i in issues)
+
+        # Verify POST was used with correct endpoint
+        mock_request.assert_called_once()
+        call_args = mock_request.call_args
+        assert call_args[0][0] == "POST"  # HTTP method
+        assert call_args[0][1] == "/rest/api/2/search"  # Endpoint
+
+    def test_search_issues_server_pagination(self) -> None:
+        """search_issues handles offset-based pagination for Server/DC."""
+        from src.github_analyzer.api.jira_client import JiraClient
+
+        server_config = JiraConfig(
+            jira_url="https://jira.company.com",
+            jira_email="test@company.com",
+            jira_api_token="test-token",
+        )
+        client = JiraClient(server_config)
+
+        since_date = datetime(2025, 11, 1, tzinfo=timezone.utc)
+
+        # Page 1: more pages available (startAt + len(issues) < total)
+        page_1 = {
+            "startAt": 0,
+            "maxResults": 2,
+            "total": 3,
+            "issues": ISSUE_SEARCH_RESPONSE_PAGE_1["issues"],  # 2 issues
+        }
+
+        # Page 2: last page
+        page_2 = {
+            "startAt": 2,
+            "maxResults": 2,
+            "total": 3,
+            "issues": ISSUE_SEARCH_RESPONSE_PAGE_2["issues"],  # 1 issue
+        }
+
+        with mock.patch.object(client, "_make_request") as mock_request:
+            mock_request.side_effect = [page_1, page_2]
+            issues = list(client.search_issues(["PROJ"], since_date))
+
+        # 2 from page 1 + 1 from page 2
+        assert len(issues) == 3
+        assert mock_request.call_count == 2
+
 
 class TestJiraClientGetComments:
     """Tests for get_comments() method."""