@canonry/canonry 5.20.3 → 5.21.0

package/dist/{chunk-PXVJ3P5G.js → chunk-FRWZWJB3.js}

@@ -5,7 +5,7 @@ import {
   PACKAGE_VERSION,
   canonryMcpTools,
   isMachineFormat
-} from "./chunk-JJPZ4OQ2.js";
+} from "./chunk-WUT3G2GM.js";
 import {
   AGENT_PROVIDER_IDS,
   CANONRY_NPM_PACKAGE_URL,
@@ -37,7 +37,7 @@ import {
   skillsClientSchema,
   upgradeCaveatFor,
   upgradeCommandFor
-} from "./chunk-TOSPZ7I5.js";
+} from "./chunk-2LO7FLVD.js";
 
 // src/config.ts
 import fs from "fs";
@@ -8891,12 +8891,12 @@ var ApiClient = class {
       })
     );
   }
-  async getVisibilityCompare(project, from, to) {
+  async getVisibilityCompare(project, from, to, selection = {}) {
     return this.invoke(
       () => getApiV1ProjectsByNameVisibilityCompare({
         client: this.heyClient,
         path: { name: project },
-        query: { from, to }
+        query: { from, to, ...selection }
       })
     );
   }

package/dist/{chunk-KHNPBUUN.js → chunk-HDJHQPW3.js}

@@ -5,12 +5,12 @@ import {
   siteCrawlGraphNodes,
   siteCrawlPages,
   siteCrawlSnapshots
-} from "./chunk-7YGOE4R2.js";
+} from "./chunk-FAVYLZQV.js";
 import {
   SITE_CRAWL_GRAPH_MAX_EDGES,
   SITE_CRAWL_GRAPH_MAX_NODES,
   TEMPLATE_LINK_RATIO_THRESHOLD
-} from "./chunk-TOSPZ7I5.js";
+} from "./chunk-2LO7FLVD.js";
 
 // src/site-crawl-graph-layout.ts
 import crypto from "crypto";

package/dist/{chunk-CVUR3O5G.js → chunk-MEAKE5W7.js}

@@ -4,14 +4,14 @@ import {
   installSkills,
   loadConfigRaw,
   saveConfigPatch
-} from "./chunk-PXVJ3P5G.js";
+} from "./chunk-FRWZWJB3.js";
 import {
   PACKAGE_VERSION
-} from "./chunk-JJPZ4OQ2.js";
+} from "./chunk-WUT3G2GM.js";
 import {
   SKILL_MANIFEST_FILENAME,
   SkillsClients
-} from "./chunk-TOSPZ7I5.js";
+} from "./chunk-2LO7FLVD.js";
 
 // src/skills-autosync.ts
 import fs from "fs";

package/dist/{chunk-H6XSHOS5.js → chunk-NFN5GSEJ.js}

@@ -13,19 +13,19 @@ import {
   resolveOperatorApiKeyIds,
   runWithUsageTags,
   saveConfigPatch
-} from "./chunk-PXVJ3P5G.js";
+} from "./chunk-FRWZWJB3.js";
 import {
   deleteSiteCrawlGraphLayout,
   persistSiteCrawlGraphLayout,
   prepareSiteCrawlGraphLayout
-} from "./chunk-KHNPBUUN.js";
+} from "./chunk-HDJHQPW3.js";
 import {
   CanonryMcpToolNames,
   CliError,
   PACKAGE_VERSION,
   canonryMcpTools,
   isMachineFormat
-} from "./chunk-JJPZ4OQ2.js";
+} from "./chunk-WUT3G2GM.js";
 import {
   CC_CACHE_DIR,
   DUCKDB_SPEC,
@@ -186,7 +186,7 @@ import {
   siteLivenessState,
   toAlertView,
   usageCounters
-} from "./chunk-7YGOE4R2.js";
+} from "./chunk-FAVYLZQV.js";
 import {
   AGENT_MEMORY_VALUE_MAX_BYTES,
   AGENT_NONE,
@@ -353,7 +353,7 @@ import {
   visibilityReportRequestSchema,
   winnabilityClassLabel,
   withRetry
-} from "./chunk-TOSPZ7I5.js";
+} from "./chunk-2LO7FLVD.js";
 
 // src/runtime-context.ts
 function cliRuntimeContext(env = process.env, stdio = process) {
@@ -6648,7 +6648,7 @@ function nonBlank(value) {
   return trimmed ? trimmed : void 0;
 }
 function resolveBuildCommit(env = process.env) {
-  const embedded = true ? "391e3197a54a3b85226958ac923a021d124eaf60" : void 0;
+  const embedded = true ? "9367462bc55240da41850bf9358ec7327c387258" : void 0;
   return nonBlank(embedded) ?? nonBlank(env.CANONRY_COMMIT);
 }
 function resolveInstanceIdentity(env = process.env) {
@@ -12235,7 +12235,7 @@ function readStoredGroundingSources(rawResponse) {
   return result2;
 }
 async function backfillInsightsCommand(project, opts) {
-  const { IntelligenceService: IntelligenceService2 } = await import("./intelligence-service-H4LGPJLZ.js");
+  const { IntelligenceService: IntelligenceService2 } = await import("./intelligence-service-3UUKRAZ5.js");
   const config = loadConfig();
   const db = createClient(config.database);
   migrate(db);

package/dist/{chunk-JJPZ4OQ2.js → chunk-WUT3G2GM.js}

@@ -104,8 +104,9 @@ import {
   trafficConnectWordpressRequestSchema,
   trafficEventKindSchema,
   trafficSeriesGranularitySchema,
+  visibilityCompareSelectionSchema,
   visibilityReportRequestSchema
-} from "./chunk-TOSPZ7I5.js";
+} from "./chunk-2LO7FLVD.js";
 
 // src/cli-error.ts
 function isMachineFormat(format) {
@@ -1579,17 +1580,18 @@ var canonryMcpTools = [
   defineTool({
     name: "canonry_visibility_compare",
     title: "Compare AEO visibility month over month",
-    description: "Statistically honest month-over-month AEO comparison in ONE call \u2014 use this instead of hand-computing deltas from two visibility-stats calls. Share of voice (`mention-share-of-voice`, `driftRobust: true`) is less exposed to broad model-wide naming propensity than absolute rates, but it never overrides model continuity. The response restricts to common query/provider pairs, then includes only providers with exactly one known, identical configured model id in both months. `continuity` surfaces every provider, its model evidence, and whether it was excluded for a changed, mixed mid-month, or unknown model. When no provider remains, metrics return `model-discontinuous` or `model-unknown`, never a directional call. A silent upstream version bump under an unchanged configured id remains undetectable. `from` must be a month strictly before `to`.",
+    description: "Statistically honest month-over-month AEO comparison in ONE call \u2014 use this instead of hand-computing deltas from two visibility-stats calls. Share of voice (`mention-share-of-voice`, `driftRobust: true`) is less exposed to broad model-wide naming propensity than absolute rates, but it never overrides model continuity. Branded and non-brand mention/cited rates are separate additive metrics; classification-unavailable never falls back to pooling. provider and location narrow every frame; scope, scopeKey and marketKey answer from the frozen Advanced frame alone (refused when a month holds unreconstructable schema-v1 runs) and deduplicate shared executions. Without scope/marketKey, Advanced class metrics use classComparison for their basket and continuity while the four original metrics keep the project frame. On frozen frames, answers with incomplete source capture leave every citation figure (excludedUnknown). The response restricts to common query/provider pairs, then includes only providers with exactly one known, identical configured model id in both months. `continuity` surfaces every provider, its model evidence, and whether it was excluded for a changed, mixed mid-month, or unknown model. When no provider remains, metrics return `model-discontinuous` or `model-unknown`, never a directional call. A silent upstream version bump under an unchanged configured id remains undetectable. `from` must be a month strictly before `to`.",
     access: "read",
     tier: "monitoring",
     inputSchema: z3.object({
       project: projectNameSchema,
+      ...visibilityCompareSelectionSchema.shape,
       from: z3.string().describe('Earlier calendar month (YYYY-MM), the baseline. Must be strictly before "to".'),
       to: z3.string().describe('Later calendar month (YYYY-MM), compared against "from".')
     }),
     annotations: readAnnotations(),
     openApiOperations: ["GET /api/v1/projects/{name}/visibility-compare"],
-    handler: (client, input) => client.getVisibilityCompare(input.project, input.from, input.to)
+    handler: (client, input) => client.getVisibilityCompare(input.project, input.from, input.to, { scope: input.scope, scopeKey: input.scopeKey, marketKey: input.marketKey, provider: input.provider, location: input.location })
   }),
   defineTool({
     name: "canonry_content_targets",

package/dist/cli.js

@@ -35,11 +35,11 @@ import {
   trackCliCommandFinished,
   trackEvent,
   waitForServerRuntimeStartup
-} from "./chunk-H6XSHOS5.js";
+} from "./chunk-NFN5GSEJ.js";
 import {
   autoSyncSkills,
   formatAutoSyncNotice
-} from "./chunk-CVUR3O5G.js";
+} from "./chunk-MEAKE5W7.js";
 import {
   configExists,
   createApiClient,
@@ -56,13 +56,13 @@ import {
   saveConfig,
   saveConfigPatch,
   shouldPrintServeSkillsNudge
-} from "./chunk-PXVJ3P5G.js";
+} from "./chunk-FRWZWJB3.js";
 import {
   DEFAULT_DEMO_TRUSTED_PROXIES,
   trustedProxiesProblem,
   trustedProxyProblem
 } from "./chunk-RB2F4D3Z.js";
-import "./chunk-KHNPBUUN.js";
+import "./chunk-HDJHQPW3.js";
 import {
   CliError,
   EXIT_SYSTEM_ERROR,
@@ -74,7 +74,7 @@ import {
   runMeasurementDraftAction,
   systemError,
   usageError
-} from "./chunk-JJPZ4OQ2.js";
+} from "./chunk-WUT3G2GM.js";
 import {
   CLOUDFLARE_WORKER_BINDINGS,
   CLOUDFLARE_WORKER_GENERATED_MARKER,
@@ -89,7 +89,7 @@ import {
   queries,
   renderReportHtml,
   runs
-} from "./chunk-7YGOE4R2.js";
+} from "./chunk-FAVYLZQV.js";
 import {
   AdsDeliverySnapshotStatuses,
   AdsHistoricalCampaignRollupStatuses,
@@ -146,6 +146,7 @@ import {
   formatRunErrorOneLine,
   formatWholePercent,
   googleAdsMetricsWindowSchema,
+  isVisibilityCompareClassMetric,
   logQuerySchema,
   measurementChangesQuerySchema,
   measurementDataQualityQuerySchema,
@@ -175,9 +176,10 @@ import {
   shareOfVoiceLabel,
   shareOfVoiceReason,
   snapshotProviderModeSchema,
+  visibilityCompareSelectionSchema,
   visibilityReportRequestSchema,
   winnabilityClassSchema
-} from "./chunk-TOSPZ7I5.js";
+} from "./chunk-2LO7FLVD.js";
 
 // src/cli.ts
 import { pathToFileURL } from "url";
@@ -442,7 +444,7 @@ function parseDemoTrustedProxies(values) {
 async function demoCommand(options) {
   const { host, port } = parseDemoListenOptions(options);
   const trustProxy = parseDemoTrustedProxies(options.trustProxy);
-  const { createDemoServer } = await import("./demo-server-JYDAUEP2.js");
+  const { createDemoServer } = await import("./demo-server-7BVVVXPM.js");
   const app = await createDemoServer({ trustProxy });
   let stopping = false;
   const stop = () => {
@@ -17420,7 +17422,7 @@ function pct3(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);
+  const data = await client.getVisibilityCompare(project, opts.from, opts.to, { scope: opts.scope, scopeKey: opts.scopeKey, marketKey: opts.marketKey, provider: opts.provider, location: opts.location });
   if (isMachineFormat(opts.format)) {
     console.log(JSON.stringify(data, null, 2));
     return;
@@ -17428,6 +17430,7 @@ async function showVisibilityCompare(project, opts) {
   printVisibilityCompare(data);
 }
 function periodCell(p) {
+  if (p.availability === "classification-unavailable") return "unavailable: query classification";
   if (p.availability === "no-competitive-frame") {
     return `unavailable: no competitive frame (${p.numerator} observed)`;
   }
@@ -17450,12 +17453,24 @@ function verdictCell(m) {
   }
 }
 function metricQueryClassLabel(metric) {
+  if (metric.queryClass === "branded") return "branded queries";
   if (metric.queryClass === "non-brand") return "non-brand queries";
   if (metric.queryClass === "pooled") return "pooled queries; classification unavailable";
   return "all queries";
 }
+function selectionLabel(selection) {
+  if (!selection) return null;
+  const parts = [];
+  if (selection.scope && selection.scope !== "project") parts.push(`${selection.scope} ${selection.scopeKey ?? ""}`.trim());
+  if (selection.marketKey) parts.push(`market ${selection.marketKey}`);
+  if (selection.provider) parts.push(`engine ${selection.provider}`);
+  if (selection.location) parts.push(`location ${selection.location}`);
+  return parts.length > 0 ? parts.join(" \xB7 ") : null;
+}
 function printVisibilityCompare(data) {
   console.log(`AEO month over month: ${data.project}   ${data.from.month} -> ${data.to.month}`);
+  const selection = selectionLabel(data.selection);
+  if (selection) console.log(`Selection: ${selection}`);
   const b = data.basket;
   const excl = [];
   if (b.excludedFromOnly > 0) excl.push(`${b.excludedFromOnly} only in ${data.from.month}`);
@@ -17469,8 +17484,19 @@ function printVisibilityCompare(data) {
     console.log(`Continuity: ${data.continuity.status.replace("-", " ")} \u2014 no directional call is made.`);
   }
   console.log("");
+  if (data.classComparison) {
+    const frame = data.classComparison;
+    console.log(`Class metrics basket (frozen Advanced): ${frame.basket.queryCount} queries; engines: ${frame.basket.providers.join(", ") || "none"}`);
+    const classSweeps = `Class basket sweeps: ${frame.from.month} ${frame.from.runCount}, ${frame.to.month} ${frame.to.runCount}; continuity: ${frame.continuity.status}`;
+    const classLow = frame.from.lowRunCount || frame.to.lowRunCount;
+    console.log(classLow ? `${classSweeps}  (below the 5-sweep floor \u2014 class intervals are wide, a "moved" verdict is unlikely to be reachable)` : classSweeps);
+    for (const provider of frame.continuity.providers) {
+      if (provider.status !== "included") console.log(`Class basket excludes ${provider.provider}: ${provider.fromModels.join("/") || "?"} -> ${provider.toModels.join("/") || "?"} (${provider.status})`);
+    }
+    console.log("");
+  }
   const rows = data.metrics.map((m) => ({
-    label: `${m.label} \xB7 ${metricQueryClassLabel(m)}${m.driftRobust ? " *" : ""}`,
+    label: `${m.label} \xB7 ${metricQueryClassLabel(m)}${data.classComparison && isVisibilityCompareClassMetric(m.key) ? " \xB7 class basket" : ""}${m.driftRobust ? " *" : ""}`,
     to: periodCell(m.to),
     from: periodCell(m.from),
     verdict: verdictCell(m)
@@ -17600,7 +17626,32 @@ function parseQueryClass(value) {
   }
   return value;
 }
-var COMPARE_USAGE = "canonry visibility-compare <project> --from <YYYY-MM> --to <YYYY-MM> [--format json]";
+var COMPARE_USAGE = "canonry visibility-compare <project> --from <YYYY-MM> --to <YYYY-MM> [--scope project|group|market|property] [--scope-key <key>] [--market-key <key>] [--provider <engine>] [--location <label|none>] [--format json]";
+var COMPARE_SELECTION_FLAGS = {
+  scope: "--scope",
+  scopeKey: "--scope-key",
+  marketKey: "--market-key",
+  provider: "--provider",
+  location: "--location"
+};
+function parseCompareSelection(values) {
+  const parsed = visibilityCompareSelectionSchema.safeParse({
+    scope: getString(values, "scope"),
+    scopeKey: getString(values, "scope-key"),
+    marketKey: getString(values, "market-key"),
+    provider: getString(values, "provider"),
+    location: getString(values, "location")
+  });
+  if (parsed.success) return parsed.data;
+  const issue = parsed.error.issues[0];
+  const flag = COMPARE_SELECTION_FLAGS[String(issue.path[0])] ?? "--scope";
+  const message = flag === "--scope" ? "--scope must be one of: project, group, market, property" : `${flag} must not be empty`;
+  throw usageError(`Error: ${message}
+Usage: ${COMPARE_USAGE}`, {
+    message,
+    details: { command: "visibility-compare", usage: COMPARE_USAGE }
+  });
+}
 var VISIBILITY_STATS_CLI_COMMANDS = [
   {
     path: ["visibility-stats"],
@@ -17637,13 +17688,19 @@ var VISIBILITY_STATS_CLI_COMMANDS = [
     usage: COMPARE_USAGE,
     options: {
       from: stringOption(),
-      to: stringOption()
+      to: stringOption(),
+      scope: stringOption(),
+      "scope-key": stringOption(),
+      "market-key": stringOption(),
+      provider: stringOption(),
+      location: 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"),
+        ...parseCompareSelection(input.values),
         format: input.format
       });
     }

package/dist/{demo-server-JYDAUEP2.js → demo-server-7BVVVXPM.js}

@@ -4,11 +4,11 @@ import {
 import {
   layoutSiteCrawlGraphInput,
   persistSiteCrawlGraphLayout
-} from "./chunk-KHNPBUUN.js";
+} from "./chunk-HDJHQPW3.js";
 import {
   PACKAGE_VERSION,
   canonryMcpTools
-} from "./chunk-JJPZ4OQ2.js";
+} from "./chunk-WUT3G2GM.js";
 import {
   HISTORY_WINDOW_RUNS,
   IntelligenceService,
@@ -84,7 +84,7 @@ import {
   siteCrawlPages,
   siteCrawlSnapshots,
   trafficSources
-} from "./chunk-7YGOE4R2.js";
+} from "./chunk-FAVYLZQV.js";
 import {
   RunKinds,
   SiteCrawlFetchStates,
@@ -108,7 +108,7 @@ import {
   placementLinkDecision,
   siteAuditPageFactorSchema,
   wilsonInterval
-} from "./chunk-TOSPZ7I5.js";
+} from "./chunk-2LO7FLVD.js";
 
 // src/demo-server.ts
 import { dirname, join as join2 } from "path";

package/dist/index.js

@@ -3,14 +3,14 @@ import {
   createGoogleMarketingCredentialStore,
   createGoogleMarketingRuntime,
   createServer
-} from "./chunk-H6XSHOS5.js";
+} from "./chunk-NFN5GSEJ.js";
 import {
   loadConfig
-} from "./chunk-PXVJ3P5G.js";
-import "./chunk-KHNPBUUN.js";
-import "./chunk-JJPZ4OQ2.js";
-import "./chunk-7YGOE4R2.js";
-import "./chunk-TOSPZ7I5.js";
+} from "./chunk-FRWZWJB3.js";
+import "./chunk-HDJHQPW3.js";
+import "./chunk-WUT3G2GM.js";
+import "./chunk-FAVYLZQV.js";
+import "./chunk-2LO7FLVD.js";
 export {
   GoogleMarketingRuntimeError,
   createGoogleMarketingCredentialStore,

package/dist/{intelligence-service-H4LGPJLZ.js → intelligence-service-3UUKRAZ5.js}

@@ -1,8 +1,8 @@
 import {
   HISTORY_WINDOW_RUNS,
   IntelligenceService
-} from "./chunk-7YGOE4R2.js";
-import "./chunk-TOSPZ7I5.js";
+} from "./chunk-FAVYLZQV.js";
+import "./chunk-2LO7FLVD.js";
 export {
   HISTORY_WINDOW_RUNS,
   IntelligenceService

package/dist/mcp.js

@@ -1,15 +1,15 @@
 import {
   autoSyncSkills
-} from "./chunk-CVUR3O5G.js";
+} from "./chunk-MEAKE5W7.js";
 import {
   createApiClient,
   createCanonryMcpServer
-} from "./chunk-PXVJ3P5G.js";
-import "./chunk-JJPZ4OQ2.js";
+} from "./chunk-FRWZWJB3.js";
+import "./chunk-WUT3G2GM.js";
 import {
   isReadOnlyKey,
   updateCheckEnvOptOut
-} from "./chunk-TOSPZ7I5.js";
+} from "./chunk-2LO7FLVD.js";
 
 // src/mcp/cli.ts
 import { randomUUID } from "crypto";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@canonry/canonry",
-  "version": "5.20.3",
+  "version": "5.21.0",
   "type": "module",
   "description": "Self-hosted AI visibility (AEO) platform: track how ChatGPT, Claude, Gemini, and Perplexity cite your domain, join it with Search Console, GA4, server-side traffic, and paid media, and fix what you find through agent tools (CLI, REST, MCP). Local SQLite.",
   "keywords": [
@@ -86,32 +86,32 @@
     "@types/node-cron": "^3.0.11",
     "tsup": "^8.5.1",
     "tsx": "^4.19.0",
-    "@ainyc/canonry-api-client": "0.0.0",
-    "@ainyc/canonry-config": "0.0.0",
     "@ainyc/canonry-web": "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-config": "0.0.0",
     "@ainyc/canonry-db": "0.0.0",
-    "@ainyc/canonry-integration-cloud-run": "0.0.0",
-    "@ainyc/canonry-integration-cloudflare-worker": "0.0.0",
     "@ainyc/canonry-integration-bing": "0.0.0",
-    "@ainyc/canonry-integration-google": "0.0.0",
+    "@ainyc/canonry-integration-cloud-run": "0.0.0",
     "@ainyc/canonry-integration-cloudflare-queue": "0.0.0",
-    "@ainyc/canonry-integration-commoncrawl": "0.0.0",
+    "@ainyc/canonry-integration-google": "0.0.0",
+    "@ainyc/canonry-integration-cloudflare-worker": "0.0.0",
     "@ainyc/canonry-integration-google-ads": "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-commoncrawl": "0.0.0",
     "@ainyc/canonry-integration-google-tag-manager": "0.0.0",
     "@ainyc/canonry-integration-openai-ads": "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-provider-cdp": "0.0.0",
-    "@ainyc/canonry-provider-claude": "0.0.0",
-    "@ainyc/canonry-provider-local": "0.0.0",
     "@ainyc/canonry-provider-gemini": "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-perplexity": "0.0.0",
+    "@ainyc/canonry-provider-local": "0.0.0"
   },
   "scripts": {
     "build": "pnpm run build:cli && pnpm run build:web",