@canonry/canonry 4.129.1 → 4.131.0

package/dist/{chunk-LPEE5AYY.js → chunk-ZXVWL5HX.js}

@@ -29,6 +29,7 @@ import {
   ContentActions,
   DEFAULT_DISCOVERY_PROMOTE_BUCKETS,
   DEFAULT_DISCOVERY_PROMOTE_COMPETITOR_TYPES,
+  DEFAULT_MEASUREMENT_CONFIG,
   DISCOVERY_DEFAULT_DEDUP_THRESHOLD,
   DISCOVERY_DEFAULT_PROBE_CONCURRENCY,
   DISCOVERY_PROBE_CONCURRENCY_CAP,
@@ -38,6 +39,8 @@ import {
   DiscoveryCompetitorTypes,
   DiscoverySessionStatuses,
   MODEL_ATTRIBUTION_EVENT_LIMIT,
+  ResearchQueryStatuses,
+  ResearchRunStatuses,
   RunKinds,
   RunStatuses,
   RunTriggers,
@@ -227,6 +230,7 @@ import {
   hostOf,
   indexingRequestResponseDtoSchema,
   internalError,
+  isBrowserProvider,
   isReadOnlyKey,
   keywordDtoSchema,
   keywordGenerateRequestSchema,
@@ -271,6 +275,9 @@ import {
   reportConfidenceLabel,
   reportHorizonLabel,
   reportSeverityLabel,
+  researchRunCreateSchema,
+  researchRunDetailSchema,
+  researchRunListSchema,
   resolveConfigSpecQueries,
   resolveLocations,
   resolveSnapshotRequestQueries,
@@ -337,10 +344,10 @@ import {
   wordpressSchemaDeployResultDtoSchema,
   wordpressSchemaStatusResultDtoSchema,
   wordpressStatusDtoSchema
-} from "./chunk-K4FDDCYG.js";
+} from "./chunk-3WBAJKRR.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";
+import { eq as eq42, desc as desc19, asc as asc9, and as and33, ne as ne6, or as or8, inArray as inArray15, gte as gte10, lte as lte6 } from "drizzle-orm";
 
 // ../db/src/client.ts
 import { mkdirSync } from "fs";
@@ -379,9 +386,12 @@ __export(schema_exports, {
   discoveryProbes: () => discoveryProbes,
   discoverySessions: () => discoverySessions,
   domainClassifications: () => domainClassifications,
+  gaAcquisitionDaily: () => gaAcquisitionDaily,
   gaAiReferrals: () => gaAiReferrals,
   gaConnections: () => gaConnections,
   gaDailyTotals: () => gaDailyTotals,
+  gaLeadEventsDaily: () => gaLeadEventsDaily,
+  gaMeasurementSyncStates: () => gaMeasurementSyncStates,
   gaSocialReferrals: () => gaSocialReferrals,
   gaTrafficSnapshots: () => gaTrafficSnapshots,
   gaTrafficSummaries: () => gaTrafficSummaries,
@@ -411,6 +421,8 @@ __export(schema_exports, {
   rawEventSamples: () => rawEventSamples,
   recommendationBriefs: () => recommendationBriefs,
   recommendationExplanations: () => recommendationExplanations,
+  researchRunQueries: () => researchRunQueries,
+  researchRuns: () => researchRuns,
   runs: () => runs,
   schedules: () => schedules,
   siteAuditPages: () => siteAuditPages,
@@ -418,7 +430,8 @@ __export(schema_exports, {
   trafficSources: () => trafficSources,
   usageCounters: () => usageCounters
 });
-import { index, integer, primaryKey, real, sqliteTable, text, uniqueIndex } from "drizzle-orm/sqlite-core";
+import { sql } from "drizzle-orm";
+import { check, index, integer, primaryKey, real, sqliteTable, text, uniqueIndex } from "drizzle-orm/sqlite-core";
 var projects = sqliteTable("projects", {
   id: text("id").primaryKey(),
   name: text("name").notNull().unique(),
@@ -432,6 +445,11 @@ var projects = sqliteTable("projects", {
   labels: text("labels", { mode: "json" }).$type().notNull().default({}),
   providers: text("providers", { mode: "json" }).$type().notNull().default([]),
   providerModels: text("provider_models", { mode: "json" }).$type().notNull().default({}),
+  measurement: text("measurement_config", { mode: "json" }).$type().notNull().default({
+    marketingHosts: [],
+    brandTerms: [],
+    leadEventNames: ["generate_lead"]
+  }),
   locations: text("locations", { mode: "json" }).$type().notNull().default([]),
   defaultLocation: text("default_location"),
   autoExtractBacklinks: integer("auto_extract_backlinks", { mode: "boolean" }).notNull().default(false),
@@ -863,6 +881,97 @@ var gaDailyTotals = sqliteTable("ga_daily_totals", {
   index("idx_ga_daily_totals_project").on(table.projectId),
   index("idx_ga_daily_totals_run").on(table.syncRunId)
 ]);
+var gaAcquisitionDaily = sqliteTable("ga_acquisition_daily", {
+  id: text("id").primaryKey(),
+  projectId: text("project_id").notNull().references(() => projects.id, { onDelete: "cascade" }),
+  date: text("date").notNull(),
+  channelGroup: text("channel_group").notNull(),
+  source: text("source").notNull(),
+  medium: text("medium").notNull(),
+  hostName: text("host_name").notNull(),
+  landingPage: text("landing_page").notNull(),
+  landingPageNormalized: text("landing_page_normalized"),
+  sessions: integer("sessions").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_ga_acquisition_daily_grain").on(
+    table.projectId,
+    table.date,
+    table.channelGroup,
+    table.source,
+    table.medium,
+    table.hostName,
+    table.landingPage
+  ),
+  index("idx_ga_acquisition_daily_project_date").on(table.projectId, table.date),
+  index("idx_ga_acquisition_daily_project_channel").on(table.projectId, table.date, table.channelGroup),
+  index("idx_ga_acquisition_daily_project_page").on(table.projectId, table.date, table.landingPageNormalized),
+  check("chk_ga_acquisition_daily_sessions", sql`${table.sessions} >= 0`)
+]);
+var gaLeadEventsDaily = sqliteTable("ga_lead_events_daily", {
+  id: text("id").primaryKey(),
+  projectId: text("project_id").notNull().references(() => projects.id, { onDelete: "cascade" }),
+  date: text("date").notNull(),
+  eventName: text("event_name").notNull(),
+  channelGroup: text("channel_group").notNull(),
+  source: text("source").notNull(),
+  medium: text("medium").notNull(),
+  hostName: text("host_name").notNull(),
+  landingPage: text("landing_page").notNull(),
+  landingPageNormalized: text("landing_page_normalized"),
+  attributionScope: text("attribution_scope").$type().notNull(),
+  eventCount: integer("event_count").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_ga_lead_events_daily_grain").on(
+    table.projectId,
+    table.date,
+    table.eventName,
+    table.channelGroup,
+    table.source,
+    table.medium,
+    table.hostName,
+    table.landingPage,
+    table.attributionScope
+  ),
+  index("idx_ga_lead_events_daily_project_date").on(table.projectId, table.date),
+  index("idx_ga_lead_events_daily_project_channel").on(table.projectId, table.date, table.channelGroup),
+  index("idx_ga_lead_events_daily_project_event").on(table.projectId, table.date, table.eventName),
+  index("idx_ga_lead_events_daily_project_page").on(table.projectId, table.date, table.landingPageNormalized),
+  check("chk_ga_lead_events_daily_count", sql`${table.eventCount} >= 0`),
+  check(
+    "chk_ga_lead_events_daily_scope",
+    sql`${table.attributionScope} IN ('landing-page', 'channel')`
+  )
+]);
+var gaMeasurementSyncStates = sqliteTable("ga_measurement_sync_state", {
+  projectId: text("project_id").primaryKey().references(() => projects.id, { onDelete: "cascade" }),
+  acquisitionStatus: text("acquisition_status").$type().notNull().default("never-synced"),
+  acquisitionError: text("acquisition_error"),
+  acquisitionSyncedAt: text("acquisition_synced_at"),
+  leadStatus: text("lead_status").$type().notNull().default("never-synced"),
+  leadError: text("lead_error"),
+  leadSyncedAt: text("lead_synced_at"),
+  leadAttributionScope: text("lead_attribution_scope").$type(),
+  updatedAt: text("updated_at").notNull()
+}, (table) => [
+  check(
+    "chk_ga_measurement_sync_acquisition_status",
+    sql`${table.acquisitionStatus} IN ('never-synced', 'ready', 'error')`
+  ),
+  check(
+    "chk_ga_measurement_sync_lead_status",
+    sql`${table.leadStatus} IN ('never-synced', 'ready', 'error')`
+  ),
+  check(
+    "chk_ga_measurement_sync_lead_scope",
+    sql`${table.leadAttributionScope} IS NULL OR ${table.leadAttributionScope} IN ('landing-page', 'channel')`
+  )
+]);
 var gaAiReferrals = sqliteTable("ga_ai_referrals", {
   id: text("id").primaryKey(),
   projectId: text("project_id").notNull().references(() => projects.id, { onDelete: "cascade" }),
@@ -1310,6 +1419,45 @@ var discoverySessions = sqliteTable("discovery_sessions", {
   index("idx_discovery_sessions_project_created").on(table.projectId, table.createdAt),
   index("idx_discovery_sessions_run").on(table.runId)
 ]);
+var researchRuns = sqliteTable("research_runs", {
+  id: text("id").primaryKey(),
+  projectId: text("project_id").notNull().references(() => projects.id, { onDelete: "cascade" }),
+  status: text("status").notNull().default("queued"),
+  provider: text("provider").notNull(),
+  requestedModel: text("requested_model"),
+  resolvedModel: text("resolved_model").notNull(),
+  location: text("location", { mode: "json" }).$type(),
+  totalQueries: integer("total_queries").notNull(),
+  completedQueries: integer("completed_queries").notNull().default(0),
+  failedQueries: integer("failed_queries").notNull().default(0),
+  idempotencyKey: text("idempotency_key"),
+  requestHash: text("request_hash"),
+  error: text("error"),
+  startedAt: text("started_at"),
+  finishedAt: text("finished_at"),
+  createdAt: text("created_at").notNull()
+}, (table) => [index("idx_research_runs_project_created").on(table.projectId, table.createdAt), index("idx_research_runs_status").on(table.status), uniqueIndex("idx_research_runs_project_idempotency").on(table.projectId, table.idempotencyKey)]);
+var researchRunQueries = sqliteTable("research_run_queries", {
+  id: text("id").primaryKey(),
+  researchRunId: text("research_run_id").notNull().references(() => researchRuns.id, { onDelete: "cascade" }),
+  position: integer("position").notNull(),
+  queryText: text("query_text").notNull(),
+  status: text("status").notNull().default("queued"),
+  requestedModel: text("requested_model"),
+  resolvedModel: text("resolved_model").notNull(),
+  servedModel: text("served_model"),
+  answerText: text("answer_text"),
+  groundingSources: text("grounding_sources", { mode: "json" }).$type().notNull().default([]),
+  citedDomains: text("cited_domains", { mode: "json" }).$type().notNull().default([]),
+  searchQueries: text("search_queries", { mode: "json" }).$type().notNull().default([]),
+  answerMentioned: integer("answer_mentioned", { mode: "boolean" }),
+  citationState: text("citation_state"),
+  rawResponse: text("raw_response", { mode: "json" }).$type(),
+  error: text("error"),
+  startedAt: text("started_at"),
+  finishedAt: text("finished_at"),
+  createdAt: text("created_at").notNull()
+}, (table) => [index("idx_research_run_queries_run").on(table.researchRunId), uniqueIndex("idx_research_run_queries_run_position").on(table.researchRunId, table.position)]);
 var discoveryProbes = sqliteTable("discovery_probes", {
   id: text("id").primaryKey(),
   sessionId: text("session_id").notNull().references(() => discoverySessions.id, { onDelete: "cascade" }),
@@ -1716,7 +1864,7 @@ function parseJsonColumn(value, fallback) {
 }
 
 // ../db/src/migrate.ts
-import { sql } from "drizzle-orm";
+import { sql as sql2 } from "drizzle-orm";
 var MIGRATION_SQL = `
 CREATE TABLE IF NOT EXISTS projects (
   id                TEXT PRIMARY KEY,
@@ -1859,14 +2007,14 @@ CREATE TABLE IF NOT EXISTS _migrations (
 );
 `;
 function relinkOrphanedSnapshotQueryIds(tx) {
-  const orphans = tx.all(sql`
+  const orphans = tx.all(sql2`
     SELECT qs.id AS snapId, qs.query_text AS text, r.project_id AS projectId
     FROM query_snapshots qs
     JOIN runs r ON r.id = qs.run_id
     WHERE qs.query_id IS NULL AND qs.query_text IS NOT NULL
   `);
   if (orphans.length === 0) return;
-  const queryRows = tx.all(sql`SELECT id, project_id AS projectId, query FROM queries`);
+  const queryRows = tx.all(sql2`SELECT id, project_id AS projectId, query FROM queries`);
   const byProject = /* @__PURE__ */ new Map();
   for (const row of queryRows) {
     let perProject = byProject.get(row.projectId);
@@ -1880,12 +2028,12 @@ function relinkOrphanedSnapshotQueryIds(tx) {
   for (const orphan of orphans) {
     const queryId = byProject.get(orphan.projectId)?.get(normalizeQueryText(orphan.text));
     if (queryId) {
-      tx.run(sql`UPDATE query_snapshots SET query_id = ${queryId} WHERE id = ${orphan.snapId}`);
+      tx.run(sql2`UPDATE query_snapshots SET query_id = ${queryId} WHERE id = ${orphan.snapId}`);
     }
   }
 }
 function backfillQuerySnapshotServedModel(tx) {
-  tx.run(sql.raw(`
+  tx.run(sql2.raw(`
     UPDATE query_snapshots
     SET served_model = json_extract(raw_response, '$.apiResponse.model')
     WHERE served_model IS NULL
@@ -2670,10 +2818,10 @@ var MIGRATION_VERSIONS = [
     run: (tx) => {
       if (!tableExists(tx, "ga_ai_referrals")) return;
       if (!columnExists(tx, "ga_ai_referrals", "channel_group")) {
-        tx.run(sql.raw(`ALTER TABLE ga_ai_referrals ADD COLUMN channel_group TEXT NOT NULL DEFAULT '(not set)'`));
+        tx.run(sql2.raw(`ALTER TABLE ga_ai_referrals ADD COLUMN channel_group TEXT NOT NULL DEFAULT '(not set)'`));
       }
-      tx.run(sql.raw(`DROP INDEX IF EXISTS idx_ga_ai_ref_unique_v3`));
-      tx.run(sql.raw(`CREATE UNIQUE INDEX IF NOT EXISTS idx_ga_ai_ref_unique_v4
+      tx.run(sql2.raw(`DROP INDEX IF EXISTS idx_ga_ai_ref_unique_v3`));
+      tx.run(sql2.raw(`CREATE UNIQUE INDEX IF NOT EXISTS idx_ga_ai_ref_unique_v4
          ON ga_ai_referrals(project_id, date, source, medium, source_dimension, channel_group, landing_page)`));
     }
   },
@@ -3126,11 +3274,11 @@ var MIGRATION_VERSIONS = [
     statements: [],
     run: (db) => {
       if (tableExists(db, "google_connections") && !columnExists(db, "google_connections", "created_by_project_id")) {
-        db.run(sql.raw(
+        db.run(sql2.raw(
           `ALTER TABLE google_connections ADD COLUMN created_by_project_id TEXT REFERENCES projects(id) ON DELETE SET NULL`
         ));
-        db.run(sql.raw(`CREATE INDEX IF NOT EXISTS idx_google_conn_project ON google_connections(created_by_project_id)`));
-        db.run(sql.raw(
+        db.run(sql2.raw(`CREATE INDEX IF NOT EXISTS idx_google_conn_project ON google_connections(created_by_project_id)`));
+        db.run(sql2.raw(
           `UPDATE google_connections
               SET created_by_project_id = (
                 SELECT p.id FROM projects p
@@ -3142,11 +3290,11 @@ var MIGRATION_VERSIONS = [
         ));
       }
       if (tableExists(db, "bing_connections") && !columnExists(db, "bing_connections", "created_by_project_id")) {
-        db.run(sql.raw(
+        db.run(sql2.raw(
           `ALTER TABLE bing_connections ADD COLUMN created_by_project_id TEXT REFERENCES projects(id) ON DELETE SET NULL`
         ));
-        db.run(sql.raw(`CREATE INDEX IF NOT EXISTS idx_bing_conn_project ON bing_connections(created_by_project_id)`));
-        db.run(sql.raw(
+        db.run(sql2.raw(`CREATE INDEX IF NOT EXISTS idx_bing_conn_project ON bing_connections(created_by_project_id)`));
+        db.run(sql2.raw(
           `UPDATE bing_connections
               SET created_by_project_id = (
                 SELECT p.id FROM projects p
@@ -3516,10 +3664,10 @@ var MIGRATION_VERSIONS = [
     run: (db) => {
       if (!tableExists(db, "health_snapshots")) return;
       if (!columnExists(db, "health_snapshots", "overall_mention_rate")) {
-        db.run(sql.raw(`ALTER TABLE health_snapshots ADD COLUMN overall_mention_rate TEXT`));
+        db.run(sql2.raw(`ALTER TABLE health_snapshots ADD COLUMN overall_mention_rate TEXT`));
       }
       if (!columnExists(db, "health_snapshots", "mentioned_pairs")) {
-        db.run(sql.raw(`ALTER TABLE health_snapshots ADD COLUMN mentioned_pairs INTEGER`));
+        db.run(sql2.raw(`ALTER TABLE health_snapshots ADD COLUMN mentioned_pairs INTEGER`));
       }
     }
   },
@@ -3540,7 +3688,7 @@ var MIGRATION_VERSIONS = [
       ];
       for (const col of cols) {
         if (!columnExists(db, "gbp_locations", col)) {
-          db.run(sql.raw(`ALTER TABLE gbp_locations ADD COLUMN ${col} TEXT`));
+          db.run(sql2.raw(`ALTER TABLE gbp_locations ADD COLUMN ${col} TEXT`));
         }
       }
     }
@@ -3736,9 +3884,9 @@ var MIGRATION_VERSIONS = [
     run: (tx) => {
       if (!tableExists(tx, "ga_ai_referrals")) return;
       if (!columnExists(tx, "ga_ai_referrals", "traffic_class")) {
-        tx.run(sql.raw(`ALTER TABLE ga_ai_referrals ADD COLUMN traffic_class TEXT NOT NULL DEFAULT 'organic'`));
+        tx.run(sql2.raw(`ALTER TABLE ga_ai_referrals ADD COLUMN traffic_class TEXT NOT NULL DEFAULT 'organic'`));
       }
-      tx.run(sql.raw(`CREATE INDEX IF NOT EXISTS idx_ga_ai_ref_traffic_class ON ga_ai_referrals(project_id, date, traffic_class)`));
+      tx.run(sql2.raw(`CREATE INDEX IF NOT EXISTS idx_ga_ai_ref_traffic_class ON ga_ai_referrals(project_id, date, traffic_class)`));
     }
   },
   {
@@ -4022,14 +4170,98 @@ var MIGRATION_VERSIONS = [
       `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)`
     ]
+  },
+  {
+    version: 108,
+    name: "research-query-runs",
+    statements: [
+      `CREATE TABLE IF NOT EXISTS research_runs (id TEXT PRIMARY KEY, project_id TEXT NOT NULL REFERENCES projects(id) ON DELETE CASCADE, status TEXT NOT NULL DEFAULT 'queued', provider TEXT NOT NULL, requested_model TEXT, resolved_model TEXT NOT NULL, location TEXT, total_queries INTEGER NOT NULL, completed_queries INTEGER NOT NULL DEFAULT 0, failed_queries INTEGER NOT NULL DEFAULT 0, idempotency_key TEXT, request_hash TEXT, error TEXT, started_at TEXT, finished_at TEXT, created_at TEXT NOT NULL)`,
+      `CREATE INDEX IF NOT EXISTS idx_research_runs_project_created ON research_runs(project_id, created_at)`,
+      `CREATE INDEX IF NOT EXISTS idx_research_runs_status ON research_runs(status)`,
+      `CREATE UNIQUE INDEX IF NOT EXISTS idx_research_runs_project_idempotency ON research_runs(project_id, idempotency_key)`,
+      `CREATE TABLE IF NOT EXISTS research_run_queries (id TEXT PRIMARY KEY, research_run_id TEXT NOT NULL REFERENCES research_runs(id) ON DELETE CASCADE, position INTEGER NOT NULL, query_text TEXT NOT NULL, status TEXT NOT NULL DEFAULT 'queued', requested_model TEXT, resolved_model TEXT NOT NULL, served_model TEXT, answer_text TEXT, grounding_sources TEXT NOT NULL DEFAULT '[]', cited_domains TEXT NOT NULL DEFAULT '[]', search_queries TEXT NOT NULL DEFAULT '[]', answer_mentioned INTEGER, citation_state TEXT, raw_response TEXT, error TEXT, started_at TEXT, finished_at TEXT, created_at TEXT NOT NULL)`,
+      `CREATE INDEX IF NOT EXISTS idx_research_run_queries_run ON research_run_queries(research_run_id)`,
+      `CREATE UNIQUE INDEX IF NOT EXISTS idx_research_run_queries_run_position ON research_run_queries(research_run_id, position)`
+    ]
+  },
+  {
+    version: 109,
+    name: "ga-measurement-foundation",
+    statements: [
+      `ALTER TABLE projects ADD COLUMN measurement_config TEXT NOT NULL DEFAULT '{"marketingHosts":[],"brandTerms":[],"leadEventNames":["generate_lead"]}'`,
+      `CREATE TABLE IF NOT EXISTS ga_acquisition_daily (
+        id                       TEXT PRIMARY KEY,
+        project_id               TEXT NOT NULL REFERENCES projects(id) ON DELETE CASCADE,
+        date                     TEXT NOT NULL,
+        channel_group            TEXT NOT NULL,
+        source                   TEXT NOT NULL,
+        medium                   TEXT NOT NULL,
+        host_name                TEXT NOT NULL,
+        landing_page             TEXT NOT NULL,
+        landing_page_normalized  TEXT,
+        sessions                 INTEGER NOT NULL DEFAULT 0 CHECK (sessions >= 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_ga_acquisition_daily_grain
+        ON ga_acquisition_daily(project_id, date, channel_group, source, medium, host_name, landing_page)`,
+      `CREATE INDEX IF NOT EXISTS idx_ga_acquisition_daily_project_date
+        ON ga_acquisition_daily(project_id, date)`,
+      `CREATE INDEX IF NOT EXISTS idx_ga_acquisition_daily_project_channel
+        ON ga_acquisition_daily(project_id, date, channel_group)`,
+      `CREATE INDEX IF NOT EXISTS idx_ga_acquisition_daily_project_page
+        ON ga_acquisition_daily(project_id, date, landing_page_normalized)`,
+      `CREATE TABLE IF NOT EXISTS ga_lead_events_daily (
+        id                       TEXT PRIMARY KEY,
+        project_id               TEXT NOT NULL REFERENCES projects(id) ON DELETE CASCADE,
+        date                     TEXT NOT NULL,
+        event_name               TEXT NOT NULL,
+        channel_group            TEXT NOT NULL,
+        source                   TEXT NOT NULL,
+        medium                   TEXT NOT NULL,
+        host_name                TEXT NOT NULL,
+        landing_page             TEXT NOT NULL,
+        landing_page_normalized  TEXT,
+        attribution_scope        TEXT NOT NULL CHECK (attribution_scope IN ('landing-page', 'channel')),
+        event_count              INTEGER NOT NULL DEFAULT 0 CHECK (event_count >= 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_ga_lead_events_daily_grain
+        ON ga_lead_events_daily(project_id, date, event_name, channel_group, source, medium, host_name, landing_page, attribution_scope)`,
+      `CREATE INDEX IF NOT EXISTS idx_ga_lead_events_daily_project_date
+        ON ga_lead_events_daily(project_id, date)`,
+      `CREATE INDEX IF NOT EXISTS idx_ga_lead_events_daily_project_channel
+        ON ga_lead_events_daily(project_id, date, channel_group)`,
+      `CREATE INDEX IF NOT EXISTS idx_ga_lead_events_daily_project_event
+        ON ga_lead_events_daily(project_id, date, event_name)`,
+      `CREATE INDEX IF NOT EXISTS idx_ga_lead_events_daily_project_page
+        ON ga_lead_events_daily(project_id, date, landing_page_normalized)`,
+      `CREATE TABLE IF NOT EXISTS ga_measurement_sync_state (
+        project_id                TEXT PRIMARY KEY REFERENCES projects(id) ON DELETE CASCADE,
+        acquisition_status        TEXT NOT NULL DEFAULT 'never-synced'
+                                  CHECK (acquisition_status IN ('never-synced', 'ready', 'error')),
+        acquisition_error         TEXT,
+        acquisition_synced_at     TEXT,
+        lead_status               TEXT NOT NULL DEFAULT 'never-synced'
+                                  CHECK (lead_status IN ('never-synced', 'ready', 'error')),
+        lead_error                TEXT,
+        lead_synced_at            TEXT,
+        lead_attribution_scope    TEXT
+                                  CHECK (lead_attribution_scope IS NULL OR lead_attribution_scope IN ('landing-page', 'channel')),
+        updated_at                TEXT NOT NULL
+      )`
+    ]
   }
 ];
 function rebuildBacklinkTableWithSource(tx, table) {
   if (!tableExists(tx, table)) return;
   if (columnExists(tx, table, "source")) return;
   if (table === "backlink_domains") {
-    tx.run(sql.raw(`DROP TABLE IF EXISTS backlink_domains_v78`));
-    tx.run(sql.raw(`CREATE TABLE backlink_domains_v78 (
+    tx.run(sql2.raw(`DROP TABLE IF EXISTS backlink_domains_v78`));
+    tx.run(sql2.raw(`CREATE TABLE backlink_domains_v78 (
       id               TEXT PRIMARY KEY,
       project_id       TEXT NOT NULL REFERENCES projects(id) ON DELETE CASCADE,
       release_sync_id  TEXT REFERENCES cc_release_syncs(id) ON DELETE CASCADE,
@@ -4040,24 +4272,24 @@ function rebuildBacklinkTableWithSource(tx, table) {
       num_hosts        INTEGER NOT NULL,
       created_at       TEXT NOT NULL
     )`));
-    tx.run(sql.raw(`INSERT INTO backlink_domains_v78
+    tx.run(sql2.raw(`INSERT INTO backlink_domains_v78
         (id, project_id, release_sync_id, source, release, target_domain, linking_domain, num_hosts, created_at)
       SELECT bd.id, bd.project_id,
              CASE WHEN bd.release_sync_id IN (SELECT id FROM cc_release_syncs) THEN bd.release_sync_id ELSE NULL END,
              'commoncrawl', bd.release, bd.target_domain, bd.linking_domain, bd.num_hosts, bd.created_at
       FROM backlink_domains bd
       WHERE bd.project_id IN (SELECT id FROM projects)`));
-    tx.run(sql.raw(`DROP TABLE backlink_domains`));
-    tx.run(sql.raw(`ALTER TABLE backlink_domains_v78 RENAME TO backlink_domains`));
-    tx.run(sql.raw(`CREATE INDEX IF NOT EXISTS idx_backlink_domains_project ON backlink_domains(project_id)`));
-    tx.run(sql.raw(`CREATE INDEX IF NOT EXISTS idx_backlink_domains_release_sync ON backlink_domains(release_sync_id)`));
-    tx.run(sql.raw(`CREATE INDEX IF NOT EXISTS idx_backlink_domains_project_release ON backlink_domains(project_id, release)`));
-    tx.run(sql.raw(`CREATE INDEX IF NOT EXISTS idx_backlink_domains_hosts ON backlink_domains(num_hosts)`));
-    tx.run(sql.raw(`CREATE UNIQUE INDEX IF NOT EXISTS idx_backlink_domains_unique ON backlink_domains(project_id, source, release, linking_domain)`));
+    tx.run(sql2.raw(`DROP TABLE backlink_domains`));
+    tx.run(sql2.raw(`ALTER TABLE backlink_domains_v78 RENAME TO backlink_domains`));
+    tx.run(sql2.raw(`CREATE INDEX IF NOT EXISTS idx_backlink_domains_project ON backlink_domains(project_id)`));
+    tx.run(sql2.raw(`CREATE INDEX IF NOT EXISTS idx_backlink_domains_release_sync ON backlink_domains(release_sync_id)`));
+    tx.run(sql2.raw(`CREATE INDEX IF NOT EXISTS idx_backlink_domains_project_release ON backlink_domains(project_id, release)`));
+    tx.run(sql2.raw(`CREATE INDEX IF NOT EXISTS idx_backlink_domains_hosts ON backlink_domains(num_hosts)`));
+    tx.run(sql2.raw(`CREATE UNIQUE INDEX IF NOT EXISTS idx_backlink_domains_unique ON backlink_domains(project_id, source, release, linking_domain)`));
     return;
   }
-  tx.run(sql.raw(`DROP TABLE IF EXISTS backlink_summaries_v78`));
-  tx.run(sql.raw(`CREATE TABLE backlink_summaries_v78 (
+  tx.run(sql2.raw(`DROP TABLE IF EXISTS backlink_summaries_v78`));
+  tx.run(sql2.raw(`CREATE TABLE backlink_summaries_v78 (
     id                     TEXT PRIMARY KEY,
     project_id             TEXT NOT NULL REFERENCES projects(id) ON DELETE CASCADE,
     release_sync_id        TEXT REFERENCES cc_release_syncs(id) ON DELETE CASCADE,
@@ -4070,17 +4302,17 @@ function rebuildBacklinkTableWithSource(tx, table) {
     queried_at             TEXT NOT NULL,
     created_at             TEXT NOT NULL
   )`));
-  tx.run(sql.raw(`INSERT INTO backlink_summaries_v78
+  tx.run(sql2.raw(`INSERT INTO backlink_summaries_v78
       (id, project_id, release_sync_id, source, release, target_domain, total_linking_domains, total_hosts, top_10_hosts_share, queried_at, created_at)
     SELECT bs.id, bs.project_id,
            CASE WHEN bs.release_sync_id IN (SELECT id FROM cc_release_syncs) THEN bs.release_sync_id ELSE NULL END,
            'commoncrawl', bs.release, bs.target_domain, bs.total_linking_domains, bs.total_hosts, bs.top_10_hosts_share, bs.queried_at, bs.created_at
     FROM backlink_summaries bs
     WHERE bs.project_id IN (SELECT id FROM projects)`));
-  tx.run(sql.raw(`DROP TABLE backlink_summaries`));
-  tx.run(sql.raw(`ALTER TABLE backlink_summaries_v78 RENAME TO backlink_summaries`));
-  tx.run(sql.raw(`CREATE UNIQUE INDEX IF NOT EXISTS idx_backlink_summaries_project_release ON backlink_summaries(project_id, source, release)`));
-  tx.run(sql.raw(`CREATE INDEX IF NOT EXISTS idx_backlink_summaries_project ON backlink_summaries(project_id)`));
+  tx.run(sql2.raw(`DROP TABLE backlink_summaries`));
+  tx.run(sql2.raw(`ALTER TABLE backlink_summaries_v78 RENAME TO backlink_summaries`));
+  tx.run(sql2.raw(`CREATE UNIQUE INDEX IF NOT EXISTS idx_backlink_summaries_project_release ON backlink_summaries(project_id, source, release)`));
+  tx.run(sql2.raw(`CREATE INDEX IF NOT EXISTS idx_backlink_summaries_project ON backlink_summaries(project_id)`));
 }
 function addBacklinkSourceDiscriminator(tx) {
   rebuildBacklinkTableWithSource(tx, "backlink_domains");
@@ -4093,25 +4325,25 @@ function isDuplicateColumnError(err) {
   return false;
 }
 function columnExists(db, table, column) {
-  const rows = db.all(sql.raw(
+  const rows = db.all(sql2.raw(
     `SELECT COUNT(*) as c FROM pragma_table_info('${table}') WHERE name = '${column}'`
   ));
   return (rows[0]?.c ?? 0) > 0;
 }
 function tableExists(db, table) {
-  const rows = db.all(sql.raw(
+  const rows = db.all(sql2.raw(
     `SELECT COUNT(*) as c FROM sqlite_master WHERE type = 'table' AND name = '${table}'`
   ));
   return (rows[0]?.c ?? 0) > 0;
 }
 function tableIsEmpty(db, table) {
-  const rows = db.all(sql.raw(`SELECT COUNT(*) as c FROM ${table}`));
+  const rows = db.all(sql2.raw(`SELECT COUNT(*) as c FROM ${table}`));
   return (rows[0]?.c ?? 0) === 0;
 }
 function backfillGaAiReferralTrafficClass(tx) {
   if (!tableExists(tx, "ga_ai_referrals")) return 0;
   if (!columnExists(tx, "ga_ai_referrals", "traffic_class")) return 0;
-  const rows = tx.all(sql.raw(
+  const rows = tx.all(sql2.raw(
     `SELECT id, source, medium, channel_group, landing_page, traffic_class FROM ga_ai_referrals`
   ));
   let updated = 0;
@@ -4123,7 +4355,7 @@ function backfillGaAiReferralTrafficClass(tx) {
       landingPage: row.landing_page
     });
     if (next === row.traffic_class) continue;
-    tx.run(sql`UPDATE ga_ai_referrals SET traffic_class = ${next} WHERE id = ${row.id}`);
+    tx.run(sql2`UPDATE ga_ai_referrals SET traffic_class = ${next} WHERE id = ${row.id}`);
     updated += 1;
   }
   return updated;
@@ -4137,28 +4369,28 @@ function normalizeLegacyQuerySchema(db) {
     if (!tableIsEmpty(db, "queries")) {
       throw new Error("Cannot migrate keywords to queries because both tables contain data");
     }
-    db.run(sql.raw(`DROP TABLE queries`));
+    db.run(sql2.raw(`DROP TABLE queries`));
   }
-  db.run(sql.raw(`DROP INDEX IF EXISTS idx_keywords_project`));
-  db.run(sql.raw(`DROP INDEX IF EXISTS idx_keywords_project_keyword`));
-  db.run(sql.raw(`DROP INDEX IF EXISTS idx_snapshots_keyword`));
-  db.run(sql.raw(`DROP INDEX IF EXISTS idx_insights_keyword_provider`));
+  db.run(sql2.raw(`DROP INDEX IF EXISTS idx_keywords_project`));
+  db.run(sql2.raw(`DROP INDEX IF EXISTS idx_keywords_project_keyword`));
+  db.run(sql2.raw(`DROP INDEX IF EXISTS idx_snapshots_keyword`));
+  db.run(sql2.raw(`DROP INDEX IF EXISTS idx_insights_keyword_provider`));
   if (tableExists(db, "keywords")) {
-    db.run(sql.raw(`ALTER TABLE keywords RENAME TO queries`));
+    db.run(sql2.raw(`ALTER TABLE keywords RENAME TO queries`));
   }
   if (columnExists(db, "queries", "keyword")) {
-    db.run(sql.raw(`ALTER TABLE queries RENAME COLUMN keyword TO query`));
+    db.run(sql2.raw(`ALTER TABLE queries RENAME COLUMN keyword TO query`));
   }
   if (columnExists(db, "query_snapshots", "keyword_id")) {
-    db.run(sql.raw(`ALTER TABLE query_snapshots RENAME COLUMN keyword_id TO query_id`));
+    db.run(sql2.raw(`ALTER TABLE query_snapshots RENAME COLUMN keyword_id TO query_id`));
   }
   if (columnExists(db, "insights", "keyword")) {
-    db.run(sql.raw(`ALTER TABLE insights RENAME COLUMN keyword TO query`));
+    db.run(sql2.raw(`ALTER TABLE insights RENAME COLUMN keyword TO query`));
   }
 }
 function dropColumnIfExists(db, table, column) {
   try {
-    db.run(sql.raw(`ALTER TABLE ${table} DROP COLUMN ${column}`));
+    db.run(sql2.raw(`ALTER TABLE ${table} DROP COLUMN ${column}`));
   } catch (err) {
     if (!(err instanceof Error)) throw err;
     const msg = err.message;
@@ -4173,7 +4405,7 @@ function dropColumnIfExists(db, table, column) {
 function extractLegacyCredentials(db) {
   const out = { google: [], ga4: [] };
   if (columnExists(db, "google_connections", "access_token")) {
-    const rows = db.all(sql.raw(
+    const rows = db.all(sql2.raw(
       `SELECT domain, connection_type, property_id, sitemap_url, access_token, refresh_token, token_expires_at, scopes, created_at, updated_at
        FROM google_connections
        WHERE refresh_token IS NOT NULL AND refresh_token != ''`
@@ -4194,7 +4426,7 @@ function extractLegacyCredentials(db) {
     }
   }
   if (columnExists(db, "ga_connections", "private_key")) {
-    const rows = db.all(sql.raw(
+    const rows = db.all(sql2.raw(
       `SELECT p.name AS project_name, ga.property_id, ga.client_email, ga.private_key, ga.created_at, ga.updated_at
        FROM ga_connections ga
        INNER JOIN projects p ON p.id = ga.project_id
@@ -4228,11 +4460,11 @@ function dropLegacyCredentialColumns(db) {
   }
 }
 function getAppliedVersion(db) {
-  const rows = db.all(sql`SELECT MAX(version) as max_version FROM _migrations`);
+  const rows = db.all(sql2`SELECT MAX(version) as max_version FROM _migrations`);
   return rows[0]?.max_version ?? 0;
 }
 function recordMigration(db, version, name) {
-  db.run(sql`INSERT OR IGNORE INTO _migrations (version, name) VALUES (${version}, ${name})`);
+  db.run(sql2`INSERT OR IGNORE INTO _migrations (version, name) VALUES (${version}, ${name})`);
 }
 function migrate(db, versions = MIGRATION_VERSIONS) {
   db.transaction((tx) => {
@@ -4240,7 +4472,7 @@ function migrate(db, versions = MIGRATION_VERSIONS) {
   });
   const statements = MIGRATION_SQL.split(";").map((s) => s.trim()).filter((s) => s.length > 0);
   for (const statement of statements) {
-    db.run(sql.raw(statement));
+    db.run(sql2.raw(statement));
   }
   const appliedVersion = getAppliedVersion(db);
   for (const mv of versions) {
@@ -4248,7 +4480,7 @@ function migrate(db, versions = MIGRATION_VERSIONS) {
     db.transaction((tx) => {
       for (const statement of mv.statements) {
         try {
-          tx.run(sql.raw(statement));
+          tx.run(sql2.raw(statement));
         } catch (err) {
           if (isDuplicateColumnError(err)) continue;
           throw err;
@@ -6554,11 +6786,11 @@ async function authPlugin(app, opts = {}) {
 
 // ../api-routes/src/projects.ts
 import crypto4 from "crypto";
-import { eq as eq3, sql as sql3 } from "drizzle-orm";
+import { eq as eq3, sql as sql4 } from "drizzle-orm";
 
 // ../api-routes/src/helpers.ts
 import crypto3 from "crypto";
-import { eq as eq2, ne, sql as sql2 } from "drizzle-orm";
+import { eq as eq2, ne, sql as sql3 } from "drizzle-orm";
 function notProbeRun() {
   return ne(runs.trigger, RunTriggers.probe);
 }
@@ -6836,6 +7068,7 @@ async function projectRoutes(app, opts) {
       });
     }
     const nextAutoExtractBacklinks = body.autoExtractBacklinks !== void 0 ? body.autoExtractBacklinks : existing?.autoExtractBacklinks ?? false;
+    const nextMeasurement = body.measurement ?? existing?.measurement ?? DEFAULT_MEASUREMENT_CONFIG;
     const nextAliases = normalizeProjectAliases(body.displayName, body.aliases ?? []);
     if (existing) {
       const prevAliases = existing.aliases;
@@ -6852,6 +7085,7 @@ async function projectRoutes(app, opts) {
           labels: body.labels ?? {},
           providers: body.providers ?? [],
           providerModels,
+          measurement: nextMeasurement,
           locations: nextLocations,
           defaultLocation: nextDefaultLocation,
           autoExtractBacklinks: nextAutoExtractBacklinks,
@@ -6887,6 +7121,7 @@ async function projectRoutes(app, opts) {
         labels: body.labels ?? {},
         providers: body.providers ?? [],
         providerModels,
+        measurement: nextMeasurement,
         locations: nextLocations,
         defaultLocation: nextDefaultLocation,
         autoExtractBacklinks: nextAutoExtractBacklinks,
@@ -6920,12 +7155,12 @@ async function projectRoutes(app, opts) {
     const project = resolveProject(app.db, request.params.name);
     const pid = project.id;
     const count2 = (n) => n ?? 0;
-    const queryCount = app.db.select({ n: sql3`count(*)` }).from(queries).where(eq3(queries.projectId, pid)).get();
-    const competitorCount = app.db.select({ n: sql3`count(*)` }).from(competitors).where(eq3(competitors.projectId, pid)).get();
-    const runCount = app.db.select({ n: sql3`count(*)` }).from(runs).where(eq3(runs.projectId, pid)).get();
-    const snapshotCount = app.db.select({ n: sql3`count(*)` }).from(querySnapshots).innerJoin(runs, eq3(querySnapshots.runId, runs.id)).where(eq3(runs.projectId, pid)).get();
-    const insightCount = app.db.select({ n: sql3`count(*)` }).from(insights).where(eq3(insights.projectId, pid)).get();
-    const auditLogCount = app.db.select({ n: sql3`count(*)` }).from(auditLog).where(eq3(auditLog.projectId, pid)).get();
+    const queryCount = app.db.select({ n: sql4`count(*)` }).from(queries).where(eq3(queries.projectId, pid)).get();
+    const competitorCount = app.db.select({ n: sql4`count(*)` }).from(competitors).where(eq3(competitors.projectId, pid)).get();
+    const runCount = app.db.select({ n: sql4`count(*)` }).from(runs).where(eq3(runs.projectId, pid)).get();
+    const snapshotCount = app.db.select({ n: sql4`count(*)` }).from(querySnapshots).innerJoin(runs, eq3(querySnapshots.runId, runs.id)).where(eq3(runs.projectId, pid)).get();
+    const insightCount = app.db.select({ n: sql4`count(*)` }).from(insights).where(eq3(insights.projectId, pid)).get();
+    const auditLogCount = app.db.select({ n: sql4`count(*)` }).from(auditLog).where(eq3(auditLog.projectId, pid)).get();
     return reply.send({
       project: { id: project.id, name: project.name },
       cascadeRows: {
@@ -7059,6 +7294,7 @@ async function projectRoutes(app, opts) {
         competitors: comps.map((c) => c.domain),
         providers: project.providers,
         ...Object.keys(project.providerModels).length > 0 ? { providerModels: project.providerModels } : {},
+        measurement: project.measurement,
         locations: project.locations,
         ...project.defaultLocation ? { defaultLocation: project.defaultLocation } : {},
         ...project.autoExtractBacklinks ? { autoExtractBacklinks: true } : {},
@@ -7107,6 +7343,7 @@ function formatProject(row) {
     labels: row.labels,
     providers: row.providers,
     providerModels: row.providerModels,
+    measurement: row.measurement,
     locations: row.locations,
     defaultLocation: row.defaultLocation,
     autoExtractBacklinks: row.autoExtractBacklinks,
@@ -7126,7 +7363,7 @@ function aliasArraysEqual(a, b) {
 
 // ../api-routes/src/queries.ts
 import crypto6 from "crypto";
-import { and, eq as eq5, inArray as inArray2, sql as sql4 } from "drizzle-orm";
+import { and, eq as eq5, inArray as inArray2, sql as sql5 } from "drizzle-orm";
 
 // ../api-routes/src/query-replace.ts
 import crypto5 from "crypto";
@@ -7248,9 +7485,9 @@ async function queryRoutes(app, opts) {
     let snapshotsDetached = 0;
     let affectedQueries = 0;
     if (removedIds.length > 0) {
-      const snapshotCount = app.db.select({ n: sql4`count(*)` }).from(querySnapshots).where(inArray2(querySnapshots.queryId, removedIds)).get();
+      const snapshotCount = app.db.select({ n: sql5`count(*)` }).from(querySnapshots).where(inArray2(querySnapshots.queryId, removedIds)).get();
       snapshotsDetached = snapshotCount?.n ?? 0;
-      const distinctAffected = app.db.select({ n: sql4`count(distinct ${querySnapshots.queryId})` }).from(querySnapshots).where(inArray2(querySnapshots.queryId, removedIds)).get();
+      const distinctAffected = app.db.select({ n: sql5`count(distinct ${querySnapshots.queryId})` }).from(querySnapshots).where(inArray2(querySnapshots.queryId, removedIds)).get();
       affectedQueries = distinctAffected?.n ?? 0;
     }
     return reply.send({
@@ -7659,7 +7896,7 @@ function parseCompetitorBatch(value) {
 
 // ../api-routes/src/runs.ts
 import crypto9 from "crypto";
-import { and as and4, eq as eq8, asc, desc, or as or2, sql as sql5 } from "drizzle-orm";
+import { and as and4, eq as eq8, asc, desc, or as or2, sql as sql6 } from "drizzle-orm";
 import { gte } from "drizzle-orm";
 
 // ../api-routes/src/run-queue.ts
@@ -7834,7 +8071,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: sql5`count(*)` }).from(runs).where(and4(eq8(runs.projectId, project.id), notProbeRun())).get();
+    const countRow = app.db.select({ count: sql6`count(*)` }).from(runs).where(and4(eq8(runs.projectId, project.id), notProbeRun())).get();
     const totalRuns = countRow?.count ?? 0;
     const latestRun = app.db.select().from(runs).where(and4(eq8(runs.projectId, project.id), notProbeRun())).orderBy(desc(runs.createdAt), desc(runs.id)).limit(1).get();
     if (!latestRun) {
@@ -8440,6 +8677,7 @@ async function applyRoutes(app, opts) {
           labels: config.metadata.labels,
           providers: config.spec.providers ?? [],
           providerModels,
+          measurement: config.spec.measurement,
           locations: config.spec.locations ?? [],
           defaultLocation: config.spec.defaultLocation ?? null,
           autoExtractBacklinks: config.spec.autoExtractBacklinks ?? false,
@@ -8469,6 +8707,7 @@ async function applyRoutes(app, opts) {
           labels: config.metadata.labels,
           providers: config.spec.providers ?? [],
           providerModels,
+          measurement: config.spec.measurement,
           locations: config.spec.locations ?? [],
           defaultLocation: config.spec.defaultLocation ?? null,
           autoExtractBacklinks: config.spec.autoExtractBacklinks ?? false,
@@ -8594,6 +8833,7 @@ async function applyRoutes(app, opts) {
       labels: project.labels,
       providers: project.providers,
       providerModels: project.providerModels,
+      measurement: project.measurement,
       locations: project.locations,
       defaultLocation: project.defaultLocation,
       autoExtractBacklinks: project.autoExtractBacklinks,
@@ -9931,7 +10171,7 @@ async function intelligenceRoutes(app) {
 }
 
 // ../api-routes/src/report.ts
-import { and as and12, desc as desc7, eq as eq16, gte as gte4, inArray as inArray7, lt as lt2, lte, ne as ne2, or as or3, sql as sql7 } from "drizzle-orm";
+import { and as and12, desc as desc7, eq as eq16, gte as gte4, inArray as inArray7, lt as lt2, lte, ne as ne2, or as or3, sql as sql8 } from "drizzle-orm";
 
 // ../api-routes/src/content.ts
 import crypto12 from "crypto";
@@ -10672,7 +10912,7 @@ function winnabilityClassRank(winnabilityClass) {
 }
 
 // ../api-routes/src/gsc-totals.ts
-import { and as and11, asc as asc3, eq as eq15, sql as sql6 } from "drizzle-orm";
+import { and as and11, asc as asc3, eq as eq15, sql as sql7 } from "drizzle-orm";
 function readGscDailyTotals(db, projectId, startDate, endDate) {
   const rows = db.select({
     date: gscDailyTotals.date,
@@ -10682,8 +10922,8 @@ function readGscDailyTotals(db, projectId, startDate, endDate) {
   }).from(gscDailyTotals).where(
     and11(
       eq15(gscDailyTotals.projectId, projectId),
-      sql6`${gscDailyTotals.date} >= ${startDate}`,
-      sql6`${gscDailyTotals.date} <= ${endDate}`
+      sql7`${gscDailyTotals.date} >= ${startDate}`,
+      sql7`${gscDailyTotals.date} <= ${endDate}`
     )
   ).orderBy(asc3(gscDailyTotals.date)).all();
   return rows.map((r) => {
@@ -10712,8 +10952,8 @@ function readGscQueryDailyRows(db, projectId, startDate, endDate) {
   }).from(gscQueryDailyTotals).where(
     and11(
       eq15(gscQueryDailyTotals.projectId, projectId),
-      sql6`${gscQueryDailyTotals.date} >= ${startDate}`,
-      sql6`${gscQueryDailyTotals.date} <= ${endDate}`
+      sql7`${gscQueryDailyTotals.date} >= ${startDate}`,
+      sql7`${gscQueryDailyTotals.date} <= ${endDate}`
     )
   ).all();
   return rows.map((r) => {
@@ -13225,7 +13465,7 @@ function buildGaSection(db, projectId, windowDays) {
   const aiSessionRows = db.select({
     trafficClass: gaAiReferrals.trafficClass,
     channelGroup: gaAiReferrals.channelGroup,
-    sessions: sql7`COALESCE(SUM(${gaAiReferrals.sessions}), 0)`
+    sessions: sql8`COALESCE(SUM(${gaAiReferrals.sessions}), 0)`
   }).from(gaAiReferrals).where(and12(...aiConditions)).groupBy(gaAiReferrals.trafficClass, gaAiReferrals.channelGroup).all();
   let paidAiSessions = 0;
   let organicAiSessions = 0;
@@ -13319,8 +13559,8 @@ 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}`
+    sql8`${gaAiReferrals.date} >= ${window.start}`,
+    sql8`${gaAiReferrals.date} <= ${window.end}`
   )).all();
   if (rows.length === 0) return null;
   const dimSessionsByTuple = /* @__PURE__ */ new Map();
@@ -13396,7 +13636,7 @@ function buildAiReferrals(db, projectId, windowDays) {
   };
 }
 function nonSubresourceReferralPathCondition() {
-  return sql7`
+  return sql8`
     LOWER(${aiReferralEventsHourly.landingPathNormalized}) NOT LIKE '/_next/static/%'
     AND LOWER(${aiReferralEventsHourly.landingPathNormalized}) NOT LIKE '/assets/%'
     AND LOWER(${aiReferralEventsHourly.landingPathNormalized}) NOT LIKE '/static/%'
@@ -13435,7 +13675,7 @@ function buildServerActivity(db, projectId, windowDays) {
   const priorStart = new Date(priorStartMs).toISOString();
   const trendStart = new Date(trendStartMs).toISOString();
   const sumVerifiedCrawlers = (windowStartIso, windowEndIso, exclusiveEnd = false) => Number(
-    db.select({ total: sql7`COALESCE(SUM(${crawlerEventsHourly.hits}), 0)` }).from(crawlerEventsHourly).where(
+    db.select({ total: sql8`COALESCE(SUM(${crawlerEventsHourly.hits}), 0)` }).from(crawlerEventsHourly).where(
       and12(
         eq16(crawlerEventsHourly.projectId, projectId),
         eq16(crawlerEventsHourly.verificationStatus, VerificationStatuses.verified),
@@ -13445,7 +13685,7 @@ function buildServerActivity(db, projectId, windowDays) {
     ).get()?.total ?? 0
   );
   const sumUnverifiedCrawlers = (windowStartIso, windowEndIso, exclusiveEnd = false) => Number(
-    db.select({ total: sql7`COALESCE(SUM(${crawlerEventsHourly.hits}), 0)` }).from(crawlerEventsHourly).where(
+    db.select({ total: sql8`COALESCE(SUM(${crawlerEventsHourly.hits}), 0)` }).from(crawlerEventsHourly).where(
       and12(
         eq16(crawlerEventsHourly.projectId, projectId),
         ne2(crawlerEventsHourly.verificationStatus, VerificationStatuses.verified),
@@ -13456,9 +13696,9 @@ function buildServerActivity(db, projectId, windowDays) {
   );
   const sumReferrals = (windowStartIso, windowEndIso, exclusiveEnd = false) => {
     const row = db.select({
-      total: sql7`COALESCE(SUM(${aiReferralEventsHourly.sessionsOrHits}), 0)`,
-      paid: sql7`COALESCE(SUM(${aiReferralEventsHourly.paidSessionsOrHits}), 0)`,
-      organic: sql7`COALESCE(SUM(${aiReferralEventsHourly.organicSessionsOrHits}), 0)`
+      total: sql8`COALESCE(SUM(${aiReferralEventsHourly.sessionsOrHits}), 0)`,
+      paid: sql8`COALESCE(SUM(${aiReferralEventsHourly.paidSessionsOrHits}), 0)`,
+      organic: sql8`COALESCE(SUM(${aiReferralEventsHourly.organicSessionsOrHits}), 0)`
     }).from(aiReferralEventsHourly).where(
       and12(
         eq16(aiReferralEventsHourly.projectId, projectId),
@@ -13470,7 +13710,7 @@ function buildServerActivity(db, projectId, windowDays) {
     return aiReferralClassCounts(Number(row?.total ?? 0), Number(row?.paid ?? 0), Number(row?.organic ?? 0));
   };
   const sumUserFetches = (windowStartIso, windowEndIso, exclusiveEnd = false) => Number(
-    db.select({ total: sql7`COALESCE(SUM(${aiUserFetchEventsHourly.hits}), 0)` }).from(aiUserFetchEventsHourly).where(
+    db.select({ total: sql8`COALESCE(SUM(${aiUserFetchEventsHourly.hits}), 0)` }).from(aiUserFetchEventsHourly).where(
       and12(
         eq16(aiUserFetchEventsHourly.projectId, projectId),
         gte4(aiUserFetchEventsHourly.tsHour, windowStartIso),
@@ -13489,7 +13729,7 @@ function buildServerActivity(db, projectId, windowDays) {
   const crawlerByOperatorRows = db.select({
     operator: crawlerEventsHourly.operator,
     verificationStatus: crawlerEventsHourly.verificationStatus,
-    hits: sql7`COALESCE(SUM(${crawlerEventsHourly.hits}), 0)`
+    hits: sql8`COALESCE(SUM(${crawlerEventsHourly.hits}), 0)`
   }).from(crawlerEventsHourly).where(
     and12(
       eq16(crawlerEventsHourly.projectId, projectId),
@@ -13499,7 +13739,7 @@ function buildServerActivity(db, projectId, windowDays) {
   ).groupBy(crawlerEventsHourly.operator, crawlerEventsHourly.verificationStatus).all();
   const crawlerByOperatorPriorRows = db.select({
     operator: crawlerEventsHourly.operator,
-    hits: sql7`COALESCE(SUM(${crawlerEventsHourly.hits}), 0)`
+    hits: sql8`COALESCE(SUM(${crawlerEventsHourly.hits}), 0)`
   }).from(crawlerEventsHourly).where(
     and12(
       eq16(crawlerEventsHourly.projectId, projectId),
@@ -13510,7 +13750,7 @@ function buildServerActivity(db, projectId, windowDays) {
   ).groupBy(crawlerEventsHourly.operator).all();
   const referralByOperatorRows = db.select({
     operator: aiReferralEventsHourly.operator,
-    hits: sql7`COALESCE(SUM(${aiReferralEventsHourly.sessionsOrHits}), 0)`
+    hits: sql8`COALESCE(SUM(${aiReferralEventsHourly.sessionsOrHits}), 0)`
   }).from(aiReferralEventsHourly).where(
     and12(
       eq16(aiReferralEventsHourly.projectId, projectId),
@@ -13521,7 +13761,7 @@ function buildServerActivity(db, projectId, windowDays) {
   ).groupBy(aiReferralEventsHourly.operator).all();
   const userFetchByOperatorRows = db.select({
     operator: aiUserFetchEventsHourly.operator,
-    hits: sql7`COALESCE(SUM(${aiUserFetchEventsHourly.hits}), 0)`
+    hits: sql8`COALESCE(SUM(${aiUserFetchEventsHourly.hits}), 0)`
   }).from(aiUserFetchEventsHourly).where(
     and12(
       eq16(aiUserFetchEventsHourly.projectId, projectId),
@@ -13564,8 +13804,8 @@ function buildServerActivity(db, projectId, windowDays) {
   );
   const topPathsRows = db.select({
     path: crawlerEventsHourly.pathNormalized,
-    hits: sql7`COALESCE(SUM(${crawlerEventsHourly.hits}), 0)`,
-    operators: sql7`COUNT(DISTINCT ${crawlerEventsHourly.operator})`
+    hits: sql8`COALESCE(SUM(${crawlerEventsHourly.hits}), 0)`,
+    operators: sql8`COUNT(DISTINCT ${crawlerEventsHourly.operator})`
   }).from(crawlerEventsHourly).where(
     and12(
       eq16(crawlerEventsHourly.projectId, projectId),
@@ -13573,7 +13813,7 @@ function buildServerActivity(db, projectId, windowDays) {
       gte4(crawlerEventsHourly.tsHour, headlineStart),
       lte(crawlerEventsHourly.tsHour, headlineEnd)
     )
-  ).groupBy(crawlerEventsHourly.pathNormalized).orderBy(desc7(sql7`SUM(${crawlerEventsHourly.hits})`)).limit(SERVER_ACTIVITY_TOP_PATHS_LIMIT).all();
+  ).groupBy(crawlerEventsHourly.pathNormalized).orderBy(desc7(sql8`SUM(${crawlerEventsHourly.hits})`)).limit(SERVER_ACTIVITY_TOP_PATHS_LIMIT).all();
   const topCrawledPaths = topPathsRows.map((r) => ({
     path: r.path,
     verifiedHits: Number(r.hits),
@@ -13581,8 +13821,8 @@ function buildServerActivity(db, projectId, windowDays) {
   }));
   const referralProductsRows = db.select({
     product: aiReferralEventsHourly.product,
-    arrivals: sql7`COALESCE(SUM(${aiReferralEventsHourly.sessionsOrHits}), 0)`,
-    landingPaths: sql7`COUNT(DISTINCT ${aiReferralEventsHourly.landingPathNormalized})`
+    arrivals: sql8`COALESCE(SUM(${aiReferralEventsHourly.sessionsOrHits}), 0)`,
+    landingPaths: sql8`COUNT(DISTINCT ${aiReferralEventsHourly.landingPathNormalized})`
   }).from(aiReferralEventsHourly).where(
     and12(
       eq16(aiReferralEventsHourly.projectId, projectId),
@@ -13590,7 +13830,7 @@ function buildServerActivity(db, projectId, windowDays) {
       gte4(aiReferralEventsHourly.tsHour, headlineStart),
       lte(aiReferralEventsHourly.tsHour, headlineEnd)
     )
-  ).groupBy(aiReferralEventsHourly.product).orderBy(desc7(sql7`SUM(${aiReferralEventsHourly.sessionsOrHits})`)).all();
+  ).groupBy(aiReferralEventsHourly.product).orderBy(desc7(sql8`SUM(${aiReferralEventsHourly.sessionsOrHits})`)).all();
   const referralProducts = referralProductsRows.map((r) => ({
     product: r.product,
     arrivals: Number(r.arrivals),
@@ -13598,8 +13838,8 @@ function buildServerActivity(db, projectId, windowDays) {
   }));
   const topReferralRows = db.select({
     path: aiReferralEventsHourly.landingPathNormalized,
-    arrivals: sql7`COALESCE(SUM(${aiReferralEventsHourly.sessionsOrHits}), 0)`,
-    products: sql7`COUNT(DISTINCT ${aiReferralEventsHourly.product})`
+    arrivals: sql8`COALESCE(SUM(${aiReferralEventsHourly.sessionsOrHits}), 0)`,
+    products: sql8`COUNT(DISTINCT ${aiReferralEventsHourly.product})`
   }).from(aiReferralEventsHourly).where(
     and12(
       eq16(aiReferralEventsHourly.projectId, projectId),
@@ -13607,15 +13847,15 @@ function buildServerActivity(db, projectId, windowDays) {
       gte4(aiReferralEventsHourly.tsHour, headlineStart),
       lte(aiReferralEventsHourly.tsHour, headlineEnd)
     )
-  ).groupBy(aiReferralEventsHourly.landingPathNormalized).orderBy(desc7(sql7`SUM(${aiReferralEventsHourly.sessionsOrHits})`)).limit(SERVER_ACTIVITY_TOP_PATHS_LIMIT).all();
+  ).groupBy(aiReferralEventsHourly.landingPathNormalized).orderBy(desc7(sql8`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: sql7`SUBSTR(${crawlerEventsHourly.tsHour}, 1, 10)`,
-    hits: sql7`COALESCE(SUM(${crawlerEventsHourly.hits}), 0)`
+    date: sql8`SUBSTR(${crawlerEventsHourly.tsHour}, 1, 10)`,
+    hits: sql8`COALESCE(SUM(${crawlerEventsHourly.hits}), 0)`
   }).from(crawlerEventsHourly).where(
     and12(
       eq16(crawlerEventsHourly.projectId, projectId),
@@ -13623,10 +13863,10 @@ function buildServerActivity(db, projectId, windowDays) {
       gte4(crawlerEventsHourly.tsHour, trendStart),
       lte(crawlerEventsHourly.tsHour, headlineEnd)
     )
-  ).groupBy(sql7`SUBSTR(${crawlerEventsHourly.tsHour}, 1, 10)`).all();
+  ).groupBy(sql8`SUBSTR(${crawlerEventsHourly.tsHour}, 1, 10)`).all();
   const referralTrendRows = db.select({
-    date: sql7`SUBSTR(${aiReferralEventsHourly.tsHour}, 1, 10)`,
-    hits: sql7`COALESCE(SUM(${aiReferralEventsHourly.sessionsOrHits}), 0)`
+    date: sql8`SUBSTR(${aiReferralEventsHourly.tsHour}, 1, 10)`,
+    hits: sql8`COALESCE(SUM(${aiReferralEventsHourly.sessionsOrHits}), 0)`
   }).from(aiReferralEventsHourly).where(
     and12(
       eq16(aiReferralEventsHourly.projectId, projectId),
@@ -13634,17 +13874,17 @@ function buildServerActivity(db, projectId, windowDays) {
       gte4(aiReferralEventsHourly.tsHour, trendStart),
       lte(aiReferralEventsHourly.tsHour, headlineEnd)
     )
-  ).groupBy(sql7`SUBSTR(${aiReferralEventsHourly.tsHour}, 1, 10)`).all();
+  ).groupBy(sql8`SUBSTR(${aiReferralEventsHourly.tsHour}, 1, 10)`).all();
   const userFetchTrendRows = db.select({
-    date: sql7`SUBSTR(${aiUserFetchEventsHourly.tsHour}, 1, 10)`,
-    hits: sql7`COALESCE(SUM(${aiUserFetchEventsHourly.hits}), 0)`
+    date: sql8`SUBSTR(${aiUserFetchEventsHourly.tsHour}, 1, 10)`,
+    hits: sql8`COALESCE(SUM(${aiUserFetchEventsHourly.hits}), 0)`
   }).from(aiUserFetchEventsHourly).where(
     and12(
       eq16(aiUserFetchEventsHourly.projectId, projectId),
       gte4(aiUserFetchEventsHourly.tsHour, trendStart),
       lte(aiUserFetchEventsHourly.tsHour, headlineEnd)
     )
-  ).groupBy(sql7`SUBSTR(${aiUserFetchEventsHourly.tsHour}, 1, 10)`).all();
+  ).groupBy(sql8`SUBSTR(${aiUserFetchEventsHourly.tsHour}, 1, 10)`).all();
   const emptyTrendEntry = () => ({ verifiedCrawlerHits: 0, userFetchHits: 0, referralArrivals: 0 });
   const dailyTrendMap = /* @__PURE__ */ new Map();
   for (const r of crawlerTrendRows) {
@@ -15496,7 +15736,7 @@ async function resultsExportRoutes(app) {
 }
 
 // ../api-routes/src/composites.ts
-import { eq as eq20, and as and16, desc as desc9, sql as sql8, like as like2, or as or4, inArray as inArray10 } from "drizzle-orm";
+import { eq as eq20, and as and16, desc as desc9, sql as sql9, like as like2, or as or4, inArray as inArray10 } from "drizzle-orm";
 var TOP_INSIGHT_LIMIT = 5;
 var SEARCH_HIT_HARD_LIMIT = 50;
 var SEARCH_SNIPPET_RADIUS = 80;
@@ -15673,9 +15913,9 @@ async function compositeRoutes(app) {
       and16(
         eq20(queries.projectId, project.id),
         or4(
-          sql8`${querySnapshots.answerText} LIKE ${pattern} ESCAPE '\\'`,
-          sql8`${querySnapshots.citedDomains} LIKE ${pattern} ESCAPE '\\'`,
-          sql8`${querySnapshots.rawResponse} LIKE ${pattern} ESCAPE '\\'`,
+          sql9`${querySnapshots.answerText} LIKE ${pattern} ESCAPE '\\'`,
+          sql9`${querySnapshots.citedDomains} LIKE ${pattern} ESCAPE '\\'`,
+          sql9`${querySnapshots.rawResponse} LIKE ${pattern} ESCAPE '\\'`,
           like2(queries.query, pattern)
         )
       )
@@ -15686,8 +15926,8 @@ async function compositeRoutes(app) {
         or4(
           like2(insights.title, pattern),
           like2(insights.query, pattern),
-          sql8`${insights.recommendation} LIKE ${pattern} ESCAPE '\\'`,
-          sql8`${insights.cause} LIKE ${pattern} ESCAPE '\\'`
+          sql9`${insights.recommendation} LIKE ${pattern} ESCAPE '\\'`,
+          sql9`${insights.cause} LIKE ${pattern} ESCAPE '\\'`
         )
       )
     ).orderBy(desc9(insights.createdAt)).limit(limit + 1).all();
@@ -15893,16 +16133,16 @@ function buildSuggestedQueriesFromGsc(app, projectId, trackedQueries) {
   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)`,
+    impressions: sql9`COALESCE(SUM(${gscSearchData.impressions}), 0)`,
+    clicks: sql9`COALESCE(SUM(${gscSearchData.clicks}), 0)`,
     // Weighted average: SUM(position * impressions) / SUM(impressions).
     // NULLIF guards the degenerate impressions=0 case (SQLite returns NULL,
     // which the JS coerces to 0 — caught by the impression floor anyway).
-    avgPosition: sql8`COALESCE(SUM(${gscSearchData.position} * ${gscSearchData.impressions}) * 1.0 / NULLIF(SUM(${gscSearchData.impressions}), 0), 0)`
+    avgPosition: sql9`COALESCE(SUM(${gscSearchData.position} * ${gscSearchData.impressions}) * 1.0 / NULLIF(SUM(${gscSearchData.impressions}), 0), 0)`
   }).from(gscSearchData).where(and16(
     eq20(gscSearchData.projectId, projectId),
-    sql8`${gscSearchData.date} >= ${cutoff}`,
-    sql8`${gscSearchData.impressions} > 0`
+    sql9`${gscSearchData.date} >= ${cutoff}`,
+    sql9`${gscSearchData.impressions} > 0`
   )).groupBy(gscSearchData.date, gscSearchData.query).all();
   const todayIso = (/* @__PURE__ */ new Date()).toISOString().slice(0, 10);
   const merged = mergeGscQueryTotalsWithFallback(
@@ -16114,6 +16354,7 @@ function formatProject2(row) {
     labels: row.labels,
     providers: row.providers,
     providerModels: row.providerModels,
+    measurement: row.measurement,
     locations: row.locations,
     defaultLocation: row.defaultLocation,
     autoExtractBacklinks: row.autoExtractBacklinks,
@@ -16265,6 +16506,9 @@ var SCHEMA_TABLE = {
   DiscoveryPromoteResult: discoveryPromoteResultSchema,
   DiscoverySessionDetailDto: discoverySessionDetailDtoSchema,
   DiscoverySessionDto: discoverySessionDtoSchema,
+  ResearchRunCreate: researchRunCreateSchema,
+  ResearchRunDetailDto: researchRunDetailSchema,
+  ResearchRunListDto: researchRunListSchema,
   DoctorReportDto: doctorReportSchema,
   GA4AiReferralHistoryEntry: ga4AiReferralHistoryEntrySchema,
   GA4SessionHistoryEntry: ga4SessionHistoryEntrySchema,
@@ -16767,6 +17011,32 @@ var routeCatalog = [
       404: errorResponse("Project not found.")
     }
   },
+  {
+    method: "post",
+    path: "/api/v1/projects/{name}/research/runs",
+    summary: "Start an isolated research query batch",
+    description: "Runs one to fifty ad-hoc queries through one API provider and saves the answer evidence. Research never creates tracked queries, shared runs, snapshots, insights, or notifications.",
+    tags: ["research"],
+    parameters: [nameParameter],
+    requestBody: { required: true, content: { "application/json": { schema: { $ref: "#/components/schemas/ResearchRunCreate" } } } },
+    responses: { 200: jsonResponse("Idempotent request returned its existing research run.", "ResearchRunDetailDto"), 202: jsonResponse("Research batch queued.", "ResearchRunDetailDto"), 400: errorResponse("Invalid provider, model, location, or request."), 404: errorResponse("Project not found."), 409: errorResponse("Idempotency key was reused with a different payload."), 422: errorResponse("Research executor is unavailable on this deployment.") }
+  },
+  {
+    method: "get",
+    path: "/api/v1/projects/{name}/research/runs",
+    summary: "List saved research query batches",
+    tags: ["research"],
+    parameters: [nameParameter, { name: "limit", in: "query", description: "Max runs, default 20 and maximum 100.", schema: integerSchema }],
+    responses: { 200: jsonResponse("Research runs returned newest first.", "ResearchRunListDto"), 404: errorResponse("Project not found.") }
+  },
+  {
+    method: "get",
+    path: "/api/v1/projects/{name}/research/runs/{runId}",
+    summary: "Get a research query batch and saved answers",
+    tags: ["research"],
+    parameters: [nameParameter, { name: "runId", in: "path", required: true, description: "Research run ID.", schema: stringSchema }],
+    responses: { 200: jsonResponse("Research run detail returned.", "ResearchRunDetailDto"), 404: errorResponse("Project or research run not found.") }
+  },
   {
     method: "post",
     path: "/api/v1/projects/{name}/locations",
@@ -21723,7 +21993,7 @@ function formatNotification(row) {
 
 // ../api-routes/src/google.ts
 import crypto19 from "crypto";
-import { eq as eq24, and as and18, desc as desc11, sql as sql9, inArray as inArray11 } from "drizzle-orm";
+import { eq as eq24, and as and18, desc as desc11, sql as sql10, inArray as inArray11 } from "drizzle-orm";
 
 // ../api-routes/src/gbp-summary.ts
 function computeMetricTotals(rows) {
@@ -22281,11 +22551,14 @@ var GA4_DIMENSIONS = {
   firstUserSource: "firstUserSource",
   firstUserMedium: "firstUserMedium",
   sessionDefaultChannelGrouping: "sessionDefaultChannelGrouping",
-  sessionDefaultChannelGroup: "sessionDefaultChannelGroup"
+  sessionDefaultChannelGroup: "sessionDefaultChannelGroup",
+  hostName: "hostName",
+  eventName: "eventName"
 };
 var GA4_METRICS = {
   sessions: "sessions",
-  totalUsers: "totalUsers"
+  totalUsers: "totalUsers",
+  eventCount: "eventCount"
 };
 
 // ../integration-google-analytics/src/types.ts
@@ -22554,6 +22827,100 @@ async function batchRunReports(accessToken, propertyId, requests) {
 function formatDate2(d) {
   return d.toISOString().slice(0, 10);
 }
+function measurementDateRange(days) {
+  const syncDays = Math.min(Math.max(1, days ?? GA4_DEFAULT_SYNC_DAYS), GA4_MAX_SYNC_DAYS);
+  const endDate = /* @__PURE__ */ new Date();
+  const startDate = /* @__PURE__ */ new Date();
+  startDate.setUTCDate(startDate.getUTCDate() - syncDays);
+  return { syncDays, dateRange: { startDate: formatDate2(startDate), endDate: formatDate2(endDate) } };
+}
+async function fetchPagedReport(accessToken, propertyId, baseRequest, pageSize = 1e4) {
+  const rows = [];
+  let offset = 0;
+  for (let page = 0; page < GA4_MAX_PAGES; page++) {
+    const response = await runReport(accessToken, propertyId, { ...baseRequest, limit: pageSize, offset });
+    const pageRows = response.rows ?? [];
+    rows.push(...pageRows);
+    offset += pageRows.length;
+    if (pageRows.length < pageSize || response.rowCount !== void 0 && offset >= response.rowCount) break;
+    if (page === GA4_MAX_PAGES - 1) {
+      throw new Error(`GA4 report truncated: page limit (${GA4_MAX_PAGES}) reached before all rows were fetched`);
+    }
+  }
+  return rows;
+}
+async function fetchAcquisitionByChannel(accessToken, propertyId, days, options) {
+  validateAccessToken2(accessToken);
+  validatePropertyId(propertyId);
+  const { syncDays, dateRange } = measurementDateRange(days);
+  const rows = await fetchPagedReport(accessToken, propertyId, {
+    dateRanges: [dateRange],
+    dimensions: [
+      { name: GA4_DIMENSIONS.date },
+      { name: GA4_DIMENSIONS.sessionDefaultChannelGroup },
+      { name: GA4_DIMENSIONS.sessionSource },
+      { name: GA4_DIMENSIONS.sessionMedium },
+      { name: GA4_DIMENSIONS.hostName },
+      { name: GA4_DIMENSIONS.landingPagePlusQueryString }
+    ],
+    metrics: [{ name: GA4_METRICS.sessions }]
+  }, options?.pageSize);
+  ga4Log("info", "fetch-acquisition.done", { propertyId, days: syncDays, rowCount: rows.length });
+  return { ...dateRange, rows: rows.map((row) => ({
+    date: compactDateToIso(row.dimensionValues[0]?.value ?? ""),
+    channelGroup: row.dimensionValues[1]?.value ?? "(not set)",
+    source: row.dimensionValues[2]?.value ?? "(not set)",
+    medium: row.dimensionValues[3]?.value ?? "(not set)",
+    hostName: row.dimensionValues[4]?.value ?? "(not set)",
+    landingPage: row.dimensionValues[5]?.value ?? "(not set)",
+    sessions: parseInt(row.metricValues[0]?.value ?? "0", 10) || 0
+  })) };
+}
+function isLandingPageDimensionIncompatibility(error) {
+  return error instanceof GA4ApiError && error.status === 400 && /landingPagePlusQueryString/i.test(error.message) && /incompatib/i.test(error.message);
+}
+async function fetchLeadEvents(accessToken, propertyId, eventNames, days) {
+  validateAccessToken2(accessToken);
+  validatePropertyId(propertyId);
+  const { dateRange } = measurementDateRange(days);
+  const filter = { orGroup: { expressions: eventNames.map((value) => ({ filter: {
+    fieldName: GA4_DIMENSIONS.eventName,
+    stringFilter: { matchType: "EXACT", value }
+  } })) } };
+  const dimensions = [
+    { name: GA4_DIMENSIONS.date },
+    { name: GA4_DIMENSIONS.eventName },
+    { name: GA4_DIMENSIONS.sessionDefaultChannelGroup },
+    { name: GA4_DIMENSIONS.sessionSource },
+    { name: GA4_DIMENSIONS.sessionMedium }
+  ];
+  const request = (landingPage) => ({
+    dateRanges: [dateRange],
+    dimensions: landingPage ? [...dimensions, { name: GA4_DIMENSIONS.hostName }, { name: GA4_DIMENSIONS.landingPagePlusQueryString }] : dimensions,
+    metrics: [{ name: GA4_METRICS.eventCount }],
+    dimensionFilter: filter
+  });
+  let attributionScope = "landing-page";
+  let rawRows;
+  try {
+    rawRows = await fetchPagedReport(accessToken, propertyId, request(true));
+  } catch (error) {
+    if (!isLandingPageDimensionIncompatibility(error)) throw error;
+    attributionScope = "channel";
+    rawRows = await fetchPagedReport(accessToken, propertyId, request(false));
+  }
+  const rows = rawRows.map((row) => ({
+    date: compactDateToIso(row.dimensionValues[0]?.value ?? ""),
+    eventName: row.dimensionValues[1]?.value ?? "(not set)",
+    channelGroup: row.dimensionValues[2]?.value ?? "(not set)",
+    source: row.dimensionValues[3]?.value ?? "(not set)",
+    medium: row.dimensionValues[4]?.value ?? "(not set)",
+    hostName: attributionScope === "landing-page" ? row.dimensionValues[5]?.value ?? "(not available)" : "(not available)",
+    landingPage: attributionScope === "landing-page" ? row.dimensionValues[6]?.value ?? "(not available)" : "(not available)",
+    eventCount: parseInt(row.metricValues[0]?.value ?? "0", 10) || 0
+  }));
+  return { ...dateRange, attributionScope, rows };
+}
 var AI_REFERRAL_SOURCE_FILTERS = [
   { matchType: "CONTAINS", value: "perplexity" },
   { matchType: "CONTAINS", value: "gemini" },
@@ -23726,11 +24093,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 = [eq24(gscSearchData.projectId, project.id)];
-    if (startDate) conditions.push(sql9`${gscSearchData.date} >= ${startDate}`);
-    else if (cutoffDate) conditions.push(sql9`${gscSearchData.date} >= ${cutoffDate}`);
-    if (endDate) conditions.push(sql9`${gscSearchData.date} <= ${endDate}`);
-    if (query) conditions.push(sql9`${gscSearchData.query} LIKE ${"%" + escapeLikePattern(query) + "%"} ESCAPE '\\'`);
-    if (page) conditions.push(sql9`${gscSearchData.page} LIKE ${"%" + escapeLikePattern(page) + "%"} ESCAPE '\\'`);
+    if (startDate) conditions.push(sql10`${gscSearchData.date} >= ${startDate}`);
+    else if (cutoffDate) conditions.push(sql10`${gscSearchData.date} >= ${cutoffDate}`);
+    if (endDate) conditions.push(sql10`${gscSearchData.date} <= ${endDate}`);
+    if (query) conditions.push(sql10`${gscSearchData.query} LIKE ${"%" + escapeLikePattern(query) + "%"} ESCAPE '\\'`);
+    if (page) conditions.push(sql10`${gscSearchData.page} LIKE ${"%" + escapeLikePattern(page) + "%"} ESCAPE '\\'`);
     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(and18(...conditions)).orderBy(desc11(gscSearchData.date)).limit(limitVal).offset(offsetVal).all();
@@ -23754,13 +24121,13 @@ async function googleRoutes(app, opts) {
     const windowEnd = endDate ?? "9999-12-31";
     const dailyTotals = readGscDailyTotals(app.db, project.id, windowStart, windowEnd);
     const conditions = [eq24(gscSearchData.projectId, project.id)];
-    if (startDate) conditions.push(sql9`${gscSearchData.date} >= ${startDate}`);
-    else if (cutoffDate) conditions.push(sql9`${gscSearchData.date} >= ${cutoffDate}`);
-    if (endDate) conditions.push(sql9`${gscSearchData.date} <= ${endDate}`);
+    if (startDate) conditions.push(sql10`${gscSearchData.date} >= ${startDate}`);
+    else if (cutoffDate) conditions.push(sql10`${gscSearchData.date} >= ${cutoffDate}`);
+    if (endDate) conditions.push(sql10`${gscSearchData.date} <= ${endDate}`);
     const dimensionedRows = app.db.select({
       date: gscSearchData.date,
-      clicks: sql9`COALESCE(SUM(${gscSearchData.clicks}), 0)`,
-      impressions: sql9`COALESCE(SUM(${gscSearchData.impressions}), 0)`
+      clicks: sql10`COALESCE(SUM(${gscSearchData.clicks}), 0)`,
+      impressions: sql10`COALESCE(SUM(${gscSearchData.impressions}), 0)`
     }).from(gscSearchData).where(and18(...conditions)).groupBy(gscSearchData.date).orderBy(gscSearchData.date).all();
     const daily = mergeGscDailyTotalsWithFallback(
       dailyTotals,
@@ -24656,11 +25023,11 @@ async function googleRoutes(app, opts) {
 
 // ../api-routes/src/ads.ts
 import crypto22 from "crypto";
-import { eq as eq26, and as and20, asc as asc6, gt as gt2, gte as gte6, lt as lt3, lte as lte4, ne as ne3, inArray as inArray12, or as or6, isNull as isNull2, isNotNull as isNotNull2, sql as sql11 } from "drizzle-orm";
+import { eq as eq26, and as and20, asc as asc6, gt as gt2, gte as gte6, lt as lt3, lte as lte4, ne as ne3, inArray as inArray12, or as or6, isNull as isNull2, isNotNull as isNotNull2, sql as sql12 } from "drizzle-orm";
 
 // ../api-routes/src/ads-activation-routes.ts
 import crypto21 from "crypto";
-import { and as and19, asc as asc5, eq as eq25, gt, isNotNull, isNull, lte as lte3, or as or5, sql as sql10 } from "drizzle-orm";
+import { and as and19, asc as asc5, eq as eq25, gt, isNotNull, isNull, lte as lte3, or as or5, sql as sql11 } from "drizzle-orm";
 
 // ../api-routes/src/ads-activation.ts
 import crypto20 from "crypto";
@@ -26533,7 +26900,7 @@ function selectWatchdogOperations(app, nowIso, batchSize, allowLiveRevocationLea
     ),
     leaseAvailable
   );
-  const freshRevocationPriority = sql10`CASE
+  const freshRevocationPriority = sql11`CASE
     WHEN ${adsActivationGrants.revocationRequestedAt} IS NOT NULL
       AND (
         ${adsOperations.lastReconciledAt} IS NULL
@@ -27629,7 +27996,7 @@ function claimOperationForReconciliation(app, row, leaseOwner, now, leaseMs, pol
     state: AdsOperationStates.reconciling,
     leaseOwner,
     leaseExpiresAt,
-    reconcileAttempts: sql11`${adsOperations.reconcileAttempts} + 1`,
+    reconcileAttempts: sql12`${adsOperations.reconcileAttempts} + 1`,
     updatedAt: nowIso
   }).where(and20(
     eq26(adsOperations.id, row.id),
@@ -29701,7 +30068,7 @@ async function cdpRoutes(app, opts) {
 
 // ../api-routes/src/ga.ts
 import crypto24 from "crypto";
-import { eq as eq29, desc as desc13, and as and23, sql as sql12 } from "drizzle-orm";
+import { eq as eq29, desc as desc13, and as and23, sql as sql13 } from "drizzle-orm";
 
 // ../api-routes/src/ga-session-history.ts
 function buildSessionHistory(landingPageDays, dailyTotals) {
@@ -29780,6 +30147,134 @@ function normalizeAiTrafficClass(value) {
 function emptyAiCounts() {
   return { sessions: 0, users: 0 };
 }
+function persistAcquisitionMeasurement(db, input) {
+  const { startDate, endDate } = input.report;
+  db.transaction((tx) => {
+    tx.delete(gaAcquisitionDaily).where(and23(
+      eq29(gaAcquisitionDaily.projectId, input.projectId),
+      sql13`${gaAcquisitionDaily.date} >= ${startDate}`,
+      sql13`${gaAcquisitionDaily.date} <= ${endDate}`
+    )).run();
+    for (const row of input.report.rows) {
+      tx.insert(gaAcquisitionDaily).values({
+        id: crypto24.randomUUID(),
+        projectId: input.projectId,
+        date: row.date,
+        channelGroup: row.channelGroup,
+        source: row.source,
+        medium: row.medium,
+        hostName: row.hostName,
+        landingPage: row.landingPage,
+        landingPageNormalized: normalizeUrlPath(row.landingPage),
+        sessions: row.sessions,
+        syncedAt: input.syncedAt,
+        syncRunId: input.runId,
+        createdAt: input.syncedAt
+      }).run();
+    }
+    tx.insert(gaMeasurementSyncStates).values({
+      projectId: input.projectId,
+      acquisitionStatus: "ready",
+      acquisitionError: null,
+      acquisitionSyncedAt: input.syncedAt,
+      updatedAt: input.syncedAt
+    }).onConflictDoUpdate({
+      target: gaMeasurementSyncStates.projectId,
+      set: {
+        acquisitionStatus: "ready",
+        acquisitionError: null,
+        acquisitionSyncedAt: input.syncedAt,
+        updatedAt: input.syncedAt
+      }
+    }).run();
+  });
+}
+function persistLeadMeasurement(db, input) {
+  const { startDate, endDate } = input.report;
+  db.transaction((tx) => {
+    tx.delete(gaLeadEventsDaily).where(and23(
+      eq29(gaLeadEventsDaily.projectId, input.projectId),
+      sql13`${gaLeadEventsDaily.date} >= ${startDate}`,
+      sql13`${gaLeadEventsDaily.date} <= ${endDate}`
+    )).run();
+    for (const row of input.report.rows) {
+      tx.insert(gaLeadEventsDaily).values({
+        id: crypto24.randomUUID(),
+        projectId: input.projectId,
+        date: row.date,
+        eventName: row.eventName,
+        channelGroup: row.channelGroup,
+        source: row.source,
+        medium: row.medium,
+        hostName: row.hostName,
+        landingPage: row.landingPage,
+        landingPageNormalized: input.report.attributionScope === "landing-page" ? normalizeUrlPath(row.landingPage) : null,
+        attributionScope: input.report.attributionScope,
+        eventCount: row.eventCount,
+        syncedAt: input.syncedAt,
+        syncRunId: input.runId,
+        createdAt: input.syncedAt
+      }).run();
+    }
+    tx.insert(gaMeasurementSyncStates).values({
+      projectId: input.projectId,
+      leadStatus: "ready",
+      leadError: null,
+      leadSyncedAt: input.syncedAt,
+      leadAttributionScope: input.report.attributionScope,
+      updatedAt: input.syncedAt
+    }).onConflictDoUpdate({
+      target: gaMeasurementSyncStates.projectId,
+      set: {
+        leadStatus: "ready",
+        leadError: null,
+        leadSyncedAt: input.syncedAt,
+        leadAttributionScope: input.report.attributionScope,
+        updatedAt: input.syncedAt
+      }
+    }).run();
+  });
+}
+function resetLeadMeasurement(db, projectId, updatedAt) {
+  db.transaction((tx) => {
+    tx.delete(gaLeadEventsDaily).where(eq29(gaLeadEventsDaily.projectId, projectId)).run();
+    tx.insert(gaMeasurementSyncStates).values({ projectId, leadStatus: "never-synced", leadError: null, leadSyncedAt: null, leadAttributionScope: null, updatedAt }).onConflictDoUpdate({
+      target: gaMeasurementSyncStates.projectId,
+      set: { leadStatus: "never-synced", leadError: null, leadSyncedAt: null, leadAttributionScope: null, updatedAt }
+    }).run();
+  });
+}
+function persistMeasurementError(db, projectId, component, message, updatedAt) {
+  if (component === "acquisition") {
+    db.insert(gaMeasurementSyncStates).values({
+      projectId,
+      acquisitionStatus: "error",
+      acquisitionError: message,
+      updatedAt
+    }).onConflictDoUpdate({
+      target: gaMeasurementSyncStates.projectId,
+      set: {
+        acquisitionStatus: "error",
+        acquisitionError: message,
+        updatedAt
+      }
+    }).run();
+    return;
+  }
+  db.insert(gaMeasurementSyncStates).values({
+    projectId,
+    leadStatus: "error",
+    leadError: message,
+    updatedAt
+  }).onConflictDoUpdate({
+    target: gaMeasurementSyncStates.projectId,
+    set: {
+      leadStatus: "error",
+      leadError: message,
+      updatedAt
+    }
+  }).run();
+}
 function summarizeAiReferralCounts(rows) {
   const dedupeGroups = /* @__PURE__ */ new Map();
   const bySessionChannelGroup = /* @__PURE__ */ new Map();
@@ -30043,6 +30538,10 @@ async function ga4Routes(app, opts) {
     const syncSummary = true;
     const syncAi = !only || only === "ai";
     const syncSocial = !only || only === "social";
+    const measurementState = app.db.select().from(gaMeasurementSyncStates).where(eq29(gaMeasurementSyncStates.projectId, project.id)).get();
+    const acquisitionDays = measurementState?.acquisitionSyncedAt != null ? Math.min(Math.max(1, days), 90) : 90;
+    const leadDays = measurementState?.leadSyncedAt != null ? Math.min(Math.max(1, days), 90) : 90;
+    const leadEventNames = project.measurement.leadEventNames;
     const startedAt = (/* @__PURE__ */ new Date()).toISOString();
     const runId = crypto24.randomUUID();
     app.db.insert(runs).values({
@@ -30068,6 +30567,10 @@ async function ga4Routes(app, opts) {
       if (syncTraffic) fetches.push(fetchTrafficByLandingPage(accessToken, propertyId, days));
       if (syncAi) fetches.push(fetchAiReferrals(accessToken, propertyId, days));
       if (syncSocial) fetches.push(fetchSocialReferrals(accessToken, propertyId, days));
+      const measurementFetch = Promise.allSettled([
+        fetchAcquisitionByChannel(accessToken, propertyId, acquisitionDays),
+        leadEventNames.length > 0 ? fetchLeadEvents(accessToken, propertyId, leadEventNames, leadDays) : Promise.resolve(null)
+      ]);
       const results = await Promise.all(fetches);
       const summary = results[0];
       const windowSummaries = results.slice(1, 1 + WINDOW_KEYS.length);
@@ -30088,8 +30591,8 @@ async function ga4Routes(app, opts) {
           tx.delete(gaTrafficSnapshots).where(
             and23(
               eq29(gaTrafficSnapshots.projectId, project.id),
-              sql12`${gaTrafficSnapshots.date} >= ${summary.periodStart}`,
-              sql12`${gaTrafficSnapshots.date} <= ${summary.periodEnd}`
+              sql13`${gaTrafficSnapshots.date} >= ${summary.periodStart}`,
+              sql13`${gaTrafficSnapshots.date} <= ${summary.periodEnd}`
             )
           ).run();
           for (const row of rows) {
@@ -30111,8 +30614,8 @@ async function ga4Routes(app, opts) {
         tx.delete(gaDailyTotals).where(
           and23(
             eq29(gaDailyTotals.projectId, project.id),
-            sql12`${gaDailyTotals.date} >= ${summary.periodStart}`,
-            sql12`${gaDailyTotals.date} <= ${summary.periodEnd}`
+            sql13`${gaDailyTotals.date} >= ${summary.periodStart}`,
+            sql13`${gaDailyTotals.date} <= ${summary.periodEnd}`
           )
         ).run();
         for (const row of dailyTotals) {
@@ -30131,8 +30634,8 @@ async function ga4Routes(app, opts) {
           tx.delete(gaAiReferrals).where(
             and23(
               eq29(gaAiReferrals.projectId, project.id),
-              sql12`${gaAiReferrals.date} >= ${summary.periodStart}`,
-              sql12`${gaAiReferrals.date} <= ${summary.periodEnd}`
+              sql13`${gaAiReferrals.date} >= ${summary.periodStart}`,
+              sql13`${gaAiReferrals.date} <= ${summary.periodEnd}`
             )
           ).run();
           for (const row of aiReferrals) {
@@ -30163,8 +30666,8 @@ async function ga4Routes(app, opts) {
           tx.delete(gaSocialReferrals).where(
             and23(
               eq29(gaSocialReferrals.projectId, project.id),
-              sql12`${gaSocialReferrals.date} >= ${summary.periodStart}`,
-              sql12`${gaSocialReferrals.date} <= ${summary.periodEnd}`
+              sql13`${gaSocialReferrals.date} >= ${summary.periodStart}`,
+              sql13`${gaSocialReferrals.date} <= ${summary.periodEnd}`
             )
           ).run();
           for (const row of socialReferrals) {
@@ -30213,7 +30716,74 @@ async function ga4Routes(app, opts) {
           }
         }
       });
-      app.db.update(runs).set({ status: RunStatuses.completed, finishedAt: now }).where(eq29(runs.id, runId)).run();
+      const [acquisitionSettled, leadsSettled] = await measurementFetch;
+      const measurementNow = (/* @__PURE__ */ new Date()).toISOString();
+      const recordMeasurementFailure = (component, reason) => {
+        const message = reason instanceof Error ? reason.message : String(reason);
+        gaLog("warn", "measurement.component-failed", {
+          projectId: project.id,
+          runId,
+          component,
+          error: message
+        });
+        try {
+          persistMeasurementError(app.db, project.id, component, message, measurementNow);
+        } catch (stateError) {
+          gaLog("error", "measurement.state-write-failed", {
+            projectId: project.id,
+            runId,
+            component,
+            error: stateError instanceof Error ? stateError.message : String(stateError)
+          });
+        }
+        return { status: "error", days: component === "acquisition" ? acquisitionDays : leadDays, rowCount: 0, error: message };
+      };
+      const acquisitionResult = (() => {
+        if (acquisitionSettled.status === "rejected") {
+          return recordMeasurementFailure("acquisition", acquisitionSettled.reason);
+        }
+        try {
+          persistAcquisitionMeasurement(app.db, {
+            projectId: project.id,
+            runId,
+            syncedAt: measurementNow,
+            report: acquisitionSettled.value
+          });
+          return {
+            status: "ready",
+            days: acquisitionDays,
+            rowCount: acquisitionSettled.value.rows.length
+          };
+        } catch (error) {
+          return recordMeasurementFailure("acquisition", error);
+        }
+      })();
+      const leadResult = (() => {
+        if (leadsSettled.status === "rejected") {
+          return recordMeasurementFailure("leads", leadsSettled.reason);
+        }
+        if (leadsSettled.value === null) {
+          resetLeadMeasurement(app.db, project.id, measurementNow);
+          return { status: "not-configured", days: 0, rowCount: 0 };
+        }
+        try {
+          persistLeadMeasurement(app.db, {
+            projectId: project.id,
+            runId,
+            syncedAt: measurementNow,
+            report: leadsSettled.value
+          });
+          return {
+            status: "ready",
+            days: leadDays,
+            rowCount: leadsSettled.value.rows.length,
+            attributionScope: leadsSettled.value.attributionScope
+          };
+        } catch (error) {
+          return recordMeasurementFailure("leads", error);
+        }
+      })();
+      app.db.update(runs).set({ status: RunStatuses.completed, finishedAt: measurementNow }).where(eq29(runs.id, runId)).run();
       const syncedComponents = only ? [
         ...syncTraffic ? ["traffic"] : [],
         ...syncSummary ? ["summary"] : [],
@@ -30237,6 +30807,10 @@ async function ga4Routes(app, opts) {
         socialReferralCount: socialReferrals.length,
         days,
         syncedAt: now,
+        measurement: {
+          acquisition: acquisitionResult,
+          leads: leadResult
+        },
         ...syncedComponents ? { syncedComponents } : {}
       };
     } catch (e) {
@@ -30254,11 +30828,11 @@ async function ga4Routes(app, opts) {
     const cutoff = windowCutoff(window);
     const cutoffDate = cutoff?.slice(0, 10) ?? null;
     const snapshotConditions = [eq29(gaTrafficSnapshots.projectId, project.id)];
-    if (cutoffDate) snapshotConditions.push(sql12`${gaTrafficSnapshots.date} >= ${cutoffDate}`);
+    if (cutoffDate) snapshotConditions.push(sql13`${gaTrafficSnapshots.date} >= ${cutoffDate}`);
     const aiConditions = [eq29(gaAiReferrals.projectId, project.id)];
-    if (cutoffDate) aiConditions.push(sql12`${gaAiReferrals.date} >= ${cutoffDate}`);
+    if (cutoffDate) aiConditions.push(sql13`${gaAiReferrals.date} >= ${cutoffDate}`);
     const socialConditions = [eq29(gaSocialReferrals.projectId, project.id)];
-    if (cutoffDate) socialConditions.push(sql12`${gaSocialReferrals.date} >= ${cutoffDate}`);
+    if (cutoffDate) socialConditions.push(sql13`${gaSocialReferrals.date} >= ${cutoffDate}`);
     const windowSummaryRow = cutoffDate ? app.db.select({
       totalSessions: gaTrafficWindowSummaries.totalSessions,
       totalOrganicSessions: gaTrafficWindowSummaries.totalOrganicSessions,
@@ -30271,9 +30845,9 @@ async function ga4Routes(app, opts) {
       )
     ).get() : null;
     const snapshotTotalsRow = cutoffDate && !windowSummaryRow ? app.db.select({
-      totalSessions: sql12`COALESCE(SUM(${gaTrafficSnapshots.sessions}), 0)`,
-      totalOrganicSessions: sql12`COALESCE(SUM(${gaTrafficSnapshots.organicSessions}), 0)`,
-      totalUsers: sql12`COALESCE(SUM(${gaTrafficSnapshots.users}), 0)`
+      totalSessions: sql13`COALESCE(SUM(${gaTrafficSnapshots.sessions}), 0)`,
+      totalOrganicSessions: sql13`COALESCE(SUM(${gaTrafficSnapshots.organicSessions}), 0)`,
+      totalUsers: sql13`COALESCE(SUM(${gaTrafficSnapshots.users}), 0)`
     }).from(gaTrafficSnapshots).where(and23(...snapshotConditions)).get() : null;
     const summaryRow = cutoffDate ? windowSummaryRow ?? snapshotTotalsRow : app.db.select({
       totalSessions: gaTrafficSummaries.totalSessions,
@@ -30281,41 +30855,41 @@ async function ga4Routes(app, opts) {
       totalUsers: gaTrafficSummaries.totalUsers
     }).from(gaTrafficSummaries).where(eq29(gaTrafficSummaries.projectId, project.id)).get();
     const directTotalRow = windowSummaryRow ? { totalDirectSessions: windowSummaryRow.totalDirectSessions } : app.db.select({
-      totalDirectSessions: sql12`COALESCE(SUM(${gaTrafficSnapshots.directSessions}), 0)`
+      totalDirectSessions: sql13`COALESCE(SUM(${gaTrafficSnapshots.directSessions}), 0)`
     }).from(gaTrafficSnapshots).where(and23(...snapshotConditions)).get();
     const summaryMeta = app.db.select({
       periodStart: gaTrafficSummaries.periodStart,
       periodEnd: gaTrafficSummaries.periodEnd
     }).from(gaTrafficSummaries).where(eq29(gaTrafficSummaries.projectId, project.id)).get();
     const rows = app.db.select({
-      landingPage: sql12`COALESCE(${gaTrafficSnapshots.landingPageNormalized}, ${gaTrafficSnapshots.landingPage})`,
-      sessions: sql12`SUM(${gaTrafficSnapshots.sessions})`,
-      organicSessions: sql12`SUM(${gaTrafficSnapshots.organicSessions})`,
-      directSessions: sql12`COALESCE(SUM(${gaTrafficSnapshots.directSessions}), 0)`,
-      users: sql12`SUM(${gaTrafficSnapshots.users})`
-    }).from(gaTrafficSnapshots).where(and23(...snapshotConditions)).groupBy(sql12`COALESCE(${gaTrafficSnapshots.landingPageNormalized}, ${gaTrafficSnapshots.landingPage})`).orderBy(sql12`SUM(${gaTrafficSnapshots.sessions}) DESC`).limit(limit).all();
+      landingPage: sql13`COALESCE(${gaTrafficSnapshots.landingPageNormalized}, ${gaTrafficSnapshots.landingPage})`,
+      sessions: sql13`SUM(${gaTrafficSnapshots.sessions})`,
+      organicSessions: sql13`SUM(${gaTrafficSnapshots.organicSessions})`,
+      directSessions: sql13`COALESCE(SUM(${gaTrafficSnapshots.directSessions}), 0)`,
+      users: sql13`SUM(${gaTrafficSnapshots.users})`
+    }).from(gaTrafficSnapshots).where(and23(...snapshotConditions)).groupBy(sql13`COALESCE(${gaTrafficSnapshots.landingPageNormalized}, ${gaTrafficSnapshots.landingPage})`).orderBy(sql13`SUM(${gaTrafficSnapshots.sessions}) DESC`).limit(limit).all();
     const aiReferralRows = app.db.select({
       source: gaAiReferrals.source,
       medium: gaAiReferrals.medium,
       trafficClass: gaAiReferrals.trafficClass,
       sourceDimension: gaAiReferrals.sourceDimension,
-      sessions: sql12`SUM(${gaAiReferrals.sessions})`,
-      users: sql12`SUM(${gaAiReferrals.users})`
+      sessions: sql13`SUM(${gaAiReferrals.sessions})`,
+      users: sql13`SUM(${gaAiReferrals.users})`
     }).from(gaAiReferrals).where(and23(...aiConditions)).groupBy(gaAiReferrals.source, gaAiReferrals.medium, gaAiReferrals.trafficClass, gaAiReferrals.sourceDimension).all();
     const aiReferralLandingPageRows = app.db.select({
       source: gaAiReferrals.source,
       medium: gaAiReferrals.medium,
       trafficClass: gaAiReferrals.trafficClass,
       sourceDimension: gaAiReferrals.sourceDimension,
-      landingPage: sql12`COALESCE(${gaAiReferrals.landingPageNormalized}, ${gaAiReferrals.landingPage})`,
-      sessions: sql12`SUM(${gaAiReferrals.sessions})`,
-      users: sql12`SUM(${gaAiReferrals.users})`
+      landingPage: sql13`COALESCE(${gaAiReferrals.landingPageNormalized}, ${gaAiReferrals.landingPage})`,
+      sessions: sql13`SUM(${gaAiReferrals.sessions})`,
+      users: sql13`SUM(${gaAiReferrals.users})`
     }).from(gaAiReferrals).where(and23(...aiConditions)).groupBy(
       gaAiReferrals.source,
       gaAiReferrals.medium,
       gaAiReferrals.trafficClass,
       gaAiReferrals.sourceDimension,
-      sql12`COALESCE(${gaAiReferrals.landingPageNormalized}, ${gaAiReferrals.landingPage})`
+      sql13`COALESCE(${gaAiReferrals.landingPageNormalized}, ${gaAiReferrals.landingPage})`
     ).all();
     const aiRowsForTotals = app.db.select({
       date: gaAiReferrals.date,
@@ -30340,12 +30914,12 @@ async function ga4Routes(app, opts) {
       source: gaSocialReferrals.source,
       medium: gaSocialReferrals.medium,
       channelGroup: gaSocialReferrals.channelGroup,
-      sessions: sql12`SUM(${gaSocialReferrals.sessions})`,
-      users: sql12`SUM(${gaSocialReferrals.users})`
-    }).from(gaSocialReferrals).where(and23(...socialConditions)).groupBy(gaSocialReferrals.source, gaSocialReferrals.medium, gaSocialReferrals.channelGroup).orderBy(sql12`SUM(${gaSocialReferrals.sessions}) DESC`).all();
+      sessions: sql13`SUM(${gaSocialReferrals.sessions})`,
+      users: sql13`SUM(${gaSocialReferrals.users})`
+    }).from(gaSocialReferrals).where(and23(...socialConditions)).groupBy(gaSocialReferrals.source, gaSocialReferrals.medium, gaSocialReferrals.channelGroup).orderBy(sql13`SUM(${gaSocialReferrals.sessions}) DESC`).all();
     const socialTotals = app.db.select({
-      sessions: sql12`SUM(${gaSocialReferrals.sessions})`,
-      users: sql12`SUM(${gaSocialReferrals.users})`
+      sessions: sql13`SUM(${gaSocialReferrals.sessions})`,
+      users: sql13`SUM(${gaSocialReferrals.users})`
     }).from(gaSocialReferrals).where(and23(...socialConditions)).get();
     const latestSync = app.db.select({ syncedAt: gaTrafficSummaries.syncedAt }).from(gaTrafficSummaries).where(eq29(gaTrafficSummaries.projectId, project.id)).orderBy(desc13(gaTrafficSummaries.syncedAt)).limit(1).get();
     const total = summaryRow?.totalSessions ?? 0;
@@ -30446,23 +31020,23 @@ async function ga4Routes(app, opts) {
     requireGa4Connection(opts, project.name, project.canonicalDomain);
     const cutoffDate = windowCutoff(parseWindow(request.query.window))?.slice(0, 10) ?? null;
     const conditions = [eq29(gaAiReferrals.projectId, project.id)];
-    if (cutoffDate) conditions.push(sql12`${gaAiReferrals.date} >= ${cutoffDate}`);
+    if (cutoffDate) conditions.push(sql13`${gaAiReferrals.date} >= ${cutoffDate}`);
     const rows = app.db.select({
       date: gaAiReferrals.date,
       source: gaAiReferrals.source,
       medium: gaAiReferrals.medium,
       trafficClass: gaAiReferrals.trafficClass,
-      landingPage: sql12`COALESCE(${gaAiReferrals.landingPageNormalized}, ${gaAiReferrals.landingPage})`,
+      landingPage: sql13`COALESCE(${gaAiReferrals.landingPageNormalized}, ${gaAiReferrals.landingPage})`,
       sourceDimension: gaAiReferrals.sourceDimension,
-      sessions: sql12`SUM(${gaAiReferrals.sessions})`,
-      users: sql12`SUM(${gaAiReferrals.users})`
+      sessions: sql13`SUM(${gaAiReferrals.sessions})`,
+      users: sql13`SUM(${gaAiReferrals.users})`
     }).from(gaAiReferrals).where(and23(...conditions)).groupBy(
       gaAiReferrals.date,
       gaAiReferrals.source,
       gaAiReferrals.medium,
       gaAiReferrals.trafficClass,
       gaAiReferrals.sourceDimension,
-      sql12`COALESCE(${gaAiReferrals.landingPageNormalized}, ${gaAiReferrals.landingPage})`
+      sql13`COALESCE(${gaAiReferrals.landingPageNormalized}, ${gaAiReferrals.landingPage})`
     ).orderBy(gaAiReferrals.date).all();
     return rows;
   });
@@ -30471,7 +31045,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 = [eq29(gaSocialReferrals.projectId, project.id)];
-    if (cutoffDate) conditions.push(sql12`${gaSocialReferrals.date} >= ${cutoffDate}`);
+    if (cutoffDate) conditions.push(sql13`${gaSocialReferrals.date} >= ${cutoffDate}`);
     const rows = app.db.select({
       date: gaSocialReferrals.date,
       source: gaSocialReferrals.source,
@@ -30492,10 +31066,10 @@ async function ga4Routes(app, opts) {
       d.setDate(d.getDate() - n);
       return fmt(d);
     };
-    const sumSocial = (from, to) => app.db.select({ sessions: sql12`COALESCE(SUM(${gaSocialReferrals.sessions}), 0)` }).from(gaSocialReferrals).where(and23(
+    const sumSocial = (from, to) => app.db.select({ sessions: sql13`COALESCE(SUM(${gaSocialReferrals.sessions}), 0)` }).from(gaSocialReferrals).where(and23(
       eq29(gaSocialReferrals.projectId, project.id),
-      sql12`${gaSocialReferrals.date} >= ${from}`,
-      sql12`${gaSocialReferrals.date} < ${to}`
+      sql13`${gaSocialReferrals.date} >= ${from}`,
+      sql13`${gaSocialReferrals.date} < ${to}`
     )).get();
     const current7d = sumSocial(daysAgo(7), fmt(today));
     const prev7d = sumSocial(daysAgo(14), daysAgo(7));
@@ -30504,19 +31078,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: sql12`SUM(${gaSocialReferrals.sessions})`
+      sessions: sql13`SUM(${gaSocialReferrals.sessions})`
     }).from(gaSocialReferrals).where(and23(
       eq29(gaSocialReferrals.projectId, project.id),
-      sql12`${gaSocialReferrals.date} >= ${daysAgo(7)}`,
-      sql12`${gaSocialReferrals.date} < ${fmt(today)}`
+      sql13`${gaSocialReferrals.date} >= ${daysAgo(7)}`,
+      sql13`${gaSocialReferrals.date} < ${fmt(today)}`
     )).groupBy(gaSocialReferrals.source).all();
     const sourcePrev = app.db.select({
       source: gaSocialReferrals.source,
-      sessions: sql12`SUM(${gaSocialReferrals.sessions})`
+      sessions: sql13`SUM(${gaSocialReferrals.sessions})`
     }).from(gaSocialReferrals).where(and23(
       eq29(gaSocialReferrals.projectId, project.id),
-      sql12`${gaSocialReferrals.date} >= ${daysAgo(14)}`,
-      sql12`${gaSocialReferrals.date} < ${daysAgo(7)}`
+      sql13`${gaSocialReferrals.date} >= ${daysAgo(14)}`,
+      sql13`${gaSocialReferrals.date} < ${daysAgo(7)}`
     )).groupBy(gaSocialReferrals.source).all();
     const prevMap = new Map(sourcePrev.map((r) => [r.source, r.sessions]));
     let biggestMover = null;
@@ -30555,16 +31129,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: sql12`COALESCE(SUM(${gaTrafficSnapshots.sessions}), 0)` }).from(gaTrafficSnapshots).where(and23(eq29(gaTrafficSnapshots.projectId, project.id), sql12`${gaTrafficSnapshots.date} >= ${from}`, sql12`${gaTrafficSnapshots.date} < ${to}`)).get();
-    const sumOrganic = (from, to) => app.db.select({ sessions: sql12`COALESCE(SUM(${gaTrafficSnapshots.organicSessions}), 0)` }).from(gaTrafficSnapshots).where(and23(eq29(gaTrafficSnapshots.projectId, project.id), sql12`${gaTrafficSnapshots.date} >= ${from}`, sql12`${gaTrafficSnapshots.date} < ${to}`)).get();
-    const sumDirect = (from, to) => app.db.select({ sessions: sql12`COALESCE(SUM(${gaTrafficSnapshots.directSessions}), 0)` }).from(gaTrafficSnapshots).where(and23(eq29(gaTrafficSnapshots.projectId, project.id), sql12`${gaTrafficSnapshots.date} >= ${from}`, sql12`${gaTrafficSnapshots.date} < ${to}`)).get();
-    const sumAi = (from, to) => app.db.select({ sessions: sql12`COALESCE(SUM(${gaAiReferrals.sessions}), 0)` }).from(gaAiReferrals).where(and23(
+    const sumTotal = (from, to) => app.db.select({ sessions: sql13`COALESCE(SUM(${gaTrafficSnapshots.sessions}), 0)` }).from(gaTrafficSnapshots).where(and23(eq29(gaTrafficSnapshots.projectId, project.id), sql13`${gaTrafficSnapshots.date} >= ${from}`, sql13`${gaTrafficSnapshots.date} < ${to}`)).get();
+    const sumOrganic = (from, to) => app.db.select({ sessions: sql13`COALESCE(SUM(${gaTrafficSnapshots.organicSessions}), 0)` }).from(gaTrafficSnapshots).where(and23(eq29(gaTrafficSnapshots.projectId, project.id), sql13`${gaTrafficSnapshots.date} >= ${from}`, sql13`${gaTrafficSnapshots.date} < ${to}`)).get();
+    const sumDirect = (from, to) => app.db.select({ sessions: sql13`COALESCE(SUM(${gaTrafficSnapshots.directSessions}), 0)` }).from(gaTrafficSnapshots).where(and23(eq29(gaTrafficSnapshots.projectId, project.id), sql13`${gaTrafficSnapshots.date} >= ${from}`, sql13`${gaTrafficSnapshots.date} < ${to}`)).get();
+    const sumAi = (from, to) => app.db.select({ sessions: sql13`COALESCE(SUM(${gaAiReferrals.sessions}), 0)` }).from(gaAiReferrals).where(and23(
       eq29(gaAiReferrals.projectId, project.id),
-      sql12`${gaAiReferrals.date} >= ${from}`,
-      sql12`${gaAiReferrals.date} < ${to}`,
+      sql13`${gaAiReferrals.date} >= ${from}`,
+      sql13`${gaAiReferrals.date} < ${to}`,
       eq29(gaAiReferrals.sourceDimension, "session")
     )).get();
-    const sumSocial = (from, to) => app.db.select({ sessions: sql12`COALESCE(SUM(${gaSocialReferrals.sessions}), 0)` }).from(gaSocialReferrals).where(and23(eq29(gaSocialReferrals.projectId, project.id), sql12`${gaSocialReferrals.date} >= ${from}`, sql12`${gaSocialReferrals.date} < ${to}`)).get();
+    const sumSocial = (from, to) => app.db.select({ sessions: sql13`COALESCE(SUM(${gaSocialReferrals.sessions}), 0)` }).from(gaSocialReferrals).where(and23(eq29(gaSocialReferrals.projectId, project.id), sql13`${gaSocialReferrals.date} >= ${from}`, sql13`${gaSocialReferrals.date} < ${to}`)).get();
     const todayStr = fmt(today);
     const buildTrend = (sum) => {
       const c7 = sum(daysAgo(7), todayStr)?.sessions ?? 0;
@@ -30573,16 +31147,16 @@ async function ga4Routes(app, opts) {
       const p30 = sum(daysAgo(60), daysAgo(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: sql12`COALESCE(SUM(${gaAiReferrals.sessions}), 0)` }).from(gaAiReferrals).where(and23(
+    const aiSourceCurrent = app.db.select({ source: gaAiReferrals.source, sessions: sql13`COALESCE(SUM(${gaAiReferrals.sessions}), 0)` }).from(gaAiReferrals).where(and23(
       eq29(gaAiReferrals.projectId, project.id),
-      sql12`${gaAiReferrals.date} >= ${daysAgo(7)}`,
-      sql12`${gaAiReferrals.date} < ${todayStr}`,
+      sql13`${gaAiReferrals.date} >= ${daysAgo(7)}`,
+      sql13`${gaAiReferrals.date} < ${todayStr}`,
       eq29(gaAiReferrals.sourceDimension, "session")
     )).groupBy(gaAiReferrals.source).all();
-    const aiSourcePrev = app.db.select({ source: gaAiReferrals.source, sessions: sql12`COALESCE(SUM(${gaAiReferrals.sessions}), 0)` }).from(gaAiReferrals).where(and23(
+    const aiSourcePrev = app.db.select({ source: gaAiReferrals.source, sessions: sql13`COALESCE(SUM(${gaAiReferrals.sessions}), 0)` }).from(gaAiReferrals).where(and23(
       eq29(gaAiReferrals.projectId, project.id),
-      sql12`${gaAiReferrals.date} >= ${daysAgo(14)}`,
-      sql12`${gaAiReferrals.date} < ${daysAgo(7)}`,
+      sql13`${gaAiReferrals.date} >= ${daysAgo(14)}`,
+      sql13`${gaAiReferrals.date} < ${daysAgo(7)}`,
       eq29(gaAiReferrals.sourceDimension, "session")
     )).groupBy(gaAiReferrals.source).all();
     const findBiggestMover = (current, prev) => {
@@ -30599,8 +31173,8 @@ async function ga4Routes(app, opts) {
       }
       return mover;
     };
-    const socialSourceCurrent = app.db.select({ source: gaSocialReferrals.source, sessions: sql12`SUM(${gaSocialReferrals.sessions})` }).from(gaSocialReferrals).where(and23(eq29(gaSocialReferrals.projectId, project.id), sql12`${gaSocialReferrals.date} >= ${daysAgo(7)}`, sql12`${gaSocialReferrals.date} < ${todayStr}`)).groupBy(gaSocialReferrals.source).all();
-    const socialSourcePrev = app.db.select({ source: gaSocialReferrals.source, sessions: sql12`SUM(${gaSocialReferrals.sessions})` }).from(gaSocialReferrals).where(and23(eq29(gaSocialReferrals.projectId, project.id), sql12`${gaSocialReferrals.date} >= ${daysAgo(14)}`, sql12`${gaSocialReferrals.date} < ${daysAgo(7)}`)).groupBy(gaSocialReferrals.source).all();
+    const socialSourceCurrent = app.db.select({ source: gaSocialReferrals.source, sessions: sql13`SUM(${gaSocialReferrals.sessions})` }).from(gaSocialReferrals).where(and23(eq29(gaSocialReferrals.projectId, project.id), sql13`${gaSocialReferrals.date} >= ${daysAgo(7)}`, sql13`${gaSocialReferrals.date} < ${todayStr}`)).groupBy(gaSocialReferrals.source).all();
+    const socialSourcePrev = app.db.select({ source: gaSocialReferrals.source, sessions: sql13`SUM(${gaSocialReferrals.sessions})` }).from(gaSocialReferrals).where(and23(eq29(gaSocialReferrals.projectId, project.id), sql13`${gaSocialReferrals.date} >= ${daysAgo(14)}`, sql13`${gaSocialReferrals.date} < ${daysAgo(7)}`)).groupBy(gaSocialReferrals.source).all();
     return {
       total: buildTrend(sumTotal),
       organic: buildTrend(sumOrganic),
@@ -30616,15 +31190,15 @@ async function ga4Routes(app, opts) {
     requireGa4Connection(opts, project.name, project.canonicalDomain);
     const cutoffDate = windowCutoff(parseWindow(request.query.window))?.slice(0, 10) ?? null;
     const conditions = [eq29(gaTrafficSnapshots.projectId, project.id)];
-    if (cutoffDate) conditions.push(sql12`${gaTrafficSnapshots.date} >= ${cutoffDate}`);
+    if (cutoffDate) conditions.push(sql13`${gaTrafficSnapshots.date} >= ${cutoffDate}`);
     const rows = app.db.select({
       date: gaTrafficSnapshots.date,
-      sessions: sql12`SUM(${gaTrafficSnapshots.sessions})`,
-      organicSessions: sql12`SUM(${gaTrafficSnapshots.organicSessions})`,
-      users: sql12`SUM(${gaTrafficSnapshots.users})`
+      sessions: sql13`SUM(${gaTrafficSnapshots.sessions})`,
+      organicSessions: sql13`SUM(${gaTrafficSnapshots.organicSessions})`,
+      users: sql13`SUM(${gaTrafficSnapshots.users})`
     }).from(gaTrafficSnapshots).where(and23(...conditions)).groupBy(gaTrafficSnapshots.date).orderBy(gaTrafficSnapshots.date).all();
     const totalConditions = [eq29(gaDailyTotals.projectId, project.id)];
-    if (cutoffDate) totalConditions.push(sql12`${gaDailyTotals.date} >= ${cutoffDate}`);
+    if (cutoffDate) totalConditions.push(sql13`${gaDailyTotals.date} >= ${cutoffDate}`);
     const totals = app.db.select({ date: gaDailyTotals.date, users: gaDailyTotals.users }).from(gaDailyTotals).where(and23(...totalConditions)).all();
     return buildSessionHistory(
       rows.map((r) => ({
@@ -30640,11 +31214,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: sql12`COALESCE(${gaTrafficSnapshots.landingPageNormalized}, ${gaTrafficSnapshots.landingPage})`,
-      sessions: sql12`SUM(${gaTrafficSnapshots.sessions})`,
-      organicSessions: sql12`SUM(${gaTrafficSnapshots.organicSessions})`,
-      users: sql12`SUM(${gaTrafficSnapshots.users})`
-    }).from(gaTrafficSnapshots).where(eq29(gaTrafficSnapshots.projectId, project.id)).groupBy(sql12`COALESCE(${gaTrafficSnapshots.landingPageNormalized}, ${gaTrafficSnapshots.landingPage})`).orderBy(sql12`SUM(${gaTrafficSnapshots.sessions}) DESC`).all();
+      landingPage: sql13`COALESCE(${gaTrafficSnapshots.landingPageNormalized}, ${gaTrafficSnapshots.landingPage})`,
+      sessions: sql13`SUM(${gaTrafficSnapshots.sessions})`,
+      organicSessions: sql13`SUM(${gaTrafficSnapshots.organicSessions})`,
+      users: sql13`SUM(${gaTrafficSnapshots.users})`
+    }).from(gaTrafficSnapshots).where(eq29(gaTrafficSnapshots.projectId, project.id)).groupBy(sql13`COALESCE(${gaTrafficSnapshots.landingPageNormalized}, ${gaTrafficSnapshots.landingPage})`).orderBy(sql13`SUM(${gaTrafficSnapshots.sessions}) DESC`).all();
     return {
       pages: trafficPages.map((r) => ({
         landingPage: r.landingPage,
@@ -31752,9 +32326,9 @@ async function wordpressRoutes(app, opts) {
     throw validationError("WordPress connection storage is not configured for this deployment");
   }
   async function assertWordpressUrlAllowed(rawUrl, field) {
-    const check = await resolveWebhookTarget(rawUrl, { allowLoopback });
-    if (!check.ok) {
-      throw validationError(`${field} ${check.message.replace(/^"url" /, "")}`);
+    const check2 = await resolveWebhookTarget(rawUrl, { allowLoopback });
+    if (!check2.ok) {
+      throw validationError(`${field} ${check2.message.replace(/^"url" /, "")}`);
     }
   }
   function requireConnection(store, projectName) {
@@ -32292,7 +32866,7 @@ async function wordpressRoutes(app, opts) {
 
 // ../api-routes/src/backlinks.ts
 import crypto26 from "crypto";
-import { and as and25, asc as asc7, desc as desc14, eq as eq30, sql as sql13 } from "drizzle-orm";
+import { and as and25, asc as asc7, desc as desc14, eq as eq30, sql as sql14 } from "drizzle-orm";
 
 // ../integration-commoncrawl/src/constants.ts
 import os2 from "os";
@@ -32582,7 +33156,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 sql16 = `
+  const sql17 = `
     WITH vertices AS (
       SELECT * FROM read_csv(
         ${quote(opts.vertexPath)},
@@ -32618,7 +33192,7 @@ async function queryBacklinks(opts) {
   const conn = await instance.connect();
   let rows;
   try {
-    const reader = await conn.runAndReadAll(sql16);
+    const reader = await conn.runAndReadAll(sql17);
     rows = reader.getRowObjects();
   } finally {
     conn.disconnectSync?.();
@@ -32808,12 +33382,12 @@ function computeFilteredSummary(db, base) {
   );
   const filteredCondition = and25(baseDomainCondition, backlinkCrawlerExclusionClause());
   const unfilteredAgg = db.select({
-    count: sql13`count(*)`,
-    total: sql13`coalesce(sum(${backlinkDomains.numHosts}), 0)`
+    count: sql14`count(*)`,
+    total: sql14`coalesce(sum(${backlinkDomains.numHosts}), 0)`
   }).from(backlinkDomains).where(baseDomainCondition).get();
   const filteredAgg = db.select({
-    count: sql13`count(*)`,
-    total: sql13`coalesce(sum(${backlinkDomains.numHosts}), 0)`
+    count: sql14`count(*)`,
+    total: sql14`coalesce(sum(${backlinkDomains.numHosts}), 0)`
   }).from(backlinkDomains).where(filteredCondition).get();
   const top10Rows = db.select({ numHosts: backlinkDomains.numHosts }).from(backlinkDomains).where(filteredCondition).orderBy(desc14(backlinkDomains.numHosts)).limit(10).all();
   const totalLinkingDomains = Number(filteredAgg?.count ?? 0);
@@ -32839,7 +33413,7 @@ function buildSourceAvailability(db, projectId, source, connected, excludeCrawle
   const summary = db.select().from(backlinkSummaries).where(and25(eq30(backlinkSummaries.projectId, projectId), eq30(backlinkSummaries.source, source))).orderBy(desc14(backlinkSummaries.queriedAt)).limit(1).get();
   let totalLinkingDomains = summary?.totalLinkingDomains ?? 0;
   if (summary && excludeCrawlers) {
-    const filtered = db.select({ count: sql13`count(*)` }).from(backlinkDomains).where(and25(
+    const filtered = db.select({ count: sql14`count(*)` }).from(backlinkDomains).where(and25(
       eq30(backlinkDomains.projectId, projectId),
       eq30(backlinkDomains.source, source),
       eq30(backlinkDomains.release, summary.release),
@@ -33028,7 +33602,7 @@ async function backlinksRoutes(app, opts) {
       eq30(backlinkDomains.release, targetRelease)
     );
     const domainCondition = excludeCrawlers ? and25(baseDomainCondition, backlinkCrawlerExclusionClause()) : baseDomainCondition;
-    const totalRow = app.db.select({ count: sql13`count(*)` }).from(backlinkDomains).where(domainCondition).get();
+    const totalRow = app.db.select({ count: sql14`count(*)` }).from(backlinkDomains).where(domainCondition).get();
     const rows = app.db.select({
       linkingDomain: backlinkDomains.linkingDomain,
       numHosts: backlinkDomains.numHosts,
@@ -33107,7 +33681,7 @@ async function backlinksRoutes(app, opts) {
 // ../api-routes/src/traffic.ts
 import crypto28 from "crypto";
 import { Agent as UndiciAgent } from "undici";
-import { and as and26, desc as desc15, eq as eq31, gte as gte7, lte as lte5, sql as sql14 } from "drizzle-orm";
+import { and as and26, desc as desc15, eq as eq31, gte as gte7, lte as lte5, sql as sql15 } from "drizzle-orm";
 
 // ../integration-cloud-run/src/auth.ts
 import crypto27 from "crypto";
@@ -37168,11 +37742,11 @@ async function trafficRoutes(app, opts) {
   const pullVercelEvents = opts.pullVercelTrafficEvents ?? listVercelTrafficEvents;
   const allowLoopback = opts.allowLoopbackWebhooks === true;
   async function assertWordpressTargetAllowed(baseUrl) {
-    const check = await resolveWebhookTarget(baseUrl, { allowLoopback });
-    if (!check.ok) {
-      throw validationError(`WordPress baseUrl rejected: ${check.message}`);
+    const check2 = await resolveWebhookTarget(baseUrl, { allowLoopback });
+    if (!check2.ok) {
+      throw validationError(`WordPress baseUrl rejected: ${check2.message}`);
     }
-    const { address, family } = check.target;
+    const { address, family } = check2.target;
     return new UndiciAgent({
       connect: {
         lookup: (_hostname, options, cb) => {
@@ -37808,7 +38382,7 @@ async function trafficRoutes(app, opts) {
             crawlerEventsHourly.status
           ],
           set: {
-            hits: sql14`${crawlerEventsHourly.hits} + ${bucket.hits}`,
+            hits: sql15`${crawlerEventsHourly.hits} + ${bucket.hits}`,
             sampledUserAgent: bucket.sampledUserAgent,
             updatedAt: finishedAt
           }
@@ -37841,7 +38415,7 @@ async function trafficRoutes(app, opts) {
             aiUserFetchEventsHourly.status
           ],
           set: {
-            hits: sql14`${aiUserFetchEventsHourly.hits} + ${bucket.hits}`,
+            hits: sql15`${aiUserFetchEventsHourly.hits} + ${bucket.hits}`,
             sampledUserAgent: bucket.sampledUserAgent,
             updatedAt: finishedAt
           }
@@ -37881,9 +38455,9 @@ async function trafficRoutes(app, opts) {
           // colliding bucket adds its paid and organic arrivals to the ones
           // already there rather than overwriting a single label.
           set: {
-            sessionsOrHits: sql14`${aiReferralEventsHourly.sessionsOrHits} + ${bucket.hits}`,
-            paidSessionsOrHits: sql14`${aiReferralEventsHourly.paidSessionsOrHits} + ${bucket.paidHits}`,
-            organicSessionsOrHits: sql14`${aiReferralEventsHourly.organicSessionsOrHits} + ${bucket.organicHits}`,
+            sessionsOrHits: sql15`${aiReferralEventsHourly.sessionsOrHits} + ${bucket.hits}`,
+            paidSessionsOrHits: sql15`${aiReferralEventsHourly.paidSessionsOrHits} + ${bucket.paidHits}`,
+            organicSessionsOrHits: sql15`${aiReferralEventsHourly.organicSessionsOrHits} + ${bucket.organicHits}`,
             updatedAt: finishedAt
           }
         }).run();
@@ -38174,7 +38748,7 @@ async function trafficRoutes(app, opts) {
   function buildSourceDetail(projectId, row, since) {
     const crawlerPathRows = app.db.select({
       pathNormalized: crawlerEventsHourly.pathNormalized,
-      hits: sql14`COALESCE(SUM(${crawlerEventsHourly.hits}), 0)`
+      hits: sql15`COALESCE(SUM(${crawlerEventsHourly.hits}), 0)`
     }).from(crawlerEventsHourly).where(
       and26(
         eq31(crawlerEventsHourly.sourceId, row.id),
@@ -38185,19 +38759,19 @@ async function trafficRoutes(app, opts) {
       crawlerPathRows.map((r) => ({ pathNormalized: r.pathNormalized, hits: Number(r.hits) }))
     );
     const crawlerTotal = crawlerSegments.content + crawlerSegments.sitemap + crawlerSegments.robots + crawlerSegments.asset + crawlerSegments.other;
-    const aiUserFetchTotals = app.db.select({ total: sql14`COALESCE(SUM(${aiUserFetchEventsHourly.hits}), 0)` }).from(aiUserFetchEventsHourly).where(
+    const aiUserFetchTotals = app.db.select({ total: sql15`COALESCE(SUM(${aiUserFetchEventsHourly.hits}), 0)` }).from(aiUserFetchEventsHourly).where(
       and26(
         eq31(aiUserFetchEventsHourly.sourceId, row.id),
         gte7(aiUserFetchEventsHourly.tsHour, since)
       )
     ).get();
-    const aiTotals = app.db.select({ total: sql14`COALESCE(SUM(${aiReferralEventsHourly.sessionsOrHits}), 0)` }).from(aiReferralEventsHourly).where(
+    const aiTotals = app.db.select({ total: sql15`COALESCE(SUM(${aiReferralEventsHourly.sessionsOrHits}), 0)` }).from(aiReferralEventsHourly).where(
       and26(
         eq31(aiReferralEventsHourly.sourceId, row.id),
         gte7(aiReferralEventsHourly.tsHour, since)
       )
     ).get();
-    const sampleTotals = app.db.select({ total: sql14`COUNT(*)` }).from(rawEventSamples).where(
+    const sampleTotals = app.db.select({ total: sql15`COUNT(*)` }).from(rawEventSamples).where(
       and26(
         eq31(rawEventSamples.sourceId, row.id),
         gte7(rawEventSamples.ts, since)
@@ -38359,18 +38933,18 @@ async function trafficRoutes(app, opts) {
       const crawlerWhere = and26(...crawlerFilters);
       const pathTotals = app.db.select({
         pathNormalized: crawlerEventsHourly.pathNormalized,
-        hits: sql14`COALESCE(SUM(${crawlerEventsHourly.hits}), 0)`,
-        rows: sql14`COUNT(*)`
+        hits: sql15`COALESCE(SUM(${crawlerEventsHourly.hits}), 0)`,
+        rows: sql15`COUNT(*)`
       }).from(crawlerEventsHourly).where(crawlerWhere).groupBy(crawlerEventsHourly.pathNormalized).all();
       crawlerSegments = segmentCrawlerHits(
         pathTotals.map((r) => ({ pathNormalized: r.pathNormalized, hits: Number(r.hits) }))
       );
       crawlerTotal = crawlerSegments.content + crawlerSegments.sitemap + crawlerSegments.robots + crawlerSegments.asset + crawlerSegments.other;
       totalEventRows += pathTotals.reduce((sum, row) => sum + Number(row.rows), 0);
-      const crawlerSeriesBucket = granularity === TrafficSeriesGranularities.day ? sql14`substr(${crawlerEventsHourly.tsHour}, 1, 10)` : crawlerEventsHourly.tsHour;
+      const crawlerSeriesBucket = granularity === TrafficSeriesGranularities.day ? sql15`substr(${crawlerEventsHourly.tsHour}, 1, 10)` : crawlerEventsHourly.tsHour;
       const crawlerSeries = app.db.select({
         bucket: crawlerSeriesBucket,
-        hits: sql14`COALESCE(SUM(${crawlerEventsHourly.hits}), 0)`
+        hits: sql15`COALESCE(SUM(${crawlerEventsHourly.hits}), 0)`
       }).from(crawlerEventsHourly).where(crawlerWhere).groupBy(crawlerSeriesBucket).all();
       for (const row of crawlerSeries) {
         trafficSeriesPoint(seriesByBucket, row.bucket).crawlerHits = Number(row.hits);
@@ -38400,15 +38974,15 @@ async function trafficRoutes(app, opts) {
       if (sourceIdParam) userFetchFilters.push(eq31(aiUserFetchEventsHourly.sourceId, sourceIdParam));
       const userFetchWhere = and26(...userFetchFilters);
       const total = app.db.select({
-        total: sql14`COALESCE(SUM(${aiUserFetchEventsHourly.hits}), 0)`,
-        rows: sql14`COUNT(*)`
+        total: sql15`COALESCE(SUM(${aiUserFetchEventsHourly.hits}), 0)`,
+        rows: sql15`COUNT(*)`
       }).from(aiUserFetchEventsHourly).where(userFetchWhere).get();
       aiUserFetchTotal = Number(total?.total ?? 0);
       totalEventRows += Number(total?.rows ?? 0);
-      const userFetchSeriesBucket = granularity === TrafficSeriesGranularities.day ? sql14`substr(${aiUserFetchEventsHourly.tsHour}, 1, 10)` : aiUserFetchEventsHourly.tsHour;
+      const userFetchSeriesBucket = granularity === TrafficSeriesGranularities.day ? sql15`substr(${aiUserFetchEventsHourly.tsHour}, 1, 10)` : aiUserFetchEventsHourly.tsHour;
       const userFetchSeries = app.db.select({
         bucket: userFetchSeriesBucket,
-        hits: sql14`COALESCE(SUM(${aiUserFetchEventsHourly.hits}), 0)`
+        hits: sql15`COALESCE(SUM(${aiUserFetchEventsHourly.hits}), 0)`
       }).from(aiUserFetchEventsHourly).where(userFetchWhere).groupBy(userFetchSeriesBucket).all();
       for (const row of userFetchSeries) {
         trafficSeriesPoint(seriesByBucket, row.bucket).aiUserFetchHits = Number(row.hits);
@@ -38437,10 +39011,10 @@ async function trafficRoutes(app, opts) {
       if (sourceIdParam) aiFilters.push(eq31(aiReferralEventsHourly.sourceId, sourceIdParam));
       const aiWhere = and26(...aiFilters);
       const total = app.db.select({
-        total: sql14`COALESCE(SUM(${aiReferralEventsHourly.sessionsOrHits}), 0)`,
-        paid: sql14`COALESCE(SUM(${aiReferralEventsHourly.paidSessionsOrHits}), 0)`,
-        organic: sql14`COALESCE(SUM(${aiReferralEventsHourly.organicSessionsOrHits}), 0)`,
-        rows: sql14`COUNT(*)`
+        total: sql15`COALESCE(SUM(${aiReferralEventsHourly.sessionsOrHits}), 0)`,
+        paid: sql15`COALESCE(SUM(${aiReferralEventsHourly.paidSessionsOrHits}), 0)`,
+        organic: sql15`COALESCE(SUM(${aiReferralEventsHourly.organicSessionsOrHits}), 0)`,
+        rows: sql15`COUNT(*)`
       }).from(aiReferralEventsHourly).where(aiWhere).get();
       aiReferralCounts = aiReferralClassCounts(
         Number(total?.total ?? 0),
@@ -38448,10 +39022,10 @@ async function trafficRoutes(app, opts) {
         Number(total?.organic ?? 0)
       );
       totalEventRows += Number(total?.rows ?? 0);
-      const referralSeriesBucket = granularity === TrafficSeriesGranularities.day ? sql14`substr(${aiReferralEventsHourly.tsHour}, 1, 10)` : aiReferralEventsHourly.tsHour;
+      const referralSeriesBucket = granularity === TrafficSeriesGranularities.day ? sql15`substr(${aiReferralEventsHourly.tsHour}, 1, 10)` : aiReferralEventsHourly.tsHour;
       const referralSeries = app.db.select({
         bucket: referralSeriesBucket,
-        hits: sql14`COALESCE(SUM(${aiReferralEventsHourly.sessionsOrHits}), 0)`
+        hits: sql15`COALESCE(SUM(${aiReferralEventsHourly.sessionsOrHits}), 0)`
       }).from(aiReferralEventsHourly).where(aiWhere).groupBy(referralSeriesBucket).all();
       for (const row of referralSeries) {
         trafficSeriesPoint(seriesByBucket, row.bucket).aiReferralHits = Number(row.hits);
@@ -39049,7 +39623,7 @@ var winnabilityCoverageCheck = {
 };
 var CONTENT_CHECKS = [winnabilityCoverageCheck];
 var CONTENT_CHECK_BY_ID = Object.fromEntries(
-  CONTENT_CHECKS.map((check) => [check.id, check])
+  CONTENT_CHECKS.map((check2) => [check2.id, check2])
 );
 
 // ../api-routes/src/doctor/checks/ads.ts
@@ -39600,7 +40174,7 @@ var GBP_AUTH_CHECKS = [
   recentSyncCheck
 ];
 var GBP_AUTH_CHECK_BY_ID = Object.fromEntries(
-  GBP_AUTH_CHECKS.map((check) => [check.id, check])
+  GBP_AUTH_CHECKS.map((check2) => [check2.id, check2])
 );
 
 // ../api-routes/src/doctor/checks/places.ts
@@ -39678,7 +40252,7 @@ var apiKeyCheck = {
 };
 var PLACES_CHECKS = [apiKeyCheck];
 var PLACES_CHECK_BY_ID = Object.fromEntries(
-  PLACES_CHECKS.map((check) => [check.id, check])
+  PLACES_CHECKS.map((check2) => [check2.id, check2])
 );
 
 // ../api-routes/src/doctor/checks/google-auth.ts
@@ -39985,7 +40559,7 @@ var GOOGLE_AUTH_CHECKS = [
   scopesCheck2
 ];
 var GOOGLE_AUTH_CHECK_BY_ID = Object.fromEntries(
-  GOOGLE_AUTH_CHECKS.map((check) => [check.id, check])
+  GOOGLE_AUTH_CHECKS.map((check2) => [check2.id, check2])
 );
 
 // ../api-routes/src/doctor/checks/providers.ts
@@ -40146,7 +40720,7 @@ var RUNTIME_STATE_CHECKS = [
 ];
 
 // ../api-routes/src/doctor/checks/traffic-source.ts
-import { and as and29, eq as eq37, gte as gte8, ne as ne5, sql as sql15 } from "drizzle-orm";
+import { and as and29, eq as eq37, gte as gte8, ne as ne5, sql as sql16 } from "drizzle-orm";
 var RECENT_DATA_WARN_DAYS = 7;
 var RECENT_DATA_FAIL_DAYS = 30;
 function skippedNoProject5() {
@@ -40240,7 +40814,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: sql15`COALESCE(SUM(${crawlerEventsHourly.hits}), 0)` }).from(crawlerEventsHourly).where(
+      ctx.db.select({ total: sql16`COALESCE(SUM(${crawlerEventsHourly.hits}), 0)` }).from(crawlerEventsHourly).where(
         and29(
           eq37(crawlerEventsHourly.projectId, ctx.project.id),
           gte8(crawlerEventsHourly.tsHour, warnCutoff)
@@ -40248,7 +40822,7 @@ var recentDataCheck = {
       ).get()?.total ?? 0
     );
     const recentReferrals = Number(
-      ctx.db.select({ total: sql15`COALESCE(SUM(${aiReferralEventsHourly.sessionsOrHits}), 0)` }).from(aiReferralEventsHourly).where(
+      ctx.db.select({ total: sql16`COALESCE(SUM(${aiReferralEventsHourly.sessionsOrHits}), 0)` }).from(aiReferralEventsHourly).where(
         and29(
           eq37(aiReferralEventsHourly.projectId, ctx.project.id),
           gte8(aiReferralEventsHourly.tsHour, warnCutoff)
@@ -40264,7 +40838,7 @@ var recentDataCheck = {
       };
     }
     const olderCrawlers = Number(
-      ctx.db.select({ total: sql15`COALESCE(SUM(${crawlerEventsHourly.hits}), 0)` }).from(crawlerEventsHourly).where(
+      ctx.db.select({ total: sql16`COALESCE(SUM(${crawlerEventsHourly.hits}), 0)` }).from(crawlerEventsHourly).where(
         and29(
           eq37(crawlerEventsHourly.projectId, ctx.project.id),
           gte8(crawlerEventsHourly.tsHour, failCutoff)
@@ -40272,7 +40846,7 @@ var recentDataCheck = {
       ).get()?.total ?? 0
     );
     const olderReferrals = Number(
-      ctx.db.select({ total: sql15`COALESCE(SUM(${aiReferralEventsHourly.sessionsOrHits}), 0)` }).from(aiReferralEventsHourly).where(
+      ctx.db.select({ total: sql16`COALESCE(SUM(${aiReferralEventsHourly.sessionsOrHits}), 0)` }).from(aiReferralEventsHourly).where(
         and29(
           eq37(aiReferralEventsHourly.projectId, ctx.project.id),
           gte8(aiReferralEventsHourly.tsHour, failCutoff)
@@ -40584,9 +41158,9 @@ async function runChecks(ctx, checks, options = {}) {
   const filters = options.checkIds ?? [];
   const targetScope = ctx.project ? CheckScopes.project : CheckScopes.global;
   const projectName = ctx.project?.name ?? null;
-  const selected = checks.filter((check) => {
-    if (check.scope !== targetScope) return false;
-    return matchesCheckId(check.id, filters);
+  const selected = checks.filter((check2) => {
+    if (check2.scope !== targetScope) return false;
+    return matchesCheckId(check2.id, filters);
   });
   const results = [];
   for (const definition of selected) {
@@ -41524,6 +42098,80 @@ async function technicalAeoRoutes(app, opts) {
   });
 }
 
+// ../api-routes/src/research.ts
+import crypto33 from "crypto";
+import { and as and32, desc as desc18, eq as eq41 } from "drizzle-orm";
+var sameLocation = (a, b) => a.label === b.label && a.city === b.city && a.region === b.region && a.country === b.country && a.timezone === b.timezone;
+async function researchRoutes(app, opts) {
+  app.post("/projects/:name/research/runs", async (request, reply) => {
+    const project = resolveProject(app.db, request.params.name);
+    if (!opts.onResearchRunRequested) throw missingDependency("Research execution is not available on this deployment.", { reason: "no-research-handler" });
+    const parsed = researchRunCreateSchema.safeParse(request.body ?? {});
+    if (!parsed.success) throw validationError("Invalid research run request", { issues: parsed.error.issues });
+    const input = parsed.data;
+    const adapters = opts.providerAdapters ?? [];
+    const configured = new Set(opts.configuredProviderNames ?? []);
+    const providerName = input.provider ?? project.providers.find((name) => configured.has(name) && adapters.some((adapter2) => adapter2.name === name && adapter2.mode === "api")) ?? adapters.find((adapter2) => adapter2.mode === "api" && configured.has(adapter2.name))?.name;
+    const adapter = adapters.find((candidate) => candidate.name === providerName);
+    if (!providerName || !adapter || adapter.mode !== "api" || isBrowserProvider(providerName) || !configured.has(providerName)) throw validationError("Research requires a configured API provider.", { provider: input.provider, validProviders: adapters.filter((a) => a.mode === "api" && configured.has(a.name)).map((a) => a.name) });
+    if (input.model) {
+      adapter.modelValidationPattern.lastIndex = 0;
+      if (!adapter.modelConfigurable || !adapter.modelValidationPattern.test(input.model)) throw validationError(`Invalid model "${input.model}" for provider "${providerName}".`, { provider: providerName, model: input.model, hint: adapter.modelValidationHint });
+    }
+    const location = input.location === void 0 ? project.defaultLocation ? project.locations.find((item) => item.label === project.defaultLocation) ?? null : null : input.location;
+    if (location && !project.locations.some((item) => sameLocation(item, location))) throw validationError("Research location must exactly match a configured project location.", { location });
+    const requestedModel = input.model ?? null;
+    const resolvedModel = requestedModel ?? (project.providerModels[providerName] || adapter.defaultModel);
+    adapter.modelValidationPattern.lastIndex = 0;
+    if (!adapter.modelValidationPattern.test(resolvedModel)) throw validationError(`Invalid resolved model "${resolvedModel}" for provider "${providerName}".`, { provider: providerName, model: resolvedModel, hint: adapter.modelValidationHint });
+    if (new Set(input.queries.map((query) => query.toLocaleLowerCase())).size !== input.queries.length) throw validationError("Research queries must be unique within a batch.");
+    const normalized = { queries: input.queries, provider: providerName, model: requestedModel, location: location ?? null };
+    const requestHash2 = crypto33.createHash("sha256").update(JSON.stringify(normalized)).digest("hex");
+    const now = (/* @__PURE__ */ new Date()).toISOString();
+    const decision = app.db.transaction((tx) => {
+      if (input.idempotencyKey) {
+        const existing = tx.select().from(researchRuns).where(and32(eq41(researchRuns.projectId, project.id), eq41(researchRuns.idempotencyKey, input.idempotencyKey))).get();
+        if (existing) {
+          if (existing.requestHash !== requestHash2) throw alreadyExists("Research idempotency key", input.idempotencyKey);
+          return { reused: true, id: existing.id, shouldDispatch: existing.status === ResearchRunStatuses.queued };
+        }
+      }
+      const id = crypto33.randomUUID();
+      tx.insert(researchRuns).values({ id, projectId: project.id, status: ResearchRunStatuses.queued, provider: providerName, requestedModel, resolvedModel, location: location ?? null, totalQueries: input.queries.length, idempotencyKey: input.idempotencyKey ?? null, requestHash: input.idempotencyKey ? requestHash2 : null, createdAt: now }).run();
+      for (const [position, query] of input.queries.entries()) tx.insert(researchRunQueries).values({ id: crypto33.randomUUID(), researchRunId: id, position, queryText: query, status: ResearchQueryStatuses.queued, requestedModel, resolvedModel, groundingSources: [], citedDomains: [], searchQueries: [], createdAt: now }).run();
+      writeAuditLog(tx, { projectId: project.id, actor: "api", action: "research.created", entityType: "research_run", entityId: id });
+      return { reused: false, id, shouldDispatch: true };
+    });
+    const result = getDetail(app, project.id, decision.id);
+    if (decision.shouldDispatch) opts.onResearchRunRequested(decision.id, project.id);
+    if (decision.reused) return reply.status(200).send(result);
+    return reply.status(202).send(result);
+  });
+  app.get("/projects/:name/research/runs", async (request) => {
+    const project = resolveProject(app.db, request.params.name);
+    const requested = Number.parseInt(request.query.limit ?? "", 10);
+    const limit = Number.isInteger(requested) && requested > 0 ? Math.min(requested, 100) : 20;
+    const runs2 = app.db.select().from(researchRuns).where(eq41(researchRuns.projectId, project.id)).orderBy(desc18(researchRuns.createdAt)).limit(limit).all().map(serializeRun);
+    return { runs: runs2 };
+  });
+  app.get("/projects/:name/research/runs/:runId", async (request) => {
+    const project = resolveProject(app.db, request.params.name);
+    return getDetail(app, project.id, request.params.runId);
+  });
+}
+function getDetail(app, projectId, id) {
+  const row = app.db.select().from(researchRuns).where(and32(eq41(researchRuns.id, id), eq41(researchRuns.projectId, projectId))).get();
+  if (!row) throw notFound("Research run", id);
+  const queries2 = app.db.select().from(researchRunQueries).where(eq41(researchRunQueries.researchRunId, id)).orderBy(researchRunQueries.position).all().map(serializeQuery);
+  return { ...serializeRun(row), queries: queries2 };
+}
+function serializeRun(row) {
+  return { id: row.id, projectId: row.projectId, status: row.status, provider: row.provider, requestedModel: row.requestedModel, resolvedModel: row.resolvedModel, location: row.location ?? null, totalQueries: row.totalQueries, completedQueries: row.completedQueries, failedQueries: row.failedQueries, error: row.error, startedAt: row.startedAt, finishedAt: row.finishedAt, createdAt: row.createdAt };
+}
+function serializeQuery(row) {
+  return { id: row.id, position: row.position, query: row.queryText, status: row.status, requestedModel: row.requestedModel, resolvedModel: row.resolvedModel, servedModel: row.servedModel, answerText: row.answerText, groundingSources: row.groundingSources, citedDomains: row.citedDomains, searchQueries: row.searchQueries, answerMentioned: row.answerMentioned, citationState: row.citationState, error: row.error, startedAt: row.startedAt, finishedAt: row.finishedAt, createdAt: row.createdAt };
+}
+
 // ../api-routes/src/index.ts
 async function apiRoutes(app, opts) {
   app.decorate("db", opts.db);
@@ -41710,6 +42358,11 @@ async function apiRoutes(app, opts) {
       harvestSearchQueries: opts.harvestSearchQueries,
       embedQueries: opts.embedQueries
     });
+    await api.register(researchRoutes, {
+      providerAdapters: opts.providerAdapters,
+      configuredProviderNames: opts.providerSummary?.filter((provider) => provider.configured).map((provider) => provider.name),
+      onResearchRunRequested: opts.onResearchRunRequested
+    });
     await api.register(technicalAeoRoutes, {
       onSiteAuditRequested: opts.onSiteAuditRequested
     });
@@ -41871,7 +42524,7 @@ function buildTrafficSourceValidators(opts) {
 }
 
 // src/intelligence-service.ts
-import crypto33 from "crypto";
+import crypto34 from "crypto";
 
 // src/logger.ts
 var IS_TTY = process.stdout.isTTY === true;
@@ -42103,16 +42756,16 @@ var IntelligenceService = class {
    */
   analyzeAndPersist(runId, projectId) {
     const recentRuns = this.db.select().from(runs).where(
-      and32(
-        eq41(runs.projectId, projectId),
-        or8(eq41(runs.status, "completed"), eq41(runs.status, "partial")),
+      and33(
+        eq42(runs.projectId, projectId),
+        or8(eq42(runs.status, "completed"), eq42(runs.status, "partial")),
         // Defensive: RunCoordinator already skips probes before this is
         // called, but if a future call site invokes analyzeAndPersist
         // directly for a probe, probes still must not pollute the
         // intelligence window.
         ne6(runs.trigger, RunTriggers.probe)
       )
-    ).orderBy(desc18(runs.finishedAt), desc18(runs.createdAt)).limit(HISTORY_WINDOW_RUNS).all();
+    ).orderBy(desc19(runs.finishedAt), desc19(runs.createdAt)).limit(HISTORY_WINDOW_RUNS).all();
     if (recentRuns.length === 0) {
       log.info("intelligence.skip", { runId, reason: "no completed runs" });
       return null;
@@ -42187,7 +42840,7 @@ var IntelligenceService = class {
    * Returns the persisted insights so the coordinator can count critical/high.
    */
   analyzeAndPersistGbp(runId, projectId) {
-    const runRow = this.db.select({ createdAt: runs.createdAt, startedAt: runs.startedAt, finishedAt: runs.finishedAt }).from(runs).where(eq41(runs.id, runId)).get();
+    const runRow = this.db.select({ createdAt: runs.createdAt, startedAt: runs.startedAt, finishedAt: runs.finishedAt }).from(runs).where(eq42(runs.id, runId)).get();
     if (!runRow) {
       log.info("gbp-intelligence.skip", { runId, reason: "run not found" });
       this.persistGbpInsights(runId, projectId, [], []);
@@ -42195,9 +42848,9 @@ var IntelligenceService = class {
     }
     const windowStart = runRow.startedAt ?? runRow.createdAt;
     const windowEnd = runRow.finishedAt ?? (/* @__PURE__ */ new Date()).toISOString();
-    const selected = this.db.select().from(gbpLocations).where(and32(
-      eq41(gbpLocations.projectId, projectId),
-      eq41(gbpLocations.selected, true),
+    const selected = this.db.select().from(gbpLocations).where(and33(
+      eq42(gbpLocations.projectId, projectId),
+      eq42(gbpLocations.selected, true),
       gte10(gbpLocations.syncedAt, windowStart),
       lte6(gbpLocations.syncedAt, windowEnd)
     )).all();
@@ -42232,12 +42885,12 @@ var IntelligenceService = class {
   }
   /** Build the per-location signal bundle the GBP analyzer consumes. */
   buildGbpLocationSignals(projectId, locationName, displayName, fallbackDate) {
-    const metricRows = this.db.select({ metric: gbpDailyMetrics.metric, date: gbpDailyMetrics.date, value: gbpDailyMetrics.value }).from(gbpDailyMetrics).where(and32(eq41(gbpDailyMetrics.projectId, projectId), eq41(gbpDailyMetrics.locationName, locationName))).all();
-    const placeActionRows = this.db.select({ placeActionType: gbpPlaceActions.placeActionType, providerType: gbpPlaceActions.providerType }).from(gbpPlaceActions).where(and32(eq41(gbpPlaceActions.projectId, projectId), eq41(gbpPlaceActions.locationName, locationName))).all();
-    const lodgingRow = this.db.select({ populatedGroupCount: gbpLodgingSnapshots.populatedGroupCount }).from(gbpLodgingSnapshots).where(and32(eq41(gbpLodgingSnapshots.projectId, projectId), eq41(gbpLodgingSnapshots.locationName, locationName))).orderBy(desc18(gbpLodgingSnapshots.syncedAt)).limit(1).get();
-    const ownerRow = this.db.select({ description: gbpLocations.description }).from(gbpLocations).where(and32(eq41(gbpLocations.projectId, projectId), eq41(gbpLocations.locationName, locationName))).get();
+    const metricRows = this.db.select({ metric: gbpDailyMetrics.metric, date: gbpDailyMetrics.date, value: gbpDailyMetrics.value }).from(gbpDailyMetrics).where(and33(eq42(gbpDailyMetrics.projectId, projectId), eq42(gbpDailyMetrics.locationName, locationName))).all();
+    const placeActionRows = this.db.select({ placeActionType: gbpPlaceActions.placeActionType, providerType: gbpPlaceActions.providerType }).from(gbpPlaceActions).where(and33(eq42(gbpPlaceActions.projectId, projectId), eq42(gbpPlaceActions.locationName, locationName))).all();
+    const lodgingRow = this.db.select({ populatedGroupCount: gbpLodgingSnapshots.populatedGroupCount }).from(gbpLodgingSnapshots).where(and33(eq42(gbpLodgingSnapshots.projectId, projectId), eq42(gbpLodgingSnapshots.locationName, locationName))).orderBy(desc19(gbpLodgingSnapshots.syncedAt)).limit(1).get();
+    const ownerRow = this.db.select({ description: gbpLocations.description }).from(gbpLocations).where(and33(eq42(gbpLocations.projectId, projectId), eq42(gbpLocations.locationName, locationName))).get();
     const descriptionMissing = !(ownerRow?.description ?? "").trim();
-    const placeRow = this.db.select({ attributes: gbpPlaceDetails.attributes }).from(gbpPlaceDetails).where(and32(eq41(gbpPlaceDetails.projectId, projectId), eq41(gbpPlaceDetails.locationName, locationName))).orderBy(desc18(gbpPlaceDetails.syncedAt)).limit(1).get();
+    const placeRow = this.db.select({ attributes: gbpPlaceDetails.attributes }).from(gbpPlaceDetails).where(and33(eq42(gbpPlaceDetails.projectId, projectId), eq42(gbpPlaceDetails.locationName, locationName))).orderBy(desc19(gbpPlaceDetails.syncedAt)).limit(1).get();
     const placesAmenities = placeRow ? extractPlaceAmenities(placeRow.attributes) : [];
     const summary = buildGbpSummary({
       locationName,
@@ -42273,7 +42926,7 @@ var IntelligenceService = class {
   /** Build the month-over-month keyword series for a location from the
    *  accumulating gbp_keyword_monthly table (latest complete month vs prior). */
   buildGbpKeywordTrend(projectId, locationName) {
-    const rows = this.db.select({ month: gbpKeywordMonthly.month, keyword: gbpKeywordMonthly.keyword, valueCount: gbpKeywordMonthly.valueCount }).from(gbpKeywordMonthly).where(and32(eq41(gbpKeywordMonthly.projectId, projectId), eq41(gbpKeywordMonthly.locationName, locationName))).all();
+    const rows = this.db.select({ month: gbpKeywordMonthly.month, keyword: gbpKeywordMonthly.keyword, valueCount: gbpKeywordMonthly.valueCount }).from(gbpKeywordMonthly).where(and33(eq42(gbpKeywordMonthly.projectId, projectId), eq42(gbpKeywordMonthly.locationName, locationName))).all();
     if (rows.length === 0) return { recentMonth: null, priorMonth: null, points: [] };
     const months = [...new Set(rows.map((r) => r.month))].sort().reverse();
     const recentMonth = months[0] ?? null;
@@ -42304,7 +42957,7 @@ var IntelligenceService = class {
    */
   persistGbpInsights(runId, projectId, gbpInsights, coveredLocationNames) {
     const covered = new Set(coveredLocationNames);
-    const existing = this.db.select({ id: insights.id, dismissed: insights.dismissed }).from(insights).where(and32(eq41(insights.projectId, projectId), eq41(insights.provider, GBP_INSIGHT_PROVIDER))).all();
+    const existing = this.db.select({ id: insights.id, dismissed: insights.dismissed }).from(insights).where(and33(eq42(insights.projectId, projectId), eq42(insights.provider, GBP_INSIGHT_PROVIDER))).all();
     const staleIds = [];
     const dismissedSlots = /* @__PURE__ */ new Set();
     for (const row of existing) {
@@ -42315,7 +42968,7 @@ var IntelligenceService = class {
     }
     this.db.transaction((tx) => {
       for (const id of staleIds) {
-        tx.delete(insights).where(eq41(insights.id, id)).run();
+        tx.delete(insights).where(eq42(insights.id, id)).run();
       }
       for (const insight of gbpInsights) {
         const parsed = parseGbpInsightId(insight.id);
@@ -42393,7 +43046,7 @@ var IntelligenceService = class {
    *     create per run + aggregate). DB is left untouched.
    */
   backfill(projectName, opts, onProgress) {
-    const project = this.db.select().from(projects).where(eq41(projects.name, projectName)).get();
+    const project = this.db.select().from(projects).where(eq42(projects.name, projectName)).get();
     if (!project) {
       throw new Error(`Project "${projectName}" not found`);
     }
@@ -42406,9 +43059,9 @@ var IntelligenceService = class {
       sinceTimestamp = parsed;
     }
     const allRuns = this.db.select().from(runs).where(
-      and32(
-        eq41(runs.projectId, project.id),
-        or8(eq41(runs.status, "completed"), eq41(runs.status, "partial")),
+      and33(
+        eq42(runs.projectId, project.id),
+        or8(eq42(runs.status, "completed"), eq42(runs.status, "partial")),
         // Backfill must not replay probe runs as if they were real sweeps.
         ne6(runs.trigger, RunTriggers.probe)
       )
@@ -42487,7 +43140,7 @@ var IntelligenceService = class {
     return { processed, skipped, totalInsights };
   }
   loadTrackedCompetitors(projectId) {
-    return this.db.select({ domain: competitors.domain }).from(competitors).where(eq41(competitors.projectId, projectId)).all().map((r) => r.domain);
+    return this.db.select({ domain: competitors.domain }).from(competitors).where(eq42(competitors.projectId, projectId)).all().map((r) => r.domain);
   }
   /**
    * Wipe transition signals from an analysis result while keeping health.
@@ -42508,15 +43161,15 @@ var IntelligenceService = class {
   }
   persistResult(result, runId, projectId) {
     const previouslyDismissed = /* @__PURE__ */ new Set();
-    const existingInsights = this.db.select({ query: insights.query, provider: insights.provider, type: insights.type, dismissed: insights.dismissed }).from(insights).where(eq41(insights.runId, runId)).all();
+    const existingInsights = this.db.select({ query: insights.query, provider: insights.provider, type: insights.type, dismissed: insights.dismissed }).from(insights).where(eq42(insights.runId, runId)).all();
     for (const row of existingInsights) {
       if (row.dismissed) {
         previouslyDismissed.add(`${row.query}:${row.provider}:${row.type}`);
       }
     }
     this.db.transaction((tx) => {
-      tx.delete(insights).where(eq41(insights.runId, runId)).run();
-      tx.delete(healthSnapshots).where(eq41(healthSnapshots.runId, runId)).run();
+      tx.delete(insights).where(eq42(insights.runId, runId)).run();
+      tx.delete(healthSnapshots).where(eq42(healthSnapshots.runId, runId)).run();
       const now = (/* @__PURE__ */ new Date()).toISOString();
       for (const insight of result.insights) {
         const wasDismissed = previouslyDismissed.has(`${insight.query}:${insight.provider}:${insight.type}`);
@@ -42536,7 +43189,7 @@ var IntelligenceService = class {
         }).run();
       }
       tx.insert(healthSnapshots).values({
-        id: crypto33.randomUUID(),
+        id: crypto34.randomUUID(),
         projectId,
         runId,
         overallCitedRate: String(result.health.overallCitedRate),
@@ -42569,28 +43222,28 @@ var IntelligenceService = class {
   applySeverityTiering(rawInsights, excludeRunId, projectId) {
     const regressions = rawInsights.filter((i) => i.type === "regression");
     if (regressions.length === 0) return rawInsights;
-    const gscRows = this.db.select({ query: gscSearchData.query, impressions: gscSearchData.impressions }).from(gscSearchData).where(eq41(gscSearchData.projectId, projectId)).all();
+    const gscRows = this.db.select({ query: gscSearchData.query, impressions: gscSearchData.impressions }).from(gscSearchData).where(eq42(gscSearchData.projectId, projectId)).all();
     const gscConnected = gscRows.length > 0;
     const gscImpressionsByQuery = /* @__PURE__ */ new Map();
     for (const row of gscRows) {
       const key = row.query.toLowerCase();
       gscImpressionsByQuery.set(key, (gscImpressionsByQuery.get(key) ?? 0) + row.impressions);
     }
-    const projectRow = this.db.select({ locations: projects.locations }).from(projects).where(eq41(projects.id, projectId)).get();
+    const projectRow = this.db.select({ locations: projects.locations }).from(projects).where(eq42(projects.id, projectId)).get();
     const locationCount = Math.max(
       1,
       (projectRow?.locations ?? []).length
     );
     const ROWS_PER_GROUP_BUDGET = Math.max(2, locationCount);
     const recentRunRows = this.db.select({ id: runs.id, createdAt: runs.createdAt }).from(runs).where(
-      and32(
-        eq41(runs.projectId, projectId),
-        eq41(runs.kind, RunKinds["answer-visibility"]),
-        or8(eq41(runs.status, "completed"), eq41(runs.status, "partial")),
+      and33(
+        eq42(runs.projectId, projectId),
+        eq42(runs.kind, RunKinds["answer-visibility"]),
+        or8(eq42(runs.status, "completed"), eq42(runs.status, "partial")),
         // Defensive — see top of file.
         ne6(runs.trigger, RunTriggers.probe)
       )
-    ).orderBy(desc18(runs.createdAt), desc18(runs.id)).limit((RECURRENCE_LOOKBACK_RUNS + 1) * ROWS_PER_GROUP_BUDGET).all();
+    ).orderBy(desc19(runs.createdAt), desc19(runs.id)).limit((RECURRENCE_LOOKBACK_RUNS + 1) * ROWS_PER_GROUP_BUDGET).all();
     const recentGroups = groupRunsByCreatedAt(recentRunRows);
     const recentRunIds = [];
     const recentRunIdToCreatedAt = /* @__PURE__ */ new Map();
@@ -42606,7 +43259,7 @@ var IntelligenceService = class {
     const haveHistory = recentRunIds.length > 0;
     const priorRegressionsByPair = /* @__PURE__ */ new Map();
     if (haveHistory) {
-      const priorRows = this.db.select({ query: insights.query, provider: insights.provider, runId: insights.runId }).from(insights).where(and32(eq41(insights.type, "regression"), inArray15(insights.runId, recentRunIds))).all();
+      const priorRows = this.db.select({ query: insights.query, provider: insights.provider, runId: insights.runId }).from(insights).where(and33(eq42(insights.type, "regression"), inArray15(insights.runId, recentRunIds))).all();
       const regressionGroups = /* @__PURE__ */ new Map();
       for (const row of priorRows) {
         if (!row.runId) continue;
@@ -42635,7 +43288,7 @@ var IntelligenceService = class {
     });
   }
   buildRunData(runId, projectId, completedAt, location = null) {
-    const projectDomainRow = this.db.select({ canonicalDomain: projects.canonicalDomain, ownedDomains: projects.ownedDomains }).from(projects).where(eq41(projects.id, projectId)).get();
+    const projectDomainRow = this.db.select({ canonicalDomain: projects.canonicalDomain, ownedDomains: projects.ownedDomains }).from(projects).where(eq42(projects.id, projectId)).get();
     const projectDomains = projectDomainRow ? effectiveDomains({
       canonicalDomain: projectDomainRow.canonicalDomain,
       ownedDomains: projectDomainRow.ownedDomains
@@ -42652,7 +43305,7 @@ var IntelligenceService = class {
       citedDomains: querySnapshots.citedDomains,
       competitorOverlap: querySnapshots.competitorOverlap,
       snapshotLocation: querySnapshots.location
-    }).from(querySnapshots).leftJoin(queries, eq41(querySnapshots.queryId, queries.id)).where(eq41(querySnapshots.runId, runId)).all();
+    }).from(querySnapshots).leftJoin(queries, eq42(querySnapshots.queryId, queries.id)).where(eq42(querySnapshots.runId, runId)).all();
     const snapshots = [];
     let orphanCount = 0;
     for (const r of rows) {
@@ -42728,6 +43381,8 @@ export {
   aiUserFetchEventsHourly,
   rawEventSamples,
   discoverySessions,
+  researchRuns,
+  researchRunQueries,
   gbpLocations,
   gbpDailyMetrics,
   gbpKeywordImpressions,