@ainyc/canonry 4.144.0 → 4.146.0

package/dist/{chunk-3NYTF3YC.js → chunk-Z7B6BRPP.js}

@@ -10,7 +10,7 @@ import {
   loadConfig,
   loadConfigRaw,
   saveConfigPatch
-} from "./chunk-Z672VQ7G.js";
+} from "./chunk-UQOTEIA6.js";
 import {
   CC_CACHE_DIR,
   DUCKDB_SPEC,
@@ -126,7 +126,7 @@ import {
   siteAuditSnapshots,
   toAlertView,
   usageCounters
-} from "./chunk-7D2GZU6O.js";
+} from "./chunk-ED7C5TWT.js";
 import {
   AGENT_MEMORY_VALUE_MAX_BYTES,
   AGENT_PROVIDER_IDS,
@@ -217,7 +217,7 @@ import {
   validationError,
   winnabilityClassLabel,
   withRetry
-} from "./chunk-WADGZMWT.js";
+} from "./chunk-B5H55ZMA.js";
 
 // src/telemetry.ts
 import crypto from "crypto";
@@ -7420,7 +7420,7 @@ function readStoredGroundingSources(rawResponse) {
   return result;
 }
 async function backfillInsightsCommand(project, opts) {
-  const { IntelligenceService: IntelligenceService2 } = await import("./intelligence-service-OLIGR6HE.js");
+  const { IntelligenceService: IntelligenceService2 } = await import("./intelligence-service-M5UNHF7X.js");
   const config = loadConfig();
   const db = createClient(config.database);
   migrate(db);

package/dist/cli.js

@@ -30,7 +30,7 @@ import {
   showFirstRunNotice,
   trackCliCommandFinished,
   trackEvent
-} from "./chunk-3NYTF3YC.js";
+} from "./chunk-Z7B6BRPP.js";
 import {
   CliError,
   EXIT_SYSTEM_ERROR,
@@ -47,7 +47,7 @@ import {
   saveConfig,
   saveConfigPatch,
   usageError
-} from "./chunk-Z672VQ7G.js";
+} from "./chunk-UQOTEIA6.js";
 import {
   apiKeys,
   createClient,
@@ -55,7 +55,7 @@ import {
   projects,
   queries,
   renderReportHtml
-} from "./chunk-7D2GZU6O.js";
+} from "./chunk-ED7C5TWT.js";
 import {
   AdsDeliverySnapshotStatuses,
   AdsHistoricalCampaignRollupStatuses,
@@ -106,7 +106,7 @@ import {
   providerQuotaPolicySchema,
   resolveProviderInput,
   winnabilityClassSchema
-} from "./chunk-WADGZMWT.js";
+} from "./chunk-B5H55ZMA.js";
 
 // src/cli.ts
 import { pathToFileURL } from "url";
@@ -15756,8 +15756,131 @@ async function discoverMeasurementTargets(project, sitemapUrl, ruleSource, maxUr
 async function showMeasurementReport(project, revision) {
   console.log(JSON.stringify(await createApiClient().getMeasurementReport(project, revision), null, 2));
 }
+var METRIC_REASONS = {
+  plan_v1: "not measured (setup update required)",
+  no_completed_run: "not measured (no completed run)",
+  no_population: "not measured (no questions of this type)",
+  evidence_incomplete: "not measured (evidence incomplete)",
+  not_applicable: "not measured (not applicable)"
+};
+function metricText(metric) {
+  if (metric.state === "unavailable") return METRIC_REASONS[metric.reason] ?? `not measured (${metric.reason})`;
+  const percent = `${Math.round(metric.value * 100)}%`;
+  return metric.numerator === void 0 || metric.denominator === void 0 ? percent : `${metric.numerator} of ${metric.denominator} (${percent})`;
+}
+async function showMeasurementProperty(project, opts) {
+  const response = await createApiClient().getMeasurementOverview(project, {
+    scope: "property",
+    targetKey: opts.targetKey,
+    ...opts.queryClass === void 0 ? {} : { queryClass: opts.queryClass },
+    ...opts.provider === void 0 ? {} : { provider: opts.provider },
+    ...opts.location === void 0 ? {} : { location: opts.location },
+    ...opts.runId === void 0 ? {} : { runId: opts.runId }
+  });
+  if (isMachineFormat(opts.format)) {
+    console.log(JSON.stringify(response, null, 2));
+    return;
+  }
+  printMeasurementProperty(response);
+}
+function printMeasurementProperty(response) {
+  const row = response.properties.items.at(0);
+  const lines = [];
+  lines.push(`${response.scope.label} \u2014 ${response.queryClass} questions`);
+  lines.push(`Measurement: ${response.measurement.state}${response.measurement.displayedRunId ? ` \xB7 run ${response.measurement.displayedRunId}` : ""}`);
+  lines.push("");
+  lines.push(`Mentioned  ${metricText(row ? row.mentionCoverage : response.metrics.mentionCoverage)}`);
+  lines.push(`Cited      ${metricText(row ? row.citationCoverage : response.metrics.citationCoverage)}`);
+  if (row && row.flags > 0) lines.push(`Flagged    ${row.flags} ${row.flags === 1 ? "result needs" : "results need"} review`);
+  if (row && row.providers.length > 0) {
+    lines.push("");
+    lines.push(`${"Engine".padEnd(14)}${"Mentioned".padEnd(34)}Cited`);
+    for (const provider of row.providers) {
+      lines.push(`${provider.provider.padEnd(14)}${metricText(provider.mentionCoverage).padEnd(34)}${metricText(provider.citationCoverage)}`);
+    }
+  }
+  console.log(lines.join("\n"));
+}
+async function showMeasurementPropertyEvidence(project, opts) {
+  const response = await createApiClient().getMeasurementPropertyEvidence(project, {
+    targetKey: opts.targetKey,
+    ...opts.queryClass === void 0 ? {} : { queryClass: opts.queryClass },
+    ...opts.provider === void 0 ? {} : { provider: opts.provider },
+    ...opts.location === void 0 ? {} : { location: opts.location },
+    ...opts.runId === void 0 ? {} : { runId: opts.runId },
+    ...opts.cursor === void 0 ? {} : { cursor: opts.cursor },
+    ...opts.limit === void 0 ? {} : { limit: opts.limit }
+  });
+  if (opts.format === "jsonl") {
+    emitJsonl([{
+      kind: "measurement-property-evidence-header",
+      property: response.property,
+      queryClass: response.queryClass,
+      measurement: response.measurement,
+      totalEstimate: response.evidence.totalEstimate ?? null,
+      nextCursor: response.evidence.nextCursor ?? null
+    }]);
+    emitJsonl(response.evidence.items);
+    return;
+  }
+  if (opts.format === "json") {
+    console.log(JSON.stringify(response, null, 2));
+    return;
+  }
+  printMeasurementPropertyEvidence(response);
+}
+function printMeasurementPropertyEvidence(response) {
+  const lines = [];
+  lines.push(`${response.property.label} \u2014 ${response.queryClass} questions`);
+  if (response.measurement.state === "not_measured") {
+    lines.push("Not measured yet. Run a measurement to collect source evidence.");
+    console.log(lines.join("\n"));
+    return;
+  }
+  const page = response.evidence;
+  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.");
+    console.log(lines.join("\n"));
+    return;
+  }
+  lines.push(`${page.items.length} of ${page.totalEstimate ?? page.items.length} 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.nextCursor) lines.push(`
+More rows: --cursor ${page.nextCursor}`);
+  console.log(lines.join("\n"));
+}
 
 // src/cli-commands/measurement-plan.ts
+var QUERY_CLASSES = ["all", "branded", "non-brand"];
+function queryClassOption(input) {
+  const value = getString(input.values, "query-class");
+  if (value === void 0) return void 0;
+  const match = QUERY_CLASSES.find((candidate) => candidate === value);
+  if (!match) throw usageError(`--query-class must be one of ${QUERY_CLASSES.join(", ")}`);
+  return match;
+}
+function propertyScope(input, command, usage) {
+  return {
+    targetKey: requireStringOption(input, "target-key", { command, usage, message: "--target-key is required" }),
+    queryClass: queryClassOption(input),
+    provider: getString(input.values, "provider"),
+    location: getString(input.values, "location"),
+    runId: getString(input.values, "run-id"),
+    format: input.format
+  };
+}
+var PROPERTY_SCOPE_OPTIONS = {
+  "target-key": stringOption(),
+  "query-class": stringOption(),
+  provider: stringOption(),
+  location: stringOption(),
+  "run-id": stringOption()
+};
 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");
@@ -15816,6 +15939,35 @@ var MEASUREMENT_PLAN_CLI_COMMANDS = [
       }
       return showMeasurementReport(project, revision);
     }
+  },
+  {
+    path: ["measurement-plan", "property"],
+    usage: "canonry measurement-plan property <project> --target-key <key> [--query-class all|branded|non-brand] [--provider <p>] [--location <l>] [--run-id <id>] [--format json]",
+    options: PROPERTY_SCOPE_OPTIONS,
+    run: (input) => {
+      const usage = "canonry measurement-plan property <project> --target-key <key>";
+      const project = requireProject(input, "measurement-plan.property", usage);
+      return showMeasurementProperty(project, propertyScope(input, "measurement-plan.property", usage));
+    }
+  },
+  {
+    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() },
+    run: (input) => {
+      const usage = "canonry measurement-plan property-evidence <project> --target-key <key>";
+      const project = requireProject(input, "measurement-plan.property-evidence", usage);
+      const limitValue = getString(input.values, "limit");
+      const limit = limitValue === void 0 ? void 0 : Number(limitValue);
+      if (limit !== void 0 && (!Number.isInteger(limit) || limit < 1 || limit > 100)) {
+        throw usageError("--limit must be an integer from 1 to 100");
+      }
+      return showMeasurementPropertyEvidence(project, {
+        ...propertyScope(input, "measurement-plan.property-evidence", usage),
+        cursor: getString(input.values, "cursor"),
+        ...limit === void 0 ? {} : { limit }
+      });
+    }
   }
 ];
 

package/dist/index.js

@@ -1,11 +1,11 @@
 import {
   createServer
-} from "./chunk-3NYTF3YC.js";
+} from "./chunk-Z7B6BRPP.js";
 import {
   loadConfig
-} from "./chunk-Z672VQ7G.js";
-import "./chunk-7D2GZU6O.js";
-import "./chunk-WADGZMWT.js";
+} from "./chunk-UQOTEIA6.js";
+import "./chunk-ED7C5TWT.js";
+import "./chunk-B5H55ZMA.js";
 export {
   createServer,
   loadConfig

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

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

package/dist/mcp.js

@@ -3,10 +3,10 @@ import {
   PACKAGE_VERSION,
   canonryMcpTools,
   createApiClient
-} from "./chunk-Z672VQ7G.js";
+} from "./chunk-UQOTEIA6.js";
 import {
   isReadOnlyKey
-} from "./chunk-WADGZMWT.js";
+} from "./chunk-B5H55ZMA.js";
 
 // src/mcp/cli.ts
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
@@ -116,9 +116,9 @@ var CANONRY_MCP_TOOLKITS = [
   },
   {
     name: "setup",
-    title: "Project configuration",
-    description: "Manage queries, competitors, schedules, project upsert, and config-as-code roundtrips.",
-    whenToLoad: "Load when onboarding a new project or editing tracked queries, competitors, or schedules."
+    title: "Project setup and measurement",
+    description: "Manage project configuration, Advanced Measurement drafts, query assets, competitors, and schedules.",
+    whenToLoad: "Load when onboarding a project, editing its measurement plan, or managing tracked queries, competitors, or schedules."
   },
   {
     name: "gsc",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ainyc/canonry",
-  "version": "4.144.0",
+  "version": "4.146.0",
   "type": "module",
   "description": "Agent-first open-source AEO operating platform - track how answer engines cite your domain",
   "license": "FSL-1.1-ALv2",
@@ -68,23 +68,23 @@
     "@ainyc/canonry-api-client": "0.0.0",
     "@ainyc/canonry-api-routes": "0.0.0",
     "@ainyc/canonry-config": "0.0.0",
-    "@ainyc/canonry-db": "0.0.0",
     "@ainyc/canonry-contracts": "0.0.0",
+    "@ainyc/canonry-db": "0.0.0",
     "@ainyc/canonry-integration-bing": "0.0.0",
+    "@ainyc/canonry-integration-cloud-run": "0.0.0",
+    "@ainyc/canonry-integration-commoncrawl": "0.0.0",
     "@ainyc/canonry-integration-openai-ads": "0.0.0",
     "@ainyc/canonry-integration-google": "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-cloud-run": "0.0.0",
     "@ainyc/canonry-integration-traffic": "0.0.0",
     "@ainyc/canonry-integration-wordpress": "0.0.0",
-    "@ainyc/canonry-provider-cdp": "0.0.0",
+    "@ainyc/canonry-integration-google-business-profile": "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-gemini": "0.0.0",
     "@ainyc/canonry-provider-local": "0.0.0",
     "@ainyc/canonry-provider-openai": "0.0.0",
+    "@ainyc/canonry-provider-gemini": "0.0.0",
     "@ainyc/canonry-provider-perplexity": "0.0.0"
   },
   "scripts": {