@ainyc/canonry 4.99.1 → 4.100.0

package/dist/{chunk-YBIT5O62.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-JF7EXHGA.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";
@@ -5045,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));
@@ -13107,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([
@@ -13125,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;
@@ -13257,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();
@@ -13885,6 +14227,7 @@ var SCHEMA_TABLE = {
   LatestProjectRunDto: latestProjectRunDtoSchema,
   LocationContext: locationContextSchema,
   NotificationDto: notificationDtoSchema,
+  PortfolioDto: portfolioDtoSchema,
   ProjectDto: projectDtoSchema,
   ProjectOverviewDto: projectOverviewDtoSchema,
   ProjectReportDto: projectReportDtoSchema,
@@ -17139,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",
@@ -21534,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 {
@@ -21735,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,
@@ -25144,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";
@@ -25903,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,
@@ -33868,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 {
@@ -33952,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,
@@ -34887,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) {

package/dist/{chunk-IDI6LMYL.js → chunk-UVIHWF45.js}

@@ -24,7 +24,7 @@ import {
   trafficConnectVercelRequestSchema,
   trafficConnectWordpressRequestSchema,
   trafficEventKindSchema
-} from "./chunk-JF7EXHGA.js";
+} from "./chunk-ADLS64PG.js";
 
 // src/config.ts
 import fs from "fs";
@@ -3085,6 +3085,18 @@ var getApiV1ProjectsByNameContentGaps = (options) => {
     ...options
   });
 };
+var getApiV1Portfolio = (options) => {
+  return (options?.client ?? client).get({
+    security: [
+      {
+        scheme: "bearer",
+        type: "http"
+      }
+    ],
+    url: "/api/v1/portfolio",
+    ...options
+  });
+};
 var getApiV1ProjectsByNameOverview = (options) => {
   return (options.client ?? client).get({
     security: [
@@ -3908,6 +3920,9 @@ var ApiClient = class {
   async apply(config) {
     return this.invoke(() => postApiV1Apply({ client: this.heyClient, body: config }));
   }
+  async getPortfolio() {
+    return this.invoke(() => getApiV1Portfolio({ client: this.heyClient }));
+  }
   async getProjectOverview(project, opts) {
     return this.invoke(
       () => getApiV1ProjectsByNameOverview({
@@ -5681,6 +5696,17 @@ var canonryMcpTools = [
     openApiOperations: ["GET /api/v1/projects/{name}/report"],
     handler: (client2, input) => client2.getReport(input.project, input.period !== void 0 ? { period: input.period } : void 0)
   }),
+  defineTool({
+    name: "canonry_portfolio",
+    title: "Get portfolio change feed (composite)",
+    description: 'One-call cross-project portfolio: a server-ordered "what changed" feed \u2014 citation and mention gains/losses over each project\'s comparable query basket, failed sweeps, critical/high insight echoes, stale-visibility, query-set changes, and never-run projects, ranked by recency then severity \u2014 plus a timestamped recent-runs log carrying BOTH result signals (mentioned vs cited counts, independent) and a per-project state table. Probe runs excluded. Use it to answer "what changed across all my projects" without fanning out per project. `generatedAt` anchors every relative timestamp.',
+    access: "read",
+    tier: "monitoring",
+    inputSchema: emptyInputSchema,
+    annotations: readAnnotations(),
+    openApiOperations: ["GET /api/v1/portfolio"],
+    handler: (client2) => client2.getPortfolio()
+  }),
   defineTool({
     name: "canonry_analytics_metrics",
     title: "Get citation & mention trend",