@canonry/canonry 4.133.2 → 4.134.0

package/dist/cli.js

@@ -29,7 +29,7 @@ import {
   setTelemetrySource,
   showFirstRunNotice,
   trackEvent
-} from "./chunk-V2YR3YK6.js";
+} from "./chunk-TKXWTDV6.js";
 import {
   CliError,
   EXIT_SYSTEM_ERROR,
@@ -46,7 +46,7 @@ import {
   saveConfig,
   saveConfigPatch,
   usageError
-} from "./chunk-JTJQZ4UC.js";
+} from "./chunk-ZUQPHGEN.js";
 import {
   apiKeys,
   createClient,
@@ -54,8 +54,11 @@ import {
   projects,
   queries,
   renderReportHtml
-} from "./chunk-IEZTETUZ.js";
+} from "./chunk-LIXWDIDR.js";
 import {
+  AdsDeliverySnapshotStatuses,
+  AdsHistoricalCampaignRollupStatuses,
+  AdsLiveEntityTypes,
   AdsOperationKinds,
   AdsOperationStates,
   AdsOperationStepStates,
@@ -97,7 +100,7 @@ import {
   providerQuotaPolicySchema,
   resolveProviderInput,
   winnabilityClassSchema
-} from "./chunk-ZPQX5ZQ2.js";
+} from "./chunk-PC7AYXND.js";
 
 // src/cli.ts
 import { pathToFileURL } from "url";
@@ -2690,6 +2693,12 @@ function printDetail(project, detail, format) {
     console.log(`  ${query.query.slice(0, 58).padEnd(58)}  ${query.status.padEnd(10)}  ${cited.padEnd(5)}  ${mentioned}`);
     if (query.error) console.log(`    Error: ${query.error}`);
     if (query.answerText) console.log(`    Answer: ${query.answerText}`);
+    if (query.namedCompetitors.length > 0) {
+      console.log(`    Named competitors: ${query.namedCompetitors.join(", ")}`);
+    }
+    if (query.citedCompetitorDomains.length > 0) {
+      console.log(`    Cited competitor domains: ${query.citedCompetitorDomains.join(", ")}`);
+    }
     if (query.groundingSources.length > 0) {
       console.log("    Sources:");
       for (const source of query.groundingSources) {
@@ -3381,6 +3390,73 @@ async function adsSummary(project, opts) {
   console.log(`Spend:        ${formatMicros(result.totals.spendMicros, result.currencyCode ?? "USD")}${result.totals.cpcMicros != null ? ` (CPC ${formatMicros(result.totals.cpcMicros, result.currencyCode ?? "USD")})` : ""}`);
   console.log(`Last synced:  ${result.lastSyncedAt ?? "never"}`);
 }
+async function adsDeliveryDiagnostics(project, opts) {
+  const result = await getClient6().getAdsDeliveryDiagnostics(project);
+  if (isMachineFormat(opts?.format)) {
+    console.log(JSON.stringify(result, null, 2));
+    return;
+  }
+  console.log(`Snapshot:     ${result.snapshot.status}${result.snapshot.issue ? ` (${result.snapshot.issue})` : ""}`);
+  console.log(`Source sync:  ${result.snapshot.sourceSync ? `${result.snapshot.sourceSync.runId} [${result.snapshot.sourceSync.status}]` : "none"}`);
+  console.log(`Structure:    ${result.snapshot.campaignCount} campaigns / ${result.snapshot.adGroupCount} ad groups / ${result.snapshot.adCount} ads`);
+  console.log(`Last synced:  ${result.snapshot.lastSyncedAt ?? "never"}`);
+  console.log(`Activity:     ${result.assessment.state}`);
+  if (result.historicalCampaignRollups.status === AdsHistoricalCampaignRollupStatuses.reported && result.historicalCampaignRollups.totals !== null) {
+    console.log(`Historical:   ${result.historicalCampaignRollups.totals.impressions} impressions / ${result.historicalCampaignRollups.totals.clicks} clicks (${result.historicalCampaignRollups.window.from} \u2192 ${result.historicalCampaignRollups.window.to})`);
+  } else {
+    console.log("Historical:   no stored campaign rollups");
+  }
+  console.log("Evidence:     stored snapshot and historical rollups only; not an OpenAI eligibility or serving verdict.");
+  if (result.snapshot.status !== AdsDeliverySnapshotStatuses.complete) {
+    console.log("Structure details suppressed until a complete trusted snapshot exists.");
+    return;
+  }
+  for (const campaign of result.storedConfiguration.campaigns) {
+    const budget = campaign.dailySpendLimitMicros !== null ? `${formatMicros(campaign.dailySpendLimitMicros)}/day` : campaign.lifetimeSpendLimitMicros !== null ? `${formatMicros(campaign.lifetimeSpendLimitMicros)} lifetime` : "no stored budget";
+    console.log(`${campaign.name} [${campaign.status}] \u2014 ${campaign.biddingType ?? "unknown bidding"}, ${budget}, ${campaign.conversionEventSettingIds.length} conversion settings`);
+    for (const group of campaign.adGroups) {
+      const bid = group.maxBidMicros === null ? "no stored max bid" : `max bid ${formatMicros(group.maxBidMicros)}`;
+      console.log(`  - ${group.name} [${group.status}] \u2014 ${group.billingEventType ?? "unknown billing"}, ${bid}, ${group.contextHints.length} context hints`);
+      for (const ad of group.ads) console.log(`      ${ad.name} [${ad.status}] review=${ad.reviewStatus ?? "unknown"}`);
+    }
+  }
+}
+async function adsLiveDelivery(project, opts) {
+  const result = await getClient6().getAdsLiveDelivery(project, {
+    campaignId: opts?.campaignId,
+    lookbackDays: opts?.lookbackDays
+  });
+  if (isMachineFormat(opts?.format)) {
+    console.log(JSON.stringify(result, null, 2));
+    return;
+  }
+  console.log(`Read at:      ${result.fetchedAt} (live provider read)`);
+  console.log(`Ad account:   ${result.adAccountId}`);
+  console.log(`Snapshot:     last synced ${result.storedSnapshotSyncedAt ?? "never"}`);
+  console.log(`Metrics:      last ${result.metricsWindow.lookbackDays}d, as the provider reported them`);
+  console.log(`Provider:     ${result.bounds.readerCalls}/${result.bounds.maxReaderCalls} reader calls, up to ${result.bounds.maxUpstreamHttpRequests} upstream HTTP requests${result.bounds.truncated ? " (TRUNCATED, walk hit a cap)" : ""}`);
+  console.log(`Drift:        ${result.drift.driftedEntities}/${result.drift.entitiesCompared} entities (${result.drift.statusDrifted} status, ${result.drift.metricsDrifted} metrics)`);
+  for (const failure of result.errors) {
+    console.log(`Read failed:  ${failure.surface}${failure.entityId ? ` ${failure.entityId}` : ""}${failure.upstreamStatus === null ? "" : ` [HTTP ${failure.upstreamStatus}]`}`);
+  }
+  for (const entity of result.entities) {
+    const indent = entity.entityType === AdsLiveEntityTypes.campaign ? "" : entity.entityType === AdsLiveEntityTypes.ad_group ? "  " : "    ";
+    const label = entity.live?.name ?? entity.stored?.name ?? entity.id;
+    const liveStatus = entity.live === null ? "absent upstream" : entity.live.status;
+    const storedStatus = entity.stored === null ? "absent locally" : entity.stored.status;
+    const marker = entity.drifted ? "DRIFT" : "match";
+    console.log(`${indent}${label} [${entity.entityType}]: live ${liveStatus} / stored ${storedStatus} (${marker})`);
+    for (const delta of entity.fieldDeltas) {
+      console.log(`${indent}  ${delta.field}: live ${delta.live ?? "none"} / stored ${delta.stored ?? "none"}`);
+    }
+    for (const delta of entity.metricDeltas ?? []) {
+      if (!delta.drifted) continue;
+      const live = delta.live === null ? "no provider row" : `${delta.live.impressions} impr / ${delta.live.clicks} clicks / ${formatMicros(delta.live.spendMicros)}`;
+      const stored = delta.stored === null ? "no stored row" : `${delta.stored.impressions} impr / ${delta.stored.clicks} clicks / ${formatMicros(delta.stored.spendMicros)}`;
+      console.log(`${indent}  ${delta.date}: live ${live} / stored ${stored}`);
+    }
+  }
+}
 
 // src/cli-commands/ads.ts
 var ADS_CLI_COMMANDS = [
@@ -3736,6 +3812,35 @@ Usage: ${usage}`, {
       const project = requireProject(input, "ads.summary", "canonry ads summary <project> [--format json]");
       await adsSummary(project, { format: input.format });
     }
+  },
+  {
+    path: ["ads", "live-delivery"],
+    usage: "canonry ads live-delivery <project> [--campaign <id>] [--lookback-days <n>] [--format json]",
+    options: {
+      campaign: stringOption(),
+      "lookback-days": stringOption()
+    },
+    run: async (input) => {
+      const usage = "canonry ads live-delivery <project> [--campaign <id>] [--lookback-days <n>] [--format json]";
+      const project = requireProject(input, "ads.live-delivery", usage);
+      await adsLiveDelivery(project, {
+        campaignId: getString(input.values, "campaign"),
+        lookbackDays: parseIntegerOption(input, "lookback-days", {
+          command: "ads.live-delivery",
+          message: "--lookback-days must be an integer from 1 to 30",
+          usage
+        }),
+        format: input.format
+      });
+    }
+  },
+  {
+    path: ["ads", "delivery-diagnostics"],
+    usage: "canonry ads delivery-diagnostics <project> [--format json]",
+    run: async (input) => {
+      const project = requireProject(input, "ads.delivery-diagnostics", "canonry ads delivery-diagnostics <project> [--format json]");
+      await adsDeliveryDiagnostics(project, { format: input.format });
+    }
   }
 ];
 

package/dist/index.js

@@ -1,11 +1,11 @@
 import {
   createServer
-} from "./chunk-V2YR3YK6.js";
+} from "./chunk-TKXWTDV6.js";
 import {
   loadConfig
-} from "./chunk-JTJQZ4UC.js";
-import "./chunk-IEZTETUZ.js";
-import "./chunk-ZPQX5ZQ2.js";
+} from "./chunk-ZUQPHGEN.js";
+import "./chunk-LIXWDIDR.js";
+import "./chunk-PC7AYXND.js";
 export {
   createServer,
   loadConfig

package/dist/{intelligence-service-WZNE23TV.js → intelligence-service-4XOFUN5E.js}

@@ -1,7 +1,7 @@
 import {
   IntelligenceService
-} from "./chunk-IEZTETUZ.js";
-import "./chunk-ZPQX5ZQ2.js";
+} from "./chunk-LIXWDIDR.js";
+import "./chunk-PC7AYXND.js";
 export {
   IntelligenceService
 };

package/dist/mcp.js

@@ -3,10 +3,10 @@ import {
   PACKAGE_VERSION,
   canonryMcpTools,
   createApiClient
-} from "./chunk-JTJQZ4UC.js";
+} from "./chunk-ZUQPHGEN.js";
 import {
   isReadOnlyKey
-} from "./chunk-ZPQX5ZQ2.js";
+} from "./chunk-PC7AYXND.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.133.2",
+  "version": "4.134.0",
   "type": "module",
   "description": "Agent-first open-source AEO operating platform - track how answer engines cite your domain",
   "license": "FSL-1.1-ALv2",
@@ -68,24 +68,24 @@
     "@ainyc/canonry-api-client": "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-contracts": "0.0.0",
     "@ainyc/canonry-integration-bing": "0.0.0",
     "@ainyc/canonry-integration-openai-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-cloud-run": "0.0.0",
+    "@ainyc/canonry-integration-google": "0.0.0",
     "@ainyc/canonry-integration-google-places": "0.0.0",
-    "@ainyc/canonry-integration-wordpress": "0.0.0",
+    "@ainyc/canonry-integration-google-business-profile": "0.0.0",
     "@ainyc/canonry-integration-traffic": "0.0.0",
+    "@ainyc/canonry-integration-wordpress": "0.0.0",
+    "@ainyc/canonry-integration-commoncrawl": "0.0.0",
     "@ainyc/canonry-provider-cdp": "0.0.0",
-    "@ainyc/canonry-intelligence": "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-perplexity": "0.0.0",
-    "@ainyc/canonry-provider-openai": "0.0.0"
+    "@ainyc/canonry-provider-gemini": "0.0.0",
+    "@ainyc/canonry-intelligence": "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",