@ainyc/canonry 4.36.0 → 4.40.0

package/dist/{chunk-F2G67CIU.js → chunk-H6COOYA6.js}

@@ -5,7 +5,7 @@ import {
   loadConfig,
   loadConfigRaw,
   saveConfigPatch
-} from "./chunk-O7S623DL.js";
+} from "./chunk-JS6KRBBZ.js";
 import {
   DEFAULT_RUN_HISTORY_LIMIT,
   IntelligenceService,
@@ -30,11 +30,14 @@ import {
   buildGapQueryScore,
   buildInventory,
   buildMentionCoverage,
+  buildMentionGapScore,
   buildMentionLandscape,
   buildMovementSummary,
   buildOverviewCompetitors,
   buildProviderScores,
+  buildProviderTrends,
   buildRunHistory,
+  buildShareOfVoice,
   buildVisibilityScore,
   categorizeQueryByIntent,
   ccReleaseSyncs,
@@ -67,6 +70,7 @@ import {
   parseJsonColumn,
   pickGroupRepresentative,
   projects,
+  providerKey,
   queries,
   querySnapshots,
   rawEventSamples,
@@ -74,7 +78,7 @@ import {
   schedules,
   trafficSources,
   usageCounters
-} from "./chunk-JQQXMCQ7.js";
+} from "./chunk-EWYUJ2DG.js";
 import {
   AGENT_MEMORY_VALUE_MAX_BYTES,
   AGENT_PROVIDER_IDS,
@@ -926,7 +930,7 @@ function aliasArraysEqual(a, b) {
 
 // ../api-routes/src/queries.ts
 import crypto5 from "crypto";
-import { eq as eq4 } from "drizzle-orm";
+import { eq as eq4, inArray, sql as sql3 } from "drizzle-orm";
 async function queryRoutes(app, opts) {
   app.get("/projects/:name/queries", async (request, reply) => {
     const project = resolveProject(app.db, request.params.name);
@@ -962,6 +966,36 @@ async function queryRoutes(app, opts) {
     const rows = app.db.select().from(queries).where(eq4(queries.projectId, project.id)).all();
     return reply.send(rows.map((r) => ({ id: r.id, query: r.query, createdAt: r.createdAt })));
   });
+  app.post("/projects/:name/queries/replace-preview", async (request, reply) => {
+    const project = resolveProject(app.db, request.params.name);
+    const body = request.body;
+    if (!body || !Array.isArray(body.queries)) {
+      throw validationError('Body must contain a "queries" array');
+    }
+    const currentRows = app.db.select().from(queries).where(eq4(queries.projectId, project.id)).all();
+    const currentTexts = currentRows.map((r) => r.query);
+    const currentSet = new Set(currentTexts);
+    const proposedSet = new Set(body.queries);
+    const removed = currentTexts.filter((q) => !proposedSet.has(q));
+    const added = body.queries.filter((q) => !currentSet.has(q));
+    const unchanged = currentTexts.filter((q) => proposedSet.has(q));
+    const currentIds = currentRows.map((r) => r.id);
+    let snapshotsDetached = 0;
+    let affectedQueries = 0;
+    if (currentIds.length > 0) {
+      const snapshotCount = app.db.select({ n: sql3`count(*)` }).from(querySnapshots).where(inArray(querySnapshots.queryId, currentIds)).get();
+      snapshotsDetached = snapshotCount?.n ?? 0;
+      const distinctAffected = app.db.select({ n: sql3`count(distinct ${querySnapshots.queryId})` }).from(querySnapshots).where(inArray(querySnapshots.queryId, currentIds)).get();
+      affectedQueries = distinctAffected?.n ?? 0;
+    }
+    return reply.send({
+      project: { id: project.id, name: project.name },
+      current: currentTexts,
+      proposed: body.queries,
+      diff: { added, removed, unchanged },
+      snapshotImpact: { affectedQueries, snapshotsDetached }
+    });
+  });
   app.delete("/projects/:name/queries", async (request, reply) => {
     const project = resolveProject(app.db, request.params.name);
     const body = request.body;
@@ -1325,7 +1359,7 @@ function parseCompetitorBatch(value) {
 
 // ../api-routes/src/runs.ts
 import crypto8 from "crypto";
-import { and as and2, eq as eq7, asc, desc, or as or2, sql as sql3 } from "drizzle-orm";
+import { and as and2, eq as eq7, asc, desc, or as or2, sql as sql4 } from "drizzle-orm";
 
 // ../api-routes/src/run-queue.ts
 import crypto7 from "crypto";
@@ -1497,7 +1531,7 @@ async function runRoutes(app, opts) {
   });
   app.get("/projects/:name/runs/latest", async (request, reply) => {
     const project = resolveProject(app.db, request.params.name);
-    const countRow = app.db.select({ count: sql3`count(*)` }).from(runs).where(eq7(runs.projectId, project.id)).get();
+    const countRow = app.db.select({ count: sql4`count(*)` }).from(runs).where(eq7(runs.projectId, project.id)).get();
     const totalRuns = countRow?.count ?? 0;
     const latestRun = app.db.select().from(runs).where(eq7(runs.projectId, project.id)).orderBy(desc(runs.createdAt), desc(runs.id)).limit(1).get();
     if (!latestRun) {
@@ -2226,7 +2260,7 @@ function normalizeCompetitorList2(domains) {
 }
 
 // ../api-routes/src/history.ts
-import { eq as eq9, desc as desc2, inArray } from "drizzle-orm";
+import { eq as eq9, desc as desc2, inArray as inArray2 } from "drizzle-orm";
 
 // ../api-routes/src/notification-redaction.ts
 var REDACTED_URL = {
@@ -2302,7 +2336,7 @@ async function historyRoutes(app) {
       recommendedCompetitors: querySnapshots.recommendedCompetitors,
       location: querySnapshots.location,
       createdAt: querySnapshots.createdAt
-    }).from(querySnapshots).leftJoin(queries, eq9(querySnapshots.queryId, queries.id)).where(inArray(querySnapshots.runId, projectRuns.map((r) => r.id))).orderBy(desc2(querySnapshots.createdAt)).all();
+    }).from(querySnapshots).leftJoin(queries, eq9(querySnapshots.queryId, queries.id)).where(inArray2(querySnapshots.runId, projectRuns.map((r) => r.id))).orderBy(desc2(querySnapshots.createdAt)).all();
     const locationFilter = request.query.location;
     const filtered = locationFilter !== void 0 ? allSnapshots.filter((s) => s.location === (locationFilter || null)) : allSnapshots;
     const total = filtered.length;
@@ -2337,7 +2371,7 @@ async function historyRoutes(app) {
       return reply.send([]);
     }
     const runIds = new Set(projectRuns.map((r) => r.id));
-    const rawSnapshots = app.db.select().from(querySnapshots).where(inArray(querySnapshots.runId, [...runIds])).all();
+    const rawSnapshots = app.db.select().from(querySnapshots).where(inArray2(querySnapshots.runId, [...runIds])).all();
     const timelineLocationFilter = request.query.location;
     const filteredSnapshots = timelineLocationFilter !== void 0 ? rawSnapshots.filter((s) => s.location === (timelineLocationFilter || null)) : rawSnapshots;
     const allSnapshots = filteredSnapshots.map((snapshot) => ({
@@ -2517,7 +2551,7 @@ function formatAuditEntry(row) {
 }
 
 // ../api-routes/src/analytics.ts
-import { eq as eq10, desc as desc3, inArray as inArray2 } from "drizzle-orm";
+import { eq as eq10, desc as desc3, inArray as inArray3 } from "drizzle-orm";
 async function analyticsRoutes(app) {
   app.get("/projects/:name/analytics/metrics", async (request, reply) => {
     const project = resolveProject(app.db, request.params.name);
@@ -2544,7 +2578,7 @@ async function analyticsRoutes(app) {
       answerMentioned: querySnapshots.answerMentioned,
       answerText: querySnapshots.answerText,
       createdAt: querySnapshots.createdAt
-    }).from(querySnapshots).where(inArray2(querySnapshots.runId, runIds)).all());
+    }).from(querySnapshots).where(inArray3(querySnapshots.runId, runIds)).all());
     const allSnapshots = rawSnapshots.map((s) => ({
       ...s,
       resolvedMentioned: resolveSnapshotAnswerMentioned(s, project)
@@ -2589,7 +2623,7 @@ async function analyticsRoutes(app) {
         citationState: querySnapshots.citationState,
         answerMentioned: querySnapshots.answerMentioned,
         answerText: querySnapshots.answerText
-      }).from(querySnapshots).where(inArray2(querySnapshots.runId, windowRunIds)).all());
+      }).from(querySnapshots).where(inArray3(querySnapshots.runId, windowRunIds)).all());
       for (const s of allWindowSnaps) {
         const timePoint = runIdToCreatedAt.get(s.runId) ?? s.runId;
         let entry = consistencyMap.get(s.queryId);
@@ -2610,7 +2644,7 @@ async function analyticsRoutes(app) {
       answerMentioned: querySnapshots.answerMentioned,
       answerText: querySnapshots.answerText,
       competitorOverlap: querySnapshots.competitorOverlap
-    }).from(querySnapshots).leftJoin(queries, eq10(querySnapshots.queryId, queries.id)).where(inArray2(querySnapshots.runId, latestGroupRunIds)).all());
+    }).from(querySnapshots).leftJoin(queries, eq10(querySnapshots.queryId, queries.id)).where(inArray3(querySnapshots.runId, latestGroupRunIds)).all());
     const snapshots = rawSnapshots.map((s) => ({
       ...s,
       resolvedMentioned: resolveSnapshotAnswerMentioned(s, project)
@@ -2705,7 +2739,7 @@ async function analyticsRoutes(app) {
       queryId: querySnapshots.queryId,
       query: queries.query,
       rawResponse: querySnapshots.rawResponse
-    }).from(querySnapshots).leftJoin(queries, eq10(querySnapshots.queryId, queries.id)).where(inArray2(querySnapshots.runId, windowRunIds)).all();
+    }).from(querySnapshots).leftJoin(queries, eq10(querySnapshots.queryId, queries.id)).where(inArray3(querySnapshots.runId, windowRunIds)).all();
     const overallCounts = /* @__PURE__ */ new Map();
     const byQuery = {};
     for (const snap of snapshots) {
@@ -2864,7 +2898,7 @@ function buildCategoryCounts(counts) {
 }
 
 // ../api-routes/src/intelligence.ts
-import { eq as eq11, desc as desc4, and as and4, inArray as inArray3 } from "drizzle-orm";
+import { eq as eq11, desc as desc4, and as and4, inArray as inArray4 } from "drizzle-orm";
 function emptyHealthSnapshot(projectId) {
   return {
     id: `no-data:${projectId}`,
@@ -2980,14 +3014,14 @@ async function intelligenceRoutes(app) {
     const projectVisRuns = app.db.select({ id: runs.id, createdAt: runs.createdAt }).from(runs).where(and4(
       eq11(runs.projectId, project.id),
       eq11(runs.kind, RunKinds["answer-visibility"]),
-      inArray3(runs.status, [RunStatuses.completed, RunStatuses.partial])
+      inArray4(runs.status, [RunStatuses.completed, RunStatuses.partial])
     )).orderBy(desc4(runs.createdAt), desc4(runs.id)).all();
     const latestGroup = groupRunsByCreatedAt(projectVisRuns)[0] ?? [];
     const latestGroupRunIds = latestGroup.map((r) => r.id);
     if (latestGroupRunIds.length > 0) {
       const groupRows = app.db.select().from(healthSnapshots).where(and4(
         eq11(healthSnapshots.projectId, project.id),
-        inArray3(healthSnapshots.runId, latestGroupRunIds)
+        inArray4(healthSnapshots.runId, latestGroupRunIds)
       )).all();
       if (groupRows.length > 0) {
         return reply.send(aggregateHealthSnapshots(project.id, groupRows));
@@ -3009,7 +3043,7 @@ async function intelligenceRoutes(app) {
 }
 
 // ../api-routes/src/report.ts
-import { and as and6, desc as desc6, eq as eq13, gte, inArray as inArray5, lt, lte, ne, or as or3, sql as sql4 } from "drizzle-orm";
+import { and as and6, desc as desc6, eq as eq13, gte, inArray as inArray6, lt, lte, ne, or as or3, sql as sql5 } from "drizzle-orm";
 
 // ../api-routes/src/report-renderer.ts
 var COLORS = {
@@ -5245,7 +5279,7 @@ function renderReportHtml(report, opts = {}) {
 }
 
 // ../api-routes/src/content-data.ts
-import { and as and5, eq as eq12, desc as desc5, inArray as inArray4 } from "drizzle-orm";
+import { and as and5, eq as eq12, desc as desc5, inArray as inArray5 } from "drizzle-orm";
 var RECENT_RUNS_WINDOW = 5;
 function loadOrchestratorInput(db, project, locationFilter = void 0) {
   const projectId = project.id;
@@ -5375,7 +5409,7 @@ function listRecentAnswerVisibilityRunIds(db, projectId, limit, locationFilter)
       // Queued/running/failed/cancelled runs may have partial or no
       // snapshots; including them risks pointing latestRunId at a run with
       // no usable evidence.
-      inArray4(runs.status, [RunStatuses.completed, RunStatuses.partial])
+      inArray5(runs.status, [RunStatuses.completed, RunStatuses.partial])
     )
   ).orderBy(desc5(runs.createdAt)).all();
   const filtered = locationFilter === void 0 ? rows : rows.filter((r) => (r.location ?? null) === locationFilter);
@@ -5417,7 +5451,7 @@ function buildCandidateQueries(opts) {
   const queryRows = opts.db.select({ id: queries.id, text: queries.query }).from(queries).where(eq12(queries.projectId, opts.projectId)).all();
   const queryIdByText = new Map(queryRows.map((r) => [r.text, r.id]));
   const candidateQueryIds = opts.candidateQueryStrings.map((q) => queryIdByText.get(q)).filter((id) => Boolean(id));
-  const snapshotRows = filterTrackedSnapshots(opts.db.select().from(querySnapshots).where(inArray4(querySnapshots.runId, opts.recentRunIds)).all()).filter((r) => candidateQueryIds.includes(r.queryId));
+  const snapshotRows = filterTrackedSnapshots(opts.db.select().from(querySnapshots).where(inArray5(querySnapshots.runId, opts.recentRunIds)).all()).filter((r) => candidateQueryIds.includes(r.queryId));
   const snapshotsByQuery = /* @__PURE__ */ new Map();
   for (const row of snapshotRows) {
     const list = snapshotsByQuery.get(row.queryId) ?? [];
@@ -5635,7 +5669,7 @@ function loadSnapshotsForRun(db, runId) {
 }
 function loadSnapshotsForRunIds(db, runIds) {
   if (runIds.length === 0) return [];
-  const rows = db.select().from(querySnapshots).where(inArray5(querySnapshots.runId, [...runIds])).all();
+  const rows = db.select().from(querySnapshots).where(inArray6(querySnapshots.runId, [...runIds])).all();
   return rows.filter((r) => r.queryId !== null).map((r) => ({
     id: r.id,
     runId: r.runId,
@@ -5885,7 +5919,7 @@ function buildAiReferrals(db, projectId) {
   return { totalSessions: total, totalUsers, bySource, trend, topLandingPages };
 }
 function nonSubresourceReferralPathCondition() {
-  return sql4`
+  return sql5`
     LOWER(${aiReferralEventsHourly.landingPathNormalized}) NOT LIKE '/_next/static/%'
     AND LOWER(${aiReferralEventsHourly.landingPathNormalized}) NOT LIKE '/assets/%'
     AND LOWER(${aiReferralEventsHourly.landingPathNormalized}) NOT LIKE '/static/%'
@@ -5924,7 +5958,7 @@ function buildServerActivity(db, projectId) {
   const priorStart = new Date(priorStartMs).toISOString();
   const trendStart = new Date(trendStartMs).toISOString();
   const sumVerifiedCrawlers = (windowStartIso, windowEndIso, exclusiveEnd = false) => Number(
-    db.select({ total: sql4`COALESCE(SUM(${crawlerEventsHourly.hits}), 0)` }).from(crawlerEventsHourly).where(
+    db.select({ total: sql5`COALESCE(SUM(${crawlerEventsHourly.hits}), 0)` }).from(crawlerEventsHourly).where(
       and6(
         eq13(crawlerEventsHourly.projectId, projectId),
         eq13(crawlerEventsHourly.verificationStatus, VerificationStatuses.verified),
@@ -5934,7 +5968,7 @@ function buildServerActivity(db, projectId) {
     ).get()?.total ?? 0
   );
   const sumUnverifiedCrawlers = (windowStartIso, windowEndIso, exclusiveEnd = false) => Number(
-    db.select({ total: sql4`COALESCE(SUM(${crawlerEventsHourly.hits}), 0)` }).from(crawlerEventsHourly).where(
+    db.select({ total: sql5`COALESCE(SUM(${crawlerEventsHourly.hits}), 0)` }).from(crawlerEventsHourly).where(
       and6(
         eq13(crawlerEventsHourly.projectId, projectId),
         ne(crawlerEventsHourly.verificationStatus, VerificationStatuses.verified),
@@ -5944,7 +5978,7 @@ function buildServerActivity(db, projectId) {
     ).get()?.total ?? 0
   );
   const sumReferrals = (windowStartIso, windowEndIso, exclusiveEnd = false) => Number(
-    db.select({ total: sql4`COALESCE(SUM(${aiReferralEventsHourly.sessionsOrHits}), 0)` }).from(aiReferralEventsHourly).where(
+    db.select({ total: sql5`COALESCE(SUM(${aiReferralEventsHourly.sessionsOrHits}), 0)` }).from(aiReferralEventsHourly).where(
       and6(
         eq13(aiReferralEventsHourly.projectId, projectId),
         nonSubresourceReferralPathCondition(),
@@ -5962,7 +5996,7 @@ function buildServerActivity(db, projectId) {
   const crawlerByOperatorRows = db.select({
     operator: crawlerEventsHourly.operator,
     verificationStatus: crawlerEventsHourly.verificationStatus,
-    hits: sql4`COALESCE(SUM(${crawlerEventsHourly.hits}), 0)`
+    hits: sql5`COALESCE(SUM(${crawlerEventsHourly.hits}), 0)`
   }).from(crawlerEventsHourly).where(
     and6(
       eq13(crawlerEventsHourly.projectId, projectId),
@@ -5972,7 +6006,7 @@ function buildServerActivity(db, projectId) {
   ).groupBy(crawlerEventsHourly.operator, crawlerEventsHourly.verificationStatus).all();
   const crawlerByOperatorPriorRows = db.select({
     operator: crawlerEventsHourly.operator,
-    hits: sql4`COALESCE(SUM(${crawlerEventsHourly.hits}), 0)`
+    hits: sql5`COALESCE(SUM(${crawlerEventsHourly.hits}), 0)`
   }).from(crawlerEventsHourly).where(
     and6(
       eq13(crawlerEventsHourly.projectId, projectId),
@@ -5983,7 +6017,7 @@ function buildServerActivity(db, projectId) {
   ).groupBy(crawlerEventsHourly.operator).all();
   const referralByOperatorRows = db.select({
     operator: aiReferralEventsHourly.operator,
-    hits: sql4`COALESCE(SUM(${aiReferralEventsHourly.sessionsOrHits}), 0)`
+    hits: sql5`COALESCE(SUM(${aiReferralEventsHourly.sessionsOrHits}), 0)`
   }).from(aiReferralEventsHourly).where(
     and6(
       eq13(aiReferralEventsHourly.projectId, projectId),
@@ -6023,8 +6057,8 @@ function buildServerActivity(db, projectId) {
   );
   const topPathsRows = db.select({
     path: crawlerEventsHourly.pathNormalized,
-    hits: sql4`COALESCE(SUM(${crawlerEventsHourly.hits}), 0)`,
-    operators: sql4`COUNT(DISTINCT ${crawlerEventsHourly.operator})`
+    hits: sql5`COALESCE(SUM(${crawlerEventsHourly.hits}), 0)`,
+    operators: sql5`COUNT(DISTINCT ${crawlerEventsHourly.operator})`
   }).from(crawlerEventsHourly).where(
     and6(
       eq13(crawlerEventsHourly.projectId, projectId),
@@ -6032,7 +6066,7 @@ function buildServerActivity(db, projectId) {
       gte(crawlerEventsHourly.tsHour, headlineStart),
       lte(crawlerEventsHourly.tsHour, headlineEnd)
     )
-  ).groupBy(crawlerEventsHourly.pathNormalized).orderBy(desc6(sql4`SUM(${crawlerEventsHourly.hits})`)).limit(SERVER_ACTIVITY_TOP_PATHS_LIMIT).all();
+  ).groupBy(crawlerEventsHourly.pathNormalized).orderBy(desc6(sql5`SUM(${crawlerEventsHourly.hits})`)).limit(SERVER_ACTIVITY_TOP_PATHS_LIMIT).all();
   const topCrawledPaths = topPathsRows.map((r) => ({
     path: r.path,
     verifiedHits: Number(r.hits),
@@ -6040,8 +6074,8 @@ function buildServerActivity(db, projectId) {
   }));
   const referralProductsRows = db.select({
     product: aiReferralEventsHourly.product,
-    arrivals: sql4`COALESCE(SUM(${aiReferralEventsHourly.sessionsOrHits}), 0)`,
-    landingPaths: sql4`COUNT(DISTINCT ${aiReferralEventsHourly.landingPathNormalized})`
+    arrivals: sql5`COALESCE(SUM(${aiReferralEventsHourly.sessionsOrHits}), 0)`,
+    landingPaths: sql5`COUNT(DISTINCT ${aiReferralEventsHourly.landingPathNormalized})`
   }).from(aiReferralEventsHourly).where(
     and6(
       eq13(aiReferralEventsHourly.projectId, projectId),
@@ -6049,7 +6083,7 @@ function buildServerActivity(db, projectId) {
       gte(aiReferralEventsHourly.tsHour, headlineStart),
       lte(aiReferralEventsHourly.tsHour, headlineEnd)
     )
-  ).groupBy(aiReferralEventsHourly.product).orderBy(desc6(sql4`SUM(${aiReferralEventsHourly.sessionsOrHits})`)).all();
+  ).groupBy(aiReferralEventsHourly.product).orderBy(desc6(sql5`SUM(${aiReferralEventsHourly.sessionsOrHits})`)).all();
   const referralProducts = referralProductsRows.map((r) => ({
     product: r.product,
     arrivals: Number(r.arrivals),
@@ -6057,8 +6091,8 @@ function buildServerActivity(db, projectId) {
   }));
   const topReferralRows = db.select({
     path: aiReferralEventsHourly.landingPathNormalized,
-    arrivals: sql4`COALESCE(SUM(${aiReferralEventsHourly.sessionsOrHits}), 0)`,
-    products: sql4`COUNT(DISTINCT ${aiReferralEventsHourly.product})`
+    arrivals: sql5`COALESCE(SUM(${aiReferralEventsHourly.sessionsOrHits}), 0)`,
+    products: sql5`COUNT(DISTINCT ${aiReferralEventsHourly.product})`
   }).from(aiReferralEventsHourly).where(
     and6(
       eq13(aiReferralEventsHourly.projectId, projectId),
@@ -6066,15 +6100,15 @@ function buildServerActivity(db, projectId) {
       gte(aiReferralEventsHourly.tsHour, headlineStart),
       lte(aiReferralEventsHourly.tsHour, headlineEnd)
     )
-  ).groupBy(aiReferralEventsHourly.landingPathNormalized).orderBy(desc6(sql4`SUM(${aiReferralEventsHourly.sessionsOrHits})`)).limit(SERVER_ACTIVITY_TOP_PATHS_LIMIT).all();
+  ).groupBy(aiReferralEventsHourly.landingPathNormalized).orderBy(desc6(sql5`SUM(${aiReferralEventsHourly.sessionsOrHits})`)).limit(SERVER_ACTIVITY_TOP_PATHS_LIMIT).all();
   const topReferralLandingPaths = topReferralRows.map((r) => ({
     path: r.path,
     arrivals: Number(r.arrivals),
     distinctProducts: Number(r.products)
   }));
   const crawlerTrendRows = db.select({
-    date: sql4`SUBSTR(${crawlerEventsHourly.tsHour}, 1, 10)`,
-    hits: sql4`COALESCE(SUM(${crawlerEventsHourly.hits}), 0)`
+    date: sql5`SUBSTR(${crawlerEventsHourly.tsHour}, 1, 10)`,
+    hits: sql5`COALESCE(SUM(${crawlerEventsHourly.hits}), 0)`
   }).from(crawlerEventsHourly).where(
     and6(
       eq13(crawlerEventsHourly.projectId, projectId),
@@ -6082,10 +6116,10 @@ function buildServerActivity(db, projectId) {
       gte(crawlerEventsHourly.tsHour, trendStart),
       lte(crawlerEventsHourly.tsHour, headlineEnd)
     )
-  ).groupBy(sql4`SUBSTR(${crawlerEventsHourly.tsHour}, 1, 10)`).all();
+  ).groupBy(sql5`SUBSTR(${crawlerEventsHourly.tsHour}, 1, 10)`).all();
   const referralTrendRows = db.select({
-    date: sql4`SUBSTR(${aiReferralEventsHourly.tsHour}, 1, 10)`,
-    hits: sql4`COALESCE(SUM(${aiReferralEventsHourly.sessionsOrHits}), 0)`
+    date: sql5`SUBSTR(${aiReferralEventsHourly.tsHour}, 1, 10)`,
+    hits: sql5`COALESCE(SUM(${aiReferralEventsHourly.sessionsOrHits}), 0)`
   }).from(aiReferralEventsHourly).where(
     and6(
       eq13(aiReferralEventsHourly.projectId, projectId),
@@ -6093,7 +6127,7 @@ function buildServerActivity(db, projectId) {
       gte(aiReferralEventsHourly.tsHour, trendStart),
       lte(aiReferralEventsHourly.tsHour, headlineEnd)
     )
-  ).groupBy(sql4`SUBSTR(${aiReferralEventsHourly.tsHour}, 1, 10)`).all();
+  ).groupBy(sql5`SUBSTR(${aiReferralEventsHourly.tsHour}, 1, 10)`).all();
   const dailyTrendMap = /* @__PURE__ */ new Map();
   for (const r of crawlerTrendRows) {
     const e = dailyTrendMap.get(r.date) ?? { verifiedCrawlerHits: 0, referralArrivals: 0 };
@@ -6215,7 +6249,7 @@ function buildInsightList(db, projectId, locationFilter) {
     )
   ).orderBy(desc6(runs.createdAt)).all().filter((r) => locationFilter === void 0 || (r.location ?? null) === locationFilter).slice(0, INSIGHT_LOOKBACK_RUNS).map((r) => r.id);
   if (recentRunIds.length === 0) return [];
-  const rows = db.select().from(insights).where(and6(eq13(insights.projectId, projectId), inArray5(insights.runId, recentRunIds))).orderBy(desc6(insights.createdAt)).all();
+  const rows = db.select().from(insights).where(and6(eq13(insights.projectId, projectId), inArray6(insights.runId, recentRunIds))).orderBy(desc6(insights.createdAt)).all();
   const severityRank = { critical: 0, high: 1, medium: 2, low: 3 };
   const flat = rows.filter((r) => !r.dismissed).map((r) => {
     const recommendation = parseJsonColumn(r.recommendation, null);
@@ -6988,7 +7022,7 @@ async function reportRoutes(app) {
 }
 
 // ../api-routes/src/citations.ts
-import { eq as eq14, inArray as inArray6 } from "drizzle-orm";
+import { eq as eq14, inArray as inArray7 } from "drizzle-orm";
 async function citationRoutes(app) {
   app.get("/projects/:name/citations/visibility", async (request, reply) => {
     const project = resolveProject(app.db, request.params.name);
@@ -7012,7 +7046,7 @@ async function citationRoutes(app) {
       competitorOverlap: querySnapshots.competitorOverlap,
       answerMentioned: querySnapshots.answerMentioned,
       createdAt: querySnapshots.createdAt
-    }).from(querySnapshots).where(inArray6(querySnapshots.runId, projectRuns.map((r) => r.id))).all();
+    }).from(querySnapshots).where(inArray7(querySnapshots.runId, projectRuns.map((r) => r.id))).all();
     if (rawSnapshots.length === 0) {
       return reply.send(emptyCitationVisibility("no-runs-yet"));
     }
@@ -7153,7 +7187,7 @@ function normalizeDomain2(domain) {
 }
 
 // ../api-routes/src/composites.ts
-import { eq as eq15, and as and7, desc as desc7, sql as sql5, like, or as or4, inArray as inArray7 } from "drizzle-orm";
+import { eq as eq15, and as and7, desc as desc7, sql as sql6, like, or as or4, inArray as inArray8 } from "drizzle-orm";
 var TOP_INSIGHT_LIMIT = 5;
 var SEARCH_HIT_HARD_LIMIT = 50;
 var SEARCH_SNIPPET_RADIUS = 80;
@@ -7205,10 +7239,19 @@ async function compositeRoutes(app) {
     const projectQueries = app.db.select({ id: queries.id, query: queries.query }).from(queries).where(eq15(queries.projectId, project.id)).all();
     const queryLookup = { byId: new Map(projectQueries.map((q) => [q.id, q.query])) };
     const configuredApiProviders = parseJsonColumn(project.providers, []).filter((p) => !p.startsWith("cdp:"));
+    const projectDomains = effectiveDomains({
+      canonicalDomain: project.canonicalDomain,
+      ownedDomains: parseJsonColumn(project.ownedDomains, [])
+    });
     const scores = {
       mention: buildMentionCoverage(latestSnapshots, { configuredApiProviders }),
       visibility: buildVisibilityScore(latestSnapshots, { configuredApiProviders }),
+      shareOfVoice: buildShareOfVoice(latestSnapshots, {
+        projectDomains,
+        competitorDomains: competitorRows.map((c) => c.domain)
+      }),
       gapQueries: buildGapQueryScore(latestSnapshots),
+      mentionGaps: buildMentionGapScore(latestSnapshots),
       indexCoverage: buildIndexCoverageScore(app, project.id),
       competitorPressure: buildCompetitorPressureScore(
         latestSnapshots,
@@ -7217,8 +7260,19 @@ async function compositeRoutes(app) {
       ),
       runStatus: buildRunStatusScore(allRuns)
     };
-    const movementSummary = buildMovementSummary(latestSnapshots, previousSnapshots);
-    const providerScores = buildProviderScores(latestSnapshots);
+    const movementSummary = buildMovementSummary(latestSnapshots, previousSnapshots, {
+      queryLookup: queryLookup.byId
+    });
+    const providerScoresBase = buildProviderScores(latestSnapshots);
+    const providerTrends = buildProviderTrends(
+      visibilityRuns.slice(0, DEFAULT_RUN_HISTORY_LIMIT).map((r) => ({ id: r.id, createdAt: r.createdAt })),
+      snapshotsByRun,
+      DEFAULT_RUN_HISTORY_LIMIT
+    );
+    const providerScores = providerScoresBase.map((score) => {
+      const trend = providerTrends.get(providerKey(score.provider, score.model)) ?? [];
+      return trend.length > 1 ? { ...score, trend: trend.map((p) => p.rate) } : score;
+    });
     const overviewCompetitors = buildOverviewCompetitors(
       latestSnapshots,
       competitorRows.map((c) => ({ id: c.id, domain: c.domain })),
@@ -7271,9 +7325,9 @@ async function compositeRoutes(app) {
       and7(
         eq15(queries.projectId, project.id),
         or4(
-          sql5`${querySnapshots.answerText} LIKE ${pattern} ESCAPE '\\'`,
-          sql5`${querySnapshots.citedDomains} LIKE ${pattern} ESCAPE '\\'`,
-          sql5`${querySnapshots.rawResponse} LIKE ${pattern} ESCAPE '\\'`,
+          sql6`${querySnapshots.answerText} LIKE ${pattern} ESCAPE '\\'`,
+          sql6`${querySnapshots.citedDomains} LIKE ${pattern} ESCAPE '\\'`,
+          sql6`${querySnapshots.rawResponse} LIKE ${pattern} ESCAPE '\\'`,
           like(queries.query, pattern)
         )
       )
@@ -7284,8 +7338,8 @@ async function compositeRoutes(app) {
         or4(
           like(insights.title, pattern),
           like(insights.query, pattern),
-          sql5`${insights.recommendation} LIKE ${pattern} ESCAPE '\\'`,
-          sql5`${insights.cause} LIKE ${pattern} ESCAPE '\\'`
+          sql6`${insights.recommendation} LIKE ${pattern} ESCAPE '\\'`,
+          sql6`${insights.cause} LIKE ${pattern} ESCAPE '\\'`
         )
       )
     ).orderBy(desc7(insights.createdAt)).limit(limit + 1).all();
@@ -7360,7 +7414,7 @@ function loadSnapshotsByRunIds(app, runIds) {
     answerMentioned: querySnapshots.answerMentioned,
     competitorOverlap: querySnapshots.competitorOverlap,
     citedDomains: querySnapshots.citedDomains
-  }).from(querySnapshots).where(inArray7(querySnapshots.runId, [...runIds])).all());
+  }).from(querySnapshots).where(inArray8(querySnapshots.runId, [...runIds])).all());
   for (const row of rows) {
     const list = result.get(row.runId) ?? [];
     list.push({
@@ -8139,6 +8193,32 @@ var routeCatalog = [
       200: { description: "Queries appended." }
     }
   },
+  {
+    method: "post",
+    path: "/api/v1/projects/{name}/queries/replace-preview",
+    summary: "Preview the impact of replacing tracked queries",
+    description: "Read-only impact summary backing `canonry query replace --dry-run`. Returns current vs proposed query sets, the added/removed/unchanged diff, and the count of snapshots that would detach (queryId \u2192 NULL; queryText preserved).",
+    tags: ["queries"],
+    parameters: [nameParameter],
+    requestBody: {
+      required: true,
+      content: {
+        "application/json": {
+          schema: {
+            type: "object",
+            required: ["queries"],
+            properties: {
+              queries: stringArraySchema
+            }
+          }
+        }
+      }
+    },
+    responses: {
+      200: { description: "Replace preview returned." },
+      404: { description: "Project not found." }
+    }
+  },
   {
     method: "post",
     path: "/api/v1/projects/{name}/queries/generate",
@@ -11418,7 +11498,7 @@ function formatNotification(row) {
 
 // ../api-routes/src/google.ts
 import crypto14 from "crypto";
-import { eq as eq18, and as and9, desc as desc8, sql as sql6 } from "drizzle-orm";
+import { eq as eq18, and as and9, desc as desc8, sql as sql7 } from "drizzle-orm";
 
 // ../integration-google/src/constants.ts
 var GOOGLE_AUTH_URL = "https://accounts.google.com/o/oauth2/v2/auth";
@@ -12644,11 +12724,11 @@ async function googleRoutes(app, opts) {
     const { startDate, endDate, query, page, limit, offset } = request.query;
     const cutoffDate = !startDate ? windowCutoff(parseWindow(request.query.window))?.slice(0, 10) ?? null : null;
     const conditions = [eq18(gscSearchData.projectId, project.id)];
-    if (startDate) conditions.push(sql6`${gscSearchData.date} >= ${startDate}`);
-    else if (cutoffDate) conditions.push(sql6`${gscSearchData.date} >= ${cutoffDate}`);
-    if (endDate) conditions.push(sql6`${gscSearchData.date} <= ${endDate}`);
-    if (query) conditions.push(sql6`${gscSearchData.query} LIKE ${"%" + query + "%"}`);
-    if (page) conditions.push(sql6`${gscSearchData.page} LIKE ${"%" + page + "%"}`);
+    if (startDate) conditions.push(sql7`${gscSearchData.date} >= ${startDate}`);
+    else if (cutoffDate) conditions.push(sql7`${gscSearchData.date} >= ${cutoffDate}`);
+    if (endDate) conditions.push(sql7`${gscSearchData.date} <= ${endDate}`);
+    if (query) conditions.push(sql7`${gscSearchData.query} LIKE ${"%" + query + "%"}`);
+    if (page) conditions.push(sql7`${gscSearchData.page} LIKE ${"%" + page + "%"}`);
     const limitVal = Math.max(parseInt(limit ?? "500", 10) || 0, 1);
     const offsetVal = Math.max(parseInt(offset ?? "0", 10) || 0, 0);
     const rows = app.db.select().from(gscSearchData).where(and9(...conditions)).orderBy(desc8(gscSearchData.date)).limit(limitVal).offset(offsetVal).all();
@@ -13893,7 +13973,7 @@ async function cdpRoutes(app, opts) {
 
 // ../api-routes/src/ga.ts
 import crypto16 from "crypto";
-import { eq as eq21, desc as desc10, and as and12, sql as sql7 } from "drizzle-orm";
+import { eq as eq21, desc as desc10, and as and12, sql as sql8 } from "drizzle-orm";
 function gaLog(level, action, ctx) {
   const entry = { ts: (/* @__PURE__ */ new Date()).toISOString(), level, module: "GA4Routes", action, ...ctx };
   const stream = level === "error" ? process.stderr : process.stdout;
@@ -14190,8 +14270,8 @@ async function ga4Routes(app, opts) {
           tx.delete(gaTrafficSnapshots).where(
             and12(
               eq21(gaTrafficSnapshots.projectId, project.id),
-              sql7`${gaTrafficSnapshots.date} >= ${summary.periodStart}`,
-              sql7`${gaTrafficSnapshots.date} <= ${summary.periodEnd}`
+              sql8`${gaTrafficSnapshots.date} >= ${summary.periodStart}`,
+              sql8`${gaTrafficSnapshots.date} <= ${summary.periodEnd}`
             )
           ).run();
           for (const row of rows) {
@@ -14214,8 +14294,8 @@ async function ga4Routes(app, opts) {
           tx.delete(gaAiReferrals).where(
             and12(
               eq21(gaAiReferrals.projectId, project.id),
-              sql7`${gaAiReferrals.date} >= ${summary.periodStart}`,
-              sql7`${gaAiReferrals.date} <= ${summary.periodEnd}`
+              sql8`${gaAiReferrals.date} >= ${summary.periodStart}`,
+              sql8`${gaAiReferrals.date} <= ${summary.periodEnd}`
             )
           ).run();
           for (const row of aiReferrals) {
@@ -14240,8 +14320,8 @@ async function ga4Routes(app, opts) {
           tx.delete(gaSocialReferrals).where(
             and12(
               eq21(gaSocialReferrals.projectId, project.id),
-              sql7`${gaSocialReferrals.date} >= ${summary.periodStart}`,
-              sql7`${gaSocialReferrals.date} <= ${summary.periodEnd}`
+              sql8`${gaSocialReferrals.date} >= ${summary.periodStart}`,
+              sql8`${gaSocialReferrals.date} <= ${summary.periodEnd}`
             )
           ).run();
           for (const row of socialReferrals) {
@@ -14331,11 +14411,11 @@ async function ga4Routes(app, opts) {
     const cutoff = windowCutoff(window);
     const cutoffDate = cutoff?.slice(0, 10) ?? null;
     const snapshotConditions = [eq21(gaTrafficSnapshots.projectId, project.id)];
-    if (cutoffDate) snapshotConditions.push(sql7`${gaTrafficSnapshots.date} >= ${cutoffDate}`);
+    if (cutoffDate) snapshotConditions.push(sql8`${gaTrafficSnapshots.date} >= ${cutoffDate}`);
     const aiConditions = [eq21(gaAiReferrals.projectId, project.id)];
-    if (cutoffDate) aiConditions.push(sql7`${gaAiReferrals.date} >= ${cutoffDate}`);
+    if (cutoffDate) aiConditions.push(sql8`${gaAiReferrals.date} >= ${cutoffDate}`);
     const socialConditions = [eq21(gaSocialReferrals.projectId, project.id)];
-    if (cutoffDate) socialConditions.push(sql7`${gaSocialReferrals.date} >= ${cutoffDate}`);
+    if (cutoffDate) socialConditions.push(sql8`${gaSocialReferrals.date} >= ${cutoffDate}`);
     const windowSummaryRow = cutoffDate ? app.db.select({
       totalSessions: gaTrafficWindowSummaries.totalSessions,
       totalOrganicSessions: gaTrafficWindowSummaries.totalOrganicSessions,
@@ -14348,9 +14428,9 @@ async function ga4Routes(app, opts) {
       )
     ).get() : null;
     const snapshotTotalsRow = cutoffDate && !windowSummaryRow ? app.db.select({
-      totalSessions: sql7`COALESCE(SUM(${gaTrafficSnapshots.sessions}), 0)`,
-      totalOrganicSessions: sql7`COALESCE(SUM(${gaTrafficSnapshots.organicSessions}), 0)`,
-      totalUsers: sql7`COALESCE(SUM(${gaTrafficSnapshots.users}), 0)`
+      totalSessions: sql8`COALESCE(SUM(${gaTrafficSnapshots.sessions}), 0)`,
+      totalOrganicSessions: sql8`COALESCE(SUM(${gaTrafficSnapshots.organicSessions}), 0)`,
+      totalUsers: sql8`COALESCE(SUM(${gaTrafficSnapshots.users}), 0)`
     }).from(gaTrafficSnapshots).where(and12(...snapshotConditions)).get() : null;
     const summaryRow = cutoffDate ? windowSummaryRow ?? snapshotTotalsRow : app.db.select({
       totalSessions: gaTrafficSummaries.totalSessions,
@@ -14358,38 +14438,38 @@ async function ga4Routes(app, opts) {
       totalUsers: gaTrafficSummaries.totalUsers
     }).from(gaTrafficSummaries).where(eq21(gaTrafficSummaries.projectId, project.id)).get();
     const directTotalRow = windowSummaryRow ? { totalDirectSessions: windowSummaryRow.totalDirectSessions } : app.db.select({
-      totalDirectSessions: sql7`COALESCE(SUM(${gaTrafficSnapshots.directSessions}), 0)`
+      totalDirectSessions: sql8`COALESCE(SUM(${gaTrafficSnapshots.directSessions}), 0)`
     }).from(gaTrafficSnapshots).where(and12(...snapshotConditions)).get();
     const summaryMeta = app.db.select({
       periodStart: gaTrafficSummaries.periodStart,
       periodEnd: gaTrafficSummaries.periodEnd
     }).from(gaTrafficSummaries).where(eq21(gaTrafficSummaries.projectId, project.id)).get();
     const rows = app.db.select({
-      landingPage: sql7`COALESCE(${gaTrafficSnapshots.landingPageNormalized}, ${gaTrafficSnapshots.landingPage})`,
-      sessions: sql7`SUM(${gaTrafficSnapshots.sessions})`,
-      organicSessions: sql7`SUM(${gaTrafficSnapshots.organicSessions})`,
-      directSessions: sql7`COALESCE(SUM(${gaTrafficSnapshots.directSessions}), 0)`,
-      users: sql7`SUM(${gaTrafficSnapshots.users})`
-    }).from(gaTrafficSnapshots).where(and12(...snapshotConditions)).groupBy(sql7`COALESCE(${gaTrafficSnapshots.landingPageNormalized}, ${gaTrafficSnapshots.landingPage})`).orderBy(sql7`SUM(${gaTrafficSnapshots.sessions}) DESC`).limit(limit).all();
+      landingPage: sql8`COALESCE(${gaTrafficSnapshots.landingPageNormalized}, ${gaTrafficSnapshots.landingPage})`,
+      sessions: sql8`SUM(${gaTrafficSnapshots.sessions})`,
+      organicSessions: sql8`SUM(${gaTrafficSnapshots.organicSessions})`,
+      directSessions: sql8`COALESCE(SUM(${gaTrafficSnapshots.directSessions}), 0)`,
+      users: sql8`SUM(${gaTrafficSnapshots.users})`
+    }).from(gaTrafficSnapshots).where(and12(...snapshotConditions)).groupBy(sql8`COALESCE(${gaTrafficSnapshots.landingPageNormalized}, ${gaTrafficSnapshots.landingPage})`).orderBy(sql8`SUM(${gaTrafficSnapshots.sessions}) DESC`).limit(limit).all();
     const aiReferralRows = app.db.select({
       source: gaAiReferrals.source,
       medium: gaAiReferrals.medium,
       sourceDimension: gaAiReferrals.sourceDimension,
-      sessions: sql7`SUM(${gaAiReferrals.sessions})`,
-      users: sql7`SUM(${gaAiReferrals.users})`
+      sessions: sql8`SUM(${gaAiReferrals.sessions})`,
+      users: sql8`SUM(${gaAiReferrals.users})`
     }).from(gaAiReferrals).where(and12(...aiConditions)).groupBy(gaAiReferrals.source, gaAiReferrals.medium, gaAiReferrals.sourceDimension).all();
     const aiReferralLandingPageRows = app.db.select({
       source: gaAiReferrals.source,
       medium: gaAiReferrals.medium,
       sourceDimension: gaAiReferrals.sourceDimension,
-      landingPage: sql7`COALESCE(${gaAiReferrals.landingPageNormalized}, ${gaAiReferrals.landingPage})`,
-      sessions: sql7`SUM(${gaAiReferrals.sessions})`,
-      users: sql7`SUM(${gaAiReferrals.users})`
+      landingPage: sql8`COALESCE(${gaAiReferrals.landingPageNormalized}, ${gaAiReferrals.landingPage})`,
+      sessions: sql8`SUM(${gaAiReferrals.sessions})`,
+      users: sql8`SUM(${gaAiReferrals.users})`
     }).from(gaAiReferrals).where(and12(...aiConditions)).groupBy(
       gaAiReferrals.source,
       gaAiReferrals.medium,
       gaAiReferrals.sourceDimension,
-      sql7`COALESCE(${gaAiReferrals.landingPageNormalized}, ${gaAiReferrals.landingPage})`
+      sql8`COALESCE(${gaAiReferrals.landingPageNormalized}, ${gaAiReferrals.landingPage})`
     ).all();
     const aiReferrals = pickWinningDimension(
       aiReferralRows,
@@ -14400,10 +14480,10 @@ async function ga4Routes(app, opts) {
       (r) => `${r.source}\0${r.medium}\0${r.landingPage}`
     );
     const aiDeduped = app.db.select({
-      sessions: sql7`COALESCE(SUM(max_sessions), 0)`,
-      users: sql7`COALESCE(SUM(max_users), 0)`
+      sessions: sql8`COALESCE(SUM(max_sessions), 0)`,
+      users: sql8`COALESCE(SUM(max_users), 0)`
     }).from(
-      sql7`(
+      sql8`(
           SELECT date, source, medium,
                  MAX(dimension_sessions) AS max_sessions,
                  MAX(dimension_users) AS max_users
@@ -14412,7 +14492,7 @@ async function ga4Routes(app, opts) {
                    SUM(sessions) AS dimension_sessions,
                    SUM(users) AS dimension_users
             FROM ga_ai_referrals
-            WHERE project_id = ${project.id}${cutoffDate ? sql7` AND date >= ${cutoffDate}` : sql7``}
+            WHERE project_id = ${project.id}${cutoffDate ? sql8` AND date >= ${cutoffDate}` : sql8``}
             GROUP BY date, source, medium, source_dimension
           )
           GROUP BY date, source, medium
@@ -14420,8 +14500,8 @@ async function ga4Routes(app, opts) {
     ).get();
     const aiBySessionRows = app.db.select({
       channelGroup: gaAiReferrals.channelGroup,
-      sessions: sql7`COALESCE(SUM(${gaAiReferrals.sessions}), 0)`,
-      users: sql7`COALESCE(SUM(${gaAiReferrals.users}), 0)`
+      sessions: sql8`COALESCE(SUM(${gaAiReferrals.sessions}), 0)`,
+      users: sql8`COALESCE(SUM(${gaAiReferrals.users}), 0)`
     }).from(gaAiReferrals).where(and12(...aiConditions, eq21(gaAiReferrals.sourceDimension, "session"))).groupBy(gaAiReferrals.channelGroup).all();
     const aiSessionsByChannelGroup = /* @__PURE__ */ new Map();
     let aiBySessionUsers = 0;
@@ -14434,12 +14514,12 @@ async function ga4Routes(app, opts) {
       source: gaSocialReferrals.source,
       medium: gaSocialReferrals.medium,
       channelGroup: gaSocialReferrals.channelGroup,
-      sessions: sql7`SUM(${gaSocialReferrals.sessions})`,
-      users: sql7`SUM(${gaSocialReferrals.users})`
-    }).from(gaSocialReferrals).where(and12(...socialConditions)).groupBy(gaSocialReferrals.source, gaSocialReferrals.medium, gaSocialReferrals.channelGroup).orderBy(sql7`SUM(${gaSocialReferrals.sessions}) DESC`).all();
+      sessions: sql8`SUM(${gaSocialReferrals.sessions})`,
+      users: sql8`SUM(${gaSocialReferrals.users})`
+    }).from(gaSocialReferrals).where(and12(...socialConditions)).groupBy(gaSocialReferrals.source, gaSocialReferrals.medium, gaSocialReferrals.channelGroup).orderBy(sql8`SUM(${gaSocialReferrals.sessions}) DESC`).all();
     const socialTotals = app.db.select({
-      sessions: sql7`SUM(${gaSocialReferrals.sessions})`,
-      users: sql7`SUM(${gaSocialReferrals.users})`
+      sessions: sql8`SUM(${gaSocialReferrals.sessions})`,
+      users: sql8`SUM(${gaSocialReferrals.users})`
     }).from(gaSocialReferrals).where(and12(...socialConditions)).get();
     const latestSync = app.db.select({ syncedAt: gaTrafficSummaries.syncedAt }).from(gaTrafficSummaries).where(eq21(gaTrafficSummaries.projectId, project.id)).orderBy(desc10(gaTrafficSummaries.syncedAt)).limit(1).get();
     const total = summaryRow?.totalSessions ?? 0;
@@ -14522,21 +14602,21 @@ async function ga4Routes(app, opts) {
     requireGa4Connection(opts, project.name, project.canonicalDomain);
     const cutoffDate = windowCutoff(parseWindow(request.query.window))?.slice(0, 10) ?? null;
     const conditions = [eq21(gaAiReferrals.projectId, project.id)];
-    if (cutoffDate) conditions.push(sql7`${gaAiReferrals.date} >= ${cutoffDate}`);
+    if (cutoffDate) conditions.push(sql8`${gaAiReferrals.date} >= ${cutoffDate}`);
     const rows = app.db.select({
       date: gaAiReferrals.date,
       source: gaAiReferrals.source,
       medium: gaAiReferrals.medium,
-      landingPage: sql7`COALESCE(${gaAiReferrals.landingPageNormalized}, ${gaAiReferrals.landingPage})`,
+      landingPage: sql8`COALESCE(${gaAiReferrals.landingPageNormalized}, ${gaAiReferrals.landingPage})`,
       sourceDimension: gaAiReferrals.sourceDimension,
-      sessions: sql7`SUM(${gaAiReferrals.sessions})`,
-      users: sql7`SUM(${gaAiReferrals.users})`
+      sessions: sql8`SUM(${gaAiReferrals.sessions})`,
+      users: sql8`SUM(${gaAiReferrals.users})`
     }).from(gaAiReferrals).where(and12(...conditions)).groupBy(
       gaAiReferrals.date,
       gaAiReferrals.source,
       gaAiReferrals.medium,
       gaAiReferrals.sourceDimension,
-      sql7`COALESCE(${gaAiReferrals.landingPageNormalized}, ${gaAiReferrals.landingPage})`
+      sql8`COALESCE(${gaAiReferrals.landingPageNormalized}, ${gaAiReferrals.landingPage})`
     ).orderBy(gaAiReferrals.date).all();
     return rows;
   });
@@ -14545,7 +14625,7 @@ async function ga4Routes(app, opts) {
     requireGa4Connection(opts, project.name, project.canonicalDomain);
     const cutoffDate = windowCutoff(parseWindow(request.query.window))?.slice(0, 10) ?? null;
     const conditions = [eq21(gaSocialReferrals.projectId, project.id)];
-    if (cutoffDate) conditions.push(sql7`${gaSocialReferrals.date} >= ${cutoffDate}`);
+    if (cutoffDate) conditions.push(sql8`${gaSocialReferrals.date} >= ${cutoffDate}`);
     const rows = app.db.select({
       date: gaSocialReferrals.date,
       source: gaSocialReferrals.source,
@@ -14566,10 +14646,10 @@ async function ga4Routes(app, opts) {
       d.setDate(d.getDate() - n);
       return fmt(d);
     };
-    const sumSocial = (from, to) => app.db.select({ sessions: sql7`COALESCE(SUM(${gaSocialReferrals.sessions}), 0)` }).from(gaSocialReferrals).where(and12(
+    const sumSocial = (from, to) => app.db.select({ sessions: sql8`COALESCE(SUM(${gaSocialReferrals.sessions}), 0)` }).from(gaSocialReferrals).where(and12(
       eq21(gaSocialReferrals.projectId, project.id),
-      sql7`${gaSocialReferrals.date} >= ${from}`,
-      sql7`${gaSocialReferrals.date} < ${to}`
+      sql8`${gaSocialReferrals.date} >= ${from}`,
+      sql8`${gaSocialReferrals.date} < ${to}`
     )).get();
     const current7d = sumSocial(daysAgo2(7), fmt(today));
     const prev7d = sumSocial(daysAgo2(14), daysAgo2(7));
@@ -14578,19 +14658,19 @@ async function ga4Routes(app, opts) {
     const pct = (cur, prev) => prev === 0 ? null : Math.round((cur - prev) / prev * 100);
     const sourceCurrent = app.db.select({
       source: gaSocialReferrals.source,
-      sessions: sql7`SUM(${gaSocialReferrals.sessions})`
+      sessions: sql8`SUM(${gaSocialReferrals.sessions})`
     }).from(gaSocialReferrals).where(and12(
       eq21(gaSocialReferrals.projectId, project.id),
-      sql7`${gaSocialReferrals.date} >= ${daysAgo2(7)}`,
-      sql7`${gaSocialReferrals.date} < ${fmt(today)}`
+      sql8`${gaSocialReferrals.date} >= ${daysAgo2(7)}`,
+      sql8`${gaSocialReferrals.date} < ${fmt(today)}`
     )).groupBy(gaSocialReferrals.source).all();
     const sourcePrev = app.db.select({
       source: gaSocialReferrals.source,
-      sessions: sql7`SUM(${gaSocialReferrals.sessions})`
+      sessions: sql8`SUM(${gaSocialReferrals.sessions})`
     }).from(gaSocialReferrals).where(and12(
       eq21(gaSocialReferrals.projectId, project.id),
-      sql7`${gaSocialReferrals.date} >= ${daysAgo2(14)}`,
-      sql7`${gaSocialReferrals.date} < ${daysAgo2(7)}`
+      sql8`${gaSocialReferrals.date} >= ${daysAgo2(14)}`,
+      sql8`${gaSocialReferrals.date} < ${daysAgo2(7)}`
     )).groupBy(gaSocialReferrals.source).all();
     const prevMap = new Map(sourcePrev.map((r) => [r.source, r.sessions]));
     let biggestMover = null;
@@ -14629,16 +14709,16 @@ async function ga4Routes(app, opts) {
       return fmt(d);
     };
     const pct = (cur, prev) => prev === 0 ? null : Math.round((cur - prev) / prev * 100);
-    const sumTotal = (from, to) => app.db.select({ sessions: sql7`COALESCE(SUM(${gaTrafficSnapshots.sessions}), 0)` }).from(gaTrafficSnapshots).where(and12(eq21(gaTrafficSnapshots.projectId, project.id), sql7`${gaTrafficSnapshots.date} >= ${from}`, sql7`${gaTrafficSnapshots.date} < ${to}`)).get();
-    const sumOrganic = (from, to) => app.db.select({ sessions: sql7`COALESCE(SUM(${gaTrafficSnapshots.organicSessions}), 0)` }).from(gaTrafficSnapshots).where(and12(eq21(gaTrafficSnapshots.projectId, project.id), sql7`${gaTrafficSnapshots.date} >= ${from}`, sql7`${gaTrafficSnapshots.date} < ${to}`)).get();
-    const sumDirect = (from, to) => app.db.select({ sessions: sql7`COALESCE(SUM(${gaTrafficSnapshots.directSessions}), 0)` }).from(gaTrafficSnapshots).where(and12(eq21(gaTrafficSnapshots.projectId, project.id), sql7`${gaTrafficSnapshots.date} >= ${from}`, sql7`${gaTrafficSnapshots.date} < ${to}`)).get();
-    const sumAi = (from, to) => app.db.select({ sessions: sql7`COALESCE(SUM(${gaAiReferrals.sessions}), 0)` }).from(gaAiReferrals).where(and12(
+    const sumTotal = (from, to) => app.db.select({ sessions: sql8`COALESCE(SUM(${gaTrafficSnapshots.sessions}), 0)` }).from(gaTrafficSnapshots).where(and12(eq21(gaTrafficSnapshots.projectId, project.id), sql8`${gaTrafficSnapshots.date} >= ${from}`, sql8`${gaTrafficSnapshots.date} < ${to}`)).get();
+    const sumOrganic = (from, to) => app.db.select({ sessions: sql8`COALESCE(SUM(${gaTrafficSnapshots.organicSessions}), 0)` }).from(gaTrafficSnapshots).where(and12(eq21(gaTrafficSnapshots.projectId, project.id), sql8`${gaTrafficSnapshots.date} >= ${from}`, sql8`${gaTrafficSnapshots.date} < ${to}`)).get();
+    const sumDirect = (from, to) => app.db.select({ sessions: sql8`COALESCE(SUM(${gaTrafficSnapshots.directSessions}), 0)` }).from(gaTrafficSnapshots).where(and12(eq21(gaTrafficSnapshots.projectId, project.id), sql8`${gaTrafficSnapshots.date} >= ${from}`, sql8`${gaTrafficSnapshots.date} < ${to}`)).get();
+    const sumAi = (from, to) => app.db.select({ sessions: sql8`COALESCE(SUM(${gaAiReferrals.sessions}), 0)` }).from(gaAiReferrals).where(and12(
       eq21(gaAiReferrals.projectId, project.id),
-      sql7`${gaAiReferrals.date} >= ${from}`,
-      sql7`${gaAiReferrals.date} < ${to}`,
+      sql8`${gaAiReferrals.date} >= ${from}`,
+      sql8`${gaAiReferrals.date} < ${to}`,
       eq21(gaAiReferrals.sourceDimension, "session")
     )).get();
-    const sumSocial = (from, to) => app.db.select({ sessions: sql7`COALESCE(SUM(${gaSocialReferrals.sessions}), 0)` }).from(gaSocialReferrals).where(and12(eq21(gaSocialReferrals.projectId, project.id), sql7`${gaSocialReferrals.date} >= ${from}`, sql7`${gaSocialReferrals.date} < ${to}`)).get();
+    const sumSocial = (from, to) => app.db.select({ sessions: sql8`COALESCE(SUM(${gaSocialReferrals.sessions}), 0)` }).from(gaSocialReferrals).where(and12(eq21(gaSocialReferrals.projectId, project.id), sql8`${gaSocialReferrals.date} >= ${from}`, sql8`${gaSocialReferrals.date} < ${to}`)).get();
     const todayStr = fmt(today);
     const buildTrend = (sum) => {
       const c7 = sum(daysAgo2(7), todayStr)?.sessions ?? 0;
@@ -14647,16 +14727,16 @@ async function ga4Routes(app, opts) {
       const p30 = sum(daysAgo2(60), daysAgo2(30))?.sessions ?? 0;
       return { sessions7d: c7, sessionsPrev7d: p7, trend7dPct: pct(c7, p7), sessions30d: c30, sessionsPrev30d: p30, trend30dPct: pct(c30, p30) };
     };
-    const aiSourceCurrent = app.db.select({ source: gaAiReferrals.source, sessions: sql7`COALESCE(SUM(${gaAiReferrals.sessions}), 0)` }).from(gaAiReferrals).where(and12(
+    const aiSourceCurrent = app.db.select({ source: gaAiReferrals.source, sessions: sql8`COALESCE(SUM(${gaAiReferrals.sessions}), 0)` }).from(gaAiReferrals).where(and12(
       eq21(gaAiReferrals.projectId, project.id),
-      sql7`${gaAiReferrals.date} >= ${daysAgo2(7)}`,
-      sql7`${gaAiReferrals.date} < ${todayStr}`,
+      sql8`${gaAiReferrals.date} >= ${daysAgo2(7)}`,
+      sql8`${gaAiReferrals.date} < ${todayStr}`,
       eq21(gaAiReferrals.sourceDimension, "session")
     )).groupBy(gaAiReferrals.source).all();
-    const aiSourcePrev = app.db.select({ source: gaAiReferrals.source, sessions: sql7`COALESCE(SUM(${gaAiReferrals.sessions}), 0)` }).from(gaAiReferrals).where(and12(
+    const aiSourcePrev = app.db.select({ source: gaAiReferrals.source, sessions: sql8`COALESCE(SUM(${gaAiReferrals.sessions}), 0)` }).from(gaAiReferrals).where(and12(
       eq21(gaAiReferrals.projectId, project.id),
-      sql7`${gaAiReferrals.date} >= ${daysAgo2(14)}`,
-      sql7`${gaAiReferrals.date} < ${daysAgo2(7)}`,
+      sql8`${gaAiReferrals.date} >= ${daysAgo2(14)}`,
+      sql8`${gaAiReferrals.date} < ${daysAgo2(7)}`,
       eq21(gaAiReferrals.sourceDimension, "session")
     )).groupBy(gaAiReferrals.source).all();
     const findBiggestMover = (current, prev) => {
@@ -14673,8 +14753,8 @@ async function ga4Routes(app, opts) {
       }
       return mover;
     };
-    const socialSourceCurrent = app.db.select({ source: gaSocialReferrals.source, sessions: sql7`SUM(${gaSocialReferrals.sessions})` }).from(gaSocialReferrals).where(and12(eq21(gaSocialReferrals.projectId, project.id), sql7`${gaSocialReferrals.date} >= ${daysAgo2(7)}`, sql7`${gaSocialReferrals.date} < ${todayStr}`)).groupBy(gaSocialReferrals.source).all();
-    const socialSourcePrev = app.db.select({ source: gaSocialReferrals.source, sessions: sql7`SUM(${gaSocialReferrals.sessions})` }).from(gaSocialReferrals).where(and12(eq21(gaSocialReferrals.projectId, project.id), sql7`${gaSocialReferrals.date} >= ${daysAgo2(14)}`, sql7`${gaSocialReferrals.date} < ${daysAgo2(7)}`)).groupBy(gaSocialReferrals.source).all();
+    const socialSourceCurrent = app.db.select({ source: gaSocialReferrals.source, sessions: sql8`SUM(${gaSocialReferrals.sessions})` }).from(gaSocialReferrals).where(and12(eq21(gaSocialReferrals.projectId, project.id), sql8`${gaSocialReferrals.date} >= ${daysAgo2(7)}`, sql8`${gaSocialReferrals.date} < ${todayStr}`)).groupBy(gaSocialReferrals.source).all();
+    const socialSourcePrev = app.db.select({ source: gaSocialReferrals.source, sessions: sql8`SUM(${gaSocialReferrals.sessions})` }).from(gaSocialReferrals).where(and12(eq21(gaSocialReferrals.projectId, project.id), sql8`${gaSocialReferrals.date} >= ${daysAgo2(14)}`, sql8`${gaSocialReferrals.date} < ${daysAgo2(7)}`)).groupBy(gaSocialReferrals.source).all();
     return {
       total: buildTrend(sumTotal),
       organic: buildTrend(sumOrganic),
@@ -14690,12 +14770,12 @@ async function ga4Routes(app, opts) {
     requireGa4Connection(opts, project.name, project.canonicalDomain);
     const cutoffDate = windowCutoff(parseWindow(request.query.window))?.slice(0, 10) ?? null;
     const conditions = [eq21(gaTrafficSnapshots.projectId, project.id)];
-    if (cutoffDate) conditions.push(sql7`${gaTrafficSnapshots.date} >= ${cutoffDate}`);
+    if (cutoffDate) conditions.push(sql8`${gaTrafficSnapshots.date} >= ${cutoffDate}`);
     const rows = app.db.select({
       date: gaTrafficSnapshots.date,
-      sessions: sql7`SUM(${gaTrafficSnapshots.sessions})`,
-      organicSessions: sql7`SUM(${gaTrafficSnapshots.organicSessions})`,
-      users: sql7`SUM(${gaTrafficSnapshots.users})`
+      sessions: sql8`SUM(${gaTrafficSnapshots.sessions})`,
+      organicSessions: sql8`SUM(${gaTrafficSnapshots.organicSessions})`,
+      users: sql8`SUM(${gaTrafficSnapshots.users})`
     }).from(gaTrafficSnapshots).where(and12(...conditions)).groupBy(gaTrafficSnapshots.date).orderBy(gaTrafficSnapshots.date).all();
     return rows.map((r) => ({
       date: r.date,
@@ -14708,11 +14788,11 @@ async function ga4Routes(app, opts) {
     const project = resolveProject(app.db, request.params.name);
     requireGa4Connection(opts, project.name, project.canonicalDomain);
     const trafficPages = app.db.select({
-      landingPage: sql7`COALESCE(${gaTrafficSnapshots.landingPageNormalized}, ${gaTrafficSnapshots.landingPage})`,
-      sessions: sql7`SUM(${gaTrafficSnapshots.sessions})`,
-      organicSessions: sql7`SUM(${gaTrafficSnapshots.organicSessions})`,
-      users: sql7`SUM(${gaTrafficSnapshots.users})`
-    }).from(gaTrafficSnapshots).where(eq21(gaTrafficSnapshots.projectId, project.id)).groupBy(sql7`COALESCE(${gaTrafficSnapshots.landingPageNormalized}, ${gaTrafficSnapshots.landingPage})`).orderBy(sql7`SUM(${gaTrafficSnapshots.sessions}) DESC`).all();
+      landingPage: sql8`COALESCE(${gaTrafficSnapshots.landingPageNormalized}, ${gaTrafficSnapshots.landingPage})`,
+      sessions: sql8`SUM(${gaTrafficSnapshots.sessions})`,
+      organicSessions: sql8`SUM(${gaTrafficSnapshots.organicSessions})`,
+      users: sql8`SUM(${gaTrafficSnapshots.users})`
+    }).from(gaTrafficSnapshots).where(eq21(gaTrafficSnapshots.projectId, project.id)).groupBy(sql8`COALESCE(${gaTrafficSnapshots.landingPageNormalized}, ${gaTrafficSnapshots.landingPage})`).orderBy(sql8`SUM(${gaTrafficSnapshots.sessions}) DESC`).all();
     return {
       pages: trafficPages.map((r) => ({
         landingPage: r.landingPage,
@@ -16349,7 +16429,7 @@ async function wordpressRoutes(app, opts) {
 
 // ../api-routes/src/backlinks.ts
 import crypto18 from "crypto";
-import { and as and14, asc as asc2, desc as desc11, eq as eq22, sql as sql8 } from "drizzle-orm";
+import { and as and14, asc as asc2, desc as desc11, eq as eq22, sql as sql9 } from "drizzle-orm";
 
 // ../integration-commoncrawl/src/constants.ts
 import os3 from "os";
@@ -16633,7 +16713,7 @@ async function queryBacklinks(opts) {
   const reversed = opts.targets.map(reverseDomain);
   const targetList = reversed.map(quote).join(", ");
   const limitClause = opts.limitPerTarget ? `QUALIFY row_number() OVER (PARTITION BY t.target_rev_domain ORDER BY v.num_hosts DESC) <= ${Math.floor(opts.limitPerTarget)}` : "";
-  const sql15 = `
+  const sql16 = `
     WITH vertices AS (
       SELECT * FROM read_csv(
         ${quote(opts.vertexPath)},
@@ -16669,7 +16749,7 @@ async function queryBacklinks(opts) {
   const conn = await instance.connect();
   let rows;
   try {
-    const reader = await conn.runAndReadAll(sql15);
+    const reader = await conn.runAndReadAll(sql16);
     rows = reader.getRowObjects();
   } finally {
     conn.disconnectSync?.();
@@ -16845,12 +16925,12 @@ function computeFilteredSummary(db, base) {
   );
   const filteredCondition = and14(baseDomainCondition, backlinkCrawlerExclusionClause());
   const unfilteredAgg = db.select({
-    count: sql8`count(*)`,
-    total: sql8`coalesce(sum(${backlinkDomains.numHosts}), 0)`
+    count: sql9`count(*)`,
+    total: sql9`coalesce(sum(${backlinkDomains.numHosts}), 0)`
   }).from(backlinkDomains).where(baseDomainCondition).get();
   const filteredAgg = db.select({
-    count: sql8`count(*)`,
-    total: sql8`coalesce(sum(${backlinkDomains.numHosts}), 0)`
+    count: sql9`count(*)`,
+    total: sql9`coalesce(sum(${backlinkDomains.numHosts}), 0)`
   }).from(backlinkDomains).where(filteredCondition).get();
   const top10Rows = db.select({ numHosts: backlinkDomains.numHosts }).from(backlinkDomains).where(filteredCondition).orderBy(desc11(backlinkDomains.numHosts)).limit(10).all();
   const totalLinkingDomains = Number(filteredAgg?.count ?? 0);
@@ -17024,7 +17104,7 @@ async function backlinksRoutes(app, opts) {
       eq22(backlinkDomains.release, targetRelease)
     );
     const domainCondition = excludeCrawlers ? and14(baseDomainCondition, backlinkCrawlerExclusionClause()) : baseDomainCondition;
-    const totalRow = app.db.select({ count: sql8`count(*)` }).from(backlinkDomains).where(domainCondition).get();
+    const totalRow = app.db.select({ count: sql9`count(*)` }).from(backlinkDomains).where(domainCondition).get();
     const rows = app.db.select({
       linkingDomain: backlinkDomains.linkingDomain,
       numHosts: backlinkDomains.numHosts
@@ -17059,7 +17139,7 @@ async function backlinksRoutes(app, opts) {
 
 // ../api-routes/src/traffic.ts
 import crypto20 from "crypto";
-import { and as and15, desc as desc12, eq as eq23, gte as gte2, lte as lte2, sql as sql9 } from "drizzle-orm";
+import { and as and15, desc as desc12, eq as eq23, gte as gte2, lte as lte2, sql as sql10 } from "drizzle-orm";
 
 // ../integration-cloud-run/src/auth.ts
 import crypto19 from "crypto";
@@ -18797,7 +18877,7 @@ async function trafficRoutes(app, opts) {
             crawlerEventsHourly.status
           ],
           set: {
-            hits: sql9`${crawlerEventsHourly.hits} + ${bucket.hits}`,
+            hits: sql10`${crawlerEventsHourly.hits} + ${bucket.hits}`,
             sampledUserAgent: bucket.sampledUserAgent,
             updatedAt: finishedAt
           }
@@ -18832,7 +18912,7 @@ async function trafficRoutes(app, opts) {
             aiReferralEventsHourly.status
           ],
           set: {
-            sessionsOrHits: sql9`${aiReferralEventsHourly.sessionsOrHits} + ${bucket.hits}`,
+            sessionsOrHits: sql10`${aiReferralEventsHourly.sessionsOrHits} + ${bucket.hits}`,
             updatedAt: finishedAt
           }
         }).run();
@@ -19084,19 +19164,19 @@ async function trafficRoutes(app, opts) {
     return response;
   });
   function buildSourceDetail(projectId, row, since) {
-    const crawlerTotals = app.db.select({ total: sql9`COALESCE(SUM(${crawlerEventsHourly.hits}), 0)` }).from(crawlerEventsHourly).where(
+    const crawlerTotals = app.db.select({ total: sql10`COALESCE(SUM(${crawlerEventsHourly.hits}), 0)` }).from(crawlerEventsHourly).where(
       and15(
         eq23(crawlerEventsHourly.sourceId, row.id),
         gte2(crawlerEventsHourly.tsHour, since)
       )
     ).get();
-    const aiTotals = app.db.select({ total: sql9`COALESCE(SUM(${aiReferralEventsHourly.sessionsOrHits}), 0)` }).from(aiReferralEventsHourly).where(
+    const aiTotals = app.db.select({ total: sql10`COALESCE(SUM(${aiReferralEventsHourly.sessionsOrHits}), 0)` }).from(aiReferralEventsHourly).where(
       and15(
         eq23(aiReferralEventsHourly.sourceId, row.id),
         gte2(aiReferralEventsHourly.tsHour, since)
       )
     ).get();
-    const sampleTotals = app.db.select({ total: sql9`COUNT(*)` }).from(rawEventSamples).where(
+    const sampleTotals = app.db.select({ total: sql10`COUNT(*)` }).from(rawEventSamples).where(
       and15(
         eq23(rawEventSamples.sourceId, row.id),
         gte2(rawEventSamples.ts, since)
@@ -19198,7 +19278,7 @@ async function trafficRoutes(app, opts) {
       ];
       if (sourceIdParam) crawlerFilters.push(eq23(crawlerEventsHourly.sourceId, sourceIdParam));
       const crawlerWhere = and15(...crawlerFilters);
-      const total = app.db.select({ total: sql9`COALESCE(SUM(${crawlerEventsHourly.hits}), 0)` }).from(crawlerEventsHourly).where(crawlerWhere).get();
+      const total = app.db.select({ total: sql10`COALESCE(SUM(${crawlerEventsHourly.hits}), 0)` }).from(crawlerEventsHourly).where(crawlerWhere).get();
       crawlerTotal = Number(total?.total ?? 0);
       const rows = app.db.select().from(crawlerEventsHourly).where(crawlerWhere).orderBy(desc12(crawlerEventsHourly.tsHour)).limit(limit).all();
       for (const r of rows) {
@@ -19223,7 +19303,7 @@ async function trafficRoutes(app, opts) {
       ];
       if (sourceIdParam) aiFilters.push(eq23(aiReferralEventsHourly.sourceId, sourceIdParam));
       const aiWhere = and15(...aiFilters);
-      const total = app.db.select({ total: sql9`COALESCE(SUM(${aiReferralEventsHourly.sessionsOrHits}), 0)` }).from(aiReferralEventsHourly).where(aiWhere).get();
+      const total = app.db.select({ total: sql10`COALESCE(SUM(${aiReferralEventsHourly.sessionsOrHits}), 0)` }).from(aiReferralEventsHourly).where(aiWhere).get();
       aiReferralTotal = Number(total?.total ?? 0);
       const rows = app.db.select().from(aiReferralEventsHourly).where(aiWhere).orderBy(desc12(aiReferralEventsHourly.tsHour)).limit(limit).all();
       for (const r of rows) {
@@ -19946,7 +20026,7 @@ var providersConfiguredCheck = {
 var PROVIDERS_CHECKS = [providersConfiguredCheck];
 
 // ../api-routes/src/doctor/checks/traffic-source.ts
-import { and as and16, eq as eq24, gte as gte3, ne as ne3, sql as sql10 } from "drizzle-orm";
+import { and as and16, eq as eq24, gte as gte3, ne as ne3, sql as sql11 } from "drizzle-orm";
 var RECENT_DATA_WARN_DAYS = 7;
 var RECENT_DATA_FAIL_DAYS = 30;
 function skippedNoProject2() {
@@ -20040,7 +20120,7 @@ var recentDataCheck = {
     const warnCutoff = new Date(now.getTime() - RECENT_DATA_WARN_DAYS * 24 * 60 * 6e4).toISOString();
     const failCutoff = new Date(now.getTime() - RECENT_DATA_FAIL_DAYS * 24 * 60 * 6e4).toISOString();
     const recentCrawlers = Number(
-      ctx.db.select({ total: sql10`COALESCE(SUM(${crawlerEventsHourly.hits}), 0)` }).from(crawlerEventsHourly).where(
+      ctx.db.select({ total: sql11`COALESCE(SUM(${crawlerEventsHourly.hits}), 0)` }).from(crawlerEventsHourly).where(
         and16(
           eq24(crawlerEventsHourly.projectId, ctx.project.id),
           gte3(crawlerEventsHourly.tsHour, warnCutoff)
@@ -20048,7 +20128,7 @@ var recentDataCheck = {
       ).get()?.total ?? 0
     );
     const recentReferrals = Number(
-      ctx.db.select({ total: sql10`COALESCE(SUM(${aiReferralEventsHourly.sessionsOrHits}), 0)` }).from(aiReferralEventsHourly).where(
+      ctx.db.select({ total: sql11`COALESCE(SUM(${aiReferralEventsHourly.sessionsOrHits}), 0)` }).from(aiReferralEventsHourly).where(
         and16(
           eq24(aiReferralEventsHourly.projectId, ctx.project.id),
           gte3(aiReferralEventsHourly.tsHour, warnCutoff)
@@ -20064,7 +20144,7 @@ var recentDataCheck = {
       };
     }
     const olderCrawlers = Number(
-      ctx.db.select({ total: sql10`COALESCE(SUM(${crawlerEventsHourly.hits}), 0)` }).from(crawlerEventsHourly).where(
+      ctx.db.select({ total: sql11`COALESCE(SUM(${crawlerEventsHourly.hits}), 0)` }).from(crawlerEventsHourly).where(
         and16(
           eq24(crawlerEventsHourly.projectId, ctx.project.id),
           gte3(crawlerEventsHourly.tsHour, failCutoff)
@@ -20072,7 +20152,7 @@ var recentDataCheck = {
       ).get()?.total ?? 0
     );
     const olderReferrals = Number(
-      ctx.db.select({ total: sql10`COALESCE(SUM(${aiReferralEventsHourly.sessionsOrHits}), 0)` }).from(aiReferralEventsHourly).where(
+      ctx.db.select({ total: sql11`COALESCE(SUM(${aiReferralEventsHourly.sessionsOrHits}), 0)` }).from(aiReferralEventsHourly).where(
         and16(
           eq24(aiReferralEventsHourly.projectId, ctx.project.id),
           gte3(aiReferralEventsHourly.tsHour, failCutoff)
@@ -20372,7 +20452,7 @@ async function doctorRoutes(app, opts) {
 
 // ../api-routes/src/discovery/routes.ts
 import crypto21 from "crypto";
-import { and as and17, desc as desc13, eq as eq25, gte as gte4, inArray as inArray8 } from "drizzle-orm";
+import { and as and17, desc as desc13, eq as eq25, gte as gte4, inArray as inArray9 } from "drizzle-orm";
 var MAX_INFLIGHT_DISCOVERY_AGE_MS = 2 * 60 * 60 * 1e3;
 async function discoveryRoutes(app, opts) {
   app.post("/projects/:name/discover/run", async (request, reply) => {
@@ -20407,7 +20487,7 @@ async function discoveryRoutes(app, opts) {
       const existing = tx.select({ id: discoverySessions.id, runId: discoverySessions.runId }).from(discoverySessions).where(and17(
         eq25(discoverySessions.projectId, project.id),
         eq25(discoverySessions.icpDescription, icpDescription),
-        inArray8(discoverySessions.status, [
+        inArray9(discoverySessions.status, [
           DiscoverySessionStatuses.queued,
           DiscoverySessionStatuses.seeding,
           DiscoverySessionStatuses.probing
@@ -23725,7 +23805,7 @@ import crypto24 from "crypto";
 import fs8 from "fs";
 import path10 from "path";
 import os5 from "os";
-import { and as and18, eq as eq27, inArray as inArray9, sql as sql11 } from "drizzle-orm";
+import { and as and18, eq as eq27, inArray as inArray10, sql as sql12 } from "drizzle-orm";
 
 // src/run-telemetry.ts
 import crypto23 from "crypto";
@@ -24070,7 +24150,7 @@ var JobRunner = class {
     this.registry = registry;
   }
   recoverStaleRuns() {
-    const stale = this.db.select({ id: runs.id, status: runs.status }).from(runs).where(inArray9(runs.status, ["running", "queued"])).all();
+    const stale = this.db.select({ id: runs.id, status: runs.status }).from(runs).where(inArray10(runs.status, ["running", "queued"])).all();
     if (stale.length === 0) return;
     const now = (/* @__PURE__ */ new Date()).toISOString();
     for (const run of stale) {
@@ -24133,7 +24213,7 @@ var JobRunner = class {
       }
       log.info("run.dispatch", { runId, providerCount: activeProviders.length, providers: activeProviders.map((p) => p.adapter.name) });
       const scopedQueryNames = parseJsonColumn(existingRun.queries, null);
-      projectQueries = scopedQueryNames ? this.db.select().from(queries).where(and18(eq27(queries.projectId, projectId), inArray9(queries.query, scopedQueryNames))).all() : this.db.select().from(queries).where(eq27(queries.projectId, projectId)).all();
+      projectQueries = scopedQueryNames ? this.db.select().from(queries).where(and18(eq27(queries.projectId, projectId), inArray10(queries.query, scopedQueryNames))).all() : this.db.select().from(queries).where(eq27(queries.projectId, projectId)).all();
       const projectCompetitors = this.db.select().from(competitors).where(eq27(competitors.projectId, projectId)).all();
       const competitorDomains = projectCompetitors.map((c) => c.domain);
       const allDomains = effectiveDomains({
@@ -24406,7 +24486,7 @@ var JobRunner = class {
       updatedAt: now
     }).onConflictDoUpdate({
       target: [usageCounters.scope, usageCounters.period, usageCounters.metric],
-      set: { count: sql11`${usageCounters.count} + ${count}`, updatedAt: now }
+      set: { count: sql12`${usageCounters.count} + ${count}`, updatedAt: now }
     }).run();
   }
   flushProviderUsage(projectId, providerDispatchCounts) {
@@ -24476,7 +24556,7 @@ function buildPhases(input) {
 
 // src/gsc-sync.ts
 import crypto25 from "crypto";
-import { eq as eq28, and as and19, sql as sql12 } from "drizzle-orm";
+import { eq as eq28, and as and19, sql as sql13 } from "drizzle-orm";
 var log2 = createLogger("GscSync");
 function formatDate3(d) {
   return d.toISOString().split("T")[0];
@@ -24530,8 +24610,8 @@ async function executeGscSync(db, runId, projectId, opts) {
     db.delete(gscSearchData).where(
       and19(
         eq28(gscSearchData.projectId, projectId),
-        sql12`${gscSearchData.date} >= ${startDate}`,
-        sql12`${gscSearchData.date} <= ${endDate}`
+        sql13`${gscSearchData.date} >= ${startDate}`,
+        sql13`${gscSearchData.date} <= ${endDate}`
       )
     ).run();
     const batchSize = 500;
@@ -25067,7 +25147,7 @@ async function executeBingInspectSitemap(db, runId, projectId, opts) {
 // src/commoncrawl-sync.ts
 import crypto28 from "crypto";
 import path11 from "path";
-import { and as and21, eq as eq31, sql as sql13 } from "drizzle-orm";
+import { and as and21, eq as eq31, sql as sql14 } from "drizzle-orm";
 var log6 = createLogger("CommonCrawlSync");
 var INSERT_CHUNK_SIZE = 1e4;
 function defaultDeps() {
@@ -25679,23 +25759,25 @@ function buildDiscoveryInsightTitle(input) {
 }
 
 // src/commands/backfill.ts
-import { and as and24, eq as eq34, inArray as inArray10 } from "drizzle-orm";
+import { and as and24, eq as eq34, inArray as inArray11 } from "drizzle-orm";
 var SNAPSHOT_BATCH_SIZE = 500;
 async function backfillAnswerVisibilityCommand(opts) {
   const config = loadConfig();
   const db = createClient(config.database);
   migrate(db);
   const projectFilter = opts?.project?.trim();
+  const isDryRun = opts?.dryRun === true;
   const scopedProjects = projectFilter ? db.select().from(projects).where(eq34(projects.name, projectFilter)).all() : db.select().from(projects).all();
   let examined = 0;
   let updated = 0;
+  let wouldUpdate = 0;
   let mentioned = 0;
   let reparsed = 0;
   let providerErrors = 0;
   if (scopedProjects.length > 0) {
     const runRows = projectFilter ? db.select({ id: runs.id, projectId: runs.projectId }).from(runs).where(and24(
       eq34(runs.kind, RunKinds["answer-visibility"]),
-      inArray10(runs.projectId, scopedProjects.map((project) => project.id))
+      inArray11(runs.projectId, scopedProjects.map((project) => project.id))
     )).all() : db.select({ id: runs.id, projectId: runs.projectId }).from(runs).where(eq34(runs.kind, RunKinds["answer-visibility"])).all();
     const runIdsByProject = /* @__PURE__ */ new Map();
     for (const run of runRows) {
@@ -25727,7 +25809,7 @@ async function backfillAnswerVisibilityCommand(opts) {
           competitorOverlap: querySnapshots.competitorOverlap,
           recommendedCompetitors: querySnapshots.recommendedCompetitors,
           rawResponse: querySnapshots.rawResponse
-        }).from(querySnapshots).where(inArray10(querySnapshots.runId, batchRunIds)).all();
+        }).from(querySnapshots).where(inArray11(querySnapshots.runId, batchRunIds)).all();
         const pendingUpdates = [];
         for (const snapshot of snapshotRows) {
           examined++;
@@ -25791,12 +25873,16 @@ async function backfillAnswerVisibilityCommand(opts) {
           }
         }
         if (pendingUpdates.length > 0) {
-          db.transaction((tx) => {
-            for (const update of pendingUpdates) {
-              tx.update(querySnapshots).set(update.patch).where(eq34(querySnapshots.id, update.id)).run();
-            }
-          });
-          updated += pendingUpdates.length;
+          if (isDryRun) {
+            wouldUpdate += pendingUpdates.length;
+          } else {
+            db.transaction((tx) => {
+              for (const update of pendingUpdates) {
+                tx.update(querySnapshots).set(update.patch).where(eq34(querySnapshots.id, update.id)).run();
+              }
+            });
+            updated += pendingUpdates.length;
+          }
         }
       }
     }
@@ -25810,20 +25896,33 @@ async function backfillAnswerVisibilityCommand(opts) {
     reparsed,
     providerErrors
   };
+  if (isDryRun) {
+    result.dryRun = true;
+    result.wouldUpdate = wouldUpdate;
+  }
   if (opts?.format === "json") {
     console.log(JSON.stringify(result, null, 2));
     return;
   }
-  console.log("Answer visibility backfill complete.\n");
+  console.log(`Answer visibility backfill ${isDryRun ? "preview" : "complete"}.
+`);
   if (projectFilter) {
     console.log(`  Project:  ${projectFilter}`);
   }
   console.log(`  Projects: ${scopedProjects.length}`);
-  console.log(`  Examined:  ${examined}`);
-  console.log(`  Updated:   ${updated}`);
-  console.log(`  Mentioned: ${mentioned}`);
-  console.log(`  Reparsed:  ${reparsed}`);
-  console.log(`  Errors:    ${providerErrors}`);
+  console.log(`  Examined:     ${examined}`);
+  if (isDryRun) {
+    console.log(`  Would update: ${wouldUpdate}`);
+  } else {
+    console.log(`  Updated:      ${updated}`);
+  }
+  console.log(`  Mentioned:    ${mentioned}`);
+  console.log(`  Reparsed:     ${reparsed}`);
+  console.log(`  Errors:       ${providerErrors}`);
+  if (isDryRun) {
+    console.log(`
+No DB writes performed. Re-run without --dry-run to apply.`);
+  }
 }
 function backfillNormalizedPaths(db, opts) {
   const baseConditions = [];
@@ -25969,7 +26068,8 @@ async function backfillAiReferralPathsCommand(opts) {
   console.log(`  Updated:   ${updated}`);
   console.log(`  Unchanged: ${unchanged}`);
 }
-function backfillProjectAnswerMentions(db, projectId) {
+function backfillProjectAnswerMentions(db, projectId, opts) {
+  const isDryRun = opts?.dryRun === true;
   const project = db.select().from(projects).where(eq34(projects.id, projectId)).get();
   if (!project) return { examined: 0, updated: 0, mentioned: 0 };
   const competitorDomains = db.select({ domain: competitors.domain }).from(competitors).where(eq34(competitors.projectId, projectId)).all().map((row) => row.domain);
@@ -25977,8 +26077,11 @@ function backfillProjectAnswerMentions(db, projectId) {
   const runIds = runRows.map((r) => r.id);
   let examined = 0;
   let updated = 0;
+  let wouldUpdate = 0;
   let mentioned = 0;
-  if (runIds.length === 0) return { examined, updated, mentioned };
+  if (runIds.length === 0) {
+    return isDryRun ? { examined, updated, wouldUpdate, mentioned } : { examined, updated, mentioned };
+  }
   const projectDomains = effectiveDomains({
     canonicalDomain: project.canonicalDomain,
     ownedDomains: parseJsonColumn(project.ownedDomains, [])
@@ -25998,7 +26101,7 @@ function backfillProjectAnswerMentions(db, projectId) {
       competitorOverlap: querySnapshots.competitorOverlap,
       recommendedCompetitors: querySnapshots.recommendedCompetitors,
       rawResponse: querySnapshots.rawResponse
-    }).from(querySnapshots).where(inArray10(querySnapshots.runId, batchRunIds)).all();
+    }).from(querySnapshots).where(inArray11(querySnapshots.runId, batchRunIds)).all();
     const pendingUpdates = [];
     for (const snapshot of snapshotRows) {
       examined++;
@@ -26041,29 +26144,36 @@ function backfillProjectAnswerMentions(db, projectId) {
       }
     }
     if (pendingUpdates.length > 0) {
-      db.transaction((tx) => {
-        for (const update of pendingUpdates) {
-          tx.update(querySnapshots).set(update.patch).where(eq34(querySnapshots.id, update.id)).run();
-        }
-      });
-      updated += pendingUpdates.length;
+      if (isDryRun) {
+        wouldUpdate += pendingUpdates.length;
+      } else {
+        db.transaction((tx) => {
+          for (const update of pendingUpdates) {
+            tx.update(querySnapshots).set(update.patch).where(eq34(querySnapshots.id, update.id)).run();
+          }
+        });
+        updated += pendingUpdates.length;
+      }
     }
   }
-  return { examined, updated, mentioned };
+  return isDryRun ? { examined, updated, wouldUpdate, mentioned } : { examined, updated, mentioned };
 }
 async function backfillAnswerMentionsCommand(opts) {
   const config = loadConfig();
   const db = createClient(config.database);
   migrate(db);
   const projectFilter = opts?.project?.trim();
+  const isDryRun = opts?.dryRun === true;
   const scopedProjects = projectFilter ? db.select().from(projects).where(eq34(projects.name, projectFilter)).all() : db.select().from(projects).all();
   let examined = 0;
   let updated = 0;
+  let wouldUpdate = 0;
   let mentioned = 0;
   for (const project of scopedProjects) {
-    const result2 = backfillProjectAnswerMentions(db, project.id);
+    const result2 = backfillProjectAnswerMentions(db, project.id, { dryRun: isDryRun });
     examined += result2.examined;
     updated += result2.updated;
+    wouldUpdate += result2.wouldUpdate ?? 0;
     mentioned += result2.mentioned;
   }
   const result = {
@@ -26073,16 +26183,29 @@ async function backfillAnswerMentionsCommand(opts) {
     updated,
     mentioned
   };
+  if (isDryRun) {
+    result.dryRun = true;
+    result.wouldUpdate = wouldUpdate;
+  }
   if (opts?.format === "json") {
     console.log(JSON.stringify(result, null, 2));
     return;
   }
-  console.log("Answer mentions backfill complete.\n");
-  if (projectFilter) console.log(`  Project:   ${projectFilter}`);
-  console.log(`  Projects:  ${scopedProjects.length}`);
-  console.log(`  Examined:  ${examined}`);
-  console.log(`  Updated:   ${updated}`);
-  console.log(`  Mentioned: ${mentioned}`);
+  console.log(`Answer mentions backfill ${isDryRun ? "preview" : "complete"}.
+`);
+  if (projectFilter) console.log(`  Project:      ${projectFilter}`);
+  console.log(`  Projects:     ${scopedProjects.length}`);
+  console.log(`  Examined:     ${examined}`);
+  if (isDryRun) {
+    console.log(`  Would update: ${wouldUpdate}`);
+  } else {
+    console.log(`  Updated:      ${updated}`);
+  }
+  console.log(`  Mentioned:    ${mentioned}`);
+  if (isDryRun) {
+    console.log(`
+No DB writes performed. Re-run without --dry-run to apply.`);
+  }
 }
 function readStoredGroundingSources(rawResponse) {
   const envelope = parseJsonColumn(rawResponse, {});
@@ -26101,7 +26224,7 @@ function readStoredGroundingSources(rawResponse) {
   return result;
 }
 async function backfillInsightsCommand(project, opts) {
-  const { IntelligenceService: IntelligenceService2 } = await import("./intelligence-service-7AWRUNI2.js");
+  const { IntelligenceService: IntelligenceService2 } = await import("./intelligence-service-ZZP3TVZZ.js");
   const config = loadConfig();
   const db = createClient(config.database);
   migrate(db);
@@ -26419,7 +26542,7 @@ var Scheduler = class {
 };
 
 // src/notifier.ts
-import { eq as eq36, desc as desc16, and as and26, inArray as inArray11, or as or5 } from "drizzle-orm";
+import { eq as eq36, desc as desc16, and as and26, inArray as inArray12, or as or5 } from "drizzle-orm";
 import crypto31 from "crypto";
 var log10 = createLogger("Notifier");
 var Notifier = class {
@@ -26572,13 +26695,13 @@ var Notifier = class {
       provider: querySnapshots.provider,
       location: querySnapshots.location,
       citationState: querySnapshots.citationState
-    }).from(querySnapshots).leftJoin(queries, eq36(querySnapshots.queryId, queries.id)).where(inArray11(querySnapshots.runId, currentRunIds)).all();
+    }).from(querySnapshots).leftJoin(queries, eq36(querySnapshots.queryId, queries.id)).where(inArray12(querySnapshots.runId, currentRunIds)).all();
     const previousSnapshots = this.db.select({
       queryId: querySnapshots.queryId,
       provider: querySnapshots.provider,
       location: querySnapshots.location,
       citationState: querySnapshots.citationState
-    }).from(querySnapshots).where(inArray11(querySnapshots.runId, previousRunIds)).all();
+    }).from(querySnapshots).where(inArray12(querySnapshots.runId, previousRunIds)).all();
     const prevMap = /* @__PURE__ */ new Map();
     for (const s of previousSnapshots) {
       if (s.queryId == null) continue;
@@ -27091,7 +27214,7 @@ function resolveSessionProviderAndModel(config, opts) {
 
 // src/agent/memory-store.ts
 import crypto32 from "crypto";
-import { and as and27, desc as desc17, eq as eq38, like as like2, sql as sql14 } from "drizzle-orm";
+import { and as and27, desc as desc17, eq as eq38, like as like2, sql as sql15 } from "drizzle-orm";
 var COMPACTION_KEY_PREFIX = "compaction:";
 var COMPACTION_NOTES_PER_SESSION = 3;
 function rowToDto2(row) {
@@ -27177,7 +27300,7 @@ function writeCompactionNote(db, args) {
     ).orderBy(desc17(agentMemory.updatedAt)).all();
     const stale = existing.slice(COMPACTION_NOTES_PER_SESSION).map((r) => r.id);
     if (stale.length > 0) {
-      tx.delete(agentMemory).where(sql14`${agentMemory.id} IN (${sql14.join(stale.map((s) => sql14`${s}`), sql14`, `)})`).run();
+      tx.delete(agentMemory).where(sql15`${agentMemory.id} IN (${sql15.join(stale.map((s) => sql15`${s}`), sql15`, `)})`).run();
     }
     const row = tx.select().from(agentMemory).where(and27(eq38(agentMemory.projectId, args.projectId), eq38(agentMemory.key, key))).get();
     if (row) inserted = rowToDto2(row);