@canonry/canonry 4.131.0 → 4.133.0

package/dist/cli.js

@@ -29,7 +29,7 @@ import {
   setTelemetrySource,
   showFirstRunNotice,
   trackEvent
-} from "./chunk-5GQ6FF5R.js";
+} from "./chunk-42P7POVS.js";
 import {
   CliError,
   EXIT_SYSTEM_ERROR,
@@ -46,7 +46,7 @@ import {
   saveConfig,
   saveConfigPatch,
   usageError
-} from "./chunk-73HPY6XQ.js";
+} from "./chunk-P4MIG7V5.js";
 import {
   apiKeys,
   createClient,
@@ -54,7 +54,7 @@ import {
   projects,
   queries,
   renderReportHtml
-} from "./chunk-ZXVWL5HX.js";
+} from "./chunk-VPY3PZXV.js";
 import {
   AdsOperationKinds,
   AdsOperationStates,
@@ -97,7 +97,7 @@ import {
   providerQuotaPolicySchema,
   resolveProviderInput,
   winnabilityClassSchema
-} from "./chunk-3WBAJKRR.js";
+} from "./chunk-ZPQX5ZQ2.js";
 
 // src/cli.ts
 import { pathToFileURL } from "url";
@@ -3937,6 +3937,47 @@ async function gaTraffic(project, opts) {
   Last synced: ${result.lastSyncedAt}`);
   }
 }
+async function gaMeasurementAnalysis(project, opts) {
+  const client = getClient7();
+  const params = {};
+  if (opts?.window) params.window = opts.window;
+  if (opts?.hostScope) params.hostScope = opts.hostScope;
+  if (opts?.pathPrefix) params.pathPrefix = opts.pathPrefix;
+  if (opts?.limit) params.limit = String(opts.limit);
+  const result = await client.gaMeasurementAnalysis(
+    project,
+    Object.keys(params).length > 0 ? params : void 0
+  );
+  if (isMachineFormat(opts?.format)) {
+    console.log(JSON.stringify(result, null, 2));
+    return;
+  }
+  console.log(`GA4 Measurement Analysis for "${project}" (${result.window})
+`);
+  console.log(`  Acquisition: ${result.acquisition.status}`);
+  if (result.acquisition.error) console.log(`    Error: ${result.acquisition.error}`);
+  for (const period of result.acquisition.periods) {
+    console.log(`    ${period.label.padEnd(8)} ${period.sessions} sessions  ${period.startDate} to ${period.endDate}`);
+  }
+  if (result.acquisition.channels.length > 0) {
+    console.log("  Native channels (latest cohort)");
+    for (const channel of result.acquisition.channels) {
+      console.log(`    ${channel.channelGroup}: ${channel.periods.at(-1)?.sessions ?? 0}`);
+    }
+  }
+  console.log(`  Leads: ${result.leads.status}${result.leads.attributionScope ? ` (${result.leads.attributionScope} attribution)` : ""}`);
+  if (result.leads.error) console.log(`    Error: ${result.leads.error}`);
+  for (const period of result.leads.periods) {
+    console.log(`    ${period.label.padEnd(8)} ${period.eventCount} leads  ${period.startDate} to ${period.endDate}`);
+  }
+  console.log(`  Search demand: ${result.searchDemand.status}`);
+  for (const period of result.searchDemand.periods) {
+    console.log(`    ${period.label.padEnd(8)} ${period.propertyClicks} clicks / ${period.propertyImpressions} impressions  (${period.brandedClicks} branded clicks / ${period.brandedImpressions} branded impressions; ${period.nonBrandedClicks} reported non-brand clicks / ${period.nonBrandedImpressions} reported non-brand impressions; ${period.unreportedClicks} unreported clicks / ${period.unreportedImpressions} unreported impressions)`);
+  }
+  if (!result.leads.hostAndPathFiltersApplied && result.leads.attributionScope === "channel") {
+    console.log("  Note: lead attribution is channel-level; host and path filters do not apply to leads.");
+  }
+}
 async function gaAiReferralHistory(project, opts) {
   const client = getClient7();
   const result = await client.gaAiReferralHistory(project, opts?.window ? { window: opts.window } : void 0);
@@ -4367,6 +4408,27 @@ var GA_CLI_COMMANDS = [
       });
     }
   },
+  {
+    path: ["ga", "measurement-analysis"],
+    usage: "canonry ga measurement-analysis <project> [--window 30d|60d|90d] [--host-scope marketing|all] [--path-prefix /path] [--limit 100] [--format json]",
+    options: {
+      window: stringOption(),
+      "host-scope": stringOption(),
+      "path-prefix": stringOption(),
+      limit: stringOption()
+    },
+    run: async (input) => {
+      const project = requireProject(input, "ga.measurement-analysis", "canonry ga measurement-analysis <project> [--window 30d|60d|90d] [--format json]");
+      const limitValue = getString(input.values, "limit");
+      await gaMeasurementAnalysis(project, {
+        window: getString(input.values, "window"),
+        hostScope: getString(input.values, "host-scope"),
+        pathPrefix: getString(input.values, "path-prefix"),
+        limit: limitValue ? parseInt(limitValue, 10) : void 0,
+        format: input.format
+      });
+    }
+  },
   {
     path: ["ga", "traffic"],
     usage: "canonry ga traffic <project> [--limit 50] [--window 30d] [--format json]",
@@ -4471,7 +4533,7 @@ var GA_CLI_COMMANDS = [
       unknownSubcommand(input.positionals[0], {
         command: "ga",
         usage: "canonry ga <subcommand> <project> [args]",
-        available: ["connect", "disconnect", "status", "sync", "traffic", "coverage", "ai-referral-history", "social-referral-history", "session-history", "social-referral-summary", "attribution"]
+        available: ["connect", "disconnect", "status", "sync", "measurement-analysis", "traffic", "coverage", "ai-referral-history", "social-referral-history", "session-history", "social-referral-summary", "attribution"]
       });
     }
   }
@@ -9343,6 +9405,70 @@ var REPORT_CLI_COMMANDS = [
   }
 ];
 
+// src/commands/organic-evidence.ts
+async function showOrganicEvidence(project, opts) {
+  const data = await createApiClient().getOrganicEvidence(project, opts.period);
+  if (isMachineFormat(opts.format)) {
+    console.log(JSON.stringify(data, null, 2));
+    return;
+  }
+  printOrganicEvidence(project, data);
+}
+function formatCounts(clicks, impressions) {
+  return `${clicks} clicks / ${impressions} impressions`;
+}
+function printOrganicEvidence(project, data) {
+  const asOf = data.asOfDate ? ` through ${data.asOfDate}` : "";
+  console.log(`Organic evidence: ${project}  (${data.periodDays} days${asOf})`);
+  console.log(`Coverage: GSC ${data.coverage.gsc ? "yes" : "no"} \xB7 GA4 ${data.coverage.ga4 ? "yes" : "no"} \xB7 server ${data.coverage.server ? "yes" : "no"} \xB7 AI visibility ${data.coverage.visibility ? "yes" : "no"}`);
+  if (data.gsc) {
+    console.log(`Google Search: ${formatCounts(data.gsc.propertyTotals.clicks, data.gsc.propertyTotals.impressions)} (named non-brand: ${formatCounts(data.gsc.namedNonBrand.clicks, data.gsc.namedNonBrand.impressions)})`);
+  }
+  if (data.ga4) console.log(`GA4 organic: ${data.ga4.organicSessions} sessions`);
+  if (data.gaAiReferrals) console.log(`GA4 AI referrals: ${data.gaAiReferrals.organicSessions} organic, ${data.gaAiReferrals.paidSessions} paid sessions`);
+  if (data.server) {
+    const s = data.server;
+    const fetchTotal = s.userFetchHits.verified + s.userFetchHits.claimedUnverified + s.userFetchHits.unknownAiLike;
+    console.log(`Server AI: ${s.crawlerHits.verified} verified + ${s.crawlerHits.claimedUnverified} claimed + ${s.crawlerHits.unknownAiLike} heuristic crawls; ${fetchTotal} user-agent fetches (${s.userFetchHits.verified} verified, ${s.userFetchHits.claimedUnverified} claimed, ${s.userFetchHits.unknownAiLike} heuristic); ${s.referralSessions.organic} organic referrals, ${s.referralSessions.paid} paid, ${s.referralSessions.unknown} unclassified`);
+  }
+  if (data.visibility) {
+    const v = data.visibility;
+    console.log(`Latest AI visibility: ${v.mentionedPairs}/${v.answerPairs} mentioned, ${v.citedPairs}/${v.answerPairs} cited (${Math.floor(v.ageDays)}d old)`);
+  }
+  if (data.findings.length > 0) {
+    console.log("\nFindings:");
+    for (const finding of data.findings) console.log(`- ${finding.title}: ${finding.detail}`);
+  }
+  if (data.limitations.length > 0) {
+    console.log("\nLimitations:");
+    for (const limitation of data.limitations) console.log(`- ${limitation.detail}`);
+  }
+}
+
+// src/cli-commands/organic-evidence.ts
+var USAGE4 = "canonry organic-evidence <project> [--period 60|90] [--format json|jsonl]";
+function parsePeriod2(value) {
+  if (value === void 0) return void 0;
+  if (value === "60" || value === "90") return Number(value);
+  throw usageError(`Error: --period must be 60 or 90
+
+Usage: ${USAGE4}`);
+}
+var ORGANIC_EVIDENCE_CLI_COMMANDS = [
+  {
+    path: ["organic-evidence"],
+    usage: USAGE4,
+    options: { period: stringOption() },
+    run: async (input) => {
+      const project = requireProject(input, "organic-evidence", USAGE4);
+      await showOrganicEvidence(project, {
+        period: parsePeriod2(getString(input.values, "period")),
+        format: input.format
+      });
+    }
+  }
+];
+
 // src/commands/run.ts
 function getClient22() {
   return createApiClient();
@@ -13242,12 +13368,12 @@ function printVisibilityStats(data) {
 }
 
 // src/cli-commands/visibility-stats.ts
-var USAGE4 = "canonry visibility-stats <project> [--since <iso>] [--until <iso>] [--month <YYYY-MM>] [--last-runs <n>] [--by-provider] [--share-of-voice] [--format json|jsonl]";
+var USAGE5 = "canonry visibility-stats <project> [--since <iso>] [--until <iso>] [--month <YYYY-MM>] [--last-runs <n>] [--by-provider] [--share-of-voice] [--format json|jsonl]";
 var COMPARE_USAGE = "canonry visibility-compare <project> --from <YYYY-MM> --to <YYYY-MM> [--format json]";
 var VISIBILITY_STATS_CLI_COMMANDS = [
   {
     path: ["visibility-stats"],
-    usage: USAGE4,
+    usage: USAGE5,
     options: {
       since: stringOption(),
       until: stringOption(),
@@ -13257,14 +13383,14 @@ var VISIBILITY_STATS_CLI_COMMANDS = [
       "share-of-voice": { type: "boolean", default: false }
     },
     run: async (input) => {
-      const project = requireProject(input, "visibility-stats", USAGE4);
+      const project = requireProject(input, "visibility-stats", USAGE5);
       await showVisibilityStats(project, {
         since: getString(input.values, "since"),
         until: getString(input.values, "until"),
         month: getString(input.values, "month"),
         lastRuns: parseIntegerOption(input, "last-runs", {
           command: "visibility-stats",
-          usage: USAGE4,
+          usage: USAGE5,
           message: "--last-runs must be an integer"
         }),
         byProvider: getBoolean(input.values, "by-provider"),
@@ -14871,6 +14997,7 @@ var REGISTERED_CLI_COMMANDS = [
   ...SYSTEM_CLI_COMMANDS,
   ...PROJECT_CLI_COMMANDS,
   ...REPORT_CLI_COMMANDS,
+  ...ORGANIC_EVIDENCE_CLI_COMMANDS,
   ...QUERY_CLI_COMMANDS,
   ...KEYWORD_CLI_COMMANDS,
   ...KEYS_CLI_COMMANDS,
@@ -14904,7 +15031,7 @@ var REGISTERED_CLI_COMMANDS = [
 
 // src/cli.ts
 import { createRequire as createRequire2 } from "module";
-var USAGE5 = `
+var USAGE6 = `
 cnry \u2014 AEO monitoring CLI   ('canonry' also works)
 
 Usage:  cnry <command> [options]
@@ -14927,6 +15054,7 @@ Monitoring:
   status <project>      Show project summary
   evidence <project>    Show per-query results
   analytics <project>   Show analytics (metrics, gaps, sources)
+  organic-evidence      Reconcile 60/90d search, GA4, and server AI evidence
   insights <project>    Show intelligence insights
   health <project>      Show citation health
 
@@ -14969,7 +15097,7 @@ function extractFormat(cmdArgs) {
 }
 async function runCli(args = process.argv.slice(2)) {
   if (args.length === 0 || args[0] === "--help" || args[0] === "-h") {
-    console.log(USAGE5);
+    console.log(USAGE6);
     return 0;
   }
   if (args.includes("--version") || args.includes("-v")) {

package/dist/index.js

@@ -1,11 +1,11 @@
 import {
   createServer
-} from "./chunk-5GQ6FF5R.js";
+} from "./chunk-42P7POVS.js";
 import {
   loadConfig
-} from "./chunk-73HPY6XQ.js";
-import "./chunk-ZXVWL5HX.js";
-import "./chunk-3WBAJKRR.js";
+} from "./chunk-P4MIG7V5.js";
+import "./chunk-VPY3PZXV.js";
+import "./chunk-ZPQX5ZQ2.js";
 export {
   createServer,
   loadConfig

package/dist/{intelligence-service-YJKQQYJQ.js → intelligence-service-2K7GVEQM.js}

@@ -1,7 +1,7 @@
 import {
   IntelligenceService
-} from "./chunk-ZXVWL5HX.js";
-import "./chunk-3WBAJKRR.js";
+} from "./chunk-VPY3PZXV.js";
+import "./chunk-ZPQX5ZQ2.js";
 export {
   IntelligenceService
 };

package/dist/mcp.js

@@ -3,10 +3,10 @@ import {
   PACKAGE_VERSION,
   canonryMcpTools,
   createApiClient
-} from "./chunk-73HPY6XQ.js";
+} from "./chunk-P4MIG7V5.js";
 import {
   isReadOnlyKey
-} from "./chunk-3WBAJKRR.js";
+} from "./chunk-ZPQX5ZQ2.js";
 
 // src/mcp/cli.ts
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@canonry/canonry",
-  "version": "4.131.0",
+  "version": "4.133.0",
   "type": "module",
   "description": "Agent-first open-source AEO operating platform - track how answer engines cite your domain",
   "license": "FSL-1.1-ALv2",
@@ -66,26 +66,26 @@
     "tsup": "^8.5.1",
     "tsx": "^4.19.0",
     "@ainyc/canonry-api-client": "0.0.0",
-    "@ainyc/canonry-contracts": "0.0.0",
     "@ainyc/canonry-api-routes": "0.0.0",
     "@ainyc/canonry-config": "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-openai-ads": "0.0.0",
     "@ainyc/canonry-integration-cloud-run": "0.0.0",
     "@ainyc/canonry-integration-google": "0.0.0",
+    "@ainyc/canonry-integration-commoncrawl": "0.0.0",
     "@ainyc/canonry-integration-google-business-profile": "0.0.0",
     "@ainyc/canonry-integration-google-places": "0.0.0",
     "@ainyc/canonry-integration-traffic": "0.0.0",
-    "@ainyc/canonry-integration-commoncrawl": "0.0.0",
     "@ainyc/canonry-intelligence": "0.0.0",
-    "@ainyc/canonry-integration-wordpress": "0.0.0",
-    "@ainyc/canonry-provider-claude": "0.0.0",
-    "@ainyc/canonry-provider-gemini": "0.0.0",
     "@ainyc/canonry-provider-cdp": "0.0.0",
+    "@ainyc/canonry-provider-claude": "0.0.0",
+    "@ainyc/canonry-integration-wordpress": "0.0.0",
     "@ainyc/canonry-provider-local": "0.0.0",
-    "@ainyc/canonry-provider-perplexity": "0.0.0",
-    "@ainyc/canonry-provider-openai": "0.0.0"
+    "@ainyc/canonry-provider-gemini": "0.0.0",
+    "@ainyc/canonry-provider-openai": "0.0.0",
+    "@ainyc/canonry-provider-perplexity": "0.0.0"
   },
   "scripts": {
     "build": "tsx scripts/copy-agent-assets.ts && tsup && tsx build-web.ts",