@ainyc/canonry 4.55.1 → 4.56.0

package/dist/{chunk-UTM3FPAJ.js → chunk-4KWPOVIT.js}

@@ -9,8 +9,10 @@ import {
   categorizeSourceWithCompetitors,
   categoryLabel,
   determineAnswerMentioned,
-  normalizeProjectDomain
-} from "./chunk-OFY3Z2F7.js";
+  effectiveDomains,
+  normalizeProjectDomain,
+  registrableDomain
+} from "./chunk-WFVUZVJD.js";
 
 // src/intelligence-service.ts
 import { eq, desc, asc, and, ne, or, inArray } from "drizzle-orm";
@@ -4156,6 +4158,172 @@ function createLogger(module) {
   };
 }
 
+// src/citation-utils.ts
+function domainMatches(domain, canonicalDomain) {
+  const normalized = normalizeProjectDomain(canonicalDomain);
+  const d = normalizeProjectDomain(domain);
+  return d === normalized || d.endsWith(`.${normalized}`);
+}
+function pickProjectCitedDomain(citedDomains, projectDomains) {
+  for (const cited of citedDomains) {
+    if (projectDomains.some((pd) => domainMatches(cited, pd))) return cited;
+  }
+  return void 0;
+}
+function determineCitationState(normalized, domains) {
+  for (const canonicalDomain of domains) {
+    const bareDomain = normalizeProjectDomain(canonicalDomain);
+    if (normalized.citedDomains.some((d) => domainMatches(d, bareDomain))) {
+      return "cited";
+    }
+    const lowerDomain = bareDomain.toLowerCase();
+    for (const source of normalized.groundingSources) {
+      try {
+        const uri = source.uri.toLowerCase();
+        if (lowerDomain.includes(".") && uri.includes(lowerDomain)) {
+          return "cited";
+        }
+      } catch {
+      }
+      if (source.title) {
+        const titleLower = source.title.toLowerCase().replace(/^www\./, "");
+        if (titleLower === lowerDomain || titleLower.endsWith(`.${lowerDomain}`)) {
+          return "cited";
+        }
+      }
+    }
+  }
+  return "not-cited";
+}
+function computeCompetitorOverlap(normalized, competitorDomains) {
+  const overlapSet = /* @__PURE__ */ new Set();
+  for (const d of normalized.citedDomains) {
+    for (const cd of competitorDomains) {
+      if (domainMatches(d, cd)) {
+        overlapSet.add(cd);
+      }
+    }
+  }
+  for (const source of normalized.groundingSources) {
+    const uri = source.uri.toLowerCase();
+    for (const cd of competitorDomains) {
+      if (uri.includes(cd.toLowerCase())) {
+        overlapSet.add(cd);
+      }
+    }
+  }
+  if (normalized.answerText) {
+    const lowerAnswer = normalized.answerText.toLowerCase();
+    for (const cd of competitorDomains) {
+      if (lowerAnswer.includes(cd.toLowerCase())) {
+        overlapSet.add(cd);
+      }
+      const brand = brandLabelFromDomain(cd);
+      if (brand.length >= 4 && new RegExp(`\\b${escapeRegExp(brand)}\\b`, "i").test(lowerAnswer)) {
+        overlapSet.add(cd);
+      }
+    }
+  }
+  return [...overlapSet];
+}
+function escapeRegExp(value) {
+  return value.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+}
+function extractRecommendedCompetitors(answerText, ownDomains, citedDomains, competitorDomains, ownBrandNames = []) {
+  if (!answerText || answerText.length < 20) return [];
+  const ownBrandKeys = new Set(
+    ownDomains.flatMap((domain) => collectBrandKeysFromDomain(domain))
+  );
+  for (const name of ownBrandNames) {
+    const key = brandKeyFromText(name);
+    if (key.length >= 4) ownBrandKeys.add(key);
+  }
+  const knownCompetitorKeys = new Set(
+    [...citedDomains, ...competitorDomains].flatMap((domain) => collectBrandKeysFromDomain(domain)).filter((key) => !ownBrandKeys.has(key))
+  );
+  if (knownCompetitorKeys.size === 0) return [];
+  const candidatePatterns = [
+    /^\s*(?:[-*]|\d+\.)\s+(?:\*\*)?([A-Z0-9][A-Za-z0-9][\w\s.&',/()-]{1,50}?)(?:\*\*)?\s*[:\u2014\u2013-]/gm,
+    /\*\*([A-Z0-9][A-Za-z0-9][\w\s.&',/()-]{1,50})\*\*/g,
+    /^#{1,4}\s+(?:\d+\.\s+)?(?:\*\*)?([A-Z0-9][A-Za-z0-9][\w\s.&',/()-]{1,50}?)(?:\*\*)?$/gm,
+    /\[([A-Z0-9][A-Za-z0-9][\w\s.&',/()-]{1,50})\]\(https?:\/\/[^\s)]+\)/g
+  ];
+  const genericKeys = /* @__PURE__ */ new Set([
+    "additional",
+    "best",
+    "benefits",
+    "bottomline",
+    "comparison",
+    "conclusion",
+    "directorylisting",
+    "example",
+    "expertise",
+    "features",
+    "finalthoughts",
+    "howitworks",
+    "important",
+    "keybenefits",
+    "keyfeatures",
+    "major",
+    "note",
+    "notable",
+    "option",
+    "other",
+    "overview",
+    "pricing",
+    "pros",
+    "reviews",
+    "step",
+    "summary",
+    "top",
+    "verdict",
+    "whattolookfor",
+    "whyitmatters",
+    "whyitstandsout",
+    "whywechoseit"
+  ]);
+  const seen = /* @__PURE__ */ new Map();
+  for (const pattern of candidatePatterns) {
+    let match;
+    while ((match = pattern.exec(answerText)) !== null) {
+      const candidate = cleanCandidateName(match[1] ?? "");
+      const candidateKey = brandKeyFromText(candidate);
+      if (!candidateKey) continue;
+      if (genericKeys.has(candidateKey)) continue;
+      if (candidate.split(/\s+/).length > 6) continue;
+      if (matchesBrandKey(candidateKey, ownBrandKeys)) continue;
+      if (!matchesBrandKey(candidateKey, knownCompetitorKeys)) continue;
+      if (!seen.has(candidateKey)) seen.set(candidateKey, candidate);
+    }
+  }
+  return [...seen.values()].slice(0, 10);
+}
+function cleanCandidateName(candidate) {
+  return candidate.replace(/^[\s"'`]+|[\s"'`.,:;!?]+$/g, "").replace(/\s+/g, " ").trim();
+}
+function collectBrandKeysFromDomain(domain) {
+  const reg = registrableDomain(domain);
+  if (!reg) {
+    const hostname = normalizeProjectDomain(domain).split("/")[0] ?? "";
+    const fallback = hostname.replace(/[^a-z0-9]/gi, "").toLowerCase();
+    return fallback.length >= 4 ? [fallback] : [];
+  }
+  const keys = /* @__PURE__ */ new Set();
+  const fullKey = reg.replace(/[^a-z0-9]/gi, "").toLowerCase();
+  if (fullKey.length >= 4) keys.add(fullKey);
+  const brand = brandLabelFromDomain(reg).replace(/[^a-z0-9]/gi, "").toLowerCase();
+  if (brand.length >= 4) keys.add(brand);
+  return [...keys];
+}
+function matchesBrandKey(candidateKey, brandKeys) {
+  for (const brandKey of brandKeys) {
+    if (candidateKey === brandKey) return true;
+    if (candidateKey.startsWith(brandKey) || candidateKey.endsWith(brandKey)) return true;
+    if (brandKey.startsWith(candidateKey) || brandKey.endsWith(candidateKey)) return true;
+  }
+  return false;
+}
+
 // src/intelligence-service.ts
 var RECURRENCE_LOOKBACK_RUNS = 5;
 var HISTORY_WINDOW_RUNS = Math.max(PERSISTENT_GAP_THRESHOLD, 5);
@@ -4537,6 +4705,11 @@ var IntelligenceService = class {
     });
   }
   buildRunData(runId, projectId, completedAt, location = null) {
+    const projectDomainRow = this.db.select({ canonicalDomain: projects.canonicalDomain, ownedDomains: projects.ownedDomains }).from(projects).where(eq(projects.id, projectId)).get();
+    const projectDomains = projectDomainRow ? effectiveDomains({
+      canonicalDomain: projectDomainRow.canonicalDomain,
+      ownedDomains: projectDomainRow.ownedDomains
+    }) : [];
     const rows = this.db.select({
       query: queries.query,
       // Denormalized query text persisted by v58 — the fallback when the
@@ -4563,7 +4736,9 @@ var IntelligenceService = class {
         query: resolvedQuery,
         provider: r.provider,
         cited: r.citationState === CitationStates.cited,
-        citationUrl: domains[0] ?? void 0,
+        // The project's OWN cited domain — never a co-cited competitor that
+        // happens to sort first in the full citedDomains set.
+        citationUrl: pickProjectCitedDomain(domains, projectDomains),
         // Snapshots carry their own location for downstream detectors. In
         // practice every snapshot in a single runId shares the run's
         // location; the per-row column is the same value duplicated, but
@@ -4629,6 +4804,9 @@ export {
   groupRunsByCreatedAt,
   pickGroupRepresentative,
   filterTrackedSnapshots,
+  determineCitationState,
+  computeCompetitorOverlap,
+  extractRecommendedCompetitors,
   isBlogShapedQuery,
   buildInventory,
   buildContentTargetRows,

package/dist/{chunk-ZY3EDW3S.js → chunk-6X5TF73A.js}

@@ -22,7 +22,7 @@ import {
   trafficConnectVercelRequestSchema,
   trafficConnectWordpressRequestSchema,
   trafficEventKindSchema
-} from "./chunk-OFY3Z2F7.js";
+} from "./chunk-WFVUZVJD.js";
 
 // src/config.ts
 import fs from "fs";
@@ -3001,6 +3001,22 @@ var postApiV1ProjectsByNameTrafficSourcesByIdBackfill = (options) => {
     }
   });
 };
+var postApiV1ProjectsByNameTrafficSourcesByIdReset = (options) => {
+  return (options.client ?? client).post({
+    security: [
+      {
+        scheme: "bearer",
+        type: "http"
+      }
+    ],
+    url: "/api/v1/projects/{name}/traffic/sources/{id}/reset",
+    ...options,
+    headers: {
+      "Content-Type": "application/json",
+      ...options.headers
+    }
+  });
+};
 var getApiV1ProjectsByNameTrafficSources = (options) => {
   return (options.client ?? client).get({
     security: [
@@ -3564,9 +3580,14 @@ var ApiClient = class {
       })
     );
   }
-  async listRuns(project, limit) {
+  async listRuns(project, limit, kind) {
     return this.invoke(
-      () => getApiV1ProjectsByNameRuns({ client: this.heyClient, path: { name: project }, query: { limit } })
+      () => getApiV1ProjectsByNameRuns({
+        client: this.heyClient,
+        path: { name: project },
+        // kind arrives as a free CLI string; the server validates it against the enum.
+        query: { limit, kind }
+      })
     );
   }
   async getLatestRun(project) {
@@ -4105,6 +4126,15 @@ var ApiClient = class {
       () => getApiV1ProjectsByNameTrafficSources({ client: this.heyClient, path: { name: project } })
     );
   }
+  async trafficReset(project, sourceId) {
+    return this.invoke(
+      () => postApiV1ProjectsByNameTrafficSourcesByIdReset({
+        client: this.heyClient,
+        path: { name: project, id: sourceId },
+        body: { advanceToNow: true }
+      })
+    );
+  }
   async trafficStatus(project) {
     return this.invoke(
       () => getApiV1ProjectsByNameTrafficStatus({ client: this.heyClient, path: { name: project } })
@@ -4709,6 +4739,11 @@ var trafficBackfillInputSchema = z2.object({
   sourceId: z2.string().min(1).describe("Traffic source ID returned by canonry_traffic_sources_list."),
   days: z2.number().int().positive().max(30).optional().describe("Lookback window in days. Default 30, capped server-side at the upstream log retention ceiling (Cloud Logging _Default = 30d).")
 });
+var trafficResetInputSchema = z2.object({
+  project: projectNameSchema,
+  sourceId: z2.string().min(1).describe("Traffic source ID returned by canonry_traffic_sources_list."),
+  advanceToNow: z2.literal(true).describe("Must be `true`. Explicit gate against accidental resets. Advances lastSyncedAt to NOW and clears the source's error state.")
+});
 var trafficEventsInputSchema = z2.object({
   project: projectNameSchema,
   since: z2.string().optional().describe("ISO 8601 lower bound. Defaults to 24h ago when omitted."),
@@ -5390,6 +5425,17 @@ var canonryMcpTools = [
     openApiOperations: ["POST /api/v1/projects/{name}/traffic/sources/{id}/backfill"],
     handler: (client2, input) => client2.trafficBackfill(input.project, input.sourceId, input.days !== void 0 ? { days: input.days } : void 0)
   }),
+  defineTool({
+    name: "canonry_traffic_reset",
+    title: "Advance traffic source lastSyncedAt to NOW",
+    description: "Operator recovery for a stuck traffic source. Advances `lastSyncedAt` to NOW, sets `status` back to `connected`, and clears `last_error`. Accepts any non-archived source: the `lastSyncedAt` advance determines the next sync window for time-windowed sources (Vercel, Cloud Run); cursor-based sources (WordPress) keep their `last_cursor` so the advance is informational. Common trigger: an idle Vercel/Cloud Run source whose `lastSyncedAt` aged past the upstream retention boundary and every sync now throws a retention error. Historical events in the gap are unrecoverable from the sync path; run canonry_traffic_backfill separately if any of them are needed. Archived sources are rejected \u2014 re-connect via the appropriate canonry_traffic_connect_* tool instead.",
+    access: "write",
+    tier: "traffic",
+    inputSchema: trafficResetInputSchema,
+    annotations: writeAnnotations({ idempotentHint: true, destructiveHint: true }),
+    openApiOperations: ["POST /api/v1/projects/{name}/traffic/sources/{id}/reset"],
+    handler: (client2, input) => client2.trafficReset(input.project, input.sourceId)
+  }),
   defineTool({
     name: "canonry_project_upsert",
     title: "Create or replace project",