@canonry/canonry 4.139.1 → 4.142.0

package/dist/{chunk-YLHZQ7HQ.js → chunk-UFPP5CSN.js}

@@ -10,7 +10,7 @@ import {
   loadConfig,
   loadConfigRaw,
   saveConfigPatch
-} from "./chunk-IYTHIAAE.js";
+} from "./chunk-D7NJUGNQ.js";
 import {
   CC_CACHE_DIR,
   DUCKDB_SPEC,
@@ -123,7 +123,7 @@ import {
   siteAuditSnapshots,
   toAlertView,
   usageCounters
-} from "./chunk-DJHSOPMU.js";
+} from "./chunk-NR6OGEV3.js";
 import {
   AGENT_MEMORY_VALUE_MAX_BYTES,
   AGENT_PROVIDER_IDS,
@@ -210,7 +210,7 @@ import {
   validationError,
   winnabilityClassLabel,
   withRetry
-} from "./chunk-OA2EGCUS.js";
+} from "./chunk-LS6SEZVF.js";
 
 // src/telemetry.ts
 import crypto from "crypto";
@@ -7178,7 +7178,7 @@ function readStoredGroundingSources(rawResponse) {
   return result;
 }
 async function backfillInsightsCommand(project, opts) {
-  const { IntelligenceService: IntelligenceService2 } = await import("./intelligence-service-BGH2MGHB.js");
+  const { IntelligenceService: IntelligenceService2 } = await import("./intelligence-service-EOUP37XN.js");
   const config = loadConfig();
   const db = createClient(config.database);
   migrate(db);
@@ -12011,6 +12011,9 @@ function resolveDashboardRequirePassword(env, config) {
 function resolveDashboardShowResourceLinks(env, config) {
   return parseBooleanEnv(env.CANONRY_DASHBOARD_SHOW_RESOURCE_LINKS) ?? config.dashboard?.showResourceLinks ?? true;
 }
+function resolveDashboardShowUpdateNotification(env, config) {
+  return parseBooleanEnv(env.CANONRY_DASHBOARD_SHOW_UPDATE_NOTIFICATION) ?? config.dashboard?.showUpdateNotification ?? true;
+}
 var API_ADAPTERS = [
   geminiAdapter,
   openaiAdapter,
@@ -12876,6 +12879,7 @@ async function createServer(opts) {
   }
   const dashboardRequirePassword = resolveDashboardRequirePassword(process.env, opts.config);
   const dashboardShowResourceLinks = resolveDashboardShowResourceLinks(process.env, opts.config);
+  const dashboardShowUpdateNotification = resolveDashboardShowUpdateNotification(process.env, opts.config);
   app.log.info(
     { dashboardRequirePassword },
     "Dashboard password gate resolved"
@@ -13625,8 +13629,15 @@ async function createServer(opts) {
     const injectConfig = (html, projectTabsOverride, themeOverride, renderTokenOverride) => {
       const clientConfig = {};
       if (basePath) clientConfig.basePath = basePath;
+      const dashboardConfig = {};
       if (!dashboardShowResourceLinks) {
-        clientConfig.dashboard = { showResourceLinks: false };
+        dashboardConfig.showResourceLinks = false;
+      }
+      if (!dashboardShowUpdateNotification) {
+        dashboardConfig.showUpdateNotification = false;
+      }
+      if (Object.keys(dashboardConfig).length > 0) {
+        clientConfig.dashboard = dashboardConfig;
       }
       if (embed.enabled) {
         const embedClient = embedClientConfigForRequest(embed, projectTabsOverride, themeOverride, renderTokenOverride);

package/dist/cli.js

@@ -30,7 +30,7 @@ import {
   showFirstRunNotice,
   trackCliCommandFinished,
   trackEvent
-} from "./chunk-YLHZQ7HQ.js";
+} from "./chunk-UFPP5CSN.js";
 import {
   CliError,
   EXIT_SYSTEM_ERROR,
@@ -47,7 +47,7 @@ import {
   saveConfig,
   saveConfigPatch,
   usageError
-} from "./chunk-IYTHIAAE.js";
+} from "./chunk-D7NJUGNQ.js";
 import {
   apiKeys,
   createClient,
@@ -55,7 +55,7 @@ import {
   projects,
   queries,
   renderReportHtml
-} from "./chunk-DJHSOPMU.js";
+} from "./chunk-NR6OGEV3.js";
 import {
   AdsDeliverySnapshotStatuses,
   AdsHistoricalCampaignRollupStatuses,
@@ -101,7 +101,7 @@ import {
   providerQuotaPolicySchema,
   resolveProviderInput,
   winnabilityClassSchema
-} from "./chunk-OA2EGCUS.js";
+} from "./chunk-LS6SEZVF.js";
 
 // src/cli.ts
 import { pathToFileURL } from "url";
@@ -3824,6 +3824,16 @@ Usage: ${usage}`, {
 function getClient7() {
   return createApiClient();
 }
+function rangeParams(opts, extra) {
+  const params = { ...extra };
+  if (opts?.window) params.window = opts.window;
+  if (opts?.startDate) params.startDate = opts.startDate;
+  if (opts?.endDate) params.endDate = opts.endDate;
+  return Object.keys(params).length > 0 ? params : void 0;
+}
+function isRangeScoped(opts) {
+  return Boolean(opts?.window || opts?.startDate || opts?.endDate);
+}
 async function gaConnect(project, opts) {
   if (!opts.propertyId) {
     throw new CliError({
@@ -3925,10 +3935,8 @@ async function gaSync(project, opts) {
 }
 async function gaTraffic(project, opts) {
   const client = getClient7();
-  const params = {};
-  if (opts?.limit) params.limit = String(opts.limit);
-  if (opts?.window) params.window = opts.window;
-  const result = await client.gaTraffic(project, Object.keys(params).length > 0 ? params : void 0);
+  const params = rangeParams(opts, opts?.limit ? { limit: String(opts.limit) } : void 0);
+  const result = await client.gaTraffic(project, params);
   if (isMachineFormat(opts?.format)) {
     console.log(JSON.stringify(result, null, 2));
     return;
@@ -3937,7 +3945,7 @@ async function gaTraffic(project, opts) {
     if (!result.lastSyncedAt) {
       console.log('No GA4 traffic data. Run "canonry ga sync <project>" first.');
     } else {
-      console.log(`No GA4 traffic data for the selected period.${opts?.window ? ` Try a wider window or omit --window.` : ""}`);
+      console.log(`No GA4 traffic data for the selected period.${isRangeScoped(opts) ? " Try a wider range, or omit --window / --start / --end." : ""}`);
     }
     return;
   }
@@ -4061,16 +4069,16 @@ async function gaMeasurementAnalysis(project, opts) {
 }
 async function gaAiReferralHistory(project, opts) {
   const client = getClient7();
-  const result = await client.gaAiReferralHistory(project, opts?.window ? { window: opts.window } : void 0);
+  const result = await client.gaAiReferralHistory(project, rangeParams(opts));
   if (opts?.format === "json") {
     console.log(JSON.stringify(result, null, 2));
     return;
   } else if (opts?.format === "jsonl") {
-    emitJsonl(result.map((row) => ({ project, window: opts?.window, ...row })));
+    emitJsonl(result.map((row) => ({ project, window: opts?.window, startDate: opts?.startDate, endDate: opts?.endDate, ...row })));
     return;
   }
   if (result.length === 0) {
-    console.log(`No AI referral history.${opts?.window ? " Try a wider window or omit --window." : ' Run "canonry ga sync <project>" first.'}`);
+    console.log(`No AI referral history.${isRangeScoped(opts) ? " Try a wider range, or omit --window / --start / --end." : ' Run "canonry ga sync <project>" first.'}`);
     return;
   }
   const dateWidth = 12;
@@ -4089,16 +4097,16 @@ async function gaAiReferralHistory(project, opts) {
 }
 async function gaAiReferralDaily(project, opts) {
   const client = getClient7();
-  const result = await client.gaAiReferralDaily(project, opts?.window ? { window: opts.window } : void 0);
+  const result = await client.gaAiReferralDaily(project, rangeParams(opts));
   if (opts?.format === "json") {
     console.log(JSON.stringify(result, null, 2));
     return;
   } else if (opts?.format === "jsonl") {
-    emitJsonl(result.days.map((day) => ({ project, window: opts?.window, ...day })));
+    emitJsonl(result.days.map((day) => ({ project, window: opts?.window, startDate: opts?.startDate, endDate: opts?.endDate, ...day })));
     return;
   }
   if (result.days.length === 0) {
-    console.log(`No AI referral sessions.${opts?.window ? " Try a wider window or omit --window." : ' Run "canonry ga sync <project>" first.'}`);
+    console.log(`No AI referral sessions.${isRangeScoped(opts) ? " Try a wider range, or omit --window / --start / --end." : ' Run "canonry ga sync <project>" first.'}`);
     return;
   }
   const dateWidth = 12;
@@ -4119,16 +4127,16 @@ async function gaAiReferralDaily(project, opts) {
 }
 async function gaSocialReferralHistory(project, opts) {
   const client = getClient7();
-  const result = await client.gaSocialReferralHistory(project, opts?.window ? { window: opts.window } : void 0);
+  const result = await client.gaSocialReferralHistory(project, rangeParams(opts));
   if (opts?.format === "json") {
     console.log(JSON.stringify(result, null, 2));
     return;
   } else if (opts?.format === "jsonl") {
-    emitJsonl(result.map((row) => ({ project, window: opts?.window, ...row })));
+    emitJsonl(result.map((row) => ({ project, window: opts?.window, startDate: opts?.startDate, endDate: opts?.endDate, ...row })));
     return;
   }
   if (result.length === 0) {
-    console.log(`No social referral history.${opts?.window ? " Try a wider window or omit --window." : ' Run "canonry ga sync <project>" first.'}`);
+    console.log(`No social referral history.${isRangeScoped(opts) ? " Try a wider range, or omit --window / --start / --end." : ' Run "canonry ga sync <project>" first.'}`);
     return;
   }
   const dateWidth = 12;
@@ -4147,16 +4155,16 @@ async function gaSocialReferralHistory(project, opts) {
 }
 async function gaSessionHistory(project, opts) {
   const client = getClient7();
-  const result = await client.gaSessionHistory(project, opts?.window ? { window: opts.window } : void 0);
+  const result = await client.gaSessionHistory(project, rangeParams(opts));
   if (opts?.format === "json") {
     console.log(JSON.stringify(result, null, 2));
     return;
   } else if (opts?.format === "jsonl") {
-    emitJsonl(result.map((row) => ({ project, window: opts?.window, ...row })));
+    emitJsonl(result.map((row) => ({ project, window: opts?.window, startDate: opts?.startDate, endDate: opts?.endDate, ...row })));
     return;
   }
   if (result.length === 0) {
-    console.log(`No session history.${opts?.window ? " Try a wider window or omit --window." : ' Run "canonry ga sync <project>" first.'}`);
+    console.log(`No session history.${isRangeScoped(opts) ? " Try a wider range, or omit --window / --start / --end." : ' Run "canonry ga sync <project>" first.'}`);
     return;
   }
   const dateWidth = 12;
@@ -4449,6 +4457,19 @@ async function gaAttribution(project, opts) {
 }
 
 // src/cli-commands/ga.ts
+var RANGE_OPTIONS = {
+  window: stringOption(),
+  start: stringOption(),
+  end: stringOption()
+};
+var RANGE_USAGE = "[--window 30d] [--start YYYY-MM-DD] [--end YYYY-MM-DD]";
+function rangeValues(values) {
+  return {
+    window: getString(values, "window"),
+    startDate: getString(values, "start"),
+    endDate: getString(values, "end")
+  };
+}
 var GA_CLI_COMMANDS = [
   {
     path: ["ga", "connect"],
@@ -4530,19 +4551,18 @@ var GA_CLI_COMMANDS = [
   },
   {
     path: ["ga", "traffic"],
-    usage: "canonry ga traffic <project> [--limit 50] [--window 30d] [--format json]",
+    usage: `canonry ga traffic <project> [--limit 50] ${RANGE_USAGE} [--format json]`,
     options: {
       limit: stringOption(),
-      window: stringOption()
+      ...RANGE_OPTIONS
     },
     run: async (input) => {
-      const project = requireProject(input, "ga.traffic", "canonry ga traffic <project> [--limit 50] [--window 30d] [--format json]");
+      const project = requireProject(input, "ga.traffic", `canonry ga traffic <project> [--limit 50] ${RANGE_USAGE} [--format json]`);
       const limitStr = getString(input.values, "limit");
       const limit = limitStr ? parseInt(limitStr, 10) : void 0;
-      const window = getString(input.values, "window");
       await gaTraffic(project, {
         limit,
-        window,
+        ...rangeValues(input.values),
         format: input.format
       });
     }
@@ -4557,56 +4577,48 @@ var GA_CLI_COMMANDS = [
   },
   {
     path: ["ga", "ai-referral-history"],
-    usage: "canonry ga ai-referral-history <project> [--window 30d] [--format json]",
-    options: {
-      window: stringOption()
-    },
+    usage: `canonry ga ai-referral-history <project> ${RANGE_USAGE} [--format json]`,
+    options: { ...RANGE_OPTIONS },
     run: async (input) => {
-      const project = requireProject(input, "ga.ai-referral-history", "canonry ga ai-referral-history <project> [--window 30d] [--format json]");
+      const project = requireProject(input, "ga.ai-referral-history", `canonry ga ai-referral-history <project> ${RANGE_USAGE} [--format json]`);
       await gaAiReferralHistory(project, {
-        window: getString(input.values, "window"),
+        ...rangeValues(input.values),
         format: input.format
       });
     }
   },
   {
     path: ["ga", "ai-referral-daily"],
-    usage: "canonry ga ai-referral-daily <project> [--window 30d] [--format json]",
-    options: {
-      window: stringOption()
-    },
+    usage: `canonry ga ai-referral-daily <project> ${RANGE_USAGE} [--format json]`,
+    options: { ...RANGE_OPTIONS },
     run: async (input) => {
-      const project = requireProject(input, "ga.ai-referral-daily", "canonry ga ai-referral-daily <project> [--window 30d] [--format json]");
+      const project = requireProject(input, "ga.ai-referral-daily", `canonry ga ai-referral-daily <project> ${RANGE_USAGE} [--format json]`);
       await gaAiReferralDaily(project, {
-        window: getString(input.values, "window"),
+        ...rangeValues(input.values),
         format: input.format
       });
     }
   },
   {
     path: ["ga", "social-referral-history"],
-    usage: "canonry ga social-referral-history <project> [--window 30d] [--format json]",
-    options: {
-      window: stringOption()
-    },
+    usage: `canonry ga social-referral-history <project> ${RANGE_USAGE} [--format json]`,
+    options: { ...RANGE_OPTIONS },
     run: async (input) => {
-      const project = requireProject(input, "ga.social-referral-history", "canonry ga social-referral-history <project> [--window 30d] [--format json]");
+      const project = requireProject(input, "ga.social-referral-history", `canonry ga social-referral-history <project> ${RANGE_USAGE} [--format json]`);
       await gaSocialReferralHistory(project, {
-        window: getString(input.values, "window"),
+        ...rangeValues(input.values),
         format: input.format
       });
     }
   },
   {
     path: ["ga", "session-history"],
-    usage: "canonry ga session-history <project> [--window 30d] [--format json]",
-    options: {
-      window: stringOption()
-    },
+    usage: `canonry ga session-history <project> ${RANGE_USAGE} [--format json]`,
+    options: { ...RANGE_OPTIONS },
     run: async (input) => {
-      const project = requireProject(input, "ga.session-history", "canonry ga session-history <project> [--window 30d] [--format json]");
+      const project = requireProject(input, "ga.session-history", `canonry ga session-history <project> ${RANGE_USAGE} [--format json]`);
       await gaSessionHistory(project, {
-        window: getString(input.values, "window"),
+        ...rangeValues(input.values),
         format: input.format
       });
     }
@@ -6378,10 +6390,58 @@ async function googlePerformanceDaily(project, opts) {
     );
   }
 }
+async function googleTopPages(project, opts) {
+  const client = getClient11();
+  const params = {};
+  if (opts.window) params.window = opts.window;
+  if (opts.startDate) params.startDate = opts.startDate;
+  if (opts.endDate) params.endDate = opts.endDate;
+  if (opts.limit) params.limit = String(opts.limit);
+  const data = await client.gscTopPages(project, Object.keys(params).length > 0 ? params : void 0);
+  if (opts.format === "json") {
+    console.log(JSON.stringify(data, null, 2));
+    return;
+  } else if (opts.format === "jsonl") {
+    emitJsonl(data.rows.map((row) => ({ project, ...row })));
+    return;
+  }
+  if (data.rows.length === 0) {
+    console.log('No GSC page data found in this window. Run "canonry google sync" first.');
+    return;
+  }
+  console.log(`Top pages by clicks (${data.rows.length} page${data.rows.length === 1 ? "" : "s"}):
+`);
+  const pageWidth = Math.min(60, Math.max(20, ...data.rows.map((row) => row.page.length)));
+  console.log(`  ${"PAGE".padEnd(pageWidth)}${"CLICKS".padStart(10)}${"IMPR".padStart(12)}${"CTR".padStart(10)}`);
+  console.log(`  ${"\u2500".repeat(pageWidth)}${"\u2500".repeat(10)}${"\u2500".repeat(12)}${"\u2500".repeat(10)}`);
+  for (const row of data.rows) {
+    const page = row.page.length > pageWidth ? row.page.slice(0, pageWidth - 3) + "..." : row.page;
+    console.log(
+      `  ${page.padEnd(pageWidth)}${row.clicks.toLocaleString().padStart(10)}${row.impressions.toLocaleString().padStart(12)}${(row.ctr * 100).toFixed(2).padStart(9)}%`
+    );
+  }
+  console.log();
+  if (data.totals) {
+    const { clicks, impressions, ctr, days } = data.totals;
+    console.log(`Property total (${days} day${days === 1 ? "" : "s"}, source: ${data.totalsSource}):`);
+    console.log(`  Clicks:      ${clicks.toLocaleString()}`);
+    console.log(`  Impressions: ${impressions.toLocaleString()}`);
+    console.log(`  CTR:         ${(ctr * 100).toFixed(2)}%`);
+    console.log();
+    console.log("  The page rows above are a ranking. They do not add up to this total:");
+    console.log("  Google withholds rare queries and repeats an impression per page.");
+  } else {
+    console.log("Property total: not available for this window.");
+    console.log('  Adding up the page rows would not give it. Run "canonry google sync" to fetch it.');
+  }
+}
 async function googlePerformance(project, opts) {
   const client = getClient11();
   const params = {};
-  if (opts.days) {
+  if (opts.startDate || opts.endDate) {
+    if (opts.startDate) params.startDate = opts.startDate;
+    if (opts.endDate) params.endDate = opts.endDate;
+  } else if (opts.days) {
     const end = /* @__PURE__ */ new Date();
     const start = /* @__PURE__ */ new Date();
     start.setDate(start.getDate() - opts.days);
@@ -6390,19 +6450,36 @@ async function googlePerformance(project, opts) {
   }
   if (opts.keyword) params.query = opts.keyword;
   if (opts.page) params.page = opts.page;
-  const rows = await client.gscPerformance(project, Object.keys(params).length > 0 ? params : void 0);
+  if (opts.limit !== void 0) params.limit = String(opts.limit);
+  if (opts.offset !== void 0) params.offset = String(opts.offset);
+  if (opts.orderBy) params.orderBy = opts.orderBy;
+  const data = await client.gscPerformance(project, Object.keys(params).length > 0 ? params : void 0);
+  const { rows, totalMatching, truncated, latestAvailableDate } = data;
   if (opts.format === "json") {
-    console.log(JSON.stringify(rows, null, 2));
+    console.log(JSON.stringify(data, null, 2));
     return;
   } else if (opts.format === "jsonl") {
     emitJsonl(rows.map((row) => ({ project, ...row })));
     return;
   }
   if (rows.length === 0) {
+    const requestedEnd = params.endDate;
+    if (totalMatching > 0 && opts.offset !== void 0 && opts.offset >= totalMatching) {
+      console.log(
+        `Offset ${opts.offset} is past the end of the result set (${totalMatching.toLocaleString()} matching rows). Lower --offset to page through them.`
+      );
+      return;
+    }
+    if (latestAvailableDate && requestedEnd && requestedEnd > latestAvailableDate) {
+      console.log(
+        `No GSC data through ${requestedEnd}. GSC reporting lag: the latest date this project holds is ${latestAvailableDate}. Syncing again will not backfill dates Google has not reported yet.`
+      );
+      return;
+    }
     console.log('No GSC data found. Run "canonry google sync" first.');
     return;
   }
-  console.log(`GSC performance data (${rows.length} rows):
+  console.log(`GSC performance data (${rows.length} of ${totalMatching.toLocaleString()} matching rows):
 `);
   console.log(`  ${"DATE".padEnd(12)}${"QUERY".padEnd(30)}${"CLICKS".padEnd(8)}${"IMPR".padEnd(8)}${"CTR".padEnd(8)}${"POS".padEnd(6)}`);
   console.log(`  ${"\u2500".repeat(12)}${"\u2500".repeat(30)}${"\u2500".repeat(8)}${"\u2500".repeat(8)}${"\u2500".repeat(8)}${"\u2500".repeat(6)}`);
@@ -6414,7 +6491,13 @@ async function googlePerformance(project, opts) {
   }
   if (rows.length > 50) {
     console.log(`
-  ... and ${rows.length - 50} more rows (use --format json for full output)`);
+  ... and ${rows.length - 50} more rows on this page (use --format json for full output)`);
+  }
+  if (truncated) {
+    console.log("\n  This is one page. Use --limit / --offset to page through the rest, --order-by to change the ranking.");
+  }
+  if (latestAvailableDate) {
+    console.log(`  Latest date held for this project: ${latestAvailableDate}`);
   }
 }
 async function googleInspect(project, url, format) {
@@ -6937,6 +7020,7 @@ async function googleDeindexed(project, format) {
 }
 
 // src/cli-commands/google.ts
+var GOOGLE_PERFORMANCE_USAGE = "canonry google performance <project> [--days <n> | --start <YYYY-MM-DD> --end <YYYY-MM-DD>] [--keyword <kw>] [--page <url>] [--limit <n>] [--offset <n>] [--order-by clicks|impressions|date] [--format json]";
 var GOOGLE_CLI_COMMANDS = [
   {
     path: ["google", "connect"],
@@ -7076,22 +7160,53 @@ var GOOGLE_CLI_COMMANDS = [
   },
   {
     path: ["google", "performance"],
-    usage: "canonry google performance <project> [--days <n>] [--keyword <kw>] [--page <url>] [--format json]",
+    usage: GOOGLE_PERFORMANCE_USAGE,
     options: {
       days: stringOption(),
+      start: stringOption(),
+      end: stringOption(),
       keyword: stringOption(),
-      page: stringOption()
+      page: stringOption(),
+      limit: stringOption(),
+      offset: stringOption(),
+      "order-by": stringOption()
     },
     run: async (input) => {
-      const project = requireProject(input, "google.performance", "canonry google performance <project> [--days <n>] [--keyword <kw>] [--page <url>] [--format json]");
+      const project = requireProject(input, "google.performance", GOOGLE_PERFORMANCE_USAGE);
+      const startDate = getString(input.values, "start");
+      const endDate = getString(input.values, "end");
+      const days = parseIntegerOption(input, "days", {
+        command: "google.performance",
+        usage: GOOGLE_PERFORMANCE_USAGE,
+        message: "--days must be an integer"
+      });
+      if (days !== void 0 && (startDate || endDate)) {
+        throw usageError(
+          `Error: --days cannot be combined with --start/--end. Pass one window.
+Usage: ${GOOGLE_PERFORMANCE_USAGE}`,
+          {
+            message: "--days cannot be combined with --start/--end",
+            details: { command: "google.performance", usage: GOOGLE_PERFORMANCE_USAGE }
+          }
+        );
+      }
       await googlePerformance(project, {
-        days: parseIntegerOption(input, "days", {
-          command: "google.performance",
-          usage: "canonry google performance <project> [--days <n>] [--keyword <kw>] [--page <url>] [--format json]",
-          message: "--days must be an integer"
-        }),
+        days,
+        startDate,
+        endDate,
         keyword: getString(input.values, "keyword"),
         page: getString(input.values, "page"),
+        limit: parseIntegerOption(input, "limit", {
+          command: "google.performance",
+          usage: GOOGLE_PERFORMANCE_USAGE,
+          message: "--limit must be an integer"
+        }),
+        offset: parseIntegerOption(input, "offset", {
+          command: "google.performance",
+          usage: GOOGLE_PERFORMANCE_USAGE,
+          message: "--offset must be an integer"
+        }),
+        orderBy: getString(input.values, "order-by"),
         format: input.format
       });
     }
@@ -7114,6 +7229,31 @@ var GOOGLE_CLI_COMMANDS = [
       });
     }
   },
+  {
+    path: ["google", "top-pages"],
+    usage: "canonry google top-pages <project> [--window 7d|30d|90d|all] [--start <YYYY-MM-DD>] [--end <YYYY-MM-DD>] [--limit <n>] [--format json]",
+    options: {
+      window: stringOption(),
+      start: stringOption(),
+      end: stringOption(),
+      limit: stringOption()
+    },
+    run: async (input) => {
+      const usage = "canonry google top-pages <project> [--window 7d|30d|90d|all] [--start <YYYY-MM-DD>] [--end <YYYY-MM-DD>] [--limit <n>] [--format json]";
+      const project = requireProject(input, "google.top-pages", usage);
+      await googleTopPages(project, {
+        window: getString(input.values, "window"),
+        startDate: getString(input.values, "start"),
+        endDate: getString(input.values, "end"),
+        limit: parseIntegerOption(input, "limit", {
+          command: "google.top-pages",
+          usage,
+          message: "--limit must be an integer"
+        }),
+        format: input.format
+      });
+    }
+  },
   {
     path: ["google", "inspect"],
     usage: "canonry google inspect <project> <url> [--format json]",

package/dist/index.d.ts

@@ -196,6 +196,12 @@ interface DashboardConfigEntry {
      * quieter branded UI.
      */
     showResourceLinks?: boolean;
+    /**
+     * Whether the dashboard sidebar shows the available-version notification.
+     * Defaults to true. Disable without turning off the underlying update check
+     * or CLI update notice.
+     */
+    showUpdateNotification?: boolean;
 }
 /**
  * Google Places API config — supplemental rendered-listing data for GBP

package/dist/index.js

@@ -1,11 +1,11 @@
 import {
   createServer
-} from "./chunk-YLHZQ7HQ.js";
+} from "./chunk-UFPP5CSN.js";
 import {
   loadConfig
-} from "./chunk-IYTHIAAE.js";
-import "./chunk-DJHSOPMU.js";
-import "./chunk-OA2EGCUS.js";
+} from "./chunk-D7NJUGNQ.js";
+import "./chunk-NR6OGEV3.js";
+import "./chunk-LS6SEZVF.js";
 export {
   createServer,
   loadConfig

package/dist/{intelligence-service-BGH2MGHB.js → intelligence-service-EOUP37XN.js}

@@ -1,7 +1,7 @@
 import {
   IntelligenceService
-} from "./chunk-DJHSOPMU.js";
-import "./chunk-OA2EGCUS.js";
+} from "./chunk-NR6OGEV3.js";
+import "./chunk-LS6SEZVF.js";
 export {
   IntelligenceService
 };

package/dist/mcp.js

@@ -3,10 +3,10 @@ import {
   PACKAGE_VERSION,
   canonryMcpTools,
   createApiClient
-} from "./chunk-IYTHIAAE.js";
+} from "./chunk-D7NJUGNQ.js";
 import {
   isReadOnlyKey
-} from "./chunk-OA2EGCUS.js";
+} from "./chunk-LS6SEZVF.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.139.1",
+  "version": "4.142.0",
   "type": "module",
   "description": "Agent-first open-source AEO operating platform - track how answer engines cite your domain",
   "license": "FSL-1.1-ALv2",
@@ -66,21 +66,21 @@
     "tsup": "^8.5.1",
     "tsx": "^4.19.0",
     "@ainyc/canonry-api-client": "0.0.0",
-    "@ainyc/canonry-config": "0.0.0",
-    "@ainyc/canonry-api-routes": "0.0.0",
     "@ainyc/canonry-contracts": "0.0.0",
     "@ainyc/canonry-db": "0.0.0",
+    "@ainyc/canonry-config": "0.0.0",
+    "@ainyc/canonry-api-routes": "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-commoncrawl": "0.0.0",
+    "@ainyc/canonry-integration-openai-ads": "0.0.0",
     "@ainyc/canonry-integration-google-business-profile": "0.0.0",
-    "@ainyc/canonry-integration-google": "0.0.0",
+    "@ainyc/canonry-integration-google-places": "0.0.0",
     "@ainyc/canonry-integration-traffic": "0.0.0",
+    "@ainyc/canonry-integration-google": "0.0.0",
     "@ainyc/canonry-integration-wordpress": "0.0.0",
     "@ainyc/canonry-provider-cdp": "0.0.0",
     "@ainyc/canonry-intelligence": "0.0.0",
-    "@ainyc/canonry-integration-google-places": "0.0.0",
     "@ainyc/canonry-provider-claude": "0.0.0",
     "@ainyc/canonry-provider-gemini": "0.0.0",
     "@ainyc/canonry-provider-local": "0.0.0",