@ainyc/canonry 4.1.1 → 4.2.2

package/dist/{chunk-BQN6BBHI.js → chunk-HJZY4EOE.js}

@@ -4,8 +4,9 @@ import {
   configExists,
   loadConfig,
   saveConfigPatch
-} from "./chunk-KCETXLDF.js";
+} from "./chunk-SR7TGHHG.js";
 import {
+  DEFAULT_RUN_HISTORY_LIMIT,
   IntelligenceService,
   MIN_TREND_POINTS,
   agentMemory,
@@ -16,11 +17,22 @@ import {
   backlinkSummaries,
   bingCoverageSnapshots,
   bingUrlInspections,
+  buildAiSourceOrigin,
   buildBrandTokens,
+  buildCitationScorecard,
+  buildCompetitorLandscape,
+  buildCompetitorPressureScore,
   buildContentGapRows,
   buildContentSourceRows,
   buildContentTargetRows,
+  buildGapQueryScore,
   buildInventory,
+  buildMentionLandscape,
+  buildMovementSummary,
+  buildOverviewCompetitors,
+  buildProviderScores,
+  buildRunHistory,
+  buildVisibilityScore,
   categorizeQueryByIntent,
   ccReleaseSyncs,
   competitors,
@@ -49,7 +61,7 @@ import {
   runs,
   schedules,
   usageCounters
-} from "./chunk-NCWCPBOT.js";
+} from "./chunk-7YSI4GFA.js";
 import {
   AGENT_MEMORY_VALUE_MAX_BYTES,
   AGENT_PROVIDER_IDS,
@@ -115,7 +127,7 @@ import {
   visibilityStateFromAnswerMentioned,
   windowCutoff,
   wordpressEnvSchema
-} from "./chunk-O5JZQUPX.js";
+} from "./chunk-T2I6AO7D.js";
 
 // src/telemetry.ts
 import crypto from "crypto";
@@ -1946,7 +1958,7 @@ async function historyRoutes(app) {
     for (const snap of allSnapshots) {
       const key = `${snap.runId}:${snap.queryId}`;
       const existing = deduped.get(key);
-      if (!existing || !existing.answerMentioned && snap.answerMentioned || existing.answerMentioned === snap.answerMentioned && snap.citationState === "cited") {
+      if (!existing || !existing.answerMentioned && snap.answerMentioned || existing.answerMentioned === snap.answerMentioned && snap.citationState === CitationStates.cited) {
         deduped.set(key, snap);
       }
     }
@@ -1968,16 +1980,16 @@ async function historyRoutes(app) {
     function computeTransitions(snaps) {
       return snaps.map((snap, idx) => {
         const run = projectRuns.find((r) => r.id === snap.runId);
-        let transition = snap.citationState === "cited" ? "cited" : "not-cited";
+        let transition = snap.citationState === CitationStates.cited ? "cited" : "not-cited";
         let visibilityTransition = snap.answerMentioned ? "visible" : "not-visible";
         if (idx === 0) {
           transition = "new";
           visibilityTransition = "new";
         } else {
           const prev = snaps[idx - 1];
-          if (prev.citationState === "not-cited" && snap.citationState === "cited") {
+          if (prev.citationState === CitationStates["not-cited"] && snap.citationState === CitationStates.cited) {
             transition = "emerging";
-          } else if (prev.citationState === "cited" && snap.citationState === "not-cited") {
+          } else if (prev.citationState === CitationStates.cited && snap.citationState === CitationStates["not-cited"]) {
             transition = "lost";
           }
           if (!prev.answerMentioned && snap.answerMentioned) {
@@ -2051,7 +2063,7 @@ async function historyRoutes(app) {
         resolvedVisibilityState: resolveSnapshotVisibilityState(s, project)
       };
       const existing = map1.get(s.queryId);
-      if (!existing || !existing.resolvedAnswerMentioned && resolved.resolvedAnswerMentioned || existing.resolvedAnswerMentioned === resolved.resolvedAnswerMentioned && resolved.citationState === "cited") {
+      if (!existing || !existing.resolvedAnswerMentioned && resolved.resolvedAnswerMentioned || existing.resolvedAnswerMentioned === resolved.resolvedAnswerMentioned && resolved.citationState === CitationStates.cited) {
         map1.set(s.queryId, resolved);
       }
     }
@@ -2063,7 +2075,7 @@ async function historyRoutes(app) {
         resolvedVisibilityState: resolveSnapshotVisibilityState(s, project)
       };
       const existing = map2.get(s.queryId);
-      if (!existing || !existing.resolvedAnswerMentioned && resolved.resolvedAnswerMentioned || existing.resolvedAnswerMentioned === resolved.resolvedAnswerMentioned && resolved.citationState === "cited") {
+      if (!existing || !existing.resolvedAnswerMentioned && resolved.resolvedAnswerMentioned || existing.resolvedAnswerMentioned === resolved.resolvedAnswerMentioned && resolved.citationState === CitationStates.cited) {
         map2.set(s.queryId, resolved);
       }
     }
@@ -2177,7 +2189,7 @@ async function analyticsRoutes(app) {
           consistencyMap.set(s.queryId, entry);
         }
         entry.totalRuns.add(s.runId);
-        if (s.citationState === "cited") entry.citedRuns.add(s.runId);
+        if (s.citationState === CitationStates.cited) entry.citedRuns.add(s.runId);
         if (resolveSnapshotAnswerMentioned(s, project)) entry.mentionedRuns.add(s.runId);
       }
     }
@@ -2209,7 +2221,7 @@ async function analyticsRoutes(app) {
     const notMentioned = [];
     for (const [queryId, qSnapshots] of byQuery) {
       const query = qSnapshots[0]?.query ?? "";
-      const citedProviders = qSnapshots.filter((s) => s.citationState === "cited").map((s) => s.provider);
+      const citedProviders = qSnapshots.filter((s) => s.citationState === CitationStates.cited).map((s) => s.provider);
       const mentionedProviders = qSnapshots.filter((s) => s.resolvedMentioned).map((s) => s.provider);
       const competitorsCiting = /* @__PURE__ */ new Set();
       for (const s of qSnapshots) {
@@ -2338,7 +2350,7 @@ function bucketSizeForSpan(spanDays) {
 }
 function computeProviderMetric(snapshots) {
   const total = snapshots.length;
-  const cited = snapshots.filter((s) => s.citationState === "cited").length;
+  const cited = snapshots.filter((s) => s.citationState === CitationStates.cited).length;
   const mentionedCount = snapshots.filter((s) => s.resolvedMentioned).length;
   return {
     citationRate: total > 0 ? Math.round(cited / total * 1e4) / 1e4 : 0,
@@ -2967,7 +2979,7 @@ function renderCitationMatrix(scorecard) {
       if (!cell) {
         return '<td><span class="cell-pending">\u2014</span></td>';
       }
-      if (cell.citationState === "cited") {
+      if (cell.citationState === CitationStates.cited) {
         return '<td><span class="cell-cited">Cited</span></td>';
       }
       return '<td><span class="cell-not-cited">Not cited</span></td>';
@@ -3846,7 +3858,6 @@ function extractPath(url) {
 var TOP_QUERIES_LIMIT = 20;
 var TOP_LANDING_PAGES_LIMIT = 20;
 var TOP_AI_REFERRAL_PAGES_LIMIT = 10;
-var TOP_SOURCE_DOMAINS_LIMIT = 20;
 var TOP_CAMPAIGN_LIMIT = 10;
 var INSIGHT_LOOKBACK_RUNS = 5;
 function safeNum(value) {
@@ -3857,14 +3868,6 @@ function safeNum(value) {
   }
   return 0;
 }
-function citedDomainBelongsToProject(citedDomain, projectDomains) {
-  const candidate = normalizeProjectDomain(citedDomain);
-  for (const domain of projectDomains) {
-    const normalized = normalizeProjectDomain(domain);
-    if (candidate === normalized || candidate.endsWith(`.${normalized}`)) return true;
-  }
-  return false;
-}
 function categorizeQuery(query, projectDisplayName, canonicalDomain) {
   return categorizeQueryByIntent(query, buildBrandTokens(canonicalDomain, projectDisplayName));
 }
@@ -3891,186 +3894,6 @@ function loadQueryLookup(db, projectId) {
   for (const row of rows) byId.set(row.id, row.query);
   return { byId };
 }
-function buildCitationScorecard(snapshots, queryLookup) {
-  if (snapshots.length === 0) {
-    return { queries: [], providers: [], matrix: [], providerRates: [] };
-  }
-  const querySet = /* @__PURE__ */ new Set();
-  const providerSet = /* @__PURE__ */ new Set();
-  for (const snap of snapshots) {
-    const q = queryLookup.byId.get(snap.queryId);
-    if (!q) continue;
-    querySet.add(q);
-    providerSet.add(snap.provider);
-  }
-  const queryList = [...querySet].sort();
-  const providerList = [...providerSet].sort();
-  const matrix = queryList.map(
-    () => providerList.map(() => null)
-  );
-  const providerCounts = /* @__PURE__ */ new Map();
-  for (const snap of snapshots) {
-    const q = queryLookup.byId.get(snap.queryId);
-    if (!q) continue;
-    const qi = queryList.indexOf(q);
-    const pi = providerList.indexOf(snap.provider);
-    if (qi < 0 || pi < 0) continue;
-    matrix[qi][pi] = {
-      citationState: snap.citationState === "cited" ? "cited" : "not-cited",
-      answerMentioned: snap.answerMentioned ?? null,
-      model: snap.model
-    };
-    const counts = providerCounts.get(snap.provider) ?? { cited: 0, total: 0 };
-    counts.total++;
-    if (snap.citationState === "cited") counts.cited++;
-    providerCounts.set(snap.provider, counts);
-  }
-  const providerRates = providerList.map((provider) => {
-    const counts = providerCounts.get(provider) ?? { cited: 0, total: 0 };
-    const citationRate = counts.total > 0 ? Math.round(counts.cited / counts.total * 100) : 0;
-    return {
-      provider,
-      citedCount: counts.cited,
-      totalCount: counts.total,
-      citationRate
-    };
-  });
-  return { queries: queryList, providers: providerList, matrix, providerRates };
-}
-function buildCompetitorLandscape(snapshots, competitorDomains, projectDomains, queryLookup) {
-  let projectCitationCount = 0;
-  const competitorMap = /* @__PURE__ */ new Map();
-  for (const c of competitorDomains) {
-    competitorMap.set(c, { count: 0, queries: /* @__PURE__ */ new Set(), pages: /* @__PURE__ */ new Map() });
-  }
-  for (const snap of snapshots) {
-    const q = queryLookup.byId.get(snap.queryId);
-    const allDomains = [...snap.citedDomains, ...snap.competitorOverlap];
-    if (allDomains.some((d) => citedDomainBelongsToProject(d, projectDomains))) {
-      projectCitationCount++;
-    }
-    for (const competitor of competitorDomains) {
-      if (allDomains.some((d) => citedDomainBelongsToProject(d, [competitor]))) {
-        const entry = competitorMap.get(competitor);
-        entry.count++;
-        if (q) entry.queries.add(q);
-      }
-      const competitorNorm = normalizeDomain(competitor);
-      for (const gs of snap.groundingSources) {
-        const host = normalizeDomain(extractHostFromUri(gs.uri));
-        if (!host) continue;
-        if (host === competitorNorm || host.endsWith(`.${competitorNorm}`)) {
-          const entry = competitorMap.get(competitor);
-          const pageQueries = entry.pages.get(gs.uri) ?? /* @__PURE__ */ new Set();
-          if (q) pageQueries.add(q);
-          entry.pages.set(gs.uri, pageQueries);
-        }
-      }
-    }
-  }
-  const totalCitedSlots = projectCitationCount + [...competitorMap.values()].reduce((sum, v) => sum + v.count, 0);
-  const competitorRows = [...competitorMap.entries()].map(([domain, data]) => {
-    const total = snapshots.length;
-    const ratio = total > 0 ? data.count / total : 0;
-    let pressureLabel = "None";
-    if (data.count > 0) {
-      if (ratio >= 0.5) pressureLabel = "High";
-      else if (ratio >= 0.2) pressureLabel = "Moderate";
-      else pressureLabel = "Low";
-    }
-    const sharePct = totalCitedSlots > 0 ? Math.round(data.count / totalCitedSlots * 100) : 0;
-    const theirCitedPages = [...data.pages.entries()].map(([url, qs]) => ({ url, citedFor: [...qs].sort() })).sort((a, b) => b.citedFor.length - a.citedFor.length);
-    return {
-      domain,
-      citationCount: data.count,
-      totalCount: total,
-      pressureLabel,
-      citedQueries: [...data.queries].sort(),
-      sharePct,
-      theirCitedPages
-    };
-  });
-  competitorRows.sort((a, b) => b.citationCount - a.citationCount);
-  return { projectCitationCount, competitors: competitorRows };
-}
-function buildMentionLandscape(snapshots, competitorDomains, projectDisplayName, projectDomains, queryLookup) {
-  let projectMentionCount = 0;
-  let totalAnswerSnapshots = 0;
-  const competitorMap = /* @__PURE__ */ new Map();
-  for (const c of competitorDomains) {
-    competitorMap.set(c, { count: 0, queries: /* @__PURE__ */ new Set() });
-  }
-  for (const snap of snapshots) {
-    const text = snap.answerText;
-    if (!text) continue;
-    totalAnswerSnapshots++;
-    const q = queryLookup.byId.get(snap.queryId);
-    const projectMentioned = snap.answerMentioned ?? determineAnswerMentioned(
-      text,
-      projectDisplayName,
-      projectDomains
-    );
-    if (projectMentioned) projectMentionCount++;
-    for (const competitor of competitorDomains) {
-      const brand = brandLabelFromDomain(competitor);
-      const mentioned = determineAnswerMentioned(text, brand, [competitor]);
-      if (mentioned) {
-        const entry = competitorMap.get(competitor);
-        entry.count++;
-        if (q) entry.queries.add(q);
-      }
-    }
-  }
-  const totalMentionedSlots = projectMentionCount + [...competitorMap.values()].reduce((sum, v) => sum + v.count, 0);
-  const competitorRows = [...competitorMap.entries()].map(([domain, data]) => {
-    const ratio = totalAnswerSnapshots > 0 ? data.count / totalAnswerSnapshots : 0;
-    let pressureLabel = "None";
-    if (data.count > 0) {
-      if (ratio >= 0.5) pressureLabel = "High";
-      else if (ratio >= 0.2) pressureLabel = "Moderate";
-      else pressureLabel = "Low";
-    }
-    const sharePct = totalMentionedSlots > 0 ? Math.round(data.count / totalMentionedSlots * 100) : 0;
-    return {
-      domain,
-      mentionCount: data.count,
-      totalCount: totalAnswerSnapshots,
-      pressureLabel,
-      mentionedQueries: [...data.queries].sort(),
-      sharePct
-    };
-  });
-  competitorRows.sort((a, b) => b.mentionCount - a.mentionCount);
-  return { projectMentionCount, totalAnswerSnapshots, competitors: competitorRows };
-}
-function buildAiSourceOrigin(snapshots, projectDomains, competitorDomains) {
-  const categoryCounts = /* @__PURE__ */ new Map();
-  const domainCounts = /* @__PURE__ */ new Map();
-  let totalCitations = 0;
-  for (const snap of snapshots) {
-    for (const raw of snap.citedDomains) {
-      if (citedDomainBelongsToProject(raw, projectDomains)) continue;
-      const { category, label, domain } = categorizeSource(raw);
-      const cat = categoryCounts.get(category) ?? { label, count: 0 };
-      cat.count++;
-      categoryCounts.set(category, cat);
-      domainCounts.set(domain, (domainCounts.get(domain) ?? 0) + 1);
-      totalCitations++;
-    }
-  }
-  const categories = [...categoryCounts.entries()].map(([category, { label, count }]) => ({
-    category,
-    label,
-    count,
-    sharePct: totalCitations > 0 ? Math.round(count / totalCitations * 100) : 0
-  })).sort((a, b) => b.count - a.count);
-  const topDomains = [...domainCounts.entries()].map(([domain, count]) => ({
-    domain,
-    count,
-    isCompetitor: citedDomainBelongsToProject(domain, competitorDomains)
-  })).sort((a, b) => b.count - a.count).slice(0, TOP_SOURCE_DOMAINS_LIMIT);
-  return { categories, topDomains };
-}
 function buildGscSection(db, projectId, projectDisplayName, canonicalDomain, trackedQueries) {
   const rows = db.select().from(gscSearchData).where(eq13(gscSearchData.projectId, projectId)).all();
   if (rows.length === 0) return null;
@@ -4319,10 +4142,10 @@ function buildCitationsTrend(db, projectId, queryLookup) {
     for (const snap of snaps) {
       if (!queryLookup.byId.has(snap.queryId)) continue;
       considered++;
-      if (snap.citationState === "cited") cited++;
+      if (snap.citationState === CitationStates.cited) cited++;
       const counts = providerCounts.get(snap.provider) ?? { cited: 0, total: 0 };
       counts.total++;
-      if (snap.citationState === "cited") counts.cited++;
+      if (snap.citationState === CitationStates.cited) counts.cited++;
       providerCounts.set(snap.provider, counts);
     }
     if (considered === 0) continue;
@@ -4523,7 +4346,7 @@ function buildProjectReport(db, projectName) {
   for (const snap of latestSnapshots) {
     if (!queryLookup.byId.has(snap.queryId)) continue;
     latestConsidered++;
-    if (snap.citationState === "cited") latestCited++;
+    if (snap.citationState === CitationStates.cited) latestCited++;
   }
   const citationRate = latestConsidered > 0 ? Math.round(latestCited / latestConsidered * 100) : 0;
   const trendBaseline = isTrendBaseline(citationsTrend);
@@ -4785,24 +4608,68 @@ function normalizeDomain2(domain) {
 }
 
 // ../api-routes/src/composites.ts
-import { eq as eq15, and as and5, desc as desc7, sql as sql3, like, or as or3 } from "drizzle-orm";
+import { eq as eq15, and as and5, desc as desc7, sql as sql3, like, or as or3, inArray as inArray6 } from "drizzle-orm";
 var TOP_INSIGHT_LIMIT = 5;
 var SEARCH_HIT_HARD_LIMIT = 50;
 var SEARCH_SNIPPET_RADIUS = 80;
 async function compositeRoutes(app) {
   app.get("/projects/:name/overview", async (request, reply) => {
     const project = resolveProject(app.db, request.params.name);
-    const totalRunsRow = app.db.select({ count: sql3`count(*)` }).from(runs).where(eq15(runs.projectId, project.id)).get();
-    const totalRuns = totalRunsRow?.count ?? 0;
-    const recentRuns = app.db.select().from(runs).where(eq15(runs.projectId, project.id)).orderBy(desc7(runs.createdAt)).limit(2).all();
-    const [latestRunRow, previousRunRow] = recentRuns;
+    const filterLocation = (request.query.location ?? "").trim() || null;
+    const sinceIso = parseSinceFilter(request.query.since);
+    const allRunsRaw = app.db.select().from(runs).where(eq15(runs.projectId, project.id)).orderBy(desc7(runs.createdAt)).all();
+    const allRuns = allRunsRaw.filter((r) => runMatchesFilters(r, filterLocation, sinceIso));
+    const totalRuns = allRuns.length;
+    const visibilityRuns = allRuns.filter((r) => r.kind === RunKinds["answer-visibility"]);
+    const completedVisRuns = visibilityRuns.filter(
+      (r) => r.status === RunStatuses.completed || r.status === RunStatuses.partial
+    );
+    const latestVisibilityRun = completedVisRuns[0] ?? null;
+    const previousVisibilityRun = completedVisRuns[1] ?? null;
+    const latestRunRow = allRuns[0] ?? null;
     const latestRun = latestRunRow ? { totalRuns, run: summarizeRun(latestRunRow) } : { totalRuns: 0, run: null };
     const healthRow = app.db.select().from(healthSnapshots).where(eq15(healthSnapshots.projectId, project.id)).orderBy(desc7(healthSnapshots.createdAt)).limit(1).get();
     const health = healthRow ? mapHealthRow2(healthRow) : null;
     const insightRows = app.db.select().from(insights).where(eq15(insights.projectId, project.id)).orderBy(desc7(insights.createdAt)).all();
     const topInsights = insightRows.filter((row) => !row.dismissed).slice(0, TOP_INSIGHT_LIMIT).map(mapInsightRow2);
-    const { queryCounts, providers } = summarizeLatestRun(app, latestRunRow ?? null);
-    const transitions = summarizeTransitions(app, latestRunRow ?? null, previousRunRow ?? null);
+    const sparklineRunIds = visibilityRuns.slice(0, DEFAULT_RUN_HISTORY_LIMIT).map((r) => r.id);
+    const snapshotRunIds = new Set(sparklineRunIds);
+    if (latestVisibilityRun) snapshotRunIds.add(latestVisibilityRun.id);
+    if (previousVisibilityRun) snapshotRunIds.add(previousVisibilityRun.id);
+    const snapshotsByRun = loadSnapshotsByRunIds(app, [...snapshotRunIds]);
+    const latestSnapshots = latestVisibilityRun ? snapshotsByRun.get(latestVisibilityRun.id) ?? [] : [];
+    const previousSnapshots = previousVisibilityRun ? snapshotsByRun.get(previousVisibilityRun.id) ?? [] : [];
+    const { queryCounts, providers } = summarizeFromSnapshots(latestSnapshots);
+    const transitions = summarizeTransitionsFromSnapshots(
+      latestSnapshots,
+      previousSnapshots,
+      previousVisibilityRun?.createdAt ?? null
+    );
+    const competitorRows = app.db.select().from(competitors).where(eq15(competitors.projectId, project.id)).all();
+    const projectQueries = app.db.select({ id: queries.id, query: queries.query }).from(queries).where(eq15(queries.projectId, project.id)).all();
+    const queryLookup = { byId: new Map(projectQueries.map((q) => [q.id, q.query])) };
+    const configuredApiProviders = parseJsonColumn(project.providers, []).filter((p) => !p.startsWith("cdp:"));
+    const scores = {
+      visibility: buildVisibilityScore(latestSnapshots, { configuredApiProviders }),
+      gapQueries: buildGapQueryScore(latestSnapshots),
+      indexCoverage: buildIndexCoverageScore(app, project.id),
+      competitorPressure: buildCompetitorPressureScore(
+        latestSnapshots,
+        competitorRows.map((c) => c.domain),
+        competitorRows.length
+      ),
+      runStatus: buildRunStatusScore(allRuns)
+    };
+    const movementSummary = buildMovementSummary(latestSnapshots, previousSnapshots);
+    const providerScores = buildProviderScores(latestSnapshots);
+    const overviewCompetitors = buildOverviewCompetitors(
+      latestSnapshots,
+      competitorRows.map((c) => ({ id: c.id, domain: c.domain })),
+      queryLookup
+    );
+    const attentionItems = buildAttentionItems(insightRows, allRuns);
+    const sparklineRuns = visibilityRuns.slice(0, DEFAULT_RUN_HISTORY_LIMIT).map((r) => ({ id: r.id, createdAt: r.createdAt, status: r.status }));
+    const runHistory = buildRunHistory(sparklineRuns, snapshotsByRun);
     const result = {
       project: formatProject2(project),
       latestRun,
@@ -4810,7 +4677,15 @@ async function compositeRoutes(app) {
       topInsights,
       queryCounts,
       providers,
-      transitions
+      transitions,
+      scores,
+      movementSummary,
+      competitors: overviewCompetitors,
+      providerScores,
+      attentionItems,
+      runHistory,
+      dateRangeLabel: "All time",
+      contextLabel: `${project.country} / ${project.language.toUpperCase()}`
     };
     return reply.send(result);
   });
@@ -4876,6 +4751,21 @@ async function compositeRoutes(app) {
     return reply.send(response);
   });
 }
+function parseSinceFilter(raw) {
+  if (!raw) return null;
+  const trimmed = raw.trim();
+  if (!trimmed) return null;
+  const parsed = Date.parse(trimmed);
+  if (Number.isNaN(parsed)) {
+    throw validationError('"since" must be an ISO 8601 datetime');
+  }
+  return new Date(parsed).toISOString();
+}
+function runMatchesFilters(run, location, sinceIso) {
+  if (location !== null && (run.location ?? "") !== location) return false;
+  if (sinceIso !== null && run.createdAt < sinceIso) return false;
+  return true;
+}
 function clampSearchLimit(raw) {
   if (!raw) return 25;
   const parsed = Number.parseInt(raw, 10);
@@ -4901,29 +4791,49 @@ function summarizeRun(run) {
     createdAt: run.createdAt
   };
 }
-function summarizeLatestRun(app, run) {
+function loadSnapshotsByRunIds(app, runIds) {
+  const result = /* @__PURE__ */ new Map();
+  if (runIds.length === 0) return result;
+  const rows = app.db.select({
+    runId: querySnapshots.runId,
+    queryId: querySnapshots.queryId,
+    provider: querySnapshots.provider,
+    model: querySnapshots.model,
+    citationState: querySnapshots.citationState,
+    competitorOverlap: querySnapshots.competitorOverlap,
+    citedDomains: querySnapshots.citedDomains
+  }).from(querySnapshots).where(inArray6(querySnapshots.runId, [...runIds])).all();
+  for (const row of rows) {
+    const list = result.get(row.runId) ?? [];
+    list.push({
+      queryId: row.queryId,
+      provider: row.provider,
+      model: row.model,
+      citationState: row.citationState,
+      competitorOverlap: parseJsonColumn(row.competitorOverlap, []),
+      citedDomains: parseJsonColumn(row.citedDomains, [])
+    });
+    result.set(row.runId, list);
+  }
+  return result;
+}
+function summarizeFromSnapshots(snapshots) {
   const empty = {
     queryCounts: { totalQueries: 0, citedQueries: 0, notCitedQueries: 0, citedRate: 0 },
     providers: []
   };
-  if (!run) return empty;
-  const rows = app.db.select({
-    queryId: querySnapshots.queryId,
-    provider: querySnapshots.provider,
-    citationState: querySnapshots.citationState
-  }).from(querySnapshots).where(eq15(querySnapshots.runId, run.id)).all();
-  if (rows.length === 0) return empty;
+  if (snapshots.length === 0) return empty;
   const perQuery = /* @__PURE__ */ new Map();
   const perProvider = /* @__PURE__ */ new Map();
-  for (const row of rows) {
-    const cited = row.citationState === "cited";
-    if (!perQuery.has(row.queryId) || cited) {
-      perQuery.set(row.queryId, cited);
+  for (const snap of snapshots) {
+    const cited = snap.citationState === CitationStates.cited;
+    if (!perQuery.has(snap.queryId) || cited) {
+      perQuery.set(snap.queryId, cited);
     }
-    const bucket = perProvider.get(row.provider) ?? { cited: 0, total: 0 };
+    const bucket = perProvider.get(snap.provider) ?? { cited: 0, total: 0 };
     bucket.total += 1;
     if (cited) bucket.cited += 1;
-    perProvider.set(row.provider, bucket);
+    perProvider.set(snap.provider, bucket);
   }
   const totalQueries = perQuery.size;
   let citedQueries = 0;
@@ -4943,23 +4853,20 @@ function summarizeLatestRun(app, run) {
     providers
   };
 }
-function summarizeTransitions(app, latest, previous) {
-  const empty = { since: null, gained: 0, lost: 0, emerging: 0 };
-  if (!latest || !previous) return empty;
-  const fetchCited = (runId) => {
-    const rows = app.db.select({
-      queryId: querySnapshots.queryId,
-      citationState: querySnapshots.citationState
-    }).from(querySnapshots).where(eq15(querySnapshots.runId, runId)).all();
-    const map = /* @__PURE__ */ new Map();
-    for (const row of rows) {
-      const cited = row.citationState === "cited";
-      if (!map.has(row.queryId) || cited) map.set(row.queryId, cited);
+function summarizeTransitionsFromSnapshots(latest, previous, since) {
+  if (!since || previous.length === 0) {
+    return { since: null, gained: 0, lost: 0, emerging: 0 };
+  }
+  const buildMap = (snaps) => {
+    const m = /* @__PURE__ */ new Map();
+    for (const s of snaps) {
+      const cited = s.citationState === CitationStates.cited;
+      if (!m.has(s.queryId) || cited) m.set(s.queryId, cited);
     }
-    return map;
+    return m;
   };
-  const latestMap = fetchCited(latest.id);
-  const previousMap = fetchCited(previous.id);
+  const latestMap = buildMap(latest);
+  const previousMap = buildMap(previous);
   let gained = 0;
   let lost = 0;
   let emerging = 0;
@@ -4972,7 +4879,142 @@ function summarizeTransitions(app, latest, previous) {
     if (latestCited && !previousCited) gained += 1;
     else if (!latestCited && previousCited) lost += 1;
   }
-  return { since: previous.createdAt, gained, lost, emerging };
+  return { since, gained, lost, emerging };
+}
+function buildIndexCoverageScore(app, projectId) {
+  const tooltip = "Percentage of inspected URLs currently indexed. Google Search Console is preferred when available, otherwise Bing Webmaster Tools is used.";
+  const empty = {
+    label: "Index Coverage",
+    value: "No data",
+    delta: "Connect GSC or Bing",
+    tone: "neutral",
+    description: "Connect Google Search Console or Bing Webmaster Tools and inspect your sitemap to populate coverage.",
+    tooltip,
+    trend: []
+  };
+  const gscRow = app.db.select().from(gscCoverageSnapshots).where(eq15(gscCoverageSnapshots.projectId, projectId)).orderBy(desc7(gscCoverageSnapshots.date)).limit(1).get();
+  const bingRow = app.db.select().from(bingCoverageSnapshots).where(eq15(bingCoverageSnapshots.projectId, projectId)).orderBy(desc7(bingCoverageSnapshots.date)).limit(1).get();
+  const chosen = pickIndexCoverageRow(gscRow, bingRow);
+  if (!chosen) return empty;
+  const total = chosen.indexed + chosen.notIndexed;
+  if (total === 0) return empty;
+  const deindexed = chosen.provider === "Google" ? countGoogleDeindexedUrls(app, projectId) : 0;
+  const percentage = chosen.indexed / total * 100;
+  const tone = deindexed > 0 ? "negative" : percentage >= 90 ? "positive" : percentage >= 70 ? "caution" : "negative";
+  const notIndexedLabel = chosen.notIndexed === 1 ? "URL is" : "URLs are";
+  const deindexedLabel = deindexed === 1 ? "URL" : "URLs";
+  return {
+    label: "Index Coverage",
+    value: `${Math.round(percentage)}`,
+    delta: `${chosen.provider} \xB7 ${chosen.indexed} of ${total} indexed`,
+    tone,
+    description: deindexed > 0 ? `${deindexed} deindexed ${deindexedLabel} detected in the latest Google Search Console inspection.` : `${chosen.notIndexed} ${notIndexedLabel} not indexed in ${chosen.provider === "Google" ? "Google Search Console" : "Bing Webmaster Tools"}.`,
+    tooltip,
+    trend: [],
+    progress: Math.round(percentage)
+  };
+}
+function countGoogleDeindexedUrls(app, projectId) {
+  const rows = app.db.select({
+    url: gscUrlInspections.url,
+    indexingState: gscUrlInspections.indexingState,
+    inspectedAt: gscUrlInspections.inspectedAt
+  }).from(gscUrlInspections).where(eq15(gscUrlInspections.projectId, projectId)).orderBy(desc7(gscUrlInspections.inspectedAt)).all();
+  if (rows.length === 0) return 0;
+  const canonicalUrl = (url) => url.replace(/^http:\/\//, "https://");
+  const historyByUrl = /* @__PURE__ */ new Map();
+  for (const row of rows) {
+    const key = canonicalUrl(row.url);
+    const list = historyByUrl.get(key);
+    if (list) list.push(row);
+    else historyByUrl.set(key, [row]);
+  }
+  let deindexed = 0;
+  for (const history of historyByUrl.values()) {
+    if (history.length < 2) continue;
+    const latest = history[0];
+    const previous = history[1];
+    if (previous.indexingState === "INDEXING_ALLOWED" && latest.indexingState !== "INDEXING_ALLOWED") {
+      deindexed++;
+    }
+  }
+  return deindexed;
+}
+function pickIndexCoverageRow(gsc, bing) {
+  if (gsc && gsc.indexed + gsc.notIndexed > 0) {
+    return { provider: "Google", indexed: gsc.indexed, notIndexed: gsc.notIndexed };
+  }
+  if (bing && bing.indexed + bing.notIndexed > 0) {
+    return { provider: "Bing", indexed: bing.indexed, notIndexed: bing.notIndexed };
+  }
+  if (gsc) return { provider: "Google", indexed: gsc.indexed, notIndexed: gsc.notIndexed };
+  if (bing) return { provider: "Bing", indexed: bing.indexed, notIndexed: bing.notIndexed };
+  return null;
+}
+function buildRunStatusScore(allRuns) {
+  const tooltip = "Current execution state of visibility sweeps. Shows the status of the most recent run and total run count.";
+  if (allRuns.length === 0) {
+    return {
+      label: "Run Status",
+      value: "None",
+      delta: "No runs yet",
+      tone: "neutral",
+      description: "Trigger a visibility sweep to start tracking.",
+      tooltip,
+      trend: []
+    };
+  }
+  const latestVisibility = allRuns.find((r) => r.kind === RunKinds["answer-visibility"]);
+  const latest = latestVisibility ?? allRuns[0];
+  const value = latest.status === RunStatuses.completed ? "Healthy" : latest.status === RunStatuses.running ? "Running" : latest.status === RunStatuses.queued ? "Queued" : latest.status === RunStatuses.partial ? "Partial" : "Failed";
+  const tone = latest.status === RunStatuses.completed ? "positive" : latest.status === RunStatuses.failed ? "negative" : latest.status === RunStatuses.partial ? "caution" : "neutral";
+  const visibilityRunCount = allRuns.filter((r) => r.kind === RunKinds["answer-visibility"]).length;
+  const syncRunCount = allRuns.length - visibilityRunCount;
+  const delta = syncRunCount > 0 ? `${visibilityRunCount} visibility \xB7 ${syncRunCount} sync` : `${visibilityRunCount} visibility run${visibilityRunCount === 1 ? "" : "s"}`;
+  return {
+    label: "Run Status",
+    value,
+    delta,
+    tone,
+    description: `Latest run ${value.toLowerCase()}. ${allRuns.length} total run${allRuns.length === 1 ? "" : "s"}.`,
+    tooltip,
+    trend: []
+  };
+}
+var ATTENTION_INSIGHT_LIMIT = 5;
+function buildAttentionItems(insightRows, allRuns) {
+  const items = [];
+  for (const row of insightRows) {
+    if (row.dismissed) continue;
+    if (row.severity !== "critical" && row.severity !== "high") continue;
+    if (items.length >= ATTENTION_INSIGHT_LIMIT) break;
+    items.push({
+      id: `insight_${row.id}`,
+      tone: row.severity === "critical" ? "negative" : "caution",
+      title: row.title,
+      detail: row.query ? `On query: ${row.query}` : "",
+      actionLabel: row.severity === "critical" ? "Critical" : "High",
+      href: `#insight-${row.id}`
+    });
+  }
+  const sortedRuns = [...allRuns].sort((a, b) => b.createdAt.localeCompare(a.createdAt));
+  const latestVisRun = sortedRuns.find((r) => r.kind === RunKinds["answer-visibility"]);
+  const latestSyncRun = sortedRuns.find((r) => r.kind !== RunKinds["answer-visibility"]);
+  if (latestVisRun && latestSyncRun) {
+    const visibilityAge = new Date(latestSyncRun.createdAt).getTime() - new Date(latestVisRun.createdAt).getTime();
+    const ONE_DAY = 24 * 60 * 60 * 1e3;
+    if (visibilityAge > ONE_DAY) {
+      items.push({
+        id: "stale_visibility",
+        tone: "caution",
+        title: "Stale visibility data",
+        detail: `Last visibility sweep was ${latestVisRun.createdAt}; integration syncs have run since.`,
+        actionLabel: "Stale",
+        href: "#runs"
+      });
+    }
+  }
+  return items;
 }
 function mapInsightRow2(r) {
   return {
@@ -10814,8 +10856,8 @@ async function cdpRoutes(app, opts) {
       let total = 0;
       const queryResults = [...byQuery.values()].map(({ query, api, browser }) => {
         total++;
-        const apiCited = api?.citationState === "cited";
-        const browserCited = browser?.citationState === "cited";
+        const apiCited = api?.citationState === CitationStates.cited;
+        const browserCited = browser?.citationState === CitationStates.cited;
         let agreement;
         if (!api && !browser) {
           agreement = "no-data";
@@ -17299,7 +17341,7 @@ import crypto19 from "crypto";
 import fs7 from "fs";
 import path9 from "path";
 import os4 from "os";
-import { and as and12, eq as eq23, inArray as inArray6, sql as sql7 } from "drizzle-orm";
+import { and as and12, eq as eq23, inArray as inArray7, sql as sql7 } from "drizzle-orm";
 
 // src/citation-utils.ts
 function domainMatches(domain, canonicalDomain) {
@@ -17556,7 +17598,7 @@ var JobRunner = class {
     this.registry = registry;
   }
   recoverStaleRuns() {
-    const stale = this.db.select({ id: runs.id, status: runs.status }).from(runs).where(inArray6(runs.status, ["running", "queued"])).all();
+    const stale = this.db.select({ id: runs.id, status: runs.status }).from(runs).where(inArray7(runs.status, ["running", "queued"])).all();
     if (stale.length === 0) return;
     const now = (/* @__PURE__ */ new Date()).toISOString();
     for (const run of stale) {