npm - @ainyc/canonry - Versions diffs - 4.30.0 → 4.31.0 - Mend

@ainyc/canonry 4.30.0 → 4.31.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (25) hide show

package/assets/index.html CHANGED Viewed

@@ -12,8 +12,8 @@
     <link rel="icon" type="image/png" sizes="32x32" href="./favicon-32.png" />
     <link rel="apple-touch-icon" href="./apple-touch-icon.png" />
     <title>Canonry</title>
-    <script type="module" crossorigin src="./assets/index-BYiZYtd9.js"></script>
-    <link rel="stylesheet" crossorigin href="./assets/index-BnALDZI7.css">
+    <script type="module" crossorigin src="./assets/index-C4UBTDDS.js"></script>
+    <link rel="stylesheet" crossorigin href="./assets/index-CNKAwZMB.css">
   </head>
   <body>
     <div id="root"></div>

package/dist/{chunk-NIAAHWRF.js → chunk-5STLZRGB.js} RENAMED Viewed

@@ -4,6 +4,7 @@ import {
   DISCOVERY_MAX_PROBES_CAP,
   competitorBatchRequestSchema,
   discoveryBucketSchema,
+  discoveryCompetitorTypeSchema,
   discoveryPromoteRequestSchema,
   discoveryRunRequestSchema,
   keywordBatchRequestSchema,
@@ -20,7 +21,7 @@ import {
   trafficConnectCloudRunRequestSchema,
   trafficConnectWordpressRequestSchema,
   trafficEventKindSchema
-} from "./chunk-7UO3EGDB.js";
+} from "./chunk-HTNC6AWN.js";
 // src/config.ts
 import fs from "fs";
@@ -1287,7 +1288,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 = [
@@ -2242,7 +2244,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/{chunk-7UO3EGDB.js → chunk-HTNC6AWN.js} RENAMED Viewed

@@ -2382,11 +2382,29 @@ var DEFAULT_DISCOVERY_PROMOTE_BUCKETS = [
 ];
 var DISCOVERY_PROMOTE_COMPETITOR_CAP = 20;
 var DISCOVERY_PROMOTE_COMPETITOR_MIN_HITS = 2;
+var discoveryCompetitorTypeSchema = z21.enum([
+  "direct-competitor",
+  "ota-aggregator",
+  "editorial-media",
+  "other",
+  "unknown"
+]);
+var DiscoveryCompetitorTypes = discoveryCompetitorTypeSchema.enum;
+var DEFAULT_DISCOVERY_PROMOTE_COMPETITOR_TYPES = [
+  DiscoveryCompetitorTypes["direct-competitor"]
+];
 var discoverySessionStatusSchema = z21.enum(["queued", "seeding", "probing", "completed", "failed"]);
 var DiscoverySessionStatuses = discoverySessionStatusSchema.enum;
 var discoveryCompetitorMapEntrySchema = z21.object({
   domain: z21.string().min(1),
-  hits: z21.number().int().positive()
+  hits: z21.number().int().positive(),
+  /**
+   * Domain classification from the session's post-probe AI classification
+   * pass. Defaults to `unknown` so competitor maps persisted before
+   * classification existed (or by a session whose classification call failed)
+   * still parse — those entries are excluded from the default promote filter.
+   */
+  competitorType: discoveryCompetitorTypeSchema.default("unknown")
 });
 var discoveryProbeDtoSchema = z21.object({
   id: z21.string(),
@@ -2428,7 +2446,8 @@ var discoveryRunRequestSchema = z21.object({
 });
 var discoveryPromoteRequestSchema = z21.object({
   buckets: z21.array(discoveryBucketSchema).min(1).optional(),
-  includeCompetitors: z21.boolean().optional()
+  includeCompetitors: z21.boolean().optional(),
+  competitorTypes: z21.array(discoveryCompetitorTypeSchema).min(1).optional()
 });
 var discoveryPromotePreviewSchema = z21.object({
   sessionId: z21.string(),
@@ -2693,6 +2712,9 @@ export {
   DEFAULT_DISCOVERY_PROMOTE_BUCKETS,
   DISCOVERY_PROMOTE_COMPETITOR_CAP,
   DISCOVERY_PROMOTE_COMPETITOR_MIN_HITS,
+  discoveryCompetitorTypeSchema,
+  DiscoveryCompetitorTypes,
+  DEFAULT_DISCOVERY_PROMOTE_COMPETITOR_TYPES,
   DiscoverySessionStatuses,
   DISCOVERY_MAX_PROBES_CAP,
   discoveryRunRequestSchema,

package/dist/{chunk-PTFVEYUX.js → chunk-PUTJHEVR.js} RENAMED Viewed

@@ -5,7 +5,7 @@ import {
   loadConfig,
   loadConfigRaw,
   saveConfigPatch
-} from "./chunk-NIAAHWRF.js";
+} from "./chunk-5STLZRGB.js";
 import {
   DEFAULT_RUN_HISTORY_LIMIT,
   IntelligenceService,
@@ -70,7 +70,7 @@ import {
   schedules,
   trafficSources,
   usageCounters
-} from "./chunk-4EDC2P3J.js";
+} from "./chunk-U3YKRV47.js";
 import {
   AGENT_MEMORY_VALUE_MAX_BYTES,
   AGENT_PROVIDER_IDS,
@@ -82,9 +82,11 @@ import {
   CheckStatuses,
   CitationStates,
   DEFAULT_DISCOVERY_PROMOTE_BUCKETS,
+  DEFAULT_DISCOVERY_PROMOTE_COMPETITOR_TYPES,
   DISCOVERY_PROMOTE_COMPETITOR_CAP,
   DISCOVERY_PROMOTE_COMPETITOR_MIN_HITS,
   DiscoveryBuckets,
+  DiscoveryCompetitorTypes,
   DiscoverySessionStatuses,
   MemorySources,
   RunKinds,
@@ -175,7 +177,7 @@ import {
   visibilityStateFromAnswerMentioned,
   windowCutoff,
   wordpressEnvSchema
-} from "./chunk-7UO3EGDB.js";
+} from "./chunk-HTNC6AWN.js";
 // src/telemetry.ts
 import crypto from "crypto";
@@ -10425,7 +10427,7 @@ var routeCatalog = [
     method: "post",
     path: "/api/v1/projects/{name}/discover/sessions/{id}/promote",
     summary: "Promote a discovery session into the tracked basket",
-    description: 'Adopts a completed session\'s bucketed queries into the project\'s tracked basket, tagged with `provenance="discovery:<sessionId>"`. By default, only `cited` and `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` rather than inserted twice. Only sessions with `status: "completed"` can be promoted.',
+    description: 'Adopts a completed session\'s bucketed queries into the project\'s tracked basket, tagged with `provenance="discovery:<sessionId>"`. By default, only `cited` and `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 `competitorTypes` to adopt other classified types or to recover legacy `unknown` entries. Add-only and idempotent: queries/domains already tracked are returned under `skipped` rather than inserted twice. Only sessions with `status: "completed"` can be promoted.',
     tags: ["discovery"],
     parameters: [
       nameParameter,
@@ -10446,6 +10448,14 @@ var routeCatalog = [
               includeCompetitors: {
                 type: "boolean",
                 description: "Whether to also merge recurring discovered competitor domains. Defaults to true."
+              },
+              competitorTypes: {
+                type: "array",
+                items: {
+                  type: "string",
+                  enum: ["direct-competitor", "ota-aggregator", "editorial-media", "other", "unknown"]
+                },
+                description: "Which classified competitor types to merge. Omitted means direct-competitor only. Ignored when includeCompetitors is false."
               }
             }
           }
@@ -19725,7 +19735,7 @@ async function discoveryRoutes(app, opts) {
         else if (bucket === DiscoveryBuckets.aspirational) aspirational.add(probe.query);
         else if (bucket === DiscoveryBuckets["wasted-surface"]) wasted.add(probe.query);
       }
-      const competitorMap = parseJsonColumn(session.competitorMap, []);
+      const competitorMap = parseCompetitorMap(session.competitorMap);
       const newCompetitors = selectEligibleCompetitors(competitorMap).filter((entry) => !seenCompetitors.has(entry.domain.toLowerCase()));
       return reply.send({
         sessionId: session.id,
@@ -19764,6 +19774,7 @@ async function discoveryRoutes(app, opts) {
     const buckets = parsed.data.buckets ?? DEFAULT_DISCOVERY_PROMOTE_BUCKETS;
     const bucketSet = new Set(buckets);
     const includeCompetitors = parsed.data.includeCompetitors ?? true;
+    const competitorTypes = parsed.data.competitorTypes ?? DEFAULT_DISCOVERY_PROMOTE_COMPETITOR_TYPES;
     const probeRows = app.db.select().from(discoveryProbes).where(eq25(discoveryProbes.sessionId, session.id)).all();
     const candidateQueries = /* @__PURE__ */ new Set();
     for (const probe of probeRows) {
@@ -19790,8 +19801,8 @@ async function discoveryRoutes(app, opts) {
       const existingCompetitors = new Set(
         app.db.select({ domain: competitors.domain }).from(competitors).where(eq25(competitors.projectId, project.id)).all().map((r) => r.domain.toLowerCase())
       );
-      const competitorMap = parseJsonColumn(session.competitorMap, []);
-      for (const entry of selectEligibleCompetitors(competitorMap)) {
+      const competitorMap = parseCompetitorMap(session.competitorMap);
+      for (const entry of selectEligibleCompetitors(competitorMap, competitorTypes)) {
         const key = entry.domain.toLowerCase();
         if (existingCompetitors.has(key)) {
           skippedCompetitors.push(entry.domain);
@@ -19856,7 +19867,7 @@ function serializeSession(row) {
     citedCount: row.citedCount ?? null,
     aspirationalCount: row.aspirationalCount ?? null,
     wastedCount: row.wastedCount ?? null,
-    competitorMap: parseJsonColumn(row.competitorMap, []),
+    competitorMap: parseCompetitorMap(row.competitorMap),
     error: row.error ?? null,
     startedAt: row.startedAt ?? null,
     finishedAt: row.finishedAt ?? null,
@@ -19877,8 +19888,20 @@ function serializeProbe(row) {
     createdAt: row.createdAt
   };
 }
-function selectEligibleCompetitors(competitorMap) {
-  return competitorMap.filter((entry) => entry.hits >= DISCOVERY_PROMOTE_COMPETITOR_MIN_HITS).sort((a, b) => b.hits - a.hits || a.domain.localeCompare(b.domain)).slice(0, DISCOVERY_PROMOTE_COMPETITOR_CAP);
+function parseCompetitorMap(json) {
+  const raw = parseJsonColumn(
+    json,
+    []
+  );
+  return raw.map((entry) => ({
+    domain: entry.domain,
+    hits: entry.hits,
+    competitorType: entry.competitorType ?? DiscoveryCompetitorTypes.unknown
+  }));
+}
+function selectEligibleCompetitors(competitorMap, competitorTypes) {
+  const typeFilter = competitorTypes ? new Set(competitorTypes) : null;
+  return competitorMap.filter((entry) => entry.hits >= DISCOVERY_PROMOTE_COMPETITOR_MIN_HITS).filter((entry) => !typeFilter || typeFilter.has(entry.competitorType)).sort((a, b) => b.hits - a.hits || a.domain.localeCompare(b.domain)).slice(0, DISCOVERY_PROMOTE_COMPETITOR_CAP);
 }
 // ../api-routes/src/discovery/orchestrate.ts
@@ -19895,7 +19918,7 @@ function classifyProbeBucket(input) {
   if (competitorHit) return DiscoveryBuckets["wasted-surface"];
   return DiscoveryBuckets.aspirational;
 }
-function buildCompetitorMap(probes, project) {
+function buildCompetitorMap(probes, project, classification = {}) {
   const canonical = new Set(project.canonicalDomains.map((d) => d.toLowerCase()));
   const counts = /* @__PURE__ */ new Map();
   for (const probe of probes) {
@@ -19908,7 +19931,19 @@ function buildCompetitorMap(probes, project) {
       counts.set(domain, (counts.get(domain) ?? 0) + 1);
     }
   }
-  return Array.from(counts.entries()).map(([domain, hits]) => ({ domain, hits })).sort((a, b) => b.hits - a.hits || a.domain.localeCompare(b.domain));
+  return Array.from(counts.entries()).map(([domain, hits]) => ({
+    domain,
+    hits,
+    competitorType: classification[domain] ?? DiscoveryCompetitorTypes.unknown
+  })).sort((a, b) => b.hits - a.hits || a.domain.localeCompare(b.domain));
+}
+async function classifyCompetitorDomains(deps, project, icpDescription, domains) {
+  if (domains.length === 0) return {};
+  try {
+    return await deps.classifyDomains({ project, icpDescription, domains });
+  } catch {
+    return {};
+  }
 }
 async function pickCanonicals(candidates, deps, dedupThreshold) {
   if (candidates.length === 0) return [];
@@ -19969,7 +20004,14 @@ async function executeDiscovery(opts) {
       createdAt: (/* @__PURE__ */ new Date()).toISOString()
     }).run();
   }
-  const competitorMap = buildCompetitorMap(probeRows, opts.project);
+  const domains = buildCompetitorMap(probeRows, opts.project).map((entry) => entry.domain);
+  const classification = await classifyCompetitorDomains(
+    opts.deps,
+    opts.project,
+    opts.icpDescription,
+    domains
+  );
+  const competitorMap = buildCompetitorMap(probeRows, opts.project, classification);
   opts.db.update(discoverySessions).set({
     status: DiscoverySessionStatuses.completed,
     probeCount: probedCanonicals.length,
@@ -24560,9 +24602,84 @@ function buildDefaultDeps(registry) {
         citedDomains: normalized.citedDomains,
         rawResponse: raw.rawResponse
       };
+    },
+    async classifyDomains(input) {
+      const prompt = buildClassificationPrompt(input);
+      const text = await adapter.generateText(prompt, cfg);
+      return parseClassificationResponse(text, input.domains);
     }
   };
 }
+var CLASSIFICATION_CATEGORIES = [
+  DiscoveryCompetitorTypes["direct-competitor"],
+  DiscoveryCompetitorTypes["ota-aggregator"],
+  DiscoveryCompetitorTypes["editorial-media"],
+  DiscoveryCompetitorTypes.other
+];
+var CLASSIFICATION_CATEGORY_MATCHERS = CLASSIFICATION_CATEGORIES.map((category) => ({
+  category,
+  pattern: new RegExp(`(?<![a-z0-9])${category}(?![a-z0-9])`)
+}));
+function buildClassificationPrompt(input) {
+  const tracked = input.project.competitorDomains.length > 0 ? input.project.competitorDomains.join(", ") : "none";
+  return [
+    "You are an AEO (Answer Engine Optimization) analyst classifying the domains that AI answer engines cited for a customer's tracked queries.",
+    "",
+    `Customer: ${input.project.name} (own domains: ${input.project.canonicalDomains.join(", ")})`,
+    `ICP: ${input.icpDescription}`,
+    `Already-tracked competitors: ${tracked}`,
+    "",
+    "Classify EACH domain below into exactly one category:",
+    " - direct-competitor: a business competing directly with the customer for the same customers (another company in the same category). Every already-tracked competitor above is a direct-competitor.",
+    " - ota-aggregator: online travel agencies, marketplaces, directories, booking platforms, or review aggregators that list many businesses (e.g. expedia.com, booking.com, tripadvisor.com, yelp.com, g2.com).",
+    ' - editorial-media: news sites, magazines, blogs, or "best of" listicle / round-up articles (e.g. timeout.com, nytimes.com, personal blogs).',
+    " - other: anything else \u2014 government sites, social media, the customer itself, or domains unrelated to the competitive space.",
+    "",
+    "Domains:",
+    ...input.domains,
+    "",
+    "Return ONE line per domain in EXACTLY this format:",
+    "<domain> => <category>",
+    "",
+    "Plain text only. No numbering, bullets, commentary, or markdown."
+  ].join("\n");
+}
+function parseClassificationResponse(text, domains) {
+  const lines = text.split("\n").map((l) => l.trim().toLowerCase()).filter(Boolean);
+  const result = {};
+  for (const domain of domains) {
+    const key = domain.toLowerCase();
+    const line = lines.find((l) => startsWithDomainToken(l, key)) ?? lines.find((l) => containsDomainToken(l, key));
+    if (!line) continue;
+    const category = extractClassificationCategory(line);
+    if (category) result[domain] = category;
+  }
+  return result;
+}
+function isDomainChar(ch) {
+  return /[a-z0-9.-]/.test(ch);
+}
+function startsWithDomainToken(line, domain) {
+  return line.startsWith(domain) && !isDomainChar(line[domain.length] ?? "");
+}
+function containsDomainToken(line, domain) {
+  let idx = line.indexOf(domain);
+  while (idx !== -1) {
+    const before = line[idx - 1] ?? "";
+    const after = line[idx + domain.length] ?? "";
+    if (!isDomainChar(before) && !isDomainChar(after)) return true;
+    idx = line.indexOf(domain, idx + 1);
+  }
+  return false;
+}
+function extractClassificationCategory(line) {
+  const arrowIdx = line.indexOf("=>");
+  const haystack = arrowIdx >= 0 ? line.slice(arrowIdx + 2) : line;
+  for (const { category, pattern } of CLASSIFICATION_CATEGORY_MATCHERS) {
+    if (pattern.test(haystack)) return category;
+  }
+  return null;
+}
 function buildSeedPrompt(input) {
   return [
     "You are an AEO (Answer Engine Optimization) analyst expanding a tracked-query basket for a customer.",

package/dist/{chunk-4EDC2P3J.js → chunk-U3YKRV47.js} RENAMED Viewed

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

package/dist/cli.js CHANGED Viewed

@@ -20,7 +20,7 @@ import {
   setTelemetrySource,
   showFirstRunNotice,
   trackEvent
-} from "./chunk-PTFVEYUX.js";
+} from "./chunk-PUTJHEVR.js";
 import {
   CliError,
   EXIT_SYSTEM_ERROR,
@@ -36,7 +36,7 @@ import {
   saveConfig,
   saveConfigPatch,
   usageError
-} from "./chunk-NIAAHWRF.js";
+} from "./chunk-5STLZRGB.js";
 import {
   apiKeys,
   competitors,
@@ -49,7 +49,7 @@ import {
   queries,
   querySnapshots,
   runs
-} from "./chunk-4EDC2P3J.js";
+} from "./chunk-U3YKRV47.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-HTNC6AWN.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-CJONZ7ST.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
       });
@@ -11293,9 +11334,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 +11384,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 +11435,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.js CHANGED Viewed

@@ -1,11 +1,11 @@
 import {
   createServer
-} from "./chunk-PTFVEYUX.js";
+} from "./chunk-PUTJHEVR.js";
 import {
   loadConfig
-} from "./chunk-NIAAHWRF.js";
-import "./chunk-4EDC2P3J.js";
-import "./chunk-7UO3EGDB.js";
+} from "./chunk-5STLZRGB.js";
+import "./chunk-U3YKRV47.js";
+import "./chunk-HTNC6AWN.js";
 export {
   createServer,
   loadConfig

package/dist/{intelligence-service-ASXADXLF.js → intelligence-service-CJONZ7ST.js} RENAMED Viewed

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

package/dist/mcp.js CHANGED Viewed

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

package/package.json CHANGED Viewed

@@ -1,6 +1,6 @@
 {
   "name": "@ainyc/canonry",
-  "version": "4.30.0",
+  "version": "4.31.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": {
@@ -62,20 +63,20 @@
     "@ainyc/canonry-api-routes": "0.0.0",
     "@ainyc/canonry-config": "0.0.0",
     "@ainyc/canonry-contracts": "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-commoncrawl": "0.0.0",
+    "@ainyc/canonry-integration-bing": "0.0.0",
+    "@ainyc/canonry-integration-cloud-run": "0.0.0",
+    "@ainyc/canonry-db": "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-commoncrawl": "0.0.0",
     "@ainyc/canonry-integration-wordpress": "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-openai": "0.0.0",
+    "@ainyc/canonry-provider-gemini": "0.0.0",
     "@ainyc/canonry-provider-perplexity": "0.0.0",
-    "@ainyc/canonry-provider-gemini": "0.0.0"
+    "@ainyc/canonry-provider-claude": "0.0.0"
   },
   "scripts": {
     "build": "tsx scripts/copy-agent-assets.ts && tsup && tsx build-web.ts",