@canonry/canonry 4.172.1 → 4.172.2

package/dist/{chunk-IAX4WRAR.js → chunk-TI3SZAVI.js}

@@ -9,7 +9,7 @@ import {
   loadConfig,
   loadConfigRaw,
   saveConfigPatch
-} from "./chunk-5MRE2TXR.js";
+} from "./chunk-YXDCVM5U.js";
 import {
   CC_CACHE_DIR,
   DUCKDB_SPEC,
@@ -145,7 +145,7 @@ import {
   siteCrawlSnapshots,
   toAlertView,
   usageCounters
-} from "./chunk-3XN226N6.js";
+} from "./chunk-PXTSQ67Z.js";
 import {
   AGENT_MEMORY_VALUE_MAX_BYTES,
   AGENT_PROVIDER_IDS,
@@ -282,7 +282,7 @@ import {
   validationError,
   winnabilityClassLabel,
   withRetry
-} from "./chunk-X63CLHYM.js";
+} from "./chunk-EGGQSFQL.js";
 
 // src/telemetry.ts
 import crypto from "crypto";
@@ -11829,7 +11829,7 @@ function readStoredGroundingSources(rawResponse) {
   return result;
 }
 async function backfillInsightsCommand(project, opts) {
-  const { IntelligenceService: IntelligenceService2 } = await import("./intelligence-service-FSHZXSGK.js");
+  const { IntelligenceService: IntelligenceService2 } = await import("./intelligence-service-H7756PBD.js");
   const config = loadConfig();
   const db = createClient(config.database);
   migrate(db);

package/dist/{chunk-7L4453BU.js → chunk-U5JTZM66.js}

@@ -5,11 +5,11 @@ import {
   installSkills,
   loadConfigRaw,
   saveConfigPatch
-} from "./chunk-5MRE2TXR.js";
+} from "./chunk-YXDCVM5U.js";
 import {
   SKILL_MANIFEST_FILENAME,
   SkillsClients
-} from "./chunk-X63CLHYM.js";
+} from "./chunk-EGGQSFQL.js";
 
 // src/skills-autosync.ts
 import fs from "fs";

package/dist/{chunk-5MRE2TXR.js → chunk-YXDCVM5U.js}

@@ -91,7 +91,7 @@ import {
   trafficConnectWordpressRequestSchema,
   trafficEventKindSchema,
   trafficSeriesGranularitySchema
-} from "./chunk-X63CLHYM.js";
+} from "./chunk-EGGQSFQL.js";
 
 // src/config.ts
 import fs from "fs";
@@ -8274,7 +8274,8 @@ var ApiClient = class {
           lastRuns: opts.lastRuns,
           groupBy: opts.groupBy,
           month: opts.month,
-          shareOfVoice: opts.shareOfVoice ? "1" : void 0
+          shareOfVoice: opts.shareOfVoice ? "1" : void 0,
+          queryClass: opts.queryClass
         }
       })
     );
@@ -9999,7 +10000,7 @@ var canonryMcpTools = [
   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), `lastRuns`, or `month=YYYY-MM` (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). Set `shareOfVoice=true` for pooled project-vs-tracked-competitor brand-mention share across the same attributed snapshot set.',
+    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), `lastRuns`, or `month=YYYY-MM` (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). Set `shareOfVoice=true` for project-vs-tracked-competitor brand-mention share across the same attributed snapshot set \u2014 scoped to NON-BRAND queries by default, because a branded query names the project (it is mentioned on nearly all of them and a competitor cannot be), so a pooled figure reports brand recall as category placement. Pass `queryClass="branded"` for the recall figure; the response echoes which class it served.',
     access: "read",
     tier: "monitoring",
     inputSchema: z3.object({
@@ -10009,7 +10010,8 @@ var canonryMcpTools = [
       lastRuns: z3.number().int().positive().optional().describe("Aggregate only the most recent N answer-visibility runs. Mutually exclusive with since/until/month."),
       month: z3.string().optional().describe("Aggregate one calendar month (YYYY-MM), expanded to that month's inclusive UTC bounds. Mutually exclusive with since/until/lastRuns."),
       groupBy: z3.enum(["provider"]).optional().describe('Set to "provider" for a per-provider breakdown.'),
-      shareOfVoice: z3.boolean().optional().describe("Include pooled project-vs-tracked-competitor brand-mention share across the same window.")
+      shareOfVoice: z3.boolean().optional().describe("Include project-vs-tracked-competitor brand-mention share across the same window (non-brand queries unless queryClass says otherwise)."),
+      queryClass: z3.enum(["branded", "non-brand"]).optional().describe('Query class for shareOfVoice. Defaults to non-brand. There is no "all": branded and non-brand never share a denominator.')
     }),
     annotations: readAnnotations(),
     openApiOperations: ["GET /api/v1/projects/{name}/visibility-stats"],
@@ -10019,7 +10021,8 @@ var canonryMcpTools = [
       lastRuns: input.lastRuns,
       groupBy: input.groupBy,
       month: input.month,
-      shareOfVoice: input.shareOfVoice
+      shareOfVoice: input.shareOfVoice,
+      queryClass: input.queryClass
     })
   }),
   defineTool({

package/dist/cli.js

@@ -26,11 +26,11 @@ import {
   showFirstRunNotice,
   trackCliCommandFinished,
   trackEvent
-} from "./chunk-IAX4WRAR.js";
+} from "./chunk-TI3SZAVI.js";
 import {
   autoSyncSkills,
   formatAutoSyncNotice
-} from "./chunk-7L4453BU.js";
+} from "./chunk-U5JTZM66.js";
 import {
   CliError,
   EXIT_SYSTEM_ERROR,
@@ -55,7 +55,7 @@ import {
   saveConfigPatch,
   systemError,
   usageError
-} from "./chunk-5MRE2TXR.js";
+} from "./chunk-YXDCVM5U.js";
 import {
   CLOUDFLARE_WORKER_BINDINGS,
   CLOUDFLARE_WORKER_GENERATED_MARKER,
@@ -69,7 +69,7 @@ import {
   projects,
   queries,
   renderReportHtml
-} from "./chunk-3XN226N6.js";
+} from "./chunk-PXTSQ67Z.js";
 import {
   AdsDeliverySnapshotStatuses,
   AdsHistoricalCampaignRollupStatuses,
@@ -137,7 +137,7 @@ import {
   providerQuotaPolicySchema,
   resolveProviderInput,
   winnabilityClassSchema
-} from "./chunk-X63CLHYM.js";
+} from "./chunk-EGGQSFQL.js";
 
 // src/cli.ts
 import { pathToFileURL } from "url";
@@ -13080,14 +13080,14 @@ async function showAllOverviews(opts) {
   console.log(`
 Overviews (${overviews.length} project${overviews.length === 1 ? "" : "s"}):
 `);
-  const cols = { project: 20, mention: 10, cited: 10, share: 18, queries: 10 };
-  console.log(`  ${cell("Project", cols.project)}${cell("Mention", cols.mention)}${cell("Cited", cols.cited)}${cell("Share", cols.share)}${cell("Queries", cols.queries)}Latest run`);
+  const cols = { project: 20, mention: 10, cited: 10, share: 42, queries: 10 };
+  console.log(`  ${cell("Project", cols.project)}${cell("Mention", cols.mention)}${cell("Cited", cols.cited)}${cell("Mention share \xB7 scope", cols.share)}${cell("Queries", cols.queries)}Latest run`);
   for (const ov of overviews) {
     const project = ov.project.displayName || ov.project.name;
     const queries2 = `${ov.queryCounts.citedQueries}/${ov.queryCounts.totalQueries}`;
     const latest = ov.latestRun.run?.finishedAt ?? ov.latestRun.run?.createdAt ?? "\u2014";
     console.log(
-      `  ${cell(project, cols.project)}${cell(ov.scores.mention.value, cols.mention)}${cell(ov.scores.visibility.value, cols.cited)}${cell(ov.scores.mentionShare.value, cols.share)}${cell(queries2, cols.queries)}${latest}`
+      `  ${cell(project, cols.project)}${cell(ov.scores.mention.value, cols.mention)}${cell(ov.scores.visibility.value, cols.cited)}${cell(`${ov.scores.mentionShare.value} \xB7 ${ov.scores.mentionShare.scope} queries`, cols.share)}${cell(queries2, cols.queries)}${latest}`
     );
   }
   console.log();
@@ -16123,7 +16123,8 @@ async function showVisibilityStats(project, opts) {
     month: opts.month,
     lastRuns: opts.lastRuns,
     groupBy: opts.byProvider ? "provider" : void 0,
-    shareOfVoice: opts.shareOfVoice
+    shareOfVoice: opts.shareOfVoice,
+    queryClass: opts.queryClass
   });
   if (opts.format === "jsonl") {
     emitJsonl(data.queries.map((q) => ({ project: data.project, runCount: data.window.runCount, ...q })));
@@ -16149,6 +16150,9 @@ async function showVisibilityCompare(project, opts) {
   printVisibilityCompare(data);
 }
 function periodCell(p) {
+  if (p.availability === "no-competitive-frame") {
+    return `unavailable: no competitive frame (${p.numerator} observed)`;
+  }
   if (p.point === null || p.ciLow === null || p.ciHigh === null) return "no data";
   const p1 = (v) => formatRatio(v);
   return `${p1(p.point)} [${p1(p.ciLow)}, ${p1(p.ciHigh)}]`;
@@ -16167,6 +16171,11 @@ function verdictCell(m) {
       return "model unknown";
   }
 }
+function metricQueryClassLabel(metric) {
+  if (metric.queryClass === "non-brand") return "non-brand queries";
+  if (metric.queryClass === "pooled") return "pooled queries; classification unavailable";
+  return "all queries";
+}
 function printVisibilityCompare(data) {
   console.log(`AEO month over month: ${data.project}   ${data.from.month} -> ${data.to.month}`);
   const b = data.basket;
@@ -16183,7 +16192,7 @@ function printVisibilityCompare(data) {
   }
   console.log("");
   const rows = data.metrics.map((m) => ({
-    label: `${m.label}${m.driftRobust ? " *" : ""}`,
+    label: `${m.label} \xB7 ${metricQueryClassLabel(m)}${m.driftRobust ? " *" : ""}`,
     to: periodCell(m.to),
     from: periodCell(m.from),
     verdict: verdictCell(m)
@@ -16289,10 +16298,14 @@ function printVisibilityStats(data) {
   const sov = data.shareOfVoice;
   if (sov) {
     console.log("");
-    const pctStr = sov.percent === null ? "\u2014 (no competitors configured)" : `${sov.percent}%`;
+    const pctStr = sov.percent !== null ? `${sov.percent}%` : sov.competitorCount === 0 ? "\u2014 (no competitors configured)" : sov.snapshotsWithAnswerText === 0 ? "\u2014 (no answer text in scope)" : "\u2014 (no brands mentioned in scope)";
+    const scope = sov.queryClass === "pooled" ? "pooled queries \xB7 classification unavailable" : `${sov.queryClass} queries`;
     console.log(
-      `Share of voice: ${pctStr}  (you ${sov.projectMentions} vs competitors ${sov.competitorMentions} brand mentions across ${sov.snapshotsWithAnswerText} answers)`
+      `Share of voice (${scope}): ${pctStr}  (you ${sov.projectMentions} vs competitors ${sov.competitorMentions} brand mentions across ${sov.snapshotsWithAnswerText} answers)`
     );
+    if (sov.queryClass === "non-brand") {
+      console.log("  branded queries excluded on purpose \u2014 re-run with --query-class branded for brand recall");
+    }
     for (const c of sov.perCompetitor.slice(0, 8)) {
       console.log(`  ${c.domain}: ${c.mentions}`);
     }
@@ -16300,7 +16313,14 @@ function printVisibilityStats(data) {
 }
 
 // src/cli-commands/visibility-stats.ts
-var USAGE5 = "canonry visibility-stats <project> [--since <iso>] [--until <iso>] [--month <YYYY-MM>] [--last-runs <n>] [--by-provider] [--share-of-voice] [--format json|jsonl]";
+var USAGE5 = "canonry visibility-stats <project> [--since <iso>] [--until <iso>] [--month <YYYY-MM>] [--last-runs <n>] [--by-provider] [--share-of-voice] [--query-class branded|non-brand] [--format json|jsonl]";
+function parseQueryClass(value) {
+  if (value === void 0 || value === "") return void 0;
+  if (value !== "branded" && value !== "non-brand") {
+    throw new Error(`--query-class must be "branded" or "non-brand" (got "${value}")`);
+  }
+  return value;
+}
 var COMPARE_USAGE = "canonry visibility-compare <project> --from <YYYY-MM> --to <YYYY-MM> [--format json]";
 var VISIBILITY_STATS_CLI_COMMANDS = [
   {
@@ -16312,7 +16332,8 @@ var VISIBILITY_STATS_CLI_COMMANDS = [
       month: stringOption(),
       "last-runs": stringOption(),
       "by-provider": { type: "boolean", default: false },
-      "share-of-voice": { type: "boolean", default: false }
+      "share-of-voice": { type: "boolean", default: false },
+      "query-class": stringOption()
     },
     run: async (input) => {
       const project = requireProject(input, "visibility-stats", USAGE5);
@@ -16327,6 +16348,7 @@ var VISIBILITY_STATS_CLI_COMMANDS = [
         }),
         byProvider: getBoolean(input.values, "by-provider"),
         shareOfVoice: getBoolean(input.values, "share-of-voice"),
+        queryClass: parseQueryClass(getString(input.values, "query-class")),
         format: input.format
       });
     }

package/dist/index.js

@@ -3,12 +3,12 @@ import {
   createGoogleMarketingCredentialStore,
   createGoogleMarketingRuntime,
   createServer
-} from "./chunk-IAX4WRAR.js";
+} from "./chunk-TI3SZAVI.js";
 import {
   loadConfig
-} from "./chunk-5MRE2TXR.js";
-import "./chunk-3XN226N6.js";
-import "./chunk-X63CLHYM.js";
+} from "./chunk-YXDCVM5U.js";
+import "./chunk-PXTSQ67Z.js";
+import "./chunk-EGGQSFQL.js";
 export {
   GoogleMarketingRuntimeError,
   createGoogleMarketingCredentialStore,

package/dist/{intelligence-service-FSHZXSGK.js → intelligence-service-H7756PBD.js}

@@ -1,7 +1,7 @@
 import {
   IntelligenceService
-} from "./chunk-3XN226N6.js";
-import "./chunk-X63CLHYM.js";
+} from "./chunk-PXTSQ67Z.js";
+import "./chunk-EGGQSFQL.js";
 export {
   IntelligenceService
 };

package/dist/mcp.js

@@ -1,15 +1,15 @@
 import {
   autoSyncSkills
-} from "./chunk-7L4453BU.js";
+} from "./chunk-U5JTZM66.js";
 import {
   CliError,
   PACKAGE_VERSION,
   canonryMcpTools,
   createApiClient
-} from "./chunk-5MRE2TXR.js";
+} from "./chunk-YXDCVM5U.js";
 import {
   isReadOnlyKey
-} from "./chunk-X63CLHYM.js";
+} from "./chunk-EGGQSFQL.js";
 
 // src/mcp/cli.ts
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@canonry/canonry",
-  "version": "4.172.1",
+  "version": "4.172.2",
   "type": "module",
   "description": "Agent-first open-source AEO operating platform - track how answer engines cite your domain",
   "license": "FSL-1.1-ALv2",
@@ -71,30 +71,30 @@
     "tsup": "^8.5.1",
     "tsx": "^4.19.0",
     "@ainyc/canonry-api-client": "0.0.0",
-    "@ainyc/canonry-config": "0.0.0",
+    "@ainyc/canonry-api-routes": "0.0.0",
     "@ainyc/canonry-contracts": "0.0.0",
-    "@ainyc/canonry-integration-bing": "0.0.0",
+    "@ainyc/canonry-config": "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-cloudflare-queue": "0.0.0",
+    "@ainyc/canonry-integration-commoncrawl": "0.0.0",
     "@ainyc/canonry-integration-cloudflare-worker": "0.0.0",
-    "@ainyc/canonry-integration-openai-ads": "0.0.0",
-    "@ainyc/canonry-api-routes": "0.0.0",
-    "@ainyc/canonry-integration-cloud-run": "0.0.0",
+    "@ainyc/canonry-integration-google": "0.0.0",
     "@ainyc/canonry-integration-google-ads": "0.0.0",
-    "@ainyc/canonry-integration-commoncrawl": "0.0.0",
     "@ainyc/canonry-integration-google-places": "0.0.0",
     "@ainyc/canonry-integration-google-business-profile": "0.0.0",
     "@ainyc/canonry-integration-google-tag-manager": "0.0.0",
-    "@ainyc/canonry-integration-traffic": "0.0.0",
     "@ainyc/canonry-integration-wordpress": "0.0.0",
     "@ainyc/canonry-intelligence": "0.0.0",
-    "@ainyc/canonry-provider-cdp": "0.0.0",
+    "@ainyc/canonry-integration-traffic": "0.0.0",
     "@ainyc/canonry-provider-local": "0.0.0",
-    "@ainyc/canonry-integration-google": "0.0.0",
-    "@ainyc/canonry-provider-openai": "0.0.0",
-    "@ainyc/canonry-provider-perplexity": "0.0.0",
     "@ainyc/canonry-provider-gemini": "0.0.0",
-    "@ainyc/canonry-provider-claude": "0.0.0"
+    "@ainyc/canonry-provider-cdp": "0.0.0",
+    "@ainyc/canonry-provider-openai": "0.0.0",
+    "@ainyc/canonry-provider-claude": "0.0.0",
+    "@ainyc/canonry-provider-perplexity": "0.0.0"
   },
   "scripts": {
     "build": "tsx scripts/copy-agent-assets.ts && tsup && tsx build-web.ts",