@canonry/canonry 5.20.4 → 5.22.0

package/dist/{chunk-TOSPZ7I5.js → chunk-S5OSY3PI.js}

@@ -13572,7 +13572,7 @@ var visibilityCompareVerdictSchema = z41.enum([
 var visibilityCompareDirectionSchema = z41.enum(["up", "down", "flat"]);
 var visibilityCompareMetricPeriodSchema = z41.object({
   /** Why this period can or cannot produce a proportion. Raw numerator counts remain visible when the frame is missing. */
-  availability: z41.enum(["available", "no-observations", "no-competitive-frame"]),
+  availability: z41.enum(["available", "no-observations", "no-competitive-frame", "classification-unavailable"]),
   /** The proportion in `[0,1]`, rounded to 4 dp; `null` when `denominator === 0` (undefined over no data). */
   point: z41.number().nullable(),
   /** Wilson 95% lower bound `[0,1]`; `null` when `denominator === 0`. */
@@ -13582,14 +13582,34 @@ var visibilityCompareMetricPeriodSchema = z41.object({
   /** Successes (mentions / citations / project-brand mentions), preserved even when the competitive frame is unavailable. */
   numerator: z41.number().int(),
   /** Sample size the proportion is over (checked snapshots / total / project+competitor brand mentions). */
-  denominator: z41.number().int()
+  denominator: z41.number().int(),
+  /**
+   * Observations missing this metric's own signal, excluded from its
+   * denominator: an unknown mention for a class mention rate, incomplete
+   * source capture for a class cited rate, and, on frames that record capture
+   * completeness (Advanced), for the pooled cited rate and cited share of voice.
+   */
+  excludedUnknown: z41.number().int().nonnegative().optional()
 });
 var visibilityCompareMetricKeySchema = z41.enum([
   "mention-share-of-voice",
   "cited-share-of-voice",
   "mention-rate",
-  "cited-rate"
+  "cited-rate",
+  "mention-rate-branded",
+  "cited-rate-branded",
+  "mention-rate-non-brand",
+  "cited-rate-non-brand"
 ]);
+var VISIBILITY_COMPARE_CLASS_METRIC_KEYS = [
+  "mention-rate-branded",
+  "cited-rate-branded",
+  "mention-rate-non-brand",
+  "cited-rate-non-brand"
+];
+function isVisibilityCompareClassMetric(key) {
+  return VISIBILITY_COMPARE_CLASS_METRIC_KEYS.includes(key);
+}
 var visibilityCompareMetricSchema = z41.object({
   key: visibilityCompareMetricKeySchema,
   /** Human label ("Named share of voice", "Cited rate", …). */
@@ -13598,7 +13618,7 @@ var visibilityCompareMetricSchema = z41.object({
    * Query class behind this metric. `all` is an intentional all-query rate;
    * `pooled` means no usable project identity existed for the requested split.
    */
-  queryClass: z41.enum(["all", "non-brand", "pooled"]),
+  queryClass: z41.enum(["all", "branded", "non-brand", "pooled"]),
   /**
    * `true` for share of voice, which is less exposed to broad model-wide naming
    * propensity than an absolute rate. It does not bypass model continuity: no
@@ -13681,12 +13701,33 @@ var visibilityCompareQueriesMentionedSchema = z41.object({
   from: z41.object({ count: z41.number().int(), of: z41.number().int() }),
   to: z41.object({ count: z41.number().int(), of: z41.number().int() })
 });
+var visibilityCompareSelectionSchema = z41.object({
+  scope: z41.enum(["project", "group", "market", "property"]).optional(),
+  scopeKey: z41.string().min(1).optional(),
+  marketKey: z41.string().min(1).optional(),
+  provider: z41.string().min(1).optional(),
+  location: z41.string().min(1).optional()
+});
+var visibilityCompareClassComparisonSchema = z41.object({
+  from: visibilityComparePeriodWindowSchema,
+  to: visibilityComparePeriodWindowSchema,
+  basket: visibilityCompareBasketSchema,
+  continuity: visibilityCompareContinuitySchema,
+  modelChanges: z41.array(visibilityCompareModelChangeSchema)
+});
 var visibilityCompareDtoSchema = z41.object({
   project: z41.string(),
+  selection: visibilityCompareSelectionSchema.optional(),
+  /** Frozen Advanced cohort used by the additive class metrics; legacy project metrics retain their original frame. */
+  classComparison: visibilityCompareClassComparisonSchema.optional(),
   from: visibilityComparePeriodWindowSchema,
   to: visibilityComparePeriodWindowSchema,
   basket: visibilityCompareBasketSchema,
-  /** Ordered: mention SoV (primary), cited SoV, mention rate (level), cited rate. */
+  /**
+   * Ordered: mention SoV (primary), cited SoV, mention rate (level), cited rate,
+   * then the class rates (`mention-rate-branded`, `cited-rate-branded`,
+   * `mention-rate-non-brand`, `cited-rate-non-brand`). Read metrics by `key`.
+   */
   metrics: z41.array(visibilityCompareMetricSchema),
   queriesMentioned: visibilityCompareQueriesMentionedSchema,
   byProvider: z41.array(visibilityCompareProviderRowSchema),
@@ -15010,12 +15051,27 @@ var checkCategorySchema = z50.enum([
   "agent"
 ]);
 var CheckCategories = checkCategorySchema.enum;
+var checkNotificationPolicySchema = z50.enum(["health", "silent"]);
+var CheckNotificationPolicies = checkNotificationPolicySchema.enum;
+var reportMonthSchema = z50.string().regex(/^[1-9]\d{3}-(0[1-9]|1[0-2])$/, "Expected YYYY-MM");
+function reportMonthsForDoctor(reportMonth, now = /* @__PURE__ */ new Date()) {
+  if (reportMonth !== void 0) return [reportMonthSchema.parse(reportMonth)];
+  const current = now.toISOString().slice(0, 7);
+  if (now.getUTCDate() > 3) return [current];
+  const previous = new Date(Date.parse(calendarMonthBounds(current).since) - 1).toISOString().slice(0, 7);
+  return [previous, current];
+}
+function gradedReportMonths(months, now = /* @__PURE__ */ new Date()) {
+  const current = now.toISOString().slice(0, 7);
+  return new Set(months.length > 1 ? months.filter((month) => month !== current) : months);
+}
 var checkResultSchema = z50.object({
   id: z50.string(),
   category: checkCategorySchema,
   scope: checkScopeSchema,
   title: z50.string(),
   status: checkStatusSchema,
+  notificationPolicy: checkNotificationPolicySchema.optional().describe("Health checks page by default. Silent report advisories remain visible but never affect health alert state."),
   code: z50.string().describe('Stable machine-readable code (e.g. "google.token.refresh-failed"). Use this for filtering and remediation logic.'),
   summary: z50.string(),
   remediation: z50.string().nullable().optional().describe('Operator-facing next step. Null when status is "ok" or no specific remediation applies.'),
@@ -15025,6 +15081,7 @@ var checkResultSchema = z50.object({
 var doctorReportSchema = z50.object({
   scope: checkScopeSchema,
   project: z50.string().nullable().describe('Project name when scope is "project", null otherwise.'),
+  reportMonths: z50.array(reportMonthSchema).optional().describe("Calendar months evaluated by project report readiness checks."),
   generatedAt: z50.string().describe("ISO-8601 timestamp when this doctor run started."),
   durationMs: z50.number().int().nonnegative(),
   summary: z50.object({
@@ -15056,6 +15113,15 @@ function summarizeCheckResults(results) {
   }
   return summary;
 }
+function groupIsoDateRanges(dates) {
+  const ranges = [];
+  for (const date of [...new Set(dates)].sort()) {
+    const previous = ranges.at(-1);
+    if (previous && shiftIsoCalendarDate(previous.end, 1) === date) previous.end = date;
+    else ranges.push({ start: date, end: date });
+  }
+  return ranges;
+}
 
 // ../contracts/src/index-coverage.ts
 function deriveIndexCoverage(input) {
@@ -20115,6 +20181,8 @@ export {
   windowCutoff,
   resolveDateRange,
   visibilityStatsDtoSchema,
+  isVisibilityCompareClassMetric,
+  visibilityCompareSelectionSchema,
   visibilityCompareDtoSchema,
   calendarMonthBounds,
   resultsExportDtoSchema,
@@ -20186,8 +20254,13 @@ export {
   CheckStatuses,
   CheckScopes,
   CheckCategories,
+  CheckNotificationPolicies,
+  reportMonthSchema,
+  reportMonthsForDoctor,
+  gradedReportMonths,
   doctorReportSchema,
   summarizeCheckResults,
+  groupIsoDateRanges,
   deriveIndexCoverage,
   normalizeQueryText,
   citationVisibilityResponseSchema,

package/dist/{chunk-P73YBGZP.js → chunk-XFHXKLNT.js}

@@ -13,19 +13,19 @@ import {
   resolveOperatorApiKeyIds,
   runWithUsageTags,
   saveConfigPatch
-} from "./chunk-PXVJ3P5G.js";
+} from "./chunk-GLLY2GEV.js";
 import {
   deleteSiteCrawlGraphLayout,
   persistSiteCrawlGraphLayout,
   prepareSiteCrawlGraphLayout
-} from "./chunk-TWLJRAWA.js";
+} from "./chunk-3LCR6WU6.js";
 import {
   CanonryMcpToolNames,
   CliError,
   PACKAGE_VERSION,
   canonryMcpTools,
   isMachineFormat
-} from "./chunk-JJPZ4OQ2.js";
+} from "./chunk-DDL2XSNM.js";
 import {
   CC_CACHE_DIR,
   DUCKDB_SPEC,
@@ -172,6 +172,7 @@ import {
   runChecks,
   runFills,
   runs,
+  scheduledHealthCheckIds,
   schedules,
   serializeUserSessionCookie,
   siteAuditPages,
@@ -186,7 +187,7 @@ import {
   siteLivenessState,
   toAlertView,
   usageCounters
-} from "./chunk-NSKFW3NF.js";
+} from "./chunk-P5VXVFQW.js";
 import {
   AGENT_MEMORY_VALUE_MAX_BYTES,
   AGENT_NONE,
@@ -201,6 +202,7 @@ import {
   CANONRY_NPM_PACKAGE_URL,
   CITED_URL_CAPTURE_VERSION,
   CcReleaseSyncStatuses,
+  CheckNotificationPolicies,
   DEFAULT_VIEWER_RESEARCH_DAILY_RUN_LIMIT,
   DiscoveryCompetitorTypes,
   GOOGLE_ADS_CAMPAIGN_METRICS_MAX_CAMPAIGNS,
@@ -303,6 +305,7 @@ import {
   hostMatchesAnyDomain,
   hostMatchesDomain,
   hostOf,
+  inclusiveDayCount,
   isAgentProviderId,
   isBrowserProvider,
   isGhostTelemetryEvent,
@@ -331,6 +334,7 @@ import {
   providerError,
   providerSupportsLocationContext,
   registrableDomain,
+  reportMonthsForDoctor,
   resolveProviderModel,
   resolveSnapshotRequestQueries,
   retryAfterDelayMs,
@@ -353,7 +357,7 @@ import {
   visibilityReportRequestSchema,
   winnabilityClassLabel,
   withRetry
-} from "./chunk-TOSPZ7I5.js";
+} from "./chunk-S5OSY3PI.js";
 
 // src/runtime-context.ts
 function cliRuntimeContext(env = process.env, stdio = process) {
@@ -6648,7 +6652,7 @@ function nonBlank(value) {
   return trimmed ? trimmed : void 0;
 }
 function resolveBuildCommit(env = process.env) {
-  const embedded = true ? "c87b5bdf06eeeab4fafa7742f07c1c91149c0b70" : void 0;
+  const embedded = true ? "120bbd89c1dedb8df5c2850da43ac2e71ccd3cdc" : void 0;
   return nonBlank(embedded) ?? nonBlank(env.CANONRY_COMMIT);
 }
 function resolveInstanceIdentity(env = process.env) {
@@ -12235,7 +12239,7 @@ function readStoredGroundingSources(rawResponse) {
   return result2;
 }
 async function backfillInsightsCommand(project, opts) {
-  const { IntelligenceService: IntelligenceService2 } = await import("./intelligence-service-QHSR2H7F.js");
+  const { IntelligenceService: IntelligenceService2 } = await import("./intelligence-service-CXNBKRHV.js");
   const config = loadConfig();
   const db = createClient(config.database);
   migrate(db);
@@ -13436,11 +13440,16 @@ function startSiteLivenessLoop(deps, intervalMs = SITE_LIVENESS_INTERVAL_MS) {
 
 // src/data-refresh.ts
 var log16 = createLogger("DataRefresh");
-async function refreshAllIntegrations(client, projectName) {
+function gaRefreshDays(now = /* @__PURE__ */ new Date()) {
+  const [reportMonth] = reportMonthsForDoctor(void 0, now);
+  const reach = inclusiveDayCount(`${reportMonth}-01`, now.toISOString().slice(0, 10)) ?? 0;
+  return Math.max(30, reach);
+}
+async function refreshAllIntegrations(client, projectName, now = /* @__PURE__ */ new Date()) {
   const integrations = [
     { name: "gsc", run: () => client.gscSync(projectName, {}) },
     { name: "bing", run: () => client.bingInspectSitemap(projectName, {}) },
-    { name: "ga", run: () => client.gaSync(projectName, { days: 30 }) },
+    { name: "ga", run: () => client.gaSync(projectName, { days: gaRefreshDays(now) }) },
     { name: "gbp", run: () => client.triggerGbpSync(projectName, {}) },
     // `ads` remains the OpenAI / ChatGPT Ads integration. For scheduled
     // refreshes, Google providers have explicit names and fan out only here.
@@ -13581,13 +13590,15 @@ var Notifier = class {
           return 0;
       }
     };
-    const graded = report.checks.filter((c) => c.status === "fail" || c.status === "warn" || c.status === "ok");
+    const healthChecks = report.checks.filter((c) => c.notificationPolicy !== CheckNotificationPolicies.silent);
+    if (healthChecks.length === 0 && report.checks.length > 0) return null;
+    const graded = healthChecks.filter((c) => c.status === "fail" || c.status === "warn" || c.status === "ok");
     const failing = graded.filter((c) => c.status !== "ok").sort((a, b) => rank(b.status) - rank(a.status) || categoryRank(b.category) - categoryRank(a.category) || a.id.localeCompare(b.id));
     const worst = failing.at(0) ?? null;
     const noSignal = graded.length === 0;
     const status = noSignal ? "warn" : worst ? worst.status : "ok";
     const code = noSignal ? "health.no-signal" : worst?.code ?? "health.ok";
-    const summary = noSignal ? `No health check produced a result (${report.checks.length} skipped) \u2014 health is unknown, not confirmed.` : worst?.summary ?? `All ${graded.length} health check(s) passing.`;
+    const summary = noSignal ? `No health check produced a result (${healthChecks.length} skipped) \u2014 health is unknown, not confirmed.` : worst?.summary ?? `All ${graded.length} health check(s) passing.`;
     const previous = this.db.select().from(doctorHealthState).where(eq17(doctorHealthState.projectId, projectId)).get();
     const previousStatus = previous?.status ?? null;
     const failingSignature = failing.map((c) => `${c.status}:${c.code}`).join(",");
@@ -19493,7 +19504,7 @@ async function createServer(opts) {
     onDoctorRequested: (projectName) => {
       void (async () => {
         try {
-          const report = await schedulerClient.runDoctor({ project: projectName });
+          const report = await schedulerClient.runDoctor({ project: projectName, checkIds: scheduledHealthCheckIds() });
           const project = opts.db.select().from(projects).where(eq27(projects.name, projectName)).get();
           if (!project) {
             app.log.warn({ projectName }, "doctor schedule fired for an unknown project");

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

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

package/dist/cli.js

@@ -35,11 +35,11 @@ import {
   trackCliCommandFinished,
   trackEvent,
   waitForServerRuntimeStartup
-} from "./chunk-P73YBGZP.js";
+} from "./chunk-XFHXKLNT.js";
 import {
   autoSyncSkills,
   formatAutoSyncNotice
-} from "./chunk-CVUR3O5G.js";
+} from "./chunk-YTSXQUJ3.js";
 import {
   configExists,
   createApiClient,
@@ -56,13 +56,13 @@ import {
   saveConfig,
   saveConfigPatch,
   shouldPrintServeSkillsNudge
-} from "./chunk-PXVJ3P5G.js";
+} from "./chunk-GLLY2GEV.js";
 import {
   DEFAULT_DEMO_TRUSTED_PROXIES,
   trustedProxiesProblem,
   trustedProxyProblem
 } from "./chunk-RB2F4D3Z.js";
-import "./chunk-TWLJRAWA.js";
+import "./chunk-3LCR6WU6.js";
 import {
   CliError,
   EXIT_SYSTEM_ERROR,
@@ -74,7 +74,7 @@ import {
   runMeasurementDraftAction,
   systemError,
   usageError
-} from "./chunk-JJPZ4OQ2.js";
+} from "./chunk-DDL2XSNM.js";
 import {
   CLOUDFLARE_WORKER_BINDINGS,
   CLOUDFLARE_WORKER_GENERATED_MARKER,
@@ -89,7 +89,7 @@ import {
   queries,
   renderReportHtml,
   runs
-} from "./chunk-NSKFW3NF.js";
+} from "./chunk-P5VXVFQW.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-S5OSY3PI.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-FH2K6TCD.js");
+  const { createDemoServer } = await import("./demo-server-HULNEORN.js");
   const app = await createDemoServer({ trustProxy });
   let stopping = false;
   const stop = () => {
@@ -3049,7 +3051,8 @@ async function doctorCommand(opts) {
   const client = createApiClient();
   const report = await client.runDoctor({
     project: opts.project,
-    checkIds: opts.checks
+    checkIds: opts.checks,
+    ...opts.reportMonth ? { reportMonth: opts.reportMonth } : {}
   });
   if (opts.format === "json") {
     console.log(JSON.stringify(report, null, 2));
@@ -3075,8 +3078,8 @@ async function runDoctorAll(opts) {
   const client = createApiClient();
   const projects2 = await client.listProjects();
   const [globalReport, ...projectReports] = await Promise.all([
-    client.runDoctor({ checkIds: opts.checks }),
-    ...projects2.map((p) => client.runDoctor({ project: p.name, checkIds: opts.checks }))
+    client.runDoctor({ checkIds: opts.checks, ...opts.reportMonth ? { reportMonth: opts.reportMonth } : {} }),
+    ...projects2.map((p) => client.runDoctor({ project: p.name, checkIds: opts.checks, ...opts.reportMonth ? { reportMonth: opts.reportMonth } : {} }))
   ]);
   const byKey = { __global__: globalReport };
   projects2.forEach((p, i) => {
@@ -3172,13 +3175,14 @@ ${header}`);
 }
 
 // src/cli-commands/doctor.ts
-var USAGE = "canonry doctor [--project <name>|--all] [--check <id>...] [--format json|jsonl]";
+var USAGE = "canonry doctor [--project <name>|--all] [--check <id>...] [--report-month YYYY-MM] [--format json|jsonl]";
 var DOCTOR_CLI_COMMANDS = [
   {
     path: ["doctor"],
     usage: USAGE,
     options: {
       project: stringOption(),
+      "report-month": stringOption(),
       check: multiStringOption(),
       all: { type: "boolean" }
     },
@@ -3186,6 +3190,7 @@ var DOCTOR_CLI_COMMANDS = [
     run: async (input) => {
       await doctorCommand({
         project: getString(input.values, "project"),
+        reportMonth: getString(input.values, "report-month"),
         all: getBoolean(input.values, "all"),
         checks: getStringArray(input.values, "check"),
         format: input.format
@@ -17420,7 +17425,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 +17433,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 +17456,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 +17487,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 +17629,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 +17691,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-FH2K6TCD.js → demo-server-HULNEORN.js}

@@ -4,11 +4,11 @@ import {
 import {
   layoutSiteCrawlGraphInput,
   persistSiteCrawlGraphLayout
-} from "./chunk-TWLJRAWA.js";
+} from "./chunk-3LCR6WU6.js";
 import {
   PACKAGE_VERSION,
   canonryMcpTools
-} from "./chunk-JJPZ4OQ2.js";
+} from "./chunk-DDL2XSNM.js";
 import {
   HISTORY_WINDOW_RUNS,
   IntelligenceService,
@@ -84,7 +84,7 @@ import {
   siteCrawlPages,
   siteCrawlSnapshots,
   trafficSources
-} from "./chunk-NSKFW3NF.js";
+} from "./chunk-P5VXVFQW.js";
 import {
   RunKinds,
   SiteCrawlFetchStates,
@@ -108,7 +108,7 @@ import {
   placementLinkDecision,
   siteAuditPageFactorSchema,
   wilsonInterval
-} from "./chunk-TOSPZ7I5.js";
+} from "./chunk-S5OSY3PI.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-P73YBGZP.js";
+} from "./chunk-XFHXKLNT.js";
 import {
   loadConfig
-} from "./chunk-PXVJ3P5G.js";
-import "./chunk-TWLJRAWA.js";
-import "./chunk-JJPZ4OQ2.js";
-import "./chunk-NSKFW3NF.js";
-import "./chunk-TOSPZ7I5.js";
+} from "./chunk-GLLY2GEV.js";
+import "./chunk-3LCR6WU6.js";
+import "./chunk-DDL2XSNM.js";
+import "./chunk-P5VXVFQW.js";
+import "./chunk-S5OSY3PI.js";
 export {
   GoogleMarketingRuntimeError,
   createGoogleMarketingCredentialStore,

package/dist/{intelligence-service-QHSR2H7F.js → intelligence-service-CXNBKRHV.js}

@@ -1,8 +1,8 @@
 import {
   HISTORY_WINDOW_RUNS,
   IntelligenceService
-} from "./chunk-NSKFW3NF.js";
-import "./chunk-TOSPZ7I5.js";
+} from "./chunk-P5VXVFQW.js";
+import "./chunk-S5OSY3PI.js";
 export {
   HISTORY_WINDOW_RUNS,
   IntelligenceService

package/dist/mcp.js

@@ -1,15 +1,15 @@
 import {
   autoSyncSkills
-} from "./chunk-CVUR3O5G.js";
+} from "./chunk-YTSXQUJ3.js";
 import {
   createApiClient,
   createCanonryMcpServer
-} from "./chunk-PXVJ3P5G.js";
-import "./chunk-JJPZ4OQ2.js";
+} from "./chunk-GLLY2GEV.js";
+import "./chunk-DDL2XSNM.js";
 import {
   isReadOnlyKey,
   updateCheckEnvOptOut
-} from "./chunk-TOSPZ7I5.js";
+} from "./chunk-S5OSY3PI.js";
 
 // src/mcp/cli.ts
 import { randomUUID } from "crypto";