@prenta/core 7.7.0 → 7.7.1

package/dist/api/routes/seo.js

@@ -1,2615 +1,61 @@
-import { updateDocumentSeoFields } from '../../actions.js';
-import { logEvent } from '../../security/audit.js';
-import { DEFAULT_DIRECTIVES, coerceMaxImagePreview } from '../../seo/robots-directives.js';
-import { processSeoScan } from '../../cron/index.js';
-import { isResolvedIp } from '../../security/client-ip.js';
-import { classifyLinkHealthIssue, extractOutboundUrlsFromDocumentData, probeOutboundLink, } from '../../seo/link-probe.js';
-import { documentPublicPath, resolveTrailingSlashPolicy, trailingSlashMismatchTarget, } from '../../seo/document-path.js';
-import { getPrentaConfig } from '../../config/runtime.js';
-import { createLogger } from '../../diagnostics/logger.js';
-import { assertPlanFeature, hasPlanFeature } from '../../plan/features.js';
-import { extraImagesForSeoAnalysis, firstSectionHeading } from '../../seo/document-content.js';
-import { syncSchemaTypeFields } from '../../seo/schema-sync.js';
-import { guardedDb } from '../guarded-db.js';
-import { recordAiCrawlerFromRequest, recordAiCrawlerHit } from '../../seo/ai-crawler-log.js';
-import { detectAiBot } from '../../seo/ai-bots.js';
-import { json, errorResponse, internalError, asRecord, normalizeSeoPage, hasModel, formatCompactNumber, modelNotAvailable, requireAuth, buildActionContext, WRITE_ROLES, ADMIN_ROLES, requireRole, linkHealthLimiter, seoAuditLimiter, aiGenerateLimiter, checkRateLimitAsync, clientIp, enforceDocumentReadAccess, apiKeyCollectionScopeDenial, clampPage, clampPageSize, } from '../route-helpers.js';
-import { gatherNavigationLinkTargets } from '../../seo/nav-link-targets.js';
-import { suggestInboundLinks } from '../../seo/link-suggest.js';
-import { seoApplyFixBodySchema, seoBulkApplyBodySchema, seoLinkApplyBodySchema, validateBody, } from '../validate-body.js';
-// Explicit risk order. A plain `severity: 'asc'` DB sort orders the values
-// alphabetically (critical, info, warning) which wrongly ranks `info` above
-// `warning`. Unknown severities sort last.
-const seoLogger = createLogger('seo');
-const SEVERITY_RANK = { critical: 0, warning: 1, info: 2 };
-function severityRank(severity) {
-    return SEVERITY_RANK[String(severity)] ?? 99;
-}
-function planRequiredResponse(denial) {
-    return json({
-        error: denial.message,
-        code: 'plan_required',
-        requiredTier: denial.requiredTier,
-        feature: denial.feature,
-    }, 403);
-}
-function mapInternalLinkInsertError(err) {
-    const msg = err instanceof Error ? err.message : '';
-    switch (msg) {
-        case 'SOURCE_NOT_FOUND':
-            return errorResponse('Source document not found', 404);
-        case 'TARGET_NOT_FOUND':
-            return errorResponse('Target document not found', 404);
-        case 'NOT_WRAPPABLE':
-            return errorResponse('Anchor is not wrappable in the live source document.', 422);
-        case 'ALREADY_LINKED':
-            return errorResponse('Source already links to this target.', 422);
-        case 'TARGET_PATH_MISMATCH':
-            return errorResponse('Target path does not match the live document.', 422);
-        default:
-            return null;
-    }
-}
-function seoAiGenerationError(result) {
-    if (result.code === 'unavailable' || result.code === 'feature_disabled') {
-        return errorResponse(result.message, 503);
-    }
-    if (result.code === 'rate_limited' || result.code === 'budget_exceeded') {
-        return errorResponse(result.message, 429);
-    }
-    return errorResponse(result.message, 422);
-}
-/** Sort issues by risk (critical → warning → info), then most-recent first. */
-export function sortIssuesBySeverity(issues) {
-    return [...issues].sort((a, b) => {
-        const rankDiff = severityRank(a.severity) - severityRank(b.severity);
-        if (rankDiff !== 0)
-            return rankDiff;
-        const at = a.lastDetectedAt ? new Date(a.lastDetectedAt).getTime() : 0;
-        const bt = b.lastDetectedAt ? new Date(b.lastDetectedAt).getTime() : 0;
-        return bt - at;
-    });
-}
+import { getSeoPages } from './seo/handlers/pages.js';
+import { getSeoLinkHealth, getSeoLinkSnapshot, postSeoLinkAiIndex, postSeoLinkSuggest, postSeoLinkApply, } from './seo/handlers/links.js';
+import { postSeoScan, postSeoAudit, getSeoAudits, getSeoAudit } from './seo/handlers/audits.js';
+import { getSeoIssues, getSeoIssuesExportBrief, getSeoIssue, postSeoIssueResolve, postSeoIssueIgnore, postSeoIssueReopen, } from './seo/handlers/issues-list.js';
+import { postSeoIssuesBatchContentBriefs, getSeoIssueContentBrief, postSeoIssueContentBrief, getSeoIssueContentResearch, postSeoIssueContentResearch, postSeoIssueResearchAndBrief, } from './seo/handlers/issues-briefs.js';
+import { postSeoIssueSuggestFix, postSeoIssueApplyFix, postSeoIssueDismissFix, } from './seo/handlers/issues-fixes.js';
+import { getSeoProposals, postSeoProposalsGenerate, postSeoProposalsBulkApply, } from './seo/handlers/proposals.js';
+import { getSeoOverview, getSeoSearchPerformance, getSeoSearchInsights, } from './seo/handlers/overview.js';
+import { getSeoContent, getSeoContentRecord, putSeoContentRecord } from './seo/handlers/content.js';
+import { getSeoAnalysis, getSeoReadability, getSeoInternalLinks } from './seo/handlers/analysis.js';
+import { getLlmsTxt, getLlmsFullTxt, getMarkdownForPath, getAiCrawlerTrap, getAiCrawlers, } from './seo/handlers/public-files.js';
+export { sortIssuesBySeverity } from './seo/handlers/shared.js';
 /**
- * Content-writing fix strategies (`add-section`, `insert-link`, `fix-link`)
- * write a document the route cannot name up front, so the API-key collection
- * scope is checked inside `applyIssueFix` once the collection is known. JWT
- * sessions already passed the route's `WRITE_ROLES` check and are never denied.
+ * SEO HTTP routes. Handlers live under `./seo/handlers` so this file stays a
+ * registration list. Request behavior is unchanged.
  */
-function contentWriteGate(session) {
-    return (collection) => apiKeyCollectionScopeDenial(session, collection, 'update');
-}
 export function registerSeoRoutes(router) {
-    const db = guardedDb;
-    // ---------------------------------------------------------------------------
-    // SEO routes
-    // ---------------------------------------------------------------------------
-    router.get('/seo/pages', async (request) => {
-        try {
-            const auth = await requireAuth(request);
-            if (auth.error)
-                return auth.error;
-            // Bound the scan: a large site can have tens of thousands of published
-            // docs, and each carries a full `data` JSONB. Default to a high cap so
-            // typical sites are unaffected; expose `?limit`/`?offset` so clients can
-            // page rather than pull everything into memory at once. A full page
-            // (data.length === limit) signals there may be more.
-            const params = new URL(request.url).searchParams;
-            const limit = Math.min(Math.max(Number(params.get('limit')) || 1000, 1), 5000);
-            const offset = Math.max(Number(params.get('offset')) || 0, 0);
-            const pages = await db().document.findMany({
-                where: { deletedAt: null, status: 'PUBLISHED' },
-                select: {
-                    id: true,
-                    collection: true,
-                    data: true,
-                    updatedAt: true,
-                    structuredData: true,
-                },
-                orderBy: { updatedAt: 'desc' },
-                take: limit,
-                skip: offset,
-            });
-            return json({ data: pages.map(normalizeSeoPage), limit, offset });
-        }
-        catch (err) {
-            return internalError(err);
-        }
-    });
-    router.get('/seo/link-health', async (request) => {
-        try {
-            const auth = await requireAuth(request);
-            if (auth.error)
-                return auth.error;
-            // EDITOR+ only — this endpoint hits arbitrary URLs and can be expensive.
-            const roleErr = requireRole(auth.session.role, WRITE_ROLES);
-            if (roleErr)
-                return roleErr;
-            // Tight rate limit because each call fans out to many outbound requests.
-            const ip = clientIp(request);
-            const rateKey = isResolvedIp(ip)
-                ? `link-health:${ip}`
-                : `link-health-user:${auth.session.userId}`;
-            if (!(await checkRateLimitAsync(linkHealthLimiter, rateKey))) {
-                return errorResponse('Too many link-health scans. Please try again later.', 429);
-            }
-            const MAX_LINKS_PER_PAGE = 50;
-            const MAX_TOTAL_LINKS = 500;
-            const DOC_BATCH_SIZE = 100;
-            const PER_LINK_TIMEOUT_MS = 4000;
-            const CONCURRENCY = 8;
-            const siteSeo = getPrentaConfig()?.seo;
-            const siteUrl = (siteSeo?.siteUrl ?? process.env.NEXT_PUBLIC_SITE_URL ?? '').replace(/\/+$/, '');
-            const trailingSlash = resolveTrailingSlashPolicy(siteSeo?.trailingSlash);
-            const queue = [];
-            const seenGlobal = new Set();
-            let docsScanned = 0;
-            let skip = 0;
-            scanLoop: while (queue.length < MAX_TOTAL_LINKS) {
-                const batch = await db().document.findMany({
-                    where: { deletedAt: null, status: 'PUBLISHED' },
-                    select: { id: true, title: true, data: true, collection: true },
-                    orderBy: { updatedAt: 'desc' },
-                    skip,
-                    take: DOC_BATCH_SIZE,
-                });
-                if (batch.length === 0)
-                    break;
-                docsScanned += batch.length;
-                skip += batch.length;
-                for (const doc of batch) {
-                    const pageTitle = doc.title ?? doc.data?.title ?? doc.id;
-                    // Walk unescaped string fields — never JSON.stringify (captures `\`
-                    // from `\"` and produces mass false positives).
-                    const urls = extractOutboundUrlsFromDocumentData(doc.data ?? {}, { siteUrl });
-                    let countInPage = 0;
-                    for (const clean of urls) {
-                        if (seenGlobal.has(clean))
-                            continue;
-                        seenGlobal.add(clean);
-                        if (countInPage >= MAX_LINKS_PER_PAGE)
-                            break;
-                        if (queue.length >= MAX_TOTAL_LINKS)
-                            break scanLoop;
-                        const isInternal = !!siteUrl && clean.startsWith(siteUrl);
-                        queue.push({ docId: doc.id, pageTitle, clean, isInternal });
-                        countInPage++;
-                    }
-                }
-            }
-            const linkResults = [];
-            let cursor = 0;
-            const worker = async () => {
-                while (cursor < queue.length) {
-                    const idx = cursor++;
-                    const job = queue[idx];
-                    // GET + browser UA. safeFetch rejects private/loopback IPs and
-                    // disables redirect following so 302→internal can't bypass SSRF.
-                    // Retry once on status 0 — a single timeout was a known false
-                    // positive on otherwise-200 pages.
-                    const probed = await probeOutboundLink(job.clean, {
-                        timeoutMs: PER_LINK_TIMEOUT_MS,
-                        retryUnreachable: true,
-                    });
-                    const kind = classifyLinkHealthIssue(probed.status);
-                    const slashTarget = job.isInternal && !kind ? trailingSlashMismatchTarget(job.clean, trailingSlash) : null;
-                    if (!kind && !slashTarget)
-                        continue;
-                    linkResults.push({
-                        id: `${job.docId}-${idx}`,
-                        page: job.pageTitle,
-                        url: job.clean,
-                        status: kind ? probed.status : 308,
-                        type: job.isInternal ? 'internal' : 'external',
-                        kind: kind ?? 'redirected',
-                        ...(probed.redirectTarget || slashTarget
-                            ? { redirectTarget: probed.redirectTarget ?? slashTarget ?? undefined }
-                            : {}),
-                    });
-                }
-            };
-            await Promise.all(Array.from({ length: Math.min(CONCURRENCY, queue.length) }, worker));
-            return json({
-                data: {
-                    truncated: queue.length >= MAX_TOTAL_LINKS,
-                    docsScanned,
-                    checked: queue.length,
-                    issues: linkResults,
-                },
-            });
-        }
-        catch (err) {
-            return internalError(err);
-        }
-    });
-    router.get('/seo/links/snapshot', async (request) => {
-        try {
-            const auth = await requireAuth(request);
-            if (auth.error)
-                return auth.error;
-            const roleErr = requireRole(auth.session.role, WRITE_ROLES);
-            if (roleErr)
-                return roleErr;
-            const { gatherAuditEntities, frontEndContentCollectionTypes } = await import('../../seo/audit-runner.js');
-            const { buildLinkGraphSnapshot } = await import('../../seo/link-graph.js');
-            const { getSeoOverrides, resolveSeoModuleSettings } = await import('../../seo/config-store.js');
-            const cfg = getPrentaConfig();
-            const collectionTypes = frontEndContentCollectionTypes(cfg);
-            const siteUrl = cfg?.seo?.siteUrl?.replace(/\/+$/, '') ?? '';
-            const entities = await gatherAuditEntities(db(), { collectionTypes });
-            const docRows = await db()
-                .document.findMany({
-                where: {
-                    deletedAt: null,
-                    status: 'PUBLISHED',
-                    collection: { in: Object.keys(collectionTypes) },
-                },
-                select: { id: true, collection: true },
-            })
-                .catch(() => []);
-            const collections = Object.fromEntries(docRows.map((d) => [d.id, d.collection]));
-            let brokenLinkCount = 0;
-            if (hasModel(db(), 'seoIssue')) {
-                brokenLinkCount = await db()
-                    .seoIssue.count({
-                    where: {
-                        status: { in: ['open', 'recurring'] },
-                        type: 'broken-internal-link',
-                    },
-                })
-                    .catch(() => 0);
-            }
-            const overrides = await getSeoOverrides(db()).catch(() => null);
-            const moduleSettings = resolveSeoModuleSettings(overrides);
-            // Global nav/footer menus link to top-level pages from site chrome, not
-            // from document bodies. Feed those targets in so nav-only reachable pages
-            // are not mis-reported as orphaned. Best-effort: no-op when the navigation
-            // plugin isn't installed.
-            const navLinks = await gatherNavigationLinkTargets(db());
-            const snapshot = buildLinkGraphSnapshot({
-                entities,
-                siteUrl,
-                collections,
-                brokenLinkCount,
-                aiIndexLastRunAt: moduleSettings.linkAiIndexLastRunAt,
-                navLinks,
-            });
-            return json({ data: snapshot });
-        }
-        catch (err) {
-            return internalError(err, 'seo/links/snapshot');
-        }
-    });
-    router.post('/seo/links/ai-index', async (request) => {
-        try {
-            const auth = await requireAuth(request);
-            if (auth.error)
-                return auth.error;
-            const roleErr = requireRole(auth.session.role, WRITE_ROLES);
-            if (roleErr)
-                return roleErr;
-            if (!(await checkRateLimitAsync(aiGenerateLimiter, `link-ai-index:${auth.session.userId}`))) {
-                return errorResponse('AI link index rate limit reached. Try again later.', 429);
-            }
-            const { gatherAuditEntities, frontEndContentCollectionTypes } = await import('../../seo/audit-runner.js');
-            const { patchSeoModuleSettings } = await import('../../seo/config-store.js');
-            const cfg = getPrentaConfig();
-            const collectionTypes = frontEndContentCollectionTypes(cfg);
-            const entities = await gatherAuditEntities(db(), { collectionTypes });
-            // Availability = the governed runtime can serve the link feature right
-            // now (toggle on, model + key resolvable, budget/cap not exhausted) AND
-            // the resolved provider has an embeddings API in the runtime. A
-            // text-only provider (Anthropic, xAI) resolves fine but `embedForFeature`
-            // would refuse with `no_model`, so suggestions stay on phrase matching.
-            const { embeddingsAvailableForProvider, resolveFeatureRuntime } = await import('../../ai/index.js');
-            const probe = await resolveFeatureRuntime(db(), 'ai.features.seoInternalLinks');
-            const aiAvailable = probe.ok && embeddingsAvailableForProvider(probe.providerKey);
-            const now = new Date().toISOString();
-            await patchSeoModuleSettings(db(), { linkAiIndexLastRunAt: now }, auth.session.userId);
-            await logEvent({
-                event: 'seo_link_ai_index',
-                userId: auth.session.userId,
-                details: { entitiesIndexed: entities.length, aiAvailable },
-            });
-            return json({
-                data: {
-                    indexedAt: now,
-                    entitiesIndexed: entities.length,
-                    aiAvailable,
-                    // No standing index/embeddings are persisted here — /seo/links/suggest
-                    // rebuilds the corpus on demand and works with or without this run.
-                    // Keep the copy honest: this refreshes the link corpus and records the
-                    // run; it does not "build" anything suggestions depend on.
-                    message: aiAvailable
-                        ? 'Link corpus refreshed. AI link suggestions are generated on demand — run them on orphaned or under-linked pages.'
-                        : 'Link corpus refreshed. Connect an AI provider in Settings > AI to enable semantic link suggestions; phrase matching is active meanwhile.',
-                },
-            });
-        }
-        catch (err) {
-            return internalError(err, 'seo/links/ai-index');
-        }
-    });
-    router.post('/seo/links/suggest', async (request) => {
-        try {
-            const auth = await requireAuth(request);
-            if (auth.error)
-                return auth.error;
-            const roleErr = requireRole(auth.session.role, WRITE_ROLES);
-            if (roleErr)
-                return roleErr;
-            if (!(await checkRateLimitAsync(aiGenerateLimiter, `link-suggest:${auth.session.userId}`))) {
-                return errorResponse('Link suggestion rate limit reached. Try again later.', 429);
-            }
-            const body = (await request.json());
-            if (!body.targetEntityId || !body.targetEntityType) {
-                return errorResponse('targetEntityId and targetEntityType are required', 400);
-            }
-            const limit = Math.max(1, Math.min(20, typeof body.limit === 'number' ? body.limit : 8));
-            let result;
-            try {
-                result = await suggestInboundLinks({
-                    db: db(),
-                    targetEntityId: body.targetEntityId,
-                    targetEntityType: body.targetEntityType,
-                    limit,
-                    userId: auth.session.userId,
-                });
-            }
-            catch (err) {
-                if (err instanceof Error && err.message === 'TARGET_NOT_FOUND') {
-                    return errorResponse('Target document not found in link graph', 404);
-                }
-                throw err;
-            }
-            return json({
-                data: {
-                    target: result.target,
-                    suggestions: result.suggestions,
-                },
-            });
-        }
-        catch (err) {
-            return internalError(err, 'seo/links/suggest');
-        }
-    });
-    router.post('/seo/links/apply', async (request) => {
-        try {
-            const auth = await requireAuth(request);
-            if (auth.error)
-                return auth.error;
-            const roleErr = requireRole(auth.session.role, WRITE_ROLES);
-            if (roleErr)
-                return roleErr;
-            const inlinePlanErr = assertPlanFeature('seo.inlineApply');
-            if (inlinePlanErr)
-                return planRequiredResponse(inlinePlanErr);
-            if (!(await checkRateLimitAsync(aiGenerateLimiter, `link-apply:${auth.session.userId}`))) {
-                return errorResponse('Link apply rate limit reached. Try again later.', 429);
-            }
-            const parsed = await validateBody(request, seoLinkApplyBodySchema);
-            if (!parsed.ok)
-                return parsed.error;
-            const { sourceEntityId, targetEntityId, anchorText, fingerprint } = parsed.data;
-            const source = await db().document.findFirst({
-                where: { id: sourceEntityId, deletedAt: null },
-                select: {
-                    id: true,
-                    collection: true,
-                    updatedAt: true,
-                    data: true,
-                    slug: true,
-                    status: true,
-                },
-            });
-            if (!source)
-                return errorResponse('Source document not found', 404);
-            const target = await db().document.findFirst({
-                where: { id: targetEntityId, deletedAt: null },
-                select: { id: true, collection: true, data: true, slug: true, status: true },
-            });
-            if (!target)
-                return errorResponse('Target document not found', 404);
-            const targetData = asRecord(target.data);
-            const targetSlug = (typeof targetData.slug === 'string' && targetData.slug) ||
-                (typeof target.slug === 'string' && target.slug) ||
-                target.id;
-            const collectionDef = getPrentaConfig()?.collections?.[target.collection];
-            const targetPath = documentPublicPath({
-                urlPrefix: collectionDef?.urlPrefix,
-                slug: targetSlug,
-                data: targetData,
-            });
-            const { applyAndVerifyInternalLinkInsert, buildInsertLinkFingerprint } = await import('../../seo/issue-fix-link-insert.js');
-            const liveFingerprint = buildInsertLinkFingerprint(sourceEntityId, targetEntityId, anchorText, source.updatedAt instanceof Date ? source.updatedAt : new Date(source.updatedAt));
-            if (fingerprint !== liveFingerprint) {
-                return errorResponse('This fix is stale — the page changed since the suggestion was loaded. Expand the row again.', 409);
-            }
-            const ctx = buildActionContext(auth.session, db());
-            let verified;
-            try {
-                const result = await applyAndVerifyInternalLinkInsert({
-                    db: db(),
-                    ctx,
-                    sourceEntityId,
-                    targetEntityId,
-                    anchorText,
-                    targetPath,
-                    siteUrl: getPrentaConfig()?.seo?.siteUrl ?? '',
-                    navLinks: await gatherNavigationLinkTargets(db()),
-                });
-                verified = result.verify;
-            }
-            catch (err) {
-                const mapped = mapInternalLinkInsertError(err);
-                if (mapped)
-                    return mapped;
-                throw err;
-            }
-            if (!verified.ok) {
-                return json({ error: 'Fix applied but verification failed.', reason: verified.reason }, 409);
-            }
-            if (hasModel(db(), 'seoIssue')) {
-                await db().seoIssue.updateMany({
-                    where: {
-                        type: 'orphan-page',
-                        entityId: targetEntityId,
-                        status: { in: ['open', 'recurring'] },
-                    },
-                    data: {
-                        status: 'resolved',
-                        resolvedAt: new Date(),
-                        resolvedById: auth.session.userId,
-                    },
-                });
-            }
-            try {
-                await logEvent({
-                    event: 'document_updated',
-                    userId: auth.session.userId,
-                    details: {
-                        action: 'seo_internal_link_applied',
-                        seoFix: 'insert-link',
-                        sourceEntityId,
-                        targetEntityId,
-                        targetPath,
-                    },
-                });
-            }
-            catch {
-                /* noop */
-            }
-            return json({
-                data: { sourceEntityId, targetEntityId, targetPath, applied: true },
-            });
-        }
-        catch (err) {
-            return internalError(err, 'seo/links/apply');
-        }
-    });
-    router.post('/seo/scan', async (request) => {
-        try {
-            const auth = await requireAuth(request);
-            if (auth.error)
-                return auth.error;
-            const roleErr = requireRole(auth.session.role, WRITE_ROLES);
-            if (roleErr)
-                return roleErr;
-            // Expensive: loads + regex-scans every published doc. Rate-limit it (same
-            // budget as the full audit) so it can't be hammered into an OOM/CPU spike.
-            const scanIp = clientIp(request);
-            const scanKey = isResolvedIp(scanIp)
-                ? `seo-scan:${scanIp}`
-                : `seo-scan-user:${auth.session.userId}`;
-            if (!(await checkRateLimitAsync(seoAuditLimiter, scanKey))) {
-                return errorResponse('Too many scans. Please try again later.', 429);
-            }
-            // Scope the scan to configured front-end content collections so structural
-            // (navigation/footer) and benchmark documents are never reported. Shares
-            // the exact scan logic with the cron path via processSeoScan.
-            const { frontEndContentCollectionTypes } = await import('../../seo/audit-runner.js');
-            const allowedCollections = Object.keys(frontEndContentCollectionTypes(getPrentaConfig()));
-            const result = await processSeoScan(db(), { allowedCollections, maxDocuments: 5000 });
-            return json({ data: result });
-        }
-        catch (err) {
-            return internalError(err);
-        }
-    });
-    // ---------------------------------------------------------------------------
-    // SEO Operations Center — audit engine, issues, overview, content records
-    // ---------------------------------------------------------------------------
-    function seoIssueToApi(i) {
-        return {
-            id: i.id,
-            auditRunId: i.auditRunId ?? null,
-            entityType: i.entityType ?? null,
-            entityId: i.entityId ?? null,
-            entityTitle: i.entityTitle ?? null,
-            url: i.url ?? null,
-            severity: i.severity,
-            category: i.category,
-            type: i.type,
-            title: i.title,
-            description: i.description ?? null,
-            impact: i.impact ?? null,
-            recommendation: i.recommendation ?? null,
-            status: i.status,
-            fixable: i.fixable ?? false,
-            fixActionType: i.fixActionType ?? null,
-            relatedEntityIds: Array.isArray(i.relatedEntityIds) ? i.relatedEntityIds : [],
-            source: i.source ?? 'audit',
-            firstDetectedAt: i.firstDetectedAt ?? null,
-            lastDetectedAt: i.lastDetectedAt ?? null,
-            resolvedAt: i.resolvedAt ?? null,
-        };
-    }
-    /**
-     * Compute the set of front-end content collections the caller may read.
-     * Mirrors the per-document `enforceDocumentReadAccess` check the sibling
-     * `/seo/analysis|readability|…` endpoints run, but resolved once for the
-     * collection list so the aggregate `/seo/content` view can never surface SEO
-     * fields for a collection the caller's scope/role forbids.
-     */
-    async function readableSeoCollections(session) {
-        const { frontEndContentCollectionTypes } = await import('../../seo/audit-runner.js');
-        const collectionTypes = frontEndContentCollectionTypes(getPrentaConfig());
-        const allowed = new Set();
-        for (const slug of Object.keys(collectionTypes)) {
-            const err = await enforceDocumentReadAccess(session, slug);
-            if (!err)
-                allowed.add(slug);
-        }
-        return allowed;
-    }
-    async function buildSeoContentRecords(allowedCollections, 
-    /**
-     * Restrict to specific documents, regardless of publication status. Used by
-     * the per-document GET, which must answer for a saved draft — the list
-     * endpoints deliberately stay published-only.
-     */
-    documentIds, page) {
-        const { gatherAuditEntities, countAuditEntities, frontEndContentCollectionTypes } = await import('../../seo/audit-runner.js');
-        const { applySeoOverrides, getSeoOverrides } = await import('../../seo/config-store.js');
-        const { calculatePageSeoScore } = await import('../../seo/score.js');
-        const allTypes = frontEndContentCollectionTypes(getPrentaConfig());
-        // When a readable-collection allow-list is supplied, scope the gather to it
-        // so records for forbidden collections are never even built.
-        const collectionTypes = allowedCollections
-            ? Object.fromEntries(Object.entries(allTypes).filter(([slug]) => allowedCollections.has(slug)))
-            : allTypes;
-        const overrides = await getSeoOverrides(db()).catch(() => null);
-        const siteSeo = applySeoOverrides(getPrentaConfig(), overrides)?.seo;
-        const [entities, total] = await Promise.all([
-            gatherAuditEntities(db(), {
-                collectionTypes,
-                documentIds,
-                skip: page?.skip,
-                take: page?.take,
-            }),
-            documentIds
-                ? Promise.resolve(documentIds.length)
-                : countAuditEntities(db(), { collectionTypes }),
-        ]);
-        const records = entities.map((e) => {
-            const score = calculatePageSeoScore(e);
-            return {
-                id: `${e.entityType}:${e.entityId}`,
-                entityType: e.entityType,
-                entityId: e.entityId,
-                title: e.title,
-                url: e.url,
-                canonicalUrl: e.canonicalUrl ?? null,
-                /** Rendered public title (after site title template). */
-                metaTitle: e.metaTitle ?? null,
-                /** Stored page-specific portion (`%page%` token). */
-                metaTitlePage: e.metaTitlePage ?? null,
-                siteName: siteSeo?.siteName ?? null,
-                titleTemplate: siteSeo?.titleTemplate ?? null,
-                metaDescription: e.metaDescription ?? null,
-                focusKeyword: e.focusKeyword ?? null,
-                keyTakeaway: e.keyTakeaway ?? null,
-                ogTitle: e.ogTitle ?? null,
-                ogDescription: e.ogDescription ?? null,
-                ogImageId: null,
-                ogImage: e.ogImage ?? null,
-                twitterTitle: null,
-                twitterDescription: null,
-                twitterImageId: null,
-                noindex: e.noindex ?? false,
-                nofollow: false,
-                // Permissive defaults; the single-record GET overlays what is stored.
-                nosnippet: false,
-                noarchive: false,
-                maxImagePreview: DEFAULT_DIRECTIVES.maxImagePreview,
-                structuredDataType: e.structuredDataType ?? null,
-                structuredData: null,
-                // llms.txt curation defaults; the single-record GET overlays the real
-                // stored values (the list endpoint doesn't surface these).
-                llmsInclude: 'AUTO',
-                llmsDescription: null,
-                llmsSection: null,
-                llmsOptional: false,
-                seoScore: score.score,
-                seoGrade: score.grade,
-                updatedAt: e.updatedAt instanceof Date
-                    ? e.updatedAt.toISOString()
-                    : typeof e.updatedAt === 'string'
-                        ? e.updatedAt
-                        : null,
-            };
-        });
-        return {
-            records,
-            total,
-            truncated: !documentIds && total > records.length,
-        };
-    }
-    /** Synced GSC data (trailing 28 days). Returns null when there is none yet. */
-    async function loadRealSearchPerformance(limit) {
-        if (!hasModel(db(), 'searchPageInsight'))
-            return null;
-        try {
-            const rows = await db().searchPageInsight.findMany({
-                where: { impressions28d: { gt: 0 } },
-                orderBy: { impressions28d: 'desc' },
-                take: limit,
-            });
-            if (rows.length === 0)
-                return null;
-            const ids = rows.map((r) => r.entityId).filter(Boolean);
-            const titles = new Map();
-            if (ids.length > 0) {
-                const docs = await db().document.findMany({
-                    where: { id: { in: ids } },
-                    select: { id: true, title: true },
-                });
-                for (const d of docs) {
-                    if (d.title)
-                        titles.set(d.id, d.title);
-                }
-            }
-            return rows.map((r) => ({
-                url: r.path,
-                title: (r.entityId && titles.get(r.entityId)) || r.path,
-                impressions: r.impressions28d,
-                clicks: r.clicks28d,
-                ctr: r.impressions28d > 0 ? r.clicks28d / r.impressions28d : 0,
-                averagePosition: r.avgPosition28d ?? 0,
-            }));
-        }
-        catch {
-            return null;
-        }
-    }
-    /**
-     * Synced GSC rows when Search Console is connected; otherwise (or before the
-     * first sync) an empty list. The admin renders its own "not connected" empty
-     * state, and MCP / REST consumers must never see fabricated rows.
-     */
-    async function loadSearchPerformance(limit = 10, connected = false) {
-        if (!connected)
-            return [];
-        return (await loadRealSearchPerformance(limit)) ?? [];
-    }
-    /**
-     * Site-level 28d totals + prior-window deltas from the insight table for the
-     * overview metric cards. Position is impressions-weighted. Null when no
-     * synced data exists (metrics then fall back to the perf-row estimate,
-     * which is empty until Search Console is connected).
-     */
-    async function loadSearchInsightStats() {
-        if (!hasModel(db(), 'searchPageInsight'))
-            return null;
-        try {
-            const rows = (await db().searchPageInsight.findMany({
-                where: { OR: [{ impressions28d: { gt: 0 } }, { impressionsPrev28d: { gt: 0 } }] },
-                select: {
-                    impressions28d: true,
-                    impressionsPrev28d: true,
-                    avgPosition28d: true,
-                    avgPositionPrev28d: true,
-                },
-                take: 2000,
-            }));
-            if (rows.length === 0)
-                return null;
-            let impressions28d = 0;
-            let impressionsPrev28d = 0;
-            let posWeight = 0;
-            let posWeightBase = 0;
-            let prevPosWeight = 0;
-            let prevPosWeightBase = 0;
-            for (const r of rows) {
-                impressions28d += r.impressions28d;
-                impressionsPrev28d += r.impressionsPrev28d;
-                if (r.avgPosition28d !== null && r.impressions28d > 0) {
-                    posWeight += r.avgPosition28d * r.impressions28d;
-                    posWeightBase += r.impressions28d;
-                }
-                if (r.avgPositionPrev28d !== null && r.impressionsPrev28d > 0) {
-                    prevPosWeight += r.avgPositionPrev28d * r.impressionsPrev28d;
-                    prevPosWeightBase += r.impressionsPrev28d;
-                }
-            }
-            return {
-                impressions28d,
-                impressionsPrev28d,
-                avgPosition: posWeightBase > 0 ? posWeight / posWeightBase : null,
-                avgPositionPrev: prevPosWeightBase > 0 ? prevPosWeight / prevPosWeightBase : null,
-            };
-        }
-        catch {
-            return null;
-        }
-    }
-    router.post('/seo/audit', async (request) => {
-        try {
-            const auth = await requireAuth(request);
-            if (auth.error)
-                return auth.error;
-            const roleErr = requireRole(auth.session.role, WRITE_ROLES);
-            if (roleErr)
-                return roleErr;
-            if (!hasModel(db(), 'seoAuditRun') || !hasModel(db(), 'seoIssue')) {
-                return modelNotAvailable('SeoAuditRun');
-            }
-            const ip = clientIp(request);
-            const rateKey = isResolvedIp(ip) ? `seo-audit:${ip}` : `seo-audit-user:${auth.session.userId}`;
-            if (!(await checkRateLimitAsync(seoAuditLimiter, rateKey))) {
-                return errorResponse('Too many audits. Please try again later.', 429);
-            }
-            const body = (await request.json().catch(() => ({})));
-            const scope = body?.scope ?? 'full';
-            const { runAndPersistAudit, frontEndContentCollectionTypes } = await import('../../seo/audit-runner.js');
-            const run = await runAndPersistAudit(db(), {
-                scope,
-                startedById: auth.session.userId,
-                collectionTypes: frontEndContentCollectionTypes(getPrentaConfig()),
-            });
-            try {
-                await logEvent({
-                    event: 'settings_changed',
-                    userId: auth.session.userId,
-                    details: { action: 'seo_audit', auditRunId: run.id, scope },
-                });
-            }
-            catch {
-                /* audit-log failures never block */
-            }
-            return json({
-                data: {
-                    id: run.id,
-                    status: run.status,
-                    siteScoreAfter: run.siteScoreAfter,
-                    issuesFound: run.issuesFound,
-                    criticalCount: run.criticalCount,
-                    warningCount: run.warningCount,
-                    infoCount: run.infoCount,
-                    pagesScanned: run.pagesScanned,
-                    renderedAudit: run.renderedAudit,
-                },
-            });
-        }
-        catch (err) {
-            return internalError(err, 'seo/audit');
-        }
-    });
-    router.get('/seo/audits', async (request) => {
-        try {
-            const auth = await requireAuth(request);
-            if (auth.error)
-                return auth.error;
-            if (!hasModel(db(), 'seoAuditRun'))
-                return json({ data: { runs: [] } });
-            const runs = await db().seoAuditRun.findMany({
-                orderBy: { startedAt: 'desc' },
-                take: 50,
-            });
-            return json({ data: { runs } });
-        }
-        catch (err) {
-            return internalError(err, 'seo/audits');
-        }
-    });
-    router.get('/seo/audits/:id', async (request, params) => {
-        try {
-            const auth = await requireAuth(request);
-            if (auth.error)
-                return auth.error;
-            if (!hasModel(db(), 'seoAuditRun'))
-                return modelNotAvailable('SeoAuditRun');
-            const run = await db().seoAuditRun.findUnique({ where: { id: params.id } });
-            if (!run)
-                return errorResponse('Audit run not found', 404);
-            return json({ data: run });
-        }
-        catch (err) {
-            return internalError(err, 'seo/audits/:id');
-        }
-    });
-    router.get('/seo/issues', async (request) => {
-        try {
-            const auth = await requireAuth(request);
-            if (auth.error)
-                return auth.error;
-            if (!hasModel(db(), 'seoIssue'))
-                return json({ data: { issues: [] } });
-            const url = new URL(request.url);
-            const where = {};
-            const severity = url.searchParams.get('severity');
-            const category = url.searchParams.get('category');
-            const status = url.searchParams.get('status');
-            const auditRunId = url.searchParams.get('auditRunId');
-            if (severity)
-                where.severity = severity;
-            if (category)
-                where.category = category;
-            if (status)
-                where.status = status;
-            else
-                where.status = { in: ['open', 'recurring'] };
-            if (auditRunId)
-                where.auditRunId = auditRunId;
-            const issues = await db().seoIssue.findMany({
-                where,
-                orderBy: { lastDetectedAt: 'desc' },
-                take: 500,
-            });
-            return json({ data: { issues: sortIssuesBySeverity(issues).map(seoIssueToApi) } });
-        }
-        catch (err) {
-            return internalError(err, 'seo/issues');
-        }
-    });
-    router.get('/seo/issues/export-brief', async (request) => {
-        try {
-            const auth = await requireAuth(request);
-            if (auth.error)
-                return auth.error;
-            if (!hasModel(db(), 'seoIssue')) {
-                const { buildSeoFixBriefMarkdown, fixBriefFilename } = await import('../../seo/fix-brief-export.js');
-                return json({
-                    data: {
-                        markdown: buildSeoFixBriefMarkdown({ issues: [], manualOnly: true }),
-                        filename: fixBriefFilename(),
-                        issueCount: 0,
-                    },
-                });
-            }
-            const url = new URL(request.url);
-            const severity = url.searchParams.get('severity');
-            const status = url.searchParams.get('status');
-            const auditRunId = url.searchParams.get('auditRunId');
-            const manualOnly = url.searchParams.get('manualOnly') !== 'false';
-            const includeContentBriefs = url.searchParams.get('includeContentBriefs') !== 'false';
-            const includeContentResearch = url.searchParams.get('includeContentResearch') !== 'false';
-            const where = {};
-            if (severity)
-                where.severity = severity;
-            if (status)
-                where.status = status;
-            else
-                where.status = { in: ['open', 'recurring'] };
-            if (auditRunId)
-                where.auditRunId = auditRunId;
-            const issues = sortIssuesBySeverity(await db().seoIssue.findMany({
-                where,
-                orderBy: { lastDetectedAt: 'desc' },
-                take: 500,
-            }));
-            let runAuditDate = null;
-            let runId = auditRunId;
-            if (auditRunId && hasModel(db(), 'seoAuditRun')) {
-                const run = await db().seoAuditRun.findUnique({ where: { id: auditRunId } });
-                runAuditDate = run?.finishedAt ?? run?.startedAt ?? null;
-            }
-            else if (hasModel(db(), 'seoAuditRun')) {
-                const lastRun = await db().seoAuditRun.findFirst({
-                    where: { status: 'COMPLETED' },
-                    orderBy: { startedAt: 'desc' },
-                });
-                runId = lastRun?.id ?? null;
-                runAuditDate = lastRun?.finishedAt ?? lastRun?.startedAt ?? null;
-            }
-            const { applySeoOverrides, getSeoOverrides } = await import('../../seo/config-store.js');
-            const overrides = await getSeoOverrides(db()).catch(() => null);
-            const mergedConfig = applySeoOverrides(getPrentaConfig(), overrides);
-            const siteSeo = mergedConfig?.seo;
-            const { buildSeoFixBriefMarkdown, filterFixBriefIssues, fixBriefFilename } = await import('../../seo/fix-brief-export.js');
-            const entityIds = [
-                ...new Set(issues
-                    .map((i) => i.entityId)
-                    .filter((id) => typeof id === 'string' && id.length > 0)),
-            ];
-            const updatedAtByEntity = new Map();
-            if ((includeContentBriefs || includeContentResearch) && entityIds.length > 0) {
-                const docs = await db().document.findMany({
-                    where: { id: { in: entityIds }, deletedAt: null },
-                    select: { id: true, updatedAt: true },
-                });
-                for (const doc of docs) {
-                    updatedAtByEntity.set(doc.id, doc.updatedAt instanceof Date ? doc.updatedAt : new Date(doc.updatedAt));
-                }
-            }
-            const { contentBriefFromMetadata } = await import('../../seo/issue-content-brief.js');
-            const { contentResearchFromMetadata } = await import('../../seo/issue-content-research.js');
-            const briefIssues = issues.map((i) => {
-                let contentBrief = null;
-                let contentResearch = null;
-                if (i.entityId) {
-                    const updatedAt = updatedAtByEntity.get(i.entityId);
-                    if (updatedAt) {
-                        if (includeContentBriefs) {
-                            contentBrief = contentBriefFromMetadata(i.metadata, i.type, i.entityId, updatedAt);
-                        }
-                        if (includeContentResearch) {
-                            contentResearch = contentResearchFromMetadata(i.metadata, i.type, i.entityId, updatedAt);
-                        }
-                    }
-                }
-                return {
-                    id: i.id,
-                    type: i.type,
-                    title: i.title,
-                    description: i.description ?? null,
-                    impact: i.impact ?? null,
-                    recommendation: i.recommendation ?? null,
-                    severity: i.severity,
-                    category: i.category,
-                    status: i.status,
-                    entityType: i.entityType ?? null,
-                    entityId: i.entityId ?? null,
-                    entityTitle: i.entityTitle ?? null,
-                    url: i.url ?? null,
-                    fixActionType: i.fixActionType ?? null,
-                    fixable: i.fixable ?? false,
-                    contentBrief,
-                    contentResearch,
-                };
-            });
-            const markdown = buildSeoFixBriefMarkdown({
-                siteName: siteSeo?.siteName ?? null,
-                siteUrl: siteSeo?.siteUrl ?? null,
-                auditRunId: runId,
-                auditDate: runAuditDate,
-                issues: briefIssues,
-                manualOnly,
-            });
-            const issueCount = filterFixBriefIssues(briefIssues, manualOnly).length;
-            return json({
-                data: {
-                    markdown,
-                    filename: fixBriefFilename(siteSeo?.siteName, runAuditDate ?? undefined),
-                    issueCount,
-                },
-            });
-        }
-        catch (err) {
-            return internalError(err, 'seo/issues/export-brief');
-        }
-    });
-    router.post('/seo/issues/batch-content-briefs', async (request) => {
-        try {
-            const auth = await requireAuth(request);
-            if (auth.error)
-                return auth.error;
-            const roleErr = requireRole(auth.session.role, ADMIN_ROLES);
-            if (roleErr)
-                return roleErr;
-            const batchPlanErr = assertPlanFeature('seo.batchContentBriefs');
-            if (batchPlanErr)
-                return planRequiredResponse(batchPlanErr);
-            if (!hasModel(db(), 'seoIssue'))
-                return modelNotAvailable('SeoIssue');
-            if (!(await checkRateLimitAsync(aiGenerateLimiter, `ai-seo-batch-briefs:${auth.session.userId}`))) {
-                return errorResponse('AI rate limit reached. Try again in an hour.', 429);
-            }
-            const body = (await request.json().catch(() => ({})));
-            const severity = typeof body?.severity === 'string' ? body.severity : null;
-            const status = typeof body?.status === 'string' ? body.status : null;
-            const skipExisting = body?.skipExisting !== false;
-            const includeResearch = body?.includeResearch === true;
-            const competitorUrls = Array.isArray(body?.competitorUrls)
-                ? body.competitorUrls.filter((u) => typeof u === 'string')
-                : undefined;
-            const issueIds = Array.isArray(body?.issueIds)
-                ? body.issueIds.filter((id) => typeof id === 'string' && id.length > 0)
-                : null;
-            const where = {};
-            if (severity)
-                where.severity = severity;
-            if (status)
-                where.status = status;
-            else
-                where.status = { in: ['open', 'recurring'] };
-            let issues = await db().seoIssue.findMany({
-                where,
-                orderBy: { lastDetectedAt: 'desc' },
-                take: 500,
-            });
-            if (issueIds?.length) {
-                const idSet = new Set(issueIds);
-                issues = issues.filter((i) => idSet.has(i.id));
-            }
-            const { supportsContentBrief } = await import('../../seo/issue-content-brief.js');
-            const eligible = issues.filter((i) => supportsContentBrief(i.type));
-            const entityIds = [
-                ...new Set(eligible
-                    .map((i) => i.entityId)
-                    .filter((id) => typeof id === 'string' && id.length > 0)),
-            ];
-            const { documentToAuditEntity, frontEndContentCollectionTypes } = await import('../../seo/audit-runner.js');
-            const { applySeoOverrides, getSeoOverrides } = await import('../../seo/config-store.js');
-            const collectionTypes = frontEndContentCollectionTypes(getPrentaConfig());
-            const overrides = await getSeoOverrides(db()).catch(() => null);
-            const mergedConfig = applySeoOverrides(getPrentaConfig(), overrides);
-            const contexts = new Map();
-            if (entityIds.length > 0) {
-                const docs = await db().document.findMany({
-                    where: { id: { in: entityIds }, deletedAt: null },
-                    select: {
-                        id: true,
-                        collection: true,
-                        title: true,
-                        slug: true,
-                        data: true,
-                        structuredData: true,
-                        plainText: true,
-                        publishedAt: true,
-                        updatedAt: true,
-                    },
-                });
-                for (const doc of docs) {
-                    contexts.set(doc.id, {
-                        collection: doc.collection,
-                        entity: documentToAuditEntity(doc, collectionTypes, mergedConfig?.seo),
-                        updatedAt: doc.updatedAt instanceof Date ? doc.updatedAt : new Date(doc.updatedAt),
-                    });
-                }
-            }
-            const { batchGenerateContentBriefs } = await import('../../seo/issue-batch-briefs.js');
-            const result = await batchGenerateContentBriefs(eligible.map((i) => ({
-                id: i.id,
-                type: i.type,
-                title: i.title,
-                description: i.description,
-                recommendation: i.recommendation,
-                entityId: i.entityId,
-                entityType: i.entityType,
-                metadata: i.metadata,
-            })), contexts, { db: db(), userId: auth.session.userId, collection: 'pages' }, { skipExisting, includeResearch, competitorUrls });
-            return json({ data: result });
-        }
-        catch (err) {
-            return internalError(err, 'seo/issues/batch-content-briefs');
-        }
-    });
-    router.get('/seo/issues/:id/content-brief', async (request, params) => {
-        try {
-            const auth = await requireAuth(request);
-            if (auth.error)
-                return auth.error;
-            if (!hasModel(db(), 'seoIssue'))
-                return modelNotAvailable('SeoIssue');
-            const issue = await db().seoIssue.findUnique({ where: { id: params.id } });
-            if (!issue)
-                return errorResponse('Issue not found', 404);
-            const { supportsContentBrief, contentBriefFromMetadata } = await import('../../seo/issue-content-brief.js');
-            if (!supportsContentBrief(issue.type)) {
-                return json({ data: { supported: false, brief: null, stale: false } });
-            }
-            if (!issue.entityId) {
-                return json({ data: { supported: true, brief: null, stale: false } });
-            }
-            const loaded = await loadIssueFixContext(issue);
-            if ('error' in loaded)
-                return loaded.error;
-            const brief = contentBriefFromMetadata(issue.metadata, issue.type, issue.entityId, loaded.updatedAt);
-            const raw = asRecord(issue.metadata)?.contentBrief;
-            const stale = !!raw &&
-                typeof raw === 'object' &&
-                !Array.isArray(raw) &&
-                typeof raw.fingerprint === 'string' &&
-                !brief;
-            return json({ data: { supported: true, brief, stale } });
-        }
-        catch (err) {
-            return internalError(err, 'seo/issues/:id/content-brief');
-        }
-    });
-    router.post('/seo/issues/:id/content-brief', async (request, params) => {
-        try {
-            const auth = await requireAuth(request);
-            if (auth.error)
-                return auth.error;
-            const roleErr = requireRole(auth.session.role, ADMIN_ROLES);
-            if (roleErr)
-                return roleErr;
-            const planErr = assertPlanFeature('seo.contentBrief');
-            if (planErr)
-                return planRequiredResponse(planErr);
-            if (!hasModel(db(), 'seoIssue'))
-                return modelNotAvailable('SeoIssue');
-            if (!(await checkRateLimitAsync(aiGenerateLimiter, `ai-seo-content-brief:${auth.session.userId}`))) {
-                return errorResponse('AI rate limit reached. Try again in an hour.', 429);
-            }
-            const issue = await db().seoIssue.findUnique({ where: { id: params.id } });
-            if (!issue)
-                return errorResponse('Issue not found', 404);
-            const loaded = await loadIssueFixContext(issue);
-            if ('error' in loaded)
-                return loaded.error;
-            const { generateContentBrief, contentBriefToMetadata, supportsContentBrief } = await import('../../seo/issue-content-brief.js');
-            if (!supportsContentBrief(issue.type)) {
-                return errorResponse('This issue type does not support content briefs.', 422);
-            }
-            const result = await generateContentBrief({
-                id: issue.id,
-                type: issue.type,
-                title: issue.title,
-                description: issue.description,
-                recommendation: issue.recommendation,
-                entityId: issue.entityId,
-            }, { entity: loaded.entity, updatedAt: loaded.updatedAt }, { db: db(), userId: auth.session.userId, collection: loaded.collection });
-            if (!result.ok) {
-                return seoAiGenerationError(result);
-            }
-            const existingMeta = asRecord(issue.metadata);
-            await db().seoIssue.update({
-                where: { id: issue.id },
-                data: { metadata: { ...existingMeta, ...contentBriefToMetadata(result.brief) } },
-            });
-            return json({ data: { brief: result.brief } });
-        }
-        catch (err) {
-            return internalError(err, 'seo/issues/:id/content-brief');
-        }
-    });
-    router.get('/seo/issues/:id/content-research', async (request, params) => {
-        try {
-            const auth = await requireAuth(request);
-            if (auth.error)
-                return auth.error;
-            if (!hasModel(db(), 'seoIssue'))
-                return modelNotAvailable('SeoIssue');
-            const issue = await db().seoIssue.findUnique({ where: { id: params.id } });
-            if (!issue)
-                return errorResponse('Issue not found', 404);
-            const { supportsContentResearch, contentResearchFromMetadata } = await import('../../seo/issue-content-research.js');
-            if (!supportsContentResearch(issue.type)) {
-                return json({ data: { supported: false, research: null, stale: false } });
-            }
-            if (!issue.entityId) {
-                return json({ data: { supported: true, research: null, stale: false } });
-            }
-            const loaded = await loadIssueFixContext(issue);
-            if ('error' in loaded)
-                return loaded.error;
-            const research = contentResearchFromMetadata(issue.metadata, issue.type, issue.entityId, loaded.updatedAt);
-            const raw = asRecord(issue.metadata)?.contentResearch;
-            const stale = !!raw &&
-                typeof raw === 'object' &&
-                !Array.isArray(raw) &&
-                typeof raw.fingerprint === 'string' &&
-                !research;
-            return json({ data: { supported: true, research, stale } });
-        }
-        catch (err) {
-            return internalError(err, 'seo/issues/:id/content-research');
-        }
-    });
-    router.post('/seo/issues/:id/content-research', async (request, params) => {
-        try {
-            const auth = await requireAuth(request);
-            if (auth.error)
-                return auth.error;
-            const roleErr = requireRole(auth.session.role, ADMIN_ROLES);
-            if (roleErr)
-                return roleErr;
-            const researchPlanErr = assertPlanFeature('seo.contentResearch');
-            if (researchPlanErr)
-                return planRequiredResponse(researchPlanErr);
-            if (!hasModel(db(), 'seoIssue'))
-                return modelNotAvailable('SeoIssue');
-            if (!(await checkRateLimitAsync(aiGenerateLimiter, `ai-seo-content-research:${auth.session.userId}`))) {
-                return errorResponse('AI rate limit reached. Try again in an hour.', 429);
-            }
-            const body = (await request.json().catch(() => ({})));
-            const competitorUrls = Array.isArray(body?.competitorUrls)
-                ? body.competitorUrls.filter((u) => typeof u === 'string')
-                : undefined;
-            const issue = await db().seoIssue.findUnique({ where: { id: params.id } });
-            if (!issue)
-                return errorResponse('Issue not found', 404);
-            const loaded = await loadIssueFixContext(issue);
-            if ('error' in loaded)
-                return loaded.error;
-            const { generateContentResearch, contentResearchToMetadata, supportsContentResearch } = await import('../../seo/issue-content-research.js');
-            if (!supportsContentResearch(issue.type)) {
-                return errorResponse('This issue type does not support topic research.', 422);
-            }
-            const result = await generateContentResearch({
-                id: issue.id,
-                type: issue.type,
-                title: issue.title,
-                description: issue.description,
-                recommendation: issue.recommendation,
-                entityId: issue.entityId,
-            }, { entity: loaded.entity, updatedAt: loaded.updatedAt }, { db: db(), userId: auth.session.userId, collection: loaded.collection }, { competitorUrls });
-            if (!result.ok) {
-                return seoAiGenerationError(result);
-            }
-            const existingMeta = asRecord(issue.metadata);
-            await db().seoIssue.update({
-                where: { id: issue.id },
-                data: { metadata: { ...existingMeta, ...contentResearchToMetadata(result.research) } },
-            });
-            return json({ data: { research: result.research } });
-        }
-        catch (err) {
-            return internalError(err, 'seo/issues/:id/content-research');
-        }
-    });
-    router.post('/seo/issues/:id/research-and-brief', async (request, params) => {
-        try {
-            const auth = await requireAuth(request);
-            if (auth.error)
-                return auth.error;
-            const roleErr = requireRole(auth.session.role, ADMIN_ROLES);
-            if (roleErr)
-                return roleErr;
-            const comboPlanErr = assertPlanFeature('seo.contentResearch');
-            if (comboPlanErr)
-                return planRequiredResponse(comboPlanErr);
-            if (!hasModel(db(), 'seoIssue'))
-                return modelNotAvailable('SeoIssue');
-            if (!(await checkRateLimitAsync(aiGenerateLimiter, `ai-seo-research-brief:${auth.session.userId}`))) {
-                return errorResponse('AI rate limit reached. Try again in an hour.', 429);
-            }
-            const body = (await request.json().catch(() => ({})));
-            const competitorUrls = Array.isArray(body?.competitorUrls)
-                ? body.competitorUrls.filter((u) => typeof u === 'string')
-                : undefined;
-            const issue = await db().seoIssue.findUnique({ where: { id: params.id } });
-            if (!issue)
-                return errorResponse('Issue not found', 404);
-            const loaded = await loadIssueFixContext(issue);
-            if ('error' in loaded)
-                return loaded.error;
-            const { generateContentResearch, contentResearchToMetadata, supportsContentResearch, contentResearchFromMetadata, } = await import('../../seo/issue-content-research.js');
-            const { generateContentBrief, contentBriefToMetadata, supportsContentBrief } = await import('../../seo/issue-content-brief.js');
-            if (!supportsContentBrief(issue.type)) {
-                return errorResponse('This issue type does not support content briefs.', 422);
-            }
-            const issueInput = {
-                id: issue.id,
-                type: issue.type,
-                title: issue.title,
-                description: issue.description,
-                recommendation: issue.recommendation,
-                entityId: issue.entityId,
-            };
-            const briefCtx = { entity: loaded.entity, updatedAt: loaded.updatedAt };
-            const deps = { db: db(), userId: auth.session.userId, collection: loaded.collection };
-            let research = supportsContentResearch(issue.type)
-                ? contentResearchFromMetadata(issue.metadata, issue.type, issue.entityId, loaded.updatedAt)
-                : null;
-            if (supportsContentResearch(issue.type) && !research) {
-                const researchResult = await generateContentResearch(issueInput, briefCtx, deps, {
-                    competitorUrls,
-                });
-                if (!researchResult.ok) {
-                    return seoAiGenerationError(researchResult);
-                }
-                research = researchResult.research;
-            }
-            const briefResult = await generateContentBrief(issueInput, briefCtx, deps, { research });
-            if (!briefResult.ok) {
-                return seoAiGenerationError(briefResult);
-            }
-            const existingMeta = asRecord(issue.metadata);
-            const metadata = {
-                ...existingMeta,
-                ...contentBriefToMetadata(briefResult.brief),
-                ...(research ? contentResearchToMetadata(research) : {}),
-            };
-            await db().seoIssue.update({
-                where: { id: issue.id },
-                data: { metadata },
-            });
-            return json({ data: { research, brief: briefResult.brief } });
-        }
-        catch (err) {
-            return internalError(err, 'seo/issues/:id/research-and-brief');
-        }
-    });
-    router.get('/seo/issues/:id', async (request, params) => {
-        try {
-            const auth = await requireAuth(request);
-            if (auth.error)
-                return auth.error;
-            if (!hasModel(db(), 'seoIssue'))
-                return modelNotAvailable('SeoIssue');
-            const issue = await db().seoIssue.findUnique({ where: { id: params.id } });
-            if (!issue)
-                return errorResponse('Issue not found', 404);
-            return json({ data: seoIssueToApi(issue) });
-        }
-        catch (err) {
-            return internalError(err, 'seo/issues/:id');
-        }
-    });
-    async function setIssueStatus(request, issueId, status) {
-        const auth = await requireAuth(request);
-        if (auth.error)
-            return auth.error;
-        const roleErr = requireRole(auth.session.role, WRITE_ROLES);
-        if (roleErr)
-            return roleErr;
-        if (!hasModel(db(), 'seoIssue'))
-            return modelNotAvailable('SeoIssue');
-        const existing = await db().seoIssue.findUnique({ where: { id: issueId } });
-        if (!existing)
-            return errorResponse('Issue not found', 404);
-        const issue = await db().seoIssue.update({
-            where: { id: issueId },
-            data: {
-                status,
-                resolvedAt: status === 'resolved' ? new Date() : null,
-                resolvedById: status === 'resolved' ? auth.session.userId : null,
-            },
-        });
-        try {
-            await logEvent({
-                event: 'settings_changed',
-                userId: auth.session.userId,
-                details: { action: 'seo_issue_status', issueId, status },
-            });
-        }
-        catch {
-            /* noop */
-        }
-        return json({ data: seoIssueToApi(issue) });
-    }
-    router.post('/seo/issues/:id/resolve', (request, params) => setIssueStatus(request, params.id, 'resolved').catch((e) => internalError(e)));
-    router.post('/seo/issues/:id/ignore', (request, params) => setIssueStatus(request, params.id, 'ignored').catch((e) => internalError(e)));
-    router.post('/seo/issues/:id/reopen', (request, params) => setIssueStatus(request, params.id, 'open').catch((e) => internalError(e)));
-    /** Load the audit entity + collection for an issue's linked document. */
-    async function loadIssueFixContext(issue) {
-        const { loadIssueFixContext: load } = await import('../../seo/issue-fix-apply.js');
-        const loaded = await load(db(), issue);
-        if (!loaded.ok)
-            return { error: errorResponse(loaded.message, loaded.status) };
-        return loaded.ctx;
-    }
-    router.post('/seo/issues/:id/suggest-fix', async (request, params) => {
-        try {
-            const auth = await requireAuth(request);
-            if (auth.error)
-                return auth.error;
-            if (!hasModel(db(), 'seoIssue'))
-                return modelNotAvailable('SeoIssue');
-            const issue = await db().seoIssue.findUnique({ where: { id: params.id } });
-            if (!issue)
-                return errorResponse('Issue not found', 404);
-            const loaded = await loadIssueFixContext(issue);
-            if ('error' in loaded)
-                return loaded.error;
-            const issueInput = {
-                type: issue.type,
-                title: issue.title,
-                recommendation: issue.recommendation,
-                entityType: issue.entityType,
-                entityId: issue.entityId,
-            };
-            const fixCtx = {
-                entity: loaded.entity,
-                siteSeo: loaded.siteSeo,
-                updatedAt: loaded.updatedAt,
-                metadata: asRecord(issue.metadata),
-            };
-            let aiDeps;
-            const { REDIRECT_FIX_TYPES } = await import('../../seo/issue-fix-redirect.js');
-            const { INSERT_LINK_FIX_TYPES } = await import('../../seo/issue-fix-link-insert.js');
-            if (REDIRECT_FIX_TYPES.has(issue.type) || INSERT_LINK_FIX_TYPES.has(issue.type)) {
-                aiDeps = {
-                    db: db(),
-                    userId: auth.session.userId,
-                    collection: loaded.collection,
-                };
-            }
-            else {
-                const adminErr = requireRole(auth.session.role, ADMIN_ROLES);
-                if (!adminErr &&
-                    hasPlanFeature('seo.inlineApply') &&
-                    (await checkRateLimitAsync(aiGenerateLimiter, `ai-seo-fix-suggest:${auth.session.userId}`))) {
-                    aiDeps = {
-                        db: db(),
-                        userId: auth.session.userId,
-                        collection: loaded.collection,
-                    };
-                }
-            }
-            const { suggestIssueFix } = await import('../../seo/issue-fix.js');
-            const { pendingFixToMetadata, scoreFixBrandAlignment } = await import('../../seo/issue-fix-ai.js');
-            const result = await suggestIssueFix(issueInput, fixCtx, aiDeps);
-            const existingMeta = asRecord(issue.metadata);
-            let nextMetadata;
-            if (result.cacheForApply) {
-                // Deterministic brand-voice score stamped at generation (no LLM call)
-                // so the proposals inbox can badge it without re-scoring.
-                const { getAIConfig } = await import('../../ai/config-store.js');
-                const brandVoice = await getAIConfig(db())
-                    .then((c) => c.settings.brandVoice)
-                    .catch((err) => {
-                    // Fail open: an unreadable AI config must not cost a working suggestion.
-                    seoLogger.warn('AI config unavailable for brand alignment', {
-                        error: err instanceof Error ? err.message : String(err),
-                    });
-                    return undefined;
-                });
-                nextMetadata = {
-                    ...existingMeta,
-                    ...pendingFixToMetadata(result.suggestion, {
-                        brandAlignment: scoreFixBrandAlignment(result.suggestion.changes, brandVoice),
-                    }),
-                };
-            }
-            else {
-                nextMetadata = { ...existingMeta, pendingFix: null };
-            }
-            await db().seoIssue.update({
-                where: { id: issue.id },
-                data: { metadata: nextMetadata },
-            });
-            return json({ data: { suggestion: result.suggestion } });
-        }
-        catch (err) {
-            return internalError(err, 'seo/issues/:id/suggest-fix');
-        }
-    });
-    router.post('/seo/issues/:id/apply-fix', async (request, params) => {
-        try {
-            const auth = await requireAuth(request);
-            if (auth.error)
-                return auth.error;
-            const roleErr = requireRole(auth.session.role, WRITE_ROLES);
-            if (roleErr)
-                return roleErr;
-            if (!hasModel(db(), 'seoIssue'))
-                return modelNotAvailable('SeoIssue');
-            const parsed = await validateBody(request, seoApplyFixBodySchema);
-            if (!parsed.ok)
-                return parsed.error;
-            const body = parsed.data;
-            const [{ applyIssueFix, VERIFY_FAILED_MESSAGE }, { FAQ_HEADING_MAX, FAQ_MAX_ITEMS }] = await Promise.all([
-                import('../../seo/issue-fix-apply.js'),
-                import('../../seo/issue-fix-faq.js'),
-            ]);
-            const fingerprint = typeof body?.fingerprint === 'string' ? body.fingerprint : undefined;
-            // `includeItems` / `headingOverride` only mean something for `add-section`
-            // fixes; they are validated for shape here and ignored by other branches.
-            let includeItems;
-            if (body?.includeItems !== undefined) {
-                const raw = body.includeItems;
-                if (!Array.isArray(raw) ||
-                    raw.length > FAQ_MAX_ITEMS ||
-                    !raw.every((n) => typeof n === 'number' && Number.isInteger(n) && n >= 0) ||
-                    new Set(raw).size !== raw.length) {
-                    return errorResponse(`includeItems must be an array of at most ${FAQ_MAX_ITEMS} distinct non-negative integers`, 400);
-                }
-                includeItems = raw;
-            }
-            let headingOverride;
-            if (body?.headingOverride !== undefined) {
-                // Trimmed length is the one that lands in the section, so it is the one measured.
-                const trimmed = typeof body.headingOverride === 'string' ? body.headingOverride.trim() : null;
-                if (trimmed === null || trimmed.length > FAQ_HEADING_MAX) {
-                    return errorResponse(`headingOverride must be a string of at most ${FAQ_HEADING_MAX} characters`, 400);
-                }
-                headingOverride = trimmed;
-            }
-            const result = await applyIssueFix(db(), {
-                issueId: params.id,
-                fingerprint,
-                includeItems,
-                headingOverride,
-                actor: { userId: auth.session.userId, role: auth.session.role },
-                authorizeContentWrite: contentWriteGate(auth.session),
-            });
-            switch (result.status) {
-                case 'applied':
-                    return json({
-                        data: {
-                            issue: seoIssueToApi(result.issue),
-                            applied: result.applied,
-                            ...(result.sectionId ? { sectionId: result.sectionId } : {}),
-                        },
-                    });
-                case 'stale':
-                    return errorResponse(result.reason, 409);
-                case 'verify-failed':
-                    return json({ error: VERIFY_FAILED_MESSAGE, reason: result.reason }, 409);
-                case 'plan-required':
-                    return planRequiredResponse(result.denial);
-                case 'not-found':
-                    return errorResponse(result.reason, 404);
-                case 'not-allowed':
-                    return errorResponse(result.reason, result.httpStatus);
-                case 'not-fixable':
-                    return errorResponse(result.reason, result.httpStatus);
-                default: {
-                    const _exhaustive = result;
-                    return _exhaustive;
-                }
-            }
-        }
-        catch (err) {
-            return internalError(err, 'seo/issues/:id/apply-fix');
-        }
-    });
-    router.post('/seo/issues/:id/dismiss-fix', async (request, params) => {
-        try {
-            const auth = await requireAuth(request);
-            if (auth.error)
-                return auth.error;
-            const roleErr = requireRole(auth.session.role, WRITE_ROLES);
-            if (roleErr)
-                return roleErr;
-            if (!hasModel(db(), 'seoIssue'))
-                return modelNotAvailable('SeoIssue');
-            const issue = await db().seoIssue.findUnique({ where: { id: params.id } });
-            if (!issue)
-                return errorResponse('Issue not found', 404);
-            const { pendingFixFromMetadata } = await import('../../seo/issue-fix-ai.js');
-            const cached = pendingFixFromMetadata(issue.metadata);
-            if (!cached)
-                return json({ data: { dismissed: false } });
-            // Sticky: remember which document state was rejected so batch
-            // generation does not recreate it until the document changes. The
-            // marker must match the entity-based live fingerprint the no-cache
-            // path computes, which differs from the cached one for insert-link.
-            const { dismissalFingerprintFor } = await import('../../seo/proposals.js');
-            const entityDoc = typeof issue.entityId === 'string'
-                ? await db()
-                    .document.findUnique({ where: { id: issue.entityId }, select: { updatedAt: true } })
-                    .catch(() => null)
-                : null;
-            const dismissedFingerprint = dismissalFingerprintFor(issue, cached, entityDoc?.updatedAt ?? null);
-            await db().seoIssue.update({
-                where: { id: issue.id },
-                data: {
-                    metadata: {
-                        ...asRecord(issue.metadata),
-                        pendingFix: null,
-                        dismissedFingerprint,
-                    },
-                },
-            });
-            try {
-                await logEvent({
-                    event: 'seo_fix_dismissed',
-                    userId: auth.session.userId,
-                    details: {
-                        issueId: issue.id,
-                        issueType: issue.type,
-                        entityId: issue.entityId ?? null,
-                        fingerprint: dismissedFingerprint,
-                        source: cached.source,
-                    },
-                });
-            }
-            catch {
-                /* audit-log failures never block */
-            }
-            return json({ data: { dismissed: true } });
-        }
-        catch (err) {
-            return internalError(err, 'seo/issues/:id/dismiss-fix');
-        }
-    });
-    // Any authenticated user, like GET /seo/issues and GET /seo/overview: editors
-    // read the inbox and act through the WRITE_ROLES mutation routes.
-    router.get('/seo/proposals', async (request) => {
-        try {
-            const auth = await requireAuth(request);
-            if (auth.error)
-                return auth.error;
-            const { listSeoProposals } = await import('../../seo/proposals.js');
-            return json({ data: await listSeoProposals(db()) });
-        }
-        catch (err) {
-            return internalError(err, 'seo/proposals');
-        }
-    });
-    router.post('/seo/proposals/generate', async (request) => {
-        try {
-            const auth = await requireAuth(request);
-            if (auth.error)
-                return auth.error;
-            const roleErr = requireRole(auth.session.role, ADMIN_ROLES);
-            if (roleErr)
-                return roleErr;
-            const planErr = assertPlanFeature('seo.inlineApply');
-            if (planErr)
-                return planRequiredResponse(planErr);
-            if (!hasModel(db(), 'seoIssue'))
-                return modelNotAvailable('SeoIssue');
-            const body = (await request.json().catch(() => ({})));
-            if (body?.confirm !== true) {
-                return errorResponse('Pass { "confirm": true } to generate proposals.', 400);
-            }
-            if (!(await checkRateLimitAsync(aiGenerateLimiter, `ai-seo-proposals-generate:${auth.session.userId}`))) {
-                return errorResponse('AI rate limit reached. Try again in an hour.', 429);
-            }
-            const { generateSeoProposals } = await import('../../seo/proposals-generate.js');
-            const result = await generateSeoProposals(db(), { userId: auth.session.userId });
-            return json({ data: result });
-        }
-        catch (err) {
-            return internalError(err, 'seo/proposals/generate');
-        }
-    });
-    // WRITE_ROLES like the per-item apply-fix route; redirect items are
-    // additionally admin-gated per item inside the service (spec §4).
-    router.post('/seo/proposals/bulk-apply', async (request) => {
-        try {
-            const auth = await requireAuth(request);
-            if (auth.error)
-                return auth.error;
-            const roleErr = requireRole(auth.session.role, WRITE_ROLES);
-            if (roleErr)
-                return roleErr;
-            if (!hasModel(db(), 'seoIssue'))
-                return modelNotAvailable('SeoIssue');
-            const parsed = await validateBody(request, seoBulkApplyBodySchema);
-            if (!parsed.ok)
-                return parsed.error;
-            const rawItems = parsed.data.items;
-            const { PROPOSAL_BULK_APPLY_MAX, bulkApplySeoProposals } = await import('../../seo/proposals-bulk-apply.js');
-            if (rawItems.length > PROPOSAL_BULK_APPLY_MAX) {
-                return errorResponse(`At most ${PROPOSAL_BULK_APPLY_MAX} items per bulk apply.`, 400);
-            }
-            const items = rawItems.map((item) => ({
-                kind: item.kind,
-                id: item.id,
-                fingerprint: item.fingerprint,
-            }));
-            const result = await bulkApplySeoProposals(db(), {
-                items,
-                actor: { userId: auth.session.userId, role: auth.session.role },
-                authorizeContentWrite: contentWriteGate(auth.session),
-            });
-            if (result.blocked) {
-                return json({ error: result.reason, code: 'governance_blocked' }, 403);
-            }
-            return json({
-                data: {
-                    results: result.results,
-                    applied: result.applied,
-                    failed: result.failed,
-                    pending: result.pending,
-                },
-            });
-        }
-        catch (err) {
-            return internalError(err, 'seo/proposals/bulk-apply');
-        }
-    });
-    router.get('/seo/overview', async (request) => {
-        try {
-            const auth = await requireAuth(request);
-            if (auth.error)
-                return auth.error;
-            const { resolveSeoModuleSettings, getSeoOverrides } = await import('../../seo/config-store.js');
-            const { buildQuickWins } = await import('../../seo/audit-engine.js');
-            const { gradeForSeoScore } = await import('../../seo/score.js');
-            const overrides = await getSeoOverrides(db()).catch(() => null);
-            const moduleSettings = resolveSeoModuleSettings(overrides);
-            let lastRun = null;
-            let openIssues = [];
-            if (hasModel(db(), 'seoAuditRun')) {
-                lastRun = await db().seoAuditRun.findFirst({
-                    where: { status: 'COMPLETED' },
-                    orderBy: { startedAt: 'desc' },
-                });
-            }
-            if (hasModel(db(), 'seoIssue')) {
-                const rawIssues = await db().seoIssue.findMany({
-                    where: { status: { in: ['open', 'recurring'] } },
-                    orderBy: { lastDetectedAt: 'desc' },
-                    take: 200,
-                });
-                openIssues = sortIssuesBySeverity(rawIssues);
-            }
-            const { frontEndContentCollectionTypes, countAuditEntities } = await import('../../seo/audit-runner.js');
-            const collectionTypes = frontEndContentCollectionTypes(getPrentaConfig());
-            const total = await countAuditEntities(db(), { collectionTypes }).catch(() => 0);
-            const meta = (lastRun?.metadata ?? {});
-            const indexable = typeof meta.indexableCount === 'number' && Number.isFinite(meta.indexableCount)
-                ? meta.indexableCount
-                : total;
-            const auditTruncated = meta.truncated === true;
-            const perf = await loadSearchPerformance(10, moduleSettings.searchConsoleConnected);
-            const searchStats = moduleSettings.searchConsoleConnected
-                ? await loadSearchInsightStats()
-                : null;
-            const summary = {
-                total: openIssues.length,
-                critical: openIssues.filter((i) => i.severity === 'critical').length,
-                warning: openIssues.filter((i) => i.severity === 'warning').length,
-                info: openIssues.filter((i) => i.severity === 'info').length,
-            };
-            const { countPendingProposals } = await import('../../seo/proposals.js');
-            const pendingProposals = await countPendingProposals(db(), openIssues).catch(() => ({
-                issueFixes: 0,
-                redirects: 0,
-            }));
-            const scoreAfter = lastRun?.siteScoreAfter ?? null;
-            const scoreBefore = lastRun?.siteScoreBefore ?? null;
-            const breakdown = lastRun?.metadata?.breakdown ?? [];
-            // Real site-level stats (weighted by impressions, with prior-window
-            // trends) when synced data exists; the perf-row estimate otherwise.
-            const avgPosition = searchStats?.avgPosition ??
-                (perf.length > 0
-                    ? perf.reduce((s, r) => s + r.averagePosition, 0) / perf.length
-                    : null);
-            const impressions28d = searchStats?.impressions28d ?? perf.reduce((s, r) => s + r.impressions, 0);
-            // Position: lower is better, so an "up" trend means the number dropped.
-            let positionTrend = 'flat';
-            if (searchStats?.avgPosition != null && searchStats.avgPositionPrev != null) {
-                const delta = searchStats.avgPosition - searchStats.avgPositionPrev;
-                if (delta <= -0.5)
-                    positionTrend = 'up';
-                else if (delta >= 0.5)
-                    positionTrend = 'down';
-            }
-            let impressionsTrend = 'flat';
-            if (searchStats && searchStats.impressionsPrev28d > 0) {
-                const ratio = searchStats.impressions28d / searchStats.impressionsPrev28d;
-                if (ratio >= 1.05)
-                    impressionsTrend = 'up';
-                else if (ratio <= 0.95)
-                    impressionsTrend = 'down';
-            }
-            const metrics = [
-                {
-                    label: 'Pages Indexed',
-                    value: String(indexable),
-                    helper: auditTruncated ? `${total} published (audit capped)` : `${total} published pages`,
-                    trend: 'flat',
-                },
-                {
-                    label: 'Open Issues',
-                    value: String(summary.total),
-                    helper: `${summary.critical} critical`,
-                    trend: summary.critical > 0 ? 'down' : 'flat',
-                },
-                {
-                    label: 'Avg. Position',
-                    value: avgPosition !== null ? avgPosition.toFixed(1) : '—',
-                    helper: moduleSettings.searchConsoleConnected
-                        ? searchStats?.avgPositionPrev != null
-                            ? `was ${searchStats.avgPositionPrev.toFixed(1)} the prior 28 days`
-                            : 'last 28 days'
-                        : 'Connect Search Console',
-                    trend: positionTrend,
-                },
-                {
-                    label: 'Impressions',
-                    value: impressions28d > 0 ? formatCompactNumber(impressions28d) : '—',
-                    helper: moduleSettings.searchConsoleConnected
-                        ? searchStats && searchStats.impressionsPrev28d > 0
-                            ? `was ${formatCompactNumber(searchStats.impressionsPrev28d)} the prior 28 days`
-                            : 'last 28 days'
-                        : 'Connect Search Console',
-                    trend: impressionsTrend,
-                },
-            ];
-            // Weight quick wins by real traffic when synced search data exists.
-            const impressionsByEntityId = {};
-            if (moduleSettings.searchConsoleConnected && hasModel(db(), 'searchPageInsight')) {
-                try {
-                    const impressionRows = (await db().searchPageInsight.findMany({
-                        where: { entityId: { not: null }, impressions28d: { gt: 0 } },
-                        select: { entityId: true, impressions28d: true },
-                        take: 2000,
-                    }));
-                    for (const r of impressionRows) {
-                        if (r.entityId)
-                            impressionsByEntityId[r.entityId] = r.impressions28d;
-                    }
-                }
-                catch {
-                    /* weighting is optional */
-                }
-            }
-            const quickWins = buildQuickWins(openIssues.map((i) => ({
-                issueKey: i.issueKey,
-                entityType: i.entityType,
-                entityId: i.entityId,
-                entityTitle: i.entityTitle,
-                url: i.url,
-                severity: i.severity,
-                category: i.category,
-                type: i.type,
-                title: i.title,
-                description: i.description ?? '',
-                impact: i.impact ?? 'Low',
-                recommendation: i.recommendation ?? '',
-                fixable: i.fixable ?? false,
-                fixActionType: i.fixActionType ?? null,
-                relatedEntityIds: Array.isArray(i.relatedEntityIds) ? i.relatedEntityIds : [],
-            })), { impressionsByEntityId }).map((w) => ({
-                id: w.id,
-                title: w.title,
-                explanation: w.explanation,
-                impact: w.impact,
-                issueId: openIssues.find((i) => i.type === w.issueType)?.id ?? null,
-                fixActionType: w.fixActionType,
-            }));
-            return json({
-                data: {
-                    siteScore: {
-                        score: scoreAfter ?? 0,
-                        grade: gradeForSeoScore(scoreAfter ?? 0),
-                        delta: scoreAfter !== null && scoreBefore !== null ? scoreAfter - scoreBefore : null,
-                        breakdown,
-                    },
-                    metrics,
-                    issues: openIssues.slice(0, 7).map(seoIssueToApi),
-                    issuesSummary: summary,
-                    quickWins,
-                    searchPerformance: perf,
-                    searchConsoleConnected: moduleSettings.searchConsoleConnected,
-                    lastAuditRunId: lastRun?.id ?? null,
-                    auditTruncated,
-                    pendingProposals,
-                },
-            });
-        }
-        catch (err) {
-            return internalError(err, 'seo/overview');
-        }
-    });
-    router.get('/seo/search-performance', async (request) => {
-        try {
-            const auth = await requireAuth(request);
-            if (auth.error)
-                return auth.error;
-            const url = new URL(request.url);
-            const limit = Math.min(50, Math.max(1, Number(url.searchParams.get('limit') ?? 10)));
-            const { getSeoOverrides, resolveSeoModuleSettings } = await import('../../seo/config-store.js');
-            const settings = resolveSeoModuleSettings(await getSeoOverrides(db()));
-            const rows = await loadSearchPerformance(limit, settings.searchConsoleConnected);
-            return json({ data: { rows } });
-        }
-        catch (err) {
-            return internalError(err, 'seo/search-performance');
-        }
-    });
-    // Per-document search insight (synced GSC + CrUX) for the editor pane's
-    // read-only stats block. `insight: null` when not synced or no data.
-    router.get('/seo/search-insights/:entityId', async (request, params) => {
-        try {
-            const auth = await requireAuth(request);
-            if (auth.error)
-                return auth.error;
-            const entityId = params.entityId;
-            if (!entityId)
-                return errorResponse('entityId is required', 400);
-            const { getSeoOverrides, resolveSeoModuleSettings } = await import('../../seo/config-store.js');
-            const settings = resolveSeoModuleSettings(await getSeoOverrides(db()));
-            const connected = settings.searchConsoleConnected;
-            if (!connected || !hasModel(db(), 'searchPageInsight')) {
-                return json({ data: { connected, insight: null } });
-            }
-            const row = await db().searchPageInsight.findFirst({
-                where: { entityId },
-                select: {
-                    path: true,
-                    clicks28d: true,
-                    impressions28d: true,
-                    avgPosition28d: true,
-                    clicksPrev28d: true,
-                    impressionsPrev28d: true,
-                    avgPositionPrev28d: true,
-                    topQueries: true,
-                    lcpMs: true,
-                    inpMs: true,
-                    cls: true,
-                    cwvStatus: true,
-                    lastSyncedAt: true,
-                },
-            });
-            return json({
-                data: {
-                    connected,
-                    insight: row
-                        ? {
-                            ...row,
-                            topQueries: Array.isArray(row.topQueries) ? row.topQueries : [],
-                            lastSyncedAt: row.lastSyncedAt instanceof Date
-                                ? row.lastSyncedAt.toISOString()
-                                : row.lastSyncedAt,
-                        }
-                        : null,
-                },
-            });
-        }
-        catch (err) {
-            return internalError(err, 'seo/search-insights');
-        }
-    });
-    router.get('/seo/content', async (request) => {
-        try {
-            const auth = await requireAuth(request);
-            if (auth.error)
-                return auth.error;
-            // Scope the list to the collections this caller may read — otherwise a
-            // collection-scoped API key (or a collection-restricted role) could pull
-            // metaTitle/description/canonical/OG for every collection, the exact
-            // bypass the sibling document-level SEO endpoints already prevent.
-            const allowed = await readableSeoCollections(auth.session);
-            const url = new URL(request.url);
-            const page = clampPage(url.searchParams.get('page'));
-            const pageSize = clampPageSize(url.searchParams.get('pageSize'), 100, 50);
-            const result = await buildSeoContentRecords(allowed, undefined, {
-                skip: (page - 1) * pageSize,
-                take: pageSize,
-            });
-            return json({
-                data: {
-                    records: result.records,
-                    total: result.total,
-                    page,
-                    pageSize,
-                    truncated: result.truncated,
-                },
-            });
-        }
-        catch (err) {
-            return internalError(err, 'seo/content');
-        }
-    });
-    router.get('/seo/content/:entityType/:entityId', async (request, params) => {
-        try {
-            const auth = await requireAuth(request);
-            if (auth.error)
-                return auth.error;
-            // Load the target first so we can enforce the collection's read-access
-            // rule (requireCollectionScope + assertCollectionAccess) before returning
-            // any SEO fields — parity with /seo/analysis and friends.
-            const doc = await db().document.findFirst({
-                where: { id: params.entityId, deletedAt: null },
-                select: { data: true, collection: true },
-            });
-            if (!doc)
-                return errorResponse('Content record not found', 404);
-            const accessErr = await enforceDocumentReadAccess(auth.session, doc.collection);
-            if (accessErr)
-                return accessErr;
-            // Scoped to THIS document and not filtered by publication status: a saved
-            // draft has SEO worth editing, and the matching PUT accepts one. Resolving
-            // through the published-only gather made drafts 404 here while remaining
-            // writable — so an editor could save SEO and never read it back.
-            const { records } = await buildSeoContentRecords(null, [params.entityId]);
-            const record = records.find((r) => r.entityType === params.entityType && r.entityId === params.entityId);
-            if (!record)
-                return errorResponse('Content record not found', 404);
-            // Overlay the real llms.txt curation values from the stored document
-            // (the audit-entity pipeline that builds the base record doesn't carry
-            // these convention keys).
-            const data = asRecord(doc.data);
-            const includeRaw = String(data.llmsInclude ?? '').toUpperCase();
-            const merged = {
-                ...record,
-                llmsInclude: includeRaw === 'ALWAYS' || includeRaw === 'NEVER'
-                    ? includeRaw
-                    : 'AUTO',
-                llmsDescription: typeof data.llmsDescription === 'string' ? data.llmsDescription : null,
-                llmsSection: typeof data.llmsSection === 'string' ? data.llmsSection : null,
-                llmsOptional: data.llmsOptional === true,
-                // Robots directives live in the same content JSON. Overlaid here for
-                // the same reason as the llms.txt keys: the audit-entity pipeline that
-                // builds the base record does not carry them, so without this the
-                // editor would read every page back as fully permissive and silently
-                // overwrite a real restriction on the next save.
-                nosnippet: data.nosnippet === true,
-                noarchive: data.noarchive === true,
-                maxImagePreview: coerceMaxImagePreview(data.maxImagePreview),
-            };
-            return json({ data: merged });
-        }
-        catch (err) {
-            return internalError(err, 'seo/content/:id');
-        }
-    });
-    router.put('/seo/content/:entityType/:entityId', async (request, params) => {
-        try {
-            const auth = await requireAuth(request);
-            if (auth.error)
-                return auth.error;
-            const roleErr = requireRole(auth.session.role, WRITE_ROLES);
-            if (roleErr)
-                return roleErr;
-            const body = (await request.json().catch(() => null));
-            if (!body || typeof body !== 'object') {
-                return errorResponse('Request body must be an object', 400);
-            }
-            const doc = await db().document.findFirst({
-                where: { id: params.entityId, deletedAt: null },
-                select: { id: true, collection: true },
-            });
-            if (!doc)
-                return errorResponse('Document not found', 404);
-            // String SEO fields: payload key -> stored data key, each with a max
-            // length so we never persist unbounded/megabyte values into the content
-            // JSON. Canonical is stored as `canonical` to match normalizeSeoPage.
-            const TEXT_FIELDS = {
-                metaTitle: { target: 'metaTitle', max: 300 },
-                metaDescription: { target: 'metaDescription', max: 1000 },
-                canonicalUrl: { target: 'canonical', max: 2000 },
-                focusKeyword: { target: 'focusKeyword', max: 200 },
-                keyTakeaway: { target: 'keyTakeaway', max: 500 },
-                ogTitle: { target: 'ogTitle', max: 300 },
-                ogDescription: { target: 'ogDescription', max: 1000 },
-                ogImage: { target: 'ogImage', max: 2000 },
-                twitterTitle: { target: 'twitterTitle', max: 300 },
-                twitterDescription: { target: 'twitterDescription', max: 1000 },
-                twitterImage: { target: 'twitterImage', max: 2000 },
-                structuredDataType: { target: 'structuredDataType', max: 100 },
-                schemaType: { target: 'schemaType', max: 100 },
-                llmsDescription: { target: 'llmsDescription', max: 500 },
-                llmsSection: { target: 'llmsSection', max: 100 },
-            };
-            const patch = {};
-            for (const [key, { target, max }] of Object.entries(TEXT_FIELDS)) {
-                if (!(key in body))
-                    continue;
-                const value = body[key];
-                if (value === null || value === '') {
-                    patch[target] = '';
-                    continue;
-                }
-                if (typeof value !== 'string') {
-                    return errorResponse(`Field "${key}" must be a string`, 400);
-                }
-                if (value.length > max) {
-                    return errorResponse(`Field "${key}" exceeds the ${max}-character limit`, 400);
-                }
-                patch[target] = value;
-            }
-            if ('noindex' in body)
-                patch.noindex = body.noindex === true;
-            if ('nofollow' in body)
-                patch.nofollow = body.nofollow === true;
-            if ('nosnippet' in body)
-                patch.nosnippet = body.nosnippet === true;
-            if ('noarchive' in body)
-                patch.noarchive = body.noarchive === true;
-            if ('maxImagePreview' in body) {
-                // Coerced rather than rejected: the field is an enum with a permissive
-                // default, and refusing the write would block an otherwise valid patch
-                // over a value the composer already knows how to fall back from.
-                patch.maxImagePreview = coerceMaxImagePreview(body.maxImagePreview);
-            }
-            if ('llmsOptional' in body)
-                patch.llmsOptional = body.llmsOptional === true;
-            if ('llmsInclude' in body) {
-                const v = String(body.llmsInclude ?? '').toUpperCase();
-                if (v !== 'AUTO' && v !== 'ALWAYS' && v !== 'NEVER') {
-                    return errorResponse('llmsInclude must be one of AUTO, ALWAYS, NEVER', 400);
-                }
-                // AUTO is the default — store empty so the field falls back cleanly.
-                patch.llmsInclude = v === 'AUTO' ? '' : v;
-            }
-            if ('llmsPriority' in body) {
-                const n = body.llmsPriority;
-                if (n !== null && typeof n !== 'number') {
-                    return errorResponse('llmsPriority must be a number', 400);
-                }
-                patch.llmsPriority = n ?? 0;
-            }
-            if ('structuredData' in body) {
-                const sd = body.structuredData;
-                if (sd !== null && (typeof sd !== 'object' || Array.isArray(sd))) {
-                    return errorResponse('structuredData must be a JSON object', 400);
-                }
-                if (sd && JSON.stringify(sd).length > 50_000) {
-                    return errorResponse('structuredData payload is too large', 400);
-                }
-                patch.structuredData = sd;
-            }
-            if (Object.keys(patch).length === 0) {
-                return errorResponse('No recognized SEO fields in request body', 400);
-            }
-            if ('structuredDataType' in patch || 'schemaType' in patch) {
-                Object.assign(patch, syncSchemaTypeFields(patch));
-            }
-            // Route through the data layer so the edit gets per-collection access
-            // control, a Version snapshot, search re-indexing and the afterUpdate
-            // hook — never write document.data directly. (updateDocumentSeoFields
-            // preserves the undeclared SEO convention keys that the generic
-            // updateDocument field-access layer would strip.)
-            const ctx = buildActionContext(auth.session, db());
-            try {
-                await updateDocumentSeoFields(doc.collection, doc.id, patch, ctx);
-            }
-            catch (err) {
-                const msg = err instanceof Error ? err.message : '';
-                if (msg.includes('Access denied'))
-                    return errorResponse('Insufficient permissions', 403);
-                if (msg.includes('not found'))
-                    return errorResponse('Document not found', 404);
-                throw err;
-            }
-            try {
-                await logEvent({
-                    event: 'document_updated',
-                    userId: auth.session.userId,
-                    details: { action: 'seo_fields_update', documentId: doc.id },
-                });
-            }
-            catch {
-                /* noop */
-            }
-            const { records } = await buildSeoContentRecords(null, [doc.id]);
-            const record = records.find((r) => r.entityId === doc.id);
-            return json({ data: record ?? { ok: true } });
-        }
-        catch (err) {
-            return internalError(err, 'seo/content PUT');
-        }
-    });
-    // ---------------------------------------------------------------------------
-    // SEO analysis, readability, internal links, schema, meta
-    // ---------------------------------------------------------------------------
-    router.get('/seo/analysis/:documentId', async (request, params) => {
-        try {
-            const auth = await requireAuth(request);
-            if (auth.error)
-                return auth.error;
-            const doc = await db().document.findFirst({
-                where: { id: params.documentId, deletedAt: null },
-            });
-            if (!doc)
-                return errorResponse('Not found', 404);
-            const accessErr = await enforceDocumentReadAccess(auth.session, doc.collection);
-            if (accessErr)
-                return accessErr;
-            const { analyzeContent } = await import('../../seo/analysis.js');
-            const { documentToAuditEntity, frontEndContentCollectionTypes } = await import('../../seo/audit-runner.js');
-            const { applySeoOverrides, getSeoOverrides } = await import('../../seo/config-store.js');
-            const data = doc.data || {};
-            // Same content assembly as readability + audit entity (`documentContentForSeoAnalysis`)
-            // so MCP/admin scores agree and section-built pages still get plainText/sections.
-            const collectionTypes = frontEndContentCollectionTypes(getPrentaConfig());
-            const overrides = await getSeoOverrides(db()).catch(() => null);
-            const siteSeo = applySeoOverrides(getPrentaConfig(), overrides)?.seo;
-            const entity = documentToAuditEntity(doc, collectionTypes, siteSeo);
-            const result = analyzeContent({
-                title: entity.title,
-                slug: doc.slug || data.slug || '',
-                content: entity.content ?? '',
-                // Rendered title (site template applied) — the same value the page
-                // score measures, so both agree instead of one reading the page portion.
-                metaTitle: entity.metaTitle ?? undefined,
-                metaDescription: entity.metaDescription ?? undefined,
-                focusKeyphrase: entity.focusKeyword ?? undefined,
-                canonical: entity.canonicalUrl ?? undefined,
-                ogTitle: entity.ogTitle ?? undefined,
-                ogDescription: entity.ogDescription ?? undefined,
-                ogImage: entity.ogImage ?? undefined,
-                extraImages: extraImagesForSeoAnalysis(data),
-                entityType: entity.entityType,
-                sectionH1: firstSectionHeading(data) ?? undefined,
-                isCornerstone: data.isCornerstone,
-            });
-            return new Response(JSON.stringify(result), {
-                status: 200,
-                headers: { 'Content-Type': 'application/json' },
-            });
-        }
-        catch (err) {
-            return internalError(err, 'seo/analysis');
-        }
-    });
-    router.get('/seo/readability/:documentId', async (request, params) => {
-        try {
-            const auth = await requireAuth(request);
-            if (auth.error)
-                return auth.error;
-            const doc = await db().document.findFirst({
-                where: { id: params.documentId, deletedAt: null },
-            });
-            if (!doc)
-                return errorResponse('Not found', 404);
-            const accessErr = await enforceDocumentReadAccess(auth.session, doc.collection);
-            if (accessErr)
-                return accessErr;
-            const { calculateReadability, stripHtmlTags } = await import('../../seo/analysis.js');
-            const { documentContentForSeoAnalysis } = await import('../../seo/document-content.js');
-            const text = stripHtmlTags(documentContentForSeoAnalysis(doc));
-            const result = calculateReadability(text);
-            return new Response(JSON.stringify(result), {
-                status: 200,
-                headers: { 'Content-Type': 'application/json' },
-            });
-        }
-        catch (err) {
-            return internalError(err, 'seo/readability');
-        }
-    });
-    router.get('/seo/internal-links/:documentId', async (request, params) => {
-        try {
-            const auth = await requireAuth(request);
-            if (auth.error)
-                return auth.error;
-            const doc = await db().document.findFirst({
-                where: { id: params.documentId, deletedAt: null },
-            });
-            if (!doc)
-                return errorResponse('Not found', 404);
-            const accessErr = await enforceDocumentReadAccess(auth.session, doc.collection);
-            if (accessErr)
-                return accessErr;
-            const data = doc.data || {};
-            const title = doc.title || data.title || '';
-            const keywords = title
-                .split(/\s+/)
-                .filter((w) => w.length > 3)
-                .slice(0, 5);
-            if (keywords.length === 0) {
-                return new Response(JSON.stringify({ suggestions: [] }), {
-                    status: 200,
-                    headers: { 'Content-Type': 'application/json' },
-                });
-            }
-            const suggestions = await db().document.findMany({
-                where: {
-                    id: { not: params.documentId },
-                    status: 'PUBLISHED',
-                    deletedAt: null,
-                    OR: keywords.map((kw) => ({
-                        title: { contains: kw, mode: 'insensitive' },
-                    })),
-                },
-                select: { id: true, title: true, slug: true, collection: true },
-                take: 10,
-                orderBy: { updatedAt: 'desc' },
-            });
-            return new Response(JSON.stringify({ suggestions }), {
-                status: 200,
-                headers: { 'Content-Type': 'application/json' },
-            });
-        }
-        catch (err) {
-            return internalError(err, 'seo/internal-links');
-        }
-    });
-    router.get('/llms.txt', async (request) => {
-        try {
-            // Public surface: must exclude soft-deleted docs and internal/system
-            // collections (e.g. `__seo_config__`). Over-fetch then filter so the
-            // 50-page cap still lands on real content after exclusion.
-            const { isInternalCollection } = await import('../../seo/audit-runner.js');
-            const { siteUrlFromRequest, loadEffectiveConfig } = await import('./seo-public.js');
-            // Layer DB overrides (Settings → SEO) so an admin-edited siteName /
-            // defaultMetaDescription flows into the llms heading + summary too, exactly
-            // as sitemap.xml, robots.txt, /og.png and the feeds already do.
-            const cfg = (await loadEffectiveConfig()) ?? getPrentaConfig();
-            const llmsCfg = cfg?.seo?.llms;
-            const base = siteUrlFromRequest(request, cfg);
-            // Operators can disable the file entirely (it's optionality, not a
-            // guaranteed traffic channel).
-            if (llmsCfg?.disabled) {
-                return new Response('Not found', { status: 404 });
-            }
-            const maxEntries = llmsCfg?.maxEntries ?? 50;
-            const maxPerSection = llmsCfg?.maxPerSection ?? 25;
-            // Restrict AUTO selection to the configured high-value collections when
-            // set, so blog archives don't flood the curated guide.
-            const eligible = Array.isArray(llmsCfg?.eligibleCollections) && llmsCfg.eligibleCollections.length > 0
-                ? new Set(llmsCfg.eligibleCollections)
-                : null;
-            const rawDocs = await db().document.findMany({
-                where: { status: 'PUBLISHED', deletedAt: null },
-                select: { title: true, slug: true, collection: true, updatedAt: true, data: true },
-                orderBy: { updatedAt: 'desc' },
-                take: 500,
-            });
-            // Per-doc curation + privacy boundary (noindex exclusion) live in the
-            // shared selector so `/llms.txt` and `/llms-full.txt` can never diverge.
-            const { selectLlmsDocs, toLlmsPage } = await import('../../seo/llms-select.js');
-            const selected = selectLlmsDocs(rawDocs, { isInternalCollection, eligible });
-            const { generateLlmsTxt } = await import('../../seo/llms-txt.js');
-            const pages = selected.map((d) => toLlmsPage(d, {
-                base,
-                urlPrefix: cfg?.collections?.[d.collection]?.urlPrefix,
-                trailingSlash: cfg?.seo?.trailingSlash,
-            }));
-            const txt = generateLlmsTxt({
-                siteName: cfg?.seo?.siteName || 'Prenta CMS',
-                siteUrl: base,
-                siteDescription: llmsCfg?.summary || cfg?.seo?.defaultMetaDescription || 'Content managed by Prenta CMS',
-                intro: llmsCfg?.intro,
-                maxPages: maxEntries,
-                maxPerSection,
-            }, pages);
-            // Opt-in honeypot: append a unique trap link. No human reads llms.txt, so
-            // a fetch of this URL is an automated reader — recorded under the
-            // "honeypot" surface in the AI-crawler panel.
-            let body = txt;
-            if (llmsCfg?.honeypot) {
-                const trapUrl = `${base.replace(/\/$/, '')}/api/cms/ai-crawlers/trap`;
-                body += `\n## Reference\n\n- [Complete content index](${trapUrl}): Full machine-readable content map.\n`;
-            }
-            // Measurement: if a known AI crawler fetched the index, count it.
-            await recordAiCrawlerFromRequest(db(), request, 'llms');
-            return new Response(body, {
-                status: 200,
-                headers: {
-                    'Content-Type': 'text/plain; charset=utf-8',
-                    // The file itself is a machine-facing index, not a page to rank.
-                    'X-Robots-Tag': 'noindex',
-                    // Same CDN TTL as robots.txt — the index is cheap to regenerate
-                    // after publish but should not be fetched on every agent request.
-                    'Cache-Control': 'public, max-age=3600, s-maxage=3600',
-                },
-            });
-        }
-        catch (err) {
-            return internalError(err, 'llms.txt');
-        }
-    });
-    // `/llms-full.txt` — same curated selection as `/llms.txt`, but inlines each
-    // page's content rendered to clean Markdown so an agent can read the actual
-    // body without fetching every URL. Opt-in (these files get large) and bounded
-    // by a byte budget. noindex + never in the sitemap; HTML stays canonical.
-    router.get('/llms-full.txt', async (request) => {
-        try {
-            const { isInternalCollection } = await import('../../seo/audit-runner.js');
-            const { siteUrlFromRequest, loadEffectiveConfig } = await import('./seo-public.js');
-            // Honor admin overrides (siteName / summary / defaultMetaDescription) the
-            // same way `/llms.txt` and the other public SEO surfaces do.
-            const cfg = (await loadEffectiveConfig()) ?? getPrentaConfig();
-            const llmsCfg = cfg?.seo?.llms;
-            const base = siteUrlFromRequest(request, cfg);
-            // Gated independently from `/llms.txt`: must be both enabled overall and
-            // have the full variant turned on.
-            if (llmsCfg?.disabled || !llmsCfg?.fullEnabled) {
-                return new Response('Not found', { status: 404 });
-            }
-            const maxEntries = llmsCfg?.maxEntries ?? 50;
-            const maxBytes = llmsCfg?.maxFullBytes ?? 2_000_000;
-            const eligible = Array.isArray(llmsCfg?.eligibleCollections) && llmsCfg.eligibleCollections.length > 0
-                ? new Set(llmsCfg.eligibleCollections)
-                : null;
-            const rawDocs = await db().document.findMany({
-                where: { status: 'PUBLISHED', deletedAt: null },
-                select: {
-                    title: true,
-                    slug: true,
-                    collection: true,
-                    updatedAt: true,
-                    data: true,
-                    plainText: true,
-                },
-                orderBy: { updatedAt: 'desc' },
-                take: 500,
-            });
-            const { selectLlmsDocs, toLlmsPage } = await import('../../seo/llms-select.js');
-            const { documentToMarkdown } = await import('../../seo/content-markdown.js');
-            const selected = selectLlmsDocs(rawDocs, { isInternalCollection, eligible }).slice(0, maxEntries);
-            const header = [
-                `# ${cfg?.seo?.siteName || 'Prenta CMS'}`,
-                '',
-                `> ${llmsCfg?.summary || cfg?.seo?.defaultMetaDescription || 'Full content export for AI agents.'}`,
-                '',
-            ].join('\n');
-            const chunks = [header];
-            let bytes = Buffer.byteLength(header, 'utf8');
-            let truncated = false;
-            for (const d of selected) {
-                const page = toLlmsPage(d, {
-                    base,
-                    urlPrefix: cfg?.collections?.[d.collection]?.urlPrefix,
-                    trailingSlash: cfg?.seo?.trailingSlash,
-                });
-                const md = documentToMarkdown({
-                    title: d.title,
-                    data: d.data,
-                    plainText: d.plainText,
-                }, { baseUrl: base });
-                // Each entry is delimited by a horizontal rule and carries its canonical
-                // URL so the inlined content stays traceable back to the live page.
-                const block = `\n---\n\nURL: ${page.url}\n\n${md}\n`;
-                const blockBytes = Buffer.byteLength(block, 'utf8');
-                if (bytes + blockBytes > maxBytes) {
-                    truncated = true;
-                    break;
-                }
-                chunks.push(block);
-                bytes += blockBytes;
-            }
-            if (truncated) {
-                chunks.push('\n---\n\n> Output truncated at the configured size limit.\n');
-            }
-            await recordAiCrawlerFromRequest(db(), request, 'llms-full');
-            return new Response(chunks.join(''), {
-                status: 200,
-                headers: {
-                    'Content-Type': 'text/plain; charset=utf-8',
-                    'X-Robots-Tag': 'noindex',
-                    'Cache-Control': 'public, max-age=3600, s-maxage=3600',
-                },
-            });
-        }
-        catch (err) {
-            return internalError(err, 'llms-full.txt');
-        }
-    });
-    // Per-page Markdown: `GET /md?path=/about` returns a clean Markdown rendering
-    // of a single published page so an agent can fetch the content, not just the
-    // link. Fresh installs expose this at clean `/{path}.md` URLs via a scaffolded
-    // rewrite. CRITICAL: always noindex, never in the sitemap — the HTML page
-    // stays canonical (per-page `.md` is the most common duplicate-content trap).
-    router.get('/md', async (request) => {
-        try {
-            const cfg = getPrentaConfig();
-            const url = new URL(request.url);
-            const pathParam = url.searchParams.get('path');
-            if (!pathParam) {
-                return errorResponse('Missing required "path" query parameter', 400);
-            }
-            // Part of the AI/agent layer — honor the same master switch as llms.txt.
-            if (cfg?.seo?.llms?.disabled) {
-                return new Response('Not found', { status: 404 });
-            }
-            const { matchPathToCollection } = await import('../../seo/resolve-path.js');
-            const match = matchPathToCollection(cfg, pathParam);
-            if (!match) {
-                return new Response('Not found', { status: 404 });
-            }
-            const slugFilter = match.isRoot
-                ? {
-                    OR: [
-                        { data: { path: ['slug'], equals: 'home' } },
-                        { data: { path: ['slug'], equals: 'index' } },
-                        { slug: 'home' },
-                        { slug: 'index' },
-                    ],
-                }
-                : {
-                    OR: [{ data: { path: ['slug'], equals: match.slug } }, { slug: match.slug }],
-                };
-            const doc = await db().document.findFirst({
-                where: {
-                    collection: match.collection,
-                    deletedAt: null,
-                    status: 'PUBLISHED',
-                    ...slugFilter,
-                },
-                select: { title: true, data: true, plainText: true },
-            });
-            if (!doc) {
-                return new Response('Not found', { status: 404 });
-            }
-            const data = doc.data || {};
-            // The selection filter is the privacy boundary: noindexed or explicitly
-            // excluded pages must not be fetchable as Markdown either.
-            const { isLlmsNoindex, readLlmsInclude } = await import('../../seo/llms-select.js');
-            if (isLlmsNoindex(data) || readLlmsInclude(data) === 'NEVER') {
-                return new Response('Not found', { status: 404 });
-            }
-            const { documentToMarkdown } = await import('../../seo/content-markdown.js');
-            const { siteUrlFromRequest } = await import('./seo-public.js');
-            const base = siteUrlFromRequest(request, cfg);
-            const md = documentToMarkdown({ title: doc.title, data, plainText: doc.plainText }, { baseUrl: base });
-            await recordAiCrawlerFromRequest(db(), request, 'md');
-            return new Response(md, {
-                status: 200,
-                headers: {
-                    'Content-Type': 'text/markdown; charset=utf-8',
-                    'X-Robots-Tag': 'noindex',
-                },
-            });
-        }
-        catch (err) {
-            return internalError(err, 'md');
-        }
-    });
-    // Honeypot: a unique trap URL appended to llms.txt only when
-    // `seo.llms.honeypot` is enabled. No human visits it, so any fetch is an
-    // automated reader that followed a link from the file. Always records (even
-    // if the flag was later turned off, a cached llms.txt may still point here)
-    // and returns a tiny noindex body.
-    router.get('/ai-crawlers/trap', async (request) => {
-        try {
-            const detected = detectAiBot(request.headers.get('user-agent'));
-            await recordAiCrawlerHit(db(), {
-                bot: detected?.token ?? 'unknown',
-                surface: 'honeypot',
-                category: detected?.category ?? 'other',
-            });
-            return new Response('This endpoint exists to detect automated indexers.\n', {
-                status: 200,
-                headers: {
-                    'Content-Type': 'text/plain; charset=utf-8',
-                    'X-Robots-Tag': 'noindex',
-                },
-            });
-        }
-        catch (err) {
-            return internalError(err, 'ai-crawlers/trap');
-        }
-    });
-    // Admin: aggregated AI-crawler activity for the SEO → Technical panel.
-    // Any authenticated admin may read it (analytics, not a mutation).
-    router.get('/ai-crawlers', async (request) => {
-        try {
-            const auth = await requireAuth(request);
-            if (auth.error)
-                return auth.error;
-            if (!hasModel(db(), 'aiCrawlerHit')) {
-                return json({
-                    data: { enabled: false, rows: [], totals: { hits: 0, bots: 0, honeypot: 0 } },
-                });
-            }
-            const rows = await db().aiCrawlerHit.findMany({
-                orderBy: { lastSeenAt: 'desc' },
-                take: 500,
-            });
-            const totalHits = rows.reduce((sum, r) => sum + Number(r.hits ?? 0), 0);
-            const honeypotHits = rows
-                .filter((r) => r.surface === 'honeypot')
-                .reduce((sum, r) => sum + Number(r.hits ?? 0), 0);
-            const uniqueBots = new Set(rows.map((r) => r.bot)).size;
-            // Recency windowing. `hits` is a lifetime cumulative counter (one row per
-            // bot×surface), so we can't derive per-window hit *counts* from it — but
-            // `lastSeenAt` lets us answer the actionable question "which bots/surfaces
-            // were active in the last 24h / 7d". Per-window hit-count trends would
-            // need a (bot, surface, day) bucket table (a future additive migration);
-            // this keeps storage bounded while making recency visible today.
-            const nowMs = Date.now();
-            const DAY_MS = 24 * 60 * 60 * 1000;
-            const within = (v, ms) => {
-                if (!v)
-                    return false;
-                const t = v instanceof Date ? v.getTime() : new Date(v).getTime();
-                return Number.isFinite(t) && nowMs - t <= ms;
-            };
-            const windowSummary = (ms) => {
-                const active = rows.filter((r) => within(r.lastSeenAt, ms));
-                return {
-                    bots: new Set(active.map((r) => r.bot)).size,
-                    surfaces: new Set(active.map((r) => r.surface)).size,
-                    rows: active.length,
-                };
-            };
-            return json({
-                data: {
-                    enabled: true,
-                    rows: rows.map((r) => ({
-                        bot: r.bot,
-                        surface: r.surface,
-                        category: r.category,
-                        hits: Number(r.hits ?? 0),
-                        firstSeenAt: r.firstSeenAt,
-                        lastSeenAt: r.lastSeenAt,
-                        activeLast24h: within(r.lastSeenAt, DAY_MS),
-                        activeLast7d: within(r.lastSeenAt, 7 * DAY_MS),
-                    })),
-                    totals: { hits: totalHits, bots: uniqueBots, honeypot: honeypotHits },
-                    windows: { last24h: windowSummary(DAY_MS), last7d: windowSummary(7 * DAY_MS) },
-                },
-            });
-        }
-        catch (err) {
-            return internalError(err, 'ai-crawlers');
-        }
-    });
+    router.get('/seo/pages', getSeoPages);
+    router.get('/seo/link-health', getSeoLinkHealth);
+    router.get('/seo/links/snapshot', getSeoLinkSnapshot);
+    router.post('/seo/links/ai-index', postSeoLinkAiIndex);
+    router.post('/seo/links/suggest', postSeoLinkSuggest);
+    router.post('/seo/links/apply', postSeoLinkApply);
+    router.post('/seo/scan', postSeoScan);
+    router.post('/seo/audit', postSeoAudit);
+    router.get('/seo/audits', getSeoAudits);
+    router.get('/seo/audits/:id', getSeoAudit);
+    router.get('/seo/issues', getSeoIssues);
+    router.get('/seo/issues/export-brief', getSeoIssuesExportBrief);
+    router.post('/seo/issues/batch-content-briefs', postSeoIssuesBatchContentBriefs);
+    router.get('/seo/issues/:id/content-brief', getSeoIssueContentBrief);
+    router.post('/seo/issues/:id/content-brief', postSeoIssueContentBrief);
+    router.get('/seo/issues/:id/content-research', getSeoIssueContentResearch);
+    router.post('/seo/issues/:id/content-research', postSeoIssueContentResearch);
+    router.post('/seo/issues/:id/research-and-brief', postSeoIssueResearchAndBrief);
+    router.get('/seo/issues/:id', getSeoIssue);
+    router.post('/seo/issues/:id/resolve', postSeoIssueResolve);
+    router.post('/seo/issues/:id/ignore', postSeoIssueIgnore);
+    router.post('/seo/issues/:id/reopen', postSeoIssueReopen);
+    router.post('/seo/issues/:id/suggest-fix', postSeoIssueSuggestFix);
+    router.post('/seo/issues/:id/apply-fix', postSeoIssueApplyFix);
+    router.post('/seo/issues/:id/dismiss-fix', postSeoIssueDismissFix);
+    router.get('/seo/proposals', getSeoProposals);
+    router.post('/seo/proposals/generate', postSeoProposalsGenerate);
+    router.post('/seo/proposals/bulk-apply', postSeoProposalsBulkApply);
+    router.get('/seo/overview', getSeoOverview);
+    router.get('/seo/search-performance', getSeoSearchPerformance);
+    router.get('/seo/search-insights/:entityId', getSeoSearchInsights);
+    router.get('/seo/content', getSeoContent);
+    router.get('/seo/content/:entityType/:entityId', getSeoContentRecord);
+    router.put('/seo/content/:entityType/:entityId', putSeoContentRecord);
+    router.get('/seo/analysis/:documentId', getSeoAnalysis);
+    router.get('/seo/readability/:documentId', getSeoReadability);
+    router.get('/seo/internal-links/:documentId', getSeoInternalLinks);
+    router.get('/llms.txt', getLlmsTxt);
+    router.get('/llms-full.txt', getLlmsFullTxt);
+    router.get('/md', getMarkdownForPath);
+    router.get('/ai-crawlers/trap', getAiCrawlerTrap);
+    router.get('/ai-crawlers', getAiCrawlers);
 }
 //# sourceMappingURL=seo.js.map