@canonry/canonry 4.124.0 → 4.126.0

package/assets/assets/{trash-2-CcmHLt5u.js → trash-2-BnFgG3Wq.js}

@@ -1 +1 @@
-import{c}from"./index-CqFSTLK5.js";const a=[["circle",{cx:"12",cy:"12",r:"10",key:"1mglay"}],["path",{d:"m9 12 2 2 4-4",key:"dzmm74"}]],h=c("circle-check",a);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"}]],n=c("circle-question-mark",e);const o=[["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=c("download",o);const t=[["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"}]],r=c("trash-2",t);export{h as C,s as D,r as T,n as a};
+import{c}from"./index-B_CDPjOg.js";const a=[["circle",{cx:"12",cy:"12",r:"10",key:"1mglay"}],["path",{d:"m9 12 2 2 4-4",key:"dzmm74"}]],h=c("circle-check",a);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"}]],n=c("circle-question-mark",e);const o=[["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=c("download",o);const t=[["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"}]],r=c("trash-2",t);export{h as C,s as D,r as T,n 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-CqFSTLK5.js"></script>
+    <script type="module" crossorigin src="./assets/index-B_CDPjOg.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-BGLBWFMV.js → chunk-FCGRCCX6.js}

@@ -7,6 +7,7 @@ import {
   AI_PROVIDER_INFRA_DOMAINS,
   AdsActivationEntityTypes,
   AdsActivationGrantStates,
+  AdsActivationVersionPolicies,
   AdsAdGroupBillingEventTypes,
   AdsCampaignBiddingTypes,
   AdsEntityStatuses,
@@ -335,7 +336,7 @@ import {
   wordpressSchemaDeployResultDtoSchema,
   wordpressSchemaStatusResultDtoSchema,
   wordpressStatusDtoSchema
-} from "./chunk-SLCGTOKT.js";
+} from "./chunk-RFLNTI7Y.js";
 
 // src/intelligence-service.ts
 import { eq as eq41, desc as desc18, asc as asc9, and as and32, ne as ne6, or as or8, inArray as inArray15, gte as gte10, lte as lte6 } from "drizzle-orm";
@@ -395,6 +396,7 @@ __export(schema_exports, {
   googleConnections: () => googleConnections,
   gscCoverageSnapshots: () => gscCoverageSnapshots,
   gscDailyTotals: () => gscDailyTotals,
+  gscQueryDailyTotals: () => gscQueryDailyTotals,
   gscSearchData: () => gscSearchData,
   gscUrlInspections: () => gscUrlInspections,
   healthSnapshots: () => healthSnapshots,
@@ -655,6 +657,27 @@ var gscDailyTotals = sqliteTable("gsc_daily_totals", {
   uniqueIndex("idx_gsc_daily_totals_project_date").on(table.projectId, table.date),
   index("idx_gsc_daily_totals_project").on(table.projectId)
 ]);
+var gscQueryDailyTotals = sqliteTable("gsc_query_daily_totals", {
+  id: text("id").primaryKey(),
+  projectId: text("project_id").notNull().references(() => projects.id, { onDelete: "cascade" }),
+  date: text("date").notNull(),
+  query: text("query").notNull(),
+  clicks: integer("clicks").notNull().default(0),
+  impressions: integer("impressions").notNull().default(0),
+  /**
+   * Stored as a string like `gscSearchData.position` (parsed on read). CTR is
+   * derived (clicks / impressions) and intentionally not stored.
+   */
+  position: text("position").notNull().default("0"),
+  syncedAt: text("synced_at").notNull(),
+  syncRunId: text("sync_run_id").references(() => runs.id, { onDelete: "cascade" }),
+  createdAt: text("created_at").notNull()
+}, (table) => [
+  uniqueIndex("idx_gsc_query_daily_totals_project_date_query").on(table.projectId, table.date, table.query),
+  index("idx_gsc_query_daily_totals_project_date").on(table.projectId, table.date),
+  index("idx_gsc_query_daily_totals_query").on(table.query),
+  index("idx_gsc_query_daily_totals_run").on(table.syncRunId)
+]);
 var gscUrlInspections = sqliteTable("gsc_url_inspections", {
   id: text("id").primaryKey(),
   projectId: text("project_id").notNull().references(() => projects.id, { onDelete: "cascade" }),
@@ -3970,6 +3993,34 @@ var MIGRATION_VERSIONS = [
       `CREATE INDEX IF NOT EXISTS idx_ga_daily_totals_project ON ga_daily_totals(project_id)`,
       `CREATE INDEX IF NOT EXISTS idx_ga_daily_totals_run ON ga_daily_totals(sync_run_id)`
     ]
+  },
+  {
+    // Per-query daily totals fetched WITHOUT the `page` dimension. Summing
+    // `gsc_search_data` by query multiplies impressions by how many of the
+    // site's pages ranked on the same SERP — ~0% for single-page queries but
+    // ~500% for brand+category terms, which reorders a top-queries table.
+    // Dropping `page` makes Google do the dedup. Per-query counterpart to
+    // `gsc_daily_totals`.
+    version: 107,
+    name: "gsc-query-daily-totals",
+    statements: [
+      `CREATE TABLE IF NOT EXISTS gsc_query_daily_totals (
+        id           TEXT PRIMARY KEY,
+        project_id   TEXT NOT NULL REFERENCES projects(id) ON DELETE CASCADE,
+        date         TEXT NOT NULL,
+        query        TEXT NOT NULL,
+        clicks       INTEGER NOT NULL DEFAULT 0,
+        impressions  INTEGER NOT NULL DEFAULT 0,
+        position     TEXT NOT NULL DEFAULT '0',
+        synced_at    TEXT NOT NULL,
+        sync_run_id  TEXT REFERENCES runs(id) ON DELETE CASCADE,
+        created_at   TEXT NOT NULL
+      )`,
+      `CREATE UNIQUE INDEX IF NOT EXISTS idx_gsc_query_daily_totals_project_date_query ON gsc_query_daily_totals(project_id, date, query)`,
+      `CREATE INDEX IF NOT EXISTS idx_gsc_query_daily_totals_project_date ON gsc_query_daily_totals(project_id, date)`,
+      `CREATE INDEX IF NOT EXISTS idx_gsc_query_daily_totals_query ON gsc_query_daily_totals(query)`,
+      `CREATE INDEX IF NOT EXISTS idx_gsc_query_daily_totals_run ON gsc_query_daily_totals(sync_run_id)`
+    ]
   }
 ];
 function rebuildBacklinkTableWithSource(tx, table) {
@@ -9583,14 +9634,24 @@ function computeQueryChanges(projectQueries, cutoff) {
     label: `+${count2} kp`
   }));
 }
+function pooledRate(buckets, rateKey) {
+  const countKey = rateKey === "citationRate" ? "cited" : "mentionedCount";
+  let numerator = 0;
+  let denominator = 0;
+  for (const bucket of buckets) {
+    numerator += bucket[countKey];
+    denominator += bucket.total;
+  }
+  return denominator > 0 ? numerator / denominator : 0;
+}
 function computeTrend(buckets, rateKey) {
   const nonEmpty = buckets.filter((b) => b.total > 0);
   if (nonEmpty.length < 2) return "stable";
   const mid = Math.floor(nonEmpty.length / 2);
   const firstHalf = nonEmpty.slice(0, mid);
   const secondHalf = nonEmpty.slice(mid);
-  const avgFirst = firstHalf.reduce((s, b) => s + b[rateKey], 0) / firstHalf.length;
-  const avgSecond = secondHalf.reduce((s, b) => s + b[rateKey], 0) / secondHalf.length;
+  const avgFirst = pooledRate(firstHalf, rateKey);
+  const avgSecond = pooledRate(secondHalf, rateKey);
   const diff = avgSecond - avgFirst;
   if (diff > 0.05) return "improving";
   if (diff < -0.05) return "declining";
@@ -10047,7 +10108,12 @@ function buildGaTrafficByPage(db, projectId) {
   return map;
 }
 function sumAiReferralSessions(db, projectId) {
-  const rows = db.select({ sessions: gaAiReferrals.sessions }).from(gaAiReferrals).where(eq13(gaAiReferrals.projectId, projectId)).all();
+  const rows = db.select({ sessions: gaAiReferrals.sessions }).from(gaAiReferrals).where(
+    and9(
+      eq13(gaAiReferrals.projectId, projectId),
+      eq13(gaAiReferrals.sourceDimension, "session")
+    )
+  ).all();
   return rows.reduce((acc, r) => acc + (r.sessions ?? 0), 0);
 }
 function buildCandidateQueries(opts) {
@@ -10635,6 +10701,64 @@ function mergeGscDailyTotalsWithFallback(propertyTotals, dimensionedFallback) {
   for (const row of propertyTotals) byDate.set(row.date, row);
   return [...byDate.values()].sort((a, b) => a.date.localeCompare(b.date));
 }
+function readGscQueryDailyRows(db, projectId, startDate, endDate) {
+  const rows = db.select({
+    date: gscQueryDailyTotals.date,
+    query: gscQueryDailyTotals.query,
+    clicks: gscQueryDailyTotals.clicks,
+    impressions: gscQueryDailyTotals.impressions,
+    position: gscQueryDailyTotals.position
+  }).from(gscQueryDailyTotals).where(
+    and11(
+      eq15(gscQueryDailyTotals.projectId, projectId),
+      sql6`${gscQueryDailyTotals.date} >= ${startDate}`,
+      sql6`${gscQueryDailyTotals.date} <= ${endDate}`
+    )
+  ).all();
+  return rows.map((r) => {
+    const position = Number(r.position);
+    return {
+      date: r.date,
+      query: r.query,
+      clicks: r.clicks,
+      impressions: r.impressions,
+      position: Number.isFinite(position) ? position : 0
+    };
+  });
+}
+function mergeGscQueryTotalsWithFallback(accurateDays, fallbackDays) {
+  const dayKey = (r) => `${r.date}\0${r.query}`;
+  const byDay = /* @__PURE__ */ new Map();
+  for (const row of fallbackDays) byDay.set(dayKey(row), { row, accurate: false });
+  for (const row of accurateDays) byDay.set(dayKey(row), { row, accurate: true });
+  const byQuery = /* @__PURE__ */ new Map();
+  for (const { row, accurate } of byDay.values()) {
+    const acc = byQuery.get(row.query) ?? {
+      clicks: 0,
+      impressions: 0,
+      weightedPositionSum: 0,
+      positionSum: 0,
+      positionDays: 0,
+      sawAccurate: false,
+      sawLegacy: false
+    };
+    acc.clicks += row.clicks;
+    acc.impressions += row.impressions;
+    acc.weightedPositionSum += row.position * row.impressions;
+    acc.positionSum += row.position;
+    acc.positionDays += 1;
+    if (accurate) acc.sawAccurate = true;
+    else acc.sawLegacy = true;
+    byQuery.set(row.query, acc);
+  }
+  return [...byQuery.entries()].map(([query, acc]) => ({
+    query,
+    clicks: acc.clicks,
+    impressions: acc.impressions,
+    position: acc.impressions > 0 ? acc.weightedPositionSum / acc.impressions : acc.positionDays > 0 ? acc.positionSum / acc.positionDays : 0,
+    source: acc.sawAccurate && acc.sawLegacy ? "mixed" : acc.sawAccurate ? "google" : "page-summed"
+  }));
+}
 
 // ../api-routes/src/report-renderer.ts
 var COLORS = {
@@ -12968,15 +13092,16 @@ function buildGscSection(db, projectId, projectBrandNames, canonicalDomain, trac
   const dailyTotals = allDailyTotals.filter((r) => r.date >= startDate && r.date <= maxDate);
   if (rows.length === 0 && dailyTotals.length === 0) return null;
   let dimensionedClicks = 0;
-  const queryAgg = /* @__PURE__ */ new Map();
+  const queryDayAgg = /* @__PURE__ */ new Map();
   const dimensionedTrendAgg = /* @__PURE__ */ new Map();
   for (const r of rows) {
     dimensionedClicks += r.clicks;
-    const q = queryAgg.get(r.query) ?? { clicks: 0, impressions: 0, weightedPositionSum: 0 };
+    const dayKey = `${r.date} ${r.query}`;
+    const q = queryDayAgg.get(dayKey) ?? { date: r.date, query: r.query, clicks: 0, impressions: 0, weightedPositionSum: 0 };
     q.clicks += r.clicks;
     q.impressions += r.impressions;
     q.weightedPositionSum += safeNum(r.position) * r.impressions;
-    queryAgg.set(r.query, q);
+    queryDayAgg.set(dayKey, q);
     const t = dimensionedTrendAgg.get(r.date) ?? { clicks: 0, impressions: 0, weightedPositionSum: 0 };
     t.clicks += r.clicks;
     t.impressions += r.impressions;
@@ -13003,17 +13128,27 @@ function buildGscSection(db, projectId, projectBrandNames, canonicalDomain, trac
   const trend = dailySeries.map((d) => ({ date: d.date, clicks: d.clicks, impressions: d.impressions }));
   const ctr = totalImpressions > 0 ? totalClicks / totalImpressions : 0;
   const avgPosition = totalImpressions > 0 ? weightedPositionSum / totalImpressions : 0;
-  const topQueries = [...queryAgg.entries()].map(([query, agg]) => ({
-    query,
+  const queryTotals = mergeGscQueryTotalsWithFallback(
+    readGscQueryDailyRows(db, projectId, startDate, maxDate),
+    [...queryDayAgg.values()].map((agg) => ({
+      date: agg.date,
+      query: agg.query,
+      clicks: agg.clicks,
+      impressions: agg.impressions,
+      position: agg.impressions > 0 ? agg.weightedPositionSum / agg.impressions : 0
+    }))
+  );
+  const topQueries = queryTotals.map((agg) => ({
+    query: agg.query,
     clicks: agg.clicks,
     impressions: agg.impressions,
     ctr: agg.impressions > 0 ? agg.clicks / agg.impressions : 0,
-    avgPosition: agg.impressions > 0 ? agg.weightedPositionSum / agg.impressions : 0,
-    category: categorizeQuery(query, projectBrandNames, canonicalDomain)
+    avgPosition: agg.position,
+    category: categorizeQuery(agg.query, projectBrandNames, canonicalDomain)
   })).sort((a, b) => b.clicks - a.clicks).slice(0, TOP_QUERIES_LIMIT);
   const categoryAgg = /* @__PURE__ */ new Map();
-  for (const [query, agg] of queryAgg) {
-    const cat = categorizeQuery(query, projectBrandNames, canonicalDomain);
+  for (const agg of queryTotals) {
+    const cat = categorizeQuery(agg.query, projectBrandNames, canonicalDomain);
     const bucket = categoryAgg.get(cat) ?? { clicks: 0, impressions: 0 };
     bucket.clicks += agg.clicks;
     bucket.impressions += agg.impressions;
@@ -13028,9 +13163,9 @@ function buildGscSection(db, projectId, projectBrandNames, canonicalDomain, trac
   const periodStart = trend[0]?.date ?? "";
   const periodEnd = trend.at(-1)?.date ?? "";
   const trackedSet = new Set(trackedQueries.map((q) => q.toLowerCase()));
-  const gscQuerySet = new Set([...queryAgg.keys()].map((q) => q.toLowerCase()));
+  const gscQuerySet = new Set(queryTotals.map((q) => q.query.toLowerCase()));
   const trackedButNoGsc = trackedQueries.filter((q) => !gscQuerySet.has(q.toLowerCase())).sort();
-  const gscButNotTracked = [...queryAgg.entries()].filter(([q]) => !trackedSet.has(q.toLowerCase())).filter(([q]) => categorizeQuery(q, projectBrandNames, canonicalDomain) !== "brand").sort((a, b) => b[1].impressions - a[1].impressions).map(([q]) => q).slice(0, TOP_QUERIES_LIMIT);
+  const gscButNotTracked = [...queryTotals].filter((agg) => !trackedSet.has(agg.query.toLowerCase())).filter((agg) => categorizeQuery(agg.query, projectBrandNames, canonicalDomain) !== "brand").sort((a, b) => b.impressions - a.impressions).map((agg) => agg.query).slice(0, TOP_QUERIES_LIMIT);
   return {
     periodStart,
     periodEnd,
@@ -15753,7 +15888,8 @@ function summarizeTransitionsFromSnapshots(latest, previous, since) {
 }
 function buildSuggestedQueriesFromGsc(app, projectId, trackedQueries) {
   const cutoff = new Date(Date.now() - 28 * 24 * 60 * 60 * 1e3).toISOString().slice(0, 10);
-  const rows = app.db.select({
+  const dimensionedRows = app.db.select({
+    date: gscSearchData.date,
     query: gscSearchData.query,
     impressions: sql8`COALESCE(SUM(${gscSearchData.impressions}), 0)`,
     clicks: sql8`COALESCE(SUM(${gscSearchData.clicks}), 0)`,
@@ -15765,12 +15901,23 @@ function buildSuggestedQueriesFromGsc(app, projectId, trackedQueries) {
     eq20(gscSearchData.projectId, projectId),
     sql8`${gscSearchData.date} >= ${cutoff}`,
     sql8`${gscSearchData.impressions} > 0`
-  )).groupBy(gscSearchData.query).orderBy(sql8`SUM(${gscSearchData.impressions}) DESC`).limit(100).all();
-  const gscRows = rows.map((r) => ({
+  )).groupBy(gscSearchData.date, gscSearchData.query).all();
+  const todayIso = (/* @__PURE__ */ new Date()).toISOString().slice(0, 10);
+  const merged = mergeGscQueryTotalsWithFallback(
+    readGscQueryDailyRows(app.db, projectId, cutoff, todayIso),
+    dimensionedRows.map((r) => ({
+      date: r.date,
+      query: r.query,
+      impressions: Number(r.impressions),
+      clicks: Number(r.clicks),
+      position: Number(r.avgPosition)
+    }))
+  );
+  const gscRows = merged.filter((r) => r.impressions > 0).sort((a, b) => b.impressions - a.impressions).slice(0, 100).map((r) => ({
     query: r.query,
-    impressions: Number(r.impressions),
-    clicks: Number(r.clicks),
-    avgPosition: Number(r.avgPosition)
+    impressions: r.impressions,
+    clicks: r.clicks,
+    avgPosition: r.position
   }));
   return buildSuggestedQueries(gscRows, { trackedQueries });
 }
@@ -18623,7 +18770,13 @@ var routeCatalog = [
             properties: {
               manifest: adsActivationManifestSchema2,
               executorApiKeyId: adsEntityIdSchema,
-              expiresAt: { type: "string", format: "date-time" }
+              expiresAt: { type: "string", format: "date-time" },
+              versionPolicy: {
+                type: "string",
+                enum: ["exact", "refresh_semantically_unchanged"],
+                default: "exact",
+                description: "Exact rejects any provider version drift. refresh_semantically_unchanged rebinds versions only when the live paused tree still matches its durable create receipts field-for-field."
+              }
             }
           }
         }
@@ -24948,6 +25101,81 @@ async function preflightAdsActivationApproval(provider, request) {
   }
   return { manifest, manifestHash: hashAdsActivationManifest(manifest) };
 }
+async function refreshSemanticallyUnchangedAdsActivationManifest(provider, request) {
+  const manifest = canonicalManifest(request.manifest);
+  await validateAccount(provider, request.adAccountId);
+  await validateExactDescendants(provider, manifest, {
+    entityType: AdsActivationEntityTypes.campaign,
+    entityId: manifest.campaign.id,
+    parentId: null,
+    expectedUpdatedAt: manifest.campaign.expectedUpdatedAt
+  });
+  const versions = /* @__PURE__ */ new Map();
+  for (const target of activationTargets(manifest)) {
+    let entity;
+    try {
+      entity = await readTarget(provider, target);
+    } catch {
+      throw targetError(
+        AdsActivationErrorCodes.providerReadFailed,
+        "An ads entity could not be verified for version refresh",
+        502,
+        target
+      );
+    }
+    validateIdentity(target, entity);
+    validateAdApproval(target, entity);
+    if (entity.status !== PROVIDER_PAUSED) {
+      throw targetError(AdsActivationErrorCodes.entityNotPaused, "Every approved ads entity must still be paused", 409, target);
+    }
+    if (!Number.isInteger(entity.updatedAt) || entity.updatedAt === null || entity.updatedAt < 0) {
+      throw targetError(
+        AdsActivationErrorCodes.providerReadFailed,
+        "An ads entity did not report a usable provider version",
+        502,
+        target
+      );
+    }
+    if (!request.semanticallyMatchesMaterialization(target.entityType, target.entityId, entity)) {
+      throw targetError(
+        AdsActivationErrorCodes.entityMismatch,
+        "An ads entity no longer matches its materialized approved fields",
+        409,
+        target
+      );
+    }
+    versions.set(`${target.entityType}:${target.entityId}`, entity.updatedAt);
+  }
+  const version = (entityType, entityId) => {
+    const current = versions.get(`${entityType}:${entityId}`);
+    if (current === void 0) {
+      throw new AdsActivationError(
+        AdsActivationErrorCodes.persistenceFailed,
+        "A refreshed ads entity version is missing",
+        500
+      );
+    }
+    return current;
+  };
+  const refreshed = {
+    campaign: {
+      id: manifest.campaign.id,
+      expectedUpdatedAt: version(AdsActivationEntityTypes.campaign, manifest.campaign.id),
+      adGroups: manifest.campaign.adGroups.map((group) => ({
+        id: group.id,
+        expectedUpdatedAt: version(AdsActivationEntityTypes.ad_group, group.id),
+        ads: group.ads.map((ad) => ({
+          id: ad.id,
+          expectedUpdatedAt: version(AdsActivationEntityTypes.ad, ad.id)
+        }))
+      }))
+    }
+  };
+  return preflightAdsActivationApproval(provider, {
+    adAccountId: request.adAccountId,
+    manifest: refreshed
+  });
+}
 function stepTarget(manifest, step) {
   const target = activationTargets(manifest).find(
     (candidate) => candidate.entityType === step.entityType && candidate.entityId === step.entityId
@@ -26519,7 +26747,11 @@ function registerAdsActivationRoutes(app, opts) {
       const runtime = await opts.resolveRuntime(project);
       let preflight;
       try {
-        preflight = await preflightAdsActivationApproval(runtime.provider, {
+        preflight = body.versionPolicy === AdsActivationVersionPolicies.refreshSemanticallyUnchanged ? await refreshSemanticallyUnchangedAdsActivationManifest(runtime.provider, {
+          adAccountId: runtime.adAccountId,
+          manifest: body.manifest,
+          semanticallyMatchesMaterialization: runtime.semanticallyMatchesMaterialization ?? (() => false)
+        }) : await preflightAdsActivationApproval(runtime.provider, {
           adAccountId: runtime.adAccountId,
           manifest: body.manifest
         });
@@ -26960,6 +27192,44 @@ function entityMatchesReconcileFields(entity, desired, fingerprint) {
   const candidateFingerprint = requestHash(selected);
   return fingerprint === null ? candidateFingerprint === requestHash(desired) : candidateFingerprint === fingerprint;
 }
+function semanticallyMatchesMaterializedEntity(app, input) {
+  const createKind = (() => {
+    switch (input.entityType) {
+      case AdsActivationEntityTypes.campaign:
+        return AdsOperationKinds.campaign_create;
+      case AdsActivationEntityTypes.ad_group:
+        return AdsOperationKinds.ad_group_create;
+      case AdsActivationEntityTypes.ad:
+        return AdsOperationKinds.ad_create;
+    }
+  })();
+  const updateKind = (() => {
+    switch (input.entityType) {
+      case AdsActivationEntityTypes.campaign:
+        return AdsOperationKinds.campaign_update;
+      case AdsActivationEntityTypes.ad_group:
+        return AdsOperationKinds.ad_group_update;
+      case AdsActivationEntityTypes.ad:
+        return AdsOperationKinds.ad_update;
+    }
+  })();
+  const rows = app.db.select().from(adsOperations).where(and20(
+    eq26(adsOperations.projectId, input.projectId),
+    eq26(adsOperations.entityType, input.entityType),
+    eq26(adsOperations.entityId, input.entityId),
+    inArray12(adsOperations.kind, [createKind, updateKind])
+  )).orderBy(asc6(adsOperations.createdAt), asc6(adsOperations.id)).all();
+  if (rows.some((row) => row.state === AdsOperationStates.pending || row.state === AdsOperationStates.reconciling || row.state === AdsOperationStates.unknown || row.kind === updateKind && row.state === AdsOperationStates.succeeded)) {
+    return false;
+  }
+  const creates = rows.filter((row) => row.kind === createKind && row.state === AdsOperationStates.succeeded);
+  if (creates.length !== 1) return false;
+  const create = creates[0];
+  if (create.adAccountId !== input.adAccountId || create.reconcileStrategy !== AdsReconcileStrategies.create_fingerprint || !create.reconcileFields) {
+    return false;
+  }
+  return entityMatchesReconcileFields(input.entity, create.reconcileFields, null);
+}
 function reconcileFieldsWithoutParent(fields) {
   const { campaignId: _campaignId, adGroupId: _adGroupId, ...withoutParent } = fields;
   return withoutParent;
@@ -27743,6 +28013,16 @@ async function adsRoutes(app, opts) {
       }
       return {
         adAccountId,
+        semanticallyMatchesMaterialization: (entityType, entityId, entity) => {
+          if (entity.status === null || entity.updatedAt === null) return false;
+          return semanticallyMatchesMaterializedEntity(app, {
+            projectId: project.id,
+            adAccountId,
+            entityType,
+            entityId,
+            entity: { ...entity, status: entity.status, updatedAt: entity.updatedAt }
+          });
+        },
         provider: {
           getAccount: refreshAccount,
           getCampaign: (id) => operator.getCampaign(apiKey, id),
@@ -42131,6 +42411,7 @@ export {
   notifications,
   gscSearchData,
   gscDailyTotals,
+  gscQueryDailyTotals,
   gscUrlInspections,
   gscCoverageSnapshots,
   siteAuditSnapshots,

package/dist/{chunk-4D2XUMMV.js → chunk-M6GKSLOJ.js}

@@ -10,7 +10,7 @@ import {
   loadConfig,
   loadConfigRaw,
   saveConfigPatch
-} from "./chunk-WGGB7QBD.js";
+} from "./chunk-WA57WG6W.js";
 import {
   CC_CACHE_DIR,
   DUCKDB_SPEC,
@@ -77,6 +77,7 @@ import {
   groupRunsByCreatedAt,
   gscCoverageSnapshots,
   gscDailyTotals,
+  gscQueryDailyTotals,
   gscSearchData,
   gscUrlInspections,
   hashAttributes,
@@ -115,7 +116,7 @@ import {
   siteAuditPages,
   siteAuditSnapshots,
   usageCounters
-} from "./chunk-BGLBWFMV.js";
+} from "./chunk-FCGRCCX6.js";
 import {
   AGENT_MEMORY_VALUE_MAX_BYTES,
   AGENT_PROVIDER_IDS,
@@ -185,7 +186,7 @@ import {
   validationError,
   winnabilityClassLabel,
   withRetry
-} from "./chunk-SLCGTOKT.js";
+} from "./chunk-RFLNTI7Y.js";
 
 // src/telemetry.ts
 import crypto from "crypto";
@@ -3869,6 +3870,36 @@ async function executeGscSync(db, runId, projectId, opts) {
       }).run();
     }
     log2.info("daily-totals.complete", { runId, projectId, rowCount: totalRows.length });
+    const queryTotalRows = await fetchSearchAnalytics(accessToken, propertyId, {
+      startDate,
+      endDate,
+      dimensions: ["date", "query"]
+    });
+    db.delete(gscQueryDailyTotals).where(
+      and2(
+        eq2(gscQueryDailyTotals.projectId, projectId),
+        sql2`${gscQueryDailyTotals.date} >= ${startDate}`,
+        sql2`${gscQueryDailyTotals.date} <= ${endDate}`
+      )
+    ).run();
+    const queryTotalsNow = (/* @__PURE__ */ new Date()).toISOString();
+    for (const row of queryTotalRows) {
+      const [date, query] = row.keys;
+      if (!date || !query) continue;
+      db.insert(gscQueryDailyTotals).values({
+        id: crypto4.randomUUID(),
+        projectId,
+        date,
+        query,
+        clicks: row.clicks,
+        impressions: row.impressions,
+        position: String(row.position),
+        syncedAt: queryTotalsNow,
+        syncRunId: runId,
+        createdAt: queryTotalsNow
+      }).run();
+    }
+    log2.info("query-totals.complete", { runId, projectId, rowCount: queryTotalRows.length });
     const pageClicks = /* @__PURE__ */ new Map();
     for (const row of rows) {
       const page = row.keys[1];
@@ -4612,7 +4643,10 @@ async function fetchAllPages(apiKey, path10, queryPairs) {
   );
 }
 function insightsPairs(opts) {
-  return (opts?.fields ?? []).map((field) => `fields[]=${encodeURIComponent(field)}`);
+  return [
+    ...(opts?.fields ?? []).map((field) => `fields[]=${encodeURIComponent(field)}`),
+    ...(opts?.timeRanges ?? []).map((range) => `time_ranges[]=${encodeURIComponent(JSON.stringify(range))}`)
+  ];
 }
 async function getAdAccount(apiKey) {
   validateApiKey(apiKey);
@@ -4793,6 +4827,31 @@ function removeOpenAiAdsConnection(config, projectName) {
 var log4 = createLogger("AdsSync");
 var CAMPAIGN_INSIGHT_FIELDS = ["campaign.impressions", "campaign.clicks", "campaign.spend", "campaign.conversions", "metadata.readable_time"];
 var AD_GROUP_INSIGHT_FIELDS = ["ad_group.impressions", "ad_group.clicks", "ad_group.spend", "ad_group.conversions", "metadata.readable_time"];
+var INSIGHTS_LOOKBACK_MS = 90 * 24 * 60 * 60 * 1e3;
+function accountHour(date, timezone) {
+  const parts = new Intl.DateTimeFormat("en-CA", {
+    timeZone: timezone,
+    year: "numeric",
+    month: "2-digit",
+    day: "2-digit",
+    hour: "2-digit",
+    hourCycle: "h23"
+  }).formatToParts(date);
+  const value = (type) => {
+    const part = parts.find((candidate) => candidate.type === type)?.value;
+    if (!part) throw new Error(`OpenAI Ads account timezone did not produce a ${type}`);
+    return part;
+  };
+  return `${value("year")}-${value("month")}-${value("day")}T${value("hour")}`;
+}
+function trailingAdsInsightHourRange(now, timezone) {
+  return {
+    type: "hour_range",
+    since: accountHour(new Date(now.getTime() - INSIGHTS_LOOKBACK_MS), timezone),
+    until: accountHour(now, timezone),
+    timezone
+  };
+}
 function toInsightUpserts(level, entityId, rows) {
   const upserts = [];
   for (const row of rows) {
@@ -4830,6 +4889,7 @@ async function executeAdsSync(db, runId, projectId, opts) {
     log4.info("sync.start", { runId, projectId, adAccountId: connRow.adAccountId });
     const account = await getAdAccount(apiKey);
     const campaigns = await listCampaigns(apiKey);
+    const insightTimeRanges = [trailingAdsInsightHourRange(/* @__PURE__ */ new Date(), account.timezone)];
     const errors = /* @__PURE__ */ new Map();
     const adGroupsByCampaign = /* @__PURE__ */ new Map();
     const adsByGroup = /* @__PURE__ */ new Map();
@@ -4839,12 +4899,18 @@ async function executeAdsSync(db, runId, projectId, opts) {
       try {
         const [adGroups, campaignInsights] = await Promise.all([
           listAdGroups(apiKey, campaign.id),
-          getCampaignInsights(apiKey, campaign.id, { fields: CAMPAIGN_INSIGHT_FIELDS })
+          getCampaignInsights(apiKey, campaign.id, {
+            fields: CAMPAIGN_INSIGHT_FIELDS,
+            timeRanges: insightTimeRanges
+          })
         ]);
         const groupResults = await Promise.all(adGroups.map(async (group) => ({
           group,
           ads: await listAds(apiKey, group.id),
-          insights: await getAdGroupInsights(apiKey, group.id, { fields: AD_GROUP_INSIGHT_FIELDS })
+          insights: await getAdGroupInsights(apiKey, group.id, {
+            fields: AD_GROUP_INSIGHT_FIELDS,
+            timeRanges: insightTimeRanges
+          })
         })));
         syncedCampaigns.push(campaign);
         adGroupsByCampaign.set(campaign.id, adGroups);
@@ -6901,7 +6967,7 @@ function readStoredGroundingSources(rawResponse) {
   return result;
 }
 async function backfillInsightsCommand(project, opts) {
-  const { IntelligenceService: IntelligenceService2 } = await import("./intelligence-service-SACHNNCT.js");
+  const { IntelligenceService: IntelligenceService2 } = await import("./intelligence-service-K6B3MTDS.js");
   const config = loadConfig();
   const db = createClient(config.database);
   migrate(db);

package/dist/{chunk-SLCGTOKT.js → chunk-RFLNTI7Y.js}

@@ -6848,10 +6848,19 @@ var adsOperationStepDtoSchema = z35.discriminatedUnion("state", [
   adsOperationStepRollbackFailedDtoSchema,
   adsOperationStepUnknownDtoSchema
 ]);
+var AdsActivationVersionPolicies = {
+  exact: "exact",
+  refreshSemanticallyUnchanged: "refresh_semantically_unchanged"
+};
+var adsActivationVersionPolicySchema = z35.enum([
+  AdsActivationVersionPolicies.exact,
+  AdsActivationVersionPolicies.refreshSemanticallyUnchanged
+]);
 var adsActivationGrantCreateRequestSchema = z35.object({
   manifest: adsActivationManifestSchema,
   executorApiKeyId: adsEntityIdSchema,
-  expiresAt: adsActivationIsoTimestampSchema
+  expiresAt: adsActivationIsoTimestampSchema,
+  versionPolicy: adsActivationVersionPolicySchema.default(AdsActivationVersionPolicies.exact)
 }).strict();
 var adsActivationGrantResponseSchema = z35.object({
   grant: adsActivationGrantDtoSchema
@@ -7441,6 +7450,7 @@ export {
   adsOperationResponseSchema,
   adsActivationGrantDtoSchema,
   adsOperationStepDtoSchema,
+  AdsActivationVersionPolicies,
   adsActivationGrantCreateRequestSchema,
   adsActivationGrantResponseSchema,
   adsActivationGrantRevokeRequestSchema,