@ainyc/canonry 3.3.8 → 3.4.5

package/dist/{chunk-ZCPZOVVE.js → chunk-ZOJLW6WR.js}

@@ -1,9 +1,11 @@
 import {
+  ContentActions,
+  RunKinds,
   __export
-} from "./chunk-MLKGABMK.js";
+} from "./chunk-D4YFX3X4.js";
 
 // src/intelligence-service.ts
-import { eq, desc, asc, and, or } from "drizzle-orm";
+import { eq, desc, asc, and, or, inArray } from "drizzle-orm";
 
 // ../db/src/client.ts
 import { mkdirSync } from "fs";
@@ -1946,6 +1948,103 @@ function clamp012(value) {
   return value;
 }
 
+// ../intelligence/src/next-steps.ts
+var TOP_N = 5;
+var IMMEDIATE_HORIZON = 3;
+var ACTION_TITLE = {
+  [ContentActions.create]: (q) => `Create a page targeting "${q}"`,
+  [ContentActions.refresh]: (q) => `Refresh the page targeting "${q}"`,
+  [ContentActions.expand]: (q) => `Expand coverage of "${q}"`,
+  [ContentActions["add-schema"]]: (q) => `Add structured data to the page targeting "${q}"`
+};
+function mapOpportunitiesToNextSteps(opportunities, existing) {
+  if (existing.length > 0) return existing;
+  if (opportunities.length === 0) return [];
+  return opportunities.slice(0, TOP_N).map((opp, idx) => ({
+    horizon: idx < IMMEDIATE_HORIZON ? "immediate" : "short-term",
+    title: ACTION_TITLE[opp.action](opp.query),
+    rationale: `Score ${Math.round(opp.score)} \xB7 demand ${opp.demandSource} \xB7 ${opp.actionConfidence} confidence.`
+  }));
+}
+
+// ../intelligence/src/insight-severity.ts
+var SEVERITY_THRESHOLDS = {
+  highTrafficImpressions: 100,
+  recurrenceCount: 2,
+  mediumTrafficImpressions: 10
+};
+function classifyRegressionSeverity(signals) {
+  const { gscImpressions, recurrenceCount } = signals;
+  if (gscImpressions === void 0 && recurrenceCount === void 0) return "high";
+  const isHighTraffic = gscImpressions !== void 0 && gscImpressions >= SEVERITY_THRESHOLDS.highTrafficImpressions;
+  const isRecurring = recurrenceCount !== void 0 && recurrenceCount >= SEVERITY_THRESHOLDS.recurrenceCount;
+  const isModerateTraffic = gscImpressions !== void 0 && gscImpressions >= SEVERITY_THRESHOLDS.mediumTrafficImpressions;
+  if (isHighTraffic && isRecurring) return "critical";
+  if (isHighTraffic || isRecurring) return "high";
+  if (isModerateTraffic) return "medium";
+  return "low";
+}
+
+// ../intelligence/src/insight-grouping.ts
+function groupInsights(insights2, keyFn = (i) => `${i.keyword} ${i.provider} ${i.type}`) {
+  const order = [];
+  const buckets = /* @__PURE__ */ new Map();
+  for (const i of insights2) {
+    const key = keyFn(i);
+    const bucket = buckets.get(key);
+    if (bucket) {
+      bucket.push(i);
+    } else {
+      buckets.set(key, [i]);
+      order.push(key);
+    }
+  }
+  return order.map((key) => {
+    const sorted = [...buckets.get(key)].sort((a, b) => a.createdAt.localeCompare(b.createdAt));
+    const representative = sorted[sorted.length - 1];
+    return {
+      representative,
+      count: sorted.length,
+      instances: sorted,
+      latest: representative.createdAt
+    };
+  });
+}
+
+// ../intelligence/src/query-categorize.ts
+var TRANSACTIONAL_RE = /\b(buy|price|pricing|cost|hire|near me|services?|agency|consultant|company)\b/i;
+var INFORMATIONAL_RE = /\b(what|how|why|when|guide|tutorial|vs|versus|alternatives?|examples?|definition)\b/i;
+var MIN_BRAND_TOKEN_LENGTH = 3;
+function compact(value) {
+  return value.toLowerCase().replace(/[^a-z0-9]/g, "");
+}
+function buildBrandTokens(canonicalDomain, displayName) {
+  const seen = /* @__PURE__ */ new Set();
+  const stem = canonicalDomain.toLowerCase().replace(/\.[a-z]{2,}$/, "");
+  const stemCompact = compact(stem);
+  if (stemCompact.length >= MIN_BRAND_TOKEN_LENGTH) seen.add(stemCompact);
+  if (displayName) {
+    const displayCompact = compact(displayName);
+    if (displayCompact.length >= MIN_BRAND_TOKEN_LENGTH) seen.add(displayCompact);
+  }
+  return [...seen];
+}
+function categorizeQueryByIntent(query, brandTokens) {
+  const compactQuery = compact(query);
+  if (brandTokens.length > 0 && brandTokens.some((t) => compactQuery.includes(t))) {
+    return "brand";
+  }
+  if (TRANSACTIONAL_RE.test(query)) return "lead-gen";
+  if (INFORMATIONAL_RE.test(query)) return "industry";
+  return "other";
+}
+
+// ../intelligence/src/trend-stability.ts
+var MIN_TREND_POINTS = 4;
+function isTrendBaseline(points) {
+  return points.length < MIN_TREND_POINTS;
+}
+
 // src/intelligence-service.ts
 import crypto from "crypto";
 
@@ -1987,6 +2086,7 @@ function createLogger(module) {
 }
 
 // src/intelligence-service.ts
+var RECURRENCE_LOOKBACK_RUNS = 5;
 var log = createLogger("IntelligenceService");
 var IntelligenceService = class {
   constructor(db) {
@@ -2040,8 +2140,9 @@ var IntelligenceService = class {
       citedRate: result.health.overallCitedRate,
       insights: result.insights.length
     });
-    this.persistResult(result, runId, projectId);
-    return result;
+    const tieredResult = this.tierResult(result, runId, projectId);
+    this.persistResult(tieredResult, runId, projectId);
+    return tieredResult;
   }
   /**
    * Analyze a single run given an explicit previous run (or null for first run).
@@ -2059,8 +2160,9 @@ var IntelligenceService = class {
       return result2;
     }
     const result = analyzeRuns(currentRun, previousRun);
-    this.persistResult(result, runRecord.id, runRecord.projectId);
-    return result;
+    const tieredResult = this.tierResult(result, runRecord.id, runRecord.projectId);
+    this.persistResult(tieredResult, runRecord.id, runRecord.projectId);
+    return tieredResult;
   }
   /**
    * Backfill intelligence for all completed/partial runs of a project.
@@ -2151,6 +2253,59 @@ var IntelligenceService = class {
     });
     log.info("intelligence.persisted", { runId, insights: result.insights.length });
   }
+  /**
+   * Apply severity tiering to the insights of an AnalysisResult and return a
+   * new result. Wraps `applySeverityTiering` so callers (analyzeAndPersist,
+   * analyzeRunWithPrevious) can pass the same tiered shape both into the DB
+   * write and back to the RunCoordinator / webhook dispatcher.
+   */
+  tierResult(result, runId, projectId) {
+    if (result.insights.length === 0) return result;
+    return { ...result, insights: this.applySeverityTiering(result.insights, runId, projectId) };
+  }
+  /**
+   * Re-classify each regression insight's severity using GSC traffic +
+   * recurrence signals via the pure `classifyRegressionSeverity` primitive
+   * in @ainyc/canonry-intelligence. Non-regression insights are returned
+   * untouched.
+   */
+  applySeverityTiering(rawInsights, excludeRunId, projectId) {
+    const regressions = rawInsights.filter((i) => i.type === "regression");
+    if (regressions.length === 0) return rawInsights;
+    const gscRows = this.db.select({ query: gscSearchData.query, impressions: gscSearchData.impressions }).from(gscSearchData).where(eq(gscSearchData.projectId, projectId)).all();
+    const gscConnected = gscRows.length > 0;
+    const gscImpressionsByKeyword = /* @__PURE__ */ new Map();
+    for (const row of gscRows) {
+      const key = row.query.toLowerCase();
+      gscImpressionsByKeyword.set(key, (gscImpressionsByKeyword.get(key) ?? 0) + row.impressions);
+    }
+    const recentRunIds = this.db.select({ id: runs.id }).from(runs).where(
+      and(
+        eq(runs.projectId, projectId),
+        eq(runs.kind, RunKinds["answer-visibility"]),
+        or(eq(runs.status, "completed"), eq(runs.status, "partial"))
+      )
+    ).orderBy(desc(runs.createdAt)).limit(RECURRENCE_LOOKBACK_RUNS + 1).all().map((r) => r.id).filter((id) => id !== excludeRunId).slice(0, RECURRENCE_LOOKBACK_RUNS);
+    const haveHistory = recentRunIds.length > 0;
+    const priorRegressionsByPair = /* @__PURE__ */ new Map();
+    if (haveHistory) {
+      const priorRows = this.db.select({ keyword: insights.keyword, provider: insights.provider }).from(insights).where(and(eq(insights.type, "regression"), inArray(insights.runId, recentRunIds))).all();
+      for (const row of priorRows) {
+        const key = `${row.keyword}:${row.provider}`;
+        priorRegressionsByPair.set(key, (priorRegressionsByPair.get(key) ?? 0) + 1);
+      }
+    }
+    return rawInsights.map((insight) => {
+      if (insight.type !== "regression") return insight;
+      const gscImpressions = gscConnected ? gscImpressionsByKeyword.get(insight.keyword.toLowerCase()) ?? 0 : void 0;
+      const recurrenceCount = haveHistory ? priorRegressionsByPair.get(`${insight.keyword}:${insight.provider}`) ?? 0 : void 0;
+      const severity = classifyRegressionSeverity({
+        gscImpressions,
+        recurrenceCount
+      });
+      return { ...insight, severity };
+    });
+  }
   buildRunData(runId, projectId, completedAt) {
     const rows = this.db.select({
       keyword: keywords.keyword,
@@ -2211,6 +2366,12 @@ export {
   buildContentTargetRows,
   buildContentSourceRows,
   buildContentGapRows,
+  mapOpportunitiesToNextSteps,
+  groupInsights,
+  buildBrandTokens,
+  categorizeQueryByIntent,
+  MIN_TREND_POINTS,
+  isTrendBaseline,
   createLogger,
   IntelligenceService
 };

package/dist/cli.js

@@ -17,51 +17,55 @@ import {
   setGoogleAuthConfig,
   showFirstRunNotice,
   trackEvent
-} from "./chunk-P6D3O5JB.js";
+} from "./chunk-P3PS3ZSN.js";
 import {
-  CcReleaseSyncStatuses,
-  CheckScopes,
-  CheckStatuses,
   CliError,
-  CodingAgents,
   EXIT_SYSTEM_ERROR,
   EXIT_USER_ERROR,
-  ProviderNames,
-  RunKinds,
-  RunStatuses,
-  SkillsClients,
   configExists,
   createApiClient,
-  determineAnswerMentioned,
-  effectiveDomains,
-  formatRunErrorOneLine,
   getConfigDir,
   getConfigPath,
   isEndpointMissing,
   loadConfig,
-  normalizeUrlPath,
-  notificationEventSchema,
   printCliError,
-  providerQuotaPolicySchema,
-  resolveProviderInput,
   saveConfig,
   saveConfigPatch,
-  skillsClientSchema,
   usageError
-} from "./chunk-24C7RMIS.js";
+} from "./chunk-5OYYYY4I.js";
 import {
+  MIN_TREND_POINTS,
   apiKeys,
   competitors,
   createClient,
   gaAiReferrals,
   gaTrafficSnapshots,
+  groupInsights,
+  isTrendBaseline,
   migrate,
   parseJsonColumn,
   projects,
   querySnapshots,
   runs
-} from "./chunk-ZCPZOVVE.js";
-import "./chunk-MLKGABMK.js";
+} from "./chunk-ZOJLW6WR.js";
+import {
+  CcReleaseSyncStatuses,
+  CheckScopes,
+  CheckStatuses,
+  CodingAgents,
+  ProviderNames,
+  RunKinds,
+  RunStatuses,
+  SkillsClients,
+  determineAnswerMentioned,
+  effectiveDomains,
+  formatRunErrorOneLine,
+  normalizeUrlPath,
+  notificationEventSchema,
+  providerQuotaPolicySchema,
+  resolveProviderInput,
+  skillsClientSchema
+} from "./chunk-D4YFX3X4.js";
 
 // src/cli.ts
 import { pathToFileURL } from "url";
@@ -577,7 +581,7 @@ function readStoredGroundingSources(rawResponse) {
   return result;
 }
 async function backfillInsightsCommand(project, opts) {
-  const { IntelligenceService } = await import("./intelligence-service-FNJTFSI3.js");
+  const { IntelligenceService } = await import("./intelligence-service-GV6CAJ3Q.js");
   const config = loadConfig();
   const db = createClient(config.database);
   migrate(db);
@@ -5206,6 +5210,48 @@ function formatNumber(value) {
   if (Math.abs(value) >= 1e3) return `${(value / 1e3).toFixed(1)}K`;
   return value.toLocaleString("en-US");
 }
+function summarizeQueryParams(params) {
+  const keys = Array.from(params.keys());
+  const total = keys.length;
+  if (total === 0) return "";
+  const noun = total === 1 ? "param" : "params";
+  const tag = inferAdSource(params);
+  return tag ? `${tag} \xB7 ${total} ${noun}` : `${total} tracking ${noun}`;
+}
+function inferAdSource(params) {
+  if (params.has("fbclid")) return "Facebook Ad";
+  if (params.has("gclid") || params.has("gbraid") || params.has("wbraid")) return "Google Ad";
+  if (params.has("msclkid")) return "Microsoft Ad";
+  if (params.has("ttclid")) return "TikTok Ad";
+  if (params.has("li_fat_id")) return "LinkedIn Ad";
+  if (params.has("twclid")) return "X / Twitter Ad";
+  if (params.has("epik")) return "Pinterest Ad";
+  for (const k of params.keys()) {
+    if (k.startsWith("hsa_")) return "Search Ad";
+  }
+  const src = params.get("utm_source");
+  const med = params.get("utm_medium");
+  if (src && med) return `${src} / ${med}`;
+  if (src) return `Source: ${src}`;
+  if (med) return `Medium: ${med}`;
+  return null;
+}
+function formatLandingPageHtml(raw) {
+  const value = raw ?? "";
+  const queryIdx = value.indexOf("?");
+  const path10 = queryIdx === -1 ? value : value.slice(0, queryIdx);
+  const query = queryIdx === -1 ? "" : value.slice(queryIdx + 1);
+  const pathHtml = `<span class="page-path">${escapeHtml(path10 || "/")}</span>`;
+  if (!query) return pathHtml;
+  let summary = "";
+  try {
+    summary = summarizeQueryParams(new URLSearchParams(query));
+  } catch {
+    summary = "tracking params";
+  }
+  if (!summary) return pathHtml;
+  return `${pathHtml}<span class="page-query" title="${escapeHtml(value)}">${escapeHtml(summary)}</span>`;
+}
 function formatDate(iso) {
   if (!iso) return "\u2014";
   try {
@@ -5344,6 +5390,9 @@ table.report-table th, table.report-table td {
   text-align: left;
   padding: 10px 12px;
   border-bottom: 1px solid ${COLORS.border};
+  vertical-align: top;
+  overflow-wrap: anywhere;
+  word-break: break-word;
 }
 table.report-table th {
   font-weight: 600;
@@ -5352,7 +5401,25 @@ table.report-table th {
   letter-spacing: 0.06em;
   font-size: 10px;
 }
-table.report-table td.numeric { text-align: right; font-variant-numeric: tabular-nums; }
+table.report-table td.numeric { text-align: right; font-variant-numeric: tabular-nums; white-space: nowrap; }
+table.report-table td.page-cell { max-width: 0; }
+table.report-table td.page-cell .page-path {
+  display: block;
+  font-family: ui-monospace, SFMono-Regular, 'SF Mono', Menlo, Consolas, monospace;
+  font-size: 12px;
+  color: ${COLORS.text};
+}
+table.report-table td.page-cell .page-query {
+  display: inline-block;
+  margin-top: 4px;
+  padding: 1px 8px;
+  font-size: 11px;
+  color: ${COLORS.textMuted};
+  background: ${COLORS.surface};
+  border: 1px solid ${COLORS.border};
+  border-radius: 999px;
+  cursor: help;
+}
 table.report-table td .badge {
   display: inline-block;
   padding: 2px 8px;
@@ -5601,15 +5668,19 @@ function renderCompetitorLandscape(report) {
   }
   const rows = competitors2.map((c) => {
     const tone = pressureTone(c.pressureLabel);
+    const pagesDisclosure = c.theirCitedPages.length > 0 ? `<details class="cited-pages"><summary>${c.theirCitedPages.length} cited URL${c.theirCitedPages.length > 1 ? "s" : ""}</summary>
+          <ul>${c.theirCitedPages.map((p) => `<li><a href="${escapeHtml(p.url)}">${escapeHtml(p.url)}</a> <span class="cited-for">${escapeHtml(p.citedFor.join(", "))}</span></li>`).join("")}</ul>
+        </details>` : "";
     return `<tr>
       <td>${escapeHtml(c.domain)}</td>
       <td><span class="badge tone-${tone}">${escapeHtml(c.pressureLabel)}</span></td>
       <td class="numeric">${c.citationCount} / ${c.totalCount}</td>
-      <td>${escapeHtml(c.citedKeywords.slice(0, 5).join(", "))}${c.citedKeywords.length > 5 ? "\u2026" : ""}</td>
+      <td class="numeric">${c.sharePct}%</td>
+      <td>${escapeHtml(c.citedKeywords.slice(0, 5).join(", "))}${c.citedKeywords.length > 5 ? "\u2026" : ""}${pagesDisclosure}</td>
     </tr>`;
   }).join("");
   const table = competitors2.length > 0 ? `<table class="report-table">
-        <thead><tr><th>Domain</th><th>Pressure</th><th>Citations</th><th>Cited keywords</th></tr></thead>
+        <thead><tr><th>Domain</th><th>Pressure</th><th>Citations</th><th class="numeric">SOV</th><th>Cited keywords</th></tr></thead>
         <tbody>${rows}</tbody>
       </table>` : renderEmpty("No competitors configured.");
   return section(
@@ -5741,6 +5812,19 @@ function renderGsc(report) {
     COLORS.accent,
     "Clicks over time"
   );
+  const crossoverBlocks = [];
+  if (gsc.trackedButNoGsc.length > 0) {
+    crossoverBlocks.push(`<div class="chart-card"><h3>AEO keywords without search demand</h3>
+      <p class="section-intro">Tracked AEO keywords with no GSC impressions in this window \u2014 review whether they represent real search demand.</p>
+      <ul>${gsc.trackedButNoGsc.map((k) => `<li>${escapeHtml(k)}</li>`).join("")}</ul>
+    </div>`);
+  }
+  if (gsc.gscButNotTracked.length > 0) {
+    crossoverBlocks.push(`<div class="chart-card"><h3>Search queries you should track</h3>
+      <p class="section-intro">GSC top queries (by impressions) that aren't tracked in your AEO project \u2014 candidates to add as keywords.</p>
+      <ul>${gsc.gscButNotTracked.map((q) => `<li>${escapeHtml(q)}</li>`).join("")}</ul>
+    </div>`);
+  }
   return section(
     { id: "gsc", eyebrow: "Section 5", title: "GSC Performance", intro: "Top queries, category breakdown, and traffic trend from Google Search Console." },
     `<div class="metric-grid">
@@ -5761,7 +5845,8 @@ function renderGsc(report) {
         <thead><tr><th>Category</th><th class="numeric">Clicks</th><th class="numeric">Imp.</th><th class="numeric">Share</th></tr></thead>
         <tbody>${breakdownRows}</tbody>
       </table>
-    </div>`
+    </div>
+    ${crossoverBlocks.join("\n")}`
   );
 }
 function renderGa(report) {
@@ -5774,7 +5859,7 @@ function renderGa(report) {
   }
   const pageRows = ga.topLandingPages.map((p) => `
     <tr>
-      <td>${escapeHtml(p.page)}</td>
+      <td class="page-cell">${formatLandingPageHtml(p.page)}</td>
       <td class="numeric">${formatNumber(p.sessions)}</td>
       <td class="numeric">${formatNumber(p.users)}</td>
       <td class="numeric">${formatNumber(p.organicSessions)}</td>
@@ -5864,7 +5949,7 @@ function renderAiReferrals(report) {
     </tr>`).join("");
   const pageRows = ai.topLandingPages.map((p) => `
     <tr>
-      <td>${escapeHtml(p.page)}</td>
+      <td class="page-cell">${formatLandingPageHtml(p.page)}</td>
       <td class="numeric">${formatNumber(p.sessions)}</td>
       <td class="numeric">${formatNumber(p.users)}</td>
     </tr>`).join("");
@@ -5941,6 +6026,12 @@ function renderCitationsTrend(report) {
       renderEmpty("Run multiple visibility sweeps to see a trend.")
     );
   }
+  if (isTrendBaseline(trend)) {
+    return section(
+      { id: "citations-trend", eyebrow: "Section 10", title: "Citations Over Time" },
+      renderEmpty(`Establishing baseline (${trend.length} of ${MIN_TREND_POINTS} runs collected). Trend will appear once more sweeps are recorded.`)
+    );
+  }
   const chart = renderLineChart(
     trend.map((t) => ({ x: t.date, y: t.citationRate, label: formatDate(t.date) })),
     COLORS.positive,
@@ -5972,15 +6063,17 @@ function renderInsights(report) {
       renderEmpty("No insights yet \u2014 run a visibility sweep to generate alerts.")
     );
   }
-  const rows = list.map((i) => {
+  const haveDeduped = list.every((i) => typeof i.instanceCount === "number");
+  const rows = (haveDeduped ? list.map((i) => ({ rep: i, count: i.instanceCount })) : groupInsights(list).map((g) => ({ rep: g.representative, count: g.count }))).map(({ rep: i, count }) => {
     const tone = severityTone(i.severity);
+    const countChip = count > 1 ? ` <span class="badge tone-neutral">\xD7 ${count}</span>` : "";
     return `<tr>
-      <td><span class="badge tone-${tone}">${escapeHtml(i.severity)}</span></td>
-      <td>${escapeHtml(i.title)}</td>
-      <td>${escapeHtml(i.keyword)}</td>
-      <td>${escapeHtml(i.provider)}</td>
-      <td>${i.recommendation ? escapeHtml(i.recommendation) : '<span class="cell-pending">\u2014</span>'}</td>
-    </tr>`;
+        <td><span class="badge tone-${tone}">${escapeHtml(i.severity)}</span></td>
+        <td>${escapeHtml(i.title)}${countChip}</td>
+        <td>${escapeHtml(i.keyword)}</td>
+        <td>${escapeHtml(i.provider)}</td>
+        <td>${i.recommendation ? escapeHtml(i.recommendation) : '<span class="cell-pending">\u2014</span>'}</td>
+      </tr>`;
   }).join("");
   return section(
     { id: "insights", eyebrow: "Section 11", title: "Insights & Alerts", intro: "Priority-ordered findings from the most recent runs." },
@@ -5990,11 +6083,40 @@ function renderInsights(report) {
     </table>`
   );
 }
+function renderOpportunities(report) {
+  const opps = report.contentOpportunities;
+  if (opps.length === 0) return "";
+  const rows = opps.slice(0, 10).map((o) => {
+    const ourPage = o.ourBestPage ? `<a href="${escapeHtml(o.ourBestPage.url)}">${escapeHtml(o.ourBestPage.url)}</a>` : '<span class="cell-not-cited">\u2014</span>';
+    const winning = o.winningCompetitor ? `<a href="${escapeHtml(o.winningCompetitor.url)}">${escapeHtml(o.winningCompetitor.domain)}</a>` : '<span class="cell-not-cited">\u2014</span>';
+    return `<tr>
+      <td>${escapeHtml(o.query)}</td>
+      <td><span class="badge tone-neutral">${escapeHtml(o.action)}</span></td>
+      <td class="numeric">${Math.round(o.score)}</td>
+      <td>${ourPage}</td>
+      <td>${winning}</td>
+      <td><span class="badge tone-neutral">${escapeHtml(o.demandSource)}</span></td>
+      <td><span class="badge tone-neutral">${escapeHtml(o.actionConfidence)}</span></td>
+    </tr>`;
+  }).join("");
+  return section(
+    {
+      id: "content-opportunities",
+      eyebrow: "Section 12",
+      title: "Content Opportunities",
+      intro: "Ranked, action-typed targets from the content recommendation engine. Top 10 shown."
+    },
+    `<table class="report-table">
+      <thead><tr><th>Query</th><th>Action</th><th class="numeric">Score</th><th>Our page</th><th>Winning competitor</th><th>Demand</th><th>Confidence</th></tr></thead>
+      <tbody>${rows}</tbody>
+    </table>`
+  );
+}
 function renderRecommendedNextSteps(report) {
   const steps = report.recommendedNextSteps;
   if (steps.length === 0) {
     return section(
-      { id: "recommended-next-steps", eyebrow: "Section 12", title: "Recommended Next Steps" },
+      { id: "recommended-next-steps", eyebrow: "Section 13", title: "Recommended Next Steps" },
       renderEmpty("No outstanding actions.")
     );
   }
@@ -6005,7 +6127,7 @@ function renderRecommendedNextSteps(report) {
       <span class="rationale">${escapeHtml(s.rationale)}</span>
     </div>`).join("");
   return section(
-    { id: "recommended-next-steps", eyebrow: "Section 12", title: "Recommended Next Steps" },
+    { id: "recommended-next-steps", eyebrow: "Section 13", title: "Recommended Next Steps" },
     `<div class="steps">${items}</div>`
   );
 }
@@ -6026,6 +6148,7 @@ function renderReportHtml(report, opts = {}) {
     renderIndexingHealth(report),
     renderCitationsTrend(report),
     renderInsights(report),
+    renderOpportunities(report),
     renderRecommendedNextSteps(report)
   ].join("\n");
   const json = escapeJsonForScript(JSON.stringify(report));

package/dist/index.js

@@ -1,11 +1,11 @@
 import {
   createServer
-} from "./chunk-P6D3O5JB.js";
+} from "./chunk-P3PS3ZSN.js";
 import {
   loadConfig
-} from "./chunk-24C7RMIS.js";
-import "./chunk-ZCPZOVVE.js";
-import "./chunk-MLKGABMK.js";
+} from "./chunk-5OYYYY4I.js";
+import "./chunk-ZOJLW6WR.js";
+import "./chunk-D4YFX3X4.js";
 export {
   createServer,
   loadConfig

package/dist/{intelligence-service-FNJTFSI3.js → intelligence-service-GV6CAJ3Q.js}

@@ -1,7 +1,7 @@
 import {
   IntelligenceService
-} from "./chunk-ZCPZOVVE.js";
-import "./chunk-MLKGABMK.js";
+} from "./chunk-ZOJLW6WR.js";
+import "./chunk-D4YFX3X4.js";
 export {
   IntelligenceService
 };

package/dist/mcp.js

@@ -2,8 +2,8 @@ import {
   CliError,
   canonryMcpTools,
   createApiClient
-} from "./chunk-24C7RMIS.js";
-import "./chunk-MLKGABMK.js";
+} from "./chunk-5OYYYY4I.js";
+import "./chunk-D4YFX3X4.js";
 
 // src/mcp/cli.ts
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ainyc/canonry",
-  "version": "3.3.8",
+  "version": "3.4.5",
   "type": "module",
   "description": "Agent-first open-source AEO operating platform - track how answer engines cite your domain",
   "license": "FSL-1.1-ALv2",
@@ -59,21 +59,21 @@
     "@types/node-cron": "^3.0.11",
     "tsup": "^8.5.1",
     "tsx": "^4.19.0",
-    "@ainyc/canonry-config": "0.0.0",
     "@ainyc/canonry-api-routes": "0.0.0",
+    "@ainyc/canonry-config": "0.0.0",
     "@ainyc/canonry-contracts": "0.0.0",
-    "@ainyc/canonry-intelligence": "0.0.0",
     "@ainyc/canonry-db": "0.0.0",
-    "@ainyc/canonry-integration-commoncrawl": "0.0.0",
     "@ainyc/canonry-integration-bing": "0.0.0",
+    "@ainyc/canonry-intelligence": "0.0.0",
     "@ainyc/canonry-integration-google": "0.0.0",
+    "@ainyc/canonry-integration-commoncrawl": "0.0.0",
     "@ainyc/canonry-integration-wordpress": "0.0.0",
-    "@ainyc/canonry-provider-cdp": "0.0.0",
     "@ainyc/canonry-provider-claude": "0.0.0",
-    "@ainyc/canonry-provider-gemini": "0.0.0",
-    "@ainyc/canonry-provider-local": "0.0.0",
+    "@ainyc/canonry-provider-cdp": "0.0.0",
     "@ainyc/canonry-provider-openai": "0.0.0",
-    "@ainyc/canonry-provider-perplexity": "0.0.0"
+    "@ainyc/canonry-provider-gemini": "0.0.0",
+    "@ainyc/canonry-provider-perplexity": "0.0.0",
+    "@ainyc/canonry-provider-local": "0.0.0"
   },
   "scripts": {
     "build": "tsx scripts/copy-agent-assets.ts && tsup && tsx build-web.ts",

package/dist/chunk-MLKGABMK.js

@@ -1,9 +0,0 @@
-var __defProp = Object.defineProperty;
-var __export = (target, all) => {
-  for (var name in all)
-    __defProp(target, name, { get: all[name], enumerable: true });
-};
-
-export {
-  __export
-};