@canonry/canonry 7.14.0 → 7.16.0

package/dist/{chunk-KXHPQMBP.js → chunk-VWSUFTW5.js}

@@ -20,20 +20,20 @@ import {
   saveConfig,
   saveConfigPatch,
   sentimentInstallReadiness
-} from "./chunk-ZHXOR2LJ.js";
+} from "./chunk-3ZGBSHZ2.js";
 import {
   computeFactorAverages,
   deleteSiteCrawlGraphLayout,
   persistSiteCrawlGraphLayout,
   prepareSiteCrawlGraphLayout,
   recordedSharePct
-} from "./chunk-WHVEDCHY.js";
+} from "./chunk-2S7U2YHI.js";
 import {
   CanonryMcpToolNames,
   CliError,
   PACKAGE_VERSION,
   canonryMcpTools
-} from "./chunk-4LQ4HKVK.js";
+} from "./chunk-KDWTNI4Z.js";
 import {
   CC_CACHE_DIR,
   DUCKDB_SPEC,
@@ -217,7 +217,7 @@ import {
   siteLivenessState,
   toAlertView,
   usageCounters
-} from "./chunk-EZRBFH77.js";
+} from "./chunk-SPZRSKCF.js";
 import {
   AGENT_MEMORY_VALUE_MAX_BYTES,
   AGENT_NONE,
@@ -238,6 +238,7 @@ import {
   DEFAULT_VIEWER_RESEARCH_DAILY_RUN_LIMIT,
   DiscoveryCompetitorTypes,
   FEEDBACK_LIMITS,
+  GBP_NO_SELECTED_LOCATIONS_ERROR,
   GOOGLE_ADS_CAMPAIGN_METRICS_MAX_CAMPAIGNS,
   GOOGLE_ADS_CAMPAIGN_METRICS_MAX_DAYS,
   GOOGLE_ADS_CAMPAIGN_METRICS_MAX_ROWS,
@@ -328,6 +329,7 @@ import {
   deriveSiteHealthState,
   describeBatchIneligibility,
   describeError,
+  describeFetchError,
   detectAgentRuntime,
   determineAnswerMentioned,
   dollarsToMicros,
@@ -430,7 +432,7 @@ import {
   winnabilityClassLabel,
   withRetry,
   withSkippedProviders
-} from "./chunk-A25FO3Z5.js";
+} from "./chunk-6LS2R477.js";
 
 // src/runtime-context.ts
 function cliRuntimeContext(env = process.env, stdio = process) {
@@ -1597,15 +1599,16 @@ var GoogleAdsClient = class {
     if (includeLoginCustomerId && this.#loginCustomerId) {
       headers["login-customer-id"] = this.#loginCustomerId;
     }
+    const url = `${GOOGLE_ADS_API_BASE}${path9}`;
     let response;
     try {
-      response = await this.#fetch(`${GOOGLE_ADS_API_BASE}${path9}`, {
+      response = await this.#fetch(url, {
         ...init,
         headers,
         signal: AbortSignal.timeout(this.#requestTimeoutMs)
       });
     } catch (error) {
-      const detail = describeError(error);
+      const detail = describeFetchError(error, url);
       throw new GoogleAdsApiError(
         `Google Ads API request failed: ${sanitizeText(detail, this.#secrets())}`
       );
@@ -8042,7 +8045,7 @@ function nonBlank(value) {
   return trimmed ? trimmed : void 0;
 }
 function resolveBuildCommit(env = process.env) {
-  const embedded = true ? "8eb9720cf39e4787ffa530b4083372db8c39ae8f" : void 0;
+  const embedded = true ? "27c13aa5394b95a729a483c1d7062fc4be42361f" : void 0;
   return nonBlank(embedded) ?? nonBlank(env.CANONRY_COMMIT);
 }
 function resolveInstanceIdentity(env = process.env) {
@@ -11005,7 +11008,7 @@ async function executeGbpSync(db, runId, projectId, opts) {
       locationRows = locationRows.filter((l) => wanted.has(l.locationName));
     }
     if (locationRows.length === 0) {
-      throw new Error("No selected GBP locations to sync. Discover and select locations first.");
+      throw new Error(GBP_NO_SELECTED_LOCATIONS_ERROR);
     }
     locationRows = await refreshSelectedLocationProfiles(db, projectId, accessToken, locationRows);
     const daysOfMetrics = opts.daysOfMetrics ?? DEFAULT_DAYS_OF_METRICS;
@@ -15453,27 +15456,47 @@ function gaRefreshDays(now = /* @__PURE__ */ new Date()) {
   const reach = inclusiveDayCount(`${reportMonth}-01`, now.toISOString().slice(0, 10)) ?? 0;
   return Math.max(30, reach);
 }
+function queuedRun(result2) {
+  const record2 = asRecord(result2);
+  const runId = record2?.runId ?? record2?.id;
+  const runStatus = record2?.status;
+  return {
+    runId: typeof runId === "string" ? runId : null,
+    runStatus: typeof runStatus === "string" ? runStatus : null
+  };
+}
 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: gaRefreshDays(now) }) },
-    { name: "gbp", run: () => client.triggerGbpSync(projectName, {}) },
+    { name: "gsc", completion: "queued", run: () => client.gscSync(projectName, {}) },
+    { name: "bing", completion: "queued", run: () => client.bingInspectSitemap(projectName, {}) },
+    { name: "ga", completion: "synchronous", run: () => client.gaSync(projectName, { days: gaRefreshDays(now) }) },
+    { name: "gbp", completion: "queued", run: () => client.triggerGbpSync(projectName, {}) },
     // `ads` remains the OpenAI / ChatGPT Ads integration. For scheduled
     // refreshes, Google providers have explicit names and fan out only here.
-    { name: "ads", run: () => client.triggerAdsSync(projectName) },
-    { name: "google-ads", run: () => client.triggerGoogleAdsSync(projectName) },
-    { name: "gtm", run: () => client.triggerGtmSync(projectName) }
+    { name: "ads", completion: "queued", run: () => client.triggerAdsSync(projectName) },
+    { name: "google-ads", completion: "queued", run: () => client.triggerGoogleAdsSync(projectName) },
+    { name: "gtm", completion: "queued", run: () => client.triggerGtmSync(projectName) }
   ];
   const results = await Promise.allSettled(integrations.map((i) => i.run()));
   results.forEach((result2, idx) => {
-    const integration = integrations[idx].name;
-    if (result2.status === "fulfilled") {
-      log19.info("integration.refreshed", { projectName, integration });
-    } else {
+    const { name: integration, completion } = integrations[idx];
+    if (result2.status === "rejected") {
       const reason = result2.reason;
       const message = describeError(reason);
       log19.warn("integration.refresh-failed", { projectName, integration, error: message });
+      return;
+    }
+    switch (completion) {
+      case "synchronous":
+        log19.info("integration.refreshed", { projectName, integration });
+        return;
+      case "queued":
+        log19.info("integration.queued", { projectName, integration, ...queuedRun(result2.value) });
+        return;
+      default: {
+        const _exhaustive = completion;
+        return _exhaustive;
+      }
     }
   });
 }

package/dist/cli.js

@@ -33,11 +33,11 @@ import {
   trackCliCommandFinished,
   trackEvent,
   waitForServerRuntimeStartup
-} from "./chunk-KXHPQMBP.js";
+} from "./chunk-VWSUFTW5.js";
 import {
   autoSyncSkills,
   formatAutoSyncNotice
-} from "./chunk-LUQ5G5OO.js";
+} from "./chunk-O6XPXEN6.js";
 import {
   configExists,
   createApiClient,
@@ -54,13 +54,13 @@ import {
   saveConfig,
   saveConfigPatch,
   shouldPrintServeSkillsNudge
-} from "./chunk-ZHXOR2LJ.js";
+} from "./chunk-3ZGBSHZ2.js";
 import {
   DEFAULT_DEMO_TRUSTED_PROXIES,
   trustedProxiesProblem,
   trustedProxyProblem
 } from "./chunk-RB2F4D3Z.js";
-import "./chunk-WHVEDCHY.js";
+import "./chunk-2S7U2YHI.js";
 import {
   CliError,
   EXIT_SYSTEM_ERROR,
@@ -72,7 +72,7 @@ import {
   runMeasurementDraftAction,
   systemError,
   usageError
-} from "./chunk-4LQ4HKVK.js";
+} from "./chunk-KDWTNI4Z.js";
 import {
   CLOUDFLARE_WORKER_BINDINGS,
   CLOUDFLARE_WORKER_GENERATED_MARKER,
@@ -104,7 +104,7 @@ import {
   rawEventSamples,
   readMarketCompetitorNames,
   runs
-} from "./chunk-EZRBFH77.js";
+} from "./chunk-SPZRSKCF.js";
 import {
   AdsDeliverySnapshotStatuses,
   AdsHistoricalCampaignRollupStatuses,
@@ -234,7 +234,7 @@ import {
   visibilityCompareSelectionSchema,
   visibilityReportRequestSchema,
   winnabilityClassSchema
-} from "./chunk-A25FO3Z5.js";
+} from "./chunk-6LS2R477.js";
 
 // src/cli.ts
 import { pathToFileURL } from "url";
@@ -784,7 +784,7 @@ function parseDemoTrustedProxies(values) {
 async function demoCommand(options) {
   const { host, port } = parseDemoListenOptions(options);
   const trustProxy = parseDemoTrustedProxies(options.trustProxy);
-  const { createDemoServer } = await import("./demo-server-SIATTXXS.js");
+  const { createDemoServer } = await import("./demo-server-6OE3H2KL.js");
   const app = await createDemoServer({ trustProxy });
   let stopping = false;
   const stop = () => {
@@ -1198,7 +1198,7 @@ No DB writes performed. Re-run without --dry-run to apply.`);
   }
 }
 async function backfillInsightsCommand(project2, opts) {
-  const { IntelligenceService } = await import("./intelligence-service-UEEVETII.js");
+  const { IntelligenceService } = await import("./intelligence-service-USSTKAKC.js");
   const config = loadConfig();
   const db = createClient(config.database);
   migrate(db);
@@ -5530,6 +5530,48 @@ async function gaTraffic(project2, opts) {
   Last synced: ${result.lastSyncedAt}`);
   }
 }
+var AI_ENGINE_LEAD_RATE_NOTES = {
+  "no-data": null,
+  "sync-not-ready": "the latest acquisition or lead sync failed, so sessions and lead events may cover different days; rerun the GA sync for lead rates.",
+  "channel-leads-unfiltered": "lead events are channel-level here, so host and path filters narrow sessions but not leads; rerun with --host-scope all and no --path-prefix for lead rates.",
+  "paid-split-needs-landing-page": "lead events are channel-level here, so the paid/organic split cannot read landing-page utm tags, and some AI sessions were paid only by those tags (counted as organic above); tag paid AI links with a paid utm_medium such as cpc for lead rates.",
+  "sessions-behind-leads": "stored lead events run past the last stored session date, so recent leads have no sessions to divide by; rerun the GA sync for lead rates.",
+  "sessions-missing-on-lead-days": "some days in this window have stored lead events but no stored sessions, so those leads have no sessions to divide by; rerun the GA sync with --days covering the window for lead rates."
+};
+function hasAiEngineLeadRows(block) {
+  return block.engines.length > 0 || block.unattributed.sources.length > 0;
+}
+function printAiEngineLeadClass(heading, block) {
+  const cell2 = (period) => `${period.eventCount} / ${period.sessions}  ${formatPercent(period.leadRate)}`;
+  const rows = [
+    ...block.engines.map((engine) => ({ label: engine.label, cells: engine.periods.map(cell2) })),
+    ...block.unattributed.sources.length > 0 ? [{ label: "Other AI Assistant", cells: block.unattributed.periods.map(cell2) }] : [],
+    { label: "All AI", cells: block.periods.map(cell2) }
+  ];
+  const labelWidth = Math.max("ENGINE".length, ...rows.map((row) => row.label.length));
+  const widths = block.periods.map((period, index) => Math.max(
+    period.label.length,
+    ...rows.map((row) => row.cells[index]?.length ?? 0)
+  ));
+  const line = (label, cells) => `    ${label.padEnd(labelWidth)}  ${cells.map((value, index) => value.padEnd(widths[index] ?? 0)).join("  ")}`.trimEnd();
+  console.log(`  ${heading} (lead events / AI sessions, lead rate)`);
+  console.log(line("ENGINE", block.periods.map((period) => period.label.toUpperCase())));
+  for (const row of rows) console.log(line(row.label, row.cells));
+}
+function printAiEngineLeads(aiEngines) {
+  if (!aiEngines) return;
+  if (aiEngines.organic.periods.length === 0) return;
+  if (!hasAiEngineLeadRows(aiEngines.organic) && !hasAiEngineLeadRows(aiEngines.paid)) {
+    console.log("  Leads by AI engine: no AI engine sessions or lead events in this window");
+    return;
+  }
+  printAiEngineLeadClass("Leads by AI engine, organic", aiEngines.organic);
+  if (hasAiEngineLeadRows(aiEngines.paid)) {
+    printAiEngineLeadClass("Leads by AI engine, paid clicks", aiEngines.paid);
+  }
+  const note = aiEngines.leadRateUnavailableReason === null ? null : AI_ENGINE_LEAD_RATE_NOTES[aiEngines.leadRateUnavailableReason];
+  if (note) console.log(`    Note: ${note}`);
+}
 async function gaMeasurementAnalysis(project2, opts) {
   const client = getClient7();
   const params = {};
@@ -5563,6 +5605,7 @@ async function gaMeasurementAnalysis(project2, opts) {
   for (const period of result.leads.periods) {
     console.log(`    ${period.label.padEnd(8)} ${period.eventCount} leads  ${period.startDate} to ${period.endDate}`);
   }
+  printAiEngineLeads(result.leads.aiEngines);
   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)`);

package/dist/{demo-server-SIATTXXS.js → demo-server-6OE3H2KL.js}

@@ -5,11 +5,11 @@ import {
   computeFactorAverages,
   layoutSiteCrawlGraphInput,
   persistSiteCrawlGraphLayout
-} from "./chunk-WHVEDCHY.js";
+} from "./chunk-2S7U2YHI.js";
 import {
   PACKAGE_VERSION,
   canonryMcpTools
-} from "./chunk-4LQ4HKVK.js";
+} from "./chunk-KDWTNI4Z.js";
 import {
   HISTORY_WINDOW_RUNS,
   IntelligenceService,
@@ -83,7 +83,7 @@ import {
   siteCrawlPages,
   siteCrawlSnapshots,
   trafficSources
-} from "./chunk-EZRBFH77.js";
+} from "./chunk-SPZRSKCF.js";
 import {
   RunKinds,
   SiteCrawlFetchStates,
@@ -112,7 +112,7 @@ import {
   roundPreservingTotal,
   siteAuditPageFactorSchema,
   wilsonInterval
-} from "./chunk-A25FO3Z5.js";
+} from "./chunk-6LS2R477.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-KXHPQMBP.js";
+} from "./chunk-VWSUFTW5.js";
 import {
   loadConfig
-} from "./chunk-ZHXOR2LJ.js";
-import "./chunk-WHVEDCHY.js";
-import "./chunk-4LQ4HKVK.js";
-import "./chunk-EZRBFH77.js";
-import "./chunk-A25FO3Z5.js";
+} from "./chunk-3ZGBSHZ2.js";
+import "./chunk-2S7U2YHI.js";
+import "./chunk-KDWTNI4Z.js";
+import "./chunk-SPZRSKCF.js";
+import "./chunk-6LS2R477.js";
 export {
   GoogleMarketingRuntimeError,
   createGoogleMarketingCredentialStore,

package/dist/{intelligence-service-UEEVETII.js → intelligence-service-USSTKAKC.js}

@@ -1,8 +1,8 @@
 import {
   HISTORY_WINDOW_RUNS,
   IntelligenceService
-} from "./chunk-EZRBFH77.js";
-import "./chunk-A25FO3Z5.js";
+} from "./chunk-SPZRSKCF.js";
+import "./chunk-6LS2R477.js";
 export {
   HISTORY_WINDOW_RUNS,
   IntelligenceService

package/dist/mcp.js

@@ -1,15 +1,15 @@
 import {
   autoSyncSkills
-} from "./chunk-LUQ5G5OO.js";
+} from "./chunk-O6XPXEN6.js";
 import {
   createApiClient,
   createCanonryMcpServer
-} from "./chunk-ZHXOR2LJ.js";
-import "./chunk-4LQ4HKVK.js";
+} from "./chunk-3ZGBSHZ2.js";
+import "./chunk-KDWTNI4Z.js";
 import {
   isReadOnlyKey,
   updateCheckEnvOptOut
-} from "./chunk-A25FO3Z5.js";
+} from "./chunk-6LS2R477.js";
 
 // src/mcp/cli.ts
 import { randomUUID } from "crypto";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@canonry/canonry",
-  "version": "7.14.0",
+  "version": "7.16.0",
   "type": "module",
   "description": "Self-hosted AI visibility (AEO) platform: track how ChatGPT, Claude, Gemini, and Perplexity cite your domain, join it with Search Console, GA4, server-side traffic, and paid media, and fix what you find through agent tools (CLI, REST, MCP). Local SQLite.",
   "keywords": [
@@ -85,34 +85,34 @@
     "@types/node-cron": "^3.0.11",
     "tsup": "^8.5.1",
     "tsx": "^4.19.0",
-    "@ainyc/canonry-api-client": "0.0.0",
+    "@ainyc/canonry-web": "0.0.0",
     "@ainyc/canonry-api-routes": "0.0.0",
+    "@ainyc/canonry-api-client": "0.0.0",
     "@ainyc/canonry-config": "0.0.0",
-    "@ainyc/canonry-web": "0.0.0",
-    "@ainyc/canonry-contracts": "0.0.0",
     "@ainyc/canonry-db": "0.0.0",
-    "@ainyc/canonry-integration-cloud-run": "0.0.0",
+    "@ainyc/canonry-contracts": "0.0.0",
     "@ainyc/canonry-integration-bing": "0.0.0",
+    "@ainyc/canonry-integration-cloud-run": "0.0.0",
     "@ainyc/canonry-integration-cloudflare-queue": "0.0.0",
     "@ainyc/canonry-integration-cloudflare-worker": "0.0.0",
-    "@ainyc/canonry-integration-google-ads": "0.0.0",
-    "@ainyc/canonry-integration-commoncrawl": "0.0.0",
     "@ainyc/canonry-integration-google": "0.0.0",
     "@ainyc/canonry-integration-google-business-profile": "0.0.0",
-    "@ainyc/canonry-integration-openai-ads": "0.0.0",
-    "@ainyc/canonry-integration-traffic": "0.0.0",
     "@ainyc/canonry-integration-google-places": "0.0.0",
     "@ainyc/canonry-integration-google-tag-manager": "0.0.0",
-    "@ainyc/canonry-provider-claude": "0.0.0",
-    "@ainyc/canonry-provider-cdp": "0.0.0",
+    "@ainyc/canonry-integration-commoncrawl": "0.0.0",
+    "@ainyc/canonry-integration-openai-ads": "0.0.0",
+    "@ainyc/canonry-integration-traffic": "0.0.0",
     "@ainyc/canonry-integration-wordpress": "0.0.0",
     "@ainyc/canonry-intelligence": "0.0.0",
+    "@ainyc/canonry-provider-cdp": "0.0.0",
     "@ainyc/canonry-provider-gemini": "0.0.0",
-    "@ainyc/canonry-provider-openai": "0.0.0",
-    "@ainyc/canonry-provider-local": "0.0.0",
+    "@ainyc/canonry-integration-google-ads": "0.0.0",
+    "@ainyc/canonry-provider-claude": "0.0.0",
     "@ainyc/canonry-provider-muse": "0.0.0",
-    "@ainyc/canonry-provider-perplexity": "0.0.0",
-    "@ainyc/canonry-integration-typesafe": "0.0.0"
+    "@ainyc/canonry-provider-local": "0.0.0",
+    "@ainyc/canonry-provider-openai": "0.0.0",
+    "@ainyc/canonry-integration-typesafe": "0.0.0",
+    "@ainyc/canonry-provider-perplexity": "0.0.0"
   },
   "scripts": {
     "build": "pnpm run build:cli && pnpm run build:web",