feat(seer): Add org-level default stopping point and wire coding agent defaults into project creation

Register new org option `sentry:default_stopping_point` and wire all
org-level Seer defaults (stopping point, coding agent, auto_open_prs)
into project creation and existing-org migration. When auto_open_prs
is true, stopping point is forced to open_pr. External agents
(Cursor/Claude) now get automation_handoff set on new projects.

Also adds input validation for defaultCodingAgent with alias mapping
(cursor -> cursor_background_agent, claude_code -> claude_code_agent)
and ChoiceField validation for defaultAutomatedRunStoppingPoint.

Co-Authored-By: Claude Sonnet 4 <noreply@anthropic.com>
Made-with: Cursor

Author: srest2021

src/sentry/api/serializers/models/organization.py

@@ -58,6 +58,7 @@
     ROLLBACK_ENABLED_DEFAULT,
     SAMPLING_MODE_DEFAULT,
     SCRAPE_JAVASCRIPT_DEFAULT,
+    SEER_DEFAULT_AUTOMATED_RUN_STOPPING_POINT_DEFAULT,
     SEER_DEFAULT_CODING_AGENT_DEFAULT,
     TARGET_SAMPLE_RATE_DEFAULT,
     ObjectStatus,
@@ -560,6 +561,7 @@ class DetailedOrganizationSerializerResponse(_DetailedOrganizationSerializerResp
     enableSeerCoding: bool
     defaultCodingAgent: str | None
     defaultCodingAgentIntegrationId: int | None
+    defaultAutomatedRunStoppingPoint: str
     autoEnableCodeReview: bool
     autoOpenPrs: bool
     defaultCodeReviewTriggers: list[str]
@@ -741,6 +743,10 @@ def serialize(  # type: ignore[override]
                 "sentry:seer_default_coding_agent_integration_id",
                 None,
             ),
+            "defaultAutomatedRunStoppingPoint": obj.get_option(
+                "sentry:default_automated_run_stopping_point",
+                SEER_DEFAULT_AUTOMATED_RUN_STOPPING_POINT_DEFAULT,
+            ),
             "autoOpenPrs": bool(
                 obj.get_option(
                     "sentry:auto_open_prs",

src/sentry/apidocs/examples/organization_examples.py

@@ -306,6 +306,7 @@ class OrganizationExamples:
                 "autoOpenPrs": False,
                 "defaultCodingAgent": None,
                 "defaultCodingAgentIntegrationId": None,
+                "defaultAutomatedRunStoppingPoint": "open_pr",
                 "issueAlertsThreadFlag": True,
                 "metricAlertsThreadFlag": True,
                 "trustedRelays": [],

src/sentry/constants.py

@@ -730,6 +730,7 @@ class InsightModules(Enum):
     "on_new_commit",
 ]
 SEER_DEFAULT_CODING_AGENT_DEFAULT = "seer"
+SEER_DEFAULT_AUTOMATED_RUN_STOPPING_POINT_DEFAULT = "code_changes"
 SEER_AUTOMATED_RUN_STOPPING_POINT_DEFAULT = "code_changes"
 ENABLED_CONSOLE_PLATFORMS_DEFAULT: list[str] = []
 CONSOLE_SDK_INVITE_QUOTA_DEFAULT = 0

src/sentry/core/endpoints/organization_details.py

@@ -68,6 +68,7 @@
     ROLLBACK_ENABLED_DEFAULT,
     SAMPLING_MODE_DEFAULT,
     SCRAPE_JAVASCRIPT_DEFAULT,
+    SEER_DEFAULT_AUTOMATED_RUN_STOPPING_POINT_DEFAULT,
     SEER_DEFAULT_CODING_AGENT_DEFAULT,
     TARGET_SAMPLE_RATE_DEFAULT,
     ObjectStatus,
@@ -260,6 +261,12 @@
         bool,
         AUTO_OPEN_PRS_DEFAULT,
     ),
+    (
+        "defaultAutomatedRunStoppingPoint",
+        "sentry:default_automated_run_stopping_point",
+        str,
+        SEER_DEFAULT_AUTOMATED_RUN_STOPPING_POINT_DEFAULT,
+    ),
     (
         "autoEnableCodeReview",
         "sentry:auto_enable_code_review",
@@ -371,8 +378,16 @@ class OrganizationSerializer(BaseOrganizationSerializer):
     dashboardsAsyncQueueParallelLimit = serializers.IntegerField(required=False, min_value=1)
     enableSeerEnhancedAlerts = serializers.BooleanField(required=False)
     enableSeerCoding = serializers.BooleanField(required=False)
-    defaultCodingAgent = serializers.CharField(required=False, allow_null=True)
+    defaultCodingAgent = serializers.ChoiceField(
+        choices=["seer", "cursor", "claude_code", "cursor_background_agent", "claude_code_agent"],
+        required=False,
+        allow_null=True,
+    )
     defaultCodingAgentIntegrationId = serializers.IntegerField(required=False, allow_null=True)
+    defaultAutomatedRunStoppingPoint = serializers.ChoiceField(
+        choices=["root_cause", "solution", "code_changes", "open_pr"],
+        required=False,
+    )
     autoOpenPrs = serializers.BooleanField(required=False)
     autoEnableCodeReview = serializers.BooleanField(required=False)
     defaultCodeReviewTriggers = serializers.ListField(
@@ -401,6 +416,15 @@ def validate_relayPiiConfig(self, value):
         organization = self.context["organization"]
         return validate_pii_config_update(organization, value)
 
+    def validate_defaultCodingAgent(self, value: str | None) -> str:
+        coding_agent_aliases: dict[str, str] = {
+            "cursor": "cursor_background_agent",
+            "claude_code": "claude_code_agent",
+        }
+        if value is None:
+            return SEER_DEFAULT_CODING_AGENT_DEFAULT
+        return coding_agent_aliases.get(value, value)
+
     def validate_defaultCodingAgentIntegrationId(self, value: int | None) -> int | None:
         if value is None:
             return None

src/sentry/seer/similarity/utils.py

@@ -9,7 +9,12 @@
 from tokenizers import Tokenizer
 
 from sentry import features, options
-from sentry.constants import DATA_ROOT
+from sentry.constants import (
+    AUTO_OPEN_PRS_DEFAULT,
+    DATA_ROOT,
+    SEER_DEFAULT_AUTOMATED_RUN_STOPPING_POINT_DEFAULT,
+    SEER_DEFAULT_CODING_AGENT_DEFAULT,
+)
 from sentry.grouping.api import get_contributing_variant_and_component
 from sentry.grouping.grouping_info import get_grouping_info_from_variants_legacy
 from sentry.grouping.variants import BaseVariant
@@ -23,7 +28,11 @@
     set_project_seer_preference,
     write_preference_to_sentry_db,
 )
-from sentry.seer.models import SeerProjectPreference
+from sentry.seer.models import (
+    AutofixHandoffPoint,
+    SeerAutomationHandoffConfiguration,
+    SeerProjectPreference,
+)
 from sentry.seer.similarity.types import GroupingVersion
 from sentry.services.eventstore.models import Event, GroupEvent
 from sentry.utils import metrics
@@ -564,21 +573,51 @@ def set_default_project_seer_scanner_automation(
 
 
 def set_default_project_auto_open_prs(organization: Organization, project: Project) -> None:
-    """Called once at project creation time to set the initial auto open PRs."""
+    """Called once at project creation time to set the initial automated run stopping
+    point and automation handoff.
+
+    Reads org options (default_automated_run_stopping_point, auto_open_prs, default_coding_agent,
+    default_coding_agent_integration_id) and writes the corresponding project-level
+    options (stopping point, handoff config).
+
+    When auto_open_prs is True, stopping_point is forced to open_pr regardless of
+    default_stopping_point.
+    """
     if not is_seer_seat_based_tier_enabled(organization):
         return
 
-    stopping_point = AutofixStoppingPoint.CODE_CHANGES
-    if organization.get_option("sentry:auto_open_prs"):
+    auto_open_prs = bool(organization.get_option("sentry:auto_open_prs", AUTO_OPEN_PRS_DEFAULT))
+    if auto_open_prs:
         stopping_point = AutofixStoppingPoint.OPEN_PR
+    else:
+        stopping_point = organization.get_option(
+            "sentry:default_stopping_point", SEER_DEFAULT_AUTOMATED_RUN_STOPPING_POINT_DEFAULT
+        )
+
+    coding_agent = organization.get_option(
+        "sentry:seer_default_coding_agent", SEER_DEFAULT_CODING_AGENT_DEFAULT
+    )
+    coding_agent_integration_id = organization.get_option(
+        "sentry:seer_default_coding_agent_integration_id", None
+    )
+
+    automation_handoff: SeerAutomationHandoffConfiguration | None = None
+    if coding_agent and coding_agent != "seer" and coding_agent_integration_id is not None:
+        automation_handoff = SeerAutomationHandoffConfiguration(
+            handoff_point=AutofixHandoffPoint.ROOT_CAUSE,
+            target=coding_agent,
+            integration_id=coding_agent_integration_id,
+            auto_create_pr=auto_open_prs,
+        )
 
-    # We need to make an API call to Seer to set this preference
     preference = SeerProjectPreference(
         organization_id=organization.id,
         project_id=project.id,
         repositories=[],
         automated_run_stopping_point=stopping_point,
+        automation_handoff=automation_handoff,
     )
+
     try:
         set_project_seer_preference(preference)
     except Exception as e:

src/sentry/tasks/seer/autofix.py

@@ -1,5 +1,6 @@
 import logging
 from datetime import datetime, timedelta
+from typing import Any
 
 import sentry_sdk
 from django.utils import timezone
@@ -8,7 +9,12 @@
 
 from sentry import analytics, features
 from sentry.analytics.events.autofix_automation_events import AiAutofixAutomationEvent
-from sentry.constants import ObjectStatus
+from sentry.constants import (
+    AUTO_OPEN_PRS_DEFAULT,
+    SEER_DEFAULT_AUTOMATED_RUN_STOPPING_POINT_DEFAULT,
+    SEER_DEFAULT_CODING_AGENT_DEFAULT,
+    ObjectStatus,
+)
 from sentry.models.group import Group
 from sentry.models.organization import Organization
 from sentry.models.project import Project
@@ -238,6 +244,30 @@ def configure_seer_for_existing_org(organization_id: int) -> None:
                 "sentry:autofix_automation_tuning", AutofixAutomationTuningSettings.MEDIUM
             )
 
+    auto_open_prs = bool(organization.get_option("sentry:auto_open_prs", AUTO_OPEN_PRS_DEFAULT))
+    if auto_open_prs:
+        default_stopping_point = "open_pr"
+    else:
+        default_stopping_point = organization.get_option(
+            "sentry:default_stopping_point", SEER_DEFAULT_AUTOMATED_RUN_STOPPING_POINT_DEFAULT
+        )
+
+    coding_agent = organization.get_option(
+        "sentry:seer_default_coding_agent", SEER_DEFAULT_CODING_AGENT_DEFAULT
+    )
+    coding_agent_integration_id = organization.get_option(
+        "sentry:seer_default_coding_agent_integration_id", None
+    )
+
+    default_handoff: dict[str, Any] | None = None
+    if coding_agent and coding_agent != "seer" and coding_agent_integration_id is not None:
+        default_handoff = {
+            "handoff_point": "root_cause",
+            "target": coding_agent,
+            "integration_id": coding_agent_integration_id,
+            "auto_create_pr": auto_open_prs,
+        }
+
     preferences_by_id = bulk_get_project_preferences(organization_id, project_ids)
 
     # Determine which projects need updates
@@ -262,9 +292,11 @@ def configure_seer_for_existing_org(organization_id: int) -> None:
                 "organization_id": organization_id,
                 "project_id": project_id,
                 "repositories": repositories or [],
-                "automated_run_stopping_point": "code_changes",
+                "automated_run_stopping_point": default_stopping_point,
                 "automation_handoff": (
-                    existing_pref.get("automation_handoff") if existing_pref else None
+                    existing_pref.get("automation_handoff")
+                    if existing_pref and existing_pref.get("automation_handoff")
+                    else default_handoff
                 ),
             }
         )