@canonry/canonry 4.133.2 → 4.134.0

package/dist/{chunk-IEZTETUZ.js → chunk-LIXWDIDR.js}

@@ -8,11 +8,20 @@ import {
   AdsActivationEntityTypes,
   AdsActivationGrantStates,
   AdsActivationVersionPolicies,
+  AdsActivityAssessmentStates,
   AdsAdGroupBillingEventTypes,
   AdsCampaignBiddingTypes,
+  AdsDeliveryConfigurationBases,
+  AdsDeliverySnapshotIssues,
+  AdsDeliverySnapshotStatuses,
   AdsEntityStatuses,
   AdsEntityTypes,
+  AdsHistoricalCampaignRollupStatuses,
+  AdsInsightLevels,
   AdsIntegrityDecisions,
+  AdsLiveDeliveryBases,
+  AdsLiveEntityTypes,
+  AdsLivePresences,
   AdsOperationKinds,
   AdsOperationStates,
   AdsOperationStepStates,
@@ -83,12 +92,15 @@ import {
   adsConversionPixelListResponseSchema,
   adsCpcMicros,
   adsCtr,
+  adsDeliveryDiagnosticsDtoSchema,
   adsDisconnectResponseSchema,
   adsGeoSearchQuerySchema,
   adsGeoSearchResponseSchema,
   adsImageUploadRequestSchema,
   adsInsightLevelSchema,
   adsInsightsResponseSchema,
+  adsLiveDeliveryDtoSchema,
+  adsLiveDeliveryQuerySchema,
   adsOperationReconcileResponseSchema,
   adsOperationResponseSchema,
   adsOperationStepDtoSchema,
@@ -176,6 +188,7 @@ import {
   discoverySessionDetailDtoSchema,
   discoverySessionDtoSchema,
   doctorReportSchema,
+  dollarsToMicros,
   domainClassificationsResponseDtoSchema,
   effectiveBrandNames,
   effectiveDomains,
@@ -192,6 +205,7 @@ import {
   formatDateRange,
   formatDeltaCopy,
   formatIsoDate,
+  formatIsoDateInTimeZone,
   formatNumber,
   formatRatio,
   formatWindowCountDelta,
@@ -235,6 +249,7 @@ import {
   internalError,
   isBrowserProvider,
   isReadOnlyKey,
+  isoDateDaysBeforeInTimeZone,
   keywordDtoSchema,
   keywordGenerateRequestSchema,
   latestProjectRunDtoSchema,
@@ -349,10 +364,10 @@ import {
   wordpressSchemaDeployResultDtoSchema,
   wordpressSchemaStatusResultDtoSchema,
   wordpressStatusDtoSchema
-} from "./chunk-ZPQX5ZQ2.js";
+} from "./chunk-PC7AYXND.js";
 
 // src/intelligence-service.ts
-import { eq as eq44, desc as desc20, asc as asc9, and as and35, ne as ne6, or as or10, inArray as inArray15, gte as gte12, lte as lte8 } from "drizzle-orm";
+import { eq as eq44, desc as desc21, asc as asc9, and as and35, ne as ne6, or as or10, inArray as inArray15, gte as gte12, lte as lte8 } from "drizzle-orm";
 
 // ../db/src/client.ts
 import { mkdirSync } from "fs";
@@ -1455,6 +1470,8 @@ var researchRunQueries = sqliteTable("research_run_queries", {
   groundingSources: text("grounding_sources", { mode: "json" }).$type().notNull().default([]),
   citedDomains: text("cited_domains", { mode: "json" }).$type().notNull().default([]),
   searchQueries: text("search_queries", { mode: "json" }).$type().notNull().default([]),
+  namedCompetitors: text("named_competitors", { mode: "json" }).$type().notNull().default([]),
+  citedCompetitorDomains: text("cited_competitor_domains", { mode: "json" }).$type().notNull().default([]),
   answerMentioned: integer("answer_mentioned", { mode: "boolean" }),
   citationState: text("citation_state"),
   rawResponse: text("raw_response", { mode: "json" }).$type(),
@@ -4259,6 +4276,16 @@ var MIGRATION_VERSIONS = [
         updated_at                TEXT NOT NULL
       )`
     ]
+  },
+  {
+    // Keep research batches useful as a competitor-comparison workspace while
+    // retaining their strict isolation from tracked visibility snapshots.
+    version: 110,
+    name: "research-query-named-and-cited-competitors",
+    statements: [
+      `ALTER TABLE research_run_queries ADD COLUMN named_competitors TEXT NOT NULL DEFAULT '[]'`,
+      `ALTER TABLE research_run_queries ADD COLUMN cited_competitor_domains TEXT NOT NULL DEFAULT '[]'`
+    ]
   }
 ];
 function rebuildBacklinkTableWithSource(tx, table) {
@@ -17379,11 +17406,13 @@ var SCHEMA_TABLE = {
   AdsActivationGrantResponse: adsActivationGrantResponseSchema,
   AdsCampaignListResponse: adsCampaignListResponseSchema,
   AdsConnectionStatusDto: adsConnectionStatusDtoSchema,
+  AdsDeliveryDiagnosticsDto: adsDeliveryDiagnosticsDtoSchema,
   AdsConversionEventSettingListResponse: adsConversionEventSettingListResponseSchema,
   AdsConversionPixelListResponse: adsConversionPixelListResponseSchema,
   AdsDisconnectResponse: adsDisconnectResponseSchema,
   AdsGeoSearchResponse: adsGeoSearchResponseSchema,
   AdsInsightsResponse: adsInsightsResponseSchema,
+  AdsLiveDeliveryDto: adsLiveDeliveryDtoSchema,
   AdsOperationReconcileResponse: adsOperationReconcileResponseSchema,
   AdsOperationResponse: adsOperationResponseSchema,
   AdsSummaryDto: adsSummaryDtoSchema,
@@ -20375,6 +20404,47 @@ var routeCatalog = [
       404: errorResponse("Project not found.")
     }
   },
+  {
+    method: "get",
+    path: "/api/v1/projects/{name}/ads/delivery-diagnostics",
+    summary: "Stored ads snapshot provenance, configuration facts, and historical campaign activity",
+    description: "Read-only local evidence. It does not call OpenAI and never determines provider eligibility or serving.",
+    tags: ["ads"],
+    parameters: [nameParameter],
+    responses: {
+      200: jsonResponse("Stored diagnostics returned.", "AdsDeliveryDiagnosticsDto"),
+      404: errorResponse("Project not found.")
+    }
+  },
+  {
+    method: "get",
+    path: "/api/v1/projects/{name}/ads/live-delivery",
+    summary: "Live provider read of ads status and metrics, with the local snapshot delta",
+    description: "Calls the OpenAI Ads API right now with the stored connection and returns the provider's current status and metrics unaggregated, alongside the corresponding local snapshot values and an explicit per-entity delta. Dates on both sides are the ad account's local calendar dates. The first day of the window is measured from 00:00 in the account timezone on both sides, so it is a whole day either way and a difference on it is real; the current local day is in progress on both sides, so a difference there is snapshot staleness. Read-only: it never creates, updates, pauses, or activates anything, and it never waits for a sync run. The window counts calendar days in the account timezone, not fixed 24-hour periods, so a daylight-saving transition cannot move the first day. The walk is bounded by per-level caps and a budget of 40 reader calls (see bounds). Admission has two rules: a project may have only one live read running at a time (a second request is refused for as long as the first is actually walking, which can exceed any interval), and consecutive reads are spaced by at least one minute. The interval is counted as soon as the provider is called, so a read that fails upstream still holds it; only a read rejected before the provider was called leaves the next one free. A reader call is not one HTTP request: each list or insight read auto-paginates up to 100 pages, so the worst-case upstream cost of a single request is about 4000 HTTP requests, reported as bounds.maxUpstreamHttpRequests.",
+    tags: ["ads"],
+    parameters: [
+      nameParameter,
+      {
+        name: "campaignId",
+        in: "query",
+        description: "Scope the walk to a single campaign.",
+        schema: stringSchema
+      },
+      {
+        name: "lookbackDays",
+        in: "query",
+        description: "Metrics window in calendar days of the ad account timezone (1-30, default 7).",
+        schema: integerSchema
+      }
+    ],
+    responses: {
+      200: jsonResponse("Live provider state and snapshot delta returned.", "AdsLiveDeliveryDto"),
+      400: errorResponse("Invalid query, or no ads connection for this project."),
+      404: errorResponse("Project not found."),
+      429: errorResponse("Another live read for this project is still running, or the minimum interval since the last provider read has not elapsed. error.details.reason says which."),
+      502: errorResponse("The OpenAI Ads API read failed.")
+    }
+  },
   {
     method: "post",
     path: "/api/v1/projects/{name}/bing/connect",
@@ -26008,7 +26078,7 @@ async function googleRoutes(app, opts) {
 
 // ../api-routes/src/ads.ts
 import crypto22 from "crypto";
-import { eq as eq28, and as and22, asc as asc6, gt as gt2, gte as gte8, lt as lt3, lte as lte6, ne as ne3, inArray as inArray12, or as or8, isNull as isNull2, isNotNull as isNotNull2, sql as sql14 } from "drizzle-orm";
+import { eq as eq28, and as and22, asc as asc6, desc as desc13, gt as gt2, gte as gte8, lt as lt3, lte as lte6, ne as ne3, inArray as inArray12, or as or8, isNull as isNull2, isNotNull as isNotNull2, sql as sql14 } from "drizzle-orm";
 
 // ../api-routes/src/ads-activation-routes.ts
 import crypto21 from "crypto";
@@ -28445,7 +28515,256 @@ function registerAdsActivationRoutes(app, opts) {
   });
 }
 
+// ../api-routes/src/ads-live-delivery.ts
+function liveComparisonWindow(fetchedAtMs, lookbackDays, timezone) {
+  const fetchedAtIso = new Date(fetchedAtMs).toISOString();
+  return {
+    startDate: isoDateDaysBeforeInTimeZone(fetchedAtIso, lookbackDays, timezone),
+    endDate: formatIsoDateInTimeZone(fetchedAtIso, timezone)
+  };
+}
+var EMPTY_METRIC_VALUES = {
+  impressions: 0,
+  clicks: 0,
+  spendMicros: 0,
+  conversions: 0
+};
+function presenceOf(live, stored) {
+  if (live && stored) return AdsLivePresences.both;
+  if (live) return AdsLivePresences["live-only"];
+  return AdsLivePresences["stored-only"];
+}
+function fieldDelta(field, live, stored) {
+  return live === stored ? null : { field, live, stored };
+}
+function buildFieldDeltas(live, stored) {
+  if (!live || !stored) return [];
+  const deltas = [
+    fieldDelta("status", live.status, stored.status),
+    fieldDelta("reviewStatus", live.reviewStatus, stored.reviewStatus),
+    fieldDelta("name", live.name, stored.name)
+  ];
+  return deltas.filter((delta) => delta !== null);
+}
+function foldLiveRows(rows) {
+  let values = EMPTY_METRIC_VALUES;
+  for (const row of rows) {
+    values = {
+      impressions: values.impressions + Math.round(row.impressions ?? 0),
+      clicks: values.clicks + Math.round(row.clicks ?? 0),
+      spendMicros: values.spendMicros + dollarsToMicros(row.spend ?? 0),
+      conversions: values.conversions + Math.round(row.conversions ?? 0)
+    };
+  }
+  return values;
+}
+function sameMetrics(a, b) {
+  return a.impressions === b.impressions && a.clicks === b.clicks && a.spendMicros === b.spendMicros && a.conversions === b.conversions;
+}
+function buildMetricDeltas(liveRows, storedRows, window) {
+  if (liveRows === null && storedRows === null) return null;
+  const liveByDate = /* @__PURE__ */ new Map();
+  for (const row of liveRows ?? []) {
+    if (row.date === null) continue;
+    const bucket = liveByDate.get(row.date) ?? [];
+    bucket.push(row);
+    liveByDate.set(row.date, bucket);
+  }
+  const storedByDate = /* @__PURE__ */ new Map();
+  for (const row of storedRows ?? []) {
+    if (row.date < window.startDate || row.date > window.endDate) continue;
+    storedByDate.set(row.date, row);
+  }
+  const dates = [.../* @__PURE__ */ new Set([...liveByDate.keys(), ...storedByDate.keys()])].sort();
+  return dates.map((date) => {
+    const liveBucket = liveByDate.get(date);
+    const storedRow = storedByDate.get(date);
+    const live = liveBucket ? foldLiveRows(liveBucket) : null;
+    const stored = storedRow ? {
+      impressions: storedRow.impressions,
+      clicks: storedRow.clicks,
+      spendMicros: storedRow.spendMicros,
+      conversions: storedRow.conversions
+    } : null;
+    const drifted = live === null || stored === null || !sameMetrics(live, stored);
+    return { date, live, stored, drifted };
+  });
+}
+function buildLiveEntityComparison(observation, window) {
+  const presence = presenceOf(observation.live, observation.stored);
+  const fieldDeltas = buildFieldDeltas(observation.live, observation.stored);
+  const metricDeltas = buildMetricDeltas(observation.liveMetrics, observation.storedMetrics, window);
+  const drifted = presence !== AdsLivePresences.both || fieldDeltas.length > 0 || (metricDeltas?.some((delta) => delta.drifted) ?? false);
+  return {
+    entityType: observation.entityType,
+    id: observation.id,
+    parentId: observation.parentId,
+    presence,
+    live: observation.live,
+    stored: observation.stored,
+    fieldDeltas,
+    liveMetrics: observation.liveMetrics,
+    metricDeltas,
+    drifted
+  };
+}
+function summarizeLiveDrift(entities) {
+  let driftedEntities = 0;
+  let statusDrifted = 0;
+  let metricsDrifted = 0;
+  for (const entity of entities) {
+    if (entity.drifted) driftedEntities += 1;
+    if (entity.fieldDeltas.some((delta) => delta.field === "status")) statusDrifted += 1;
+    if (entity.metricDeltas?.some((delta) => delta.drifted)) metricsDrifted += 1;
+  }
+  return {
+    entitiesCompared: entities.length,
+    driftedEntities,
+    statusDrifted,
+    metricsDrifted
+  };
+}
+
 // ../api-routes/src/ads.ts
+function runSourceDto(row) {
+  const parsed = runStatusSchema.safeParse(row.status);
+  return parsed.success ? { runId: row.id, status: parsed.data } : null;
+}
+function storedSnapshotProvenance(input) {
+  if (!input.connected) {
+    return {
+      status: AdsDeliverySnapshotStatuses.unavailable,
+      issue: AdsDeliverySnapshotIssues.no_ads_connection,
+      sourceSync: null
+    };
+  }
+  if (input.connectionLastSyncedAt === null) {
+    return {
+      status: input.hasEntityRows ? AdsDeliverySnapshotStatuses.partial : AdsDeliverySnapshotStatuses.unavailable,
+      issue: AdsDeliverySnapshotIssues.connection_not_synced,
+      sourceSync: null
+    };
+  }
+  if (!input.hasEntityRows) {
+    if (!input.latestAdsSync) {
+      return {
+        status: AdsDeliverySnapshotStatuses.unavailable,
+        issue: AdsDeliverySnapshotIssues.no_ads_sync,
+        sourceSync: null
+      };
+    }
+    const sourceSync2 = runSourceDto(input.latestAdsSync);
+    if (!sourceSync2 || sourceSync2.status !== RunStatuses.completed) {
+      return {
+        status: AdsDeliverySnapshotStatuses.partial,
+        issue: AdsDeliverySnapshotIssues.source_sync_not_completed,
+        sourceSync: sourceSync2
+      };
+    }
+    return {
+      status: AdsDeliverySnapshotStatuses.complete,
+      issue: null,
+      sourceSync: sourceSync2
+    };
+  }
+  if (input.hasEntityWithoutSyncRunId) {
+    return {
+      status: AdsDeliverySnapshotStatuses.partial,
+      issue: AdsDeliverySnapshotIssues.entity_rows_missing_sync_run_id,
+      sourceSync: null
+    };
+  }
+  if (input.entitySyncRunIds.size !== 1) {
+    return {
+      status: AdsDeliverySnapshotStatuses.partial,
+      issue: AdsDeliverySnapshotIssues.entity_rows_span_multiple_sync_runs,
+      sourceSync: null
+    };
+  }
+  if (!input.sourceSync) {
+    return {
+      status: AdsDeliverySnapshotStatuses.partial,
+      issue: AdsDeliverySnapshotIssues.source_sync_missing,
+      sourceSync: null
+    };
+  }
+  const sourceSync = runSourceDto(input.sourceSync);
+  if (input.sourceSync.kind !== RunKinds["ads-sync"]) {
+    return {
+      status: AdsDeliverySnapshotStatuses.partial,
+      issue: AdsDeliverySnapshotIssues.source_sync_not_ads_sync,
+      sourceSync
+    };
+  }
+  if (!sourceSync || sourceSync.status !== RunStatuses.completed) {
+    return {
+      status: AdsDeliverySnapshotStatuses.partial,
+      issue: AdsDeliverySnapshotIssues.source_sync_not_completed,
+      sourceSync
+    };
+  }
+  return {
+    status: AdsDeliverySnapshotStatuses.complete,
+    issue: null,
+    sourceSync
+  };
+}
+function historicalCampaignRollups(rows) {
+  if (rows.length === 0) {
+    return {
+      status: AdsHistoricalCampaignRollupStatuses.unavailable,
+      window: { from: null, to: null },
+      totals: null
+    };
+  }
+  let impressions = 0;
+  let clicks = 0;
+  let spendMicros = 0;
+  let conversions = 0;
+  let fromDate = null;
+  let toDate = null;
+  for (const row of rows) {
+    impressions += row.impressions;
+    clicks += row.clicks;
+    spendMicros += row.spendMicros;
+    conversions += row.conversions;
+    if (fromDate === null || row.date < fromDate) fromDate = row.date;
+    if (toDate === null || row.date > toDate) toDate = row.date;
+  }
+  return {
+    status: AdsHistoricalCampaignRollupStatuses.reported,
+    window: { from: fromDate, to: toDate },
+    totals: {
+      impressions,
+      clicks,
+      spendMicros,
+      conversions,
+      ctr: adsCtr(clicks, impressions),
+      cpcMicros: adsCpcMicros(spendMicros, clicks)
+    }
+  };
+}
+function storedActivityAssessment(snapshotStatus, rollupStatus, rollupImpressions) {
+  switch (snapshotStatus) {
+    case AdsDeliverySnapshotStatuses.unavailable:
+      return AdsActivityAssessmentStates.unavailable;
+    case AdsDeliverySnapshotStatuses.partial:
+      return AdsActivityAssessmentStates.partial_snapshot;
+    case AdsDeliverySnapshotStatuses.complete:
+      switch (rollupStatus) {
+        case AdsHistoricalCampaignRollupStatuses.unavailable:
+          return AdsActivityAssessmentStates.metrics_unavailable;
+        case AdsHistoricalCampaignRollupStatuses.reported:
+          return (rollupImpressions ?? 0) > 0 ? AdsActivityAssessmentStates.observed_activity : AdsActivityAssessmentStates.no_observed_activity;
+      }
+  }
+}
+var ADS_LIVE_MAX_CAMPAIGNS = 5;
+var ADS_LIVE_MAX_AD_GROUPS_PER_CAMPAIGN = 10;
+var ADS_LIVE_MAX_ADS_PER_AD_GROUP = 20;
+var ADS_LIVE_MAX_READER_CALLS = 40;
+var DEFAULT_ADS_LIVE_MAX_PAGES_PER_READER_CALL = 100;
+var DEFAULT_ADS_LIVE_DELIVERY_MIN_INTERVAL_MS = 6e4;
 var DEFAULT_RECONCILE_SWEEP_INTERVAL_MS = 6e4;
 var DEFAULT_RECONCILE_PENDING_STALE_MS = 5 * 6e4;
 var DEFAULT_RECONCILE_BACKOFF_BASE_MS = 5 * 6e4;
@@ -28808,6 +29127,47 @@ async function executeAdsRead(surface, read) {
     });
   }
 }
+function resolveAdsLiveDeliveryReader(opts, projectName) {
+  const apiKey = opts.adsCredentialStore?.getConnection(projectName)?.apiKey;
+  if (!apiKey) {
+    throw validationError("No OpenAI Ads API key configured for this project");
+  }
+  if (!opts.adsLiveDeliveryReader) {
+    throw validationError("Ads live delivery reads are not configured for this deployment");
+  }
+  return { apiKey, reader: opts.adsLiveDeliveryReader };
+}
+function upstreamStatusOf(error) {
+  return typeof error === "object" && error !== null && "status" in error && typeof error.status === "number" && Number.isInteger(error.status) ? error.status : null;
+}
+function liveReadFailure(surface, entityId, error) {
+  return { surface, entityId, upstreamStatus: upstreamStatusOf(error) };
+}
+function liveReadProviderError(surface, error) {
+  const upstreamStatus = upstreamStatusOf(error);
+  return providerError(
+    `OpenAI Ads API ${surface} read failed`,
+    upstreamStatus === null ? void 0 : { upstreamStatus }
+  );
+}
+function liveEntityState(entity) {
+  return {
+    name: entity.name,
+    status: entity.status,
+    reviewStatus: entity.reviewStatus,
+    mode: entity.mode,
+    updatedAt: entity.updatedAt
+  };
+}
+function storedEntityState(row) {
+  return {
+    name: row.name,
+    status: row.status,
+    reviewStatus: row.reviewStatus ?? null,
+    upstreamUpdatedAt: row.upstreamUpdatedAt,
+    syncedAt: row.syncedAt
+  };
+}
 async function executeAdsOperation(app, request, input) {
   const hash = requestHash({ kind: input.kind, entityType: input.entityType, payload: input.payload });
   const existing = readOperationByKey(app, input.projectId, input.operationKey);
@@ -29446,6 +29806,21 @@ async function adsRoutes(app, opts) {
     opts.adsAccountVerificationCacheTtlMs ?? DEFAULT_ADS_ACCOUNT_VERIFICATION_CACHE_TTL_MS
   );
   const verificationCache = /* @__PURE__ */ new Map();
+  const liveDeliveryMinIntervalMs = Math.max(
+    0,
+    opts.adsLiveDeliveryMinIntervalMs ?? DEFAULT_ADS_LIVE_DELIVERY_MIN_INTERVAL_MS
+  );
+  const liveDeliveryMaxPagesPerReaderCall = Math.max(
+    1,
+    opts.adsLiveDeliveryMaxPagesPerReaderCall ?? DEFAULT_ADS_LIVE_MAX_PAGES_PER_READER_CALL
+  );
+  const liveDeliveryInFlight = /* @__PURE__ */ new Set();
+  const liveDeliveryLastAttemptAtMs = /* @__PURE__ */ new Map();
+  const pruneLiveDeliveryAttempts = (nowMs) => {
+    for (const [projectId, lastAtMs] of liveDeliveryLastAttemptAtMs) {
+      if (nowMs - lastAtMs >= liveDeliveryMinIntervalMs) liveDeliveryLastAttemptAtMs.delete(projectId);
+    }
+  };
   const reconcilePolicy = {
     pendingMinIdleMs: pendingStaleMs,
     backoffBaseMs,
@@ -29571,6 +29946,10 @@ async function adsRoutes(app, opts) {
             reviewStatus: account.reviewStatus,
             integrityReviewStatus: account.integrityReviewStatus,
             integrityDecision: account.integrityDecision,
+            // A credential rotation for the same account preserves its
+            // snapshot watermark. A different account invalidates all stored
+            // entity/insight provenance until the new binding is synced.
+            lastSyncedAt: existingRow.adAccountId === account.id ? existingRow.lastSyncedAt : null,
             updatedAt: now
           }).where(eq28(adsConnections.id, existingRow.id)).run();
         } else {
@@ -30126,6 +30505,359 @@ async function adsRoutes(app, opts) {
     const response = { rows: dtoRows, currencyCode: conn?.currencyCode ?? null };
     return response;
   });
+  app.get("/projects/:name/ads/delivery-diagnostics", async (request) => {
+    const project = resolveProject(app.db, request.params.name);
+    const connection = app.db.select().from(adsConnections).where(eq28(adsConnections.projectId, project.id)).get();
+    const campaignRows = app.db.select().from(adsCampaigns).where(eq28(adsCampaigns.projectId, project.id)).all();
+    const adGroupRows = app.db.select().from(adsAdGroups).where(eq28(adsAdGroups.projectId, project.id)).all();
+    const adRows = app.db.select().from(adsAds).where(eq28(adsAds.projectId, project.id)).all();
+    const entityRows = [...campaignRows, ...adGroupRows, ...adRows];
+    const hasEntityWithoutSyncRunId = entityRows.some((row) => row.syncRunId === null);
+    const entitySyncRunIds = new Set(entityRows.flatMap((row) => row.syncRunId === null ? [] : [row.syncRunId]));
+    const sourceSync = entitySyncRunIds.size === 1 ? app.db.select({ id: runs.id, kind: runs.kind, status: runs.status }).from(runs).where(and22(
+      eq28(runs.id, [...entitySyncRunIds][0]),
+      eq28(runs.projectId, project.id)
+    )).get() : void 0;
+    const latestAdsSync = app.db.select({ id: runs.id, kind: runs.kind, status: runs.status }).from(runs).where(and22(
+      eq28(runs.projectId, project.id),
+      eq28(runs.kind, RunKinds["ads-sync"])
+    )).orderBy(desc13(runs.createdAt)).get();
+    const snapshot = storedSnapshotProvenance({
+      connected: Boolean(connection),
+      connectionLastSyncedAt: connection?.lastSyncedAt ?? null,
+      hasEntityRows: entityRows.length > 0,
+      hasEntityWithoutSyncRunId,
+      entitySyncRunIds,
+      sourceSync,
+      latestAdsSync
+    });
+    const rollups = historicalCampaignRollups(app.db.select({
+      date: adsInsightsDaily.date,
+      impressions: adsInsightsDaily.impressions,
+      clicks: adsInsightsDaily.clicks,
+      spendMicros: adsInsightsDaily.spendMicros,
+      conversions: adsInsightsDaily.conversions
+    }).from(adsInsightsDaily).where(and22(
+      eq28(adsInsightsDaily.projectId, project.id),
+      eq28(adsInsightsDaily.level, AdsInsightLevels.campaign)
+    )).all());
+    const adsByGroup = /* @__PURE__ */ new Map();
+    for (const ad of adRows) {
+      const list = adsByGroup.get(ad.adGroupId) ?? [];
+      list.push({ id: ad.id, name: ad.name, status: ad.status, reviewStatus: ad.reviewStatus });
+      adsByGroup.set(ad.adGroupId, list);
+    }
+    const groupsByCampaign = /* @__PURE__ */ new Map();
+    for (const adGroup of adGroupRows) {
+      const list = groupsByCampaign.get(adGroup.campaignId) ?? [];
+      list.push({
+        id: adGroup.id,
+        name: adGroup.name,
+        status: adGroup.status,
+        billingEventType: adGroupBillingEventTypeDto(adGroup.billingEventType),
+        maxBidMicros: adGroup.maxBidMicros,
+        contextHints: adGroup.contextHints,
+        ads: adsByGroup.get(adGroup.id) ?? []
+      });
+      groupsByCampaign.set(adGroup.campaignId, list);
+    }
+    const response = {
+      snapshot: {
+        ...snapshot,
+        lastSyncedAt: connection?.lastSyncedAt ?? null,
+        campaignCount: campaignRows.length,
+        adGroupCount: adGroupRows.length,
+        adCount: adRows.length
+      },
+      historicalCampaignRollups: rollups,
+      storedConfiguration: {
+        basis: AdsDeliveryConfigurationBases.storedSnapshot,
+        connection: connection === void 0 ? null : {
+          status: connection.status,
+          reviewStatus: connection.reviewStatus,
+          integrityReviewStatus: connection.integrityReviewStatus,
+          integrityDecision: connection.integrityDecision,
+          conversionTrackingConfigured: connection.conversionTrackingConfigured
+        },
+        campaigns: campaignRows.map((campaign) => ({
+          id: campaign.id,
+          name: campaign.name,
+          status: campaign.status,
+          biddingType: campaignBiddingTypeDto(campaign.biddingType),
+          dailySpendLimitMicros: campaign.dailySpendLimitMicros,
+          lifetimeSpendLimitMicros: campaign.lifetimeSpendLimitMicros,
+          conversionEventSettingIds: campaign.conversionEventSettingIds,
+          adGroups: groupsByCampaign.get(campaign.id) ?? []
+        }))
+      },
+      assessment: {
+        state: storedActivityAssessment(
+          snapshot.status,
+          rollups.status,
+          rollups.totals === null ? null : rollups.totals.impressions
+        )
+      }
+    };
+    return response;
+  });
+  app.get("/projects/:name/ads/live-delivery", async (request) => {
+    const project = resolveProject(app.db, request.params.name);
+    const parsed = adsLiveDeliveryQuerySchema.safeParse(request.query);
+    if (!parsed.success) {
+      throw validationError("Invalid ads live delivery query", { issues: parsed.error.issues });
+    }
+    const { campaignId, lookbackDays } = parsed.data;
+    const connection = app.db.select().from(adsConnections).where(eq28(adsConnections.projectId, project.id)).get();
+    if (!connection) {
+      throw validationError('No ads connection for this project. Run "canonry ads connect" first.');
+    }
+    const { apiKey, reader } = resolveAdsLiveDeliveryReader(opts, project.name);
+    const verifyAdsAccount = opts.verifyAdsAccount;
+    if (!verifyAdsAccount) {
+      throw validationError("Ads account verification is not configured for this deployment");
+    }
+    const fetchedAtMs = Date.now();
+    const lastAttemptAtMs = liveDeliveryLastAttemptAtMs.get(project.id);
+    const remainingIntervalMs = liveDeliveryMinIntervalMs > 0 && lastAttemptAtMs !== void 0 ? lastAttemptAtMs + liveDeliveryMinIntervalMs - fetchedAtMs : 0;
+    if (liveDeliveryInFlight.has(project.id)) {
+      throw quotaExceeded("OpenAI Ads live delivery reads", {
+        reason: "read-in-flight",
+        minIntervalMs: liveDeliveryMinIntervalMs,
+        // A LOWER bound, and only when the interval itself still blocks. How
+        // much longer the running walk needs is unknowable from here, so once
+        // it has outlived the interval there is no honest number to give and
+        // the field is absent rather than guessed.
+        ...remainingIntervalMs > 0 ? { retryAfterMs: remainingIntervalMs } : {}
+      });
+    }
+    if (remainingIntervalMs > 0) {
+      throw quotaExceeded("OpenAI Ads live delivery reads", {
+        reason: "min-interval",
+        minIntervalMs: liveDeliveryMinIntervalMs,
+        retryAfterMs: remainingIntervalMs
+      });
+    }
+    liveDeliveryInFlight.add(project.id);
+    const spendLiveDeliveryAttempt = () => {
+      if (liveDeliveryMinIntervalMs <= 0) return;
+      pruneLiveDeliveryAttempts(fetchedAtMs);
+      liveDeliveryLastAttemptAtMs.set(project.id, fetchedAtMs);
+    };
+    try {
+      let readerCalls = 0;
+      let truncated = false;
+      const errors = [];
+      const callProvider = async (surface, entityId, run) => {
+        if (readerCalls >= ADS_LIVE_MAX_READER_CALLS) {
+          truncated = true;
+          return null;
+        }
+        readerCalls += 1;
+        try {
+          return await run();
+        } catch (error) {
+          errors.push(liveReadFailure(surface, entityId, error));
+          return null;
+        }
+      };
+      readerCalls += 1;
+      let account;
+      spendLiveDeliveryAttempt();
+      try {
+        account = await verifyAdsAccount(apiKey);
+      } catch (error) {
+        throw liveReadProviderError("account identity", error);
+      }
+      if (account.id !== connection.adAccountId) {
+        throw validationError("The configured key belongs to a different OpenAI ad account; reconnect this project");
+      }
+      readerCalls += 1;
+      let liveCampaigns;
+      try {
+        liveCampaigns = await reader.listCampaigns(apiKey);
+      } catch (error) {
+        throw liveReadProviderError("campaign list", error);
+      }
+      const scopedCampaigns = campaignId === void 0 ? liveCampaigns : liveCampaigns.filter((campaign) => campaign.id === campaignId);
+      if (scopedCampaigns.length > ADS_LIVE_MAX_CAMPAIGNS) truncated = true;
+      const walkedCampaigns = scopedCampaigns.slice(0, ADS_LIVE_MAX_CAMPAIGNS);
+      const storedCampaignRows = app.db.select().from(adsCampaigns).where(and22(
+        eq28(adsCampaigns.projectId, project.id),
+        campaignId === void 0 ? void 0 : eq28(adsCampaigns.id, campaignId)
+      )).all();
+      const storedAdGroupRows = app.db.select().from(adsAdGroups).where(and22(
+        eq28(adsAdGroups.projectId, project.id),
+        campaignId === void 0 ? void 0 : eq28(adsAdGroups.campaignId, campaignId)
+      )).all();
+      const storedAdGroupIds = new Set(storedAdGroupRows.map((row) => row.id));
+      const storedAdRows = app.db.select().from(adsAds).where(eq28(adsAds.projectId, project.id)).all().filter((row) => campaignId === void 0 || storedAdGroupIds.has(row.adGroupId));
+      const storedInsightRows = app.db.select({
+        level: adsInsightsDaily.level,
+        entityId: adsInsightsDaily.entityId,
+        date: adsInsightsDaily.date,
+        impressions: adsInsightsDaily.impressions,
+        clicks: adsInsightsDaily.clicks,
+        spendMicros: adsInsightsDaily.spendMicros,
+        conversions: adsInsightsDaily.conversions
+      }).from(adsInsightsDaily).where(eq28(adsInsightsDaily.projectId, project.id)).all();
+      const storedCampaignById = new Map(storedCampaignRows.map((row) => [row.id, row]));
+      const storedAdGroupById = new Map(storedAdGroupRows.map((row) => [row.id, row]));
+      const storedAdById = new Map(storedAdRows.map((row) => [row.id, row]));
+      const storedMetricsByEntity = /* @__PURE__ */ new Map();
+      for (const row of storedInsightRows) {
+        const key = `${row.level}:${row.entityId}`;
+        const bucket = storedMetricsByEntity.get(key) ?? [];
+        bucket.push({
+          date: row.date,
+          impressions: row.impressions,
+          clicks: row.clicks,
+          spendMicros: row.spendMicros,
+          conversions: row.conversions
+        });
+        storedMetricsByEntity.set(key, bucket);
+      }
+      const storedMetricsFor = (level, entityId) => storedMetricsByEntity.get(`${level}:${entityId}`) ?? [];
+      const accountTimezone = account.timezone ?? "UTC";
+      const window = liveComparisonWindow(fetchedAtMs, lookbackDays, accountTimezone);
+      const insightsRequest = {
+        startDate: window.startDate,
+        fetchedAtMs,
+        timezone: accountTimezone
+      };
+      const observations = [];
+      const walkedCampaignIds = /* @__PURE__ */ new Set();
+      const walkedAdGroupIds = /* @__PURE__ */ new Set();
+      const walkedAdIds = /* @__PURE__ */ new Set();
+      for (const campaign of walkedCampaigns) {
+        walkedCampaignIds.add(campaign.id);
+        const campaignMetrics = await callProvider(
+          "campaign insights",
+          campaign.id,
+          () => reader.campaignInsights(apiKey, campaign.id, insightsRequest)
+        );
+        observations.push({
+          entityType: AdsLiveEntityTypes.campaign,
+          id: campaign.id,
+          parentId: null,
+          live: liveEntityState(campaign),
+          stored: storedCampaignById.has(campaign.id) ? storedEntityState(storedCampaignById.get(campaign.id)) : null,
+          // A metrics call that did not happen is not evidence about metrics, so
+          // both sides stay null and no delta is claimed.
+          liveMetrics: campaignMetrics,
+          storedMetrics: campaignMetrics === null ? null : storedMetricsFor(AdsInsightLevels.campaign, campaign.id)
+        });
+        const liveAdGroups = await callProvider(
+          "ad group list",
+          campaign.id,
+          () => reader.listAdGroups(apiKey, campaign.id)
+        );
+        if (liveAdGroups === null) continue;
+        if (liveAdGroups.length > ADS_LIVE_MAX_AD_GROUPS_PER_CAMPAIGN) truncated = true;
+        for (const adGroup of liveAdGroups.slice(0, ADS_LIVE_MAX_AD_GROUPS_PER_CAMPAIGN)) {
+          walkedAdGroupIds.add(adGroup.id);
+          const adGroupMetrics = await callProvider(
+            "ad group insights",
+            adGroup.id,
+            () => reader.adGroupInsights(apiKey, adGroup.id, insightsRequest)
+          );
+          observations.push({
+            entityType: AdsLiveEntityTypes.ad_group,
+            id: adGroup.id,
+            parentId: campaign.id,
+            live: liveEntityState(adGroup),
+            stored: storedAdGroupById.has(adGroup.id) ? storedEntityState(storedAdGroupById.get(adGroup.id)) : null,
+            liveMetrics: adGroupMetrics,
+            storedMetrics: adGroupMetrics === null ? null : storedMetricsFor(AdsInsightLevels.ad_group, adGroup.id)
+          });
+          const liveAds = await callProvider(
+            "ad list",
+            adGroup.id,
+            () => reader.listAds(apiKey, adGroup.id)
+          );
+          if (liveAds === null) continue;
+          if (liveAds.length > ADS_LIVE_MAX_ADS_PER_AD_GROUP) truncated = true;
+          for (const ad of liveAds.slice(0, ADS_LIVE_MAX_ADS_PER_AD_GROUP)) {
+            walkedAdIds.add(ad.id);
+            observations.push({
+              entityType: AdsLiveEntityTypes.ad,
+              id: ad.id,
+              parentId: adGroup.id,
+              live: liveEntityState(ad),
+              stored: storedAdById.has(ad.id) ? storedEntityState(storedAdById.get(ad.id)) : null,
+              // The provider has no per-ad insights surface (same reason ads-sync
+              // stores no ad-level rollups), so ads carry status evidence only.
+              liveMetrics: null,
+              storedMetrics: null
+            });
+          }
+        }
+      }
+      if (!truncated && errors.length === 0) {
+        for (const row of storedCampaignRows) {
+          if (walkedCampaignIds.has(row.id)) continue;
+          observations.push({
+            entityType: AdsLiveEntityTypes.campaign,
+            id: row.id,
+            parentId: null,
+            live: null,
+            stored: storedEntityState(row),
+            liveMetrics: null,
+            storedMetrics: null
+          });
+        }
+        for (const row of storedAdGroupRows) {
+          if (walkedAdGroupIds.has(row.id)) continue;
+          observations.push({
+            entityType: AdsLiveEntityTypes.ad_group,
+            id: row.id,
+            parentId: row.campaignId,
+            live: null,
+            stored: storedEntityState(row),
+            liveMetrics: null,
+            storedMetrics: null
+          });
+        }
+        for (const row of storedAdRows) {
+          if (walkedAdIds.has(row.id)) continue;
+          observations.push({
+            entityType: AdsLiveEntityTypes.ad,
+            id: row.id,
+            parentId: row.adGroupId,
+            live: null,
+            stored: storedEntityState(row),
+            liveMetrics: null,
+            storedMetrics: null
+          });
+        }
+      }
+      const entities = observations.map(
+        (observation) => buildLiveEntityComparison(observation, window)
+      );
+      const response = {
+        basis: AdsLiveDeliveryBases.liveProviderRead,
+        fetchedAt: new Date(fetchedAtMs).toISOString(),
+        adAccountId: account.id,
+        storedSnapshotSyncedAt: connection.lastSyncedAt ?? null,
+        metricsWindow: { lookbackDays },
+        bounds: {
+          maxCampaigns: ADS_LIVE_MAX_CAMPAIGNS,
+          maxAdGroupsPerCampaign: ADS_LIVE_MAX_AD_GROUPS_PER_CAMPAIGN,
+          maxAdsPerAdGroup: ADS_LIVE_MAX_ADS_PER_AD_GROUP,
+          maxReaderCalls: ADS_LIVE_MAX_READER_CALLS,
+          readerCalls,
+          maxPagesPerReaderCall: liveDeliveryMaxPagesPerReaderCall,
+          maxUpstreamHttpRequests: ADS_LIVE_MAX_READER_CALLS * liveDeliveryMaxPagesPerReaderCall,
+          truncated
+        },
+        entities,
+        drift: summarizeLiveDrift(entities),
+        errors
+      };
+      return response;
+    } finally {
+      liveDeliveryInFlight.delete(project.id);
+    }
+  });
   app.get("/projects/:name/ads/summary", async (request) => {
     const project = resolveProject(app.db, request.params.name);
     const row = app.db.select().from(adsConnections).where(eq28(adsConnections.projectId, project.id)).get();
@@ -30174,7 +30906,7 @@ async function adsRoutes(app, opts) {
 
 // ../api-routes/src/bing.ts
 import crypto23 from "crypto";
-import { eq as eq29, and as and23, desc as desc13 } from "drizzle-orm";
+import { eq as eq29, and as and23, desc as desc14 } from "drizzle-orm";
 
 // ../integration-bing/src/constants.ts
 var BING_WMT_API_BASE = "https://ssl.bing.com/webmaster/api.svc/json";
@@ -30548,7 +31280,7 @@ async function bingRoutes(app, opts) {
     const store = requireConnectionStore();
     const project = resolveProject(app.db, request.params.name);
     requireConnection(store, project.canonicalDomain);
-    const allInspections = app.db.select().from(bingUrlInspections).where(eq29(bingUrlInspections.projectId, project.id)).orderBy(desc13(bingUrlInspections.inspectedAt)).all();
+    const allInspections = app.db.select().from(bingUrlInspections).where(eq29(bingUrlInspections.projectId, project.id)).orderBy(desc14(bingUrlInspections.inspectedAt)).all();
     const latestByUrl = /* @__PURE__ */ new Map();
     const definitiveByUrl = /* @__PURE__ */ new Map();
     for (const row of allInspections) {
@@ -30637,7 +31369,7 @@ async function bingRoutes(app, opts) {
     const project = resolveProject(app.db, request.params.name);
     const parsed = parseInt(request.query.limit ?? "90", 10);
     const limit = Number.isNaN(parsed) || parsed <= 0 ? 90 : parsed;
-    const rows = app.db.select().from(bingCoverageSnapshots).where(eq29(bingCoverageSnapshots.projectId, project.id)).orderBy(desc13(bingCoverageSnapshots.date)).limit(limit).all();
+    const rows = app.db.select().from(bingCoverageSnapshots).where(eq29(bingCoverageSnapshots.projectId, project.id)).orderBy(desc14(bingCoverageSnapshots.date)).limit(limit).all();
     return rows.map((r) => ({
       date: r.date,
       indexed: r.indexed,
@@ -30650,7 +31382,7 @@ async function bingRoutes(app, opts) {
     const project = resolveProject(app.db, request.params.name);
     const { url, limit } = request.query;
     const whereClause = url ? and23(eq29(bingUrlInspections.projectId, project.id), eq29(bingUrlInspections.url, url)) : eq29(bingUrlInspections.projectId, project.id);
-    const filtered = app.db.select().from(bingUrlInspections).where(whereClause).orderBy(desc13(bingUrlInspections.inspectedAt)).limit(Math.max(1, Math.min(parseInt(limit ?? "100", 10) || 100, 1e3))).all();
+    const filtered = app.db.select().from(bingUrlInspections).where(whereClause).orderBy(desc14(bingUrlInspections.inspectedAt)).limit(Math.max(1, Math.min(parseInt(limit ?? "100", 10) || 100, 1e3))).all();
     return filtered.map((r) => ({
       id: r.id,
       url: r.url,
@@ -30794,7 +31526,7 @@ async function bingRoutes(app, opts) {
     }
     let urlsToSubmit = request.body?.urls ?? [];
     if (request.body?.allUnindexed) {
-      const allInspections = app.db.select().from(bingUrlInspections).where(eq29(bingUrlInspections.projectId, project.id)).orderBy(desc13(bingUrlInspections.inspectedAt)).all();
+      const allInspections = app.db.select().from(bingUrlInspections).where(eq29(bingUrlInspections.projectId, project.id)).orderBy(desc14(bingUrlInspections.inspectedAt)).all();
       const latestByUrl = /* @__PURE__ */ new Map();
       for (const row of allInspections) {
         if (!latestByUrl.has(row.url)) {
@@ -31053,7 +31785,7 @@ async function cdpRoutes(app, opts) {
 
 // ../api-routes/src/ga.ts
 import crypto24 from "crypto";
-import { eq as eq31, desc as desc14, and as and25, sql as sql15 } from "drizzle-orm";
+import { eq as eq31, desc as desc15, and as and25, sql as sql15 } from "drizzle-orm";
 
 // ../api-routes/src/ga-session-history.ts
 function buildSessionHistory(landingPageDays, dailyTotals) {
@@ -31500,7 +32232,7 @@ async function ga4Routes(app, opts) {
     if (!connected) {
       return { connected: false, propertyId: null, clientEmail: null, authMethod: null, lastSyncedAt: null };
     }
-    const latestSync = app.db.select({ syncedAt: gaTrafficSummaries.syncedAt }).from(gaTrafficSummaries).where(eq31(gaTrafficSummaries.projectId, project.id)).orderBy(desc14(gaTrafficSummaries.syncedAt)).limit(1).get();
+    const latestSync = app.db.select({ syncedAt: gaTrafficSummaries.syncedAt }).from(gaTrafficSummaries).where(eq31(gaTrafficSummaries.projectId, project.id)).orderBy(desc15(gaTrafficSummaries.syncedAt)).limit(1).get();
     return {
       connected: true,
       propertyId: saConn?.propertyId ?? oauthConn?.propertyId ?? null,
@@ -31906,7 +32638,7 @@ async function ga4Routes(app, opts) {
       sessions: sql15`SUM(${gaSocialReferrals.sessions})`,
       users: sql15`SUM(${gaSocialReferrals.users})`
     }).from(gaSocialReferrals).where(and25(...socialConditions)).get();
-    const latestSync = app.db.select({ syncedAt: gaTrafficSummaries.syncedAt }).from(gaTrafficSummaries).where(eq31(gaTrafficSummaries.projectId, project.id)).orderBy(desc14(gaTrafficSummaries.syncedAt)).limit(1).get();
+    const latestSync = app.db.select({ syncedAt: gaTrafficSummaries.syncedAt }).from(gaTrafficSummaries).where(eq31(gaTrafficSummaries.projectId, project.id)).orderBy(desc15(gaTrafficSummaries.syncedAt)).limit(1).get();
     const total = summaryRow?.totalSessions ?? 0;
     const totalDirectSessions = directTotalRow?.totalDirectSessions ?? 0;
     const totalOrganicSessions = summaryRow?.totalOrganicSessions ?? 0;
@@ -33851,7 +34583,7 @@ async function wordpressRoutes(app, opts) {
 
 // ../api-routes/src/backlinks.ts
 import crypto26 from "crypto";
-import { and as and27, asc as asc7, desc as desc15, eq as eq32, sql as sql16 } from "drizzle-orm";
+import { and as and27, asc as asc7, desc as desc16, eq as eq32, sql as sql16 } from "drizzle-orm";
 
 // ../integration-commoncrawl/src/constants.ts
 import os2 from "os";
@@ -34352,7 +35084,7 @@ function latestSummaryForProject(db, projectId, source, release) {
     eq32(backlinkSummaries.source, source)
   ];
   if (release) conditions.push(eq32(backlinkSummaries.release, release));
-  return db.select().from(backlinkSummaries).where(and27(...conditions)).orderBy(desc15(backlinkSummaries.queriedAt)).limit(1).get();
+  return db.select().from(backlinkSummaries).where(and27(...conditions)).orderBy(desc16(backlinkSummaries.queriedAt)).limit(1).get();
 }
 function parseExcludeCrawlers(value) {
   if (!value) return false;
@@ -34374,7 +35106,7 @@ function computeFilteredSummary(db, base) {
     count: sql16`count(*)`,
     total: sql16`coalesce(sum(${backlinkDomains.numHosts}), 0)`
   }).from(backlinkDomains).where(filteredCondition).get();
-  const top10Rows = db.select({ numHosts: backlinkDomains.numHosts }).from(backlinkDomains).where(filteredCondition).orderBy(desc15(backlinkDomains.numHosts)).limit(10).all();
+  const top10Rows = db.select({ numHosts: backlinkDomains.numHosts }).from(backlinkDomains).where(filteredCondition).orderBy(desc16(backlinkDomains.numHosts)).limit(10).all();
   const totalLinkingDomains = Number(filteredAgg?.count ?? 0);
   const totalHosts = Number(filteredAgg?.total ?? 0);
   const unfilteredLinkingDomains = Number(unfilteredAgg?.count ?? 0);
@@ -34395,7 +35127,7 @@ function computeFilteredSummary(db, base) {
   };
 }
 function buildSourceAvailability(db, projectId, source, connected, excludeCrawlers) {
-  const summary = db.select().from(backlinkSummaries).where(and27(eq32(backlinkSummaries.projectId, projectId), eq32(backlinkSummaries.source, source))).orderBy(desc15(backlinkSummaries.queriedAt)).limit(1).get();
+  const summary = db.select().from(backlinkSummaries).where(and27(eq32(backlinkSummaries.projectId, projectId), eq32(backlinkSummaries.source, source))).orderBy(desc16(backlinkSummaries.queriedAt)).limit(1).get();
   let totalLinkingDomains = summary?.totalLinkingDomains ?? 0;
   if (summary && excludeCrawlers) {
     const filtered = db.select({ count: sql16`count(*)` }).from(backlinkDomains).where(and27(
@@ -34501,11 +35233,11 @@ async function backlinksRoutes(app, opts) {
     return reply.status(201).send(mapSyncRow(inserted));
   });
   app.get("/backlinks/syncs/latest", async (_request, reply) => {
-    const row = app.db.select().from(ccReleaseSyncs).orderBy(desc15(ccReleaseSyncs.updatedAt)).limit(1).get();
+    const row = app.db.select().from(ccReleaseSyncs).orderBy(desc16(ccReleaseSyncs.updatedAt)).limit(1).get();
     return reply.send(row ? mapSyncRow(row) : null);
   });
   app.get("/backlinks/syncs", async (_request, reply) => {
-    const rows = app.db.select().from(ccReleaseSyncs).orderBy(desc15(ccReleaseSyncs.updatedAt)).all();
+    const rows = app.db.select().from(ccReleaseSyncs).orderBy(desc16(ccReleaseSyncs.updatedAt)).all();
     return reply.send(rows.map(mapSyncRow));
   });
   app.get("/backlinks/releases", async (_request, reply) => {
@@ -34592,7 +35324,7 @@ async function backlinksRoutes(app, opts) {
       linkingDomain: backlinkDomains.linkingDomain,
       numHosts: backlinkDomains.numHosts,
       source: backlinkDomains.source
-    }).from(backlinkDomains).where(domainCondition).orderBy(desc15(backlinkDomains.numHosts)).limit(limit).offset(offset).all();
+    }).from(backlinkDomains).where(domainCondition).orderBy(desc16(backlinkDomains.numHosts)).limit(limit).offset(offset).all();
     let summary = null;
     if (summaryRow) {
       summary = excludeCrawlers ? computeFilteredSummary(app.db, summaryRow) : mapSummaryRow(summaryRow);
@@ -34666,7 +35398,7 @@ async function backlinksRoutes(app, opts) {
 // ../api-routes/src/traffic.ts
 import crypto28 from "crypto";
 import { Agent as UndiciAgent } from "undici";
-import { and as and28, desc as desc16, eq as eq33, gte as gte9, lte as lte7, sql as sql17 } from "drizzle-orm";
+import { and as and28, desc as desc17, eq as eq33, gte as gte9, lte as lte7, sql as sql17 } from "drizzle-orm";
 
 // ../integration-cloud-run/src/auth.ts
 import crypto27 from "crypto";
@@ -39768,7 +40500,7 @@ async function trafficRoutes(app, opts) {
         eq33(runs.kind, RunKinds["traffic-sync"]),
         eq33(runs.sourceId, row.id)
       )
-    ).orderBy(desc16(runs.startedAt)).limit(1).get();
+    ).orderBy(desc17(runs.startedAt)).limit(1).get();
     return {
       ...rowToDto(row),
       totals24h: {
@@ -39828,14 +40560,14 @@ async function trafficRoutes(app, opts) {
   });
   app.get("/projects/:name/traffic/sources", async (request) => {
     const project = resolveProject(app.db, request.params.name);
-    const rows = app.db.select().from(trafficSources).where(eq33(trafficSources.projectId, project.id)).orderBy(desc16(trafficSources.createdAt)).all();
+    const rows = app.db.select().from(trafficSources).where(eq33(trafficSources.projectId, project.id)).orderBy(desc17(trafficSources.createdAt)).all();
     const sources = rows.filter((row) => row.status !== TrafficSourceStatuses.archived).map(rowToDto);
     const response = { sources };
     return response;
   });
   app.get("/projects/:name/traffic/status", async (request) => {
     const project = resolveProject(app.db, request.params.name);
-    const rows = app.db.select().from(trafficSources).where(eq33(trafficSources.projectId, project.id)).orderBy(desc16(trafficSources.createdAt)).all();
+    const rows = app.db.select().from(trafficSources).where(eq33(trafficSources.projectId, project.id)).orderBy(desc17(trafficSources.createdAt)).all();
     const since = new Date(Date.now() - 24 * 60 * 6e4).toISOString();
     const sources = rows.filter((row) => row.status !== TrafficSourceStatuses.archived).map((row) => buildSourceDetail(project.id, row, since));
     const response = { sources };
@@ -39934,7 +40666,7 @@ async function trafficRoutes(app, opts) {
       for (const row of crawlerSeries) {
         trafficSeriesPoint(seriesByBucket, row.bucket).crawlerHits = Number(row.hits);
       }
-      const rows = app.db.select().from(crawlerEventsHourly).where(crawlerWhere).orderBy(desc16(crawlerEventsHourly.tsHour)).limit(limit).all();
+      const rows = app.db.select().from(crawlerEventsHourly).where(crawlerWhere).orderBy(desc17(crawlerEventsHourly.tsHour)).limit(limit).all();
       for (const r of rows) {
         events.push({
           kind: TrafficEventKinds.crawler,
@@ -39972,7 +40704,7 @@ async function trafficRoutes(app, opts) {
       for (const row of userFetchSeries) {
         trafficSeriesPoint(seriesByBucket, row.bucket).aiUserFetchHits = Number(row.hits);
       }
-      const rows = app.db.select().from(aiUserFetchEventsHourly).where(userFetchWhere).orderBy(desc16(aiUserFetchEventsHourly.tsHour)).limit(limit).all();
+      const rows = app.db.select().from(aiUserFetchEventsHourly).where(userFetchWhere).orderBy(desc17(aiUserFetchEventsHourly.tsHour)).limit(limit).all();
       for (const r of rows) {
         events.push({
           kind: TrafficEventKinds["ai-user-fetch"],
@@ -40015,7 +40747,7 @@ async function trafficRoutes(app, opts) {
       for (const row of referralSeries) {
         trafficSeriesPoint(seriesByBucket, row.bucket).aiReferralHits = Number(row.hits);
       }
-      const rows = app.db.select().from(aiReferralEventsHourly).where(aiWhere).orderBy(desc16(aiReferralEventsHourly.tsHour)).limit(limit).all();
+      const rows = app.db.select().from(aiReferralEventsHourly).where(aiWhere).orderBy(desc17(aiReferralEventsHourly.tsHour)).limit(limit).all();
       for (const r of rows) {
         const counts2 = aiReferralClassCounts(r.sessionsOrHits, r.paidSessionsOrHits, r.organicSessionsOrHits);
         events.push({
@@ -42251,7 +42983,7 @@ async function doctorRoutes(app, opts) {
 
 // ../api-routes/src/discovery/routes.ts
 import crypto30 from "crypto";
-import { and as and32, desc as desc17, eq as eq40, gte as gte11, inArray as inArray13, isNull as isNull3, or as or9 } from "drizzle-orm";
+import { and as and32, desc as desc18, eq as eq40, gte as gte11, inArray as inArray13, isNull as isNull3, or as or9 } 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) => {
@@ -42312,7 +43044,7 @@ async function discoveryRoutes(app, opts) {
           DiscoverySessionStatuses.probing
         ]),
         gte11(discoverySessions.createdAt, ageFloorIso)
-      )).orderBy(desc17(discoverySessions.createdAt)).get();
+      )).orderBy(desc18(discoverySessions.createdAt)).get();
       if (existing && existing.runId) {
         return { reused: true, sessionId: existing.id, runId: existing.runId };
       }
@@ -42381,7 +43113,7 @@ async function discoveryRoutes(app, opts) {
       const project = resolveProject(app.db, request.params.name);
       const parsedLimit = parseInt(request.query.limit ?? "", 10);
       const limit = Number.isNaN(parsedLimit) || parsedLimit <= 0 ? 50 : parsedLimit;
-      const rows = app.db.select().from(discoverySessions).where(eq40(discoverySessions.projectId, project.id)).orderBy(desc17(discoverySessions.createdAt)).limit(limit).all();
+      const rows = app.db.select().from(discoverySessions).where(eq40(discoverySessions.projectId, project.id)).orderBy(desc18(discoverySessions.createdAt)).limit(limit).all();
       return reply.send(rows.map(serializeSession));
     }
   );
@@ -42931,7 +43663,7 @@ function dedupeStrings(input) {
 
 // ../api-routes/src/technical-aeo.ts
 import crypto32 from "crypto";
-import { and as and33, asc as asc8, count, desc as desc18, eq as eq42, inArray as inArray14, lt as lt4 } from "drizzle-orm";
+import { and as and33, asc as asc8, count, desc as desc19, eq as eq42, inArray as inArray14, lt as lt4 } from "drizzle-orm";
 var SURFACEABLE_STATUSES = [RunStatuses.completed, RunStatuses.partial];
 function emptyScore(projectName) {
   return {
@@ -42970,13 +43702,13 @@ async function technicalAeoRoutes(app, opts) {
       notProbeRun()
     ];
     const targetFilters = request.query.runId ? [...baseFilters, eq42(siteAuditSnapshots.runId, request.query.runId)] : baseFilters;
-    const latest = app.db.select({ snap: siteAuditSnapshots, runStatus: runs.status }).from(siteAuditSnapshots).innerJoin(runs, eq42(siteAuditSnapshots.runId, runs.id)).where(and33(...targetFilters)).orderBy(desc18(siteAuditSnapshots.createdAt)).limit(1).get();
+    const latest = app.db.select({ snap: siteAuditSnapshots, runStatus: runs.status }).from(siteAuditSnapshots).innerJoin(runs, eq42(siteAuditSnapshots.runId, runs.id)).where(and33(...targetFilters)).orderBy(desc19(siteAuditSnapshots.createdAt)).limit(1).get();
     if (!latest) {
       if (request.query.runId) throw notFound("Site audit run", request.query.runId);
       return emptyScore(project.name);
     }
     const snap = latest.snap;
-    const previous = app.db.select({ snap: siteAuditSnapshots }).from(siteAuditSnapshots).innerJoin(runs, eq42(siteAuditSnapshots.runId, runs.id)).where(and33(...baseFilters, lt4(siteAuditSnapshots.createdAt, snap.createdAt))).orderBy(desc18(siteAuditSnapshots.createdAt)).limit(1).get()?.snap ?? null;
+    const previous = app.db.select({ snap: siteAuditSnapshots }).from(siteAuditSnapshots).innerJoin(runs, eq42(siteAuditSnapshots.runId, runs.id)).where(and33(...baseFilters, lt4(siteAuditSnapshots.createdAt, snap.createdAt))).orderBy(desc19(siteAuditSnapshots.createdAt)).limit(1).get()?.snap ?? null;
     const deltaScore = previous ? snap.aggregateScore - previous.aggregateScore : null;
     const trend = deltaScore == null ? null : deltaScore > 0 ? SiteAuditTrendDirections.up : deltaScore < 0 ? SiteAuditTrendDirections.down : SiteAuditTrendDirections.flat;
     return {
@@ -43009,7 +43741,7 @@ async function technicalAeoRoutes(app, opts) {
       notProbeRun()
     ];
     if (request.query.runId) targetFilters.push(eq42(siteAuditSnapshots.runId, request.query.runId));
-    const latest = app.db.select({ runId: siteAuditSnapshots.runId, auditedAt: siteAuditSnapshots.auditedAt }).from(siteAuditSnapshots).innerJoin(runs, eq42(siteAuditSnapshots.runId, runs.id)).where(and33(...targetFilters)).orderBy(desc18(siteAuditSnapshots.createdAt)).limit(1).get();
+    const latest = app.db.select({ runId: siteAuditSnapshots.runId, auditedAt: siteAuditSnapshots.auditedAt }).from(siteAuditSnapshots).innerJoin(runs, eq42(siteAuditSnapshots.runId, runs.id)).where(and33(...targetFilters)).orderBy(desc19(siteAuditSnapshots.createdAt)).limit(1).get();
     if (!latest && request.query.runId) {
       throw notFound("Site audit run", request.query.runId);
     }
@@ -43024,7 +43756,7 @@ async function technicalAeoRoutes(app, opts) {
     const total = totalRow?.value ?? 0;
     const limit = parsePositiveInt(request.query.limit, 100, 500);
     const offset = parsePositiveInt(request.query.offset, 0, Number.MAX_SAFE_INTEGER);
-    const orderBy = request.query.sort === "score-desc" ? desc18(siteAuditPages.overallScore) : request.query.sort === "url" ? asc8(siteAuditPages.url) : asc8(siteAuditPages.overallScore);
+    const orderBy = request.query.sort === "score-desc" ? desc19(siteAuditPages.overallScore) : request.query.sort === "url" ? asc8(siteAuditPages.url) : asc8(siteAuditPages.overallScore);
     const rows = app.db.select().from(siteAuditPages).where(where).orderBy(orderBy).limit(limit).offset(offset).all();
     const pages = rows.map((row) => ({
       url: row.url,
@@ -43048,7 +43780,7 @@ async function technicalAeoRoutes(app, opts) {
       eq42(runs.kind, RunKinds["site-audit"]),
       inArray14(runs.status, SURFACEABLE_STATUSES),
       notProbeRun()
-    )).orderBy(desc18(siteAuditSnapshots.createdAt)).limit(limit).all();
+    )).orderBy(desc19(siteAuditSnapshots.createdAt)).limit(limit).all();
     return { project: project.name, points: rows.reverse() };
   });
   app.post("/projects/:name/technical-aeo/runs", async (request) => {
@@ -43085,7 +43817,7 @@ async function technicalAeoRoutes(app, opts) {
 
 // ../api-routes/src/research.ts
 import crypto33 from "crypto";
-import { and as and34, desc as desc19, eq as eq43 } from "drizzle-orm";
+import { and as and34, desc as desc20, eq as eq43 } from "drizzle-orm";
 var sameLocation = (a, b) => a.label === b.label && a.city === b.city && a.region === b.region && a.country === b.country && a.timezone === b.timezone;
 async function researchRoutes(app, opts) {
   app.post("/projects/:name/research/runs", async (request, reply) => {
@@ -43136,7 +43868,7 @@ async function researchRoutes(app, opts) {
     const project = resolveProject(app.db, request.params.name);
     const requested = Number.parseInt(request.query.limit ?? "", 10);
     const limit = Number.isInteger(requested) && requested > 0 ? Math.min(requested, 100) : 20;
-    const runs2 = app.db.select().from(researchRuns).where(eq43(researchRuns.projectId, project.id)).orderBy(desc19(researchRuns.createdAt)).limit(limit).all().map(serializeRun);
+    const runs2 = app.db.select().from(researchRuns).where(eq43(researchRuns.projectId, project.id)).orderBy(desc20(researchRuns.createdAt)).limit(limit).all().map(serializeRun);
     return { runs: runs2 };
   });
   app.get("/projects/:name/research/runs/:runId", async (request) => {
@@ -43154,7 +43886,7 @@ function serializeRun(row) {
   return { id: row.id, projectId: row.projectId, status: row.status, provider: row.provider, requestedModel: row.requestedModel, resolvedModel: row.resolvedModel, location: row.location ?? null, totalQueries: row.totalQueries, completedQueries: row.completedQueries, failedQueries: row.failedQueries, error: row.error, startedAt: row.startedAt, finishedAt: row.finishedAt, createdAt: row.createdAt };
 }
 function serializeQuery(row) {
-  return { id: row.id, position: row.position, query: row.queryText, status: row.status, requestedModel: row.requestedModel, resolvedModel: row.resolvedModel, servedModel: row.servedModel, answerText: row.answerText, groundingSources: row.groundingSources, citedDomains: row.citedDomains, searchQueries: row.searchQueries, answerMentioned: row.answerMentioned, citationState: row.citationState, error: row.error, startedAt: row.startedAt, finishedAt: row.finishedAt, createdAt: row.createdAt };
+  return { id: row.id, position: row.position, query: row.queryText, status: row.status, requestedModel: row.requestedModel, resolvedModel: row.resolvedModel, servedModel: row.servedModel, answerText: row.answerText, groundingSources: row.groundingSources, citedDomains: row.citedDomains, searchQueries: row.searchQueries, namedCompetitors: row.namedCompetitors, citedCompetitorDomains: row.citedCompetitorDomains, answerMentioned: row.answerMentioned, citationState: row.citationState, error: row.error, startedAt: row.startedAt, finishedAt: row.finishedAt, createdAt: row.createdAt };
 }
 
 // ../api-routes/src/index.ts
@@ -43275,6 +44007,9 @@ async function apiRoutes(app, opts) {
       adsCredentialStore: opts.adsCredentialStore,
       verifyAdsAccount: opts.verifyAdsAccount,
       adsReader: opts.adsReader,
+      adsLiveDeliveryReader: opts.adsLiveDeliveryReader,
+      adsLiveDeliveryMinIntervalMs: opts.adsLiveDeliveryMinIntervalMs,
+      adsLiveDeliveryMaxPagesPerReaderCall: opts.adsLiveDeliveryMaxPagesPerReaderCall,
       onAdsSyncRequested: opts.onAdsSyncRequested,
       adsOperator: opts.adsOperator,
       adsReconcileSweepIntervalMs: opts.adsReconcileSweepIntervalMs,
@@ -43618,6 +44353,15 @@ function computeCompetitorOverlap(normalized, competitorDomains) {
   }
   return [...overlapSet];
 }
+function computeCitedCompetitorDomains(citedDomains, competitorDomains) {
+  const citedCompetitors = /* @__PURE__ */ new Set();
+  for (const citedDomain of citedDomains) {
+    for (const competitorDomain of competitorDomains) {
+      if (domainMatches(citedDomain, competitorDomain)) citedCompetitors.add(competitorDomain);
+    }
+  }
+  return [...citedCompetitors];
+}
 function escapeRegExp5(value) {
   return value.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
 }
@@ -43678,7 +44422,7 @@ function extractRecommendedCompetitors(answerText, ownDomains, citedDomains, com
   for (const pattern of candidatePatterns) {
     let match;
     while ((match = pattern.exec(answerText)) !== null) {
-      const candidate = cleanCandidateName(match[1] ?? "");
+      const candidate = cleanCandidateName(match[1]);
       const candidateKey = brandKeyFromText(candidate);
       if (!candidateKey) continue;
       if (genericKeys.has(candidateKey)) continue;
@@ -43752,7 +44496,7 @@ var IntelligenceService = class {
         // intelligence window.
         ne6(runs.trigger, RunTriggers.probe)
       )
-    ).orderBy(desc20(runs.finishedAt), desc20(runs.createdAt)).limit(HISTORY_WINDOW_RUNS).all();
+    ).orderBy(desc21(runs.finishedAt), desc21(runs.createdAt)).limit(HISTORY_WINDOW_RUNS).all();
     if (recentRuns.length === 0) {
       log.info("intelligence.skip", { runId, reason: "no completed runs" });
       return null;
@@ -43874,10 +44618,10 @@ var IntelligenceService = class {
   buildGbpLocationSignals(projectId, locationName, displayName, fallbackDate) {
     const metricRows = this.db.select({ metric: gbpDailyMetrics.metric, date: gbpDailyMetrics.date, value: gbpDailyMetrics.value }).from(gbpDailyMetrics).where(and35(eq44(gbpDailyMetrics.projectId, projectId), eq44(gbpDailyMetrics.locationName, locationName))).all();
     const placeActionRows = this.db.select({ placeActionType: gbpPlaceActions.placeActionType, providerType: gbpPlaceActions.providerType }).from(gbpPlaceActions).where(and35(eq44(gbpPlaceActions.projectId, projectId), eq44(gbpPlaceActions.locationName, locationName))).all();
-    const lodgingRow = this.db.select({ populatedGroupCount: gbpLodgingSnapshots.populatedGroupCount }).from(gbpLodgingSnapshots).where(and35(eq44(gbpLodgingSnapshots.projectId, projectId), eq44(gbpLodgingSnapshots.locationName, locationName))).orderBy(desc20(gbpLodgingSnapshots.syncedAt)).limit(1).get();
+    const lodgingRow = this.db.select({ populatedGroupCount: gbpLodgingSnapshots.populatedGroupCount }).from(gbpLodgingSnapshots).where(and35(eq44(gbpLodgingSnapshots.projectId, projectId), eq44(gbpLodgingSnapshots.locationName, locationName))).orderBy(desc21(gbpLodgingSnapshots.syncedAt)).limit(1).get();
     const ownerRow = this.db.select({ description: gbpLocations.description }).from(gbpLocations).where(and35(eq44(gbpLocations.projectId, projectId), eq44(gbpLocations.locationName, locationName))).get();
     const descriptionMissing = !(ownerRow?.description ?? "").trim();
-    const placeRow = this.db.select({ attributes: gbpPlaceDetails.attributes }).from(gbpPlaceDetails).where(and35(eq44(gbpPlaceDetails.projectId, projectId), eq44(gbpPlaceDetails.locationName, locationName))).orderBy(desc20(gbpPlaceDetails.syncedAt)).limit(1).get();
+    const placeRow = this.db.select({ attributes: gbpPlaceDetails.attributes }).from(gbpPlaceDetails).where(and35(eq44(gbpPlaceDetails.projectId, projectId), eq44(gbpPlaceDetails.locationName, locationName))).orderBy(desc21(gbpPlaceDetails.syncedAt)).limit(1).get();
     const placesAmenities = placeRow ? extractPlaceAmenities(placeRow.attributes) : [];
     const summary = buildGbpSummary({
       locationName,
@@ -44230,7 +44974,7 @@ var IntelligenceService = class {
         // Defensive — see top of file.
         ne6(runs.trigger, RunTriggers.probe)
       )
-    ).orderBy(desc20(runs.createdAt), desc20(runs.id)).limit((RECURRENCE_LOOKBACK_RUNS + 1) * ROWS_PER_GROUP_BUDGET).all();
+    ).orderBy(desc21(runs.createdAt), desc21(runs.id)).limit((RECURRENCE_LOOKBACK_RUNS + 1) * ROWS_PER_GROUP_BUDGET).all();
     const recentGroups = groupRunsByCreatedAt(recentRunRows);
     const recentRunIds = [];
     const recentRunIdToCreatedAt = /* @__PURE__ */ new Map();
@@ -44393,6 +45137,7 @@ export {
   classifyAiUserFetch,
   determineCitationState,
   computeCompetitorOverlap,
+  computeCitedCompetitorDomains,
   extractRecommendedCompetitors,
   getPlaceDetails,
   hashPlaceDetails,