@ainyc/canonry 4.46.1 → 4.50.0

package/dist/{chunk-IYUI74JP.js → chunk-YVP5CTSV.js}

@@ -5,7 +5,7 @@ import {
   loadConfig,
   loadConfigRaw,
   saveConfigPatch
-} from "./chunk-PRNO52YC.js";
+} from "./chunk-MYDJ25GO.js";
 import {
   DEFAULT_RUN_HISTORY_LIMIT,
   IntelligenceService,
@@ -80,10 +80,13 @@ import {
   smoothedRunDelta,
   trafficSources,
   usageCounters
-} from "./chunk-K2TOOQ4F.js";
+} from "./chunk-M4USKXJ4.js";
 import {
   AGENT_MEMORY_VALUE_MAX_BYTES,
   AGENT_PROVIDER_IDS,
+  AI_ENGINE_DOMAINS,
+  AI_ENGINE_SELF_DOMAINS,
+  AI_PROVIDER_INFRA_DOMAINS,
   AgentProviderIds,
   AppError,
   CcReleaseSyncStatuses,
@@ -110,24 +113,50 @@ import {
   TrafficSourceAuthModes,
   TrafficSourceStatuses,
   TrafficSourceTypes,
+  VERTEX_AI_SEARCH_PROXY_DOMAIN,
   VerificationStatuses,
   absolutizeProjectUrl,
   actionConfidenceLabel,
   agentBusy,
   agentMemoryDeleteRequestSchema,
   agentMemoryUpsertRequestSchema,
+  agentProvidersResponseDtoSchema,
+  auditLogEntrySchema,
   authInvalid,
   authRequired,
+  backlinkHistoryEntrySchema,
+  backlinkListResponseSchema,
+  backlinkSummaryDtoSchema,
+  backlinksInstallResultDtoSchema,
+  backlinksInstallStatusDtoSchema,
+  bingConnectResponseDtoSchema,
+  bingCoverageSnapshotDtoSchema,
+  bingCoverageSummaryDtoSchema,
+  bingIndexingRequestResponseDtoSchema,
+  bingKeywordStatsDtoSchema,
+  bingSetSiteResponseDtoSchema,
+  bingSitesResponseDtoSchema,
+  bingStatusDtoSchema,
+  bingUrlInspectionDtoSchema,
   brandKeyFromText,
   brandLabelFromDomain,
   buildRunErrorFromMessages,
   categorizeSource,
   categoryLabel,
+  ccAvailableReleaseSchema,
+  ccCachedReleaseSchema,
+  ccReleaseSyncDtoSchema,
+  cdpStatusDtoSchema,
   citationStateSchema,
   citationStateToCited,
+  citationVisibilityResponseSchema,
   clusterByCosine,
   competitorBatchRequestSchema,
+  competitorDtoSchema,
   contentActionLabel,
+  contentGapsResponseDtoSchema,
+  contentSourcesResponseDtoSchema,
+  contentTargetsResponseDtoSchema,
   dedupeReportActions,
   dedupeReportOpportunities,
   deliveryFailed,
@@ -135,8 +164,13 @@ import {
   deltaTone,
   determineAnswerMentioned,
   discoveryBucketSchema,
+  discoveryPromotePreviewSchema,
   discoveryPromoteRequestSchema,
+  discoveryPromoteResultSchema,
   discoveryRunRequestSchema,
+  discoverySessionDetailDtoSchema,
+  discoverySessionDtoSchema,
+  doctorReportSchema,
   effectiveBrandNames,
   effectiveDomains,
   emptyCitationVisibility,
@@ -148,12 +182,29 @@ import {
   formatIsoDate,
   formatNumber,
   formatRatio,
+  ga4AiReferralHistoryEntrySchema,
+  ga4SessionHistoryEntrySchema,
+  ga4SocialReferralHistoryEntrySchema,
+  ga4StatusDtoSchema,
+  ga4SyncResponseDtoSchema,
   getProviderLocationHandling,
+  googleConnectionDtoSchema,
+  gscCoverageSnapshotDtoSchema,
+  gscCoverageSummaryDtoSchema,
+  gscDeindexedRowSchema,
+  gscPerformanceDailyDtoSchema,
+  gscSearchDataDtoSchema,
+  gscSiteListResponseDtoSchema,
+  gscSitemapListResponseDtoSchema,
+  gscUrlInspectionDtoSchema,
   hasLocationLabel,
+  indexingRequestResponseDtoSchema,
   internalError,
   isAgentProviderId,
   isBrowserProvider,
+  keywordDtoSchema,
   keywordGenerateRequestSchema,
+  latestProjectRunDtoSchema,
   locationContextSchema,
   mentionStateFromAnswerMentioned,
   missingDependency,
@@ -162,12 +213,16 @@ import {
   normalizeUrlPath,
   notFound,
   notImplemented,
+  notificationDtoSchema,
   parseRunError,
   parseWindow,
   pickClusterRepresentative,
   projectConfigSchema,
+  projectDtoSchema,
+  projectReportDtoSchema,
   projectUpsertRequestSchema,
   providerError,
+  queryDtoSchema,
   queryGenerateRequestSchema,
   registrableDomain,
   reportActionCategoryLabel,
@@ -178,22 +233,47 @@ import {
   resolveConfigSpecQueries,
   resolveLocations,
   resolveSnapshotRequestQueries,
+  runDetailDtoSchema,
+  runDtoSchema,
   runInProgress,
   runNotCancellable,
   runTriggerRequestSchema,
   schedulableRunKindSchema,
+  scheduleDtoSchema,
   scheduleUpsertRequestSchema,
   serializeRunError,
+  settingsDtoSchema,
+  snapshotDiffResponseSchema,
+  snapshotListResponseSchema,
+  snapshotReportSchema,
   snapshotRequestSchema,
   summarizeCheckResults,
+  trafficBackfillResponseSchema,
   trafficConnectVercelRequestSchema,
   trafficConnectWordpressRequestSchema,
+  trafficEventsResponseSchema,
+  trafficSourceDetailDtoSchema,
+  trafficSourceDtoSchema,
+  trafficSourceListResponseSchema,
+  trafficStatusResponseSchema,
+  trafficSyncResponseSchema,
   unsupportedKind,
   validationError,
   visibilityStateFromAnswerMentioned,
   windowCutoff,
-  wordpressEnvSchema
-} from "./chunk-MM3A2CJK.js";
+  wordpressAuditPageDtoSchema,
+  wordpressBulkMetaResultDtoSchema,
+  wordpressDiffDtoSchema,
+  wordpressEnvSchema,
+  wordpressManualAssistDtoSchema,
+  wordpressOnboardResultDtoSchema,
+  wordpressPageDetailDtoSchema,
+  wordpressPageSummaryDtoSchema,
+  wordpressSchemaBlockDtoSchema,
+  wordpressSchemaDeployResultDtoSchema,
+  wordpressSchemaStatusResultDtoSchema,
+  wordpressStatusDtoSchema
+} from "./chunk-QIG3TKL4.js";
 
 // src/telemetry.ts
 import crypto from "crypto";
@@ -559,7 +639,10 @@ import { eq as eq3, sql as sql2 } from "drizzle-orm";
 
 // ../api-routes/src/helpers.ts
 import crypto3 from "crypto";
-import { eq as eq2, sql } from "drizzle-orm";
+import { eq as eq2, ne, sql } from "drizzle-orm";
+function notProbeRun() {
+  return ne(runs.trigger, RunTriggers.probe);
+}
 function resolveProject(db, name) {
   const project = db.select().from(projects).where(eq2(projects.name, name)).get();
   if (!project) {
@@ -2262,7 +2345,7 @@ function normalizeCompetitorList2(domains) {
 }
 
 // ../api-routes/src/history.ts
-import { eq as eq9, desc as desc2, inArray as inArray2 } from "drizzle-orm";
+import { and as and4, eq as eq9, desc as desc2, inArray as inArray2 } from "drizzle-orm";
 
 // ../api-routes/src/notification-redaction.ts
 var REDACTED_URL = {
@@ -2319,7 +2402,7 @@ async function historyRoutes(app) {
     const project = resolveProject(app.db, request.params.name);
     const limit = parseInt(request.query.limit ?? "50", 10);
     const offset = parseInt(request.query.offset ?? "0", 10);
-    const projectRuns = app.db.select({ id: runs.id }).from(runs).where(eq9(runs.projectId, project.id)).all();
+    const projectRuns = app.db.select({ id: runs.id }).from(runs).where(and4(eq9(runs.projectId, project.id), notProbeRun())).all();
     if (projectRuns.length === 0) {
       return reply.send({ snapshots: [], total: 0 });
     }
@@ -2368,7 +2451,7 @@ async function historyRoutes(app) {
   app.get("/projects/:name/timeline", async (request, reply) => {
     const project = resolveProject(app.db, request.params.name);
     const projectQueries = app.db.select().from(queries).where(eq9(queries.projectId, project.id)).all();
-    const projectRuns = app.db.select().from(runs).where(eq9(runs.projectId, project.id)).orderBy(runs.createdAt).all();
+    const projectRuns = app.db.select().from(runs).where(and4(eq9(runs.projectId, project.id), notProbeRun())).orderBy(runs.createdAt).all();
     if (projectRuns.length === 0 || projectQueries.length === 0) {
       return reply.send([]);
     }
@@ -2553,13 +2636,13 @@ function formatAuditEntry(row) {
 }
 
 // ../api-routes/src/analytics.ts
-import { eq as eq10, desc as desc3, inArray as inArray3 } from "drizzle-orm";
+import { and as and5, eq as eq10, desc as desc3, inArray as inArray3 } from "drizzle-orm";
 async function analyticsRoutes(app) {
   app.get("/projects/:name/analytics/metrics", async (request, reply) => {
     const project = resolveProject(app.db, request.params.name);
     const window = parseWindow(request.query.window);
     const cutoff = windowCutoff(window);
-    const projectRuns = app.db.select().from(runs).where(eq10(runs.projectId, project.id)).orderBy(runs.createdAt).all().filter((r) => r.status === "completed" || r.status === "partial").filter((r) => !cutoff || r.createdAt >= cutoff);
+    const projectRuns = app.db.select().from(runs).where(and5(eq10(runs.projectId, project.id), notProbeRun())).orderBy(runs.createdAt).all().filter((r) => r.status === "completed" || r.status === "partial").filter((r) => !cutoff || r.createdAt >= cutoff);
     if (projectRuns.length === 0) {
       return reply.send({
         window,
@@ -2607,14 +2690,14 @@ async function analyticsRoutes(app) {
     const project = resolveProject(app.db, request.params.name);
     const window = parseWindow(request.query.window);
     const cutoff = windowCutoff(window);
-    const completedRuns = app.db.select().from(runs).where(eq10(runs.projectId, project.id)).orderBy(desc3(runs.createdAt), desc3(runs.id)).all().filter((r) => r.status === "completed" || r.status === "partial");
+    const completedRuns = app.db.select().from(runs).where(and5(eq10(runs.projectId, project.id), notProbeRun())).orderBy(desc3(runs.createdAt), desc3(runs.id)).all().filter((r) => r.status === "completed" || r.status === "partial");
     const latestGroup = groupRunsByCreatedAt(completedRuns)[0] ?? [];
     const latestGroupRunIds = latestGroup.map((r) => r.id);
     const latestRun = pickGroupRepresentative(latestGroup);
     if (!latestRun) {
       return reply.send({ cited: [], gap: [], uncited: [], mentionedQueries: [], mentionGap: [], notMentioned: [], runId: "", window });
     }
-    const windowRuns = app.db.select().from(runs).where(eq10(runs.projectId, project.id)).orderBy(runs.createdAt).all().filter((r) => r.status === "completed" || r.status === "partial").filter((r) => !cutoff || r.createdAt >= cutoff);
+    const windowRuns = app.db.select().from(runs).where(and5(eq10(runs.projectId, project.id), notProbeRun())).orderBy(runs.createdAt).all().filter((r) => r.status === "completed" || r.status === "partial").filter((r) => !cutoff || r.createdAt >= cutoff);
     const windowRunIds = windowRuns.map((r) => r.id);
     const runIdToCreatedAt = new Map(windowRuns.map((r) => [r.id, r.createdAt]));
     const consistencyMap = /* @__PURE__ */ new Map();
@@ -2730,7 +2813,7 @@ async function analyticsRoutes(app) {
     const project = resolveProject(app.db, request.params.name);
     const window = parseWindow(request.query.window);
     const cutoff = windowCutoff(window);
-    const windowRuns = app.db.select().from(runs).where(eq10(runs.projectId, project.id)).orderBy(desc3(runs.createdAt), desc3(runs.id)).all().filter((r) => r.status === "completed" || r.status === "partial").filter((r) => !cutoff || r.createdAt >= cutoff);
+    const windowRuns = app.db.select().from(runs).where(and5(eq10(runs.projectId, project.id), notProbeRun())).orderBy(desc3(runs.createdAt), desc3(runs.id)).all().filter((r) => r.status === "completed" || r.status === "partial").filter((r) => !cutoff || r.createdAt >= cutoff);
     if (windowRuns.length === 0) {
       return reply.send({ overall: [], byQuery: {}, runId: "", window });
     }
@@ -2764,16 +2847,10 @@ async function analyticsRoutes(app) {
     return reply.send({ overall, byQuery, runId: latestRunId, window });
   });
 }
-var PROVIDER_INFRA_DOMAINS = /* @__PURE__ */ new Set([
-  "vertexaisearch.cloud.google.com",
-  "openai.com",
-  "anthropic.com",
-  "googleapis.com"
-]);
 function isProviderInfraDomain(uri) {
   try {
     const host = new URL(uri).hostname.toLowerCase();
-    for (const blocked of PROVIDER_INFRA_DOMAINS) {
+    for (const blocked of AI_PROVIDER_INFRA_DOMAINS) {
       if (host === blocked || host.endsWith(`.${blocked}`)) return true;
     }
   } catch {
@@ -2900,7 +2977,7 @@ function buildCategoryCounts(counts) {
 }
 
 // ../api-routes/src/intelligence.ts
-import { eq as eq11, desc as desc4, and as and4, inArray as inArray4 } from "drizzle-orm";
+import { eq as eq11, desc as desc4, and as and6, inArray as inArray4 } from "drizzle-orm";
 function emptyHealthSnapshot(projectId) {
   return {
     id: `no-data:${projectId}`,
@@ -2989,7 +3066,7 @@ async function intelligenceRoutes(app) {
     if (request.query.runId) {
       conditions.push(eq11(insights.runId, request.query.runId));
     }
-    const rows = app.db.select().from(insights).where(conditions.length === 1 ? conditions[0] : and4(...conditions)).orderBy(desc4(insights.createdAt)).all();
+    const rows = app.db.select().from(insights).where(conditions.length === 1 ? conditions[0] : and6(...conditions)).orderBy(desc4(insights.createdAt)).all();
     const showDismissed = request.query.dismissed === "true";
     const result = rows.filter((r) => showDismissed || !r.dismissed).map(mapInsightRow);
     return reply.send(result);
@@ -3013,15 +3090,18 @@ async function intelligenceRoutes(app) {
   });
   app.get("/projects/:name/health/latest", async (request, reply) => {
     const project = resolveProject(app.db, request.params.name);
-    const projectVisRuns = app.db.select({ id: runs.id, createdAt: runs.createdAt }).from(runs).where(and4(
+    const projectVisRuns = app.db.select({ id: runs.id, createdAt: runs.createdAt }).from(runs).where(and6(
       eq11(runs.projectId, project.id),
       eq11(runs.kind, RunKinds["answer-visibility"]),
-      inArray4(runs.status, [RunStatuses.completed, RunStatuses.partial])
+      inArray4(runs.status, [RunStatuses.completed, RunStatuses.partial]),
+      // Health-latest is the dashboard headline; probe runs must not
+      // displace the most recent real visibility sweep.
+      notProbeRun()
     )).orderBy(desc4(runs.createdAt), desc4(runs.id)).all();
     const latestGroup = groupRunsByCreatedAt(projectVisRuns)[0] ?? [];
     const latestGroupRunIds = latestGroup.map((r) => r.id);
     if (latestGroupRunIds.length > 0) {
-      const groupRows = app.db.select().from(healthSnapshots).where(and4(
+      const groupRows = app.db.select().from(healthSnapshots).where(and6(
         eq11(healthSnapshots.projectId, project.id),
         inArray4(healthSnapshots.runId, latestGroupRunIds)
       )).all();
@@ -3045,7 +3125,7 @@ async function intelligenceRoutes(app) {
 }
 
 // ../api-routes/src/report.ts
-import { and as and6, desc as desc6, eq as eq13, gte, inArray as inArray6, lt, lte, ne, or as or3, sql as sql5 } from "drizzle-orm";
+import { and as and8, desc as desc6, eq as eq13, gte, inArray as inArray6, lt, lte, ne as ne2, or as or3, sql as sql5 } from "drizzle-orm";
 
 // ../api-routes/src/report-renderer.ts
 var COLORS = {
@@ -5285,7 +5365,7 @@ function renderReportHtml(report, opts = {}) {
 }
 
 // ../api-routes/src/content-data.ts
-import { and as and5, eq as eq12, desc as desc5, inArray as inArray5 } from "drizzle-orm";
+import { and as and7, eq as eq12, desc as desc5, inArray as inArray5 } from "drizzle-orm";
 var RECENT_RUNS_WINDOW = 5;
 function loadOrchestratorInput(db, project, locationFilter = void 0) {
   const projectId = project.id;
@@ -5409,13 +5489,16 @@ function listCompetitorDomains(db, projectId) {
 }
 function listRecentAnswerVisibilityRunIds(db, projectId, limit, locationFilter) {
   const rows = db.select({ id: runs.id, location: runs.location }).from(runs).where(
-    and5(
+    and7(
       eq12(runs.projectId, projectId),
       eq12(runs.kind, RunKinds["answer-visibility"]),
       // Queued/running/failed/cancelled runs may have partial or no
       // snapshots; including them risks pointing latestRunId at a run with
       // no usable evidence.
-      inArray5(runs.status, [RunStatuses.completed, RunStatuses.partial])
+      inArray5(runs.status, [RunStatuses.completed, RunStatuses.partial]),
+      // Probe runs are operator/agent test runs; they must not poison the
+      // recent-runs window the content engine uses to recommend actions.
+      notProbeRun()
     )
   ).orderBy(desc5(runs.createdAt)).all();
   const filtered = locationFilter === void 0 ? rows : rows.filter((r) => (r.location ?? null) === locationFilter);
@@ -5776,7 +5859,7 @@ function buildGscSection(db, projectId, projectBrandNames, canonicalDomain, trac
 }
 function buildGaSection(db, projectId) {
   const windowSummary = db.select().from(gaTrafficWindowSummaries).where(
-    and6(
+    and8(
       eq13(gaTrafficWindowSummaries.projectId, projectId),
       eq13(gaTrafficWindowSummaries.windowKey, "30d")
     )
@@ -5954,9 +6037,9 @@ function nonSubresourceReferralPathCondition() {
 }
 function buildServerActivity(db, projectId) {
   const sourceRows = db.select({ id: trafficSources.id }).from(trafficSources).where(
-    and6(
+    and8(
       eq13(trafficSources.projectId, projectId),
-      ne(trafficSources.status, TrafficSourceStatuses.archived)
+      ne2(trafficSources.status, TrafficSourceStatuses.archived)
     )
   ).all();
   if (sourceRows.length === 0) return null;
@@ -5970,7 +6053,7 @@ function buildServerActivity(db, projectId) {
   const trendStart = new Date(trendStartMs).toISOString();
   const sumVerifiedCrawlers = (windowStartIso, windowEndIso, exclusiveEnd = false) => Number(
     db.select({ total: sql5`COALESCE(SUM(${crawlerEventsHourly.hits}), 0)` }).from(crawlerEventsHourly).where(
-      and6(
+      and8(
         eq13(crawlerEventsHourly.projectId, projectId),
         eq13(crawlerEventsHourly.verificationStatus, VerificationStatuses.verified),
         gte(crawlerEventsHourly.tsHour, windowStartIso),
@@ -5980,9 +6063,9 @@ function buildServerActivity(db, projectId) {
   );
   const sumUnverifiedCrawlers = (windowStartIso, windowEndIso, exclusiveEnd = false) => Number(
     db.select({ total: sql5`COALESCE(SUM(${crawlerEventsHourly.hits}), 0)` }).from(crawlerEventsHourly).where(
-      and6(
+      and8(
         eq13(crawlerEventsHourly.projectId, projectId),
-        ne(crawlerEventsHourly.verificationStatus, VerificationStatuses.verified),
+        ne2(crawlerEventsHourly.verificationStatus, VerificationStatuses.verified),
         gte(crawlerEventsHourly.tsHour, windowStartIso),
         exclusiveEnd ? lt(crawlerEventsHourly.tsHour, windowEndIso) : lte(crawlerEventsHourly.tsHour, windowEndIso)
       )
@@ -5990,7 +6073,7 @@ function buildServerActivity(db, projectId) {
   );
   const sumReferrals = (windowStartIso, windowEndIso, exclusiveEnd = false) => Number(
     db.select({ total: sql5`COALESCE(SUM(${aiReferralEventsHourly.sessionsOrHits}), 0)` }).from(aiReferralEventsHourly).where(
-      and6(
+      and8(
         eq13(aiReferralEventsHourly.projectId, projectId),
         nonSubresourceReferralPathCondition(),
         gte(aiReferralEventsHourly.tsHour, windowStartIso),
@@ -6009,7 +6092,7 @@ function buildServerActivity(db, projectId) {
     verificationStatus: crawlerEventsHourly.verificationStatus,
     hits: sql5`COALESCE(SUM(${crawlerEventsHourly.hits}), 0)`
   }).from(crawlerEventsHourly).where(
-    and6(
+    and8(
       eq13(crawlerEventsHourly.projectId, projectId),
       gte(crawlerEventsHourly.tsHour, headlineStart),
       lte(crawlerEventsHourly.tsHour, headlineEnd)
@@ -6019,7 +6102,7 @@ function buildServerActivity(db, projectId) {
     operator: crawlerEventsHourly.operator,
     hits: sql5`COALESCE(SUM(${crawlerEventsHourly.hits}), 0)`
   }).from(crawlerEventsHourly).where(
-    and6(
+    and8(
       eq13(crawlerEventsHourly.projectId, projectId),
       eq13(crawlerEventsHourly.verificationStatus, VerificationStatuses.verified),
       gte(crawlerEventsHourly.tsHour, priorStart),
@@ -6030,7 +6113,7 @@ function buildServerActivity(db, projectId) {
     operator: aiReferralEventsHourly.operator,
     hits: sql5`COALESCE(SUM(${aiReferralEventsHourly.sessionsOrHits}), 0)`
   }).from(aiReferralEventsHourly).where(
-    and6(
+    and8(
       eq13(aiReferralEventsHourly.projectId, projectId),
       nonSubresourceReferralPathCondition(),
       gte(aiReferralEventsHourly.tsHour, headlineStart),
@@ -6071,7 +6154,7 @@ function buildServerActivity(db, projectId) {
     hits: sql5`COALESCE(SUM(${crawlerEventsHourly.hits}), 0)`,
     operators: sql5`COUNT(DISTINCT ${crawlerEventsHourly.operator})`
   }).from(crawlerEventsHourly).where(
-    and6(
+    and8(
       eq13(crawlerEventsHourly.projectId, projectId),
       eq13(crawlerEventsHourly.verificationStatus, VerificationStatuses.verified),
       gte(crawlerEventsHourly.tsHour, headlineStart),
@@ -6088,7 +6171,7 @@ function buildServerActivity(db, projectId) {
     arrivals: sql5`COALESCE(SUM(${aiReferralEventsHourly.sessionsOrHits}), 0)`,
     landingPaths: sql5`COUNT(DISTINCT ${aiReferralEventsHourly.landingPathNormalized})`
   }).from(aiReferralEventsHourly).where(
-    and6(
+    and8(
       eq13(aiReferralEventsHourly.projectId, projectId),
       nonSubresourceReferralPathCondition(),
       gte(aiReferralEventsHourly.tsHour, headlineStart),
@@ -6105,7 +6188,7 @@ function buildServerActivity(db, projectId) {
     arrivals: sql5`COALESCE(SUM(${aiReferralEventsHourly.sessionsOrHits}), 0)`,
     products: sql5`COUNT(DISTINCT ${aiReferralEventsHourly.product})`
   }).from(aiReferralEventsHourly).where(
-    and6(
+    and8(
       eq13(aiReferralEventsHourly.projectId, projectId),
       nonSubresourceReferralPathCondition(),
       gte(aiReferralEventsHourly.tsHour, headlineStart),
@@ -6121,7 +6204,7 @@ function buildServerActivity(db, projectId) {
     date: sql5`SUBSTR(${crawlerEventsHourly.tsHour}, 1, 10)`,
     hits: sql5`COALESCE(SUM(${crawlerEventsHourly.hits}), 0)`
   }).from(crawlerEventsHourly).where(
-    and6(
+    and8(
       eq13(crawlerEventsHourly.projectId, projectId),
       eq13(crawlerEventsHourly.verificationStatus, VerificationStatuses.verified),
       gte(crawlerEventsHourly.tsHour, trendStart),
@@ -6132,7 +6215,7 @@ function buildServerActivity(db, projectId) {
     date: sql5`SUBSTR(${aiReferralEventsHourly.tsHour}, 1, 10)`,
     hits: sql5`COALESCE(SUM(${aiReferralEventsHourly.sessionsOrHits}), 0)`
   }).from(aiReferralEventsHourly).where(
-    and6(
+    and8(
       eq13(aiReferralEventsHourly.projectId, projectId),
       nonSubresourceReferralPathCondition(),
       gte(aiReferralEventsHourly.tsHour, trendStart),
@@ -6207,7 +6290,7 @@ function buildIndexingHealth(db, projectId) {
   return null;
 }
 function buildCitationsTrend(db, projectId, queryLookup, locationFilter) {
-  const visibilityRuns = db.select().from(runs).where(and6(eq13(runs.projectId, projectId), eq13(runs.kind, RunKinds["answer-visibility"]))).all().filter((r) => locationFilter === void 0 || (r.location ?? null) === locationFilter);
+  const visibilityRuns = db.select().from(runs).where(and8(eq13(runs.projectId, projectId), eq13(runs.kind, RunKinds["answer-visibility"]), notProbeRun())).all().filter((r) => locationFilter === void 0 || (r.location ?? null) === locationFilter);
   const totalQueries = queryLookup.byId.size;
   const points = [];
   for (const run of visibilityRuns) {
@@ -6253,14 +6336,15 @@ function buildCitationsTrend(db, projectId, queryLookup, locationFilter) {
 }
 function buildInsightList(db, projectId, locationFilter) {
   const recentRunIds = db.select({ id: runs.id, location: runs.location }).from(runs).where(
-    and6(
+    and8(
       eq13(runs.projectId, projectId),
       eq13(runs.kind, RunKinds["answer-visibility"]),
-      or3(eq13(runs.status, RunStatuses.completed), eq13(runs.status, RunStatuses.partial))
+      or3(eq13(runs.status, RunStatuses.completed), eq13(runs.status, RunStatuses.partial)),
+      notProbeRun()
     )
   ).orderBy(desc6(runs.createdAt)).all().filter((r) => locationFilter === void 0 || (r.location ?? null) === locationFilter).slice(0, INSIGHT_LOOKBACK_RUNS).map((r) => r.id);
   if (recentRunIds.length === 0) return [];
-  const rows = db.select().from(insights).where(and6(eq13(insights.projectId, projectId), inArray6(insights.runId, recentRunIds))).orderBy(desc6(insights.createdAt)).all();
+  const rows = db.select().from(insights).where(and8(eq13(insights.projectId, projectId), inArray6(insights.runId, recentRunIds))).orderBy(desc6(insights.createdAt)).all();
   const severityRank = { critical: 0, high: 1, medium: 2, low: 3 };
   const flat = rows.filter((r) => !r.dismissed).map((r) => {
     const recommendation = parseJsonColumn(r.recommendation, null);
@@ -6805,7 +6889,7 @@ function buildWhatsChanged(input) {
 function buildProjectReport(db, projectName) {
   const project = resolveProject(db, projectName);
   const queryLookup = loadQueryLookup(db, project.id);
-  const allRuns = db.select().from(runs).where(eq13(runs.projectId, project.id)).orderBy(desc6(runs.createdAt), desc6(runs.id)).all();
+  const allRuns = db.select().from(runs).where(and8(eq13(runs.projectId, project.id), notProbeRun())).orderBy(desc6(runs.createdAt), desc6(runs.id)).all();
   const visibilityRuns = allRuns.filter((r) => r.kind === RunKinds["answer-visibility"]);
   const completedVisRunGroups = groupRunsByCreatedAt(
     visibilityRuns.filter((r) => r.status === RunStatuses.completed || r.status === RunStatuses.partial)
@@ -7033,7 +7117,7 @@ async function reportRoutes(app) {
 }
 
 // ../api-routes/src/citations.ts
-import { eq as eq14, inArray as inArray7 } from "drizzle-orm";
+import { and as and9, eq as eq14, inArray as inArray7 } from "drizzle-orm";
 async function citationRoutes(app) {
   app.get("/projects/:name/citations/visibility", async (request, reply) => {
     const project = resolveProject(app.db, request.params.name);
@@ -7042,7 +7126,7 @@ async function citationRoutes(app) {
     if (projectQueries.length === 0) {
       return reply.send(emptyCitationVisibility("no-queries"));
     }
-    const projectRuns = app.db.select({ id: runs.id, createdAt: runs.createdAt }).from(runs).where(eq14(runs.projectId, project.id)).all();
+    const projectRuns = app.db.select({ id: runs.id, createdAt: runs.createdAt }).from(runs).where(and9(eq14(runs.projectId, project.id), notProbeRun())).all();
     if (projectRuns.length === 0) {
       return reply.send(emptyCitationVisibility("no-runs-yet"));
     }
@@ -7198,7 +7282,7 @@ function normalizeDomain2(domain) {
 }
 
 // ../api-routes/src/composites.ts
-import { eq as eq15, and as and7, desc as desc7, sql as sql6, like, or as or4, inArray as inArray8 } from "drizzle-orm";
+import { eq as eq15, and as and10, desc as desc7, sql as sql6, like, or as or4, inArray as inArray8 } from "drizzle-orm";
 var TOP_INSIGHT_LIMIT = 5;
 var SEARCH_HIT_HARD_LIMIT = 50;
 var SEARCH_SNIPPET_RADIUS = 80;
@@ -7216,7 +7300,7 @@ async function compositeRoutes(app) {
     const project = resolveProject(app.db, request.params.name);
     const filterLocation = (request.query.location ?? "").trim() || null;
     const sinceIso = parseSinceFilter(request.query.since);
-    const allRunsRaw = app.db.select().from(runs).where(eq15(runs.projectId, project.id)).orderBy(desc7(runs.createdAt), desc7(runs.id)).all();
+    const allRunsRaw = app.db.select().from(runs).where(and10(eq15(runs.projectId, project.id), notProbeRun())).orderBy(desc7(runs.createdAt), desc7(runs.id)).all();
     const allRuns = allRunsRaw.filter((r) => runMatchesFilters(r, filterLocation, sinceIso));
     const totalRuns = allRuns.length;
     const visibilityRuns = allRuns.filter((r) => r.kind === RunKinds["answer-visibility"]);
@@ -7345,7 +7429,7 @@ async function compositeRoutes(app) {
       rawResponse: querySnapshots.rawResponse,
       createdAt: querySnapshots.createdAt
     }).from(querySnapshots).innerJoin(queries, eq15(querySnapshots.queryId, queries.id)).where(
-      and7(
+      and10(
         eq15(queries.projectId, project.id),
         or4(
           sql6`${querySnapshots.answerText} LIKE ${pattern} ESCAPE '\\'`,
@@ -7356,7 +7440,7 @@ async function compositeRoutes(app) {
       )
     ).orderBy(desc7(querySnapshots.createdAt)).limit(limit + 1).all());
     const insightMatches = app.db.select().from(insights).where(
-      and7(
+      and10(
         eq15(insights.projectId, project.id),
         or4(
           like(insights.title, pattern),
@@ -7529,7 +7613,7 @@ function buildSuggestedQueriesFromGsc(app, projectId, trackedQueries) {
     // NULLIF guards the degenerate impressions=0 case (SQLite returns NULL,
     // which the JS coerces to 0 — caught by the impression floor anyway).
     avgPosition: sql6`COALESCE(SUM(${gscSearchData.position} * ${gscSearchData.impressions}) * 1.0 / NULLIF(SUM(${gscSearchData.impressions}), 0), 0)`
-  }).from(gscSearchData).where(and7(
+  }).from(gscSearchData).where(and10(
     eq15(gscSearchData.projectId, projectId),
     sql6`${gscSearchData.date} >= ${cutoff}`,
     sql6`${gscSearchData.impressions} > 0`
@@ -7718,6 +7802,7 @@ function formatProject2(row) {
     language: row.language,
     tags: parseJsonColumn(row.tags, []),
     labels: parseJsonColumn(row.labels, {}),
+    providers: parseJsonColumn(row.providers, []),
     locations: parseJsonColumn(row.locations, []),
     defaultLocation: row.defaultLocation,
     autoExtractBacklinks: row.autoExtractBacklinks === 1,
@@ -7864,6 +7949,141 @@ function parseLimitParam(raw) {
   return parsed;
 }
 
+// ../api-routes/src/openapi-schemas.ts
+import { z } from "zod";
+var SCHEMA_TABLE = {
+  AgentProvidersResponseDto: agentProvidersResponseDtoSchema,
+  AuditLogEntry: auditLogEntrySchema,
+  BacklinkHistoryEntry: backlinkHistoryEntrySchema,
+  BacklinkListResponse: backlinkListResponseSchema,
+  BacklinkSummaryDto: backlinkSummaryDtoSchema,
+  BacklinksInstallResultDto: backlinksInstallResultDtoSchema,
+  BacklinksInstallStatusDto: backlinksInstallStatusDtoSchema,
+  BingConnectResponseDto: bingConnectResponseDtoSchema,
+  BingCoverageSnapshotDto: bingCoverageSnapshotDtoSchema,
+  BingCoverageSummaryDto: bingCoverageSummaryDtoSchema,
+  BingIndexingRequestResponseDto: bingIndexingRequestResponseDtoSchema,
+  BingKeywordStatsDto: bingKeywordStatsDtoSchema,
+  BingSetSiteResponseDto: bingSetSiteResponseDtoSchema,
+  BingSitesResponseDto: bingSitesResponseDtoSchema,
+  BingStatusDto: bingStatusDtoSchema,
+  BingUrlInspectionDto: bingUrlInspectionDtoSchema,
+  CcAvailableRelease: ccAvailableReleaseSchema,
+  CcCachedRelease: ccCachedReleaseSchema,
+  CcReleaseSyncDto: ccReleaseSyncDtoSchema,
+  CdpStatusDto: cdpStatusDtoSchema,
+  CitationVisibilityResponse: citationVisibilityResponseSchema,
+  CompetitorDto: competitorDtoSchema,
+  ContentGapsResponseDto: contentGapsResponseDtoSchema,
+  ContentSourcesResponseDto: contentSourcesResponseDtoSchema,
+  ContentTargetsResponseDto: contentTargetsResponseDtoSchema,
+  DiscoveryPromotePreview: discoveryPromotePreviewSchema,
+  DiscoveryPromoteResult: discoveryPromoteResultSchema,
+  DiscoverySessionDetailDto: discoverySessionDetailDtoSchema,
+  DiscoverySessionDto: discoverySessionDtoSchema,
+  DoctorReportDto: doctorReportSchema,
+  GA4AiReferralHistoryEntry: ga4AiReferralHistoryEntrySchema,
+  GA4SessionHistoryEntry: ga4SessionHistoryEntrySchema,
+  GA4SocialReferralHistoryEntry: ga4SocialReferralHistoryEntrySchema,
+  GA4StatusDto: ga4StatusDtoSchema,
+  GA4SyncResponseDto: ga4SyncResponseDtoSchema,
+  GoogleConnectionDto: googleConnectionDtoSchema,
+  GscCoverageSnapshotDto: gscCoverageSnapshotDtoSchema,
+  GscCoverageSummaryDto: gscCoverageSummaryDtoSchema,
+  GscDeindexedRowDto: gscDeindexedRowSchema,
+  GscPerformanceDailyDto: gscPerformanceDailyDtoSchema,
+  GscSearchDataDto: gscSearchDataDtoSchema,
+  GscSiteListResponseDto: gscSiteListResponseDtoSchema,
+  GscSitemapListResponseDto: gscSitemapListResponseDtoSchema,
+  GscUrlInspectionDto: gscUrlInspectionDtoSchema,
+  IndexingRequestResponseDto: indexingRequestResponseDtoSchema,
+  KeywordDto: keywordDtoSchema,
+  LatestProjectRunDto: latestProjectRunDtoSchema,
+  LocationContext: locationContextSchema,
+  NotificationDto: notificationDtoSchema,
+  ProjectDto: projectDtoSchema,
+  ProjectReportDto: projectReportDtoSchema,
+  QueryDto: queryDtoSchema,
+  RunDetailDto: runDetailDtoSchema,
+  RunDto: runDtoSchema,
+  ScheduleDto: scheduleDtoSchema,
+  SettingsDto: settingsDtoSchema,
+  SnapshotDiffResponse: snapshotDiffResponseSchema,
+  SnapshotListResponse: snapshotListResponseSchema,
+  SnapshotReportDto: snapshotReportSchema,
+  TrafficBackfillResponse: trafficBackfillResponseSchema,
+  TrafficEventsResponse: trafficEventsResponseSchema,
+  TrafficSourceDetailDto: trafficSourceDetailDtoSchema,
+  TrafficSourceDto: trafficSourceDtoSchema,
+  TrafficSourceListResponse: trafficSourceListResponseSchema,
+  TrafficStatusResponse: trafficStatusResponseSchema,
+  TrafficSyncResponse: trafficSyncResponseSchema,
+  WordpressAuditPageDto: wordpressAuditPageDtoSchema,
+  WordpressBulkMetaResultDto: wordpressBulkMetaResultDtoSchema,
+  WordpressDiffDto: wordpressDiffDtoSchema,
+  WordpressManualAssistDto: wordpressManualAssistDtoSchema,
+  WordpressOnboardResultDto: wordpressOnboardResultDtoSchema,
+  WordpressPageDetailDto: wordpressPageDetailDtoSchema,
+  WordpressPageSummaryDto: wordpressPageSummaryDtoSchema,
+  WordpressSchemaBlockDto: wordpressSchemaBlockDtoSchema,
+  WordpressSchemaDeployResultDto: wordpressSchemaDeployResultDtoSchema,
+  WordpressSchemaStatusResultDto: wordpressSchemaStatusResultDtoSchema,
+  WordpressStatusDto: wordpressStatusDtoSchema,
+  // Shared envelope used by every 4xx/5xx response. Defined locally because
+  // the API never returns this from a typed handler — it's emitted by the
+  // global error handler. Codegen consumers reference it through the
+  // ErrorEnvelope ref so error shape is part of the public contract.
+  ErrorEnvelope: z.object({
+    error: z.object({
+      code: z.string(),
+      message: z.string(),
+      details: z.unknown().optional()
+    })
+  })
+};
+function buildComponentSchemas() {
+  const out = {};
+  for (const [name, schema] of Object.entries(SCHEMA_TABLE)) {
+    out[name] = z.toJSONSchema(schema, { target: "openapi-3.0" });
+  }
+  return out;
+}
+function jsonResponse(description, schemaName) {
+  return {
+    description,
+    content: {
+      "application/json": {
+        schema: { $ref: `#/components/schemas/${schemaName}` }
+      }
+    }
+  };
+}
+function jsonArrayResponse(description, schemaName) {
+  return {
+    description,
+    content: {
+      "application/json": {
+        schema: {
+          type: "array",
+          items: { $ref: `#/components/schemas/${schemaName}` }
+        }
+      }
+    }
+  };
+}
+function rawJsonResponse(description, schema) {
+  return {
+    description,
+    content: {
+      "application/json": { schema }
+    }
+  };
+}
+var looseObjectSchema = { type: "object", additionalProperties: true };
+function errorResponse(description) {
+  return jsonResponse(description, "ErrorEnvelope");
+}
+
 // ../api-routes/src/openapi.ts
 var stringSchema = { type: "string" };
 var booleanSchema = { type: "boolean" };
@@ -7996,7 +8216,7 @@ var routeCatalog = [
     tags: ["meta"],
     auth: false,
     responses: {
-      200: { description: "OpenAPI document." }
+      200: rawJsonResponse("OpenAPI document.", looseObjectSchema)
     }
   },
   {
@@ -8031,8 +8251,8 @@ var routeCatalog = [
       }
     },
     responses: {
-      200: { description: "Project updated." },
-      201: { description: "Project created." }
+      200: jsonResponse("Project updated.", "ProjectDto"),
+      201: jsonResponse("Project created.", "ProjectDto")
     }
   },
   {
@@ -8041,7 +8261,7 @@ var routeCatalog = [
     summary: "List projects",
     tags: ["projects"],
     responses: {
-      200: { description: "Projects returned." }
+      200: jsonArrayResponse("Projects returned.", "ProjectDto")
     }
   },
   {
@@ -8051,8 +8271,8 @@ var routeCatalog = [
     tags: ["projects"],
     parameters: [nameParameter],
     responses: {
-      200: { description: "Project returned." },
-      404: { description: "Project not found." }
+      200: jsonResponse("Project returned.", "ProjectDto"),
+      404: errorResponse("Project not found.")
     }
   },
   {
@@ -8063,7 +8283,7 @@ var routeCatalog = [
     parameters: [nameParameter],
     responses: {
       204: { description: "Project deleted." },
-      404: { description: "Project not found." }
+      404: errorResponse("Project not found.")
     }
   },
   {
@@ -8074,8 +8294,9 @@ var routeCatalog = [
     tags: ["projects"],
     parameters: [nameParameter],
     responses: {
-      200: { description: "Preview of cascade impact." },
-      404: { description: "Project not found." }
+      // TODO: Define `ProjectDeletePreviewDto` Zod schema in contracts and reference here.
+      200: rawJsonResponse("Preview of cascade impact.", looseObjectSchema),
+      404: errorResponse("Project not found.")
     }
   },
   {
@@ -8093,9 +8314,9 @@ var routeCatalog = [
       }
     },
     responses: {
-      201: { description: "Location created." },
-      400: { description: "Invalid location." },
-      404: { description: "Project not found." }
+      201: jsonResponse("Location created.", "LocationContext"),
+      400: errorResponse("Invalid location."),
+      404: errorResponse("Project not found.")
     }
   },
   {
@@ -8105,8 +8326,9 @@ var routeCatalog = [
     tags: ["projects"],
     parameters: [nameParameter],
     responses: {
-      200: { description: "Locations returned." },
-      404: { description: "Project not found." }
+      // TODO: Define `ProjectLocationsResponse` Zod schema (`{ locations: LocationContext[]; defaultLocation: string | null }`) in contracts.
+      200: rawJsonResponse("Locations returned.", looseObjectSchema),
+      404: errorResponse("Project not found.")
     }
   },
   {
@@ -8117,8 +8339,8 @@ var routeCatalog = [
     parameters: [nameParameter, locationLabelParameter],
     responses: {
       204: { description: "Location removed." },
-      400: { description: "Invalid location." },
-      404: { description: "Project or location not found." }
+      400: errorResponse("Invalid location."),
+      404: errorResponse("Project or location not found.")
     }
   },
   {
@@ -8142,9 +8364,9 @@ var routeCatalog = [
       }
     },
     responses: {
-      200: { description: "Default location updated." },
-      400: { description: "Invalid location." },
-      404: { description: "Project not found." }
+      200: jsonResponse("Default location updated.", "ProjectDto"),
+      400: errorResponse("Invalid location."),
+      404: errorResponse("Project not found.")
     }
   },
   {
@@ -8154,8 +8376,9 @@ var routeCatalog = [
     tags: ["projects"],
     parameters: [nameParameter],
     responses: {
-      200: { description: "Project configuration returned." },
-      404: { description: "Project not found." }
+      // TODO: Define an `ExportedProjectConfig` Zod schema in contracts (mirrors canonry.yaml shape).
+      200: rawJsonResponse("Project configuration returned.", looseObjectSchema),
+      404: errorResponse("Project not found.")
     }
   },
   {
@@ -8165,7 +8388,7 @@ var routeCatalog = [
     tags: ["queries"],
     parameters: [nameParameter],
     responses: {
-      200: { description: "Queries returned." }
+      200: jsonArrayResponse("Queries returned.", "QueryDto")
     }
   },
   {
@@ -8189,7 +8412,7 @@ var routeCatalog = [
       }
     },
     responses: {
-      200: { description: "Queries replaced." }
+      200: jsonArrayResponse("Queries replaced.", "QueryDto")
     }
   },
   {
@@ -8213,8 +8436,8 @@ var routeCatalog = [
       }
     },
     responses: {
-      200: { description: "Remaining queries returned." },
-      400: { description: "Invalid query delete request." }
+      200: jsonArrayResponse("Remaining queries returned.", "QueryDto"),
+      400: errorResponse("Invalid query delete request.")
     }
   },
   {
@@ -8238,7 +8461,7 @@ var routeCatalog = [
       }
     },
     responses: {
-      200: { description: "Queries appended." }
+      200: jsonArrayResponse("Queries appended.", "QueryDto")
     }
   },
   {
@@ -8263,8 +8486,9 @@ var routeCatalog = [
       }
     },
     responses: {
-      200: { description: "Replace preview returned." },
-      404: { description: "Project not found." }
+      // TODO: Add `QueriesReplacePreviewDto` Zod schema in contracts.
+      200: rawJsonResponse("Replace preview returned.", looseObjectSchema),
+      404: errorResponse("Project not found.")
     }
   },
   {
@@ -8289,8 +8513,8 @@ var routeCatalog = [
       }
     },
     responses: {
-      200: { description: "Query suggestions returned." },
-      501: { description: "Query generation is not available." }
+      200: rawJsonResponse("Query suggestions returned.", { type: "object", properties: { suggestions: { type: "array", items: { type: "string" } } } }),
+      501: errorResponse("Query generation is not available.")
     }
   },
   {
@@ -8300,7 +8524,7 @@ var routeCatalog = [
     tags: ["queries"],
     parameters: [nameParameter],
     responses: {
-      200: { description: "Legacy keyword-shaped queries returned." }
+      200: jsonArrayResponse("Legacy keyword-shaped queries returned.", "KeywordDto")
     }
   },
   {
@@ -8324,7 +8548,7 @@ var routeCatalog = [
       }
     },
     responses: {
-      200: { description: "Legacy keyword-shaped queries replaced." }
+      200: jsonArrayResponse("Legacy keyword-shaped queries replaced.", "KeywordDto")
     }
   },
   {
@@ -8348,8 +8572,8 @@ var routeCatalog = [
       }
     },
     responses: {
-      200: { description: "Remaining legacy keyword-shaped queries returned." },
-      400: { description: "Invalid legacy keyword delete request." }
+      200: jsonArrayResponse("Remaining legacy keyword-shaped queries returned.", "KeywordDto"),
+      400: errorResponse("Invalid legacy keyword delete request.")
     }
   },
   {
@@ -8373,7 +8597,7 @@ var routeCatalog = [
       }
     },
     responses: {
-      200: { description: "Legacy keyword-shaped queries appended." }
+      200: jsonArrayResponse("Legacy keyword-shaped queries appended.", "KeywordDto")
     }
   },
   {
@@ -8398,8 +8622,9 @@ var routeCatalog = [
       }
     },
     responses: {
-      200: { description: "Legacy keyword suggestions returned." },
-      501: { description: "Legacy keyword generation is not available." }
+      // TODO: Add `KeywordGenerateResponse` Zod schema (`{ suggestions: string[] }`) in contracts.
+      200: rawJsonResponse("Legacy keyword suggestions returned.", looseObjectSchema),
+      501: errorResponse("Legacy keyword generation is not available.")
     }
   },
   {
@@ -8409,7 +8634,7 @@ var routeCatalog = [
     tags: ["competitors"],
     parameters: [nameParameter],
     responses: {
-      200: { description: "Competitors returned." }
+      200: jsonArrayResponse("Competitors returned.", "CompetitorDto")
     }
   },
   {
@@ -8433,7 +8658,7 @@ var routeCatalog = [
       }
     },
     responses: {
-      200: { description: "Competitors replaced." }
+      200: jsonArrayResponse("Competitors replaced.", "CompetitorDto")
     }
   },
   {
@@ -8457,8 +8682,8 @@ var routeCatalog = [
       }
     },
     responses: {
-      200: { description: "Competitors appended." },
-      400: { description: "Invalid competitor append request." }
+      200: jsonArrayResponse("Competitors appended.", "CompetitorDto"),
+      400: errorResponse("Invalid competitor append request.")
     }
   },
   {
@@ -8482,8 +8707,8 @@ var routeCatalog = [
       }
     },
     responses: {
-      200: { description: "Remaining competitors returned." },
-      400: { description: "Invalid competitor delete request." }
+      200: jsonArrayResponse("Remaining competitors returned.", "CompetitorDto"),
+      400: errorResponse("Invalid competitor delete request.")
     }
   },
   {
@@ -8511,8 +8736,8 @@ var routeCatalog = [
       }
     },
     responses: {
-      201: { description: "Run queued." },
-      409: { description: "Run already in progress." }
+      201: jsonResponse("Run queued.", "RunDto"),
+      409: errorResponse("Run already in progress.")
     }
   },
   {
@@ -8522,7 +8747,7 @@ var routeCatalog = [
     tags: ["runs"],
     parameters: [nameParameter, limitQueryParameter],
     responses: {
-      200: { description: "Runs returned." }
+      200: jsonArrayResponse("Runs returned.", "RunDto")
     }
   },
   {
@@ -8532,7 +8757,7 @@ var routeCatalog = [
     tags: ["runs"],
     parameters: [nameParameter],
     responses: {
-      200: { description: "Latest run returned." }
+      200: jsonResponse("Latest run returned.", "LatestProjectRunDto")
     }
   },
   {
@@ -8541,7 +8766,7 @@ var routeCatalog = [
     summary: "List all runs",
     tags: ["runs"],
     responses: {
-      200: { description: "Runs returned." }
+      200: jsonArrayResponse("Runs returned.", "RunDto")
     }
   },
   {
@@ -8563,7 +8788,8 @@ var routeCatalog = [
       }
     },
     responses: {
-      207: { description: "Run results returned." }
+      // TODO: Add `TriggerAllRunsResponse` Zod schema in contracts.
+      207: rawJsonResponse("Run results returned.", looseObjectSchema)
     }
   },
   {
@@ -8573,8 +8799,8 @@ var routeCatalog = [
     tags: ["runs"],
     parameters: [runIdParameter],
     responses: {
-      200: { description: "Run returned." },
-      404: { description: "Run not found." }
+      200: jsonResponse("Run returned.", "RunDetailDto"),
+      404: errorResponse("Run not found.")
     }
   },
   {
@@ -8584,9 +8810,9 @@ var routeCatalog = [
     tags: ["runs"],
     parameters: [runIdParameter],
     responses: {
-      200: { description: "Run cancelled." },
-      404: { description: "Run not found." },
-      409: { description: "Run is not cancellable." }
+      200: jsonResponse("Run cancelled.", "RunDto"),
+      404: errorResponse("Run not found."),
+      409: errorResponse("Run is not cancellable.")
     }
   },
   {
@@ -8604,8 +8830,9 @@ var routeCatalog = [
       }
     },
     responses: {
-      200: { description: "Config applied." },
-      400: { description: "Invalid config." }
+      // TODO: Add `ApplyResultDto` Zod schema in contracts (single-doc apply result).
+      200: jsonResponse("Config applied.", "ProjectDto"),
+      400: errorResponse("Invalid config.")
     }
   },
   {
@@ -8615,7 +8842,7 @@ var routeCatalog = [
     tags: ["history"],
     parameters: [nameParameter],
     responses: {
-      200: { description: "Audit history returned." }
+      200: jsonArrayResponse("Audit history returned.", "AuditLogEntry")
     }
   },
   {
@@ -8624,7 +8851,7 @@ var routeCatalog = [
     summary: "Get global audit history",
     tags: ["history"],
     responses: {
-      200: { description: "Audit history returned." }
+      200: jsonArrayResponse("Audit history returned.", "AuditLogEntry")
     }
   },
   {
@@ -8639,7 +8866,7 @@ var routeCatalog = [
       locationQueryParameter
     ],
     responses: {
-      200: { description: "Snapshots returned." }
+      200: jsonResponse("Snapshots returned.", "SnapshotListResponse")
     }
   },
   {
@@ -8649,7 +8876,8 @@ var routeCatalog = [
     tags: ["history"],
     parameters: [nameParameter, locationQueryParameter],
     responses: {
-      200: { description: "Timeline returned." }
+      // TODO: Add `ProjectTimelineDto` Zod schema in contracts.
+      200: rawJsonResponse("Timeline returned.", looseObjectSchema)
     }
   },
   {
@@ -8659,8 +8887,9 @@ var routeCatalog = [
     tags: ["analytics"],
     parameters: [nameParameter, analyticsWindowParameter],
     responses: {
-      200: { description: "Citation metrics returned." },
-      404: { description: "Project not found." }
+      // TODO: Add `BrandMetricsDto` Zod schema in contracts.
+      200: rawJsonResponse("Citation metrics returned.", looseObjectSchema),
+      404: errorResponse("Project not found.")
     }
   },
   {
@@ -8670,8 +8899,9 @@ var routeCatalog = [
     tags: ["analytics"],
     parameters: [nameParameter, analyticsWindowParameter],
     responses: {
-      200: { description: "Gap analysis returned." },
-      404: { description: "Project not found." }
+      // TODO: Add `GapAnalysisDto` Zod schema in contracts.
+      200: rawJsonResponse("Gap analysis returned.", looseObjectSchema),
+      404: errorResponse("Project not found.")
     }
   },
   {
@@ -8681,8 +8911,9 @@ var routeCatalog = [
     tags: ["analytics"],
     parameters: [nameParameter, analyticsWindowParameter],
     responses: {
-      200: { description: "Source breakdown returned." },
-      404: { description: "Project not found." }
+      // TODO: Add `SourceBreakdownDto` Zod schema in contracts.
+      200: rawJsonResponse("Source breakdown returned.", looseObjectSchema),
+      404: errorResponse("Project not found.")
     }
   },
   {
@@ -8708,8 +8939,8 @@ var routeCatalog = [
       }
     ],
     responses: {
-      200: { description: "Diff returned." },
-      400: { description: "Missing run IDs." }
+      200: jsonResponse("Diff returned.", "SnapshotDiffResponse"),
+      400: errorResponse("Missing run IDs.")
     }
   },
   {
@@ -8718,7 +8949,7 @@ var routeCatalog = [
     summary: "Get provider settings summary",
     tags: ["settings"],
     responses: {
-      200: { description: "Settings returned." }
+      200: jsonResponse("Settings returned.", "SettingsDto")
     }
   },
   {
@@ -8744,9 +8975,10 @@ var routeCatalog = [
       }
     },
     responses: {
-      200: { description: "Provider updated." },
-      400: { description: "Invalid provider settings." },
-      501: { description: "Provider updates are not supported." }
+      // TODO: Add `ProviderSettingsDto` Zod schema in contracts.
+      200: rawJsonResponse("Provider updated.", looseObjectSchema),
+      400: errorResponse("Invalid provider settings."),
+      501: errorResponse("Provider updates are not supported.")
     }
   },
   {
@@ -8770,9 +9002,10 @@ var routeCatalog = [
       }
     },
     responses: {
-      200: { description: "Google settings updated." },
-      400: { description: "Invalid Google settings." },
-      501: { description: "Google settings updates are not supported." }
+      // TODO: Add `GoogleSettingsDto` Zod schema in contracts.
+      200: rawJsonResponse("Google settings updated.", looseObjectSchema),
+      400: errorResponse("Invalid Google settings."),
+      501: errorResponse("Google settings updates are not supported.")
     }
   },
   {
@@ -8798,9 +9031,9 @@ var routeCatalog = [
       }
     },
     responses: {
-      200: { description: "Snapshot report returned." },
-      400: { description: "Invalid snapshot input." },
-      501: { description: "Snapshot reporting is not supported." }
+      200: jsonResponse("Snapshot report returned.", "SnapshotReportDto"),
+      400: errorResponse("Invalid snapshot input."),
+      501: errorResponse("Snapshot reporting is not supported.")
     }
   },
   {
@@ -8823,9 +9056,10 @@ var routeCatalog = [
       }
     },
     responses: {
-      200: { description: "Bing settings updated." },
-      400: { description: "Invalid Bing settings." },
-      501: { description: "Bing settings updates are not supported." }
+      // TODO: Add `BingSettingsDto` Zod schema in contracts.
+      200: rawJsonResponse("Bing settings updated.", looseObjectSchema),
+      400: errorResponse("Invalid Bing settings."),
+      501: errorResponse("Bing settings updates are not supported.")
     }
   },
   {
@@ -8849,9 +9083,10 @@ var routeCatalog = [
       }
     },
     responses: {
-      200: { description: "CDP endpoint updated." },
-      400: { description: "Invalid CDP settings." },
-      501: { description: "CDP updates are not supported." }
+      // TODO: Add `CdpEndpointConfigDto` Zod schema in contracts.
+      200: rawJsonResponse("CDP endpoint updated.", looseObjectSchema),
+      400: errorResponse("Invalid CDP settings."),
+      501: errorResponse("CDP updates are not supported.")
     }
   },
   {
@@ -8880,9 +9115,9 @@ var routeCatalog = [
       }
     },
     responses: {
-      200: { description: "Schedule updated." },
-      201: { description: "Schedule created." },
-      400: { description: "Invalid payload (e.g. sourceId missing for kind=traffic-sync, or providers set for kind=traffic-sync)." }
+      200: jsonResponse("Schedule updated.", "ScheduleDto"),
+      201: jsonResponse("Schedule created.", "ScheduleDto"),
+      400: errorResponse("Invalid payload (e.g. sourceId missing for kind=traffic-sync, or providers set for kind=traffic-sync).")
     }
   },
   {
@@ -8892,8 +9127,8 @@ var routeCatalog = [
     tags: ["schedules"],
     parameters: [nameParameter, scheduleKindQueryParameter],
     responses: {
-      200: { description: "Schedule returned." },
-      404: { description: "Schedule not found." }
+      200: jsonResponse("Schedule returned.", "ScheduleDto"),
+      404: errorResponse("Schedule not found.")
     }
   },
   {
@@ -8904,7 +9139,7 @@ var routeCatalog = [
     parameters: [nameParameter, scheduleKindQueryParameter],
     responses: {
       204: { description: "Schedule deleted." },
-      404: { description: "Schedule not found." }
+      404: errorResponse("Schedule not found.")
     }
   },
   {
@@ -8913,7 +9148,7 @@ var routeCatalog = [
     summary: "List notification event types",
     tags: ["notifications"],
     responses: {
-      200: { description: "Events returned." }
+      200: rawJsonResponse("Events returned.", { type: "array", items: stringSchema })
     }
   },
   {
@@ -8939,7 +9174,7 @@ var routeCatalog = [
       }
     },
     responses: {
-      201: { description: "Notification created." }
+      201: jsonResponse("Notification created.", "NotificationDto")
     }
   },
   {
@@ -8949,7 +9184,7 @@ var routeCatalog = [
     tags: ["notifications"],
     parameters: [nameParameter],
     responses: {
-      200: { description: "Notifications returned." }
+      200: jsonArrayResponse("Notifications returned.", "NotificationDto")
     }
   },
   {
@@ -8960,7 +9195,7 @@ var routeCatalog = [
     parameters: [nameParameter, notificationIdParameter],
     responses: {
       204: { description: "Notification deleted." },
-      404: { description: "Notification not found." }
+      404: errorResponse("Notification not found.")
     }
   },
   {
@@ -8970,10 +9205,11 @@ var routeCatalog = [
     tags: ["notifications"],
     parameters: [nameParameter, notificationIdParameter],
     responses: {
-      200: { description: "Test notification sent." },
-      400: { description: "Stored notification config is invalid." },
-      404: { description: "Notification not found." },
-      502: { description: "Notification delivery failed." }
+      // TODO: Add `NotificationTestResult` Zod schema in contracts.
+      200: rawJsonResponse("Test notification sent.", looseObjectSchema),
+      400: errorResponse("Stored notification config is invalid."),
+      404: errorResponse("Notification not found."),
+      502: errorResponse("Notification delivery failed.")
     }
   },
   {
@@ -8982,8 +9218,9 @@ var routeCatalog = [
     summary: "Get telemetry status",
     tags: ["telemetry"],
     responses: {
-      200: { description: "Telemetry status returned." },
-      501: { description: "Telemetry status is not available." }
+      // TODO: Add `TelemetryStatusDto` Zod schema in contracts.
+      200: rawJsonResponse("Telemetry status returned.", looseObjectSchema),
+      501: errorResponse("Telemetry status is not available.")
     }
   },
   {
@@ -9006,9 +9243,10 @@ var routeCatalog = [
       }
     },
     responses: {
-      200: { description: "Telemetry updated." },
-      400: { description: "Invalid telemetry request." },
-      501: { description: "Telemetry configuration is not available." }
+      // TODO: Add `TelemetryStatusDto` Zod schema in contracts.
+      200: rawJsonResponse("Telemetry updated.", looseObjectSchema),
+      400: errorResponse("Invalid telemetry request."),
+      501: errorResponse("Telemetry configuration is not available.")
     }
   },
   {
@@ -9018,8 +9256,9 @@ var routeCatalog = [
     tags: ["cdp"],
     parameters: [snapshotIdParameter],
     responses: {
-      200: { description: "Screenshot returned." },
-      404: { description: "Screenshot not found." }
+      // Returns image bytes, not JSON. Codegen consumers should treat this as a binary stream.
+      200: { description: "Screenshot returned.", content: { "image/png": { schema: { type: "string", format: "binary" } } } },
+      404: errorResponse("Screenshot not found.")
     }
   },
   {
@@ -9028,8 +9267,8 @@ var routeCatalog = [
     summary: "Get CDP connection status",
     tags: ["cdp"],
     responses: {
-      200: { description: "CDP status returned." },
-      501: { description: "CDP is not configured." }
+      200: jsonResponse("CDP status returned.", "CdpStatusDto"),
+      501: errorResponse("CDP is not configured.")
     }
   },
   {
@@ -9053,9 +9292,10 @@ var routeCatalog = [
       }
     },
     responses: {
-      200: { description: "CDP screenshot results returned." },
-      400: { description: "Invalid CDP screenshot request." },
-      501: { description: "CDP screenshot support is not available." }
+      // TODO: Add `CdpScreenshotResultDto` Zod schema in contracts.
+      200: rawJsonResponse("CDP screenshot results returned.", looseObjectSchema),
+      400: errorResponse("Invalid CDP screenshot request."),
+      501: errorResponse("CDP screenshot support is not available.")
     }
   },
   {
@@ -9065,8 +9305,9 @@ var routeCatalog = [
     tags: ["cdp", "runs"],
     parameters: [nameParameter, projectRunIdParameter],
     responses: {
-      200: { description: "Browser diff returned." },
-      404: { description: "Project or run not found." }
+      // TODO: Add `BrowserDiffDto` Zod schema in contracts.
+      200: rawJsonResponse("Browser diff returned.", looseObjectSchema),
+      404: errorResponse("Project or run not found.")
     }
   },
   {
@@ -9081,9 +9322,9 @@ var routeCatalog = [
       { name: "error", in: "query", description: "OAuth error code.", schema: stringSchema }
     ],
     responses: {
-      200: { description: "OAuth callback handled." },
-      400: { description: "Invalid callback request." },
-      500: { description: "OAuth configuration is incomplete." }
+      200: rawJsonResponse("OAuth callback handled.", { type: "object", properties: { status: { type: "string" } } }),
+      400: errorResponse("Invalid callback request."),
+      500: errorResponse("OAuth configuration is incomplete.")
     }
   },
   {
@@ -9099,9 +9340,9 @@ var routeCatalog = [
       { name: "error", in: "query", description: "OAuth error code.", schema: stringSchema }
     ],
     responses: {
-      200: { description: "OAuth callback handled." },
-      400: { description: "Invalid callback request." },
-      500: { description: "OAuth configuration is incomplete." }
+      200: rawJsonResponse("OAuth callback handled.", { type: "object", properties: { status: { type: "string" } } }),
+      400: errorResponse("Invalid callback request."),
+      500: errorResponse("OAuth configuration is incomplete.")
     }
   },
   {
@@ -9111,8 +9352,8 @@ var routeCatalog = [
     tags: ["google"],
     parameters: [nameParameter],
     responses: {
-      200: { description: "Google connections returned." },
-      404: { description: "Project not found." }
+      200: jsonArrayResponse("Google connections returned.", "GoogleConnectionDto"),
+      404: errorResponse("Project not found.")
     }
   },
   {
@@ -9138,8 +9379,8 @@ var routeCatalog = [
       }
     },
     responses: {
-      200: { description: "Google auth URL returned." },
-      400: { description: "Invalid Google connection request." }
+      200: rawJsonResponse("Google auth URL returned.", { type: "object", properties: { url: { type: "string" } } }),
+      400: errorResponse("Invalid Google connection request.")
     }
   },
   {
@@ -9150,7 +9391,7 @@ var routeCatalog = [
     parameters: [nameParameter, googleTypeParameter],
     responses: {
       204: { description: "Google connection deleted." },
-      404: { description: "Project or connection not found." }
+      404: errorResponse("Project or connection not found.")
     }
   },
   {
@@ -9160,9 +9401,9 @@ var routeCatalog = [
     tags: ["google"],
     parameters: [nameParameter],
     responses: {
-      200: { description: "Google properties returned." },
-      400: { description: "Google OAuth is not configured." },
-      404: { description: "Project not found." }
+      200: jsonResponse("Google properties returned.", "GscSiteListResponseDto"),
+      400: errorResponse("Google OAuth is not configured."),
+      404: errorResponse("Project not found.")
     }
   },
   {
@@ -9186,9 +9427,9 @@ var routeCatalog = [
       }
     },
     responses: {
-      200: { description: "Google property updated." },
-      400: { description: "Invalid property request." },
-      404: { description: "Project or connection not found." }
+      200: jsonResponse("Google property updated.", "GoogleConnectionDto"),
+      400: errorResponse("Invalid property request."),
+      404: errorResponse("Project or connection not found.")
     }
   },
   {
@@ -9212,9 +9453,9 @@ var routeCatalog = [
       }
     },
     responses: {
-      200: { description: "Google sitemap updated." },
-      400: { description: "Invalid sitemap request." },
-      404: { description: "Project or connection not found." }
+      200: jsonResponse("Google sitemap updated.", "GoogleConnectionDto"),
+      400: errorResponse("Invalid sitemap request."),
+      404: errorResponse("Project or connection not found.")
     }
   },
   {
@@ -9237,9 +9478,9 @@ var routeCatalog = [
       }
     },
     responses: {
-      200: { description: "GSC sync run returned." },
-      400: { description: "Invalid GSC sync request." },
-      404: { description: "Project or connection not found." }
+      200: jsonResponse("GSC sync run returned.", "RunDto"),
+      400: errorResponse("Invalid GSC sync request."),
+      404: errorResponse("Project or connection not found.")
     }
   },
   {
@@ -9258,8 +9499,11 @@ var routeCatalog = [
       analyticsWindowParameter
     ],
     responses: {
-      200: { description: "GSC performance rows returned." },
-      404: { description: "Project not found." }
+      // Handler returns an array of GscSearchDataDto rows (web's
+      // ApiGscPerformanceRow[] confirms). Was incorrectly spec'd as a
+      // single object, which silently truncated client types to one row.
+      200: jsonArrayResponse("GSC performance rows returned.", "GscSearchDataDto"),
+      404: errorResponse("Project not found.")
     }
   },
   {
@@ -9274,8 +9518,8 @@ var routeCatalog = [
       analyticsWindowParameter
     ],
     responses: {
-      200: { description: "Daily aggregate (date \u2192 clicks/impressions/ctr) plus window totals." },
-      404: { description: "Project not found." }
+      200: jsonResponse("Daily aggregate (date \u2192 clicks/impressions/ctr) plus window totals.", "GscPerformanceDailyDto"),
+      404: errorResponse("Project not found.")
     }
   },
   {
@@ -9299,9 +9543,9 @@ var routeCatalog = [
       }
     },
     responses: {
-      200: { description: "GSC inspection result returned." },
-      400: { description: "Invalid inspection request." },
-      404: { description: "Project or connection not found." }
+      200: jsonResponse("GSC inspection result returned.", "GscUrlInspectionDto"),
+      400: errorResponse("Invalid inspection request."),
+      404: errorResponse("Project or connection not found.")
     }
   },
   {
@@ -9311,8 +9555,8 @@ var routeCatalog = [
     tags: ["google"],
     parameters: [nameParameter, { name: "url", in: "query", description: "Filter by URL.", schema: stringSchema }, limitQueryParameter],
     responses: {
-      200: { description: "GSC inspections returned." },
-      404: { description: "Project not found." }
+      200: jsonArrayResponse("GSC inspections returned.", "GscUrlInspectionDto"),
+      404: errorResponse("Project not found.")
     }
   },
   {
@@ -9322,8 +9566,8 @@ var routeCatalog = [
     tags: ["google"],
     parameters: [nameParameter],
     responses: {
-      200: { description: "Deindexed pages returned." },
-      404: { description: "Project not found." }
+      200: jsonArrayResponse("Deindexed pages returned.", "GscDeindexedRowDto"),
+      404: errorResponse("Project not found.")
     }
   },
   {
@@ -9333,8 +9577,8 @@ var routeCatalog = [
     tags: ["google"],
     parameters: [nameParameter],
     responses: {
-      200: { description: "GSC coverage returned." },
-      404: { description: "Project not found." }
+      200: jsonResponse("GSC coverage returned.", "GscCoverageSummaryDto"),
+      404: errorResponse("Project not found.")
     }
   },
   {
@@ -9344,8 +9588,8 @@ var routeCatalog = [
     tags: ["google"],
     parameters: [nameParameter, limitQueryParameter],
     responses: {
-      200: { description: "GSC coverage history returned." },
-      404: { description: "Project not found." }
+      200: jsonArrayResponse("GSC coverage history returned.", "GscCoverageSnapshotDto"),
+      404: errorResponse("Project not found.")
     }
   },
   {
@@ -9355,9 +9599,9 @@ var routeCatalog = [
     tags: ["google"],
     parameters: [nameParameter],
     responses: {
-      200: { description: "GSC sitemaps returned." },
-      400: { description: "Invalid sitemap request." },
-      404: { description: "Project or connection not found." }
+      200: jsonResponse("GSC sitemaps returned.", "GscSitemapListResponseDto"),
+      400: errorResponse("Invalid sitemap request."),
+      404: errorResponse("Project or connection not found.")
     }
   },
   {
@@ -9367,9 +9611,10 @@ var routeCatalog = [
     tags: ["google"],
     parameters: [nameParameter],
     responses: {
-      200: { description: "Discovered sitemaps and queued run returned." },
-      400: { description: "Invalid sitemap discovery request." },
-      404: { description: "Project or connection not found." }
+      // TODO: Add `DiscoverSitemapsResponse` Zod schema in contracts.
+      200: rawJsonResponse("Discovered sitemaps and queued run returned.", looseObjectSchema),
+      400: errorResponse("Invalid sitemap discovery request."),
+      404: errorResponse("Project or connection not found.")
     }
   },
   {
@@ -9391,9 +9636,9 @@ var routeCatalog = [
       }
     },
     responses: {
-      200: { description: "Sitemap inspection run returned." },
-      400: { description: "Invalid sitemap inspection request." },
-      404: { description: "Project or connection not found." }
+      200: jsonResponse("Sitemap inspection run returned.", "RunDto"),
+      400: errorResponse("Invalid sitemap inspection request."),
+      404: errorResponse("Project or connection not found.")
     }
   },
   {
@@ -9417,9 +9662,9 @@ var routeCatalog = [
       }
     },
     responses: {
-      200: { description: "Indexing request results returned." },
-      400: { description: "Invalid indexing request." },
-      404: { description: "Project or connection not found." }
+      200: jsonResponse("Indexing request results returned.", "IndexingRequestResponseDto"),
+      400: errorResponse("Invalid indexing request."),
+      404: errorResponse("Project or connection not found.")
     }
   },
   {
@@ -9443,9 +9688,9 @@ var routeCatalog = [
       }
     },
     responses: {
-      200: { description: "Bing connection returned." },
-      400: { description: "Invalid Bing connection request." },
-      404: { description: "Project not found." }
+      200: jsonResponse("Bing connection returned.", "BingConnectResponseDto"),
+      400: errorResponse("Invalid Bing connection request."),
+      404: errorResponse("Project not found.")
     }
   },
   {
@@ -9456,7 +9701,7 @@ var routeCatalog = [
     parameters: [nameParameter],
     responses: {
       204: { description: "Bing connection deleted." },
-      404: { description: "Project or connection not found." }
+      404: errorResponse("Project or connection not found.")
     }
   },
   {
@@ -9466,8 +9711,8 @@ var routeCatalog = [
     tags: ["bing"],
     parameters: [nameParameter],
     responses: {
-      200: { description: "Bing status returned." },
-      404: { description: "Project not found." }
+      200: jsonResponse("Bing status returned.", "BingStatusDto"),
+      404: errorResponse("Project not found.")
     }
   },
   {
@@ -9477,9 +9722,9 @@ var routeCatalog = [
     tags: ["bing"],
     parameters: [nameParameter],
     responses: {
-      200: { description: "Bing sites returned." },
-      400: { description: "Bing is not configured for this project." },
-      404: { description: "Project not found." }
+      200: jsonResponse("Bing sites returned.", "BingSitesResponseDto"),
+      400: errorResponse("Bing is not configured for this project."),
+      404: errorResponse("Project not found.")
     }
   },
   {
@@ -9503,9 +9748,9 @@ var routeCatalog = [
       }
     },
     responses: {
-      200: { description: "Active Bing site updated." },
-      400: { description: "Invalid Bing site request." },
-      404: { description: "Project or connection not found." }
+      200: jsonResponse("Active Bing site updated.", "BingSetSiteResponseDto"),
+      400: errorResponse("Invalid Bing site request."),
+      404: errorResponse("Project or connection not found.")
     }
   },
   {
@@ -9515,9 +9760,13 @@ var routeCatalog = [
     tags: ["bing"],
     parameters: [nameParameter],
     responses: {
-      200: { description: "Bing coverage returned." },
-      400: { description: "Bing is not configured for this project." },
-      404: { description: "Project not found." }
+      // Was incorrectly mapped to `BingCoverageSnapshotDto` (the daily
+      // history snapshot — 4 fields). The /coverage handler actually
+      // returns the nested summary shape with indexed/notIndexed/unknown
+      // arrays. `BingCoverageSummaryDto` is the right ref.
+      200: jsonResponse("Bing coverage returned.", "BingCoverageSummaryDto"),
+      400: errorResponse("Bing is not configured for this project."),
+      404: errorResponse("Project not found.")
     }
   },
   {
@@ -9527,9 +9776,9 @@ var routeCatalog = [
     tags: ["bing"],
     parameters: [nameParameter, limitQueryParameter],
     responses: {
-      200: { description: "Bing coverage history returned." },
-      400: { description: "Bing is not configured for this project." },
-      404: { description: "Project not found." }
+      200: jsonArrayResponse("Bing coverage history returned.", "BingCoverageSnapshotDto"),
+      400: errorResponse("Bing is not configured for this project."),
+      404: errorResponse("Project not found.")
     }
   },
   {
@@ -9539,9 +9788,9 @@ var routeCatalog = [
     tags: ["bing"],
     parameters: [nameParameter, { name: "url", in: "query", description: "Filter by URL.", schema: stringSchema }, limitQueryParameter],
     responses: {
-      200: { description: "Bing inspections returned." },
-      400: { description: "Bing is not configured for this project." },
-      404: { description: "Project not found." }
+      200: jsonArrayResponse("Bing inspections returned.", "BingUrlInspectionDto"),
+      400: errorResponse("Bing is not configured for this project."),
+      404: errorResponse("Project not found.")
     }
   },
   {
@@ -9565,9 +9814,9 @@ var routeCatalog = [
       }
     },
     responses: {
-      200: { description: "Bing inspection result returned." },
-      400: { description: "Invalid inspection request." },
-      404: { description: "Project or connection not found." }
+      200: jsonResponse("Bing inspection result returned.", "BingUrlInspectionDto"),
+      400: errorResponse("Invalid inspection request."),
+      404: errorResponse("Project or connection not found.")
     }
   },
   {
@@ -9590,9 +9839,9 @@ var routeCatalog = [
       }
     },
     responses: {
-      200: { description: "Sitemap inspection run queued." },
-      400: { description: "Bing is not configured for this project." },
-      404: { description: "Project not found." }
+      200: jsonResponse("Sitemap inspection run queued.", "RunDto"),
+      400: errorResponse("Bing is not configured for this project."),
+      404: errorResponse("Project not found.")
     }
   },
   {
@@ -9616,9 +9865,9 @@ var routeCatalog = [
       }
     },
     responses: {
-      200: { description: "Bing indexing request results returned." },
-      400: { description: "Invalid indexing request." },
-      404: { description: "Project or connection not found." }
+      200: jsonResponse("Bing indexing request results returned.", "BingIndexingRequestResponseDto"),
+      400: errorResponse("Invalid indexing request."),
+      404: errorResponse("Project or connection not found.")
     }
   },
   {
@@ -9628,9 +9877,9 @@ var routeCatalog = [
     tags: ["bing"],
     parameters: [nameParameter, limitQueryParameter],
     responses: {
-      200: { description: "Bing performance returned." },
-      400: { description: "Bing is not configured for this project." },
-      404: { description: "Project not found." }
+      200: jsonArrayResponse("Bing performance returned.", "BingKeywordStatsDto"),
+      400: errorResponse("Bing is not configured for this project."),
+      404: errorResponse("Project not found.")
     }
   },
   {
@@ -9658,9 +9907,9 @@ var routeCatalog = [
       }
     },
     responses: {
-      200: { description: "WordPress connection status returned." },
-      400: { description: "Invalid WordPress connection request." },
-      404: { description: "Project not found." }
+      200: jsonResponse("WordPress connection status returned.", "WordpressStatusDto"),
+      400: errorResponse("Invalid WordPress connection request."),
+      404: errorResponse("Project not found.")
     }
   },
   {
@@ -9671,7 +9920,7 @@ var routeCatalog = [
     parameters: [nameParameter],
     responses: {
       204: { description: "WordPress connection deleted." },
-      404: { description: "Project or connection not found." }
+      404: errorResponse("Project or connection not found.")
     }
   },
   {
@@ -9681,8 +9930,8 @@ var routeCatalog = [
     tags: ["wordpress"],
     parameters: [nameParameter],
     responses: {
-      200: { description: "WordPress status returned." },
-      404: { description: "Project not found." }
+      200: jsonResponse("WordPress status returned.", "WordpressStatusDto"),
+      404: errorResponse("Project not found.")
     }
   },
   {
@@ -9692,9 +9941,9 @@ var routeCatalog = [
     tags: ["wordpress"],
     parameters: [nameParameter, wordpressEnvQueryParameter],
     responses: {
-      200: { description: "WordPress pages returned." },
-      400: { description: "Invalid environment or missing connection." },
-      404: { description: "Project not found." }
+      200: jsonArrayResponse("WordPress pages returned.", "WordpressPageSummaryDto"),
+      400: errorResponse("Invalid environment or missing connection."),
+      404: errorResponse("Project not found.")
     }
   },
   {
@@ -9704,9 +9953,9 @@ var routeCatalog = [
     tags: ["wordpress"],
     parameters: [nameParameter, wordpressSlugQueryParameter, wordpressEnvQueryParameter],
     responses: {
-      200: { description: "WordPress page returned." },
-      400: { description: "Invalid slug or environment." },
-      404: { description: "Project, connection, or page not found." }
+      200: jsonResponse("WordPress page returned.", "WordpressPageDetailDto"),
+      400: errorResponse("Invalid slug or environment."),
+      404: errorResponse("Project, connection, or page not found.")
     }
   },
   {
@@ -9734,9 +9983,9 @@ var routeCatalog = [
       }
     },
     responses: {
-      200: { description: "WordPress page created." },
-      400: { description: "Invalid page creation request." },
-      404: { description: "Project or connection not found." }
+      200: jsonResponse("WordPress page created.", "WordpressPageDetailDto"),
+      400: errorResponse("Invalid page creation request."),
+      404: errorResponse("Project or connection not found.")
     }
   },
   {
@@ -9765,9 +10014,9 @@ var routeCatalog = [
       }
     },
     responses: {
-      200: { description: "WordPress page updated." },
-      400: { description: "Invalid page update request." },
-      404: { description: "Project, connection, or page not found." }
+      200: jsonResponse("WordPress page updated.", "WordpressPageDetailDto"),
+      400: errorResponse("Invalid page update request."),
+      404: errorResponse("Project, connection, or page not found.")
     }
   },
   {
@@ -9795,9 +10044,10 @@ var routeCatalog = [
       }
     },
     responses: {
-      200: { description: "WordPress SEO meta updated." },
-      400: { description: "SEO meta is unsupported or the request is invalid." },
-      404: { description: "Project, connection, or page not found." }
+      // TODO: Add `WordpressSeoStateDto` to the schema table (already in contracts).
+      200: rawJsonResponse("WordPress SEO meta updated.", looseObjectSchema),
+      400: errorResponse("SEO meta is unsupported or the request is invalid."),
+      404: errorResponse("Project, connection, or page not found.")
     }
   },
   {
@@ -9834,9 +10084,9 @@ var routeCatalog = [
       }
     },
     responses: {
-      200: { description: "Bulk SEO meta update results returned." },
-      400: { description: "Invalid entries or environment." },
-      404: { description: "Project or connection not found." }
+      200: jsonResponse("Bulk SEO meta update results returned.", "WordpressBulkMetaResultDto"),
+      400: errorResponse("Invalid entries or environment."),
+      404: errorResponse("Project or connection not found.")
     }
   },
   {
@@ -9846,9 +10096,9 @@ var routeCatalog = [
     tags: ["wordpress"],
     parameters: [nameParameter, wordpressSlugQueryParameter, wordpressEnvQueryParameter],
     responses: {
-      200: { description: "WordPress schema blocks returned." },
-      400: { description: "Invalid slug or environment." },
-      404: { description: "Project, connection, or page not found." }
+      200: jsonArrayResponse("WordPress schema blocks returned.", "WordpressSchemaBlockDto"),
+      400: errorResponse("Invalid slug or environment."),
+      404: errorResponse("Project, connection, or page not found.")
     }
   },
   {
@@ -9875,9 +10125,9 @@ var routeCatalog = [
       }
     },
     responses: {
-      200: { description: "Manual schema instructions returned." },
-      400: { description: "Invalid schema request." },
-      404: { description: "Project, connection, or page not found." }
+      200: jsonResponse("Manual schema instructions returned.", "WordpressManualAssistDto"),
+      400: errorResponse("Invalid schema request."),
+      404: errorResponse("Project, connection, or page not found.")
     }
   },
   {
@@ -9905,9 +10155,9 @@ var routeCatalog = [
       }
     },
     responses: {
-      200: { description: "Schema deployment results returned." },
-      400: { description: "Invalid profile or environment." },
-      404: { description: "Project or connection not found." }
+      200: jsonResponse("Schema deployment results returned.", "WordpressSchemaDeployResultDto"),
+      400: errorResponse("Invalid profile or environment."),
+      404: errorResponse("Project or connection not found.")
     }
   },
   {
@@ -9917,9 +10167,9 @@ var routeCatalog = [
     tags: ["wordpress"],
     parameters: [nameParameter, wordpressEnvQueryParameter],
     responses: {
-      200: { description: "Schema status per page returned." },
-      400: { description: "Invalid environment." },
-      404: { description: "Project or connection not found." }
+      200: jsonResponse("Schema status per page returned.", "WordpressSchemaStatusResultDto"),
+      400: errorResponse("Invalid environment."),
+      404: errorResponse("Project or connection not found.")
     }
   },
   {
@@ -9929,9 +10179,10 @@ var routeCatalog = [
     tags: ["wordpress"],
     parameters: [nameParameter, wordpressEnvQueryParameter],
     responses: {
-      200: { description: "llms.txt returned." },
-      400: { description: "Invalid environment or missing connection." },
-      404: { description: "Project not found." }
+      // Returns raw text/plain content of llms.txt.
+      200: { description: "llms.txt returned.", content: { "text/plain": { schema: { type: "string" } } } },
+      400: errorResponse("Invalid environment or missing connection."),
+      404: errorResponse("Project not found.")
     }
   },
   {
@@ -9956,9 +10207,9 @@ var routeCatalog = [
       }
     },
     responses: {
-      200: { description: "Manual llms.txt instructions returned." },
-      400: { description: "Invalid llms.txt request." },
-      404: { description: "Project or connection not found." }
+      200: jsonResponse("Manual llms.txt instructions returned.", "WordpressManualAssistDto"),
+      400: errorResponse("Invalid llms.txt request."),
+      404: errorResponse("Project or connection not found.")
     }
   },
   {
@@ -9968,9 +10219,9 @@ var routeCatalog = [
     tags: ["wordpress"],
     parameters: [nameParameter, wordpressEnvQueryParameter],
     responses: {
-      200: { description: "WordPress audit returned." },
-      400: { description: "Invalid environment or missing connection." },
-      404: { description: "Project not found." }
+      200: jsonArrayResponse("WordPress audit returned.", "WordpressAuditPageDto"),
+      400: errorResponse("Invalid environment or missing connection."),
+      404: errorResponse("Project not found.")
     }
   },
   {
@@ -9980,9 +10231,9 @@ var routeCatalog = [
     tags: ["wordpress"],
     parameters: [nameParameter, wordpressSlugQueryParameter],
     responses: {
-      200: { description: "WordPress diff returned." },
-      400: { description: "Invalid slug or missing staging configuration." },
-      404: { description: "Project, connection, or page not found." }
+      200: jsonResponse("WordPress diff returned.", "WordpressDiffDto"),
+      400: errorResponse("Invalid slug or missing staging configuration."),
+      404: errorResponse("Project, connection, or page not found.")
     }
   },
   {
@@ -9992,9 +10243,10 @@ var routeCatalog = [
     tags: ["wordpress"],
     parameters: [nameParameter],
     responses: {
-      200: { description: "WordPress staging status returned." },
-      400: { description: "WordPress is not configured for this project." },
-      404: { description: "Project not found." }
+      // TODO: Add `WordpressSiteStatusDto` to the schema table (already in contracts).
+      200: rawJsonResponse("WordPress staging status returned.", looseObjectSchema),
+      400: errorResponse("WordPress is not configured for this project."),
+      404: errorResponse("Project not found.")
     }
   },
   {
@@ -10004,9 +10256,9 @@ var routeCatalog = [
     tags: ["wordpress"],
     parameters: [nameParameter],
     responses: {
-      200: { description: "Manual staging push instructions returned." },
-      400: { description: "Missing staging configuration." },
-      404: { description: "Project or connection not found." }
+      200: jsonResponse("Manual staging push instructions returned.", "WordpressManualAssistDto"),
+      400: errorResponse("Missing staging configuration."),
+      404: errorResponse("Project or connection not found.")
     }
   },
   {
@@ -10037,9 +10289,9 @@ var routeCatalog = [
       }
     },
     responses: {
-      200: { description: "Onboarding result with step-by-step status." },
-      400: { description: "Invalid onboarding request." },
-      404: { description: "Project not found." }
+      200: jsonResponse("Onboarding result with step-by-step status.", "WordpressOnboardResultDto"),
+      400: errorResponse("Invalid onboarding request."),
+      404: errorResponse("Project not found.")
     }
   },
   // GA4 routes
@@ -10065,9 +10317,10 @@ var routeCatalog = [
       }
     },
     responses: {
-      200: { description: "GA4 connection established." },
-      400: { description: "Invalid GA4 connection request." },
-      404: { description: "Project not found." }
+      // TODO: Add `GaConnectResponse` Zod schema in contracts.
+      200: rawJsonResponse("GA4 connection established.", looseObjectSchema),
+      400: errorResponse("Invalid GA4 connection request."),
+      404: errorResponse("Project not found.")
     }
   },
   {
@@ -10078,7 +10331,7 @@ var routeCatalog = [
     parameters: [nameParameter],
     responses: {
       204: { description: "GA4 connection deleted." },
-      404: { description: "Project or connection not found." }
+      404: errorResponse("Project or connection not found.")
     }
   },
   {
@@ -10088,8 +10341,8 @@ var routeCatalog = [
     tags: ["ga4"],
     parameters: [nameParameter],
     responses: {
-      200: { description: "GA4 status returned." },
-      404: { description: "Project not found." }
+      200: jsonResponse("GA4 status returned.", "GA4StatusDto"),
+      404: errorResponse("Project not found.")
     }
   },
   {
@@ -10112,9 +10365,9 @@ var routeCatalog = [
       }
     },
     responses: {
-      200: { description: "GA4 sync completed." },
-      400: { description: "GA4 is not connected." },
-      404: { description: "Project not found." }
+      200: jsonResponse("GA4 sync completed.", "GA4SyncResponseDto"),
+      400: errorResponse("GA4 is not connected."),
+      404: errorResponse("Project not found.")
     }
   },
   {
@@ -10124,9 +10377,10 @@ var routeCatalog = [
     tags: ["ga4"],
     parameters: [nameParameter, limitQueryParameter, analyticsWindowParameter],
     responses: {
-      200: { description: "GA4 traffic data returned." },
-      400: { description: "GA4 is not connected." },
-      404: { description: "Project not found." }
+      // TODO: Add `GaTrafficResponse` Zod schema in contracts.
+      200: rawJsonResponse("GA4 traffic data returned.", looseObjectSchema),
+      400: errorResponse("GA4 is not connected."),
+      404: errorResponse("Project not found.")
     }
   },
   {
@@ -10136,9 +10390,9 @@ var routeCatalog = [
     tags: ["ga4"],
     parameters: [nameParameter, analyticsWindowParameter],
     responses: {
-      200: { description: "AI referral history returned." },
-      400: { description: "GA4 is not connected." },
-      404: { description: "Project not found." }
+      200: jsonArrayResponse("AI referral history returned.", "GA4AiReferralHistoryEntry"),
+      400: errorResponse("GA4 is not connected."),
+      404: errorResponse("Project not found.")
     }
   },
   {
@@ -10148,9 +10402,9 @@ var routeCatalog = [
     tags: ["ga4"],
     parameters: [nameParameter, analyticsWindowParameter],
     responses: {
-      200: { description: "Social referral history returned." },
-      400: { description: "GA4 is not connected." },
-      404: { description: "Project not found." }
+      200: jsonArrayResponse("Social referral history returned.", "GA4SocialReferralHistoryEntry"),
+      400: errorResponse("GA4 is not connected."),
+      404: errorResponse("Project not found.")
     }
   },
   {
@@ -10160,9 +10414,10 @@ var routeCatalog = [
     tags: ["ga4"],
     parameters: [nameParameter],
     responses: {
-      200: { description: "Social referral trend returned." },
-      400: { description: "GA4 is not connected." },
-      404: { description: "Project not found." }
+      // TODO: Add `GaSocialReferralTrendResponse` Zod schema in contracts.
+      200: rawJsonResponse("Social referral trend returned.", looseObjectSchema),
+      400: errorResponse("GA4 is not connected."),
+      404: errorResponse("Project not found.")
     }
   },
   {
@@ -10172,9 +10427,10 @@ var routeCatalog = [
     tags: ["ga4"],
     parameters: [nameParameter],
     responses: {
-      200: { description: "Attribution trend returned." },
-      400: { description: "GA4 is not connected." },
-      404: { description: "Project not found." }
+      // TODO: Add `GaAttributionTrendResponse` Zod schema in contracts.
+      200: rawJsonResponse("Attribution trend returned.", looseObjectSchema),
+      400: errorResponse("GA4 is not connected."),
+      404: errorResponse("Project not found.")
     }
   },
   {
@@ -10184,9 +10440,9 @@ var routeCatalog = [
     tags: ["ga4"],
     parameters: [nameParameter, analyticsWindowParameter],
     responses: {
-      200: { description: "Session history returned." },
-      400: { description: "GA4 is not connected." },
-      404: { description: "Project not found." }
+      200: jsonArrayResponse("Session history returned.", "GA4SessionHistoryEntry"),
+      400: errorResponse("GA4 is not connected."),
+      404: errorResponse("Project not found.")
     }
   },
   {
@@ -10196,9 +10452,10 @@ var routeCatalog = [
     tags: ["ga4"],
     parameters: [nameParameter],
     responses: {
-      200: { description: "GA4 coverage data returned." },
-      400: { description: "GA4 is not connected." },
-      404: { description: "Project not found." }
+      // TODO: Add `GaCoverageResponse` Zod schema in contracts.
+      200: rawJsonResponse("GA4 coverage data returned.", looseObjectSchema),
+      400: errorResponse("GA4 is not connected."),
+      404: errorResponse("Project not found.")
     }
   },
   // Intelligence
@@ -10213,8 +10470,9 @@ var routeCatalog = [
       { name: "runId", in: "query", description: "Filter by run ID.", schema: stringSchema }
     ],
     responses: {
-      200: { description: "Insights returned." },
-      404: { description: "Project not found." }
+      // TODO: Add `InsightDto` Zod schema in contracts.
+      200: rawJsonResponse("Insights returned.", { type: "array", items: looseObjectSchema }),
+      404: errorResponse("Project not found.")
     }
   },
   {
@@ -10227,8 +10485,9 @@ var routeCatalog = [
       { name: "id", in: "path", required: true, description: "Insight ID.", schema: stringSchema }
     ],
     responses: {
-      200: { description: "Insight returned." },
-      404: { description: "Insight not found." }
+      // TODO: Add `InsightDto` Zod schema in contracts.
+      200: rawJsonResponse("Insight returned.", looseObjectSchema),
+      404: errorResponse("Insight not found.")
     }
   },
   {
@@ -10241,8 +10500,9 @@ var routeCatalog = [
       { name: "id", in: "path", required: true, description: "Insight ID.", schema: stringSchema }
     ],
     responses: {
-      200: { description: "Insight dismissed." },
-      404: { description: "Insight not found." }
+      // TODO: Add `InsightDto` Zod schema in contracts.
+      200: rawJsonResponse("Insight dismissed.", looseObjectSchema),
+      404: errorResponse("Insight not found.")
     }
   },
   {
@@ -10253,8 +10513,8 @@ var routeCatalog = [
     description: "Bundles every section the canonry-report HTML output needs (executive summary, client summary, agency diagnostics, action plan, citation scorecard, competitor landscape \u2014 citation + mention landscapes, AI citation sources, GSC, GA4, social/AI referrals, indexing health, citations trend, insights, and recommended next steps) into a single canonical JSON payload. Backs `canonry report <project>` and MCP report reads.",
     parameters: [nameParameter],
     responses: {
-      200: { description: "Report returned." },
-      404: { description: "Project not found." }
+      200: jsonResponse("Report returned.", "ProjectReportDto"),
+      404: errorResponse("Project not found.")
     }
   },
   {
@@ -10265,8 +10525,8 @@ var routeCatalog = [
     description: "Server-rendered self-contained HTML version of the project report. Same data as `/projects/{name}/report` (JSON), rendered through the canonry HTML report renderer in agency or client mode. Returns `text/html` with `Content-Disposition: attachment` so browsers download it as `canonry-report-<project>-<audience>-YYYY-MM-DD.html`. Open in a browser and Print \u2192 Save as PDF for a PDF copy.",
     parameters: [nameParameter, reportAudienceQueryParameter],
     responses: {
-      200: { description: "HTML report returned." },
-      404: { description: "Project not found." }
+      200: { description: "HTML report returned.", content: { "text/html": { schema: { type: "string" } } } },
+      404: errorResponse("Project not found.")
     }
   },
   {
@@ -10277,8 +10537,9 @@ var routeCatalog = [
     tags: ["intelligence"],
     parameters: [nameParameter],
     responses: {
-      200: { description: "Health snapshot or no-data sentinel returned." },
-      404: { description: "Project not found." }
+      // TODO: Add `HealthSnapshotDto` Zod schema in contracts.
+      200: rawJsonResponse("Health snapshot or no-data sentinel returned.", looseObjectSchema),
+      404: errorResponse("Project not found.")
     }
   },
   {
@@ -10291,8 +10552,9 @@ var routeCatalog = [
       { name: "limit", in: "query", description: "Max results.", schema: stringSchema }
     ],
     responses: {
-      200: { description: "Health history returned." },
-      404: { description: "Project not found." }
+      // TODO: Add `HealthSnapshotDto` Zod schema in contracts.
+      200: rawJsonResponse("Health history returned.", { type: "array", items: looseObjectSchema }),
+      404: errorResponse("Project not found.")
     }
   },
   {
@@ -10303,8 +10565,8 @@ var routeCatalog = [
     tags: ["intelligence"],
     parameters: [nameParameter],
     responses: {
-      200: { description: "Citation visibility report or no-data sentinel returned." },
-      404: { description: "Project not found." }
+      200: jsonResponse("Citation visibility report or no-data sentinel returned.", "CitationVisibilityResponse"),
+      404: errorResponse("Project not found.")
     }
   },
   // Content opportunity engine
@@ -10320,9 +10582,9 @@ var routeCatalog = [
       { name: "include-in-progress", in: "query", description: "Include rows with in-flight tracked actions.", schema: stringSchema }
     ],
     responses: {
-      200: { description: "Targets returned." },
-      400: { description: "Invalid limit." },
-      404: { description: "Project not found." }
+      200: jsonResponse("Targets returned.", "ContentTargetsResponseDto"),
+      400: errorResponse("Invalid limit."),
+      404: errorResponse("Project not found.")
     }
   },
   {
@@ -10333,8 +10595,8 @@ var routeCatalog = [
     tags: ["content"],
     parameters: [nameParameter],
     responses: {
-      200: { description: "Sources returned." },
-      404: { description: "Project not found." }
+      200: jsonResponse("Sources returned.", "ContentSourcesResponseDto"),
+      404: errorResponse("Project not found.")
     }
   },
   {
@@ -10345,8 +10607,8 @@ var routeCatalog = [
     tags: ["content"],
     parameters: [nameParameter],
     responses: {
-      200: { description: "Gaps returned." },
-      404: { description: "Project not found." }
+      200: jsonResponse("Gaps returned.", "ContentGapsResponseDto"),
+      404: errorResponse("Project not found.")
     }
   },
   {
@@ -10357,8 +10619,9 @@ var routeCatalog = [
     tags: ["intelligence"],
     parameters: [nameParameter],
     responses: {
-      200: { description: "Overview returned." },
-      404: { description: "Project not found." }
+      // TODO: Add `ProjectOverviewDto` Zod schema in contracts.
+      200: rawJsonResponse("Overview returned.", looseObjectSchema),
+      404: errorResponse("Project not found.")
     }
   },
   {
@@ -10373,9 +10636,10 @@ var routeCatalog = [
       { name: "limit", in: "query", description: "Max combined hits (1-50, default 25).", schema: stringSchema }
     ],
     responses: {
-      200: { description: "Search hits returned." },
-      400: { description: "Query string missing or too short." },
-      404: { description: "Project not found." }
+      // TODO: Add `ProjectSearchResponseDto` Zod schema in contracts (projectSearchResponseSchema exists).
+      200: rawJsonResponse("Search hits returned.", looseObjectSchema),
+      400: errorResponse("Query string missing or too short."),
+      404: errorResponse("Project not found.")
     }
   },
   {
@@ -10393,7 +10657,7 @@ var routeCatalog = [
       }
     ],
     responses: {
-      200: { description: "Doctor report returned." }
+      200: jsonResponse("Doctor report returned.", "DoctorReportDto")
     }
   },
   {
@@ -10412,8 +10676,8 @@ var routeCatalog = [
       }
     ],
     responses: {
-      200: { description: "Doctor report returned." },
-      404: { description: "Project not found." }
+      200: jsonResponse("Doctor report returned.", "DoctorReportDto"),
+      404: errorResponse("Project not found.")
     }
   },
   {
@@ -10423,8 +10687,8 @@ var routeCatalog = [
     description: "Reports whether @duckdb/node-api is installed in the local plugin dir. Returns MISSING_DEPENDENCY (422) on deployments that cannot host the plugin (e.g. the cloud API).",
     tags: ["backlinks"],
     responses: {
-      200: { description: "Install status returned." },
-      422: { description: "Backlinks feature is not available on this deployment." }
+      200: jsonResponse("Install status returned.", "BacklinksInstallStatusDto"),
+      422: errorResponse("Backlinks feature is not available on this deployment.")
     }
   },
   {
@@ -10434,8 +10698,8 @@ var routeCatalog = [
     description: "Idempotently installs DuckDB into the canonry plugin dir. Returns MISSING_DEPENDENCY (422) when the host cannot perform the install.",
     tags: ["backlinks"],
     responses: {
-      200: { description: "Installed (or already present)." },
-      422: { description: "Backlinks feature is not available on this deployment." }
+      200: jsonResponse("Installed (or already present).", "BacklinksInstallResultDto"),
+      422: errorResponse("Backlinks feature is not available on this deployment.")
     }
   },
   {
@@ -10458,10 +10722,10 @@ var routeCatalog = [
       }
     },
     responses: {
-      200: { description: "Existing in-flight sync returned." },
-      201: { description: "Sync queued." },
-      400: { description: "Invalid release id." },
-      422: { description: "Backlinks feature is not available on this deployment." }
+      200: jsonResponse("Existing in-flight sync returned.", "CcReleaseSyncDto"),
+      201: jsonResponse("Sync queued.", "CcReleaseSyncDto"),
+      400: errorResponse("Invalid release id."),
+      422: errorResponse("Backlinks feature is not available on this deployment.")
     }
   },
   {
@@ -10471,7 +10735,7 @@ var routeCatalog = [
     description: "Returns syncs ordered by updatedAt DESC \u2014 re-queued rows surface ahead of untouched newer rows.",
     tags: ["backlinks"],
     responses: {
-      200: { description: "Sync history returned." }
+      200: jsonArrayResponse("Sync history returned.", "CcReleaseSyncDto")
     }
   },
   {
@@ -10480,7 +10744,10 @@ var routeCatalog = [
     summary: "Get the most recently-updated Common Crawl release sync",
     tags: ["backlinks"],
     responses: {
-      200: { description: "Latest sync returned, or null when no sync exists." }
+      // Returns CcReleaseSyncDto | null
+      200: rawJsonResponse("Latest sync returned, or null when no sync exists.", {
+        oneOf: [{ $ref: "#/components/schemas/CcReleaseSyncDto" }, { type: "null" }]
+      })
     }
   },
   {
@@ -10489,7 +10756,7 @@ var routeCatalog = [
     summary: "List cached Common Crawl releases on the local filesystem",
     tags: ["backlinks"],
     responses: {
-      200: { description: "Cached release metadata returned." }
+      200: jsonArrayResponse("Cached release metadata returned.", "CcCachedRelease")
     }
   },
   {
@@ -10499,8 +10766,10 @@ var routeCatalog = [
     description: "Probes Common Crawl by HEAD-checking quarterly release slugs and returns the newest one published. The local server caches the result for ~5 minutes so repeated calls do not hammer Common Crawl.",
     tags: ["backlinks"],
     responses: {
-      200: { description: "Latest available release, or null when no candidate slug responded." },
-      422: { description: "Backlinks feature is not available on this deployment." }
+      200: rawJsonResponse("Latest available release, or null when no candidate slug responded.", {
+        oneOf: [{ $ref: "#/components/schemas/CcAvailableRelease" }, { type: "null" }]
+      }),
+      422: errorResponse("Backlinks feature is not available on this deployment.")
     }
   },
   {
@@ -10518,9 +10787,10 @@ var routeCatalog = [
       }
     ],
     responses: {
-      200: { description: "Cache pruned." },
-      400: { description: "Invalid release id." },
-      422: { description: "Backlinks feature is not available on this deployment." }
+      // TODO: Add `BacklinksCachePruneResultDto` Zod schema in contracts.
+      200: rawJsonResponse("Cache pruned.", looseObjectSchema),
+      400: errorResponse("Invalid release id."),
+      422: errorResponse("Backlinks feature is not available on this deployment.")
     }
   },
   {
@@ -10544,10 +10814,10 @@ var routeCatalog = [
       }
     },
     responses: {
-      201: { description: "Extract run queued." },
-      400: { description: "Invalid release id." },
-      404: { description: "Project not found." },
-      422: { description: "Backlinks feature is not available on this deployment." }
+      201: jsonResponse("Extract run queued.", "RunDto"),
+      400: errorResponse("Invalid release id."),
+      404: errorResponse("Project not found."),
+      422: errorResponse("Backlinks feature is not available on this deployment.")
     }
   },
   {
@@ -10560,8 +10830,10 @@ var routeCatalog = [
       { name: "release", in: "query", description: "Release id filter.", schema: stringSchema }
     ],
     responses: {
-      200: { description: "Summary returned, or null when no backlinks exist." },
-      404: { description: "Project not found." }
+      200: rawJsonResponse("Summary returned, or null when no backlinks exist.", {
+        oneOf: [{ $ref: "#/components/schemas/BacklinkSummaryDto" }, { type: "null" }]
+      }),
+      404: errorResponse("Project not found.")
     }
   },
   {
@@ -10576,8 +10848,8 @@ var routeCatalog = [
       { name: "offset", in: "query", description: "Pagination offset.", schema: stringSchema }
     ],
     responses: {
-      200: { description: "Domain list returned." },
-      404: { description: "Project not found." }
+      200: jsonResponse("Domain list returned.", "BacklinkListResponse"),
+      404: errorResponse("Project not found.")
     }
   },
   {
@@ -10587,8 +10859,8 @@ var routeCatalog = [
     tags: ["backlinks"],
     parameters: [nameParameter],
     responses: {
-      200: { description: "History returned oldest-first by queriedAt." },
-      404: { description: "Project not found." }
+      200: jsonArrayResponse("History returned oldest-first by queriedAt.", "BacklinkHistoryEntry"),
+      404: errorResponse("Project not found.")
     }
   },
   {
@@ -10617,9 +10889,9 @@ var routeCatalog = [
       }
     },
     responses: {
-      200: { description: "Traffic source DTO returned." },
-      400: { description: "Invalid Cloud Run connection request." },
-      404: { description: "Project not found." }
+      200: jsonResponse("Traffic source DTO returned.", "TrafficSourceDto"),
+      400: errorResponse("Invalid Cloud Run connection request."),
+      404: errorResponse("Project not found.")
     }
   },
   {
@@ -10647,10 +10919,10 @@ var routeCatalog = [
       }
     },
     responses: {
-      200: { description: "Traffic source DTO returned." },
-      400: { description: "Invalid WordPress connection request." },
-      404: { description: "Project not found." },
-      502: { description: "WordPress plugin endpoint probe failed (bad credentials, unreachable host, etc.)." }
+      200: jsonResponse("Traffic source DTO returned.", "TrafficSourceDto"),
+      400: errorResponse("Invalid WordPress connection request."),
+      404: errorResponse("Project not found."),
+      502: errorResponse("WordPress plugin endpoint probe failed (bad credentials, unreachable host, etc.).")
     }
   },
   {
@@ -10679,10 +10951,10 @@ var routeCatalog = [
       }
     },
     responses: {
-      200: { description: "Traffic source DTO returned." },
-      400: { description: "Invalid Vercel connection request." },
-      404: { description: "Project not found." },
-      502: { description: "Vercel request-logs endpoint probe failed (bad token, wrong project / team id, unreachable host, etc.)." }
+      200: jsonResponse("Traffic source DTO returned.", "TrafficSourceDto"),
+      400: errorResponse("Invalid Vercel connection request."),
+      404: errorResponse("Project not found."),
+      502: errorResponse("Vercel request-logs endpoint probe failed (bad token, wrong project / team id, unreachable host, etc.).")
     }
   },
   {
@@ -10709,10 +10981,10 @@ var routeCatalog = [
       }
     },
     responses: {
-      200: { description: "Sync summary returned." },
-      400: { description: "Invalid sync request or missing credentials." },
-      404: { description: "Project or traffic source not found." },
-      502: { description: "Upstream Cloud Run pull or auth-token resolution failed." }
+      200: jsonResponse("Sync summary returned.", "TrafficSyncResponse"),
+      400: errorResponse("Invalid sync request or missing credentials."),
+      404: errorResponse("Project or traffic source not found."),
+      502: errorResponse("Upstream Cloud Run pull or auth-token resolution failed.")
     }
   },
   {
@@ -10739,9 +11011,9 @@ var routeCatalog = [
       }
     },
     responses: {
-      200: { description: "Backfill submitted; poll the returned runId for completion." },
-      400: { description: "Invalid backfill request or missing credentials." },
-      404: { description: "Project or traffic source not found." }
+      200: jsonResponse("Backfill submitted; poll the returned runId for completion.", "TrafficBackfillResponse"),
+      400: errorResponse("Invalid backfill request or missing credentials."),
+      404: errorResponse("Project or traffic source not found.")
     }
   },
   {
@@ -10751,8 +11023,8 @@ var routeCatalog = [
     tags: ["traffic"],
     parameters: [nameParameter],
     responses: {
-      200: { description: "Source list returned." },
-      404: { description: "Project not found." }
+      200: jsonResponse("Source list returned.", "TrafficSourceListResponse"),
+      404: errorResponse("Project not found.")
     }
   },
   {
@@ -10763,8 +11035,8 @@ var routeCatalog = [
     tags: ["traffic"],
     parameters: [nameParameter],
     responses: {
-      200: { description: "Status returned." },
-      404: { description: "Project not found." }
+      200: jsonResponse("Status returned.", "TrafficStatusResponse"),
+      404: errorResponse("Project not found.")
     }
   },
   {
@@ -10777,8 +11049,8 @@ var routeCatalog = [
       { name: "id", in: "path", required: true, description: "Traffic source ID.", schema: stringSchema }
     ],
     responses: {
-      200: { description: "Source detail returned." },
-      404: { description: "Project or source not found." }
+      200: jsonResponse("Source detail returned.", "TrafficSourceDetailDto"),
+      404: errorResponse("Project or source not found.")
     }
   },
   {
@@ -10796,9 +11068,9 @@ var routeCatalog = [
       { name: "sourceId", in: "query", description: "Restrict to a single traffic source.", schema: stringSchema }
     ],
     responses: {
-      200: { description: "Events returned with windowed totals." },
-      400: { description: "Invalid query parameters." },
-      404: { description: "Project not found." }
+      200: jsonResponse("Events returned with windowed totals.", "TrafficEventsResponse"),
+      400: errorResponse("Invalid query parameters."),
+      404: errorResponse("Project not found.")
     }
   },
   {
@@ -10829,10 +11101,11 @@ var routeCatalog = [
       }
     },
     responses: {
-      200: { description: "An in-flight session with the same project + ICP was reused; returns { runId, sessionId, status, consolidated: true }. The request's dedupThreshold / maxProbes are ignored." },
-      201: { description: "New discovery session enqueued; returns { runId, sessionId, status, consolidated: false }." },
-      400: { description: "Missing or invalid ICP / parameters." },
-      404: { description: "Project not found." }
+      // TODO: Add `DiscoveryRunResponse` Zod schema in contracts (`{ runId, sessionId, status, consolidated }`).
+      200: rawJsonResponse("An in-flight session with the same project + ICP was reused; returns { runId, sessionId, status, consolidated: true }. The request's dedupThreshold / maxProbes are ignored.", looseObjectSchema),
+      201: rawJsonResponse("New discovery session enqueued; returns { runId, sessionId, status, consolidated: false }.", looseObjectSchema),
+      400: errorResponse("Missing or invalid ICP / parameters."),
+      404: errorResponse("Project not found.")
     }
   },
   {
@@ -10846,8 +11119,8 @@ var routeCatalog = [
       { name: "limit", in: "query", description: "Max sessions returned. Default 50.", schema: stringSchema }
     ],
     responses: {
-      200: { description: "Sessions returned." },
-      404: { description: "Project not found." }
+      200: jsonArrayResponse("Sessions returned.", "DiscoverySessionDto"),
+      404: errorResponse("Project not found.")
     }
   },
   {
@@ -10861,8 +11134,8 @@ var routeCatalog = [
       { name: "id", in: "path", required: true, description: "Discovery session ID.", schema: stringSchema }
     ],
     responses: {
-      200: { description: "Session detail returned." },
-      404: { description: "Project or session not found." }
+      200: jsonResponse("Session detail returned.", "DiscoverySessionDetailDto"),
+      404: errorResponse("Project or session not found.")
     }
   },
   {
@@ -10876,8 +11149,8 @@ var routeCatalog = [
       { name: "id", in: "path", required: true, description: "Discovery session ID.", schema: stringSchema }
     ],
     responses: {
-      200: { description: "Promote preview returned." },
-      404: { description: "Project or session not found." }
+      200: jsonResponse("Promote preview returned.", "DiscoveryPromotePreview"),
+      404: errorResponse("Project or session not found.")
     }
   },
   {
@@ -10920,9 +11193,9 @@ var routeCatalog = [
       }
     },
     responses: {
-      200: { description: "Promotion applied; returns promoted + skipped query/competitor lists." },
-      400: { description: "Session is not completed, or invalid request body." },
-      404: { description: "Project or session not found." }
+      200: jsonResponse("Promotion applied; returns promoted + skipped query/competitor lists.", "DiscoveryPromoteResult"),
+      400: errorResponse("Session is not completed, or invalid request body."),
+      404: errorResponse("Project or session not found.")
     }
   }
 ];
@@ -10935,8 +11208,9 @@ var canonryLocalRouteCatalog = [
     tags: ["agent"],
     parameters: [nameParameter],
     responses: {
-      200: { description: "Transcript returned." },
-      404: { description: "Project not found." }
+      // TODO: Add `AgentTranscriptDto` Zod schema in contracts.
+      200: rawJsonResponse("Transcript returned.", looseObjectSchema),
+      404: errorResponse("Project not found.")
     }
   },
   {
@@ -10947,8 +11221,9 @@ var canonryLocalRouteCatalog = [
     tags: ["agent"],
     parameters: [nameParameter],
     responses: {
-      200: { description: "Session reset." },
-      404: { description: "Project not found." }
+      // Returns { status: 'reset' } sentinel.
+      200: rawJsonResponse("Session reset.", { type: "object", properties: { status: { type: "string", enum: ["reset"] } } }),
+      404: errorResponse("Project not found.")
     }
   },
   {
@@ -10959,8 +11234,9 @@ var canonryLocalRouteCatalog = [
     tags: ["agent"],
     parameters: [nameParameter],
     responses: {
-      200: { description: "Memory entries returned." },
-      404: { description: "Project not found." }
+      // TODO: Add `AgentMemoryListResponse` Zod schema in contracts.
+      200: rawJsonResponse("Memory entries returned.", looseObjectSchema),
+      404: errorResponse("Project not found.")
     }
   },
   {
@@ -10986,9 +11262,10 @@ var canonryLocalRouteCatalog = [
       }
     },
     responses: {
-      200: { description: "Entry upserted." },
-      400: { description: "Validation failed (key length, value size, reserved prefix)." },
-      404: { description: "Project not found." }
+      // TODO: Add `AgentMemoryEntryDto` Zod schema in contracts.
+      200: rawJsonResponse("Entry upserted.", looseObjectSchema),
+      400: errorResponse("Validation failed (key length, value size, reserved prefix)."),
+      404: errorResponse("Project not found.")
     }
   },
   {
@@ -11013,9 +11290,10 @@ var canonryLocalRouteCatalog = [
       }
     },
     responses: {
-      200: { description: "Entry removed or already absent." },
-      400: { description: "Validation failed (reserved prefix)." },
-      404: { description: "Project not found." }
+      // Returns { status: 'removed' | 'missing' } sentinel.
+      200: rawJsonResponse("Entry removed or already absent.", { type: "object", properties: { status: { type: "string", enum: ["removed", "missing"] } } }),
+      400: errorResponse("Validation failed (reserved prefix)."),
+      404: errorResponse("Project not found.")
     }
   },
   {
@@ -11026,8 +11304,8 @@ var canonryLocalRouteCatalog = [
     tags: ["agent"],
     parameters: [nameParameter],
     responses: {
-      200: { description: "Providers returned." },
-      404: { description: "Project not found." }
+      200: jsonResponse("Providers returned.", "AgentProvidersResponseDto"),
+      404: errorResponse("Project not found.")
     }
   },
   {
@@ -11066,10 +11344,11 @@ var canonryLocalRouteCatalog = [
       }
     },
     responses: {
-      200: { description: "SSE stream of AgentEvent frames." },
-      400: { description: "Missing or empty prompt." },
-      404: { description: "Project not found." },
-      409: { description: "Another Aero turn is already in flight." }
+      // Returns text/event-stream — codegen consumers should treat as a stream.
+      200: { description: "SSE stream of AgentEvent frames.", content: { "text/event-stream": { schema: { type: "string" } } } },
+      400: errorResponse("Missing or empty prompt."),
+      404: errorResponse("Project not found."),
+      409: errorResponse("Another Aero turn is already in flight.")
     }
   }
 ];
@@ -11095,8 +11374,14 @@ function buildOpenApiDocument(info = {}) {
     acc[fullPath] = pathItem;
     return acc;
   }, {});
+  const schemas = buildComponentSchemas();
   return {
-    openapi: "3.1.0",
+    // OpenAPI 3.0 (not 3.1) so `nullable: true` on emitted schemas is the
+    // canonical nullability marker. `z.toJSONSchema(..., { target: 'openapi-3.0' })`
+    // outputs `nullable: true`; declaring 3.1 would tell consumers (and the
+    // hey-api codegen) to expect 3.1-style `type: ["string", "null"]` instead,
+    // and they'd silently strip the `null` from optional fields.
+    openapi: "3.0.0",
     info: {
       title: info.title ?? "Canonry API",
       version: info.version ?? "0.0.0",
@@ -11115,7 +11400,8 @@ function buildOpenApiDocument(info = {}) {
           scheme: "bearer",
           bearerFormat: "API key"
         }
-      }
+      },
+      schemas
     },
     paths
   };
@@ -11290,12 +11576,12 @@ async function telemetryRoutes(app, opts) {
 
 // ../api-routes/src/schedules.ts
 import crypto11 from "crypto";
-import { and as and8, eq as eq16 } from "drizzle-orm";
+import { and as and11, eq as eq16 } from "drizzle-orm";
 function parseKindParam(raw) {
   if (raw === void 0 || raw === null || raw === "") return SchedulableRunKinds["answer-visibility"];
   const parsed = schedulableRunKindSchema.safeParse(raw);
   if (!parsed.success) {
-    throw validationError(`Invalid kind "${String(raw)}". Must be one of: ${Object.values(SchedulableRunKinds).join(", ")}`);
+    throw validationError(`Invalid kind "${JSON.stringify(raw)}". Must be one of: ${Object.values(SchedulableRunKinds).join(", ")}`);
   }
   return parsed.data;
 }
@@ -11356,7 +11642,7 @@ async function scheduleRoutes(app, opts) {
     }
     const now = (/* @__PURE__ */ new Date()).toISOString();
     const enabledInt = enabled === false ? 0 : 1;
-    const existing = app.db.select().from(schedules).where(and8(eq16(schedules.projectId, project.id), eq16(schedules.kind, kind))).get();
+    const existing = app.db.select().from(schedules).where(and11(eq16(schedules.projectId, project.id), eq16(schedules.kind, kind))).get();
     if (existing) {
       app.db.update(schedules).set({
         cronExpr,
@@ -11390,13 +11676,13 @@ async function scheduleRoutes(app, opts) {
       diff: { kind, cronExpr, preset, timezone, providers, sourceId }
     });
     opts.onScheduleUpdated?.("upsert", project.id, kind);
-    const schedule = app.db.select().from(schedules).where(and8(eq16(schedules.projectId, project.id), eq16(schedules.kind, kind))).get();
+    const schedule = app.db.select().from(schedules).where(and11(eq16(schedules.projectId, project.id), eq16(schedules.kind, kind))).get();
     return reply.status(existing ? 200 : 201).send(formatSchedule(schedule));
   });
   app.get("/projects/:name/schedule", async (request, reply) => {
     const project = resolveProject(app.db, request.params.name);
     const kind = parseKindParam(request.query?.kind);
-    const schedule = app.db.select().from(schedules).where(and8(eq16(schedules.projectId, project.id), eq16(schedules.kind, kind))).get();
+    const schedule = app.db.select().from(schedules).where(and11(eq16(schedules.projectId, project.id), eq16(schedules.kind, kind))).get();
     if (!schedule) {
       throw notFound("Schedule", `${request.params.name} (kind=${kind})`);
     }
@@ -11405,7 +11691,7 @@ async function scheduleRoutes(app, opts) {
   app.delete("/projects/:name/schedule", async (request, reply) => {
     const project = resolveProject(app.db, request.params.name);
     const kind = parseKindParam(request.query?.kind);
-    const schedule = app.db.select().from(schedules).where(and8(eq16(schedules.projectId, project.id), eq16(schedules.kind, kind))).get();
+    const schedule = app.db.select().from(schedules).where(and11(eq16(schedules.projectId, project.id), eq16(schedules.kind, kind))).get();
     if (!schedule) {
       throw notFound("Schedule", `${request.params.name} (kind=${kind})`);
     }
@@ -11562,7 +11848,7 @@ function formatNotification(row) {
 
 // ../api-routes/src/google.ts
 import crypto14 from "crypto";
-import { eq as eq18, and as and9, desc as desc8, sql as sql7 } from "drizzle-orm";
+import { eq as eq18, and as and12, desc as desc8, sql as sql7 } from "drizzle-orm";
 
 // ../integration-google/src/constants.ts
 var GOOGLE_AUTH_URL = "https://accounts.google.com/o/oauth2/v2/auth";
@@ -11946,6 +12232,22 @@ var GA4_DEFAULT_SYNC_DAYS = 30;
 var GA4_MAX_SYNC_DAYS = 90;
 var GA4_REQUEST_TIMEOUT_MS = 3e4;
 var GA4_MAX_PAGES = 50;
+var GA4_DIMENSIONS = {
+  date: "date",
+  landingPagePlusQueryString: "landingPagePlusQueryString",
+  sessionSource: "sessionSource",
+  sessionMedium: "sessionMedium",
+  sessionManualSource: "sessionManualSource",
+  sessionManualMedium: "sessionManualMedium",
+  firstUserSource: "firstUserSource",
+  firstUserMedium: "firstUserMedium",
+  sessionDefaultChannelGrouping: "sessionDefaultChannelGrouping",
+  sessionDefaultChannelGroup: "sessionDefaultChannelGroup"
+};
+var GA4_METRICS = {
+  sessions: "sessions",
+  totalUsers: "totalUsers"
+};
 
 // ../integration-google-analytics/src/types.ts
 var GA4ApiError = class extends Error {
@@ -12137,8 +12439,8 @@ var AI_REFERRAL_SOURCE_FILTERS = [
   { matchType: "CONTAINS", value: "anthropic" },
   { matchType: "CONTAINS", value: "copilot" },
   { matchType: "CONTAINS", value: "phind" },
-  { matchType: "EXACT", value: "you.com" },
-  { matchType: "CONTAINS", value: "meta.ai" }
+  { matchType: "EXACT", value: AI_ENGINE_DOMAINS.you },
+  { matchType: "CONTAINS", value: AI_ENGINE_DOMAINS.metaAi }
 ];
 async function fetchTrafficByLandingPage(accessToken, propertyId, days) {
   validateAccessToken2(accessToken);
@@ -12157,12 +12459,12 @@ async function fetchTrafficByLandingPage(accessToken, propertyId, days) {
     const request = {
       dateRanges: [{ startDate: formatDate2(startDate), endDate: formatDate2(endDate) }],
       dimensions: [
-        { name: "date" },
-        { name: "landingPagePlusQueryString" }
+        { name: GA4_DIMENSIONS.date },
+        { name: GA4_DIMENSIONS.landingPagePlusQueryString }
       ],
       metrics: [
-        { name: "sessions" },
-        { name: "totalUsers" }
+        { name: GA4_METRICS.sessions },
+        { name: GA4_METRICS.totalUsers }
       ],
       limit: PAGE_SIZE,
       offset
@@ -12191,11 +12493,11 @@ async function fetchTrafficByLandingPage(accessToken, propertyId, days) {
     organicPageCount++;
     const organicRequest = {
       dateRanges: [{ startDate: formatDate2(startDate), endDate: formatDate2(endDate) }],
-      dimensions: [{ name: "date" }, { name: "landingPagePlusQueryString" }],
-      metrics: [{ name: "sessions" }],
+      dimensions: [{ name: GA4_DIMENSIONS.date }, { name: GA4_DIMENSIONS.landingPagePlusQueryString }],
+      metrics: [{ name: GA4_METRICS.sessions }],
       dimensionFilter: {
         filter: {
-          fieldName: "sessionDefaultChannelGrouping",
+          fieldName: GA4_DIMENSIONS.sessionDefaultChannelGrouping,
           stringFilter: { matchType: "EXACT", value: "Organic Search" }
         }
       },
@@ -12219,11 +12521,11 @@ async function fetchTrafficByLandingPage(accessToken, propertyId, days) {
     directPageCount++;
     const directRequest = {
       dateRanges: [{ startDate: formatDate2(startDate), endDate: formatDate2(endDate) }],
-      dimensions: [{ name: "date" }, { name: "landingPagePlusQueryString" }],
-      metrics: [{ name: "sessions" }],
+      dimensions: [{ name: GA4_DIMENSIONS.date }, { name: GA4_DIMENSIONS.landingPagePlusQueryString }],
+      metrics: [{ name: GA4_METRICS.sessions }],
       dimensionFilter: {
         filter: {
-          fieldName: "sessionDefaultChannelGrouping",
+          fieldName: GA4_DIMENSIONS.sessionDefaultChannelGrouping,
           stringFilter: { matchType: "EXACT", value: "Direct" }
         }
       },
@@ -12268,8 +12570,8 @@ async function verifyConnectionWithToken(accessToken, propertyId) {
   startDate.setDate(startDate.getDate() - 1);
   await runReport(accessToken, propertyId, {
     dateRanges: [{ startDate: formatDate2(startDate), endDate: formatDate2(endDate) }],
-    dimensions: [{ name: "date" }],
-    metrics: [{ name: "sessions" }],
+    dimensions: [{ name: GA4_DIMENSIONS.date }],
+    metrics: [{ name: GA4_METRICS.sessions }],
     limit: 1
   });
   return true;
@@ -12287,16 +12589,16 @@ async function fetchAggregateSummary(accessToken, propertyId, days) {
     {
       dateRanges: [dateRange],
       dimensions: [],
-      metrics: [{ name: "sessions" }, { name: "totalUsers" }],
+      metrics: [{ name: GA4_METRICS.sessions }, { name: GA4_METRICS.totalUsers }],
       limit: 1
     },
     {
       dateRanges: [dateRange],
       dimensions: [],
-      metrics: [{ name: "sessions" }],
+      metrics: [{ name: GA4_METRICS.sessions }],
       dimensionFilter: {
         filter: {
-          fieldName: "sessionDefaultChannelGrouping",
+          fieldName: GA4_DIMENSIONS.sessionDefaultChannelGrouping,
           stringFilter: { matchType: "EXACT", value: "Organic Search" }
         }
       },
@@ -12332,16 +12634,16 @@ async function fetchWindowSummary(accessToken, propertyId, windowKey) {
     {
       dateRanges: [dateRange],
       dimensions: [],
-      metrics: [{ name: "sessions" }, { name: "totalUsers" }],
+      metrics: [{ name: GA4_METRICS.sessions }, { name: GA4_METRICS.totalUsers }],
       limit: 1
     },
     {
       dateRanges: [dateRange],
       dimensions: [],
-      metrics: [{ name: "sessions" }],
+      metrics: [{ name: GA4_METRICS.sessions }],
       dimensionFilter: {
         filter: {
-          fieldName: "sessionDefaultChannelGrouping",
+          fieldName: GA4_DIMENSIONS.sessionDefaultChannelGrouping,
           stringFilter: { matchType: "EXACT", value: "Organic Search" }
         }
       },
@@ -12350,10 +12652,10 @@ async function fetchWindowSummary(accessToken, propertyId, windowKey) {
     {
       dateRanges: [dateRange],
       dimensions: [],
-      metrics: [{ name: "sessions" }],
+      metrics: [{ name: GA4_METRICS.sessions }],
       dimensionFilter: {
         filter: {
-          fieldName: "sessionDefaultChannelGrouping",
+          fieldName: GA4_DIMENSIONS.sessionDefaultChannelGrouping,
           stringFilter: { matchType: "EXACT", value: "Direct" }
         }
       },
@@ -12386,9 +12688,9 @@ async function fetchAiReferrals(accessToken, propertyId, days) {
   const PAGE_SIZE = 1e3;
   const rows = [];
   const dimensionPairs = [
-    ["sessionSource", "sessionMedium", "session"],
-    ["firstUserSource", "firstUserMedium", "first_user"],
-    ["sessionManualSource", "sessionManualMedium", "manual_utm"]
+    [GA4_DIMENSIONS.sessionSource, GA4_DIMENSIONS.sessionMedium, "session"],
+    [GA4_DIMENSIONS.firstUserSource, GA4_DIMENSIONS.firstUserMedium, "first_user"],
+    [GA4_DIMENSIONS.sessionManualSource, GA4_DIMENSIONS.sessionManualMedium, "manual_utm"]
   ];
   for (const [sourceDim, mediumDim, dimLabel] of dimensionPairs) {
     let offset = 0;
@@ -12398,15 +12700,15 @@ async function fetchAiReferrals(accessToken, propertyId, days) {
       const request = {
         dateRanges: [{ startDate: formatDate2(startDate), endDate: formatDate2(endDate) }],
         dimensions: [
-          { name: "date" },
+          { name: GA4_DIMENSIONS.date },
           { name: sourceDim },
           { name: mediumDim },
-          { name: "sessionDefaultChannelGroup" },
-          { name: "landingPagePlusQueryString" }
+          { name: GA4_DIMENSIONS.sessionDefaultChannelGrouping },
+          { name: GA4_DIMENSIONS.landingPagePlusQueryString }
         ],
         metrics: [
-          { name: "sessions" },
-          { name: "totalUsers" }
+          { name: GA4_METRICS.sessions },
+          { name: GA4_METRICS.totalUsers }
         ],
         dimensionFilter: {
           orGroup: {
@@ -12479,20 +12781,20 @@ async function fetchSocialReferrals(accessToken, propertyId, days) {
     const request = {
       dateRanges: [{ startDate: formatDate2(startDate), endDate: formatDate2(endDate) }],
       dimensions: [
-        { name: "date" },
-        { name: "sessionSource" },
-        { name: "sessionMedium" },
-        { name: "sessionDefaultChannelGroup" }
+        { name: GA4_DIMENSIONS.date },
+        { name: GA4_DIMENSIONS.sessionSource },
+        { name: GA4_DIMENSIONS.sessionMedium },
+        { name: GA4_DIMENSIONS.sessionDefaultChannelGroup }
       ],
       metrics: [
-        { name: "sessions" },
-        { name: "totalUsers" }
+        { name: GA4_METRICS.sessions },
+        { name: GA4_METRICS.totalUsers }
       ],
       dimensionFilter: {
         orGroup: {
           expressions: SOCIAL_CHANNEL_GROUPS.map((value) => ({
             filter: {
-              fieldName: "sessionDefaultChannelGroup",
+              fieldName: GA4_DIMENSIONS.sessionDefaultChannelGroup,
               stringFilter: { matchType: "EXACT", value }
             }
           }))
@@ -12662,7 +12964,8 @@ async function googleRoutes(app, opts) {
               <li>Under "Authorized redirect URIs", add:<br><code style="background:#1e1e1e;color:#e0e0e0;padding:4px 8px;border-radius:4px;display:inline-block;margin-top:4px">${request.query.state ? (() => {
         try {
           const s = verifySignedState(request.query.state, stateSecret);
-          return escapeHtml2(String(s?.redirectUri ?? "Could not determine URI"));
+          const uri = s?.redirectUri;
+          return escapeHtml2(typeof uri === "string" ? uri : "Could not determine URI");
         } catch {
           return "Could not determine URI";
         }
@@ -12799,7 +13102,7 @@ async function googleRoutes(app, opts) {
     if (page) conditions.push(sql7`${gscSearchData.page} LIKE ${"%" + page + "%"}`);
     const limitVal = Math.max(parseInt(limit ?? "500", 10) || 0, 1);
     const offsetVal = Math.max(parseInt(offset ?? "0", 10) || 0, 0);
-    const rows = app.db.select().from(gscSearchData).where(and9(...conditions)).orderBy(desc8(gscSearchData.date)).limit(limitVal).offset(offsetVal).all();
+    const rows = app.db.select().from(gscSearchData).where(and12(...conditions)).orderBy(desc8(gscSearchData.date)).limit(limitVal).offset(offsetVal).all();
     return rows.map((r) => ({
       date: r.date,
       query: r.query,
@@ -12824,7 +13127,7 @@ async function googleRoutes(app, opts) {
       date: gscSearchData.date,
       clicks: sql7`COALESCE(SUM(${gscSearchData.clicks}), 0)`,
       impressions: sql7`COALESCE(SUM(${gscSearchData.impressions}), 0)`
-    }).from(gscSearchData).where(and9(...conditions)).groupBy(gscSearchData.date).orderBy(gscSearchData.date).all();
+    }).from(gscSearchData).where(and12(...conditions)).groupBy(gscSearchData.date).orderBy(gscSearchData.date).all();
     const daily = rows.map((r) => ({
       date: r.date,
       clicks: r.clicks,
@@ -12904,7 +13207,7 @@ async function googleRoutes(app, opts) {
     const { url, limit } = request.query;
     const conditions = [eq18(gscUrlInspections.projectId, project.id)];
     if (url) conditions.push(eq18(gscUrlInspections.url, url));
-    const rows = app.db.select().from(gscUrlInspections).where(and9(...conditions)).orderBy(desc8(gscUrlInspections.inspectedAt)).limit(parseInt(limit ?? "100", 10)).all();
+    const rows = app.db.select().from(gscUrlInspections).where(and12(...conditions)).orderBy(desc8(gscUrlInspections.inspectedAt)).limit(parseInt(limit ?? "100", 10)).all();
     return rows.map((r) => ({
       id: r.id,
       url: r.url,
@@ -13256,7 +13559,7 @@ async function googleRoutes(app, opts) {
 
 // ../api-routes/src/bing.ts
 import crypto15 from "crypto";
-import { eq as eq19, and as and10, desc as desc9 } from "drizzle-orm";
+import { eq as eq19, and as and13, desc as desc9 } from "drizzle-orm";
 
 // ../integration-bing/src/constants.ts
 var BING_WMT_API_BASE = "https://ssl.bing.com/webmaster/api.svc/json";
@@ -13670,7 +13973,7 @@ async function bingRoutes(app, opts) {
     requireConnectionStore();
     const project = resolveProject(app.db, request.params.name);
     const { url, limit } = request.query;
-    const whereClause = url ? and10(eq19(bingUrlInspections.projectId, project.id), eq19(bingUrlInspections.url, url)) : eq19(bingUrlInspections.projectId, project.id);
+    const whereClause = url ? and13(eq19(bingUrlInspections.projectId, project.id), eq19(bingUrlInspections.url, url)) : eq19(bingUrlInspections.projectId, project.id);
     const filtered = app.db.select().from(bingUrlInspections).where(whereClause).orderBy(desc9(bingUrlInspections.inspectedAt)).limit(Math.max(1, Math.min(parseInt(limit ?? "100", 10) || 100, 1e3))).all();
     return filtered.map((r) => ({
       id: r.id,
@@ -13902,7 +14205,7 @@ async function bingRoutes(app, opts) {
 import fs from "fs";
 import path from "path";
 import os2 from "os";
-import { eq as eq20, and as and11 } from "drizzle-orm";
+import { eq as eq20, and as and14 } from "drizzle-orm";
 function getScreenshotDir() {
   return path.join(os2.homedir(), ".canonry", "screenshots");
 }
@@ -13975,7 +14278,7 @@ async function cdpRoutes(app, opts) {
     async (request, reply) => {
       const project = resolveProject(app.db, request.params.name);
       const { runId } = request.params;
-      const run = app.db.select().from(runs).where(and11(eq20(runs.id, runId), eq20(runs.projectId, project.id))).get();
+      const run = app.db.select().from(runs).where(and14(eq20(runs.id, runId), eq20(runs.projectId, project.id))).get();
       if (!run) {
         const err = notFound("Run", runId);
         return reply.code(err.statusCode).send(err.toJSON());
@@ -14072,7 +14375,7 @@ async function cdpRoutes(app, opts) {
 
 // ../api-routes/src/ga.ts
 import crypto16 from "crypto";
-import { eq as eq21, desc as desc10, and as and12, sql as sql8 } from "drizzle-orm";
+import { eq as eq21, desc as desc10, and as and15, sql as sql8 } from "drizzle-orm";
 function gaLog(level, action, ctx) {
   const entry = { ts: (/* @__PURE__ */ new Date()).toISOString(), level, module: "GA4Routes", action, ...ctx };
   const stream = level === "error" ? process.stderr : process.stdout;
@@ -14367,7 +14670,7 @@ async function ga4Routes(app, opts) {
       app.db.transaction((tx) => {
         if (syncTraffic) {
           tx.delete(gaTrafficSnapshots).where(
-            and12(
+            and15(
               eq21(gaTrafficSnapshots.projectId, project.id),
               sql8`${gaTrafficSnapshots.date} >= ${summary.periodStart}`,
               sql8`${gaTrafficSnapshots.date} <= ${summary.periodEnd}`
@@ -14391,7 +14694,7 @@ async function ga4Routes(app, opts) {
         }
         if (syncAi) {
           tx.delete(gaAiReferrals).where(
-            and12(
+            and15(
               eq21(gaAiReferrals.projectId, project.id),
               sql8`${gaAiReferrals.date} >= ${summary.periodStart}`,
               sql8`${gaAiReferrals.date} <= ${summary.periodEnd}`
@@ -14417,7 +14720,7 @@ async function ga4Routes(app, opts) {
         }
         if (syncSocial) {
           tx.delete(gaSocialReferrals).where(
-            and12(
+            and15(
               eq21(gaSocialReferrals.projectId, project.id),
               sql8`${gaSocialReferrals.date} >= ${summary.periodStart}`,
               sql8`${gaSocialReferrals.date} <= ${summary.periodEnd}`
@@ -14521,7 +14824,7 @@ async function ga4Routes(app, opts) {
       totalDirectSessions: gaTrafficWindowSummaries.totalDirectSessions,
       totalUsers: gaTrafficWindowSummaries.totalUsers
     }).from(gaTrafficWindowSummaries).where(
-      and12(
+      and15(
         eq21(gaTrafficWindowSummaries.projectId, project.id),
         eq21(gaTrafficWindowSummaries.windowKey, window)
       )
@@ -14530,7 +14833,7 @@ async function ga4Routes(app, opts) {
       totalSessions: sql8`COALESCE(SUM(${gaTrafficSnapshots.sessions}), 0)`,
       totalOrganicSessions: sql8`COALESCE(SUM(${gaTrafficSnapshots.organicSessions}), 0)`,
       totalUsers: sql8`COALESCE(SUM(${gaTrafficSnapshots.users}), 0)`
-    }).from(gaTrafficSnapshots).where(and12(...snapshotConditions)).get() : null;
+    }).from(gaTrafficSnapshots).where(and15(...snapshotConditions)).get() : null;
     const summaryRow = cutoffDate ? windowSummaryRow ?? snapshotTotalsRow : app.db.select({
       totalSessions: gaTrafficSummaries.totalSessions,
       totalOrganicSessions: gaTrafficSummaries.totalOrganicSessions,
@@ -14538,7 +14841,7 @@ async function ga4Routes(app, opts) {
     }).from(gaTrafficSummaries).where(eq21(gaTrafficSummaries.projectId, project.id)).get();
     const directTotalRow = windowSummaryRow ? { totalDirectSessions: windowSummaryRow.totalDirectSessions } : app.db.select({
       totalDirectSessions: sql8`COALESCE(SUM(${gaTrafficSnapshots.directSessions}), 0)`
-    }).from(gaTrafficSnapshots).where(and12(...snapshotConditions)).get();
+    }).from(gaTrafficSnapshots).where(and15(...snapshotConditions)).get();
     const summaryMeta = app.db.select({
       periodStart: gaTrafficSummaries.periodStart,
       periodEnd: gaTrafficSummaries.periodEnd
@@ -14549,14 +14852,14 @@ async function ga4Routes(app, opts) {
       organicSessions: sql8`SUM(${gaTrafficSnapshots.organicSessions})`,
       directSessions: sql8`COALESCE(SUM(${gaTrafficSnapshots.directSessions}), 0)`,
       users: sql8`SUM(${gaTrafficSnapshots.users})`
-    }).from(gaTrafficSnapshots).where(and12(...snapshotConditions)).groupBy(sql8`COALESCE(${gaTrafficSnapshots.landingPageNormalized}, ${gaTrafficSnapshots.landingPage})`).orderBy(sql8`SUM(${gaTrafficSnapshots.sessions}) DESC`).limit(limit).all();
+    }).from(gaTrafficSnapshots).where(and15(...snapshotConditions)).groupBy(sql8`COALESCE(${gaTrafficSnapshots.landingPageNormalized}, ${gaTrafficSnapshots.landingPage})`).orderBy(sql8`SUM(${gaTrafficSnapshots.sessions}) DESC`).limit(limit).all();
     const aiReferralRows = app.db.select({
       source: gaAiReferrals.source,
       medium: gaAiReferrals.medium,
       sourceDimension: gaAiReferrals.sourceDimension,
       sessions: sql8`SUM(${gaAiReferrals.sessions})`,
       users: sql8`SUM(${gaAiReferrals.users})`
-    }).from(gaAiReferrals).where(and12(...aiConditions)).groupBy(gaAiReferrals.source, gaAiReferrals.medium, gaAiReferrals.sourceDimension).all();
+    }).from(gaAiReferrals).where(and15(...aiConditions)).groupBy(gaAiReferrals.source, gaAiReferrals.medium, gaAiReferrals.sourceDimension).all();
     const aiReferralLandingPageRows = app.db.select({
       source: gaAiReferrals.source,
       medium: gaAiReferrals.medium,
@@ -14564,7 +14867,7 @@ async function ga4Routes(app, opts) {
       landingPage: sql8`COALESCE(${gaAiReferrals.landingPageNormalized}, ${gaAiReferrals.landingPage})`,
       sessions: sql8`SUM(${gaAiReferrals.sessions})`,
       users: sql8`SUM(${gaAiReferrals.users})`
-    }).from(gaAiReferrals).where(and12(...aiConditions)).groupBy(
+    }).from(gaAiReferrals).where(and15(...aiConditions)).groupBy(
       gaAiReferrals.source,
       gaAiReferrals.medium,
       gaAiReferrals.sourceDimension,
@@ -14601,7 +14904,7 @@ async function ga4Routes(app, opts) {
       channelGroup: gaAiReferrals.channelGroup,
       sessions: sql8`COALESCE(SUM(${gaAiReferrals.sessions}), 0)`,
       users: sql8`COALESCE(SUM(${gaAiReferrals.users}), 0)`
-    }).from(gaAiReferrals).where(and12(...aiConditions, eq21(gaAiReferrals.sourceDimension, "session"))).groupBy(gaAiReferrals.channelGroup).all();
+    }).from(gaAiReferrals).where(and15(...aiConditions, eq21(gaAiReferrals.sourceDimension, "session"))).groupBy(gaAiReferrals.channelGroup).all();
     const aiSessionsByChannelGroup = /* @__PURE__ */ new Map();
     let aiBySessionUsers = 0;
     for (const row of aiBySessionRows) {
@@ -14615,11 +14918,11 @@ async function ga4Routes(app, opts) {
       channelGroup: gaSocialReferrals.channelGroup,
       sessions: sql8`SUM(${gaSocialReferrals.sessions})`,
       users: sql8`SUM(${gaSocialReferrals.users})`
-    }).from(gaSocialReferrals).where(and12(...socialConditions)).groupBy(gaSocialReferrals.source, gaSocialReferrals.medium, gaSocialReferrals.channelGroup).orderBy(sql8`SUM(${gaSocialReferrals.sessions}) DESC`).all();
+    }).from(gaSocialReferrals).where(and15(...socialConditions)).groupBy(gaSocialReferrals.source, gaSocialReferrals.medium, gaSocialReferrals.channelGroup).orderBy(sql8`SUM(${gaSocialReferrals.sessions}) DESC`).all();
     const socialTotals = app.db.select({
       sessions: sql8`SUM(${gaSocialReferrals.sessions})`,
       users: sql8`SUM(${gaSocialReferrals.users})`
-    }).from(gaSocialReferrals).where(and12(...socialConditions)).get();
+    }).from(gaSocialReferrals).where(and15(...socialConditions)).get();
     const latestSync = app.db.select({ syncedAt: gaTrafficSummaries.syncedAt }).from(gaTrafficSummaries).where(eq21(gaTrafficSummaries.projectId, project.id)).orderBy(desc10(gaTrafficSummaries.syncedAt)).limit(1).get();
     const total = summaryRow?.totalSessions ?? 0;
     const totalDirectSessions = directTotalRow?.totalDirectSessions ?? 0;
@@ -14710,7 +15013,7 @@ async function ga4Routes(app, opts) {
       sourceDimension: gaAiReferrals.sourceDimension,
       sessions: sql8`SUM(${gaAiReferrals.sessions})`,
       users: sql8`SUM(${gaAiReferrals.users})`
-    }).from(gaAiReferrals).where(and12(...conditions)).groupBy(
+    }).from(gaAiReferrals).where(and15(...conditions)).groupBy(
       gaAiReferrals.date,
       gaAiReferrals.source,
       gaAiReferrals.medium,
@@ -14732,7 +15035,7 @@ async function ga4Routes(app, opts) {
       channelGroup: gaSocialReferrals.channelGroup,
       sessions: gaSocialReferrals.sessions,
       users: gaSocialReferrals.users
-    }).from(gaSocialReferrals).where(and12(...conditions)).orderBy(gaSocialReferrals.date).all();
+    }).from(gaSocialReferrals).where(and15(...conditions)).orderBy(gaSocialReferrals.date).all();
     return rows;
   });
   app.get("/projects/:name/ga/social-referral-trend", async (request, _reply) => {
@@ -14745,7 +15048,7 @@ async function ga4Routes(app, opts) {
       d.setDate(d.getDate() - n);
       return fmt(d);
     };
-    const sumSocial = (from, to) => app.db.select({ sessions: sql8`COALESCE(SUM(${gaSocialReferrals.sessions}), 0)` }).from(gaSocialReferrals).where(and12(
+    const sumSocial = (from, to) => app.db.select({ sessions: sql8`COALESCE(SUM(${gaSocialReferrals.sessions}), 0)` }).from(gaSocialReferrals).where(and15(
       eq21(gaSocialReferrals.projectId, project.id),
       sql8`${gaSocialReferrals.date} >= ${from}`,
       sql8`${gaSocialReferrals.date} < ${to}`
@@ -14758,7 +15061,7 @@ async function ga4Routes(app, opts) {
     const sourceCurrent = app.db.select({
       source: gaSocialReferrals.source,
       sessions: sql8`SUM(${gaSocialReferrals.sessions})`
-    }).from(gaSocialReferrals).where(and12(
+    }).from(gaSocialReferrals).where(and15(
       eq21(gaSocialReferrals.projectId, project.id),
       sql8`${gaSocialReferrals.date} >= ${daysAgo2(7)}`,
       sql8`${gaSocialReferrals.date} < ${fmt(today)}`
@@ -14766,7 +15069,7 @@ async function ga4Routes(app, opts) {
     const sourcePrev = app.db.select({
       source: gaSocialReferrals.source,
       sessions: sql8`SUM(${gaSocialReferrals.sessions})`
-    }).from(gaSocialReferrals).where(and12(
+    }).from(gaSocialReferrals).where(and15(
       eq21(gaSocialReferrals.projectId, project.id),
       sql8`${gaSocialReferrals.date} >= ${daysAgo2(14)}`,
       sql8`${gaSocialReferrals.date} < ${daysAgo2(7)}`
@@ -14808,16 +15111,16 @@ async function ga4Routes(app, opts) {
       return fmt(d);
     };
     const pct = (cur, prev) => prev === 0 ? null : Math.round((cur - prev) / prev * 100);
-    const sumTotal = (from, to) => app.db.select({ sessions: sql8`COALESCE(SUM(${gaTrafficSnapshots.sessions}), 0)` }).from(gaTrafficSnapshots).where(and12(eq21(gaTrafficSnapshots.projectId, project.id), sql8`${gaTrafficSnapshots.date} >= ${from}`, sql8`${gaTrafficSnapshots.date} < ${to}`)).get();
-    const sumOrganic = (from, to) => app.db.select({ sessions: sql8`COALESCE(SUM(${gaTrafficSnapshots.organicSessions}), 0)` }).from(gaTrafficSnapshots).where(and12(eq21(gaTrafficSnapshots.projectId, project.id), sql8`${gaTrafficSnapshots.date} >= ${from}`, sql8`${gaTrafficSnapshots.date} < ${to}`)).get();
-    const sumDirect = (from, to) => app.db.select({ sessions: sql8`COALESCE(SUM(${gaTrafficSnapshots.directSessions}), 0)` }).from(gaTrafficSnapshots).where(and12(eq21(gaTrafficSnapshots.projectId, project.id), sql8`${gaTrafficSnapshots.date} >= ${from}`, sql8`${gaTrafficSnapshots.date} < ${to}`)).get();
-    const sumAi = (from, to) => app.db.select({ sessions: sql8`COALESCE(SUM(${gaAiReferrals.sessions}), 0)` }).from(gaAiReferrals).where(and12(
+    const sumTotal = (from, to) => app.db.select({ sessions: sql8`COALESCE(SUM(${gaTrafficSnapshots.sessions}), 0)` }).from(gaTrafficSnapshots).where(and15(eq21(gaTrafficSnapshots.projectId, project.id), sql8`${gaTrafficSnapshots.date} >= ${from}`, sql8`${gaTrafficSnapshots.date} < ${to}`)).get();
+    const sumOrganic = (from, to) => app.db.select({ sessions: sql8`COALESCE(SUM(${gaTrafficSnapshots.organicSessions}), 0)` }).from(gaTrafficSnapshots).where(and15(eq21(gaTrafficSnapshots.projectId, project.id), sql8`${gaTrafficSnapshots.date} >= ${from}`, sql8`${gaTrafficSnapshots.date} < ${to}`)).get();
+    const sumDirect = (from, to) => app.db.select({ sessions: sql8`COALESCE(SUM(${gaTrafficSnapshots.directSessions}), 0)` }).from(gaTrafficSnapshots).where(and15(eq21(gaTrafficSnapshots.projectId, project.id), sql8`${gaTrafficSnapshots.date} >= ${from}`, sql8`${gaTrafficSnapshots.date} < ${to}`)).get();
+    const sumAi = (from, to) => app.db.select({ sessions: sql8`COALESCE(SUM(${gaAiReferrals.sessions}), 0)` }).from(gaAiReferrals).where(and15(
       eq21(gaAiReferrals.projectId, project.id),
       sql8`${gaAiReferrals.date} >= ${from}`,
       sql8`${gaAiReferrals.date} < ${to}`,
       eq21(gaAiReferrals.sourceDimension, "session")
     )).get();
-    const sumSocial = (from, to) => app.db.select({ sessions: sql8`COALESCE(SUM(${gaSocialReferrals.sessions}), 0)` }).from(gaSocialReferrals).where(and12(eq21(gaSocialReferrals.projectId, project.id), sql8`${gaSocialReferrals.date} >= ${from}`, sql8`${gaSocialReferrals.date} < ${to}`)).get();
+    const sumSocial = (from, to) => app.db.select({ sessions: sql8`COALESCE(SUM(${gaSocialReferrals.sessions}), 0)` }).from(gaSocialReferrals).where(and15(eq21(gaSocialReferrals.projectId, project.id), sql8`${gaSocialReferrals.date} >= ${from}`, sql8`${gaSocialReferrals.date} < ${to}`)).get();
     const todayStr = fmt(today);
     const buildTrend = (sum) => {
       const c7 = sum(daysAgo2(7), todayStr)?.sessions ?? 0;
@@ -14826,13 +15129,13 @@ async function ga4Routes(app, opts) {
       const p30 = sum(daysAgo2(60), daysAgo2(30))?.sessions ?? 0;
       return { sessions7d: c7, sessionsPrev7d: p7, trend7dPct: pct(c7, p7), sessions30d: c30, sessionsPrev30d: p30, trend30dPct: pct(c30, p30) };
     };
-    const aiSourceCurrent = app.db.select({ source: gaAiReferrals.source, sessions: sql8`COALESCE(SUM(${gaAiReferrals.sessions}), 0)` }).from(gaAiReferrals).where(and12(
+    const aiSourceCurrent = app.db.select({ source: gaAiReferrals.source, sessions: sql8`COALESCE(SUM(${gaAiReferrals.sessions}), 0)` }).from(gaAiReferrals).where(and15(
       eq21(gaAiReferrals.projectId, project.id),
       sql8`${gaAiReferrals.date} >= ${daysAgo2(7)}`,
       sql8`${gaAiReferrals.date} < ${todayStr}`,
       eq21(gaAiReferrals.sourceDimension, "session")
     )).groupBy(gaAiReferrals.source).all();
-    const aiSourcePrev = app.db.select({ source: gaAiReferrals.source, sessions: sql8`COALESCE(SUM(${gaAiReferrals.sessions}), 0)` }).from(gaAiReferrals).where(and12(
+    const aiSourcePrev = app.db.select({ source: gaAiReferrals.source, sessions: sql8`COALESCE(SUM(${gaAiReferrals.sessions}), 0)` }).from(gaAiReferrals).where(and15(
       eq21(gaAiReferrals.projectId, project.id),
       sql8`${gaAiReferrals.date} >= ${daysAgo2(14)}`,
       sql8`${gaAiReferrals.date} < ${daysAgo2(7)}`,
@@ -14852,8 +15155,8 @@ async function ga4Routes(app, opts) {
       }
       return mover;
     };
-    const socialSourceCurrent = app.db.select({ source: gaSocialReferrals.source, sessions: sql8`SUM(${gaSocialReferrals.sessions})` }).from(gaSocialReferrals).where(and12(eq21(gaSocialReferrals.projectId, project.id), sql8`${gaSocialReferrals.date} >= ${daysAgo2(7)}`, sql8`${gaSocialReferrals.date} < ${todayStr}`)).groupBy(gaSocialReferrals.source).all();
-    const socialSourcePrev = app.db.select({ source: gaSocialReferrals.source, sessions: sql8`SUM(${gaSocialReferrals.sessions})` }).from(gaSocialReferrals).where(and12(eq21(gaSocialReferrals.projectId, project.id), sql8`${gaSocialReferrals.date} >= ${daysAgo2(14)}`, sql8`${gaSocialReferrals.date} < ${daysAgo2(7)}`)).groupBy(gaSocialReferrals.source).all();
+    const socialSourceCurrent = app.db.select({ source: gaSocialReferrals.source, sessions: sql8`SUM(${gaSocialReferrals.sessions})` }).from(gaSocialReferrals).where(and15(eq21(gaSocialReferrals.projectId, project.id), sql8`${gaSocialReferrals.date} >= ${daysAgo2(7)}`, sql8`${gaSocialReferrals.date} < ${todayStr}`)).groupBy(gaSocialReferrals.source).all();
+    const socialSourcePrev = app.db.select({ source: gaSocialReferrals.source, sessions: sql8`SUM(${gaSocialReferrals.sessions})` }).from(gaSocialReferrals).where(and15(eq21(gaSocialReferrals.projectId, project.id), sql8`${gaSocialReferrals.date} >= ${daysAgo2(14)}`, sql8`${gaSocialReferrals.date} < ${daysAgo2(7)}`)).groupBy(gaSocialReferrals.source).all();
     return {
       total: buildTrend(sumTotal),
       organic: buildTrend(sumOrganic),
@@ -14875,7 +15178,7 @@ async function ga4Routes(app, opts) {
       sessions: sql8`SUM(${gaTrafficSnapshots.sessions})`,
       organicSessions: sql8`SUM(${gaTrafficSnapshots.organicSessions})`,
       users: sql8`SUM(${gaTrafficSnapshots.users})`
-    }).from(gaTrafficSnapshots).where(and12(...conditions)).groupBy(gaTrafficSnapshots.date).orderBy(gaTrafficSnapshots.date).all();
+    }).from(gaTrafficSnapshots).where(and15(...conditions)).groupBy(gaTrafficSnapshots.date).orderBy(gaTrafficSnapshots.date).all();
     return rows.map((r) => ({
       date: r.date,
       sessions: r.sessions ?? 0,
@@ -15669,7 +15972,7 @@ async function deploySchema(connection, slug, schemas, env) {
       return {
         slug,
         status: "stripped",
-        schemasInjected: schemas.map((s) => String(s["@type"] ?? "Unknown")),
+        schemasInjected: schemas.map((s) => typeof s["@type"] === "string" ? s["@type"] : "Unknown"),
         manualAssist: {
           manualRequired: true,
           targetUrl: page.link ?? `${site.siteUrl}/${slug}`,
@@ -15686,7 +15989,7 @@ async function deploySchema(connection, slug, schemas, env) {
     return {
       slug,
       status: "deployed",
-      schemasInjected: schemas.map((s) => String(s["@type"] ?? "Unknown"))
+      schemasInjected: schemas.map((s) => typeof s["@type"] === "string" ? s["@type"] : "Unknown")
     };
   } catch (error) {
     if (error instanceof WordpressApiError && error.code === "NOT_FOUND") {
@@ -15746,7 +16049,7 @@ async function getSchemaStatus(connection, env) {
         while ((jsonMatch = jsonLdRegex.exec(match[1])) !== null) {
           try {
             const parsed = JSON.parse(jsonMatch[1].trim());
-            canonrySchemas.push(String(parsed["@type"] ?? "Unknown"));
+            canonrySchemas.push(typeof parsed["@type"] === "string" ? parsed["@type"] : "Unknown");
           } catch {
           }
         }
@@ -16477,7 +16780,7 @@ async function wordpressRoutes(app, opts) {
             steps.push({ name: "google-submit", status: "completed", summary: `${succeeded}/${pageUrls.length} URLs submitted` });
           } else {
             const body = JSON.parse(googleRes.body);
-            const msg = body.message || body.error || `HTTP ${googleRes.statusCode}`;
+            const msg = body.message ?? body.error ?? `HTTP ${googleRes.statusCode}`;
             if (googleRes.statusCode === 400 || googleRes.statusCode === 404) {
               steps.push({ name: "google-submit", status: "skipped", summary: msg });
             } else {
@@ -16502,7 +16805,7 @@ async function wordpressRoutes(app, opts) {
             steps.push({ name: "bing-submit", status: "completed", summary: `${succeeded}/${pageUrls.length} URLs submitted` });
           } else {
             const body = JSON.parse(bingRes.body);
-            const msg = body.message || body.error || `HTTP ${bingRes.statusCode}`;
+            const msg = body.message ?? body.error ?? `HTTP ${bingRes.statusCode}`;
             if (bingRes.statusCode === 400 || bingRes.statusCode === 404) {
               steps.push({ name: "bing-submit", status: "skipped", summary: msg });
             } else {
@@ -16528,7 +16831,7 @@ async function wordpressRoutes(app, opts) {
 
 // ../api-routes/src/backlinks.ts
 import crypto18 from "crypto";
-import { and as and14, asc as asc2, desc as desc11, eq as eq22, sql as sql9 } from "drizzle-orm";
+import { and as and17, asc as asc2, desc as desc11, eq as eq22, sql as sql9 } from "drizzle-orm";
 
 // ../integration-commoncrawl/src/constants.ts
 import os3 from "os";
@@ -16925,7 +17228,7 @@ function pruneCachedRelease(release, opts = {}) {
 }
 
 // ../api-routes/src/backlinks-filter.ts
-import { and as and13, ne as ne2, notLike } from "drizzle-orm";
+import { and as and16, ne as ne3, notLike } from "drizzle-orm";
 var BACKLINK_FILTER_PATTERNS = [
   "*.google.com",
   "*.googleusercontent.com",
@@ -16942,13 +17245,13 @@ function backlinkCrawlerExclusionClause() {
   for (const pattern of BACKLINK_FILTER_PATTERNS) {
     if (pattern.startsWith("*.")) {
       const suffix = pattern.slice(2);
-      conditions.push(ne2(backlinkDomains.linkingDomain, suffix));
+      conditions.push(ne3(backlinkDomains.linkingDomain, suffix));
       conditions.push(notLike(backlinkDomains.linkingDomain, `%.${suffix}`));
     } else {
-      conditions.push(ne2(backlinkDomains.linkingDomain, pattern));
+      conditions.push(ne3(backlinkDomains.linkingDomain, pattern));
     }
   }
-  const combined = and13(...conditions);
+  const combined = and16(...conditions);
   if (!combined) throw new Error("BACKLINK_FILTER_PATTERNS is unexpectedly empty");
   return combined;
 }
@@ -17009,7 +17312,7 @@ function mapRunRow(row) {
   };
 }
 function latestSummaryForProject(db, projectId, release) {
-  const condition = release ? and14(eq22(backlinkSummaries.projectId, projectId), eq22(backlinkSummaries.release, release)) : eq22(backlinkSummaries.projectId, projectId);
+  const condition = release ? and17(eq22(backlinkSummaries.projectId, projectId), eq22(backlinkSummaries.release, release)) : eq22(backlinkSummaries.projectId, projectId);
   return db.select().from(backlinkSummaries).where(condition).orderBy(desc11(backlinkSummaries.queriedAt)).limit(1).get();
 }
 function parseExcludeCrawlers(value) {
@@ -17018,11 +17321,11 @@ function parseExcludeCrawlers(value) {
   return lower === "1" || lower === "true" || lower === "yes";
 }
 function computeFilteredSummary(db, base) {
-  const baseDomainCondition = and14(
+  const baseDomainCondition = and17(
     eq22(backlinkDomains.projectId, base.projectId),
     eq22(backlinkDomains.release, base.release)
   );
-  const filteredCondition = and14(baseDomainCondition, backlinkCrawlerExclusionClause());
+  const filteredCondition = and17(baseDomainCondition, backlinkCrawlerExclusionClause());
   const unfilteredAgg = db.select({
     count: sql9`count(*)`,
     total: sql9`coalesce(sum(${backlinkDomains.numHosts}), 0)`
@@ -17198,11 +17501,11 @@ async function backlinksRoutes(app, opts) {
     const limit = Math.min(Math.max(parseInt(request.query.limit ?? "50", 10) || 50, 1), 500);
     const offset = Math.max(parseInt(request.query.offset ?? "0", 10) || 0, 0);
     const excludeCrawlers = parseExcludeCrawlers(request.query.excludeCrawlers);
-    const baseDomainCondition = and14(
+    const baseDomainCondition = and17(
       eq22(backlinkDomains.projectId, project.id),
       eq22(backlinkDomains.release, targetRelease)
     );
-    const domainCondition = excludeCrawlers ? and14(baseDomainCondition, backlinkCrawlerExclusionClause()) : baseDomainCondition;
+    const domainCondition = excludeCrawlers ? and17(baseDomainCondition, backlinkCrawlerExclusionClause()) : baseDomainCondition;
     const totalRow = app.db.select({ count: sql9`count(*)` }).from(backlinkDomains).where(domainCondition).get();
     const rows = app.db.select({
       linkingDomain: backlinkDomains.linkingDomain,
@@ -17238,7 +17541,7 @@ async function backlinksRoutes(app, opts) {
 
 // ../api-routes/src/traffic.ts
 import crypto20 from "crypto";
-import { and as and15, desc as desc12, eq as eq23, gte as gte2, lte as lte2, sql as sql10 } from "drizzle-orm";
+import { and as and18, desc as desc12, eq as eq23, gte as gte2, lte as lte2, sql as sql10 } from "drizzle-orm";
 
 // ../integration-cloud-run/src/auth.ts
 import crypto19 from "crypto";
@@ -17521,6 +17824,7 @@ async function listCloudRunTrafficEvents(accessToken, options) {
 }
 
 // ../integration-traffic/src/rules.ts
+var LEGACY_CHATGPT_DOMAIN = "chat.openai.com";
 var DEFAULT_AI_CRAWLER_RULES = [
   {
     id: "openai-gptbot",
@@ -17615,15 +17919,15 @@ var DEFAULT_AI_CRAWLER_RULES = [
   }
 ];
 var DEFAULT_AI_REFERRER_RULES = [
-  { domain: "chatgpt.com", operator: "OpenAI", product: "ChatGPT" },
-  { domain: "chat.openai.com", operator: "OpenAI", product: "ChatGPT" },
-  { domain: "perplexity.ai", operator: "Perplexity", product: "Perplexity" },
-  { domain: "claude.ai", operator: "Anthropic", product: "Claude" },
-  { domain: "gemini.google.com", operator: "Google", product: "Gemini" },
-  { domain: "copilot.microsoft.com", operator: "Microsoft", product: "Copilot" },
-  { domain: "phind.com", operator: "Phind", product: "Phind" },
-  { domain: "you.com", operator: "You.com", product: "You.com" },
-  { domain: "meta.ai", operator: "Meta", product: "Meta AI" }
+  { domain: AI_ENGINE_DOMAINS.chatgpt, operator: "OpenAI", product: "ChatGPT" },
+  { domain: LEGACY_CHATGPT_DOMAIN, operator: "OpenAI", product: "ChatGPT" },
+  { domain: AI_ENGINE_DOMAINS.perplexity, operator: "Perplexity", product: "Perplexity" },
+  { domain: AI_ENGINE_DOMAINS.claude, operator: "Anthropic", product: "Claude" },
+  { domain: AI_ENGINE_DOMAINS.gemini, operator: "Google", product: "Gemini" },
+  { domain: AI_ENGINE_DOMAINS.copilotMicrosoft, operator: "Microsoft", product: "Copilot" },
+  { domain: AI_ENGINE_DOMAINS.phind, operator: "Phind", product: "Phind" },
+  { domain: AI_ENGINE_DOMAINS.you, operator: "You.com", product: "You.com" },
+  { domain: AI_ENGINE_DOMAINS.metaAi, operator: "Meta", product: "Meta AI" }
 ];
 
 // ../integration-traffic/src/classifier.ts
@@ -18386,21 +18690,21 @@ async function runBackfillTask(options) {
   try {
     app.db.transaction((tx) => {
       tx.delete(crawlerEventsHourly).where(
-        and15(
+        and18(
           eq23(crawlerEventsHourly.sourceId, sourceRow.id),
           gte2(crawlerEventsHourly.tsHour, windowStartIso),
           lte2(crawlerEventsHourly.tsHour, windowEndIso)
         )
       ).run();
       tx.delete(aiReferralEventsHourly).where(
-        and15(
+        and18(
           eq23(aiReferralEventsHourly.sourceId, sourceRow.id),
           gte2(aiReferralEventsHourly.tsHour, windowStartIso),
           lte2(aiReferralEventsHourly.tsHour, windowEndIso)
         )
       ).run();
       tx.delete(rawEventSamples).where(
-        and15(
+        and18(
           eq23(rawEventSamples.sourceId, sourceRow.id),
           gte2(rawEventSamples.ts, windowStartIso),
           lte2(rawEventSamples.ts, windowEndIso)
@@ -19264,25 +19568,25 @@ async function trafficRoutes(app, opts) {
   });
   function buildSourceDetail(projectId, row, since) {
     const crawlerTotals = app.db.select({ total: sql10`COALESCE(SUM(${crawlerEventsHourly.hits}), 0)` }).from(crawlerEventsHourly).where(
-      and15(
+      and18(
         eq23(crawlerEventsHourly.sourceId, row.id),
         gte2(crawlerEventsHourly.tsHour, since)
       )
     ).get();
     const aiTotals = app.db.select({ total: sql10`COALESCE(SUM(${aiReferralEventsHourly.sessionsOrHits}), 0)` }).from(aiReferralEventsHourly).where(
-      and15(
+      and18(
         eq23(aiReferralEventsHourly.sourceId, row.id),
         gte2(aiReferralEventsHourly.tsHour, since)
       )
     ).get();
     const sampleTotals = app.db.select({ total: sql10`COUNT(*)` }).from(rawEventSamples).where(
-      and15(
+      and18(
         eq23(rawEventSamples.sourceId, row.id),
         gte2(rawEventSamples.ts, since)
       )
     ).get();
     const latestRun = app.db.select().from(runs).where(
-      and15(
+      and18(
         eq23(runs.projectId, projectId),
         eq23(runs.kind, RunKinds["traffic-sync"]),
         eq23(runs.sourceId, row.id)
@@ -19376,7 +19680,7 @@ async function trafficRoutes(app, opts) {
         lte2(crawlerEventsHourly.tsHour, untilIso)
       ];
       if (sourceIdParam) crawlerFilters.push(eq23(crawlerEventsHourly.sourceId, sourceIdParam));
-      const crawlerWhere = and15(...crawlerFilters);
+      const crawlerWhere = and18(...crawlerFilters);
       const total = app.db.select({ total: sql10`COALESCE(SUM(${crawlerEventsHourly.hits}), 0)` }).from(crawlerEventsHourly).where(crawlerWhere).get();
       crawlerTotal = Number(total?.total ?? 0);
       const rows = app.db.select().from(crawlerEventsHourly).where(crawlerWhere).orderBy(desc12(crawlerEventsHourly.tsHour)).limit(limit).all();
@@ -19401,7 +19705,7 @@ async function trafficRoutes(app, opts) {
         lte2(aiReferralEventsHourly.tsHour, untilIso)
       ];
       if (sourceIdParam) aiFilters.push(eq23(aiReferralEventsHourly.sourceId, sourceIdParam));
-      const aiWhere = and15(...aiFilters);
+      const aiWhere = and18(...aiFilters);
       const total = app.db.select({ total: sql10`COALESCE(SUM(${aiReferralEventsHourly.sessionsOrHits}), 0)` }).from(aiReferralEventsHourly).where(aiWhere).get();
       aiReferralTotal = Number(total?.total ?? 0);
       const rows = app.db.select().from(aiReferralEventsHourly).where(aiWhere).orderBy(desc12(aiReferralEventsHourly.tsHour)).limit(limit).all();
@@ -20125,7 +20429,7 @@ var providersConfiguredCheck = {
 var PROVIDERS_CHECKS = [providersConfiguredCheck];
 
 // ../api-routes/src/doctor/checks/traffic-source.ts
-import { and as and16, eq as eq24, gte as gte3, ne as ne3, sql as sql11 } from "drizzle-orm";
+import { and as and19, eq as eq24, gte as gte3, ne as ne4, sql as sql11 } from "drizzle-orm";
 var RECENT_DATA_WARN_DAYS = 7;
 var RECENT_DATA_FAIL_DAYS = 30;
 function skippedNoProject2() {
@@ -20139,9 +20443,9 @@ function skippedNoProject2() {
 function loadProbes(ctx) {
   if (!ctx.project) return [];
   const rows = ctx.db.select().from(trafficSources).where(
-    and16(
+    and19(
       eq24(trafficSources.projectId, ctx.project.id),
-      ne3(trafficSources.status, TrafficSourceStatuses.archived)
+      ne4(trafficSources.status, TrafficSourceStatuses.archived)
     )
   ).all();
   return rows.map((r) => ({
@@ -20220,7 +20524,7 @@ var recentDataCheck = {
     const failCutoff = new Date(now.getTime() - RECENT_DATA_FAIL_DAYS * 24 * 60 * 6e4).toISOString();
     const recentCrawlers = Number(
       ctx.db.select({ total: sql11`COALESCE(SUM(${crawlerEventsHourly.hits}), 0)` }).from(crawlerEventsHourly).where(
-        and16(
+        and19(
           eq24(crawlerEventsHourly.projectId, ctx.project.id),
           gte3(crawlerEventsHourly.tsHour, warnCutoff)
         )
@@ -20228,7 +20532,7 @@ var recentDataCheck = {
     );
     const recentReferrals = Number(
       ctx.db.select({ total: sql11`COALESCE(SUM(${aiReferralEventsHourly.sessionsOrHits}), 0)` }).from(aiReferralEventsHourly).where(
-        and16(
+        and19(
           eq24(aiReferralEventsHourly.projectId, ctx.project.id),
           gte3(aiReferralEventsHourly.tsHour, warnCutoff)
         )
@@ -20244,7 +20548,7 @@ var recentDataCheck = {
     }
     const olderCrawlers = Number(
       ctx.db.select({ total: sql11`COALESCE(SUM(${crawlerEventsHourly.hits}), 0)` }).from(crawlerEventsHourly).where(
-        and16(
+        and19(
           eq24(crawlerEventsHourly.projectId, ctx.project.id),
           gte3(crawlerEventsHourly.tsHour, failCutoff)
         )
@@ -20252,7 +20556,7 @@ var recentDataCheck = {
     );
     const olderReferrals = Number(
       ctx.db.select({ total: sql11`COALESCE(SUM(${aiReferralEventsHourly.sessionsOrHits}), 0)` }).from(aiReferralEventsHourly).where(
-        and16(
+        and19(
           eq24(aiReferralEventsHourly.projectId, ctx.project.id),
           gte3(aiReferralEventsHourly.tsHour, failCutoff)
         )
@@ -20436,9 +20740,6 @@ var ALL_CHECKS = [
   ...TRAFFIC_SOURCE_CHECKS,
   ...AGENT_CHECKS
 ];
-var CHECK_BY_ID = Object.fromEntries(
-  ALL_CHECKS.map((check) => [check.id, check])
-);
 
 // ../api-routes/src/doctor/runner.ts
 function matchesCheckId(checkId, filters) {
@@ -20551,7 +20852,7 @@ async function doctorRoutes(app, opts) {
 
 // ../api-routes/src/discovery/routes.ts
 import crypto21 from "crypto";
-import { and as and17, desc as desc13, eq as eq25, gte as gte4, inArray as inArray9 } from "drizzle-orm";
+import { and as and20, desc as desc13, eq as eq25, gte as gte4, inArray as inArray9 } from "drizzle-orm";
 var MAX_INFLIGHT_DISCOVERY_AGE_MS = 2 * 60 * 60 * 1e3;
 async function discoveryRoutes(app, opts) {
   app.post("/projects/:name/discover/run", async (request, reply) => {
@@ -20583,7 +20884,7 @@ async function discoveryRoutes(app, opts) {
     const now = (/* @__PURE__ */ new Date()).toISOString();
     const ageFloorIso = new Date(Date.now() - MAX_INFLIGHT_DISCOVERY_AGE_MS).toISOString();
     const decision = app.db.transaction((tx) => {
-      const existing = tx.select({ id: discoverySessions.id, runId: discoverySessions.runId }).from(discoverySessions).where(and17(
+      const existing = tx.select({ id: discoverySessions.id, runId: discoverySessions.runId }).from(discoverySessions).where(and20(
         eq25(discoverySessions.projectId, project.id),
         eq25(discoverySessions.icpDescription, icpDescription),
         inArray9(discoverySessions.status, [
@@ -21560,10 +21861,10 @@ function extractDomainFromUri(uri) {
   try {
     const url = new URL(uri);
     const hostname = url.hostname.replace(/^www\./, "").toLowerCase();
-    if (hostname.includes("chatgpt.com") || hostname.includes("openai.com")) {
+    if (AI_ENGINE_SELF_DOMAINS.chatgpt.some((self) => hostname.includes(self))) {
       return null;
     }
-    if (hostname === "vertexaisearch.cloud.google.com") {
+    if (hostname === VERTEX_AI_SEARCH_PROXY_DOMAIN) {
       const redirectPath = url.pathname.replace(/^\/grounding-api-redirect\//, "");
       if (redirectPath && redirectPath !== url.pathname) {
         try {
@@ -21831,7 +22132,7 @@ async function healthcheck2(config) {
 async function executeTrackedQuery2(input) {
   const model = input.config.model ?? DEFAULT_MODEL2;
   const client = new OpenAI({ apiKey: input.config.apiKey });
-  const webSearchTool = { type: "web_search_preview" };
+  const webSearchTool = { type: "web_search" };
   if (input.location) {
     webSearchTool.user_location = {
       type: "approximate",
@@ -21993,7 +22294,7 @@ function extractDomainFromUri2(uri) {
   try {
     const url = new URL(uri);
     const hostname = url.hostname.replace(/^www\./, "").toLowerCase();
-    if (hostname.includes("chatgpt.com") || hostname.includes("openai.com")) {
+    if (AI_ENGINE_SELF_DOMAINS.chatgpt.some((self) => hostname.includes(self))) {
       return null;
     }
     return hostname;
@@ -22372,7 +22673,7 @@ function extractDomainFromUri3(uri) {
   try {
     const url = new URL(uri);
     const hostname = url.hostname.replace(/^www\./, "").toLowerCase();
-    if (hostname.includes("chatgpt.com") || hostname.includes("openai.com")) {
+    if (AI_ENGINE_SELF_DOMAINS.chatgpt.some((self) => hostname.includes(self))) {
       return null;
     }
     return hostname;
@@ -22917,8 +23218,8 @@ async function waitForStabilization(client, selector, opts = {}) {
 // ../provider-cdp/src/targets/chatgpt.ts
 var chatgptTarget = {
   name: "chatgpt",
-  baseUrl: "https://chatgpt.com",
-  newConversationUrl: "https://chatgpt.com/?model=auto",
+  baseUrl: `https://${AI_ENGINE_DOMAINS.chatgpt}`,
+  newConversationUrl: `https://${AI_ENGINE_DOMAINS.chatgpt}/?model=auto`,
   responseSelector: '[data-testid="conversation-turn-3"], article:last-of-type, .agent-turn:last-of-type',
   async submitQuery(client, query) {
     const inputReady = await waitForElement(
@@ -23022,8 +23323,10 @@ var chatgptTarget = {
   },
   extractCitations(client) {
     return (async () => {
+      const selfDomainsLiteral = JSON.stringify(AI_ENGINE_SELF_DOMAINS.chatgpt);
       const { result } = await client.Runtime.evaluate({
         expression: `(() => {
+          const SELF_DOMAINS = ${selfDomainsLiteral};
           const sources = [];
           const seen = new Set();
           const turns = document.querySelectorAll('[data-message-author-role="assistant"]');
@@ -23047,7 +23350,7 @@ var chatgptTarget = {
               }
             }
 
-            if (!seen.has(href) && hostname !== 'chatgpt.com' && hostname !== 'openai.com') {
+            if (!seen.has(href) && !SELF_DOMAINS.includes(hostname)) {
               seen.add(href);
               sources.push({
                 uri: href,
@@ -23064,7 +23367,7 @@ var chatgptTarget = {
             if (href && !seen.has(href)) {
               let hostname = '';
               try { hostname = new URL(href).hostname.replace(/^www\\./, ''); } catch {}
-              if (hostname !== 'chatgpt.com' && hostname !== 'openai.com') {
+              if (!SELF_DOMAINS.includes(hostname)) {
                 seen.add(href);
                 sources.push({ uri: href, title: title || hostname || href });
               }
@@ -23154,7 +23457,7 @@ function extractCitedDomains(groundingSources) {
     try {
       const url = new URL(source.uri);
       const domain = url.hostname.replace(/^www\./, "").toLowerCase();
-      if (!domain.includes("chatgpt.com") && !domain.includes("openai.com")) {
+      if (!AI_ENGINE_SELF_DOMAINS.chatgpt.some((self) => domain.includes(self))) {
         domains.add(domain);
       }
     } catch {
@@ -23539,7 +23842,7 @@ function extractDomainFromUri4(uri) {
   try {
     const url = new URL(uri);
     const hostname = url.hostname.replace(/^www\./, "").toLowerCase();
-    if (hostname.includes("chatgpt.com") || hostname.includes("openai.com")) {
+    if (AI_ENGINE_SELF_DOMAINS.chatgpt.some((self) => hostname.includes(self))) {
       return null;
     }
     return hostname;
@@ -23904,7 +24207,7 @@ import crypto24 from "crypto";
 import fs8 from "fs";
 import path10 from "path";
 import os5 from "os";
-import { and as and18, eq as eq27, inArray as inArray10, sql as sql12 } from "drizzle-orm";
+import { and as and21, eq as eq27, inArray as inArray10, sql as sql12 } from "drizzle-orm";
 
 // src/run-telemetry.ts
 import crypto23 from "crypto";
@@ -24287,7 +24590,7 @@ var JobRunner = class {
         throw new Error(`Run ${runId} is not executable from status '${existingRun.status}'`);
       }
       if (existingRun.status === "queued") {
-        this.db.update(runs).set({ status: "running", startedAt: now }).where(and18(eq27(runs.id, runId), eq27(runs.status, "queued"))).run();
+        this.db.update(runs).set({ status: "running", startedAt: now }).where(and21(eq27(runs.id, runId), eq27(runs.status, "queued"))).run();
       }
       this.throwIfRunCancelled(runId);
       const project = this.db.select().from(projects).where(eq27(projects.id, projectId)).get();
@@ -24312,7 +24615,7 @@ var JobRunner = class {
       }
       log.info("run.dispatch", { runId, providerCount: activeProviders.length, providers: activeProviders.map((p) => p.adapter.name) });
       const scopedQueryNames = parseJsonColumn(existingRun.queries, null);
-      projectQueries = scopedQueryNames ? this.db.select().from(queries).where(and18(eq27(queries.projectId, projectId), inArray10(queries.query, scopedQueryNames))).all() : this.db.select().from(queries).where(eq27(queries.projectId, projectId)).all();
+      projectQueries = scopedQueryNames ? this.db.select().from(queries).where(and21(eq27(queries.projectId, projectId), inArray10(queries.query, scopedQueryNames))).all() : this.db.select().from(queries).where(eq27(queries.projectId, projectId)).all();
       const projectCompetitors = this.db.select().from(competitors).where(eq27(competitors.projectId, projectId)).all();
       const competitorDomains = projectCompetitors.map((c) => c.domain);
       const allDomains = effectiveDomains({
@@ -24655,7 +24958,7 @@ function buildPhases(input) {
 
 // src/gsc-sync.ts
 import crypto25 from "crypto";
-import { eq as eq28, and as and19, sql as sql13 } from "drizzle-orm";
+import { eq as eq28, and as and22, sql as sql13 } from "drizzle-orm";
 var log2 = createLogger("GscSync");
 function formatDate3(d) {
   return d.toISOString().split("T")[0];
@@ -24707,7 +25010,7 @@ async function executeGscSync(db, runId, projectId, opts) {
     });
     log2.info("fetch.complete", { runId, projectId, rowCount: rows.length });
     db.delete(gscSearchData).where(
-      and19(
+      and22(
         eq28(gscSearchData.projectId, projectId),
         sql13`${gscSearchData.date} >= ${startDate}`,
         sql13`${gscSearchData.date} <= ${endDate}`
@@ -24796,7 +25099,7 @@ async function executeGscSync(db, runId, projectId, opts) {
       }
     }
     const snapshotDate = formatDate3(/* @__PURE__ */ new Date());
-    db.delete(gscCoverageSnapshots).where(and19(eq28(gscCoverageSnapshots.projectId, projectId), eq28(gscCoverageSnapshots.date, snapshotDate))).run();
+    db.delete(gscCoverageSnapshots).where(and22(eq28(gscCoverageSnapshots.projectId, projectId), eq28(gscCoverageSnapshots.date, snapshotDate))).run();
     db.insert(gscCoverageSnapshots).values({
       id: crypto25.randomUUID(),
       projectId,
@@ -24819,7 +25122,7 @@ async function executeGscSync(db, runId, projectId, opts) {
 
 // src/gsc-inspect-sitemap.ts
 import crypto26 from "crypto";
-import { eq as eq29, and as and20 } from "drizzle-orm";
+import { eq as eq29, and as and23 } from "drizzle-orm";
 
 // src/sitemap-parser.ts
 var log3 = createLogger("SitemapParser");
@@ -25037,7 +25340,7 @@ async function executeInspectSitemap(db, runId, projectId, opts) {
       }
     }
     const snapshotDate = (/* @__PURE__ */ new Date()).toISOString().split("T")[0];
-    db.delete(gscCoverageSnapshots).where(and20(eq29(gscCoverageSnapshots.projectId, projectId), eq29(gscCoverageSnapshots.date, snapshotDate))).run();
+    db.delete(gscCoverageSnapshots).where(and23(eq29(gscCoverageSnapshots.projectId, projectId), eq29(gscCoverageSnapshots.date, snapshotDate))).run();
     db.insert(gscCoverageSnapshots).values({
       id: crypto26.randomUUID(),
       projectId,
@@ -25248,7 +25551,7 @@ async function executeBingInspectSitemap(db, runId, projectId, opts) {
 // src/commoncrawl-sync.ts
 import crypto28 from "crypto";
 import path11 from "path";
-import { and as and21, eq as eq31, sql as sql14 } from "drizzle-orm";
+import { and as and24, eq as eq31, sql as sql14 } from "drizzle-orm";
 var log6 = createLogger("CommonCrawlSync");
 var INSERT_CHUNK_SIZE = 1e4;
 function defaultDeps() {
@@ -25439,7 +25742,7 @@ function computeSummary(rows) {
 // src/backlink-extract.ts
 import crypto29 from "crypto";
 import fs9 from "fs";
-import { and as and22, desc as desc15, eq as eq32 } from "drizzle-orm";
+import { and as and25, desc as desc15, eq as eq32 } from "drizzle-orm";
 var log7 = createLogger("BacklinkExtract");
 function defaultDeps2() {
   return {
@@ -25485,7 +25788,7 @@ async function executeBacklinkExtract(db, runId, projectId, opts = {}) {
     const targetDomain = project.canonicalDomain;
     db.transaction((tx) => {
       tx.delete(backlinkDomains).where(
-        and22(eq32(backlinkDomains.projectId, projectId), eq32(backlinkDomains.release, release))
+        and25(eq32(backlinkDomains.projectId, projectId), eq32(backlinkDomains.release, release))
       ).run();
       if (rows.length > 0) {
         const values = rows.map((r) => ({
@@ -25556,7 +25859,7 @@ function computeSummary2(rows) {
 
 // src/discovery-run.ts
 import crypto30 from "crypto";
-import { and as and23, eq as eq33 } from "drizzle-orm";
+import { and as and26, eq as eq33 } from "drizzle-orm";
 var log8 = createLogger("DiscoveryRun");
 var DEFAULT_SEED_COUNT = 30;
 var QUERIES_PER_INTENT_BUCKET = 6;
@@ -25816,7 +26119,7 @@ function writeDiscoveryInsight(db, input) {
     totalProbes
   });
   db.transaction((tx) => {
-    tx.update(insights).set({ dismissed: true }).where(and23(
+    tx.update(insights).set({ dismissed: true }).where(and26(
       eq33(insights.projectId, input.projectId),
       eq33(insights.type, "discovery.basket-divergence"),
       eq33(insights.dismissed, false)
@@ -25860,7 +26163,7 @@ function buildDiscoveryInsightTitle(input) {
 }
 
 // src/commands/backfill.ts
-import { and as and24, eq as eq34, inArray as inArray11 } from "drizzle-orm";
+import { and as and27, eq as eq34, inArray as inArray11 } from "drizzle-orm";
 var SNAPSHOT_BATCH_SIZE = 500;
 async function backfillAnswerVisibilityCommand(opts) {
   const config = loadConfig();
@@ -25876,7 +26179,7 @@ async function backfillAnswerVisibilityCommand(opts) {
   let reparsed = 0;
   let providerErrors = 0;
   if (scopedProjects.length > 0) {
-    const runRows = projectFilter ? db.select({ id: runs.id, projectId: runs.projectId }).from(runs).where(and24(
+    const runRows = projectFilter ? db.select({ id: runs.id, projectId: runs.projectId }).from(runs).where(and27(
       eq34(runs.kind, RunKinds["answer-visibility"]),
       inArray11(runs.projectId, scopedProjects.map((project) => project.id))
     )).all() : db.select({ id: runs.id, projectId: runs.projectId }).from(runs).where(eq34(runs.kind, RunKinds["answer-visibility"])).all();
@@ -26034,7 +26337,7 @@ function backfillNormalizedPaths(db, opts) {
     id: gaTrafficSnapshots.id,
     landingPage: gaTrafficSnapshots.landingPage,
     landingPageNormalized: gaTrafficSnapshots.landingPageNormalized
-  }).from(gaTrafficSnapshots).where(baseConditions.length > 0 ? and24(...baseConditions) : void 0).all();
+  }).from(gaTrafficSnapshots).where(baseConditions.length > 0 ? and27(...baseConditions) : void 0).all();
   let updated = 0;
   let unchanged = 0;
   if (rows.length > 0) {
@@ -26106,7 +26409,7 @@ function backfillAiReferralPaths(db, opts) {
     id: gaAiReferrals.id,
     landingPage: gaAiReferrals.landingPage,
     landingPageNormalized: gaAiReferrals.landingPageNormalized
-  }).from(gaAiReferrals).where(baseConditions.length > 0 ? and24(...baseConditions) : void 0).all();
+  }).from(gaAiReferrals).where(baseConditions.length > 0 ? and27(...baseConditions) : void 0).all();
   let updated = 0;
   let unchanged = 0;
   if (rows.length > 0) {
@@ -26174,7 +26477,7 @@ function backfillProjectAnswerMentions(db, projectId, opts) {
   const project = db.select().from(projects).where(eq34(projects.id, projectId)).get();
   if (!project) return { examined: 0, updated: 0, mentioned: 0 };
   const competitorDomains = db.select({ domain: competitors.domain }).from(competitors).where(eq34(competitors.projectId, projectId)).all().map((row) => row.domain);
-  const runRows = db.select({ id: runs.id }).from(runs).where(and24(eq34(runs.kind, RunKinds["answer-visibility"]), eq34(runs.projectId, projectId))).all();
+  const runRows = db.select({ id: runs.id }).from(runs).where(and27(eq34(runs.kind, RunKinds["answer-visibility"]), eq34(runs.projectId, projectId))).all();
   const runIds = runRows.map((r) => r.id);
   let examined = 0;
   let updated = 0;
@@ -26325,7 +26628,7 @@ function readStoredGroundingSources(rawResponse) {
   return result;
 }
 async function backfillInsightsCommand(project, opts) {
-  const { IntelligenceService: IntelligenceService2 } = await import("./intelligence-service-R3KDVKIB.js");
+  const { IntelligenceService: IntelligenceService2 } = await import("./intelligence-service-TY7IPRST.js");
   const config = loadConfig();
   const db = createClient(config.database);
   migrate(db);
@@ -26474,7 +26777,7 @@ var ProviderRegistry = class {
 
 // src/scheduler.ts
 import cron from "node-cron";
-import { and as and25, eq as eq35 } from "drizzle-orm";
+import { and as and28, eq as eq35 } from "drizzle-orm";
 var log9 = createLogger("Scheduler");
 function taskKey(projectId, kind) {
   return `${projectId}::${kind}`;
@@ -26519,7 +26822,7 @@ var Scheduler = class {
       this.stopTask(key, existing, "Stopped");
       this.tasks.delete(key);
     }
-    const schedule = this.db.select().from(schedules).where(and25(eq35(schedules.projectId, projectId), eq35(schedules.kind, kind))).get();
+    const schedule = this.db.select().from(schedules).where(and28(eq35(schedules.projectId, projectId), eq35(schedules.kind, kind))).get();
     if (schedule && schedule.enabled === 1) {
       this.registerCronTask(schedule);
     }
@@ -26540,8 +26843,8 @@ var Scheduler = class {
     }
   }
   stopTask(key, task, verb) {
-    task.stop();
-    task.destroy();
+    void task.stop();
+    void task.destroy();
     log9.info(`task.${verb.toLowerCase()}`, { key });
   }
   registerCronTask(schedule) {
@@ -26643,7 +26946,7 @@ var Scheduler = class {
 };
 
 // src/notifier.ts
-import { eq as eq36, desc as desc16, and as and26, inArray as inArray12, or as or5 } from "drizzle-orm";
+import { eq as eq36, desc as desc16, and as and29, inArray as inArray12, or as or5 } from "drizzle-orm";
 import crypto31 from "crypto";
 var log10 = createLogger("Notifier");
 var Notifier = class {
@@ -26750,7 +27053,7 @@ var Notifier = class {
   computeTransitions(runId, projectId) {
     const thisRun = this.db.select().from(runs).where(eq36(runs.id, runId)).get();
     if (!thisRun) return [];
-    const groupSiblings = this.db.select().from(runs).where(and26(
+    const groupSiblings = this.db.select().from(runs).where(and29(
       eq36(runs.projectId, projectId),
       eq36(runs.kind, thisRun.kind),
       eq36(runs.createdAt, thisRun.createdAt)
@@ -26776,7 +27079,7 @@ var Notifier = class {
     );
     const RECENT_FETCH_LIMIT = Math.max(8, locationCount * 4);
     const recentRuns = this.db.select().from(runs).where(
-      and26(
+      and29(
         eq36(runs.projectId, projectId),
         eq36(runs.kind, thisRun.kind),
         or5(eq36(runs.status, "completed"), eq36(runs.status, "partial"))
@@ -26889,6 +27192,10 @@ var RunCoordinator = class {
   async onRunCompleted(runId, projectId) {
     const runRow = this.db.select().from(runs).where(eq37(runs.id, runId)).get();
     const kind = runRow?.kind ?? RunKinds["answer-visibility"];
+    if (runRow?.trigger === RunTriggers.probe) {
+      log11.info("probe.skip-side-effects", { runId, projectId, kind });
+      return;
+    }
     let insightCount = 0;
     let criticalOrHigh = 0;
     if (kind === RunKinds["answer-visibility"]) {
@@ -27315,7 +27622,7 @@ function resolveSessionProviderAndModel(config, opts) {
 
 // src/agent/memory-store.ts
 import crypto32 from "crypto";
-import { and as and27, desc as desc17, eq as eq38, like as like2, sql as sql15 } from "drizzle-orm";
+import { and as and30, desc as desc17, eq as eq38, like as like2, sql as sql15 } from "drizzle-orm";
 var COMPACTION_KEY_PREFIX = "compaction:";
 var COMPACTION_NOTES_PER_SESSION = 3;
 function rowToDto2(row) {
@@ -27360,12 +27667,12 @@ function upsertMemoryEntry(db, args) {
       updatedAt: now
     }
   }).run();
-  const row = db.select().from(agentMemory).where(and27(eq38(agentMemory.projectId, args.projectId), eq38(agentMemory.key, args.key))).get();
+  const row = db.select().from(agentMemory).where(and30(eq38(agentMemory.projectId, args.projectId), eq38(agentMemory.key, args.key))).get();
   if (!row) throw new Error("memory upsert produced no row");
   return rowToDto2(row);
 }
 function deleteMemoryEntry(db, projectId, key) {
-  const result = db.delete(agentMemory).where(and27(eq38(agentMemory.projectId, projectId), eq38(agentMemory.key, key))).run();
+  const result = db.delete(agentMemory).where(and30(eq38(agentMemory.projectId, projectId), eq38(agentMemory.key, key))).run();
   const changes = result.changes ?? 0;
   return changes > 0;
 }
@@ -27394,7 +27701,7 @@ function writeCompactionNote(db, args) {
     }).run();
     const sessionPrefix = `${COMPACTION_KEY_PREFIX}${args.sessionId}:`;
     const existing = tx.select({ id: agentMemory.id, updatedAt: agentMemory.updatedAt }).from(agentMemory).where(
-      and27(
+      and30(
         eq38(agentMemory.projectId, args.projectId),
         like2(agentMemory.key, `${sessionPrefix}%`)
       )
@@ -27403,7 +27710,7 @@ function writeCompactionNote(db, args) {
     if (stale.length > 0) {
       tx.delete(agentMemory).where(sql15`${agentMemory.id} IN (${sql15.join(stale.map((s) => sql15`${s}`), sql15`, `)})`).run();
     }
-    const row = tx.select().from(agentMemory).where(and27(eq38(agentMemory.projectId, args.projectId), eq38(agentMemory.key, key))).get();
+    const row = tx.select().from(agentMemory).where(and30(eq38(agentMemory.projectId, args.projectId), eq38(agentMemory.key, key))).get();
     if (row) inserted = rowToDto2(row);
   });
   if (!inserted) throw new Error("compaction note write produced no row");