@ainyc/canonry 4.99.0 → 4.100.0

package/dist/{chunk-DJVUNURL.js → chunk-SNHYRSUF.js}

@@ -18,6 +18,7 @@ import {
   DiscoveryBuckets,
   DiscoveryCompetitorTypes,
   DiscoverySessionStatuses,
+  PortfolioChangeTypes,
   RunKinds,
   RunStatuses,
   RunTriggers,
@@ -131,6 +132,7 @@ import {
   formatIsoDate,
   formatNumber,
   formatRatio,
+  formatRunErrorOneLine,
   formatWindowCountDelta,
   ga4AiReferralHistoryEntrySchema,
   ga4SessionHistoryEntrySchema,
@@ -184,6 +186,7 @@ import {
   parseRunError,
   parseWindow,
   pickClusterRepresentative,
+  portfolioDtoSchema,
   projectConfigSchema,
   projectDtoSchema,
   projectOverviewDtoSchema,
@@ -263,10 +266,10 @@ import {
   wordpressSchemaDeployResultDtoSchema,
   wordpressSchemaStatusResultDtoSchema,
   wordpressStatusDtoSchema
-} from "./chunk-CWFTMFEU.js";
+} from "./chunk-ADLS64PG.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";
+import { eq as eq37, desc as desc18, asc as asc6, and as and27, ne as ne5, or as or5, inArray as inArray14, gte as gte7, lte as lte4 } from "drizzle-orm";
 
 // ../db/src/client.ts
 import { mkdirSync } from "fs";
@@ -4428,19 +4431,23 @@ function buildCitationScorecard(snapshots, queryLookup) {
       answerMentioned: snap.answerMentioned ?? null,
       model: snap.model
     };
-    const counts2 = providerCounts.get(snap.provider) ?? { cited: 0, total: 0 };
+    const counts2 = providerCounts.get(snap.provider) ?? { cited: 0, mentioned: 0, total: 0 };
     counts2.total++;
     if (snap.citationState === CitationStates.cited) counts2.cited++;
+    if (snap.answerMentioned === true) counts2.mentioned++;
     providerCounts.set(snap.provider, counts2);
   }
   const providerRates = providerList.map((provider) => {
-    const counts2 = providerCounts.get(provider) ?? { cited: 0, total: 0 };
+    const counts2 = providerCounts.get(provider) ?? { cited: 0, mentioned: 0, total: 0 };
     const citationRate = counts2.total > 0 ? Math.round(counts2.cited / counts2.total * 100) : 0;
+    const mentionRate = counts2.total > 0 ? Math.round(counts2.mentioned / counts2.total * 100) : 0;
     return {
       provider,
       citedCount: counts2.cited,
+      mentionedCount: counts2.mentioned,
       totalCount: counts2.total,
-      citationRate
+      citationRate,
+      mentionRate
     };
   });
   return { queries: queryList, providers: providerList, matrix, providerRates };
@@ -5041,6 +5048,233 @@ function buildRunHistory(runs2, snapshotsByRunId, limit = DEFAULT_RUN_HISTORY_LI
   });
 }
 
+// ../intelligence/src/portfolio-change-feed.ts
+var PORTFOLIO_CHANGE_FEED_LIMIT = 12;
+var TONE_SEVERITY = {
+  negative: 0,
+  caution: 1,
+  positive: 2,
+  neutral: 3
+};
+function pluralizeQueries(n) {
+  return n === 1 ? "query" : "queries";
+}
+function pluralizeAnswers(n) {
+  return n === 1 ? "answer" : "answers";
+}
+function affectedDetail(queries2, max = 3) {
+  const list = queries2 ?? [];
+  if (list.length === 0) return "";
+  const shown = list.slice(0, max).map((q) => `"${q}"`).join(", ");
+  const remaining = list.length - max;
+  return remaining > 0 ? `${shown} +${remaining} more` : shown;
+}
+function buildProjectChanges(input) {
+  const {
+    projectName,
+    projectSlug,
+    citationMovement,
+    mentionMovement,
+    movementComparison,
+    attentionItems,
+    latestRun
+  } = input;
+  const href = `/projects/${encodeURIComponent(projectSlug)}`;
+  const rows = [];
+  if (!latestRun) {
+    rows.push({
+      id: `${projectSlug}:${PortfolioChangeTypes["project-never-run"]}`,
+      projectName,
+      projectSlug,
+      changeType: PortfolioChangeTypes["project-never-run"],
+      tone: "neutral",
+      title: `${projectName} has no completed sweep yet`,
+      detail: `${input.trackedQueryCount} ${pluralizeQueries(input.trackedQueryCount)} tracked \u2014 run a sweep to start measuring.`,
+      occurredAt: input.projectCreatedAt,
+      href,
+      actionLabel: "Run sweep",
+      comparable: false
+    });
+    return rows;
+  }
+  const { runId, occurredAt } = latestRun;
+  const comparable = movementComparison.comparable;
+  if (latestRun.status === RunStatuses.failed) {
+    rows.push({
+      id: `${projectSlug}:${PortfolioChangeTypes["run-failed"]}:${runId}`,
+      projectName,
+      projectSlug,
+      changeType: PortfolioChangeTypes["run-failed"],
+      tone: "negative",
+      title: `${projectName} sweep failed`,
+      detail: latestRun.error ? formatRunErrorOneLine(latestRun.error) : "The latest visibility sweep failed.",
+      occurredAt,
+      href,
+      actionLabel: "View run",
+      comparable
+    });
+  }
+  if (comparable) {
+    if (citationMovement.lost > 0) {
+      rows.push({
+        id: `${projectSlug}:${PortfolioChangeTypes["citation-lost"]}:${runId}`,
+        projectName,
+        projectSlug,
+        changeType: PortfolioChangeTypes["citation-lost"],
+        tone: "negative",
+        title: `${projectName} lost ${citationMovement.lost} cited ${pluralizeQueries(citationMovement.lost)}`,
+        detail: affectedDetail(citationMovement.lostQueries),
+        occurredAt,
+        href,
+        actionLabel: "Open project",
+        comparable: true
+      });
+    }
+    if (citationMovement.gained > 0) {
+      rows.push({
+        id: `${projectSlug}:${PortfolioChangeTypes["citation-gained"]}:${runId}`,
+        projectName,
+        projectSlug,
+        changeType: PortfolioChangeTypes["citation-gained"],
+        tone: "positive",
+        title: `${projectName} gained ${citationMovement.gained} cited ${pluralizeQueries(citationMovement.gained)}`,
+        detail: affectedDetail(citationMovement.gainedQueries),
+        occurredAt,
+        href,
+        actionLabel: "Open project",
+        comparable: true
+      });
+    }
+    if (mentionMovement.lost > 0) {
+      const queries2 = affectedDetail(mentionMovement.lostQueries);
+      rows.push({
+        id: `${projectSlug}:${PortfolioChangeTypes["mention-lost"]}:${runId}`,
+        projectName,
+        projectSlug,
+        changeType: PortfolioChangeTypes["mention-lost"],
+        tone: "negative",
+        title: `${projectName} dropped from ${mentionMovement.lost} ${pluralizeAnswers(mentionMovement.lost)}`,
+        detail: queries2 ? `No longer mentioned for ${queries2}` : "",
+        occurredAt,
+        href,
+        actionLabel: "Open project",
+        comparable: true
+      });
+    }
+    if (mentionMovement.gained > 0) {
+      rows.push({
+        id: `${projectSlug}:${PortfolioChangeTypes["mention-gained"]}:${runId}`,
+        projectName,
+        projectSlug,
+        changeType: PortfolioChangeTypes["mention-gained"],
+        tone: "positive",
+        title: `${projectName} now mentioned in ${mentionMovement.gained} more ${pluralizeAnswers(mentionMovement.gained)}`,
+        detail: affectedDetail(mentionMovement.gainedQueries),
+        occurredAt,
+        href,
+        actionLabel: "Open project",
+        comparable: true
+      });
+    }
+  } else if (movementComparison.hasPreviousRun && movementComparison.querySetChanged) {
+    rows.push({
+      id: `${projectSlug}:${PortfolioChangeTypes["query-set-changed"]}:${runId}`,
+      projectName,
+      projectSlug,
+      changeType: PortfolioChangeTypes["query-set-changed"],
+      tone: "neutral",
+      title: `${projectName} query set changed`,
+      detail: `+${movementComparison.addedQueryCount} added \xB7 \u2212${movementComparison.removedQueryCount} removed since last sweep \u2014 movement compares the shared queries`,
+      occurredAt,
+      href,
+      actionLabel: "Open project",
+      comparable: false
+    });
+  }
+  for (const item of attentionItems) {
+    if (item.id.startsWith("insight_")) {
+      const isCritical = item.tone === "negative";
+      const changeType = isCritical ? PortfolioChangeTypes["insight-critical"] : PortfolioChangeTypes["insight-high"];
+      rows.push({
+        id: `${projectSlug}:${changeType}:${item.id}`,
+        projectName,
+        projectSlug,
+        changeType,
+        tone: item.tone,
+        title: item.title,
+        detail: item.detail,
+        occurredAt,
+        href,
+        actionLabel: isCritical ? "Critical" : "High",
+        comparable
+      });
+    } else if (item.id === "stale_visibility") {
+      rows.push({
+        id: `${projectSlug}:${PortfolioChangeTypes["stale-visibility"]}:${runId}`,
+        projectName,
+        projectSlug,
+        changeType: PortfolioChangeTypes["stale-visibility"],
+        tone: "caution",
+        title: `${projectName} visibility data is stale`,
+        detail: "Integration syncs have run since the last sweep.",
+        occurredAt,
+        href,
+        actionLabel: "Re-sweep",
+        comparable
+      });
+    }
+  }
+  return rows;
+}
+function resolveEmptyState(projectCount, comparableProjectCount) {
+  if (comparableProjectCount === 0) {
+    return {
+      kind: "awaiting-second-sweep",
+      title: "No changes to compare yet",
+      detail: "Visibility movement appears after a second sweep."
+    };
+  }
+  return {
+    kind: "all-clear",
+    title: "No changes since the last sweep",
+    detail: `All ${projectCount} project${projectCount === 1 ? "" : "s"} held their mention and citation coverage.`
+  };
+}
+function buildPortfolioChangeFeed(inputs, _nowIso) {
+  const all = [];
+  let comparableProjectCount = 0;
+  let firstSweepProjectCount = 0;
+  for (const input of inputs) {
+    if (input.latestRun) {
+      if (input.movementComparison.comparable) comparableProjectCount += 1;
+      if (!input.movementComparison.hasPreviousRun) firstSweepProjectCount += 1;
+    }
+    all.push(...buildProjectChanges(input));
+  }
+  const byId = /* @__PURE__ */ new Map();
+  for (const row of all) {
+    if (!byId.has(row.id)) byId.set(row.id, row);
+  }
+  const deduped = [...byId.values()];
+  deduped.sort((a, b) => {
+    if (a.occurredAt !== b.occurredAt) return a.occurredAt < b.occurredAt ? 1 : -1;
+    const severity = TONE_SEVERITY[a.tone] - TONE_SEVERITY[b.tone];
+    if (severity !== 0) return severity;
+    if (a.projectName !== b.projectName) return a.projectName < b.projectName ? -1 : 1;
+    return a.id < b.id ? -1 : a.id > b.id ? 1 : 0;
+  });
+  const changeFeedTotal = deduped.length;
+  const changeFeed = deduped.slice(0, PORTFOLIO_CHANGE_FEED_LIMIT);
+  const feedEmptyState = changeFeedTotal === 0 ? resolveEmptyState(inputs.length, comparableProjectCount) : null;
+  return {
+    changeFeed,
+    changeFeedTotal,
+    feedEmptyState,
+    comparableProjectCount,
+    firstSweepProjectCount
+  };
+}
+
 // ../intelligence/src/provider-trends.ts
 function buildProviderTrends(runs2, snapshotsByRunId, limit = 12) {
   const recent = [...runs2].sort((a, b) => b.createdAt.localeCompare(a.createdAt)).slice(0, limit).sort((a, b) => a.createdAt.localeCompare(b.createdAt));
@@ -10221,9 +10455,9 @@ function renderWhatsChanged(report, audience) {
     );
   }
   const rateTiles = `<div class="metric-grid">
-    ${renderRateDeltaTile(isClient ? "AI links to your website" : "Citation rate", w.citationRate, "%")}
-    ${renderRateDeltaTile(isClient ? "AI mentions your name" : "Mention rate", w.mentionRate, "%")}
-    ${renderRateDeltaTile(isClient ? "Questions AI answered with you" : "Cited queries", w.citedQueryCount, "count")}
+    ${renderRateDeltaTile(isClient ? "AI mentions your name" : "Citation rate", isClient ? w.mentionRate : w.citationRate, "%")}
+    ${renderRateDeltaTile(isClient ? "AI links to your website" : "Mention rate", isClient ? w.citationRate : w.mentionRate, "%")}
+    ${renderRateDeltaTile(isClient ? "Questions AI mentioned you in" : "Cited queries", isClient ? w.mentionedQueryCount : w.citedQueryCount, "count")}
     ${renderTrafficDeltaTile(isClient ? "Visitors from Google" : "GSC clicks", w.gscClicksDelta, isClient ? "visits" : "clicks", w.comparisonWindowDays)}
     ${renderTrafficDeltaTile(isClient ? "Visitors from AI tools" : "AI referral sessions", w.aiReferralsDelta, isClient ? "visits" : "sessions", w.comparisonWindowDays)}
   </div>`;
@@ -11117,9 +11351,9 @@ function renderClientSummary(report) {
   const s = report.executiveSummary;
   const sc = report.citationScorecard;
   const totalQ = s.totalQueryCount;
-  const heroNumber = totalQ > 0 ? `${s.citationRate}%` : "\u2014";
-  const heroSentence = totalQ > 0 ? `When customers asked AI ${totalQ} ${pluralize(totalQ, "question")} about your industry, AI linked to your website in ${s.citedQueryCount} of ${totalQ === 1 ? "them" : "those answers"}.` : "No AI check has been run yet. Run a check to see how AI tools answer customer questions about your business.";
-  const trend = clientTrendCopy(report.whatsChanged.citationRate);
+  const heroNumber = totalQ > 0 ? `${s.mentionRate}%` : "\u2014";
+  const heroSentence = totalQ > 0 ? `When customers asked AI ${totalQ} ${pluralize(totalQ, "question")} about your industry, AI mentioned you in ${s.mentionedQueryCount} of ${totalQ === 1 ? "them" : "those answers"}.` : "No AI check has been run yet. Run a check to see how AI tools answer customer questions about your business.";
+  const trend = clientTrendCopy(report.whatsChanged.mentionRate);
   const heroTrend = trend ? `<p class="client-hero-trend tone-${trend.tone}"><span style="margin-right:6px;">${trend.arrow}</span>${escapeHtml(trend.text)}</p>` : "";
   const hero = `<div class="client-hero">
     <div class="client-hero-eyebrow">Overview</div>
@@ -11159,15 +11393,15 @@ function renderClientSummary(report) {
         </ol>
       </div>` : "";
   const providerBars = sc.providerRates.length > 0 ? `<div class="client-card">
-        <h3>How often each AI tool links to your website</h3>
-        <p class="card-subtitle">Higher is better. Each bar shows the share of customer questions where the AI cited your site.</p>
+        <h3>How often each AI tool mentions you</h3>
+        <p class="card-subtitle">Higher is better. Each bar shows the share of customer questions where the AI named you in the answer.</p>
         <div class="client-bar-list">
           ${sc.providerRates.map((r) => {
-    const pct = Math.max(r.citationRate, 1.5);
+    const pct = Math.max(r.mentionRate, 1.5);
     return `<div class="client-bar-row">
               <span class="bar-label">${escapeHtml(providerDisplayName(r.provider))}</span>
               <div class="bar-track"><div class="bar-fill" style="width:${pct}%"></div></div>
-              <span class="bar-value">${r.citationRate}% <span class="bar-value-sub">(${r.citedCount}/${r.totalCount})</span></span>
+              <span class="bar-value">${r.mentionRate}% <span class="bar-value-sub">(${r.mentionedCount}/${r.totalCount})</span></span>
             </div>`;
   }).join("")}
         </div>
@@ -11953,9 +12187,10 @@ function buildCitationsTrend(db, projectId, queryLookup, locationFilter) {
       considered++;
       if (snap.citationState === CitationStates.cited) citedQueryIds.add(snap.queryId);
       if (snap.answerMentioned) mentionedQueryIds.add(snap.queryId);
-      const counts2 = providerCounts.get(snap.provider) ?? { cited: 0, total: 0 };
+      const counts2 = providerCounts.get(snap.provider) ?? { cited: 0, mentioned: 0, total: 0 };
       counts2.total++;
       if (snap.citationState === CitationStates.cited) counts2.cited++;
+      if (snap.answerMentioned === true) counts2.mentioned++;
       providerCounts.set(snap.provider, counts2);
     }
     if (considered === 0) continue;
@@ -11965,7 +12200,8 @@ function buildCitationsTrend(db, projectId, queryLookup, locationFilter) {
     const mentionRate = totalQueries > 0 ? Math.round(mentionedQueryCount / totalQueries * 100) : 0;
     const providerRates = [...providerCounts.entries()].map(([provider, counts2]) => ({
       provider,
-      citationRate: counts2.total > 0 ? Math.round(counts2.cited / counts2.total * 100) : 0
+      citationRate: counts2.total > 0 ? Math.round(counts2.cited / counts2.total * 100) : 0,
+      mentionRate: counts2.total > 0 ? Math.round(counts2.mentioned / counts2.total * 100) : 0
     })).sort((a, b) => a.provider.localeCompare(b.provider));
     points.push({
       runId: run.id,
@@ -12345,23 +12581,17 @@ function buildReportActionPlan(input) {
   }
   return actions.sort((a, b) => a.priority - b.priority).slice(0, 10);
 }
-function trendSentence(trend) {
-  switch (trend) {
-    case "up":
-      return "Citation coverage improved versus the prior comparable check.";
-    case "down":
-      return "Citation coverage declined versus the prior comparable check.";
-    case "flat":
-      return "Citation coverage is flat versus the prior comparable check.";
-    case "unknown":
-      return "There is not enough comparable run history yet to call a trend.";
-  }
+function mentionTrendSentence(delta) {
+  if (!delta) return "There is not enough comparable run history yet to call a mention trend.";
+  if (delta.direction === "up") return "Mention coverage improved versus the prior comparable checks.";
+  if (delta.direction === "down") return "Mention coverage declined versus the prior comparable checks.";
+  return "Mention coverage is flat versus the prior comparable checks.";
 }
 function buildClientSummary(reportLike) {
   const s = reportLike.executiveSummary;
   const queryNoun = s.totalQueryCount === 1 ? "query" : "queries";
-  const headline = s.totalQueryCount > 0 ? `${s.citedQueryCount} of ${s.totalQueryCount} tracked ${queryNoun} are cited by AI engines` : "No tracked queries have completed a check yet";
-  const overview = s.totalQueryCount > 0 ? `${reportLike.canonicalDomain} is cited on ${s.citationRate}% of tracked queries and mentioned on ${s.mentionRate}% of tracked queries. ${trendSentence(s.trend)}` : "At least one completed check is needed before this can summarize how the brand appears in AI answers.";
+  const headline = s.totalQueryCount > 0 ? `${s.mentionedQueryCount} of ${s.totalQueryCount} tracked ${queryNoun} mention the brand in AI answers` : "No tracked queries have completed a check yet";
+  const overview = s.totalQueryCount > 0 ? `${reportLike.canonicalDomain} is mentioned on ${s.mentionRate}% of tracked queries and cited on ${s.citationRate}% of tracked queries. ${mentionTrendSentence(reportLike.whatsChanged.mentionRate)}` : "At least one completed check is needed before this can summarize how the brand appears in AI answers.";
   const confidenceNotes = [];
   if (s.totalQueryCount === 0) {
     confidenceNotes.push("Confidence is low until the first tracked query check completes.");
@@ -12496,6 +12726,11 @@ function buildWhatsChanged(input) {
     ...citedQueryCountSmoothed,
     direction: rateDirection(citedQueryCountSmoothed.deltaAbs, COUNT_REAL_MOVEMENT_THRESHOLD)
   } : null;
+  const mentionedQueryCountSmoothed = smoothedRunDelta(citationsTrend, (p) => p.mentionedQueryCount);
+  const mentionedQueryCount = enoughHistory && mentionedQueryCountSmoothed ? {
+    ...mentionedQueryCountSmoothed,
+    direction: rateDirection(mentionedQueryCountSmoothed.deltaAbs, COUNT_REAL_MOVEMENT_THRESHOLD)
+  } : null;
   const providerMovements = [];
   if (enoughHistory) {
     const priorByProvider = new Map(prior.providerRates.map((p) => [p.provider, p.citationRate]));
@@ -12531,6 +12766,7 @@ function buildWhatsChanged(input) {
     citationRate,
     mentionRate,
     citedQueryCount,
+    mentionedQueryCount,
     gscClicksDelta,
     aiReferralsDelta,
     comparisonWindowDays,
@@ -12694,6 +12930,7 @@ function buildProjectReport(db, projectName, periodDays) {
     reportLocation,
     executiveSummary,
     citationsTrend,
+    whatsChanged,
     gsc: gscSection,
     actionPlan
   });
@@ -13100,8 +13337,9 @@ async function visibilityStatsRoutes(app) {
 }
 
 // ../api-routes/src/composites.ts
-import { eq as eq17, and as and12, desc as desc9, sql as sql7, like as like2, or as or4, inArray as inArray9 } from "drizzle-orm";
+import { eq as eq17, and as and12, asc as asc2, desc as desc9, sql as sql7, like as like2, or as or4, inArray as inArray9 } from "drizzle-orm";
 var TOP_INSIGHT_LIMIT = 5;
+var PORTFOLIO_RECENT_RUNS_LIMIT = 8;
 var SEARCH_HIT_HARD_LIMIT = 50;
 var SEARCH_SNIPPET_RADIUS = 80;
 var INTEGRATION_SYNC_KINDS = /* @__PURE__ */ new Set([
@@ -13118,6 +13356,14 @@ async function compositeRoutes(app) {
     const project = resolveProject(app.db, request.params.name);
     const filterLocation = (request.query.location ?? "").trim() || null;
     const sinceIso = parseSinceFilter(request.query.since);
+    return reply.send(computeProjectOverview(project, { filterLocation, sinceIso }));
+  });
+  app.get("/portfolio", async (_request, reply) => {
+    return reply.send(buildPortfolioOverview());
+  });
+  function computeProjectOverview(project, opts = {}) {
+    const filterLocation = opts.filterLocation ?? null;
+    const sinceIso = opts.sinceIso ?? null;
     const allRunsRaw = app.db.select().from(runs).where(and12(eq17(runs.projectId, project.id), notProbeRun())).orderBy(desc9(runs.createdAt), desc9(runs.id)).all();
     const allRuns = allRunsRaw.filter((r) => runMatchesFilters(r, filterLocation, sinceIso));
     const totalRuns = allRuns.length;
@@ -13250,8 +13496,111 @@ async function compositeRoutes(app) {
       dateRangeLabel: "All time",
       contextLabel: `${project.country} / ${project.language.toUpperCase()}`
     };
-    return reply.send(result);
-  });
+    return result;
+  }
+  function buildPortfolioOverview() {
+    const generatedAt = (/* @__PURE__ */ new Date()).toISOString();
+    const projectRows = app.db.select().from(projects).orderBy(asc2(projects.name)).all();
+    const trackedCountRows = app.db.select({ projectId: queries.projectId, total: sql7`COUNT(*)` }).from(queries).groupBy(queries.projectId).all();
+    const trackedCountByProject = new Map(trackedCountRows.map((r) => [r.projectId, Number(r.total)]));
+    const lastSweepRow = app.db.select({ createdAt: runs.createdAt, finishedAt: runs.finishedAt }).from(runs).where(and12(
+      eq17(runs.kind, RunKinds["answer-visibility"]),
+      notProbeRun(),
+      inArray9(runs.status, [RunStatuses.completed, RunStatuses.partial])
+    )).orderBy(desc9(runs.createdAt), desc9(runs.id)).limit(1).get();
+    const lastSweepAt = lastSweepRow ? lastSweepRow.finishedAt ?? lastSweepRow.createdAt : null;
+    const feedInputs = [];
+    const projectRowDtos = [];
+    const runHistoryById = /* @__PURE__ */ new Map();
+    for (const projectRow of projectRows) {
+      const overview = computeProjectOverview(projectRow);
+      for (const point of overview.runHistory) runHistoryById.set(point.runId, point);
+      const latestVisRunRow = app.db.select().from(runs).where(and12(
+        eq17(runs.projectId, projectRow.id),
+        eq17(runs.kind, RunKinds["answer-visibility"]),
+        notProbeRun()
+      )).orderBy(desc9(runs.createdAt), desc9(runs.id)).limit(1).get();
+      const projectName = projectRow.displayName || projectRow.name;
+      feedInputs.push({
+        projectName,
+        projectSlug: projectRow.name,
+        citationMovement: overview.citationMovement,
+        mentionMovement: overview.mentionMovement,
+        movementComparison: overview.movementComparison,
+        attentionItems: overview.attentionItems,
+        latestRun: latestVisRunRow ? {
+          runId: latestVisRunRow.id,
+          status: latestVisRunRow.status,
+          occurredAt: latestVisRunRow.finishedAt ?? latestVisRunRow.createdAt,
+          error: parseRunError(latestVisRunRow.error)
+        } : null,
+        trackedQueryCount: trackedCountByProject.get(projectRow.id) ?? 0,
+        projectCreatedAt: projectRow.createdAt
+      });
+      const mention = overview.scores.mention;
+      projectRowDtos.push({
+        projectSlug: projectRow.name,
+        projectName,
+        canonicalDomain: projectRow.canonicalDomain,
+        mentionScore: mention.progress ?? 0,
+        mentionTone: mention.tone,
+        mentionedOfTotal: { mentioned: overview.queryCounts.mentionedQueries, total: overview.queryCounts.totalQueries },
+        citedOfTotal: { cited: overview.queryCounts.citedQueries, total: overview.queryCounts.totalQueries },
+        mentionDelta: {
+          gained: overview.mentionMovement.gained,
+          lost: overview.mentionMovement.lost,
+          comparable: overview.movementComparison.comparable
+        },
+        citationDelta: {
+          gained: overview.citationMovement.gained,
+          lost: overview.citationMovement.lost,
+          comparable: overview.movementComparison.comparable
+        },
+        competitorPressureLabel: overview.scores.competitorPressure.value,
+        mentionTrend: mention.trend,
+        lastRunAt: latestVisRunRow ? latestVisRunRow.finishedAt ?? latestVisRunRow.createdAt : null,
+        hasEverRun: latestVisRunRow != null
+      });
+    }
+    const feed = buildPortfolioChangeFeed(feedInputs, generatedAt);
+    const projectById = new Map(projectRows.map((p) => [p.id, p]));
+    const recentRunRows = app.db.select().from(runs).where(and12(eq17(runs.kind, RunKinds["answer-visibility"]), notProbeRun())).orderBy(desc9(runs.createdAt), desc9(runs.id)).limit(PORTFOLIO_RECENT_RUNS_LIMIT).all();
+    const recentRuns = [];
+    for (const run of recentRunRows) {
+      const projectRow = projectById.get(run.projectId);
+      if (!projectRow) continue;
+      const point = runHistoryById.get(run.id);
+      const countable = run.status === RunStatuses.completed || run.status === RunStatuses.partial;
+      const error = parseRunError(run.error);
+      recentRuns.push({
+        runId: run.id,
+        projectName: projectRow.displayName || projectRow.name,
+        projectSlug: projectRow.name,
+        kindLabel: "Answer visibility sweep",
+        status: run.status,
+        createdAt: run.createdAt,
+        startedAt: run.startedAt ?? null,
+        finishedAt: run.finishedAt ?? null,
+        durationMs: run.startedAt && run.finishedAt ? new Date(run.finishedAt).getTime() - new Date(run.startedAt).getTime() : null,
+        mentionedCount: countable && point ? point.mentionedCount : null,
+        citedCount: countable && point ? point.citedCount : null,
+        totalCount: countable && point ? point.totalCount : null,
+        errorSummary: error ? formatRunErrorOneLine(error) : null
+      });
+    }
+    return {
+      generatedAt,
+      lastSweepAt,
+      projectCount: projectRows.length,
+      comparableProjectCount: feed.comparableProjectCount,
+      firstSweepProjectCount: feed.firstSweepProjectCount,
+      changeFeed: feed.changeFeed,
+      changeFeedTotal: feed.changeFeedTotal,
+      feedEmptyState: feed.feedEmptyState,
+      recentRuns,
+      projects: projectRowDtos
+    };
+  }
   app.get("/projects/:name/search", async (request, reply) => {
     const project = resolveProject(app.db, request.params.name);
     const rawQuery = (request.query.q ?? "").trim();
@@ -13878,6 +14227,7 @@ var SCHEMA_TABLE = {
   LatestProjectRunDto: latestProjectRunDtoSchema,
   LocationContext: locationContextSchema,
   NotificationDto: notificationDtoSchema,
+  PortfolioDto: portfolioDtoSchema,
   ProjectDto: projectDtoSchema,
   ProjectOverviewDto: projectOverviewDtoSchema,
   ProjectReportDto: projectReportDtoSchema,
@@ -17132,6 +17482,17 @@ var routeCatalog = [
       404: errorResponse("Project not found.")
     }
   },
+  {
+    method: "get",
+    path: "/api/v1/portfolio",
+    summary: "Cross-project portfolio: what changed, recent runs, project state",
+    description: 'One call for the dashboard Portfolio page and `canonry portfolio`. Returns a server-ordered "what changed" feed (citation/mention gains and losses over each project\'s comparable basket, failed sweeps, critical/high insight echoes, stale-visibility, query-set changes, and never-run projects \u2014 recency then severity), a timestamped recent-runs log with independent mention and cited result counts, and a per-project state table. Probe runs are excluded. `generatedAt` is the freshness anchor for every relative timestamp.',
+    tags: ["intelligence"],
+    parameters: [],
+    responses: {
+      200: jsonResponse("Portfolio overview returned.", "PortfolioDto")
+    }
+  },
   {
     method: "get",
     path: "/api/v1/projects/{name}/overview",
@@ -21527,7 +21888,7 @@ async function googleRoutes(app, opts) {
 
 // ../api-routes/src/ads.ts
 import crypto19 from "crypto";
-import { eq as eq22, and as and15, asc as asc2, gte as gte3, lte as lte2, inArray as inArray11 } from "drizzle-orm";
+import { eq as eq22, and as and15, asc as asc3, gte as gte3, lte as lte2, inArray as inArray11 } from "drizzle-orm";
 function statusDto(row) {
   if (!row) return { connected: false };
   return {
@@ -21728,7 +22089,7 @@ async function adsRoutes(app, opts) {
     if (entityId) conditions.push(eq22(adsInsightsDaily.entityId, entityId));
     if (from) conditions.push(gte3(adsInsightsDaily.date, from));
     if (to) conditions.push(lte2(adsInsightsDaily.date, to));
-    const rows = app.db.select().from(adsInsightsDaily).where(and15(...conditions)).orderBy(asc2(adsInsightsDaily.date)).all();
+    const rows = app.db.select().from(adsInsightsDaily).where(and15(...conditions)).orderBy(asc3(adsInsightsDaily.date)).all();
     const dtoRows = rows.map((row) => ({
       level: row.level,
       entityId: row.entityId,
@@ -25137,7 +25498,7 @@ async function wordpressRoutes(app, opts) {
 
 // ../api-routes/src/backlinks.ts
 import crypto23 from "crypto";
-import { and as and20, asc as asc3, desc as desc14, eq as eq26, sql as sql10 } from "drizzle-orm";
+import { and as and20, asc as asc4, desc as desc14, eq as eq26, sql as sql10 } from "drizzle-orm";
 
 // ../integration-commoncrawl/src/constants.ts
 import os2 from "os";
@@ -25896,7 +26257,7 @@ async function backlinksRoutes(app, opts) {
     async (request, reply) => {
       const project = resolveProject(app.db, request.params.name);
       const source = parseSourceParam(request.query.source);
-      const rows = app.db.select().from(backlinkSummaries).where(and20(eq26(backlinkSummaries.projectId, project.id), eq26(backlinkSummaries.source, source))).orderBy(asc3(backlinkSummaries.queriedAt)).all();
+      const rows = app.db.select().from(backlinkSummaries).where(and20(eq26(backlinkSummaries.projectId, project.id), eq26(backlinkSummaries.source, source))).orderBy(asc4(backlinkSummaries.queriedAt)).all();
       const response = rows.map((r) => ({
         release: r.release,
         totalLinkingDomains: r.totalLinkingDomains,
@@ -33861,7 +34222,7 @@ function dedupeStrings(input) {
 
 // ../api-routes/src/technical-aeo.ts
 import crypto29 from "crypto";
-import { and as and26, asc as asc4, count, desc as desc17, eq as eq36, inArray as inArray13 } from "drizzle-orm";
+import { and as and26, asc as asc5, count, desc as desc17, eq as eq36, inArray as inArray13 } from "drizzle-orm";
 var SURFACEABLE_STATUSES = [RunStatuses.completed, RunStatuses.partial];
 function emptyScore(projectName) {
   return {
@@ -33945,7 +34306,7 @@ async function technicalAeoRoutes(app, opts) {
     const total = totalRow?.value ?? 0;
     const limit = parsePositiveInt(request.query.limit, 100, 500);
     const offset = parsePositiveInt(request.query.offset, 0, Number.MAX_SAFE_INTEGER);
-    const orderBy = request.query.sort === "score-desc" ? desc17(siteAuditPages.overallScore) : request.query.sort === "url" ? asc4(siteAuditPages.url) : asc4(siteAuditPages.overallScore);
+    const orderBy = request.query.sort === "score-desc" ? desc17(siteAuditPages.overallScore) : request.query.sort === "url" ? asc5(siteAuditPages.url) : asc5(siteAuditPages.overallScore);
     const rows = app.db.select().from(siteAuditPages).where(where).orderBy(orderBy).limit(limit).offset(offset).all();
     const pages = rows.map((row) => ({
       url: row.url,
@@ -34880,7 +35241,7 @@ var IntelligenceService = class {
         // Backfill must not replay probe runs as if they were real sweeps.
         ne5(runs.trigger, RunTriggers.probe)
       )
-    ).orderBy(asc5(runs.finishedAt)).all();
+    ).orderBy(asc6(runs.finishedAt)).all();
     let startIdx = 0;
     let endIdx = allRuns.length;
     if (opts?.fromRunId) {