@ainyc/canonry 4.15.0 → 4.17.1

package/dist/cli.js

@@ -20,7 +20,7 @@ import {
   setTelemetrySource,
   showFirstRunNotice,
   trackEvent
-} from "./chunk-DLSQXNUN.js";
+} from "./chunk-ZGHD3IAV.js";
 import {
   CliError,
   EXIT_SYSTEM_ERROR,
@@ -36,7 +36,7 @@ import {
   saveConfig,
   saveConfigPatch,
   usageError
-} from "./chunk-C32VL5BB.js";
+} from "./chunk-6TWKC3DP.js";
 import {
   apiKeys,
   competitors,
@@ -49,7 +49,7 @@ import {
   queries,
   querySnapshots,
   runs
-} from "./chunk-7HBZCGRL.js";
+} from "./chunk-PAZCY4FF.js";
 import {
   CcReleaseSyncStatuses,
   CheckScopes,
@@ -60,6 +60,7 @@ import {
   RunKinds,
   RunStatuses,
   SkillsClients,
+  TrafficEventKinds,
   determineAnswerMentioned,
   effectiveDomains,
   formatRunErrorOneLine,
@@ -68,7 +69,7 @@ import {
   providerQuotaPolicySchema,
   resolveProviderInput,
   skillsClientSchema
-} from "./chunk-6QTH5NS5.js";
+} from "./chunk-Q2OED5JQ.js";
 
 // src/cli.ts
 import { pathToFileURL } from "url";
@@ -620,7 +621,7 @@ function readStoredGroundingSources(rawResponse) {
   return result;
 }
 async function backfillInsightsCommand(project, opts) {
-  const { IntelligenceService } = await import("./intelligence-service-BCKXIKIL.js");
+  const { IntelligenceService } = await import("./intelligence-service-X3PQLBUV.js");
   const config = loadConfig();
   const db = createClient(config.database);
   migrate(db);
@@ -2801,6 +2802,128 @@ async function trafficSync(project, opts) {
   console.log(`  Sample rows:      ${result.sampleRows}`);
   console.log(`  Synced at:        ${result.syncedAt}`);
 }
+function formatSourceLine(source) {
+  const parts = [
+    source.id,
+    source.sourceType,
+    source.status,
+    source.lastSyncedAt ?? "never synced",
+    source.displayName
+  ];
+  return parts.join("  ");
+}
+async function trafficSources(project, opts) {
+  const client = createApiClient();
+  const result = await client.trafficListSources(project);
+  if (opts.format === "json") {
+    console.log(JSON.stringify(result, null, 2));
+    return;
+  }
+  if (result.sources.length === 0) {
+    console.log(`No traffic sources connected for project "${project}".`);
+    console.log("Run: canonry traffic connect cloud-run <project> --gcp-project <id> --service-account-key <path>");
+    return;
+  }
+  console.log(`Traffic sources for "${project}":`);
+  console.log("  ID  TYPE  STATUS  LAST_SYNCED  DISPLAY_NAME");
+  for (const source of result.sources) {
+    console.log(`  ${formatSourceLine(source)}`);
+  }
+}
+async function trafficStatus(project, opts) {
+  const client = createApiClient();
+  const result = await client.trafficStatus(project);
+  const details = result.sources;
+  if (opts.format === "json") {
+    console.log(JSON.stringify(result, null, 2));
+    return;
+  }
+  if (details.length === 0) {
+    console.log(`No traffic sources connected for project "${project}".`);
+    console.log("Run: canonry traffic connect cloud-run <project> --gcp-project <id> --service-account-key <path>");
+    return;
+  }
+  for (const d of details) {
+    console.log(`Source ${d.id} (${d.sourceType})`);
+    console.log(`  Display name:    ${d.displayName}`);
+    console.log(`  Status:          ${d.status}`);
+    console.log(`  Last synced:     ${d.lastSyncedAt ?? "never"}`);
+    if (d.lastError) console.log(`  Last error:      ${d.lastError}`);
+    console.log(`  24h crawler:     ${d.totals24h.crawlerHits} hits`);
+    console.log(`  24h AI referral: ${d.totals24h.aiReferralHits} hits`);
+    console.log(`  24h samples:     ${d.totals24h.sampleCount}`);
+    if (d.latestRun) {
+      console.log(`  Latest run:      ${d.latestRun.runId} (${d.latestRun.status})`);
+      console.log(`    Started:       ${d.latestRun.startedAt}`);
+      if (d.latestRun.finishedAt) console.log(`    Finished:      ${d.latestRun.finishedAt}`);
+      if (d.latestRun.error) console.log(`    Error:         ${d.latestRun.error}`);
+    } else {
+      console.log(`  Latest run:      (none)`);
+    }
+    console.log("");
+  }
+}
+function formatEventLine(event) {
+  if (event.kind === TrafficEventKinds.crawler) {
+    return [
+      event.tsHour,
+      "crawler",
+      event.botId,
+      event.verificationStatus,
+      String(event.status),
+      event.pathNormalized,
+      `${event.hits} hits`
+    ].join("  ");
+  }
+  return [
+    event.tsHour,
+    "ai-referral",
+    event.product,
+    event.evidenceType,
+    event.sourceDomain,
+    event.landingPathNormalized,
+    `${event.hits} hits`
+  ].join("  ");
+}
+async function trafficEvents(project, opts) {
+  if (opts.kind && opts.kind !== "all" && opts.kind !== TrafficEventKinds.crawler && opts.kind !== TrafficEventKinds["ai-referral"]) {
+    throw new CliError({
+      code: "TRAFFIC_INVALID_KIND",
+      message: `--kind must be one of: all, ${TrafficEventKinds.crawler}, ${TrafficEventKinds["ai-referral"]}`,
+      displayMessage: `Error: --kind must be "all", "${TrafficEventKinds.crawler}", or "${TrafficEventKinds["ai-referral"]}"`,
+      details: { project, kind: opts.kind }
+    });
+  }
+  const params = {};
+  if (opts.kind && opts.kind !== "all") params.kind = opts.kind;
+  if (opts.source) params.sourceId = opts.source;
+  if (opts.limit !== void 0) params.limit = opts.limit;
+  if (opts.sinceMinutes !== void 0) {
+    const since = new Date(Date.now() - opts.sinceMinutes * 6e4).toISOString();
+    params.since = since;
+  } else if (opts.since) {
+    params.since = opts.since;
+  }
+  if (opts.until) params.until = opts.until;
+  const client = createApiClient();
+  const result = await client.trafficListEvents(project, params);
+  if (opts.format === "json") {
+    console.log(JSON.stringify(result, null, 2));
+    return;
+  }
+  console.log(`Traffic events for "${project}"  ${result.windowStart}  \u2192  ${result.windowEnd}`);
+  console.log(`  Crawler hits (window):     ${result.totals.crawlerHits}`);
+  console.log(`  AI referral hits (window): ${result.totals.aiReferralHits}`);
+  console.log("");
+  if (result.events.length === 0) {
+    console.log("No events in this window.");
+    return;
+  }
+  console.log("  TS_HOUR  KIND  IDENTITY  EVIDENCE/STATUS  PATH  HITS");
+  for (const event of result.events) {
+    console.log(`  ${formatEventLine(event)}`);
+  }
+}
 
 // src/cli-commands/traffic.ts
 var TRAFFIC_CLI_COMMANDS = [
@@ -2847,7 +2970,7 @@ var TRAFFIC_CLI_COMMANDS = [
   },
   {
     path: ["traffic", "sync"],
-    usage: "canonry traffic sync <project> --source <id> [--since-minutes 60] [--format json]",
+    usage: "canonry traffic sync <project> --source <id> [--since-minutes 43200] [--format json]",
     options: {
       source: stringOption(),
       "since-minutes": stringOption()
@@ -2856,12 +2979,15 @@ var TRAFFIC_CLI_COMMANDS = [
       const project = requireProject(
         input,
         "traffic.sync",
-        "canonry traffic sync <project> --source <id> [--since-minutes 60]"
+        "canonry traffic sync <project> --source <id> [--since-minutes 43200]"
       );
       const source = getString(input.values, "source");
       if (!source) throw new Error("--source <id> is required");
-      const sinceStr = getString(input.values, "since-minutes");
-      const sinceMinutes = sinceStr ? parseInt(sinceStr, 10) : void 0;
+      const sinceMinutes = parseIntegerOption(input, "since-minutes", {
+        command: "traffic.sync",
+        usage: "canonry traffic sync <project> --source <id> [--since-minutes 43200]",
+        message: "--since-minutes must be an integer"
+      });
       await trafficSync(project, {
         source,
         sinceMinutes,
@@ -2869,6 +2995,68 @@ var TRAFFIC_CLI_COMMANDS = [
       });
     }
   },
+  {
+    path: ["traffic", "sources"],
+    usage: "canonry traffic sources <project> [--format json]",
+    run: async (input) => {
+      const project = requireProject(
+        input,
+        "traffic.sources",
+        "canonry traffic sources <project>"
+      );
+      await trafficSources(project, { format: input.format });
+    }
+  },
+  {
+    path: ["traffic", "status"],
+    usage: "canonry traffic status <project> [--format json]",
+    run: async (input) => {
+      const project = requireProject(
+        input,
+        "traffic.status",
+        "canonry traffic status <project>"
+      );
+      await trafficStatus(project, { format: input.format });
+    }
+  },
+  {
+    path: ["traffic", "events"],
+    usage: "canonry traffic events <project> [--kind crawler|ai-referral|all] [--source <id>] [--since-minutes 1440] [--since <iso>] [--until <iso>] [--limit 500] [--format json]",
+    options: {
+      kind: stringOption(),
+      source: stringOption(),
+      "since-minutes": stringOption(),
+      since: stringOption(),
+      until: stringOption(),
+      limit: stringOption()
+    },
+    run: async (input) => {
+      const project = requireProject(
+        input,
+        "traffic.events",
+        "canonry traffic events <project>"
+      );
+      const sinceMinutes = parseIntegerOption(input, "since-minutes", {
+        command: "traffic.events",
+        usage: "canonry traffic events <project> [--since-minutes 1440]",
+        message: "--since-minutes must be an integer"
+      });
+      const limit = parseIntegerOption(input, "limit", {
+        command: "traffic.events",
+        usage: "canonry traffic events <project> [--limit 500]",
+        message: "--limit must be an integer"
+      });
+      await trafficEvents(project, {
+        kind: getString(input.values, "kind"),
+        source: getString(input.values, "source"),
+        sinceMinutes,
+        since: getString(input.values, "since"),
+        until: getString(input.values, "until"),
+        limit,
+        format: input.format
+      });
+    }
+  },
   {
     path: ["traffic"],
     usage: "canonry traffic <subcommand> <project> [args]",
@@ -2876,7 +3064,7 @@ var TRAFFIC_CLI_COMMANDS = [
       unknownSubcommand(input.positionals[0], {
         command: "traffic",
         usage: "canonry traffic <subcommand> <project> [args]",
-        available: ["connect", "sync"]
+        available: ["connect", "sync", "status", "sources", "events"]
       });
     }
   }
@@ -6072,6 +6260,8 @@ function getClient17() {
 async function setSchedule(project, opts) {
   const client = getClient17();
   const body = {};
+  if (opts.kind) body.kind = opts.kind;
+  if (opts.sourceId) body.sourceId = opts.sourceId;
   if (opts.preset) body.preset = opts.preset;
   if (opts.cron) body.cron = opts.cron;
   if (opts.timezone) body.timezone = opts.timezone;
@@ -6081,61 +6271,68 @@ async function setSchedule(project, opts) {
     console.log(JSON.stringify(result, null, 2));
     return;
   }
-  console.log(`Schedule set for "${project}":`);
+  console.log(`Schedule set for "${project}" (kind: ${result.kind}):`);
   printSchedule(result);
 }
-async function showSchedule(project, format) {
+async function showSchedule(project, format, kind) {
   const client = getClient17();
-  const result = await client.getSchedule(project);
+  const result = await client.getSchedule(project, kind);
   if (format === "json") {
     console.log(JSON.stringify(result, null, 2));
     return;
   }
   printSchedule(result);
 }
-async function enableSchedule(project, format) {
+async function enableSchedule(project, format, kind) {
   const client = getClient17();
-  const current = await client.getSchedule(project);
-  const body = { timezone: current.timezone, enabled: true };
+  const current = await client.getSchedule(project, kind);
+  const body = { kind: current.kind, timezone: current.timezone, enabled: true };
   if (current.preset) body.preset = current.preset;
   else body.cron = current.cronExpr;
   if (current.providers.length) body.providers = current.providers;
+  if (current.sourceId) body.sourceId = current.sourceId;
   const result = await client.putSchedule(project, body);
   if (format === "json") {
     console.log(JSON.stringify(result, null, 2));
     return;
   }
-  console.log(`Schedule enabled for "${project}"`);
+  console.log(`Schedule enabled for "${project}" (kind: ${result.kind})`);
 }
-async function disableSchedule(project, format) {
+async function disableSchedule(project, format, kind) {
   const client = getClient17();
-  const current = await client.getSchedule(project);
-  const body = { timezone: current.timezone, enabled: false };
+  const current = await client.getSchedule(project, kind);
+  const body = { kind: current.kind, timezone: current.timezone, enabled: false };
   if (current.preset) body.preset = current.preset;
   else body.cron = current.cronExpr;
   if (current.providers.length) body.providers = current.providers;
+  if (current.sourceId) body.sourceId = current.sourceId;
   const result = await client.putSchedule(project, body);
   if (format === "json") {
     console.log(JSON.stringify(result, null, 2));
     return;
   }
-  console.log(`Schedule disabled for "${project}"`);
+  console.log(`Schedule disabled for "${project}" (kind: ${result.kind})`);
 }
-async function removeSchedule(project, format) {
+async function removeSchedule(project, format, kind) {
   const client = getClient17();
-  await client.deleteSchedule(project);
+  await client.deleteSchedule(project, kind);
+  const resolvedKind = kind ?? "answer-visibility";
   if (format === "json") {
-    console.log(JSON.stringify({ project, removed: true }, null, 2));
+    console.log(JSON.stringify({ project, kind: resolvedKind, removed: true }, null, 2));
     return;
   }
-  console.log(`Schedule removed for "${project}"`);
+  console.log(`Schedule removed for "${project}" (kind: ${resolvedKind})`);
 }
 function printSchedule(s) {
   const label = s.preset ?? s.cronExpr;
+  console.log(`  Kind:      ${s.kind}`);
   console.log(`  Schedule:  ${label}`);
   console.log(`  Cron:      ${s.cronExpr}`);
   console.log(`  Timezone:  ${s.timezone}`);
   console.log(`  Enabled:   ${s.enabled ? "yes" : "no"}`);
+  if (s.kind === "traffic-sync" && s.sourceId) {
+    console.log(`  Source:    ${s.sourceId}`);
+  }
   if (s.providers.length) {
     console.log(`  Providers: ${s.providers.join(", ")}`);
   }
@@ -6151,30 +6348,31 @@ function printSchedule(s) {
 var SCHEDULE_CLI_COMMANDS = [
   {
     path: ["schedule", "set"],
-    usage: "canonry schedule set <project> (--preset <preset> | --cron <expr>) [--timezone <tz>] [--provider <name>...] [--format json]",
+    usage: "canonry schedule set <project> (--preset <preset> | --cron <expr>) [--kind answer-visibility|traffic-sync] [--source <id>] [--timezone <tz>] [--provider <name>...] [--format json]",
     options: {
       preset: stringOption(),
       cron: stringOption(),
+      kind: stringOption(),
+      source: stringOption(),
       timezone: stringOption(),
       provider: multiStringOption()
     },
     run: async (input) => {
-      const project = requireProject(
-        input,
-        "schedule.set",
-        "canonry schedule set <project> (--preset <preset> | --cron <expr>) [--timezone <tz>] [--provider <name>...] [--format json]"
-      );
+      const usage = "canonry schedule set <project> (--preset <preset> | --cron <expr>) [--kind answer-visibility|traffic-sync] [--source <id>] [--timezone <tz>] [--provider <name>...] [--format json]";
+      const project = requireProject(input, "schedule.set", usage);
       if (!getString(input.values, "preset") && !getString(input.values, "cron")) {
         throw usageError("Error: --preset or --cron is required", {
           message: "schedule preset or cron is required",
           details: {
             command: "schedule.set",
-            usage: "canonry schedule set <project> (--preset <preset> | --cron <expr>) [--timezone <tz>] [--provider <name>...] [--format json]",
+            usage,
             required: ["preset | cron"]
           }
         });
       }
       await setSchedule(project, {
+        kind: getString(input.values, "kind"),
+        sourceId: getString(input.values, "source"),
         preset: getString(input.values, "preset"),
         cron: getString(input.values, "cron"),
         timezone: getString(input.values, "timezone"),
@@ -6185,34 +6383,38 @@ var SCHEDULE_CLI_COMMANDS = [
   },
   {
     path: ["schedule", "show"],
-    usage: "canonry schedule show <project> [--format json]",
+    usage: "canonry schedule show <project> [--kind answer-visibility|traffic-sync] [--format json]",
+    options: { kind: stringOption() },
     run: async (input) => {
-      const project = requireProject(input, "schedule.show", "canonry schedule show <project> [--format json]");
-      await showSchedule(project, input.format);
+      const project = requireProject(input, "schedule.show", "canonry schedule show <project> [--kind ...]");
+      await showSchedule(project, input.format, getString(input.values, "kind"));
     }
   },
   {
     path: ["schedule", "enable"],
-    usage: "canonry schedule enable <project> [--format json]",
+    usage: "canonry schedule enable <project> [--kind answer-visibility|traffic-sync] [--format json]",
+    options: { kind: stringOption() },
     run: async (input) => {
-      const project = requireProject(input, "schedule.enable", "canonry schedule enable <project> [--format json]");
-      await enableSchedule(project, input.format);
+      const project = requireProject(input, "schedule.enable", "canonry schedule enable <project> [--kind ...]");
+      await enableSchedule(project, input.format, getString(input.values, "kind"));
     }
   },
   {
     path: ["schedule", "disable"],
-    usage: "canonry schedule disable <project> [--format json]",
+    usage: "canonry schedule disable <project> [--kind answer-visibility|traffic-sync] [--format json]",
+    options: { kind: stringOption() },
     run: async (input) => {
-      const project = requireProject(input, "schedule.disable", "canonry schedule disable <project> [--format json]");
-      await disableSchedule(project, input.format);
+      const project = requireProject(input, "schedule.disable", "canonry schedule disable <project> [--kind ...]");
+      await disableSchedule(project, input.format, getString(input.values, "kind"));
     }
   },
   {
     path: ["schedule", "remove"],
-    usage: "canonry schedule remove <project> [--format json]",
+    usage: "canonry schedule remove <project> [--kind answer-visibility|traffic-sync] [--format json]",
+    options: { kind: stringOption() },
     run: async (input) => {
-      const project = requireProject(input, "schedule.remove", "canonry schedule remove <project> [--format json]");
-      await removeSchedule(project, input.format);
+      const project = requireProject(input, "schedule.remove", "canonry schedule remove <project> [--kind ...]");
+      await removeSchedule(project, input.format, getString(input.values, "kind"));
     }
   },
   {
@@ -10451,6 +10653,7 @@ Integrations:
   google                Google Search Console / Analytics
   bing                  Bing Webmaster Tools
   wordpress             WordPress REST API
+  traffic               Server-side traffic ingestion (Cloud Run)
 
 Automation:
   schedule              Manage scheduled runs
@@ -10492,7 +10695,7 @@ async function runCli(args = process.argv.slice(2)) {
     showFirstRunNotice();
     getOrCreateAnonymousId();
   }
-  const SUBCOMMAND_COMMANDS = /* @__PURE__ */ new Set(["backfill", "project", "query", "keyword", "competitor", "schedule", "notify", "settings", "telemetry", "google", "bing", "wordpress", "cdp"]);
+  const SUBCOMMAND_COMMANDS = /* @__PURE__ */ new Set(["backfill", "project", "query", "keyword", "competitor", "schedule", "notify", "settings", "telemetry", "google", "bing", "wordpress", "cdp", "traffic"]);
   const MIXED_SUBCOMMANDS = {
     insights: /* @__PURE__ */ new Set(["dismiss"]),
     run: /* @__PURE__ */ new Set(["show", "cancel"])

package/dist/index.js

@@ -1,11 +1,11 @@
 import {
   createServer
-} from "./chunk-DLSQXNUN.js";
+} from "./chunk-ZGHD3IAV.js";
 import {
   loadConfig
-} from "./chunk-C32VL5BB.js";
-import "./chunk-7HBZCGRL.js";
-import "./chunk-6QTH5NS5.js";
+} from "./chunk-6TWKC3DP.js";
+import "./chunk-PAZCY4FF.js";
+import "./chunk-Q2OED5JQ.js";
 export {
   createServer,
   loadConfig

package/dist/{intelligence-service-BCKXIKIL.js → intelligence-service-X3PQLBUV.js}

@@ -1,7 +1,7 @@
 import {
   IntelligenceService
-} from "./chunk-7HBZCGRL.js";
-import "./chunk-6QTH5NS5.js";
+} from "./chunk-PAZCY4FF.js";
+import "./chunk-Q2OED5JQ.js";
 export {
   IntelligenceService
 };

package/dist/mcp.js

@@ -2,8 +2,8 @@ import {
   CliError,
   canonryMcpTools,
   createApiClient
-} from "./chunk-C32VL5BB.js";
-import "./chunk-6QTH5NS5.js";
+} from "./chunk-6TWKC3DP.js";
+import "./chunk-Q2OED5JQ.js";
 
 // src/mcp/cli.ts
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
@@ -107,7 +107,7 @@ function zodErrorMessage(error) {
 }
 
 // src/mcp/toolkits.ts
-var CANONRY_MCP_TOOLKIT_NAMES = ["monitoring", "setup", "gsc", "ga", "agent"];
+var CANONRY_MCP_TOOLKIT_NAMES = ["monitoring", "setup", "gsc", "ga", "traffic", "agent"];
 var CANONRY_MCP_TOOLKITS = [
   {
     name: "monitoring",
@@ -133,6 +133,12 @@ var CANONRY_MCP_TOOLKITS = [
     description: "Read GA traffic, AI/social referral history, attribution trend, and session history.",
     whenToLoad: "Load when you need traffic, referral, or attribution data from Google Analytics 4."
   },
+  {
+    name: "traffic",
+    title: "Server-side traffic ingestion",
+    description: "Connect Cloud Run traffic sources, trigger syncs, and read crawler / AI-referral hourly rollups straight from server logs (no GA dependency).",
+    whenToLoad: "Load when you need server-log evidence of crawler hits or AI-referral arrivals (e.g. confirming GPTBot or ChatGPT-User on a page), or when wiring up / syncing a Cloud Run traffic source."
+  },
   {
     name: "agent",
     title: "Aero agent lifecycle and memory",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ainyc/canonry",
-  "version": "4.15.0",
+  "version": "4.17.1",
   "type": "module",
   "description": "Agent-first open-source AEO operating platform - track how answer engines cite your domain",
   "license": "FSL-1.1-ALv2",
@@ -60,21 +60,21 @@
     "tsup": "^8.5.1",
     "tsx": "^4.19.0",
     "@ainyc/canonry-api-routes": "0.0.0",
-    "@ainyc/canonry-config": "0.0.0",
     "@ainyc/canonry-db": "0.0.0",
-    "@ainyc/canonry-integration-bing": "0.0.0",
+    "@ainyc/canonry-config": "0.0.0",
     "@ainyc/canonry-intelligence": "0.0.0",
-    "@ainyc/canonry-integration-cloud-run": "0.0.0",
     "@ainyc/canonry-contracts": "0.0.0",
-    "@ainyc/canonry-integration-commoncrawl": "0.0.0",
+    "@ainyc/canonry-integration-bing": "0.0.0",
+    "@ainyc/canonry-integration-cloud-run": "0.0.0",
     "@ainyc/canonry-integration-google": "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-provider-claude": "0.0.0",
+    "@ainyc/canonry-integration-traffic": "0.0.0",
     "@ainyc/canonry-provider-gemini": "0.0.0",
     "@ainyc/canonry-provider-local": "0.0.0",
     "@ainyc/canonry-provider-openai": "0.0.0",
+    "@ainyc/canonry-provider-claude": "0.0.0",
     "@ainyc/canonry-provider-perplexity": "0.0.0"
   },
   "scripts": {