@canonry/canonry 7.66.0 → 7.68.0

package/dist/{chunk-WNCOBSPN.js → chunk-VPZMSV3Q.js}

@@ -13366,6 +13366,7 @@ var STORED_READ_OPERATIONS = /* @__PURE__ */ new Set([
   "GET /api/v1/projects/{name}/seo/domain-intelligence",
   "GET /api/v1/projects/{name}/seo/ranked-keywords",
   "GET /api/v1/projects/{name}/seo/market-rankings",
+  "GET /api/v1/projects/{name}/seo/market-rankings/summary",
   "GET /api/v1/projects/{name}/gbp/local-post-attempt",
   "GET /api/v1/openapi.json",
   "GET /api/v1/screenshots/{snapshotId}",
@@ -21386,18 +21387,31 @@ var seoMarketRankingContextSchema = z66.object({
   queryText: z66.string(),
   queryClass: queryClassSchema
 }).strict();
+var seoMarketRankingCompetitorSchema = z66.object({ domain: z66.string(), rankOrganic: z66.number().int().positive() }).strict();
+var seoMarketRankingSearchStatusSchema = z66.enum(["completed", "partial", "failed", "cancelled"]);
+var SeoMarketRankingSearchStatuses = seoMarketRankingSearchStatusSchema.enum;
 var seoMarketRankingSchema = seoMarketRankingContextSchema.extend({
   /** The exact text searched on Google for `queryText` (see `seoSearchTextSchema`). */
   searchText: z66.string(),
   locationLabel: z66.string(),
   target: seoTargetSchema,
+  searchStatus: seoMarketRankingSearchStatusSchema,
   rankOrganic: z66.number().int().positive().nullable(),
   rankAbsolute: z66.number().int().positive().nullable(),
   url: z66.string().nullable(),
-  depth: z66.number().int().positive(),
-  /** Tracked competitors found in the same results, by their best organic position. */
-  competitors: z66.array(z66.object({ domain: z66.string(), rankOrganic: z66.number().int().positive() }).strict()),
-  provenance: seoProvenanceSchema
+  /** Organic results the search checked: the requested depth, less when partial, 0 when it failed or never ran. */
+  depth: z66.number().int().nonnegative(),
+  /** Tracked competitors found in the same results at their best organic position, best first. */
+  competitors: z66.array(seoMarketRankingCompetitorSchema),
+  /** Where the results came from; null when the search returned none. */
+  provenance: seoProvenanceSchema.nullable()
+}).strict();
+var seoMarketRankingOutcomeSchema = z66.enum(["page-1", "ranks-11-20", "ranks-21-plus", "not-ranked", "partly-checked", "failed", "cancelled"]);
+var SeoMarketRankingOutcomes = seoMarketRankingOutcomeSchema.enum;
+var seoMarketRankingRowSchema = seoMarketRankingSchema.extend({
+  outcome: seoMarketRankingOutcomeSchema,
+  /** A tracked competitor ranks above the target in these results, or ranks while the target is not in them. */
+  rivalAhead: z66.boolean()
 }).strict();
 var seoResultsSchema = z66.object({
   keywordMetrics: z66.array(seoKeywordMetricsSchema),
@@ -21448,7 +21462,12 @@ var seoTaskSchema = z66.object({
   target: seoTargetSchema.nullable(),
   status: seoRunStatusSchema,
   error: z66.string().nullable(),
-  remoteTaskId: z66.string().nullable()
+  remoteTaskId: z66.string().nullable(),
+  /** Market rankings: the text searched on Google and where from, so a failed search can be named. Null for other datasets. */
+  searchText: z66.string().nullable(),
+  locationLabel: z66.string().nullable(),
+  /** A second attempt at a search whose first attempt hit a search-engine error. It replaces that attempt, which is not listed. */
+  retried: z66.boolean()
 }).strict();
 var seoResultCountsSchema = z66.object({
   keywordMetrics: z66.number().int().nonnegative(),
@@ -21478,11 +21497,57 @@ var seoPageShape = {
 var seoKeywordMetricsListSchema = z66.object({ ...seoPageShape, items: z66.array(seoKeywordMetricsSchema) }).strict();
 var seoDomainIntelligenceListSchema = z66.object({ ...seoPageShape, items: z66.array(seoDomainIntelligenceSchema) }).strict();
 var seoRankedKeywordListSchema = z66.object({ ...seoPageShape, items: z66.array(seoRankedKeywordSchema) }).strict();
+var seoMarketRankingFilterSchema = z66.enum(["needs-work", "page-1", "ranks-11-20", "ranks-21-plus", "not-ranked", "partly-checked", "rival-ahead", "failed", "cancelled"]);
+var SeoMarketRankingFilters = seoMarketRankingFilterSchema.enum;
+var seoMarketRankingSortSchema = z66.enum(["market", "rank", "-rank", "query", "-query"]);
+var SeoMarketRankingSorts = seoMarketRankingSortSchema.enum;
 var seoMarketRankingQuerySchema = seoEvidenceQuerySchema.extend({
+  marketKey: z66.string().min(1).max(200).optional(),
+  regionKey: z66.string().min(1).max(200).optional(),
+  outcome: seoMarketRankingFilterSchema.optional(),
+  /** Case-insensitive text found in the query, its searched text or its market label. */
+  q: z66.string().trim().min(1).max(200).optional(),
+  sort: seoMarketRankingSortSchema.optional()
+}).strict();
+var seoMarketRankingListSchema = z66.object({ ...seoPageShape, items: z66.array(seoMarketRankingRowSchema) }).strict();
+var seoMarketRankingCountsSchema = z66.object({
+  queries: z66.number().int().nonnegative(),
+  page1: z66.number().int().nonnegative(),
+  ranks11To20: z66.number().int().nonnegative(),
+  ranks21Plus: z66.number().int().nonnegative(),
+  /** Not in the requested depth: only searches that checked all of it, never a partial one. */
+  notRanked: z66.number().int().nonnegative(),
+  /** A partial search that did not reach the site; ranks past what it checked are unknown. */
+  partlyChecked: z66.number().int().nonnegative(),
+  failed: z66.number().int().nonnegative(),
+  cancelled: z66.number().int().nonnegative(),
+  needsWork: z66.number().int().nonnegative(),
+  /** Rows where a tracked competitor ranks above the target; overlaps the outcome counts. */
+  rivalAhead: z66.number().int().nonnegative()
+}).strict();
+var seoMarketRankingGroupKindSchema = z66.enum(["region", "market"]);
+var SeoMarketRankingGroupKinds = seoMarketRankingGroupKindSchema.enum;
+var seoMarketRankingGroupSchema = z66.object({
+  key: z66.string(),
+  label: z66.string(),
+  kind: seoMarketRankingGroupKindSchema,
+  counts: seoMarketRankingCountsSchema
+}).strict();
+var seoMarketRankingSummaryQuerySchema = seoEvidenceQuerySchema.pick({ profileId: true, runId: true }).extend({
   marketKey: z66.string().min(1).max(200).optional(),
   regionKey: z66.string().min(1).max(200).optional()
 }).strict();
-var seoMarketRankingListSchema = z66.object({ ...seoPageShape, items: z66.array(seoMarketRankingSchema) }).strict();
+var seoMarketRankingSummarySchema = z66.object({
+  runId: z66.string().nullable(),
+  depth: z66.number().int().positive().nullable(),
+  regionKey: z66.string().nullable(),
+  marketKey: z66.string().nullable(),
+  /** Names of the selected region and market; null when none is selected or the refresh has no rows for it. */
+  regionLabel: z66.string().nullable(),
+  marketLabel: z66.string().nullable(),
+  totals: seoMarketRankingCountsSchema,
+  groups: z66.array(seoMarketRankingGroupSchema)
+}).strict();
 var seoOverviewSchema = z66.object({
   status: seoStatusSchema,
   profiles: z66.array(seoProfileSchema),
@@ -21499,6 +21564,7 @@ var seoOverviewSchema = z66.object({
   keywordMetricsCount: z66.number().int().nonnegative(),
   domainIntelligenceCount: z66.number().int().nonnegative(),
   rankedKeywordCount: z66.number().int().nonnegative(),
+  /** Rows the market-rankings read returns for the evidence refresh, searches that failed or never ran included. */
   marketRankingCount: z66.number().int().nonnegative()
 }).strict();
 var seoMicrosSchema = z66.number().int().min(0).max(Number.MAX_SAFE_INTEGER);
@@ -21612,6 +21678,10 @@ var scheduleDtoSchema = z68.object({
   updatedAt: z68.string()
 });
 var scheduleExpectedUpdatedAtSchema = z68.string().datetime();
+function scheduleEnabledAt(previous, enabled, now) {
+  if (!enabled) return null;
+  return previous?.enabled ? previous.enabledAt : now;
+}
 function nextScheduleUpdatedAt(previous, nowMs = Date.now()) {
   const previousMs = previous === void 0 ? Number.NaN : Date.parse(previous);
   return new Date(Number.isFinite(previousMs) ? Math.max(nowMs, previousMs + 1) : nowMs).toISOString();
@@ -23297,11 +23367,11 @@ function resolveModelPrice(provider, model, overrides) {
   }
   return null;
 }
-function estimateAnswerCostMicros(usage, price, tier) {
+function estimateAnswerCostMicros(usage, price, tier2) {
   const cachedInputRate = price.cachedInputPerMTok ?? DEFAULT_CACHED_INPUT_MULTIPLIER * price.inputPerMTok;
   const cacheWriteRate = price.cacheWritePerMTok ?? DEFAULT_CACHE_WRITE_MULTIPLIER * price.inputPerMTok;
   const tokenMicros = usage.inputTokens * price.inputPerMTok + usage.cachedInputTokens * cachedInputRate + usage.cacheWriteTokens * cacheWriteRate + usage.outputTokens * price.outputPerMTok;
-  const tierMultiplier = tier === PricingTiers.batch ? price.batchTokenDiscount ?? DEFAULT_BATCH_TOKEN_DISCOUNT : 1;
+  const tierMultiplier = tier2 === PricingTiers.batch ? price.batchTokenDiscount ?? DEFAULT_BATCH_TOKEN_DISCOUNT : 1;
   const billedSearchUnits = price.searchUnit === SearchUnits.prompt ? usage.searchCount > 0 ? 1 : 0 : usage.searchCount;
   const searchMicros = billedSearchUnits * (price.searchPer1k ?? 0) * 1e3;
   return Math.round(tokenMicros * tierMultiplier + searchMicros);
@@ -23807,6 +23877,9 @@ var agentViewContextSchema = z82.object({
   view: z82.enum(["project", "visibility", "property", "queries", "site-health", "seo"]),
   seoProfileId: z82.string().trim().min(1).max(128).optional(),
   seoRunId: z82.string().trim().min(1).max(128).optional(),
+  /** The market-rankings region and market the SEO view is narrowed to. */
+  seoRegionKey: z82.string().trim().min(1).max(200).optional(),
+  seoMarketKey: z82.string().trim().min(1).max(200).optional(),
   unavailableReason: z82.string().trim().min(1).max(512).optional(),
   selection: visibilityReportRequestSchema.optional(),
   page: z82.object({
@@ -23816,6 +23889,7 @@ var agentViewContextSchema = z82.object({
 }).strict().superRefine((value, ctx) => {
   if (value.seoProfileId && value.view !== "seo") ctx.addIssue({ code: "custom", message: "SEO profile context requires the SEO view." });
   if (value.seoRunId && value.view !== "seo") ctx.addIssue({ code: "custom", message: "SEO run context requires the SEO view." });
+  if ((value.seoRegionKey || value.seoMarketKey) && value.view !== "seo") ctx.addIssue({ code: "custom", message: "SEO market context requires the SEO view." });
   if (value.page && value.view !== "site-health") ctx.addIssue({ code: "custom", message: "Page context requires Site Health." });
   if (value.selection && !["visibility", "property", "queries"].includes(value.view)) ctx.addIssue({ code: "custom", message: "Measurement selection requires a measurement view." });
 });
@@ -26138,6 +26212,162 @@ var cliCatalogSchema = z92.object({
   }))
 });
 
+// ../contracts/src/seo-market-rankings.ts
+var PAGE_ONE_LAST_RANK = 10;
+var CLOSE_LAST_RANK = 20;
+function bestCompetitorRank(competitors) {
+  return competitors.reduce((best, competitor) => best === null || competitor.rankOrganic < best ? competitor.rankOrganic : best, null);
+}
+function outcomeOf(row) {
+  switch (row.searchStatus) {
+    case SeoMarketRankingSearchStatuses.failed:
+      return SeoMarketRankingOutcomes.failed;
+    case SeoMarketRankingSearchStatuses.cancelled:
+      return SeoMarketRankingOutcomes.cancelled;
+    case SeoMarketRankingSearchStatuses.completed:
+    case SeoMarketRankingSearchStatuses.partial: {
+      const rank = row.rankOrganic;
+      if (rank === null) return row.searchStatus === SeoMarketRankingSearchStatuses.partial ? SeoMarketRankingOutcomes["partly-checked"] : SeoMarketRankingOutcomes["not-ranked"];
+      if (rank <= PAGE_ONE_LAST_RANK) return SeoMarketRankingOutcomes["page-1"];
+      return rank <= CLOSE_LAST_RANK ? SeoMarketRankingOutcomes["ranks-11-20"] : SeoMarketRankingOutcomes["ranks-21-plus"];
+    }
+    default: {
+      const unknown = row.searchStatus;
+      return unknown;
+    }
+  }
+}
+function marketRankingRow(row) {
+  const best = bestCompetitorRank(row.competitors);
+  return { ...row, outcome: outcomeOf(row), rivalAhead: best !== null && (row.rankOrganic === null || best < row.rankOrganic) };
+}
+function matchesMarketRankingFilter(row, filter) {
+  switch (filter) {
+    case SeoMarketRankingFilters["needs-work"]:
+      return row.outcome === SeoMarketRankingOutcomes["ranks-11-20"] || row.outcome === SeoMarketRankingOutcomes["ranks-21-plus"] || row.outcome === SeoMarketRankingOutcomes["not-ranked"] || row.outcome === SeoMarketRankingOutcomes["partly-checked"];
+    case SeoMarketRankingFilters["rival-ahead"]:
+      return row.rivalAhead;
+    case SeoMarketRankingFilters["page-1"]:
+    case SeoMarketRankingFilters["ranks-11-20"]:
+    case SeoMarketRankingFilters["ranks-21-plus"]:
+    case SeoMarketRankingFilters["not-ranked"]:
+    case SeoMarketRankingFilters["partly-checked"]:
+    case SeoMarketRankingFilters.failed:
+    case SeoMarketRankingFilters.cancelled:
+      return row.outcome === filter;
+    default: {
+      const unknown = filter;
+      return unknown;
+    }
+  }
+}
+function matchesMarketRankingText(row, text) {
+  const needle = text.trim().toLowerCase();
+  return !needle || [row.queryText, row.searchText, row.marketLabel].some((value) => value.toLowerCase().includes(needle));
+}
+var byMarket = (a, b) => compareText(a.regionLabel ?? "", b.regionLabel ?? "") || compareText(a.marketLabel, b.marketLabel) || compareText(a.searchText, b.searchText) || compareText(a.queryText, b.queryText);
+var byQuery = (a, b) => compareText(a.queryText.toLowerCase(), b.queryText.toLowerCase()) || byMarket(a, b);
+function tier(row) {
+  switch (row.outcome) {
+    case SeoMarketRankingOutcomes["page-1"]:
+    case SeoMarketRankingOutcomes["ranks-11-20"]:
+    case SeoMarketRankingOutcomes["ranks-21-plus"]:
+      return 0;
+    case SeoMarketRankingOutcomes["partly-checked"]:
+      return 1;
+    case SeoMarketRankingOutcomes["not-ranked"]:
+      return 2;
+    case SeoMarketRankingOutcomes.failed:
+      return 3;
+    case SeoMarketRankingOutcomes.cancelled:
+      return 4;
+    default: {
+      const unknown = row.outcome;
+      return unknown;
+    }
+  }
+}
+function worst(row) {
+  const order = tier(row);
+  return order === 2 ? 0 : order === 0 ? 2 : order;
+}
+var unranked = (row) => tier(row) === 1 || tier(row) === 2;
+var rivalOrder = (a, b) => (bestCompetitorRank(a.competitors) ?? Number.MAX_SAFE_INTEGER) - (bestCompetitorRank(b.competitors) ?? Number.MAX_SAFE_INTEGER);
+function compareMarketRankingsBy(sort) {
+  switch (sort) {
+    case SeoMarketRankingSorts.market:
+      return byMarket;
+    case SeoMarketRankingSorts.query:
+      return byQuery;
+    case SeoMarketRankingSorts["-query"]:
+      return (a, b) => byQuery(b, a);
+    case SeoMarketRankingSorts.rank:
+      return (a, b) => tier(a) - tier(b) || (a.rankOrganic !== null && b.rankOrganic !== null ? a.rankOrganic - b.rankOrganic : 0) || (unranked(a) ? rivalOrder(a, b) : 0) || byQuery(a, b);
+    case SeoMarketRankingSorts["-rank"]:
+      return (a, b) => worst(a) - worst(b) || (a.rankOrganic !== null && b.rankOrganic !== null ? b.rankOrganic - a.rankOrganic : 0) || (unranked(a) ? rivalOrder(a, b) : 0) || byQuery(a, b);
+    default: {
+      const unknown = sort;
+      return unknown;
+    }
+  }
+}
+function marketRankingBands(depth, totals) {
+  const fills = (count3, firstRank) => depth === null || depth >= firstRank || (totals?.[count3] ?? 0) > 0;
+  const bands = [{ count: "page1", filter: SeoMarketRankingFilters["page-1"], label: "Page 1" }];
+  if (fills("ranks11To20", 11)) bands.push({ count: "ranks11To20", filter: SeoMarketRankingFilters["ranks-11-20"], label: "11-20" });
+  if (fills("ranks21Plus", 21)) bands.push({ count: "ranks21Plus", filter: SeoMarketRankingFilters["ranks-21-plus"], label: depth === null || depth <= 21 ? "21 and deeper" : `21-${depth}` });
+  bands.push({ count: "notRanked", filter: SeoMarketRankingFilters["not-ranked"], label: depth === null ? "Not ranked" : `Not in top ${depth}` });
+  return bands;
+}
+function countMarketRankings(rows) {
+  const counts = { queries: rows.length, page1: 0, ranks11To20: 0, ranks21Plus: 0, notRanked: 0, partlyChecked: 0, failed: 0, cancelled: 0, needsWork: 0, rivalAhead: 0 };
+  for (const row of rows) {
+    switch (row.outcome) {
+      case SeoMarketRankingOutcomes["page-1"]:
+        counts.page1++;
+        break;
+      case SeoMarketRankingOutcomes["ranks-11-20"]:
+        counts.ranks11To20++;
+        break;
+      case SeoMarketRankingOutcomes["ranks-21-plus"]:
+        counts.ranks21Plus++;
+        break;
+      case SeoMarketRankingOutcomes["not-ranked"]:
+        counts.notRanked++;
+        break;
+      case SeoMarketRankingOutcomes["partly-checked"]:
+        counts.partlyChecked++;
+        break;
+      case SeoMarketRankingOutcomes.failed:
+        counts.failed++;
+        break;
+      case SeoMarketRankingOutcomes.cancelled:
+        counts.cancelled++;
+        break;
+      default: {
+        const unknown = row.outcome;
+        return unknown;
+      }
+    }
+    if (row.rivalAhead) counts.rivalAhead++;
+  }
+  counts.needsWork = counts.ranks11To20 + counts.ranks21Plus + counts.notRanked + counts.partlyChecked;
+  return counts;
+}
+function groupMarketRankings(rows, scope) {
+  if (scope.marketKey !== void 0) return [];
+  const groups = /* @__PURE__ */ new Map();
+  for (const row of rows) {
+    const region = scope.regionKey === void 0 && row.regionKey !== null;
+    const key = region ? row.regionKey : row.marketKey;
+    const id2 = `${region ? "region" : "market"}\0${key}`;
+    const group = groups.get(id2) ?? { key, label: region ? row.regionLabel ?? key : row.marketLabel, kind: region ? SeoMarketRankingGroupKinds.region : SeoMarketRankingGroupKinds.market, rows: [] };
+    group.rows.push(row);
+    groups.set(id2, group);
+  }
+  return [...groups.values()].map((group) => ({ key: group.key, label: group.label, kind: group.kind, counts: countMarketRankings(group.rows) })).sort((a, b) => b.counts.ranks11To20 - a.counts.ranks11To20 || b.counts.ranks21Plus - a.counts.ranks21Plus || compareText(a.label, b.label) || compareText(a.key, b.key));
+}
+
 export {
   apiKeyDtoSchema,
   apiKeyListDtoSchema,
@@ -26175,6 +26405,7 @@ export {
   calendarRecurrenceSchema,
   scheduleDtoSchema,
   scheduleExpectedUpdatedAtSchema,
+  scheduleEnabledAt,
   nextScheduleUpdatedAt,
   scheduleUpsertRequestSchema,
   buildRedactedNotificationUrl,
@@ -27371,6 +27602,8 @@ export {
   seoRefreshIntentInputSchema,
   seoQuoteSchema,
   seoSyncInputSchema,
+  SeoMarketRankingSearchStatuses,
+  SeoMarketRankingOutcomes,
   emptySeoResults,
   seoSearchTextForQuery,
   seoRunSchema,
@@ -27380,11 +27613,23 @@ export {
   seoKeywordMetricsListSchema,
   seoDomainIntelligenceListSchema,
   seoRankedKeywordListSchema,
+  seoMarketRankingFilterSchema,
+  seoMarketRankingSortSchema,
+  SeoMarketRankingSorts,
   seoMarketRankingQuerySchema,
   seoMarketRankingListSchema,
+  seoMarketRankingSummaryQuerySchema,
+  seoMarketRankingSummarySchema,
   seoOverviewSchema,
   seoOperatorTaskSchema,
   seoReconcileInputSchema,
   seoReconcileResultSchema,
-  SeoAdapterOutcomes
+  SeoAdapterOutcomes,
+  marketRankingRow,
+  matchesMarketRankingFilter,
+  matchesMarketRankingText,
+  compareMarketRankingsBy,
+  marketRankingBands,
+  countMarketRankings,
+  groupMarketRankings
 };

package/dist/{chunk-DVYS2RMM.js → chunk-W7PA35VJ.js}

@@ -1,16 +1,16 @@
 import {
   runWithUsageTags
-} from "./chunk-EIMXB6UH.js";
+} from "./chunk-FDRZQH3Y.js";
 import {
   CanonryMcpToolNames,
   canonryMcpTools
-} from "./chunk-ALQEGGYM.js";
+} from "./chunk-YIIIYNPW.js";
 import {
   CliError
 } from "./chunk-HGMYEDAQ.js";
 import {
   buildOpenApiDocument
-} from "./chunk-JYOMHNRP.js";
+} from "./chunk-6W3ENB2X.js";
 import {
   DEFAULT_COMPETITOR_AUTO_ALIAS_MODE,
   MeasurementPortfolioLists,
@@ -23,7 +23,7 @@ import {
   seoDatasetWithoutVendor,
   seoProviderSchema,
   truncateUtf16
-} from "./chunk-WNCOBSPN.js";
+} from "./chunk-VPZMSV3Q.js";
 
 // src/agent/tools.ts
 import { Type as Type2 } from "@earendil-works/pi-ai";

package/dist/{chunk-YJYLFIVT.js → chunk-XMXYUP7X.js}

@@ -1,7 +1,7 @@
 import {
   API_PROVIDER_NAMES,
   ProviderNames
-} from "./chunk-WNCOBSPN.js";
+} from "./chunk-VPZMSV3Q.js";
 
 // src/provider-registration.ts
 function isApiProviderRegistrable(name, entry) {

package/dist/{chunk-J5YZXRD5.js → chunk-Y42G2YKT.js}

@@ -7,27 +7,27 @@ import {
   reparseStoredResult4,
   reparseStoredResult5,
   resolveStoredApiResponse
-} from "./chunk-OSF27DCY.js";
+} from "./chunk-IVBJEVHS.js";
 import {
   loadConfig
-} from "./chunk-EYWC24VC.js";
+} from "./chunk-MVRPFLEL.js";
 import {
   isMachineFormat
 } from "./chunk-HGMYEDAQ.js";
 import {
   determineCitationState
-} from "./chunk-QRBZBJ4U.js";
+} from "./chunk-K2P2XO6P.js";
 import {
   backfillProjectAnswerMentions,
   competitorIdentityColumns,
   createRunCompetitorResolver,
   readMarketCompetitorNames,
   refreshSnapshotMentionIdentity
-} from "./chunk-JYOMHNRP.js";
+} from "./chunk-6W3ENB2X.js";
 import {
   classifyAiUserFetch,
   classifyCrawler
-} from "./chunk-BCRRAH5C.js";
+} from "./chunk-J4CNNYRQ.js";
 import {
   aiUserFetchEventsHourly,
   auditLog,
@@ -42,7 +42,7 @@ import {
   querySnapshots,
   rawEventSamples,
   runs
-} from "./chunk-JALKQREN.js";
+} from "./chunk-ARIYTYOM.js";
 import {
   ProviderNames,
   RetrievalContracts,
@@ -59,7 +59,7 @@ import {
   extractRecommendedCompetitors,
   normalizeUrlPath,
   openRouterRouteModel
-} from "./chunk-WNCOBSPN.js";
+} from "./chunk-VPZMSV3Q.js";
 
 // src/commands/backfill.ts
 import { setImmediate as yieldToEventLoop } from "timers/promises";
@@ -437,7 +437,7 @@ No DB writes performed. Re-run without --dry-run to apply.`);
   }
 }
 async function backfillInsightsCommand(project, opts) {
-  const { IntelligenceService } = await import("./intelligence-service-U4NSGZUH.js");
+  const { IntelligenceService } = await import("./intelligence-service-4OO2VQ2I.js");
   const config = loadConfig();
   const db = createClient(config.database);
   migrate(db);

package/dist/{chunk-ALQEGGYM.js → chunk-YIIIYNPW.js}

@@ -2,11 +2,11 @@ import {
   dedupeGscSitemapUrls,
   resolveDiscoveredGscSitemapUrls,
   submitGscSitemapBatches
-} from "./chunk-2YBEI6LE.js";
+} from "./chunk-5SK27UE7.js";
 import {
   measurementDraftOperationSchema,
   runMeasurementDraftAction
-} from "./chunk-CKTA5374.js";
+} from "./chunk-PAVSKSKA.js";
 import {
   CliError
 } from "./chunk-HGMYEDAQ.js";
@@ -143,6 +143,8 @@ import {
   seoKeywordMetricsListSchema,
   seoMarketRankingListSchema,
   seoMarketRankingQuerySchema,
+  seoMarketRankingSummaryQuerySchema,
+  seoMarketRankingSummarySchema,
   seoOperatorTaskSchema,
   seoOverviewSchema,
   seoProfileInputSchema,
@@ -175,7 +177,7 @@ import {
   trafficSeriesGranularitySchema,
   visibilityCompareSelectionSchema,
   visibilityReportRequestSchema
-} from "./chunk-WNCOBSPN.js";
+} from "./chunk-VPZMSV3Q.js";
 
 // src/mcp/tool-registry.ts
 import { z as z2 } from "zod";
@@ -1126,6 +1128,7 @@ var sentimentBackfillInputSchema = sentimentBackfillRequestSchema.extend({ proje
 var seoIdInputSchema = projectInputSchema.extend({ id: z2.string().min(1) });
 var seoEvidenceInputSchema = seoEvidenceQuerySchema.extend({ project: projectNameSchema });
 var seoMarketRankingInputSchema = seoMarketRankingQuerySchema.extend({ project: projectNameSchema });
+var seoMarketRankingSummaryInputSchema = seoMarketRankingSummaryQuerySchema.extend({ project: projectNameSchema });
 var rawCanonryMcpTools = [
   defineTool({
     name: "canonry_seo_operator_task",
@@ -1340,7 +1343,7 @@ var rawCanonryMcpTools = [
   defineTool({
     name: "canonry_seo_market_rankings",
     title: "SEO market rankings",
-    description: "Read stored SEO data only. No provider calls. The site's Google position for each tracked non-brand query in each market, searched from that market's location; these are the same tracked queries AI visibility measures, and searchText is the exact text searched. A null rank means not in the checked results (depth), not a failed search. Filter with marketKey or regionKey and keep runId fixed while paging.",
+    description: "Read stored SEO data only. No provider calls. The site's Google position for each tracked non-brand query in each market, searched from that market's location; these are the same tracked queries AI visibility measures, and searchText is the exact text searched. searchStatus says how each search ended: a null rank in a completed or partial row means not in the checked results (depth, lower when only part of the results came back); a failed or cancelled row has no rank because the search returned nothing. outcome says where each row landed (page-1, ranks-11-20, ranks-21-plus, not-ranked, partly-checked for a partial search without the site, failed, cancelled) and rivalAhead whether a tracked competitor ranks above the site. Filter with marketKey, regionKey, outcome (needs-work = off page 1 with a result) and q; sort=rank puts the closest to page 1 first. Keep runId fixed while paging.",
     access: "read",
     tier: "seo",
     inputSchema: seoMarketRankingInputSchema,
@@ -1352,6 +1355,21 @@ var rawCanonryMcpTools = [
       return client.getSeoMarketRankings(project, query);
     }
   }),
+  defineTool({
+    name: "canonry_seo_market_summary",
+    title: "SEO market rankings by outcome",
+    description: "Read stored SEO data only. No provider calls. Market-rankings rows counted by outcome (page 1, ranks 11-20, 21 and deeper, not ranked, partly checked, failed, cancelled, needs work, rival ahead) for the whole profile with one group per region, for one region (regionKey) with one group per market, or for one market (marketKey). Groups come in needs-work order. Start here to see what needs work, then read the rows with canonry_seo_market_rankings.",
+    access: "read",
+    tier: "seo",
+    inputSchema: seoMarketRankingSummaryInputSchema,
+    outputSchema: seoMarketRankingSummarySchema,
+    annotations: readAnnotations(),
+    openApiOperations: ["GET /api/v1/projects/{name}/seo/market-rankings/summary"],
+    handler: (client, input) => {
+      const { project, ...query } = input;
+      return client.getSeoMarketRankingSummary(project, query);
+    }
+  }),
   defineTool({
     name: "canonry_sentiment_settings",
     title: "Read sentiment readiness and settings",

package/dist/{chunk-XC44Q5XR.js → chunk-ZD5G5QEV.js}

@@ -8,7 +8,7 @@ import {
 } from "./chunk-HGMYEDAQ.js";
 import {
   describeError
-} from "./chunk-WNCOBSPN.js";
+} from "./chunk-VPZMSV3Q.js";
 
 // src/commands/mcp.ts
 import fs from "fs";

package/dist/{chunk-SGZWOUIZ.js → chunk-ZU6X4SN2.js}

@@ -1,6 +1,6 @@
 import {
   pickProjectCitedDomain
-} from "./chunk-QRBZBJ4U.js";
+} from "./chunk-K2P2XO6P.js";
 import {
   GBP_INSIGHT_PROVIDER,
   PERSISTENT_GAP_THRESHOLD,
@@ -14,10 +14,10 @@ import {
   mergeGscQueryTotalsWithFallback,
   readGscQueryDailyRows,
   readLatestGscDataDate
-} from "./chunk-JYOMHNRP.js";
+} from "./chunk-6W3ENB2X.js";
 import {
   getRequestContext
-} from "./chunk-YRX5UOM3.js";
+} from "./chunk-7SGZHGZ2.js";
 import {
   competitors,
   gbpDailyMetrics,
@@ -35,7 +35,7 @@ import {
   queries,
   querySnapshots,
   runs
-} from "./chunk-JALKQREN.js";
+} from "./chunk-ARIYTYOM.js";
 import {
   CitationStates,
   RunKinds,
@@ -45,7 +45,7 @@ import {
   effectiveDomains,
   redactLogString,
   redactLogValue
-} from "./chunk-WNCOBSPN.js";
+} from "./chunk-VPZMSV3Q.js";
 
 // src/intelligence-service.ts
 import { eq, desc, asc, and, ne, or, inArray, gte, lte, isNull, sql, exists } from "drizzle-orm";

package/dist/{chunk-IPF2S5G2.js → chunk-ZUXFHO4T.js}

@@ -2,13 +2,13 @@ import {
   bucketCliCommandDuration,
   isTelemetryEnabled,
   trackEvent
-} from "./chunk-IHOVPHUW.js";
+} from "./chunk-7AXVACK6.js";
 import {
   getConfigDir
-} from "./chunk-EYWC24VC.js";
+} from "./chunk-MVRPFLEL.js";
 import {
   currentOutcomeAttribution
-} from "./chunk-YRX5UOM3.js";
+} from "./chunk-7SGZHGZ2.js";
 import {
   AGENT_NONE,
   OutcomeSurfaces,
@@ -19,7 +19,7 @@ import {
   integrationConnectionPropertiesSchema,
   normalizeAgentSlug,
   usageSurfaceSchema
-} from "./chunk-WNCOBSPN.js";
+} from "./chunk-VPZMSV3Q.js";
 
 // src/outcome-telemetry.ts
 import fs from "fs";

package/dist/{citations-ZTQIYYDB.js → citations-NIFKIG6Y.js}

@@ -1,10 +1,10 @@
 import {
   createApiClient
-} from "./chunk-EIMXB6UH.js";
-import "./chunk-EYWC24VC.js";
+} from "./chunk-FDRZQH3Y.js";
+import "./chunk-MVRPFLEL.js";
 import "./chunk-AOJU5LKX.js";
 import "./chunk-HGMYEDAQ.js";
-import "./chunk-WNCOBSPN.js";
+import "./chunk-VPZMSV3Q.js";
 import "./chunk-MLKGABMK.js";
 
 // src/commands/citations.ts

package/dist/{cli-catalog-IZJXAHFQ.js → cli-catalog-ONYERYPV.js}

@@ -3,11 +3,11 @@ import {
   buildCliCatalog,
   printCliCatalog,
   renderTopLevelHelp
-} from "./chunk-TJZLICMB.js";
-import "./chunk-LBRG6RKI.js";
+} from "./chunk-7NMCRHQL.js";
+import "./chunk-33LH4ZGF.js";
 import "./chunk-Z7IUAJOF.js";
 import "./chunk-HGMYEDAQ.js";
-import "./chunk-WNCOBSPN.js";
+import "./chunk-VPZMSV3Q.js";
 import "./chunk-MLKGABMK.js";
 export {
   CLI_ROOT_SUMMARIES,