@ainyc/canonry 4.86.0 → 4.87.0

package/dist/{chunk-DLBQU3VG.js → chunk-5LW7CJAO.js}

@@ -170,6 +170,7 @@ import {
   missingDependency,
   normalizeProjectAliases,
   normalizeProjectDomain,
+  normalizeQueryText,
   normalizeUrlPath,
   notFound,
   notImplemented,
@@ -180,6 +181,7 @@ import {
   pickClusterRepresentative,
   projectConfigSchema,
   projectDtoSchema,
+  projectOverviewDtoSchema,
   projectReportDtoSchema,
   projectUpsertRequestSchema,
   providerError,
@@ -253,7 +255,7 @@ import {
   wordpressSchemaDeployResultDtoSchema,
   wordpressSchemaStatusResultDtoSchema,
   wordpressStatusDtoSchema
-} from "./chunk-23HGQV22.js";
+} from "./chunk-MDRDX5R2.js";
 
 // src/intelligence-service.ts
 import { eq as eq37, desc as desc18, asc as asc5, and as and27, ne as ne5, or as or5, inArray as inArray14, gte as gte7, lte as lte4 } from "drizzle-orm";
@@ -4532,35 +4534,101 @@ function buildAiSourceOrigin(snapshots, projectDomains, competitorDomains, topDo
 
 // ../intelligence/src/movement-summary.ts
 function buildMovementSummary(currentSnapshots, previousSnapshots, options = {}) {
+  return buildSignalMovementSummary(
+    currentSnapshots,
+    previousSnapshots,
+    (snapshot) => snapshot.citationState === CitationStates.cited,
+    options
+  );
+}
+function buildCitationMovementSummary(currentSnapshots, previousSnapshots, options = {}) {
+  return buildMovementSummary(currentSnapshots, previousSnapshots, options);
+}
+function buildMentionMovementSummary(currentSnapshots, previousSnapshots, options = {}) {
+  return buildSignalMovementSummary(
+    currentSnapshots,
+    previousSnapshots,
+    (snapshot) => snapshot.answerMentioned === true,
+    options
+  );
+}
+function buildMovementComparison(currentSnapshots, previousSnapshots, options = {}) {
+  const currentIds = collectQueryIds(currentSnapshots);
+  const previousIds = collectQueryIds(previousSnapshots);
+  const hasPreviousRun = previousSnapshots.length > 0;
+  if (!hasPreviousRun) {
+    return {
+      hasPreviousRun: false,
+      comparable: false,
+      querySetChanged: false,
+      previousRunAt: null,
+      currentQueryCount: currentIds.size,
+      previousQueryCount: 0,
+      comparableQueryCount: 0,
+      addedQueryCount: 0,
+      removedQueryCount: 0,
+      addedQueries: [],
+      removedQueries: []
+    };
+  }
+  const comparableIds = intersection(currentIds, previousIds);
+  const addedIds = difference(currentIds, previousIds);
+  const removedIds = difference(previousIds, currentIds);
+  const querySetChanged = addedIds.size > 0 || removedIds.size > 0;
+  return {
+    hasPreviousRun: true,
+    comparable: !querySetChanged && currentIds.size > 0,
+    querySetChanged,
+    previousRunAt: options.previousRunAt ?? null,
+    currentQueryCount: currentIds.size,
+    previousQueryCount: previousIds.size,
+    comparableQueryCount: comparableIds.size,
+    addedQueryCount: addedIds.size,
+    removedQueryCount: removedIds.size,
+    addedQueries: resolveQueryTexts(addedIds, options.queryLookup),
+    removedQueries: resolveQueryTexts(removedIds, options.queryLookup)
+  };
+}
+function buildSignalMovementSummary(currentSnapshots, previousSnapshots, isActive, options) {
   if (previousSnapshots.length === 0) {
-    const citedIds = collectCitedQueryIds(currentSnapshots);
-    const citedCount = citedIds.size;
-    const tone2 = citedCount > 0 ? "positive" : "neutral";
+    const activeIds = collectActiveQueryIds(currentSnapshots, isActive);
     return withQueryLists(
-      { gained: citedCount, lost: 0, tone: tone2, hasPreviousRun: false },
-      citedIds,
+      {
+        gained: activeIds.size,
+        lost: 0,
+        tone: activeIds.size > 0 ? "positive" : "neutral",
+        hasPreviousRun: false
+      },
+      activeIds,
       /* @__PURE__ */ new Set(),
       options.queryLookup
     );
   }
-  const latestCited = collectCitedQueryIds(currentSnapshots);
-  const previousCited = collectCitedQueryIds(previousSnapshots);
-  const gainedIds = /* @__PURE__ */ new Set();
-  const lostIds = /* @__PURE__ */ new Set();
-  for (const id of latestCited) {
-    if (!previousCited.has(id)) gainedIds.add(id);
-  }
-  for (const id of previousCited) {
-    if (!latestCited.has(id)) lostIds.add(id);
-  }
-  const tone = lostIds.size > gainedIds.size ? "negative" : gainedIds.size > lostIds.size ? "positive" : "neutral";
+  const comparableIds = intersection(
+    collectQueryIds(currentSnapshots),
+    collectQueryIds(previousSnapshots)
+  );
+  const currentActive = intersection(collectActiveQueryIds(currentSnapshots, isActive), comparableIds);
+  const previousActive = intersection(collectActiveQueryIds(previousSnapshots, isActive), comparableIds);
+  const gainedIds = difference(currentActive, previousActive);
+  const lostIds = difference(previousActive, currentActive);
   return withQueryLists(
-    { gained: gainedIds.size, lost: lostIds.size, tone, hasPreviousRun: true },
+    {
+      gained: gainedIds.size,
+      lost: lostIds.size,
+      tone: movementTone(gainedIds.size, lostIds.size),
+      hasPreviousRun: true
+    },
     gainedIds,
     lostIds,
     options.queryLookup
   );
 }
+function movementTone(gained, lost) {
+  if (lost > gained) return "negative";
+  if (gained > lost) return "positive";
+  return "neutral";
+}
 function withQueryLists(base, gainedIds, lostIds, lookup) {
   if (!lookup) return base;
   return {
@@ -4570,6 +4638,7 @@ function withQueryLists(base, gainedIds, lostIds, lookup) {
   };
 }
 function resolveQueryTexts(ids, lookup) {
+  if (!lookup) return [];
   const out = [];
   for (const id of ids) {
     const text2 = lookup.get(id);
@@ -4577,12 +4646,33 @@ function resolveQueryTexts(ids, lookup) {
   }
   return out.sort();
 }
-function collectCitedQueryIds(snapshots) {
-  const cited = /* @__PURE__ */ new Set();
-  for (const s of snapshots) {
-    if (s.citationState === CitationStates.cited && s.queryId) cited.add(s.queryId);
+function collectQueryIds(snapshots) {
+  const ids = /* @__PURE__ */ new Set();
+  for (const snapshot of snapshots) {
+    if (snapshot.queryId) ids.add(snapshot.queryId);
+  }
+  return ids;
+}
+function collectActiveQueryIds(snapshots, isActive) {
+  const active = /* @__PURE__ */ new Set();
+  for (const snapshot of snapshots) {
+    if (snapshot.queryId && isActive(snapshot)) active.add(snapshot.queryId);
   }
-  return cited;
+  return active;
+}
+function intersection(left, right) {
+  const out = /* @__PURE__ */ new Set();
+  for (const value of left) {
+    if (right.has(value)) out.add(value);
+  }
+  return out;
+}
+function difference(left, right) {
+  const out = /* @__PURE__ */ new Set();
+  for (const value of left) {
+    if (!right.has(value)) out.add(value);
+  }
+  return out;
 }
 
 // ../intelligence/src/score-tones.ts
@@ -5027,12 +5117,12 @@ var DEFAULT_LIMIT = 10;
 function buildSuggestedQueries(gscRows, options) {
   const minImpressions = options.minImpressions ?? DEFAULT_MIN_IMPRESSIONS;
   const limit = options.limit ?? DEFAULT_LIMIT;
-  const trackedSet = new Set(options.trackedQueries.map(normalizeQuery));
+  const trackedSet = new Set(options.trackedQueries.map(normalizeQueryText));
   let skippedAlreadyTracked = 0;
   const candidates = [];
   for (const row of gscRows) {
     if (row.impressions < minImpressions) continue;
-    const normalized = normalizeQuery(row.query);
+    const normalized = normalizeQueryText(row.query);
     if (normalized.length === 0) continue;
     if (trackedSet.has(normalized)) {
       skippedAlreadyTracked++;
@@ -5054,9 +5144,6 @@ function buildSuggestedQueries(gscRows, options) {
     skippedAlreadyTracked
   };
 }
-function normalizeQuery(value) {
-  return value.trim().toLowerCase();
-}
 function buildReason(row) {
   const impressionsLabel = formatImpressions2(row.impressions);
   if (row.avgPosition <= 10) {
@@ -12924,18 +13011,31 @@ async function compositeRoutes(app) {
     const snapshotRunIds = new Set(sparklineRunIds);
     for (const run of latestVisRunGroup) snapshotRunIds.add(run.id);
     for (const run of previousVisRunGroup) snapshotRunIds.add(run.id);
-    const snapshotsByRun = loadSnapshotsByRunIds(app, [...snapshotRunIds]);
+    const projectQueries = app.db.select({ id: queries.id, query: queries.query }).from(queries).where(eq17(queries.projectId, project.id)).all();
+    const queryIdByText = new Map(projectQueries.map((q) => [normalizeQueryText(q.query), q.id]));
+    const snapshotsByRun = loadSnapshotsByRunIds(app, [...snapshotRunIds], queryIdByText);
     const latestSnapshots = latestVisRunGroup.flatMap((r) => snapshotsByRun.get(r.id) ?? []);
     const previousSnapshots = previousVisRunGroup.flatMap((r) => snapshotsByRun.get(r.id) ?? []);
-    const { queryCounts, providers } = summarizeFromSnapshots(latestSnapshots);
+    const trackedLatest = latestSnapshots.filter((s) => !s.archived);
+    const trackedPrevious = previousSnapshots.filter((s) => !s.archived);
+    const trackedSnapshotsByRun = new Map(
+      [...snapshotsByRun].map(([runId, snaps]) => [runId, snaps.filter((s) => !s.archived)])
+    );
+    const { queryCounts, providers } = summarizeFromSnapshots(trackedLatest);
     const transitions = summarizeTransitionsFromSnapshots(
-      latestSnapshots,
-      previousSnapshots,
+      trackedLatest,
+      trackedPrevious,
       previousVisibilityRun?.createdAt ?? null
     );
     const competitorRows = app.db.select().from(competitors).where(eq17(competitors.projectId, project.id)).all();
-    const projectQueries = app.db.select({ id: queries.id, query: queries.query }).from(queries).where(eq17(queries.projectId, project.id)).all();
     const queryLookup = { byId: new Map(projectQueries.map((q) => [q.id, q.query])) };
+    for (const snapshots of snapshotsByRun.values()) {
+      for (const snapshot of snapshots) {
+        if (snapshot.queryText && !queryLookup.byId.has(snapshot.queryId)) {
+          queryLookup.byId.set(snapshot.queryId, snapshot.queryText);
+        }
+      }
+    }
     const configuredApiProviders = project.providers.filter((p) => !p.startsWith("cdp:"));
     const mentionShareCompetitors = competitorRows.map((c) => ({
       domain: c.domain,
@@ -12945,32 +13045,39 @@ async function compositeRoutes(app) {
       brandTokens: [brandLabelFromDomain(c.domain)].filter((t) => t.length >= 3)
     }));
     const scores = {
-      mention: buildMentionCoverage(latestSnapshots, { configuredApiProviders }),
-      visibility: buildVisibilityScore(latestSnapshots, { configuredApiProviders }),
+      mention: buildMentionCoverage(trackedLatest, { configuredApiProviders }),
+      visibility: buildVisibilityScore(trackedLatest, { configuredApiProviders }),
       mentionShare: buildMentionShare(
-        latestSnapshots.map((s) => ({
+        trackedLatest.map((s) => ({
           projectMentioned: s.answerMentioned === true,
           answerText: s.answerText
         })),
         { competitors: mentionShareCompetitors }
       ),
-      gapQueries: buildGapQueryScore(latestSnapshots),
-      mentionGaps: buildMentionGapScore(latestSnapshots),
+      gapQueries: buildGapQueryScore(trackedLatest),
+      mentionGaps: buildMentionGapScore(trackedLatest),
       indexCoverage: buildIndexCoverageScore(app, project.id),
       competitorPressure: buildCompetitorPressureScore(
-        latestSnapshots,
+        trackedLatest,
         competitorRows.map((c) => c.domain),
         competitorRows.length
       ),
       runStatus: buildRunStatusScore(allRuns)
     };
-    const movementSummary = buildMovementSummary(latestSnapshots, previousSnapshots, {
+    const citationMovement = buildCitationMovementSummary(latestSnapshots, previousSnapshots, {
       queryLookup: queryLookup.byId
     });
-    const providerScoresBase = buildProviderScores(latestSnapshots);
+    const mentionMovement = buildMentionMovementSummary(latestSnapshots, previousSnapshots, {
+      queryLookup: queryLookup.byId
+    });
+    const movementComparison = buildMovementComparison(latestSnapshots, previousSnapshots, {
+      queryLookup: queryLookup.byId,
+      previousRunAt: previousVisibilityRun?.createdAt ?? null
+    });
+    const providerScoresBase = buildProviderScores(trackedLatest);
     const providerTrends = buildProviderTrends(
       visibilityRuns.slice(0, DEFAULT_RUN_HISTORY_LIMIT).map((r) => ({ id: r.id, createdAt: r.createdAt })),
-      snapshotsByRun,
+      trackedSnapshotsByRun,
       DEFAULT_RUN_HISTORY_LIMIT
     );
     const providerScores = providerScoresBase.map((score) => {
@@ -12978,13 +13085,13 @@ async function compositeRoutes(app) {
       return trend.length > 1 ? { ...score, trend: trend.map((p) => p.rate) } : score;
     });
     const overviewCompetitors = buildOverviewCompetitors(
-      latestSnapshots,
+      trackedLatest,
       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 runHistory = buildRunHistory(sparklineRuns, trackedSnapshotsByRun);
     scores.mention.trend = runHistory.map((p) => p.mentionRate);
     scores.visibility.trend = runHistory.map((p) => p.citationRate);
     const suggestedQueries = buildSuggestedQueriesFromGsc(
@@ -13001,7 +13108,12 @@ async function compositeRoutes(app) {
       providers,
       transitions,
       scores,
-      movementSummary,
+      // Keep the legacy citation-only field for API compatibility. New
+      // consumers read the explicitly named siblings below.
+      movementSummary: citationMovement,
+      citationMovement,
+      mentionMovement,
+      movementComparison,
       competitors: overviewCompetitors,
       providerScores,
       attentionItems,
@@ -13111,12 +13223,13 @@ function summarizeRun(run) {
     createdAt: run.createdAt
   };
 }
-function loadSnapshotsByRunIds(app, runIds) {
+function loadSnapshotsByRunIds(app, runIds, queryIdByText) {
   const result = /* @__PURE__ */ new Map();
   if (runIds.length === 0) return result;
-  const rows = filterTrackedSnapshots(app.db.select({
+  const rows = app.db.select({
     runId: querySnapshots.runId,
     queryId: querySnapshots.queryId,
+    queryText: querySnapshots.queryText,
     provider: querySnapshots.provider,
     model: querySnapshots.model,
     citationState: querySnapshots.citationState,
@@ -13124,11 +13237,30 @@ function loadSnapshotsByRunIds(app, runIds) {
     answerText: querySnapshots.answerText,
     competitorOverlap: querySnapshots.competitorOverlap,
     citedDomains: querySnapshots.citedDomains
-  }).from(querySnapshots).where(inArray9(querySnapshots.runId, [...runIds])).all());
+  }).from(querySnapshots).where(inArray9(querySnapshots.runId, [...runIds])).all();
   for (const row of rows) {
+    const queryText = row.queryText?.trim() || null;
+    let queryId;
+    let archived = false;
+    if (row.queryId) {
+      queryId = row.queryId;
+    } else if (queryText) {
+      const tracked = queryIdByText.get(normalizeQueryText(queryText));
+      if (tracked) {
+        queryId = tracked;
+      } else {
+        queryId = `archived:${normalizeQueryText(queryText)}`;
+        archived = true;
+      }
+    } else {
+      queryId = null;
+    }
+    if (!queryId) continue;
     const list = result.get(row.runId) ?? [];
     list.push({
-      queryId: row.queryId,
+      queryId,
+      queryText,
+      archived,
       provider: row.provider,
       model: row.model,
       citationState: row.citationState,
@@ -13618,6 +13750,7 @@ var SCHEMA_TABLE = {
   LocationContext: locationContextSchema,
   NotificationDto: notificationDtoSchema,
   ProjectDto: projectDtoSchema,
+  ProjectOverviewDto: projectOverviewDtoSchema,
   ProjectReportDto: projectReportDtoSchema,
   QueryDto: queryDtoSchema,
   RunDetailDto: runDetailDtoSchema,
@@ -16851,12 +16984,11 @@ var routeCatalog = [
     method: "get",
     path: "/api/v1/projects/{name}/overview",
     summary: "Get a composite overview of project health",
-    description: 'Bundles project info, latest run, top undismissed insights, the latest health snapshot, query cited rate, per-provider breakdown, and transitions vs. the previous run. Designed for the "how is project X doing?" question so agents can answer in one call.',
+    description: 'Bundles project info, latest run, top undismissed insights, health, independent mention and citation coverage, query-basket comparability, and separate mention/citation movement over the shared query cohort. Designed for the "how is project X doing?" question so agents can answer in one call.',
     tags: ["intelligence"],
     parameters: [nameParameter],
     responses: {
-      // TODO: Add `ProjectOverviewDto` Zod schema in contracts.
-      200: rawJsonResponse("Overview returned.", looseObjectSchema),
+      200: jsonResponse("Overview returned.", "ProjectOverviewDto"),
       404: errorResponse("Project not found.")
     }
   },

package/dist/{chunk-LLJPZKHG.js → chunk-6XMXBAEW.js}

@@ -23,7 +23,7 @@ import {
   trafficConnectVercelRequestSchema,
   trafficConnectWordpressRequestSchema,
   trafficEventKindSchema
-} from "./chunk-23HGQV22.js";
+} from "./chunk-MDRDX5R2.js";
 
 // src/config.ts
 import fs from "fs";
@@ -5597,7 +5597,7 @@ var canonryMcpTools = [
   defineTool({
     name: "canonry_project_overview",
     title: "Get project overview (composite)",
-    description: 'One-call summary for "how is project X doing?" \u2014 bundles project info, latest run, top undismissed insights, latest health snapshot, query cited rate, per-provider breakdown, gained/lost/emerging vs the previous run, the five score gauges (visibility, gap queries, index coverage, competitor pressure, run status), per-(provider, model) scores, configured competitors with pressure labels, an attention queue of critical/high insights, and a recent-runs sparkline. Filterable by location and time window. Prefer this over fanning out to separate tools.',
+    description: 'One-call summary for "how is project X doing?". Returns independent mention and citation coverage, separate query-level movement for each signal, query-basket comparability with added/removed counts, latest run and health, insights, provider/model breakdowns, competitors, attention items, and recent history. Movement excludes queries not shared by both sweeps. Filterable by location and time window. Prefer this over fanning out to separate tools.',
     access: "read",
     tier: "core",
     inputSchema: z2.object({

package/dist/{chunk-SELXBOAP.js → chunk-DUDFNP5Y.js}

@@ -9,7 +9,7 @@ import {
   loadConfig,
   loadConfigRaw,
   saveConfigPatch
-} from "./chunk-LLJPZKHG.js";
+} from "./chunk-6XMXBAEW.js";
 import {
   CC_CACHE_DIR,
   DUCKDB_SPEC,
@@ -104,7 +104,7 @@ import {
   siteAuditPages,
   siteAuditSnapshots,
   usageCounters
-} from "./chunk-DLBQU3VG.js";
+} from "./chunk-5LW7CJAO.js";
 import {
   AGENT_MEMORY_VALUE_MAX_BYTES,
   AGENT_PROVIDER_IDS,
@@ -160,7 +160,7 @@ import {
   validationError,
   winnabilityClassLabel,
   withRetry
-} from "./chunk-23HGQV22.js";
+} from "./chunk-MDRDX5R2.js";
 
 // src/telemetry.ts
 import crypto from "crypto";
@@ -6289,7 +6289,7 @@ function readStoredGroundingSources(rawResponse) {
   return result;
 }
 async function backfillInsightsCommand(project, opts) {
-  const { IntelligenceService: IntelligenceService2 } = await import("./intelligence-service-ZHUJKZRO.js");
+  const { IntelligenceService: IntelligenceService2 } = await import("./intelligence-service-XUKYOHKL.js");
   const config = loadConfig();
   const db = createClient(config.database);
   migrate(db);

package/dist/{chunk-23HGQV22.js → chunk-MDRDX5R2.js}

@@ -3163,6 +3163,196 @@ var ccCachedReleaseSchema = z23.object({
 
 // ../contracts/src/composites.ts
 import { z as z24 } from "zod";
+var metricToneSchema = z24.enum(["positive", "caution", "negative", "neutral"]);
+var scoreSummarySchema = z24.object({
+  label: z24.string(),
+  value: z24.string(),
+  delta: z24.string(),
+  tone: metricToneSchema,
+  description: z24.string(),
+  tooltip: z24.string().optional(),
+  trend: z24.array(z24.number()),
+  progress: z24.number().optional(),
+  providerCoverage: z24.string().optional()
+});
+var mentionShareSchema = scoreSummarySchema.extend({
+  breakdown: z24.object({
+    projectMentionSnapshots: z24.number().int().nonnegative(),
+    competitorMentionSnapshots: z24.number().int().nonnegative(),
+    perCompetitor: z24.array(z24.object({
+      domain: z24.string(),
+      mentionSnapshots: z24.number().int().nonnegative(),
+      shareOfCompetitiveTotal: z24.number()
+    })),
+    snapshotsWithAnswerText: z24.number().int().nonnegative(),
+    snapshotsTotal: z24.number().int().nonnegative()
+  })
+});
+var movementSummarySchema = z24.object({
+  gained: z24.number().int().nonnegative(),
+  lost: z24.number().int().nonnegative(),
+  tone: metricToneSchema,
+  hasPreviousRun: z24.boolean(),
+  gainedQueries: z24.array(z24.string()).optional(),
+  lostQueries: z24.array(z24.string()).optional()
+});
+var movementComparisonSchema = z24.object({
+  hasPreviousRun: z24.boolean(),
+  comparable: z24.boolean(),
+  querySetChanged: z24.boolean(),
+  previousRunAt: z24.string().nullable(),
+  currentQueryCount: z24.number().int().nonnegative(),
+  previousQueryCount: z24.number().int().nonnegative(),
+  comparableQueryCount: z24.number().int().nonnegative(),
+  addedQueryCount: z24.number().int().nonnegative(),
+  removedQueryCount: z24.number().int().nonnegative(),
+  addedQueries: z24.array(z24.string()),
+  removedQueries: z24.array(z24.string())
+});
+var projectOverviewInsightSchema = z24.object({
+  id: z24.string(),
+  projectId: z24.string(),
+  runId: z24.string().nullable(),
+  type: z24.enum([
+    "regression",
+    "gain",
+    "opportunity",
+    "first-citation",
+    "provider-pickup",
+    "persistent-gap",
+    "competitor-gained",
+    "competitor-lost",
+    "gbp-lodging-gap",
+    "gbp-listing-discrepancy",
+    "gbp-cta-gap",
+    "gbp-metric-drop",
+    "gbp-keyword-drop"
+  ]),
+  severity: z24.enum(["critical", "high", "medium", "low"]),
+  title: z24.string(),
+  query: z24.string(),
+  provider: z24.string(),
+  recommendation: z24.object({
+    action: z24.string(),
+    target: z24.string().optional(),
+    reason: z24.string()
+  }).optional(),
+  cause: z24.object({
+    cause: z24.string(),
+    competitorDomain: z24.string().optional(),
+    details: z24.string().optional()
+  }).optional(),
+  dismissed: z24.boolean(),
+  createdAt: z24.string()
+});
+var projectOverviewHealthSchema = z24.object({
+  id: z24.string(),
+  projectId: z24.string(),
+  runId: z24.string().nullable(),
+  overallCitedRate: z24.number(),
+  overallMentionRate: z24.number(),
+  totalPairs: z24.number().int().nonnegative(),
+  citedPairs: z24.number().int().nonnegative(),
+  mentionedPairs: z24.number().int().nonnegative(),
+  providerBreakdown: z24.record(z24.string(), z24.object({
+    citedRate: z24.number(),
+    mentionRate: z24.number(),
+    cited: z24.number().int().nonnegative(),
+    mentioned: z24.number().int().nonnegative(),
+    total: z24.number().int().nonnegative()
+  })),
+  createdAt: z24.string(),
+  status: z24.enum(["ready", "no-data"]),
+  reason: z24.literal("no-runs-yet").optional()
+});
+var projectOverviewDtoSchema = z24.object({
+  project: projectDtoSchema,
+  latestRun: latestProjectRunDtoSchema,
+  health: projectOverviewHealthSchema.nullable(),
+  topInsights: z24.array(projectOverviewInsightSchema),
+  queryCounts: z24.object({
+    totalQueries: z24.number().int().nonnegative(),
+    citedQueries: z24.number().int().nonnegative(),
+    notCitedQueries: z24.number().int().nonnegative(),
+    citedRate: z24.number(),
+    mentionedQueries: z24.number().int().nonnegative(),
+    notMentionedQueries: z24.number().int().nonnegative(),
+    mentionRate: z24.number()
+  }),
+  providers: z24.array(z24.object({
+    provider: z24.string(),
+    citedRate: z24.number(),
+    cited: z24.number().int().nonnegative(),
+    total: z24.number().int().nonnegative()
+  })),
+  transitions: z24.object({
+    since: z24.string().nullable(),
+    gained: z24.number().int().nonnegative(),
+    lost: z24.number().int().nonnegative(),
+    emerging: z24.number().int().nonnegative()
+  }),
+  scores: z24.object({
+    mention: scoreSummarySchema,
+    visibility: scoreSummarySchema,
+    mentionShare: mentionShareSchema,
+    gapQueries: scoreSummarySchema,
+    mentionGaps: scoreSummarySchema,
+    indexCoverage: scoreSummarySchema,
+    competitorPressure: scoreSummarySchema,
+    runStatus: scoreSummarySchema
+  }),
+  movementSummary: movementSummarySchema,
+  citationMovement: movementSummarySchema,
+  mentionMovement: movementSummarySchema,
+  movementComparison: movementComparisonSchema,
+  competitors: z24.array(z24.object({
+    id: z24.string(),
+    domain: z24.string(),
+    citationCount: z24.number().int().nonnegative(),
+    totalQueries: z24.number().int().nonnegative(),
+    pressureLabel: z24.enum(["None", "Low", "Moderate", "High"]),
+    citedQueries: z24.array(z24.string())
+  })),
+  providerScores: z24.array(z24.object({
+    provider: z24.string(),
+    model: z24.string().nullable(),
+    score: z24.number(),
+    cited: z24.number().int().nonnegative(),
+    total: z24.number().int().nonnegative(),
+    trend: z24.array(z24.number()).optional()
+  })),
+  attentionItems: z24.array(z24.object({
+    id: z24.string(),
+    tone: metricToneSchema,
+    title: z24.string(),
+    detail: z24.string(),
+    actionLabel: z24.string(),
+    href: z24.string()
+  })),
+  runHistory: z24.array(z24.object({
+    runId: z24.string(),
+    createdAt: z24.string(),
+    citedCount: z24.number().int().nonnegative(),
+    totalCount: z24.number().int().nonnegative(),
+    citationRate: z24.number(),
+    mentionedCount: z24.number().int().nonnegative(),
+    mentionRate: z24.number(),
+    status: z24.string()
+  })),
+  suggestedQueries: z24.object({
+    rows: z24.array(z24.object({
+      query: z24.string(),
+      impressions: z24.number(),
+      clicks: z24.number(),
+      avgPosition: z24.number(),
+      reason: z24.string()
+    })),
+    totalCandidates: z24.number().int().nonnegative(),
+    skippedAlreadyTracked: z24.number().int().nonnegative()
+  }),
+  dateRangeLabel: z24.string(),
+  contextLabel: z24.string()
+});
 var searchHitKindSchema = z24.enum(["snapshot", "insight"]);
 var projectSearchSnapshotHitSchema = z24.object({
   kind: z24.literal("snapshot"),
@@ -3533,6 +3723,11 @@ function summarizeCheckResults(results) {
   return summary;
 }
 
+// ../contracts/src/query-normalize.ts
+function normalizeQueryText(value) {
+  return value.trim().toLowerCase();
+}
+
 // ../contracts/src/citations.ts
 import { z as z27 } from "zod";
 var citationCoverageProviderSchema = z27.object({
@@ -5029,6 +5224,7 @@ export {
   backlinksInstallResultDtoSchema,
   ccAvailableReleaseSchema,
   ccCachedReleaseSchema,
+  projectOverviewDtoSchema,
   ContentActions,
   contentActionLabel,
   actionConfidenceLabel,
@@ -5052,6 +5248,7 @@ export {
   CheckCategories,
   doctorReportSchema,
   summarizeCheckResults,
+  normalizeQueryText,
   citationVisibilityResponseSchema,
   emptyCitationVisibility,
   citationStateToCited,