@canonry/canonry 4.136.0 → 4.136.2

package/dist/{chunk-TPVMHYHD.js → chunk-YVMQWVNY.js}

@@ -238,13 +238,18 @@ import {
   gscCoverageSnapshotDtoSchema,
   gscCoverageSummaryDtoSchema,
   gscDeindexedRowSchema,
+  gscDiscoverSitemapsResponseDtoSchema,
   gscPerformanceDailyDtoSchema,
   gscSearchDataDtoSchema,
   gscSiteListResponseDtoSchema,
   gscSitemapListResponseDtoSchema,
+  gscSubmitSitemapsRequestDtoSchema,
+  gscSubmitSitemapsResponseDtoSchema,
   gscUrlInspectionDtoSchema,
   hasLocationLabel,
   healthSnapshotDtoSchema,
+  hostMatchesAnyDomain,
+  hostMatchesDomain,
   hostOf,
   indexingRequestResponseDtoSchema,
   internalError,
@@ -333,6 +338,9 @@ import {
   summarizeCheckResults,
   surfaceClassFromCompetitorType,
   surfaceClassLabel,
+  textContainsAnyBrandAlias,
+  textContainsBrandAlias,
+  textContainsDomain,
   trafficBackfillResponseSchema,
   trafficConnectVercelRequestSchema,
   trafficConnectWordpressRequestSchema,
@@ -365,7 +373,7 @@ import {
   wordpressSchemaDeployResultDtoSchema,
   wordpressSchemaStatusResultDtoSchema,
   wordpressStatusDtoSchema
-} from "./chunk-PXEEWJRV.js";
+} from "./chunk-GGIRLRAY.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";
@@ -5463,24 +5471,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";
@@ -5548,12 +5551,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
@@ -5575,11 +5573,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);
@@ -5613,16 +5608,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) {
@@ -6040,10 +6025,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++;
     }
   }
@@ -6068,7 +6052,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);
       }
     }
@@ -6215,15 +6199,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);
       }
     }
@@ -6266,16 +6257,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) {
@@ -9776,14 +9757,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, {});
@@ -10215,12 +10189,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] ?? "";
@@ -10261,7 +10235,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 [];
@@ -10480,21 +10454,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);
     }
   }
@@ -10516,6 +10491,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) {
@@ -10568,16 +10546,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();
@@ -14940,10 +14908,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;
@@ -15013,10 +14978,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 !== "/") {
@@ -15273,11 +15238,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);
 };
@@ -15357,7 +15318,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({
@@ -15810,7 +15773,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,
@@ -15884,18 +15847,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,
@@ -15937,9 +15901,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";
@@ -15949,9 +15910,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) {
@@ -16032,7 +15990,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;
       }
     }
   }
@@ -17487,7 +17445,9 @@ var SCHEMA_TABLE = {
   GscDeindexedRowDto: gscDeindexedRowSchema,
   GscPerformanceDailyDto: gscPerformanceDailyDtoSchema,
   GscSearchDataDto: gscSearchDataDtoSchema,
+  GscDiscoverSitemapsResponseDto: gscDiscoverSitemapsResponseDtoSchema,
   GscSiteListResponseDto: gscSiteListResponseDtoSchema,
+  GscSubmitSitemapsResponseDto: gscSubmitSitemapsResponseDtoSchema,
   GscSitemapListResponseDto: gscSitemapListResponseDtoSchema,
   GscUrlInspectionDto: gscUrlInspectionDtoSchema,
   HealthSnapshotDto: healthSnapshotDtoSchema,
@@ -17910,6 +17870,34 @@ var routeCatalog = [
       200: rawJsonResponse("OpenAPI document.", looseObjectSchema)
     }
   },
+  {
+    method: "post",
+    path: "/api/v1/projects/{name}/google/gsc/sitemaps/submit",
+    summary: "Submit GSC sitemaps",
+    description: "Submits sitemap URLs to Google Search Console sequentially. An accepted result means Google accepted the submit/refetch request; it does not indicate indexing.",
+    tags: ["google"],
+    parameters: [nameParameter],
+    requestBody: {
+      required: true,
+      content: {
+        "application/json": {
+          schema: {
+            type: "object",
+            required: ["sitemapUrls"],
+            additionalProperties: false,
+            properties: {
+              sitemapUrls: { type: "array", minItems: 1, maxItems: 50, items: { type: "string", format: "uri", pattern: "^https?://" } }
+            }
+          }
+        }
+      }
+    },
+    responses: {
+      200: jsonResponse("Per-sitemap submission results returned.", "GscSubmitSitemapsResponseDto"),
+      400: errorResponse("Invalid sitemap request, property ownership, or OAuth scope."),
+      404: errorResponse("Project or connection not found.")
+    }
+  },
   {
     method: "put",
     path: "/api/v1/projects/{name}",
@@ -19487,7 +19475,15 @@ var routeCatalog = [
     path: "/api/v1/projects/{name}/google/gsc/sitemaps",
     summary: "List GSC sitemaps",
     tags: ["google"],
-    parameters: [nameParameter],
+    parameters: [
+      nameParameter,
+      {
+        name: "sitemapIndex",
+        in: "query",
+        description: "Optional owned sitemap-index URL. When present, returns that index's child entries.",
+        schema: { type: "string", format: "uri", pattern: "^https?://" }
+      }
+    ],
     responses: {
       200: jsonResponse("GSC sitemaps returned.", "GscSitemapListResponseDto"),
       400: errorResponse("Invalid sitemap request."),
@@ -19501,8 +19497,7 @@ var routeCatalog = [
     tags: ["google"],
     parameters: [nameParameter],
     responses: {
-      // TODO: Add `DiscoverSitemapsResponse` Zod schema in contracts.
-      200: rawJsonResponse("Discovered sitemaps and queued run returned.", looseObjectSchema),
+      200: jsonResponse("Discovered sitemaps and queued run returned.", "GscDiscoverSitemapsResponseDto"),
       400: errorResponse("Invalid sitemap discovery request."),
       404: errorResponse("Project or connection not found.")
     }
@@ -23230,7 +23225,8 @@ function buildGbpSummary(input) {
 // ../integration-google/src/constants.ts
 var GOOGLE_AUTH_URL = "https://accounts.google.com/o/oauth2/v2/auth";
 var GOOGLE_TOKEN_URL = "https://oauth2.googleapis.com/token";
-var GSC_SCOPE = "https://www.googleapis.com/auth/webmasters.readonly";
+var GSC_SCOPE = "https://www.googleapis.com/auth/webmasters";
+var GSC_READONLY_SCOPE = "https://www.googleapis.com/auth/webmasters.readonly";
 var INDEXING_SCOPE = "https://www.googleapis.com/auth/indexing";
 var GSC_API_BASE = "https://www.googleapis.com/webmasters/v3";
 var URL_INSPECTION_API = "https://searchconsole.googleapis.com/v1/urlInspection/index:inspect";
@@ -23480,7 +23476,7 @@ function gscClientLog(level, action, ctx) {
   const stream = level === "error" ? process.stderr : process.stdout;
   stream.write(JSON.stringify(entry) + "\n");
 }
-async function gscFetch(accessToken, url, opts) {
+async function gscFetchResponse(accessToken, url, opts) {
   const method = opts?.method ?? "GET";
   const headers = {
     Authorization: `Bearer ${accessToken}`,
@@ -23506,26 +23502,50 @@ async function gscFetch(accessToken, url, opts) {
     const detail = body.length <= 500 ? body : `${body.slice(0, 500)}... [truncated]`;
     throw new GoogleApiError(`GSC API error (${res.status}): ${detail}`, res.status);
   }
-  return await res.json();
+  return res;
+}
+async function gscFetchJson(accessToken, url, opts) {
+  const res = await gscFetchResponse(accessToken, url, opts);
+  const text2 = await res.text();
+  if (!text2) {
+    throw new GoogleApiError("GSC API returned an empty response where JSON was expected", res.status);
+  }
+  try {
+    return JSON.parse(text2);
+  } catch {
+    throw new GoogleApiError("GSC API returned invalid JSON", res.status);
+  }
 }
 async function listSites(accessToken) {
   validateAccessToken(accessToken);
-  const data = await gscFetch(
+  const data = await gscFetchJson(
     accessToken,
     `${GSC_API_BASE}/sites`
   );
   return data.siteEntry ?? [];
 }
-async function listSitemaps(accessToken, siteUrl) {
+async function listSitemaps(accessToken, siteUrl, sitemapIndex) {
   validateAccessToken(accessToken);
   validateSiteUrl(siteUrl);
+  if (sitemapIndex != null) validateUrl(sitemapIndex);
   const encodedSiteUrl = encodeURIComponent(siteUrl);
-  const data = await gscFetch(
+  const sitemapIndexQuery = sitemapIndex == null ? "" : `?sitemapIndex=${encodeURIComponent(sitemapIndex)}`;
+  const data = await gscFetchJson(
     accessToken,
-    `${GSC_API_BASE}/sites/${encodedSiteUrl}/sitemaps`
+    `${GSC_API_BASE}/sites/${encodedSiteUrl}/sitemaps${sitemapIndexQuery}`
   );
   return data.sitemap ?? [];
 }
+async function submitSitemap(accessToken, siteUrl, sitemapUrl) {
+  validateAccessToken(accessToken);
+  validateSiteUrl(siteUrl);
+  validateUrl(sitemapUrl);
+  await gscFetchResponse(
+    accessToken,
+    `${GSC_API_BASE}/sites/${encodeURIComponent(siteUrl)}/sitemaps/${encodeURIComponent(sitemapUrl)}`,
+    { method: "PUT" }
+  );
+}
 async function fetchSearchAnalytics(accessToken, siteUrl, opts) {
   validateAccessToken(accessToken);
   validateSiteUrl(siteUrl);
@@ -23555,7 +23575,7 @@ async function fetchSearchAnalytics(accessToken, siteUrl, opts) {
       requestBody.dimensionFilterGroups = filters;
     }
     const encodedSiteUrl = encodeURIComponent(siteUrl);
-    const data = await gscFetch(
+    const data = await gscFetchJson(
       accessToken,
       `${GSC_API_BASE}/sites/${encodedSiteUrl}/searchAnalytics/query`,
       { method: "POST", body: requestBody }
@@ -23572,7 +23592,7 @@ async function fetchSearchAnalytics(accessToken, siteUrl, opts) {
 async function publishUrlNotification(accessToken, url, type = "URL_UPDATED") {
   validateAccessToken(accessToken);
   validateUrl(url);
-  return gscFetch(
+  return gscFetchJson(
     accessToken,
     `${INDEXING_API_BASE}/urlNotifications:publish`,
     {
@@ -23585,7 +23605,7 @@ async function inspectUrl(accessToken, inspectionUrl, siteUrl) {
   validateAccessToken(accessToken);
   validateUrl(inspectionUrl);
   validateSiteUrl(siteUrl);
-  return gscFetch(
+  return gscFetchJson(
     accessToken,
     URL_INSPECTION_API,
     {
@@ -24779,11 +24799,9 @@ function stableStringify3(value) {
 
 // ../api-routes/src/google.ts
 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) {
@@ -24795,6 +24813,31 @@ function scopesForConnectionType(type) {
       return [GBP_SCOPE];
   }
 }
+function isSitemapOwnedByProperty(sitemapUrl, propertyId, canonicalDomain) {
+  let sitemap;
+  try {
+    sitemap = new URL(sitemapUrl);
+  } catch {
+    return false;
+  }
+  if (sitemap.protocol !== "http:" && sitemap.protocol !== "https:") return false;
+  if (/^sc-domain:/i.test(propertyId)) {
+    const domain = propertyId.slice("sc-domain:".length).toLowerCase();
+    return hostMatchesDomain(sitemap.hostname, domain);
+  }
+  if (/^\d+$/.test(propertyId)) {
+    return hostOf(sitemap.hostname) === hostOf(canonicalDomain);
+  }
+  try {
+    const property = new URL(propertyId);
+    if (property.protocol !== "http:" && property.protocol !== "https:") return false;
+    if (sitemap.origin !== property.origin) return false;
+    const prefix = property.pathname.endsWith("/") ? property.pathname : `${property.pathname}/`;
+    return sitemap.pathname === property.pathname || sitemap.pathname.startsWith(prefix);
+  } catch {
+    return false;
+  }
+}
 function signState(payload, secret) {
   return crypto19.createHmac("sha256", secret).update(payload).digest("hex");
 }
@@ -25454,17 +25497,83 @@ async function googleRoutes(app, opts) {
     }
     const store = requireConnectionStore();
     const project = resolveProject(app.db, request.params.name);
+    const conn = store.getConnection(project.canonicalDomain, "gsc");
+    if (!conn?.propertyId) {
+      throw validationError('No GSC property configured for this connection. Set one with "canonry google set-property".');
+    }
+    const sitemapIndex = request.query.sitemapIndex;
+    if (sitemapIndex && !isSitemapOwnedByProperty(sitemapIndex, conn.propertyId, project.canonicalDomain)) {
+      throw validationError(`sitemapIndex must belong to the configured GSC property "${conn.propertyId}".`);
+    }
     try {
       const { accessToken, propertyId } = await getValidToken(store, project.canonicalDomain, "gsc", googleClientId, googleClientSecret);
       if (!propertyId) {
         throw validationError('No GSC property configured for this connection. Set one with "canonry google set-property".');
       }
-      const sitemaps = await listSitemaps(accessToken, propertyId);
-      return { sitemaps };
+      const entries = await listSitemaps(accessToken, propertyId, sitemapIndex);
+      const sitemaps = sitemapIndex ? entries.map((sitemap) => ({ ...sitemap, parentSitemapUrl: sitemapIndex })) : entries;
+      const indexes = sitemaps.filter((sitemap) => sitemap.isSitemapsIndex).length;
+      return {
+        sitemaps,
+        summary: { total: sitemaps.length, indexes, files: sitemaps.length - indexes },
+        preferredSubmissionUrls: indexes > 0 ? sitemaps.filter((sitemap) => sitemap.isSitemapsIndex).map((sitemap) => sitemap.path) : sitemaps.map((sitemap) => sitemap.path)
+      };
     } catch (err) {
       throw gscErrorToAppError(err, "Failed to list Search Console sitemaps");
     }
   });
+  app.post("/projects/:name/google/gsc/sitemaps/submit", async (request) => {
+    const parsed = gscSubmitSitemapsRequestDtoSchema.safeParse(request.body ?? {});
+    if (!parsed.success) {
+      throw validationError("sitemapUrls must contain between 1 and 50 valid sitemap URLs");
+    }
+    const sitemapUrls = [...new Set(parsed.data.sitemapUrls)];
+    const project = resolveProject(app.db, request.params.name);
+    const store = requireConnectionStore();
+    const conn = store.getConnection(project.canonicalDomain, "gsc");
+    if (!conn) {
+      throw validationError('No GSC connection found for this domain. Run "canonry google connect" first.');
+    }
+    if (!conn.propertyId) {
+      throw validationError('No GSC property configured for this connection. Set one with "canonry google set-property".');
+    }
+    const invalidUrls = sitemapUrls.filter((url) => !isSitemapOwnedByProperty(url, conn.propertyId, project.canonicalDomain));
+    if (invalidUrls.length > 0) {
+      throw validationError(`Sitemap URLs must belong to the configured GSC property "${conn.propertyId}". Invalid: ${invalidUrls.slice(0, 5).join(", ")}`);
+    }
+    if (!(conn.scopes ?? []).includes(GSC_SCOPE)) {
+      throw validationError('This GSC connection has the read-only webmasters scope and cannot submit sitemaps. Reconnect with "canonry google connect" to grant the full webmasters scope.');
+    }
+    const { clientId: googleClientId, clientSecret: googleClientSecret } = getAuthConfig();
+    if (!googleClientId || !googleClientSecret) {
+      throw validationError("Google OAuth is not configured");
+    }
+    let accessToken;
+    try {
+      ({ accessToken } = await getValidToken(store, project.canonicalDomain, "gsc", googleClientId, googleClientSecret));
+    } catch (err) {
+      throw gscErrorToAppError(err, "Failed to authorize Search Console sitemap submission");
+    }
+    const results = [];
+    for (const sitemapUrl of sitemapUrls) {
+      try {
+        await submitSitemap(accessToken, conn.propertyId, sitemapUrl);
+        const submittedAt = (/* @__PURE__ */ new Date()).toISOString();
+        writeAuditLog(app.db, {
+          projectId: project.id,
+          actor: "api",
+          action: "google.sitemap.submitted",
+          entityType: "sitemap",
+          entityId: sitemapUrl
+        });
+        results.push({ sitemapUrl, status: "accepted", submittedAt });
+      } catch (err) {
+        results.push({ sitemapUrl, status: "error", error: err instanceof Error ? err.message : String(err) });
+      }
+    }
+    const accepted = results.filter((result) => result.status === "accepted").length;
+    return { summary: { total: results.length, accepted, failed: results.length - accepted }, results };
+  });
   app.post("/projects/:name/google/gsc/discover-sitemaps", async (request) => {
     const { clientId: googleClientId, clientSecret: googleClientSecret } = getAuthConfig();
     if (!googleClientId || !googleClientSecret) {
@@ -25487,9 +25596,11 @@ async function googleRoutes(app, opts) {
       throw gscErrorToAppError(err, "Failed to discover Search Console sitemaps");
     }
     if (sitemaps.length === 0) {
-      throw validationError("No sitemaps found for this GSC property. Submit a sitemap in Google Search Console first.");
+      throw validationError(
+        `No sitemaps found for this GSC property. Submit one with "canonry google submit-sitemap ${request.params.name} <url>" first.`
+      );
     }
-    const primary = sitemaps.find((s) => !s.isSitemapsIndex) ?? sitemaps[0];
+    const primary = sitemaps.find((s) => s.isSitemapsIndex) ?? sitemaps[0];
     const sitemapUrl = primary.path;
     store.updateConnection(project.canonicalDomain, "gsc", {
       sitemapUrl,
@@ -38276,9 +38387,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;
@@ -38287,12 +38396,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;
@@ -38462,13 +38566,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) {
@@ -42064,7 +42164,6 @@ var PLACES_CHECK_BY_ID = Object.fromEntries(
 );
 
 // ../api-routes/src/doctor/checks/google-auth.ts
-var REQUIRED_GSC_SCOPES = [GSC_SCOPE, INDEXING_SCOPE];
 async function resolveAccessToken(ctx) {
   if (!ctx.project) {
     return { ok: false, output: skippedNoProject4() };
@@ -42339,8 +42438,19 @@ var scopesCheck2 = {
       };
     }
     const granted = new Set(conn.scopes ?? []);
-    const missing = REQUIRED_GSC_SCOPES.filter((scope) => !granted.has(scope));
-    if (missing.length === 0) {
+    const hasFullGscScope = granted.has(GSC_SCOPE);
+    const hasReadOnlyGscScope = granted.has(GSC_READONLY_SCOPE);
+    const hasIndexingScope = granted.has(INDEXING_SCOPE);
+    if (!hasFullGscScope && !hasReadOnlyGscScope) {
+      return {
+        status: CheckStatuses.fail,
+        code: "google.auth.required-scope-missing",
+        summary: "Neither the full nor read-only Search Console scope is granted, so GSC reads will fail.",
+        remediation: `Reconnect to grant a Search Console scope: \`canonry google connect ${ctx.project.name} --type gsc\`.`,
+        details: { granted: [...granted], missing: [GSC_SCOPE, GSC_READONLY_SCOPE] }
+      };
+    }
+    if (hasFullGscScope && hasIndexingScope) {
       return {
         status: CheckStatuses.ok,
         code: "google.auth.scopes-ok",
@@ -42349,14 +42459,22 @@ var scopesCheck2 = {
         details: { granted: [...granted] }
       };
     }
-    const gscMissing = missing.includes(GSC_SCOPE);
-    const indexingOnlyMissing = !gscMissing && missing.includes(INDEXING_SCOPE) && missing.length === 1;
+    if (!hasFullGscScope) {
+      const missing = [GSC_SCOPE, ...hasIndexingScope ? [] : [INDEXING_SCOPE]];
+      return {
+        status: CheckStatuses.warn,
+        code: "google.auth.sitemap-write-scope-missing",
+        summary: hasIndexingScope ? "The read-only Search Console scope supports existing GSC reads, but sitemap submission is unavailable." : "The read-only Search Console scope supports existing GSC reads, but sitemap submission and the Indexing API are unavailable.",
+        remediation: `Reconnect to grant the full Search Console webmasters scope: \`canonry google connect ${ctx.project.name} --type gsc\`.`,
+        details: { granted: [...granted], missing }
+      };
+    }
     return {
-      status: indexingOnlyMissing ? CheckStatuses.warn : CheckStatuses.fail,
-      code: indexingOnlyMissing ? "google.auth.indexing-scope-missing" : "google.auth.required-scope-missing",
-      summary: indexingOnlyMissing ? "Indexing API scope is not granted \u2014 `canonry google request-indexing` will fail." : `Missing required scopes: ${missing.join(", ")}.`,
+      status: CheckStatuses.warn,
+      code: "google.auth.indexing-scope-missing",
+      summary: "Indexing API scope is not granted \u2014 `canonry google request-indexing` will fail.",
       remediation: `Reconnect to grant missing scopes: \`canonry google connect ${ctx.project.name} --type gsc\`.`,
-      details: { granted: [...granted], missing }
+      details: { granted: [...granted], missing: [INDEXING_SCOPE] }
     };
   }
 };
@@ -43710,7 +43828,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(),
@@ -44377,38 +44495,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";
@@ -44417,27 +44517,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);
       }
     }
@@ -44448,27 +44546,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,
@@ -44518,8 +44613,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);
     }
   }
@@ -44528,27 +44623,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