@ainyc/canonry 1.16.0 → 1.18.0

package/dist/cli.js

@@ -19,7 +19,7 @@ import {
   setGoogleAuthConfig,
   showFirstRunNotice,
   trackEvent
-} from "./chunk-RU7RHCWK.js";
+} from "./chunk-7RIIMCVP.js";
 
 // src/cli.ts
 import { parseArgs } from "util";
@@ -673,6 +673,19 @@ var ApiClient = class {
   async gscDiscoverSitemaps(project) {
     return this.request("POST", `/projects/${encodeURIComponent(project)}/google/gsc/discover-sitemaps`, {});
   }
+  // Analytics
+  async getAnalyticsMetrics(project, window) {
+    const qs = window ? `?window=${encodeURIComponent(window)}` : "";
+    return this.request("GET", `/projects/${encodeURIComponent(project)}/analytics/metrics${qs}`);
+  }
+  async getAnalyticsGaps(project, window) {
+    const qs = window ? `?window=${encodeURIComponent(window)}` : "";
+    return this.request("GET", `/projects/${encodeURIComponent(project)}/analytics/gaps${qs}`);
+  }
+  async getAnalyticsSources(project, window) {
+    const qs = window ? `?window=${encodeURIComponent(window)}` : "";
+    return this.request("GET", `/projects/${encodeURIComponent(project)}/analytics/sources${qs}`);
+  }
   // Google Indexing API
   async googleRequestIndexing(project, body) {
     return this.request("POST", `/projects/${encodeURIComponent(project)}/google/indexing/request`, body);
@@ -1226,6 +1239,107 @@ async function showHistory(project, format) {
   }
 }
 
+// src/commands/analytics.ts
+function getClient8() {
+  const config = loadConfig();
+  return new ApiClient(config.apiUrl, config.apiKey);
+}
+async function showAnalytics(project, options) {
+  const client = getClient8();
+  const features = options.feature ? [options.feature] : ["metrics", "gaps", "sources"];
+  const results = {};
+  for (const feature of features) {
+    switch (feature) {
+      case "metrics": {
+        const data = await client.getAnalyticsMetrics(project, options.window);
+        results.metrics = data;
+        if (options.format !== "json") printMetrics(data);
+        break;
+      }
+      case "gaps": {
+        const data = await client.getAnalyticsGaps(project, options.window);
+        results.gaps = data;
+        if (options.format !== "json") printGaps(data);
+        break;
+      }
+      case "sources": {
+        const data = await client.getAnalyticsSources(project, options.window);
+        results.sources = data;
+        if (options.format !== "json") printSources(data);
+        break;
+      }
+      default:
+        console.error(`Unknown feature: ${feature}. Use: metrics, gaps, sources`);
+        process.exit(1);
+    }
+  }
+  if (options.format === "json") {
+    console.log(JSON.stringify(results, null, 2));
+  }
+}
+function printMetrics(data) {
+  console.log(`
+Citation Rate Trends (${data.window})`);
+  console.log("\u2500".repeat(50));
+  const pct = (n) => `${(n * 100).toFixed(1)}%`;
+  console.log(`  Overall: ${pct(data.overall.citationRate)} (${data.overall.cited}/${data.overall.total})`);
+  console.log(`  Trend:   ${data.trend}`);
+  if (Object.keys(data.byProvider).length > 0) {
+    console.log(`
+  By Provider:`);
+    for (const [provider, metric] of Object.entries(data.byProvider)) {
+      console.log(`    ${provider.padEnd(10)} ${pct(metric.citationRate).padStart(6)} (${metric.cited}/${metric.total})`);
+    }
+  }
+  if (data.buckets.length > 0) {
+    console.log(`
+  Timeline:`);
+    for (const bucket of data.buckets) {
+      const start = bucket.startDate.slice(0, 10);
+      const bar = bucket.total > 0 ? "\u2588".repeat(Math.round(bucket.citationRate * 20)) : "";
+      console.log(`    ${start}  ${pct(bucket.citationRate).padStart(6)}  ${bar}`);
+    }
+  }
+}
+function printGaps(data) {
+  console.log(`
+Brand Gap Analysis`);
+  console.log("\u2500".repeat(50));
+  console.log(`  Cited: ${data.cited.length}  |  Gap: ${data.gap.length}  |  Uncited: ${data.uncited.length}`);
+  if (data.gap.length > 0) {
+    console.log(`
+  Opportunity Gaps (competitors cited, you're not):`);
+    for (const kw of data.gap) {
+      const competitors = kw.competitorsCiting.join(", ");
+      const cons = kw.consistency.totalRuns > 0 ? ` [cited ${kw.consistency.citedRuns}/${kw.consistency.totalRuns} runs]` : "";
+      console.log(`    \u2022 ${kw.keyword}${cons}`);
+      console.log(`      Competitors: ${competitors}`);
+    }
+  }
+  if (data.cited.length > 0) {
+    console.log(`
+  Cited Keywords:`);
+    for (const kw of data.cited) {
+      const cons = kw.consistency.totalRuns > 0 ? ` [${kw.consistency.citedRuns}/${kw.consistency.totalRuns} runs]` : "";
+      console.log(`    \u2713 ${kw.keyword} (${kw.providers.join(", ")})${cons}`);
+    }
+  }
+}
+function printSources(data) {
+  console.log(`
+Source Origin Breakdown`);
+  console.log("\u2500".repeat(50));
+  if (data.overall.length === 0) {
+    console.log("  No source data available");
+    return;
+  }
+  for (const cat of data.overall) {
+    const pct = `${(cat.percentage * 100).toFixed(1)}%`;
+    const domains = cat.topDomains.slice(0, 3).map((d) => d.domain).join(", ");
+    console.log(`  ${cat.label.padEnd(20)} ${pct.padStart(6)}  (${cat.count})  ${domains}`);
+  }
+}
+
 // src/commands/apply.ts
 import fs4 from "fs";
 import { parseAllDocuments } from "yaml";
@@ -1280,12 +1394,12 @@ async function exportProject(project, opts) {
 }
 
 // src/commands/settings.ts
-function getClient8() {
+function getClient9() {
   const config = loadConfig();
   return new ApiClient(config.apiUrl, config.apiKey);
 }
 async function setProvider(name, opts) {
-  const client = getClient8();
+  const client = getClient9();
   const result = await client.updateProvider(name, opts);
   console.log(`Provider ${result.name} updated successfully.`);
   if (result.model) {
@@ -1296,7 +1410,7 @@ async function setProvider(name, opts) {
   }
 }
 async function showSettings(format) {
-  const client = getClient8();
+  const client = getClient9();
   const config = loadConfig();
   const settings = await client.getSettings();
   if (format === "json") {
@@ -1334,12 +1448,12 @@ function setGoogleAuth(opts) {
 }
 
 // src/commands/schedule.ts
-function getClient9() {
+function getClient10() {
   const config = loadConfig();
   return new ApiClient(config.apiUrl, config.apiKey);
 }
 async function setSchedule(project, opts) {
-  const client = getClient9();
+  const client = getClient10();
   const body = {};
   if (opts.preset) body.preset = opts.preset;
   if (opts.cron) body.cron = opts.cron;
@@ -1350,7 +1464,7 @@ async function setSchedule(project, opts) {
   printSchedule(result);
 }
 async function showSchedule(project, format) {
-  const client = getClient9();
+  const client = getClient10();
   const result = await client.getSchedule(project);
   if (format === "json") {
     console.log(JSON.stringify(result, null, 2));
@@ -1359,7 +1473,7 @@ async function showSchedule(project, format) {
   printSchedule(result);
 }
 async function enableSchedule(project) {
-  const client = getClient9();
+  const client = getClient10();
   const current = await client.getSchedule(project);
   const body = { timezone: current.timezone };
   if (current.preset) body.preset = current.preset;
@@ -1369,7 +1483,7 @@ async function enableSchedule(project) {
   console.log(`Schedule enabled for "${project}"`);
 }
 async function disableSchedule(project) {
-  const client = getClient9();
+  const client = getClient10();
   const current = await client.getSchedule(project);
   const body = { timezone: current.timezone, enabled: false };
   if (current.preset) body.preset = current.preset;
@@ -1379,7 +1493,7 @@ async function disableSchedule(project) {
   console.log(`Schedule disabled for "${project}"`);
 }
 async function removeSchedule(project) {
-  const client = getClient9();
+  const client = getClient10();
   await client.deleteSchedule(project);
   console.log(`Schedule removed for "${project}"`);
 }
@@ -1401,12 +1515,12 @@ function printSchedule(s) {
 }
 
 // src/commands/notify.ts
-function getClient10() {
+function getClient11() {
   const config = loadConfig();
   return new ApiClient(config.apiUrl, config.apiKey);
 }
 async function addNotification(project, opts) {
-  const client = getClient10();
+  const client = getClient11();
   const result = await client.createNotification(project, {
     channel: "webhook",
     url: opts.webhook,
@@ -1416,7 +1530,7 @@ async function addNotification(project, opts) {
   printNotification(result);
 }
 async function listNotifications(project, format) {
-  const client = getClient10();
+  const client = getClient11();
   const results = await client.listNotifications(project);
   if (format === "json") {
     console.log(JSON.stringify(results, null, 2));
@@ -1434,12 +1548,12 @@ async function listNotifications(project, format) {
   }
 }
 async function removeNotification(project, id) {
-  const client = getClient10();
+  const client = getClient11();
   await client.deleteNotification(project, id);
   console.log(`Notification ${id} removed from "${project}"`);
 }
 async function testNotification(project, id) {
-  const client = getClient10();
+  const client = getClient11();
   const result = await client.testNotification(project, id);
   if (result.ok) {
     console.log(`Test webhook delivered successfully (HTTP ${result.status})`);
@@ -1531,12 +1645,12 @@ function telemetryCommand(subcommand) {
 }
 
 // src/commands/google.ts
-function getClient11() {
+function getClient12() {
   const config = loadConfig();
   return new ApiClient(config.apiUrl, config.apiKey);
 }
 async function googleConnect(project, opts) {
-  const client = getClient11();
+  const client = getClient12();
   const { authUrl, redirectUri } = await client.googleConnect(project, {
     type: opts.type,
     publicUrl: opts.publicUrl
@@ -1561,12 +1675,12 @@ Open this URL in your browser to authorize Google ${opts.type.toUpperCase()} acc
   }
 }
 async function googleDisconnect(project, opts) {
-  const client = getClient11();
+  const client = getClient12();
   await client.googleDisconnect(project, opts.type);
   console.log(`Disconnected Google ${opts.type.toUpperCase()} from project "${project}".`);
 }
 async function googleStatus(project, format) {
-  const client = getClient11();
+  const client = getClient12();
   const connections = await client.googleConnections(project);
   if (format === "json") {
     console.log(JSON.stringify({ connections }, null, 2));
@@ -1590,7 +1704,7 @@ async function googleStatus(project, format) {
   }
 }
 async function googleProperties(project, format) {
-  const client = getClient11();
+  const client = getClient12();
   const { sites } = await client.googleProperties(project);
   if (format === "json") {
     console.log(JSON.stringify({ sites }, null, 2));
@@ -1611,12 +1725,12 @@ async function googleProperties(project, format) {
 Use "canonry google set-property <project> <siteUrl>" to select a property.`);
 }
 async function googleSetProperty(project, propertyUrl) {
-  const client = getClient11();
+  const client = getClient12();
   await client.googleSetProperty(project, "gsc", propertyUrl);
   console.log(`GSC property set to "${propertyUrl}" for project "${project}".`);
 }
 async function googleSync(project, opts) {
-  const client = getClient11();
+  const client = getClient12();
   const run = await client.gscSync(project, { days: opts.days, full: opts.full });
   if (opts.format === "json") {
     console.log(JSON.stringify(run, null, 2));
@@ -1647,7 +1761,7 @@ async function googleSync(project, opts) {
   }
 }
 async function googlePerformance(project, opts) {
-  const client = getClient11();
+  const client = getClient12();
   const params = {};
   if (opts.days) {
     const end = /* @__PURE__ */ new Date();
@@ -1683,7 +1797,7 @@ async function googlePerformance(project, opts) {
   }
 }
 async function googleInspect(project, url, format) {
-  const client = getClient11();
+  const client = getClient12();
   const result = await client.gscInspect(project, url);
   if (format === "json") {
     console.log(JSON.stringify(result, null, 2));
@@ -1703,7 +1817,7 @@ URL Inspection: ${result.url}
   console.log(`  Inspected At:      ${result.inspectedAt}`);
 }
 async function googleInspections(project, opts) {
-  const client = getClient11();
+  const client = getClient12();
   const params = {};
   if (opts.url) params.url = opts.url;
   const rows = await client.gscInspections(project, Object.keys(params).length > 0 ? params : void 0);
@@ -1728,7 +1842,7 @@ async function googleInspections(project, opts) {
   }
 }
 async function googleCoverage(project, format) {
-  const client = getClient11();
+  const client = getClient12();
   const result = await client.gscCoverage(project);
   if (format === "json") {
     console.log(JSON.stringify(result, null, 2));
@@ -1774,12 +1888,12 @@ Index Coverage for "${project}"
   }
 }
 async function googleSetSitemap(project, sitemapUrl) {
-  const client = getClient11();
+  const client = getClient12();
   await client.googleSetSitemap(project, "gsc", sitemapUrl);
   console.log(`GSC sitemap URL set to "${sitemapUrl}" for project "${project}".`);
 }
 async function googleListSitemaps(project, opts) {
-  const client = getClient11();
+  const client = getClient12();
   const result = await client.gscSitemaps(project);
   if (opts.format === "json") {
     console.log(JSON.stringify(result, null, 2));
@@ -1801,7 +1915,7 @@ Sitemaps for project "${project}":
   }
 }
 async function googleInspectSitemap(project, opts) {
-  const client = getClient11();
+  const client = getClient12();
   const run = await client.gscInspectSitemap(project, {
     sitemapUrl: opts.sitemapUrl
   });
@@ -1836,7 +1950,7 @@ async function googleInspectSitemap(project, opts) {
   }
 }
 async function googleCoverageHistory(project, opts) {
-  const client = getClient11();
+  const client = getClient12();
   const rows = await client.gscCoverageHistory(project, { limit: opts.limit });
   if (opts.format === "json") {
     console.log(JSON.stringify(rows, null, 2));
@@ -1858,7 +1972,7 @@ GSC Coverage History for "${project}" (${rows.length} snapshots):
   }
 }
 async function googleDiscoverSitemaps(project, opts) {
-  const client = getClient11();
+  const client = getClient12();
   const result = await client.gscDiscoverSitemaps(project);
   if (opts.format === "json") {
     console.log(JSON.stringify(result, null, 2));
@@ -1903,7 +2017,7 @@ Primary sitemap: ${result.primarySitemapUrl}`);
   }
 }
 async function googleRequestIndexing(project, opts) {
-  const client = getClient11();
+  const client = getClient12();
   const body = { urls: [] };
   if (opts.allUnindexed) {
     body.allUnindexed = true;
@@ -1965,7 +2079,7 @@ async function googleRequestIndexing(project, opts) {
   }
 }
 async function googleDeindexed(project, format) {
-  const client = getClient11();
+  const client = getClient12();
   const rows = await client.gscDeindexed(project);
   if (format === "json") {
     console.log(JSON.stringify(rows, null, 2));
@@ -2023,6 +2137,7 @@ Usage:
   canonry runs <project>              List runs for a project
   canonry status <project>            Show project summary
   canonry evidence <project>          Show per-phrase results
+  canonry analytics <project>         Show analytics (--feature metrics|gaps|sources, --window 7d|30d|90d|all)
   canonry history <project>           Show audit trail
   canonry export <project>            Export project as YAML
   canonry apply <file...>              Apply declarative config (multi-doc YAML supported)
@@ -2539,6 +2654,19 @@ async function main() {
         await showHistory(project, format);
         break;
       }
+      case "analytics": {
+        const project = args[1];
+        if (!project) {
+          console.error("Error: project name is required");
+          process.exit(1);
+        }
+        const featureIdx = args.indexOf("--feature");
+        const feature = featureIdx !== -1 ? args[featureIdx + 1] : void 0;
+        const windowIdx = args.indexOf("--window");
+        const windowArg = windowIdx !== -1 ? args[windowIdx + 1] : void 0;
+        await showAnalytics(project, { feature, window: windowArg, format });
+        break;
+      }
       case "export": {
         const project = args[1];
         if (!project) {

package/dist/index.js

@@ -1,7 +1,7 @@
 import {
   createServer,
   loadConfig
-} from "./chunk-RU7RHCWK.js";
+} from "./chunk-7RIIMCVP.js";
 export {
   createServer,
   loadConfig

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ainyc/canonry",
-  "version": "1.16.0",
+  "version": "1.18.0",
   "type": "module",
   "description": "The ultimate open-source AEO monitoring tool - track how answer engines cite your domain",
   "license": "FSL-1.1-ALv2",
@@ -52,14 +52,14 @@
     "tsup": "^8.5.1",
     "tsx": "^4.19.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-provider-gemini": "0.0.0",
-    "@ainyc/canonry-integration-google": "0.0.0",
+    "@ainyc/canonry-provider-local": "0.0.0",
+    "@ainyc/canonry-contracts": "0.0.0",
     "@ainyc/canonry-provider-claude": "0.0.0",
+    "@ainyc/canonry-integration-google": "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-db": "0.0.0"
   },
   "scripts": {
     "build": "tsup && tsx build-web.ts",