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

Fixes CW-1120

Register new org option `sentry:default_automated_run_stopping_point`
and wire all org-level Seer defaults (stopping point, coding agent,
auto_open_prs) into both project creation and the existing-org migration
task.

Project creation and the org migration task to new seat-based pricing
now:
- Read the org's `defaultAutomatedRunStoppingPoint` and
`defaultCodingAgent` and `defaultCodingAgentIntegrationId`
- For external agents, configure automation_handoff with
`auto_create_pr` from `auto_open_prs`
- For Seer agent, `auto_open_prs=true` forces `open_pr`;
`auto_open_prs=false` caps `open_pr` down to `code_changes`
- Also adds ChoiceField validation for `defaultCodingAgent` (with alias
mapping for cursor → cursor_background_agent, claude_code →
claude_code_agent) and `defaultAutomatedRunStoppingPoint`.

---------

Co-authored-by: Claude Sonnet 4 <noreply@anthropic.com>

Author: 2 people

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

@@ -58,6 +58,7 @@
     ROLLBACK_ENABLED_DEFAULT,
     SAMPLING_MODE_DEFAULT,
     SCRAPE_JAVASCRIPT_DEFAULT,
+    SEER_AUTOMATED_RUN_STOPPING_POINT_DEFAULT,
     SEER_DEFAULT_CODING_AGENT_DEFAULT,
     TARGET_SAMPLE_RATE_DEFAULT,
     ObjectStatus,
@@ -558,8 +559,9 @@ class DetailedOrganizationSerializerResponse(_DetailedOrganizationSerializerResp
     defaultSeerScannerAutomation: bool
     enableSeerEnhancedAlerts: bool
     enableSeerCoding: bool
-    defaultCodingAgent: str | None
+    defaultCodingAgent: str
     defaultCodingAgentIntegrationId: int | None
+    defaultAutomatedRunStoppingPoint: str
     autoEnableCodeReview: bool
     autoOpenPrs: bool
     defaultCodeReviewTriggers: list[str]
@@ -734,12 +736,14 @@ def serialize(  # type: ignore[override]
                 )
             ),
             "defaultCodingAgent": obj.get_option(
-                "sentry:seer_default_coding_agent",
-                SEER_DEFAULT_CODING_AGENT_DEFAULT,
+                "sentry:seer_default_coding_agent", SEER_DEFAULT_CODING_AGENT_DEFAULT
             ),
             "defaultCodingAgentIntegrationId": obj.get_option(
-                "sentry:seer_default_coding_agent_integration_id",
-                None,
+                "sentry:seer_default_coding_agent_integration_id", None
+            ),
+            "defaultAutomatedRunStoppingPoint": obj.get_option(
+                "sentry:default_automated_run_stopping_point",
+                SEER_AUTOMATED_RUN_STOPPING_POINT_DEFAULT,
             ),
             "autoOpenPrs": bool(
                 obj.get_option(

src/sentry/apidocs/examples/organization_examples.py

@@ -304,8 +304,9 @@ class OrganizationExamples:
                 "enableSeerCoding": True,
                 "enableSeerEnhancedAlerts": True,
                 "autoOpenPrs": False,
-                "defaultCodingAgent": None,
+                "defaultCodingAgent": "seer",
                 "defaultCodingAgentIntegrationId": None,
+                "defaultAutomatedRunStoppingPoint": "code_changes",
                 "issueAlertsThreadFlag": True,
                 "metricAlertsThreadFlag": True,
                 "trustedRelays": [],

src/sentry/core/endpoints/organization_details.py

@@ -68,6 +68,7 @@
     ROLLBACK_ENABLED_DEFAULT,
     SAMPLING_MODE_DEFAULT,
     SCRAPE_JAVASCRIPT_DEFAULT,
+    SEER_AUTOMATED_RUN_STOPPING_POINT_DEFAULT,
     SEER_DEFAULT_CODING_AGENT_DEFAULT,
     TARGET_SAMPLE_RATE_DEFAULT,
     ObjectStatus,
@@ -254,12 +255,17 @@
         None,
     ),
     (
-        # Informs UI default for automated_run_stopping_point in project preferences
         "autoOpenPrs",
         "sentry:auto_open_prs",
         bool,
         AUTO_OPEN_PRS_DEFAULT,
     ),
+    (
+        "defaultAutomatedRunStoppingPoint",
+        "sentry:default_automated_run_stopping_point",
+        str,
+        SEER_AUTOMATED_RUN_STOPPING_POINT_DEFAULT,
+    ),
     (
         "autoEnableCodeReview",
         "sentry:auto_enable_code_review",
@@ -371,8 +377,15 @@ 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=["code_changes", "open_pr"], required=False
+    )
     autoOpenPrs = serializers.BooleanField(required=False)
     autoEnableCodeReview = serializers.BooleanField(required=False)
     defaultCodeReviewTriggers = serializers.ListField(
@@ -401,6 +414,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:
+        if value is None:
+            return SEER_DEFAULT_CODING_AGENT_DEFAULT
+        coding_agent_aliases: dict[str, str] = {
+            "cursor": "cursor_background_agent",
+            "claude_code": "claude_code_agent",
+        }
+        return coding_agent_aliases.get(value, value)
+
     def validate_defaultCodingAgentIntegrationId(self, value: int | None) -> int | None:
         if value is None:
             return None

src/sentry/core/endpoints/team_projects.py

@@ -31,8 +31,8 @@
 from sentry.models.team import Team
 from sentry.seer.similarity.utils import (
     project_is_seer_eligible,
-    set_default_project_auto_open_prs,
     set_default_project_autofix_automation_tuning,
+    set_default_project_seer_preferences,
     set_default_project_seer_scanner_automation,
 )
 from sentry.signals import project_created
@@ -56,7 +56,7 @@ def apply_default_project_settings(organization: Organization, project: Project)
 
     set_default_project_autofix_automation_tuning(organization, project)
     set_default_project_seer_scanner_automation(organization, project)
-    set_default_project_auto_open_prs(organization, project)
+    set_default_project_seer_preferences(organization, project)
 
 
 class ProjectPostSerializer(serializers.Serializer):

src/sentry/seer/autofix/utils.py

@@ -15,6 +15,7 @@
 
 from sentry import features, options, ratelimits
 from sentry.constants import (
+    AUTO_OPEN_PRS_DEFAULT,
     SEER_AUTOMATED_RUN_STOPPING_POINT_DEFAULT,
     DataCategory,
     ObjectStatus,
@@ -42,6 +43,10 @@
     SeerProjectRepository,
     SeerProjectRepositoryBranchOverride,
 )
+from sentry.seer.models.seer_api_models import (
+    AutofixHandoffPoint,
+    SeerAutomationHandoffConfiguration,
+)
 from sentry.seer.signed_seer_api import SeerViewerContext, make_signed_seer_api_request
 from sentry.utils.cache import cache
 from sentry.utils.outcomes import Outcome, track_outcome
@@ -384,14 +389,47 @@ def validate(self, data):
 
 
 def default_seer_project_preference(project: Project) -> SeerProjectPreference:
+    stopping_point, handoff = get_org_default_seer_automation_handoff(project.organization)
     return SeerProjectPreference(
         organization_id=project.organization.id,
         project_id=project.id,
         repositories=[],
-        automated_run_stopping_point=AutofixStoppingPoint.CODE_CHANGES.value,
-        automation_handoff=None,
+        automated_run_stopping_point=stopping_point,
+        automation_handoff=handoff,
+    )
+
+
+def get_org_default_seer_automation_handoff(
+    organization: Organization,
+) -> tuple[str, SeerAutomationHandoffConfiguration | None]:
+    """Get the default stopping point and automation handoff for an organization."""
+    stopping_point = organization.get_option(
+        "sentry:default_automated_run_stopping_point", SEER_AUTOMATED_RUN_STOPPING_POINT_DEFAULT
     )
 
+    auto_open_prs = organization.get_option("sentry:auto_open_prs", AUTO_OPEN_PRS_DEFAULT)
+
+    automation_handoff: SeerAutomationHandoffConfiguration | None = None
+    coding_agent = organization.get_option("sentry:seer_default_coding_agent")
+    coding_agent_integration_id = organization.get_option(
+        "sentry:seer_default_coding_agent_integration_id"
+    )
+    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,
+        )
+    # If Seer agent and auto open PRs, we can run up to open_pr.
+    elif auto_open_prs:
+        stopping_point = "open_pr"
+    # If Seer agent and no auto open PRs, we shouldn't go past code_changes.
+    elif stopping_point == "open_pr":
+        stopping_point = "code_changes"
+
+    return stopping_point, automation_handoff
+
 
 def get_project_seer_preferences(project_id: int) -> SeerRawPreferenceResponse:
     """

src/sentry/seer/similarity/utils.py

@@ -9,7 +9,9 @@
 from tokenizers import Tokenizer
 
 from sentry import features, options
-from sentry.constants import DATA_ROOT
+from sentry.constants import (
+    DATA_ROOT,
+)
 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
@@ -18,12 +20,14 @@
 from sentry.models.project import Project
 from sentry.seer.autofix.constants import AutofixAutomationTuningSettings
 from sentry.seer.autofix.utils import (
-    AutofixStoppingPoint,
+    get_org_default_seer_automation_handoff,
     is_seer_seat_based_tier_enabled,
     set_project_seer_preference,
     write_preference_to_sentry_db,
 )
-from sentry.seer.models import SeerProjectPreference
+from sentry.seer.models import (
+    SeerProjectPreference,
+)
 from sentry.seer.similarity.types import GroupingVersion
 from sentry.services.eventstore.models import Event, GroupEvent
 from sentry.utils import metrics
@@ -563,22 +567,24 @@ def set_default_project_seer_scanner_automation(
             project.update_option("sentry:seer_scanner_automation", org_default)
 
 
-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."""
+def set_default_project_seer_preferences(organization: Organization, project: Project) -> None:
+    """Called once at project creation time to set the initial automated run stopping
+    point and automation handoff.
+    """
     if not is_seer_seat_based_tier_enabled(organization):
         return
 
-    stopping_point = AutofixStoppingPoint.CODE_CHANGES
-    if organization.get_option("sentry:auto_open_prs"):
-        stopping_point = AutofixStoppingPoint.OPEN_PR
+    stopping_point, automation_handoff = get_org_default_seer_automation_handoff(organization)
 
     # 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

@@ -8,7 +8,9 @@
 
 from sentry import analytics, features
 from sentry.analytics.events.autofix_automation_events import AiAutofixAutomationEvent
-from sentry.constants import ObjectStatus
+from sentry.constants import (
+    ObjectStatus,
+)
 from sentry.models.group import Group
 from sentry.models.organization import Organization
 from sentry.models.project import Project
@@ -24,6 +26,7 @@
     deduplicate_repositories,
     get_autofix_repos_from_project_code_mappings,
     get_autofix_state,
+    get_org_default_seer_automation_handoff,
     get_seer_seat_based_tier_cache_key,
     resolve_repository_ids,
 )
@@ -238,34 +241,49 @@ def configure_seer_for_existing_org(organization_id: int) -> None:
                 "sentry:autofix_automation_tuning", AutofixAutomationTuningSettings.MEDIUM
             )
 
+    default_stopping_point, default_handoff = get_org_default_seer_automation_handoff(organization)
+    default_handoff_dict = default_handoff.dict() if default_handoff else None
+
+    valid_stopping_points = {"open_pr", "code_changes"}
+
     preferences_by_id = bulk_get_project_preferences(organization_id, project_ids)
 
     # Determine which projects need updates
     preferences_to_set = []
     projects_by_id = {p.id: p for p in projects}
     for project_id in project_ids:
+        stopping_point = default_stopping_point
+        handoff = default_handoff_dict
+
         existing_pref = preferences_by_id.get(str(project_id))
         if not existing_pref:
             # No existing preferences, get repositories from code mappings
             repositories = get_autofix_repos_from_project_code_mappings(projects_by_id[project_id])
         else:
-            # Skip projects that already have an acceptable stopping point configured
-            if existing_pref.get("automated_run_stopping_point") in ("open_pr", "code_changes"):
-                continue
             repositories = existing_pref.get("repositories") or []
 
-        repositories = deduplicate_repositories(repositories)
+            existing_stopping_point = existing_pref.get("automated_run_stopping_point")
+            existing_handoff = existing_pref.get("automation_handoff")
+
+            # Skip projects that a) already have an acceptable stopping point configured
+            # AND b) already have a handoff configured or no org default handoff.
+            if existing_stopping_point in valid_stopping_points and (
+                existing_handoff or default_handoff_dict is None
+            ):
+                continue
+
+            if existing_stopping_point in valid_stopping_points:
+                stopping_point = existing_stopping_point
+            if existing_handoff:
+                handoff = existing_handoff
 
-        # Preserve existing repositories and automation_handoff, only update the stopping point
         preferences_to_set.append(
             {
                 "organization_id": organization_id,
                 "project_id": project_id,
-                "repositories": repositories or [],
-                "automated_run_stopping_point": "code_changes",
-                "automation_handoff": (
-                    existing_pref.get("automation_handoff") if existing_pref else None
-                ),
+                "repositories": deduplicate_repositories(repositories) or [],
+                "automated_run_stopping_point": stopping_point,
+                "automation_handoff": handoff,
             }
         )