@ainyc/canonry 4.95.0 → 4.97.0

package/dist/{chunk-FFSJRZJR.js → chunk-SRJ5IGNK.js}

@@ -16,6 +16,7 @@ import {
   projectUpsertRequestSchema,
   queryBatchRequestSchema,
   queryGenerateRequestSchema,
+  reportPeriodSchema,
   runTriggerRequestSchema,
   schedulableRunKindSchema,
   scheduleUpsertRequestSchema,
@@ -23,7 +24,7 @@ import {
   trafficConnectVercelRequestSchema,
   trafficConnectWordpressRequestSchema,
   trafficEventKindSchema
-} from "./chunk-BUGJOQNW.js";
+} from "./chunk-E2FDXNMW.js";
 
 // src/config.ts
 import fs from "fs";
@@ -3899,9 +3900,13 @@ var ApiClient = class {
       })
     );
   }
-  async getReport(project) {
+  async getReport(project, opts) {
     return this.invoke(
-      () => getApiV1ProjectsByNameReport({ client: this.heyClient, path: { name: project } })
+      () => getApiV1ProjectsByNameReport({
+        client: this.heyClient,
+        path: { name: project },
+        ...opts?.period !== void 0 && { query: { period: opts.period } }
+      })
     );
   }
   // ── Queries / keywords / competitors ────────────────────────────────────
@@ -5639,13 +5644,16 @@ var canonryMcpTools = [
   defineTool({
     name: "canonry_report",
     title: "Get aggregated AEO report",
-    description: "Returns the full canonical AEO report bundle for a project \u2014 executive summary, client summary, agency diagnostics, action plan, per-query \xD7 per-provider citation matrix, competitor landscape, AI citation sources, GSC/GA4 performance, social and AI referrals, indexing health, citations trend, prioritized insights, and recommended next steps. Same payload `canonry report <project>` consumes to render audience-specific HTML.",
+    description: "Returns the full canonical AEO report bundle for a project \u2014 executive summary, client summary, agency diagnostics, action plan, per-query \xD7 per-provider citation matrix, competitor landscape, AI citation sources, GSC/GA4 performance, social and AI referrals, indexing health, citations trend, prioritized insights, and recommended next steps. Same payload `canonry report <project>` consumes to render audience-specific HTML. Pass `period` (7/14/30/90 days, default 30) to scope the GSC/GA4/server-activity sections and the period-over-period comparisons.",
     access: "read",
     tier: "monitoring",
-    inputSchema: projectInputSchema,
+    inputSchema: z2.object({
+      project: projectNameSchema,
+      period: reportPeriodSchema.optional()
+    }),
     annotations: readAnnotations(),
     openApiOperations: ["GET /api/v1/projects/{name}/report"],
-    handler: (client2, input) => client2.getReport(input.project)
+    handler: (client2, input) => client2.getReport(input.project, input.period !== void 0 ? { period: input.period } : void 0)
   }),
   defineTool({
     name: "canonry_analytics_metrics",

package/dist/{chunk-7YU6ILWL.js → chunk-TXNKKTFD.js}

@@ -124,12 +124,14 @@ import {
   extractAnswerMentions,
   findDuplicateLocationLabels,
   forbidden,
+  formatAverageDelta,
   formatDate,
   formatDateRange,
   formatDeltaCopy,
   formatIsoDate,
   formatNumber,
   formatRatio,
+  formatWindowCountDelta,
   ga4AiReferralHistoryEntrySchema,
   ga4SessionHistoryEntrySchema,
   ga4SocialReferralHistoryEntrySchema,
@@ -178,6 +180,7 @@ import {
   notImplemented,
   notificationDtoSchema,
   parseInclusiveEndMs,
+  parseReportPeriodDays,
   parseRunError,
   parseWindow,
   pickClusterRepresentative,
@@ -196,6 +199,7 @@ import {
   registrableDomain,
   reportActionCategoryLabel,
   reportActionTone,
+  reportComparisonWindowDays,
   reportConfidenceLabel,
   reportHorizonLabel,
   reportSeverityLabel,
@@ -259,7 +263,7 @@ import {
   wordpressSchemaDeployResultDtoSchema,
   wordpressSchemaStatusResultDtoSchema,
   wordpressStatusDtoSchema
-} from "./chunk-BUGJOQNW.js";
+} from "./chunk-E2FDXNMW.js";
 
 // src/intelligence-service.ts
 import { eq as eq37, desc as desc18, asc as asc5, and as and27, ne as ne5, or as or5, inArray as inArray14, gte as gte7, lte as lte4 } from "drizzle-orm";
@@ -1299,6 +1303,7 @@ var adsConnections = sqliteTable("ads_connections", {
   timezone: text("timezone"),
   status: text("status"),
   lastSyncedAt: text("last_synced_at"),
+  conversionTrackingConfigured: integer("conversion_tracking_configured", { mode: "boolean" }).notNull().default(false),
   createdAt: text("created_at").notNull(),
   updatedAt: text("updated_at").notNull()
 }, (table) => [
@@ -1362,6 +1367,7 @@ var adsInsightsDaily = sqliteTable("ads_insights_daily", {
   impressions: integer("impressions").notNull().default(0),
   clicks: integer("clicks").notNull().default(0),
   spendMicros: integer("spend_micros").notNull().default(0),
+  conversions: integer("conversions").notNull().default(0),
   syncRunId: text("sync_run_id").references(() => runs.id, { onDelete: "set null" })
 }, (table) => [
   uniqueIndex("uniq_ads_insights_daily").on(table.projectId, table.level, table.entityId, table.date),
@@ -3197,6 +3203,14 @@ var MIGRATION_VERSIONS = [
       )`,
       `CREATE INDEX IF NOT EXISTS idx_gbp_attributes_loc ON gbp_attributes_snapshots(project_id, location_name, synced_at)`
     ]
+  },
+  {
+    version: 83,
+    name: "ads-insights-conversions",
+    statements: [
+      `ALTER TABLE ads_insights_daily ADD COLUMN conversions INTEGER NOT NULL DEFAULT 0`,
+      `ALTER TABLE ads_connections ADD COLUMN conversion_tracking_configured INTEGER NOT NULL DEFAULT 0`
+    ]
   }
 ];
 function rebuildBacklinkTableWithSource(tx, table) {
@@ -5237,10 +5251,13 @@ function smoothedRunDelta(points, valueFn, maxWindow = SMOOTHED_RUN_DELTA_MAX_WI
   const sum = (arr) => arr.reduce((s, p) => s + valueFn(p), 0);
   const currentAvg = sum(tail) / tail.length;
   const priorAvg = sum(prior) / prior.length;
+  const current = roundTo1Decimal(currentAvg);
+  const prior_ = roundTo1Decimal(priorAvg);
   return {
-    current: roundTo1Decimal(currentAvg),
-    prior: roundTo1Decimal(priorAvg),
+    current,
+    prior: prior_,
     deltaAbs: currentAvg - priorAvg,
+    deltaPct: deltaPercent(current, prior_),
     window
   };
 }
@@ -10123,27 +10140,24 @@ function renderRateDeltaTile(label, delta, unit) {
     return `<div class="metric"><div class="label">${escapeHtml(label)}</div><div class="value">\u2014</div><div class="delta">No prior data</div></div>`;
   }
   const valueSuffix = unit === "%" ? "%" : "";
-  const deltaSign = delta.deltaAbs > 0 ? "+" : "";
-  const deltaText = `${deltaSign}${delta.deltaAbs.toFixed(unit === "%" ? 1 : 0)}${valueSuffix} vs ${delta.prior}${valueSuffix}`;
+  const deltaText = unit === "%" ? `${delta.deltaAbs > 0 ? "+" : ""}${delta.deltaAbs.toFixed(1)}% vs ${delta.prior}%` : formatAverageDelta(delta);
   return `<div class="metric">
     <div class="label">${escapeHtml(label)}</div>
     <div class="value ${deltaToneClass(delta.direction)}">${delta.current}${valueSuffix} <span style="font-size:14px;font-weight:500;">${deltaArrow(delta.direction)}</span></div>
     <div class="delta">${deltaText}</div>
   </div>`;
 }
-function renderTrafficDeltaTile(label, delta, countLabel) {
+function renderTrafficDeltaTile(label, delta, countLabel, comparisonWindowDays) {
   if (!delta) {
     return `<div class="metric"><div class="label">${escapeHtml(label)}</div><div class="value">\u2014</div><div class="delta">Not enough trend data</div></div>`;
   }
-  const deltaSign = delta.deltaAbs > 0 ? "+" : "";
-  const deltaText = `${deltaSign}${formatNumber(delta.deltaAbs)} ${countLabel} vs prior ${WHATS_CHANGED_PERIOD_DAYS} days`;
+  const deltaText = formatWindowCountDelta(delta, countLabel, `vs prior ${comparisonWindowDays} days`);
   return `<div class="metric">
     <div class="label">${escapeHtml(label)}</div>
     <div class="value ${deltaToneClass(delta.direction)}">${formatNumber(delta.current)} <span style="font-size:14px;font-weight:500;">${deltaArrow(delta.direction)}</span></div>
     <div class="delta">${deltaText}</div>
   </div>`;
 }
-var WHATS_CHANGED_PERIOD_DAYS = 14;
 function renderProviderMovements(movements, audience) {
   const meaningful = movements.filter((m) => m.direction !== "flat");
   if (meaningful.length === 0) return "";
@@ -10210,8 +10224,8 @@ function renderWhatsChanged(report, audience) {
     ${renderRateDeltaTile(isClient ? "AI links to your website" : "Citation rate", w.citationRate, "%")}
     ${renderRateDeltaTile(isClient ? "AI mentions your name" : "Mention rate", w.mentionRate, "%")}
     ${renderRateDeltaTile(isClient ? "Questions AI answered with you" : "Cited queries", w.citedQueryCount, "count")}
-    ${renderTrafficDeltaTile(isClient ? "Visitors from Google" : "GSC clicks", w.gscClicksDelta, isClient ? "visits" : "clicks")}
-    ${renderTrafficDeltaTile(isClient ? "Visitors from AI tools" : "AI referral sessions", w.aiReferralsDelta, isClient ? "visits" : "sessions")}
+    ${renderTrafficDeltaTile(isClient ? "Visitors from Google" : "GSC clicks", w.gscClicksDelta, isClient ? "visits" : "clicks", w.comparisonWindowDays)}
+    ${renderTrafficDeltaTile(isClient ? "Visitors from AI tools" : "AI referral sessions", w.aiReferralsDelta, isClient ? "visits" : "sessions", w.comparisonWindowDays)}
   </div>`;
   const movements = renderProviderMovements(w.providerMovements, audience);
   const winsHeading = isClient ? "What got better" : "Wins";
@@ -10676,33 +10690,36 @@ function renderAiReferrals(report) {
     </div>`
   );
 }
-function serverActivityHeading(audience, hasData) {
+function serverActivityHeading(audience, hasData, windowDays) {
   const isClient = audience === "client";
   return {
     id: "server-activity",
     eyebrow: isClient ? "AI engine attention" : "Section 10",
     title: "AI Visibility \u2014 Server-Side",
-    intro: isClient ? hasData ? "What AI engines actually do in your server logs over the last 7 days \u2014 the other half of citations." : "Live telemetry from your server logs." : "What AI engines actually do in your server logs \u2014 direct evidence, complementary to citations (which measure what they say)."
+    intro: isClient ? hasData ? `What AI engines actually do in your server logs over the last ${windowDays} days \u2014 the other half of citations.` : "Live telemetry from your server logs." : "What AI engines actually do in your server logs \u2014 direct evidence, complementary to citations (which measure what they say)."
   };
 }
 function renderServerActivity(report, audience) {
   const sa = report.serverActivity;
   const isClient = audience === "client";
+  const windowDays = report.meta.periodDays;
+  const windowLabel = `${windowDays}d`;
+  const priorWindowLabel = `vs prior ${windowDays} days`;
   if (!sa) {
     if (isClient) return "";
     return section(
-      serverActivityHeading("agency", false),
+      serverActivityHeading("agency", false, windowDays),
       renderEmpty("Connect a server-side traffic source to surface what AI engines do directly in your server logs \u2014 distinct from GA4 click-throughs.")
     );
   }
   if (!sa.hasData) {
     return section(
-      serverActivityHeading(audience, false),
+      serverActivityHeading(audience, false, windowDays),
       renderEmpty(isClient ? "Your server-side traffic source is connected. Numbers will appear after the next sync." : "Source connected \u2014 collecting your first data. Numbers will appear after the next sync.")
     );
   }
   const formatDelta = (d, suffix) => {
-    const copy = formatDeltaCopy(d, suffix);
+    const copy = formatDeltaCopy(d, suffix, priorWindowLabel);
     if (!copy) return "";
     return `<span class="tone-${deltaTone(d.deltaPct)}">${escapeHtml(copy)}</span>`;
   };
@@ -10729,7 +10746,7 @@ function renderServerActivity(report, audience) {
       <td class="numeric">${formatNumber(o.referralArrivals)}</td>
     </tr>`).join("");
     return section(
-      serverActivityHeading("client", true),
+      serverActivityHeading("client", true, windowDays),
       `<div class="metric-grid">
         <div class="metric">
           <div class="label">AI bot requests observed</div>
@@ -10749,7 +10766,7 @@ function renderServerActivity(report, audience) {
       </div>
       ${clientOperatorRows ? `<div class="chart-card"><h3>By AI tool</h3>
         <table class="report-table">
-          <thead><tr><th>AI tool</th><th class="numeric">Bot requests (7d)</th><th class="numeric">User fetches (7d)</th><th class="numeric">Referral sessions</th></tr></thead>
+          <thead><tr><th>AI tool</th><th class="numeric">Bot requests (${windowLabel})</th><th class="numeric">User fetches (${windowLabel})</th><th class="numeric">Referral sessions</th></tr></thead>
           <tbody>${clientOperatorRows}</tbody>
         </table>
         <p class="meta">Bot requests are bulk crawl (GPTBot, PerplexityBot, \u2026). User fetches are on-demand reads triggered by real users inside an AI surface (ChatGPT-User, Perplexity-User, \u2026). Verified means the request came from an IP the operator publishes as its own; unverified means the user-agent matched but the IP is not in a published range. User-fetch totals count both, since many genuine user fetches come from outside any published range.</p>
@@ -10790,28 +10807,28 @@ function renderServerActivity(report, audience) {
   const trendChart = sa.dailyTrend.length > 0 ? renderLineChart(
     sa.dailyTrend.map((d) => ({ x: d.date, y: d.verifiedCrawlerHits, label: d.date.slice(5) })),
     COLORS.series[1],
-    "Verified crawler hits over time (last 14 days)"
+    `Verified crawler hits over time (last ${windowDays} days)`
   ) : "";
   return section(
-    serverActivityHeading("agency", true),
+    serverActivityHeading("agency", true, windowDays),
     `<div class="metric-grid">
       <div class="metric">
-        <div class="label">Verified crawler hits (7d)</div>
+        <div class="label">Verified crawler hits (${windowLabel})</div>
         <div class="value">${formatNumber(sa.verifiedCrawlerHits.current)}</div>
         <div class="subtitle">${formatDelta(sa.verifiedCrawlerHits, "hits")}</div>
       </div>
       <div class="metric">
-        <div class="label">Unverified crawler hits (7d)</div>
+        <div class="label">Unverified crawler hits (${windowLabel})</div>
         <div class="value">${formatNumber(sa.unverifiedCrawlerHits.current)}</div>
         <div class="subtitle">${formatDelta(sa.unverifiedCrawlerHits, "hits")}</div>
       </div>
       <div class="metric">
-        <div class="label">AI user-fetch hits (7d)</div>
+        <div class="label">AI user-fetch hits (${windowLabel})</div>
         <div class="value">${formatNumber(sa.aiUserFetchHits.current)}</div>
         <div class="subtitle">${formatDelta(sa.aiUserFetchHits, "hits")}</div>
       </div>
       <div class="metric">
-        <div class="label">AI-referral sessions (7d)</div>
+        <div class="label">AI-referral sessions (${windowLabel})</div>
         <div class="value">${formatNumber(sa.referralArrivals.current)}</div>
         <div class="subtitle">${formatDelta(sa.referralArrivals, "sessions")}</div>
       </div>
@@ -10820,12 +10837,12 @@ function renderServerActivity(report, audience) {
     ${operatorRows ? `<div class="chart-card"><h3>Per AI operator</h3>
       <p class="meta">Verified means the request's source IP falls inside the operator's published range. Unverified bots claim the user-agent but the IP is not in a published range, so it could be the real bot or an imitator. User fetches are on-demand reads from an AI surface on behalf of a real user (ChatGPT-User, Perplexity-User, \u2026), disjoint from bulk crawl and counted whether or not the IP can be verified.</p>
       <table class="report-table">
-        <thead><tr><th>Operator</th><th class="numeric">Verified hits</th><th class="numeric">Unverified</th><th class="numeric">User fetches</th><th class="numeric">Referral sessions</th><th class="numeric">7d delta</th></tr></thead>
+        <thead><tr><th>Operator</th><th class="numeric">Verified hits</th><th class="numeric">Unverified</th><th class="numeric">User fetches</th><th class="numeric">Referral sessions</th><th class="numeric">${windowLabel} delta</th></tr></thead>
         <tbody>${operatorRows}</tbody>
       </table>
     </div>` : ""}
     ${pathRows ? `<div class="chart-card"><h3>Top crawled paths</h3>
-      <p class="meta">Pages AI bots fetched most often (verified only, last 7d).</p>
+      <p class="meta">Pages AI bots fetched most often (verified only, last ${windowLabel}).</p>
       <table class="report-table">
         <thead><tr><th>Path</th><th class="numeric">Verified hits</th><th class="numeric">Distinct operators</th></tr></thead>
         <tbody>${pathRows}</tbody>
@@ -11305,7 +11322,7 @@ function renderReportHtml(report, opts = {}) {
   <header class="header">
     <div class="eyebrow">AI Visibility Report</div>
     <h1>${escapeHtml(report.meta.project.displayName)}</h1>
-    <div class="subtitle">${escapeHtml(report.meta.project.canonicalDomain)} \xB7 ${escapeHtml(report.meta.project.country)} / ${escapeHtml(report.meta.project.language.toUpperCase())}${renderHeaderLocationFragment(report.meta.location)} \xB7 Generated ${formatDate(report.meta.generatedAt)}</div>
+    <div class="subtitle">${escapeHtml(report.meta.project.canonicalDomain)} \xB7 ${escapeHtml(report.meta.project.country)} / ${escapeHtml(report.meta.project.language.toUpperCase())}${renderHeaderLocationFragment(report.meta.location)} \xB7 Last ${report.meta.periodDays} days \xB7 Generated ${formatDate(report.meta.generatedAt)}</div>
   </header>
   ${sections}
   <footer class="footer">Generated by <a href="https://canonry.ai">canonry</a> \xB7 ${escapeHtml(formatIsoDate(report.meta.generatedAt))}</footer>
@@ -11321,10 +11338,8 @@ var TOP_LANDING_PAGES_LIMIT = 20;
 var TOP_AI_REFERRAL_PAGES_LIMIT = 10;
 var TOP_CAMPAIGN_LIMIT = 10;
 var INSIGHT_LOOKBACK_RUNS = 5;
-var REPORT_WINDOW_DAYS = 30;
-var SERVER_ACTIVITY_HEADLINE_DAYS = 7;
-var SERVER_ACTIVITY_TREND_DAYS = 14;
 var SERVER_ACTIVITY_TOP_PATHS_LIMIT = 10;
+var GA_WINDOW_SUMMARY_KEYS = { 7: "7d", 30: "30d", 90: "90d" };
 function windowStartDate(endDate, windowDays) {
   const m = /^(\d{4})-(\d{2})-(\d{2})$/.exec(endDate);
   if (!m) return endDate;
@@ -11370,12 +11385,12 @@ function loadQueryLookup(db, projectId) {
   for (const row of rows) byId.set(row.id, row.query);
   return { byId };
 }
-function buildGscSection(db, projectId, projectBrandNames, canonicalDomain, trackedQueries) {
+function buildGscSection(db, projectId, projectBrandNames, canonicalDomain, trackedQueries, windowDays) {
   const allRows = db.select().from(gscSearchData).where(eq14(gscSearchData.projectId, projectId)).all();
   if (allRows.length === 0) return null;
   let maxDate = "";
   for (const r of allRows) if (r.date > maxDate) maxDate = r.date;
-  const startDate = windowStartDate(maxDate, REPORT_WINDOW_DAYS);
+  const startDate = windowStartDate(maxDate, windowDays);
   const rows = allRows.filter((r) => r.date >= startDate && r.date <= maxDate);
   if (rows.length === 0) return null;
   let totalClicks = 0;
@@ -11442,19 +11457,20 @@ function buildGscSection(db, projectId, projectBrandNames, canonicalDomain, trac
     gscButNotTracked
   };
 }
-function buildGaSection(db, projectId) {
-  const windowSummary = db.select().from(gaTrafficWindowSummaries).where(
+function buildGaSection(db, projectId, windowDays) {
+  const gaWindowKey = GA_WINDOW_SUMMARY_KEYS[windowDays];
+  const windowSummary = gaWindowKey ? db.select().from(gaTrafficWindowSummaries).where(
     and9(
       eq14(gaTrafficWindowSummaries.projectId, projectId),
-      eq14(gaTrafficWindowSummaries.windowKey, "30d")
+      eq14(gaTrafficWindowSummaries.windowKey, gaWindowKey)
     )
-  ).limit(1).get();
+  ).limit(1).get() : void 0;
   const fallbackSummary = windowSummary ? null : db.select().from(gaTrafficSummaries).where(eq14(gaTrafficSummaries.projectId, projectId)).orderBy(desc7(gaTrafficSummaries.syncedAt)).limit(1).get();
   const allSnapshotRows = db.select().from(gaTrafficSnapshots).where(eq14(gaTrafficSnapshots.projectId, projectId)).all();
   if (!windowSummary && !fallbackSummary && allSnapshotRows.length === 0) return null;
   let snapshotMaxDate = "";
   for (const r of allSnapshotRows) if (r.date > snapshotMaxDate) snapshotMaxDate = r.date;
-  const snapshotStartDate = snapshotMaxDate ? windowStartDate(snapshotMaxDate, REPORT_WINDOW_DAYS) : "";
+  const snapshotStartDate = snapshotMaxDate ? windowStartDate(snapshotMaxDate, windowDays) : "";
   const snapshotRows = snapshotStartDate ? allSnapshotRows.filter((r) => r.date >= snapshotStartDate && r.date <= snapshotMaxDate) : allSnapshotRows;
   const totalSessions = windowSummary?.totalSessions ?? fallbackSummary?.totalSessions ?? snapshotRows.reduce((s, r) => s + r.sessions, 0);
   const totalUsers = windowSummary?.totalUsers ?? fallbackSummary?.totalUsers ?? snapshotRows.reduce((s, r) => s + r.users, 0);
@@ -11620,7 +11636,7 @@ function nonSubresourceReferralPathCondition() {
     AND LOWER(${aiReferralEventsHourly.landingPathNormalized}) NOT LIKE '%.woff2'
   `;
 }
-function buildServerActivity(db, projectId) {
+function buildServerActivity(db, projectId, windowDays) {
   const sourceRows = db.select({ id: trafficSources.id }).from(trafficSources).where(
     and9(
       eq14(trafficSources.projectId, projectId),
@@ -11630,9 +11646,9 @@ function buildServerActivity(db, projectId) {
   if (sourceRows.length === 0) return null;
   const now = /* @__PURE__ */ new Date();
   const headlineEnd = now.toISOString();
-  const headlineStartMs = now.getTime() - SERVER_ACTIVITY_HEADLINE_DAYS * 24 * 60 * 6e4;
-  const priorStartMs = headlineStartMs - SERVER_ACTIVITY_HEADLINE_DAYS * 24 * 60 * 6e4;
-  const trendStartMs = now.getTime() - SERVER_ACTIVITY_TREND_DAYS * 24 * 60 * 6e4;
+  const headlineStartMs = now.getTime() - windowDays * 24 * 60 * 6e4;
+  const priorStartMs = headlineStartMs - windowDays * 24 * 60 * 6e4;
+  const trendStartMs = headlineStartMs;
   const headlineStart = new Date(headlineStartMs).toISOString();
   const priorStart = new Date(priorStartMs).toISOString();
   const trendStart = new Date(trendStartMs).toISOString();
@@ -12416,8 +12432,6 @@ function buildAgencyDiagnostics(input) {
     diagnostics
   };
 }
-var WHATS_CHANGED_PERIOD_DAYS2 = 14;
-var WHATS_CHANGED_MIN_TREND_POINTS = WHATS_CHANGED_PERIOD_DAYS2 * 2;
 var RATE_REAL_MOVEMENT_THRESHOLD_PP = 3;
 var COUNT_REAL_MOVEMENT_THRESHOLD = 0.5;
 var WIN_REGRESSION_LIMIT = 5;
@@ -12426,10 +12440,10 @@ function rateDirection(delta, threshold = 0.5) {
   if (delta < -threshold) return "down";
   return "flat";
 }
-function periodOverPeriodDelta(trend) {
-  if (trend.length < WHATS_CHANGED_MIN_TREND_POINTS) return null;
-  const tail = trend.slice(-WHATS_CHANGED_PERIOD_DAYS2);
-  const prior = trend.slice(-WHATS_CHANGED_PERIOD_DAYS2 * 2, -WHATS_CHANGED_PERIOD_DAYS2);
+function periodOverPeriodDelta(trend, halfWindow) {
+  if (trend.length < halfWindow * 2) return null;
+  const tail = trend.slice(-halfWindow);
+  const prior = trend.slice(-halfWindow * 2, -halfWindow);
   const current = tail.reduce((s, p) => s + p.value, 0);
   const priorTotal = prior.reduce((s, p) => s + p.value, 0);
   const deltaAbs = current - priorTotal;
@@ -12437,10 +12451,11 @@ function periodOverPeriodDelta(trend) {
     current,
     prior: priorTotal,
     deltaAbs,
+    deltaPct: deltaPercent(current, priorTotal),
     direction: rateDirection(deltaAbs, 0)
   };
 }
-function buildWhatsChangedHeadline(citation, gscClicks, aiReferrals, enoughHistory, trendLength) {
+function buildWhatsChangedHeadline(citation, gscClicks, aiReferrals, enoughHistory, trendLength, comparisonWindowDays) {
   if (!enoughHistory) {
     return `Building baseline (${trendLength} of ${MIN_TREND_POINTS} checks completed). Trends appear after a few more checks.`;
   }
@@ -12453,15 +12468,15 @@ function buildWhatsChangedHeadline(citation, gscClicks, aiReferrals, enoughHisto
   }
   if (aiReferrals && aiReferrals.direction !== "flat") {
     const arrow = aiReferrals.direction === "up" ? "\u2191" : "\u2193";
-    parts.push(`AI referrals ${arrow}${Math.abs(aiReferrals.deltaAbs)} sessions vs prior 14 days`);
+    parts.push(`AI referrals ${arrow}${Math.abs(aiReferrals.deltaAbs)} sessions vs prior ${comparisonWindowDays} days`);
   } else if (gscClicks && gscClicks.direction !== "flat") {
     const arrow = gscClicks.direction === "up" ? "\u2191" : "\u2193";
-    parts.push(`GSC clicks ${arrow}${Math.abs(gscClicks.deltaAbs)} vs prior 14 days`);
+    parts.push(`GSC clicks ${arrow}${Math.abs(gscClicks.deltaAbs)} vs prior ${comparisonWindowDays} days`);
   }
   return parts.length > 0 ? `${parts.join(" \xB7 ")}.` : "No meaningful movement vs the prior period.";
 }
 function buildWhatsChanged(input) {
-  const { citationsTrend, gsc, aiReferrals, insights: insightList } = input;
+  const { citationsTrend, gsc, aiReferrals, insights: insightList, comparisonWindowDays } = input;
   const baseline = isTrendBaseline(citationsTrend);
   const latest = citationsTrend.at(-1);
   const prior = citationsTrend.length >= 2 ? citationsTrend.at(-2) : null;
@@ -12498,8 +12513,8 @@ function buildWhatsChanged(input) {
     }
     providerMovements.sort((a, b) => Math.abs(b.deltaAbs) - Math.abs(a.deltaAbs));
   }
-  const gscClicksDelta = gsc ? periodOverPeriodDelta(gsc.trend.map((t) => ({ date: t.date, value: t.clicks }))) : null;
-  const aiReferralsDelta = aiReferrals ? periodOverPeriodDelta(aiReferrals.trend.map((t) => ({ date: t.date, value: t.sessions }))) : null;
+  const gscClicksDelta = gsc ? periodOverPeriodDelta(gsc.trend.map((t) => ({ date: t.date, value: t.clicks })), comparisonWindowDays) : null;
+  const aiReferralsDelta = aiReferrals ? periodOverPeriodDelta(aiReferrals.trend.map((t) => ({ date: t.date, value: t.sessions })), comparisonWindowDays) : null;
   const wins = insightList.filter((i) => i.type === "gain").slice(0, WIN_REGRESSION_LIMIT);
   const regressions = insightList.filter((i) => i.type === "regression").slice(0, WIN_REGRESSION_LIMIT);
   const headline = buildWhatsChangedHeadline(
@@ -12507,7 +12522,8 @@ function buildWhatsChanged(input) {
     gscClicksDelta,
     aiReferralsDelta,
     enoughHistory,
-    citationsTrend.length
+    citationsTrend.length,
+    comparisonWindowDays
   );
   return {
     enoughHistory,
@@ -12517,14 +12533,16 @@ function buildWhatsChanged(input) {
     citedQueryCount,
     gscClicksDelta,
     aiReferralsDelta,
+    comparisonWindowDays,
     providerMovements,
     wins,
     regressions
   };
 }
-function buildProjectReport(db, projectName) {
+function buildProjectReport(db, projectName, periodDays) {
   const project = resolveProject(db, projectName);
   const queryLookup = loadQueryLookup(db, project.id);
+  const comparisonWindowDays = reportComparisonWindowDays(periodDays);
   const allRuns = db.select().from(runs).where(and9(eq14(runs.projectId, project.id), notProbeRun())).orderBy(desc7(runs.createdAt), desc7(runs.id)).all();
   const visibilityRuns = allRuns.filter((r) => r.kind === RunKinds["answer-visibility"]);
   const completedVisRunGroups = groupRunsByCreatedAt(
@@ -12564,12 +12582,13 @@ function buildProjectReport(db, projectName) {
     project.id,
     projectBrandNames,
     project.canonicalDomain,
-    trackedQueries
+    trackedQueries,
+    periodDays
   );
-  const gaSection = buildGaSection(db, project.id);
+  const gaSection = buildGaSection(db, project.id, periodDays);
   const socialSection = buildSocialReferrals(db, project.id);
   const aiReferralsSection = buildAiReferrals(db, project.id);
-  const serverActivitySection = buildServerActivity(db, project.id);
+  const serverActivitySection = buildServerActivity(db, project.id, periodDays);
   const indexingHealthSection = buildIndexingHealth(db, project.id);
   const citationsTrend = buildCitationsTrend(db, project.id, queryLookup, latestRunLocation);
   const insightList = buildInsightList(db, project.id, latestRunLocation);
@@ -12588,7 +12607,8 @@ function buildProjectReport(db, projectName) {
     citationsTrend,
     gsc: gscSection,
     aiReferrals: aiReferralsSection,
-    insights: insightList
+    insights: insightList,
+    comparisonWindowDays
   });
   const totalQueryCount = queryLookup.byId.size;
   const citedQueryIds = /* @__PURE__ */ new Set();
@@ -12704,7 +12724,8 @@ function buildProjectReport(db, projectName) {
       location: reportLocation,
       providerLocationHandling,
       periodStart,
-      periodEnd
+      periodEnd,
+      periodDays
     },
     executiveSummary,
     citationScorecard,
@@ -12740,12 +12761,14 @@ function reportFilenameFor(project, generatedAt, audience) {
 }
 async function reportRoutes(app) {
   app.get("/projects/:name/report", async (request, reply) => {
-    const dto = buildProjectReport(app.db, request.params.name);
+    const periodDays = parseReportPeriodDays(request.query.period);
+    const dto = buildProjectReport(app.db, request.params.name, periodDays);
     return reply.send(dto);
   });
   app.get("/projects/:name/report.html", async (request, reply) => {
     const audience = parseReportAudience(request.query.audience);
-    const dto = buildProjectReport(app.db, request.params.name);
+    const periodDays = parseReportPeriodDays(request.query.period);
+    const dto = buildProjectReport(app.db, request.params.name, periodDays);
     const html = renderReportHtml(dto, { audience });
     const filename = reportFilenameFor(dto.meta.project, dto.meta.generatedAt, audience);
     reply.header("Content-Type", "text/html; charset=utf-8");
@@ -14105,6 +14128,12 @@ var analyticsWindowParameter = {
   description: "Time window for analytics queries.",
   schema: { type: "string", enum: ["7d", "30d", "90d", "all"] }
 };
+var reportPeriodQueryParameter = {
+  name: "period",
+  in: "query",
+  description: "Report window in days \u2014 one of 7, 14, 30, 90 (default 30). Scopes the GSC, GA4, and server-side AI activity sections and the period-over-period comparisons to this window.",
+  schema: { type: "integer", enum: [7, 14, 30, 90] }
+};
 var sinceQueryParameter = {
   name: "since",
   in: "query",
@@ -16839,7 +16868,7 @@ var routeCatalog = [
     summary: "Aggregated canonical AEO report",
     tags: ["report"],
     description: "Bundles every section the canonry-report HTML output needs (executive summary, client summary, agency diagnostics, action plan, citation scorecard, competitor landscape \u2014 citation + mention landscapes, AI citation sources, GSC, GA4, social/AI referrals, indexing health, citations trend, insights, and recommended next steps) into a single canonical JSON payload. Backs `canonry report <project>` and MCP report reads.",
-    parameters: [nameParameter],
+    parameters: [nameParameter, reportPeriodQueryParameter],
     responses: {
       200: jsonResponse("Report returned.", "ProjectReportDto"),
       404: errorResponse("Project not found.")
@@ -16851,7 +16880,7 @@ var routeCatalog = [
     summary: "Standalone HTML AEO report",
     tags: ["report"],
     description: "Server-rendered self-contained HTML version of the project report. Same data as `/projects/{name}/report` (JSON), rendered through the canonry HTML report renderer in agency or client mode. Returns `text/html` with `Content-Disposition: attachment` so browsers download it as `canonry-report-<project>-<audience>-YYYY-MM-DD.html`. Open in a browser and Print \u2192 Save as PDF for a PDF copy.",
-    parameters: [nameParameter, reportAudienceQueryParameter],
+    parameters: [nameParameter, reportAudienceQueryParameter, reportPeriodQueryParameter],
     responses: {
       200: { description: "HTML report returned.", content: { "text/html": { schema: { type: "string" } } } },
       404: errorResponse("Project not found.")
@@ -21508,7 +21537,8 @@ function statusDto(row) {
     currencyCode: row.currencyCode,
     timezone: row.timezone,
     status: row.status,
-    lastSyncedAt: row.lastSyncedAt
+    lastSyncedAt: row.lastSyncedAt,
+    conversionTrackingConfigured: row.conversionTrackingConfigured
   };
 }
 function creativeDto(raw) {
@@ -21706,6 +21736,7 @@ async function adsRoutes(app, opts) {
       impressions: row.impressions,
       clicks: row.clicks,
       spendMicros: row.spendMicros,
+      conversions: row.conversions,
       ctr: adsCtr(row.clicks, row.impressions),
       cpcMicros: adsCpcMicros(row.spendMicros, row.clicks)
     }));
@@ -21726,12 +21757,14 @@ async function adsRoutes(app, opts) {
     let impressions = 0;
     let clicks = 0;
     let spendMicros = 0;
+    let conversions = 0;
     let fromDate = null;
     let toDate = null;
     for (const insight of campaignInsights) {
       impressions += insight.impressions;
       clicks += insight.clicks;
       spendMicros += insight.spendMicros;
+      conversions += insight.conversions;
       if (fromDate === null || insight.date < fromDate) fromDate = insight.date;
       if (toDate === null || insight.date > toDate) toDate = insight.date;
     }
@@ -21748,6 +21781,7 @@ async function adsRoutes(app, opts) {
         impressions,
         clicks,
         spendMicros,
+        conversions,
         ctr: adsCtr(clicks, impressions),
         cpcMicros: adsCpcMicros(spendMicros, clicks)
       }