@canonry/canonry 4.146.0 → 4.147.1

package/dist/cli.js

@@ -30,7 +30,7 @@ import {
   showFirstRunNotice,
   trackCliCommandFinished,
   trackEvent
-} from "./chunk-Z7B6BRPP.js";
+} from "./chunk-GNKVF6TZ.js";
 import {
   CliError,
   EXIT_SYSTEM_ERROR,
@@ -43,11 +43,14 @@ import {
   isMachineFormat,
   loadConfig,
   loadConfigRaw,
+  measurementDraftOperationSchema,
   printCliError,
+  runMeasurementDraftAction,
   saveConfig,
   saveConfigPatch,
+  systemError,
   usageError
-} from "./chunk-UQOTEIA6.js";
+} from "./chunk-2NTWZHNF.js";
 import {
   apiKeys,
   createClient,
@@ -55,7 +58,7 @@ import {
   projects,
   queries,
   renderReportHtml
-} from "./chunk-ED7C5TWT.js";
+} from "./chunk-ZRUNFIGA.js";
 import {
   AdsDeliverySnapshotStatuses,
   AdsHistoricalCampaignRollupStatuses,
@@ -68,6 +71,7 @@ import {
   CheckScopes,
   CheckStatuses,
   CitationStates,
+  MeasurementEvidenceShapes,
   READ_ONLY_SCOPE,
   REPORT_PERIOD_OPTIONS,
   ResearchRunStatuses,
@@ -98,15 +102,27 @@ import {
   formatMicros,
   formatRatio,
   formatRunErrorOneLine,
+  measurementChangesQuerySchema,
+  measurementDataQualityQuerySchema,
   measurementDiscoveryRequestSchema,
   measurementDiscoveryRuleSchema,
+  measurementDraftCollectionQuerySchema,
+  measurementOverviewQuerySchema,
+  measurementPlanDeactivateRequestSchema,
   measurementPlanInputSchema,
+  measurementPortfolioSummaryQuerySchema,
+  measurementPropertyCompetitorsQuerySchema,
+  measurementPropertyQuestionsQuerySchema,
+  measurementQuerySetUpsertRequestSchema,
+  measurementQueryTemplateApplyRequestSchema,
+  measurementQueryTemplateUpsertRequestSchema,
+  measurementQuestionResultQuerySchema,
   normalizeProjectAliases,
   notificationEventSchema,
   providerQuotaPolicySchema,
   resolveProviderInput,
   winnabilityClassSchema
-} from "./chunk-B5H55ZMA.js";
+} from "./chunk-BVOU4UJM.js";
 
 // src/cli.ts
 import { pathToFileURL } from "url";
@@ -15714,8 +15730,10 @@ Usage: ${usage}`, {
 ];
 
 // src/commands/measurement-plan.ts
+import crypto3 from "crypto";
 import fs16 from "fs";
 import { parse } from "yaml";
+import { z as z2 } from "zod";
 function readPlan(source) {
   const content = source === "-" ? fs16.readFileSync(0, "utf8") : fs16.readFileSync(source, "utf8");
   const parsed = source.endsWith(".json") ? JSON.parse(content) : parse(content);
@@ -15726,6 +15744,171 @@ function readDiscoveryRule(source) {
   const parsed = source.endsWith(".json") ? JSON.parse(content) : parse(content);
   return measurementDiscoveryRuleSchema.parse(parsed);
 }
+var ADVANCED_MEASUREMENT_OPERATIONS = [
+  "setup",
+  "overview",
+  "portfolio-summary",
+  "property-questions",
+  "question-result",
+  "property-competitors",
+  "changes",
+  "data-quality",
+  "draft",
+  "draft-targets",
+  "draft-assignments",
+  "draft-groups",
+  "draft-action",
+  "deactivate",
+  "query-sets",
+  "query-set-get",
+  "query-set-upsert",
+  "query-set-delete",
+  "query-templates",
+  "query-template-upsert",
+  "query-template-delete",
+  "query-template-apply"
+];
+var advancedIdempotencyKeySchema = z2.string().trim().min(1);
+var advancedResourceIdSchema = z2.string().trim().min(1);
+var advancedEmptyInputSchema = z2.object({}).strict();
+var advancedQuerySetInputSchema = z2.object({ setId: advancedResourceIdSchema }).strict();
+var advancedQuerySetUpsertInputSchema = advancedQuerySetInputSchema.extend({
+  request: measurementQuerySetUpsertRequestSchema
+}).strict();
+var advancedQueryTemplateInputSchema = z2.object({ templateId: advancedResourceIdSchema }).strict();
+var advancedQueryTemplateUpsertInputSchema = advancedQueryTemplateInputSchema.extend({
+  request: measurementQueryTemplateUpsertRequestSchema
+}).strict();
+var advancedQueryTemplateApplyInputSchema = advancedQueryTemplateInputSchema.extend({
+  request: measurementQueryTemplateApplyRequestSchema,
+  idempotencyKey: advancedIdempotencyKeySchema
+}).strict();
+var advancedDeactivateInputSchema = z2.object({
+  request: measurementPlanDeactivateRequestSchema,
+  idempotencyKey: advancedIdempotencyKeySchema
+}).strict();
+function readAdvancedMeasurementInput(source) {
+  if (source === void 0) return {};
+  const content = source === "-" ? fs16.readFileSync(0, "utf8") : fs16.readFileSync(source, "utf8");
+  return JSON.parse(content);
+}
+var advancedMeasurementCollectionKeys = {
+  "draft-targets": "items",
+  "draft-assignments": "items",
+  "draft-groups": "items",
+  "query-sets": "querySets",
+  "query-templates": "templates"
+};
+function isAdvancedMeasurementCollectionOperation(operation) {
+  return operation === "draft-targets" || operation === "draft-assignments" || operation === "draft-groups" || operation === "query-sets" || operation === "query-templates";
+}
+function emitAdvancedMeasurementJsonl(operation, result) {
+  if (!isAdvancedMeasurementCollectionOperation(operation) || typeof result !== "object" || result === null || Array.isArray(result)) return false;
+  const collectionKey = advancedMeasurementCollectionKeys[operation];
+  const envelope = result;
+  const candidateRows = envelope[collectionKey];
+  if (!Array.isArray(candidateRows)) return false;
+  const context = {};
+  for (const [key, value] of Object.entries(envelope)) {
+    if (key !== collectionKey) context[key] = value;
+  }
+  emitJsonl([{ kind: "measurement-advanced-header", operation, ...context }]);
+  emitJsonl(candidateRows.map((row) => row));
+  return true;
+}
+async function runAdvancedMeasurementOperation(project, operation, source, format) {
+  const input = readAdvancedMeasurementInput(source);
+  const client = createApiClient();
+  let result;
+  switch (operation) {
+    case "setup":
+      advancedEmptyInputSchema.parse(input);
+      result = await client.getMeasurementSetup(project);
+      break;
+    case "overview":
+      result = await client.getMeasurementOverview(project, measurementOverviewQuerySchema.parse(input));
+      break;
+    case "portfolio-summary":
+      result = await client.getMeasurementPortfolioSummary(project, measurementPortfolioSummaryQuerySchema.parse(input));
+      break;
+    case "property-questions":
+      result = await client.getMeasurementPropertyQuestions(project, measurementPropertyQuestionsQuerySchema.parse(input));
+      break;
+    case "question-result":
+      result = await client.getMeasurementQuestionResult(project, measurementQuestionResultQuerySchema.parse(input));
+      break;
+    case "property-competitors":
+      result = await client.getMeasurementPropertyCompetitors(project, measurementPropertyCompetitorsQuerySchema.parse(input));
+      break;
+    case "changes":
+      result = await client.getMeasurementChanges(project, measurementChangesQuerySchema.parse(input));
+      break;
+    case "data-quality":
+      result = await client.getMeasurementDataQuality(project, measurementDataQualityQuerySchema.parse(input));
+      break;
+    case "draft":
+      advancedEmptyInputSchema.parse(input);
+      result = await client.getMeasurementPlanDraft(project);
+      break;
+    case "draft-targets":
+      result = await client.getMeasurementDraftTargets(project, measurementDraftCollectionQuerySchema.parse(input));
+      break;
+    case "draft-assignments":
+      result = await client.getMeasurementDraftAssignments(project, measurementDraftCollectionQuerySchema.parse(input));
+      break;
+    case "draft-groups":
+      result = await client.getMeasurementDraftGroups(project, measurementDraftCollectionQuerySchema.parse(input));
+      break;
+    case "draft-action":
+      result = await runMeasurementDraftAction(client, project, measurementDraftOperationSchema.parse(input));
+      break;
+    case "deactivate": {
+      const parsed = advancedDeactivateInputSchema.parse(input);
+      result = await client.deactivateMeasurementPlan(project, parsed.request, parsed.idempotencyKey);
+      break;
+    }
+    case "query-sets":
+      advancedEmptyInputSchema.parse(input);
+      result = await client.listMeasurementQuerySets(project);
+      break;
+    case "query-set-get": {
+      const parsed = advancedQuerySetInputSchema.parse(input);
+      result = await client.getMeasurementQuerySet(project, parsed.setId);
+      break;
+    }
+    case "query-set-upsert": {
+      const parsed = advancedQuerySetUpsertInputSchema.parse(input);
+      result = await client.upsertMeasurementQuerySet(project, parsed.setId, parsed.request);
+      break;
+    }
+    case "query-set-delete": {
+      const parsed = advancedQuerySetInputSchema.parse(input);
+      result = await client.deleteMeasurementQuerySet(project, parsed.setId);
+      break;
+    }
+    case "query-templates":
+      advancedEmptyInputSchema.parse(input);
+      result = await client.listMeasurementQueryTemplates(project);
+      break;
+    case "query-template-upsert": {
+      const parsed = advancedQueryTemplateUpsertInputSchema.parse(input);
+      result = await client.upsertMeasurementQueryTemplate(project, parsed.templateId, parsed.request);
+      break;
+    }
+    case "query-template-delete": {
+      const parsed = advancedQueryTemplateInputSchema.parse(input);
+      result = await client.deleteMeasurementQueryTemplate(project, parsed.templateId);
+      break;
+    }
+    case "query-template-apply": {
+      const parsed = advancedQueryTemplateApplyInputSchema.parse(input);
+      result = await client.applyMeasurementQueryTemplate(project, parsed.templateId, parsed.request, parsed.idempotencyKey);
+      break;
+    }
+  }
+  if (format === "jsonl" && emitAdvancedMeasurementJsonl(operation, result)) return;
+  console.log(JSON.stringify(result ?? null, null, 2));
+}
 async function showMeasurementPlan(project, revision) {
   const client = createApiClient();
   console.log(JSON.stringify(revision === void 0 ? await client.getMeasurementPlan(project) : await client.getMeasurementPlanVersion(project, revision), null, 2));
@@ -15745,6 +15928,76 @@ async function publishMeasurementPlan(project, source) {
 async function retireMeasurementPlanSegment(project, stableKey) {
   console.log(JSON.stringify(await createApiClient().retireMeasurementPlanSegment(project, stableKey), null, 2));
 }
+async function measurementAssignmentRequest(project, opts) {
+  const client = createApiClient();
+  const current = await client.getMeasurementPlanDraft(project);
+  if (!current.draft || !current.etag) {
+    throw new Error(`Project "${project}" has no Advanced Measurement draft. Start setup in the dashboard or create a draft first.`);
+  }
+  const targetKeys = opts.allProperties ? current.draft.authoring.targets.filter((target) => target.status === "included").map((target) => target.stableKey) : opts.targetKeys;
+  return {
+    client,
+    request: {
+      ...targetKeys?.length ? { targetKeys } : {},
+      ...opts.groupKeys?.length ? { groupKeys: opts.groupKeys } : {},
+      queryIds: opts.queryIds
+    }
+  };
+}
+async function previewMeasurementPlanAssignments(project, opts) {
+  const { client, request } = await measurementAssignmentRequest(project, opts);
+  console.log(JSON.stringify(await client.previewMeasurementDraftAssignments(project, request), null, 2));
+}
+async function applyMeasurementPlanAssignments(project, opts) {
+  const { client, request } = await measurementAssignmentRequest(project, opts);
+  const preview = await client.previewMeasurementDraftAssignments(project, request);
+  const result = await client.applyMeasurementDraftAssignments(
+    project,
+    request,
+    crypto3.randomUUID(),
+    preview.draftEtag
+  );
+  console.log(JSON.stringify({ preview, result }, null, 2));
+}
+async function replaceMeasurementPlanAssignments(project, opts) {
+  const { client, request } = await measurementAssignmentRequest(project, opts);
+  const preview = await client.previewMeasurementDraftAssignments(project, request);
+  const result = await client.replaceMeasurementDraftAssignments(
+    project,
+    request,
+    crypto3.randomUUID(),
+    preview.draftEtag
+  );
+  console.log(JSON.stringify({ preview, result }, null, 2));
+}
+function readGroupMembershipCsv(source) {
+  return source === "-" ? fs16.readFileSync(0, "utf8") : fs16.readFileSync(source, "utf8");
+}
+async function previewMeasurementPlanGroups(project, source) {
+  const preview = await createApiClient().previewMeasurementDraftGroupMembership(project, {
+    csv: readGroupMembershipCsv(source)
+  });
+  console.log(JSON.stringify(preview, null, 2));
+}
+async function applyMeasurementPlanGroups(project, source, opts) {
+  const client = createApiClient();
+  const csv = readGroupMembershipCsv(source);
+  const preview = await client.previewMeasurementDraftGroupMembership(project, { csv });
+  if (preview.counts.needsAttention > 0 && !opts.acknowledgeSkipped) {
+    throw new Error(
+      `${preview.counts.needsAttention} CSV rows need attention. Correct them or add --acknowledge-skipped to apply only the selected matched rows.`
+    );
+  }
+  const acceptedRows = opts.acceptAllMatched ? preview.rows.filter((row) => row.status === "matched").map((row) => row.dataRow) : opts.acceptedRows ?? [];
+  if (acceptedRows.length === 0) throw new Error("No matched CSV rows were selected for apply.");
+  const result = await client.applyMeasurementDraftGroupMembership(project, {
+    csv,
+    sourceChecksum: preview.sourceChecksum,
+    previewChecksum: preview.previewChecksum,
+    acceptedRows
+  }, crypto3.randomUUID(), preview.draftEtag);
+  console.log(JSON.stringify({ preview, result }, null, 2));
+}
 async function discoverMeasurementTargets(project, sitemapUrl, ruleSource, maxUrls) {
   const request = measurementDiscoveryRequestSchema.parse({
     sitemapUrl,
@@ -15801,6 +16054,11 @@ function printMeasurementProperty(response) {
   }
   console.log(lines.join("\n"));
 }
+function shapedPage(response) {
+  if (response.answers !== void 0) return { shape: MeasurementEvidenceShapes.answers, ...response.answers };
+  if (response.evidence !== void 0) return { shape: MeasurementEvidenceShapes.sources, ...response.evidence };
+  throw systemError("The measurement property evidence response carried neither an evidence nor an answers page.");
+}
 async function showMeasurementPropertyEvidence(project, opts) {
   const response = await createApiClient().getMeasurementPropertyEvidence(project, {
     targetKey: opts.targetKey,
@@ -15808,19 +16066,22 @@ async function showMeasurementPropertyEvidence(project, opts) {
     ...opts.provider === void 0 ? {} : { provider: opts.provider },
     ...opts.location === void 0 ? {} : { location: opts.location },
     ...opts.runId === void 0 ? {} : { runId: opts.runId },
+    ...opts.shape === void 0 ? {} : { shape: opts.shape },
     ...opts.cursor === void 0 ? {} : { cursor: opts.cursor },
     ...opts.limit === void 0 ? {} : { limit: opts.limit }
   });
   if (opts.format === "jsonl") {
+    const page = shapedPage(response);
     emitJsonl([{
       kind: "measurement-property-evidence-header",
+      shape: page.shape,
       property: response.property,
       queryClass: response.queryClass,
       measurement: response.measurement,
-      totalEstimate: response.evidence.totalEstimate ?? null,
-      nextCursor: response.evidence.nextCursor ?? null
+      totalEstimate: page.totalEstimate ?? null,
+      nextCursor: page.nextCursor ?? null
     }]);
-    emitJsonl(response.evidence.items);
+    emitJsonl(page.items);
     return;
   }
   if (opts.format === "json") {
@@ -15829,6 +16090,10 @@ async function showMeasurementPropertyEvidence(project, opts) {
   }
   printMeasurementPropertyEvidence(response);
 }
+function signalText(signal) {
+  if (signal === null) return "not measured";
+  return signal ? "yes" : "no";
+}
 function printMeasurementPropertyEvidence(response) {
   const lines = [];
   lines.push(`${response.property.label} \u2014 ${response.queryClass} questions`);
@@ -15837,18 +16102,28 @@ function printMeasurementPropertyEvidence(response) {
     console.log(lines.join("\n"));
     return;
   }
-  const page = response.evidence;
+  const page = shapedPage(response);
+  const answerShape = page.shape === MeasurementEvidenceShapes.answers;
   lines.push(`Measurement: ${response.measurement.state}${response.measurement.displayedRunId ? ` \xB7 run ${response.measurement.displayedRunId}` : ""}`);
   if (page.items.length === 0) {
-    lines.push("No source evidence matched this Property in the displayed run.");
+    lines.push(answerShape ? "No answers matched this Property in the displayed run." : "No source evidence matched this Property in the displayed run.");
     console.log(lines.join("\n"));
     return;
   }
-  lines.push(`${page.items.length} of ${page.totalEstimate ?? page.items.length} evidence rows`);
+  lines.push(`${page.items.length} of ${page.totalEstimate ?? page.items.length} ${answerShape ? "answers" : "evidence rows"}`);
   lines.push("");
-  lines.push(`${"Match".padEnd(14)}${"Engine".padEnd(12)}${"Question".padEnd(40)}URL`);
-  for (const item of page.items) {
-    lines.push(`${item.classification.padEnd(14)}${item.provider.padEnd(12)}${item.queryText.slice(0, 39).padEnd(40)}${item.sourceUrl}`);
+  if (page.shape === MeasurementEvidenceShapes.answers) {
+    lines.push(`${"Engine".padEnd(12)}${"Question".padEnd(40)}${"Mentioned".padEnd(15)}${"Cited".padEnd(8)}Sources`);
+    for (const item of page.items) {
+      lines.push(
+        `${item.provider.padEnd(12)}${item.queryText.slice(0, 39).padEnd(40)}${signalText(item.mentioned).padEnd(15)}${signalText(item.cited).padEnd(8)}${item.sources.length}`
+      );
+    }
+  } else {
+    lines.push(`${"Match".padEnd(14)}${"Engine".padEnd(12)}${"Question".padEnd(40)}URL`);
+    for (const item of page.items) {
+      lines.push(`${item.classification.padEnd(14)}${item.provider.padEnd(12)}${item.queryText.slice(0, 39).padEnd(40)}${item.sourceUrl}`);
+    }
   }
   if (page.nextCursor) lines.push(`
 More rows: --cursor ${page.nextCursor}`);
@@ -15857,6 +16132,7 @@ More rows: --cursor ${page.nextCursor}`);
 
 // src/cli-commands/measurement-plan.ts
 var QUERY_CLASSES = ["all", "branded", "non-brand"];
+var EVIDENCE_SHAPES = ["sources", "answers"];
 function queryClassOption(input) {
   const value = getString(input.values, "query-class");
   if (value === void 0) return void 0;
@@ -15864,6 +16140,13 @@ function queryClassOption(input) {
   if (!match) throw usageError(`--query-class must be one of ${QUERY_CLASSES.join(", ")}`);
   return match;
 }
+function shapeOption(input) {
+  const value = getString(input.values, "shape");
+  if (value === void 0) return void 0;
+  const match = EVIDENCE_SHAPES.find((candidate) => candidate === value);
+  if (!match) throw usageError(`--shape must be one of ${EVIDENCE_SHAPES.join(", ")}`);
+  return match;
+}
 function propertyScope(input, command, usage) {
   return {
     targetKey: requireStringOption(input, "target-key", { command, usage, message: "--target-key is required" }),
@@ -15881,6 +16164,36 @@ var PROPERTY_SCOPE_OPTIONS = {
   location: stringOption(),
   "run-id": stringOption()
 };
+var ASSIGNMENT_AUDIENCE_OPTIONS = {
+  group: multiStringOption(),
+  "target-key": multiStringOption(),
+  "all-properties": { type: "boolean" },
+  "query-id": multiStringOption()
+};
+function assignmentAudience(input, command, usage) {
+  const project = requireProject(input, command, usage);
+  const groupKeys = getStringArray(input.values, "group")?.map((value) => value.trim()).filter(Boolean);
+  const targetKeys = getStringArray(input.values, "target-key")?.map((value) => value.trim()).filter(Boolean);
+  const queryIds = getStringArray(input.values, "query-id")?.map((value) => value.trim()).filter(Boolean) ?? [];
+  const allProperties = getBoolean(input.values, "all-properties");
+  if (queryIds.length === 0) throw usageError(`Error: at least one --query-id is required
+Usage: ${usage}`);
+  if (allProperties && ((groupKeys?.length ?? 0) > 0 || (targetKeys?.length ?? 0) > 0)) {
+    throw usageError(`Error: --all-properties cannot be combined with --group or --target-key
+Usage: ${usage}`);
+  }
+  if (!allProperties && (groupKeys?.length ?? 0) === 0 && (targetKeys?.length ?? 0) === 0) {
+    throw usageError(`Error: select at least one --group, --target-key, or --all-properties
+Usage: ${usage}`);
+  }
+  return { project, options: { groupKeys, targetKeys, queryIds, allProperties } };
+}
+function advancedMeasurementOperation(value, usage) {
+  const operation = ADVANCED_MEASUREMENT_OPERATIONS.find((candidate) => candidate === value);
+  if (operation) return operation;
+  throw usageError(`Error: unsupported Advanced Measurement operation: ${value ?? "(none)"}
+Usage: ${usage}`);
+}
 var MEASUREMENT_PLAN_CLI_COMMANDS = [
   { path: ["measurement-plan", "show"], usage: "canonry measurement-plan show <project> [--revision N] [--format json]", options: { revision: stringOption() }, run: async (input) => {
     const value = getString(input.values, "revision");
@@ -15901,6 +16214,95 @@ var MEASUREMENT_PLAN_CLI_COMMANDS = [
     if (!stableKey) throw usageError("stable segment key is required");
     return retireMeasurementPlanSegment(project, stableKey);
   } },
+  {
+    path: ["measurement-plan", "advanced"],
+    usage: "canonry measurement-plan advanced <project> <operation> [<json|->] [--format json|jsonl]",
+    run: (input) => {
+      const usage = "canonry measurement-plan advanced <project> <operation> [<json|->] [--format json|jsonl]";
+      const project = requireProject(input, "measurement-plan.advanced", usage);
+      const operation = advancedMeasurementOperation(input.positionals[1], usage);
+      return runAdvancedMeasurementOperation(project, operation, input.positionals[2], input.format);
+    }
+  },
+  {
+    path: ["measurement-plan", "assignments", "preview"],
+    usage: "canonry measurement-plan assignments preview <project> [--group KEY ...] [--target-key KEY ... | --all-properties] --query-id ID [--query-id ID ...] [--format json]",
+    options: ASSIGNMENT_AUDIENCE_OPTIONS,
+    run: (input) => {
+      const usage = "canonry measurement-plan assignments preview <project> [--group KEY ...] [--target-key KEY ... | --all-properties] --query-id ID [--query-id ID ...]";
+      const { project, options } = assignmentAudience(input, "measurement-plan.assignments.preview", usage);
+      return previewMeasurementPlanAssignments(project, options);
+    }
+  },
+  {
+    path: ["measurement-plan", "assignments", "apply"],
+    usage: "canonry measurement-plan assignments apply <project> [--group KEY ...] [--target-key KEY ... | --all-properties] --query-id ID [--query-id ID ...] [--format json]",
+    options: ASSIGNMENT_AUDIENCE_OPTIONS,
+    run: (input) => {
+      const usage = "canonry measurement-plan assignments apply <project> [--group KEY ...] [--target-key KEY ... | --all-properties] --query-id ID [--query-id ID ...]";
+      const { project, options } = assignmentAudience(input, "measurement-plan.assignments.apply", usage);
+      return applyMeasurementPlanAssignments(project, options);
+    }
+  },
+  {
+    path: ["measurement-plan", "assignments", "replace"],
+    usage: "canonry measurement-plan assignments replace <project> [--group KEY ...] [--target-key KEY ... | --all-properties] --query-id ID [--query-id ID ...] --confirm [--format json]",
+    options: { ...ASSIGNMENT_AUDIENCE_OPTIONS, confirm: { type: "boolean" } },
+    run: (input) => {
+      const usage = "canonry measurement-plan assignments replace <project> [--group KEY ...] [--target-key KEY ... | --all-properties] --query-id ID [--query-id ID ...] --confirm";
+      if (!getBoolean(input.values, "confirm")) throw usageError(`Error: --confirm is required
+Usage: ${usage}`);
+      const { project, options } = assignmentAudience(input, "measurement-plan.assignments.replace", usage);
+      return replaceMeasurementPlanAssignments(project, options);
+    }
+  },
+  {
+    path: ["measurement-plan", "groups", "preview"],
+    usage: "canonry measurement-plan groups preview <project> <csv|-> [--format json]",
+    run: (input) => {
+      const usage = "canonry measurement-plan groups preview <project> <csv|->";
+      const project = requireProject(input, "measurement-plan.groups.preview", usage);
+      const source = input.positionals[1];
+      if (!source) throw usageError(`Error: CSV file path or - is required
+Usage: ${usage}`);
+      return previewMeasurementPlanGroups(project, source);
+    }
+  },
+  {
+    path: ["measurement-plan", "groups", "apply"],
+    usage: "canonry measurement-plan groups apply <project> <csv|-> --confirm [--accept-row N ... | --accept-all-matched] [--acknowledge-skipped] [--format json]",
+    options: {
+      confirm: { type: "boolean" },
+      "accept-row": multiStringOption(),
+      "accept-all-matched": { type: "boolean" },
+      "acknowledge-skipped": { type: "boolean" }
+    },
+    run: (input) => {
+      const usage = "canonry measurement-plan groups apply <project> <csv|-> --confirm [--accept-row N ... | --accept-all-matched] [--acknowledge-skipped]";
+      const project = requireProject(input, "measurement-plan.groups.apply", usage);
+      const source = input.positionals[1];
+      if (!source) throw usageError(`Error: CSV file path or - is required
+Usage: ${usage}`);
+      if (!getBoolean(input.values, "confirm")) throw usageError(`Error: --confirm is required
+Usage: ${usage}`);
+      const acceptAllMatched = getBoolean(input.values, "accept-all-matched");
+      const rowValues = getStringArray(input.values, "accept-row") ?? [];
+      if (acceptAllMatched === rowValues.length > 0) {
+        throw usageError(`Error: choose exactly one of --accept-row or --accept-all-matched
+Usage: ${usage}`);
+      }
+      const acceptedRows = rowValues.map((value) => Number(value));
+      if (acceptedRows.some((row) => !Number.isSafeInteger(row) || row < 1)) {
+        throw usageError(`Error: --accept-row must be a positive integer
+Usage: ${usage}`);
+      }
+      return applyMeasurementPlanGroups(project, source, {
+        acceptedRows,
+        acceptAllMatched,
+        acknowledgeSkipped: getBoolean(input.values, "acknowledge-skipped")
+      });
+    }
+  },
   {
     path: ["measurement-plan", "discover"],
     usage: "canonry measurement-plan discover <project> --sitemap-url <url> --rule <yaml|json|-> [--max-urls N] [--format json]",
@@ -15952,8 +16354,8 @@ var MEASUREMENT_PLAN_CLI_COMMANDS = [
   },
   {
     path: ["measurement-plan", "property-evidence"],
-    usage: "canonry measurement-plan property-evidence <project> --target-key <key> [--query-class all|branded|non-brand] [--provider <p>] [--location <l>] [--run-id <id>] [--cursor <c>] [--limit N] [--format json|jsonl]",
-    options: { ...PROPERTY_SCOPE_OPTIONS, cursor: stringOption(), limit: stringOption() },
+    usage: "canonry measurement-plan property-evidence <project> --target-key <key> [--query-class all|branded|non-brand] [--provider <p>] [--location <l>] [--run-id <id>] [--shape sources|answers] [--cursor <c>] [--limit N] [--format json|jsonl]",
+    options: { ...PROPERTY_SCOPE_OPTIONS, shape: stringOption(), cursor: stringOption(), limit: stringOption() },
     run: (input) => {
       const usage = "canonry measurement-plan property-evidence <project> --target-key <key>";
       const project = requireProject(input, "measurement-plan.property-evidence", usage);
@@ -15962,8 +16364,10 @@ var MEASUREMENT_PLAN_CLI_COMMANDS = [
       if (limit !== void 0 && (!Number.isInteger(limit) || limit < 1 || limit > 100)) {
         throw usageError("--limit must be an integer from 1 to 100");
       }
+      const shape = shapeOption(input);
       return showMeasurementPropertyEvidence(project, {
         ...propertyScope(input, "measurement-plan.property-evidence", usage),
+        ...shape === void 0 ? {} : { shape },
         cursor: getString(input.values, "cursor"),
         ...limit === void 0 ? {} : { limit }
       });

package/dist/index.js

@@ -1,11 +1,11 @@
 import {
   createServer
-} from "./chunk-Z7B6BRPP.js";
+} from "./chunk-GNKVF6TZ.js";
 import {
   loadConfig
-} from "./chunk-UQOTEIA6.js";
-import "./chunk-ED7C5TWT.js";
-import "./chunk-B5H55ZMA.js";
+} from "./chunk-2NTWZHNF.js";
+import "./chunk-ZRUNFIGA.js";
+import "./chunk-BVOU4UJM.js";
 export {
   createServer,
   loadConfig

package/dist/{intelligence-service-M5UNHF7X.js → intelligence-service-2E5YAXI3.js}

@@ -1,7 +1,7 @@
 import {
   IntelligenceService
-} from "./chunk-ED7C5TWT.js";
-import "./chunk-B5H55ZMA.js";
+} from "./chunk-ZRUNFIGA.js";
+import "./chunk-BVOU4UJM.js";
 export {
   IntelligenceService
 };

package/dist/mcp.js

@@ -3,10 +3,10 @@ import {
   PACKAGE_VERSION,
   canonryMcpTools,
   createApiClient
-} from "./chunk-UQOTEIA6.js";
+} from "./chunk-2NTWZHNF.js";
 import {
   isReadOnlyKey
-} from "./chunk-B5H55ZMA.js";
+} from "./chunk-BVOU4UJM.js";
 
 // src/mcp/cli.ts
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
@@ -110,9 +110,9 @@ var CANONRY_MCP_TOOLKIT_NAMES = ["monitoring", "setup", "gsc", "ga", "gbp", "ads
 var CANONRY_MCP_TOOLKITS = [
   {
     name: "monitoring",
-    title: "Runs, snapshots, insights, health",
-    description: "Inspect run history, query snapshots, intelligence insights, and health timelines.",
-    whenToLoad: "Load when investigating regressions, comparing runs, or reviewing insights and health history."
+    title: "Measurement, runs, insights, health",
+    description: "Inspect portfolio and Property measurement, question results, run history, intelligence insights, and health timelines.",
+    whenToLoad: "Load when finding weak Properties, reviewing answers and competitors, checking data quality, comparing runs, or investigating regressions."
   },
   {
     name: "setup",