@canonry/canonry 4.125.0 → 4.127.0

package/dist/{chunk-YPRUBNUK.js → chunk-HQRUFTLN.js}

@@ -336,7 +336,7 @@ import {
   wordpressSchemaDeployResultDtoSchema,
   wordpressSchemaStatusResultDtoSchema,
   wordpressStatusDtoSchema
-} from "./chunk-RFLNTI7Y.js";
+} from "./chunk-BLSHHRRU.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";
@@ -396,6 +396,7 @@ __export(schema_exports, {
   googleConnections: () => googleConnections,
   gscCoverageSnapshots: () => gscCoverageSnapshots,
   gscDailyTotals: () => gscDailyTotals,
+  gscQueryDailyTotals: () => gscQueryDailyTotals,
   gscSearchData: () => gscSearchData,
   gscUrlInspections: () => gscUrlInspections,
   healthSnapshots: () => healthSnapshots,
@@ -656,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" }),
@@ -3971,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) {
@@ -9584,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";
@@ -10048,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) {
@@ -10636,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 = {
@@ -12235,7 +12358,6 @@ function renderAiReferrals(report) {
     <tr>
       <td class="page-cell">${formatLandingPageHtml(p.page)}</td>
       <td class="numeric">${formatNumber(p.sessions)}</td>
-      <td class="numeric">${formatNumber(p.users)}</td>
     </tr>`).join("");
   const trendChart = renderLineChart(
     ai.trend.map((t) => ({ x: t.date, y: t.sessions, label: t.date.slice(5) })),
@@ -12246,13 +12368,12 @@ function renderAiReferrals(report) {
     { id: "ai-referrals", eyebrow: "Section 9", title: "AI Referral Traffic", intro: "Traffic arriving from AI answer engines." },
     `<div class="metric-grid">
       <div class="metric"><div class="label">Total sessions</div><div class="value">${formatNumber(ai.totalSessions)}</div></div>
-      <div class="metric"><div class="label">Total users</div><div class="value">${formatNumber(ai.totalUsers)}</div></div>
     </div>
     ${trendChart}
     ${sourceBars}
     <div class="chart-card"><h3>Top AI landing pages</h3>
       <table class="report-table">
-        <thead><tr><th>Page</th><th class="numeric">Sessions</th><th class="numeric">Users</th></tr></thead>
+        <thead><tr><th>Page</th><th class="numeric">Sessions</th></tr></thead>
         <tbody>${pageRows}</tbody>
       </table>
     </div>`
@@ -12969,15 +13090,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;
@@ -13004,17 +13126,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;
@@ -13029,9 +13161,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,
@@ -13171,8 +13303,24 @@ function buildSocialReferrals(db, projectId) {
     topCampaigns
   };
 }
-function buildAiReferrals(db, projectId) {
-  const rows = db.select().from(gaAiReferrals).where(eq16(gaAiReferrals.projectId, projectId)).all();
+function resolveAiReferralWindow(db, projectId, windowDays) {
+  const windowKey = GA_WINDOW_SUMMARY_KEYS[windowDays];
+  const windowSummary = windowKey ? db.select({ periodStart: gaTrafficWindowSummaries.periodStart, periodEnd: gaTrafficWindowSummaries.periodEnd }).from(gaTrafficWindowSummaries).where(and12(
+    eq16(gaTrafficWindowSummaries.projectId, projectId),
+    eq16(gaTrafficWindowSummaries.windowKey, windowKey)
+  )).get() : void 0;
+  if (windowSummary) return { start: windowSummary.periodStart, end: windowSummary.periodEnd };
+  const latestSummary = db.select({ periodEnd: gaTrafficSummaries.periodEnd }).from(gaTrafficSummaries).where(eq16(gaTrafficSummaries.projectId, projectId)).orderBy(desc7(gaTrafficSummaries.syncedAt)).get();
+  const end = latestSummary?.periodEnd ?? (/* @__PURE__ */ new Date()).toISOString().slice(0, 10);
+  return { start: windowStartDate(end, windowDays), end };
+}
+function buildAiReferrals(db, projectId, windowDays) {
+  const window = resolveAiReferralWindow(db, projectId, windowDays);
+  const rows = db.select().from(gaAiReferrals).where(and12(
+    eq16(gaAiReferrals.projectId, projectId),
+    sql7`${gaAiReferrals.date} >= ${window.start}`,
+    sql7`${gaAiReferrals.date} <= ${window.end}`
+  )).all();
   if (rows.length === 0) return null;
   const dimSessionsByTuple = /* @__PURE__ */ new Map();
   for (const r of rows) {
@@ -13200,60 +13348,47 @@ function buildAiReferrals(db, projectId) {
     (r) => winningDimension.get(`${r.date}::${r.source}::${r.medium}`) === r.sourceDimension
   );
   let total = 0;
-  let totalUsers = 0;
   let paidSessions = 0;
-  let paidUsers = 0;
   let organicSessions = 0;
-  let organicUsers = 0;
   const sourceAgg = /* @__PURE__ */ new Map();
   const trendAgg = /* @__PURE__ */ new Map();
   const pageAgg = /* @__PURE__ */ new Map();
   for (const r of dedupedRows) {
     total += r.sessions;
-    totalUsers += r.users;
     const paid = isPaidAiTrafficClass(r.trafficClass);
     if (paid) {
       paidSessions += r.sessions;
-      paidUsers += r.users;
     } else {
       organicSessions += r.sessions;
-      organicUsers += r.users;
     }
     const s = sourceAgg.get(r.source) ?? {
       sessions: 0,
-      users: 0,
       paidSessions: 0,
       organicSessions: 0
     };
     s.sessions += r.sessions;
-    s.users += r.users;
     if (paid) s.paidSessions += r.sessions;
     else s.organicSessions += r.sessions;
     sourceAgg.set(r.source, s);
     trendAgg.set(r.date, (trendAgg.get(r.date) ?? 0) + r.sessions);
     const page = r.landingPageNormalized ?? r.landingPage;
-    const p = pageAgg.get(page) ?? { sessions: 0, users: 0 };
+    const p = pageAgg.get(page) ?? { sessions: 0 };
     p.sessions += r.sessions;
-    p.users += r.users;
     pageAgg.set(page, p);
   }
   const bySource = [...sourceAgg.entries()].map(([source, data]) => ({
     source,
     sessions: data.sessions,
-    users: data.users,
     paidSessions: data.paidSessions,
     organicSessions: data.organicSessions,
     sharePct: total > 0 ? Math.round(data.sessions / total * 100) : 0
   })).sort((a, b) => b.sessions - a.sessions);
   const trend = [...trendAgg.entries()].map(([date, sessions]) => ({ date, sessions })).sort((a, b) => a.date.localeCompare(b.date));
-  const topLandingPages = [...pageAgg.entries()].map(([page, data]) => ({ page, sessions: data.sessions, users: data.users })).sort((a, b) => b.sessions - a.sessions).slice(0, TOP_AI_REFERRAL_PAGES_LIMIT);
+  const topLandingPages = [...pageAgg.entries()].map(([page, data]) => ({ page, sessions: data.sessions })).sort((a, b) => b.sessions - a.sessions).slice(0, TOP_AI_REFERRAL_PAGES_LIMIT);
   return {
     totalSessions: total,
-    totalUsers,
     paidSessions,
-    paidUsers,
     organicSessions,
-    organicUsers,
     bySource,
     trend,
     topLandingPages
@@ -14258,7 +14393,7 @@ function buildProjectReport(db, projectName, periodDays) {
   );
   const gaSection = buildGaSection(db, project.id, periodDays);
   const socialSection = buildSocialReferrals(db, project.id);
-  const aiReferralsSection = buildAiReferrals(db, project.id);
+  const aiReferralsSection = buildAiReferrals(db, project.id, periodDays);
   const serverActivitySection = buildServerActivity(db, project.id, periodDays);
   const indexingHealthSection = buildIndexingHealth(db, project.id);
   const citationsTrend = buildCitationsTrend(db, project.id, queryLookup, latestRunLocation);
@@ -15754,7 +15889,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)`,
@@ -15766,12 +15902,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 });
 }
@@ -24545,6 +24692,7 @@ var AdsActivationError = class extends Error {
   entity;
 };
 var DEFAULT_LEASE_MS = 5 * 6e4;
+var DEFAULT_ACTIVATION_VERIFICATION_RETRY_DELAYS_MS = [100, 250, 500, 1e3, 2e3, 2e3];
 var PROVIDER_PAUSED = "paused";
 var PROVIDER_ACTIVE = "active";
 function assertNever(value) {
@@ -25479,6 +25627,66 @@ async function validateActiveDescendants(ctx, parent) {
     );
   }
 }
+async function verifyActiveAfterMutation(ctx, target) {
+  let lastUpdatedAt = null;
+  for (let attempt = 0; ; attempt++) {
+    let entity = null;
+    try {
+      entity = await readTarget(ctx.deps.provider, target);
+      lastUpdatedAt = entity.updatedAt;
+    } catch {
+    }
+    if (entity) {
+      try {
+        validateIdentity(target, entity);
+        validateAdApproval(target, entity);
+      } catch (cause) {
+        return {
+          ok: false,
+          error: cause instanceof AdsActivationError ? cause : targetError(
+            AdsActivationErrorCodes.providerMutationFailed,
+            "Provider activation validation failed",
+            502,
+            target
+          ),
+          providerUpdatedAt: entity.updatedAt
+        };
+      }
+      if (entity.status === PROVIDER_ACTIVE && entity.updatedAt !== null) {
+        return { ok: true, entity };
+      }
+      const exactPreMutationSnapshot = entity.status === PROVIDER_PAUSED && entity.updatedAt === target.expectedUpdatedAt;
+      if (!exactPreMutationSnapshot) {
+        return {
+          ok: false,
+          error: targetError(
+            AdsActivationErrorCodes.providerMutationFailed,
+            "Provider did not confirm the required active state",
+            502,
+            target
+          ),
+          providerUpdatedAt: entity.updatedAt
+        };
+      }
+    }
+    if (attempt >= ctx.deps.activationVerificationRetryDelaysMs.length) {
+      return {
+        ok: false,
+        error: targetError(
+          AdsActivationErrorCodes.providerMutationFailed,
+          "Provider activation outcome could not be verified",
+          502,
+          target
+        ),
+        providerUpdatedAt: lastUpdatedAt
+      };
+    }
+    const delayMs = ctx.deps.activationVerificationRetryDelaysMs[attempt];
+    await renewLease(ctx);
+    await ctx.deps.sleep(delayMs);
+    await renewLease(ctx);
+  }
+}
 async function activateOne(ctx, original) {
   let step = currentStep(ctx, original.id);
   if (step.state === AdsOperationStepStates.active) {
@@ -25530,25 +25738,16 @@ async function activateOne(ctx, original) {
   } catch {
   }
   await renewLease(ctx);
-  let entity;
-  try {
-    entity = await readTarget(ctx.deps.provider, target);
-  } catch {
-    const error = targetError(AdsActivationErrorCodes.providerMutationFailed, "Provider activation outcome could not be verified", 502, target);
-    await transitionStep(ctx, step, unknownStep(step, error, null, ctx.deps.now().toISOString()));
-    throw error;
-  }
-  try {
-    validateIdentity(target, entity);
-    validateAdApproval(target, entity);
-    if (entity.status !== PROVIDER_ACTIVE || entity.updatedAt === null) {
-      throw targetError(AdsActivationErrorCodes.providerMutationFailed, "Provider did not confirm the required active state", 502, target);
-    }
-  } catch (cause) {
-    const error = cause instanceof AdsActivationError ? cause : targetError(AdsActivationErrorCodes.providerMutationFailed, "Provider activation validation failed", 502, target);
-    await transitionStep(ctx, step, unknownStep(step, error, entity.updatedAt, ctx.deps.now().toISOString()));
-    throw error;
+  const verification = await verifyActiveAfterMutation(ctx, target);
+  if (!verification.ok) {
+    await transitionStep(
+      ctx,
+      step,
+      unknownStep(step, verification.error, verification.providerUpdatedAt, ctx.deps.now().toISOString())
+    );
+    throw verification.error;
   }
+  const { entity } = verification;
   await validateExactDescendants(
     ctx.deps.provider,
     ctx.manifest,
@@ -25732,11 +25931,22 @@ async function executeApprovedAdsActivation(dependencies, request) {
     provider: dependencies.provider,
     now: dependencies.now ?? (() => /* @__PURE__ */ new Date()),
     randomId: dependencies.randomId ?? (() => crypto20.randomUUID()),
-    leaseMs: dependencies.leaseMs ?? DEFAULT_LEASE_MS
+    leaseMs: dependencies.leaseMs ?? DEFAULT_LEASE_MS,
+    sleep: dependencies.sleep ?? ((ms) => new Promise((resolve) => setTimeout(resolve, ms))),
+    activationVerificationRetryDelaysMs: dependencies.activationVerificationRetryDelaysMs ?? DEFAULT_ACTIVATION_VERIFICATION_RETRY_DELAYS_MS
   };
   if (!Number.isSafeInteger(deps.leaseMs) || deps.leaseMs <= 0) {
     throw new AdsActivationError(AdsActivationErrorCodes.invalidManifest, "Activation lease duration is invalid", 400);
   }
+  if (deps.activationVerificationRetryDelaysMs.some(
+    (delay) => !Number.isSafeInteger(delay) || delay < 0
+  )) {
+    throw new AdsActivationError(
+      AdsActivationErrorCodes.invalidManifest,
+      "Activation verification retry delays are invalid",
+      400
+    );
+  }
   const now = deps.now();
   const operationId = deps.randomId();
   const leaseOwner = deps.randomId();
@@ -42265,6 +42475,7 @@ export {
   notifications,
   gscSearchData,
   gscDailyTotals,
+  gscQueryDailyTotals,
   gscUrlInspections,
   gscCoverageSnapshots,
   siteAuditSnapshots,

package/dist/{chunk-WA57WG6W.js → chunk-IHRW6WWV.js}

@@ -37,7 +37,7 @@ import {
   trafficConnectVercelRequestSchema,
   trafficConnectWordpressRequestSchema,
   trafficEventKindSchema
-} from "./chunk-RFLNTI7Y.js";
+} from "./chunk-BLSHHRRU.js";
 
 // src/config.ts
 import fs from "fs";

package/dist/cli.js

@@ -29,7 +29,7 @@ import {
   setTelemetrySource,
   showFirstRunNotice,
   trackEvent
-} from "./chunk-DN5H2ZN7.js";
+} from "./chunk-A4YBV4Y4.js";
 import {
   CliError,
   EXIT_SYSTEM_ERROR,
@@ -46,7 +46,7 @@ import {
   saveConfig,
   saveConfigPatch,
   usageError
-} from "./chunk-WA57WG6W.js";
+} from "./chunk-IHRW6WWV.js";
 import {
   apiKeys,
   createClient,
@@ -54,7 +54,7 @@ import {
   projects,
   queries,
   renderReportHtml
-} from "./chunk-YPRUBNUK.js";
+} from "./chunk-HQRUFTLN.js";
 import {
   AdsOperationKinds,
   AdsOperationStates,
@@ -95,7 +95,7 @@ import {
   providerQuotaPolicySchema,
   resolveProviderInput,
   winnabilityClassSchema
-} from "./chunk-RFLNTI7Y.js";
+} from "./chunk-BLSHHRRU.js";
 
 // src/cli.ts
 import { pathToFileURL } from "url";

package/dist/index.js

@@ -1,11 +1,11 @@
 import {
   createServer
-} from "./chunk-DN5H2ZN7.js";
+} from "./chunk-A4YBV4Y4.js";
 import {
   loadConfig
-} from "./chunk-WA57WG6W.js";
-import "./chunk-YPRUBNUK.js";
-import "./chunk-RFLNTI7Y.js";
+} from "./chunk-IHRW6WWV.js";
+import "./chunk-HQRUFTLN.js";
+import "./chunk-BLSHHRRU.js";
 export {
   createServer,
   loadConfig

package/dist/{intelligence-service-WJ2ZR7GF.js → intelligence-service-2WKS3EWJ.js}

@@ -1,7 +1,7 @@
 import {
   IntelligenceService
-} from "./chunk-YPRUBNUK.js";
-import "./chunk-RFLNTI7Y.js";
+} from "./chunk-HQRUFTLN.js";
+import "./chunk-BLSHHRRU.js";
 export {
   IntelligenceService
 };

package/dist/mcp.js

@@ -3,10 +3,10 @@ import {
   PACKAGE_VERSION,
   canonryMcpTools,
   createApiClient
-} from "./chunk-WA57WG6W.js";
+} from "./chunk-IHRW6WWV.js";
 import {
   isReadOnlyKey
-} from "./chunk-RFLNTI7Y.js";
+} from "./chunk-BLSHHRRU.js";
 
 // src/mcp/cli.ts
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@canonry/canonry",
-  "version": "4.125.0",
+  "version": "4.127.0",
   "type": "module",
   "description": "Agent-first open-source AEO operating platform - track how answer engines cite your domain",
   "license": "FSL-1.1-ALv2",
@@ -71,21 +71,21 @@
     "@ainyc/canonry-contracts": "0.0.0",
     "@ainyc/canonry-db": "0.0.0",
     "@ainyc/canonry-integration-bing": "0.0.0",
-    "@ainyc/canonry-integration-cloud-run": "0.0.0",
-    "@ainyc/canonry-integration-google": "0.0.0",
     "@ainyc/canonry-integration-openai-ads": "0.0.0",
+    "@ainyc/canonry-integration-cloud-run": "0.0.0",
     "@ainyc/canonry-integration-commoncrawl": "0.0.0",
-    "@ainyc/canonry-integration-google-business-profile": "0.0.0",
+    "@ainyc/canonry-integration-google": "0.0.0",
     "@ainyc/canonry-integration-google-places": "0.0.0",
     "@ainyc/canonry-intelligence": "0.0.0",
+    "@ainyc/canonry-integration-traffic": "0.0.0",
+    "@ainyc/canonry-integration-wordpress": "0.0.0",
     "@ainyc/canonry-provider-cdp": "0.0.0",
     "@ainyc/canonry-provider-claude": "0.0.0",
-    "@ainyc/canonry-provider-gemini": "0.0.0",
-    "@ainyc/canonry-integration-wordpress": "0.0.0",
-    "@ainyc/canonry-integration-traffic": "0.0.0",
+    "@ainyc/canonry-integration-google-business-profile": "0.0.0",
     "@ainyc/canonry-provider-local": "0.0.0",
     "@ainyc/canonry-provider-openai": "0.0.0",
-    "@ainyc/canonry-provider-perplexity": "0.0.0"
+    "@ainyc/canonry-provider-perplexity": "0.0.0",
+    "@ainyc/canonry-provider-gemini": "0.0.0"
   },
   "scripts": {
     "build": "tsx scripts/copy-agent-assets.ts && tsup && tsx build-web.ts",