@canonry/canonry 4.136.1 → 4.137.0

package/dist/{chunk-YQ2RXMU2.js → chunk-PBTB3FCN.js}

@@ -248,6 +248,8 @@ import {
   gscUrlInspectionDtoSchema,
   hasLocationLabel,
   healthSnapshotDtoSchema,
+  hostMatchesAnyDomain,
+  hostMatchesDomain,
   hostOf,
   indexingRequestResponseDtoSchema,
   internalError,
@@ -262,6 +264,8 @@ import {
   mentionStateFromAnswerMentioned,
   missingDependency,
   modelIdsEquivalent,
+  noProvider,
+  noQueries,
   normalizeIdTokens,
   normalizeModelId,
   normalizeProjectAliases,
@@ -271,6 +275,7 @@ import {
   notFound,
   notImplemented,
   notificationDtoSchema,
+  onboardingTelemetryEventSchema,
   operationInProgress,
   orderLocationsDefaultFirst,
   organicEvidenceDtoSchema,
@@ -336,6 +341,10 @@ import {
   summarizeCheckResults,
   surfaceClassFromCompetitorType,
   surfaceClassLabel,
+  telemetryEventAcceptedDtoSchema,
+  textContainsAnyBrandAlias,
+  textContainsBrandAlias,
+  textContainsDomain,
   trafficBackfillResponseSchema,
   trafficConnectVercelRequestSchema,
   trafficConnectWordpressRequestSchema,
@@ -368,7 +377,7 @@ import {
   wordpressSchemaDeployResultDtoSchema,
   wordpressSchemaStatusResultDtoSchema,
   wordpressStatusDtoSchema
-} from "./chunk-PIMWEIJ3.js";
+} from "./chunk-7RF5EDUO.js";
 
 // src/intelligence-service.ts
 import { eq as eq44, desc as desc21, asc as asc9, and as and35, ne as ne6, or as or10, inArray as inArray15, gte as gte12, lte as lte8 } from "drizzle-orm";
@@ -5466,24 +5475,19 @@ function groupInsights(insights2, keyFn = (i) => JSON.stringify([i.query, i.prov
 var TRANSACTIONAL_RE = /\b(?:buy|price|pricing|cost|hire|near me|services?|agency|consultant|company)\b/i;
 var INFORMATIONAL_RE = /\b(?:what|how|why|when|guide|tutorial|vs|versus|alternatives?|examples?|definition)\b/i;
 var MIN_BRAND_TOKEN_LENGTH = 3;
-function compact(value) {
-  return value.toLowerCase().replace(/[^a-z0-9]/g, "");
-}
 function buildBrandTokens(canonicalDomain, brandNames = []) {
   const seen = /* @__PURE__ */ new Set();
-  const stem = canonicalDomain.toLowerCase().replace(/\.[a-z]{2,}$/, "");
-  const stemCompact = compact(stem);
+  const stemCompact = brandKeyFromText(brandLabelFromDomain(canonicalDomain));
   if (stemCompact.length >= MIN_BRAND_TOKEN_LENGTH) seen.add(stemCompact);
   for (const name of brandNames) {
     if (!name) continue;
-    const nameCompact = compact(name);
+    const nameCompact = brandKeyFromText(name);
     if (nameCompact.length >= MIN_BRAND_TOKEN_LENGTH) seen.add(nameCompact);
   }
   return [...seen];
 }
 function categorizeQueryByIntent(query, brandTokens) {
-  const compactQuery = compact(query);
-  if (brandTokens.length > 0 && brandTokens.some((t) => compactQuery.includes(t))) {
+  if (textContainsAnyBrandAlias(query, brandTokens)) {
     return "brand";
   }
   if (TRANSACTIONAL_RE.test(query)) return "lead-gen";
@@ -5551,12 +5555,7 @@ function buildCitationScorecard(snapshots, queryLookup) {
 
 // ../intelligence/src/domain-matching.ts
 function citedDomainBelongsToProject(citedDomain, projectDomains) {
-  const candidate = normalizeProjectDomain(citedDomain);
-  for (const domain of projectDomains) {
-    const normalized = normalizeProjectDomain(domain);
-    if (candidate === normalized || candidate.endsWith(`.${normalized}`)) return true;
-  }
-  return false;
+  return hostMatchesAnyDomain(citedDomain, projectDomains);
 }
 
 // ../intelligence/src/competitor-landscape.ts
@@ -5578,11 +5577,8 @@ function buildCompetitorLandscape(snapshots, competitorDomains, projectDomains,
         entry.count++;
         if (q) entry.queries.add(q);
       }
-      const competitorNorm = normalizeUrlDomain(competitor);
       for (const gs of snap.groundingSources) {
-        const host = normalizeUrlDomain(extractHostFromUri(gs.uri));
-        if (!host) continue;
-        if (host === competitorNorm || host.endsWith(`.${competitorNorm}`)) {
+        if (hostMatchesDomain(gs.uri, competitor)) {
           const entry = competitorMap.get(competitor);
           const pageQueries = entry.pages.get(gs.uri) ?? /* @__PURE__ */ new Set();
           if (q) pageQueries.add(q);
@@ -5616,16 +5612,6 @@ function buildCompetitorLandscape(snapshots, competitorDomains, projectDomains,
   competitorRows.sort((a, b) => b.citationCount - a.citationCount);
   return { projectCitationCount, competitors: competitorRows };
 }
-function normalizeUrlDomain(domain) {
-  return domain.toLowerCase().replace(/^https?:\/\//, "").replace(/^www\./, "").replace(/\/$/, "");
-}
-function extractHostFromUri(uri) {
-  try {
-    return new URL(uri).hostname;
-  } catch {
-    return "";
-  }
-}
 
 // ../intelligence/src/mention-landscape.ts
 function buildMentionLandscape(snapshots, competitorDomains, projectBrandNames, projectDomains, queryLookup) {
@@ -6043,10 +6029,9 @@ function buildCompetitorPressureScore(snapshots, competitorDomains, totalTracked
       trend: []
     };
   }
-  const competitorSet = new Set(competitorDomains);
   let overlapCount = 0;
   for (const snap of snapshots) {
-    if (snap.competitorOverlap.some((d) => competitorSet.has(d))) {
+    if (snap.competitorOverlap.some((domain) => hostMatchesAnyDomain(domain, competitorDomains))) {
       overlapCount++;
     }
   }
@@ -6071,7 +6056,7 @@ function buildOverviewCompetitors(snapshots, competitors2, queryLookup) {
   return competitors2.map((competitor, index2) => {
     const citedQuerySet = /* @__PURE__ */ new Set();
     for (const snap of snapshots) {
-      if (snap.competitorOverlap.includes(competitor.domain) || snap.citedDomains.includes(competitor.domain)) {
+      if (snap.competitorOverlap.some((domain) => hostMatchesDomain(domain, competitor.domain)) || snap.citedDomains.some((domain) => hostMatchesDomain(domain, competitor.domain))) {
         if (snap.queryId) citedQuerySet.add(snap.queryId);
       }
     }
@@ -6218,15 +6203,22 @@ function buildMentionShare(snapshots, options) {
   let projectMentionSnapshots = 0;
   let snapshotsWithAnswerText = 0;
   const competitorCounts = /* @__PURE__ */ new Map();
-  for (const c of options.competitors) competitorCounts.set(c.domain, 0);
+  const competitorAliases = /* @__PURE__ */ new Map();
+  for (const competitor of options.competitors) {
+    competitorCounts.set(competitor.domain, 0);
+    competitorAliases.set(
+      competitor.domain,
+      competitor.brandTokens.filter((alias) => brandKeyFromText(alias).length >= 3)
+    );
+  }
   for (const snap of snapshots) {
     const text2 = snap.answerText ?? "";
     if (text2.length === 0) continue;
     snapshotsWithAnswerText++;
     if (snap.projectMentioned) projectMentionSnapshots++;
-    const answerBrandKey = brandKeyFromText(text2);
     for (const competitor of options.competitors) {
-      if (competitorMentioned(text2, answerBrandKey, competitor.brandTokens)) {
+      const aliases = competitorAliases.get(competitor.domain) ?? [];
+      if (textContainsAnyBrandAlias(text2, aliases)) {
         competitorCounts.set(competitor.domain, (competitorCounts.get(competitor.domain) ?? 0) + 1);
       }
     }
@@ -6269,16 +6261,6 @@ function mentionShareTone(score) {
   if (score >= 25) return "caution";
   return "negative";
 }
-function competitorMentioned(text2, answerBrandKey, brandTokens) {
-  for (const token of brandTokens) {
-    if (token.length < 3) continue;
-    const escaped = token.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
-    if (new RegExp(`\\b${escaped}\\b`, "i").test(text2)) return true;
-    const tokenBrandKey = brandKeyFromText(token);
-    if (tokenBrandKey.length >= 3 && answerBrandKey.includes(tokenBrandKey)) return true;
-  }
-  return false;
-}
 function describe(parts) {
   const { score, projectMentionSnapshots, competitorMentionSnapshots, perCompetitor } = parts;
   if (projectMentionSnapshots === 0 && competitorMentionSnapshots === 0) {
@@ -7991,9 +7973,20 @@ async function runRoutes(app, opts) {
       rawProviders.splice(0, rawProviders.length, ...normalized);
     }
     const providers = rawProviders?.length ? rawProviders : void 0;
+    const shouldPreflight = trigger !== RunTriggers.probe && opts.getRunnableProviderNames !== void 0;
+    const trackedRows = body.queries?.length || shouldPreflight ? app.db.select({ query: queries.query }).from(queries).where(eq8(queries.projectId, project.id)).all() : [];
+    if (shouldPreflight) {
+      const preflightError = answerVisibilityPreflightError({
+        projectName: project.name,
+        projectProviders: project.providers,
+        requestedProviders: providers,
+        runnableProviderNames: opts.getRunnableProviderNames(),
+        trackedQueryCount: trackedRows.length
+      });
+      if (preflightError) throw preflightError;
+    }
     let scopedQueries = null;
     if (body.queries?.length) {
-      const trackedRows = app.db.select({ query: queries.query }).from(queries).where(eq8(queries.projectId, project.id)).all();
       const tracked = new Set(trackedRows.map((r) => r.query));
       const missing = body.queries.filter((q) => !tracked.has(q));
       if (missing.length) {
@@ -8157,7 +8150,28 @@ async function runRoutes(app, opts) {
     const providers = rawProviders?.length ? rawProviders : void 0;
     const now = (/* @__PURE__ */ new Date()).toISOString();
     const results = [];
+    const runnableProviderNames = opts.getRunnableProviderNames?.();
     for (const project of allProjects) {
+      if (runnableProviderNames) {
+        const trackedQuery = app.db.select({ id: queries.id }).from(queries).where(eq8(queries.projectId, project.id)).limit(1).get();
+        const preflightError = answerVisibilityPreflightError({
+          projectName: project.name,
+          projectProviders: project.providers,
+          requestedProviders: providers,
+          runnableProviderNames,
+          trackedQueryCount: trackedQuery ? 1 : 0
+        });
+        if (preflightError) {
+          results.push({
+            projectName: project.name,
+            projectId: project.id,
+            status: "error",
+            error: preflightError.message,
+            errorCode: preflightError.code
+          });
+          continue;
+        }
+      }
       const projectLocations = project.locations;
       let resolvedLocation;
       if (project.defaultLocation) {
@@ -8221,6 +8235,26 @@ async function runRoutes(app, opts) {
     return reply.send(loadRunDetail(app, run));
   });
 }
+function answerVisibilityPreflightError(input) {
+  if (input.trackedQueryCount === 0) {
+    return noQueries(input.projectName);
+  }
+  const availableProviders = normalizeProviderNames(input.runnableProviderNames);
+  const requestedProviders = normalizeProviderNames(input.requestedProviders ?? []);
+  const projectProviders = normalizeProviderNames(input.projectProviders);
+  const selectedProviders = requestedProviders.length > 0 ? requestedProviders : projectProviders.length > 0 ? projectProviders : availableProviders;
+  const available = new Set(availableProviders);
+  const runnableProviders = selectedProviders.filter((provider) => available.has(provider));
+  if (runnableProviders.length > 0) return null;
+  return noProvider(input.projectName, {
+    availableProviders,
+    selectedProviders,
+    selectionSource: requestedProviders.length > 0 ? "request" : projectProviders.length > 0 ? "project" : "instance"
+  });
+}
+function normalizeProviderNames(providerNames) {
+  return [...new Set(providerNames.map((name) => name.trim().toLowerCase()).filter(Boolean))];
+}
 function parseRunTriggerRequest(value) {
   const result = runTriggerRequestSchema.safeParse(value);
   if (result.success) return result.data;
@@ -9779,14 +9813,7 @@ async function analyticsRoutes(app) {
 }
 var ANCHOR_SWEEP_SCAN_LIMIT = 60;
 function isProviderInfraDomain(uri) {
-  try {
-    const host = new URL(uri).hostname.toLowerCase();
-    for (const blocked of AI_PROVIDER_INFRA_DOMAINS) {
-      if (host === blocked || host.endsWith(`.${blocked}`)) return true;
-    }
-  } catch {
-  }
-  return false;
+  return hostMatchesAnyDomain(uri, AI_PROVIDER_INFRA_DOMAINS);
 }
 function parseGroundingSources(rawResponse) {
   const parsed = parseJsonColumn(rawResponse, {});
@@ -10218,12 +10245,12 @@ import { and as and9, eq as eq13, desc as desc5, inArray as inArray6 } from "dri
 var RECENT_RUNS_WINDOW = 5;
 function loadOrchestratorInput(db, project, locationFilter = void 0) {
   const projectId = project.id;
-  const ownDomain = normalizeDomain(project.canonicalDomain);
+  const ownDomain = hostOf(project.canonicalDomain) ?? "";
   const ownedDomains = project.ownedDomains ?? [];
-  const ourDomains = /* @__PURE__ */ new Set([ownDomain, ...ownedDomains.map(normalizeDomain)]);
+  const ourDomains = /* @__PURE__ */ new Set([ownDomain, ...ownedDomains.map((domain) => hostOf(domain) ?? "")]);
   const trackedQueries = listQueries(db, projectId);
   const candidateQueryStrings = trackedQueries.filter(isBlogShapedQuery);
-  const trackedCompetitors = listCompetitorDomains(db, projectId).map(normalizeDomain);
+  const trackedCompetitors = listCompetitorDomains(db, projectId).map((domain) => hostOf(domain) ?? "");
   const competitorSet = new Set(trackedCompetitors);
   const recentRunIds = listRecentAnswerVisibilityRunIds(db, projectId, RECENT_RUNS_WINDOW, locationFilter);
   const latestRunId = recentRunIds[0] ?? "";
@@ -10264,7 +10291,7 @@ function loadOrchestratorInput(db, project, locationFilter = void 0) {
 }
 function loadDomainClasses(db, projectId) {
   const rows = db.select({ domain: domainClassifications.domain, competitorType: domainClassifications.competitorType }).from(domainClassifications).where(eq13(domainClassifications.projectId, projectId)).all();
-  return new Map(rows.map((r) => [normalizeDomain(r.domain), r.competitorType]));
+  return new Map(rows.map((r) => [hostOf(r.domain) ?? "", r.competitorType]));
 }
 function buildQueryIntentModifiers(project, locationFilter) {
   if (locationFilter === void 0 || locationFilter === null) return [];
@@ -10483,21 +10510,22 @@ function aggregateCandidate(opts) {
     const isLatestRun = snap.runId === opts.latestRunId;
     const competitorOverlap = snap.competitorOverlap;
     for (const domain of competitorOverlap) {
-      const normalized = normalizeDomain(domain);
-      if (!opts.competitorSet.has(normalized)) continue;
-      competitorTally.set(normalized, (competitorTally.get(normalized) ?? 0) + 1);
+      const normalized = hostOf(domain) ?? "";
+      const competitor = findMatchingDomain(normalized, opts.competitorSet);
+      if (!competitor) continue;
+      competitorTally.set(competitor, (competitorTally.get(competitor) ?? 0) + 1);
     }
     const grounding = extractGroundingSources(snap.rawResponse);
     for (const g of grounding) {
-      const domain = normalizeDomain(extractHostFromUri2(g.uri));
+      const domain = hostOf(g.uri) ?? "";
       if (!domain) continue;
-      if (opts.ourDomains.has(domain)) {
+      if (findMatchingDomain(domain, opts.ourDomains)) {
         if (isLatestRun) ourCitedInLatestRun = true;
         recordGroundingHit(ourGroundingTally, g, domain, snap.provider);
         continue;
       }
       citedSurfaceTally.set(domain, (citedSurfaceTally.get(domain) ?? 0) + 1);
-      if (!opts.competitorSet.has(domain)) continue;
+      if (!findMatchingDomain(domain, opts.competitorSet)) continue;
       recordGroundingHit(competitorGroundingTally, g, domain, snap.provider);
     }
   }
@@ -10519,6 +10547,9 @@ function aggregateCandidate(opts) {
     runsOfHistory: new Set(opts.snapshots.map((s) => s.runId)).size
   };
 }
+function findMatchingDomain(candidate, domains) {
+  return [...domains].find((domain) => hostMatchesDomain(candidate, domain));
+}
 function recordGroundingHit(tally, g, domain, provider) {
   const existing = tally.get(g.uri);
   if (existing) {
@@ -10571,16 +10602,6 @@ function extractGroundingSources(rawResponse) {
   }
   return [];
 }
-function extractHostFromUri2(uri) {
-  try {
-    return new URL(uri).hostname;
-  } catch {
-    return "";
-  }
-}
-function normalizeDomain(domain) {
-  return domain.toLowerCase().replace(/^https?:\/\//, "").replace(/^www\./, "").replace(/\/$/, "");
-}
 function extractPath2(url) {
   if (!url) return "";
   const trimmed = url.trim();
@@ -14943,10 +14964,7 @@ function stableUnique(values, normalize) {
   return result;
 }
 function matchesHost(value, marketingHosts) {
-  const normalized = normalizeHost(value);
-  return marketingHosts.some(
-    (candidate) => normalized === candidate || normalized.endsWith(`.${candidate}`)
-  );
+  return hostMatchesAnyDomain(value, marketingHosts);
 }
 function normalizeLandingPage(value) {
   return normalizeUrlPath(value) ?? UNKNOWN_LANDING_PAGE;
@@ -15016,10 +15034,10 @@ function buildGaMeasurementAnalysis(db, projectName, options = {}) {
     const conditions = [];
     if (parsedHostScope.data === "marketing") {
       const lowerHost = sql9`lower(${hostColumn})`;
-      const normalizedHost2 = sql9`case when ${lowerHost} like 'www.%' then substr(${lowerHost}, 5) else ${lowerHost} end`;
+      const normalizedHost = sql9`case when ${lowerHost} like 'www.%' then substr(${lowerHost}, 5) else ${lowerHost} end`;
       conditions.push(or4(...marketingHosts.flatMap((host) => [
-        sql9`${normalizedHost2} = ${host}`,
-        sql9`${normalizedHost2} like ${`%.${host}`}`
+        sql9`${normalizedHost} = ${host}`,
+        sql9`${normalizedHost} like ${`%.${host}`}`
       ])));
     }
     if (pathPrefix && pathPrefix !== "/") {
@@ -15276,11 +15294,7 @@ var normalizedPath = (value) => {
   return normalized.split("?")[0] || "/";
 };
 var inRange = (date, startDate, endDate) => date >= startDate && date <= endDate;
-var normalizedHost = (value) => value.trim().toLowerCase().replace(/^www\./, "");
-var matchesMarketingHost = (value, marketingHosts) => {
-  const hostname = normalizedHost(value);
-  return marketingHosts.some((candidate) => hostname === candidate || hostname.endsWith(`.${candidate}`));
-};
+var matchesMarketingHost = (value, marketingHosts) => hostMatchesAnyDomain(value, marketingHosts);
 var pageMatchesMarketingHost = (value, marketingHosts) => {
   return matchesMarketingHost(hostOf(value) ?? "", marketingHosts);
 };
@@ -15360,7 +15374,9 @@ function buildOrganicEvidence(db, projectName, periodDays) {
   const nativeAcquisition = measurement.acquisition;
   const nativeAcquisitionActive = nativeAcquisition.status !== "never-synced";
   const marketingHosts = measurement.filters.marketingHosts;
-  const normalizedMarketingHosts = [...new Set(marketingHosts.map(normalizedHost).filter(Boolean))];
+  const normalizedMarketingHosts = [...new Set(
+    marketingHosts.map((host) => hostOf(host)).filter((host) => host !== null)
+  )];
   const nativeStartDate = nativeAcquisition.periods[0]?.startDate;
   const nativeEndDate = nativeAcquisition.periods.at(-1)?.endDate;
   const gscCoverage = aggregateCoverage(db.select({
@@ -15813,7 +15829,7 @@ async function citationRoutes(app) {
       queryId: s.queryId,
       runCreatedAt: runCreatedAt.get(s.runId) ?? s.createdAt
     }));
-    const projectCompetitors = app.db.select({ domain: competitors.domain }).from(competitors).where(eq19(competitors.projectId, project.id)).all().map((c) => normalizeDomain2(c.domain)).filter((d) => d.length > 0);
+    const projectCompetitors = app.db.select({ domain: competitors.domain }).from(competitors).where(eq19(competitors.projectId, project.id)).all().map((c) => hostOf(c.domain) ?? "").filter((d) => d.length > 0);
     const response = computeCitationVisibility({
       queries: projectQueries.map((q) => ({ id: q.id, query: q.query })),
       snapshots,
@@ -15887,18 +15903,19 @@ function computeCitationVisibility(input) {
       totalProviders: providers.length
     });
   }
-  const competitorSet = new Set(competitorDomains);
   const competitorGaps = [];
   const queryById = new Map(qs.map((q) => [q.id, q.query]));
   for (const snap of latestByPair.values()) {
     if (citationStateToCited(snap.citationState)) continue;
-    if (competitorSet.size === 0) continue;
+    if (competitorDomains.length === 0) continue;
     const cited = snap.citedDomains;
     const overlap = snap.competitorOverlap;
     const candidates = new Set(
-      [...cited, ...overlap].map((d) => normalizeDomain2(d)).filter((d) => d.length > 0)
+      [...cited, ...overlap].map((d) => hostOf(d) ?? "").filter((d) => d.length > 0)
+    );
+    const citingCompetitors = competitorDomains.filter(
+      (competitor) => [...candidates].some((candidate) => hostMatchesDomain(candidate, competitor))
     );
-    const citingCompetitors = Array.from(candidates).filter((d) => competitorSet.has(d));
     if (citingCompetitors.length === 0) continue;
     competitorGaps.push({
       queryId: snap.queryId,
@@ -15940,9 +15957,6 @@ function computeCitationVisibility(input) {
     status: "ready"
   };
 }
-function normalizeDomain2(domain) {
-  return domain.toLowerCase().trim().replace(/^https?:\/\//, "").replace(/^www\./, "").replace(/\/$/, "");
-}
 
 // ../api-routes/src/visibility-stats.ts
 import { and as and16, desc as desc9, eq as eq20, inArray as inArray9 } from "drizzle-orm";
@@ -15952,9 +15966,6 @@ var VISIBILITY_COMPARE_MIN_RUNS = 5;
 function basketPairKey(queryId, provider) {
   return JSON.stringify([queryId, provider]);
 }
-function citedHostMatches(citedHost, competitorHost) {
-  return citedHost === competitorHost || citedHost.endsWith(`.${competitorHost}`);
-}
 function restrict(snapshots, attribution, pairs) {
   const out = [];
   for (const snap of snapshots) {
@@ -16035,7 +16046,7 @@ function countPeriod(snaps, competitors2) {
     if (competitorHosts.length > 0 && snap.citedDomains.length > 0) {
       const citedHosts = snap.citedDomains.map((d) => hostOf(d)).filter((h) => h !== null && h.length > 0);
       for (const compHost of competitorHosts) {
-        if (citedHosts.some((ch) => citedHostMatches(ch, compHost))) competitorCited += 1;
+        if (citedHosts.some((ch) => hostMatchesDomain(ch, compHost))) competitorCited += 1;
       }
     }
   }
@@ -17501,6 +17512,7 @@ var SCHEMA_TABLE = {
   LatestProjectRunDto: latestProjectRunDtoSchema,
   LocationContext: locationContextSchema,
   NotificationDto: notificationDtoSchema,
+  OnboardingTelemetryEvent: onboardingTelemetryEventSchema,
   OrganicEvidenceDto: organicEvidenceDtoSchema,
   ProjectDto: projectDtoSchema,
   ProjectUpsertRequest: projectUpsertRequestSchema,
@@ -17522,6 +17534,7 @@ var SCHEMA_TABLE = {
   SnapshotListResponse: snapshotListResponseSchema,
   SnapshotReportDto: snapshotReportSchema,
   SourceBreakdownDto: sourceBreakdownDtoSchema,
+  TelemetryEventAcceptedDto: telemetryEventAcceptedDtoSchema,
   TrafficBackfillResponse: trafficBackfillResponseSchema,
   TrafficEventsResponse: trafficEventsResponseSchema,
   TrafficSourceDetailDto: trafficSourceDetailDtoSchema,
@@ -18547,7 +18560,9 @@ var routeCatalog = [
     },
     responses: {
       201: jsonResponse("Run queued.", "RunDto"),
-      409: errorResponse("Run already in progress.")
+      422: errorResponse("Project has no tracked queries."),
+      409: errorResponse("Run already in progress."),
+      503: errorResponse("No runnable answer provider is configured.")
     }
   },
   {
@@ -19172,6 +19187,24 @@ var routeCatalog = [
       501: errorResponse("Telemetry configuration is not available.")
     }
   },
+  {
+    method: "post",
+    path: "/api/v1/telemetry/onboarding",
+    summary: "Record a privacy-safe onboarding milestone",
+    tags: ["telemetry"],
+    requestBody: {
+      required: true,
+      content: {
+        "application/json": {
+          schema: { $ref: "#/components/schemas/OnboardingTelemetryEvent" }
+        }
+      }
+    },
+    responses: {
+      202: jsonResponse("Onboarding milestone accepted.", "TelemetryEventAcceptedDto"),
+      400: errorResponse("Invalid onboarding telemetry event.")
+    }
+  },
   {
     method: "get",
     path: "/api/v1/screenshots/{snapshotId}",
@@ -22822,6 +22855,19 @@ async function telemetryRoutes(app, opts) {
       anonymousId: status?.anonymousId ? status.anonymousId.slice(0, 8) + "..." : void 0
     };
   });
+  app.post("/telemetry/onboarding", async (request, reply) => {
+    const parsed = onboardingTelemetryEventSchema.safeParse(request.body);
+    if (!parsed.success) {
+      throw validationError("Invalid onboarding telemetry event", {
+        issues: parsed.error.issues.map((issue) => ({
+          code: issue.code,
+          path: issue.path.join(".")
+        }))
+      });
+    }
+    opts.recordOnboardingEvent?.(parsed.data);
+    return reply.status(202).send({ accepted: Boolean(opts.recordOnboardingEvent) });
+  });
 }
 
 // ../api-routes/src/schedules.ts
@@ -24843,12 +24889,28 @@ function stableStringify3(value) {
 }
 
 // ../api-routes/src/google.ts
+var GOOGLE_OAUTH_COMPLETE_MESSAGE = "canonry:google-oauth-complete";
+function googleOAuthSuccessHtml(type) {
+  const message = JSON.stringify({
+    type: GOOGLE_OAUTH_COMPLETE_MESSAGE,
+    connectionType: type
+  });
+  return `<html><body style="font-family:system-ui;text-align:center;padding:60px">
+    <h2>Connected successfully!</h2>
+    <p>Google ${type.toUpperCase()} has been linked to your domain.</p>
+    <p style="color:#888">This window closes automatically.</p>
+    <script>
+      if (window.opener && !window.opener.closed) {
+        window.opener.postMessage(${message}, '*')
+        window.close()
+      }
+    </script>
+  </body></html>`;
+}
 function isOnProjectDomain(url, projectDomain) {
-  try {
-    return new URL(url).hostname.toLowerCase().replace(/^www\./, "") === projectDomain;
-  } catch {
-    return false;
-  }
+  const urlHost = hostOf(url);
+  const projectHost = hostOf(projectDomain);
+  return urlHost !== null && projectHost !== null && urlHost === projectHost;
 }
 function scopesForConnectionType(type) {
   switch (type) {
@@ -24870,12 +24932,10 @@ function isSitemapOwnedByProperty(sitemapUrl, propertyId, canonicalDomain) {
   if (sitemap.protocol !== "http:" && sitemap.protocol !== "https:") return false;
   if (/^sc-domain:/i.test(propertyId)) {
     const domain = propertyId.slice("sc-domain:".length).toLowerCase();
-    const host = sitemap.hostname.toLowerCase();
-    return host === domain || host.endsWith(`.${domain}`);
+    return hostMatchesDomain(sitemap.hostname, domain);
   }
   if (/^\d+$/.test(propertyId)) {
-    const domain = normalizeProjectDomain(canonicalDomain);
-    return sitemap.hostname.toLowerCase().replace(/^www\./, "") === domain;
+    return hostOf(sitemap.hostname) === hostOf(canonicalDomain);
   }
   try {
     const property = new URL(propertyId);
@@ -25172,13 +25232,7 @@ async function googleRoutes(app, opts) {
       entityId: type,
       diff: { domain, type, propertyId }
     });
-    return reply.type("text/html").send(
-      `<html><body style="font-family:system-ui;text-align:center;padding:60px">
-        <h2>Connected successfully!</h2>
-        <p>Google ${type.toUpperCase()} has been linked to your domain.</p>
-        <p style="color:#888">You can close this tab.</p>
-      </body></html>`
-    );
+    return reply.type("text/html").send(googleOAuthSuccessHtml(type));
   }
   app.get("/google/callback", async (request, reply) => {
     return handleOAuthCallback(request, reply);
@@ -38436,9 +38490,7 @@ function normalizeHost2(host) {
   return host.trim().toLowerCase().replace(/^www\./, "");
 }
 function hostMatches(host, domain) {
-  const normalizedHost2 = normalizeHost2(host);
-  const normalizedDomain = normalizeHost2(domain);
-  return normalizedHost2 === normalizedDomain || normalizedHost2.endsWith(`.${normalizedDomain}`);
+  return hostMatchesDomain(host, domain);
 }
 function utmTokenMatchesDomain(utmSource, domain) {
   if (hostMatches(utmSource, domain)) return true;
@@ -38447,12 +38499,7 @@ function utmTokenMatchesDomain(utmSource, domain) {
   return Boolean(firstLabel) && normalizedUtm === firstLabel;
 }
 function hostFromUrl(value) {
-  if (!value) return null;
-  try {
-    return normalizeHost2(new URL(value).hostname);
-  } catch {
-    return null;
-  }
+  return hostOf(value);
 }
 function utmSourceFromQuery(queryString) {
   if (!queryString) return null;
@@ -38622,13 +38669,9 @@ function sessionWindowBucket(value, windowMs) {
   if (Number.isNaN(date.getTime())) return value;
   return new Date(Math.floor(date.getTime() / windowMs) * windowMs).toISOString();
 }
-function normalizeHost3(host) {
-  if (!host) return null;
-  return host.trim().toLowerCase().replace(/^www\./, "") || null;
-}
 function sameHost(a, b) {
-  const normalizedA = normalizeHost3(a);
-  const normalizedB = normalizeHost3(b);
+  const normalizedA = hostOf(a);
+  const normalizedB = hostOf(b);
   return !!normalizedA && !!normalizedB && normalizedA === normalizedB;
 }
 function pathFromSameOriginReferer(event) {
@@ -43888,7 +43931,7 @@ function upsertDomainClassifications(db, projectId, sessionId, competitorMap) {
   if (competitorMap.length === 0) return;
   const now = (/* @__PURE__ */ new Date()).toISOString();
   for (const entry of competitorMap) {
-    const domain = normalizeDomain(entry.domain);
+    const domain = hostOf(entry.domain) ?? "";
     if (!domain) continue;
     db.insert(domainClassifications).values({
       id: crypto31.randomUUID(),
@@ -44219,7 +44262,8 @@ async function apiRoutes(app, opts) {
     await api.register(competitorRoutes);
     await api.register(runRoutes, {
       onRunCreated: opts.onRunCreated,
-      validProviderNames: opts.providerAdapters?.map((a) => a.name)
+      validProviderNames: opts.providerAdapters?.map((a) => a.name),
+      getRunnableProviderNames: opts.getRunnableProviderNames
     });
     await api.register(applyRoutes, {
       onScheduleUpdated: opts.onScheduleUpdated,
@@ -44270,7 +44314,8 @@ async function apiRoutes(app, opts) {
     });
     await api.register(telemetryRoutes, {
       getTelemetryStatus: opts.getTelemetryStatus,
-      setTelemetryEnabled: opts.setTelemetryEnabled
+      setTelemetryEnabled: opts.setTelemetryEnabled,
+      recordOnboardingEvent: opts.recordOnboardingEvent
     });
     await api.register(adsRoutes, {
       adsCredentialStore: opts.adsCredentialStore,
@@ -44555,38 +44600,20 @@ function createLogger(module) {
 }
 
 // src/citation-utils.ts
-function domainMatches(domain, canonicalDomain) {
-  const normalized = normalizeProjectDomain(canonicalDomain);
-  const d = normalizeProjectDomain(domain);
-  return d === normalized || d.endsWith(`.${normalized}`);
-}
 function pickProjectCitedDomain(citedDomains, projectDomains) {
   for (const cited of citedDomains) {
-    if (projectDomains.some((pd) => domainMatches(cited, pd))) return cited;
+    if (projectDomains.some((pd) => hostMatchesDomain(cited, pd))) return cited;
   }
   return void 0;
 }
 function determineCitationState(normalized, domains) {
   for (const canonicalDomain of domains) {
-    const bareDomain = normalizeProjectDomain(canonicalDomain);
-    if (normalized.citedDomains.some((d) => domainMatches(d, bareDomain))) {
+    if (normalized.citedDomains.some((d) => hostMatchesDomain(d, canonicalDomain))) {
       return "cited";
     }
-    const lowerDomain = bareDomain.toLowerCase();
     for (const source of normalized.groundingSources) {
-      try {
-        const uri = source.uri.toLowerCase();
-        if (lowerDomain.includes(".") && uri.includes(lowerDomain)) {
-          return "cited";
-        }
-      } catch {
-      }
-      if (source.title) {
-        const titleLower = source.title.toLowerCase().replace(/^www\./, "");
-        if (titleLower === lowerDomain || titleLower.endsWith(`.${lowerDomain}`)) {
-          return "cited";
-        }
-      }
+      if (hostMatchesDomain(source.uri, canonicalDomain)) return "cited";
+      if (source.title && hostMatchesDomain(source.title, canonicalDomain)) return "cited";
     }
   }
   return "not-cited";
@@ -44595,27 +44622,25 @@ function computeCompetitorOverlap(normalized, competitorDomains) {
   const overlapSet = /* @__PURE__ */ new Set();
   for (const d of normalized.citedDomains) {
     for (const cd of competitorDomains) {
-      if (domainMatches(d, cd)) {
+      if (hostMatchesDomain(d, cd)) {
         overlapSet.add(cd);
       }
     }
   }
   for (const source of normalized.groundingSources) {
-    const uri = source.uri.toLowerCase();
     for (const cd of competitorDomains) {
-      if (uri.includes(cd.toLowerCase())) {
+      if (hostMatchesDomain(source.uri, cd)) {
         overlapSet.add(cd);
       }
     }
   }
   if (normalized.answerText) {
-    const lowerAnswer = normalized.answerText.toLowerCase();
     for (const cd of competitorDomains) {
-      if (lowerAnswer.includes(cd.toLowerCase())) {
+      if (textContainsDomain(normalized.answerText, cd)) {
         overlapSet.add(cd);
       }
       const brand = brandLabelFromDomain(cd);
-      if (brand.length >= 4 && new RegExp(`\\b${escapeRegExp5(brand)}\\b`, "i").test(lowerAnswer)) {
+      if (brandKeyFromText(brand).length >= 4 && textContainsBrandAlias(normalized.answerText, brand)) {
         overlapSet.add(cd);
       }
     }
@@ -44626,27 +44651,24 @@ function computeCitedCompetitorDomains(citedDomains, competitorDomains) {
   const citedCompetitors = /* @__PURE__ */ new Set();
   for (const citedDomain of citedDomains) {
     for (const competitorDomain of competitorDomains) {
-      if (domainMatches(citedDomain, competitorDomain)) citedCompetitors.add(competitorDomain);
+      if (hostMatchesDomain(citedDomain, competitorDomain)) citedCompetitors.add(competitorDomain);
     }
   }
   return [...citedCompetitors];
 }
-function escapeRegExp5(value) {
-  return value.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
-}
 function extractRecommendedCompetitors(answerText, ownDomains, citedDomains, competitorDomains, ownBrandNames = []) {
   if (!answerText || answerText.length < 20) return [];
-  const ownBrandKeys = new Set(
-    ownDomains.flatMap((domain) => collectBrandKeysFromDomain(domain))
+  const ownBrandAliases = new Set(
+    ownDomains.flatMap((domain) => collectBrandAliasesFromDomain(domain))
   );
   for (const name of ownBrandNames) {
-    const key = brandKeyFromText(name);
-    if (key.length >= 4) ownBrandKeys.add(key);
+    if (brandKeyFromText(name).length >= 4) ownBrandAliases.add(name);
   }
-  const knownCompetitorKeys = new Set(
-    [...citedDomains, ...competitorDomains].flatMap((domain) => collectBrandKeysFromDomain(domain)).filter((key) => !ownBrandKeys.has(key))
+  const ownKeys = new Set([...ownBrandAliases].map(brandKeyFromText));
+  const knownCompetitorAliases = new Set(
+    [...citedDomains, ...competitorDomains].flatMap((domain) => collectBrandAliasesFromDomain(domain)).filter((alias) => !ownKeys.has(brandKeyFromText(alias)))
   );
-  if (knownCompetitorKeys.size === 0) return [];
+  if (knownCompetitorAliases.size === 0) return [];
   const candidatePatterns = [
     /^\s*(?:[-*]|\d+\.)\s+(?:\*\*)?([A-Z0-9][A-Za-z0-9][\w\s.&',/()-]{1,50}?)(?:\*\*)?\s*[:\u2014\u2013-]/gm,
     /\*\*([A-Z0-9][A-Za-z0-9][\w\s.&',/()-]{1,50})\*\*/g,
@@ -44696,8 +44718,8 @@ function extractRecommendedCompetitors(answerText, ownDomains, citedDomains, com
       if (!candidateKey) continue;
       if (genericKeys.has(candidateKey)) continue;
       if (candidate.split(/\s+/).length > 6) continue;
-      if (matchesBrandKey(candidateKey, ownBrandKeys)) continue;
-      if (!matchesBrandKey(candidateKey, knownCompetitorKeys)) continue;
+      if (matchesBrandAlias(candidate, ownBrandAliases)) continue;
+      if (!matchesBrandAlias(candidate, knownCompetitorAliases)) continue;
       if (!seen.has(candidateKey)) seen.set(candidateKey, candidate);
     }
   }
@@ -44706,27 +44728,17 @@ function extractRecommendedCompetitors(answerText, ownDomains, citedDomains, com
 function cleanCandidateName(candidate) {
   return candidate.replace(/^[\s"'`]+|[\s"'`.,:;!?]+$/g, "").replace(/\s+/g, " ").trim();
 }
-function collectBrandKeysFromDomain(domain) {
+function collectBrandAliasesFromDomain(domain) {
   const reg = registrableDomain(domain);
-  if (!reg) {
-    const hostname = normalizeProjectDomain(domain).split("/")[0] ?? "";
-    const fallback = hostname.replace(/[^a-z0-9]/gi, "").toLowerCase();
-    return fallback.length >= 4 ? [fallback] : [];
-  }
-  const keys = /* @__PURE__ */ new Set();
-  const fullKey = reg.replace(/[^a-z0-9]/gi, "").toLowerCase();
-  if (fullKey.length >= 4) keys.add(fullKey);
-  const brand = brandLabelFromDomain(reg).replace(/[^a-z0-9]/gi, "").toLowerCase();
-  if (brand.length >= 4) keys.add(brand);
-  return [...keys];
-}
-function matchesBrandKey(candidateKey, brandKeys) {
-  for (const brandKey of brandKeys) {
-    if (candidateKey === brandKey) return true;
-    if (candidateKey.startsWith(brandKey) || candidateKey.endsWith(brandKey)) return true;
-    if (brandKey.startsWith(candidateKey) || brandKey.endsWith(candidateKey)) return true;
-  }
-  return false;
+  if (!reg) return [];
+  const aliases = /* @__PURE__ */ new Set();
+  if (brandKeyFromText(reg).length >= 4) aliases.add(reg);
+  const brand = brandLabelFromDomain(reg);
+  if (brandKeyFromText(brand).length >= 4) aliases.add(brand);
+  return [...aliases];
+}
+function matchesBrandAlias(candidate, aliases) {
+  return [...aliases].some((alias) => textContainsBrandAlias(candidate, alias));
 }
 
 // src/intelligence-service.ts