@canonry/canonry 4.133.3 → 4.134.0

package/assets/assets/{trash-2-LGfqtSzZ.js → trash-2-BVh__r6G.js}

@@ -1 +1 @@
-import{c as a}from"./index-CQzGDGMB.js";const c=[["circle",{cx:"12",cy:"12",r:"10",key:"1mglay"}],["path",{d:"m9 12 2 2 4-4",key:"dzmm74"}]],d=a("circle-check",c);const e=[["circle",{cx:"12",cy:"12",r:"10",key:"1mglay"}],["path",{d:"M9.09 9a3 3 0 0 1 5.83 1c0 2-3 3-3 3",key:"1u773s"}],["path",{d:"M12 17h.01",key:"p32p05"}]],k=a("circle-question-mark",e);const t=[["path",{d:"M12 15V3",key:"m9g1x1"}],["path",{d:"M21 15v4a2 2 0 0 1-2 2H5a2 2 0 0 1-2-2v-4",key:"ih7n3h"}],["path",{d:"m7 10 5 5 5-5",key:"brsn70"}]],s=a("download",t);const o=[["path",{d:"M15 3h6v6",key:"1q9fwt"}],["path",{d:"M10 14 21 3",key:"gplh6r"}],["path",{d:"M18 13v6a2 2 0 0 1-2 2H5a2 2 0 0 1-2-2V8a2 2 0 0 1 2-2h6",key:"a6xqqp"}]],r=a("external-link",o);const n=[["path",{d:"M10 11v6",key:"nco0om"}],["path",{d:"M14 11v6",key:"outv1u"}],["path",{d:"M19 6v14a2 2 0 0 1-2 2H7a2 2 0 0 1-2-2V6",key:"miytrc"}],["path",{d:"M3 6h18",key:"d0wm0j"}],["path",{d:"M8 6V4a2 2 0 0 1 2-2h4a2 2 0 0 1 2 2v2",key:"e791ji"}]],y=a("trash-2",n);export{d as C,s as D,r as E,y as T,k as a};
+import{c as a}from"./index-De1MKbc7.js";const c=[["circle",{cx:"12",cy:"12",r:"10",key:"1mglay"}],["path",{d:"m9 12 2 2 4-4",key:"dzmm74"}]],d=a("circle-check",c);const e=[["circle",{cx:"12",cy:"12",r:"10",key:"1mglay"}],["path",{d:"M9.09 9a3 3 0 0 1 5.83 1c0 2-3 3-3 3",key:"1u773s"}],["path",{d:"M12 17h.01",key:"p32p05"}]],k=a("circle-question-mark",e);const t=[["path",{d:"M12 15V3",key:"m9g1x1"}],["path",{d:"M21 15v4a2 2 0 0 1-2 2H5a2 2 0 0 1-2-2v-4",key:"ih7n3h"}],["path",{d:"m7 10 5 5 5-5",key:"brsn70"}]],s=a("download",t);const o=[["path",{d:"M15 3h6v6",key:"1q9fwt"}],["path",{d:"M10 14 21 3",key:"gplh6r"}],["path",{d:"M18 13v6a2 2 0 0 1-2 2H5a2 2 0 0 1-2-2V8a2 2 0 0 1 2-2h6",key:"a6xqqp"}]],r=a("external-link",o);const n=[["path",{d:"M10 11v6",key:"nco0om"}],["path",{d:"M14 11v6",key:"outv1u"}],["path",{d:"M19 6v14a2 2 0 0 1-2 2H7a2 2 0 0 1-2-2V6",key:"miytrc"}],["path",{d:"M3 6h18",key:"d0wm0j"}],["path",{d:"M8 6V4a2 2 0 0 1 2-2h4a2 2 0 0 1 2 2v2",key:"e791ji"}]],y=a("trash-2",n);export{d as C,s as D,r as E,y as T,k as a};

package/assets/index.html

@@ -12,7 +12,7 @@
     <link rel="icon" type="image/png" sizes="32x32" href="./favicon-32.png" />
     <link rel="apple-touch-icon" href="./apple-touch-icon.png" />
     <title>Canonry</title>
-    <script type="module" crossorigin src="./assets/index-CQzGDGMB.js"></script>
+    <script type="module" crossorigin src="./assets/index-De1MKbc7.js"></script>
     <link rel="modulepreload" crossorigin href="./assets/vendor-tanstack-Be8JdV5M.js">
     <link rel="modulepreload" crossorigin href="./assets/vendor-radix-CQ77EO2y.js">
     <link rel="modulepreload" crossorigin href="./assets/vendor-recharts-DSxTZhaH.js">

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

@@ -19,6 +19,9 @@ import {
   AdsHistoricalCampaignRollupStatuses,
   AdsInsightLevels,
   AdsIntegrityDecisions,
+  AdsLiveDeliveryBases,
+  AdsLiveEntityTypes,
+  AdsLivePresences,
   AdsOperationKinds,
   AdsOperationStates,
   AdsOperationStepStates,
@@ -96,6 +99,8 @@ import {
   adsImageUploadRequestSchema,
   adsInsightLevelSchema,
   adsInsightsResponseSchema,
+  adsLiveDeliveryDtoSchema,
+  adsLiveDeliveryQuerySchema,
   adsOperationReconcileResponseSchema,
   adsOperationResponseSchema,
   adsOperationStepDtoSchema,
@@ -183,6 +188,7 @@ import {
   discoverySessionDetailDtoSchema,
   discoverySessionDtoSchema,
   doctorReportSchema,
+  dollarsToMicros,
   domainClassificationsResponseDtoSchema,
   effectiveBrandNames,
   effectiveDomains,
@@ -199,6 +205,7 @@ import {
   formatDateRange,
   formatDeltaCopy,
   formatIsoDate,
+  formatIsoDateInTimeZone,
   formatNumber,
   formatRatio,
   formatWindowCountDelta,
@@ -242,6 +249,7 @@ import {
   internalError,
   isBrowserProvider,
   isReadOnlyKey,
+  isoDateDaysBeforeInTimeZone,
   keywordDtoSchema,
   keywordGenerateRequestSchema,
   latestProjectRunDtoSchema,
@@ -356,7 +364,7 @@ import {
   wordpressSchemaDeployResultDtoSchema,
   wordpressSchemaStatusResultDtoSchema,
   wordpressStatusDtoSchema
-} from "./chunk-YRRQFOAH.js";
+} from "./chunk-PC7AYXND.js";
 
 // src/intelligence-service.ts
 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";
@@ -1462,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(),
@@ -4266,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) {
@@ -17392,6 +17412,7 @@ var SCHEMA_TABLE = {
   AdsDisconnectResponse: adsDisconnectResponseSchema,
   AdsGeoSearchResponse: adsGeoSearchResponseSchema,
   AdsInsightsResponse: adsInsightsResponseSchema,
+  AdsLiveDeliveryDto: adsLiveDeliveryDtoSchema,
   AdsOperationReconcileResponse: adsOperationReconcileResponseSchema,
   AdsOperationResponse: adsOperationResponseSchema,
   AdsSummaryDto: adsSummaryDtoSchema,
@@ -20395,6 +20416,35 @@ var routeCatalog = [
       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",
@@ -28465,6 +28515,116 @@ 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);
@@ -28599,6 +28759,12 @@ function storedActivityAssessment(snapshotStatus, rollupStatus, rollupImpression
       }
   }
 }
+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;
@@ -28961,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);
@@ -29599,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,
@@ -30378,6 +30600,264 @@ async function adsRoutes(app, opts) {
     };
     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();
@@ -43406,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
@@ -43527,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,
@@ -43870,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, "\\$&");
 }
@@ -43930,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;
@@ -44645,6 +45137,7 @@ export {
   classifyAiUserFetch,
   determineCitationState,
   computeCompetitorOverlap,
+  computeCitedCompetitorDomains,
   extractRecommendedCompetitors,
   getPlaceDetails,
   hashPlaceDetails,