feat(seer): Add Seer project connected repo endpoint

src/sentry/api/urls.py

@@ -542,6 +542,9 @@
     OrganizationSeerAgentUpdateEndpoint,
 )
 from sentry.seer.endpoints.organization_seer_onboarding_check import OrganizationSeerOnboardingCheck
+from sentry.seer.endpoints.organization_seer_project_repos import (
+    OrganizationSeerProjectRepoDetailsEndpoint,
+)
 from sentry.seer.endpoints.organization_seer_rpc import OrganizationSeerRpcEndpoint
 from sentry.seer.endpoints.organization_seer_setup_check import OrganizationSeerSetupCheckEndpoint
 from sentry.seer.endpoints.organization_seer_workflows import OrganizationSeerWorkflowsEndpoint
@@ -2449,6 +2452,11 @@ def create_group_urls(name_prefix: str) -> list[URLPattern | URLResolver]:
         OrganizationSeerOnboardingCheck.as_view(),
         name="sentry-api-0-organization-seer-onboarding-check",
     ),
+    re_path(
+        r"^(?P<organization_id_or_slug>[^/]+)/seer/projects/(?P<project_id>\d+)/repos/(?P<repo_id>\d+)/$",
+        OrganizationSeerProjectRepoDetailsEndpoint.as_view(),
+        name="sentry-api-0-organization-seer-project-repo-details",
+    ),
     re_path(
         r"^(?P<organization_id_or_slug>[^/]+)/autofix/automation-settings/$",
         OrganizationAutofixAutomationSettingsEndpoint.as_view(),

src/sentry/seer/endpoints/organization_seer_project_repos.py

@@ -0,0 +1,190 @@
+from __future__ import annotations
+
+from typing import TypedDict
+
+from django.db import router, transaction
+from rest_framework import serializers
+from rest_framework.request import Request
+from rest_framework.response import Response
+
+from sentry.api.api_owners import ApiOwner
+from sentry.api.api_publish_status import ApiPublishStatus
+from sentry.api.base import cell_silo_endpoint
+from sentry.api.bases.organization import OrganizationEndpoint, OrganizationPermission
+from sentry.api.serializers.rest_framework import CamelSnakeSerializer
+from sentry.constants import ObjectStatus
+from sentry.models.organization import Organization
+from sentry.models.project import Project
+from sentry.seer.autofix.utils import replace_all_branch_overrides
+from sentry.seer.models.project_repository import SeerProjectRepository
+from sentry.seer.seer_setup import get_supported_scm_providers
+
+
+class BranchOverrideResponse(TypedDict):
+    id: str
+    tagName: str
+    tagValue: str
+    branchName: str
+
+
+class ProjectRepoResponse(TypedDict):
+    id: str
+    repositoryId: str
+    organizationId: str
+    provider: str
+    owner: str
+    name: str
+    externalId: str
+    integrationId: str | None
+    branchName: str | None
+    branchOverrides: list[BranchOverrideResponse]
+    instructions: str | None
+
+
+def _serialize_project_repo(project_repo: SeerProjectRepository) -> ProjectRepoResponse:
+    repo = project_repo.project_repository.repository
+    name_parts = repo.name.split("/", 1)
+    owner = name_parts[0] if len(name_parts) > 1 else ""
+    name = name_parts[1] if len(name_parts) > 1 else repo.name
+
+    return ProjectRepoResponse(
+        id=str(project_repo.id),
+        repositoryId=str(repo.id),
+        organizationId=str(repo.organization_id),
+        provider=repo.provider or "",
+        owner=owner,
+        name=name,
+        externalId=repo.external_id or "",
+        integrationId=str(repo.integration_id) if repo.integration_id is not None else None,
+        branchName=project_repo.branch_name,
+        branchOverrides=[
+            BranchOverrideResponse(
+                id=str(bo.id),
+                tagName=bo.tag_name,
+                tagValue=bo.tag_value,
+                branchName=bo.branch_name,
+            )
+            for bo in project_repo.branch_overrides.all()
+        ],
+        instructions=project_repo.instructions,
+    )
+
+
+def _valid_project_repos_queryset(project: Project, organization: Organization):
+    """Get a project's base SeerProjectRepository queryset for active repos with providers supported by Seer."""
+    return SeerProjectRepository.objects.filter(
+        project_repository__project=project,
+        project_repository__repository__status=ObjectStatus.ACTIVE,
+        project_repository__repository__provider__in=get_supported_scm_providers(organization),
+    ).select_related("project_repository", "project_repository__repository")
+
+
+def _validate_branch_overrides(value):
+    if not value:
+        return value
+    seen: set[tuple[str, str]] = set()
+    for override in value:
+        key = (override["tag_name"], override["tag_value"])
+        if key in seen:
+            raise serializers.ValidationError(
+                f"Duplicate branch override for tag {key[0]}={key[1]}"
+            )
+        seen.add(key)
+    return value
+
+
+class BranchOverrideSerializer(CamelSnakeSerializer):
+    tag_name = serializers.CharField(required=True)
+    tag_value = serializers.CharField(required=True)
+    branch_name = serializers.CharField(required=True)
+
+
+class SeerProjectRepoUpdateSerializer(CamelSnakeSerializer):
+    branch_name = serializers.CharField(required=False, allow_null=True, allow_blank=True)
+    instructions = serializers.CharField(required=False, allow_null=True, allow_blank=True)
+    branch_overrides = BranchOverrideSerializer(many=True, required=False, allow_null=False)
+
+    def validate_branch_overrides(self, value):
+        return _validate_branch_overrides(value)
+
+    def validate(self, data):
+        if not data:
+            raise serializers.ValidationError("At least one field must be provided.")
+        return data
+
+
+@cell_silo_endpoint
+class OrganizationSeerProjectRepoDetailsEndpoint(OrganizationEndpoint):
+    owner = ApiOwner.ML_AI
+    publish_status = {
+        "GET": ApiPublishStatus.EXPERIMENTAL,
+        "PUT": ApiPublishStatus.EXPERIMENTAL,
+        "DELETE": ApiPublishStatus.EXPERIMENTAL,
+    }
+    permission_classes = (OrganizationPermission,)
+
+    def get(
+        self, request: Request, organization: Organization, project_id: int, repo_id: int
+    ) -> Response:
+        project = self.get_projects(request, organization, project_ids={int(project_id)})[0]
+
+        project_repo = (
+            _valid_project_repos_queryset(project, organization)
+            .prefetch_related("branch_overrides")
+            .filter(project_repository__repository_id=repo_id)
+            .first()
+        )
+        if project_repo is None:
+            return Response(status=404)
+
+        return Response(_serialize_project_repo(project_repo))
+
+    def put(
+        self, request: Request, organization: Organization, project_id: int, repo_id: int
+    ) -> Response:
+        project = self.get_projects(request, organization, project_ids={int(project_id)})[0]
+
+        serializer = SeerProjectRepoUpdateSerializer(data=request.data)
+        if not serializer.is_valid():
+            return Response(serializer.errors, status=400)
+
+        data = serializer.validated_data
+
+        with transaction.atomic(router.db_for_write(SeerProjectRepository)):
+            project_repo = (
+                _valid_project_repos_queryset(project, organization)
+                .select_for_update()
+                .filter(project_repository__repository_id=repo_id)
+                .first()
+            )
+            if project_repo is None:
+                return Response(status=404)
+
+            if "branch_name" in data:
+                project_repo.branch_name = data["branch_name"]
+            if "instructions" in data:
+                project_repo.instructions = data["instructions"]
+            if "branch_name" in data or "instructions" in data:
+                project_repo.save()
+
+            if "branch_overrides" in data:
+                replace_all_branch_overrides(project_repo, data["branch_overrides"])
+
+        return Response(_serialize_project_repo(project_repo))
+
+    def delete(
+        self, request: Request, organization: Organization, project_id: int, repo_id: int
+    ) -> Response:
+        project = self.get_projects(request, organization, project_ids={int(project_id)})[0]
+
+        with transaction.atomic(router.db_for_write(SeerProjectRepository)):
+            deleted_count, _ = (
+                _valid_project_repos_queryset(project, organization)
+                .filter(project_repository__repository_id=repo_id)
+                .delete()
+            )
+
+        if deleted_count == 0:
+            return Response(status=404)
+
+        return Response(status=204)

static/app/utils/api/knownSentryApiUrls.generated.ts

@@ -559,6 +559,7 @@ export type KnownSentryApiUrls =
   | '/organizations/$organizationIdOrSlug/seer/explorer-update/$runId/'
   | '/organizations/$organizationIdOrSlug/seer/onboarding-check/'
   | '/organizations/$organizationIdOrSlug/seer/projects/'
+  | '/organizations/$organizationIdOrSlug/seer/projects/$projectId/repos/$repoId/'
   | '/organizations/$organizationIdOrSlug/seer/setup-check/'
   | '/organizations/$organizationIdOrSlug/seer/supergroups/$supergroupId/'
   | '/organizations/$organizationIdOrSlug/seer/supergroups/by-group/'