aeorank 2.0.0 → 2.2.0

package/README.md

@@ -41,38 +41,90 @@ console.log(result.opportunities); // Prioritized improvements
 
 ## What It Checks
 
-AEORank evaluates 28 criteria across 4 categories that determine how AI engines (ChatGPT, Claude, Perplexity, Google AI Overviews) discover, parse, and cite your content:
-
-| # | Criterion | Weight | Category |
-|---|-----------|--------|----------|
-| 1 | llms.txt File | 8% | Discovery |
-| 2 | Schema.org Structured Data | 8% | Structure |
-| 3 | Q&A Content Format | 12% | Content |
-| 4 | Clean, Crawlable HTML | 8% | Structure |
-| 5 | Entity Authority & NAP Consistency | 8% | Authority |
-| 6 | robots.txt for AI Crawlers | 3% | Discovery |
-| 7 | Comprehensive FAQ Section | 8% | Content |
-| 8 | Original Data & Expert Analysis | 12% | Content |
-| 9 | Internal Linking Structure | 8% | Structure |
-| 10 | Semantic HTML5 & Accessibility | 4% | Structure |
-| 11 | Content Freshness Signals | 6% | Content |
-| 12 | Sitemap Completeness | 3% | Discovery |
-| 13 | RSS/Atom Feed | 2% | Discovery |
-| 14 | Table & List Extractability | 5% | Structure |
-| 15 | Definition Patterns | 4% | Content |
-| 16 | Direct Answer Paragraphs | 7% | Content |
-| 17 | Content Licensing & AI Permissions | 3% | Discovery |
-| 18 | Author & Expert Schema | 4% | Authority |
-| 19 | Fact & Data Density | 8% | Content |
-| 20 | Canonical URL Strategy | 2% | Structure |
-| 21 | Content Publishing Velocity | 3% | Content |
-| 22 | Schema Coverage & Depth | 2% | Structure |
-| 23 | Speakable Schema | 2% | Structure |
-| 24 | Query-Answer Alignment | 6% | Content |
-| 25 | Content Cannibalization | 5% | Content |
-| 26 | Visible Date Signal | 4% | Content |
-| 27 | **Topic Coherence** | **14%** | **Content** |
-| 28 | **Content Depth** | **6%** | **Content** |
+AEORank evaluates 28 criteria that determine how AI engines (ChatGPT, Claude, Perplexity, Google AI Overviews) discover, parse, and cite your content. Criteria are organized into three tiers by impact on real-world AI citations:
+
+### Scoring Tiers (by importance)
+
+**Content Substance (~55%)** - *Why* an AI engine would cite you:
+
+| Criterion | Weight | What it measures |
+|-----------|--------|------------------|
+| Topic Coherence | 14% | Blog content focus on core expertise vs scattered topics |
+| Original Data & Expert Analysis | 10% | Proprietary research, case studies, unique data points |
+| Content Depth | 7% | Article length, heading structure, deep vs thin pages |
+| Fact & Data Density | 6% | Specific numbers, statistics, data points per page |
+| Direct Answer Paragraphs | 5% | Concise answer paragraphs after question headings |
+| Q&A Content Format | 5% | Question-format headings (What, How, Why) with answers |
+| Query-Answer Alignment | 5% | Every question heading followed by a direct answer |
+| Comprehensive FAQ Section | 4% | Dedicated FAQ with FAQPage schema markup |
+
+**Content Organization (~30%)** - *How* easily AI can extract and trust your content:
+
+| Criterion | Weight | What it measures |
+|-----------|--------|------------------|
+| Entity Authority & NAP Consistency | 5% | Organization schema, consistent name/address/phone |
+| Internal Linking Structure | 4% | Topic clusters, breadcrumbs, reachability from homepage |
+| Content Freshness Signals | 4% | dateModified schema, visible dates, recent content |
+| Schema.org Structured Data | 3% | JSON-LD blocks (Organization, Article, FAQPage, etc.) |
+| Author & Expert Schema | 3% | Person schema with credentials and expertise |
+| Table & List Extractability | 3% | HTML tables with headers, ordered/unordered lists |
+| Definition Patterns | 2% | Clear "X is defined as..." patterns for key terms |
+| Visible Date Signal | 2% | Visible publication dates with `<time>` elements |
+| Semantic HTML5 & Accessibility | 2% | Semantic elements (main, article, nav), ARIA, lang |
+| Clean, Crawlable HTML | 2% | HTTPS, meta tags, proper heading hierarchy |
+
+**Technical Plumbing (~15%)** - *Whether* AI crawlers can find you (table stakes):
+
+| Criterion | Weight | What it measures |
+|-----------|--------|------------------|
+| Content Cannibalization | 2% | Overlapping pages competing for the same topic |
+| llms.txt File | 2% | /llms.txt with site description and key page URLs |
+| robots.txt for AI Crawlers | 2% | GPTBot, ClaudeBot, PerplexityBot access |
+| Content Publishing Velocity | 2% | Regular publishing cadence in sitemap |
+| Content Licensing & AI Permissions | 2% | /ai.txt file, license schema for AI usage |
+| Sitemap Completeness | 1% | sitemap.xml with lastmod dates |
+| Canonical URL Strategy | 1% | Self-referencing canonical tags |
+| RSS/Atom Feed | 1% | RSS feed linked from homepage |
+| Schema Coverage & Depth | 1% | Schema markup on inner pages, not just homepage |
+| Speakable Schema | 1% | SpeakableSpecification for voice assistants |
+
+> **Coherence Gate:** Sites with topic coherence below 6/10 are score-capped regardless of technical perfection. A scattered site with perfect robots.txt, llms.txt, and schema will score lower than a focused site with mediocre technical implementation.
+
+<details>
+<summary>All 28 criteria (numbered list)</summary>
+
+| # | Criterion | Weight | Tier |
+|---|-----------|--------|------|
+| 1 | llms.txt File | 2% | Plumbing |
+| 2 | Schema.org Structured Data | 3% | Organization |
+| 3 | Q&A Content Format | 5% | Substance |
+| 4 | Clean, Crawlable HTML | 2% | Organization |
+| 5 | Entity Authority & NAP Consistency | 5% | Organization |
+| 6 | robots.txt for AI Crawlers | 2% | Plumbing |
+| 7 | Comprehensive FAQ Section | 4% | Substance |
+| 8 | Original Data & Expert Analysis | 10% | Substance |
+| 9 | Internal Linking Structure | 4% | Organization |
+| 10 | Semantic HTML5 & Accessibility | 2% | Organization |
+| 11 | Content Freshness Signals | 4% | Organization |
+| 12 | Sitemap Completeness | 1% | Plumbing |
+| 13 | RSS/Atom Feed | 1% | Plumbing |
+| 14 | Table & List Extractability | 3% | Organization |
+| 15 | Definition Patterns | 2% | Organization |
+| 16 | Direct Answer Paragraphs | 5% | Substance |
+| 17 | Content Licensing & AI Permissions | 2% | Plumbing |
+| 18 | Author & Expert Schema | 3% | Organization |
+| 19 | Fact & Data Density | 6% | Substance |
+| 20 | Canonical URL Strategy | 1% | Plumbing |
+| 21 | Content Publishing Velocity | 2% | Plumbing |
+| 22 | Schema Coverage & Depth | 1% | Plumbing |
+| 23 | Speakable Schema | 1% | Plumbing |
+| 24 | Query-Answer Alignment | 5% | Substance |
+| 25 | Content Cannibalization | 2% | Plumbing |
+| 26 | Visible Date Signal | 2% | Organization |
+| 27 | Topic Coherence | 14% | Substance |
+| 28 | Content Depth | 7% | Substance |
+
+</details>
 
 ## CLI Options
 
@@ -296,9 +348,26 @@ console.log(crawlResult.discoveredUrls.length); // Total URLs found
 
 AEORank scores each individual page (0-100) against the 14 criteria that apply at page level. Instead of only seeing "your site scores 62," you get "your /about page scores 45, your /blog/guide scores 78."
 
-The 14 per-page criteria: Schema.org Structured Data, Q&A Content Format, Clean Crawlable HTML, FAQ Section Content, Original Data & Expert Content, Query-Answer Alignment, Content Freshness Signals, Table & List Extractability, Direct Answer Paragraphs, Semantic HTML5 & Accessibility, Fact & Data Density, Definition Patterns, Canonical URL Strategy, Visible Date Signal.
-
-The remaining 14 criteria (llms.txt, robots.txt, sitemap, RSS, entity consistency, internal linking, content licensing, author schema, content velocity, schema coverage, speakable schema, content cannibalization, topic coherence, content depth) are site-level only.
+The 14 per-page criteria follow the same substance-first weighting as the site-level score:
+
+| Tier | Per-Page Criteria | Weight |
+|------|-------------------|--------|
+| **Substance** | Original Data & Expert Content | 10% |
+| | Fact & Data Density | 6% |
+| | Direct Answer Paragraphs | 5% |
+| | Q&A Content Format | 5% |
+| | Query-Answer Alignment | 5% |
+| | FAQ Section Content | 4% |
+| **Organization** | Content Freshness Signals | 4% |
+| | Schema.org Structured Data | 3% |
+| | Table & List Extractability | 3% |
+| | Definition Patterns | 2% |
+| | Visible Date Signal | 2% |
+| | Semantic HTML5 & Accessibility | 2% |
+| | Clean, Crawlable HTML | 2% |
+| **Plumbing** | Canonical URL Strategy | 1% |
+
+The remaining 14 criteria are site-level only: llms.txt, robots.txt, sitemap, RSS, entity consistency, internal linking, content licensing, author schema, content velocity, schema coverage, speakable schema, content cannibalization, topic coherence, and content depth.
 
 ### CLI Output
 

package/dist/browser.d.ts

@@ -376,7 +376,7 @@ declare function analyzeAllPages(siteData: SiteData): PageReview[];
 
 /**
  * Per-page AEO scoring.
- * Evaluates 14 of 26 criteria that apply at individual page level.
+ * Evaluates 14 of 28 criteria that apply at individual page level.
  * Produces a 0-100 AEO score per page.
  */
 

package/dist/browser.js

@@ -2069,40 +2069,58 @@ function auditSiteFromData(data) {
 
 // src/scoring.ts
 var WEIGHTS = {
-  // ─── Core Content (high weight - these determine real AI citation quality) ──
-  qa_content_format: 0.12,
-  original_data: 0.12,
+  // ─── Content Substance (~55%) ─────────────────────────────────────────────
+  // WHY an AI engine would cite you. These drive citation quality directly.
   topic_coherence: 0.14,
-  // NEW v2.0: biggest predictor of AI citation quality
-  fact_density: 0.08,
-  direct_answer_density: 0.07,
-  content_depth: 0.06,
-  // NEW v2.0: substantive content vs thin pages
-  // ─── Structure & Discovery (medium weight - technical readiness) ────────────
-  schema_markup: 0.08,
-  llms_txt: 0.08,
-  clean_html: 0.08,
-  entity_consistency: 0.08,
-  faq_section: 0.08,
-  internal_linking: 0.08,
-  // ─── Content Signals (moderate weight) ──────────────────────────────────────
-  content_freshness: 0.06,
-  table_list_extractability: 0.05,
-  query_answer_alignment: 0.06,
-  definition_patterns: 0.04,
-  author_schema_depth: 0.04,
-  content_cannibalization: 0.05,
-  visible_date_signal: 0.04,
-  semantic_html: 0.04,
-  // ─── Plumbing (low weight - nice to have but not what drives citations) ─────
-  robots_txt: 0.03,
-  sitemap_completeness: 0.03,
-  content_velocity: 0.03,
-  rss_feed: 0.02,
-  content_licensing: 0.03,
-  canonical_url: 0.02,
-  schema_coverage: 0.02,
-  speakable_schema: 0.02
+  // Topical authority - THE gating signal
+  original_data: 0.1,
+  // Unique value AI can't find elsewhere
+  content_depth: 0.07,
+  // Comprehensive vs thin coverage
+  fact_density: 0.06,
+  // Information density per page
+  direct_answer_density: 0.05,
+  // Direct answers to queries
+  qa_content_format: 0.05,
+  // Answer-shaped content structure
+  query_answer_alignment: 0.05,
+  // Relevance to actual AI queries
+  faq_section: 0.04,
+  // Structured Q&A pairs
+  // ─── Content Organization (~30%) ──────────────────────────────────────────
+  // HOW easily AI engines can extract and trust your content.
+  entity_consistency: 0.05,
+  // Brand authority and E-E-A-T
+  internal_linking: 0.04,
+  // Site structure and topic clusters
+  content_freshness: 0.04,
+  // Recency signals
+  schema_markup: 0.03,
+  // Structured data for discovery
+  author_schema_depth: 0.03,
+  // Expert attribution
+  table_list_extractability: 0.03,
+  // Extractable structured data
+  definition_patterns: 0.02,
+  // Clear definitions
+  visible_date_signal: 0.02,
+  // Publication date trust
+  semantic_html: 0.02,
+  // Clean semantic structure
+  clean_html: 0.02,
+  // Parseable markup
+  // ─── Technical Plumbing (~15%) ────────────────────────────────────────────
+  // WHETHER AI crawlers can find you. Table stakes with diminishing returns.
+  content_cannibalization: 0.02,
+  llms_txt: 0.02,
+  robots_txt: 0.02,
+  content_velocity: 0.02,
+  content_licensing: 0.02,
+  sitemap_completeness: 0.01,
+  canonical_url: 0.01,
+  rss_feed: 0.01,
+  schema_coverage: 0.01,
+  speakable_schema: 0.01
 };
 function calculateOverallScore(criteria) {
   let totalWeight = 0;
@@ -2113,7 +2131,13 @@ function calculateOverallScore(criteria) {
     totalWeight += weight;
   }
   if (totalWeight === 0) return 0;
-  return Math.round(weightedSum / totalWeight);
+  let score = Math.round(weightedSum / totalWeight);
+  const coherence = criteria.find((c) => c.criterion === "topic_coherence");
+  if (coherence && coherence.score < 6) {
+    const cap2 = 35 + coherence.score * 5;
+    score = Math.min(score, cap2);
+  }
+  return score;
 }
 
 // src/scorecard-builder.ts
@@ -2231,32 +2255,37 @@ function buildDetailedFindings(results) {
 
 // src/narrative-generator.ts
 var CRITERION_WEIGHTS = {
-  llms_txt: 0.1,
-  schema_markup: 0.15,
-  qa_content_format: 0.15,
-  clean_html: 0.1,
-  entity_consistency: 0.1,
-  robots_txt: 0.05,
-  faq_section: 0.1,
+  // Content Substance (~55%)
+  topic_coherence: 0.14,
   original_data: 0.1,
-  internal_linking: 0.1,
-  semantic_html: 0.05,
-  content_freshness: 0.07,
-  sitemap_completeness: 0.05,
-  rss_feed: 0.03,
-  table_list_extractability: 0.07,
-  definition_patterns: 0.04,
-  direct_answer_density: 0.07,
-  content_licensing: 0.04,
-  author_schema_depth: 0.04,
-  fact_density: 0.05,
-  canonical_url: 0.04,
-  content_velocity: 0.03,
-  schema_coverage: 0.03,
-  speakable_schema: 0.03,
-  query_answer_alignment: 0.08,
-  content_cannibalization: 0.05,
-  visible_date_signal: 0.04
+  content_depth: 0.07,
+  fact_density: 0.06,
+  direct_answer_density: 0.05,
+  qa_content_format: 0.05,
+  query_answer_alignment: 0.05,
+  faq_section: 0.04,
+  // Content Organization (~30%)
+  entity_consistency: 0.05,
+  internal_linking: 0.04,
+  content_freshness: 0.04,
+  schema_markup: 0.03,
+  author_schema_depth: 0.03,
+  table_list_extractability: 0.03,
+  definition_patterns: 0.02,
+  visible_date_signal: 0.02,
+  semantic_html: 0.02,
+  clean_html: 0.02,
+  // Technical Plumbing (~15%)
+  content_cannibalization: 0.02,
+  llms_txt: 0.02,
+  robots_txt: 0.02,
+  content_velocity: 0.02,
+  content_licensing: 0.02,
+  sitemap_completeness: 0.01,
+  canonical_url: 0.01,
+  rss_feed: 0.01,
+  schema_coverage: 0.01,
+  speakable_schema: 0.01
 };
 var OPPORTUNITY_TEMPLATES = {
   llms_txt: {
@@ -2388,6 +2417,16 @@ var OPPORTUNITY_TEMPLATES = {
     name: "Add Visible Date Signals",
     effort: "Low",
     description: "Display publication/modification dates visibly using <time> elements and add datePublished/dateModified to JSON-LD schema."
+  },
+  topic_coherence: {
+    name: "Focus Content on Core Topics",
+    effort: "High",
+    description: 'Ensure blog content consistently covers your core expertise areas rather than scattering across unrelated topics. AI engines build authority models - a site about "Medicare coverage" that also publishes about humidifiers and groceries dilutes its topical authority.'
+  },
+  content_depth: {
+    name: "Increase Content Depth",
+    effort: "Medium",
+    description: "Expand articles to 1000+ words with structured H2/H3 sections, comparison tables, and expert analysis. Thin content (under 300 words) is rarely cited by AI engines. Deep, well-structured articles demonstrate expertise."
   }
 };
 function calculateImpact(score, weight, effort) {
@@ -2509,7 +2548,7 @@ function generatePitchNumbers(score, rawData, scorecard) {
   const passing = scorecard.filter((s) => s.score >= 7).length;
   metrics.push({
     metric: "Criteria Passing",
-    value: `${passing}/26`,
+    value: `${passing}/28`,
     significance: passing >= 18 ? "Excellent coverage across AEO dimensions" : passing >= 12 ? "Good foundation with room to improve remaining criteria" : `${26 - passing} criteria need attention for full AI visibility`
   });
   return metrics;
@@ -2616,6 +2655,38 @@ function extractNavLinks(html, domain) {
   }
   return Array.from(paths);
 }
+function extractAllInternalLinks(html, domain, limit = 30) {
+  const cleanDomain = domain.replace(/^www\./, "").toLowerCase();
+  const hrefMatches = html.match(/href="([^"#]*)"/gi) || [];
+  const paths = /* @__PURE__ */ new Set();
+  for (const match of hrefMatches) {
+    const href = match.match(/href="([^"#]*)"/i)?.[1];
+    if (!href) continue;
+    let path;
+    if (href.startsWith("/")) {
+      path = href;
+    } else if (href.startsWith("http")) {
+      try {
+        const url = new URL(href);
+        const linkDomain = url.hostname.replace(/^www\./, "").toLowerCase();
+        if (linkDomain !== cleanDomain) continue;
+        path = url.pathname;
+      } catch {
+        continue;
+      }
+    } else {
+      continue;
+    }
+    path = path.replace(/\/+$/, "") || "/";
+    if (path === "/") continue;
+    if (path.includes("#") || path.includes("?")) continue;
+    if (/\.(js|css|png|jpg|jpeg|gif|svg|ico|pdf|xml|txt|zip|woff|woff2|ttf|eot|mp4|webm|mp3)$/i.test(path)) continue;
+    if (/^\/(api|wp-admin|wp-includes|wp-json|static|assets|_next|auth|login|signup|sign-up|register|cart|checkout|account|admin|cdn-cgi|feed|rss)\b/i.test(path)) continue;
+    if (path.startsWith("mailto:") || path.startsWith("tel:")) continue;
+    paths.add(path);
+  }
+  return Array.from(paths).sort((a, b) => a.split("/").length - b.split("/").length || a.localeCompare(b)).slice(0, limit);
+}
 function extractContentPagesFromSitemap(sitemapText, domain, limit = 6) {
   const urlBlocks = sitemapText.match(/<url>([\s\S]*?)<\/url>/gi) || [];
   const cleanDomain = domain.replace(/^www\./, "").toLowerCase();
@@ -2683,6 +2754,16 @@ async function fetchMultiPageData(siteData, options) {
       if (!existingUrls.has(url)) urlsToFetch.set(url, "content");
     }
   }
+  const hasBlogSample = (siteData.blogSample?.length ?? 0) > 3;
+  if (!hasBlogSample) {
+    const allPaths = extractAllInternalLinks(siteData.homepage.text, siteData.domain, 30);
+    for (const path of allPaths) {
+      const url = `${baseUrl}${path}`;
+      if (!existingUrls.has(url) && !urlsToFetch.has(url)) {
+        urlsToFetch.set(url, "content");
+      }
+    }
+  }
   const entries = Array.from(urlsToFetch.entries());
   if (entries.length === 0) return 0;
   const results = await Promise.all(entries.map(([url]) => fetchPage(url, timeoutMs)));
@@ -2701,20 +2782,23 @@ async function fetchMultiPageData(siteData, options) {
 
 // src/page-scorer.ts
 var PAGE_CRITERIA = {
-  schema_markup: { weight: 0.15, label: "Schema.org Structured Data" },
-  qa_content_format: { weight: 0.15, label: "Q&A Content Format" },
-  clean_html: { weight: 0.1, label: "Clean, Crawlable HTML" },
-  faq_section: { weight: 0.1, label: "FAQ Section Content" },
+  // Content Substance
   original_data: { weight: 0.1, label: "Original Data & Expert Content" },
-  query_answer_alignment: { weight: 0.08, label: "Query-Answer Alignment" },
-  content_freshness: { weight: 0.07, label: "Content Freshness Signals" },
-  table_list_extractability: { weight: 0.07, label: "Table & List Extractability" },
-  direct_answer_density: { weight: 0.07, label: "Direct Answer Paragraphs" },
-  semantic_html: { weight: 0.05, label: "Semantic HTML5 & Accessibility" },
-  fact_density: { weight: 0.05, label: "Fact & Data Density" },
-  definition_patterns: { weight: 0.04, label: "Definition Patterns" },
-  canonical_url: { weight: 0.04, label: "Canonical URL Strategy" },
-  visible_date_signal: { weight: 0.04, label: "Visible Date Signal" }
+  fact_density: { weight: 0.06, label: "Fact & Data Density" },
+  direct_answer_density: { weight: 0.05, label: "Direct Answer Paragraphs" },
+  qa_content_format: { weight: 0.05, label: "Q&A Content Format" },
+  query_answer_alignment: { weight: 0.05, label: "Query-Answer Alignment" },
+  faq_section: { weight: 0.04, label: "FAQ Section Content" },
+  // Content Organization
+  content_freshness: { weight: 0.04, label: "Content Freshness Signals" },
+  schema_markup: { weight: 0.03, label: "Schema.org Structured Data" },
+  table_list_extractability: { weight: 0.03, label: "Table & List Extractability" },
+  definition_patterns: { weight: 0.02, label: "Definition Patterns" },
+  visible_date_signal: { weight: 0.02, label: "Visible Date Signal" },
+  semantic_html: { weight: 0.02, label: "Semantic HTML5 & Accessibility" },
+  clean_html: { weight: 0.02, label: "Clean, Crawlable HTML" },
+  // Technical Plumbing
+  canonical_url: { weight: 0.01, label: "Canonical URL Strategy" }
 };
 function extractJsonLdBlocks(html) {
   const blocks = [];
@@ -3484,32 +3568,37 @@ function buildLinkGraph(pages, domain, homepageUrl) {
 
 // src/fix-engine.ts
 var CRITERION_WEIGHTS2 = {
-  llms_txt: 0.1,
-  schema_markup: 0.15,
-  qa_content_format: 0.15,
-  clean_html: 0.1,
-  entity_consistency: 0.1,
-  robots_txt: 0.05,
-  faq_section: 0.1,
+  // Content Substance (~55%)
+  topic_coherence: 0.14,
   original_data: 0.1,
-  internal_linking: 0.1,
-  semantic_html: 0.05,
-  content_freshness: 0.07,
-  sitemap_completeness: 0.05,
-  rss_feed: 0.03,
-  table_list_extractability: 0.07,
-  definition_patterns: 0.04,
-  direct_answer_density: 0.07,
-  content_licensing: 0.04,
-  author_schema_depth: 0.04,
-  fact_density: 0.05,
-  canonical_url: 0.04,
-  content_velocity: 0.03,
-  schema_coverage: 0.03,
-  speakable_schema: 0.03,
-  query_answer_alignment: 0.08,
-  content_cannibalization: 0.05,
-  visible_date_signal: 0.04
+  content_depth: 0.07,
+  fact_density: 0.06,
+  direct_answer_density: 0.05,
+  qa_content_format: 0.05,
+  query_answer_alignment: 0.05,
+  faq_section: 0.04,
+  // Content Organization (~30%)
+  entity_consistency: 0.05,
+  internal_linking: 0.04,
+  content_freshness: 0.04,
+  schema_markup: 0.03,
+  author_schema_depth: 0.03,
+  table_list_extractability: 0.03,
+  definition_patterns: 0.02,
+  visible_date_signal: 0.02,
+  semantic_html: 0.02,
+  clean_html: 0.02,
+  // Technical Plumbing (~15%)
+  content_cannibalization: 0.02,
+  llms_txt: 0.02,
+  robots_txt: 0.02,
+  content_velocity: 0.02,
+  content_licensing: 0.02,
+  sitemap_completeness: 0.01,
+  canonical_url: 0.01,
+  rss_feed: 0.01,
+  schema_coverage: 0.01,
+  speakable_schema: 0.01
 };
 var PHASE_CONFIG = [
   {
@@ -3532,7 +3621,9 @@ var PHASE_CONFIG = [
       "content_freshness",
       "table_list_extractability",
       "query_answer_alignment",
-      "visible_date_signal"
+      "visible_date_signal",
+      "topic_coherence",
+      "content_depth"
     ]
   },
   {
@@ -4436,6 +4527,55 @@ Summarization: yes`,
       affectedPages: affected,
       pageCount: affected?.length
     }];
+  },
+  topic_coherence: (c) => {
+    if (c.score >= 10) return [];
+    const impact = impactFromScore(c.score);
+    const effort = effortForCriterion("topic_coherence", c.score);
+    return [{
+      id: "fix-topic-coherence",
+      criterion: c.criterion_label,
+      criterionId: c.criterion,
+      title: "Focus blog content on core expertise",
+      description: "Ensure blog content consistently covers your core topic areas. Scattered content across unrelated topics weakens AI engine authority signals.",
+      impact,
+      effort: effort === "trivial" ? "low" : effort,
+      impactScore: 0,
+      category: "content",
+      steps: [
+        "Identify 2-3 core expertise areas your brand is known for",
+        "Audit existing blog posts and remove or consolidate off-topic content",
+        "Create a content calendar focused on core topics",
+        "Use topic clusters: pillar pages linking to supporting articles within the same niche"
+      ],
+      successCriteria: "80%+ of blog content covers core expertise areas with consistent topic focus"
+    }];
+  },
+  content_depth: (c, pages) => {
+    if (c.score >= 10) return [];
+    const impact = impactFromScore(c.score);
+    const effort = effortForCriterion("content_depth", c.score);
+    const affected = getAffectedPages("content_depth", pages);
+    return [{
+      id: "fix-content-depth",
+      criterion: c.criterion_label,
+      criterionId: c.criterion,
+      title: "Increase content depth and structure",
+      description: "Expand thin content with more detail, examples, and structured sections. AI engines prefer comprehensive articles with clear heading hierarchies.",
+      impact,
+      effort: effort === "trivial" ? "low" : effort,
+      impactScore: 0,
+      category: "content",
+      steps: [
+        "Aim for 1000+ words per article with expert analysis and examples",
+        "Use H2/H3 subheadings every 200-300 words for clear structure",
+        "Add comparison tables, numbered steps, and data points",
+        "Remove or expand thin pages (under 300 words) that dilute site quality"
+      ],
+      successCriteria: "Average article length exceeds 1000 words with 5+ subheadings per page",
+      affectedPages: affected,
+      pageCount: affected?.length
+    }];
   }
 };
 function generateFixPlan(domain, overallScore, criteria, pagesReviewed, linkGraph) {