@canonry/canonry 4.116.0 → 4.117.1

package/dist/cli.js

@@ -29,7 +29,7 @@ import {
   setTelemetrySource,
   showFirstRunNotice,
   trackEvent
-} from "./chunk-GV665WOU.js";
+} from "./chunk-NY7SC4ES.js";
 import {
   CliError,
   EXIT_SYSTEM_ERROR,
@@ -46,7 +46,7 @@ import {
   saveConfig,
   saveConfigPatch,
   usageError
-} from "./chunk-RVH6QPTA.js";
+} from "./chunk-BMBHUFMI.js";
 import {
   apiKeys,
   createClient,
@@ -54,7 +54,7 @@ import {
   projects,
   queries,
   renderReportHtml
-} from "./chunk-WEAXJ25Y.js";
+} from "./chunk-V4SW7SVX.js";
 import {
   BacklinkSources,
   CcReleaseSyncStatuses,
@@ -80,7 +80,7 @@ import {
   providerQuotaPolicySchema,
   resolveProviderInput,
   winnabilityClassSchema
-} from "./chunk-IQPMK36Y.js";
+} from "./chunk-IAJ5TQ4S.js";
 
 // src/cli.ts
 import { pathToFileURL } from "url";
@@ -11841,6 +11841,78 @@ async function showVisibilityStats(project, opts) {
 function pct3(rate) {
   return rate === null ? "\u2014" : formatRatio(rate);
 }
+async function showVisibilityCompare(project, opts) {
+  if (!opts.from || !opts.to) throw new Error("visibility-compare requires --from <YYYY-MM> and --to <YYYY-MM>");
+  const client = createApiClient();
+  const data = await client.getVisibilityCompare(project, opts.from, opts.to);
+  if (isMachineFormat(opts.format)) {
+    console.log(JSON.stringify(data, null, 2));
+    return;
+  }
+  printVisibilityCompare(data);
+}
+function periodCell(p) {
+  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)}]`;
+}
+function verdictCell(m) {
+  switch (m.verdict) {
+    case "within-noise":
+      return "within noise";
+    case "insufficient-data":
+      return "no data";
+    case "moved":
+      return `moved ${m.direction === "down" ? "down" : m.direction === "up" ? "up" : ""}`.trim();
+    case "model-discontinuous":
+      return "model discontinuity";
+    case "model-unknown":
+      return "model unknown";
+  }
+}
+function printVisibilityCompare(data) {
+  console.log(`AEO month over month: ${data.project}   ${data.from.month} -> ${data.to.month}`);
+  const b = data.basket;
+  const excl = [];
+  if (b.excludedFromOnly > 0) excl.push(`${b.excludedFromOnly} only in ${data.from.month}`);
+  if (b.excludedToOnly > 0) excl.push(`${b.excludedToOnly} only in ${data.to.month}`);
+  if (b.excludedProviders.length > 0) excl.push(`engines dropped: ${b.excludedProviders.join(", ")}`);
+  console.log(`Basket: ${b.queryCount} quer${b.queryCount === 1 ? "y" : "ies"}, ${b.providers.length} engine(s)${excl.length ? ` (excluded: ${excl.join("; ")})` : ""}`);
+  const sweeps = `Sweeps: ${data.from.month} ${data.from.runCount}, ${data.to.month} ${data.to.runCount}`;
+  const low = data.from.lowRunCount || data.to.lowRunCount;
+  console.log(low ? `${sweeps}  (below the 5-sweep floor \u2014 intervals are wide, a "moved" verdict is unlikely to be reachable)` : sweeps);
+  if (data.continuity.status !== "comparable") {
+    console.log(`Continuity: ${data.continuity.status.replace("-", " ")} \u2014 no directional call is made.`);
+  }
+  console.log("");
+  const rows = data.metrics.map((m) => ({
+    label: `${m.label}${m.driftRobust ? " *" : ""}`,
+    to: periodCell(m.to),
+    from: periodCell(m.from),
+    verdict: verdictCell(m)
+  }));
+  rows.push({
+    label: "Queries named (count)",
+    to: `${data.queriesMentioned.to.count} of ${data.queriesMentioned.to.of}`,
+    from: `${data.queriesMentioned.from.count} of ${data.queriesMentioned.from.of}`,
+    verdict: ""
+  });
+  const w = (sel, head) => Math.max(head.length, ...rows.map((r) => sel(r).length));
+  const lw = w((r) => r.label, "Metric");
+  const tw = w((r) => r.to, data.to.month);
+  const fw = w((r) => r.from, data.from.month);
+  console.log(`  ${"Metric".padEnd(lw)}  ${data.to.month.padEnd(tw)}  ${data.from.month.padEnd(fw)}  Verdict`);
+  for (const r of rows) {
+    console.log(`  ${r.label.padEnd(lw)}  ${r.to.padEnd(tw)}  ${r.from.padEnd(fw)}  ${r.verdict}`);
+  }
+  console.log("");
+  console.log("  * share of voice is less exposed to broad model-wide naming propensity; model continuity is still required.");
+  for (const provider of data.continuity.providers) {
+    if (provider.status !== "included") {
+      console.log(`  Excluded for model continuity: ${provider.provider} (${provider.fromModels.join("/") || "?"} -> ${provider.toModels.join("/") || "?"}; ${provider.status.replace("-", " ")})`);
+    }
+  }
+}
 function citedCell(c) {
   return `${c.cited}/${c.total}`;
 }
@@ -11932,6 +12004,7 @@ function printVisibilityStats(data) {
 
 // src/cli-commands/visibility-stats.ts
 var USAGE4 = "canonry visibility-stats <project> [--since <iso>] [--until <iso>] [--month <YYYY-MM>] [--last-runs <n>] [--by-provider] [--share-of-voice] [--format json|jsonl]";
+var COMPARE_USAGE = "canonry visibility-compare <project> --from <YYYY-MM> --to <YYYY-MM> [--format json]";
 var VISIBILITY_STATS_CLI_COMMANDS = [
   {
     path: ["visibility-stats"],
@@ -11960,6 +12033,22 @@ var VISIBILITY_STATS_CLI_COMMANDS = [
         format: input.format
       });
     }
+  },
+  {
+    path: ["visibility-compare"],
+    usage: COMPARE_USAGE,
+    options: {
+      from: stringOption(),
+      to: stringOption()
+    },
+    run: async (input) => {
+      const project = requireProject(input, "visibility-compare", COMPARE_USAGE);
+      await showVisibilityCompare(project, {
+        from: getString(input.values, "from"),
+        to: getString(input.values, "to"),
+        format: input.format
+      });
+    }
   }
 ];
 

package/dist/index.js

@@ -1,11 +1,11 @@
 import {
   createServer
-} from "./chunk-GV665WOU.js";
+} from "./chunk-NY7SC4ES.js";
 import {
   loadConfig
-} from "./chunk-RVH6QPTA.js";
-import "./chunk-WEAXJ25Y.js";
-import "./chunk-IQPMK36Y.js";
+} from "./chunk-BMBHUFMI.js";
+import "./chunk-V4SW7SVX.js";
+import "./chunk-IAJ5TQ4S.js";
 export {
   createServer,
   loadConfig

package/dist/{intelligence-service-HEN5HLUM.js → intelligence-service-C5YLASIP.js}

@@ -1,7 +1,7 @@
 import {
   IntelligenceService
-} from "./chunk-WEAXJ25Y.js";
-import "./chunk-IQPMK36Y.js";
+} from "./chunk-V4SW7SVX.js";
+import "./chunk-IAJ5TQ4S.js";
 export {
   IntelligenceService
 };

package/dist/mcp.js

@@ -3,10 +3,10 @@ import {
   PACKAGE_VERSION,
   canonryMcpTools,
   createApiClient
-} from "./chunk-RVH6QPTA.js";
+} from "./chunk-BMBHUFMI.js";
 import {
   isReadOnlyKey
-} from "./chunk-IQPMK36Y.js";
+} from "./chunk-IAJ5TQ4S.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.116.0",
+  "version": "4.117.1",
   "type": "module",
   "description": "Agent-first open-source AEO operating platform - track how answer engines cite your domain",
   "license": "FSL-1.1-ALv2",
@@ -65,27 +65,27 @@
     "@types/node-cron": "^3.0.11",
     "tsup": "^8.5.1",
     "tsx": "^4.19.0",
+    "@ainyc/canonry-config": "0.0.0",
     "@ainyc/canonry-api-client": "0.0.0",
     "@ainyc/canonry-api-routes": "0.0.0",
-    "@ainyc/canonry-config": "0.0.0",
-    "@ainyc/canonry-contracts": "0.0.0",
     "@ainyc/canonry-db": "0.0.0",
-    "@ainyc/canonry-integration-cloud-run": "0.0.0",
+    "@ainyc/canonry-contracts": "0.0.0",
     "@ainyc/canonry-integration-bing": "0.0.0",
     "@ainyc/canonry-integration-openai-ads": "0.0.0",
-    "@ainyc/canonry-integration-google": "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-traffic": "0.0.0",
     "@ainyc/canonry-integration-wordpress": "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-provider-cdp": "0.0.0",
+    "@ainyc/canonry-integration-google-places": "0.0.0",
     "@ainyc/canonry-provider-claude": "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-local": "0.0.0"
+    "@ainyc/canonry-provider-openai": "0.0.0",
+    "@ainyc/canonry-provider-local": "0.0.0",
+    "@ainyc/canonry-provider-perplexity": "0.0.0"
   },
   "scripts": {
     "build": "tsx scripts/copy-agent-assets.ts && tsup && tsx build-web.ts",