@ainyc/canonry 4.30.0 → 4.32.0

package/dist/{chunk-4EDC2P3J.js → chunk-LUAJVZVZ.js}

@@ -8,7 +8,7 @@ import {
   categoryLabel,
   determineAnswerMentioned,
   normalizeProjectDomain
-} from "./chunk-7UO3EGDB.js";
+} from "./chunk-5M4PP6P4.js";
 
 // src/intelligence-service.ts
 import { eq, desc, asc, and, or, inArray } from "drizzle-orm";

package/dist/{chunk-NIAAHWRF.js → chunk-LVX5TOYA.js}

@@ -4,6 +4,7 @@ import {
   DISCOVERY_MAX_PROBES_CAP,
   competitorBatchRequestSchema,
   discoveryBucketSchema,
+  discoveryCompetitorTypeSchema,
   discoveryPromoteRequestSchema,
   discoveryRunRequestSchema,
   keywordBatchRequestSchema,
@@ -18,9 +19,10 @@ import {
   schedulableRunKindSchema,
   scheduleUpsertRequestSchema,
   trafficConnectCloudRunRequestSchema,
+  trafficConnectVercelRequestSchema,
   trafficConnectWordpressRequestSchema,
   trafficEventKindSchema
-} from "./chunk-7UO3EGDB.js";
+} from "./chunk-5M4PP6P4.js";
 
 // src/config.ts
 import fs from "fs";
@@ -778,6 +780,13 @@ var ApiClient = class {
       body
     );
   }
+  async trafficConnectVercel(project, body) {
+    return this.request(
+      "POST",
+      `/projects/${encodeURIComponent(project)}/traffic/connect/vercel`,
+      body
+    );
+  }
   async trafficSync(project, sourceId, body) {
     return this.request(
       "POST",
@@ -1241,6 +1250,10 @@ var trafficConnectWordpressInputSchema = z2.object({
   project: projectNameSchema,
   request: trafficConnectWordpressRequestSchema
 });
+var trafficConnectVercelInputSchema = z2.object({
+  project: projectNameSchema,
+  request: trafficConnectVercelRequestSchema
+});
 var trafficSyncInputSchema = z2.object({
   project: projectNameSchema,
   sourceId: z2.string().min(1).describe("Traffic source ID returned by canonry_traffic_connect_cloud_run or canonry_traffic_sources_list."),
@@ -1287,7 +1300,8 @@ var discoveryPromoteInputSchema = z2.object({
   request: discoveryPromoteRequestSchema.extend({
     // Stronger descriptions for the LLM. The base Zod schema enforces the shape.
     buckets: z2.array(discoveryBucketSchema).min(1).optional().describe("Which probe buckets to adopt into the tracked basket. Omitted promotes cited + aspirational; include wasted-surface explicitly for off-ICP competitor gaps."),
-    includeCompetitors: z2.boolean().optional().describe("Whether to also merge recurring discovered competitor domains into the project. Defaults to true.")
+    includeCompetitors: z2.boolean().optional().describe("Whether to also merge recurring discovered competitor domains into the project. Defaults to true."),
+    competitorTypes: z2.array(discoveryCompetitorTypeSchema).min(1).optional().describe("Which classified competitor types to merge. Omitted promotes direct-competitor only; pass an explicit list to also adopt editorial-media channels or to recover legacy unknown entries. Ignored when includeCompetitors is false.")
   }).optional()
 });
 var AGENT_WEBHOOK_EVENTS = [
@@ -1876,6 +1890,17 @@ var canonryMcpTools = [
     openApiOperations: ["POST /api/v1/projects/{name}/traffic/connect/wordpress"],
     handler: (client, input) => client.trafficConnectWordpress(input.project, input.request)
   }),
+  defineTool({
+    name: "canonry_traffic_connect_vercel",
+    title: "Connect Vercel traffic source",
+    description: "Connect a Vercel project as a server-side traffic source. Pulls request logs from Vercel's internal request-logs endpoint \u2014 no in-app instrumentation needed. Probes the endpoint with the supplied API token before persisting \u2014 a bad token or wrong project / team id surfaces as a 502 error. Reconnecting updates the existing active Vercel source in place. The API token is stored in ~/.canonry/config.yaml (not the DB) and never echoed back.",
+    access: "write",
+    tier: "traffic",
+    inputSchema: trafficConnectVercelInputSchema,
+    annotations: writeAnnotations({ idempotentHint: true, openWorldHint: true }),
+    openApiOperations: ["POST /api/v1/projects/{name}/traffic/connect/vercel"],
+    handler: (client, input) => client.trafficConnectVercel(input.project, input.request)
+  }),
   defineTool({
     name: "canonry_traffic_sync",
     title: "Sync Cloud Run traffic source",
@@ -2242,7 +2267,7 @@ var canonryMcpTools = [
   defineTool({
     name: "canonry_discover_promote",
     title: "Promote discovery session",
-    description: 'Adopt a completed discovery session\'s bucketed queries into the project\'s tracked basket, tagged with provenance "discovery:<sessionId>". By default, only cited + aspirational queries are promoted; include wasted-surface explicitly when off-ICP competitor gaps should also be tracked. Recurring discovered competitor domains are also merged by default. Add-only and idempotent: queries/domains already tracked are returned under `skipped`, never inserted twice. Only sessions with status "completed" can be promoted. Call canonry_discover_promote_preview first to inspect candidates.',
+    description: 'Adopt a completed discovery session\'s bucketed queries into the project\'s tracked basket, tagged with provenance "discovery:<sessionId>". By default, only cited + aspirational queries are promoted; include wasted-surface explicitly when off-ICP competitor gaps should also be tracked. Recurring discovered competitor domains classified as direct-competitor are also merged by default \u2014 pass request.competitorTypes to adopt editorial-media channels or recover legacy unknown entries. Add-only and idempotent: queries/domains already tracked are returned under `skipped`, never inserted twice. Only sessions with status "completed" can be promoted. Call canonry_discover_promote_preview first to inspect candidates.',
     access: "write",
     tier: "discovery",
     inputSchema: discoveryPromoteInputSchema,

package/dist/cli.js

@@ -20,7 +20,7 @@ import {
   setTelemetrySource,
   showFirstRunNotice,
   trackEvent
-} from "./chunk-PTFVEYUX.js";
+} from "./chunk-7I65IXVU.js";
 import {
   CliError,
   EXIT_SYSTEM_ERROR,
@@ -36,7 +36,7 @@ import {
   saveConfig,
   saveConfigPatch,
   usageError
-} from "./chunk-NIAAHWRF.js";
+} from "./chunk-LVX5TOYA.js";
 import {
   apiKeys,
   competitors,
@@ -49,7 +49,7 @@ import {
   queries,
   querySnapshots,
   runs
-} from "./chunk-4EDC2P3J.js";
+} from "./chunk-LUAJVZVZ.js";
 import {
   CcReleaseSyncStatuses,
   CheckScopes,
@@ -63,6 +63,7 @@ import {
   TrafficEventKinds,
   determineAnswerMentioned,
   discoveryBucketSchema,
+  discoveryCompetitorTypeSchema,
   effectiveDomains,
   formatRunErrorOneLine,
   normalizeUrlPath,
@@ -70,7 +71,7 @@ import {
   providerQuotaPolicySchema,
   resolveProviderInput,
   skillsClientSchema
-} from "./chunk-7UO3EGDB.js";
+} from "./chunk-5M4PP6P4.js";
 
 // src/cli.ts
 import { pathToFileURL } from "url";
@@ -622,7 +623,7 @@ function readStoredGroundingSources(rawResponse) {
   return result;
 }
 async function backfillInsightsCommand(project, opts) {
-  const { IntelligenceService } = await import("./intelligence-service-ASXADXLF.js");
+  const { IntelligenceService } = await import("./intelligence-service-RSRWDBHS.js");
   const config = loadConfig();
   const db = createClient(config.database);
   migrate(db);
@@ -2142,7 +2143,10 @@ async function discoverPromotePreview(project, sessionId, opts) {
   for (const q of preview.queriesByBucket.aspirational.slice(0, 10)) console.log(`    + ${q}`);
   if (preview.suggestedCompetitors.length > 0) {
     console.log(`  Suggested new competitors:`);
-    for (const c of preview.suggestedCompetitors) console.log(`    - ${c.domain} (${c.hits} hits)`);
+    for (const c of preview.suggestedCompetitors) {
+      console.log(`    - ${c.domain} (${c.hits} hits, ${c.competitorType})`);
+    }
+    console.log("    Only direct-competitor is promoted by default \u2014 pass --competitor-types to include other types.");
   }
   console.log(`
   Run \`canonry discover promote ${project} ${sessionId}\` to merge cited + aspirational queries.`);
@@ -2152,6 +2156,7 @@ async function discoverPromote(project, sessionId, opts) {
   const client = getClient4();
   const body = {};
   if (opts.buckets && opts.buckets.length > 0) body.buckets = opts.buckets;
+  if (opts.competitorTypes && opts.competitorTypes.length > 0) body.competitorTypes = opts.competitorTypes;
   if (opts.includeCompetitors === false) body.includeCompetitors = false;
   const result = await client.promoteDiscovery(project, sessionId, body);
   if (opts.format === "json") {
@@ -2181,7 +2186,9 @@ function printSessionDetail(session) {
   console.log(`  Buckets:       cited=${session.citedCount ?? 0}  wasted-surface=${session.wastedCount ?? 0}  aspirational=${session.aspirationalCount ?? 0}`);
   if (session.competitorMap.length > 0) {
     console.log(`  Top recurring competitor domains:`);
-    for (const c of session.competitorMap.slice(0, 10)) console.log(`    - ${c.domain} (${c.hits} hits)`);
+    for (const c of session.competitorMap.slice(0, 10)) {
+      console.log(`    - ${c.domain} (${c.hits} hits, ${c.competitorType})`);
+    }
   }
   if (session.error) console.log(`  Error:         ${session.error}`);
   if (session.startedAt) console.log(`  Started:       ${session.startedAt}`);
@@ -2265,6 +2272,38 @@ Usage: ${usage}`,
   }
   return buckets;
 }
+var COMPETITOR_TYPE_VALUES = "direct-competitor, ota-aggregator, editorial-media, other, unknown";
+function parseCompetitorTypesOption(values, usage) {
+  const raw = getStringArray(values, "competitor-types");
+  if (!raw || raw.length === 0) return void 0;
+  const expanded = raw.flatMap((v) => v.split(",")).map((v) => v.trim()).filter(Boolean);
+  if (expanded.length === 0) {
+    throw usageError(
+      `Error: --competitor-types must include at least one value (valid: ${COMPETITOR_TYPE_VALUES})
+Usage: ${usage}`,
+      {
+        message: "--competitor-types must include at least one value",
+        details: { command: "discover.promote", usage, option: "competitor-types", value: raw }
+      }
+    );
+  }
+  const types = [];
+  for (const value of expanded) {
+    const parsed = discoveryCompetitorTypeSchema.safeParse(value);
+    if (!parsed.success) {
+      throw usageError(
+        `Error: invalid --competitor-types value "${value}" (valid: ${COMPETITOR_TYPE_VALUES})
+Usage: ${usage}`,
+        {
+          message: `invalid --competitor-types value "${value}"`,
+          details: { command: "discover.promote", usage, option: "competitor-types", value }
+        }
+      );
+    }
+    types.push(parsed.data);
+  }
+  return types;
+}
 var DISCOVER_CLI_COMMANDS = [
   {
     path: ["discover", "run"],
@@ -2378,13 +2417,14 @@ var DISCOVER_CLI_COMMANDS = [
   },
   {
     path: ["discover", "promote"],
-    usage: "canonry discover promote <project> <session-id> [--bucket cited,aspirational,wasted-surface] [--no-competitors] [--format json]",
+    usage: "canonry discover promote <project> <session-id> [--bucket cited,aspirational,wasted-surface] [--competitor-types direct-competitor,editorial-media] [--no-competitors] [--format json]",
     options: {
       bucket: multiStringOption(),
+      "competitor-types": multiStringOption(),
       "no-competitors": { type: "boolean", default: false }
     },
     run: async (input) => {
-      const usage = "canonry discover promote <project> <session-id> [--bucket cited,aspirational,wasted-surface] [--no-competitors] [--format json]";
+      const usage = "canonry discover promote <project> <session-id> [--bucket cited,aspirational,wasted-surface] [--competitor-types direct-competitor,editorial-media] [--no-competitors] [--format json]";
       const project = requireProject(input, "discover.promote", usage);
       const sessionId = requirePositional(input, 1, {
         command: "discover.promote",
@@ -2393,6 +2433,7 @@ var DISCOVER_CLI_COMMANDS = [
       });
       await discoverPromote(project, sessionId, {
         buckets: parseBucketsOption(input.values, usage),
+        competitorTypes: parseCompetitorTypesOption(input.values, usage),
         includeCompetitors: !getBoolean(input.values, "no-competitors"),
         format: input.format
       });
@@ -3304,6 +3345,84 @@ async function trafficConnectCloudRun(project, opts) {
   console.log("");
   console.log(`Next: canonry traffic sync ${project} --source ${result.id}`);
 }
+async function trafficConnectVercel(project, opts) {
+  if (!opts.projectId) {
+    throw new CliError({
+      code: "TRAFFIC_VERCEL_PROJECT_ID_REQUIRED",
+      message: "--project-id is required",
+      displayMessage: "Error: --project-id is required (the Vercel project id, e.g. prj_...)",
+      details: { project }
+    });
+  }
+  if (!opts.teamId) {
+    throw new CliError({
+      code: "TRAFFIC_VERCEL_TEAM_ID_REQUIRED",
+      message: "--team-id is required",
+      displayMessage: "Error: --team-id is required (the Vercel team / owner id, e.g. team_...)",
+      details: { project }
+    });
+  }
+  if (opts.token && opts.tokenFile) {
+    throw new CliError({
+      code: "TRAFFIC_VERCEL_TOKEN_CONFLICT",
+      message: "--token and --token-file are mutually exclusive",
+      displayMessage: "Error: pass either --token <token> or --token-file <path>, not both",
+      details: { project }
+    });
+  }
+  let token = opts.token?.trim() ?? "";
+  if (!token && opts.tokenFile) {
+    const fs13 = await import("fs");
+    try {
+      token = fs13.readFileSync(opts.tokenFile, "utf-8").trim();
+    } catch (e) {
+      const msg = e instanceof Error ? e.message : String(e);
+      throw new CliError({
+        code: "TRAFFIC_VERCEL_TOKEN_FILE_READ_ERROR",
+        message: `Failed to read --token-file: ${msg}`,
+        displayMessage: `Error: failed to read --token-file "${opts.tokenFile}": ${msg}`,
+        details: { project, tokenFile: opts.tokenFile }
+      });
+    }
+  }
+  if (!token) {
+    throw new CliError({
+      code: "TRAFFIC_VERCEL_TOKEN_REQUIRED",
+      message: "--token or --token-file is required",
+      displayMessage: "Error: pass --token <token> or --token-file <path>",
+      details: { project }
+    });
+  }
+  if (opts.environment && opts.environment !== "production" && opts.environment !== "preview") {
+    throw new CliError({
+      code: "TRAFFIC_VERCEL_INVALID_ENVIRONMENT",
+      message: '--environment must be "production" or "preview"',
+      displayMessage: 'Error: --environment must be "production" or "preview"',
+      details: { project, environment: opts.environment }
+    });
+  }
+  const client = getClient6();
+  const result = await client.trafficConnectVercel(project, {
+    projectId: opts.projectId,
+    teamId: opts.teamId,
+    token,
+    environment: opts.environment,
+    displayName: opts.displayName
+  });
+  if (opts.format === "json") {
+    console.log(JSON.stringify(result, null, 2));
+    return;
+  }
+  console.log(`Vercel traffic source connected for project "${project}".`);
+  console.log(`  Source ID:    ${result.id}`);
+  console.log(`  Display name: ${result.displayName}`);
+  console.log(`  Status:       ${result.status}`);
+  console.log(`  Project ID:   ${result.config.projectId ?? "(unset)"}`);
+  console.log(`  Team ID:      ${result.config.teamId ?? "(unset)"}`);
+  console.log(`  Environment:  ${result.config.environment ?? "(unset)"}`);
+  console.log("");
+  console.log(`Next: canonry traffic sync ${project} --source ${result.id}`);
+}
 async function trafficBackfill(project, opts) {
   if (!opts.source) {
     throw new CliError({
@@ -3585,6 +3704,38 @@ var TRAFFIC_CLI_COMMANDS = [
       });
     }
   },
+  {
+    path: ["traffic", "connect", "vercel"],
+    usage: "canonry traffic connect vercel <project> --project-id <prj> --team-id <team> (--token <token> | --token-file <path>) [--environment production|preview] [--display-name <name>] [--format json]",
+    options: {
+      "project-id": stringOption(),
+      "team-id": stringOption(),
+      token: stringOption(),
+      "token-file": stringOption(),
+      environment: stringOption(),
+      "display-name": stringOption()
+    },
+    run: async (input) => {
+      const project = requireProject(
+        input,
+        "traffic.connect.vercel",
+        "canonry traffic connect vercel <project> --project-id <prj> --team-id <team> (--token <token> | --token-file <path>)"
+      );
+      const projectId = getString(input.values, "project-id");
+      if (!projectId) throw new Error("--project-id is required");
+      const teamId = getString(input.values, "team-id");
+      if (!teamId) throw new Error("--team-id is required");
+      await trafficConnectVercel(project, {
+        projectId,
+        teamId,
+        token: getString(input.values, "token"),
+        tokenFile: getString(input.values, "token-file"),
+        environment: getString(input.values, "environment"),
+        displayName: getString(input.values, "display-name"),
+        format: input.format
+      });
+    }
+  },
   {
     path: ["traffic", "connect"],
     usage: "canonry traffic connect <provider> <project> [args]",
@@ -3592,7 +3743,7 @@ var TRAFFIC_CLI_COMMANDS = [
       unknownSubcommand(input.positionals[0], {
         command: "traffic connect",
         usage: "canonry traffic connect <provider> <project> [args]",
-        available: ["cloud-run", "wordpress"]
+        available: ["cloud-run", "wordpress", "vercel"]
       });
     }
   },
@@ -11293,9 +11444,9 @@ var REGISTERED_CLI_COMMANDS = [
 // src/cli.ts
 import { createRequire as createRequire2 } from "module";
 var USAGE3 = `
-canonry \u2014 AEO monitoring CLI
+cnry \u2014 AEO monitoring CLI   ('canonry' also works)
 
-Usage:  canonry <command> [options]
+Usage:  cnry <command> [options]
 
 Setup:
   init                  Initialize config and database
@@ -11343,7 +11494,7 @@ Global options:
   --help, -h            Show help (use with any command group)
   --version, -v         Show version
 
-Run 'canonry <command> --help' for details on a specific command.
+Run 'cnry <command> --help' for details on a specific command.
 `.trim();
 var _require2 = createRequire2(import.meta.url);
 var { version: VERSION } = _require2("../package.json");
@@ -11394,11 +11545,11 @@ async function runCli(args = process.argv.slice(2)) {
       return 0;
     }
     throw usageError(`Error: unknown command: ${command}
-Run "canonry --help" for usage.`, {
+Run "cnry --help" for usage.`, {
       message: `unknown command: ${command}`,
       details: {
         command,
-        usage: "canonry --help"
+        usage: "cnry --help"
       }
     });
   } catch (err) {

package/dist/index.d.ts

@@ -107,6 +107,25 @@ interface WordpressTrafficConnectionConfigEntry {
 interface WordpressTrafficConfigEntry {
     connections?: WordpressTrafficConnectionConfigEntry[];
 }
+type VercelTrafficEnvironment = 'production' | 'preview';
+/**
+ * Per-project Vercel traffic connection. Authenticates against Vercel's
+ * internal `request-logs` endpoint using a Vercel API token. The project id,
+ * team id, and environment are non-secret and also mirrored onto the
+ * `traffic_sources` row; the token lives only here.
+ */
+interface VercelTrafficConnectionConfigEntry {
+    projectName: string;
+    projectId: string;
+    teamId: string;
+    token: string;
+    environment: VercelTrafficEnvironment;
+    createdAt: string;
+    updatedAt: string;
+}
+interface VercelTrafficConfigEntry {
+    connections?: VercelTrafficConnectionConfigEntry[];
+}
 interface AgentConfigEntry {
     /** Agent mode. Only 'disabled' is valid until the native loop ships. */
     mode?: 'disabled';
@@ -130,6 +149,7 @@ interface CanonryConfig {
     cloudRun?: CloudRunConfigEntry;
     wordpress?: WordpressConfigEntry;
     wordpressTraffic?: WordpressTrafficConfigEntry;
+    vercelTraffic?: VercelTrafficConfigEntry;
     dashboardPasswordHash?: string;
     telemetry?: boolean;
     anonymousId?: string;

package/dist/index.js

@@ -1,11 +1,11 @@
 import {
   createServer
-} from "./chunk-PTFVEYUX.js";
+} from "./chunk-7I65IXVU.js";
 import {
   loadConfig
-} from "./chunk-NIAAHWRF.js";
-import "./chunk-4EDC2P3J.js";
-import "./chunk-7UO3EGDB.js";
+} from "./chunk-LVX5TOYA.js";
+import "./chunk-LUAJVZVZ.js";
+import "./chunk-5M4PP6P4.js";
 export {
   createServer,
   loadConfig

package/dist/{intelligence-service-ASXADXLF.js → intelligence-service-RSRWDBHS.js}

@@ -1,7 +1,7 @@
 import {
   IntelligenceService
-} from "./chunk-4EDC2P3J.js";
-import "./chunk-7UO3EGDB.js";
+} from "./chunk-LUAJVZVZ.js";
+import "./chunk-5M4PP6P4.js";
 export {
   IntelligenceService
 };

package/dist/mcp.js

@@ -2,8 +2,8 @@ import {
   CliError,
   canonryMcpTools,
   createApiClient
-} from "./chunk-NIAAHWRF.js";
-import "./chunk-7UO3EGDB.js";
+} from "./chunk-LVX5TOYA.js";
+import "./chunk-5M4PP6P4.js";
 
 // src/mcp/cli.ts
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ainyc/canonry",
-  "version": "4.30.0",
+  "version": "4.32.0",
   "type": "module",
   "description": "Agent-first open-source AEO operating platform - track how answer engines cite your domain",
   "license": "FSL-1.1-ALv2",
@@ -15,6 +15,7 @@
   },
   "bin": {
     "canonry": "./bin/canonry.mjs",
+    "cnry": "./bin/canonry.mjs",
     "canonry-mcp": "./bin/canonry-mcp.mjs"
   },
   "exports": {
@@ -59,23 +60,23 @@
     "@types/node-cron": "^3.0.11",
     "tsup": "^8.5.1",
     "tsx": "^4.19.0",
-    "@ainyc/canonry-api-routes": "0.0.0",
     "@ainyc/canonry-config": "0.0.0",
-    "@ainyc/canonry-contracts": "0.0.0",
+    "@ainyc/canonry-api-routes": "0.0.0",
     "@ainyc/canonry-db": "0.0.0",
     "@ainyc/canonry-integration-bing": "0.0.0",
     "@ainyc/canonry-intelligence": "0.0.0",
+    "@ainyc/canonry-integration-cloud-run": "0.0.0",
     "@ainyc/canonry-integration-commoncrawl": "0.0.0",
     "@ainyc/canonry-integration-google": "0.0.0",
     "@ainyc/canonry-integration-traffic": "0.0.0",
-    "@ainyc/canonry-integration-cloud-run": "0.0.0",
     "@ainyc/canonry-integration-wordpress": "0.0.0",
-    "@ainyc/canonry-provider-claude": "0.0.0",
+    "@ainyc/canonry-contracts": "0.0.0",
     "@ainyc/canonry-provider-cdp": "0.0.0",
+    "@ainyc/canonry-provider-gemini": "0.0.0",
     "@ainyc/canonry-provider-local": "0.0.0",
+    "@ainyc/canonry-provider-claude": "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-provider-perplexity": "0.0.0"
   },
   "scripts": {
     "build": "tsx scripts/copy-agent-assets.ts && tsup && tsx build-web.ts",