chore(seer): Settings clarity improvements (#95335)

- updates copy
- lets any project member update automation settings
- update layout to be less overwhelming
- other minor tweaks

<img width="1422" height="881" alt="Screenshot 2025-07-11 at 10 16
03 AM"
src="https://github.com/user-attachments/assets/9a5f6775-2b50-4b6e-a8bc-fac57ac73a6f"
/>
<img width="1423" height="879" alt="Screenshot 2025-07-11 at 10 16
31 AM"
src="https://github.com/user-attachments/assets/576b80a5-e3b7-44a2-b601-9289b67323bf"
/>
<img width="1425" height="871" alt="Screenshot 2025-07-11 at 10 32
40 AM"
src="https://github.com/user-attachments/assets/df0b3817-df91-4007-9acb-d860277ad438"
/>

---------

Co-authored-by: kddubey <kushdubey63@gmail.com>

Author: roaga

static/app/views/settings/projectSeer/autofixRepositories.tsx

@@ -279,7 +279,7 @@ export function AutofixRepositories({project}: ProjectSeerProps) {
         </LoadingContainer>
       ) : filteredSelectedRepositories.length === 0 ? (
         <EmptyMessage>
-          {t('No repositories selected. Click "Add Repos" to get started.')}
+          {t("Seer can't see your code. Click 'Add Repos' to give Seer access.")}
         </EmptyMessage>
       ) : (
         <ReposContainer>
@@ -313,7 +313,7 @@ const ReposContainer = styled('div')`
 
 const EmptyMessage = styled('div')`
   padding: ${space(2)};
-  color: ${p => p.theme.subText};
+  color: ${p => p.theme.errorText};
   text-align: center;
   font-size: ${p => p.theme.fontSize.md};
 `;

static/app/views/settings/projectSeer/constants.ts

@@ -1 +1,44 @@
+import {t} from 'sentry/locale';
+
 export const MAX_REPOS_LIMIT = 8;
+
+export const SEER_THRESHOLD_OPTIONS = [
+  {
+    value: 'off',
+    label: t('Off'),
+    details: t('Seer only runs when you click Start.'),
+  },
+  {
+    value: 'super_low',
+    label: t('Only the Most Actionable Issues'),
+    details: t(
+      'Seer will automatically run on issues that it thinks have an actionability of "super high." This targets around 2% of issues, but may vary by project.'
+    ),
+  },
+  {
+    value: 'low',
+    label: t('Highly Actionable and Above'),
+    details: t(
+      'Seer will automatically run on issues that it thinks have an actionability of "high" or above. This targets around 10% of issues, but may vary by project.'
+    ),
+  },
+  {
+    value: 'medium',
+    label: t('Moderately Actionable and Above'),
+    details: t(
+      'Seer will automatically run on issues that it thinks have an actionability of "medium" or above. This targets around 30% of issues, but may vary by project.'
+    ),
+  },
+  {
+    value: 'high',
+    label: t('Minimally Actionable and Above'),
+    details: t(
+      'Seer will automatically run on issues that it thinks have an actionability of "low" or above. This targets around 70% of issues, but may vary by project.'
+    ),
+  },
+  {
+    value: 'always',
+    label: t('All Issues'),
+    details: t('Seer will automatically run on all new issues.'),
+  },
+] as const;

static/app/views/settings/projectSeer/index.spec.tsx

@@ -271,7 +271,7 @@ describe('ProjectSeer', function () {
   it('can update the autofix autorun threshold setting', async function () {
     const initialProject: Project = {
       ...project,
-      autofixAutomationTuning: 'medium', // Start from medium
+      autofixAutomationTuning: 'high', // Start from high
       seerScannerAutomation: true,
     };
 
@@ -284,33 +284,39 @@ describe('ProjectSeer', function () {
     const projectPutRequest = MockApiClient.addMockResponse({
       url: `/projects/${organization.slug}/${project.slug}/`,
       method: 'PUT',
-      body: {},
+      body: {
+        autofixAutomationTuning: 'high',
+      },
     });
 
     render(<ProjectSeer project={initialProject} />, {organization});
 
     // Find the select menu
     const select = await screen.findByRole('textbox', {
-      name: /Automate Issue Fixes/i,
+      name: /Auto-Triggered Fixes/i,
     });
 
     act(() => {
       select.focus();
     });
 
-    // Open the menu and select a new value (e.g., 'Minimally Actionable and Above')
+    // Open the menu and select a new value
     await userEvent.click(select);
+
     const option = await screen.findByText('Minimally Actionable and Above');
     await userEvent.click(option);
 
+    const option2 = await screen.findByText('Highly Actionable and Above');
+    await userEvent.click(option2);
+
     // Form has saveOnBlur=true, so wait for the PUT request
     await waitFor(() => {
       expect(projectPutRequest).toHaveBeenCalledTimes(1);
     });
     await waitFor(() => {
       expect(projectPutRequest).toHaveBeenCalledWith(
         expect.any(String),
-        expect.objectContaining({data: {autofixAutomationTuning: 'high'}})
+        expect.objectContaining({data: {autofixAutomationTuning: 'low'}})
       );
     });
   });
@@ -337,7 +343,7 @@ describe('ProjectSeer', function () {
 
     // Find the toggle for Automate Issue Scans
     const toggle = await screen.findByRole('checkbox', {
-      name: /Automate Issue Scans/i,
+      name: /Scan Issues/i,
     });
     expect(toggle).toBeInTheDocument();
     expect(toggle).not.toBeChecked();
@@ -383,9 +389,9 @@ describe('ProjectSeer', function () {
 
     render(<ProjectSeer project={initialProject} />, {organization});
 
-    // Find the select menu for Stopping Point for Automatic Fixes
+    // Find the select menu for Stopping Point for Auto-Triggered Fixes
     const select = await screen.findByRole('textbox', {
-      name: /Stopping Point for Automatic Fixes/i,
+      name: /Stopping Point for Auto-Triggered Fixes/i,
     });
 
     act(() => {

static/app/views/settings/projectSeer/index.tsx

@@ -4,7 +4,6 @@ import {useQueryClient} from '@tanstack/react-query';
 
 import {hasEveryAccess} from 'sentry/components/acl/access';
 import FeatureDisabled from 'sentry/components/acl/featureDisabled';
-import {Alert} from 'sentry/components/core/alert';
 import {Link} from 'sentry/components/core/link';
 import {useProjectSeerPreferences} from 'sentry/components/events/autofix/preferences/hooks/useProjectSeerPreferences';
 import {useUpdateProjectSeerPreferences} from 'sentry/components/events/autofix/preferences/hooks/useUpdateProjectSeerPreferences';
@@ -30,6 +29,7 @@ import SettingsPageHeader from 'sentry/views/settings/components/settingsPageHea
 import {ProjectPermissionAlert} from 'sentry/views/settings/project/projectPermissionAlert';
 
 import {AutofixRepositories} from './autofixRepositories';
+import {SEER_THRESHOLD_OPTIONS} from './constants';
 
 const AiSetupDataConsent = HookOrDefault({
   hookName: 'component:ai-setup-data-consent',
@@ -55,63 +55,28 @@ const SeerSelectLabel = styled('div')`
 
 export const seerScannerAutomationField = {
   name: 'seerScannerAutomation',
-  label: t('Automate Issue Scans'),
+  label: t('Scan Issues'),
   help: () =>
     t(
-      'Seer will scan all new issues in your project, helping you focus on the most actionable and quick-to-fix ones, giving more context in Slack alerts, and enabling automatic Issue Fixes.'
+      'Seer will scan all new and ongoing issues in your project, flagging the most actionable issues, giving more context in Slack alerts, and enabling Issue Fixes to be triggered automatically.'
     ),
   type: 'boolean',
   saveOnBlur: true,
 } satisfies FieldObject;
 
 export const autofixAutomatingTuningField = {
   name: 'autofixAutomationTuning',
-  label: t('Automate Issue Fixes'),
+  label: t('Auto-Trigger Fixes'),
   help: () =>
     t(
-      "Seer will automatically find a root cause and solution for incoming issues if it thinks the issue is actionable enough. By default, it won't open PRs without your approval."
+      'If Seer detects that an issue is actionable enough, it will automatically analyze it in the background. By the time you see it, the root cause and solution will already be there for you.'
     ),
   type: 'choice',
-  options: [
-    {
-      value: 'off',
-      label: <SeerSelectLabel>{t('Off')}</SeerSelectLabel>,
-      details: t('Seer will never analyze any issues without manually clicking Start.'),
-    },
-    {
-      value: 'super_low',
-      label: <SeerSelectLabel>{t('Only the Most Actionable Issues')}</SeerSelectLabel>,
-      details: t(
-        'Seer will automatically run on issues that it thinks have an actionability of "super high." This targets around 2% of issues, but may vary by project.'
-      ),
-    },
-    {
-      value: 'low',
-      label: <SeerSelectLabel>{t('Highly Actionable and Above')}</SeerSelectLabel>,
-      details: t(
-        'Seer will automatically run on issues that it thinks have an actionability of "high" or above. This targets around 10% of issues, but may vary by project.'
-      ),
-    },
-    {
-      value: 'medium',
-      label: <SeerSelectLabel>{t('Moderately Actionable and Above')}</SeerSelectLabel>,
-      details: t(
-        'Seer will automatically run on issues that it thinks have an actionability of "medium" or above. This targets around 30% of issues, but may vary by project.'
-      ),
-    },
-    {
-      value: 'high',
-      label: <SeerSelectLabel>{t('Minimally Actionable and Above')}</SeerSelectLabel>,
-      details: t(
-        'Seer will automatically run on issues that it thinks have an actionability of "low" or above. This targets around 70% of issues, but may vary by project.'
-      ),
-    },
-    {
-      value: 'always',
-      label: <SeerSelectLabel>{t('All Issues')}</SeerSelectLabel>,
-      details: t('Seer will automatically run on all new issues.'),
-    },
-  ],
+  options: SEER_THRESHOLD_OPTIONS.map(option => ({
+    value: option.value,
+    label: <SeerSelectLabel>{option.label}</SeerSelectLabel>,
+    details: option.details,
+  })),
   saveOnBlur: true,
   saveMessage: t('Automatic Seer settings updated'),
   visible: ({model}) => model?.getValue('seerScannerAutomation') === true,
@@ -123,7 +88,7 @@ function ProjectSeerGeneralForm({project}: ProjectSeerProps) {
   const {preference} = useProjectSeerPreferences(project);
   const {mutate: updateProjectSeerPreferences} = useUpdateProjectSeerPreferences(project);
 
-  const canWriteProject = hasEveryAccess(['project:write'], {organization, project});
+  const canWriteProject = hasEveryAccess(['project:read'], {organization, project});
 
   const handleSubmitSuccess = useCallback(
     (resp: Project) => {
@@ -150,10 +115,10 @@ function ProjectSeerGeneralForm({project}: ProjectSeerProps) {
 
   const automatedRunStoppingPointField = {
     name: 'automated_run_stopping_point',
-    label: t('Stopping Point for Automatic Fixes'),
+    label: t('Stopping Point for Auto-Triggered Fixes'),
     help: () =>
       t(
-        'Choose how far Seer should go without your approval when running automatically. This does not affect Issue Fixes that you manually start.'
+        'Choose how far Seer should go before stopping for your approval. This does not affect Issue Fixes that you manually start.'
       ),
     type: 'choice',
     options: [
@@ -183,7 +148,25 @@ function ProjectSeerGeneralForm({project}: ProjectSeerProps) {
 
   const seerFormGroups: JsonFormObject[] = [
     {
-      title: t('Automation'),
+      title: (
+        <div>
+          {t('Automation')}
+          <Subheading>
+            {tct(
+              "Choose how Seer automatically triages and root-causes incoming issues, before you even notice them. This analysis is billed at the [link:standard rates] for Seer's Issue Scan and Issue Fix. See [spendlink:docs] on how to manage your Seer spend. You can also [bulklink:configure automation for other projects].",
+              {
+                link: <Link to={'https://docs.sentry.io/pricing/#seer-pricing'} />,
+                spendlink: (
+                  <Link
+                    to={getPricingDocsLinkForEventType(DataCategoryExact.SEER_AUTOFIX)}
+                  />
+                ),
+                bulklink: <Link to={`/settings/${organization.slug}/seer/`} />,
+              }
+            )}
+          </Subheading>
+        </div>
+      ),
       fields: [
         seerScannerAutomationField,
         autofixAutomatingTuningField,
@@ -214,24 +197,7 @@ function ProjectSeerGeneralForm({project}: ProjectSeerProps) {
           disabled={!canWriteProject}
           renderHeader={() => (
             <Fragment>
-              <Alert type="info" system>
-                {tct(
-                  "Choose how Seer automates analysis of incoming issues. Automated scans and fixes are charged at the [link:standard billing rates] for Seer's Issue Scan and Issue Fix. See [spendlink:docs] on how to manage your Seer spend.[break][break]You can also [bulklink:configure automation for other projects].",
-                  {
-                    link: <Link to={'https://docs.sentry.io/pricing/#seer-pricing'} />,
-                    spendlink: (
-                      <Link
-                        to={getPricingDocsLinkForEventType(
-                          DataCategoryExact.SEER_AUTOFIX
-                        )}
-                      />
-                    ),
-                    break: <br />,
-                    bulklink: <Link to={`/settings/${organization.slug}/seer/`} />,
-                  }
-                )}
-              </Alert>
-              <ProjectPermissionAlert project={project} system />
+              {!canWriteProject && <ProjectPermissionAlert project={project} system />}
             </Fragment>
           )}
         />
@@ -321,3 +287,12 @@ export default function ProjectSeerContainer({project}: ProjectSeerProps) {
 
   return <ProjectSeer project={project} />;
 }
+
+const Subheading = styled('div')`
+  font-size: ${p => p.theme.fontSize.sm};
+  color: ${p => p.theme.subText};
+  font-weight: ${p => p.theme.fontWeight.normal};
+  text-transform: none;
+  margin-top: ${space(1)};
+  line-height: 1.4;
+`;

static/gsApp/views/seerAutomation/index.spec.tsx

@@ -65,13 +65,17 @@ describe('SeerAutomation', function () {
     render(<SeerAutomationRoot />, {organization});
 
     // Project details populate the project list
-    const projectItem = await screen.findByRole('link', {name: project.slug});
+    const projectItem = await screen.findByText(project.slug);
     expect(projectItem).toBeInTheDocument();
-    expect(projectItem.parentElement!.parentElement).toHaveTextContent('Off');
+
+    // Find the panel item containing the project
+    const panelItem = projectItem.closest('[class*="PanelItem"]');
+    expect(panelItem).toBeInTheDocument();
+    expect(panelItem).toHaveTextContent('Off');
 
     // Find the select menu
     const select = await screen.findByRole('textbox', {
-      name: /Default for Automatic Issue Fixes/i,
+      name: /Default for Auto-Triggered Fixes/i,
     });
 
     act(() => {
@@ -124,9 +128,9 @@ describe('SeerAutomation', function () {
 
     render(<SeerAutomationRoot />, {organization});
 
-    // Find the toggle for Default for Automatic Issue Scans
+    // Find the toggle for Default for Issue Scans
     const toggle = await screen.findByRole('checkbox', {
-      name: /Default for Automatic Issue Scans/i,
+      name: /Default for Issue Scans/i,
     });
     expect(toggle).toBeInTheDocument();
     expect(toggle).not.toBeChecked();