@canonry/canonry 5.13.0 → 5.15.0

package/dist/{chunk-Q35D2R2P.js → chunk-3YAPVVFN.js}

@@ -404,6 +404,7 @@ import {
   internalError,
   intersectScopes,
   isBrowserProvider,
+  isListingMarketplace,
   isLocationRedirectStatus,
   isReadOnlyKey,
   isRetryableHttpError,
@@ -783,10 +784,10 @@ import {
   wordpressSchemaDeployResultDtoSchema,
   wordpressSchemaStatusResultDtoSchema,
   wordpressStatusDtoSchema
-} from "./chunk-UWJAATGC.js";
+} from "./chunk-L36TC6LB.js";
 
 // src/intelligence-service.ts
-import { eq as eq70, desc as desc32, asc as asc12, and as and60, ne as ne11, or as or18, inArray as inArray27, gte as gte18, lte as lte15, isNull as isNull13, sql as sql28, exists } from "drizzle-orm";
+import { eq as eq71, desc as desc32, asc as asc12, and as and60, ne as ne11, or as or18, inArray as inArray27, gte as gte18, lte as lte15, isNull as isNull13, sql as sql28, exists } from "drizzle-orm";
 
 // ../db/src/client.ts
 import { mkdirSync } from "fs";
@@ -3296,6 +3297,7 @@ var adsCampaigns = sqliteTable("ads_campaigns", {
   lifetimeSpendLimitMicros: integer("lifetime_spend_limit_micros"),
   conversionEventSettingIds: text("conversion_event_setting_ids", { mode: "json" }).$type().notNull().default([]),
   targeting: text("targeting", { mode: "json" }).$type(),
+  landingPageQueryStringTemplate: text("landing_page_query_string_template"),
   upstreamCreatedAt: integer("upstream_created_at"),
   upstreamUpdatedAt: integer("upstream_updated_at"),
   syncRunId: text("sync_run_id").references(() => runs.id, { onDelete: "set null" }),
@@ -3313,6 +3315,7 @@ var adsAdGroups = sqliteTable("ads_ad_groups", {
   billingEventType: text("billing_event_type"),
   maxBidMicros: integer("max_bid_micros"),
   contextHints: text("context_hints", { mode: "json" }).$type().notNull().default([]),
+  landingPageQueryStringTemplate: text("landing_page_query_string_template"),
   upstreamCreatedAt: integer("upstream_created_at"),
   upstreamUpdatedAt: integer("upstream_updated_at"),
   syncRunId: text("sync_run_id").references(() => runs.id, { onDelete: "set null" }),
@@ -3329,6 +3332,7 @@ var adsAds = sqliteTable("ads_ads", {
   status: text("status").notNull(),
   creative: text("creative", { mode: "json" }).$type(),
   reviewStatus: text("review_status"),
+  landingPageQueryStringTemplate: text("landing_page_query_string_template"),
   upstreamCreatedAt: integer("upstream_created_at"),
   upstreamUpdatedAt: integer("upstream_updated_at"),
   syncRunId: text("sync_run_id").references(() => runs.id, { onDelete: "set null" }),
@@ -7515,6 +7519,19 @@ var MIGRATION_VERSIONS = [
       `CREATE INDEX IF NOT EXISTS idx_run_fills_run ON run_fills(run_id, created_at)`,
       `CREATE INDEX IF NOT EXISTS idx_run_fills_project_status ON run_fills(project_id, status)`
     ]
+  },
+  {
+    // Ad URL tracking parameters (`landing_page_configuration.
+    // query_string_template` upstream): the provider appends them to every
+    // click URL under the entity. Stored per level because campaign, ad group,
+    // and ad each carry their own, and upstream combines them.
+    version: 161,
+    name: "ads-landing-page-tracking-template",
+    statements: [
+      `ALTER TABLE ads_campaigns ADD COLUMN landing_page_query_string_template TEXT`,
+      `ALTER TABLE ads_ad_groups ADD COLUMN landing_page_query_string_template TEXT`,
+      `ALTER TABLE ads_ads ADD COLUMN landing_page_query_string_template TEXT`
+    ]
   }
 ];
 function addRunsMeasurementPlanVersionForeignKey(tx) {
@@ -19691,12 +19708,12 @@ function upsertCompetitor(authoring, body) {
   };
 }
 function removeCompetitor(authoring, body) {
-  const { groupKey, competitorKey } = parseBody(measurementDraftRemoveCompetitorRequestSchema, body, "remove-competitor");
+  const { groupKey, competitorKey: competitorKey2 } = parseBody(measurementDraftRemoveCompetitorRequestSchema, body, "remove-competitor");
   requireGroup(authoring, groupKey);
   return {
     authoring: {
       ...authoring,
-      groups: authoring.groups.map((group) => group.stableKey === groupKey ? { ...group, competitors: group.competitors.filter((competitor) => competitor.stableKey !== competitorKey) } : group)
+      groups: authoring.groups.map((group) => group.stableKey === groupKey ? { ...group, competitors: group.competitors.filter((competitor) => competitor.stableKey !== competitorKey2) } : group)
     },
     warnings: []
   };
@@ -40583,7 +40600,8 @@ var routeCatalog = [
             uniqueItems: true,
             items: stringSchema,
             description: "Optional conversion events to optimize delivery toward. Independent of biddingType: a clicks campaign may omit these."
-          }
+          },
+          landingPageQueryStringTemplate: { type: "string", minLength: 1, maxLength: 1e3, description: "Tracking parameters appended to click URLs under this entity, as a bare query string (utm_source=chatgpt&utm_medium=cpc). Supports the {campaign_id}, {ad_group_id}, {ad_id}, {ad_account_id} and {oppref} macros. Levels combine; on a duplicate key the destination URL wins, then ad, ad group, campaign." }
         }
       } } }
     },
@@ -40615,7 +40633,8 @@ var routeCatalog = [
           description: stringSchema,
           contextHints: { type: "array", minItems: 1, maxItems: 100, items: stringSchema },
           maxBidMicros: { type: "integer", minimum: 1, maximum: 1e8 },
-          billingEventType: { type: "string", enum: Object.values(AdsAdGroupBillingEventTypes) }
+          billingEventType: { type: "string", enum: Object.values(AdsAdGroupBillingEventTypes) },
+          landingPageQueryStringTemplate: { type: "string", minLength: 1, maxLength: 1e3, description: "Tracking parameters appended to click URLs under this entity, as a bare query string (utm_source=chatgpt&utm_medium=cpc). Supports the {campaign_id}, {ad_group_id}, {ad_id}, {ad_account_id} and {oppref} macros. Levels combine; on a duplicate key the destination URL wins, then ad, ad group, campaign." }
         }
       } } }
     },
@@ -40644,7 +40663,8 @@ var routeCatalog = [
           operationKey: adsOperationKeySchema,
           adGroupId: stringSchema,
           name: { type: "string", minLength: 3, maxLength: 1e3 },
-          creative: adsCreativeRequestSchema
+          creative: adsCreativeRequestSchema,
+          landingPageQueryStringTemplate: { type: "string", minLength: 1, maxLength: 1e3, description: "Tracking parameters appended to click URLs under this entity, as a bare query string (utm_source=chatgpt&utm_medium=cpc). Supports the {campaign_id}, {ad_group_id}, {ad_id}, {ad_account_id} and {oppref} macros. Levels combine; on a duplicate key the destination URL wins, then ad, ad group, campaign." }
         }
       } } }
     },
@@ -40677,7 +40697,8 @@ var routeCatalog = [
           startTime: { type: "integer", nullable: true },
           endTime: { type: "integer", nullable: true },
           lifetimeSpendLimitMicros: { type: "integer", minimum: 1e6 },
-          locationIds: { type: "array", minItems: 1, maxItems: 100, items: stringSchema }
+          locationIds: { type: "array", minItems: 1, maxItems: 100, items: stringSchema },
+          landingPageQueryStringTemplate: { type: "string", minLength: 1, maxLength: 1e3, nullable: true, description: "Tracking parameters appended to click URLs under this entity, as a bare query string. Null clears them." }
         }
       } } }
     },
@@ -40708,7 +40729,8 @@ var routeCatalog = [
           name: { type: "string", minLength: 3, maxLength: 1e3 },
           description: { type: "string", nullable: true },
           contextHints: { type: "array", minItems: 1, maxItems: 100, items: stringSchema },
-          maxBidMicros: { type: "integer", minimum: 1, maximum: 1e8 }
+          maxBidMicros: { type: "integer", minimum: 1, maximum: 1e8 },
+          landingPageQueryStringTemplate: { type: "string", minLength: 1, maxLength: 1e3, nullable: true, description: "Tracking parameters appended to click URLs under this entity, as a bare query string. Null clears them." }
         }
       } } }
     },
@@ -40737,7 +40759,8 @@ var routeCatalog = [
           operationKey: adsOperationKeySchema,
           expectedUpdatedAt: integerSchema,
           name: { type: "string", minLength: 3, maxLength: 1e3 },
-          creative: adsCreativeRequestSchema
+          creative: adsCreativeRequestSchema,
+          landingPageQueryStringTemplate: { type: "string", minLength: 1, maxLength: 1e3, nullable: true, description: "Tracking parameters appended to click URLs under this entity, as a bare query string. Null clears them." }
         }
       } } }
     },
@@ -52444,7 +52467,8 @@ function campaignCreateReconcileFields(input) {
     lifetimeSpendLimitMicros: input.lifetimeSpendLimitMicros,
     locationIds: normalizeStringSet(input.locationIds),
     biddingType: input.biddingType,
-    conversionEventSettingIds: normalizeStringSet(input.conversionEventSettingIds ?? [])
+    conversionEventSettingIds: normalizeStringSet(input.conversionEventSettingIds ?? []),
+    ...input.landingPageQueryStringTemplate === void 0 ? {} : { landingPageQueryStringTemplate: input.landingPageQueryStringTemplate }
   };
 }
 function adGroupCreateReconcileFields(input) {
@@ -52455,7 +52479,8 @@ function adGroupCreateReconcileFields(input) {
     status: AdsEntityStatuses.paused,
     contextHints: normalizeStringSet(input.contextHints),
     maxBidMicros: input.maxBidMicros,
-    billingEventType: input.billingEventType
+    billingEventType: input.billingEventType,
+    ...input.landingPageQueryStringTemplate === void 0 ? {} : { landingPageQueryStringTemplate: input.landingPageQueryStringTemplate }
   };
 }
 function adCreateReconcileFields(input) {
@@ -52463,7 +52488,8 @@ function adCreateReconcileFields(input) {
     adGroupId: input.adGroupId,
     name: normalizeString(input.name),
     status: AdsEntityStatuses.paused,
-    creativeFingerprint: creativeFingerprint(input.creative)
+    creativeFingerprint: creativeFingerprint(input.creative),
+    ...input.landingPageQueryStringTemplate === void 0 ? {} : { landingPageQueryStringTemplate: input.landingPageQueryStringTemplate }
   };
 }
 function updateReconcileFields(entityType, update) {
@@ -52471,6 +52497,10 @@ function updateReconcileFields(entityType, update) {
   if (typeof update.name === "string") fields.name = normalizeString(update.name);
   if (update.description === null) fields.description = null;
   else if (typeof update.description === "string") fields.description = normalizeString(update.description);
+  if (update.landingPageQueryStringTemplate === null) fields.landingPageQueryStringTemplate = null;
+  else if (typeof update.landingPageQueryStringTemplate === "string") {
+    fields.landingPageQueryStringTemplate = update.landingPageQueryStringTemplate;
+  }
   if (entityType === AdsEntityTypes.campaign) {
     if (update.startTime === null || typeof update.startTime === "number") fields.startTime = update.startTime;
     if (update.endTime === null || typeof update.endTime === "number") fields.endTime = update.endTime;
@@ -52512,6 +52542,10 @@ function entityReconcileFields(entity) {
   } else if (Array.isArray(entity.conversionEventSettingIds)) {
     fields.conversionEventSettingIds = normalizeStringSet(entity.conversionEventSettingIds);
   }
+  if (entity.landingPageQueryStringTemplate === null) fields.landingPageQueryStringTemplate = null;
+  else if (typeof entity.landingPageQueryStringTemplate === "string") {
+    fields.landingPageQueryStringTemplate = entity.landingPageQueryStringTemplate;
+  }
   if (typeof entity.campaignId === "string") fields.campaignId = entity.campaignId;
   if (Array.isArray(entity.contextHints)) fields.contextHints = normalizeStringSet(entity.contextHints);
   if (typeof entity.maxBidMicros === "number") fields.maxBidMicros = entity.maxBidMicros;
@@ -54055,6 +54089,7 @@ async function adsRoutes(app, opts) {
         status: ad.status,
         reviewStatus: ad.reviewStatus,
         creative: creativeDto(ad.creative),
+        landingPageQueryStringTemplate: ad.landingPageQueryStringTemplate,
         upstreamUpdatedAt: ad.upstreamUpdatedAt,
         syncedAt: ad.syncedAt
       };
@@ -54074,6 +54109,7 @@ async function adsRoutes(app, opts) {
         maxBidMicros: group.maxBidMicros,
         contextHints: group.contextHints,
         ads: adsByGroup.get(group.id) ?? [],
+        landingPageQueryStringTemplate: group.landingPageQueryStringTemplate,
         upstreamUpdatedAt: group.upstreamUpdatedAt,
         syncedAt: group.syncedAt
       };
@@ -54094,6 +54130,7 @@ async function adsRoutes(app, opts) {
       lifetimeSpendLimitMicros: campaign.lifetimeSpendLimitMicros,
       locationIds: locationIdsDto(campaign.targeting),
       adGroups: groupsByCampaign.get(campaign.id) ?? [],
+      landingPageQueryStringTemplate: campaign.landingPageQueryStringTemplate,
       upstreamUpdatedAt: campaign.upstreamUpdatedAt,
       syncedAt: campaign.syncedAt
     }));
@@ -85596,9 +85633,88 @@ function utcDayBounds(now) {
   return { start, end, date };
 }
 
+// ../api-routes/src/plan-competitors.ts
+import { eq as eq69 } from "drizzle-orm";
+function competitorKey(value) {
+  const host = (hostOf(value) ?? value).trim().toLowerCase().replace(/\.$/, "");
+  return host.startsWith("www.") ? host.slice(4) : host;
+}
+function merge(into, domain, names) {
+  const key = competitorKey(domain);
+  if (!key) return;
+  const set = into.get(key) ?? /* @__PURE__ */ new Set();
+  for (const name of names) if (name.trim()) set.add(name.trim());
+  into.set(key, set);
+}
+function toList(merged) {
+  return [...merged].sort(([left], [right]) => left.localeCompare(right)).map(([domain, names]) => ({ domain, aliases: [...names] }));
+}
+function readScope(db, versionId) {
+  const row = db.select({ canonicalJson: measurementPlanVersions.canonicalJson }).from(measurementPlanVersions).where(eq69(measurementPlanVersions.id, versionId)).get();
+  if (!row) return null;
+  let groups;
+  let edges;
+  try {
+    const plan = parseStoredMeasurementPlanAnyVersion(row.canonicalJson);
+    if (plan.schemaVersion === MEASUREMENT_PLAN_V2_SCHEMA_VERSION) {
+      groups = plan.groups.map((group) => ({
+        targetKeys: group.targetKeys,
+        competitors: group.competitors.map((competitor) => ({ domain: competitor.domain, names: [competitor.label, ...competitor.aliases] }))
+      }));
+      edges = plan.usageEdges;
+    } else {
+      groups = plan.groups.map((group) => ({
+        targetKeys: group.targetKeys,
+        competitors: (group.competitors ?? []).map((domain) => ({ domain, names: [] }))
+      }));
+      edges = plan.usageEdges.flatMap((edge) => edge.kind === "target" ? [edge] : []);
+    }
+  } catch {
+    return null;
+  }
+  const all = /* @__PURE__ */ new Map();
+  const groupsByTarget = /* @__PURE__ */ new Map();
+  groups.forEach((group, index2) => {
+    for (const competitor of group.competitors) merge(all, competitor.domain, competitor.names);
+    for (const target of group.targetKeys) groupsByTarget.set(target, [...groupsByTarget.get(target) ?? [], index2]);
+  });
+  const nodeGroups = /* @__PURE__ */ new Map();
+  for (const edge of edges) {
+    const set = nodeGroups.get(edge.executionNodeKey) ?? /* @__PURE__ */ new Set();
+    for (const index2 of groupsByTarget.get(edge.targetKey) ?? []) set.add(index2);
+    nodeGroups.set(edge.executionNodeKey, set);
+  }
+  const byNode = /* @__PURE__ */ new Map();
+  for (const [node, indexes] of nodeGroups) {
+    const merged = /* @__PURE__ */ new Map();
+    for (const index2 of indexes) for (const competitor of groups[index2].competitors) merge(merged, competitor.domain, competitor.names);
+    byNode.set(node, toList(merged));
+  }
+  return { all: toList(all), byNode };
+}
+function createRunCompetitorResolver(db, projectCompetitorDomains) {
+  const scopes = /* @__PURE__ */ new Map();
+  const listOnly = () => ({ domains: [...new Set(projectCompetitorDomains)], aliases: /* @__PURE__ */ new Map() });
+  return (versionId, executionId) => {
+    if (!versionId || !executionId) return listOnly();
+    if (!scopes.has(versionId)) scopes.set(versionId, readScope(db, versionId));
+    const pinned = scopes.get(versionId)?.byNode.get(executionId) ?? [];
+    if (pinned.length === 0) return listOnly();
+    const byKey = /* @__PURE__ */ new Map();
+    for (const domain of projectCompetitorDomains) if (!byKey.has(competitorKey(domain))) byKey.set(competitorKey(domain), domain);
+    const aliases = /* @__PURE__ */ new Map();
+    for (const competitor of pinned) {
+      const domain = byKey.get(competitor.domain) ?? competitor.domain;
+      byKey.set(competitor.domain, domain);
+      if (competitor.aliases.length) aliases.set(domain, competitor.aliases);
+    }
+    return { domains: [.../* @__PURE__ */ new Set([...projectCompetitorDomains, ...byKey.values()])], aliases };
+  };
+}
+
 // ../api-routes/src/simple-measurement-definitions.ts
 import crypto51 from "crypto";
-import { and as and59, eq as eq69 } from "drizzle-orm";
+import { and as and59, eq as eq70 } from "drizzle-orm";
 function captureSimpleMeasurementDefinition(db, input) {
   return db.transaction((tx) => {
     const run = tx.select({
@@ -85606,7 +85722,7 @@ function captureSimpleMeasurementDefinition(db, input) {
       trigger: runs.trigger,
       status: runs.status,
       measurementPlanVersionId: runs.measurementPlanVersionId
-    }).from(runs).where(and59(eq69(runs.projectId, input.projectId), eq69(runs.id, input.runId))).get();
+    }).from(runs).where(and59(eq70(runs.projectId, input.projectId), eq70(runs.id, input.runId))).get();
     if (!run) throw notFound("Run", input.runId);
     if (run.kind !== RunKinds["answer-visibility"] || run.trigger === RunTriggers.probe || run.measurementPlanVersionId !== null) {
       return null;
@@ -85616,7 +85732,7 @@ function captureSimpleMeasurementDefinition(db, input) {
     if (definition.queries.some((query) => query.queryClass !== (classifier?.classify(query.queryText) ?? null))) {
       throw validationError("Query classes must match the captured identity and text.");
     }
-    const existing = tx.select().from(simpleMeasurementDefinitions).where(and59(eq69(simpleMeasurementDefinitions.projectId, input.projectId), eq69(simpleMeasurementDefinitions.runId, input.runId))).get();
+    const existing = tx.select().from(simpleMeasurementDefinitions).where(and59(eq70(simpleMeasurementDefinitions.projectId, input.projectId), eq70(simpleMeasurementDefinitions.runId, input.runId))).get();
     if (existing) {
       const frozen = simpleMeasurementDefinitionSchema.parse(existing.definition);
       const replayDefinition = {
@@ -85637,15 +85753,15 @@ function captureSimpleMeasurementDefinition(db, input) {
     if (run.status !== RunStatuses.running) {
       throw validationError("Only a running run can capture a new measurement definition.");
     }
-    if (tx.select({ id: querySnapshots.id }).from(querySnapshots).where(eq69(querySnapshots.runId, input.runId)).limit(1).get()) {
+    if (tx.select({ id: querySnapshots.id }).from(querySnapshots).where(eq70(querySnapshots.runId, input.runId)).limit(1).get()) {
       throw validationError("This run already has stored answers. Its measurement definition cannot be inferred afterward.");
     }
-    const projectQueryIds = new Set(tx.select({ id: queries.id }).from(queries).where(eq69(queries.projectId, input.projectId)).all().map((query) => query.id));
+    const projectQueryIds = new Set(tx.select({ id: queries.id }).from(queries).where(eq70(queries.projectId, input.projectId)).all().map((query) => query.id));
     if (definition.queries.some((query) => !projectQueryIds.has(query.queryId))) {
       throw validationError("Every captured query must belong to the run project.");
     }
     if (definition.competitors !== void 0) {
-      const liveCompetitorDomains = new Set(tx.select({ domain: competitors.domain }).from(competitors).where(eq69(competitors.projectId, input.projectId)).all().map((competitor) => competitor.domain));
+      const liveCompetitorDomains = new Set(tx.select({ domain: competitors.domain }).from(competitors).where(eq70(competitors.projectId, input.projectId)).all().map((competitor) => competitor.domain));
       const capturedDomains = new Set(definition.competitors.map((competitor) => competitor.domain));
       if (liveCompetitorDomains.size !== capturedDomains.size || [...liveCompetitorDomains].some((domain) => !capturedDomains.has(domain))) {
         throw validationError("Captured competitors must exactly match the project competitors dispatched for this run.");
@@ -86462,7 +86578,7 @@ function determineCitationState(normalized, domains) {
   }
   return "not-cited";
 }
-function computeCompetitorOverlap(normalized, competitorDomains) {
+function computeCompetitorOverlap(normalized, competitorDomains, competitorAliases = /* @__PURE__ */ new Map()) {
   const overlapSet = /* @__PURE__ */ new Set();
   for (const d of normalized.citedDomains) {
     for (const cd of competitorDomains) {
@@ -86487,6 +86603,10 @@ function computeCompetitorOverlap(normalized, competitorDomains) {
       if (brandKeyFromText(brand).length >= 4 && textContainsBrandAlias(normalized.answerText, brand)) {
         overlapSet.add(cd);
       }
+      const named = competitorAliases.get(cd);
+      if (named?.length && textContainsAnyBrandAlias(normalized.answerText, named)) {
+        overlapSet.add(cd);
+      }
     }
   }
   return [...overlapSet];
@@ -86500,7 +86620,7 @@ function computeCitedCompetitorDomains(citedDomains, competitorDomains) {
   }
   return [...citedCompetitors];
 }
-function extractRecommendedCompetitors(answerText, ownDomains, citedDomains, competitorDomains, ownBrandNames = []) {
+function extractRecommendedCompetitors(answerText, ownDomains, citedDomains, competitorDomains, ownBrandNames = [], competitorAliases = /* @__PURE__ */ new Map()) {
   if (!answerText || answerText.length < 20) return [];
   const ownBrandAliases = new Set(
     ownDomains.flatMap((domain) => collectBrandAliasesFromDomain(domain))
@@ -86510,7 +86630,7 @@ function extractRecommendedCompetitors(answerText, ownDomains, citedDomains, com
   }
   const ownKeys = new Set([...ownBrandAliases].map(brandKeyFromText));
   const knownCompetitorAliases = new Set(
-    [...citedDomains, ...competitorDomains].flatMap((domain) => collectBrandAliasesFromDomain(domain)).filter((alias2) => !ownKeys.has(brandKeyFromText(alias2)))
+    [...citedDomains.filter((domain) => !isListingMarketplace(domain)), ...competitorDomains].flatMap((domain) => collectBrandAliasesFromDomain(domain)).concat([...competitorAliases.values()].flat()).filter((alias2) => !ownKeys.has(brandKeyFromText(alias2)))
   );
   if (knownCompetitorAliases.size === 0) return [];
   const candidatePatterns = [
@@ -86592,10 +86712,10 @@ var log = createLogger("IntelligenceService");
 var runChronologyKey = sql28`coalesce(${runs.finishedAt}, ${runs.createdAt})`;
 function analyzableRunPredicates(projectId) {
   return [
-    eq70(runs.projectId, projectId),
+    eq71(runs.projectId, projectId),
     // Only this kind writes query_snapshots.
-    eq70(runs.kind, RunKinds["answer-visibility"]),
-    or18(eq70(runs.status, RunStatuses.completed), eq70(runs.status, RunStatuses.partial)),
+    eq71(runs.kind, RunKinds["answer-visibility"]),
+    or18(eq71(runs.status, RunStatuses.completed), eq71(runs.status, RunStatuses.partial)),
     // Defensive: RunCoordinator already skips probes before analyzeAndPersist
     // is called, but a future call site invoking it directly for a probe must
     // still not pollute the intelligence window.
@@ -86640,7 +86760,7 @@ var IntelligenceService = class {
    * Returns the analysis result for the coordinator to inspect (e.g. for webhook dispatch).
    */
   analyzeAndPersist(runId, projectId) {
-    const currentRunRecord = this.db.select().from(runs).where(and60(eq70(runs.id, runId), ...analyzableRunPredicates(projectId))).get();
+    const currentRunRecord = this.db.select().from(runs).where(and60(eq71(runs.id, runId), ...analyzableRunPredicates(projectId))).get();
     if (!currentRunRecord) {
       log.info("intelligence.skip", { runId, reason: "run not eligible for analysis" });
       return null;
@@ -86649,7 +86769,7 @@ var IntelligenceService = class {
     const recentRuns = this.db.select().from(runs).where(
       and60(
         ...analyzableRunPredicates(projectId),
-        currentLocation === null ? isNull13(runs.location) : eq70(runs.location, currentLocation),
+        currentLocation === null ? isNull13(runs.location) : eq71(runs.location, currentLocation),
         // Never look forward. The window is this run's own past, so
         // re-analyzing a historical run compares it against its true
         // predecessor rather than against sweeps that came after it.
@@ -86657,7 +86777,7 @@ var IntelligenceService = class {
         // MEASUREMENT: only runs that actually wrote snapshots — see above.
         // Index seek on idx_snapshots_run, short-circuited on the first row.
         exists(
-          this.db.select({ one: sql28`1` }).from(querySnapshots).where(eq70(querySnapshots.runId, runs.id))
+          this.db.select({ one: sql28`1` }).from(querySnapshots).where(eq71(querySnapshots.runId, runs.id))
         )
       )
     ).orderBy(desc32(runs.finishedAt), desc32(runs.createdAt)).limit(HISTORY_WINDOW_RUNS).all();
@@ -86732,7 +86852,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(eq70(runs.id, runId)).get();
+    const runRow = this.db.select({ createdAt: runs.createdAt, startedAt: runs.startedAt, finishedAt: runs.finishedAt }).from(runs).where(eq71(runs.id, runId)).get();
     if (!runRow) {
       log.info("gbp-intelligence.skip", { runId, reason: "run not found" });
       this.persistGbpInsights(runId, projectId, [], []);
@@ -86741,8 +86861,8 @@ 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(and60(
-      eq70(gbpLocations.projectId, projectId),
-      eq70(gbpLocations.selected, true),
+      eq71(gbpLocations.projectId, projectId),
+      eq71(gbpLocations.selected, true),
       gte18(gbpLocations.syncedAt, windowStart),
       lte15(gbpLocations.syncedAt, windowEnd)
     )).all();
@@ -86777,12 +86897,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(and60(eq70(gbpDailyMetrics.projectId, projectId), eq70(gbpDailyMetrics.locationName, locationName))).all();
-    const placeActionRows = this.db.select({ placeActionType: gbpPlaceActions.placeActionType, providerType: gbpPlaceActions.providerType }).from(gbpPlaceActions).where(and60(eq70(gbpPlaceActions.projectId, projectId), eq70(gbpPlaceActions.locationName, locationName))).all();
-    const lodgingRow = this.db.select({ populatedGroupCount: gbpLodgingSnapshots.populatedGroupCount }).from(gbpLodgingSnapshots).where(and60(eq70(gbpLodgingSnapshots.projectId, projectId), eq70(gbpLodgingSnapshots.locationName, locationName))).orderBy(desc32(gbpLodgingSnapshots.syncedAt)).limit(1).get();
-    const ownerRow = this.db.select({ description: gbpLocations.description }).from(gbpLocations).where(and60(eq70(gbpLocations.projectId, projectId), eq70(gbpLocations.locationName, locationName))).get();
+    const metricRows = this.db.select({ metric: gbpDailyMetrics.metric, date: gbpDailyMetrics.date, value: gbpDailyMetrics.value }).from(gbpDailyMetrics).where(and60(eq71(gbpDailyMetrics.projectId, projectId), eq71(gbpDailyMetrics.locationName, locationName))).all();
+    const placeActionRows = this.db.select({ placeActionType: gbpPlaceActions.placeActionType, providerType: gbpPlaceActions.providerType }).from(gbpPlaceActions).where(and60(eq71(gbpPlaceActions.projectId, projectId), eq71(gbpPlaceActions.locationName, locationName))).all();
+    const lodgingRow = this.db.select({ populatedGroupCount: gbpLodgingSnapshots.populatedGroupCount }).from(gbpLodgingSnapshots).where(and60(eq71(gbpLodgingSnapshots.projectId, projectId), eq71(gbpLodgingSnapshots.locationName, locationName))).orderBy(desc32(gbpLodgingSnapshots.syncedAt)).limit(1).get();
+    const ownerRow = this.db.select({ description: gbpLocations.description }).from(gbpLocations).where(and60(eq71(gbpLocations.projectId, projectId), eq71(gbpLocations.locationName, locationName))).get();
     const descriptionMissing = !(ownerRow?.description ?? "").trim();
-    const placeRow = this.db.select({ attributes: gbpPlaceDetails.attributes }).from(gbpPlaceDetails).where(and60(eq70(gbpPlaceDetails.projectId, projectId), eq70(gbpPlaceDetails.locationName, locationName))).orderBy(desc32(gbpPlaceDetails.syncedAt)).limit(1).get();
+    const placeRow = this.db.select({ attributes: gbpPlaceDetails.attributes }).from(gbpPlaceDetails).where(and60(eq71(gbpPlaceDetails.projectId, projectId), eq71(gbpPlaceDetails.locationName, locationName))).orderBy(desc32(gbpPlaceDetails.syncedAt)).limit(1).get();
     const placesAmenities = placeRow ? extractPlaceAmenities(placeRow.attributes) : [];
     const summary3 = buildGbpSummary({
       locationName,
@@ -86818,7 +86938,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(and60(eq70(gbpKeywordMonthly.projectId, projectId), eq70(gbpKeywordMonthly.locationName, locationName))).all();
+    const rows = this.db.select({ month: gbpKeywordMonthly.month, keyword: gbpKeywordMonthly.keyword, valueCount: gbpKeywordMonthly.valueCount }).from(gbpKeywordMonthly).where(and60(eq71(gbpKeywordMonthly.projectId, projectId), eq71(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;
@@ -86849,7 +86969,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(and60(eq70(insights.projectId, projectId), eq70(insights.provider, GBP_INSIGHT_PROVIDER))).all();
+    const existing = this.db.select({ id: insights.id, dismissed: insights.dismissed }).from(insights).where(and60(eq71(insights.projectId, projectId), eq71(insights.provider, GBP_INSIGHT_PROVIDER))).all();
     const staleIds = [];
     const dismissedSlots = /* @__PURE__ */ new Set();
     for (const row of existing) {
@@ -86860,7 +86980,7 @@ var IntelligenceService = class {
     }
     this.db.transaction((tx) => {
       for (const id of staleIds) {
-        tx.delete(insights).where(eq70(insights.id, id)).run();
+        tx.delete(insights).where(eq71(insights.id, id)).run();
       }
       for (const insight of gbpInsights) {
         const parsed = parseGbpInsightId(insight.id);
@@ -86946,7 +87066,7 @@ var IntelligenceService = class {
    *     create per run + aggregate). DB is left untouched.
    */
   backfill(projectName, opts, onProgress) {
-    const project = this.db.select().from(projects).where(eq70(projects.name, projectName)).get();
+    const project = this.db.select().from(projects).where(eq71(projects.name, projectName)).get();
     if (!project) {
       throw new Error(`Project "${projectName}" not found`);
     }
@@ -87035,7 +87155,7 @@ var IntelligenceService = class {
     return { processed, skipped: skipped3, totalInsights };
   }
   loadTrackedCompetitors(projectId) {
-    return this.db.select({ domain: competitors.domain }).from(competitors).where(eq70(competitors.projectId, projectId)).all().map((r) => r.domain);
+    return this.db.select({ domain: competitors.domain }).from(competitors).where(eq71(competitors.projectId, projectId)).all().map((r) => r.domain);
   }
   /**
    * Which of `runIds` actually wrote query snapshots. One grouped read, so
@@ -87066,15 +87186,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(eq70(insights.runId, runId)).all();
+    const existingInsights = this.db.select({ query: insights.query, provider: insights.provider, type: insights.type, dismissed: insights.dismissed }).from(insights).where(eq71(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(eq70(insights.runId, runId)).run();
-      tx.delete(healthSnapshots).where(eq70(healthSnapshots.runId, runId)).run();
+      tx.delete(insights).where(eq71(insights.runId, runId)).run();
+      tx.delete(healthSnapshots).where(eq71(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}`);
@@ -87122,7 +87242,7 @@ var IntelligenceService = class {
       impressions: gscSearchData.impressions,
       position: gscSearchData.position
     }).from(gscSearchData).where(and60(
-      eq70(gscSearchData.projectId, projectId),
+      eq71(gscSearchData.projectId, projectId),
       gte18(gscSearchData.date, window.startDate),
       lte15(gscSearchData.date, window.endDate)
     )).all();
@@ -87175,7 +87295,7 @@ var IntelligenceService = class {
       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(eq70(projects.id, projectId)).get();
+    const projectRow = this.db.select({ locations: projects.locations }).from(projects).where(eq71(projects.id, projectId)).get();
     const locationCount = Math.max(
       1,
       (projectRow?.locations ?? []).length
@@ -87183,9 +87303,9 @@ var IntelligenceService = class {
     const ROWS_PER_GROUP_BUDGET = Math.max(2, locationCount);
     const recentRunRows = this.db.select({ id: runs.id, createdAt: runs.createdAt }).from(runs).where(
       and60(
-        eq70(runs.projectId, projectId),
-        eq70(runs.kind, RunKinds["answer-visibility"]),
-        or18(eq70(runs.status, "completed"), eq70(runs.status, "partial")),
+        eq71(runs.projectId, projectId),
+        eq71(runs.kind, RunKinds["answer-visibility"]),
+        or18(eq71(runs.status, "completed"), eq71(runs.status, "partial")),
         // Defensive — see top of file.
         ne11(runs.trigger, RunTriggers.probe)
       )
@@ -87205,7 +87325,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(and60(eq70(insights.type, "regression"), inArray27(insights.runId, recentRunIds))).all();
+      const priorRows = this.db.select({ query: insights.query, provider: insights.provider, runId: insights.runId }).from(insights).where(and60(eq71(insights.type, "regression"), inArray27(insights.runId, recentRunIds))).all();
       const regressionGroups = /* @__PURE__ */ new Map();
       for (const row of priorRows) {
         if (!row.runId) continue;
@@ -87234,7 +87354,7 @@ var IntelligenceService = class {
     });
   }
   buildRunData(runId, projectId, completedAt, location = null, trackedCompetitors = []) {
-    const projectDomainRow = this.db.select({ canonicalDomain: projects.canonicalDomain, ownedDomains: projects.ownedDomains }).from(projects).where(eq70(projects.id, projectId)).get();
+    const projectDomainRow = this.db.select({ canonicalDomain: projects.canonicalDomain, ownedDomains: projects.ownedDomains }).from(projects).where(eq71(projects.id, projectId)).get();
     const projectDomains = projectDomainRow ? effectiveDomains({
       canonicalDomain: projectDomainRow.canonicalDomain,
       ownedDomains: projectDomainRow.ownedDomains
@@ -87252,7 +87372,7 @@ var IntelligenceService = class {
       citedDomains: querySnapshots.citedDomains,
       rawResponse: querySnapshots.rawResponse,
       snapshotLocation: querySnapshots.location
-    }).from(querySnapshots).leftJoin(queries, eq70(querySnapshots.queryId, queries.id)).where(eq70(querySnapshots.runId, runId)).all();
+    }).from(querySnapshots).leftJoin(queries, eq71(querySnapshots.queryId, queries.id)).where(eq71(querySnapshots.runId, runId)).all();
     const snapshots = [];
     let orphanCount = 0;
     for (const r of rows) {
@@ -87473,6 +87593,7 @@ export {
   runChecks,
   executeDiscovery,
   markSessionFailed,
+  createRunCompetitorResolver,
   captureSimpleMeasurementDefinition,
   apiRoutes,
   addLogListener,

package/dist/{chunk-IDZQ5H3J.js → chunk-CDQDPUY4.js}

@@ -5,12 +5,12 @@ import {
   siteCrawlGraphNodes,
   siteCrawlPages,
   siteCrawlSnapshots
-} from "./chunk-Q35D2R2P.js";
+} from "./chunk-3YAPVVFN.js";
 import {
   SITE_CRAWL_GRAPH_MAX_EDGES,
   SITE_CRAWL_GRAPH_MAX_NODES,
   TEMPLATE_LINK_RATIO_THRESHOLD
-} from "./chunk-UWJAATGC.js";
+} from "./chunk-L36TC6LB.js";
 
 // src/site-crawl-graph-layout.ts
 import crypto from "crypto";

package/dist/{chunk-6YLNO2T5.js → chunk-JO5HHEJV.js}

@@ -4,14 +4,14 @@ import {
   installSkills,
   loadConfigRaw,
   saveConfigPatch
-} from "./chunk-IPGBK7XR.js";
+} from "./chunk-ZGZSROSR.js";
 import {
   PACKAGE_VERSION
 } from "./chunk-AOJU5LKX.js";
 import {
   SKILL_MANIFEST_FILENAME,
   SkillsClients
-} from "./chunk-UWJAATGC.js";
+} from "./chunk-L36TC6LB.js";
 
 // src/skills-autosync.ts
 import fs from "fs";