@canonry/canonry 4.172.2 → 4.172.4

package/dist/{chunk-U5JTZM66.js → chunk-WFVK3XC7.js}

@@ -5,11 +5,11 @@ import {
   installSkills,
   loadConfigRaw,
   saveConfigPatch
-} from "./chunk-YXDCVM5U.js";
+} from "./chunk-BZDNTUCZ.js";
 import {
   SKILL_MANIFEST_FILENAME,
   SkillsClients
-} from "./chunk-EGGQSFQL.js";
+} from "./chunk-WGN2VT7L.js";
 
 // src/skills-autosync.ts
 import fs from "fs";

package/dist/{chunk-EGGQSFQL.js → chunk-WGN2VT7L.js}

@@ -7650,6 +7650,47 @@ var gscPerformanceTrendsSchema = z19.object({
   ctr: linearTrendSchema.nullable(),
   position: linearTrendSchema.nullable()
 });
+var gscPeriodTotalsSchema = z19.object({
+  startDate: z19.string(),
+  endDate: z19.string(),
+  clicks: z19.number(),
+  impressions: z19.number(),
+  /** The period's own `clicks / impressions`, never a mean of daily ratios. */
+  ctr: z19.number().nullable(),
+  /** Impression-weighted mean position, or null when no day carried one. */
+  position: z19.number().nullable(),
+  /**
+   * Which table the figures came from. `gsc_daily_totals` (property-daily) and
+   * `SUM(gsc_search_data)` (dimensioned) are not interchangeable: on one real
+   * property-month the same period reads 1,142 clicks / 34,916 impressions from
+   * the first and 792 / 45,266 from the second.
+   */
+  source: z19.enum(["property-daily", "dimensioned", "mixed", "empty"])
+});
+var gscPeriodComparisonSchema = z19.object({
+  /** Length of EACH period in calendar days. */
+  days: z19.number(),
+  prior: gscPeriodTotalsSchema,
+  trailing: gscPeriodTotalsSchema,
+  /**
+   * False when either period contains dimensioned fallback totals, in which
+   * case every `change` is null. Empty/property-daily halves are comparable;
+   * `SUM(gsc_search_data)` is never valid for property totals.
+   */
+  comparable: z19.boolean(),
+  /**
+   * Relative change as a ratio (0.5 = +50%), null where the prior period gives
+   * nothing to divide by or the trailing metric is unavailable. The sign is
+   * mathematical: a POSITIVE `position` means the rank number rose, which is
+   * worse. Desirability is the renderer's call.
+   */
+  change: z19.object({
+    clicks: z19.number().nullable(),
+    impressions: z19.number().nullable(),
+    ctr: z19.number().nullable(),
+    position: z19.number().nullable()
+  })
+});
 var gscPerformanceDailyDtoSchema = z19.object({
   totals: z19.object({
     clicks: z19.number(),
@@ -7681,7 +7722,14 @@ var gscPerformanceDailyDtoSchema = z19.object({
    * Optional for the same reason as `window`: a server older than this field
    * omits it, and the chart guards for that skew.
    */
-  trends: gscPerformanceTrendsSchema.optional()
+  trends: gscPerformanceTrendsSchema.optional(),
+  /**
+   * Optional for the same reason as `window` and `trends`, and additionally
+   * null when the window is too short to split into two periods, has no
+   * evidence, or extends beyond the project's known GSC data frontier. A
+   * consumer must render the absence rather than substitute a percentage.
+   */
+  periodComparison: gscPeriodComparisonSchema.nullable().optional()
 });
 var gscTopPageRowSchema = z19.object({
   page: z19.string(),

package/dist/cli.js

@@ -26,11 +26,11 @@ import {
   showFirstRunNotice,
   trackCliCommandFinished,
   trackEvent
-} from "./chunk-TI3SZAVI.js";
+} from "./chunk-N53TZMMR.js";
 import {
   autoSyncSkills,
   formatAutoSyncNotice
-} from "./chunk-U5JTZM66.js";
+} from "./chunk-WFVK3XC7.js";
 import {
   CliError,
   EXIT_SYSTEM_ERROR,
@@ -55,7 +55,7 @@ import {
   saveConfigPatch,
   systemError,
   usageError
-} from "./chunk-YXDCVM5U.js";
+} from "./chunk-BZDNTUCZ.js";
 import {
   CLOUDFLARE_WORKER_BINDINGS,
   CLOUDFLARE_WORKER_GENERATED_MARKER,
@@ -69,7 +69,7 @@ import {
   projects,
   queries,
   renderReportHtml
-} from "./chunk-PXTSQ67Z.js";
+} from "./chunk-2CXNT2AC.js";
 import {
   AdsDeliverySnapshotStatuses,
   AdsHistoricalCampaignRollupStatuses,
@@ -137,7 +137,7 @@ import {
   providerQuotaPolicySchema,
   resolveProviderInput,
   winnabilityClassSchema
-} from "./chunk-EGGQSFQL.js";
+} from "./chunk-WGN2VT7L.js";
 
 // src/cli.ts
 import { pathToFileURL } from "url";
@@ -7792,6 +7792,41 @@ async function googlePerformanceDaily(project, opts) {
 Trend (least-squares fit over ${days} day${days === 1 ? "" : "s"}):`);
     for (const line of trendLines) console.log(line);
   }
+  const cmp = data.periodComparison;
+  if (cmp && !cmp.comparable) {
+    console.log(
+      `
+No period comparison: period comparison needs property-level daily data. Sync again, or pick a range covered by property totals.`
+    );
+  } else if (cmp) {
+    const pct4 = (ratio, prior, trailing, inverted) => {
+      if (ratio === null) {
+        if (prior !== null && trailing !== null && prior <= 0 && trailing > 0) {
+          return `new in last ${cmp.days} day${cmp.days === 1 ? "" : "s"}`;
+        }
+        if (prior === null || prior <= 0) return "no prior period to compare";
+        if (trailing === null) return `no value in last ${cmp.days} day${cmp.days === 1 ? "" : "s"}`;
+        return "comparison unavailable";
+      }
+      if (ratio === 0) return "no change";
+      const better = inverted ? ratio < 0 : ratio > 0;
+      const magnitude = Math.abs(ratio * 100);
+      const shown = magnitude < 0.1 ? "<0.1" : magnitude.toFixed(1);
+      return `${ratio > 0 ? "+" : "-"}${shown}%  ${better ? "better" : "worse"}`;
+    };
+    console.log(
+      `
+Last ${cmp.days} day${cmp.days === 1 ? "" : "s"} (${cmp.trailing.startDate} to ${cmp.trailing.endDate}) vs prior ${cmp.days} (${cmp.prior.startDate} to ${cmp.prior.endDate}):`
+    );
+    for (const [label, ratio, prior, trailing, inverted] of [
+      ["Clicks", cmp.change.clicks, cmp.prior.clicks, cmp.trailing.clicks, false],
+      ["Impressions", cmp.change.impressions, cmp.prior.impressions, cmp.trailing.impressions, false],
+      ["CTR", cmp.change.ctr, cmp.prior.ctr, cmp.trailing.ctr, false],
+      ["Position", cmp.change.position, cmp.prior.position, cmp.trailing.position, true]
+    ]) {
+      console.log(`  ${`${label}:`.padEnd(13)}${pct4(ratio, prior, trailing, inverted)}`);
+    }
+  }
   console.log();
   console.log(`  ${"DATE".padEnd(12)}${"CLICKS".padStart(10)}${"IMPR".padStart(12)}${"CTR".padStart(10)}${"POS".padStart(9)}`);
   console.log(`  ${"\u2500".repeat(12)}${"\u2500".repeat(10)}${"\u2500".repeat(12)}${"\u2500".repeat(10)}${"\u2500".repeat(9)}`);

package/dist/index.js

@@ -3,12 +3,12 @@ import {
   createGoogleMarketingCredentialStore,
   createGoogleMarketingRuntime,
   createServer
-} from "./chunk-TI3SZAVI.js";
+} from "./chunk-N53TZMMR.js";
 import {
   loadConfig
-} from "./chunk-YXDCVM5U.js";
-import "./chunk-PXTSQ67Z.js";
-import "./chunk-EGGQSFQL.js";
+} from "./chunk-BZDNTUCZ.js";
+import "./chunk-2CXNT2AC.js";
+import "./chunk-WGN2VT7L.js";
 export {
   GoogleMarketingRuntimeError,
   createGoogleMarketingCredentialStore,

package/dist/{intelligence-service-H7756PBD.js → intelligence-service-2E7F6I7I.js}

@@ -1,7 +1,7 @@
 import {
   IntelligenceService
-} from "./chunk-PXTSQ67Z.js";
-import "./chunk-EGGQSFQL.js";
+} from "./chunk-2CXNT2AC.js";
+import "./chunk-WGN2VT7L.js";
 export {
   IntelligenceService
 };

package/dist/mcp.js

@@ -1,15 +1,15 @@
 import {
   autoSyncSkills
-} from "./chunk-U5JTZM66.js";
+} from "./chunk-WFVK3XC7.js";
 import {
   CliError,
   PACKAGE_VERSION,
   canonryMcpTools,
   createApiClient
-} from "./chunk-YXDCVM5U.js";
+} from "./chunk-BZDNTUCZ.js";
 import {
   isReadOnlyKey
-} from "./chunk-EGGQSFQL.js";
+} from "./chunk-WGN2VT7L.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.172.2",
+  "version": "4.172.4",
   "type": "module",
   "description": "Agent-first open-source AEO operating platform - track how answer engines cite your domain",
   "license": "FSL-1.1-ALv2",
@@ -72,29 +72,29 @@
     "tsx": "^4.19.0",
     "@ainyc/canonry-api-client": "0.0.0",
     "@ainyc/canonry-api-routes": "0.0.0",
-    "@ainyc/canonry-contracts": "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-cloud-run": "0.0.0",
-    "@ainyc/canonry-integration-openai-ads": "0.0.0",
     "@ainyc/canonry-integration-cloudflare-queue": "0.0.0",
-    "@ainyc/canonry-integration-commoncrawl": "0.0.0",
     "@ainyc/canonry-integration-cloudflare-worker": "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-google-ads": "0.0.0",
-    "@ainyc/canonry-integration-google-places": "0.0.0",
+    "@ainyc/canonry-integration-commoncrawl": "0.0.0",
     "@ainyc/canonry-integration-google-business-profile": "0.0.0",
-    "@ainyc/canonry-integration-google-tag-manager": "0.0.0",
+    "@ainyc/canonry-integration-traffic": "0.0.0",
+    "@ainyc/canonry-integration-google-places": "0.0.0",
     "@ainyc/canonry-integration-wordpress": "0.0.0",
     "@ainyc/canonry-intelligence": "0.0.0",
-    "@ainyc/canonry-integration-traffic": "0.0.0",
-    "@ainyc/canonry-provider-local": "0.0.0",
-    "@ainyc/canonry-provider-gemini": "0.0.0",
     "@ainyc/canonry-provider-cdp": "0.0.0",
-    "@ainyc/canonry-provider-openai": "0.0.0",
     "@ainyc/canonry-provider-claude": "0.0.0",
-    "@ainyc/canonry-provider-perplexity": "0.0.0"
+    "@ainyc/canonry-provider-local": "0.0.0",
+    "@ainyc/canonry-provider-openai": "0.0.0",
+    "@ainyc/canonry-provider-perplexity": "0.0.0",
+    "@ainyc/canonry-provider-gemini": "0.0.0",
+    "@ainyc/canonry-integration-google-tag-manager": "0.0.0"
   },
   "scripts": {
     "build": "tsx scripts/copy-agent-assets.ts && tsup && tsx build-web.ts",