@canonry/canonry 4.172.1 → 4.172.3

package/dist/cli.js

@@ -26,11 +26,11 @@ import {
   showFirstRunNotice,
   trackCliCommandFinished,
   trackEvent
-} from "./chunk-IAX4WRAR.js";
+} from "./chunk-OHSUOEVB.js";
 import {
   autoSyncSkills,
   formatAutoSyncNotice
-} from "./chunk-7L4453BU.js";
+} from "./chunk-WFVK3XC7.js";
 import {
   CliError,
   EXIT_SYSTEM_ERROR,
@@ -55,7 +55,7 @@ import {
   saveConfigPatch,
   systemError,
   usageError
-} from "./chunk-5MRE2TXR.js";
+} from "./chunk-BZDNTUCZ.js";
 import {
   CLOUDFLARE_WORKER_BINDINGS,
   CLOUDFLARE_WORKER_GENERATED_MARKER,
@@ -69,7 +69,7 @@ import {
   projects,
   queries,
   renderReportHtml
-} from "./chunk-3XN226N6.js";
+} from "./chunk-XEWBDO5L.js";
 import {
   AdsDeliverySnapshotStatuses,
   AdsHistoricalCampaignRollupStatuses,
@@ -137,7 +137,7 @@ import {
   providerQuotaPolicySchema,
   resolveProviderInput,
   winnabilityClassSchema
-} from "./chunk-X63CLHYM.js";
+} from "./chunk-WGN2VT7L.js";
 
 // src/cli.ts
 import { pathToFileURL } from "url";
@@ -7792,6 +7792,41 @@ async function googlePerformanceDaily(project, opts) {
 Trend (least-squares fit over ${days} day${days === 1 ? "" : "s"}):`);
     for (const line of trendLines) console.log(line);
   }
+  const cmp = data.periodComparison;
+  if (cmp && !cmp.comparable) {
+    console.log(
+      `
+No period comparison: period comparison needs property-level daily data. Sync again, or pick a range covered by property totals.`
+    );
+  } else if (cmp) {
+    const pct4 = (ratio, prior, trailing, inverted) => {
+      if (ratio === null) {
+        if (prior !== null && trailing !== null && prior <= 0 && trailing > 0) {
+          return `new in last ${cmp.days} day${cmp.days === 1 ? "" : "s"}`;
+        }
+        if (prior === null || prior <= 0) return "no prior period to compare";
+        if (trailing === null) return `no value in last ${cmp.days} day${cmp.days === 1 ? "" : "s"}`;
+        return "comparison unavailable";
+      }
+      if (ratio === 0) return "no change";
+      const better = inverted ? ratio < 0 : ratio > 0;
+      const magnitude = Math.abs(ratio * 100);
+      const shown = magnitude < 0.1 ? "<0.1" : magnitude.toFixed(1);
+      return `${ratio > 0 ? "+" : "-"}${shown}%  ${better ? "better" : "worse"}`;
+    };
+    console.log(
+      `
+Last ${cmp.days} day${cmp.days === 1 ? "" : "s"} (${cmp.trailing.startDate} to ${cmp.trailing.endDate}) vs prior ${cmp.days} (${cmp.prior.startDate} to ${cmp.prior.endDate}):`
+    );
+    for (const [label, ratio, prior, trailing, inverted] of [
+      ["Clicks", cmp.change.clicks, cmp.prior.clicks, cmp.trailing.clicks, false],
+      ["Impressions", cmp.change.impressions, cmp.prior.impressions, cmp.trailing.impressions, false],
+      ["CTR", cmp.change.ctr, cmp.prior.ctr, cmp.trailing.ctr, false],
+      ["Position", cmp.change.position, cmp.prior.position, cmp.trailing.position, true]
+    ]) {
+      console.log(`  ${`${label}:`.padEnd(13)}${pct4(ratio, prior, trailing, inverted)}`);
+    }
+  }
   console.log();
   console.log(`  ${"DATE".padEnd(12)}${"CLICKS".padStart(10)}${"IMPR".padStart(12)}${"CTR".padStart(10)}${"POS".padStart(9)}`);
   console.log(`  ${"\u2500".repeat(12)}${"\u2500".repeat(10)}${"\u2500".repeat(12)}${"\u2500".repeat(10)}${"\u2500".repeat(9)}`);
@@ -13080,14 +13115,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 +16158,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 +16185,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 +16206,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 +16227,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 +16333,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 +16348,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 +16367,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 +16383,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-OHSUOEVB.js";
 import {
   loadConfig
-} from "./chunk-5MRE2TXR.js";
-import "./chunk-3XN226N6.js";
-import "./chunk-X63CLHYM.js";
+} from "./chunk-BZDNTUCZ.js";
+import "./chunk-XEWBDO5L.js";
+import "./chunk-WGN2VT7L.js";
 export {
   GoogleMarketingRuntimeError,
   createGoogleMarketingCredentialStore,

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

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

package/dist/mcp.js

@@ -1,15 +1,15 @@
 import {
   autoSyncSkills
-} from "./chunk-7L4453BU.js";
+} from "./chunk-WFVK3XC7.js";
 import {
   CliError,
   PACKAGE_VERSION,
   canonryMcpTools,
   createApiClient
-} from "./chunk-5MRE2TXR.js";
+} from "./chunk-BZDNTUCZ.js";
 import {
   isReadOnlyKey
-} from "./chunk-X63CLHYM.js";
+} from "./chunk-WGN2VT7L.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.3",
   "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-contracts": "0.0.0",
-    "@ainyc/canonry-integration-bing": "0.0.0",
     "@ainyc/canonry-db": "0.0.0",
+    "@ainyc/canonry-integration-bing": "0.0.0",
     "@ainyc/canonry-integration-cloudflare-queue": "0.0.0",
+    "@ainyc/canonry-api-routes": "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-ads": "0.0.0",
+    "@ainyc/canonry-integration-google": "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-ads": "0.0.0",
+    "@ainyc/canonry-config": "0.0.0",
+    "@ainyc/canonry-integration-google-places": "0.0.0",
     "@ainyc/canonry-integration-google-tag-manager": "0.0.0",
+    "@ainyc/canonry-intelligence": "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-provider-gemini": "0.0.0",
+    "@ainyc/canonry-provider-claude": "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-perplexity": "0.0.0"
   },
   "scripts": {
     "build": "tsx scripts/copy-agent-assets.ts && tsup && tsx build-web.ts",