npm - @ainyc/canonry - Versions diffs - 4.34.0 → 4.35.0 - Mend

@ainyc/canonry 4.34.0 → 4.35.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 (16) hide show

package/README.md +2 -2
package/assets/assets/index-Cfv0_lwq.css +1 -0
package/assets/assets/index-u7ZXZ5mA.js +302 -0
package/assets/index.html +2 -2
package/dist/{chunk-5EBN7736.js → chunk-B3FBOECD.js} +1 -1
package/dist/{chunk-XW3F5EEW.js → chunk-EM5GVF3C.js} +73 -20
package/dist/{chunk-7256SFYT.js → chunk-MLS5KJWK.js} +155 -38
package/dist/{chunk-7AF6B3L6.js → chunk-NLV4MZZF.js} +1084 -279
package/dist/cli.js +100 -563
package/dist/index.d.ts +3 -0
package/dist/index.js +4 -4
package/dist/{intelligence-service-3P2DMYRR.js → intelligence-service-WAJOEOJV.js} +2 -2
package/dist/mcp.js +2 -2
package/package.json +5 -5
package/assets/assets/index-47V0U52s.js +0 -302
package/assets/assets/index-CNKAwZMB.css +0 -1

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-47V0U52s.js"></script>
-    <link rel="stylesheet" crossorigin href="./assets/index-CNKAwZMB.css">
+    <script type="module" crossorigin src="./assets/index-u7ZXZ5mA.js"></script>
+    <link rel="stylesheet" crossorigin href="./assets/index-Cfv0_lwq.css">
   </head>
   <body>
     <div id="root"></div>

package/dist/{chunk-5EBN7736.js → chunk-B3FBOECD.js} RENAMED Viewed

@@ -22,7 +22,7 @@ import {
   trafficConnectVercelRequestSchema,
   trafficConnectWordpressRequestSchema,
   trafficEventKindSchema
-} from "./chunk-XW3F5EEW.js";
+} from "./chunk-EM5GVF3C.js";
 // src/config.ts
 import fs from "fs";

package/dist/{chunk-XW3F5EEW.js → chunk-EM5GVF3C.js} RENAMED Viewed

@@ -99,8 +99,12 @@ var citationStateSchema = z2.enum(["cited", "not-cited"]);
 var CitationStates = citationStateSchema.enum;
 var visibilityStateSchema = z2.enum(["visible", "not-visible"]);
 var VisibilityStates = visibilityStateSchema.enum;
+var mentionStateSchema = z2.enum(["mentioned", "not-mentioned"]);
+var MentionStates = mentionStateSchema.enum;
 var computedTransitionSchema = z2.enum(["new", "cited", "lost", "emerging", "not-cited"]);
 var ComputedTransitions = computedTransitionSchema.enum;
+var mentionTransitionSchema = z2.enum(["new", "mentioned", "lost", "emerging", "not-mentioned"]);
+var MentionTransitions = mentionTransitionSchema.enum;
 var runTriggerRequestSchema = z2.object({
   kind: z2.literal(RunKinds["answer-visibility"]).optional(),
   trigger: z2.literal(RunTriggers.manual).optional(),
@@ -211,7 +215,10 @@ var querySnapshotDtoSchema = z2.object({
   provider: providerNameSchema,
   citationState: citationStateSchema,
   answerMentioned: z2.boolean().optional(),
+  /** @deprecated legacy name for `mentionState`; same data, kept for backwards compatibility. */
   visibilityState: visibilityStateSchema.optional(),
+  /** Mention state for this snapshot — see `mentionStateSchema`. Prefer this over the legacy `visibilityState`. */
+  mentionState: mentionStateSchema.optional(),
   transition: computedTransitionSchema.optional(),
   answerText: z2.string().nullable().optional(),
   citedDomains: z2.array(z2.string()).default([]),
@@ -235,8 +242,14 @@ var snapshotDiffRowSchema = z2.object({
   run2State: citationStateSchema.nullable(),
   run1AnswerMentioned: z2.boolean().nullable(),
   run2AnswerMentioned: z2.boolean().nullable(),
+  /** @deprecated legacy name for `run1MentionState`. */
   run1VisibilityState: visibilityStateSchema.nullable(),
+  /** @deprecated legacy name for `run2MentionState`. */
   run2VisibilityState: visibilityStateSchema.nullable(),
+  /** Mention state in run 1 — prefer this over the legacy `run1VisibilityState`. */
+  run1MentionState: mentionStateSchema.nullable().optional(),
+  /** Mention state in run 2 — prefer this over the legacy `run2VisibilityState`. */
+  run2MentionState: mentionStateSchema.nullable().optional(),
   changed: z2.boolean(),
   visibilityChanged: z2.boolean()
 });
@@ -409,6 +422,7 @@ var projectUpsertRequestSchema = z4.object({
   displayName: z4.string().min(1),
   canonicalDomain: z4.string().min(1),
   ownedDomains: z4.array(z4.string().min(1)).optional(),
+  aliases: z4.array(z4.string()).optional(),
   country: z4.string().length(2),
   language: z4.string().min(2),
   tags: z4.array(z4.string()).optional(),
@@ -425,6 +439,7 @@ var projectDtoSchema = z4.object({
   displayName: z4.string().optional(),
   canonicalDomain: z4.string(),
   ownedDomains: z4.array(z4.string()).default([]),
+  aliases: z4.array(z4.string()).default([]),
   country: z4.string().length(2),
   language: z4.string().min(2),
   tags: z4.array(z4.string()).default([]),
@@ -548,6 +563,31 @@ function effectiveDomains(project) {
   }
   return result;
 }
+function normalizeProjectAliases(displayName, aliases) {
+  if (!aliases || aliases.length === 0) return [];
+  const displayKey = displayName?.trim().toLowerCase() ?? "";
+  const seen = /* @__PURE__ */ new Set();
+  const result = [];
+  for (const raw of aliases) {
+    const trimmed = raw.trim();
+    if (!trimmed) continue;
+    const key = trimmed.toLowerCase();
+    if (key === displayKey) continue;
+    if (seen.has(key)) continue;
+    seen.add(key);
+    result.push(trimmed);
+  }
+  return result;
+}
+function effectiveBrandNames(project) {
+  const names = [];
+  const display = project.displayName?.trim() ?? "";
+  if (display) names.push(display);
+  for (const alias of normalizeProjectAliases(project.displayName, project.aliases)) {
+    names.push(alias);
+  }
+  return names;
+}
 // ../contracts/src/config-schema.ts
 var configMetadataSchema = z5.object({
@@ -584,6 +624,7 @@ var configSpecSchema = z5.object({
   displayName: z5.string().min(1),
   canonicalDomain: z5.string().min(1),
   ownedDomains: z5.array(z5.string().min(1)).optional().default([]),
+  aliases: z5.array(z5.string().min(1)).optional().default([]),
   country: z5.string().length(2),
   language: z5.string().min(2),
   queries: configQueryListSchema.optional(),
@@ -1407,7 +1448,7 @@ var BUSINESS_SUFFIXES = [
   "inc",
   "ltd"
 ];
-function extractAnswerMentions(answerText, displayName, domains) {
+function extractAnswerMentions(answerText, brandNames, domains) {
   if (!answerText) return { mentioned: false, matchedTerms: [] };
   const matchedTerms = [];
   const lowerAnswer = answerText.toLowerCase();
@@ -1420,18 +1461,21 @@ function extractAnswerMentions(answerText, displayName, domains) {
   }
   const answerNormalized = normalizeText(answerText);
   const answerBrandKey = brandKeyFromText(answerText);
-  const normalizedCandidates = brandNormalizedCandidates(displayName);
-  const brandKeyCandidates = brandKeyCandidatesForMatch(displayName);
-  const matchesNormalized = normalizedCandidates.some(
-    (c) => new RegExp(`\\b${escapeRegExp(c)}\\b`).test(answerNormalized)
-  );
-  const matchesBrandKey = brandKeyCandidates.some(
-    (c) => c.length >= MIN_BRAND_KEY_LENGTH && answerBrandKey.includes(c)
-  );
-  if (matchesNormalized || matchesBrandKey) {
-    matchedTerms.push(displayName);
+  for (const brandName of brandNames) {
+    if (!brandName || !brandName.trim()) continue;
+    const normalizedCandidates = brandNormalizedCandidates(brandName);
+    const brandKeyCandidates = brandKeyCandidatesForMatch(brandName);
+    const matchesNormalized = normalizedCandidates.some(
+      (c) => new RegExp(`\\b${escapeRegExp(c)}\\b`).test(answerNormalized)
+    );
+    const matchesBrandKey = brandKeyCandidates.some(
+      (c) => c.length >= MIN_BRAND_KEY_LENGTH && answerBrandKey.includes(c)
+    );
+    if (matchesNormalized || matchesBrandKey) {
+      matchedTerms.push(brandName);
+    }
   }
-  const brandTokens = collectBrandTokens(displayName, domains);
+  const brandTokens = collectBrandTokens(brandNames, domains);
   const allTokens = [...brandTokens.primary, ...brandTokens.secondary];
   const secondarySet = new Set(brandTokens.secondary);
   let tokenMatches = 0;
@@ -1454,12 +1498,15 @@ function extractAnswerMentions(answerText, displayName, domains) {
   });
   return { mentioned: dedupedFinal.length > 0, matchedTerms: dedupedFinal };
 }
-function determineAnswerMentioned(answerText, displayName, domains) {
-  return extractAnswerMentions(answerText, displayName, domains).mentioned;
+function determineAnswerMentioned(answerText, brandNames, domains) {
+  return extractAnswerMentions(answerText, brandNames, domains).mentioned;
 }
 function visibilityStateFromAnswerMentioned(answerMentioned) {
   return answerMentioned ? "visible" : "not-visible";
 }
+function mentionStateFromAnswerMentioned(answerMentioned) {
+  return answerMentioned ? "mentioned" : "not-mentioned";
+}
 function brandKeyFromText(value) {
   return value.toLowerCase().replace(/[^a-z0-9]/g, "");
 }
@@ -1472,14 +1519,17 @@ function domainMentioned(lowerAnswer, normalizedDomain) {
   ];
   return patterns.some((pattern) => pattern.test(lowerAnswer));
 }
-function collectBrandTokens(displayName, domains) {
+function collectBrandTokens(brandNames, domains) {
   const primary = /* @__PURE__ */ new Set();
   const secondary = /* @__PURE__ */ new Set();
-  const distinctiveWords = extractDistinctiveTokens(displayName);
-  if (distinctiveWords.length > 0) {
-    primary.add(distinctiveWords[0]);
-    for (let i = 1; i < distinctiveWords.length; i++) {
-      secondary.add(distinctiveWords[i]);
+  for (const brandName of brandNames) {
+    if (!brandName || !brandName.trim()) continue;
+    const distinctiveWords = extractDistinctiveTokens(brandName);
+    if (distinctiveWords.length > 0) {
+      primary.add(distinctiveWords[0]);
+      for (let i = 1; i < distinctiveWords.length; i++) {
+        secondary.add(distinctiveWords[i]);
+      }
     }
   }
   for (const domain of domains) {
@@ -2671,6 +2721,8 @@ export {
   registrableDomain,
   brandLabelFromDomain,
   effectiveDomains,
+  normalizeProjectAliases,
+  effectiveBrandNames,
   projectConfigSchema,
   resolveConfigSpecQueries,
   wordpressEnvSchema,
@@ -2700,6 +2752,7 @@ export {
   extractAnswerMentions,
   determineAnswerMentioned,
   visibilityStateFromAnswerMentioned,
+  mentionStateFromAnswerMentioned,
   brandKeyFromText,
   MemorySources,
   AGENT_MEMORY_VALUE_MAX_BYTES,

package/dist/{chunk-7256SFYT.js → chunk-MLS5KJWK.js} RENAMED Viewed

@@ -8,7 +8,7 @@ import {
   categoryLabel,
   determineAnswerMentioned,
   normalizeProjectDomain
-} from "./chunk-XW3F5EEW.js";
+} from "./chunk-EM5GVF3C.js";
 // src/intelligence-service.ts
 import { eq, desc, asc, and, or, inArray } from "drizzle-orm";
@@ -68,6 +68,7 @@ var projects = sqliteTable("projects", {
   displayName: text("display_name").notNull(),
   canonicalDomain: text("canonical_domain").notNull(),
   ownedDomains: text("owned_domains").notNull().default("[]"),
+  aliases: text("aliases").notNull().default("[]"),
   country: text("country").notNull(),
   language: text("language").notNull(),
   tags: text("tags").notNull().default("[]"),
@@ -153,7 +154,12 @@ var querySnapshots = sqliteTable("query_snapshots", {
 ]);
 var auditLog = sqliteTable("audit_log", {
   id: text("id").primaryKey(),
-  projectId: text("project_id").references(() => projects.id, { onDelete: "cascade" }),
+  // SET NULL (not CASCADE) so deleting a project preserves its audit trail.
+  // The DELETE /projects route writes a "project.deleted" row immediately
+  // before the delete — a CASCADE here would wipe that record before any
+  // reader could see it (the deletion would erase the only evidence it
+  // happened). Detached rows surface in audit queries with project_id=NULL.
+  projectId: text("project_id").references(() => projects.id, { onDelete: "set null" }),
   actor: text("actor").notNull(),
   action: text("action").notNull(),
   entityType: text("entity_type").notNull(),
@@ -1885,6 +1891,55 @@ var MIGRATION_VERSIONS = [
       `CREATE INDEX IF NOT EXISTS idx_snapshots_location ON query_snapshots(location)`,
       `CREATE INDEX IF NOT EXISTS idx_snapshots_created_at ON query_snapshots(created_at)`
     ]
+  },
+  {
+    version: 59,
+    name: "projects-aliases",
+    statements: [
+      `ALTER TABLE projects ADD COLUMN aliases TEXT NOT NULL DEFAULT '[]'`
+    ]
+  },
+  {
+    version: 60,
+    name: "audit-log-preserve-on-project-delete",
+    // The legacy `audit_log.project_id` FK was `ON DELETE CASCADE`, so any
+    // `DELETE /projects/:name` call cascade-wiped every audit row for that
+    // project — including the `project.deleted` row the route handler had
+    // just written in the same path. The deletion erased the only record
+    // that the deletion happened, defeating the entire purpose of the
+    // audit log.
+    //
+    // Fix: rebuild `audit_log` with `project_id` as `ON DELETE SET NULL`.
+    // Existing rows survive verbatim; future deletions detach audit rows
+    // from the project (project_id=NULL) instead of erasing them. SQLite
+    // can't change FK behavior in place — same canonical table-rebuild
+    // pattern v58 used for `query_snapshots`.
+    statements: [
+      `CREATE TABLE IF NOT EXISTS audit_log_v60 (
+         id           TEXT PRIMARY KEY,
+         project_id   TEXT REFERENCES projects(id) ON DELETE SET NULL,
+         actor        TEXT NOT NULL,
+         action       TEXT NOT NULL,
+         entity_type  TEXT NOT NULL,
+         entity_id    TEXT,
+         diff         TEXT,
+         created_at   TEXT NOT NULL
+       )`,
+      // LEFT JOIN guard mirrors v58: if a pre-existing row carries a
+      // dangling project_id (from a pre-FK era or a write with
+      // PRAGMA foreign_keys=OFF), the join nulls it out rather than
+      // failing the migration on the new FK validation.
+      `INSERT INTO audit_log_v60 (
+         id, project_id, actor, action, entity_type, entity_id, diff, created_at
+       )
+       SELECT a.id, p.id, a.actor, a.action, a.entity_type, a.entity_id, a.diff, a.created_at
+       FROM audit_log a
+       LEFT JOIN projects p ON p.id = a.project_id`,
+      `DROP TABLE audit_log`,
+      `ALTER TABLE audit_log_v60 RENAME TO audit_log`,
+      `CREATE INDEX IF NOT EXISTS idx_audit_log_project ON audit_log(project_id)`,
+      `CREATE INDEX IF NOT EXISTS idx_audit_log_created ON audit_log(created_at)`
+    ]
   }
 ];
 function isDuplicateColumnError(err) {
@@ -2074,19 +2129,26 @@ function filterTrackedSnapshots(rows) {
 }
 // ../intelligence/src/regressions.ts
+function snapshotKey(snap) {
+  const loc = snap.location ?? "__none__";
+  return JSON.stringify([snap.query, snap.provider, loc]);
+}
 function detectRegressions(currentRun, previousRun) {
+  if ((currentRun.location ?? null) !== (previousRun.location ?? null)) {
+    return [];
+  }
   const regressions = [];
   const previousCited = /* @__PURE__ */ new Map();
   for (const snap of previousRun.snapshots) {
     if (snap.cited) {
-      previousCited.set(`${snap.query}:${snap.provider}`, {
+      previousCited.set(snapshotKey(snap), {
         citationUrl: snap.citationUrl,
         position: snap.position
       });
     }
   }
   for (const snap of currentRun.snapshots) {
-    const key = `${snap.query}:${snap.provider}`;
+    const key = snapshotKey(snap);
     if (!snap.cited && previousCited.has(key)) {
       const prev = previousCited.get(key);
       regressions.push({
@@ -2103,16 +2165,23 @@ function detectRegressions(currentRun, previousRun) {
 }
 // ../intelligence/src/gains.ts
+function snapshotKey2(snap) {
+  const loc = snap.location ?? "__none__";
+  return JSON.stringify([snap.query, snap.provider, loc]);
+}
 function detectGains(currentRun, previousRun) {
+  if ((currentRun.location ?? null) !== (previousRun.location ?? null)) {
+    return [];
+  }
   const gains = [];
   const previousCited = /* @__PURE__ */ new Set();
   for (const snap of previousRun.snapshots) {
     if (snap.cited) {
-      previousCited.add(`${snap.query}:${snap.provider}`);
+      previousCited.add(snapshotKey2(snap));
     }
   }
   for (const snap of currentRun.snapshots) {
-    const key = `${snap.query}:${snap.provider}`;
+    const key = snapshotKey2(snap);
     if (snap.cited && !previousCited.has(key)) {
       gains.push({
         query: snap.query,
@@ -2173,17 +2242,26 @@ function computeHealthTrend(runs2) {
 // ../intelligence/src/causes.ts
 function analyzeCause(regression, currentSnapshots) {
-  const currentSnap = currentSnapshots.find(
-    (s) => s.query === regression.query && s.provider === regression.provider && !s.cited && s.competitorDomains && s.competitorDomains.length > 0
+  const matchingSnaps = currentSnapshots.filter(
+    (s) => s.query === regression.query && s.provider === regression.provider && !s.cited
   );
-  if (currentSnap) {
-    const competitor = currentSnap.competitorDomains[0];
+  const withCompetitor = matchingSnaps.find((s) => s.competitorDomains?.length);
+  if (withCompetitor) {
+    const competitor = withCompetitor.competitorDomains[0];
     return {
       cause: "competitor_gain",
       competitorDomain: competitor,
       details: `Competitor ${competitor} now cited for "${regression.query}" on ${regression.provider}`
     };
   }
+  const withCited = matchingSnaps.find((s) => s.citedDomains?.length);
+  if (withCited) {
+    const top = withCited.citedDomains.slice(0, 3);
+    return {
+      cause: "third_party_displacement",
+      details: `${regression.provider} now grounds on ${top.join(", ")} for "${regression.query}" \u2014 none are tracked competitors.`
+    };
+  }
   return {
     cause: "unknown",
     details: `No specific cause identified for loss of "${regression.query}" on ${regression.provider}`
@@ -2626,10 +2704,13 @@ function buildDrivers(input) {
   if (input.action === "create" && input.position === null) {
     drivers.push("no existing page");
   }
-  if (input.position !== null && input.position > 30) {
-    drivers.push(`page ranks #${input.position} (effectively invisible)`);
-  } else if (input.position !== null && input.position > 10) {
-    drivers.push(`page ranks #${input.position}`);
+  if (input.position !== null) {
+    const positionDisplay = Math.round(input.position);
+    if (input.position > 30) {
+      drivers.push(`page ranks #${positionDisplay} (effectively invisible)`);
+    } else if (input.position > 10) {
+      drivers.push(`page ranks #${positionDisplay}`);
+    }
   }
   if (input.action === "add-schema") {
     drivers.push("cited by LLMs but lacks structured data");
@@ -2900,7 +2981,7 @@ function classifyRegressionSeverity(signals) {
 }
 // ../intelligence/src/insight-grouping.ts
-function groupInsights(insights2, keyFn = (i) => `${i.query} ${i.provider} ${i.type}`) {
+function groupInsights(insights2, keyFn = (i) => JSON.stringify([i.query, i.provider, i.type])) {
   const order = [];
   const buckets = /* @__PURE__ */ new Map();
   for (const i of insights2) {
@@ -2932,14 +3013,15 @@ var MIN_BRAND_TOKEN_LENGTH = 3;
 function compact(value) {
   return value.toLowerCase().replace(/[^a-z0-9]/g, "");
 }
-function buildBrandTokens(canonicalDomain, displayName) {
+function buildBrandTokens(canonicalDomain, brandNames = []) {
   const seen = /* @__PURE__ */ new Set();
   const stem = canonicalDomain.toLowerCase().replace(/\.[a-z]{2,}$/, "");
   const stemCompact = compact(stem);
   if (stemCompact.length >= MIN_BRAND_TOKEN_LENGTH) seen.add(stemCompact);
-  if (displayName) {
-    const displayCompact = compact(displayName);
-    if (displayCompact.length >= MIN_BRAND_TOKEN_LENGTH) seen.add(displayCompact);
+  for (const name of brandNames) {
+    if (!name) continue;
+    const nameCompact = compact(name);
+    if (nameCompact.length >= MIN_BRAND_TOKEN_LENGTH) seen.add(nameCompact);
   }
   return [...seen];
 }
@@ -3086,7 +3168,7 @@ function extractHostFromUri(uri) {
 }
 // ../intelligence/src/mention-landscape.ts
-function buildMentionLandscape(snapshots, competitorDomains, projectDisplayName, projectDomains, queryLookup) {
+function buildMentionLandscape(snapshots, competitorDomains, projectBrandNames, projectDomains, queryLookup) {
   let projectMentionCount = 0;
   let totalAnswerSnapshots = 0;
   const competitorMap = /* @__PURE__ */ new Map();
@@ -3100,13 +3182,13 @@ function buildMentionLandscape(snapshots, competitorDomains, projectDisplayName,
     const q = queryLookup.byId.get(snap.queryId);
     const projectMentioned = snap.answerMentioned ?? determineAnswerMentioned(
       text2,
-      projectDisplayName,
+      [...projectBrandNames],
       [...projectDomains]
     );
     if (projectMentioned) projectMentionCount++;
     for (const competitor of competitorDomains) {
       const brand = brandLabelFromDomain(competitor);
-      const mentioned = determineAnswerMentioned(text2, brand, [competitor]);
+      const mentioned = determineAnswerMentioned(text2, brand ? [brand] : [], [competitor]);
       if (mentioned) {
         const entry = competitorMap.get(competitor);
         entry.count++;
@@ -3474,17 +3556,29 @@ var IntelligenceService = class {
       log.info("intelligence.skip", { runId, reason: "run not in recent completed list" });
       return null;
     }
-    const currentRun = this.buildRunData(runId, projectId, currentRunRecord.finishedAt ?? currentRunRecord.createdAt);
+    const currentRun = this.buildRunData(
+      runId,
+      projectId,
+      currentRunRecord.finishedAt ?? currentRunRecord.createdAt,
+      currentRunRecord.location ?? null
+    );
     if (currentRun.snapshots.length === 0) {
       log.info("intelligence.skip", { runId, reason: "no snapshots" });
       return null;
     }
     const orderedRecent = [...recentRuns].reverse();
-    const currentIdx = orderedRecent.findIndex((r) => r.id === runId);
-    const previousRunRecord = currentIdx > 0 ? orderedRecent[currentIdx - 1] : null;
-    const previousRun = previousRunRecord ? this.buildRunData(previousRunRecord.id, projectId, previousRunRecord.finishedAt ?? previousRunRecord.createdAt) : null;
+    const currentLocation = currentRunRecord.location ?? null;
+    const sameLocationOrdered = orderedRecent.filter((r) => (r.location ?? null) === currentLocation);
+    const currentLocIdx = sameLocationOrdered.findIndex((r) => r.id === runId);
+    const previousRunRecord = currentLocIdx > 0 ? sameLocationOrdered[currentLocIdx - 1] : null;
+    const previousRun = previousRunRecord ? this.buildRunData(
+      previousRunRecord.id,
+      projectId,
+      previousRunRecord.finishedAt ?? previousRunRecord.createdAt,
+      previousRunRecord.location ?? null
+    ) : null;
     const trackedCompetitors = this.loadTrackedCompetitors(projectId);
-    const history = orderedRecent.slice(0, currentIdx + 1).map((r) => r.id === runId ? currentRun : this.buildRunData(r.id, projectId, r.finishedAt ?? r.createdAt));
+    const history = sameLocationOrdered.slice(0, currentLocIdx + 1).map((r) => r.id === runId ? currentRun : this.buildRunData(r.id, projectId, r.finishedAt ?? r.createdAt, r.location ?? null));
     if (!previousRun) {
       const result2 = analyzeRuns(currentRun, currentRun, { trackedCompetitors, history });
       log.info("intelligence.analyzed", {
@@ -3519,13 +3613,23 @@ var IntelligenceService = class {
    * Used by backfill where we control the run ordering.
    */
   analyzeRunWithPrevious(runRecord, previousRunRecord, historyRecords) {
-    const currentRun = this.buildRunData(runRecord.id, runRecord.projectId, runRecord.finishedAt ?? runRecord.createdAt);
+    const currentRun = this.buildRunData(
+      runRecord.id,
+      runRecord.projectId,
+      runRecord.finishedAt ?? runRecord.createdAt,
+      runRecord.location ?? null
+    );
     if (currentRun.snapshots.length === 0) {
       return null;
     }
-    const previousRun = previousRunRecord ? this.buildRunData(previousRunRecord.id, previousRunRecord.projectId, previousRunRecord.finishedAt ?? previousRunRecord.createdAt) : null;
+    const previousRun = previousRunRecord ? this.buildRunData(
+      previousRunRecord.id,
+      previousRunRecord.projectId,
+      previousRunRecord.finishedAt ?? previousRunRecord.createdAt,
+      previousRunRecord.location ?? null
+    ) : null;
     const trackedCompetitors = this.loadTrackedCompetitors(runRecord.projectId);
-    const history = (historyRecords ?? []).map((r) => r.id === runRecord.id ? currentRun : this.buildRunData(r.id, r.projectId, r.finishedAt ?? r.createdAt));
+    const history = (historyRecords ?? []).map((r) => r.id === runRecord.id ? currentRun : this.buildRunData(r.id, r.projectId, r.finishedAt ?? r.createdAt, r.location ?? null));
     if (!previousRun) {
       const result2 = analyzeRuns(currentRun, currentRun, { trackedCompetitors, history });
       this.persistResult(this.emptyAnalysisResult(result2), runRecord.id, runRecord.projectId);
@@ -3569,10 +3673,12 @@ var IntelligenceService = class {
     let totalInsights = 0;
     for (let i = 0; i < targetRuns.length; i++) {
       const run = targetRuns[i];
-      const globalIdx = allRuns.indexOf(run);
-      const previousRun = globalIdx > 0 ? allRuns[globalIdx - 1] : null;
-      const historyStart = Math.max(0, globalIdx - (HISTORY_WINDOW_RUNS - 1));
-      const historyRecords = allRuns.slice(historyStart, globalIdx + 1);
+      const runLocation = run.location ?? null;
+      const sameLocationRuns = allRuns.filter((r) => (r.location ?? null) === runLocation);
+      const sameLocIdx = sameLocationRuns.indexOf(run);
+      const previousRun = sameLocIdx > 0 ? sameLocationRuns[sameLocIdx - 1] : null;
+      const historyStart = Math.max(0, sameLocIdx - (HISTORY_WINDOW_RUNS - 1));
+      const historyRecords = sameLocationRuns.slice(historyStart, sameLocIdx + 1);
       const result = this.analyzeRunWithPrevious(run, previousRun, historyRecords);
       if (result) {
         processed++;
@@ -3729,13 +3835,14 @@ var IntelligenceService = class {
       return { ...insight, severity };
     });
   }
-  buildRunData(runId, projectId, completedAt) {
+  buildRunData(runId, projectId, completedAt, location = null) {
     const rows = this.db.select({
       query: queries.query,
       provider: querySnapshots.provider,
       citationState: querySnapshots.citationState,
       citedDomains: querySnapshots.citedDomains,
-      competitorOverlap: querySnapshots.competitorOverlap
+      competitorOverlap: querySnapshots.competitorOverlap,
+      snapshotLocation: querySnapshots.location
     }).from(querySnapshots).leftJoin(queries, eq(querySnapshots.queryId, queries.id)).where(eq(querySnapshots.runId, runId)).all();
     const snapshots = rows.map((r) => {
       const domains = parseJsonColumn(r.citedDomains, []);
@@ -3745,10 +3852,20 @@ var IntelligenceService = class {
         provider: r.provider,
         cited: r.citationState === CitationStates.cited,
         citationUrl: domains[0] ?? void 0,
-        competitorDomains: competitors2
+        // 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
+        // we read it from the snapshot row so a stale runs.location can't
+        // mask snapshot truth.
+        location: r.snapshotLocation ?? location ?? null,
+        competitorDomains: competitors2,
+        // citedDomains is the FULL set (tracked competitors + third-party
+        // sources). Cause analysis uses it to name the displacing source
+        // when no tracked competitor appears in the response.
+        citedDomains: domains
       };
     });
-    return { runId, projectId, completedAt, snapshots };
+    return { runId, projectId, completedAt, location, snapshots };
   }
 };