npm - @ainyc/canonry - Versions diffs - 4.41.1 → 4.43.0 - Mend

@ainyc/canonry 4.41.1 → 4.43.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (11) hide show

package/README.md +1 -1
package/assets/assets/index-jvmhx0du.css +1 -0
package/assets/assets/{index-JiyuncvN.js → index-kRilKhIW.js} +57 -57
package/assets/index.html +2 -2
package/dist/{chunk-PQ2IKBT5.js → chunk-IXP4WGLQ.js} +50 -12
package/dist/{chunk-3I6Y2PSQ.js → chunk-MITJYCHG.js} +169 -87
package/dist/cli.js +2 -2
package/dist/index.js +2 -2
package/dist/{intelligence-service-FFCEIEOU.js → intelligence-service-HWWNLBZM.js} +1 -1
package/package.json +8 -8
package/assets/assets/index-Ca1Lty3H.css +0 -1

package/assets/index.html CHANGED Viewed

@@ -12,8 +12,8 @@
     <link rel="icon" type="image/png" sizes="32x32" href="./favicon-32.png" />
     <link rel="apple-touch-icon" href="./apple-touch-icon.png" />
     <title>Canonry</title>
-    <script type="module" crossorigin src="./assets/index-JiyuncvN.js"></script>
-    <link rel="stylesheet" crossorigin href="./assets/index-Ca1Lty3H.css">
+    <script type="module" crossorigin src="./assets/index-kRilKhIW.js"></script>
+    <link rel="stylesheet" crossorigin href="./assets/index-jvmhx0du.css">
   </head>
   <body>
     <div id="root"></div>

package/dist/{chunk-PQ2IKBT5.js → chunk-IXP4WGLQ.js} RENAMED Viewed

@@ -32,12 +32,13 @@ import {
   buildMentionCoverage,
   buildMentionGapScore,
   buildMentionLandscape,
+  buildMentionShare,
   buildMovementSummary,
   buildOverviewCompetitors,
   buildProviderScores,
   buildProviderTrends,
   buildRunHistory,
-  buildShareOfVoice,
+  buildSuggestedQueries,
   buildVisibilityScore,
   categorizeQueryByIntent,
   ccReleaseSyncs,
@@ -78,7 +79,7 @@ import {
   schedules,
   trafficSources,
   usageCounters
-} from "./chunk-3I6Y2PSQ.js";
+} from "./chunk-MITJYCHG.js";
 import {
   AGENT_MEMORY_VALUE_MAX_BYTES,
   AGENT_PROVIDER_IDS,
@@ -6428,7 +6429,7 @@ function buildReportActionPlan(input) {
       action: "Review the recurring external source domains and add the true competitors before the next check.",
       why: [
         "The report can identify repeated external sources, but it cannot separate competitors from publishers until competitors are configured.",
-        "A clean competitor set makes future share-of-voice and content-gap reporting easier to explain to clients."
+        "A clean competitor set makes future mention-share and content-gap reporting easier to explain to clients."
       ],
       evidence: topDomains.map((d) => `${d.domain} appeared in ${d.count} cited source${d.count === 1 ? "" : "s"}`),
       successMetric: "Next report separates tracked competitors from independent source domains in the competitor landscape.",
@@ -7239,17 +7240,23 @@ async function compositeRoutes(app) {
     const projectQueries = app.db.select({ id: queries.id, query: queries.query }).from(queries).where(eq15(queries.projectId, project.id)).all();
     const queryLookup = { byId: new Map(projectQueries.map((q) => [q.id, q.query])) };
     const configuredApiProviders = parseJsonColumn(project.providers, []).filter((p) => !p.startsWith("cdp:"));
-    const projectDomains = effectiveDomains({
-      canonicalDomain: project.canonicalDomain,
-      ownedDomains: parseJsonColumn(project.ownedDomains, [])
-    });
+    const mentionShareCompetitors = competitorRows.map((c) => ({
+      domain: c.domain,
+      // Single brand token derived from the registrable domain (e.g.
+      // "offers.roofle.com" → "roofle"). Future PR can layer operator-curated
+      // aliases on top via a `competitor_aliases` column.
+      brandTokens: [brandLabelFromDomain(c.domain)].filter((t) => t.length >= 3)
+    }));
     const scores = {
       mention: buildMentionCoverage(latestSnapshots, { configuredApiProviders }),
       visibility: buildVisibilityScore(latestSnapshots, { configuredApiProviders }),
-      shareOfVoice: buildShareOfVoice(latestSnapshots, {
-        projectDomains,
-        competitorDomains: competitorRows.map((c) => c.domain)
-      }),
+      mentionShare: buildMentionShare(
+        latestSnapshots.map((s) => ({
+          projectMentioned: s.answerMentioned === true,
+          answerText: s.answerText
+        })),
+        { competitors: mentionShareCompetitors }
+      ),
       gapQueries: buildGapQueryScore(latestSnapshots),
       mentionGaps: buildMentionGapScore(latestSnapshots),
       indexCoverage: buildIndexCoverageScore(app, project.id),
@@ -7281,6 +7288,11 @@ async function compositeRoutes(app) {
     const attentionItems = buildAttentionItems(insightRows, allRuns);
     const sparklineRuns = visibilityRuns.slice(0, DEFAULT_RUN_HISTORY_LIMIT).map((r) => ({ id: r.id, createdAt: r.createdAt, status: r.status }));
     const runHistory = buildRunHistory(sparklineRuns, snapshotsByRun);
+    const suggestedQueries = buildSuggestedQueriesFromGsc(
+      app,
+      project.id,
+      projectQueries.map((q) => q.query)
+    );
     const result = {
       project: formatProject2(project),
       latestRun,
@@ -7295,6 +7307,7 @@ async function compositeRoutes(app) {
       providerScores,
       attentionItems,
       runHistory,
+      suggestedQueries,
       dateRangeLabel: "All time",
       contextLabel: `${project.country} / ${project.language.toUpperCase()}`
     };
@@ -7412,6 +7425,7 @@ function loadSnapshotsByRunIds(app, runIds) {
     model: querySnapshots.model,
     citationState: querySnapshots.citationState,
     answerMentioned: querySnapshots.answerMentioned,
+    answerText: querySnapshots.answerText,
     competitorOverlap: querySnapshots.competitorOverlap,
     citedDomains: querySnapshots.citedDomains
   }).from(querySnapshots).where(inArray8(querySnapshots.runId, [...runIds])).all());
@@ -7423,6 +7437,7 @@ function loadSnapshotsByRunIds(app, runIds) {
       model: row.model,
       citationState: row.citationState,
       answerMentioned: row.answerMentioned,
+      answerText: row.answerText,
       competitorOverlap: parseJsonColumn(row.competitorOverlap, []),
       citedDomains: parseJsonColumn(row.citedDomains, [])
     });
@@ -7494,6 +7509,29 @@ function summarizeTransitionsFromSnapshots(latest, previous, since) {
   }
   return { since, gained, lost, emerging };
 }
+function buildSuggestedQueriesFromGsc(app, projectId, trackedQueries) {
+  const cutoff = new Date(Date.now() - 28 * 24 * 60 * 60 * 1e3).toISOString().slice(0, 10);
+  const rows = app.db.select({
+    query: gscSearchData.query,
+    impressions: sql6`COALESCE(SUM(${gscSearchData.impressions}), 0)`,
+    clicks: sql6`COALESCE(SUM(${gscSearchData.clicks}), 0)`,
+    // Weighted average: SUM(position * impressions) / SUM(impressions).
+    // NULLIF guards the degenerate impressions=0 case (SQLite returns NULL,
+    // which the JS coerces to 0 — caught by the impression floor anyway).
+    avgPosition: sql6`COALESCE(SUM(${gscSearchData.position} * ${gscSearchData.impressions}) * 1.0 / NULLIF(SUM(${gscSearchData.impressions}), 0), 0)`
+  }).from(gscSearchData).where(and7(
+    eq15(gscSearchData.projectId, projectId),
+    sql6`${gscSearchData.date} >= ${cutoff}`,
+    sql6`${gscSearchData.impressions} > 0`
+  )).groupBy(gscSearchData.query).orderBy(sql6`SUM(${gscSearchData.impressions}) DESC`).limit(100).all();
+  const gscRows = rows.map((r) => ({
+    query: r.query,
+    impressions: Number(r.impressions),
+    clicks: Number(r.clicks),
+    avgPosition: Number(r.avgPosition)
+  }));
+  return buildSuggestedQueries(gscRows, { trackedQueries });
+}
 function buildIndexCoverageScore(app, projectId) {
   const tooltip = "Percentage of inspected URLs currently indexed. Google Search Console is preferred when available, otherwise Bing Webmaster Tools is used.";
   const empty = {
@@ -26271,7 +26309,7 @@ function readStoredGroundingSources(rawResponse) {
   return result;
 }
 async function backfillInsightsCommand(project, opts) {
-  const { IntelligenceService: IntelligenceService2 } = await import("./intelligence-service-FFCEIEOU.js");
+  const { IntelligenceService: IntelligenceService2 } = await import("./intelligence-service-HWWNLBZM.js");
   const config = loadConfig();
   const db = createClient(config.database);
   migrate(db);

package/dist/{chunk-3I6Y2PSQ.js → chunk-MITJYCHG.js} RENAMED Viewed

@@ -3,6 +3,7 @@ import {
   ContentActions,
   RunKinds,
   __export,
+  brandKeyFromText,
   brandLabelFromDomain,
   categorizeSourceWithCompetitors,
   categoryLabel,
@@ -3589,92 +3590,6 @@ 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));
@@ -3712,6 +3627,172 @@ function collectProviderKeys(perRun) {
   return keys;
 }
+// ../intelligence/src/mention-share.ts
+function buildMentionShare(snapshots, options) {
+  const tooltip = 'When AI answers your tracked queries and names a brand, the % of brand-name-drops that are you vs your tracked competitors. Cleaner than Citation Coverage for "am I winning the conversation".';
+  const emptyBreakdown = {
+    projectMentionSnapshots: 0,
+    competitorMentionSnapshots: 0,
+    perCompetitor: [],
+    snapshotsWithAnswerText: 0,
+    snapshotsTotal: snapshots.length
+  };
+  if (snapshots.length === 0) {
+    return {
+      label: "Mention Share",
+      value: "No data",
+      delta: "Run a sweep first",
+      tone: "neutral",
+      description: "No mention share data yet. Trigger a run to start tracking.",
+      tooltip,
+      trend: [],
+      breakdown: emptyBreakdown
+    };
+  }
+  if (options.competitors.length === 0) {
+    return {
+      label: "Mention Share",
+      value: "Add competitors",
+      delta: "No competitors configured",
+      tone: "neutral",
+      description: "Mention Share is a head-to-head competitive metric \u2014 add tracked competitors to compare brand mention rates.",
+      tooltip,
+      trend: [],
+      breakdown: emptyBreakdown
+    };
+  }
+  let projectMentionSnapshots = 0;
+  let snapshotsWithAnswerText = 0;
+  const competitorCounts = /* @__PURE__ */ new Map();
+  for (const c of options.competitors) competitorCounts.set(c.domain, 0);
+  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)) {
+        competitorCounts.set(competitor.domain, (competitorCounts.get(competitor.domain) ?? 0) + 1);
+      }
+    }
+  }
+  const competitorMentionSnapshots = [...competitorCounts.values()].reduce((a, b) => a + b, 0);
+  const denom = projectMentionSnapshots + competitorMentionSnapshots;
+  const score = denom > 0 ? Math.round(projectMentionSnapshots / denom * 100) : 0;
+  const perCompetitor = options.competitors.map((c) => ({
+    domain: c.domain,
+    mentionSnapshots: competitorCounts.get(c.domain) ?? 0,
+    shareOfCompetitiveTotal: competitorMentionSnapshots > 0 ? Math.round((competitorCounts.get(c.domain) ?? 0) / competitorMentionSnapshots * 1e3) / 10 : 0
+  })).filter((row) => row.mentionSnapshots > 0).sort((a, b) => b.mentionSnapshots - a.mentionSnapshots);
+  const breakdown = {
+    projectMentionSnapshots,
+    competitorMentionSnapshots,
+    perCompetitor,
+    snapshotsWithAnswerText,
+    snapshotsTotal: snapshots.length
+  };
+  const description = describe({
+    score,
+    projectMentionSnapshots,
+    competitorMentionSnapshots,
+    perCompetitor
+  });
+  return {
+    label: "Mention Share",
+    value: denom > 0 ? `${score}` : "0",
+    delta: denom > 0 ? `${projectMentionSnapshots} of ${denom} brand mentions` : "No brand mentions in this run",
+    tone: denom > 0 ? mentionShareTone(score) : "neutral",
+    description,
+    tooltip,
+    trend: [],
+    progress: denom > 0 ? score : 0,
+    breakdown
+  };
+}
+function mentionShareTone(score) {
+  if (score >= 50) return "positive";
+  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) {
+    return "No brand mentions detected for you or your tracked competitors in this run.";
+  }
+  if (competitorMentionSnapshots === 0) {
+    return `${projectMentionSnapshots} brand mentions of you, zero competitor mentions \u2014 you own the conversation.`;
+  }
+  const top = perCompetitor[0];
+  if (!top) {
+    return `${score}% of brand mentions are you (${projectMentionSnapshots} of ${projectMentionSnapshots + competitorMentionSnapshots}).`;
+  }
+  return `${score}% of brand mentions are you. Top competitor: ${top.domain} (${top.mentionSnapshots} mentions).`;
+}
+// ../intelligence/src/suggested-queries.ts
+var DEFAULT_MIN_IMPRESSIONS = 10;
+var DEFAULT_LIMIT = 10;
+function buildSuggestedQueries(gscRows, options) {
+  const minImpressions = options.minImpressions ?? DEFAULT_MIN_IMPRESSIONS;
+  const limit = options.limit ?? DEFAULT_LIMIT;
+  const trackedSet = new Set(options.trackedQueries.map(normalizeQuery));
+  let skippedAlreadyTracked = 0;
+  const candidates = [];
+  for (const row of gscRows) {
+    if (row.impressions < minImpressions) continue;
+    const normalized = normalizeQuery(row.query);
+    if (normalized.length === 0) continue;
+    if (trackedSet.has(normalized)) {
+      skippedAlreadyTracked++;
+      continue;
+    }
+    candidates.push({
+      query: row.query,
+      impressions: row.impressions,
+      clicks: row.clicks,
+      avgPosition: row.avgPosition,
+      reason: buildReason(row)
+    });
+  }
+  candidates.sort((a, b) => b.impressions - a.impressions);
+  const rows = candidates.slice(0, limit);
+  return {
+    rows,
+    totalCandidates: candidates.length,
+    skippedAlreadyTracked
+  };
+}
+function normalizeQuery(value) {
+  return value.trim().toLowerCase();
+}
+function buildReason(row) {
+  const impressionsLabel = formatImpressions2(row.impressions);
+  if (row.avgPosition <= 10) {
+    return `${impressionsLabel} impressions \xB7 ranks #${Math.round(row.avgPosition)} on Google`;
+  }
+  if (row.avgPosition <= 20) {
+    return `${impressionsLabel} impressions \xB7 ranks #${Math.round(row.avgPosition)} \u2014 close to top 10`;
+  }
+  return `${impressionsLabel} impressions \xB7 ranks #${Math.round(row.avgPosition)}`;
+}
+function formatImpressions2(value) {
+  if (value >= 1e6) return `${(value / 1e6).toFixed(1)}M`;
+  if (value >= 1e4) return `${Math.round(value / 1e3)}K`;
+  if (value >= 1e3) return `${(value / 1e3).toFixed(1)}K`;
+  return value.toString();
+}
 // src/intelligence-service.ts
 import crypto from "crypto";
@@ -4238,9 +4319,10 @@ export {
   buildProviderScores,
   DEFAULT_RUN_HISTORY_LIMIT,
   buildRunHistory,
-  buildShareOfVoice,
   buildProviderTrends,
   providerKey,
+  buildMentionShare,
+  buildSuggestedQueries,
   createLogger,
   IntelligenceService
 };

package/dist/cli.js CHANGED Viewed

@@ -21,7 +21,7 @@ import {
   setTelemetrySource,
   showFirstRunNotice,
   trackEvent
-} from "./chunk-PQ2IKBT5.js";
+} from "./chunk-IXP4WGLQ.js";
 import {
   CliError,
   EXIT_SYSTEM_ERROR,
@@ -44,7 +44,7 @@ import {
   migrate,
   projects,
   queries
-} from "./chunk-3I6Y2PSQ.js";
+} from "./chunk-MITJYCHG.js";
 import {
   CcReleaseSyncStatuses,
   CheckScopes,

package/dist/index.js CHANGED Viewed

@@ -1,10 +1,10 @@
 import {
   createServer
-} from "./chunk-PQ2IKBT5.js";
+} from "./chunk-IXP4WGLQ.js";
 import {
   loadConfig
 } from "./chunk-JZ2VJW4U.js";
-import "./chunk-3I6Y2PSQ.js";
+import "./chunk-MITJYCHG.js";
 import "./chunk-Q7XFJO2V.js";
 export {
   createServer,

package/dist/{intelligence-service-FFCEIEOU.js → intelligence-service-HWWNLBZM.js} RENAMED Viewed

@@ -1,6 +1,6 @@
 import {
   IntelligenceService
-} from "./chunk-3I6Y2PSQ.js";
+} from "./chunk-MITJYCHG.js";
 import "./chunk-Q7XFJO2V.js";
 export {
   IntelligenceService

package/package.json CHANGED Viewed

@@ -1,6 +1,6 @@
 {
   "name": "@ainyc/canonry",
-  "version": "4.41.1",
+  "version": "4.43.0",
   "type": "module",
   "description": "Agent-first open-source AEO operating platform - track how answer engines cite your domain",
   "license": "FSL-1.1-ALv2",
@@ -61,22 +61,22 @@
     "tsup": "^8.5.1",
     "tsx": "^4.19.0",
     "@ainyc/canonry-api-routes": "0.0.0",
+    "@ainyc/canonry-contracts": "0.0.0",
+    "@ainyc/canonry-intelligence": "0.0.0",
     "@ainyc/canonry-config": "0.0.0",
     "@ainyc/canonry-db": "0.0.0",
-    "@ainyc/canonry-intelligence": "0.0.0",
-    "@ainyc/canonry-integration-bing": "0.0.0",
     "@ainyc/canonry-integration-cloud-run": "0.0.0",
-    "@ainyc/canonry-contracts": "0.0.0",
-    "@ainyc/canonry-integration-commoncrawl": "0.0.0",
+    "@ainyc/canonry-integration-bing": "0.0.0",
     "@ainyc/canonry-integration-google": "0.0.0",
     "@ainyc/canonry-integration-traffic": "0.0.0",
     "@ainyc/canonry-integration-wordpress": "0.0.0",
-    "@ainyc/canonry-provider-gemini": "0.0.0",
     "@ainyc/canonry-provider-cdp": "0.0.0",
     "@ainyc/canonry-provider-claude": "0.0.0",
-    "@ainyc/canonry-provider-openai": "0.0.0",
+    "@ainyc/canonry-provider-gemini": "0.0.0",
+    "@ainyc/canonry-integration-commoncrawl": "0.0.0",
+    "@ainyc/canonry-provider-perplexity": "0.0.0",
     "@ainyc/canonry-provider-local": "0.0.0",
-    "@ainyc/canonry-provider-perplexity": "0.0.0"
+    "@ainyc/canonry-provider-openai": "0.0.0"
   },
   "scripts": {
     "build": "tsx scripts/copy-agent-assets.ts && tsup && tsx build-web.ts",