@ainyc/canonry 4.99.0 → 4.99.1

package/dist/{chunk-VQN74WWA.js → chunk-IDI6LMYL.js}

@@ -24,7 +24,7 @@ import {
   trafficConnectVercelRequestSchema,
   trafficConnectWordpressRequestSchema,
   trafficEventKindSchema
-} from "./chunk-CWFTMFEU.js";
+} from "./chunk-JF7EXHGA.js";
 
 // src/config.ts
 import fs from "fs";

package/dist/{chunk-CWFTMFEU.js → chunk-JF7EXHGA.js}

@@ -3998,12 +3998,15 @@ var citationScorecardSchema = z28.object({
   providers: z28.array(z28.string()),
   /** matrix[queryIndex][providerIndex] — null when no snapshot exists for the pair. */
   matrix: z28.array(z28.array(citationCellSchema.nullable())),
-  /** Per-provider citation rate (0..100). */
+  /** Per-provider citation + mention rates (0..100). */
   providerRates: z28.array(z28.object({
     provider: z28.string(),
     citedCount: z28.number(),
+    /** Number of snapshots for this provider where the answer text mentioned the project. */
+    mentionedCount: z28.number(),
     totalCount: z28.number(),
-    citationRate: z28.number()
+    citationRate: z28.number(),
+    mentionRate: z28.number()
   }))
 });
 var competitorRowSchema = z28.object({
@@ -4274,7 +4277,11 @@ var citationsTrendPointSchema = z28.object({
    * within that provider (`cited / scanned`), so it remains comparable
    * between providers in the same run.
    */
-  providerRates: z28.array(z28.object({ provider: z28.string(), citationRate: z28.number() }))
+  providerRates: z28.array(z28.object({
+    provider: z28.string(),
+    citationRate: z28.number(),
+    mentionRate: z28.number()
+  }))
 });
 var reportInsightSchema = z28.object({
   id: z28.string(),
@@ -4356,6 +4363,8 @@ var whatsChangedSectionSchema = z28.object({
   mentionRate: reportRateDeltaSchema.nullable(),
   /** Cited query count delta vs the prior completed run. Null when no prior run. */
   citedQueryCount: reportRateDeltaSchema.nullable(),
+  /** Mentioned query count delta vs the prior completed run. Null when no prior run. */
+  mentionedQueryCount: reportRateDeltaSchema.nullable(),
   /**
    * GSC clicks delta — the most recent `comparisonWindowDays` of `gsc.trend`
    * vs the `comparisonWindowDays` before that. Null when GSC isn't connected

package/dist/{chunk-DJVUNURL.js → chunk-YBIT5O62.js}

@@ -263,7 +263,7 @@ import {
   wordpressSchemaDeployResultDtoSchema,
   wordpressSchemaStatusResultDtoSchema,
   wordpressStatusDtoSchema
-} from "./chunk-CWFTMFEU.js";
+} from "./chunk-JF7EXHGA.js";
 
 // src/intelligence-service.ts
 import { eq as eq37, desc as desc18, asc as asc5, and as and27, ne as ne5, or as or5, inArray as inArray14, gte as gte7, lte as lte4 } from "drizzle-orm";
@@ -4428,19 +4428,23 @@ function buildCitationScorecard(snapshots, queryLookup) {
       answerMentioned: snap.answerMentioned ?? null,
       model: snap.model
     };
-    const counts2 = providerCounts.get(snap.provider) ?? { cited: 0, total: 0 };
+    const counts2 = providerCounts.get(snap.provider) ?? { cited: 0, mentioned: 0, total: 0 };
     counts2.total++;
     if (snap.citationState === CitationStates.cited) counts2.cited++;
+    if (snap.answerMentioned === true) counts2.mentioned++;
     providerCounts.set(snap.provider, counts2);
   }
   const providerRates = providerList.map((provider) => {
-    const counts2 = providerCounts.get(provider) ?? { cited: 0, total: 0 };
+    const counts2 = providerCounts.get(provider) ?? { cited: 0, mentioned: 0, total: 0 };
     const citationRate = counts2.total > 0 ? Math.round(counts2.cited / counts2.total * 100) : 0;
+    const mentionRate = counts2.total > 0 ? Math.round(counts2.mentioned / counts2.total * 100) : 0;
     return {
       provider,
       citedCount: counts2.cited,
+      mentionedCount: counts2.mentioned,
       totalCount: counts2.total,
-      citationRate
+      citationRate,
+      mentionRate
     };
   });
   return { queries: queryList, providers: providerList, matrix, providerRates };
@@ -10221,9 +10225,9 @@ function renderWhatsChanged(report, audience) {
     );
   }
   const rateTiles = `<div class="metric-grid">
-    ${renderRateDeltaTile(isClient ? "AI links to your website" : "Citation rate", w.citationRate, "%")}
-    ${renderRateDeltaTile(isClient ? "AI mentions your name" : "Mention rate", w.mentionRate, "%")}
-    ${renderRateDeltaTile(isClient ? "Questions AI answered with you" : "Cited queries", w.citedQueryCount, "count")}
+    ${renderRateDeltaTile(isClient ? "AI mentions your name" : "Citation rate", isClient ? w.mentionRate : w.citationRate, "%")}
+    ${renderRateDeltaTile(isClient ? "AI links to your website" : "Mention rate", isClient ? w.citationRate : w.mentionRate, "%")}
+    ${renderRateDeltaTile(isClient ? "Questions AI mentioned you in" : "Cited queries", isClient ? w.mentionedQueryCount : w.citedQueryCount, "count")}
     ${renderTrafficDeltaTile(isClient ? "Visitors from Google" : "GSC clicks", w.gscClicksDelta, isClient ? "visits" : "clicks", w.comparisonWindowDays)}
     ${renderTrafficDeltaTile(isClient ? "Visitors from AI tools" : "AI referral sessions", w.aiReferralsDelta, isClient ? "visits" : "sessions", w.comparisonWindowDays)}
   </div>`;
@@ -11117,9 +11121,9 @@ function renderClientSummary(report) {
   const s = report.executiveSummary;
   const sc = report.citationScorecard;
   const totalQ = s.totalQueryCount;
-  const heroNumber = totalQ > 0 ? `${s.citationRate}%` : "\u2014";
-  const heroSentence = totalQ > 0 ? `When customers asked AI ${totalQ} ${pluralize(totalQ, "question")} about your industry, AI linked to your website in ${s.citedQueryCount} of ${totalQ === 1 ? "them" : "those answers"}.` : "No AI check has been run yet. Run a check to see how AI tools answer customer questions about your business.";
-  const trend = clientTrendCopy(report.whatsChanged.citationRate);
+  const heroNumber = totalQ > 0 ? `${s.mentionRate}%` : "\u2014";
+  const heroSentence = totalQ > 0 ? `When customers asked AI ${totalQ} ${pluralize(totalQ, "question")} about your industry, AI mentioned you in ${s.mentionedQueryCount} of ${totalQ === 1 ? "them" : "those answers"}.` : "No AI check has been run yet. Run a check to see how AI tools answer customer questions about your business.";
+  const trend = clientTrendCopy(report.whatsChanged.mentionRate);
   const heroTrend = trend ? `<p class="client-hero-trend tone-${trend.tone}"><span style="margin-right:6px;">${trend.arrow}</span>${escapeHtml(trend.text)}</p>` : "";
   const hero = `<div class="client-hero">
     <div class="client-hero-eyebrow">Overview</div>
@@ -11159,15 +11163,15 @@ function renderClientSummary(report) {
         </ol>
       </div>` : "";
   const providerBars = sc.providerRates.length > 0 ? `<div class="client-card">
-        <h3>How often each AI tool links to your website</h3>
-        <p class="card-subtitle">Higher is better. Each bar shows the share of customer questions where the AI cited your site.</p>
+        <h3>How often each AI tool mentions you</h3>
+        <p class="card-subtitle">Higher is better. Each bar shows the share of customer questions where the AI named you in the answer.</p>
         <div class="client-bar-list">
           ${sc.providerRates.map((r) => {
-    const pct = Math.max(r.citationRate, 1.5);
+    const pct = Math.max(r.mentionRate, 1.5);
     return `<div class="client-bar-row">
               <span class="bar-label">${escapeHtml(providerDisplayName(r.provider))}</span>
               <div class="bar-track"><div class="bar-fill" style="width:${pct}%"></div></div>
-              <span class="bar-value">${r.citationRate}% <span class="bar-value-sub">(${r.citedCount}/${r.totalCount})</span></span>
+              <span class="bar-value">${r.mentionRate}% <span class="bar-value-sub">(${r.mentionedCount}/${r.totalCount})</span></span>
             </div>`;
   }).join("")}
         </div>
@@ -11953,9 +11957,10 @@ function buildCitationsTrend(db, projectId, queryLookup, locationFilter) {
       considered++;
       if (snap.citationState === CitationStates.cited) citedQueryIds.add(snap.queryId);
       if (snap.answerMentioned) mentionedQueryIds.add(snap.queryId);
-      const counts2 = providerCounts.get(snap.provider) ?? { cited: 0, total: 0 };
+      const counts2 = providerCounts.get(snap.provider) ?? { cited: 0, mentioned: 0, total: 0 };
       counts2.total++;
       if (snap.citationState === CitationStates.cited) counts2.cited++;
+      if (snap.answerMentioned === true) counts2.mentioned++;
       providerCounts.set(snap.provider, counts2);
     }
     if (considered === 0) continue;
@@ -11965,7 +11970,8 @@ function buildCitationsTrend(db, projectId, queryLookup, locationFilter) {
     const mentionRate = totalQueries > 0 ? Math.round(mentionedQueryCount / totalQueries * 100) : 0;
     const providerRates = [...providerCounts.entries()].map(([provider, counts2]) => ({
       provider,
-      citationRate: counts2.total > 0 ? Math.round(counts2.cited / counts2.total * 100) : 0
+      citationRate: counts2.total > 0 ? Math.round(counts2.cited / counts2.total * 100) : 0,
+      mentionRate: counts2.total > 0 ? Math.round(counts2.mentioned / counts2.total * 100) : 0
     })).sort((a, b) => a.provider.localeCompare(b.provider));
     points.push({
       runId: run.id,
@@ -12345,23 +12351,17 @@ function buildReportActionPlan(input) {
   }
   return actions.sort((a, b) => a.priority - b.priority).slice(0, 10);
 }
-function trendSentence(trend) {
-  switch (trend) {
-    case "up":
-      return "Citation coverage improved versus the prior comparable check.";
-    case "down":
-      return "Citation coverage declined versus the prior comparable check.";
-    case "flat":
-      return "Citation coverage is flat versus the prior comparable check.";
-    case "unknown":
-      return "There is not enough comparable run history yet to call a trend.";
-  }
+function mentionTrendSentence(delta) {
+  if (!delta) return "There is not enough comparable run history yet to call a mention trend.";
+  if (delta.direction === "up") return "Mention coverage improved versus the prior comparable checks.";
+  if (delta.direction === "down") return "Mention coverage declined versus the prior comparable checks.";
+  return "Mention coverage is flat versus the prior comparable checks.";
 }
 function buildClientSummary(reportLike) {
   const s = reportLike.executiveSummary;
   const queryNoun = s.totalQueryCount === 1 ? "query" : "queries";
-  const headline = s.totalQueryCount > 0 ? `${s.citedQueryCount} of ${s.totalQueryCount} tracked ${queryNoun} are cited by AI engines` : "No tracked queries have completed a check yet";
-  const overview = s.totalQueryCount > 0 ? `${reportLike.canonicalDomain} is cited on ${s.citationRate}% of tracked queries and mentioned on ${s.mentionRate}% of tracked queries. ${trendSentence(s.trend)}` : "At least one completed check is needed before this can summarize how the brand appears in AI answers.";
+  const headline = s.totalQueryCount > 0 ? `${s.mentionedQueryCount} of ${s.totalQueryCount} tracked ${queryNoun} mention the brand in AI answers` : "No tracked queries have completed a check yet";
+  const overview = s.totalQueryCount > 0 ? `${reportLike.canonicalDomain} is mentioned on ${s.mentionRate}% of tracked queries and cited on ${s.citationRate}% of tracked queries. ${mentionTrendSentence(reportLike.whatsChanged.mentionRate)}` : "At least one completed check is needed before this can summarize how the brand appears in AI answers.";
   const confidenceNotes = [];
   if (s.totalQueryCount === 0) {
     confidenceNotes.push("Confidence is low until the first tracked query check completes.");
@@ -12496,6 +12496,11 @@ function buildWhatsChanged(input) {
     ...citedQueryCountSmoothed,
     direction: rateDirection(citedQueryCountSmoothed.deltaAbs, COUNT_REAL_MOVEMENT_THRESHOLD)
   } : null;
+  const mentionedQueryCountSmoothed = smoothedRunDelta(citationsTrend, (p) => p.mentionedQueryCount);
+  const mentionedQueryCount = enoughHistory && mentionedQueryCountSmoothed ? {
+    ...mentionedQueryCountSmoothed,
+    direction: rateDirection(mentionedQueryCountSmoothed.deltaAbs, COUNT_REAL_MOVEMENT_THRESHOLD)
+  } : null;
   const providerMovements = [];
   if (enoughHistory) {
     const priorByProvider = new Map(prior.providerRates.map((p) => [p.provider, p.citationRate]));
@@ -12531,6 +12536,7 @@ function buildWhatsChanged(input) {
     citationRate,
     mentionRate,
     citedQueryCount,
+    mentionedQueryCount,
     gscClicksDelta,
     aiReferralsDelta,
     comparisonWindowDays,
@@ -12694,6 +12700,7 @@ function buildProjectReport(db, projectName, periodDays) {
     reportLocation,
     executiveSummary,
     citationsTrend,
+    whatsChanged,
     gsc: gscSection,
     actionPlan
   });

package/dist/cli.js

@@ -27,7 +27,7 @@ import {
   setTelemetrySource,
   showFirstRunNotice,
   trackEvent
-} from "./chunk-CEHD33NQ.js";
+} from "./chunk-4Q3LBD7A.js";
 import {
   CliError,
   EXIT_SYSTEM_ERROR,
@@ -44,7 +44,7 @@ import {
   saveConfig,
   saveConfigPatch,
   usageError
-} from "./chunk-VQN74WWA.js";
+} from "./chunk-IDI6LMYL.js";
 import {
   apiKeys,
   createClient,
@@ -52,7 +52,7 @@ import {
   projects,
   queries,
   renderReportHtml
-} from "./chunk-DJVUNURL.js";
+} from "./chunk-YBIT5O62.js";
 import {
   BacklinkSources,
   CcReleaseSyncStatuses,
@@ -78,7 +78,7 @@ import {
   providerQuotaPolicySchema,
   resolveProviderInput,
   winnabilityClassSchema
-} from "./chunk-CWFTMFEU.js";
+} from "./chunk-JF7EXHGA.js";
 
 // src/cli.ts
 import { pathToFileURL } from "url";

package/dist/index.js

@@ -1,11 +1,11 @@
 import {
   createServer
-} from "./chunk-CEHD33NQ.js";
+} from "./chunk-4Q3LBD7A.js";
 import {
   loadConfig
-} from "./chunk-VQN74WWA.js";
-import "./chunk-DJVUNURL.js";
-import "./chunk-CWFTMFEU.js";
+} from "./chunk-IDI6LMYL.js";
+import "./chunk-YBIT5O62.js";
+import "./chunk-JF7EXHGA.js";
 export {
   createServer,
   loadConfig

package/dist/{intelligence-service-QHBXW4KI.js → intelligence-service-TWCEKVKZ.js}

@@ -1,7 +1,7 @@
 import {
   IntelligenceService
-} from "./chunk-DJVUNURL.js";
-import "./chunk-CWFTMFEU.js";
+} from "./chunk-YBIT5O62.js";
+import "./chunk-JF7EXHGA.js";
 export {
   IntelligenceService
 };

package/dist/mcp.js

@@ -3,10 +3,10 @@ import {
   PACKAGE_VERSION,
   canonryMcpTools,
   createApiClient
-} from "./chunk-VQN74WWA.js";
+} from "./chunk-IDI6LMYL.js";
 import {
   isReadOnlyKey
-} from "./chunk-CWFTMFEU.js";
+} from "./chunk-JF7EXHGA.js";
 
 // src/mcp/cli.ts
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ainyc/canonry",
-  "version": "4.99.0",
+  "version": "4.99.1",
   "type": "module",
   "description": "Agent-first open-source AEO operating platform - track how answer engines cite your domain",
   "license": "FSL-1.1-ALv2",
@@ -62,27 +62,27 @@
     "@types/node-cron": "^3.0.11",
     "tsup": "^8.5.1",
     "tsx": "^4.19.0",
-    "@ainyc/canonry-api-client": "0.0.0",
     "@ainyc/canonry-api-routes": "0.0.0",
-    "@ainyc/canonry-contracts": "0.0.0",
-    "@ainyc/canonry-config": "0.0.0",
+    "@ainyc/canonry-api-client": "0.0.0",
     "@ainyc/canonry-db": "0.0.0",
-    "@ainyc/canonry-integration-openai-ads": "0.0.0",
     "@ainyc/canonry-integration-bing": "0.0.0",
+    "@ainyc/canonry-integration-openai-ads": "0.0.0",
     "@ainyc/canonry-integration-cloud-run": "0.0.0",
+    "@ainyc/canonry-config": "0.0.0",
     "@ainyc/canonry-integration-commoncrawl": "0.0.0",
     "@ainyc/canonry-integration-google": "0.0.0",
     "@ainyc/canonry-integration-google-business-profile": "0.0.0",
+    "@ainyc/canonry-contracts": "0.0.0",
     "@ainyc/canonry-integration-traffic": "0.0.0",
     "@ainyc/canonry-intelligence": "0.0.0",
     "@ainyc/canonry-integration-google-places": "0.0.0",
+    "@ainyc/canonry-integration-wordpress": "0.0.0",
     "@ainyc/canonry-provider-cdp": "0.0.0",
     "@ainyc/canonry-provider-claude": "0.0.0",
     "@ainyc/canonry-provider-gemini": "0.0.0",
-    "@ainyc/canonry-integration-wordpress": "0.0.0",
     "@ainyc/canonry-provider-local": "0.0.0",
-    "@ainyc/canonry-provider-openai": "0.0.0",
-    "@ainyc/canonry-provider-perplexity": "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",