@canonry/canonry 7.17.1 → 7.18.0

package/dist/{chunk-FK7AWV57.js → chunk-EAAM47H6.js}

@@ -6,6 +6,7 @@ import {
   GA_SEARCH_LANDING_MAX_LIMIT,
   GOOGLE_MARKETING_STORED_SNAPSHOT_PAGE_MAX,
   LATEST_RUN_ID,
+  MEASUREMENT_DEFAULT_QUERY_CLASS,
   PROVIDER_ACCOUNT_FAILURE_STREAK,
   PROVIDER_ACCOUNT_RETRY_HOURS,
   RESEARCH_RUN_SCOPE,
@@ -141,7 +142,7 @@ import {
   trafficSeriesGranularitySchema,
   visibilityCompareSelectionSchema,
   visibilityReportRequestSchema
-} from "./chunk-MHB23E3N.js";
+} from "./chunk-X2S7D3MN.js";
 
 // src/cli-error.ts
 function isMachineFormat(format) {
@@ -390,7 +391,8 @@ var runTriggerInputSchema = z3.object({
 });
 var measurementPlanVersionInputSchema = z3.object({ project: projectNameSchema, revision: z3.number().int().positive() });
 var measurementReportInputSchema = measurementPlanVersionInputSchema.extend({
-  runId: runIdSchema.optional().describe("Exact eligible full measurement run to reconstruct. Omit for the latest run in the revision.")
+  runId: runIdSchema.optional().describe("Exact eligible full measurement run to reconstruct. Omit for the latest run in the revision."),
+  queryClass: measurementQueryClassFilterSchema.optional().describe("Omit for non-brand on a schema v2 revision; read branded as a separate call. all pools both classes. A schema v1 revision records no class: omit it there.")
 });
 var measurementPlanPreviewInputSchema = z3.object({ project: projectNameSchema, plan: measurementPlanAuthoringSchema });
 var measurementPlanPublishInputSchema = measurementPlanPublishRequestSchema.extend({ project: projectNameSchema });
@@ -399,10 +401,11 @@ var measurementDiscoveryInputSchema = measurementDiscoveryRequestSchema.extend({
 var idempotencyKeyInputSchema = z3.string().trim().min(1).describe("A fresh request key. Reuse it only when retrying the identical request.");
 var measurementOverviewInputSchema = z3.object({
   project: projectNameSchema,
-  scope: measurementOverviewQuerySchema.shape.scope.describe("Read all Properties, one reporting group, or one Property."),
+  scope: measurementOverviewQuerySchema.shape.scope.describe("Read all Properties, one group (every query of its Properties), one market (only the market's own queries, as the dashboard's market view), or one Property. A group and a market can share a name and still differ; for a market, use market scope."),
   groupKey: measurementOverviewQuerySchema.shape.groupKey.describe("Group stable key. Required only for group scope."),
+  marketKey: measurementOverviewQuerySchema.shape.marketKey.describe("Market stable key. Required only for market scope."),
   targetKey: measurementOverviewQuerySchema.shape.targetKey.describe("Property stable key. Required only for property scope."),
-  queryClass: measurementOverviewQuerySchema.shape.queryClass.describe("Select non-brand for acquisition performance or branded for brand awareness. Omitted means all classes combined; always name the class in the report."),
+  queryClass: measurementOverviewQuerySchema.shape.queryClass.describe("Omit for non-brand, the acquisition signal. Read branded (brand recall) as a separate call. all pools both classes into one rate, so never report it as one class."),
   provider: measurementOverviewQuerySchema.shape.provider,
   location: measurementOverviewQuerySchema.shape.location,
   from: measurementOverviewQuerySchema.shape.from,
@@ -420,14 +423,20 @@ var measurementOverviewInputSchema = z3.object({
   if (input.scope === "property" && !input.targetKey) {
     context.addIssue({ code: "custom", path: ["targetKey"], message: "Property scope requires targetKey." });
   }
+  if (input.scope === "market" && !input.marketKey) {
+    context.addIssue({ code: "custom", path: ["marketKey"], message: "Market scope requires marketKey." });
+  }
   if (input.scope !== "group" && input.groupKey) {
     context.addIssue({ code: "custom", path: ["groupKey"], message: `${input.scope} scope does not accept groupKey.` });
   }
+  if (input.scope !== "market" && input.marketKey) {
+    context.addIssue({ code: "custom", path: ["marketKey"], message: `${input.scope} scope does not accept marketKey.` });
+  }
   if (input.scope !== "property" && input.targetKey) {
     context.addIssue({ code: "custom", path: ["targetKey"], message: `${input.scope} scope does not accept targetKey.` });
   }
 });
-var AGENT_DEFAULT_QUERY_CLASS = "non-brand";
+var AGENT_DEFAULT_QUERY_CLASS = MEASUREMENT_DEFAULT_QUERY_CLASS;
 var propertyQueryClassInputSchema = measurementQueryClassFilterSchema.optional().describe("Omit for non-brand. branded reads brand recall; all pools both classes, so name the class you report.");
 function agentQueryClass(queryClass) {
   return queryClass ?? AGENT_DEFAULT_QUERY_CLASS;
@@ -2911,7 +2920,7 @@ var canonryMcpTools = [
   defineTool({
     name: "canonry_measurement_overview",
     title: "Get Advanced Measurement overview",
-    description: "Compact pages are byte-bounded whole rows by default; use nextCursor with unchanged filters. For best/worst Property mention rankings, prefer canonry_measurement_portfolio_summary and its mentionRanking. An unavailable aggregate does not invalidate available Property metrics. Return stored, revision-pinned Advanced Measurement metrics and a bounded page of Property rows for all Properties, one reporting group, or one Property. Filter by query class, provider, location, date window, run, or Property search; search filters rows without changing metric denominators. On a schema-v2 plan each Property row carries its metro (and otherMetros when it is in several). It ranks one run snapshot only and never infers a trend or compares across revisions. Choose label-asc (default), label-desc, citationCoverage-asc/desc, or mentionCoverage-asc/desc. For a coverage sort, unavailable rows form the first bucket in either direction; available rows then follow the requested numeric direction. The cursor is sort-aware, pins pagination to the active revision, displayed run, evidence snapshot, and filters even if a newer run completes, and must be reused unchanged with the same sort and filters. Legacy label cursors work only when sort is omitted, while any explicit sort needs a new sort-bound cursor. It never starts provider work or incurs provider cost; page size is at most 100, and it refuses invalid scope keys, cursor combinations, appended evidence, or a run pinned to another revision.",
+    description: "Compact pages are byte-bounded whole rows by default; use nextCursor with unchanged filters. For best/worst Property mention rankings, prefer canonry_measurement_portfolio_summary and its mentionRanking. An unavailable aggregate does not invalidate available Property metrics. Return stored, revision-pinned Advanced Measurement metrics and a bounded page of Property rows for all Properties, one group, one market, or one Property. Defaults to non-brand queries: read branded as a separate call, state the returned queryClass, and never report queryClass all (both classes pooled) as one class. A group is every query of its Properties; a market is only its own queries, the dashboard's market population. Use market scope for a market's figures, and quote the returned scope kind and label: a group figure is never a market's figure. Filter by query class, provider, location, date window, run, or Property search; search filters rows without changing metric denominators. On a schema-v2 plan each Property row carries its metro (and otherMetros when it is in several). It ranks one run snapshot only and never infers a trend or compares across revisions. Choose label-asc (default), label-desc, citationCoverage-asc/desc, or mentionCoverage-asc/desc. For a coverage sort, unavailable rows form the first bucket in either direction; available rows then follow the requested numeric direction. The cursor is sort-aware, pins pagination to the active revision, displayed run, evidence snapshot, and filters even if a newer run completes, and must be reused unchanged with the same sort and filters. Legacy label cursors work only when sort is omitted, while any explicit sort needs a new sort-bound cursor. It never starts provider work or incurs provider cost; page size is at most 100, and it refuses invalid scope keys, cursor combinations, appended evidence, or a run pinned to another revision.",
     access: "read",
     tier: "setup",
     inputSchema: measurementOverviewInputSchema,
@@ -2919,7 +2928,11 @@ var canonryMcpTools = [
     openApiOperations: ["GET /api/v1/projects/{name}/measurement-overview"],
     handler: (client, input) => {
       const { project, ...query } = input;
-      return client.getMeasurementOverview(project, { ...query, compact: query.compact ?? true });
+      return client.getMeasurementOverview(project, {
+        ...query,
+        queryClass: agentQueryClass(query.queryClass),
+        compact: query.compact ?? true
+      });
     }
   }),
   defineTool({
@@ -3193,13 +3206,15 @@ var canonryMcpTools = [
   defineTool({
     name: "canonry_measurement_report",
     title: "Get measurement report",
-    description: "Get a revision-pinned Target and group measurement report from stored runs. Optionally pin the evidence to an exact eligible full run. Never starts live provider work.",
+    description: "Get a revision-pinned Target and group measurement report from stored runs. Optionally pin the evidence to an exact eligible full run. On a schema v2 revision every rate is taken over non-brand queries unless queryClass names another class, and the response echoes queryClass; read branded as a separate call, and treat all as pooled. A schema v1 revision records no class and echoes queryClass null. Never starts live provider work.",
     access: "read",
     tier: "setup",
     inputSchema: measurementReportInputSchema,
     annotations: readAnnotations(),
     openApiOperations: ["GET /api/v1/projects/{name}/measurement-report"],
-    handler: (client, input) => client.getMeasurementReport(input.project, input.revision, input.runId)
+    // The class is sent only when named: the server serves non-brand on a v2
+    // revision and every answer on a v1 revision, which refuses a named class.
+    handler: (client, input) => client.getMeasurementReport(input.project, input.revision, input.runId, input.queryClass)
   }),
   defineTool({
     name: "canonry_run_trigger",

package/dist/{chunk-PLS4EM2Y.js → chunk-JMC7CEJB.js}

@@ -5,7 +5,7 @@ import {
   PACKAGE_VERSION,
   canonryMcpTools,
   isMachineFormat
-} from "./chunk-FK7AWV57.js";
+} from "./chunk-EAAM47H6.js";
 import {
   AGENT_PROVIDER_IDS,
   CANONRY_NPM_PACKAGE_URL,
@@ -50,7 +50,7 @@ import {
   skillsClientSchema,
   upgradeCaveatFor,
   upgradeCommandFor
-} from "./chunk-MHB23E3N.js";
+} from "./chunk-X2S7D3MN.js";
 
 // src/config.ts
 import fs from "fs";
@@ -7027,12 +7027,12 @@ var ApiClient = class {
       })
     );
   }
-  async getMeasurementReport(project, revision, runId) {
+  async getMeasurementReport(project, revision, runId, queryClass) {
     return this.invoke(
       () => getApiV1ProjectsByNameMeasurementReport({
         client: this.heyClient,
         path: { name: project },
-        query: { revision, runId }
+        query: { revision, runId, ...queryClass === void 0 ? {} : { queryClass } }
       })
     );
   }

package/dist/{chunk-OPJCFDNR.js → chunk-JUOFNJLV.js}

@@ -4,14 +4,14 @@ import {
   installSkills,
   loadConfigRaw,
   saveConfigPatch
-} from "./chunk-PLS4EM2Y.js";
+} from "./chunk-JMC7CEJB.js";
 import {
   PACKAGE_VERSION
-} from "./chunk-FK7AWV57.js";
+} from "./chunk-EAAM47H6.js";
 import {
   SKILL_MANIFEST_FILENAME,
   SkillsClients
-} from "./chunk-MHB23E3N.js";
+} from "./chunk-X2S7D3MN.js";
 
 // src/skills-autosync.ts
 import fs from "fs";

package/dist/{chunk-C6GWKYGE.js → chunk-U7D7LNVJ.js}

@@ -5,16 +5,17 @@ import {
   siteCrawlGraphNodes,
   siteCrawlPages,
   siteCrawlSnapshots
-} from "./chunk-ZQ7C6IFA.js";
+} from "./chunk-COQOQYRZ.js";
 import {
   SITE_CRAWL_GRAPH_MAX_EDGES,
   SITE_CRAWL_GRAPH_MAX_NODES,
   SiteAuditFactorStatuses,
   TEMPLATE_LINK_RATIO_THRESHOLD,
+  compareText,
   factorStatusFromDistribution,
   factorStatusFromScore,
   roundPreservingTotal
-} from "./chunk-MHB23E3N.js";
+} from "./chunk-X2S7D3MN.js";
 
 // src/site-audit-factors.ts
 function recordedSharePct(factor) {
@@ -354,7 +355,7 @@ function siteCrawlGraphComponents(nodeKeys, edges) {
     if (group) group.push(key);
     else members.set(root, [key]);
   }
-  return [...members.values()].sort((left, right) => right.length - left.length || (left[0] < right[0] ? -1 : left[0] > right[0] ? 1 : 0));
+  return [...members.values()].sort((left, right) => right.length - left.length || compareText(left[0], right[0]));
 }
 function describeComponent(nodeKeys, byKey) {
   let sumX = 0;
@@ -383,7 +384,7 @@ function packSiteCrawlGraphComponents(positions, edges, nodeSpacing) {
   const described = components.map((nodeKeys) => describeComponent(nodeKeys, byKey));
   const [anchor, ...rest] = described;
   const spacing = Math.max(nodeSpacing, Number.EPSILON) * COMPONENT_PACKING_SPACING_FACTOR;
-  const ordered = [...rest].sort((left, right) => right.radius - left.radius || (left.nodeKeys[0] < right.nodeKeys[0] ? -1 : left.nodeKeys[0] > right.nodeKeys[0] ? 1 : 0));
+  const ordered = [...rest].sort((left, right) => right.radius - left.radius || compareText(left.nodeKeys[0], right.nodeKeys[0]));
   const moved = /* @__PURE__ */ new Map();
   let ringRadius = anchor.radius + spacing;
   let ringPitch = 0;