@ainyc/canonry 4.36.0 → 4.40.0

package/dist/{chunk-JQQXMCQ7.js → chunk-EWYUJ2DG.js}

@@ -3256,24 +3256,51 @@ function buildAiSourceOrigin(snapshots, projectDomains, competitorDomains, topDo
 }
 
 // ../intelligence/src/movement-summary.ts
-function buildMovementSummary(currentSnapshots, previousSnapshots) {
+function buildMovementSummary(currentSnapshots, previousSnapshots, options = {}) {
   if (previousSnapshots.length === 0) {
-    const citedCount = collectCitedQueryIds(currentSnapshots).size;
+    const citedIds = collectCitedQueryIds(currentSnapshots);
+    const citedCount = citedIds.size;
     const tone2 = citedCount > 0 ? "positive" : "neutral";
-    return { gained: citedCount, lost: 0, tone: tone2, hasPreviousRun: false };
+    return withQueryLists(
+      { gained: citedCount, lost: 0, tone: tone2, hasPreviousRun: false },
+      citedIds,
+      /* @__PURE__ */ new Set(),
+      options.queryLookup
+    );
   }
   const latestCited = collectCitedQueryIds(currentSnapshots);
   const previousCited = collectCitedQueryIds(previousSnapshots);
-  let gained = 0;
-  let lost = 0;
+  const gainedIds = /* @__PURE__ */ new Set();
+  const lostIds = /* @__PURE__ */ new Set();
   for (const id of latestCited) {
-    if (!previousCited.has(id)) gained++;
+    if (!previousCited.has(id)) gainedIds.add(id);
   }
   for (const id of previousCited) {
-    if (!latestCited.has(id)) lost++;
+    if (!latestCited.has(id)) lostIds.add(id);
   }
-  const tone = lost > gained ? "negative" : gained > lost ? "positive" : "neutral";
-  return { gained, lost, tone, hasPreviousRun: true };
+  const tone = lostIds.size > gainedIds.size ? "negative" : gainedIds.size > lostIds.size ? "positive" : "neutral";
+  return withQueryLists(
+    { gained: gainedIds.size, lost: lostIds.size, tone, hasPreviousRun: true },
+    gainedIds,
+    lostIds,
+    options.queryLookup
+  );
+}
+function withQueryLists(base, gainedIds, lostIds, lookup) {
+  if (!lookup) return base;
+  return {
+    ...base,
+    gainedQueries: resolveQueryTexts(gainedIds, lookup),
+    lostQueries: resolveQueryTexts(lostIds, lookup)
+  };
+}
+function resolveQueryTexts(ids, lookup) {
+  const out = [];
+  for (const id of ids) {
+    const text2 = lookup.get(id);
+    if (text2) out.push(text2);
+  }
+  return out.sort();
 }
 function collectCitedQueryIds(snapshots) {
   const cited = /* @__PURE__ */ new Set();
@@ -3405,11 +3432,48 @@ function buildGapQueryScore(snapshots) {
   ).length;
   const gapQueryLabel = gapCount === 1 ? "query" : "queries";
   return {
-    label: "Gap Queries",
+    label: "Citation Gaps",
     value: `${gapCount}`,
     delta: `${gapCount} of ${totalCount} queries at risk`,
     tone: gapTone(gapCount, totalCount),
-    description: gapCount > 0 ? `${gapCount} tracked ${gapQueryLabel} currently cite competitors without citing your domain.` : "No competitive query gaps detected in the latest visibility run.",
+    description: gapCount > 0 ? `${gapCount} tracked ${gapQueryLabel} currently cite competitors without citing your domain.` : "No competitive citation gaps detected in the latest visibility run.",
+    tooltip,
+    trend: [],
+    progress: totalCount > 0 ? Math.round(gapCount / totalCount * 100) : 0
+  };
+}
+function buildMentionGapScore(snapshots) {
+  const tooltip = "Tracked queries where a competitor surfaces in the latest run but your brand / domain is not mentioned in the answer text.";
+  if (snapshots.length === 0) {
+    return {
+      label: "Mention Gaps",
+      value: "No data",
+      delta: "Run a sweep first",
+      tone: "neutral",
+      description: "Run a visibility sweep to identify queries where competitors are mentioned and your brand is not.",
+      tooltip,
+      trend: []
+    };
+  }
+  const byQuery = /* @__PURE__ */ new Map();
+  for (const snap of snapshots) {
+    const key = snap.queryId;
+    const current = byQuery.get(key) ?? { mentioned: false, competitorOverlap: /* @__PURE__ */ new Set() };
+    if (snap.answerMentioned === true) current.mentioned = true;
+    for (const domain of snap.competitorOverlap) current.competitorOverlap.add(domain);
+    byQuery.set(key, current);
+  }
+  const totalCount = byQuery.size;
+  const gapCount = [...byQuery.values()].filter(
+    (entry) => !entry.mentioned && entry.competitorOverlap.size > 0
+  ).length;
+  const gapQueryLabel = gapCount === 1 ? "query" : "queries";
+  return {
+    label: "Mention Gaps",
+    value: `${gapCount}`,
+    delta: `${gapCount} of ${totalCount} queries at risk`,
+    tone: gapTone(gapCount, totalCount),
+    description: gapCount > 0 ? `${gapCount} tracked ${gapQueryLabel} mention competitors but never your brand.` : "No competitive mention gaps detected in the latest visibility run.",
     tooltip,
     trend: [],
     progress: totalCount > 0 ? Math.round(gapCount / totalCount * 100) : 0
@@ -3525,6 +3589,129 @@ function buildRunHistory(runs2, snapshotsByRunId, limit = DEFAULT_RUN_HISTORY_LI
   });
 }
 
+// ../intelligence/src/share-of-voice.ts
+function sovTone(score) {
+  if (score >= 30) return "positive";
+  if (score >= 10) return "caution";
+  return "negative";
+}
+function buildShareOfVoice(snapshots, options) {
+  const tooltip = "Your domain's share of every distinct cited-source slot across the latest run. Subdomain-aware (cited docs.you.com counts for you.com). Distinct from Citation Coverage \u2014 SoV measures how much of the answer real-estate you own, not just whether you appear.";
+  if (snapshots.length === 0) {
+    return {
+      label: "Share of Voice",
+      value: "No data",
+      delta: "Run a sweep first",
+      tone: "neutral",
+      description: "No SoV data yet. Trigger a run to start tracking.",
+      tooltip,
+      trend: []
+    };
+  }
+  const breakdown = computeShareOfVoiceBreakdown(snapshots, options);
+  if (breakdown.totalSlots === 0) {
+    return {
+      label: "Share of Voice",
+      value: "0",
+      delta: "No citations in this run",
+      tone: "neutral",
+      description: "The latest run produced no source-list citations across any provider, so SoV cannot be measured. (Mention Coverage may still be non-zero \u2014 answers can mention you without grounding to a URL.)",
+      tooltip,
+      trend: [],
+      progress: 0
+    };
+  }
+  const { projectSlots, competitorSlots, otherSlots, totalSlots } = breakdown;
+  const score = Math.round(projectSlots / totalSlots * 100);
+  const competitorShare = Math.round(competitorSlots / totalSlots * 100);
+  const otherShare = Math.max(0, 100 - score - competitorShare);
+  const hasCompetitorsConfigured = options.competitorDomains.length > 0;
+  const description = describeBreakdown({
+    projectSlots,
+    competitorSlots,
+    otherSlots,
+    totalSlots,
+    score,
+    competitorShare,
+    otherShare,
+    hasCompetitorsConfigured
+  });
+  return {
+    label: "Share of Voice",
+    value: `${score}`,
+    delta: `${projectSlots} of ${totalSlots} cited slots`,
+    tone: sovTone(score),
+    description,
+    tooltip,
+    trend: [],
+    progress: score
+  };
+}
+function computeShareOfVoiceBreakdown(snapshots, options) {
+  let totalSlots = 0;
+  let projectSlots = 0;
+  let competitorSlots = 0;
+  for (const snap of snapshots) {
+    for (const domain of snap.citedDomains) {
+      totalSlots++;
+      if (citedDomainBelongsToProject(domain, options.projectDomains)) {
+        projectSlots++;
+      } else if (citedDomainBelongsToProject(domain, options.competitorDomains)) {
+        competitorSlots++;
+      }
+    }
+  }
+  const otherSlots = totalSlots - projectSlots - competitorSlots;
+  return { projectSlots, competitorSlots, otherSlots, totalSlots };
+}
+function describeBreakdown(parts) {
+  const { projectSlots, competitorSlots, totalSlots, score, competitorShare, otherShare, hasCompetitorsConfigured } = parts;
+  if (!hasCompetitorsConfigured) {
+    return `${projectSlots} of ${totalSlots} cited slots were yours (${score}%). Add tracked competitors to break out the rest.`;
+  }
+  if (competitorSlots === 0) {
+    return `${projectSlots} of ${totalSlots} cited slots were yours (${score}%); no tracked competitors surfaced in the run. The remaining ${otherShare}% goes to unrelated sources.`;
+  }
+  return `You own ${score}% of cited slots; tracked competitors hold ${competitorShare}%; the remaining ${otherShare}% goes to non-competitive sources.`;
+}
+
+// ../intelligence/src/provider-trends.ts
+function buildProviderTrends(runs2, snapshotsByRunId, limit = 12) {
+  const recent = [...runs2].sort((a, b) => b.createdAt.localeCompare(a.createdAt)).slice(0, limit).sort((a, b) => a.createdAt.localeCompare(b.createdAt));
+  const keys = collectProviderKeys(snapshotsByRunId.values());
+  const result = /* @__PURE__ */ new Map();
+  for (const key of keys) result.set(key, []);
+  for (const run of recent) {
+    const snaps = snapshotsByRunId.get(run.id) ?? [];
+    const perKey = /* @__PURE__ */ new Map();
+    for (const snap of snaps) {
+      const key = providerKey(snap.provider, snap.model);
+      const queryMap = perKey.get(key) ?? /* @__PURE__ */ new Map();
+      if (!queryMap.has(snap.queryId)) queryMap.set(snap.queryId, false);
+      if (snap.citationState === CitationStates.cited) queryMap.set(snap.queryId, true);
+      perKey.set(key, queryMap);
+    }
+    for (const key of keys) {
+      const queryMap = perKey.get(key);
+      const rate = queryMap && queryMap.size > 0 ? Math.round([...queryMap.values()].filter(Boolean).length / queryMap.size * 100) : 0;
+      result.get(key).push({ rate, createdAt: run.createdAt });
+    }
+  }
+  return result;
+}
+function providerKey(provider, model) {
+  return `${provider}::${model ?? "unknown"}`;
+}
+function collectProviderKeys(perRun) {
+  const keys = /* @__PURE__ */ new Set();
+  for (const snaps of perRun) {
+    for (const snap of snaps) {
+      keys.add(providerKey(snap.provider, snap.model));
+    }
+  }
+  return keys;
+}
+
 // src/intelligence-service.ts
 import crypto from "crypto";
 
@@ -4045,11 +4232,15 @@ export {
   buildVisibilityScore,
   buildMentionCoverage,
   buildGapQueryScore,
+  buildMentionGapScore,
   buildCompetitorPressureScore,
   buildOverviewCompetitors,
   buildProviderScores,
   DEFAULT_RUN_HISTORY_LIMIT,
   buildRunHistory,
+  buildShareOfVoice,
+  buildProviderTrends,
+  providerKey,
   createLogger,
   IntelligenceService
 };