@ainyc/canonry 4.84.0 → 4.86.0

package/dist/{chunk-Y3O3HBMN.js → chunk-LLJPZKHG.js}

@@ -23,7 +23,7 @@ import {
   trafficConnectVercelRequestSchema,
   trafficConnectWordpressRequestSchema,
   trafficEventKindSchema
-} from "./chunk-BNF3HXBW.js";
+} from "./chunk-23HGQV22.js";
 
 // src/config.ts
 import fs from "fs";
@@ -1538,6 +1538,18 @@ var getApiV1ProjectsByNameAnalyticsSources = (options) => {
     ...options
   });
 };
+var getApiV1ProjectsByNameVisibilityStats = (options) => {
+  return (options.client ?? client).get({
+    security: [
+      {
+        scheme: "bearer",
+        type: "http"
+      }
+    ],
+    url: "/api/v1/projects/{name}/visibility-stats",
+    ...options
+  });
+};
 var getApiV1ProjectsByNameSnapshotsDiff = (options) => {
   return (options.client ?? client).get({
     security: [
@@ -3442,6 +3454,18 @@ var getApiV1ProjectsByNameDiscoverSessionsById = (options) => {
     ...options
   });
 };
+var getApiV1ProjectsByNameDiscoverSessionsByIdHarvest = (options) => {
+  return (options.client ?? client).get({
+    security: [
+      {
+        scheme: "bearer",
+        type: "http"
+      }
+    ],
+    url: "/api/v1/projects/{name}/discover/sessions/{id}/harvest",
+    ...options
+  });
+};
 var getApiV1ProjectsByNameDiscoverSessionsByIdPromote = (options) => {
   return (options.client ?? client).get({
     security: [
@@ -4738,6 +4762,19 @@ var ApiClient = class {
       })
     );
   }
+  async getDiscoveryHarvest(project, sessionId, opts) {
+    return this.invoke(
+      () => getApiV1ProjectsByNameDiscoverSessionsByIdHarvest({
+        client: this.heyClient,
+        path: { name: project, id: sessionId },
+        query: {
+          minProbeHits: opts?.minProbeHits !== void 0 ? String(opts.minProbeHits) : void 0,
+          // The server treats anchor=false as "disable"; omit otherwise.
+          anchor: opts?.anchor === false ? "false" : void 0
+        }
+      })
+    );
+  }
   async previewDiscoveryPromote(project, sessionId) {
     return this.invoke(
       () => getApiV1ProjectsByNameDiscoverSessionsByIdPromote({
@@ -5062,6 +5099,20 @@ var ApiClient = class {
       () => getApiV1ProjectsByNameCitationsVisibility({ client: this.heyClient, path: { name: project } })
     );
   }
+  async getVisibilityStats(project, opts = {}) {
+    return this.invoke(
+      () => getApiV1ProjectsByNameVisibilityStats({
+        client: this.heyClient,
+        path: { name: project },
+        query: {
+          since: opts.since,
+          until: opts.until,
+          lastRuns: opts.lastRuns,
+          groupBy: opts.groupBy
+        }
+      })
+    );
+  }
   // ── Backlinks — workspace-level ────────────────────────────────────────
   async backlinksStatus() {
     return this.invoke(() => getApiV1BacklinksStatus({ client: this.heyClient }));
@@ -5468,6 +5519,12 @@ var discoverySessionIdInputSchema = z2.object({
   project: projectNameSchema,
   sessionId: z2.string().min(1).describe("Discovery session ID returned by canonry_discover_run_start.")
 });
+var discoveryHarvestInputSchema = z2.object({
+  project: projectNameSchema,
+  sessionId: z2.string().min(1).describe("Discovery session ID returned by canonry_discover_run_start."),
+  minProbeHits: z2.number().int().positive().optional().describe("Recurrence floor \u2014 a candidate must have appeared in at least this many distinct probes to be admitted. Default 1."),
+  anchor: z2.boolean().optional().describe("Apply the subject-anchor filter that drops off-topic acronym collisions. Default true; pass false for new-subject discovery on a well-scoped project.")
+});
 var discoveryPromoteInputSchema = z2.object({
   project: projectNameSchema,
   sessionId: z2.string().min(1).describe("Discovery session ID returned by canonry_discover_run_start."),
@@ -5768,6 +5825,28 @@ var canonryMcpTools = [
     openApiOperations: ["GET /api/v1/projects/{name}/citations/visibility"],
     handler: (client2, input) => client2.getCitationVisibility(input.project)
   }),
+  defineTool({
+    name: "canonry_visibility_stats",
+    title: "Get aggregated mention/citation stats",
+    description: 'Per-query mention (answer-text) and citation (source-list) counts WITH a sample size, pooled across many answer-visibility runs (probe-excluded) \u2014 the data to compute a confidence-aware (Wilson) proportion or detect drift without fetching every run. Tri-state aware: `checked` (the n for the mention proportion) counts only snapshots where answerMentioned was recorded; `null` ("not checked") is excluded, never counted as not-mentioned. Returns per-query `total`/`checked`/`mentioned`/`cited` + derived `mentionRate` (mentioned/checked) and `citedRate` (cited/total), `firstObserved`/`lastObserved`, and pooled `totals`. Window with `since`/`until` (ISO) OR `lastRuns` (mutually exclusive); with none set, EVERY completed/partial run is pooled (`window.runCount` says how many) \u2014 pass `lastRuns` for a recent sample. Set `groupBy=provider` for a per-provider breakdown whose counts sum to the pooled counts (`groupBy` is omitted from the response otherwise).',
+    access: "read",
+    tier: "monitoring",
+    inputSchema: z2.object({
+      project: projectNameSchema,
+      since: z2.string().optional().describe("Inclusive lower bound on run createdAt (ISO 8601). A date-only value (YYYY-MM-DD) is the start of that UTC day. Mutually exclusive with lastRuns."),
+      until: z2.string().optional().describe("Inclusive upper bound on run createdAt (ISO 8601). A date-only value (YYYY-MM-DD) covers the whole UTC day (through 23:59:59.999). Mutually exclusive with lastRuns."),
+      lastRuns: z2.number().int().positive().optional().describe("Aggregate only the most recent N answer-visibility runs. Mutually exclusive with since/until."),
+      groupBy: z2.enum(["provider"]).optional().describe('Set to "provider" for a per-provider breakdown.')
+    }),
+    annotations: readAnnotations(),
+    openApiOperations: ["GET /api/v1/projects/{name}/visibility-stats"],
+    handler: (client2, input) => client2.getVisibilityStats(input.project, {
+      since: input.since,
+      until: input.until,
+      lastRuns: input.lastRuns,
+      groupBy: input.groupBy
+    })
+  }),
   defineTool({
     name: "canonry_content_targets",
     title: "Get content targets",
@@ -6701,6 +6780,20 @@ var canonryMcpTools = [
     openApiOperations: ["GET /api/v1/projects/{name}/discover/sessions/{id}"],
     handler: (client2, input) => client2.getDiscoverySession(input.project, input.sessionId)
   }),
+  defineTool({
+    name: "canonry_discover_harvest",
+    title: "Harvest discovery search queries",
+    description: `Read the search queries the answer engine actually issued (Gemini's grounding fan-out) back out of a session's stored probes, gate them for buyer-intent + novelty, and return the survivors as candidate seeds ranked by how many distinct probes issued each one. These are a THIRD signal \u2014 issued retrieval queries \u2014 distinct from mention (answer text) and cited (source list); they carry no demand of their own. Read-only and derived: nothing is probed, tracked, or promoted. Use it to surface "queries the model searched for that you aren't tracking yet"; the operator/agent then decides what to add via canonry_query_add. minProbeHits raises the recurrence floor; anchor=false disables the subject filter. stats carries the raw count and per-reason rejection tally.`,
+    access: "read",
+    tier: "discovery",
+    inputSchema: discoveryHarvestInputSchema,
+    annotations: readAnnotations(),
+    openApiOperations: ["GET /api/v1/projects/{name}/discover/sessions/{id}/harvest"],
+    handler: (client2, input) => client2.getDiscoveryHarvest(input.project, input.sessionId, {
+      minProbeHits: input.minProbeHits,
+      anchor: input.anchor
+    })
+  }),
   defineTool({
     name: "canonry_discover_promote_preview",
     title: "Preview discovery promotion",

package/dist/{chunk-M3IYKTSF.js → chunk-SELXBOAP.js}

@@ -9,7 +9,7 @@ import {
   loadConfig,
   loadConfigRaw,
   saveConfigPatch
-} from "./chunk-Y3O3HBMN.js";
+} from "./chunk-LLJPZKHG.js";
 import {
   CC_CACHE_DIR,
   DUCKDB_SPEC,
@@ -104,7 +104,7 @@ import {
   siteAuditPages,
   siteAuditSnapshots,
   usageCounters
-} from "./chunk-VJBO4VIK.js";
+} from "./chunk-DLBQU3VG.js";
 import {
   AGENT_MEMORY_VALUE_MAX_BYTES,
   AGENT_PROVIDER_IDS,
@@ -160,7 +160,7 @@ import {
   validationError,
   winnabilityClassLabel,
   withRetry
-} from "./chunk-BNF3HXBW.js";
+} from "./chunk-23HGQV22.js";
 
 // src/telemetry.ts
 import crypto from "crypto";
@@ -6289,7 +6289,7 @@ function readStoredGroundingSources(rawResponse) {
   return result;
 }
 async function backfillInsightsCommand(project, opts) {
-  const { IntelligenceService: IntelligenceService2 } = await import("./intelligence-service-PDIAMP5I.js");
+  const { IntelligenceService: IntelligenceService2 } = await import("./intelligence-service-ZHUJKZRO.js");
   const config = loadConfig();
   const db = createClient(config.database);
   migrate(db);
@@ -10877,6 +10877,21 @@ async function createServer(opts) {
         app.log.error({ runId: input.runId, err }, "Discovery run failed");
       });
     },
+    // Read issued search queries (fan-out) back out of a stored probe payload.
+    // Discovery is Gemini-only today, so the Gemini extractor handles every
+    // probe; the provider arg lets a future multi-provider discovery dispatch.
+    harvestSearchQueries: ({ rawResponse }) => extractSearchQueriesFromRaw(rawResponse),
+    // Embed seam for the harvest's semantic novelty pass — the same Gemini
+    // embedder the discovery seed pipeline uses. Resolved at call time so a
+    // provider key set after boot is picked up; rejects (→ route degrades to
+    // exact-match novelty) when no Gemini key is configured.
+    embedQueries: (queriesToEmbed) => {
+      const cfg = registry.get("gemini")?.config;
+      if (!cfg?.apiKey) {
+        return Promise.reject(new Error("Gemini API key not configured; harvest semantic novelty unavailable"));
+      }
+      return embedQueries(queriesToEmbed, { apiKey: cfg.apiKey, baseUrl: cfg.baseUrl });
+    },
     onSiteAuditRequested: (runId, projectId, auditOpts) => {
       runSiteAudit(runId, projectId, auditOpts);
     },

package/dist/cli.js

@@ -27,7 +27,7 @@ import {
   setTelemetrySource,
   showFirstRunNotice,
   trackEvent
-} from "./chunk-M3IYKTSF.js";
+} from "./chunk-SELXBOAP.js";
 import {
   CliError,
   EXIT_SYSTEM_ERROR,
@@ -44,7 +44,7 @@ import {
   saveConfig,
   saveConfigPatch,
   usageError
-} from "./chunk-Y3O3HBMN.js";
+} from "./chunk-LLJPZKHG.js";
 import {
   apiKeys,
   createClient,
@@ -52,7 +52,7 @@ import {
   projects,
   queries,
   renderReportHtml
-} from "./chunk-VJBO4VIK.js";
+} from "./chunk-DLBQU3VG.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-23HGQV22.js";
 
 // src/cli.ts
 import { pathToFileURL } from "url";
@@ -1831,6 +1832,39 @@ async function discoverShow(project, sessionId, opts) {
   }
   printSessionDetail(session);
 }
+async function discoverHarvest(project, sessionId, opts) {
+  const client = getClient4();
+  const harvest = await client.getDiscoveryHarvest(project, sessionId, {
+    minProbeHits: opts.minProbeHits,
+    anchor: opts.anchor
+  });
+  if (opts.format === "json") {
+    console.log(JSON.stringify(harvest, null, 2));
+    return;
+  }
+  if (opts.format === "jsonl") {
+    const context = { project, sessionId, provider: harvest.provider };
+    emitJsonl(harvest.candidates.map((c) => ({ ...context, ...c })));
+    return;
+  }
+  const r = harvest.stats.rejected;
+  console.log(`Harvested issued search queries \u2014 session ${harvest.sessionId} (${harvest.provider})`);
+  console.log(
+    `  ${harvest.stats.admitted} admitted of ${harvest.stats.rawCandidates} raw \xB7 floor=${harvest.minProbeHits} \xB7 anchor=${harvest.anchorApplied ? "on" : "off"} \xB7 novelty=${harvest.semanticNoveltyApplied ? "semantic" : "exact-only"}`
+  );
+  console.log(
+    `  rejected: ${r.belowFloor} below-floor \xB7 ${r.length} length \xB7 ${r.navigational} navigational \xB7 ${r.duplicate} already-tracked \xB7 ${r.semanticDuplicate} synonym \xB7 ${r.offAnchor} off-subject`
+  );
+  if (harvest.candidates.length === 0) {
+    console.log("  (no candidates \u2014 nothing to track from this session)");
+    return;
+  }
+  console.log("");
+  console.log("  HITS  QUERY");
+  for (const candidate of harvest.candidates) {
+    console.log(`  ${String(candidate.probeHits).padStart(4)}  ${candidate.query}`);
+  }
+}
 async function discoverPromotePreview(project, sessionId, opts) {
   const client = getClient4();
   const preview = await client.previewDiscoveryPromote(project, sessionId);
@@ -2155,6 +2189,32 @@ var DISCOVER_CLI_COMMANDS = [
       });
     }
   },
+  {
+    path: ["discover", "harvest"],
+    usage: "canonry discover harvest <project> <session-id> [--min-probe-hits <n>] [--no-anchor] [--format json|jsonl]",
+    options: {
+      "min-probe-hits": stringOption(),
+      "no-anchor": { type: "boolean", default: false }
+    },
+    run: async (input) => {
+      const usage = "canonry discover harvest <project> <session-id> [--min-probe-hits <n>] [--no-anchor] [--format json|jsonl]";
+      const project = requireProject(input, "discover.harvest", usage);
+      const sessionId = requirePositional(input, 1, {
+        command: "discover.harvest",
+        usage,
+        message: "session ID is required"
+      });
+      await discoverHarvest(project, sessionId, {
+        minProbeHits: parseIntegerOption(input, "min-probe-hits", {
+          command: "discover.harvest",
+          usage,
+          message: "--min-probe-hits must be an integer"
+        }),
+        anchor: !getBoolean(input.values, "no-anchor"),
+        format: input.format
+      });
+    }
+  },
   {
     path: ["discover", "promote", "preview"],
     usage: "canonry discover promote preview <project> <session-id> [--format json]",
@@ -2868,7 +2928,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 +2971,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 +3535,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 +7011,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 +7027,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 +7041,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 +7079,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}`);
   }
 }
 
@@ -9455,8 +9515,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)`);
@@ -11266,6 +11326,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";
 
@@ -12850,6 +13039,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,
@@ -12861,7 +13051,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]
@@ -12926,7 +13116,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-M3IYKTSF.js";
+} from "./chunk-SELXBOAP.js";
 import {
   loadConfig
-} from "./chunk-Y3O3HBMN.js";
-import "./chunk-VJBO4VIK.js";
-import "./chunk-BNF3HXBW.js";
+} from "./chunk-LLJPZKHG.js";
+import "./chunk-DLBQU3VG.js";
+import "./chunk-23HGQV22.js";
 export {
   createServer,
   loadConfig

package/dist/{intelligence-service-PDIAMP5I.js → intelligence-service-ZHUJKZRO.js}

@@ -1,7 +1,7 @@
 import {
   IntelligenceService
-} from "./chunk-VJBO4VIK.js";
-import "./chunk-BNF3HXBW.js";
+} from "./chunk-DLBQU3VG.js";
+import "./chunk-23HGQV22.js";
 export {
   IntelligenceService
 };

package/dist/mcp.js

@@ -3,10 +3,10 @@ import {
   PACKAGE_VERSION,
   canonryMcpTools,
   createApiClient
-} from "./chunk-Y3O3HBMN.js";
+} from "./chunk-LLJPZKHG.js";
 import {
   isReadOnlyKey
-} from "./chunk-BNF3HXBW.js";
+} from "./chunk-23HGQV22.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.84.0",
+  "version": "4.86.0",
   "type": "module",
   "description": "Agent-first open-source AEO operating platform - track how answer engines cite your domain",
   "license": "FSL-1.1-ALv2",
@@ -63,26 +63,26 @@
     "tsup": "^8.5.1",
     "tsx": "^4.19.0",
     "@ainyc/canonry-api-client": "0.0.0",
-    "@ainyc/canonry-db": "0.0.0",
     "@ainyc/canonry-api-routes": "0.0.0",
-    "@ainyc/canonry-contracts": "0.0.0",
     "@ainyc/canonry-config": "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-cloud-run": "0.0.0",
     "@ainyc/canonry-integration-openai-ads": "0.0.0",
+    "@ainyc/canonry-integration-cloud-run": "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-integration-google-places": "0.0.0",
-    "@ainyc/canonry-intelligence": "0.0.0",
     "@ainyc/canonry-integration-traffic": "0.0.0",
-    "@ainyc/canonry-provider-claude": "0.0.0",
-    "@ainyc/canonry-provider-cdp": "0.0.0",
+    "@ainyc/canonry-intelligence": "0.0.0",
     "@ainyc/canonry-integration-wordpress": "0.0.0",
-    "@ainyc/canonry-provider-gemini": "0.0.0",
-    "@ainyc/canonry-provider-openai": "0.0.0",
+    "@ainyc/canonry-provider-cdp": "0.0.0",
+    "@ainyc/canonry-provider-claude": "0.0.0",
     "@ainyc/canonry-provider-local": "0.0.0",
-    "@ainyc/canonry-provider-perplexity": "0.0.0"
+    "@ainyc/canonry-provider-gemini": "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",