@ainyc/canonry 4.83.0 → 4.85.0

package/dist/cli.js

@@ -27,7 +27,7 @@ import {
   setTelemetrySource,
   showFirstRunNotice,
   trackEvent
-} from "./chunk-NRACXNI7.js";
+} from "./chunk-7BMSWI2K.js";
 import {
   CliError,
   EXIT_SYSTEM_ERROR,
@@ -44,7 +44,7 @@ import {
   saveConfig,
   saveConfigPatch,
   usageError
-} from "./chunk-Y3O3HBMN.js";
+} from "./chunk-62YB3ML7.js";
 import {
   apiKeys,
   createClient,
@@ -52,7 +52,7 @@ import {
   projects,
   queries,
   renderReportHtml
-} from "./chunk-GOWH42QV.js";
+} from "./chunk-3K3QRSYE.js";
 import {
   BacklinkSources,
   CcReleaseSyncStatuses,
@@ -70,13 +70,14 @@ import {
   formatGbpMetricLabel,
   formatIsoDate,
   formatMicros,
+  formatRatio,
   formatRunErrorOneLine,
   normalizeProjectAliases,
   notificationEventSchema,
   providerQuotaPolicySchema,
   resolveProviderInput,
   winnabilityClassSchema
-} from "./chunk-BNF3HXBW.js";
+} from "./chunk-I2BJC3DT.js";
 
 // src/cli.ts
 import { pathToFileURL } from "url";
@@ -2868,7 +2869,7 @@ async function gaSocialReferralSummary(project, opts) {
     console.log(`  Sessions: ${traffic.socialSessions} (${traffic.socialSharePct}% of ${traffic.totalSessions} total)`);
     console.log(`  Users:    ${traffic.socialUsers}`);
     console.log();
-    const fmtTrend = (pct3) => pct3 === null ? "n/a" : `${pct3 >= 0 ? "+" : ""}${pct3}%`;
+    const fmtTrend = (pct4) => pct4 === null ? "n/a" : `${pct4 >= 0 ? "+" : ""}${pct4}%`;
     console.log(`  7d trend:  ${fmtTrend(trend.trend7dPct)} (${trend.socialSessions7d} vs ${trend.socialSessionsPrev7d})`);
     console.log(`  30d trend: ${fmtTrend(trend.trend30dPct)} (${trend.socialSessions30d} vs ${trend.socialSessionsPrev30d})`);
     if (trend.biggestMover) {
@@ -2911,7 +2912,7 @@ async function gaSocialReferralSummary(project, opts) {
 async function gaAttribution(project, opts) {
   const client = getClient6();
   const traffic = await client.gaTraffic(project);
-  const fmtTrend = (pct3) => pct3 === null ? "n/a" : `${pct3 >= 0 ? "+" : ""}${pct3}%`;
+  const fmtTrend = (pct4) => pct4 === null ? "n/a" : `${pct4 >= 0 ? "+" : ""}${pct4}%`;
   if (opts?.trend) {
     const trend = await client.gaAttributionTrend(project);
     if (isMachineFormat(opts.format)) {
@@ -3475,9 +3476,9 @@ async function gbpPlaces(project, opts) {
     console.log(`  ${p.locationName}  [${p.tier}]  ${amenities}`);
   }
 }
-function fmtDelta(pct3) {
-  if (pct3 === null) return "n/a";
-  return `${pct3 >= 0 ? "+" : ""}${pct3}%`;
+function fmtDelta(pct4) {
+  if (pct4 === null) return "n/a";
+  return `${pct4 >= 0 ? "+" : ""}${pct4}%`;
 }
 async function gbpSummary(project, opts) {
   const client = getClient7();
@@ -6951,14 +6952,14 @@ function printMetrics(data) {
   console.log(`
 Citation Rate Trends (${data.window})`);
   console.log("\u2500".repeat(50));
-  const pct3 = (n) => `${(n * 100).toFixed(1)}%`;
-  console.log(`  Overall: ${pct3(data.overall.citationRate)} (${data.overall.cited}/${data.overall.total})`);
+  const pct4 = (n) => `${(n * 100).toFixed(1)}%`;
+  console.log(`  Overall: ${pct4(data.overall.citationRate)} (${data.overall.cited}/${data.overall.total})`);
   console.log(`  Trend:   ${data.trend}`);
   if (Object.keys(data.byProvider).length > 0) {
     console.log(`
   By Provider:`);
     for (const [provider, metric] of Object.entries(data.byProvider)) {
-      console.log(`    ${provider.padEnd(10)} ${pct3(metric.citationRate).padStart(6)} (${metric.cited}/${metric.total})`);
+      console.log(`    ${provider.padEnd(10)} ${pct4(metric.citationRate).padStart(6)} (${metric.cited}/${metric.total})`);
     }
   }
   if (data.buckets.length > 0) {
@@ -6967,7 +6968,7 @@ Citation Rate Trends (${data.window})`);
     for (const bucket of data.buckets) {
       const start = bucket.startDate.slice(0, 10);
       const bar = bucket.total > 0 ? "\u2588".repeat(Math.round(bucket.citationRate * 20)) : "";
-      console.log(`    ${start}  ${pct3(bucket.citationRate).padStart(6)}  ${bar}`);
+      console.log(`    ${start}  ${pct4(bucket.citationRate).padStart(6)}  ${bar}`);
     }
   }
   const providersInBuckets = [...new Set(data.buckets.flatMap((b) => Object.keys(b.byProvider ?? {})))].sort();
@@ -6981,7 +6982,7 @@ Citation Rate Trends (${data.window})`);
         if (!metric) continue;
         const start = bucket.startDate.slice(0, 10);
         const bar = metric.total > 0 ? "\u2588".repeat(Math.round(metric.citationRate * 20)) : "";
-        console.log(`      ${start}  ${pct3(metric.citationRate).padStart(6)}  ${bar}`);
+        console.log(`      ${start}  ${pct4(metric.citationRate).padStart(6)}  ${bar}`);
       }
     }
   }
@@ -7019,9 +7020,9 @@ Source Origin Breakdown`);
     return;
   }
   for (const cat of data.overall) {
-    const pct3 = `${(cat.percentage * 100).toFixed(1)}%`;
+    const pct4 = `${(cat.percentage * 100).toFixed(1)}%`;
     const domains = cat.topDomains.slice(0, 3).map((d) => d.domain).join(", ");
-    console.log(`  ${cat.label.padEnd(20)} ${pct3.padStart(6)}  (${cat.count})  ${domains}`);
+    console.log(`  ${cat.label.padEnd(20)} ${pct4.padStart(6)}  (${cat.count})  ${domains}`);
   }
 }
 
@@ -9247,13 +9248,15 @@ async function showHealth(project, opts) {
       console.log("No health history available.");
       return;
     }
-    console.log("Date                      Cited Rate   Cited/Total");
-    console.log("\u2500".repeat(55));
+    console.log("Date                      Mention Rate  Mentioned/Total   Cited Rate   Cited/Total");
+    console.log("\u2500".repeat(86));
     for (const snap of snapshots) {
-      const rate2 = (snap.overallCitedRate * 100).toFixed(1).padStart(5) + "%";
-      const ratio = `${snap.citedPairs}/${snap.totalPairs}`;
+      const mRate = (snap.overallMentionRate * 100).toFixed(1).padStart(5) + "%";
+      const mRatio = `${snap.mentionedPairs}/${snap.totalPairs}`.padEnd(15);
+      const cRate = (snap.overallCitedRate * 100).toFixed(1).padStart(5) + "%";
+      const cRatio = `${snap.citedPairs}/${snap.totalPairs}`;
       const date = snap.createdAt.slice(0, 19).padEnd(25);
-      console.log(`${date} ${rate2}        ${ratio}`);
+      console.log(`${date} ${mRate}        ${mRatio}   ${cRate}        ${cRatio}`);
     }
     return;
   }
@@ -9266,14 +9269,17 @@ async function showHealth(project, opts) {
     console.log("No health data yet \u2014 run a sweep first (canonry run <project>).");
     return;
   }
-  const rate = (health.overallCitedRate * 100).toFixed(1);
-  console.log(`Health: ${rate}% cited (${health.citedPairs}/${health.totalPairs} pairs)`);
+  const mentionRate = (health.overallMentionRate * 100).toFixed(1);
+  const citedRate = (health.overallCitedRate * 100).toFixed(1);
+  console.log(`Health: ${mentionRate}% mentioned (${health.mentionedPairs}/${health.totalPairs} pairs)`);
+  console.log(`        ${citedRate}% cited (${health.citedPairs}/${health.totalPairs} pairs)`);
   console.log("");
   if (health.providerBreakdown && Object.keys(health.providerBreakdown).length > 0) {
     console.log("Provider Breakdown:");
     for (const [provider, stats] of Object.entries(health.providerBreakdown)) {
-      const pRate = (stats.citedRate * 100).toFixed(1);
-      console.log(`  ${provider.padEnd(15)} ${pRate}% (${stats.cited}/${stats.total})`);
+      const pMention = (stats.mentionRate * 100).toFixed(1);
+      const pCited = (stats.citedRate * 100).toFixed(1);
+      console.log(`  ${provider.padEnd(15)} ${pMention}% mentioned (${stats.mentioned}/${stats.total})   ${pCited}% cited (${stats.cited}/${stats.total})`);
     }
   }
 }
@@ -9450,8 +9456,8 @@ function printMentionShareBreakdown(mentionShare) {
   const youPct = (breakdown.projectMentionSnapshots / total * 100).toFixed(1);
   console.log(`      you${" ".repeat(28)} ${breakdown.projectMentionSnapshots} mentions (${youPct}% of combined)`);
   for (const row of breakdown.perCompetitor.slice(0, 3)) {
-    const pct3 = (row.mentionSnapshots / total * 100).toFixed(1);
-    console.log(`      ${row.domain.padEnd(30)} ${row.mentionSnapshots} mentions (${pct3}% of combined)`);
+    const pct4 = (row.mentionSnapshots / total * 100).toFixed(1);
+    console.log(`      ${row.domain.padEnd(30)} ${row.mentionSnapshots} mentions (${pct4}% of combined)`);
   }
   if (breakdown.perCompetitor.length > 3) {
     console.log(`      + ${breakdown.perCompetitor.length - 3} more competitor${breakdown.perCompetitor.length - 3 === 1 ? "" : "s"} (--format json for full breakdown)`);
@@ -11261,6 +11267,135 @@ var TECHNICAL_AEO_CLI_COMMANDS = [
   }
 ];
 
+// src/commands/visibility-stats.ts
+async function showVisibilityStats(project, opts) {
+  const client = createApiClient();
+  const data = await client.getVisibilityStats(project, {
+    since: opts.since,
+    until: opts.until,
+    lastRuns: opts.lastRuns,
+    groupBy: opts.byProvider ? "provider" : void 0
+  });
+  if (opts.format === "jsonl") {
+    emitJsonl(data.queries.map((q) => ({ project: data.project, runCount: data.window.runCount, ...q })));
+    return;
+  }
+  if (opts.format === "json") {
+    console.log(JSON.stringify(data, null, 2));
+    return;
+  }
+  printVisibilityStats(data);
+}
+function pct3(rate) {
+  return rate === null ? "\u2014" : formatRatio(rate);
+}
+function citedCell(c) {
+  return `${c.cited}/${c.total}`;
+}
+function mentionedCell(c) {
+  return `${c.mentioned}/${c.checked}`;
+}
+function printVisibilityStats(data) {
+  const w = data.window;
+  const windowParts = [`${w.runCount} run(s)`];
+  if (w.lastRuns !== null) windowParts.push(`last ${w.lastRuns}`);
+  if (w.since !== null) windowParts.push(`since ${w.since}`);
+  if (w.until !== null) windowParts.push(`until ${w.until}`);
+  console.log("Visibility stats (cited = source list, mentioned = answer text)");
+  console.log(`Window: ${windowParts.join(" \xB7 ")}`);
+  console.log('Cited = cited/total snapshots \xB7 Mentioned = mentioned/checked (checked excludes "not checked")');
+  console.log("");
+  if (data.queries.length === 0) {
+    console.log("No answer-visibility snapshots in this window \u2014 run a sweep first (canonry run <project>).");
+    return;
+  }
+  const rows = data.queries.map((q) => ({
+    label: q.query,
+    cited: citedCell(q),
+    citedPct: pct3(q.citedRate),
+    ment: mentionedCell(q),
+    mentPct: pct3(q.mentionRate)
+  }));
+  const queryWidth = Math.max(7, ...rows.map((r) => r.label.length));
+  const citedWidth = Math.max(7, ...rows.map((r) => r.cited.length));
+  const mentWidth = Math.max(9, ...rows.map((r) => r.ment.length));
+  const header = [
+    "Query".padEnd(queryWidth),
+    "Cited".padEnd(citedWidth),
+    "Cited%".padStart(7),
+    "Mentioned".padEnd(mentWidth),
+    "Ment%".padStart(7)
+  ].join("  ");
+  console.log(header);
+  console.log("\u2500".repeat(header.length));
+  for (const r of rows) {
+    console.log(
+      [
+        r.label.padEnd(queryWidth),
+        r.cited.padEnd(citedWidth),
+        r.citedPct.padStart(7),
+        r.ment.padEnd(mentWidth),
+        r.mentPct.padStart(7)
+      ].join("  ")
+    );
+  }
+  console.log("\u2500".repeat(header.length));
+  console.log(
+    [
+      "TOTAL".padEnd(queryWidth),
+      citedCell(data.totals).padEnd(citedWidth),
+      pct3(data.totals.citedRate).padStart(7),
+      mentionedCell(data.totals).padEnd(mentWidth),
+      pct3(data.totals.mentionRate).padStart(7)
+    ].join("  ")
+  );
+  if (data.groupBy === "provider" && data.byProvider && data.byProvider.length > 0) {
+    console.log("");
+    console.log("By provider (pooled across queries):");
+    const provWidth = Math.max(8, ...data.byProvider.map((p) => p.provider.length));
+    for (const p of data.byProvider) {
+      console.log(
+        [
+          `  ${p.provider}`.padEnd(provWidth + 2),
+          citedCell(p).padEnd(citedWidth),
+          pct3(p.citedRate).padStart(7),
+          mentionedCell(p).padEnd(mentWidth),
+          pct3(p.mentionRate).padStart(7)
+        ].join("  ")
+      );
+    }
+  }
+}
+
+// src/cli-commands/visibility-stats.ts
+var USAGE4 = "canonry visibility-stats <project> [--since <iso>] [--until <iso>] [--last-runs <n>] [--by-provider] [--format json|jsonl]";
+var VISIBILITY_STATS_CLI_COMMANDS = [
+  {
+    path: ["visibility-stats"],
+    usage: USAGE4,
+    options: {
+      since: stringOption(),
+      until: stringOption(),
+      "last-runs": stringOption(),
+      "by-provider": { type: "boolean", default: false }
+    },
+    run: async (input) => {
+      const project = requireProject(input, "visibility-stats", USAGE4);
+      await showVisibilityStats(project, {
+        since: getString(input.values, "since"),
+        until: getString(input.values, "until"),
+        lastRuns: parseIntegerOption(input, "last-runs", {
+          command: "visibility-stats",
+          usage: USAGE4,
+          message: "--last-runs must be an integer"
+        }),
+        byProvider: getBoolean(input.values, "by-provider"),
+        format: input.format
+      });
+    }
+  }
+];
+
 // src/cli-commands/wordpress.ts
 import fs11 from "fs";
 
@@ -12845,6 +12980,7 @@ var REGISTERED_CLI_COMMANDS = [
   ...GBP_CLI_COMMANDS,
   ...TRAFFIC_CLI_COMMANDS,
   ...INTELLIGENCE_CLI_COMMANDS,
+  ...VISIBILITY_STATS_CLI_COMMANDS,
   ...CONTENT_CLI_COMMANDS,
   ...AGENT_CLI_COMMANDS,
   ...DISCOVER_CLI_COMMANDS,
@@ -12856,7 +12992,7 @@ var REGISTERED_CLI_COMMANDS = [
 
 // src/cli.ts
 import { createRequire as createRequire2 } from "module";
-var USAGE4 = `
+var USAGE5 = `
 cnry \u2014 AEO monitoring CLI   ('canonry' also works)
 
 Usage:  cnry <command> [options]
@@ -12921,7 +13057,7 @@ function extractFormat(cmdArgs) {
 }
 async function runCli(args = process.argv.slice(2)) {
   if (args.length === 0 || args[0] === "--help" || args[0] === "-h") {
-    console.log(USAGE4);
+    console.log(USAGE5);
     return 0;
   }
   if (args.includes("--version") || args.includes("-v")) {

package/dist/index.js

@@ -1,11 +1,11 @@
 import {
   createServer
-} from "./chunk-NRACXNI7.js";
+} from "./chunk-7BMSWI2K.js";
 import {
   loadConfig
-} from "./chunk-Y3O3HBMN.js";
-import "./chunk-GOWH42QV.js";
-import "./chunk-BNF3HXBW.js";
+} from "./chunk-62YB3ML7.js";
+import "./chunk-3K3QRSYE.js";
+import "./chunk-I2BJC3DT.js";
 export {
   createServer,
   loadConfig

package/dist/{intelligence-service-FHQM7YMA.js → intelligence-service-AHHBQKRD.js}

@@ -1,7 +1,7 @@
 import {
   IntelligenceService
-} from "./chunk-GOWH42QV.js";
-import "./chunk-BNF3HXBW.js";
+} from "./chunk-3K3QRSYE.js";
+import "./chunk-I2BJC3DT.js";
 export {
   IntelligenceService
 };

package/dist/mcp.js

@@ -3,10 +3,10 @@ import {
   PACKAGE_VERSION,
   canonryMcpTools,
   createApiClient
-} from "./chunk-Y3O3HBMN.js";
+} from "./chunk-62YB3ML7.js";
 import {
   isReadOnlyKey
-} from "./chunk-BNF3HXBW.js";
+} from "./chunk-I2BJC3DT.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.83.0",
+  "version": "4.85.0",
   "type": "module",
   "description": "Agent-first open-source AEO operating platform - track how answer engines cite your domain",
   "license": "FSL-1.1-ALv2",
@@ -36,7 +36,7 @@
     "node": ">=22.14.0"
   },
   "dependencies": {
-    "@ainyc/aeo-audit": "3.0.0",
+    "@ainyc/aeo-audit": "4.0.1",
     "@anthropic-ai/sdk": "^0.91.1",
     "@fastify/static": "^9.1.1",
     "@google/genai": "^1.46.0",
@@ -65,22 +65,22 @@
     "@ainyc/canonry-config": "0.0.0",
     "@ainyc/canonry-api-client": "0.0.0",
     "@ainyc/canonry-api-routes": "0.0.0",
-    "@ainyc/canonry-contracts": "0.0.0",
     "@ainyc/canonry-db": "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-integration-bing": "0.0.0",
+    "@ainyc/canonry-contracts": "0.0.0",
     "@ainyc/canonry-integration-commoncrawl": "0.0.0",
     "@ainyc/canonry-integration-google": "0.0.0",
-    "@ainyc/canonry-integration-google-places": "0.0.0",
     "@ainyc/canonry-integration-google-business-profile": "0.0.0",
+    "@ainyc/canonry-integration-google-places": "0.0.0",
     "@ainyc/canonry-integration-traffic": "0.0.0",
+    "@ainyc/canonry-intelligence": "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-intelligence": "0.0.0",
     "@ainyc/canonry-provider-local": "0.0.0",
+    "@ainyc/canonry-provider-claude": "0.0.0",
     "@ainyc/canonry-provider-openai": "0.0.0",
     "@ainyc/canonry-provider-perplexity": "0.0.0"
   },