@canonry/canonry 4.139.0 → 4.141.0

package/dist/cli.js

@@ -30,7 +30,7 @@ import {
   showFirstRunNotice,
   trackCliCommandFinished,
   trackEvent
-} from "./chunk-DLKUDNDA.js";
+} from "./chunk-HXXO2AF5.js";
 import {
   CliError,
   EXIT_SYSTEM_ERROR,
@@ -47,7 +47,7 @@ import {
   saveConfig,
   saveConfigPatch,
   usageError
-} from "./chunk-IYTHIAAE.js";
+} from "./chunk-ZCFQGF3V.js";
 import {
   apiKeys,
   createClient,
@@ -55,7 +55,7 @@ import {
   projects,
   queries,
   renderReportHtml
-} from "./chunk-IGU67QFM.js";
+} from "./chunk-2LUSZFB6.js";
 import {
   AdsDeliverySnapshotStatuses,
   AdsHistoricalCampaignRollupStatuses,
@@ -101,7 +101,7 @@ import {
   providerQuotaPolicySchema,
   resolveProviderInput,
   winnabilityClassSchema
-} from "./chunk-OA2EGCUS.js";
+} from "./chunk-OJOA425V.js";
 
 // src/cli.ts
 import { pathToFileURL } from "url";
@@ -6378,10 +6378,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 +6438,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 +6479,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 +7008,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 +7148,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 +7217,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

@@ -190,6 +190,18 @@ interface DashboardConfigEntry {
      * and the engine is not directly internet-reachable.
      */
     requirePassword?: boolean;
+    /**
+     * Whether the dashboard sidebar and page footer show the Canonry GitHub,
+     * documentation, and changelog links. Defaults to true. Disable for a
+     * 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-DLKUDNDA.js";
+} from "./chunk-HXXO2AF5.js";
 import {
   loadConfig
-} from "./chunk-IYTHIAAE.js";
-import "./chunk-IGU67QFM.js";
-import "./chunk-OA2EGCUS.js";
+} from "./chunk-ZCFQGF3V.js";
+import "./chunk-2LUSZFB6.js";
+import "./chunk-OJOA425V.js";
 export {
   createServer,
   loadConfig

package/dist/{intelligence-service-SMYVN3KN.js → intelligence-service-4HQIUC7U.js}

@@ -1,7 +1,7 @@
 import {
   IntelligenceService
-} from "./chunk-IGU67QFM.js";
-import "./chunk-OA2EGCUS.js";
+} from "./chunk-2LUSZFB6.js";
+import "./chunk-OJOA425V.js";
 export {
   IntelligenceService
 };

package/dist/mcp.js

@@ -3,10 +3,10 @@ import {
   PACKAGE_VERSION,
   canonryMcpTools,
   createApiClient
-} from "./chunk-IYTHIAAE.js";
+} from "./chunk-ZCFQGF3V.js";
 import {
   isReadOnlyKey
-} from "./chunk-OA2EGCUS.js";
+} from "./chunk-OJOA425V.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.0",
+  "version": "4.141.0",
   "type": "module",
   "description": "Agent-first open-source AEO operating platform - track how answer engines cite your domain",
   "license": "FSL-1.1-ALv2",
@@ -65,26 +65,26 @@
     "@types/node-cron": "^3.0.11",
     "tsup": "^8.5.1",
     "tsx": "^4.19.0",
+    "@ainyc/canonry-config": "0.0.0",
     "@ainyc/canonry-api-client": "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-cloud-run": "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-places": "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-intelligence": "0.0.0",
-    "@ainyc/canonry-provider-claude": "0.0.0",
     "@ainyc/canonry-provider-cdp": "0.0.0",
-    "@ainyc/canonry-provider-local": "0.0.0",
     "@ainyc/canonry-provider-gemini": "0.0.0",
+    "@ainyc/canonry-provider-claude": "0.0.0",
+    "@ainyc/canonry-provider-local": "0.0.0",
     "@ainyc/canonry-provider-openai": "0.0.0",
+    "@ainyc/canonry-integration-wordpress": "0.0.0",
     "@ainyc/canonry-provider-perplexity": "0.0.0"
   },
   "scripts": {