@ainyc/canonry 4.106.2 → 4.108.0

package/assets/assets/{trash-2-C9Ebw5p4.js → trash-2-BODtOdNo.js}

@@ -1 +1 @@
-import{c}from"./index-Dr2rxkFR.js";const a=[["circle",{cx:"12",cy:"12",r:"10",key:"1mglay"}],["path",{d:"m9 12 2 2 4-4",key:"dzmm74"}]],h=c("circle-check",a);const e=[["circle",{cx:"12",cy:"12",r:"10",key:"1mglay"}],["path",{d:"M9.09 9a3 3 0 0 1 5.83 1c0 2-3 3-3 3",key:"1u773s"}],["path",{d:"M12 17h.01",key:"p32p05"}]],n=c("circle-question-mark",e);const o=[["path",{d:"M12 15V3",key:"m9g1x1"}],["path",{d:"M21 15v4a2 2 0 0 1-2 2H5a2 2 0 0 1-2-2v-4",key:"ih7n3h"}],["path",{d:"m7 10 5 5 5-5",key:"brsn70"}]],s=c("download",o);const t=[["path",{d:"M10 11v6",key:"nco0om"}],["path",{d:"M14 11v6",key:"outv1u"}],["path",{d:"M19 6v14a2 2 0 0 1-2 2H7a2 2 0 0 1-2-2V6",key:"miytrc"}],["path",{d:"M3 6h18",key:"d0wm0j"}],["path",{d:"M8 6V4a2 2 0 0 1 2-2h4a2 2 0 0 1 2 2v2",key:"e791ji"}]],r=c("trash-2",t);export{h as C,s as D,r as T,n as a};
+import{c}from"./index-imKX6Edq.js";const a=[["circle",{cx:"12",cy:"12",r:"10",key:"1mglay"}],["path",{d:"m9 12 2 2 4-4",key:"dzmm74"}]],h=c("circle-check",a);const e=[["circle",{cx:"12",cy:"12",r:"10",key:"1mglay"}],["path",{d:"M9.09 9a3 3 0 0 1 5.83 1c0 2-3 3-3 3",key:"1u773s"}],["path",{d:"M12 17h.01",key:"p32p05"}]],n=c("circle-question-mark",e);const o=[["path",{d:"M12 15V3",key:"m9g1x1"}],["path",{d:"M21 15v4a2 2 0 0 1-2 2H5a2 2 0 0 1-2-2v-4",key:"ih7n3h"}],["path",{d:"m7 10 5 5 5-5",key:"brsn70"}]],s=c("download",o);const t=[["path",{d:"M10 11v6",key:"nco0om"}],["path",{d:"M14 11v6",key:"outv1u"}],["path",{d:"M19 6v14a2 2 0 0 1-2 2H7a2 2 0 0 1-2-2V6",key:"miytrc"}],["path",{d:"M3 6h18",key:"d0wm0j"}],["path",{d:"M8 6V4a2 2 0 0 1 2-2h4a2 2 0 0 1 2 2v2",key:"e791ji"}]],r=c("trash-2",t);export{h as C,s as D,r as T,n as a};

package/assets/index.html

@@ -12,7 +12,7 @@
     <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-Dr2rxkFR.js"></script>
+    <script type="module" crossorigin src="./assets/index-imKX6Edq.js"></script>
     <link rel="modulepreload" crossorigin href="./assets/vendor-tanstack-Be8JdV5M.js">
     <link rel="modulepreload" crossorigin href="./assets/vendor-radix-CQ77EO2y.js">
     <link rel="modulepreload" crossorigin href="./assets/vendor-recharts-C9EZkgbP.js">

package/dist/{chunk-F3MKVMS5.js → chunk-45YSA7GH.js}

@@ -125,6 +125,7 @@ import {
   emptyCitationVisibility,
   escapeLikePattern,
   extractAnswerMentions,
+  filterBrandedSeedCandidates,
   findDuplicateLocationLabels,
   forbidden,
   formatAverageDelta,
@@ -183,6 +184,7 @@ import {
   notFound,
   notImplemented,
   notificationDtoSchema,
+  orderLocationsDefaultFirst,
   parseInclusiveEndMs,
   parseReportPeriodDays,
   parseRunError,
@@ -267,10 +269,10 @@ import {
   wordpressSchemaDeployResultDtoSchema,
   wordpressSchemaStatusResultDtoSchema,
   wordpressStatusDtoSchema
-} from "./chunk-VOR5ZTUU.js";
+} from "./chunk-IQX7XXJN.js";
 
 // src/intelligence-service.ts
-import { eq as eq38, desc as desc18, asc as asc6, and as and28, ne as ne5, or as or5, inArray as inArray14, gte as gte7, lte as lte4 } from "drizzle-orm";
+import { eq as eq38, desc as desc18, asc as asc6, and as and28, ne as ne5, or as or6, inArray as inArray14, gte as gte7, lte as lte4 } from "drizzle-orm";
 
 // ../db/src/client.ts
 import { mkdirSync } from "fs";
@@ -1141,6 +1143,15 @@ var discoverySessions = sqliteTable("discovery_sessions", {
   // seed time; nullable for legacy sessions. No gate/warning math reads these.
   seedFromAnswerCount: integer("seed_from_answer_count"),
   seedFromGroundingCount: integer("seed_from_grounding_count"),
+  // Diagnostics: raw candidates dropped by the branded self-query filter
+  // before seed_count_raw was recorded. Nullable for legacy sessions.
+  seedBrandFilteredCount: integer("seed_brand_filtered_count"),
+  // Buyer definition the session was seeded with; part of session identity
+  // for in-flight consolidation (same ICP + different buyer never reuses).
+  buyerDescription: text("buyer_description"),
+  // Resolved service areas the session was seeded/probed with; part of session
+  // identity for in-flight consolidation. Null on legacy sessions.
+  locations: text("locations", { mode: "json" }).$type(),
   dedupThreshold: real("dedup_threshold"),
   probeCount: integer("probe_count"),
   citedCount: integer("cited_count"),
@@ -3390,6 +3401,37 @@ var MIGRATION_VERSIONS = [
       `ALTER TABLE discovery_sessions ADD COLUMN seed_from_answer_count INTEGER`,
       `ALTER TABLE discovery_sessions ADD COLUMN seed_from_grounding_count INTEGER`
     ]
+  },
+  {
+    version: 89,
+    name: "discovery-session-brand-filter-count",
+    statements: [
+      // Diagnostics: raw candidates dropped by the branded self-query filter
+      // before seed_count_raw was recorded. Nullable — legacy sessions stay
+      // null. Idempotent (the runner swallows the duplicate-column error).
+      `ALTER TABLE discovery_sessions ADD COLUMN seed_brand_filtered_count INTEGER`
+    ]
+  },
+  {
+    version: 90,
+    name: "discovery-session-buyer-description",
+    statements: [
+      // Buyer definition the session was seeded with. Part of the in-flight
+      // consolidation identity (a request with a different buyer must never
+      // reuse another buyer's session) and auditability for seed provenance.
+      `ALTER TABLE discovery_sessions ADD COLUMN buyer_description TEXT`
+    ]
+  },
+  {
+    version: 91,
+    name: "discovery-session-locations",
+    statements: [
+      // Resolved service areas the session was seeded/probed with. Part of the
+      // in-flight consolidation identity (a different location subset never
+      // reuses another geo's session) and seed/probe provenance. Nullable —
+      // legacy sessions stay null.
+      `ALTER TABLE discovery_sessions ADD COLUMN locations TEXT`
+    ]
   }
 ];
 function rebuildBacklinkTableWithSource(tx, table) {
@@ -3582,7 +3624,7 @@ function getAppliedVersion(db) {
 function recordMigration(db, version, name) {
   db.run(sql`INSERT OR IGNORE INTO _migrations (version, name) VALUES (${version}, ${name})`);
 }
-function migrate(db) {
+function migrate(db, versions = MIGRATION_VERSIONS) {
   db.transaction((tx) => {
     normalizeLegacyQuerySchema(tx);
   });
@@ -3591,7 +3633,7 @@ function migrate(db) {
     db.run(sql.raw(statement));
   }
   const appliedVersion = getAppliedVersion(db);
-  for (const mv of MIGRATION_VERSIONS) {
+  for (const mv of versions) {
     if (mv.version <= appliedVersion) continue;
     db.transaction((tx) => {
       for (const statement of mv.statements) {
@@ -18056,6 +18098,7 @@ var routeCatalog = [
             type: "object",
             properties: {
               icpDescription: { type: "string", description: "Free-text ICP. Required if the project does not have spec.icpDescription stored." },
+              buyerDescription: { type: "string", description: "Who evaluates or buys the offering, separate from the ICP. When present, every generated seed query is anchored on this buyer and the seed prompt enforces buyer-fit." },
               dedupThreshold: { type: "number", description: "Cosine similarity threshold for clustering. Defaults to 0.95." },
               maxProbes: { type: "integer", description: "Max canonical queries to probe in this session. Default 100, hard cap 500." },
               probeConcurrency: {
@@ -33729,7 +33772,7 @@ async function doctorRoutes(app, opts) {
 
 // ../api-routes/src/discovery/routes.ts
 import crypto27 from "crypto";
-import { and as and26, desc as desc16, eq as eq35, gte as gte6, inArray as inArray12 } from "drizzle-orm";
+import { and as and26, desc as desc16, eq as eq35, gte as gte6, inArray as inArray12, isNull, or as or5 } from "drizzle-orm";
 var MAX_INFLIGHT_DISCOVERY_AGE_MS = 2 * 60 * 60 * 1e3;
 async function discoveryRoutes(app, opts) {
   app.post("/projects/:name/discover/run", async (request, reply) => {
@@ -33749,9 +33792,9 @@ async function discoveryRoutes(app, opts) {
         "icpDescription is required. Pass it in the request body or store it on the project (spec.icpDescription)."
       );
     }
-    const locations = resolveLocations(
-      project.locations,
-      parsed.data.locations
+    const locations = orderLocationsDefaultFirst(
+      resolveLocations(project.locations, parsed.data.locations),
+      project.defaultLocation
     );
     if (!opts.onDiscoveryRunRequested) {
       throw validationError("Discovery is not available on this deployment.", {
@@ -33764,6 +33807,20 @@ async function discoveryRoutes(app, opts) {
       const existing = tx.select({ id: discoverySessions.id, runId: discoverySessions.runId }).from(discoverySessions).where(and26(
         eq35(discoverySessions.projectId, project.id),
         eq35(discoverySessions.icpDescription, icpDescription),
+        // Buyer is part of session identity: it changes the seed prompt's
+        // semantics, so a request with a different (or no) buyer must start
+        // its own session, never adopt another buyer's probes.
+        parsed.data.buyerDescription == null ? isNull(discoverySessions.buyerDescription) : eq35(discoverySessions.buyerDescription, parsed.data.buyerDescription),
+        // Locations are identity too: a different service-area subset seeds
+        // and probes a different geo, so it must never reuse another geo's
+        // session. resolveLocations is deterministic (project-config order),
+        // so equal subsets always serialize identically. Legacy in-flight
+        // rows (pre-91) carry NULL: on a NO-location project that geo is
+        // unambiguous (always []), so NULL matches; on a project WITH
+        // locations a NULL row's subset is unknowable, so it conservatively
+        // never reuses — a one-time, bounded (2h window) non-reuse after
+        // upgrade, never a wrong reuse.
+        locations.length === 0 ? or5(isNull(discoverySessions.locations), eq35(discoverySessions.locations, locations)) : eq35(discoverySessions.locations, locations),
         inArray12(discoverySessions.status, [
           DiscoverySessionStatuses.queued,
           DiscoverySessionStatuses.seeding,
@@ -33782,6 +33839,8 @@ async function discoveryRoutes(app, opts) {
         runId,
         status: DiscoverySessionStatuses.queued,
         icpDescription,
+        buyerDescription: parsed.data.buyerDescription ?? null,
+        locations,
         dedupThreshold: parsed.data.dedupThreshold,
         competitorMap: [],
         createdAt: now
@@ -33816,6 +33875,7 @@ async function discoveryRoutes(app, opts) {
       sessionId: decision.sessionId,
       projectId: project.id,
       icpDescription,
+      buyerDescription: parsed.data.buyerDescription,
       dedupThreshold: parsed.data.dedupThreshold,
       maxProbes: parsed.data.maxProbes,
       probeConcurrency: parsed.data.probeConcurrency,
@@ -34070,6 +34130,9 @@ function serializeSession(row) {
     seedCount: row.seedCount ?? null,
     seedFromAnswerCount: row.seedFromAnswerCount ?? null,
     seedFromGroundingCount: row.seedFromGroundingCount ?? null,
+    seedBrandFilteredCount: row.seedBrandFilteredCount ?? null,
+    buyerDescription: row.buyerDescription ?? null,
+    locations: row.locations ?? null,
     dedupThreshold: row.dedupThreshold ?? null,
     probeCount: row.probeCount ?? null,
     citedCount: row.citedCount ?? null,
@@ -34176,9 +34239,15 @@ async function executeDiscovery(opts) {
   const seedResult = await opts.deps.seed({
     project: opts.project,
     icpDescription: opts.icpDescription,
+    buyerDescription: opts.buyerDescription,
     locations: opts.locations ?? []
   });
-  const rawCandidates = dedupeStrings(seedResult.candidates);
+  const { kept: unbrandedCandidates, droppedBranded } = filterBrandedSeedCandidates({
+    candidates: seedResult.candidates,
+    brandNames: opts.project.brandNames ?? [],
+    canonicalDomains: opts.project.canonicalDomains
+  });
+  const rawCandidates = dedupeStrings(unbrandedCandidates);
   const seedCountRaw = rawCandidates.length;
   const canonicals = await pickCanonicals(
     rawCandidates,
@@ -34201,12 +34270,14 @@ async function executeDiscovery(opts) {
     // the seed dep does not report the split. Not consumed by any gate.
     seedFromAnswerCount: seedResult.fromAnswerCount ?? null,
     seedFromGroundingCount: seedResult.fromGroundingCount ?? null,
+    seedBrandFilteredCount: droppedBranded.length,
     warning
   }).where(eq36(discoverySessions.id, opts.sessionId)).run();
+  const probeLocation = opts.locations?.[0];
   const probeResults = await mapWithConcurrency(
     probedCanonicals,
     probeConcurrency,
-    (query) => opts.deps.probe({ project: opts.project, query })
+    (query) => opts.deps.probe({ project: opts.project, query, location: probeLocation })
   );
   const probeRows = [];
   const buckets = { cited: 0, aspirational: 0, "wasted-surface": 0 };
@@ -35025,7 +35096,7 @@ var IntelligenceService = class {
     const recentRuns = this.db.select().from(runs).where(
       and28(
         eq38(runs.projectId, projectId),
-        or5(eq38(runs.status, "completed"), eq38(runs.status, "partial")),
+        or6(eq38(runs.status, "completed"), eq38(runs.status, "partial")),
         // Defensive: RunCoordinator already skips probes before this is
         // called, but if a future call site invokes analyzeAndPersist
         // directly for a probe, probes still must not pollute the
@@ -35328,7 +35399,7 @@ var IntelligenceService = class {
     const allRuns = this.db.select().from(runs).where(
       and28(
         eq38(runs.projectId, project.id),
-        or5(eq38(runs.status, "completed"), eq38(runs.status, "partial")),
+        or6(eq38(runs.status, "completed"), eq38(runs.status, "partial")),
         // Backfill must not replay probe runs as if they were real sweeps.
         ne5(runs.trigger, RunTriggers.probe)
       )
@@ -35506,7 +35577,7 @@ var IntelligenceService = class {
       and28(
         eq38(runs.projectId, projectId),
         eq38(runs.kind, RunKinds["answer-visibility"]),
-        or5(eq38(runs.status, "completed"), eq38(runs.status, "partial")),
+        or6(eq38(runs.status, "completed"), eq38(runs.status, "partial")),
         // Defensive — see top of file.
         ne5(runs.trigger, RunTriggers.probe)
       )

package/dist/{chunk-VGMTLUUM.js → chunk-EKGKGKID.js}

@@ -25,7 +25,7 @@ import {
   trafficConnectVercelRequestSchema,
   trafficConnectWordpressRequestSchema,
   trafficEventKindSchema
-} from "./chunk-VOR5ZTUU.js";
+} from "./chunk-IQX7XXJN.js";
 
 // src/config.ts
 import fs from "fs";
@@ -5565,6 +5565,7 @@ var discoveryRunInputSchema = z2.object({
     // Stronger descriptions for the LLM. The base Zod schema enforces the
     // upper bound; this just clarifies the meaning of each knob.
     icpDescription: z2.string().min(1).optional().describe("Free-text ICP description. If omitted, the project must already have spec.icpDescription stored."),
+    buyerDescription: z2.string().min(1).optional().describe("Who evaluates or buys the offering, separate from the ICP. When present, every generated query is anchored on this buyer."),
     dedupThreshold: z2.number().min(0).max(1).optional().describe("Cosine similarity threshold for clustering seed candidates. Defaults to 0.85. Lower values dedupe more aggressively."),
     maxProbes: z2.number().int().positive().max(DISCOVERY_MAX_PROBES_CAP).optional().describe(`Max canonical queries to probe in this session. Default 100, hard cap ${DISCOVERY_MAX_PROBES_CAP}.`),
     probeConcurrency: z2.number().int().min(1).max(DISCOVERY_PROBE_CONCURRENCY_CAP).optional().describe(`How many probes may run in parallel. Default 1 (strictly serial), hard cap ${DISCOVERY_PROBE_CONCURRENCY_CAP}. Probe rows are persisted in canonical order regardless of concurrency, so this only shortens wall-clock time.`)

package/dist/{chunk-2AWATO4I.js → chunk-EMG4LIUJ.js}

@@ -10,7 +10,7 @@ import {
   loadConfig,
   loadConfigRaw,
   saveConfigPatch
-} from "./chunk-VGMTLUUM.js";
+} from "./chunk-EKGKGKID.js";
 import {
   CC_CACHE_DIR,
   DUCKDB_SPEC,
@@ -115,7 +115,7 @@ import {
   siteAuditPages,
   siteAuditSnapshots,
   usageCounters
-} from "./chunk-F3MKVMS5.js";
+} from "./chunk-45YSA7GH.js";
 import {
   AGENT_MEMORY_VALUE_MAX_BYTES,
   AGENT_PROVIDER_IDS,
@@ -178,7 +178,7 @@ import {
   validationError,
   winnabilityClassLabel,
   withRetry
-} from "./chunk-VOR5ZTUU.js";
+} from "./chunk-IQX7XXJN.js";
 
 // src/telemetry.ts
 import crypto from "crypto";
@@ -5572,6 +5572,7 @@ async function executeDiscoveryRun(opts) {
       sessionId: opts.sessionId,
       project,
       icpDescription: opts.icpDescription,
+      buyerDescription: opts.buyerDescription,
       dedupThreshold: opts.dedupThreshold,
       maxProbes: opts.maxProbes,
       probeConcurrency: opts.probeConcurrency,
@@ -5648,7 +5649,10 @@ function buildDefaultDeps(registry) {
         {
           query: input.query,
           canonicalDomains: input.project.canonicalDomains,
-          competitorDomains: input.project.competitorDomains
+          competitorDomains: input.project.competitorDomains,
+          // Same geo mechanism as sweeps: the provider renders the location
+          // into the prompt so the probe measures from the buyer's area.
+          ...input.location ? { location: input.location } : {}
         },
         cfg
       );
@@ -5765,11 +5769,17 @@ function buildLocationConstraint(locations) {
 function buildSeedPrompt(input) {
   const locationConstraint = buildLocationConstraint(input.locations ?? []);
   const currentYear = (/* @__PURE__ */ new Date()).getFullYear();
+  const buyer = input.buyerDescription?.trim() ?? "";
+  const brandIdentities = [...input.project.brandNames ?? [], ...input.project.canonicalDomains];
   return [
     "You are an AEO (Answer Engine Optimization) analyst expanding a tracked-query basket for a customer.",
     "",
     `Customer: ${input.project.name} (domains: ${input.project.canonicalDomains.join(", ")})`,
     `ICP: ${input.icpDescription}`,
+    ...buyer ? [
+      `Buyer: ${buyer}`,
+      "Every query must be one this buyer would plausibly type into an answer engine. Skip queries only an industry insider, investor, or job seeker would ask."
+    ] : [],
     ...locationConstraint.length > 0 ? ["", ...locationConstraint] : [],
     "",
     "Brainstorm queries a member of this ICP would type into an AI answer engine (Gemini, ChatGPT, Perplexity). Generate candidates across the five intent buckets below \u2014 these are SEMANTICALLY DISTINCT search intents, not stylistic variants. A query should fit one bucket cleanly. Diversity across buckets is the point: it keeps the list from collapsing into near-synonyms of a single intent.",
@@ -5780,6 +5790,8 @@ function buildSeedPrompt(input) {
     ' 4. Comparative \u2014 the searcher is weighing named alternatives head-to-head. Templates: "X vs Y", "X or Y for Z", "alternatives to X".',
     ' 5. Transactional \u2014 the searcher is ready to act on a purchase or booking. Templates: "book X", "X pricing", "X discount code", "buy X online".',
     "",
+    `Hard rule: NEVER include the customer's own brand name or domain (${brandIdentities.join(", ") || input.project.name}) in any query. A buyer who already knows the business by name is out of scope for this list; the goal is queries where the customer must EARN the mention. Naming competitors or directories is fine (Navigational queries should target directories and platforms, never the customer).`,
+    "",
     `Generate EXACTLY ${QUERIES_PER_INTENT_BUCKET} queries per bucket \u2014 ${QUERIES_PER_INTENT_BUCKET * 5} total. Return ONE query per line. Plain text only \u2014 no numbering, bullets, quotes, bucket labels, or commentary.`
   ].join("\n");
 }
@@ -6473,7 +6485,7 @@ function readStoredGroundingSources(rawResponse) {
   return result;
 }
 async function backfillInsightsCommand(project, opts) {
-  const { IntelligenceService: IntelligenceService2 } = await import("./intelligence-service-JGZU27U3.js");
+  const { IntelligenceService: IntelligenceService2 } = await import("./intelligence-service-YDPWS7OC.js");
   const config = loadConfig();
   const db = createClient(config.database);
   migrate(db);
@@ -11938,6 +11950,7 @@ async function createServer(opts) {
         sessionId: input.sessionId,
         projectId: input.projectId,
         icpDescription: input.icpDescription,
+        buyerDescription: input.buyerDescription,
         dedupThreshold: input.dedupThreshold,
         maxProbes: input.maxProbes,
         probeConcurrency: input.probeConcurrency,

package/dist/{chunk-VOR5ZTUU.js → chunk-IQX7XXJN.js}

@@ -169,6 +169,12 @@ function hasLocationLabel(locations, label) {
   if (!label) return true;
   return locations.some((location) => location.label === label);
 }
+function orderLocationsDefaultFirst(locations, defaultLabel) {
+  if (!defaultLabel) return [...locations];
+  const index = locations.findIndex((l) => l.label === defaultLabel);
+  if (index <= 0) return [...locations];
+  return [locations[index], ...locations.slice(0, index), ...locations.slice(index + 1)];
+}
 function resolveLocations(projectLocations, requestedLabels) {
   const normalizedRequest = (requestedLabels ?? []).map((label) => label.trim()).filter((label) => label.length > 0);
   if (normalizedRequest.length === 0) return [...projectLocations];
@@ -2186,6 +2192,19 @@ var discoverySessionDtoSchema = z17.object({
    */
   seedFromAnswerCount: z17.number().int().nullable().optional(),
   seedFromGroundingCount: z17.number().int().nullable().optional(),
+  /**
+   * Diagnostics: how many raw seed candidates were dropped by the branded
+   * self-query filter before seedCountRaw was recorded (the customer's own
+   * brand or domain in the query text). Null on legacy sessions. Purely
+   * additive: no gate or warning reads it.
+   */
+  seedBrandFilteredCount: z17.number().int().nullable().optional(),
+  /** Buyer definition the session was seeded with (part of session identity
+   *  for in-flight consolidation). Null on legacy / no-buyer sessions. */
+  buyerDescription: z17.string().nullable().optional(),
+  /** Resolved service areas the session was seeded/probed with (part of
+   *  session identity for in-flight consolidation). Null on legacy sessions. */
+  locations: z17.array(locationContextSchema).nullable().optional(),
   dedupThreshold: z17.number().nullable().optional(),
   probeCount: z17.number().int().nullable().optional(),
   citedCount: z17.number().int().nullable().default(null),
@@ -2219,8 +2238,58 @@ function seedCollapseWarning(input) {
   const noun = canonicalCount === 1 ? "query" : "queries";
   return `Seed dedup collapsed ${seedCountRaw} raw candidates into ${canonicalCount} canonical ${noun} at threshold ${dedupThreshold}. Distinct intents were likely merged into one cluster; re-run with a higher --dedup-threshold.`;
 }
+function filterBrandedSeedCandidates(input) {
+  const tokens = brandMatchTokens(input.brandNames, input.canonicalDomains);
+  if (tokens.length === 0) return { kept: [...input.candidates], droppedBranded: [] };
+  const kept = [];
+  const droppedBranded = [];
+  for (const candidate of input.candidates) {
+    const normalized = normalizeForBrandMatch(candidate);
+    if (tokens.some((token) => containsWholeToken(normalized, token))) droppedBranded.push(candidate);
+    else kept.push(candidate);
+  }
+  return { kept, droppedBranded };
+}
+function normalizeForBrandMatch(text) {
+  return text.toLowerCase().replace(/\s+/g, " ").trim();
+}
+function brandMatchTokens(brandNames, canonicalDomains) {
+  const tokens = /* @__PURE__ */ new Set();
+  for (const name of brandNames) {
+    const normalized = normalizeForBrandMatch(name);
+    if (normalized.length < 3) continue;
+    tokens.add(normalized);
+    const squashed = normalized.replace(/[^a-z0-9]/g, "");
+    if (squashed.length >= 4 && squashed !== normalized) tokens.add(squashed);
+  }
+  for (const domain of canonicalDomains) {
+    const host = hostOf(domain) ?? normalizeForBrandMatch(domain).replace(/^www\./, "");
+    if (!host) continue;
+    tokens.add(host);
+    tokens.add(`www.${host}`);
+  }
+  return [...tokens];
+}
+function containsWholeToken(normalized, token) {
+  let index = normalized.indexOf(token);
+  while (index !== -1) {
+    const before = index === 0 ? " " : normalized[index - 1];
+    const afterIndex = index + token.length;
+    const after = afterIndex >= normalized.length ? " " : normalized[afterIndex];
+    if (!/[a-z0-9]/.test(before) && !/[a-z0-9]/.test(after)) return true;
+    index = normalized.indexOf(token, index + 1);
+  }
+  return false;
+}
 var discoveryRunRequestSchema = z17.object({
   icpDescription: z17.string().min(1).optional(),
+  /**
+   * Who evaluates or buys the offering, separate from what is sold
+   * (icpDescription). When present, the seed prompt anchors every generated
+   * query on this buyer, so discovery selects buyer-fit demand instead of
+   * generic provider comparisons.
+   */
+  buyerDescription: z17.string().min(1).optional(),
   dedupThreshold: z17.number().min(0).max(1).optional(),
   maxProbes: z17.number().int().positive().max(DISCOVERY_MAX_PROBES_CAP).optional(),
   /**
@@ -5531,6 +5600,7 @@ export {
   runtimeStateMissing,
   findDuplicateLocationLabels,
   hasLocationLabel,
+  orderLocationsDefaultFirst,
   resolveLocations,
   projectUpsertRequestSchema,
   projectDtoSchema,
@@ -5660,6 +5730,7 @@ export {
   DISCOVERY_DEFAULT_PROBE_CONCURRENCY,
   DISCOVERY_DEFAULT_DEDUP_THRESHOLD,
   seedCollapseWarning,
+  filterBrandedSeedCandidates,
   discoveryRunRequestSchema,
   discoveryPromoteRequestSchema,
   discoveryPromotePreviewSchema,

package/dist/cli.js

@@ -29,7 +29,7 @@ import {
   setTelemetrySource,
   showFirstRunNotice,
   trackEvent
-} from "./chunk-2AWATO4I.js";
+} from "./chunk-EMG4LIUJ.js";
 import {
   CliError,
   EXIT_SYSTEM_ERROR,
@@ -46,7 +46,7 @@ import {
   saveConfig,
   saveConfigPatch,
   usageError
-} from "./chunk-VGMTLUUM.js";
+} from "./chunk-EKGKGKID.js";
 import {
   apiKeys,
   createClient,
@@ -54,7 +54,7 @@ import {
   projects,
   queries,
   renderReportHtml
-} from "./chunk-F3MKVMS5.js";
+} from "./chunk-45YSA7GH.js";
 import {
   BacklinkSources,
   CcReleaseSyncStatuses,
@@ -80,7 +80,7 @@ import {
   providerQuotaPolicySchema,
   resolveProviderInput,
   winnabilityClassSchema
-} from "./chunk-VOR5ZTUU.js";
+} from "./chunk-IQX7XXJN.js";
 
 // src/cli.ts
 import { pathToFileURL } from "url";
@@ -1655,6 +1655,7 @@ function getClient4() {
 function buildRunBody(opts, icpDescription) {
   const body = {};
   if (icpDescription) body.icpDescription = icpDescription;
+  if (opts.buyer !== void 0 && opts.buyer.trim() !== "") body.buyerDescription = opts.buyer;
   if (opts.dedupThreshold !== void 0) body.dedupThreshold = opts.dedupThreshold;
   if (opts.maxProbes !== void 0) body.maxProbes = opts.maxProbes;
   if (opts.probeConcurrency !== void 0) body.probeConcurrency = opts.probeConcurrency;
@@ -2057,9 +2058,10 @@ Usage: ${usage}`,
 var DISCOVER_CLI_COMMANDS = [
   {
     path: ["discover", "run"],
-    usage: 'canonry discover run <project> [--icp "..."] [--icp-angle "..."] [--locations michigan,florida] [--dedup-threshold 0.95] [--max-probes 100] [--probe-concurrency 3] [--wait] [--format json]',
+    usage: 'canonry discover run <project> [--icp "..."] [--buyer "..."] [--icp-angle "..."] [--locations michigan,florida] [--dedup-threshold 0.95] [--max-probes 100] [--probe-concurrency 3] [--wait] [--format json]',
     options: {
       icp: stringOption(),
+      buyer: stringOption(),
       "icp-angle": multiStringOption(),
       locations: multiStringOption(),
       "dedup-threshold": stringOption(),
@@ -2068,10 +2070,11 @@ var DISCOVER_CLI_COMMANDS = [
       wait: { type: "boolean", default: false }
     },
     run: async (input) => {
-      const usage = 'canonry discover run <project> [--icp "..."] [--icp-angle "..."] [--locations michigan,florida] [--dedup-threshold 0.95] [--max-probes 100] [--probe-concurrency 3] [--wait] [--format json]';
+      const usage = 'canonry discover run <project> [--icp "..."] [--buyer "..."] [--icp-angle "..."] [--locations michigan,florida] [--dedup-threshold 0.95] [--max-probes 100] [--probe-concurrency 3] [--wait] [--format json]';
       const project = requireProject(input, "discover.run", usage);
       await discoverRun(project, {
         icp: getString(input.values, "icp"),
+        buyer: getString(input.values, "buyer"),
         icpAngles: getStringArray(input.values, "icp-angle"),
         locations: parseLocationsOption(input.values),
         dedupThreshold: parseFloatOption(input.values, "dedup-threshold", usage),
@@ -2092,9 +2095,10 @@ var DISCOVER_CLI_COMMANDS = [
   },
   {
     path: ["discover", "seed"],
-    usage: 'canonry discover seed <project> [--icp "..."] [--icp-angle "..."] [--locations michigan,florida] [--dedup-threshold 0.95] [--max-probes 100] [--probe-concurrency 3] [--wait] [--format json]',
+    usage: 'canonry discover seed <project> [--icp "..."] [--buyer "..."] [--icp-angle "..."] [--locations michigan,florida] [--dedup-threshold 0.95] [--max-probes 100] [--probe-concurrency 3] [--wait] [--format json]',
     options: {
       icp: stringOption(),
+      buyer: stringOption(),
       "icp-angle": multiStringOption(),
       locations: multiStringOption(),
       "dedup-threshold": stringOption(),
@@ -2103,10 +2107,11 @@ var DISCOVER_CLI_COMMANDS = [
       wait: { type: "boolean", default: false }
     },
     run: async (input) => {
-      const usage = 'canonry discover seed <project> [--icp "..."] [--icp-angle "..."] [--locations michigan,florida] [--dedup-threshold 0.95] [--max-probes 100] [--probe-concurrency 3] [--wait] [--format json]';
+      const usage = 'canonry discover seed <project> [--icp "..."] [--buyer "..."] [--icp-angle "..."] [--locations michigan,florida] [--dedup-threshold 0.95] [--max-probes 100] [--probe-concurrency 3] [--wait] [--format json]';
       const project = requireProject(input, "discover.seed", usage);
       await discoverSeed(project, {
         icp: getString(input.values, "icp"),
+        buyer: getString(input.values, "buyer"),
         icpAngles: getStringArray(input.values, "icp-angle"),
         locations: parseLocationsOption(input.values),
         dedupThreshold: parseFloatOption(input.values, "dedup-threshold", usage),

package/dist/index.js

@@ -1,11 +1,11 @@
 import {
   createServer
-} from "./chunk-2AWATO4I.js";
+} from "./chunk-EMG4LIUJ.js";
 import {
   loadConfig
-} from "./chunk-VGMTLUUM.js";
-import "./chunk-F3MKVMS5.js";
-import "./chunk-VOR5ZTUU.js";
+} from "./chunk-EKGKGKID.js";
+import "./chunk-45YSA7GH.js";
+import "./chunk-IQX7XXJN.js";
 export {
   createServer,
   loadConfig

package/dist/{intelligence-service-JGZU27U3.js → intelligence-service-YDPWS7OC.js}

@@ -1,7 +1,7 @@
 import {
   IntelligenceService
-} from "./chunk-F3MKVMS5.js";
-import "./chunk-VOR5ZTUU.js";
+} from "./chunk-45YSA7GH.js";
+import "./chunk-IQX7XXJN.js";
 export {
   IntelligenceService
 };

package/dist/mcp.js

@@ -3,10 +3,10 @@ import {
   PACKAGE_VERSION,
   canonryMcpTools,
   createApiClient
-} from "./chunk-VGMTLUUM.js";
+} from "./chunk-EKGKGKID.js";
 import {
   isReadOnlyKey
-} from "./chunk-VOR5ZTUU.js";
+} from "./chunk-IQX7XXJN.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.106.2",
+  "version": "4.108.0",
   "type": "module",
   "description": "Agent-first open-source AEO operating platform - track how answer engines cite your domain",
   "license": "FSL-1.1-ALv2",
@@ -66,26 +66,26 @@
     "tsup": "^8.5.1",
     "tsx": "^4.19.0",
     "@ainyc/canonry-api-client": "0.0.0",
-    "@ainyc/canonry-api-routes": "0.0.0",
-    "@ainyc/canonry-db": "0.0.0",
     "@ainyc/canonry-config": "0.0.0",
+    "@ainyc/canonry-api-routes": "0.0.0",
     "@ainyc/canonry-contracts": "0.0.0",
+    "@ainyc/canonry-db": "0.0.0",
     "@ainyc/canonry-integration-bing": "0.0.0",
     "@ainyc/canonry-integration-openai-ads": "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-google-business-profile": "0.0.0",
     "@ainyc/canonry-integration-google-places": "0.0.0",
     "@ainyc/canonry-integration-traffic": "0.0.0",
+    "@ainyc/canonry-integration-google-business-profile": "0.0.0",
+    "@ainyc/canonry-integration-wordpress": "0.0.0",
     "@ainyc/canonry-intelligence": "0.0.0",
     "@ainyc/canonry-provider-cdp": "0.0.0",
-    "@ainyc/canonry-integration-wordpress": "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-gemini": "0.0.0",
-    "@ainyc/canonry-provider-perplexity": "0.0.0"
+    "@ainyc/canonry-provider-perplexity": "0.0.0",
+    "@ainyc/canonry-provider-local": "0.0.0",
+    "@ainyc/canonry-provider-openai": "0.0.0"
   },
   "scripts": {
     "build": "tsx scripts/copy-agent-assets.ts && tsup && tsx build-web.ts",