@prenta/admin 1.13.0 → 1.14.0

package/src/__tests__/views/seo-proposals-tab.render.test.tsx

@@ -0,0 +1,370 @@
+// @vitest-environment happy-dom
+import { beforeEach, describe, expect, it, vi } from 'vitest'
+import { fireEvent, render, screen, waitFor } from '@testing-library/react'
+
+import type {
+  SeoProposal,
+  SeoProposalBulkApplyResult,
+  SeoProposalsPayload,
+} from '../../lib/seo-service.js'
+
+function proposal(over: Partial<SeoProposal> = {}): SeoProposal {
+  return {
+    id: 'issue:i1',
+    kind: 'issue-fix',
+    title: 'Duplicate meta title',
+    entity: { type: 'page', id: 'd1', title: 'Pricing', url: '/pricing' },
+    changes: [{ field: 'metaTitle', label: 'Meta title', before: 'Dup', after: 'Unique Pricing' }],
+    justification: 'AI drafted a unique title.',
+    source: 'ai',
+    confidence: null,
+    brandAlignment: 88,
+    generatedAt: new Date(Date.now() - 3600_000).toISOString(),
+    fingerprint: 'fp-1',
+    stale: false,
+    issueType: 'duplicate-meta-title',
+    severity: 'warning',
+    issueId: 'i1',
+    suggestionId: null,
+    ...over,
+  }
+}
+
+function payload(over: Partial<SeoProposalsPayload> = {}): SeoProposalsPayload {
+  return {
+    proposals: [
+      proposal(),
+      proposal({
+        id: 'issue:i2',
+        issueId: 'i2',
+        fingerprint: 'fp-2',
+        title: 'Missing description',
+        brandAlignment: 60,
+      }),
+      proposal({
+        id: 'redirect:s1',
+        kind: 'redirect',
+        title: 'Redirect /old → /new',
+        source: 'ai-404-recovery',
+        confidence: 0.82,
+        brandAlignment: null,
+        fingerprint: null,
+        issueId: null,
+        suggestionId: 's1',
+        severity: null,
+        changes: [{ field: 'redirect', label: 'Redirect', before: '/old', after: '/new' }],
+      }),
+    ],
+    counts: { issueFixes: 2, redirects: 1, stale: 0, eligibleForGeneration: 5 },
+    governance: { issueFixBulk: true, redirectBulk: true },
+    ...over,
+  }
+}
+
+const fetchSeoProposals = vi.fn(async () => payload())
+const generateSeoProposals = vi.fn(async () => ({
+  result: { generated: 2, skipped: 0, failed: 0, remaining: 0, haltedReason: null },
+}))
+const bulkApplySeoProposals = vi.fn(
+  async (_items: unknown): Promise<{ result?: SeoProposalBulkApplyResult; error?: string }> => ({
+    result: { results: [], applied: 0, failed: 0, pending: 0 },
+  }),
+)
+const dismissSeoIssueFix = vi.fn(async (_id: string): Promise<{ error?: string }> => ({}))
+const dismissRedirectSuggestion = vi.fn(async (_id: string): Promise<{ error?: string }> => ({}))
+
+vi.mock('../../lib/seo-service.js', () => ({
+  fetchSeoProposals: () => fetchSeoProposals(),
+  generateSeoProposals: () => generateSeoProposals(),
+  bulkApplySeoProposals: (items: unknown) => bulkApplySeoProposals(items),
+  dismissSeoIssueFix: (id: string) => dismissSeoIssueFix(id),
+  dismissRedirectSuggestion: (id: string) => dismissRedirectSuggestion(id),
+}))
+vi.mock('sonner', () => ({
+  toast: { success: vi.fn(), error: vi.fn(), info: vi.fn(), loading: vi.fn() },
+}))
+
+const { ProposalsTab } = await import('../../views/seo/ProposalsTab.js')
+const { toast } = await import('sonner')
+
+function deferred<T>() {
+  let resolve!: (value: T) => void
+  let reject!: (reason: unknown) => void
+  const promise = new Promise<T>((res, rej) => {
+    resolve = res
+    reject = rej
+  })
+  return { promise, resolve, reject }
+}
+
+/** Let any already-settled promise continuations run. */
+async function flushMicrotasks() {
+  await new Promise((r) => setTimeout(r, 0))
+}
+
+beforeEach(() => {
+  fetchSeoProposals.mockClear()
+  fetchSeoProposals.mockImplementation(async () => payload())
+  generateSeoProposals.mockClear()
+  bulkApplySeoProposals.mockClear()
+  dismissSeoIssueFix.mockClear()
+  dismissRedirectSuggestion.mockClear()
+  vi.mocked(toast.success).mockClear()
+  vi.mocked(toast.error).mockClear()
+})
+
+describe('ProposalsTab', () => {
+  it('renders rows with kind, badges, and expandable change preview', async () => {
+    render(<ProposalsTab planInfo={null} />)
+    expect(await screen.findByText('Duplicate meta title')).toBeTruthy()
+    expect(screen.getByText('82%')).toBeTruthy()
+    expect(screen.getByLabelText('Brand voice score 88 out of 100')).toBeTruthy()
+    fireEvent.click(screen.getByRole('button', { name: 'Show changes for Duplicate meta title' }))
+    expect(screen.getByRole('table', { name: 'Proposed SEO changes' })).toBeTruthy()
+    expect(screen.getByText('Unique Pricing')).toBeTruthy()
+  })
+
+  it('select-all selects only live rows and shows the bulk bar', async () => {
+    fetchSeoProposals.mockImplementationOnce(async () =>
+      payload({
+        proposals: [
+          proposal(),
+          proposal({ id: 'issue:stale', issueId: 'stale', stale: true, title: 'Stale one' }),
+        ],
+        counts: { issueFixes: 1, redirects: 0, stale: 1, eligibleForGeneration: 1 },
+      }),
+    )
+    render(<ProposalsTab planInfo={null} />)
+    await screen.findByText('Stale one')
+    expect(screen.getByText('Stale — regenerate')).toBeTruthy()
+    expect(screen.queryByLabelText('Select proposal Stale one')).toBeNull()
+    fireEvent.click(screen.getByLabelText('Select all proposals'))
+    expect(screen.getByRole('region', { name: 'Bulk actions' }).textContent).toContain('1 selected')
+  })
+
+  it('disables batch approve with a settings callout when governance forbids bulk apply', async () => {
+    fetchSeoProposals.mockImplementationOnce(async () =>
+      payload({ governance: { issueFixBulk: false, redirectBulk: true } }),
+    )
+    const onNavigate = vi.fn()
+    render(<ProposalsTab planInfo={null} onNavigate={onNavigate} />)
+    await screen.findByText('Duplicate meta title')
+    fireEvent.click(screen.getByLabelText('Select proposal Duplicate meta title'))
+    fireEvent.click(screen.getByLabelText('Select proposal Missing description'))
+    const approve = screen.getByRole('button', { name: 'Approve selected' })
+    expect(approve).toHaveProperty('disabled', true)
+    expect(screen.getByText(/Allow bulk apply/)).toBeTruthy()
+    expect(screen.queryByRole('link')).toBeNull()
+    fireEvent.click(screen.getByRole('button', { name: 'Open Settings → AI' }))
+    expect(onNavigate).toHaveBeenCalledWith('/settings?tab=ai')
+  })
+
+  it('renders the governance callout without a settings control when onNavigate is absent', async () => {
+    fetchSeoProposals.mockImplementationOnce(async () =>
+      payload({ governance: { issueFixBulk: false, redirectBulk: true } }),
+    )
+    render(<ProposalsTab planInfo={null} />)
+    await screen.findByText('Duplicate meta title')
+    fireEvent.click(screen.getByLabelText('Select all proposals'))
+    expect(screen.getByText(/Allow bulk apply/)).toBeTruthy()
+    expect(screen.queryByRole('button', { name: 'Open Settings → AI' })).toBeNull()
+    expect(screen.queryByRole('link')).toBeNull()
+  })
+
+  it('issues a single bulk-apply request when approve is triggered twice while in flight', async () => {
+    const inflight = deferred<{ result?: SeoProposalBulkApplyResult; error?: string }>()
+    bulkApplySeoProposals.mockImplementationOnce(() => inflight.promise)
+    render(<ProposalsTab planInfo={null} />)
+    await screen.findByText('Duplicate meta title')
+    const approve = screen.getByRole('button', { name: 'Approve Duplicate meta title' })
+    fireEvent.click(approve)
+    fireEvent.click(approve)
+    fireEvent.click(screen.getByRole('button', { name: 'Approve Missing description' }))
+    await flushMicrotasks()
+    expect(bulkApplySeoProposals).toHaveBeenCalledTimes(1)
+    expect(approve).toHaveProperty('disabled', true)
+    inflight.resolve({ result: { results: [], applied: 0, failed: 0, pending: 0 } })
+    await waitFor(() =>
+      expect(screen.getByRole('button', { name: 'Approve Duplicate meta title' })).toHaveProperty(
+        'disabled',
+        false,
+      ),
+    )
+  })
+
+  it('disables every other mutation control while an apply is in flight', async () => {
+    const inflight = deferred<{ result?: SeoProposalBulkApplyResult; error?: string }>()
+    bulkApplySeoProposals.mockImplementationOnce(() => inflight.promise)
+    render(<ProposalsTab planInfo={null} />)
+    await screen.findByText('Duplicate meta title')
+    fireEvent.click(screen.getByLabelText('Select all proposals'))
+    fireEvent.click(screen.getByRole('button', { name: 'Approve selected' }))
+    fireEvent.click(await screen.findByRole('button', { name: 'Apply 3 proposals' }))
+    await waitFor(() => expect(bulkApplySeoProposals).toHaveBeenCalledTimes(1))
+    expect(screen.getByRole('button', { name: 'Dismiss selected' })).toHaveProperty(
+      'disabled',
+      true,
+    )
+    expect(screen.getByRole('button', { name: 'Approve selected' })).toHaveProperty(
+      'disabled',
+      true,
+    )
+    expect(screen.getByRole('button', { name: 'Dismiss Duplicate meta title' })).toHaveProperty(
+      'disabled',
+      true,
+    )
+    expect(screen.getByRole('button', { name: 'Generate proposals (5 eligible)' })).toHaveProperty(
+      'disabled',
+      true,
+    )
+    fireEvent.click(screen.getByRole('button', { name: 'Dismiss selected' }))
+    expect(dismissSeoIssueFix).not.toHaveBeenCalled()
+    inflight.resolve({ result: { results: [], applied: 0, failed: 0, pending: 0 } })
+    await waitFor(() =>
+      expect(
+        screen.getByRole('button', { name: 'Generate proposals (5 eligible)' }),
+      ).toHaveProperty('disabled', false),
+    )
+  })
+
+  it('re-enables controls and toasts when the apply request throws', async () => {
+    bulkApplySeoProposals.mockRejectedValueOnce(new Error('network down'))
+    render(<ProposalsTab planInfo={null} />)
+    await screen.findByText('Duplicate meta title')
+    fireEvent.click(screen.getByRole('button', { name: 'Approve Duplicate meta title' }))
+    await waitFor(() => expect(toast.error).toHaveBeenCalledWith('network down'))
+    await waitFor(() =>
+      expect(screen.getByRole('button', { name: 'Approve Duplicate meta title' })).toHaveProperty(
+        'disabled',
+        false,
+      ),
+    )
+    expect(screen.getByRole('button', { name: 'Dismiss Duplicate meta title' })).toHaveProperty(
+      'disabled',
+      false,
+    )
+  })
+
+  it('stops the generate loop and stays silent after unmount', async () => {
+    const firstPass = deferred<{
+      result: {
+        generated: number
+        skipped: number
+        failed: number
+        remaining: number
+        haltedReason: null
+      }
+    }>()
+    generateSeoProposals.mockImplementationOnce(() => firstPass.promise)
+    const { unmount } = render(<ProposalsTab planInfo={null} />)
+    fireEvent.click(await screen.findByRole('button', { name: 'Generate proposals (5 eligible)' }))
+    fireEvent.click(await screen.findByRole('button', { name: 'Generate' }))
+    await waitFor(() => expect(generateSeoProposals).toHaveBeenCalledTimes(1))
+    unmount()
+    firstPass.resolve({
+      result: { generated: 1, skipped: 0, failed: 0, remaining: 1, haltedReason: null },
+    })
+    await flushMicrotasks()
+    await flushMicrotasks()
+    expect(generateSeoProposals).toHaveBeenCalledTimes(1)
+    expect(toast.success).not.toHaveBeenCalled()
+    expect(toast.error).not.toHaveBeenCalled()
+  })
+
+  it('confirming batch approve calls bulkApplySeoProposals with selected items and reports partial results', async () => {
+    bulkApplySeoProposals.mockResolvedValueOnce({
+      result: {
+        results: [
+          { kind: 'issue-fix', id: 'i1', status: 'applied' },
+          { kind: 'issue-fix', id: 'i2', status: 'stale', reason: 'stale' },
+        ],
+        applied: 1,
+        failed: 1,
+        pending: 0,
+      },
+    })
+    const { toast } = await import('sonner')
+    render(<ProposalsTab planInfo={null} />)
+    await screen.findByText('Duplicate meta title')
+    fireEvent.click(screen.getByLabelText('Select proposal Duplicate meta title'))
+    fireEvent.click(screen.getByLabelText('Select proposal Missing description'))
+    fireEvent.click(screen.getByRole('button', { name: 'Approve selected' }))
+    fireEvent.click(await screen.findByRole('button', { name: 'Apply 2 proposals' }))
+    await waitFor(() =>
+      expect(bulkApplySeoProposals).toHaveBeenCalledWith([
+        { kind: 'issue-fix', id: 'i1', fingerprint: 'fp-1' },
+        { kind: 'issue-fix', id: 'i2', fingerprint: 'fp-2' },
+      ]),
+    )
+    await waitFor(() => expect(toast.success).toHaveBeenCalledWith('1 proposal applied.'))
+    expect(toast.error).toHaveBeenCalledWith(expect.stringContaining('1 could not be applied'))
+  })
+
+  it('offers "Apply remaining" when the server reports pending items', async () => {
+    bulkApplySeoProposals.mockResolvedValueOnce({
+      result: {
+        results: [
+          { kind: 'issue-fix', id: 'i1', status: 'applied' },
+          { kind: 'issue-fix', id: 'i2', status: 'pending' },
+        ],
+        applied: 1,
+        failed: 0,
+        pending: 1,
+      },
+    })
+    render(<ProposalsTab planInfo={null} />)
+    await screen.findByText('Duplicate meta title')
+    fireEvent.click(screen.getByLabelText('Select all proposals'))
+    fireEvent.click(screen.getByRole('button', { name: 'Approve selected' }))
+    fireEvent.click(await screen.findByRole('button', { name: 'Apply 3 proposals' }))
+    expect(await screen.findByRole('button', { name: 'Apply remaining (1)' })).toBeTruthy()
+  })
+
+  it('dismiss selected fans out to the per-kind dismiss helpers', async () => {
+    render(<ProposalsTab planInfo={null} />)
+    await screen.findByText('Duplicate meta title')
+    fireEvent.click(screen.getByLabelText('Select all proposals'))
+    fireEvent.click(screen.getByRole('button', { name: 'Dismiss selected' }))
+    await waitFor(() => expect(dismissSeoIssueFix).toHaveBeenCalledTimes(2))
+    expect(dismissRedirectSuggestion).toHaveBeenCalledWith('s1')
+  })
+
+  it('generate loops while remaining > 0 and shows the eligible count', async () => {
+    generateSeoProposals
+      .mockResolvedValueOnce({
+        result: { generated: 10, skipped: 0, failed: 0, remaining: 3, haltedReason: null },
+      })
+      .mockResolvedValueOnce({
+        result: { generated: 3, skipped: 0, failed: 0, remaining: 0, haltedReason: null },
+      })
+    const { toast } = await import('sonner')
+    render(<ProposalsTab planInfo={null} />)
+    const button = await screen.findByRole('button', { name: 'Generate proposals (5 eligible)' })
+    fireEvent.click(button)
+    fireEvent.click(await screen.findByRole('button', { name: 'Generate' }))
+    await waitFor(() => expect(generateSeoProposals).toHaveBeenCalledTimes(2))
+    await waitFor(() => expect(toast.success).toHaveBeenCalledWith('13 proposals generated.'))
+  })
+
+  it('disables Generate when nothing is eligible and shows the empty state', async () => {
+    fetchSeoProposals.mockImplementationOnce(async () =>
+      payload({
+        proposals: [],
+        counts: { issueFixes: 0, redirects: 0, stale: 0, eligibleForGeneration: 0 },
+      }),
+    )
+    render(<ProposalsTab planInfo={null} />)
+    expect(await screen.findByText('No proposals yet')).toBeTruthy()
+    expect(screen.getByRole('button', { name: 'Generate proposals (0 eligible)' })).toHaveProperty(
+      'disabled',
+      true,
+    )
+  })
+
+  it('hides Generate behind the plan callout when seo.inlineApply is off', async () => {
+    render(<ProposalsTab planInfo={{ tier: 'starter', features: [], upgradeUrl: null }} />)
+    await screen.findByText('Duplicate meta title')
+    expect(screen.queryByRole('button', { name: /Generate proposals/ })).toBeNull()
+    expect(screen.getByText(/Upgrade to unlock SEO inline apply/)).toBeTruthy()
+  })
+})

package/src/components/seo/ChangePreview.tsx

@@ -0,0 +1,47 @@
+'use client'
+
+import type { SeoFixFieldChange } from '../../lib/seo-service.js'
+
+function formatValue(value: string | boolean | null): string {
+  if (value === null || value === '') return '—'
+  if (typeof value === 'boolean') return value ? 'Yes' : 'No'
+  if (value.length > 280) return `${value.slice(0, 277)}…`
+  return value
+}
+
+/** Before/after table for a proposed SEO change set. Shared by the issue fix panel and the proposals inbox. */
+export function ChangePreview({ changes }: { changes: SeoFixFieldChange[] }) {
+  if (changes.length === 0) return null
+  return (
+    <div className="border-border overflow-x-auto rounded-md border">
+      <table className="w-full min-w-[480px] text-sm" aria-label="Proposed SEO changes">
+        <thead>
+          <tr className="border-border bg-muted/40 text-muted-foreground border-b text-left">
+            <th scope="col" className="py-2 pr-3 pl-3 font-medium">
+              Field
+            </th>
+            <th scope="col" className="py-2 pr-3 font-medium">
+              Current
+            </th>
+            <th scope="col" className="py-2 pr-3 font-medium">
+              Proposed
+            </th>
+          </tr>
+        </thead>
+        <tbody className="divide-border divide-y">
+          {changes.map((c) => (
+            <tr key={c.field}>
+              <td className="text-foreground py-2 pr-3 pl-3 font-medium">{c.label}</td>
+              <td className="text-muted-foreground max-w-48 py-2 pr-3 wrap-break-word">
+                {formatValue(c.before)}
+              </td>
+              <td className="text-foreground max-w-48 py-2 pr-3 wrap-break-word">
+                {formatValue(c.after)}
+              </td>
+            </tr>
+          ))}
+        </tbody>
+      </table>
+    </div>
+  )
+}

package/src/components/seo/SeoIssueFixPanel.tsx

@@ -16,12 +16,12 @@ import {
   supportsSeoContentResearch,
   type SeoContentBrief,
   type SeoContentResearch,
-  type SeoFixFieldChange,
   type SeoIssue,
   type SeoIssueFixSuggestion,
 } from '../../lib/seo-service.js'
 import { hasPlanFeature, type PlanInfo } from '../../lib/plan.js'
 import { PlanUpgradeCallout } from '../PlanUpgradeCallout.js'
+import { ChangePreview } from './ChangePreview.js'
 import { SeoErrorState, btnPrimary, btnSecondary } from './primitives.js'
 
 function approveButtonLabel(strategy: SeoIssueFixSuggestion['fixStrategy']): string {
@@ -56,49 +56,6 @@ function approveSuccessToast(strategy: SeoIssueFixSuggestion['fixStrategy']): st
   }
 }
 
-function formatValue(value: string | boolean | null): string {
-  if (value === null || value === '') return '—'
-  if (typeof value === 'boolean') return value ? 'Yes' : 'No'
-  if (value.length > 280) return `${value.slice(0, 277)}…`
-  return value
-}
-
-function ChangePreview({ changes }: { changes: SeoFixFieldChange[] }) {
-  if (changes.length === 0) return null
-  return (
-    <div className="border-border overflow-x-auto rounded-md border">
-      <table className="w-full min-w-[480px] text-sm" aria-label="Proposed SEO changes">
-        <thead>
-          <tr className="border-border bg-muted/40 text-muted-foreground border-b text-left">
-            <th scope="col" className="py-2 pr-3 pl-3 font-medium">
-              Field
-            </th>
-            <th scope="col" className="py-2 pr-3 font-medium">
-              Current
-            </th>
-            <th scope="col" className="py-2 pr-3 font-medium">
-              Proposed
-            </th>
-          </tr>
-        </thead>
-        <tbody className="divide-border divide-y">
-          {changes.map((c) => (
-            <tr key={c.field}>
-              <td className="text-foreground py-2 pr-3 pl-3 font-medium">{c.label}</td>
-              <td className="text-muted-foreground max-w-48 py-2 pr-3 wrap-break-word">
-                {formatValue(c.before)}
-              </td>
-              <td className="text-foreground max-w-48 py-2 pr-3 wrap-break-word">
-                {formatValue(c.after)}
-              </td>
-            </tr>
-          ))}
-        </tbody>
-      </table>
-    </div>
-  )
-}
-
 function ContentResearchCard({ research }: { research: SeoContentResearch }) {
   return (
     <div className="border-border bg-card space-y-3 rounded-md border p-4">

package/src/lib/seo-service.ts

@@ -113,6 +113,8 @@ export interface SeoOverview {
   lastAuditRunId: string | null
   /** True when the last audit hit AUDIT_MAX_ENTITIES. */
   auditTruncated?: boolean
+  /** Cached AI issue fixes + open redirect suggestions awaiting review. */
+  pendingProposals?: { issueFixes: number; redirects: number }
 }
 
 const EMPTY_OVERVIEW: SeoOverview = {
@@ -1333,3 +1335,126 @@ export async function fetchLinkHealthIssues(): Promise<{
     },
   }
 }
+
+// ─── AI proposals inbox ─────────────────────────────────────────────────
+
+export interface SeoProposal {
+  /** `issue:<issueId>` | `redirect:<suggestionId>` */
+  id: string
+  kind: 'issue-fix' | 'redirect'
+  title: string
+  entity: { type: string | null; id: string | null; title: string | null; url: string | null }
+  changes: SeoFixFieldChange[]
+  justification: string
+  source: 'ai' | 'deterministic' | 'ai-404-recovery'
+  /** 0–1, redirects only. */
+  confidence: number | null
+  /** 0–100, issue fixes only. */
+  brandAlignment: number | null
+  generatedAt: string | null
+  /** Issue fixes only; redirects are keyed by id. */
+  fingerprint: string | null
+  /** Issue fixes: cached fingerprint ≠ live fingerprint. Redirects: always false. */
+  stale: boolean
+  issueType: string | null
+  severity: SeoSeverity | null
+  issueId: string | null
+  suggestionId: string | null
+}
+
+export interface SeoProposalsPayload {
+  proposals: SeoProposal[]
+  counts: { issueFixes: number; redirects: number; stale: number; eligibleForGeneration: number }
+  /** `allowBulkApply` per feature, so the UI can disable batch approve up front. */
+  governance: { issueFixBulk: boolean; redirectBulk: boolean }
+}
+
+export interface SeoProposalGenerateResult {
+  generated: number
+  skipped: number
+  failed: number
+  remaining: number
+  haltedReason: string | null
+}
+
+export interface SeoProposalBulkApplyItem {
+  kind: 'issue-fix' | 'redirect'
+  id: string
+  fingerprint?: string
+}
+
+/** Mirrors core's `BulkApplyItemStatus` (`seo/proposals-bulk-apply.ts`). */
+export type SeoProposalBulkApplyItemStatus =
+  | 'applied'
+  | 'stale'
+  | 'verify-failed'
+  | 'plan-required'
+  | 'not-found'
+  | 'not-allowed'
+  | 'not-fixable'
+  | 'invalid'
+  | 'still-live'
+  | 'error'
+  | 'pending'
+
+export interface SeoProposalBulkApplyResult {
+  results: Array<{
+    kind: 'issue-fix' | 'redirect'
+    id: string
+    status: SeoProposalBulkApplyItemStatus
+    reason?: string
+  }>
+  applied: number
+  failed: number
+  /** Items the server did not reach within its time budget — resubmit exactly these. */
+  pending: number
+}
+
+export async function fetchSeoProposals(): Promise<SeoProposalsPayload> {
+  const res = await cmsApi<SeoProposalsPayload>('/seo/proposals')
+  throwIfError(res)
+  return (
+    res.data ?? {
+      proposals: [],
+      counts: { issueFixes: 0, redirects: 0, stale: 0, eligibleForGeneration: 0 },
+      governance: { issueFixBulk: false, redirectBulk: false },
+    }
+  )
+}
+
+export async function generateSeoProposals(): Promise<{
+  result?: SeoProposalGenerateResult
+  error?: string
+}> {
+  const res = await cmsApi<SeoProposalGenerateResult>('/seo/proposals/generate', {
+    method: 'POST',
+    body: JSON.stringify({ confirm: true }),
+  })
+  if (res.error) return { error: res.error }
+  return { result: res.data }
+}
+
+export async function bulkApplySeoProposals(items: SeoProposalBulkApplyItem[]): Promise<{
+  result?: SeoProposalBulkApplyResult
+  error?: string
+  /** True when the server refused because `allowBulkApply` is off for a represented feature. */
+  governanceBlocked?: boolean
+}> {
+  const res = await cmsApi<SeoProposalBulkApplyResult>('/seo/proposals/bulk-apply', {
+    method: 'POST',
+    body: JSON.stringify({ items }),
+  })
+  if (res.error) {
+    return res.code === 'governance_blocked'
+      ? { error: res.error, governanceBlocked: true }
+      : { error: res.error }
+  }
+  return { result: res.data }
+}
+
+export async function dismissSeoIssueFix(issueId: string): Promise<{ error?: string }> {
+  const res = await cmsApi(`/seo/issues/${encodeURIComponent(issueId)}/dismiss-fix`, {
+    method: 'POST',
+  })
+  return res.error ? { error: res.error } : {}
+}