@ainyc/canonry 4.115.1 → 4.117.0

package/dist/{chunk-6LOKMEL3.js → chunk-IAJ5TQ4S.js}

@@ -1998,7 +1998,7 @@ var DEDUP_SIMILARITY_BAND_HIGH = 0.97;
 function computeDedupSimilarityStats(vectors, indexClusters) {
   const n = vectors.length;
   if (n < 2) return { perClusterMinSimilarity: [], bandPairFraction: null, pairsTotal: 0 };
-  const round = (v) => Math.round(v * 1e4) / 1e4;
+  const round2 = (v) => Math.round(v * 1e4) / 1e4;
   const perClusterMinSimilarity = [];
   for (const cluster of indexClusters) {
     if (cluster.length < 2) continue;
@@ -2008,7 +2008,7 @@ function computeDedupSimilarityStats(vectors, indexClusters) {
         min = Math.min(min, cosineSimilarity(vectors[cluster[a]], vectors[cluster[b]]));
       }
     }
-    perClusterMinSimilarity.push(round(min));
+    perClusterMinSimilarity.push(round2(min));
   }
   let inBand = 0;
   let pairsTotal = 0;
@@ -2019,7 +2019,7 @@ function computeDedupSimilarityStats(vectors, indexClusters) {
       if (sim >= DEDUP_SIMILARITY_BAND_LOW && sim < DEDUP_SIMILARITY_BAND_HIGH) inBand++;
     }
   }
-  return { perClusterMinSimilarity, bandPairFraction: round(inBand / pairsTotal), pairsTotal };
+  return { perClusterMinSimilarity, bandPairFraction: round2(inBand / pairsTotal), pairsTotal };
 }
 
 // ../contracts/src/url-normalize.ts
@@ -2894,6 +2894,137 @@ var visibilityStatsDtoSchema = z20.object({
   /** Pooled share of voice vs tracked competitors — present only when `shareOfVoice=1` was requested. */
   shareOfVoice: visibilityStatsShareOfVoiceSchema.optional()
 });
+var visibilityCompareVerdictSchema = z20.enum([
+  "within-noise",
+  "moved",
+  "insufficient-data",
+  "model-discontinuous",
+  "model-unknown"
+]);
+var visibilityCompareDirectionSchema = z20.enum(["up", "down", "flat"]);
+var visibilityCompareMetricPeriodSchema = z20.object({
+  /** The proportion in `[0,1]`, rounded to 4 dp; `null` when `denominator === 0` (undefined over no data). */
+  point: z20.number().nullable(),
+  /** Wilson 95% lower bound `[0,1]`; `null` when `denominator === 0`. */
+  ciLow: z20.number().nullable(),
+  /** Wilson 95% upper bound `[0,1]`; `null` when `denominator === 0`. */
+  ciHigh: z20.number().nullable(),
+  /** Successes (mentions / citations / project-brand mentions). */
+  numerator: z20.number().int(),
+  /** Sample size the proportion is over (checked snapshots / total / project+competitor brand mentions). */
+  denominator: z20.number().int()
+});
+var visibilityCompareMetricKeySchema = z20.enum([
+  "mention-share-of-voice",
+  "cited-share-of-voice",
+  "mention-rate",
+  "cited-rate"
+]);
+var visibilityCompareMetricSchema = z20.object({
+  key: visibilityCompareMetricKeySchema,
+  /** Human label ("Named share of voice", "Cited rate", …). */
+  label: z20.string(),
+  /**
+   * `true` for share of voice, which is less exposed to broad model-wide naming
+   * propensity than an absolute rate. It does not bypass model continuity: no
+   * metric can make a directional call when every provider is excluded.
+   */
+  driftRobust: z20.boolean(),
+  from: visibilityCompareMetricPeriodSchema,
+  to: visibilityCompareMetricPeriodSchema,
+  /** `to.point / from.point`; `null` when `from.point` is `0` or `null` (ratio undefined). */
+  rateRatio: z20.number().nullable(),
+  /** Sign of `to.point - from.point`; `null` when either point is `null`. */
+  direction: z20.union([visibilityCompareDirectionSchema, z20.null()]),
+  verdict: visibilityCompareVerdictSchema
+});
+var visibilityComparePeriodWindowSchema = z20.object({
+  /** The `YYYY-MM` requested. */
+  month: z20.string(),
+  /** Resolved inclusive ISO bounds the month expanded to. */
+  since: z20.string(),
+  until: z20.string(),
+  /** Completed/partial, non-probe answer-visibility runs in the month. */
+  runCount: z20.number().int(),
+  /**
+   * `true` when `runCount` is below the reliability floor (`< 5` sweeps): the
+   * intervals are wide and a `moved` verdict is unlikely to be reachable. A
+   * signal to raise the sweep schedule, surfaced so the report can caveat.
+   */
+  lowRunCount: z20.boolean()
+});
+var visibilityCompareBasketSchema = z20.object({
+  /** Distinct tracked queries with at least one common provider pair — the compared universe. */
+  queryCount: z20.number().int(),
+  /** Queries observed only in `from` (dropped from the comparison). */
+  excludedFromOnly: z20.number().int(),
+  /** Queries observed only in `to`. */
+  excludedToOnly: z20.number().int(),
+  /**
+   * The compared engine set: providers with ≥1 common query/provider pair.
+   */
+  providers: z20.array(z20.string()),
+  /** Providers observed in either period that did not make the basket (dropped from the comparison). */
+  excludedProviders: z20.array(z20.string())
+});
+var visibilityCompareModelChangeSchema = z20.object({
+  provider: z20.string(),
+  fromModels: z20.array(z20.string()),
+  toModels: z20.array(z20.string())
+});
+var visibilityCompareProviderContinuityStatusSchema = z20.enum([
+  "included",
+  "model-discontinuous",
+  "model-unknown"
+]);
+var visibilityCompareProviderContinuitySchema = z20.object({
+  provider: z20.string(),
+  /** `included` only when both months carry exactly one known model id, identical across the two, and NO snapshot with an unrecorded (null) model — a null mixed alongside a known id still marks the period `model-unknown`. */
+  status: visibilityCompareProviderContinuityStatusSchema,
+  fromModels: z20.array(z20.string()),
+  toModels: z20.array(z20.string())
+});
+var visibilityCompareContinuityStatusSchema = z20.enum([
+  "comparable",
+  "model-discontinuous",
+  "model-unknown",
+  "insufficient-data"
+]);
+var visibilityCompareContinuitySchema = z20.object({
+  status: visibilityCompareContinuityStatusSchema,
+  /** Providers retained in the directional comparison after the continuity gate. */
+  comparedProviders: z20.array(z20.string()),
+  /** Every provider with common query/provider pairs, including excluded ones and their model evidence. */
+  providers: z20.array(visibilityCompareProviderContinuitySchema)
+});
+var visibilityCompareProviderRowSchema = z20.object({
+  provider: z20.string(),
+  from: z20.object({ checked: z20.number().int(), mentioned: z20.number().int(), cited: z20.number().int() }),
+  to: z20.object({ checked: z20.number().int(), mentioned: z20.number().int(), cited: z20.number().int() })
+});
+var visibilityCompareQueriesMentionedSchema = z20.object({
+  from: z20.object({ count: z20.number().int(), of: z20.number().int() }),
+  to: z20.object({ count: z20.number().int(), of: z20.number().int() })
+});
+var visibilityCompareDtoSchema = z20.object({
+  project: z20.string(),
+  from: visibilityComparePeriodWindowSchema,
+  to: visibilityComparePeriodWindowSchema,
+  basket: visibilityCompareBasketSchema,
+  /** Ordered: mention SoV (primary), cited SoV, mention rate (level), cited rate. */
+  metrics: z20.array(visibilityCompareMetricSchema),
+  queriesMentioned: visibilityCompareQueriesMentionedSchema,
+  byProvider: z20.array(visibilityCompareProviderRowSchema),
+  /** Providers whose configured model id set changed between the periods (empty = none detected). */
+  modelChanges: z20.array(visibilityCompareModelChangeSchema),
+  /** Strict model-continuity evidence and the providers that remain comparable. */
+  continuity: visibilityCompareContinuitySchema,
+  /** Per-competitor mention counts within each period's basket (for the SoV detail). */
+  competitors: z20.object({
+    from: z20.array(visibilityStatsShareCompetitorSchema),
+    to: z20.array(visibilityStatsShareCompetitorSchema)
+  })
+});
 function calendarMonthBounds(month) {
   const match = /^(\d{4})-(\d{2})$/.exec(month);
   if (!match) throw new RangeError("month must be in YYYY-MM format");
@@ -2907,9 +3038,98 @@ function calendarMonthBounds(month) {
 }
 
 // ../contracts/src/ga.ts
+import { z as z22 } from "zod";
+
+// ../contracts/src/traffic-class.ts
 import { z as z21 } from "zod";
-var ga4AiReferralTrafficClassSchema = z21.enum(["organic", "paid"]);
-var GA4AiReferralTrafficClasses = ga4AiReferralTrafficClassSchema.enum;
+
+// ../contracts/src/formatting.ts
+function formatRatio(value) {
+  if (!Number.isFinite(value) || value === 0) return "0%";
+  return `${(value * 100).toFixed(1)}%`;
+}
+function formatNumber(value) {
+  if (!Number.isFinite(value)) return "\u2014";
+  if (Math.abs(value) >= 1e6) return `${(value / 1e6).toFixed(1)}M`;
+  if (Math.abs(value) >= 1e3) return `${(value / 1e3).toFixed(1)}K`;
+  return value.toLocaleString("en-US");
+}
+function formatDate(iso) {
+  if (!iso) return "\u2014";
+  try {
+    const dateOnly = /^(\d{4})-(\d{2})-(\d{2})$/.exec(iso);
+    const options = { month: "short", day: "numeric", year: "numeric" };
+    const d = dateOnly && dateOnly[1] && dateOnly[2] && dateOnly[3] ? new Date(Date.UTC(Number(dateOnly[1]), Number(dateOnly[2]) - 1, Number(dateOnly[3]))) : new Date(iso);
+    if (Number.isNaN(d.getTime())) return iso;
+    return d.toLocaleDateString("en-US", dateOnly ? { ...options, timeZone: "UTC" } : options);
+  } catch {
+    return iso;
+  }
+}
+function formatIsoDate(iso) {
+  if (!iso) return "\u2014";
+  try {
+    const d = new Date(iso);
+    if (Number.isNaN(d.getTime())) return iso;
+    const yyyy = d.getUTCFullYear();
+    const mm = String(d.getUTCMonth() + 1).padStart(2, "0");
+    const dd = String(d.getUTCDate()).padStart(2, "0");
+    return `${yyyy}-${mm}-${dd}`;
+  } catch {
+    return iso;
+  }
+}
+function formatDateRange(start, end) {
+  if (!start && !end) return "";
+  if (start && end) return `${formatDate(start)} \u2192 ${formatDate(end)}`;
+  return formatDate(start || end);
+}
+var DATE_ONLY_PATTERN = /^\d{4}-\d{2}-\d{2}$/;
+function parseInclusiveEndMs(iso) {
+  const ms = Date.parse(iso);
+  if (Number.isNaN(ms)) return null;
+  return DATE_ONLY_PATTERN.test(iso) ? ms + 864e5 - 1 : ms;
+}
+function deltaPercent(current, prior) {
+  if (prior <= 0) return null;
+  return Math.round((current - prior) / prior * 100);
+}
+function deltaTone(deltaPct) {
+  if (deltaPct === null || deltaPct === 0) return "neutral";
+  return deltaPct > 0 ? "positive" : "negative";
+}
+function formatDeltaCopy(d, suffix, windowLabel = "vs prior 7 days") {
+  if (d.deltaPct === null) {
+    return d.prior === 0 ? "First baseline week" : "";
+  }
+  if (d.deltaPct > 0) return `Up ${d.deltaPct}% ${windowLabel} (${formatNumber(d.prior)} ${suffix})`;
+  if (d.deltaPct < 0) return `Down ${Math.abs(d.deltaPct)}% ${windowLabel} (${formatNumber(d.prior)} ${suffix})`;
+  return `Flat ${windowLabel} (${formatNumber(d.prior)} ${suffix})`;
+}
+var MIN_PCT_BASE = 30;
+function round1(value) {
+  return Math.round(value * 10) / 10;
+}
+function formatAverageDelta(d) {
+  if (d.prior >= MIN_PCT_BASE && d.deltaPct !== null) {
+    const sign2 = d.deltaPct > 0 ? "+" : "";
+    return `${sign2}${d.deltaPct}% vs prior`;
+  }
+  const sign = d.deltaAbs > 0 ? "+" : "";
+  return `${sign}${round1(d.deltaAbs)} vs ${round1(d.prior)}`;
+}
+function formatWindowCountDelta(d, countLabel, windowLabel) {
+  if (d.prior >= MIN_PCT_BASE && d.deltaPct !== null) {
+    const sign2 = d.deltaPct > 0 ? "+" : "";
+    return `${sign2}${d.deltaPct}% ${windowLabel}`;
+  }
+  const sign = d.deltaAbs > 0 ? "+" : "";
+  return `${sign}${formatNumber(Math.round(d.deltaAbs))} ${countLabel} ${windowLabel}`;
+}
+
+// ../contracts/src/traffic-class.ts
+var aiReferralTrafficClassSchema = z21.enum(["organic", "paid"]);
+var AiReferralTrafficClasses = aiReferralTrafficClassSchema.enum;
 var PAID_CHANNEL_GROUPS = /* @__PURE__ */ new Set([
   "paid search",
   "paid social",
@@ -2956,39 +3176,51 @@ function hasPaidLandingPageParam(landingPage) {
     return false;
   }
 }
-function classifyGa4AiReferralTrafficClass(input) {
+function classifyAiReferralTrafficClass(input) {
   const channelGroup = (input.channelGroup ?? "").trim().toLowerCase();
   if (PAID_CHANNEL_GROUPS.has(channelGroup) || channelGroup.startsWith("paid ")) {
-    return GA4AiReferralTrafficClasses.paid;
+    return AiReferralTrafficClasses.paid;
   }
   if (hasPaidToken(input.medium) || hasPaidToken(input.source) || hasPaidLandingPageParam(input.landingPage)) {
-    return GA4AiReferralTrafficClasses.paid;
+    return AiReferralTrafficClasses.paid;
   }
-  return GA4AiReferralTrafficClasses.organic;
-}
-var ga4ConnectionDtoSchema = z21.object({
-  id: z21.string(),
-  projectId: z21.string(),
-  propertyId: z21.string(),
-  clientEmail: z21.string(),
-  connected: z21.boolean(),
-  createdAt: z21.string(),
-  updatedAt: z21.string()
-});
-var ga4TrafficSnapshotDtoSchema = z21.object({
-  date: z21.string(),
-  landingPage: z21.string(),
-  sessions: z21.number(),
-  organicSessions: z21.number(),
-  users: z21.number()
-});
-var ga4SourceDimensionSchema = z21.enum(["session", "first_user", "manual_utm"]);
-var ga4AiReferralDtoSchema = z21.object({
-  source: z21.string(),
-  medium: z21.string(),
-  trafficClass: ga4AiReferralTrafficClassSchema,
-  sessions: z21.number(),
-  users: z21.number(),
+  return AiReferralTrafficClasses.organic;
+}
+function aiReferralClassCounts(total, paid, organic) {
+  return { total, paid, organic, unknown: Math.max(0, total - paid - organic) };
+}
+function formatAiReferralClassSummary(counts) {
+  const parts = [];
+  if (counts.paid > 0) parts.push(`Paid ${formatNumber(counts.paid)}`);
+  if (counts.organic > 0) parts.push(`Organic ${formatNumber(counts.organic)}`);
+  if (counts.unknown > 0) parts.push(`Unclassified ${formatNumber(counts.unknown)}`);
+  return parts.join(" \xB7 ");
+}
+
+// ../contracts/src/ga.ts
+var ga4ConnectionDtoSchema = z22.object({
+  id: z22.string(),
+  projectId: z22.string(),
+  propertyId: z22.string(),
+  clientEmail: z22.string(),
+  connected: z22.boolean(),
+  createdAt: z22.string(),
+  updatedAt: z22.string()
+});
+var ga4TrafficSnapshotDtoSchema = z22.object({
+  date: z22.string(),
+  landingPage: z22.string(),
+  sessions: z22.number(),
+  organicSessions: z22.number(),
+  users: z22.number()
+});
+var ga4SourceDimensionSchema = z22.enum(["session", "first_user", "manual_utm"]);
+var ga4AiReferralDtoSchema = z22.object({
+  source: z22.string(),
+  medium: z22.string(),
+  trafficClass: aiReferralTrafficClassSchema,
+  sessions: z22.number(),
+  users: z22.number(),
   /**
    * The winning attribution dimension for this (source, medium) tuple — the
    * one with the highest session count. GA4 emits one row per dimension
@@ -2998,178 +3230,178 @@ var ga4AiReferralDtoSchema = z21.object({
    */
   sourceDimension: ga4SourceDimensionSchema
 });
-var ga4AiReferralLandingPageDtoSchema = z21.object({
-  source: z21.string(),
-  medium: z21.string(),
-  trafficClass: ga4AiReferralTrafficClassSchema,
+var ga4AiReferralLandingPageDtoSchema = z22.object({
+  source: z22.string(),
+  medium: z22.string(),
+  trafficClass: aiReferralTrafficClassSchema,
   /**
    * The winning attribution dimension for this (source, medium, landingPage)
    * tuple — the one with the highest session count.
    */
   sourceDimension: ga4SourceDimensionSchema,
-  landingPage: z21.string(),
-  sessions: z21.number(),
-  users: z21.number()
-});
-var ga4SocialReferralDtoSchema = z21.object({
-  source: z21.string(),
-  medium: z21.string(),
-  sessions: z21.number(),
-  users: z21.number(),
+  landingPage: z22.string(),
+  sessions: z22.number(),
+  users: z22.number()
+});
+var ga4SocialReferralDtoSchema = z22.object({
+  source: z22.string(),
+  medium: z22.string(),
+  sessions: z22.number(),
+  users: z22.number(),
   /** GA4 default channel group (e.g. 'Organic Social', 'Paid Social') */
-  channelGroup: z21.string()
+  channelGroup: z22.string()
 });
-var ga4ChannelBucketDtoSchema = z21.object({
-  sessions: z21.number(),
-  sharePct: z21.number(),
-  sharePctDisplay: z21.string()
+var ga4ChannelBucketDtoSchema = z22.object({
+  sessions: z22.number(),
+  sharePct: z22.number(),
+  sharePctDisplay: z22.string()
 });
-var ga4ChannelBreakdownDtoSchema = z21.object({
+var ga4ChannelBreakdownDtoSchema = z22.object({
   organic: ga4ChannelBucketDtoSchema,
   social: ga4ChannelBucketDtoSchema,
   direct: ga4ChannelBucketDtoSchema,
   ai: ga4ChannelBucketDtoSchema,
   other: ga4ChannelBucketDtoSchema
 });
-var ga4TrafficSummaryDtoSchema = z21.object({
-  totalSessions: z21.number(),
-  totalOrganicSessions: z21.number(),
+var ga4TrafficSummaryDtoSchema = z22.object({
+  totalSessions: z22.number(),
+  totalOrganicSessions: z22.number(),
   /** Direct-channel sessions (sessions with no source — bookmarks, typed URLs, AI-driven traffic with stripped referrer). 0 for legacy rows from before the column was added. */
-  totalDirectSessions: z21.number(),
-  totalUsers: z21.number(),
-  topPages: z21.array(z21.object({
-    landingPage: z21.string(),
-    sessions: z21.number(),
-    organicSessions: z21.number(),
+  totalDirectSessions: z22.number(),
+  totalUsers: z22.number(),
+  topPages: z22.array(z22.object({
+    landingPage: z22.string(),
+    sessions: z22.number(),
+    organicSessions: z22.number(),
     /** Per-page Direct-channel sessions. 0 for legacy rows. */
-    directSessions: z21.number(),
-    users: z21.number()
+    directSessions: z22.number(),
+    users: z22.number()
   })),
-  aiReferrals: z21.array(ga4AiReferralDtoSchema),
-  aiReferralLandingPages: z21.array(ga4AiReferralLandingPageDtoSchema),
+  aiReferrals: z22.array(ga4AiReferralDtoSchema),
+  aiReferralLandingPages: z22.array(ga4AiReferralLandingPageDtoSchema),
   /** Deduped AI session total: MAX(sessions) per date+source+medium across attribution dimensions, then summed. Cross-cutting: can overlap with Direct/Organic/Social via firstUserSource. */
-  aiSessionsDeduped: z21.number(),
+  aiSessionsDeduped: z22.number(),
   /** Deduped AI user total: MAX(users) per date+source+medium across attribution dimensions, then summed. */
-  aiUsersDeduped: z21.number(),
+  aiUsersDeduped: z22.number(),
   /** Deduped AI sessions whose attribution carries paid intent. */
-  paidAiSessionsDeduped: z21.number(),
+  paidAiSessionsDeduped: z22.number(),
   /** Deduped users for paid AI sessions. */
-  paidAiUsersDeduped: z21.number(),
+  paidAiUsersDeduped: z22.number(),
   /** Deduped AI sessions without paid intent evidence. */
-  organicAiSessionsDeduped: z21.number(),
+  organicAiSessionsDeduped: z22.number(),
   /** Deduped users for organic/non-paid AI sessions. */
-  organicAiUsersDeduped: z21.number(),
+  organicAiUsersDeduped: z22.number(),
   /** AI sessions whose CURRENT sessionSource matched an AI engine. Can overlap with raw Organic/Social/Direct totals; `channelBreakdown` removes those overlaps for display. */
-  aiSessionsBySession: z21.number(),
+  aiSessionsBySession: z22.number(),
   /** AI users whose CURRENT sessionSource matched an AI engine. Can overlap with raw Organic/Social/Direct totals. */
-  aiUsersBySession: z21.number(),
+  aiUsersBySession: z22.number(),
   /** Session-source-only paid AI sessions. */
-  paidAiSessionsBySession: z21.number(),
+  paidAiSessionsBySession: z22.number(),
   /** Session-source-only paid AI users. */
-  paidAiUsersBySession: z21.number(),
+  paidAiUsersBySession: z22.number(),
   /** Session-source-only organic/non-paid AI sessions. */
-  organicAiSessionsBySession: z21.number(),
+  organicAiSessionsBySession: z22.number(),
   /** Session-source-only organic/non-paid AI users. */
-  organicAiUsersBySession: z21.number(),
-  socialReferrals: z21.array(ga4SocialReferralDtoSchema),
+  organicAiUsersBySession: z22.number(),
+  socialReferrals: z22.array(ga4SocialReferralDtoSchema),
   /** Total social sessions (session-scoped, no cross-dimension dedup needed). */
-  socialSessions: z21.number(),
+  socialSessions: z22.number(),
   /** Total social users (session-scoped, no cross-dimension dedup needed). */
-  socialUsers: z21.number(),
+  socialUsers: z22.number(),
   /** Five disjoint buckets used for the channel breakdown. Known AI session-source matches are removed from their native GA4 bucket before shares are computed. */
   channelBreakdown: ga4ChannelBreakdownDtoSchema,
   /** Organic sessions as a percentage of total sessions (0–100, rounded). */
-  organicSharePct: z21.number(),
+  organicSharePct: z22.number(),
   /** Deduped AI sessions as a percentage of total sessions (0–100, rounded). Cross-cutting: can overlap with Direct/Organic/Social. */
-  aiSharePct: z21.number(),
+  aiSharePct: z22.number(),
   /** Session-source-only AI sessions as a percentage of total sessions (0–100, rounded). Can overlap with raw Organic/Social/Direct totals. */
-  aiSharePctBySession: z21.number(),
+  aiSharePctBySession: z22.number(),
   /** Paid AI sessions as a percentage of total sessions (0–100, rounded). */
-  paidAiSharePct: z21.number(),
+  paidAiSharePct: z22.number(),
   /** Session-source paid AI sessions as a percentage of total sessions (0–100, rounded). */
-  paidAiSharePctBySession: z21.number(),
+  paidAiSharePctBySession: z22.number(),
   /** Organic/non-paid AI sessions as a percentage of total sessions (0–100, rounded). */
-  organicAiSharePct: z21.number(),
+  organicAiSharePct: z22.number(),
   /** Session-source organic/non-paid AI sessions as a percentage of total sessions (0–100, rounded). */
-  organicAiSharePctBySession: z21.number(),
+  organicAiSharePctBySession: z22.number(),
   /** Direct-channel sessions as a percentage of total sessions (0–100, rounded). */
-  directSharePct: z21.number(),
+  directSharePct: z22.number(),
   /** Social sessions as a percentage of total sessions (0–100, rounded). */
-  socialSharePct: z21.number(),
+  socialSharePct: z22.number(),
   /** Display string for organicSharePct: 'X%', '<1%' for non-zero shares that round below 1, or '—' when sessions exist but total is unknown (partial sync). */
-  organicSharePctDisplay: z21.string(),
+  organicSharePctDisplay: z22.string(),
   /** Display string for aiSharePct: 'X%', '<1%' for non-zero shares that round below 1, or '—' when sessions exist but total is unknown (partial sync). */
-  aiSharePctDisplay: z21.string(),
+  aiSharePctDisplay: z22.string(),
   /** Display string for aiSharePctBySession: 'X%', '<1%' for non-zero shares that round below 1, or '—' when sessions exist but total is unknown (partial sync). */
-  aiSharePctBySessionDisplay: z21.string(),
+  aiSharePctBySessionDisplay: z22.string(),
   /** Display string for paidAiSharePct. */
-  paidAiSharePctDisplay: z21.string(),
+  paidAiSharePctDisplay: z22.string(),
   /** Display string for paidAiSharePctBySession. */
-  paidAiSharePctBySessionDisplay: z21.string(),
+  paidAiSharePctBySessionDisplay: z22.string(),
   /** Display string for organicAiSharePct. */
-  organicAiSharePctDisplay: z21.string(),
+  organicAiSharePctDisplay: z22.string(),
   /** Display string for organicAiSharePctBySession. */
-  organicAiSharePctBySessionDisplay: z21.string(),
+  organicAiSharePctBySessionDisplay: z22.string(),
   /** Display string for directSharePct: 'X%', '<1%' for non-zero shares that round below 1, or '—' when sessions exist but total is unknown (partial sync). */
-  directSharePctDisplay: z21.string(),
+  directSharePctDisplay: z22.string(),
   /** Display string for socialSharePct: 'X%', '<1%' for non-zero shares that round below 1, or '—' when sessions exist but total is unknown (partial sync). */
-  socialSharePctDisplay: z21.string(),
+  socialSharePctDisplay: z22.string(),
   /** Sessions not covered by Organic, Social, Direct, or AI (session) channels — e.g. Referral, Email, Paid Search, Display. Always non-negative; clamped to 0 when the four disjoint channels sum above total (rounding edge). */
-  otherSessions: z21.number(),
+  otherSessions: z22.number(),
   /** Other sessions as a percentage of total sessions (0–100, rounded). */
-  otherSharePct: z21.number(),
+  otherSharePct: z22.number(),
   /** Display string for otherSharePct: 'X%', '<1%' for non-zero shares that round below 1, or '—' when sessions exist but total is unknown (partial sync). */
-  otherSharePctDisplay: z21.string(),
-  lastSyncedAt: z21.string().nullable()
-});
-var ga4StatusDtoSchema = z21.object({
-  connected: z21.boolean(),
-  propertyId: z21.string().nullable(),
-  clientEmail: z21.string().nullable(),
-  authMethod: z21.enum(["service-account", "oauth"]).nullable(),
-  lastSyncedAt: z21.string().nullable(),
-  createdAt: z21.string().nullable().optional(),
-  updatedAt: z21.string().nullable().optional()
-});
-var ga4SyncResponseDtoSchema = z21.object({
-  synced: z21.boolean(),
-  rowCount: z21.number().int().nonnegative(),
-  aiReferralCount: z21.number().int().nonnegative(),
-  socialReferralCount: z21.number().int().nonnegative(),
-  days: z21.number().int().nonnegative(),
-  syncedAt: z21.string(),
+  otherSharePctDisplay: z22.string(),
+  lastSyncedAt: z22.string().nullable()
+});
+var ga4StatusDtoSchema = z22.object({
+  connected: z22.boolean(),
+  propertyId: z22.string().nullable(),
+  clientEmail: z22.string().nullable(),
+  authMethod: z22.enum(["service-account", "oauth"]).nullable(),
+  lastSyncedAt: z22.string().nullable(),
+  createdAt: z22.string().nullable().optional(),
+  updatedAt: z22.string().nullable().optional()
+});
+var ga4SyncResponseDtoSchema = z22.object({
+  synced: z22.boolean(),
+  rowCount: z22.number().int().nonnegative(),
+  aiReferralCount: z22.number().int().nonnegative(),
+  socialReferralCount: z22.number().int().nonnegative(),
+  days: z22.number().int().nonnegative(),
+  syncedAt: z22.string(),
   /**
    * Components that were written this run. Present when `only` is set.
    * Always includes `traffic` and `summary` (the share denominator) plus
    * the requested channel breakdown — `ai` and/or `social`.
    */
-  syncedComponents: z21.array(z21.string()).optional()
-});
-var ga4AiReferralHistoryEntrySchema = z21.object({
-  date: z21.string(),
-  source: z21.string(),
-  medium: z21.string(),
-  trafficClass: ga4AiReferralTrafficClassSchema,
-  landingPage: z21.string(),
-  sessions: z21.number(),
-  users: z21.number(),
+  syncedComponents: z22.array(z22.string()).optional()
+});
+var ga4AiReferralHistoryEntrySchema = z22.object({
+  date: z22.string(),
+  source: z22.string(),
+  medium: z22.string(),
+  trafficClass: aiReferralTrafficClassSchema,
+  landingPage: z22.string(),
+  sessions: z22.number(),
+  users: z22.number(),
   /** Which GA4 dimension this row came from: session (sessionSource), first_user (firstUserSource), or manual_utm (utm_source parameter) */
   sourceDimension: ga4SourceDimensionSchema
 });
-var ga4SocialReferralHistoryEntrySchema = z21.object({
-  date: z21.string(),
-  source: z21.string(),
-  medium: z21.string(),
-  sessions: z21.number(),
-  users: z21.number(),
+var ga4SocialReferralHistoryEntrySchema = z22.object({
+  date: z22.string(),
+  source: z22.string(),
+  medium: z22.string(),
+  sessions: z22.number(),
+  users: z22.number(),
   /** GA4 default channel group (e.g. 'Organic Social', 'Paid Social') */
-  channelGroup: z21.string()
+  channelGroup: z22.string()
 });
-var ga4SessionHistoryEntrySchema = z21.object({
-  date: z21.string(),
-  sessions: z21.number(),
-  organicSessions: z21.number(),
-  users: z21.number()
+var ga4SessionHistoryEntrySchema = z22.object({
+  date: z22.string(),
+  sessions: z22.number(),
+  organicSessions: z22.number(),
+  users: z22.number()
 });
 
 // ../contracts/src/answer-visibility.ts
@@ -3337,50 +3569,50 @@ function escapeRegExp(value) {
 }
 
 // ../contracts/src/agent.ts
-import { z as z22 } from "zod";
-var agentProviderIdSchema = z22.enum(["claude", "openai", "gemini", "zai", "deepinfra"]);
-var agentProviderOptionDtoSchema = z22.object({
+import { z as z23 } from "zod";
+var agentProviderIdSchema = z23.enum(["claude", "openai", "gemini", "zai", "deepinfra"]);
+var agentProviderOptionDtoSchema = z23.object({
   /** Stable identifier — what clients pass back as `provider` on the prompt endpoint. */
   id: agentProviderIdSchema,
   /** Human-readable label for UI pickers, e.g. "Anthropic (Claude)". */
-  label: z22.string(),
+  label: z23.string(),
   /** Default model if the caller doesn't pick one. */
-  defaultModel: z22.string(),
+  defaultModel: z23.string(),
   /** Whether a usable API key was found (config.yaml or provider env var). */
-  configured: z22.boolean(),
+  configured: z23.boolean(),
   /**
    * Where the key resolved from, if any. `null` when `configured === false`.
    * Surfaced so the UI can nudge users toward their preferred source of truth.
    */
-  keySource: z22.enum(["config", "env"]).nullable()
+  keySource: z23.enum(["config", "env"]).nullable()
 });
-var agentProvidersResponseDtoSchema = z22.object({
+var agentProvidersResponseDtoSchema = z23.object({
   /**
    * Every provider Aero knows about. `configured === false` entries are
    * included so the UI can render them disabled with an onboarding hint.
    */
-  providers: z22.array(agentProviderOptionDtoSchema).default([]),
+  providers: z23.array(agentProviderOptionDtoSchema).default([]),
   /**
    * Provider Aero auto-picks when no explicit override is passed. Null if
    * nothing is configured (install never exchanged a key).
    */
   defaultProvider: agentProviderIdSchema.nullable()
 });
-var memorySourceSchema = z22.enum(["aero", "user", "compaction"]);
+var memorySourceSchema = z23.enum(["aero", "user", "compaction"]);
 var MemorySources = memorySourceSchema.enum;
 var AGENT_MEMORY_VALUE_MAX_BYTES = 2 * 1024;
 var AGENT_MEMORY_KEY_MAX_LENGTH = 128;
-var agentMemoryUpsertRequestSchema = z22.object({
-  key: z22.string().min(1).max(AGENT_MEMORY_KEY_MAX_LENGTH),
-  value: z22.string().min(1)
+var agentMemoryUpsertRequestSchema = z23.object({
+  key: z23.string().min(1).max(AGENT_MEMORY_KEY_MAX_LENGTH),
+  value: z23.string().min(1)
 });
-var agentMemoryDeleteRequestSchema = z22.object({
-  key: z22.string().min(1).max(AGENT_MEMORY_KEY_MAX_LENGTH)
+var agentMemoryDeleteRequestSchema = z23.object({
+  key: z23.string().min(1).max(AGENT_MEMORY_KEY_MAX_LENGTH)
 });
 
 // ../contracts/src/backlinks.ts
-import { z as z23 } from "zod";
-var backlinkSourceSchema = z23.enum(["commoncrawl", "bing-webmaster"]);
+import { z as z24 } from "zod";
+var backlinkSourceSchema = z24.enum(["commoncrawl", "bing-webmaster"]);
 var BacklinkSources = backlinkSourceSchema.enum;
 function computeBacklinkSummaryMetrics(rows) {
   if (rows.length === 0) {
@@ -3396,181 +3628,181 @@ function computeBacklinkSummaryMetrics(rows) {
     top10HostsShare: share.toFixed(6)
   };
 }
-var ccReleaseSyncStatusSchema = z23.enum(["queued", "downloading", "querying", "ready", "failed"]);
+var ccReleaseSyncStatusSchema = z24.enum(["queued", "downloading", "querying", "ready", "failed"]);
 var CcReleaseSyncStatuses = ccReleaseSyncStatusSchema.enum;
-var ccReleaseSyncDtoSchema = z23.object({
-  id: z23.string(),
-  release: z23.string(),
+var ccReleaseSyncDtoSchema = z24.object({
+  id: z24.string(),
+  release: z24.string(),
   status: ccReleaseSyncStatusSchema,
-  phaseDetail: z23.string().nullable().optional(),
-  vertexPath: z23.string().nullable().optional(),
-  edgesPath: z23.string().nullable().optional(),
-  vertexSha256: z23.string().nullable().optional(),
-  edgesSha256: z23.string().nullable().optional(),
-  vertexBytes: z23.number().int().nullable().optional(),
-  edgesBytes: z23.number().int().nullable().optional(),
-  projectsProcessed: z23.number().int().nullable().optional(),
-  domainsDiscovered: z23.number().int().nullable().optional(),
-  downloadStartedAt: z23.string().nullable().optional(),
-  downloadFinishedAt: z23.string().nullable().optional(),
-  queryStartedAt: z23.string().nullable().optional(),
-  queryFinishedAt: z23.string().nullable().optional(),
-  error: z23.string().nullable().optional(),
-  createdAt: z23.string(),
-  updatedAt: z23.string()
-});
-var backlinkDomainDtoSchema = z23.object({
-  linkingDomain: z23.string(),
+  phaseDetail: z24.string().nullable().optional(),
+  vertexPath: z24.string().nullable().optional(),
+  edgesPath: z24.string().nullable().optional(),
+  vertexSha256: z24.string().nullable().optional(),
+  edgesSha256: z24.string().nullable().optional(),
+  vertexBytes: z24.number().int().nullable().optional(),
+  edgesBytes: z24.number().int().nullable().optional(),
+  projectsProcessed: z24.number().int().nullable().optional(),
+  domainsDiscovered: z24.number().int().nullable().optional(),
+  downloadStartedAt: z24.string().nullable().optional(),
+  downloadFinishedAt: z24.string().nullable().optional(),
+  queryStartedAt: z24.string().nullable().optional(),
+  queryFinishedAt: z24.string().nullable().optional(),
+  error: z24.string().nullable().optional(),
+  createdAt: z24.string(),
+  updatedAt: z24.string()
+});
+var backlinkDomainDtoSchema = z24.object({
+  linkingDomain: z24.string(),
   // For Common Crawl this is the count of distinct hosts within the linking
   // domain; for Bing Webmaster it is the count of distinct linking pages (URLs)
   // from that linking host. Read alongside `source` — the unit differs per source.
-  numHosts: z23.number().int(),
+  numHosts: z24.number().int(),
   source: backlinkSourceSchema
 });
-var backlinkSummaryDtoSchema = z23.object({
-  projectId: z23.string(),
+var backlinkSummaryDtoSchema = z24.object({
+  projectId: z24.string(),
   // Window identifier. Common Crawl uses the release slug
   // (`cc-main-YYYY-<mon>-<mon>-<mon>`); Bing Webmaster uses a synthetic
   // per-sync-day window (`bing-YYYY-MM-DD`).
-  release: z23.string(),
-  targetDomain: z23.string(),
-  totalLinkingDomains: z23.number().int(),
-  totalHosts: z23.number().int(),
-  top10HostsShare: z23.string(),
-  queriedAt: z23.string(),
+  release: z24.string(),
+  targetDomain: z24.string(),
+  totalLinkingDomains: z24.number().int(),
+  totalHosts: z24.number().int(),
+  top10HostsShare: z24.string(),
+  queriedAt: z24.string(),
   source: backlinkSourceSchema,
   // Populated when the response is filtered (e.g. ?excludeCrawlers=1).
   // Counts the rows omitted from totalLinkingDomains/totalHosts so callers
   // can show "N hidden" hints without re-deriving them.
-  excludedLinkingDomains: z23.number().int().optional(),
-  excludedHosts: z23.number().int().optional()
+  excludedLinkingDomains: z24.number().int().optional(),
+  excludedHosts: z24.number().int().optional()
 });
-var backlinkListResponseSchema = z23.object({
+var backlinkListResponseSchema = z24.object({
   // The source this response was filtered to (defaults to commoncrawl when the
   // caller omits `?source`).
   source: backlinkSourceSchema,
   summary: backlinkSummaryDtoSchema.nullable(),
-  total: z23.number().int(),
-  rows: z23.array(backlinkDomainDtoSchema)
-});
-var backlinkHistoryEntrySchema = z23.object({
-  release: z23.string(),
-  totalLinkingDomains: z23.number().int(),
-  totalHosts: z23.number().int(),
-  top10HostsShare: z23.string(),
-  queriedAt: z23.string(),
+  total: z24.number().int(),
+  rows: z24.array(backlinkDomainDtoSchema)
+});
+var backlinkHistoryEntrySchema = z24.object({
+  release: z24.string(),
+  totalLinkingDomains: z24.number().int(),
+  totalHosts: z24.number().int(),
+  top10HostsShare: z24.string(),
+  queriedAt: z24.string(),
   source: backlinkSourceSchema
 });
-var backlinkSourceAvailabilityDtoSchema = z23.object({
+var backlinkSourceAvailabilityDtoSchema = z24.object({
   source: backlinkSourceSchema,
   /**
    * The source is set up for this project:
    *  - commoncrawl: `autoExtractBacklinks` enabled AND a `ready` release sync exists.
    *  - bing-webmaster: a Bing Webmaster connection exists for the project domain.
    */
-  connected: z23.boolean(),
+  connected: z24.boolean(),
   /** Backlink rows exist for this project + source. */
-  hasData: z23.boolean(),
+  hasData: z24.boolean(),
   /** Latest window id with data for this source, null when none. */
-  latestRelease: z23.string().nullable(),
+  latestRelease: z24.string().nullable(),
   /**
    * Linking-domain count in the latest window. Excludes crawler/proxy hosts only
    * when the request sets `?excludeCrawlers=1` (default off, matching the summary
    * and domains endpoints); the dashboard passes it so the switcher pill matches
    * the metric card.
    */
-  totalLinkingDomains: z23.number().int(),
+  totalLinkingDomains: z24.number().int(),
   /** Freshness: `queriedAt` of the latest summary for this source, null when none. */
-  lastSyncedAt: z23.string().nullable()
+  lastSyncedAt: z24.string().nullable()
 });
-var backlinkSourcesResponseSchema = z23.object({
-  projectId: z23.string(),
-  targetDomain: z23.string(),
+var backlinkSourcesResponseSchema = z24.object({
+  projectId: z24.string(),
+  targetDomain: z24.string(),
   /** Availability for every known source, in a stable order. */
-  sources: z23.array(backlinkSourceAvailabilityDtoSchema),
-  anyConnected: z23.boolean(),
-  anyData: z23.boolean()
-});
-var backlinksInstallStatusDtoSchema = z23.object({
-  duckdbInstalled: z23.boolean(),
-  duckdbVersion: z23.string().nullable().optional(),
-  duckdbSpec: z23.string(),
-  pluginDir: z23.string()
-});
-var backlinksInstallResultDtoSchema = z23.object({
-  installed: z23.boolean(),
-  version: z23.string(),
-  path: z23.string(),
-  alreadyPresent: z23.boolean()
-});
-var ccAvailableReleaseSchema = z23.object({
-  release: z23.string(),
-  vertexUrl: z23.string(),
-  edgesUrl: z23.string(),
-  vertexBytes: z23.number().int().nullable(),
-  edgesBytes: z23.number().int().nullable(),
-  lastModified: z23.string().nullable()
-});
-var ccCachedReleaseSchema = z23.object({
-  release: z23.string(),
+  sources: z24.array(backlinkSourceAvailabilityDtoSchema),
+  anyConnected: z24.boolean(),
+  anyData: z24.boolean()
+});
+var backlinksInstallStatusDtoSchema = z24.object({
+  duckdbInstalled: z24.boolean(),
+  duckdbVersion: z24.string().nullable().optional(),
+  duckdbSpec: z24.string(),
+  pluginDir: z24.string()
+});
+var backlinksInstallResultDtoSchema = z24.object({
+  installed: z24.boolean(),
+  version: z24.string(),
+  path: z24.string(),
+  alreadyPresent: z24.boolean()
+});
+var ccAvailableReleaseSchema = z24.object({
+  release: z24.string(),
+  vertexUrl: z24.string(),
+  edgesUrl: z24.string(),
+  vertexBytes: z24.number().int().nullable(),
+  edgesBytes: z24.number().int().nullable(),
+  lastModified: z24.string().nullable()
+});
+var ccCachedReleaseSchema = z24.object({
+  release: z24.string(),
   syncStatus: ccReleaseSyncStatusSchema.nullable(),
-  bytes: z23.number().int(),
-  lastUsedAt: z23.string().nullable()
+  bytes: z24.number().int(),
+  lastUsedAt: z24.string().nullable()
 });
 
 // ../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(),
+import { z as z25 } from "zod";
+var metricToneSchema = z25.enum(["positive", "caution", "negative", "neutral"]);
+var scoreSummarySchema = z25.object({
+  label: z25.string(),
+  value: z25.string(),
+  delta: z25.string(),
   tone: metricToneSchema,
-  description: z24.string(),
-  tooltip: z24.string().optional(),
-  trend: z24.array(z24.number()),
-  progress: z24.number().optional(),
-  providerCoverage: z24.string().optional()
+  description: z25.string(),
+  tooltip: z25.string().optional(),
+  trend: z25.array(z25.number()),
+  progress: z25.number().optional(),
+  providerCoverage: z25.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()
+  breakdown: z25.object({
+    projectMentionSnapshots: z25.number().int().nonnegative(),
+    competitorMentionSnapshots: z25.number().int().nonnegative(),
+    perCompetitor: z25.array(z25.object({
+      domain: z25.string(),
+      mentionSnapshots: z25.number().int().nonnegative(),
+      shareOfCompetitiveTotal: z25.number()
     })),
-    snapshotsWithAnswerText: z24.number().int().nonnegative(),
-    snapshotsTotal: z24.number().int().nonnegative()
+    snapshotsWithAnswerText: z25.number().int().nonnegative(),
+    snapshotsTotal: z25.number().int().nonnegative()
   })
 });
-var movementSummarySchema = z24.object({
-  gained: z24.number().int().nonnegative(),
-  lost: z24.number().int().nonnegative(),
+var movementSummarySchema = z25.object({
+  gained: z25.number().int().nonnegative(),
+  lost: z25.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([
+  hasPreviousRun: z25.boolean(),
+  gainedQueries: z25.array(z25.string()).optional(),
+  lostQueries: z25.array(z25.string()).optional()
+});
+var movementComparisonSchema = z25.object({
+  hasPreviousRun: z25.boolean(),
+  comparable: z25.boolean(),
+  querySetChanged: z25.boolean(),
+  previousRunAt: z25.string().nullable(),
+  currentQueryCount: z25.number().int().nonnegative(),
+  previousQueryCount: z25.number().int().nonnegative(),
+  comparableQueryCount: z25.number().int().nonnegative(),
+  addedQueryCount: z25.number().int().nonnegative(),
+  removedQueryCount: z25.number().int().nonnegative(),
+  addedQueries: z25.array(z25.string()),
+  removedQueries: z25.array(z25.string())
+});
+var projectOverviewInsightSchema = z25.object({
+  id: z25.string(),
+  projectId: z25.string(),
+  runId: z25.string().nullable(),
+  type: z25.enum([
     "regression",
     "gain",
     "opportunity",
@@ -3586,70 +3818,70 @@ var projectOverviewInsightSchema = z24.object({
     "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()
+  severity: z25.enum(["critical", "high", "medium", "low"]),
+  title: z25.string(),
+  query: z25.string(),
+  provider: z25.string(),
+  recommendation: z25.object({
+    action: z25.string(),
+    target: z25.string().optional(),
+    reason: z25.string()
   }).optional(),
-  cause: z24.object({
-    cause: z24.string(),
-    competitorDomain: z24.string().optional(),
-    details: z24.string().optional()
+  cause: z25.object({
+    cause: z25.string(),
+    competitorDomain: z25.string().optional(),
+    details: z25.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()
+  dismissed: z25.boolean(),
+  createdAt: z25.string()
+});
+var projectOverviewHealthSchema = z25.object({
+  id: z25.string(),
+  projectId: z25.string(),
+  runId: z25.string().nullable(),
+  overallCitedRate: z25.number(),
+  overallMentionRate: z25.number(),
+  totalPairs: z25.number().int().nonnegative(),
+  citedPairs: z25.number().int().nonnegative(),
+  mentionedPairs: z25.number().int().nonnegative(),
+  providerBreakdown: z25.record(z25.string(), z25.object({
+    citedRate: z25.number(),
+    mentionRate: z25.number(),
+    cited: z25.number().int().nonnegative(),
+    mentioned: z25.number().int().nonnegative(),
+    total: z25.number().int().nonnegative()
   })),
-  createdAt: z24.string(),
-  status: z24.enum(["ready", "no-data"]),
-  reason: z24.literal("no-runs-yet").optional()
+  createdAt: z25.string(),
+  status: z25.enum(["ready", "no-data"]),
+  reason: z25.literal("no-runs-yet").optional()
 });
-var projectOverviewDtoSchema = z24.object({
+var projectOverviewDtoSchema = z25.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()
+  topInsights: z25.array(projectOverviewInsightSchema),
+  queryCounts: z25.object({
+    totalQueries: z25.number().int().nonnegative(),
+    citedQueries: z25.number().int().nonnegative(),
+    notCitedQueries: z25.number().int().nonnegative(),
+    citedRate: z25.number(),
+    mentionedQueries: z25.number().int().nonnegative(),
+    notMentionedQueries: z25.number().int().nonnegative(),
+    mentionRate: z25.number()
   }),
-  providers: z24.array(z24.object({
-    provider: z24.string(),
-    citedRate: z24.number(),
-    cited: z24.number().int().nonnegative(),
-    total: z24.number().int().nonnegative()
+  providers: z25.array(z25.object({
+    provider: z25.string(),
+    citedRate: z25.number(),
+    cited: z25.number().int().nonnegative(),
+    total: z25.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()
+  transitions: z25.object({
+    since: z25.string().nullable(),
+    gained: z25.number().int().nonnegative(),
+    lost: z25.number().int().nonnegative(),
+    emerging: z25.number().int().nonnegative()
   }),
-  scores: z24.object({
+  scores: z25.object({
     mention: scoreSummarySchema,
     visibility: scoreSummarySchema,
     mentionShare: mentionShareSchema,
@@ -3663,72 +3895,72 @@ var projectOverviewDtoSchema = z24.object({
   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())
+  competitors: z25.array(z25.object({
+    id: z25.string(),
+    domain: z25.string(),
+    citationCount: z25.number().int().nonnegative(),
+    totalQueries: z25.number().int().nonnegative(),
+    pressureLabel: z25.enum(["None", "Low", "Moderate", "High"]),
+    citedQueries: z25.array(z25.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()
+  providerScores: z25.array(z25.object({
+    provider: z25.string(),
+    model: z25.string().nullable(),
+    score: z25.number(),
+    cited: z25.number().int().nonnegative(),
+    total: z25.number().int().nonnegative(),
+    trend: z25.array(z25.number()).optional()
   })),
-  attentionItems: z24.array(z24.object({
-    id: z24.string(),
+  attentionItems: z25.array(z25.object({
+    id: z25.string(),
     tone: metricToneSchema,
-    title: z24.string(),
-    detail: z24.string(),
-    actionLabel: z24.string(),
-    href: z24.string()
+    title: z25.string(),
+    detail: z25.string(),
+    actionLabel: z25.string(),
+    href: z25.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()
+  runHistory: z25.array(z25.object({
+    runId: z25.string(),
+    createdAt: z25.string(),
+    citedCount: z25.number().int().nonnegative(),
+    totalCount: z25.number().int().nonnegative(),
+    citationRate: z25.number(),
+    mentionedCount: z25.number().int().nonnegative(),
+    mentionRate: z25.number(),
+    status: z25.string()
   })),
-  suggestedQueries: z24.object({
-    rows: z24.array(z24.object({
-      query: z24.string(),
-      impressions: z24.number(),
-      clicks: z24.number(),
-      avgPosition: z24.number(),
-      reason: z24.string()
+  suggestedQueries: z25.object({
+    rows: z25.array(z25.object({
+      query: z25.string(),
+      impressions: z25.number(),
+      clicks: z25.number(),
+      avgPosition: z25.number(),
+      reason: z25.string()
     })),
-    totalCandidates: z24.number().int().nonnegative(),
-    skippedAlreadyTracked: z24.number().int().nonnegative()
+    totalCandidates: z25.number().int().nonnegative(),
+    skippedAlreadyTracked: z25.number().int().nonnegative()
   }),
-  dateRangeLabel: z24.string(),
-  contextLabel: z24.string()
-});
-var searchHitKindSchema = z24.enum(["snapshot", "insight"]);
-var projectSearchSnapshotHitSchema = z24.object({
-  kind: z24.literal("snapshot"),
-  id: z24.string(),
-  runId: z24.string(),
-  query: z24.string(),
-  provider: z24.string(),
-  model: z24.string().nullable(),
+  dateRangeLabel: z25.string(),
+  contextLabel: z25.string()
+});
+var searchHitKindSchema = z25.enum(["snapshot", "insight"]);
+var projectSearchSnapshotHitSchema = z25.object({
+  kind: z25.literal("snapshot"),
+  id: z25.string(),
+  runId: z25.string(),
+  query: z25.string(),
+  provider: z25.string(),
+  model: z25.string().nullable(),
   citationState: citationStateSchema,
-  matchedField: z24.enum(["answerText", "citedDomains", "searchQueries", "query"]),
-  snippet: z24.string(),
-  createdAt: z24.string()
-});
-var projectSearchInsightHitSchema = z24.object({
-  kind: z24.literal("insight"),
-  id: z24.string(),
-  runId: z24.string().nullable(),
-  type: z24.enum([
+  matchedField: z25.enum(["answerText", "citedDomains", "searchQueries", "query"]),
+  snippet: z25.string(),
+  createdAt: z25.string()
+});
+var projectSearchInsightHitSchema = z25.object({
+  kind: z25.literal("insight"),
+  id: z25.string(),
+  runId: z25.string().nullable(),
+  type: z25.enum([
     "regression",
     "gain",
     "opportunity",
@@ -3745,29 +3977,29 @@ var projectSearchInsightHitSchema = z24.object({
     "gbp-metric-drop",
     "gbp-keyword-drop"
   ]),
-  severity: z24.enum(["critical", "high", "medium", "low"]),
-  title: z24.string(),
-  query: z24.string(),
-  provider: z24.string(),
-  matchedField: z24.enum(["title", "query", "recommendation", "cause"]),
-  snippet: z24.string(),
-  dismissed: z24.boolean(),
-  createdAt: z24.string()
-});
-var projectSearchHitSchema = z24.discriminatedUnion("kind", [
+  severity: z25.enum(["critical", "high", "medium", "low"]),
+  title: z25.string(),
+  query: z25.string(),
+  provider: z25.string(),
+  matchedField: z25.enum(["title", "query", "recommendation", "cause"]),
+  snippet: z25.string(),
+  dismissed: z25.boolean(),
+  createdAt: z25.string()
+});
+var projectSearchHitSchema = z25.discriminatedUnion("kind", [
   projectSearchSnapshotHitSchema,
   projectSearchInsightHitSchema
 ]);
-var projectSearchResponseSchema = z24.object({
-  query: z24.string(),
-  totalHits: z24.number().int().nonnegative(),
-  truncated: z24.boolean(),
-  hits: z24.array(projectSearchHitSchema)
+var projectSearchResponseSchema = z25.object({
+  query: z25.string(),
+  totalHits: z25.number().int().nonnegative(),
+  truncated: z25.boolean(),
+  hits: z25.array(projectSearchHitSchema)
 });
 
 // ../contracts/src/content.ts
-import { z as z25 } from "zod";
-var contentActionSchema = z25.enum(["create", "expand", "refresh", "add-schema"]);
+import { z as z26 } from "zod";
+var contentActionSchema = z26.enum(["create", "expand", "refresh", "add-schema"]);
 var ContentActions = contentActionSchema.enum;
 function contentActionLabel(action) {
   switch (action) {
@@ -3781,9 +4013,9 @@ function contentActionLabel(action) {
       return "Add schema";
   }
 }
-var demandSourceSchema = z25.enum(["gsc", "competitor-evidence", "both"]);
+var demandSourceSchema = z26.enum(["gsc", "competitor-evidence", "both"]);
 var DemandSources = demandSourceSchema.enum;
-var actionConfidenceSchema = z25.enum(["high", "medium", "low"]);
+var actionConfidenceSchema = z26.enum(["high", "medium", "low"]);
 var ActionConfidences = actionConfidenceSchema.enum;
 function actionConfidenceLabel(confidence) {
   switch (confidence) {
@@ -3795,7 +4027,7 @@ function actionConfidenceLabel(confidence) {
       return "Low";
   }
 }
-var pageTypeSchema = z25.enum([
+var pageTypeSchema = z26.enum([
   "blog-post",
   "comparison",
   "listicle",
@@ -3804,7 +4036,7 @@ var pageTypeSchema = z25.enum([
   "glossary"
 ]);
 var PageTypes = pageTypeSchema.enum;
-var contentActionStateSchema = z25.enum([
+var contentActionStateSchema = z26.enum([
   "proposed",
   "briefed",
   "payload-generated",
@@ -3814,7 +4046,7 @@ var contentActionStateSchema = z25.enum([
   "dismissed"
 ]);
 var ContentActionStates = contentActionStateSchema.enum;
-var winnabilityClassSchema = z25.enum(["ownable", "ceded"]);
+var winnabilityClassSchema = z26.enum(["ownable", "ceded"]);
 var WinnabilityClasses = winnabilityClassSchema.enum;
 function winnabilityClassLabel(winnabilityClass) {
   switch (winnabilityClass) {
@@ -3849,40 +4081,40 @@ function deriveWinnabilityClass(citedSurfaceDomains, surfaceClasses, threshold =
     winnability
   };
 }
-var ourBestPageSchema = z25.object({
-  url: z25.string(),
-  gscImpressions: z25.number().nonnegative(),
-  gscClicks: z25.number().nonnegative(),
+var ourBestPageSchema = z26.object({
+  url: z26.string(),
+  gscImpressions: z26.number().nonnegative(),
+  gscClicks: z26.number().nonnegative(),
   // Null when the page came from the inventory fallback (no GSC ranking data).
-  gscAvgPosition: z25.number().nonnegative().nullable(),
-  organicSessions: z25.number().nonnegative()
+  gscAvgPosition: z26.number().nonnegative().nullable(),
+  organicSessions: z26.number().nonnegative()
 });
-var winningCompetitorSchema = z25.object({
-  domain: z25.string(),
-  url: z25.string(),
-  title: z25.string(),
-  citationCount: z25.number().int().nonnegative()
+var winningCompetitorSchema = z26.object({
+  domain: z26.string(),
+  url: z26.string(),
+  title: z26.string(),
+  citationCount: z26.number().int().nonnegative()
 });
-var scoreBreakdownSchema = z25.object({
-  demand: z25.number(),
-  competitor: z25.number(),
-  absence: z25.number(),
-  gapSeverity: z25.number()
+var scoreBreakdownSchema = z26.object({
+  demand: z26.number(),
+  competitor: z26.number(),
+  absence: z26.number(),
+  gapSeverity: z26.number()
 });
-var existingActionRefSchema = z25.object({
-  actionId: z25.string(),
+var existingActionRefSchema = z26.object({
+  actionId: z26.string(),
   state: contentActionStateSchema,
-  lastUpdated: z25.string()
+  lastUpdated: z26.string()
 });
-var contentTargetRowDtoSchema = z25.object({
-  targetRef: z25.string(),
-  query: z25.string(),
+var contentTargetRowDtoSchema = z26.object({
+  targetRef: z26.string(),
+  query: z26.string(),
   action: contentActionSchema,
   ourBestPage: ourBestPageSchema.nullable(),
   winningCompetitor: winningCompetitorSchema.nullable(),
-  score: z25.number(),
+  score: z26.number(),
   scoreBreakdown: scoreBreakdownSchema,
-  drivers: z25.array(z25.string()),
+  drivers: z26.array(z26.string()),
   demandSource: demandSourceSchema,
   actionConfidence: actionConfidenceSchema,
   existingAction: existingActionRefSchema.nullable(),
@@ -3897,134 +4129,134 @@ var contentTargetRowDtoSchema = z25.object({
    * `[0, 1]`. `null` when the gate failed open (no classification coverage for
    * the cited surface) — distinct from a computed `1.0`.
    */
-  winnability: z25.number().min(0).max(1).nullable()
-});
-var contentTargetsResponseDtoSchema = z25.object({
-  targets: z25.array(contentTargetRowDtoSchema),
-  contextMetrics: z25.object({
-    totalAiReferralSessions: z25.number().int().nonnegative(),
-    latestRunId: z25.string(),
-    runTimestamp: z25.string()
+  winnability: z26.number().min(0).max(1).nullable()
+});
+var contentTargetsResponseDtoSchema = z26.object({
+  targets: z26.array(contentTargetRowDtoSchema),
+  contextMetrics: z26.object({
+    totalAiReferralSessions: z26.number().int().nonnegative(),
+    latestRunId: z26.string(),
+    runTimestamp: z26.string()
   })
 });
-var contentTargetDismissalDtoSchema = z25.object({
-  targetRef: z25.string(),
-  addressedUrl: z25.string().nullable(),
-  note: z25.string().nullable(),
-  dismissedAt: z25.string()
+var contentTargetDismissalDtoSchema = z26.object({
+  targetRef: z26.string(),
+  addressedUrl: z26.string().nullable(),
+  note: z26.string().nullable(),
+  dismissedAt: z26.string()
 });
-var contentTargetDismissalsResponseDtoSchema = z25.object({
-  dismissals: z25.array(contentTargetDismissalDtoSchema)
+var contentTargetDismissalsResponseDtoSchema = z26.object({
+  dismissals: z26.array(contentTargetDismissalDtoSchema)
 });
-var contentTargetDismissRequestSchema = z25.object({
-  targetRef: z25.string().min(1),
+var contentTargetDismissRequestSchema = z26.object({
+  targetRef: z26.string().min(1),
   /** URL of the page the user wrote that addresses this recommendation. Stored verbatim for the audit trail; not currently used to suppress the slug-token matcher. */
-  addressedUrl: z25.string().url().optional(),
+  addressedUrl: z26.string().url().optional(),
   /** Free-form note (e.g. "covered in our Q1 content sprint"). 500 char cap is the API surface limit; the DB column is unbounded. */
-  note: z25.string().max(500).optional()
+  note: z26.string().max(500).optional()
 });
-var recommendationExplanationDtoSchema = z25.object({
-  targetRef: z25.string(),
+var recommendationExplanationDtoSchema = z26.object({
+  targetRef: z26.string(),
   /** Version of the prompt template used. Bumping the version invalidates the cache forward without touching the table. */
-  promptVersion: z25.string(),
+  promptVersion: z26.string(),
   /** Provider that produced the explanation (e.g. "claude", "gemini"). */
-  provider: z25.string(),
+  provider: z26.string(),
   /** Model id within that provider (e.g. "claude-sonnet-4-6"). */
-  model: z25.string(),
+  model: z26.string(),
   /** Markdown-formatted rationale + recommended next steps. */
-  responseText: z25.string(),
+  responseText: z26.string(),
   /** Estimated cost in millicents (1/100 of a cent). 0 when unknown. */
-  costMillicents: z25.number().int().nonnegative(),
-  generatedAt: z25.string()
+  costMillicents: z26.number().int().nonnegative(),
+  generatedAt: z26.string()
 });
-var recommendationExplainRequestSchema = z25.object({
+var recommendationExplainRequestSchema = z26.object({
   /**
    * Optional provider override (e.g. "claude" to force Claude even if
    * the project's default is Gemini). Falls through to project default
    * → auto-detect when omitted.
    */
-  provider: z25.string().optional(),
+  provider: z26.string().optional(),
   /**
    * Optional model override within the chosen provider. Falls through to
    * the `analyze`-tier default model when omitted.
    */
-  model: z25.string().optional(),
+  model: z26.string().optional(),
   /**
    * Force a fresh LLM call even if a cached explanation exists for the
    * current prompt version. Use sparingly — defeats the cache.
    */
-  forceRefresh: z25.boolean().optional()
+  forceRefresh: z26.boolean().optional()
 });
-var contentBriefDtoSchema = z25.object({
+var contentBriefDtoSchema = z26.object({
   /** The query the brief is for (echoed from the recommendation). */
-  targetQuery: z25.string().trim().min(1),
+  targetQuery: z26.string().trim().min(1),
   /** Always `ownable` in practice — the gate rejects `ceded` before synthesis. */
   winnabilityClass: winnabilityClassSchema,
   /** The differentiated content angle to take. */
-  angle: z25.string().trim().min(1),
+  angle: z26.string().trim().min(1),
   /** Why this query is winnable, citing the cited-surface signal. */
-  whyWinnable: z25.string().trim().min(1),
+  whyWinnable: z26.string().trim().min(1),
   /** The schema.org type or markup to add or extend. */
-  schemaHookup: z25.string().trim().min(1),
+  schemaHookup: z26.string().trim().min(1),
   /** Why the cited surface is controllable (the ownable-vs-ceded reasoning). */
-  controllableSurfaceRationale: z25.string().trim().min(1)
+  controllableSurfaceRationale: z26.string().trim().min(1)
 });
-var recommendationBriefDtoSchema = z25.object({
-  targetRef: z25.string(),
+var recommendationBriefDtoSchema = z26.object({
+  targetRef: z26.string(),
   /** Version of the brief prompt template; bumping invalidates the cache forward. */
-  promptVersion: z25.string(),
-  provider: z25.string(),
-  model: z25.string(),
+  promptVersion: z26.string(),
+  provider: z26.string(),
+  model: z26.string(),
   brief: contentBriefDtoSchema,
   /** Estimated cost in millicents (1/100 of a cent). 0 when unknown. */
-  costMillicents: z25.number().int().nonnegative(),
-  generatedAt: z25.string()
+  costMillicents: z26.number().int().nonnegative(),
+  generatedAt: z26.string()
 });
-var domainClassificationDtoSchema = z25.object({
-  domain: z25.string(),
+var domainClassificationDtoSchema = z26.object({
+  domain: z26.string(),
   competitorType: discoveryCompetitorTypeSchema,
-  hits: z25.number().int().nonnegative(),
-  updatedAt: z25.string()
+  hits: z26.number().int().nonnegative(),
+  updatedAt: z26.string()
 });
-var domainClassificationsResponseDtoSchema = z25.object({
-  classifications: z25.array(domainClassificationDtoSchema)
-});
-var contentGroundingSourceSchema = z25.object({
-  uri: z25.string(),
-  title: z25.string(),
-  domain: z25.string(),
-  isOurDomain: z25.boolean(),
-  isCompetitor: z25.boolean(),
-  citationCount: z25.number().int().nonnegative(),
-  providers: z25.array(providerNameSchema)
+var domainClassificationsResponseDtoSchema = z26.object({
+  classifications: z26.array(domainClassificationDtoSchema)
 });
-var contentSourceRowDtoSchema = z25.object({
-  query: z25.string(),
-  groundingSources: z25.array(contentGroundingSourceSchema)
-});
-var contentSourcesResponseDtoSchema = z25.object({
-  sources: z25.array(contentSourceRowDtoSchema),
-  latestRunId: z25.string()
-});
-var contentGapRowDtoSchema = z25.object({
-  query: z25.string(),
-  competitorDomains: z25.array(z25.string()),
-  competitorCount: z25.number().int().nonnegative(),
-  missRate: z25.number().min(0).max(1),
-  lastSeenInRunId: z25.string()
-});
-var contentGapsResponseDtoSchema = z25.object({
-  gaps: z25.array(contentGapRowDtoSchema),
-  latestRunId: z25.string()
+var contentGroundingSourceSchema = z26.object({
+  uri: z26.string(),
+  title: z26.string(),
+  domain: z26.string(),
+  isOurDomain: z26.boolean(),
+  isCompetitor: z26.boolean(),
+  citationCount: z26.number().int().nonnegative(),
+  providers: z26.array(providerNameSchema)
+});
+var contentSourceRowDtoSchema = z26.object({
+  query: z26.string(),
+  groundingSources: z26.array(contentGroundingSourceSchema)
+});
+var contentSourcesResponseDtoSchema = z26.object({
+  sources: z26.array(contentSourceRowDtoSchema),
+  latestRunId: z26.string()
+});
+var contentGapRowDtoSchema = z26.object({
+  query: z26.string(),
+  competitorDomains: z26.array(z26.string()),
+  competitorCount: z26.number().int().nonnegative(),
+  missRate: z26.number().min(0).max(1),
+  lastSeenInRunId: z26.string()
+});
+var contentGapsResponseDtoSchema = z26.object({
+  gaps: z26.array(contentGapRowDtoSchema),
+  latestRunId: z26.string()
 });
 
 // ../contracts/src/doctor.ts
-import { z as z26 } from "zod";
-var checkStatusSchema = z26.enum(["ok", "warn", "fail", "skipped"]);
+import { z as z27 } from "zod";
+var checkStatusSchema = z27.enum(["ok", "warn", "fail", "skipped"]);
 var CheckStatuses = checkStatusSchema.enum;
-var checkScopeSchema = z26.enum(["global", "project"]);
+var checkScopeSchema = z27.enum(["global", "project"]);
 var CheckScopes = checkScopeSchema.enum;
-var checkCategorySchema = z26.enum([
+var checkCategorySchema = z27.enum([
   "auth",
   "config",
   "providers",
@@ -4035,31 +4267,31 @@ var checkCategorySchema = z26.enum([
   "agent"
 ]);
 var CheckCategories = checkCategorySchema.enum;
-var checkResultSchema = z26.object({
-  id: z26.string(),
+var checkResultSchema = z27.object({
+  id: z27.string(),
   category: checkCategorySchema,
   scope: checkScopeSchema,
-  title: z26.string(),
+  title: z27.string(),
   status: checkStatusSchema,
-  code: z26.string().describe('Stable machine-readable code (e.g. "google.token.refresh-failed"). Use this for filtering and remediation logic.'),
-  summary: z26.string(),
-  remediation: z26.string().nullable().optional().describe('Operator-facing next step. Null when status is "ok" or no specific remediation applies.'),
-  details: z26.record(z26.string(), z26.unknown()).optional().describe("Structured context \u2014 principal email, redirect URI, missing scopes, etc. Stable per check id."),
-  durationMs: z26.number().int().nonnegative().describe("How long the check took to execute.")
+  code: z27.string().describe('Stable machine-readable code (e.g. "google.token.refresh-failed"). Use this for filtering and remediation logic.'),
+  summary: z27.string(),
+  remediation: z27.string().nullable().optional().describe('Operator-facing next step. Null when status is "ok" or no specific remediation applies.'),
+  details: z27.record(z27.string(), z27.unknown()).optional().describe("Structured context \u2014 principal email, redirect URI, missing scopes, etc. Stable per check id."),
+  durationMs: z27.number().int().nonnegative().describe("How long the check took to execute.")
 });
-var doctorReportSchema = z26.object({
+var doctorReportSchema = z27.object({
   scope: checkScopeSchema,
-  project: z26.string().nullable().describe('Project name when scope is "project", null otherwise.'),
-  generatedAt: z26.string().describe("ISO-8601 timestamp when this doctor run started."),
-  durationMs: z26.number().int().nonnegative(),
-  summary: z26.object({
-    total: z26.number().int().nonnegative(),
-    ok: z26.number().int().nonnegative(),
-    warn: z26.number().int().nonnegative(),
-    fail: z26.number().int().nonnegative(),
-    skipped: z26.number().int().nonnegative()
+  project: z27.string().nullable().describe('Project name when scope is "project", null otherwise.'),
+  generatedAt: z27.string().describe("ISO-8601 timestamp when this doctor run started."),
+  durationMs: z27.number().int().nonnegative(),
+  summary: z27.object({
+    total: z27.number().int().nonnegative(),
+    ok: z27.number().int().nonnegative(),
+    warn: z27.number().int().nonnegative(),
+    fail: z27.number().int().nonnegative(),
+    skipped: z27.number().int().nonnegative()
   }),
-  checks: z26.array(checkResultSchema)
+  checks: z27.array(checkResultSchema)
 });
 function summarizeCheckResults(results) {
   const summary = { total: results.length, ok: 0, warn: 0, fail: 0, skipped: 0 };
@@ -4088,52 +4320,52 @@ function normalizeQueryText(value) {
 }
 
 // ../contracts/src/citations.ts
-import { z as z27 } from "zod";
-var citationCoverageProviderSchema = z27.object({
-  provider: z27.string(),
+import { z as z28 } from "zod";
+var citationCoverageProviderSchema = z28.object({
+  provider: z28.string(),
   citationState: citationStateSchema,
-  cited: z27.boolean(),
-  mentioned: z27.boolean(),
-  runId: z27.string(),
-  runCreatedAt: z27.string()
-});
-var citationCoverageRowSchema = z27.object({
-  queryId: z27.string(),
-  query: z27.string(),
-  providers: z27.array(citationCoverageProviderSchema),
-  citedCount: z27.number().int().nonnegative(),
-  mentionedCount: z27.number().int().nonnegative(),
-  totalProviders: z27.number().int().nonnegative()
-});
-var competitorGapRowSchema = z27.object({
-  queryId: z27.string(),
-  query: z27.string(),
-  provider: z27.string(),
-  citingCompetitors: z27.array(z27.string()),
-  runId: z27.string(),
-  runCreatedAt: z27.string()
-});
-var citationVisibilitySummarySchema = z27.object({
-  providersConfigured: z27.number().int().nonnegative(),
-  providersCiting: z27.number().int().nonnegative(),
-  providersMentioning: z27.number().int().nonnegative(),
-  totalQueries: z27.number().int().nonnegative(),
+  cited: z28.boolean(),
+  mentioned: z28.boolean(),
+  runId: z28.string(),
+  runCreatedAt: z28.string()
+});
+var citationCoverageRowSchema = z28.object({
+  queryId: z28.string(),
+  query: z28.string(),
+  providers: z28.array(citationCoverageProviderSchema),
+  citedCount: z28.number().int().nonnegative(),
+  mentionedCount: z28.number().int().nonnegative(),
+  totalProviders: z28.number().int().nonnegative()
+});
+var competitorGapRowSchema = z28.object({
+  queryId: z28.string(),
+  query: z28.string(),
+  provider: z28.string(),
+  citingCompetitors: z28.array(z28.string()),
+  runId: z28.string(),
+  runCreatedAt: z28.string()
+});
+var citationVisibilitySummarySchema = z28.object({
+  providersConfigured: z28.number().int().nonnegative(),
+  providersCiting: z28.number().int().nonnegative(),
+  providersMentioning: z28.number().int().nonnegative(),
+  totalQueries: z28.number().int().nonnegative(),
   // Cross-tab buckets — each tracked query with at least one snapshot lands
   // in exactly one of these. Queries with zero snapshots are not counted in
   // any bucket; (sum of buckets) ≤ totalQueries.
-  queriesCitedAndMentioned: z27.number().int().nonnegative(),
-  queriesCitedOnly: z27.number().int().nonnegative(),
-  queriesMentionedOnly: z27.number().int().nonnegative(),
-  queriesInvisible: z27.number().int().nonnegative(),
-  latestRunId: z27.string().nullable(),
-  latestRunAt: z27.string().nullable()
-});
-var citationVisibilityResponseSchema = z27.object({
+  queriesCitedAndMentioned: z28.number().int().nonnegative(),
+  queriesCitedOnly: z28.number().int().nonnegative(),
+  queriesMentionedOnly: z28.number().int().nonnegative(),
+  queriesInvisible: z28.number().int().nonnegative(),
+  latestRunId: z28.string().nullable(),
+  latestRunAt: z28.string().nullable()
+});
+var citationVisibilityResponseSchema = z28.object({
   summary: citationVisibilitySummarySchema,
-  byQuery: z27.array(citationCoverageRowSchema),
-  competitorGaps: z27.array(competitorGapRowSchema),
-  status: z27.enum(["ready", "no-data"]),
-  reason: z27.enum(["no-runs-yet", "no-queries"]).optional()
+  byQuery: z28.array(citationCoverageRowSchema),
+  competitorGaps: z28.array(competitorGapRowSchema),
+  status: z28.enum(["ready", "no-data"]),
+  reason: z28.enum(["no-runs-yet", "no-queries"]).optional()
 });
 function emptyCitationVisibility(reason) {
   return {
@@ -4160,10 +4392,10 @@ function citationStateToCited(state) {
 }
 
 // ../contracts/src/report.ts
-import { z as z28 } from "zod";
+import { z as z29 } from "zod";
 var REPORT_PERIOD_OPTIONS = [7, 14, 30, 90];
 var REPORT_DEFAULT_PERIOD_DAYS = 30;
-var reportPeriodSchema = z28.union([z28.literal(7), z28.literal(14), z28.literal(30), z28.literal(90)]).describe("Report window in days (7, 14, 30, or 90). Defaults to 30 when omitted.");
+var reportPeriodSchema = z29.union([z29.literal(7), z29.literal(14), z29.literal(30), z29.literal(90)]).describe("Report window in days (7, 14, 30, or 90). Defaults to 30 when omitted.");
 function isReportPeriodDays(n) {
   return REPORT_PERIOD_OPTIONS.includes(n);
 }
@@ -4178,45 +4410,45 @@ function parseReportPeriodDays(value) {
 function reportComparisonWindowDays(periodDays) {
   return Math.max(1, Math.floor(periodDays / 2));
 }
-var providerLocationTreatmentSchema = z28.enum([
+var providerLocationTreatmentSchema = z29.enum([
   "prompt",
   "request-param",
   "browser-geo",
   "ignored"
 ]);
-var reportMetaLocationSchema = z28.object({
+var reportMetaLocationSchema = z29.object({
   /** Human-readable label as configured on the project (e.g. "michigan"). */
-  label: z28.string(),
+  label: z29.string(),
   /** Resolved city/region/country from the project's `LocationContext`. */
-  city: z28.string(),
-  region: z28.string(),
-  country: z28.string(),
+  city: z29.string(),
+  region: z29.string(),
+  country: z29.string(),
   /**
    * Other locations configured on the project that did NOT power this report.
    * When non-empty, callers should make clear that the report is location-scoped:
    * a separate sweep is needed to see how AI engines respond from each one.
    */
-  otherConfiguredLabels: z28.array(z28.string())
+  otherConfiguredLabels: z29.array(z29.string())
 });
-var reportProviderLocationHandlingSchema = z28.object({
+var reportProviderLocationHandlingSchema = z29.object({
   /** Provider name (matches `query_snapshots.provider`). */
-  provider: z28.string(),
+  provider: z29.string(),
   /** How this provider applied the configured location during this run. */
   treatment: providerLocationTreatmentSchema,
   /** One-sentence explanation suitable for the report. */
-  description: z28.string()
+  description: z29.string()
 });
-var reportMetaSchema = z28.object({
+var reportMetaSchema = z29.object({
   /** ISO timestamp the report was generated (server clock). */
-  generatedAt: z28.string(),
+  generatedAt: z29.string(),
   /** Project the report covers. */
-  project: z28.object({
-    id: z28.string(),
-    name: z28.string(),
-    displayName: z28.string(),
-    canonicalDomain: z28.string(),
-    country: z28.string(),
-    language: z28.string()
+  project: z29.object({
+    id: z29.string(),
+    name: z29.string(),
+    displayName: z29.string(),
+    canonicalDomain: z29.string(),
+    country: z29.string(),
+    language: z29.string()
   }),
   /**
    * The location that powered the latest visibility run, when one was set.
@@ -4231,31 +4463,31 @@ var reportMetaSchema = z28.object({
    * each provider's answer — some providers append it to the prompt, some
    * pass it as a structured request field, and some (CDP) ignore it.
    */
-  providerLocationHandling: z28.array(reportProviderLocationHandlingSchema),
+  providerLocationHandling: z29.array(reportProviderLocationHandlingSchema),
   /** Earliest data point referenced by the report (ISO date). */
-  periodStart: z28.string().nullable(),
+  periodStart: z29.string().nullable(),
   /** Latest data point referenced by the report (ISO date). */
-  periodEnd: z28.string().nullable(),
+  periodEnd: z29.string().nullable(),
   /**
    * The selected report window, in days (one of `REPORT_PERIOD_OPTIONS`).
    * Every time-windowed section scopes to this many days; renderers read it to
    * label the window ("Last 30 days", "(30d)"). Defaults to
    * `REPORT_DEFAULT_PERIOD_DAYS` when no `period` is requested.
    */
-  periodDays: z28.number().int().positive()
+  periodDays: z29.number().int().positive()
 });
-var reportExecutiveSummarySchema = z28.object({
+var reportExecutiveSummarySchema = z29.object({
   /**
    * 0..100 — share of tracked queries that were cited by at least one
    * provider in the latest run. "Cited" means the project's domain appeared
    * in the source list / grounding the AI used to answer. Computed per-query
    * (not per-(query × provider)) so the rate is invariant to provider count.
    */
-  citationRate: z28.number(),
+  citationRate: z29.number(),
   /** Numerator of `citationRate` — distinct tracked queries cited by ≥1 provider in the latest run. */
-  citedQueryCount: z28.number(),
+  citedQueryCount: z29.number(),
   /** Denominator of `citationRate` — total tracked queries. */
-  totalQueryCount: z28.number(),
+  totalQueryCount: z29.number(),
   /**
    * 0..100 — share of tracked queries where the project's brand or domain
    * appeared in at least one provider's answer text in the latest run.
@@ -4263,71 +4495,71 @@ var reportExecutiveSummarySchema = z28.object({
    * the prose without citing your domain in its sources, and vice versa.
    * Same per-query denominator as `citationRate` for consistency.
    */
-  mentionRate: z28.number(),
+  mentionRate: z29.number(),
   /** Numerator of `mentionRate` — distinct tracked queries mentioned in ≥1 provider's answer text. */
-  mentionedQueryCount: z28.number(),
+  mentionedQueryCount: z29.number(),
   /** Compared to the previous run: 'up' | 'down' | 'flat' | 'unknown' (no prior run). */
-  trend: z28.enum(["up", "down", "flat", "unknown"]),
+  trend: z29.enum(["up", "down", "flat", "unknown"]),
   /** Total tracked queries. */
-  queryCount: z28.number(),
+  queryCount: z29.number(),
   /** Total tracked competitors. */
-  competitorCount: z28.number(),
+  competitorCount: z29.number(),
   /** Number of providers in the latest run. */
-  providerCount: z28.number(),
+  providerCount: z29.number(),
   /** GSC totals across the most-recent sync window. Null when GSC is not connected. */
-  gsc: z28.object({
-    clicks: z28.number(),
-    impressions: z28.number(),
-    ctr: z28.number(),
-    avgPosition: z28.number(),
-    periodStart: z28.string(),
-    periodEnd: z28.string()
+  gsc: z29.object({
+    clicks: z29.number(),
+    impressions: z29.number(),
+    ctr: z29.number(),
+    avgPosition: z29.number(),
+    periodStart: z29.string(),
+    periodEnd: z29.string()
   }).nullable(),
   /** GA4 totals across the most-recent sync period. Null when GA4 is not connected. */
-  ga: z28.object({
-    sessions: z28.number(),
-    users: z28.number(),
-    periodStart: z28.string(),
-    periodEnd: z28.string()
+  ga: z29.object({
+    sessions: z29.number(),
+    users: z29.number(),
+    periodStart: z29.string(),
+    periodEnd: z29.string()
   }).nullable(),
   /** Top 3-5 findings, each rendered as a single-sentence narrative. */
-  findings: z28.array(z28.object({
-    title: z28.string(),
-    detail: z28.string(),
-    tone: z28.enum(["positive", "caution", "negative", "neutral"])
+  findings: z29.array(z29.object({
+    title: z29.string(),
+    detail: z29.string(),
+    tone: z29.enum(["positive", "caution", "negative", "neutral"])
   }))
 });
-var citationCellSchema = z28.object({
-  citationState: z28.enum(["cited", "not-cited", "pending"]),
-  answerMentioned: z28.boolean().nullable(),
-  model: z28.string().nullable()
+var citationCellSchema = z29.object({
+  citationState: z29.enum(["cited", "not-cited", "pending"]),
+  answerMentioned: z29.boolean().nullable(),
+  model: z29.string().nullable()
 });
-var citationScorecardSchema = z28.object({
-  queries: z28.array(z28.string()),
-  providers: z28.array(z28.string()),
+var citationScorecardSchema = z29.object({
+  queries: z29.array(z29.string()),
+  providers: z29.array(z29.string()),
   /** matrix[queryIndex][providerIndex] — null when no snapshot exists for the pair. */
-  matrix: z28.array(z28.array(citationCellSchema.nullable())),
+  matrix: z29.array(z29.array(citationCellSchema.nullable())),
   /** Per-provider citation + mention rates (0..100). */
-  providerRates: z28.array(z28.object({
-    provider: z28.string(),
-    citedCount: z28.number(),
+  providerRates: z29.array(z29.object({
+    provider: z29.string(),
+    citedCount: z29.number(),
     /** Number of snapshots for this provider where the answer text mentioned the project. */
-    mentionedCount: z28.number(),
-    totalCount: z28.number(),
-    citationRate: z28.number(),
-    mentionRate: z28.number()
+    mentionedCount: z29.number(),
+    totalCount: z29.number(),
+    citationRate: z29.number(),
+    mentionRate: z29.number()
   }))
 });
-var competitorRowSchema = z28.object({
-  domain: z28.string(),
+var competitorRowSchema = z29.object({
+  domain: z29.string(),
   /** Number of (query × provider) pairs that cited this competitor. */
-  citationCount: z28.number(),
+  citationCount: z29.number(),
   /** Out-of count for the same denominator. */
-  totalCount: z28.number(),
+  totalCount: z29.number(),
   /** 'High' | 'Moderate' | 'Low' | 'None' — from buildPortfolioProject pressure logic. */
-  pressureLabel: z28.enum(["High", "Moderate", "Low", "None"]),
+  pressureLabel: z29.enum(["High", "Moderate", "Low", "None"]),
   /** Distinct queries on which this competitor was cited. */
-  citedQueries: z28.array(z28.string()),
+  citedQueries: z29.array(z29.string()),
   /**
    * Citation share 0..100. Numerator = this competitor's `citationCount`.
    * Denominator = sum of `citationCount` across all competitors plus the
@@ -4335,30 +4567,30 @@ var competitorRowSchema = z28.object({
    * slots in the snapshot. Distinct from the project-level Mention Share
    * gauge — that one is brand-in-answer-text, this one is domain-in-source-list.
    */
-  sharePct: z28.number(),
+  sharePct: z29.number(),
   /**
    * URLs from the latest run's grounding sources whose host matches this
    * competitor's domain, with the queries each URL was cited for. Empty
    * when no grounding-source data is available (e.g. no `rawResponse` JSON
    * stored for the snapshots).
    */
-  theirCitedPages: z28.array(z28.object({ url: z28.string(), citedFor: z28.array(z28.string()) }))
+  theirCitedPages: z29.array(z29.object({ url: z29.string(), citedFor: z29.array(z29.string()) }))
 });
-var competitorLandscapeSchema = z28.object({
+var competitorLandscapeSchema = z29.object({
   /** Project's own citation count (for the bar chart comparing project vs competitors). */
-  projectCitationCount: z28.number(),
-  competitors: z28.array(competitorRowSchema)
+  projectCitationCount: z29.number(),
+  competitors: z29.array(competitorRowSchema)
 });
-var mentionRowSchema = z28.object({
-  domain: z28.string(),
+var mentionRowSchema = z29.object({
+  domain: z29.string(),
   /** Number of (query × provider) pairs whose answer text mentioned this competitor's brand or domain. */
-  mentionCount: z28.number(),
+  mentionCount: z29.number(),
   /** Out-of count for the same denominator (snapshots that had answer text). */
-  totalCount: z28.number(),
+  totalCount: z29.number(),
   /** 'High' | 'Moderate' | 'Low' | 'None' — mention frequency tier (mirrors CompetitorRow.pressureLabel). */
-  pressureLabel: z28.enum(["High", "Moderate", "Low", "None"]),
+  pressureLabel: z29.enum(["High", "Moderate", "Low", "None"]),
   /** Distinct queries on which this competitor was mentioned. */
-  mentionedQueries: z28.array(z28.string()),
+  mentionedQueries: z29.array(z29.string()),
   /**
    * Mention share 0..100. Numerator = this competitor's `mentionCount`.
    * Denominator = sum of `mentionCount` across all competitors plus the
@@ -4366,135 +4598,135 @@ var mentionRowSchema = z28.object({
    * mention. Per-competitor split of the same head-to-head measure the
    * project's hero `MentionShareDto` gauge headlines.
    */
-  sharePct: z28.number()
+  sharePct: z29.number()
 });
-var mentionLandscapeSchema = z28.object({
+var mentionLandscapeSchema = z29.object({
   /** Project's own mention count (for the bar chart comparing project vs competitors). */
-  projectMentionCount: z28.number(),
+  projectMentionCount: z29.number(),
   /** Snapshots considered — those with non-empty answerText. Drives the totalCount denominator. */
-  totalAnswerSnapshots: z28.number(),
-  competitors: z28.array(mentionRowSchema)
+  totalAnswerSnapshots: z29.number(),
+  competitors: z29.array(mentionRowSchema)
 });
-var aiSourceCategoryBucketSchema = z28.object({
+var aiSourceCategoryBucketSchema = z29.object({
   /** Category slug from packages/contracts/src/source-categories. */
-  category: z28.string(),
+  category: z29.string(),
   /** Display label. */
-  label: z28.string(),
+  label: z29.string(),
   /** Number of citations falling in this category. */
-  count: z28.number(),
+  count: z29.number(),
   /** 0..100 share of total citations. */
-  sharePct: z28.number()
+  sharePct: z29.number()
 });
-var aiSourceOriginSchema = z28.object({
-  categories: z28.array(aiSourceCategoryBucketSchema),
+var aiSourceOriginSchema = z29.object({
+  categories: z29.array(aiSourceCategoryBucketSchema),
   /** Top 20 source domains by citation count (excluding the project's own domain). */
-  topDomains: z28.array(z28.object({
-    domain: z28.string(),
-    count: z28.number(),
+  topDomains: z29.array(z29.object({
+    domain: z29.string(),
+    count: z29.number(),
     /** True when the domain is one of the project's tracked competitors. */
-    isCompetitor: z28.boolean()
+    isCompetitor: z29.boolean()
   }))
 });
-var gscQueryRowSchema = z28.object({
-  query: z28.string(),
-  clicks: z28.number(),
-  impressions: z28.number(),
-  ctr: z28.number(),
-  avgPosition: z28.number(),
+var gscQueryRowSchema = z29.object({
+  query: z29.string(),
+  clicks: z29.number(),
+  impressions: z29.number(),
+  ctr: z29.number(),
+  avgPosition: z29.number(),
   /** Heuristic categorization: 'brand' | 'lead-gen' | 'industry' | 'other'. */
-  category: z28.enum(["brand", "lead-gen", "industry", "other"])
-});
-var gscSectionSchema = z28.object({
-  periodStart: z28.string(),
-  periodEnd: z28.string(),
-  totalClicks: z28.number(),
-  totalImpressions: z28.number(),
-  ctr: z28.number(),
-  avgPosition: z28.number(),
-  topQueries: z28.array(gscQueryRowSchema),
-  categoryBreakdown: z28.array(z28.object({
-    category: z28.enum(["brand", "lead-gen", "industry", "other"]),
-    clicks: z28.number(),
-    impressions: z28.number(),
-    sharePct: z28.number()
+  category: z29.enum(["brand", "lead-gen", "industry", "other"])
+});
+var gscSectionSchema = z29.object({
+  periodStart: z29.string(),
+  periodEnd: z29.string(),
+  totalClicks: z29.number(),
+  totalImpressions: z29.number(),
+  ctr: z29.number(),
+  avgPosition: z29.number(),
+  topQueries: z29.array(gscQueryRowSchema),
+  categoryBreakdown: z29.array(z29.object({
+    category: z29.enum(["brand", "lead-gen", "industry", "other"]),
+    clicks: z29.number(),
+    impressions: z29.number(),
+    sharePct: z29.number()
   })),
-  trend: z28.array(z28.object({ date: z28.string(), clicks: z28.number(), impressions: z28.number() })),
+  trend: z29.array(z29.object({ date: z29.string(), clicks: z29.number(), impressions: z29.number() })),
   /**
    * Tracked AEO queries that have no GSC impressions in the report window.
    * Surfaces queries that may not represent real search demand.
    */
-  trackedButNoGsc: z28.array(z28.string()),
+  trackedButNoGsc: z29.array(z29.string()),
   /**
    * GSC top queries (sorted by impressions desc) that are not tracked as
    * AEO queries — the candidate set for adding to the AEO project.
    */
-  gscButNotTracked: z28.array(z28.string())
-});
-var gaTrafficSectionSchema = z28.object({
-  totalSessions: z28.number(),
-  totalUsers: z28.number(),
-  totalOrganicSessions: z28.number(),
-  periodStart: z28.string(),
-  periodEnd: z28.string(),
-  topLandingPages: z28.array(z28.object({
-    page: z28.string(),
-    sessions: z28.number(),
-    users: z28.number(),
-    organicSessions: z28.number()
+  gscButNotTracked: z29.array(z29.string())
+});
+var gaTrafficSectionSchema = z29.object({
+  totalSessions: z29.number(),
+  totalUsers: z29.number(),
+  totalOrganicSessions: z29.number(),
+  periodStart: z29.string(),
+  periodEnd: z29.string(),
+  topLandingPages: z29.array(z29.object({
+    page: z29.string(),
+    sessions: z29.number(),
+    users: z29.number(),
+    organicSessions: z29.number()
   })),
-  channelBreakdown: z28.array(z28.object({
-    channel: z28.string(),
-    sessions: z28.number(),
-    sharePct: z28.number()
+  channelBreakdown: z29.array(z29.object({
+    channel: z29.string(),
+    sessions: z29.number(),
+    sharePct: z29.number()
   }))
 });
-var socialReferralSectionSchema = z28.object({
-  totalSessions: z28.number(),
-  organicSessions: z28.number(),
-  paidSessions: z28.number(),
-  channels: z28.array(z28.object({
-    channelGroup: z28.string(),
-    sessions: z28.number(),
-    sharePct: z28.number()
+var socialReferralSectionSchema = z29.object({
+  totalSessions: z29.number(),
+  organicSessions: z29.number(),
+  paidSessions: z29.number(),
+  channels: z29.array(z29.object({
+    channelGroup: z29.string(),
+    sessions: z29.number(),
+    sharePct: z29.number()
   })),
-  topCampaigns: z28.array(z28.object({
-    source: z28.string(),
-    medium: z28.string(),
-    sessions: z28.number()
+  topCampaigns: z29.array(z29.object({
+    source: z29.string(),
+    medium: z29.string(),
+    sessions: z29.number()
   }))
 });
-var aiReferralSectionSchema = z28.object({
-  totalSessions: z28.number(),
-  totalUsers: z28.number(),
-  paidSessions: z28.number(),
-  paidUsers: z28.number(),
-  organicSessions: z28.number(),
-  organicUsers: z28.number(),
-  bySource: z28.array(z28.object({
-    source: z28.string(),
-    sessions: z28.number(),
-    users: z28.number(),
-    paidSessions: z28.number(),
-    organicSessions: z28.number(),
-    sharePct: z28.number()
+var aiReferralSectionSchema = z29.object({
+  totalSessions: z29.number(),
+  totalUsers: z29.number(),
+  paidSessions: z29.number(),
+  paidUsers: z29.number(),
+  organicSessions: z29.number(),
+  organicUsers: z29.number(),
+  bySource: z29.array(z29.object({
+    source: z29.string(),
+    sessions: z29.number(),
+    users: z29.number(),
+    paidSessions: z29.number(),
+    organicSessions: z29.number(),
+    sharePct: z29.number()
   })),
-  trend: z28.array(z28.object({ date: z28.string(), sessions: z28.number() })),
-  topLandingPages: z28.array(z28.object({
-    page: z28.string(),
-    sessions: z28.number(),
-    users: z28.number()
+  trend: z29.array(z29.object({ date: z29.string(), sessions: z29.number() })),
+  topLandingPages: z29.array(z29.object({
+    page: z29.string(),
+    sessions: z29.number(),
+    users: z29.number()
   }))
 });
-var serverActivitySectionSchema = z28.object({
+var serverActivitySectionSchema = z29.object({
   /** ISO8601 inclusive lower bound of the report window (default: 7 days). */
-  windowStart: z28.string(),
+  windowStart: z29.string(),
   /** ISO8601 inclusive upper bound. */
-  windowEnd: z28.string(),
-  hasData: z28.boolean(),
+  windowEnd: z29.string(),
+  hasData: z29.boolean(),
   /** Last-7d total verified crawler hits, with prior 7d for delta. */
-  verifiedCrawlerHits: z28.object({ current: z28.number(), prior: z28.number(), deltaPct: z28.number().nullable() }),
+  verifiedCrawlerHits: z29.object({ current: z29.number(), prior: z29.number(), deltaPct: z29.number().nullable() }),
   /** Last-7d total unverified crawler hits, separated from verified trust metrics. */
-  unverifiedCrawlerHits: z28.object({ current: z28.number(), prior: z28.number(), deltaPct: z28.number().nullable() }),
+  unverifiedCrawlerHits: z29.object({ current: z29.number(), prior: z29.number(), deltaPct: z29.number().nullable() }),
   /**
    * Last-7d on-demand per-user fetches from AI surfaces (ChatGPT-User,
    * Perplexity-User, MistralAI-User). Disjoint from `verifiedCrawlerHits` /
@@ -4503,19 +4735,34 @@ var serverActivitySectionSchema = z28.object({
    * because the operational question for user-fetch is "is this happening?"
    * not "is this a confirmed bot identity?"
    */
-  aiUserFetchHits: z28.object({ current: z28.number(), prior: z28.number(), deltaPct: z28.number().nullable() }),
-  /** Last-7d AI-referral sessions (sessionized from server-side request evidence). */
-  referralArrivals: z28.object({ current: z28.number(), prior: z28.number(), deltaPct: z28.number().nullable() }),
+  aiUserFetchHits: z29.object({ current: z29.number(), prior: z29.number(), deltaPct: z29.number().nullable() }),
+  /** Last-7d AI-referral sessions (sessionized from server-side request evidence). Paid + organic + unclassified. */
+  referralArrivals: z29.object({ current: z29.number(), prior: z29.number(), deltaPct: z29.number().nullable() }),
+  /**
+   * `referralArrivals` split by traffic class. The three buckets sum to it.
+   *
+   * `unclassified` counts sessions ingested before the classifier shipped: the
+   * UTM tags that carry paid-ness were never persisted, so those sessions can
+   * never be resolved. Reporting them as organic would overstate earned AI
+   * traffic by exactly a client's ad volume.
+   */
+  referralArrivalsByClass: z29.object({
+    paid: z29.object({ current: z29.number(), prior: z29.number(), deltaPct: z29.number().nullable() }),
+    organic: z29.object({ current: z29.number(), prior: z29.number(), deltaPct: z29.number().nullable() }),
+    unclassified: z29.object({ current: z29.number(), prior: z29.number(), deltaPct: z29.number().nullable() })
+  }),
+  /** Pre-rendered one-line breakdown, e.g. "Paid 1,200 · Organic 24". Empty when there is nothing to split. */
+  referralArrivalsClassSummary: z29.string(),
   /** Per-AI-operator breakdown (OpenAI, Anthropic, Google AI, Perplexity, …). */
-  byOperator: z28.array(z28.object({
-    operator: z28.string(),
-    verifiedHits: z28.number(),
+  byOperator: z29.array(z29.object({
+    operator: z29.string(),
+    verifiedHits: z29.number(),
     /** Shown to agency audience only: claimed-bot UA, source IP not in a published range. */
-    unverifiedHits: z28.number(),
+    unverifiedHits: z29.number(),
     /** Per-user fetches from this operator's AI surface (ChatGPT-User, …). */
-    userFetchHits: z28.number(),
-    referralArrivals: z28.number(),
-    deltaPct: z28.number().nullable()
+    userFetchHits: z29.number(),
+    referralArrivals: z29.number(),
+    deltaPct: z29.number().nullable()
   })),
   /**
    * Top crawled paths (verified only, last-7d). Path-level citation cross-reference
@@ -4525,88 +4772,88 @@ var serverActivitySectionSchema = z28.object({
    * citation evidence can extend this entry with a `citationState` field without
    * breaking the contract.
    */
-  topCrawledPaths: z28.array(z28.object({
-    path: z28.string(),
-    verifiedHits: z28.number(),
+  topCrawledPaths: z29.array(z29.object({
+    path: z29.string(),
+    verifiedHits: z29.number(),
     /** How many distinct AI operators crawled this path in the window. */
-    distinctOperators: z28.number()
+    distinctOperators: z29.number()
   })),
   /** AI products that sent ≥1 session in the window (referral by destination). */
-  referralProducts: z28.array(z28.object({
-    product: z28.string(),
-    arrivals: z28.number(),
-    distinctLandingPaths: z28.number()
+  referralProducts: z29.array(z29.object({
+    product: z29.string(),
+    arrivals: z29.number(),
+    distinctLandingPaths: z29.number()
   })),
   /** Daily trend, last 14d for sparkline / chart rendering. */
-  dailyTrend: z28.array(z28.object({
-    date: z28.string(),
-    verifiedCrawlerHits: z28.number(),
-    userFetchHits: z28.number(),
-    referralArrivals: z28.number()
+  dailyTrend: z29.array(z29.object({
+    date: z29.string(),
+    verifiedCrawlerHits: z29.number(),
+    userFetchHits: z29.number(),
+    referralArrivals: z29.number()
   })),
   /**
    * Top landing paths for AI-referral sessions (last-7d).
    * Complements `topCrawledPaths` (what bots fetch) with what humans actually land on.
    */
-  topReferralLandingPaths: z28.array(z28.object({
-    path: z28.string(),
-    arrivals: z28.number(),
-    distinctProducts: z28.number()
+  topReferralLandingPaths: z29.array(z29.object({
+    path: z29.string(),
+    arrivals: z29.number(),
+    distinctProducts: z29.number()
   }))
 });
-var indexingHealthSectionSchema = z28.object({
+var indexingHealthSectionSchema = z29.object({
   /** Source: 'google' | 'bing' | null when neither is connected. */
-  provider: z28.enum(["google", "bing"]).nullable(),
-  total: z28.number(),
-  indexed: z28.number(),
-  notIndexed: z28.number(),
+  provider: z29.enum(["google", "bing"]).nullable(),
+  total: z29.number(),
+  indexed: z29.number(),
+  notIndexed: z29.number(),
   /** Google-only — pages explicitly marked as deindexed. Bing reports 'unknown' instead. */
-  deindexed: z28.number(),
+  deindexed: z29.number(),
   /** Bing-only — pages with no inspection data yet. */
-  unknown: z28.number(),
+  unknown: z29.number(),
   /** 0..100. */
-  indexedPct: z28.number()
+  indexedPct: z29.number()
 });
-var citationsTrendPointSchema = z28.object({
+var citationsTrendPointSchema = z29.object({
   /** Run ID — anchor for cross-section linking. */
-  runId: z28.string(),
+  runId: z29.string(),
   /** ISO timestamp when the run finished (or createdAt fallback). */
-  date: z28.string(),
+  date: z29.string(),
   /**
    * 0..100 — same per-query unique-cited definition as
    * `ReportExecutiveSummary.citationRate`. Stable across runs with different
    * provider counts so the trend line measures real movement rather than
    * provider-count variance.
    */
-  citationRate: z28.number(),
+  citationRate: z29.number(),
   /** Numerator of `citationRate` for this run. */
-  citedQueryCount: z28.number(),
+  citedQueryCount: z29.number(),
   /** Denominator of `citationRate` for this run. */
-  totalQueryCount: z28.number(),
+  totalQueryCount: z29.number(),
   /** 0..100 — same per-query unique-mentioned definition as `ReportExecutiveSummary.mentionRate`. */
-  mentionRate: z28.number(),
+  mentionRate: z29.number(),
   /** Numerator of `mentionRate` for this run. */
-  mentionedQueryCount: z28.number(),
+  mentionedQueryCount: z29.number(),
   /**
    * Per-provider rates for the same run. Each provider's rate is per-pair
    * within that provider (`cited / scanned`), so it remains comparable
    * between providers in the same run.
    */
-  providerRates: z28.array(z28.object({
-    provider: z28.string(),
-    citationRate: z28.number(),
-    mentionRate: z28.number()
+  providerRates: z29.array(z29.object({
+    provider: z29.string(),
+    citationRate: z29.number(),
+    mentionRate: z29.number()
   }))
 });
-var reportInsightSchema = z28.object({
-  id: z28.string(),
-  type: z28.enum(["regression", "gain", "opportunity"]),
-  severity: z28.enum(["critical", "high", "medium", "low"]),
-  title: z28.string(),
-  query: z28.string(),
-  provider: z28.string(),
-  recommendation: z28.string().nullable(),
-  createdAt: z28.string(),
+var reportInsightSchema = z29.object({
+  id: z29.string(),
+  type: z29.enum(["regression", "gain", "opportunity"]),
+  severity: z29.enum(["critical", "high", "medium", "low"]),
+  title: z29.string(),
+  query: z29.string(),
+  provider: z29.string(),
+  recommendation: z29.string().nullable(),
+  createdAt: z29.string(),
   /**
    * How many times this insight fired across recent runs for the same
    * `(query, provider, type)` tuple. Always ≥ 1. Insights returned by the
@@ -4614,64 +4861,64 @@ var reportInsightSchema = z28.object({
    * surfacing the multiplicity. Use it directly instead of grouping again
    * client-side — counts derived from raw insight rows will overcount.
    */
-  instanceCount: z28.number()
+  instanceCount: z29.number()
 });
-var recommendedNextStepSchema = z28.object({
+var recommendedNextStepSchema = z29.object({
   /** 'immediate' | 'short-term' | 'medium-term' — bucketed by severity heuristic. */
-  horizon: z28.enum(["immediate", "short-term", "medium-term"]),
-  title: z28.string(),
-  rationale: z28.string()
+  horizon: z29.enum(["immediate", "short-term", "medium-term"]),
+  title: z29.string(),
+  rationale: z29.string()
 });
-var reportRateDeltaSchema = z28.object({
+var reportRateDeltaSchema = z29.object({
   /** Current value (0..100 for rates, raw count otherwise). When `window`
    *  is present this is the average over the last `window` checks. */
-  current: z28.number(),
+  current: z29.number(),
   /** Prior value compared against. When `window` is present this is the
    *  average over the prior `window` checks before that. */
-  prior: z28.number(),
+  prior: z29.number(),
   /** Absolute delta (current − prior). Negative = decrease. */
-  deltaAbs: z28.number(),
+  deltaAbs: z29.number(),
   /**
    * Signed percent change vs `prior`, rounded to a whole number. Null when
    * `prior <= 0` (percentage undefined). Renderers route count/traffic tiles
    * through the "smart %" rule — percentage when the prior base is large
    * enough (`MIN_PCT_BASE`), otherwise a rounded raw delta.
    */
-  deltaPct: z28.number().nullable(),
+  deltaPct: z29.number().nullable(),
   /**
    * Direction tag for tone mapping. Threshold is metric-specific (3pp for
    * rates, 0.5 for counts) so small noise lands as 'flat' rather than
    * flipping up/down each run.
    */
-  direction: z28.enum(["up", "down", "flat"]),
+  direction: z29.enum(["up", "down", "flat"]),
   /**
    * How many points went into each side of the average. Omitted (or 1)
    * means point-to-point (legacy "since last check"). Higher values mean
    * a rolling-average comparison — renderers should label it as
    * "vs prior N checks" when this is ≥ 2.
    */
-  window: z28.number().optional()
+  window: z29.number().optional()
 });
-var reportProviderMovementSchema = z28.object({
-  provider: z28.string(),
-  current: z28.number(),
-  prior: z28.number(),
-  deltaAbs: z28.number(),
-  direction: z28.enum(["up", "down", "flat"])
+var reportProviderMovementSchema = z29.object({
+  provider: z29.string(),
+  current: z29.number(),
+  prior: z29.number(),
+  deltaAbs: z29.number(),
+  direction: z29.enum(["up", "down", "flat"])
 });
-var whatsChangedSectionSchema = z28.object({
+var whatsChangedSectionSchema = z29.object({
   /**
    * False when there's no prior run (or fewer than the trend baseline),
    * meaning all per-metric deltas will be null. Renderers use this to swap
    * in a "establishing baseline" fallback rather than rendering empty
    * delta tiles.
    */
-  enoughHistory: z28.boolean(),
+  enoughHistory: z29.boolean(),
   /**
    * One-sentence narrative summary suitable as a section subtitle.
    * Always present — even on baseline, narrates whatever signal exists.
    */
-  headline: z28.string(),
+  headline: z29.string(),
   /** Citation rate delta vs the prior completed run. Null when no prior run. */
   citationRate: reportRateDeltaSchema.nullable(),
   /** Mention rate delta vs the prior completed run. Null when no prior run. */
@@ -4699,30 +4946,30 @@ var whatsChangedSectionSchema = z28.object({
    * deltas "vs prior {comparisonWindowDays} days" off this single value so the
    * SPA and HTML stay verbatim-identical.
    */
-  comparisonWindowDays: z28.number().int().positive(),
+  comparisonWindowDays: z29.number().int().positive(),
   /**
    * Per-provider citation rate movements (latest run vs prior run). Empty
    * when no prior run. Sorted by |deltaAbs| desc — providers with the
    * biggest swing first.
    */
-  providerMovements: z28.array(reportProviderMovementSchema),
+  providerMovements: z29.array(reportProviderMovementSchema),
   /**
    * Top wins this period — gains surfaced by the intelligence engine.
    * Capped at 5; sourced from `insights` filtered to `type: 'gain'`.
    */
-  wins: z28.array(reportInsightSchema),
+  wins: z29.array(reportInsightSchema),
   /**
    * Top regressions this period — citations or mentions lost. Capped at 5;
    * sourced from `insights` filtered to `type: 'regression'`.
    */
-  regressions: z28.array(reportInsightSchema)
-});
-var reportAudienceSchema = z28.enum(["agency", "client"]);
-var reportActionAudienceSchema = z28.enum(["agency", "client", "both"]);
-var reportActionHorizonSchema = z28.enum(["immediate", "short-term", "medium-term"]);
-var reportActionConfidenceSchema = z28.enum(["high", "medium", "low"]);
-var reportToneSchema = z28.enum(["positive", "caution", "negative", "neutral"]);
-var reportActionCategorySchema = z28.enum([
+  regressions: z29.array(reportInsightSchema)
+});
+var reportAudienceSchema = z29.enum(["agency", "client"]);
+var reportActionAudienceSchema = z29.enum(["agency", "client", "both"]);
+var reportActionHorizonSchema = z29.enum(["immediate", "short-term", "medium-term"]);
+var reportActionConfidenceSchema = z29.enum(["high", "medium", "low"]);
+var reportToneSchema = z29.enum(["positive", "caution", "negative", "neutral"]);
+var reportActionCategorySchema = z29.enum([
   "content",
   "competitors",
   "provider",
@@ -4731,23 +4978,23 @@ var reportActionCategorySchema = z28.enum([
   "location",
   "monitoring"
 ]);
-var reportActionPlanItemSchema = z28.object({
+var reportActionPlanItemSchema = z29.object({
   /** Which report audience should see this action. `both` renders in both modes. */
   audience: reportActionAudienceSchema,
   /** Stable sort priority. Lower numbers render earlier. */
-  priority: z28.number(),
+  priority: z29.number(),
   /** When this should be tackled. */
   horizon: reportActionHorizonSchema,
   category: reportActionCategorySchema,
-  title: z28.string(),
+  title: z29.string(),
   /** Direct next step written as an operator/client-friendly imperative. */
-  action: z28.string(),
+  action: z29.string(),
   /** Why this matters. Keep each entry concise and evidence-backed. */
-  why: z28.array(z28.string()),
+  why: z29.array(z29.string()),
   /** Specific observations that justify the action. */
-  evidence: z28.array(z28.string()),
+  evidence: z29.array(z29.string()),
   /** What should move if the action worked. */
-  successMetric: z28.string(),
+  successMetric: z29.string(),
   /** Confidence in the recommendation based on the available evidence. */
   confidence: reportActionConfidenceSchema,
   /**
@@ -4759,23 +5006,23 @@ var reportActionPlanItemSchema = z28.object({
    * load. Actions sourced from other signals (competitor gaps, indexing
    * issues, etc.) omit this and use their own dismiss flows.
    */
-  targetRef: z28.string().optional()
+  targetRef: z29.string().optional()
 });
-var reportClientSummarySchema = z28.object({
-  headline: z28.string(),
-  overview: z28.string(),
-  actionItems: z28.array(reportActionPlanItemSchema),
-  confidenceNotes: z28.array(z28.string())
+var reportClientSummarySchema = z29.object({
+  headline: z29.string(),
+  overview: z29.string(),
+  actionItems: z29.array(reportActionPlanItemSchema),
+  confidenceNotes: z29.array(z29.string())
 });
-var reportAgencyDiagnosticSchema = z28.object({
-  title: z28.string(),
-  detail: z28.string(),
-  severity: z28.enum(["positive", "caution", "negative", "neutral"]),
-  evidence: z28.array(z28.string())
+var reportAgencyDiagnosticSchema = z29.object({
+  title: z29.string(),
+  detail: z29.string(),
+  severity: z29.enum(["positive", "caution", "negative", "neutral"]),
+  evidence: z29.array(z29.string())
 });
-var reportAgencyDiagnosticsSchema = z28.object({
-  priorities: z28.array(reportActionPlanItemSchema),
-  diagnostics: z28.array(reportAgencyDiagnosticSchema)
+var reportAgencyDiagnosticsSchema = z29.object({
+  priorities: z29.array(reportActionPlanItemSchema),
+  diagnostics: z29.array(reportAgencyDiagnosticSchema)
 });
 function reportActionTone(action) {
   if (action.horizon === "immediate") return "negative";
@@ -4833,7 +5080,7 @@ function reportConfidenceLabel(confidence) {
       return "Low";
   }
 }
-var projectReportDtoSchema = z28.object({
+var projectReportDtoSchema = z29.object({
   meta: reportMetaSchema,
   executiveSummary: reportExecutiveSummarySchema,
   citationScorecard: citationScorecardSchema,
@@ -4847,16 +5094,16 @@ var projectReportDtoSchema = z28.object({
   /** Server-side log-evidence visibility (crawls + click-through sessions). Null when no traffic source connected. */
   serverActivity: serverActivitySectionSchema.nullable(),
   indexingHealth: indexingHealthSectionSchema.nullable(),
-  citationsTrend: z28.array(citationsTrendPointSchema),
+  citationsTrend: z29.array(citationsTrendPointSchema),
   /**
    * Trend-focused "what's changed" summary for the report's act 2. Always
    * present; renderers gate empty/baseline states via `enoughHistory`.
    */
   whatsChanged: whatsChangedSectionSchema,
-  insights: z28.array(reportInsightSchema),
-  recommendedNextSteps: z28.array(recommendedNextStepSchema),
+  insights: z29.array(reportInsightSchema),
+  recommendedNextSteps: z29.array(recommendedNextStepSchema),
   /** Canonical structured actions shared by the client and agency render modes. */
-  actionPlan: z28.array(reportActionPlanItemSchema),
+  actionPlan: z29.array(reportActionPlanItemSchema),
   /** Polished client-facing summary and action shortlist. */
   clientSummary: reportClientSummarySchema,
   /** Technical, evidence-oriented operator diagnostics for agency mode. */
@@ -4866,17 +5113,17 @@ var projectReportDtoSchema = z28.object({
    * intelligence layer (`buildContentTargetRows`). Empty when no run has
    * produced candidate queries with demand or competitor signal.
    */
-  contentOpportunities: z28.array(contentTargetRowDtoSchema),
+  contentOpportunities: z29.array(contentTargetRowDtoSchema),
   /**
    * Queries where competitors were cited but the project was not. Sourced
    * from `buildContentGapRows`. Empty until the first answer-visibility run.
    */
-  contentGaps: z28.array(contentGapRowDtoSchema),
+  contentGaps: z29.array(contentGapRowDtoSchema),
   /**
    * Per-query grounding source map (own + competitor cited URLs). Sourced
    * from `buildContentSourceRows`. Empty until the first answer-visibility run.
    */
-  groundingSources: z28.array(contentSourceRowDtoSchema)
+  groundingSources: z29.array(contentSourceRowDtoSchema)
 });
 
 // ../contracts/src/report-dedup.ts
@@ -4947,10 +5194,10 @@ function dedupeReportOpportunities(report) {
 }
 
 // ../contracts/src/skills.ts
-import { z as z29 } from "zod";
-var codingAgentSchema = z29.enum(["claude", "codex"]);
+import { z as z30 } from "zod";
+var codingAgentSchema = z30.enum(["claude", "codex"]);
 var CodingAgents = codingAgentSchema.enum;
-var skillsClientSchema = z29.enum(["claude", "codex", "all"]);
+var skillsClientSchema = z30.enum(["claude", "codex", "all"]);
 var SkillsClients = skillsClientSchema.enum;
 var SKILL_MANIFEST_FILENAME = ".canonry-skill-manifest.json";
 function classifySkillFile(params) {
@@ -4968,22 +5215,22 @@ function coerceSkillManifest(parsed) {
 }
 
 // ../contracts/src/traffic.ts
-import { z as z30 } from "zod";
-var trafficCrawlerSegmentsSchema = z30.object({
-  content: z30.number().int().nonnegative(),
-  sitemap: z30.number().int().nonnegative(),
-  robots: z30.number().int().nonnegative(),
-  asset: z30.number().int().nonnegative(),
-  other: z30.number().int().nonnegative()
-});
-var trafficPathClassSchema = z30.enum([
+import { z as z31 } from "zod";
+var trafficCrawlerSegmentsSchema = z31.object({
+  content: z31.number().int().nonnegative(),
+  sitemap: z31.number().int().nonnegative(),
+  robots: z31.number().int().nonnegative(),
+  asset: z31.number().int().nonnegative(),
+  other: z31.number().int().nonnegative()
+});
+var trafficPathClassSchema = z31.enum([
   "content",
   "sitemap",
   "robots",
   "asset",
   "other"
 ]);
-var trafficSourceTypeSchema = z30.enum([
+var trafficSourceTypeSchema = z31.enum([
   "cloud-run",
   "wordpress",
   "cloudflare",
@@ -4991,7 +5238,7 @@ var trafficSourceTypeSchema = z30.enum([
   "generic-log"
 ]);
 var TrafficSourceTypes = trafficSourceTypeSchema.enum;
-var trafficAdapterCapabilitySchema = z30.enum([
+var trafficAdapterCapabilitySchema = z31.enum([
   "raw-request-events",
   "aggregate-request-metrics",
   "request-url",
@@ -5002,234 +5249,252 @@ var trafficAdapterCapabilitySchema = z30.enum([
   "cursor-pull"
 ]);
 var TrafficAdapterCapabilities = trafficAdapterCapabilitySchema.enum;
-var trafficEvidenceKindSchema = z30.enum(["raw-request", "aggregate-bucket"]);
+var trafficEvidenceKindSchema = z31.enum(["raw-request", "aggregate-bucket"]);
 var TrafficEvidenceKinds = trafficEvidenceKindSchema.enum;
-var trafficEventConfidenceSchema = z30.enum(["observed", "provider-aggregated", "inferred"]);
+var trafficEventConfidenceSchema = z31.enum(["observed", "provider-aggregated", "inferred"]);
 var TrafficEventConfidences = trafficEventConfidenceSchema.enum;
-var trafficProviderResourceSchema = z30.object({
-  type: z30.string().nullable(),
-  labels: z30.record(z30.string(), z30.string())
+var trafficProviderResourceSchema = z31.object({
+  type: z31.string().nullable(),
+  labels: z31.record(z31.string(), z31.string())
 });
-var normalizedTrafficRequestSchema = z30.object({
+var normalizedTrafficRequestSchema = z31.object({
   sourceType: trafficSourceTypeSchema,
-  evidenceKind: z30.literal(TrafficEvidenceKinds["raw-request"]),
-  confidence: z30.literal(TrafficEventConfidences.observed),
-  eventId: z30.string().min(1),
-  observedAt: z30.string().min(1),
-  method: z30.string().nullable(),
-  requestUrl: z30.string().nullable(),
-  host: z30.string().nullable(),
-  path: z30.string().min(1),
-  queryString: z30.string().nullable(),
-  status: z30.number().int().nullable(),
-  userAgent: z30.string().nullable(),
-  remoteIp: z30.string().nullable(),
-  referer: z30.string().nullable(),
-  latencyMs: z30.number().nullable(),
-  requestSizeBytes: z30.number().int().nullable(),
-  responseSizeBytes: z30.number().int().nullable(),
+  evidenceKind: z31.literal(TrafficEvidenceKinds["raw-request"]),
+  confidence: z31.literal(TrafficEventConfidences.observed),
+  eventId: z31.string().min(1),
+  observedAt: z31.string().min(1),
+  method: z31.string().nullable(),
+  requestUrl: z31.string().nullable(),
+  host: z31.string().nullable(),
+  path: z31.string().min(1),
+  queryString: z31.string().nullable(),
+  status: z31.number().int().nullable(),
+  userAgent: z31.string().nullable(),
+  remoteIp: z31.string().nullable(),
+  referer: z31.string().nullable(),
+  latencyMs: z31.number().nullable(),
+  requestSizeBytes: z31.number().int().nullable(),
+  responseSizeBytes: z31.number().int().nullable(),
   providerResource: trafficProviderResourceSchema,
-  providerLabels: z30.record(z30.string(), z30.string())
+  providerLabels: z31.record(z31.string(), z31.string())
 });
-var normalizedTrafficPullPageSchema = z30.object({
-  events: z30.array(normalizedTrafficRequestSchema),
-  rawEntryCount: z30.number().int().nonnegative(),
-  skippedEntryCount: z30.number().int().nonnegative(),
-  nextPageToken: z30.string().optional(),
-  filter: z30.string()
+var normalizedTrafficPullPageSchema = z31.object({
+  events: z31.array(normalizedTrafficRequestSchema),
+  rawEntryCount: z31.number().int().nonnegative(),
+  skippedEntryCount: z31.number().int().nonnegative(),
+  nextPageToken: z31.string().optional(),
+  filter: z31.string()
 });
-var trafficSourceStatusSchema = z30.enum(["connected", "paused", "error", "archived"]);
+var trafficSourceStatusSchema = z31.enum(["connected", "paused", "error", "archived"]);
 var TrafficSourceStatuses = trafficSourceStatusSchema.enum;
-var trafficSourceAuthModeSchema = z30.enum(["oauth", "service-account"]);
+var trafficSourceAuthModeSchema = z31.enum(["oauth", "service-account"]);
 var TrafficSourceAuthModes = trafficSourceAuthModeSchema.enum;
-var verificationStatusSchema = z30.enum(["verified", "claimed_unverified", "unknown_ai_like"]);
+var verificationStatusSchema = z31.enum(["verified", "claimed_unverified", "unknown_ai_like"]);
 var VerificationStatuses = verificationStatusSchema.enum;
-var cloudRunSourceConfigSchema = z30.object({
-  gcpProjectId: z30.string().min(1),
-  serviceName: z30.string().nullable().optional(),
-  location: z30.string().nullable().optional(),
+var cloudRunSourceConfigSchema = z31.object({
+  gcpProjectId: z31.string().min(1),
+  serviceName: z31.string().nullable().optional(),
+  location: z31.string().nullable().optional(),
   authMode: trafficSourceAuthModeSchema
 });
-var wordpressTrafficSourceConfigSchema = z30.object({
-  baseUrl: z30.string().url(),
-  username: z30.string().min(1)
+var wordpressTrafficSourceConfigSchema = z31.object({
+  baseUrl: z31.string().url(),
+  username: z31.string().min(1)
 });
-var vercelTrafficEnvironmentSchema = z30.enum(["production", "preview"]);
+var vercelTrafficEnvironmentSchema = z31.enum(["production", "preview"]);
 var VercelTrafficEnvironments = vercelTrafficEnvironmentSchema.enum;
-var vercelTrafficSourceConfigSchema = z30.object({
+var vercelTrafficSourceConfigSchema = z31.object({
   /** Vercel project id (e.g. `prj_...`). */
-  projectId: z30.string().min(1),
+  projectId: z31.string().min(1),
   /** Vercel team or account id: the org that owns the project. */
-  teamId: z30.string().min(1),
+  teamId: z31.string().min(1),
   environment: vercelTrafficEnvironmentSchema
 });
-var trafficSourceDtoSchema = z30.object({
-  id: z30.string(),
-  projectId: z30.string(),
+var trafficSourceDtoSchema = z31.object({
+  id: z31.string(),
+  projectId: z31.string(),
   sourceType: trafficSourceTypeSchema,
-  displayName: z30.string(),
+  displayName: z31.string(),
   status: trafficSourceStatusSchema,
-  lastSyncedAt: z30.string().nullable(),
-  lastCursor: z30.string().nullable(),
-  lastError: z30.string().nullable(),
-  archivedAt: z30.string().nullable(),
-  config: z30.record(z30.string(), z30.unknown()),
-  createdAt: z30.string(),
-  updatedAt: z30.string()
-});
-var trafficConnectCloudRunRequestSchema = z30.object({
-  gcpProjectId: z30.string().min(1),
-  serviceName: z30.string().min(1).optional(),
-  location: z30.string().min(1).optional(),
-  displayName: z30.string().min(1).optional(),
+  lastSyncedAt: z31.string().nullable(),
+  lastCursor: z31.string().nullable(),
+  lastError: z31.string().nullable(),
+  archivedAt: z31.string().nullable(),
+  config: z31.record(z31.string(), z31.unknown()),
+  createdAt: z31.string(),
+  updatedAt: z31.string()
+});
+var trafficConnectCloudRunRequestSchema = z31.object({
+  gcpProjectId: z31.string().min(1),
+  serviceName: z31.string().min(1).optional(),
+  location: z31.string().min(1).optional(),
+  displayName: z31.string().min(1).optional(),
   /** Service-account JSON content (string). When omitted, defaults to OAuth via `canonry google connect <project> --type ga4` flow. */
-  keyJson: z30.string().optional()
+  keyJson: z31.string().optional()
 });
-var trafficConnectWordpressRequestSchema = z30.object({
-  baseUrl: z30.string().url(),
-  username: z30.string().min(1),
+var trafficConnectWordpressRequestSchema = z31.object({
+  baseUrl: z31.string().url(),
+  username: z31.string().min(1),
   /** WordPress Application Password (the same auth used by the content client). */
-  applicationPassword: z30.string().min(1),
-  displayName: z30.string().min(1).optional()
+  applicationPassword: z31.string().min(1),
+  displayName: z31.string().min(1).optional()
 });
-var trafficConnectVercelRequestSchema = z30.object({
+var trafficConnectVercelRequestSchema = z31.object({
   /** Vercel project id (e.g. `prj_...`) — from the Vercel dashboard or `.vercel/project.json`. */
-  projectId: z30.string().min(1),
+  projectId: z31.string().min(1),
   /** Vercel team or account id: the org that owns the project ("orgId" in .vercel/project.json). */
-  teamId: z30.string().min(1),
+  teamId: z31.string().min(1),
   /** Vercel personal access token. Stored in `~/.canonry/config.yaml`, never the DB. */
-  token: z30.string().min(1),
+  token: z31.string().min(1),
   /** Which deployment environment's request logs to pull. Default: `production`. */
   environment: vercelTrafficEnvironmentSchema.optional(),
-  displayName: z30.string().min(1).optional()
+  displayName: z31.string().min(1).optional()
 });
-var trafficSyncResponseSchema = z30.object({
-  sourceId: z30.string(),
-  runId: z30.string(),
-  syncedAt: z30.string(),
-  pulledEvents: z30.number().int().nonnegative(),
+var trafficSyncResponseSchema = z31.object({
+  sourceId: z31.string(),
+  runId: z31.string(),
+  syncedAt: z31.string(),
+  pulledEvents: z31.number().int().nonnegative(),
   /** Self-traffic events (Canonry's own tooling) dropped before rollup. */
-  selfTrafficExcluded: z30.number().int().nonnegative(),
-  crawlerHits: z30.number().int().nonnegative(),
-  aiUserFetchHits: z30.number().int().nonnegative(),
-  aiReferralHits: z30.number().int().nonnegative(),
-  unknownHits: z30.number().int().nonnegative(),
-  crawlerBucketRows: z30.number().int().nonnegative(),
-  aiUserFetchBucketRows: z30.number().int().nonnegative(),
-  aiReferralBucketRows: z30.number().int().nonnegative(),
-  sampleRows: z30.number().int().nonnegative(),
-  windowStart: z30.string(),
-  windowEnd: z30.string()
-});
-var trafficBackfillRequestSchema = z30.object({
+  selfTrafficExcluded: z31.number().int().nonnegative(),
+  crawlerHits: z31.number().int().nonnegative(),
+  aiUserFetchHits: z31.number().int().nonnegative(),
+  aiReferralHits: z31.number().int().nonnegative(),
+  unknownHits: z31.number().int().nonnegative(),
+  crawlerBucketRows: z31.number().int().nonnegative(),
+  aiUserFetchBucketRows: z31.number().int().nonnegative(),
+  aiReferralBucketRows: z31.number().int().nonnegative(),
+  sampleRows: z31.number().int().nonnegative(),
+  windowStart: z31.string(),
+  windowEnd: z31.string()
+});
+var trafficBackfillRequestSchema = z31.object({
   /** Lookback window in days. Capped server-side at the upstream log retention ceiling (Cloud Logging _Default = 30d). Default: 30. */
-  days: z30.number().int().positive().optional()
+  days: z31.number().int().positive().optional()
 });
-var trafficResetRequestSchema = z30.object({
-  advanceToNow: z30.literal(true)
+var trafficResetRequestSchema = z31.object({
+  advanceToNow: z31.literal(true)
 });
-var trafficBackfillResponseSchema = z30.object({
-  sourceId: z30.string(),
-  runId: z30.string(),
+var trafficBackfillResponseSchema = z31.object({
+  sourceId: z31.string(),
+  runId: z31.string(),
   status: runStatusSchema,
-  windowStart: z30.string(),
-  windowEnd: z30.string(),
+  windowStart: z31.string(),
+  windowEnd: z31.string(),
   /** Days actually used after server-side clamping (≤ requested). */
-  daysRequested: z30.number().int().positive(),
-  daysApplied: z30.number().int().positive()
+  daysRequested: z31.number().int().positive(),
+  daysApplied: z31.number().int().positive()
 });
-var trafficSourceTotalsSchema = z30.object({
+var trafficSourceTotalsSchema = z31.object({
   /**
    * Total classified-crawler hits in the window. UNCHANGED contract — still the
    * full count across every path class. Use `crawlerContentHits` for the
    * "content was actually crawled" signal.
    */
-  crawlerHits: z30.number().int().nonnegative(),
+  crawlerHits: z31.number().int().nonnegative(),
   /** Crawler hits against content/document paths only (= `crawlerSegments.content`). */
-  crawlerContentHits: z30.number().int().nonnegative(),
+  crawlerContentHits: z31.number().int().nonnegative(),
   /** Infrastructure crawler hits — sitemap + robots + asset fetches (`crawlerSegments.{sitemap,robots,asset}`). */
-  crawlerInfraHits: z30.number().int().nonnegative(),
+  crawlerInfraHits: z31.number().int().nonnegative(),
   /** Full per-class crawler-hit breakdown; the five buckets sum to `crawlerHits`. */
   crawlerSegments: trafficCrawlerSegmentsSchema,
-  aiUserFetchHits: z30.number().int().nonnegative(),
-  aiReferralHits: z30.number().int().nonnegative(),
-  sampleCount: z30.number().int().nonnegative()
+  aiUserFetchHits: z31.number().int().nonnegative(),
+  aiReferralHits: z31.number().int().nonnegative(),
+  sampleCount: z31.number().int().nonnegative()
 });
-var trafficSourceListResponseSchema = z30.object({
-  sources: z30.array(trafficSourceDtoSchema)
+var trafficSourceListResponseSchema = z31.object({
+  sources: z31.array(trafficSourceDtoSchema)
 });
 var trafficSourceDetailDtoSchema = trafficSourceDtoSchema.extend({
   totals24h: trafficSourceTotalsSchema,
-  latestRun: z30.object({
-    runId: z30.string(),
+  latestRun: z31.object({
+    runId: z31.string(),
     status: runStatusSchema,
-    startedAt: z30.string().nullable(),
-    finishedAt: z30.string().nullable(),
-    error: z30.string().nullable()
+    startedAt: z31.string().nullable(),
+    finishedAt: z31.string().nullable(),
+    error: z31.string().nullable()
   }).nullable()
 });
-var trafficStatusResponseSchema = z30.object({
-  sources: z30.array(trafficSourceDetailDtoSchema)
+var trafficStatusResponseSchema = z31.object({
+  sources: z31.array(trafficSourceDetailDtoSchema)
 });
-var trafficEventKindSchema = z30.enum(["crawler", "ai-user-fetch", "ai-referral"]);
+var trafficEventKindSchema = z31.enum(["crawler", "ai-user-fetch", "ai-referral"]);
 var TrafficEventKinds = trafficEventKindSchema.enum;
-var trafficCrawlerEventEntrySchema = z30.object({
-  kind: z30.literal(TrafficEventKinds.crawler),
-  sourceId: z30.string(),
-  tsHour: z30.string(),
-  botId: z30.string(),
-  operator: z30.string(),
-  verificationStatus: z30.string(),
-  pathNormalized: z30.string(),
+var trafficCrawlerEventEntrySchema = z31.object({
+  kind: z31.literal(TrafficEventKinds.crawler),
+  sourceId: z31.string(),
+  tsHour: z31.string(),
+  botId: z31.string(),
+  operator: z31.string(),
+  verificationStatus: z31.string(),
+  pathNormalized: z31.string(),
   /** Coarse class of the fetched path — lets the UI split content crawls from sitemap/robots/asset polling. */
   pathClass: trafficPathClassSchema,
-  status: z30.number().int(),
-  hits: z30.number().int().nonnegative()
-});
-var trafficAiUserFetchEventEntrySchema = z30.object({
-  kind: z30.literal(TrafficEventKinds["ai-user-fetch"]),
-  sourceId: z30.string(),
-  tsHour: z30.string(),
-  botId: z30.string(),
-  operator: z30.string(),
-  verificationStatus: z30.string(),
-  pathNormalized: z30.string(),
-  status: z30.number().int(),
-  hits: z30.number().int().nonnegative()
-});
-var trafficAiReferralEventEntrySchema = z30.object({
-  kind: z30.literal(TrafficEventKinds["ai-referral"]),
-  sourceId: z30.string(),
-  tsHour: z30.string(),
-  product: z30.string(),
-  operator: z30.string(),
-  sourceDomain: z30.string(),
-  evidenceType: z30.string(),
-  landingPathNormalized: z30.string(),
-  status: z30.number().int(),
-  hits: z30.number().int().nonnegative()
-});
-var trafficEventEntrySchema = z30.discriminatedUnion("kind", [
+  status: z31.number().int(),
+  hits: z31.number().int().nonnegative()
+});
+var trafficAiUserFetchEventEntrySchema = z31.object({
+  kind: z31.literal(TrafficEventKinds["ai-user-fetch"]),
+  sourceId: z31.string(),
+  tsHour: z31.string(),
+  botId: z31.string(),
+  operator: z31.string(),
+  verificationStatus: z31.string(),
+  pathNormalized: z31.string(),
+  status: z31.number().int(),
+  hits: z31.number().int().nonnegative()
+});
+var trafficAiReferralEventEntrySchema = z31.object({
+  kind: z31.literal(TrafficEventKinds["ai-referral"]),
+  sourceId: z31.string(),
+  tsHour: z31.string(),
+  product: z31.string(),
+  operator: z31.string(),
+  sourceDomain: z31.string(),
+  evidenceType: z31.string(),
+  landingPathNormalized: z31.string(),
+  status: z31.number().int(),
+  /** Total AI-referral sessions in the bucket. `paidHits + organicHits + unknownHits === hits`. */
+  hits: z31.number().int().nonnegative(),
+  /** Sessions carrying paid-attribution UTM evidence (`utm_medium=cpc`, …). */
+  paidHits: z31.number().int().nonnegative(),
+  /** Sessions with no paid-attribution evidence. Not proof the click was unpaid — an untagged ad click is indistinguishable. */
+  organicHits: z31.number().int().nonnegative(),
+  /**
+   * Sessions ingested before the classifier shipped. Their UTM tags were never
+   * persisted, so they can never be resolved to paid or organic. Never fold
+   * these into `organicHits`.
+   */
+  unknownHits: z31.number().int().nonnegative()
+});
+var trafficEventEntrySchema = z31.discriminatedUnion("kind", [
   trafficCrawlerEventEntrySchema,
   trafficAiUserFetchEventEntrySchema,
   trafficAiReferralEventEntrySchema
 ]);
-var trafficEventsResponseSchema = z30.object({
-  windowStart: z30.string(),
-  windowEnd: z30.string(),
-  totals: z30.object({
+var trafficEventsResponseSchema = z31.object({
+  windowStart: z31.string(),
+  windowEnd: z31.string(),
+  totals: z31.object({
     /** Total classified-crawler hits across the window. UNCHANGED contract. */
-    crawlerHits: z30.number().int().nonnegative(),
+    crawlerHits: z31.number().int().nonnegative(),
     /** Crawler hits against content/document paths only (= `crawlerSegments.content`). */
-    crawlerContentHits: z30.number().int().nonnegative(),
+    crawlerContentHits: z31.number().int().nonnegative(),
     /** Infrastructure crawler hits — sitemap + robots + asset fetches. */
-    crawlerInfraHits: z30.number().int().nonnegative(),
+    crawlerInfraHits: z31.number().int().nonnegative(),
     /** Full per-class crawler-hit breakdown; the five buckets sum to `crawlerHits`. */
     crawlerSegments: trafficCrawlerSegmentsSchema,
-    aiUserFetchHits: z30.number().int().nonnegative(),
-    aiReferralHits: z30.number().int().nonnegative()
+    aiUserFetchHits: z31.number().int().nonnegative(),
+    /** Total AI-referral sessions. The three class buckets below sum to it. */
+    aiReferralHits: z31.number().int().nonnegative(),
+    /** AI-referral sessions carrying paid-attribution UTM evidence. */
+    aiReferralPaidHits: z31.number().int().nonnegative(),
+    /** AI-referral sessions with no paid-attribution evidence. */
+    aiReferralOrganicHits: z31.number().int().nonnegative(),
+    /** AI-referral sessions ingested before the classifier shipped; unresolvable, never organic. */
+    aiReferralUnknownHits: z31.number().int().nonnegative()
   }),
-  events: z30.array(trafficEventEntrySchema)
+  events: z31.array(trafficEventEntrySchema)
 });
 
 // ../contracts/src/traffic-path.ts
@@ -5367,199 +5632,134 @@ function sumInfraHits(segments) {
   return segments.sitemap + segments.robots + segments.asset;
 }
 
-// ../contracts/src/formatting.ts
-function formatRatio(value) {
-  if (!Number.isFinite(value) || value === 0) return "0%";
-  return `${(value * 100).toFixed(1)}%`;
-}
-function formatNumber(value) {
-  if (!Number.isFinite(value)) return "\u2014";
-  if (Math.abs(value) >= 1e6) return `${(value / 1e6).toFixed(1)}M`;
-  if (Math.abs(value) >= 1e3) return `${(value / 1e3).toFixed(1)}K`;
-  return value.toLocaleString("en-US");
-}
-function formatDate(iso) {
-  if (!iso) return "\u2014";
-  try {
-    const dateOnly = /^(\d{4})-(\d{2})-(\d{2})$/.exec(iso);
-    const options = { month: "short", day: "numeric", year: "numeric" };
-    const d = dateOnly && dateOnly[1] && dateOnly[2] && dateOnly[3] ? new Date(Date.UTC(Number(dateOnly[1]), Number(dateOnly[2]) - 1, Number(dateOnly[3]))) : new Date(iso);
-    if (Number.isNaN(d.getTime())) return iso;
-    return d.toLocaleDateString("en-US", dateOnly ? { ...options, timeZone: "UTC" } : options);
-  } catch {
-    return iso;
-  }
-}
-function formatIsoDate(iso) {
-  if (!iso) return "\u2014";
-  try {
-    const d = new Date(iso);
-    if (Number.isNaN(d.getTime())) return iso;
-    const yyyy = d.getUTCFullYear();
-    const mm = String(d.getUTCMonth() + 1).padStart(2, "0");
-    const dd = String(d.getUTCDate()).padStart(2, "0");
-    return `${yyyy}-${mm}-${dd}`;
-  } catch {
-    return iso;
-  }
-}
-function formatDateRange(start, end) {
-  if (!start && !end) return "";
-  if (start && end) return `${formatDate(start)} \u2192 ${formatDate(end)}`;
-  return formatDate(start || end);
-}
-var DATE_ONLY_PATTERN = /^\d{4}-\d{2}-\d{2}$/;
-function parseInclusiveEndMs(iso) {
-  const ms = Date.parse(iso);
-  if (Number.isNaN(ms)) return null;
-  return DATE_ONLY_PATTERN.test(iso) ? ms + 864e5 - 1 : ms;
-}
-function deltaPercent(current, prior) {
-  if (prior <= 0) return null;
-  return Math.round((current - prior) / prior * 100);
-}
-function deltaTone(deltaPct) {
-  if (deltaPct === null || deltaPct === 0) return "neutral";
-  return deltaPct > 0 ? "positive" : "negative";
-}
-function formatDeltaCopy(d, suffix, windowLabel = "vs prior 7 days") {
-  if (d.deltaPct === null) {
-    return d.prior === 0 ? "First baseline week" : "";
-  }
-  if (d.deltaPct > 0) return `Up ${d.deltaPct}% ${windowLabel} (${formatNumber(d.prior)} ${suffix})`;
-  if (d.deltaPct < 0) return `Down ${Math.abs(d.deltaPct)}% ${windowLabel} (${formatNumber(d.prior)} ${suffix})`;
-  return `Flat ${windowLabel} (${formatNumber(d.prior)} ${suffix})`;
-}
-var MIN_PCT_BASE = 30;
-function round1(value) {
-  return Math.round(value * 10) / 10;
-}
-function formatAverageDelta(d) {
-  if (d.prior >= MIN_PCT_BASE && d.deltaPct !== null) {
-    const sign2 = d.deltaPct > 0 ? "+" : "";
-    return `${sign2}${d.deltaPct}% vs prior`;
-  }
-  const sign = d.deltaAbs > 0 ? "+" : "";
-  return `${sign}${round1(d.deltaAbs)} vs ${round1(d.prior)}`;
-}
-function formatWindowCountDelta(d, countLabel, windowLabel) {
-  if (d.prior >= MIN_PCT_BASE && d.deltaPct !== null) {
-    const sign2 = d.deltaPct > 0 ? "+" : "";
-    return `${sign2}${d.deltaPct}% ${windowLabel}`;
-  }
-  const sign = d.deltaAbs > 0 ? "+" : "";
-  return `${sign}${formatNumber(Math.round(d.deltaAbs))} ${countLabel} ${windowLabel}`;
+// ../contracts/src/statistics.ts
+function round(value, dp = 4) {
+  const f = 10 ** dp;
+  return (Math.round(value * f) + 0) / f;
+}
+function wilsonInterval(successes, n, z33 = 1.96) {
+  if (!Number.isFinite(n) || n <= 0) return null;
+  const s = Math.max(0, Math.min(successes, n));
+  const p = s / n;
+  const z210 = z33 * z33;
+  const denom = 1 + z210 / n;
+  const center = (p + z210 / (2 * n)) / denom;
+  const margin = z33 / denom * Math.sqrt(p * (1 - p) / n + z210 / (4 * n * n));
+  return {
+    low: round(Math.max(0, center - margin)),
+    high: round(Math.min(1, center + margin))
+  };
 }
 
 // ../contracts/src/ads.ts
-import { z as z31 } from "zod";
-var adsConnectRequestSchema = z31.object({
+import { z as z32 } from "zod";
+var adsConnectRequestSchema = z32.object({
   /** Ads Manager "SDK key" scoped to one ad account. Stored in config.yaml, never the DB. */
-  apiKey: z31.string().min(1)
-});
-var adsConnectionStatusDtoSchema = z31.object({
-  connected: z31.boolean(),
-  adAccountId: z31.string().nullable().optional(),
-  displayName: z31.string().nullable().optional(),
-  currencyCode: z31.string().nullable().optional(),
-  timezone: z31.string().nullable().optional(),
-  status: z31.string().nullable().optional(),
-  lastSyncedAt: z31.string().nullable().optional(),
+  apiKey: z32.string().min(1)
+});
+var adsConnectionStatusDtoSchema = z32.object({
+  connected: z32.boolean(),
+  adAccountId: z32.string().nullable().optional(),
+  displayName: z32.string().nullable().optional(),
+  currencyCode: z32.string().nullable().optional(),
+  timezone: z32.string().nullable().optional(),
+  status: z32.string().nullable().optional(),
+  lastSyncedAt: z32.string().nullable().optional(),
   /** Whether the ad account has OpenAI conversion tracking (pixel or CAPI) configured,
    *  detected from synced campaigns carrying conversion_event_setting_ids. Optional:
    *  only present when connected. */
-  conversionTrackingConfigured: z31.boolean().optional()
-});
-var adsDisconnectResponseSchema = z31.object({
-  disconnected: z31.boolean()
-});
-var adsSyncResponseSchema = z31.object({
-  runId: z31.string(),
-  status: z31.string()
-});
-var adsCreativeDtoSchema = z31.object({
-  type: z31.string().nullable().optional(),
-  title: z31.string().nullable().optional(),
-  body: z31.string().nullable().optional(),
-  targetUrl: z31.string().nullable().optional()
-});
-var adsAdDtoSchema = z31.object({
-  id: z31.string(),
-  adGroupId: z31.string(),
-  name: z31.string(),
-  status: z31.string(),
-  reviewStatus: z31.string().nullable().optional(),
+  conversionTrackingConfigured: z32.boolean().optional()
+});
+var adsDisconnectResponseSchema = z32.object({
+  disconnected: z32.boolean()
+});
+var adsSyncResponseSchema = z32.object({
+  runId: z32.string(),
+  status: z32.string()
+});
+var adsCreativeDtoSchema = z32.object({
+  type: z32.string().nullable().optional(),
+  title: z32.string().nullable().optional(),
+  body: z32.string().nullable().optional(),
+  targetUrl: z32.string().nullable().optional()
+});
+var adsAdDtoSchema = z32.object({
+  id: z32.string(),
+  adGroupId: z32.string(),
+  name: z32.string(),
+  status: z32.string(),
+  reviewStatus: z32.string().nullable().optional(),
   creative: adsCreativeDtoSchema.nullable().optional()
 });
-var adsAdGroupDtoSchema = z31.object({
-  id: z31.string(),
-  campaignId: z31.string(),
-  name: z31.string(),
-  status: z31.string(),
-  billingEventType: z31.string().nullable().optional(),
-  maxBidMicros: z31.number().int().nullable().optional(),
+var adsAdGroupDtoSchema = z32.object({
+  id: z32.string(),
+  campaignId: z32.string(),
+  name: z32.string(),
+  status: z32.string(),
+  billingEventType: z32.string().nullable().optional(),
+  maxBidMicros: z32.number().int().nullable().optional(),
   /**
    * The targeting primitive: entries are multi-line strings of
    * newline-separated example queries (the live Ads Manager format).
    */
-  contextHints: z31.array(z31.string()).default([]),
-  ads: z31.array(adsAdDtoSchema).default([])
-});
-var adsCampaignDtoSchema = z31.object({
-  id: z31.string(),
-  name: z31.string(),
-  status: z31.string(),
-  biddingType: z31.string().nullable().optional(),
-  dailySpendLimitMicros: z31.number().int().nullable().optional(),
-  lifetimeSpendLimitMicros: z31.number().int().nullable().optional(),
-  adGroups: z31.array(adsAdGroupDtoSchema).default([])
-});
-var adsCampaignListResponseSchema = z31.object({
-  campaigns: z31.array(adsCampaignDtoSchema)
-});
-var adsInsightLevelSchema = z31.enum(["campaign", "ad_group"]);
+  contextHints: z32.array(z32.string()).default([]),
+  ads: z32.array(adsAdDtoSchema).default([])
+});
+var adsCampaignDtoSchema = z32.object({
+  id: z32.string(),
+  name: z32.string(),
+  status: z32.string(),
+  biddingType: z32.string().nullable().optional(),
+  dailySpendLimitMicros: z32.number().int().nullable().optional(),
+  lifetimeSpendLimitMicros: z32.number().int().nullable().optional(),
+  adGroups: z32.array(adsAdGroupDtoSchema).default([])
+});
+var adsCampaignListResponseSchema = z32.object({
+  campaigns: z32.array(adsCampaignDtoSchema)
+});
+var adsInsightLevelSchema = z32.enum(["campaign", "ad_group"]);
 var AdsInsightLevels = adsInsightLevelSchema.enum;
-var adsInsightRowDtoSchema = z31.object({
+var adsInsightRowDtoSchema = z32.object({
   level: adsInsightLevelSchema,
-  entityId: z31.string(),
-  date: z31.string(),
-  impressions: z31.number().int(),
-  clicks: z31.number().int(),
-  spendMicros: z31.number().int(),
+  entityId: z32.string(),
+  date: z32.string(),
+  impressions: z32.number().int(),
+  clicks: z32.number().int(),
+  spendMicros: z32.number().int(),
   /** Conversion count for the row. 0 when conversion tracking is not configured.
    *  Conversion VALUE (for ROAS) is a deliberate follow-up: the upstream value
    *  field is not yet captured against a live conversion-tracking account. */
-  conversions: z31.number().int(),
+  conversions: z32.number().int(),
   /** clicks / impressions; null when impressions is 0. */
-  ctr: z31.number().nullable(),
+  ctr: z32.number().nullable(),
   /** spendMicros / clicks, rounded to integer micros; null when clicks is 0. */
-  cpcMicros: z31.number().int().nullable()
+  cpcMicros: z32.number().int().nullable()
 });
-var adsInsightsResponseSchema = z31.object({
-  rows: z31.array(adsInsightRowDtoSchema),
+var adsInsightsResponseSchema = z32.object({
+  rows: z32.array(adsInsightRowDtoSchema),
   /** Account currency for rendering spend/cpc; null before the first sync. */
-  currencyCode: z31.string().nullable().optional()
-});
-var adsTotalsDtoSchema = z31.object({
-  impressions: z31.number().int(),
-  clicks: z31.number().int(),
-  spendMicros: z31.number().int(),
-  conversions: z31.number().int(),
-  ctr: z31.number().nullable(),
-  cpcMicros: z31.number().int().nullable()
-});
-var adsSummaryDtoSchema = z31.object({
-  connected: z31.boolean(),
-  displayName: z31.string().nullable().optional(),
-  currencyCode: z31.string().nullable().optional(),
-  lastSyncedAt: z31.string().nullable().optional(),
-  campaignCount: z31.number().int(),
-  adGroupCount: z31.number().int(),
-  adCount: z31.number().int(),
+  currencyCode: z32.string().nullable().optional()
+});
+var adsTotalsDtoSchema = z32.object({
+  impressions: z32.number().int(),
+  clicks: z32.number().int(),
+  spendMicros: z32.number().int(),
+  conversions: z32.number().int(),
+  ctr: z32.number().nullable(),
+  cpcMicros: z32.number().int().nullable()
+});
+var adsSummaryDtoSchema = z32.object({
+  connected: z32.boolean(),
+  displayName: z32.string().nullable().optional(),
+  currencyCode: z32.string().nullable().optional(),
+  lastSyncedAt: z32.string().nullable().optional(),
+  campaignCount: z32.number().int(),
+  adGroupCount: z32.number().int(),
+  adCount: z32.number().int(),
   /** Date range the totals cover (oldest/newest rollup date), null when empty. */
-  window: z31.object({
-    from: z31.string().nullable(),
-    to: z31.string().nullable()
+  window: z32.object({
+    from: z32.string().nullable(),
+    to: z32.string().nullable()
   }),
   /** Campaign-level rollup totals over the window (levels are not summed across). */
   totals: adsTotalsDtoSchema
@@ -5934,9 +6134,23 @@ export {
   parseWindow,
   windowCutoff,
   visibilityStatsDtoSchema,
+  visibilityCompareDtoSchema,
   calendarMonthBounds,
-  GA4AiReferralTrafficClasses,
-  classifyGa4AiReferralTrafficClass,
+  formatRatio,
+  formatNumber,
+  formatDate,
+  formatIsoDate,
+  formatDateRange,
+  parseInclusiveEndMs,
+  deltaPercent,
+  deltaTone,
+  formatDeltaCopy,
+  formatAverageDelta,
+  formatWindowCountDelta,
+  AiReferralTrafficClasses,
+  classifyAiReferralTrafficClass,
+  aiReferralClassCounts,
+  formatAiReferralClassSummary,
   ga4StatusDtoSchema,
   ga4SyncResponseDtoSchema,
   ga4AiReferralHistoryEntrySchema,
@@ -6034,17 +6248,7 @@ export {
   classifyTrafficPath,
   segmentCrawlerHits,
   sumInfraHits,
-  formatRatio,
-  formatNumber,
-  formatDate,
-  formatIsoDate,
-  formatDateRange,
-  parseInclusiveEndMs,
-  deltaPercent,
-  deltaTone,
-  formatDeltaCopy,
-  formatAverageDelta,
-  formatWindowCountDelta,
+  wilsonInterval,
   adsConnectRequestSchema,
   adsConnectionStatusDtoSchema,
   adsDisconnectResponseSchema,