@rankcli/agent-runtime 0.0.14 → 0.0.15

package/dist/index.js

@@ -239,7 +239,7 @@ async function crawlUrl(params) {
 async function extractMeta(params) {
   const { html, url } = params;
   try {
-    const $ = cheerio62.load(html);
+    const $ = cheerio63.load(html);
     const meta = {
       title: $("title").text().trim() || void 0,
       description: $('meta[name="description"]').attr("content")?.trim(),
@@ -284,7 +284,7 @@ async function extractMeta(params) {
 async function analyzeHeadings(params) {
   const { html } = params;
   try {
-    const $ = cheerio62.load(html);
+    const $ = cheerio63.load(html);
     const headings = [];
     $("h1, h2, h3, h4, h5, h6").each((_, el) => {
       const tag = el.tagName.toLowerCase();
@@ -305,7 +305,7 @@ async function analyzeHeadings(params) {
 async function extractImages2(params) {
   const { html } = params;
   try {
-    const $ = cheerio62.load(html);
+    const $ = cheerio63.load(html);
     const images = [];
     $("img").each((_, el) => {
       images.push({
@@ -327,7 +327,7 @@ async function extractImages2(params) {
 async function extractLinks3(params) {
   const { html, baseUrl } = params;
   try {
-    const $ = cheerio62.load(html);
+    const $ = cheerio63.load(html);
     const links = [];
     const baseHostname = new URL(baseUrl).hostname;
     $("a[href]").each((_, el) => {
@@ -362,7 +362,7 @@ async function extractLinks3(params) {
 async function extractSchema2(params) {
   const { html } = params;
   try {
-    const $ = cheerio62.load(html);
+    const $ = cheerio63.load(html);
     const schemas = [];
     $('script[type="application/ld+json"]').each((_, el) => {
       try {
@@ -431,7 +431,7 @@ async function checkSitemap2(params) {
           timeout: 1e4
         });
         if (response.status === 200 && response.data.includes("<?xml")) {
-          const $ = cheerio62.load(response.data, { xmlMode: true });
+          const $ = cheerio63.load(response.data, { xmlMode: true });
           const urlCount = $("url").length || $("sitemap").length;
           return {
             success: true,
@@ -460,12 +460,12 @@ async function checkSitemap2(params) {
     };
   }
 }
-var cheerio62;
+var cheerio63;
 var init_crawl = __esm({
   "src/tools/crawl.ts"() {
     "use strict";
     init_http();
-    cheerio62 = __toESM(require("cheerio"));
+    cheerio63 = __toESM(require("cheerio"));
   }
 });
 
@@ -862,7 +862,7 @@ function analyzeRobotsTxtForAI(robotsTxt) {
   return { allowed, blocked, recommendations };
 }
 function detectRenderingMode(html) {
-  const $ = cheerio63.load(html);
+  const $ = cheerio64.load(html);
   const signals = [];
   const hasNextData = html.includes("__NEXT_DATA__");
   const hasNuxtData = html.includes("__NUXT__");
@@ -903,7 +903,7 @@ function detectRenderingMode(html) {
   };
 }
 function analyzeContentStructure(html) {
-  const $ = cheerio63.load(html);
+  const $ = cheerio64.load(html);
   const jsonLdScripts = $('script[type="application/ld+json"]');
   let hasStructuredData = jsonLdScripts.length > 0;
   let hasFAQSchema = false;
@@ -953,7 +953,7 @@ function analyzeContentStructure(html) {
   };
 }
 function analyzeCitationReadiness(html) {
-  const $ = cheerio63.load(html);
+  const $ = cheerio64.load(html);
   const bodyText = $("body").text();
   const hasCitations = $('cite, blockquote, [class*="citation"], [class*="reference"]').length > 0 || /\[\d+\]|\(\d{4}\)/.test(bodyText);
   const externalLinks = $('a[href^="http"]').filter((_, el) => {
@@ -986,7 +986,7 @@ function analyzeCitationReadiness(html) {
   };
 }
 function analyzeEntityExtraction(html) {
-  const $ = cheerio63.load(html);
+  const $ = cheerio64.load(html);
   const bodyText = $("body").text();
   const definedTerms = [];
   $("dfn, abbr[title]").each((_, el) => {
@@ -1022,7 +1022,7 @@ function analyzeEntityExtraction(html) {
   };
 }
 function calculateLLMSignals(structure, citation, entity, html) {
-  const $ = cheerio63.load(html);
+  const $ = cheerio64.load(html);
   let contentClarity = 0;
   if (structure.headingHierarchy === "good") contentClarity += 30;
   else if (structure.headingHierarchy === "needs-work") contentClarity += 15;
@@ -1328,11 +1328,11 @@ Allow: /
 Sitemap: ${siteUrl}/sitemap.xml
 `;
 }
-var cheerio63, AI_CRAWLERS, AI_CRAWLERS_INFO;
+var cheerio64, AI_CRAWLERS, AI_CRAWLERS_INFO;
 var init_geo_analyzer = __esm({
   "src/analyzers/geo-analyzer.ts"() {
     "use strict";
-    cheerio63 = __toESM(require("cheerio"));
+    cheerio64 = __toESM(require("cheerio"));
     AI_CRAWLERS = {
       // OpenAI
       GPTBot: { userAgent: "GPTBot", company: "OpenAI", purpose: "ChatGPT training & browsing" },
@@ -1691,7 +1691,7 @@ function generateCWVIssues(lcp, fidInp, cls, ttfb, url) {
   return issues;
 }
 function analyzeCoreWebVitals(html, url, headers) {
-  const $ = cheerio64.load(html);
+  const $ = cheerio65.load(html);
   const lcp = analyzeLCP(html, $);
   const fidInp = analyzeFID_INP(html, $);
   const cls = analyzeCLS(html, $);
@@ -1736,11 +1736,11 @@ function analyzeCoreWebVitals(html, url, headers) {
     issues
   };
 }
-var cheerio64;
+var cheerio65;
 var init_core_web_vitals_analyzer = __esm({
   "src/analyzers/core-web-vitals-analyzer.ts"() {
     "use strict";
-    cheerio64 = __toESM(require("cheerio"));
+    cheerio65 = __toESM(require("cheerio"));
   }
 });
 
@@ -2075,7 +2075,7 @@ function validateSchema(data, type) {
   };
 }
 function analyzeStructuredData2(html, url) {
-  const $ = cheerio65.load(html);
+  const $ = cheerio66.load(html);
   const schemas = [];
   const issues = [];
   const recommendations = [];
@@ -2339,11 +2339,11 @@ function generateSchemaTemplate(pageType, options) {
   }
   return JSON.stringify(result, null, 2);
 }
-var cheerio65, SCHEMA_REQUIREMENTS;
+var cheerio66, SCHEMA_REQUIREMENTS;
 var init_structured_data_analyzer = __esm({
   "src/analyzers/structured-data-analyzer.ts"() {
     "use strict";
-    cheerio65 = __toESM(require("cheerio"));
+    cheerio66 = __toESM(require("cheerio"));
     SCHEMA_REQUIREMENTS = {
       "Organization": {
         required: ["name", "url"],
@@ -2459,7 +2459,7 @@ function getImageFormat2(src) {
   }
 }
 function analyzeImages3(html, url) {
-  const $ = cheerio66.load(html);
+  const $ = cheerio67.load(html);
   const issues = [];
   const recommendations = [];
   let score = 100;
@@ -2677,11 +2677,11 @@ function generateResponsiveImage(options) {
   />
 </picture>`;
 }
-var cheerio66, MODERN_FORMATS3, LEGACY_FORMATS2, MAX_RECOMMENDED_DIMENSION;
+var cheerio67, MODERN_FORMATS3, LEGACY_FORMATS2, MAX_RECOMMENDED_DIMENSION;
 var init_image_optimization_analyzer = __esm({
   "src/analyzers/image-optimization-analyzer.ts"() {
     "use strict";
-    cheerio66 = __toESM(require("cheerio"));
+    cheerio67 = __toESM(require("cheerio"));
     MODERN_FORMATS3 = ["webp", "avif"];
     LEGACY_FORMATS2 = ["jpg", "jpeg", "png", "gif", "bmp"];
     MAX_RECOMMENDED_DIMENSION = 2e3;
@@ -2722,7 +2722,7 @@ function analyzeAnchorText2(text) {
   };
 }
 function analyzeInternalLinking(html, url) {
-  const $ = cheerio67.load(html);
+  const $ = cheerio68.load(html);
   const issues = [];
   const recommendations = [];
   let score = 100;
@@ -2961,11 +2961,11 @@ function suggestInternalLinks(content, availablePages) {
   }
   return suggestions.sort((a, b) => b.relevance - a.relevance).filter((s, i, arr) => arr.findIndex((x) => x.suggestedUrl === s.suggestedUrl) === i).slice(0, 10);
 }
-var cheerio67, GENERIC_ANCHOR_TEXTS;
+var cheerio68, GENERIC_ANCHOR_TEXTS;
 var init_internal_linking_analyzer = __esm({
   "src/analyzers/internal-linking-analyzer.ts"() {
     "use strict";
-    cheerio67 = __toESM(require("cheerio"));
+    cheerio68 = __toESM(require("cheerio"));
     GENERIC_ANCHOR_TEXTS = [
       "click here",
       "read more",
@@ -3159,7 +3159,7 @@ function analyzeMobileSpecific($) {
   };
 }
 function analyzeMobileSEO(html, url) {
-  const $ = cheerio68.load(html);
+  const $ = cheerio69.load(html);
   const issues = [];
   const recommendations = [];
   let score = 100;
@@ -3290,11 +3290,11 @@ function analyzeMobileSEO(html, url) {
     recommendations
   };
 }
-var cheerio68;
+var cheerio69;
 var init_mobile_seo_analyzer = __esm({
   "src/analyzers/mobile-seo-analyzer.ts"() {
     "use strict";
-    cheerio68 = __toESM(require("cheerio"));
+    cheerio69 = __toESM(require("cheerio"));
   }
 });
 
@@ -4443,6 +4443,24 @@ var ISSUE_DEFINITIONS = {
     impact: "Your content will not be used for Bard/Gemini AI training (regular search unaffected).",
     howToFix: 'Remove "User-agent: Google-Extended Disallow: /" if you want Google AI visibility.'
   },
+  CLOUDFLARE_AI_CRAWLER_GATE_AMBIGUOUS: {
+    code: "CLOUDFLARE_AI_CRAWLER_GATE_AMBIGUOUS",
+    severity: "warning",
+    category: "ai-readiness",
+    title: "No explicit AI crawler rules on a Cloudflare-fronted site",
+    description: 'This site appears to be served through Cloudflare but robots.txt has no explicit Allow/Disallow rules for AI crawlers. Cloudflare blocks "mixed-use" AI crawlers by default on ad-hosting zones starting September 15, 2026, and is rolling out Pay Per Crawl / Pay Per Use gating beyond that.',
+    impact: "Without an explicit rule, whether AI crawlers (and future citation opportunities in ChatGPT, Claude, Perplexity, etc.) can reach this site now depends on Cloudflare account-level bot-management defaults, not on this codebase \u2014 a silent, invisible-to-git failure mode.",
+    howToFix: "Add explicit User-agent rules for GPTBot, Claude-Web/ClaudeBot, PerplexityBot, and Google-Extended in robots.txt, and confirm the matching allow/block posture in the Cloudflare dashboard under Bot Management \u2192 AI Crawl Control. If you'd rather charge than block, Cloudflare's Pay Per Crawl (AI Crawl Control \u2192 Payments tab) lets you set a per-crawl price instead of a flat allow/deny \u2014 worth a look if you get meaningful AI-crawler traffic."
+  },
+  NO_AGENT_EXPERIENCE_SURFACE: {
+    code: "NO_AGENT_EXPERIENCE_SURFACE",
+    severity: "notice",
+    category: "ai-readiness",
+    title: "No agent-facing discovery surface found",
+    description: "None of the emerging AI-agent discovery conventions were found: llms-full.txt, SKILL.md, a discoverable MCP server, or an OpenAPI spec. This is a genuinely new, low-adoption category as of 2026 \u2014 most sites have none of these yet \u2014 so this is an opportunity, not a compliance failure.",
+    impact: "AI agents (not just chatbots answering questions, but agents that browse and act on a user's behalf) increasingly prefer sites that expose machine-readable capabilities over ones that require scraping and guessing at HTML structure. Being an early, discoverable site in this space is a low-competition differentiator right now.",
+    howToFix: "Start with whichever fits your site: llms-full.txt (a single Markdown dump of your key content \u2014 measured as fetched roughly 2x more than plain llms.txt), a SKILL.md capability manifest, or an OpenAPI spec at /openapi.json if you already have an API. A discoverable MCP server is the highest-effort, highest-payoff option if your product has one to expose."
+  },
   HIGH_JS_RENDERING_RATIO: {
     code: "HIGH_JS_RENDERING_RATIO",
     severity: "warning",
@@ -7389,6 +7407,62 @@ async function checkInternalRedirects(internalLinks, batchSize = 10) {
 // src/audit/checks/ai-readiness.ts
 init_http();
 var cheerio13 = __toESM(require("cheerio"));
+
+// src/audit/checks/agent-experience.ts
+init_http();
+var SIGNAL_PATHS = [
+  { path: "/llms-full.txt", description: "Full-site content dump for AI agents \u2014 the fuller sibling of llms.txt, measured as fetched roughly 2x more often" },
+  { path: "/skill.md", description: "SKILL.md capability manifest (Anthropic Agent Skills convention)" },
+  { path: "/mcp", description: "MCP (Model Context Protocol) server, discoverable at a conventional path" },
+  { path: "/.well-known/mcp.json", description: "MCP server descriptor at the .well-known convention" },
+  { path: "/openapi.json", description: "OpenAPI spec \u2014 lets an agent discover and call your API directly instead of scraping HTML" },
+  { path: "/.well-known/ai-plugin.json", description: "AI plugin manifest (older but still-referenced convention for agent tool discovery)" }
+];
+async function fetchBody(baseUrl, path3) {
+  try {
+    const url = new URL(path3, baseUrl).href;
+    const response = await httpGet(url, {
+      timeout: 8e3,
+      validateStatus: () => true
+    });
+    return { status: response.status, body: String(response.data ?? "") };
+  } catch {
+    return null;
+  }
+}
+async function pathExists(baseUrl, path3, fallbackBody) {
+  const result = await fetchBody(baseUrl, path3);
+  if (!result) return false;
+  if (result.status === 404) return false;
+  if (result.status < 200 || result.status >= 400) return false;
+  if (fallbackBody != null && result.body === fallbackBody) return false;
+  return true;
+}
+async function checkAgentExperience(baseUrl) {
+  const issues = [];
+  const probePath = `/__rankcli_ax_probe_${Math.random().toString(36).slice(2)}`;
+  const baseline = await fetchBody(baseUrl, probePath);
+  const fallbackBody = baseline && baseline.status >= 200 && baseline.status < 400 ? baseline.body : null;
+  const signals = await Promise.all(
+    SIGNAL_PATHS.map(async ({ path: path3, description }) => ({
+      path: path3,
+      description,
+      present: await pathExists(baseUrl, path3, fallbackBody)
+    }))
+  );
+  const presentCount = signals.filter((s) => s.present).length;
+  const score = Math.round(presentCount / signals.length * 100);
+  if (presentCount === 0) {
+    issues.push({
+      ...ISSUE_DEFINITIONS.NO_AGENT_EXPERIENCE_SURFACE,
+      affectedUrls: [baseUrl],
+      details: { checkedPaths: SIGNAL_PATHS.map((s) => s.path) }
+    });
+  }
+  return { issues, data: { signals, score } };
+}
+
+// src/audit/checks/ai-readiness.ts
 var AI_BOTS = {
   GPTBot: "GPTBot",
   "ChatGPT-User": "ChatGPT-User",
@@ -7609,6 +7683,32 @@ function checkJSRenderingRatio(html, url) {
     data: { ratio, staticWordCount }
   };
 }
+async function checkCloudflareAICrawlerGate(baseUrl, botBlocking) {
+  const issues = [];
+  let behindCloudflare = false;
+  try {
+    const response = await httpGet(baseUrl, {
+      timeout: 1e4,
+      validateStatus: () => true
+    });
+    const server = response.headers["server"] || "";
+    behindCloudflare = server.toLowerCase().includes("cloudflare") || "cf-ray" in response.headers;
+  } catch {
+    behindCloudflare = false;
+  }
+  const hasExplicitAIRules = botBlocking.robotsExists && botBlocking.blockedBots.length > 0;
+  const ambiguous = behindCloudflare && !hasExplicitAIRules;
+  if (ambiguous) {
+    issues.push({
+      ...ISSUE_DEFINITIONS.CLOUDFLARE_AI_CRAWLER_GATE_AMBIGUOUS,
+      affectedUrls: [baseUrl]
+    });
+  }
+  return {
+    issues,
+    data: { behindCloudflare, hasExplicitAIRules, ambiguous }
+  };
+}
 async function runAIReadinessChecks(baseUrl, html) {
   const allIssues = [];
   const llmsResult = await checkLlmsTxt(baseUrl);
@@ -7617,12 +7717,18 @@ async function runAIReadinessChecks(baseUrl, html) {
   allIssues.push(...botResult.issues);
   const jsResult = checkJSRenderingRatio(html, baseUrl);
   allIssues.push(...jsResult.issues);
+  const cfGateResult = await checkCloudflareAICrawlerGate(baseUrl, botResult.data);
+  allIssues.push(...cfGateResult.issues);
+  const agentExperienceResult = await checkAgentExperience(baseUrl);
+  allIssues.push(...agentExperienceResult.issues);
   return {
     issues: allIssues,
     data: {
       llmsTxt: llmsResult.data,
       botBlocking: botResult.data,
-      jsRenderingRatio: jsResult.data.ratio
+      jsRenderingRatio: jsResult.data.ratio,
+      cloudflareAIGate: cfGateResult.data,
+      agentExperience: agentExperienceResult.data
     }
   };
 }
@@ -16077,8 +16183,94 @@ function analyzeAIContentStructure(html, url) {
   };
 }
 
-// src/audit/checks/citation-quality.ts
+// src/audit/checks/rag-chunk-readiness.ts
 var cheerio44 = __toESM(require("cheerio"));
+var MIN_GOOD_WORDS = 150;
+var MAX_GOOD_WORDS = 450;
+var TOKENS_PER_WORD = 1.33;
+var DANGLING_OPENERS = /^(this|it|these|that|they|such|those|the former|the latter)\b/i;
+function classifySize(wordCount) {
+  if (wordCount < MIN_GOOD_WORDS) return "too-short";
+  if (wordCount > MAX_GOOD_WORDS) return "too-long";
+  return "good";
+}
+function extractSections($) {
+  const elements = $("h1, h2, h3, p, li, blockquote").toArray();
+  const sections = [];
+  let current = null;
+  for (const el of elements) {
+    const tag = el.tagName?.toLowerCase();
+    if (tag === "h1" || tag === "h2" || tag === "h3") {
+      if (current) sections.push(current);
+      current = { heading: $(el).text().trim(), headingLevel: parseInt(tag.slice(1), 10), text: "" };
+    } else if (current) {
+      current.text += " " + $(el).text();
+    }
+  }
+  if (current) sections.push(current);
+  return sections;
+}
+function analyzeRAGChunkReadiness(html, url) {
+  const issues = [];
+  const $ = cheerio44.load(html);
+  $("nav, footer, aside, script, style, noscript, header").remove();
+  const rawSections = extractSections($);
+  const sections = rawSections.map((s) => {
+    const words = s.text.trim().split(/\s+/).filter(Boolean);
+    const wordCount = words.length;
+    const estimatedTokens = Math.round(wordCount * TOKENS_PER_WORD);
+    const firstSentence = s.text.trim().split(/[.!?]/)[0] || "";
+    return {
+      heading: s.heading,
+      headingLevel: s.headingLevel,
+      wordCount,
+      estimatedTokens,
+      sizeQuality: classifySize(wordCount),
+      startsWithDanglingReference: DANGLING_OPENERS.test(firstSentence.trim())
+    };
+  });
+  const totalSections = sections.length;
+  const wellSizedSectionCount = sections.filter((s) => s.sizeQuality === "good").length;
+  const danglingReferenceCount = sections.filter((s) => s.startsWithDanglingReference).length;
+  const chunkReadinessScore = totalSections === 0 ? 0 : Math.round(
+    (wellSizedSectionCount / totalSections * 0.7 + (totalSections - danglingReferenceCount) / totalSections * 0.3) * 100
+  );
+  if (totalSections >= 3 && wellSizedSectionCount / totalSections < 0.5) {
+    const tooLong = sections.filter((s) => s.sizeQuality === "too-long").length;
+    const tooShort = sections.filter((s) => s.sizeQuality === "too-short").length;
+    issues.push({
+      code: "RAG_CHUNK_SIZE_MISMATCH",
+      severity: "notice",
+      category: "ai-readiness",
+      title: "Most sections are poorly sized for AI retrieval chunking",
+      description: `${wellSizedSectionCount} of ${totalSections} sections fall in a well-sized range for RAG retrieval (roughly 150-450 words); ${tooLong} are too long and likely to get split mid-thought, ${tooShort} are too short and likely to get merged with unrelated neighbors.`,
+      impact: "When an AI answer engine retrieves a chunk of this page in response to a query, oversized sections risk being cut off mid-point and undersized ones risk losing standalone context \u2014 both reduce the odds the retrieved chunk reads coherently in an AI-generated answer.",
+      howToFix: "Break up long sections (450+ words) with an additional H2/H3 subheading roughly every 300-400 words. Merge very short sections (under 150 words) into a neighboring section or expand them with enough context to stand alone.",
+      affectedUrls: [url],
+      details: { wellSizedSectionCount, totalSections, tooLong, tooShort }
+    });
+  }
+  if (totalSections >= 3 && danglingReferenceCount / totalSections > 0.3) {
+    issues.push({
+      code: "RAG_CHUNK_DANGLING_REFERENCES",
+      severity: "notice",
+      category: "ai-readiness",
+      title: "Several sections open with a reference to prior context",
+      description: `${danglingReferenceCount} of ${totalSections} sections start with a pronoun or demonstrative ("This...", "It...", "These...") that depends on the previous section to make sense.`,
+      impact: "A RAG system that retrieves one of these sections on its own \u2014 which is exactly how retrieval works, one chunk at a time \u2014 surfaces a sentence whose subject is undefined, reading as broken or confusing in an AI-generated answer.",
+      howToFix: 'Open each section by naming its actual subject instead of referring back to the previous one \u2014 e.g. "This approach reduces cost" becomes "Caching reduces cost."',
+      affectedUrls: [url],
+      details: { danglingReferenceCount, totalSections }
+    });
+  }
+  return {
+    issues,
+    data: { sections, totalSections, wellSizedSectionCount, danglingReferenceCount, chunkReadinessScore }
+  };
+}
+
+// src/audit/checks/citation-quality.ts
+var cheerio45 = __toESM(require("cheerio"));
 var REPUTABLE_SOURCES = {
   academic: [
     "scholar.google.com",
@@ -16145,7 +16337,7 @@ var REPUTABLE_SOURCES = {
 };
 function analyzeCitationQuality(html, url) {
   const issues = [];
-  const $ = cheerio44.load(html);
+  const $ = cheerio45.load(html);
   const parsedUrl = new URL(url);
   const currentDomain = parsedUrl.hostname;
   const $content = $("body").clone();
@@ -16374,12 +16566,12 @@ function analyzeCitationQuality(html, url) {
 }
 
 // src/audit/checks/answer-conciseness.ts
-var cheerio45 = __toESM(require("cheerio"));
+var cheerio46 = __toESM(require("cheerio"));
 var IDEAL_ANSWER_LENGTH = { min: 40, max: 150 };
 var MAX_FIRST_SENTENCE = 200;
 function analyzeAnswerConciseness(html, url) {
   const issues = [];
-  const $ = cheerio45.load(html);
+  const $ = cheerio46.load(html);
   $("nav, footer, aside, script, style, noscript, header").remove();
   const headings = $("h1, h2, h3, h4, h5, h6");
   let totalHeadings = 0;
@@ -16570,7 +16762,7 @@ function analyzeAnswerConciseness(html, url) {
 }
 
 // src/audit/checks/brand-mention-optimization.ts
-var cheerio46 = __toESM(require("cheerio"));
+var cheerio47 = __toESM(require("cheerio"));
 var BRAND_DEFINITION_PATTERNS = [
   /(?:we are|we're|is a|is the|is an)\s+(?:leading|premier|top|best|trusted|innovative|professional)/i,
   /(?:our mission|our vision|we help|we provide|we offer|we specialize)/i,
@@ -16608,7 +16800,7 @@ var REVIEW_PLATFORMS = [
 ];
 function analyzeBrandMentionOptimization(html, url) {
   const issues = [];
-  const $ = cheerio46.load(html);
+  const $ = cheerio47.load(html);
   const parsedUrl = new URL(url);
   const $content = $("body").clone();
   $content.find("nav, footer, script, style, noscript").remove();
@@ -16800,7 +16992,7 @@ function analyzeBrandMentionOptimization(html, url) {
 }
 
 // src/audit/checks/ai-citation-worthiness.ts
-var cheerio47 = __toESM(require("cheerio"));
+var cheerio48 = __toESM(require("cheerio"));
 var ORIGINAL_DATA_PATTERNS = [
   /(?:our data|our research|our study|our analysis|we found|we discovered)/i,
   /(?:survey of|surveyed|interviewed|analyzed)\s+\d+/i,
@@ -16847,7 +17039,7 @@ var STOCK_IMAGE_DOMAINS = [
 ];
 function analyzeAICitationWorthiness(html, url) {
   const issues = [];
-  const $ = cheerio47.load(html);
+  const $ = cheerio48.load(html);
   const $content = $("body").clone();
   $content.find("nav, footer, script, style, noscript, aside").remove();
   const bodyText = $content.text();
@@ -17072,7 +17264,7 @@ function analyzeAICitationWorthiness(html, url) {
 }
 
 // src/audit/checks/review-ecosystem.ts
-var cheerio48 = __toESM(require("cheerio"));
+var cheerio49 = __toESM(require("cheerio"));
 var REVIEW_PLATFORMS2 = {
   general: [
     { name: "Google Business", domain: "google.com/maps", aliases: ["goo.gl/maps", "maps.google"] },
@@ -17132,7 +17324,7 @@ var TRUST_BADGE_PATTERNS2 = [
 ];
 function analyzeReviewEcosystem(html, url) {
   const issues = [];
-  const $ = cheerio48.load(html);
+  const $ = cheerio49.load(html);
   const allLinks = $("a[href]").map((_, a) => $(a).attr("href") || "").get();
   const allLinksLower = allLinks.map((l) => l.toLowerCase());
   const linkedPlatforms = [];
@@ -17816,11 +18008,11 @@ function analyzeStructure(content) {
 }
 
 // src/audit/checks/html-compliance.ts
-var cheerio49 = __toESM(require("cheerio"));
+var cheerio50 = __toESM(require("cheerio"));
 init_http();
 async function analyzeHtmlCompliance(html, url, headers) {
   const issues = [];
-  const $ = cheerio49.load(html);
+  const $ = cheerio50.load(html);
   const parsedUrl = new URL(url);
   const doctypeMatch = html.match(/<!DOCTYPE\s+([^>]+)>/i);
   const hasDoctype = doctypeMatch !== null;
@@ -18386,7 +18578,7 @@ function getAssetType(url) {
 }
 
 // src/audit/checks/dom-size.ts
-var cheerio50 = __toESM(require("cheerio"));
+var cheerio51 = __toESM(require("cheerio"));
 var THRESHOLDS = {
   totalElements: {
     warning: 1500,
@@ -18403,7 +18595,7 @@ var THRESHOLDS = {
 };
 function analyzeDomSize(html, url) {
   const issues = [];
-  const $ = cheerio50.load(html);
+  const $ = cheerio51.load(html);
   const allElements = $("*");
   const totalElements = allElements.length;
   let maxDepth = 0;
@@ -18559,10 +18751,10 @@ function getDomReductionSuggestions(breakdown) {
 }
 
 // src/audit/checks/image-dimensions.ts
-var cheerio51 = __toESM(require("cheerio"));
+var cheerio52 = __toESM(require("cheerio"));
 function analyzeImageDimensions(html, url) {
   const issues = [];
-  const $ = cheerio51.load(html);
+  const $ = cheerio52.load(html);
   const images = $("img");
   const totalImages = images.length;
   let withDimensions = 0;
@@ -18673,7 +18865,7 @@ function truncateSrc(src) {
 }
 
 // src/audit/checks/color-contrast.ts
-var cheerio52 = __toESM(require("cheerio"));
+var cheerio53 = __toESM(require("cheerio"));
 var KNOWN_LOW_CONTRAST_PAIRS = [
   { fg: "#999999", bg: "#ffffff", ratio: 2.85 },
   { fg: "#888888", bg: "#ffffff", ratio: 3.54 },
@@ -18708,7 +18900,7 @@ var NAMED_COLORS = {
 };
 function analyzeColorContrast(html, url) {
   const issues = [];
-  const $ = cheerio52.load(html);
+  const $ = cheerio53.load(html);
   const potentialIssues = [];
   let elementsAnalyzed = 0;
   let passedChecks = 0;
@@ -18907,7 +19099,7 @@ function calculateContrastRatio(fg, bg) {
 
 // src/audit/checks/asset-minification.ts
 init_http();
-var cheerio53 = __toESM(require("cheerio"));
+var cheerio54 = __toESM(require("cheerio"));
 function isMinified(content, type) {
   const lines = content.split("\n");
   const totalLines = lines.length;
@@ -18935,7 +19127,7 @@ function isMinified(content, type) {
   };
 }
 function extractAssetUrls(html, baseUrl) {
-  const $ = cheerio53.load(html);
+  const $ = cheerio54.load(html);
   const base = new URL(baseUrl);
   const css = [];
   const js = [];
@@ -19081,10 +19273,10 @@ async function analyzeAssetMinification(html, url) {
 }
 
 // src/audit/checks/page-resources.ts
-var cheerio54 = __toESM(require("cheerio"));
+var cheerio55 = __toESM(require("cheerio"));
 function analyzePageResources(html, url) {
   const issues = [];
-  const $ = cheerio54.load(html);
+  const $ = cheerio55.load(html);
   const baseUrl = new URL(url);
   const baseHostname = baseUrl.hostname;
   const stylesheets = [];
@@ -19285,7 +19477,7 @@ function analyzePageResources(html, url) {
 
 // src/audit/checks/responsive-css.ts
 init_http();
-var cheerio55 = __toESM(require("cheerio"));
+var cheerio56 = __toESM(require("cheerio"));
 function extractMediaQueries(css) {
   const mediaQueries = [];
   const regex = /@media\s*([^{]+)/g;
@@ -19335,7 +19527,7 @@ function classifyBreakpoints(mediaQueries) {
 }
 async function analyzeResponsiveCss(html, url) {
   const issues = [];
-  const $ = cheerio55.load(html);
+  const $ = cheerio56.load(html);
   const baseUrl = new URL(url);
   const viewportMeta = $('meta[name="viewport"]').attr("content");
   const hasViewport = !!viewportMeta;
@@ -20073,10 +20265,10 @@ var urlSafetyDatabase = {
 };
 
 // src/audit/checks/tracking-verification.ts
-var cheerio56 = __toESM(require("cheerio"));
+var cheerio57 = __toESM(require("cheerio"));
 function analyzeTrackingVerification(html, url) {
   const issues = [];
-  const $ = cheerio56.load(html);
+  const $ = cheerio57.load(html);
   const ga4Match = html.match(/gtag\s*\(\s*['"]config['"]\s*,\s*['"](G-[A-Z0-9]+)['"]/i) || html.match(/googletagmanager\.com\/gtag\/js\?id=(G-[A-Z0-9]+)/i);
   const hasGa4 = !!ga4Match;
   const ga4MeasurementId = ga4Match ? ga4Match[1] : void 0;
@@ -20210,10 +20402,10 @@ async function runFullAudit(options) {
   const runExtendedChecks = tier !== "free";
   const parsedUrl = new URL(url);
   const domain = parsedUrl.hostname;
-  console.log(`
+  console.error(`
 \u{1F50D} Running comprehensive SEO audit on ${url}...
 `);
-  console.log("\u{1F4CB} Phase 1: Crawlability checks + page fetch (parallel)...");
+  console.error("\u{1F4CB} Phase 1: Crawlability checks + page fetch (parallel)...");
   const [crawlabilityResult, fetchResult] = await Promise.all([
     runCrawlabilityChecks(url).catch((err) => {
       console.error("Crawlability check failed:", err);
@@ -20248,7 +20440,7 @@ async function runFullAudit(options) {
   }
   const html = fetchResult.data;
   const headers = fetchResult.headers;
-  console.log(`\u{1F4DD} Phase 2: Running synchronous HTML checks (tier: ${tier}, limit: ${checksLimit})...`);
+  console.error(`\u{1F4DD} Phase 2: Running synchronous HTML checks (tier: ${tier}, limit: ${checksLimit})...`);
   const onPageResult = analyzeOnPage(html, url);
   const structuredDataResult = analyzeStructuredData(html, url);
   const mobileResult = analyzeMobile(html, url);
@@ -20288,6 +20480,7 @@ async function runFullAudit(options) {
   const entityResult = runPremiumChecks ? analyzeEntitySEO(html, url) : { issues: [], data: {} };
   const qdfFreshnessResult = runPremiumChecks ? analyzeFreshnessSignals(html, url) : { issues: [], data: {} };
   const aiContentStructureResult = runPremiumChecks ? analyzeAIContentStructure(html, url) : { issues: [], data: {} };
+  const ragChunkReadinessResult = runPremiumChecks ? analyzeRAGChunkReadiness(html, url) : { issues: [], data: {} };
   const citationQualityResult = runPremiumChecks ? analyzeCitationQuality(html, url) : { issues: [], data: {} };
   const answerConcisenessResult = runPremiumChecks ? analyzeAnswerConciseness(html, url) : { issues: [], data: {} };
   const brandMentionResult = runPremiumChecks ? analyzeBrandMentionOptimization(html, url) : { issues: [], data: {} };
@@ -20326,6 +20519,7 @@ async function runFullAudit(options) {
     ...entityResult.issues,
     ...qdfFreshnessResult.issues,
     ...aiContentStructureResult.issues,
+    ...ragChunkReadinessResult.issues,
     ...citationQualityResult.issues,
     ...answerConcisenessResult.issues,
     ...brandMentionResult.issues,
@@ -20349,7 +20543,7 @@ async function runFullAudit(options) {
       };
     }
   }
-  console.log("\u{1F517} Phase 3: Running async checks (parallel)...");
+  console.error("\u{1F517} Phase 3: Running async checks (parallel)...");
   const safeAsync = async (name, fn, timeoutMs = 1e4) => {
     try {
       const resultPromise = fn();
@@ -20462,7 +20656,7 @@ async function runFullAudit(options) {
     loadTime: perfData.loadTime,
     issues: allIssues.map((i) => i.code)
   });
-  console.log("\n\u2705 Audit complete!\n");
+  console.error("\n\u2705 Audit complete!\n");
   return createReport(url, domain, allIssues, pages);
 }
 function createReport(url, domain, issues, pages) {
@@ -20623,10 +20817,10 @@ function groupIssuesByCategory(issues) {
 }
 
 // src/audit/checks/duplicate-content.ts
-var cheerio57 = __toESM(require("cheerio"));
+var cheerio58 = __toESM(require("cheerio"));
 var import_crypto = require("crypto");
 function extractContentHash(html, url) {
-  const $ = cheerio57.load(html);
+  const $ = cheerio58.load(html);
   $("script, style, nav, header, footer, aside, .nav, .header, .footer, .sidebar").remove();
   const title = $("title").text().trim();
   const bodyText = $("body").text().replace(/\s+/g, " ").trim();
@@ -21854,7 +22048,7 @@ var PRIORITY_WEIGHTS = {
 };
 
 // src/keywords/engine.ts
-var cheerio59 = __toESM(require("cheerio"));
+var cheerio60 = __toESM(require("cheerio"));
 init_http();
 
 // src/keywords/prioritizer.ts
@@ -22151,7 +22345,7 @@ function enrichKeywordsWithEstimates(keywords) {
 
 // src/keywords/sources/free-sources.ts
 init_http();
-var cheerio58 = __toESM(require("cheerio"));
+var cheerio59 = __toESM(require("cheerio"));
 var USER_AGENT = "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36";
 async function getPeopleAlsoAsk(query) {
   try {
@@ -22160,7 +22354,7 @@ async function getPeopleAlsoAsk(query) {
       headers: { "User-Agent": USER_AGENT },
       timeout: 1e4
     });
-    const $ = cheerio58.load(response.data);
+    const $ = cheerio59.load(response.data);
     const questions = [];
     $("[data-sgrd]").each((_, el) => {
       const text = $(el).text().trim();
@@ -22186,7 +22380,7 @@ async function getRelatedSearches(query) {
       headers: { "User-Agent": USER_AGENT },
       timeout: 1e4
     });
-    const $ = cheerio58.load(response.data);
+    const $ = cheerio59.load(response.data);
     const related = [];
     $("div[data-ved] a").each((_, el) => {
       const href = $(el).attr("href");
@@ -22276,7 +22470,7 @@ async function analyzeCompetitorTitles(query) {
       headers: { "User-Agent": USER_AGENT },
       timeout: 1e4
     });
-    const $ = cheerio58.load(response.data);
+    const $ = cheerio59.load(response.data);
     const titles = [];
     const keywords = /* @__PURE__ */ new Set();
     $("h3").each((_, el) => {
@@ -22609,7 +22803,7 @@ async function fetchPageMeta(url) {
     const response = await httpGet(url, {
       timeout: 1e4
     });
-    const $ = cheerio59.load(response.data);
+    const $ = cheerio60.load(response.data);
     return {
       url,
       title: $("title").text().trim() || void 0,
@@ -22740,7 +22934,7 @@ async function extractSeedKeywords(url) {
     const response = await httpGet(url, {
       timeout: 1e4
     });
-    const $ = cheerio59.load(response.data);
+    const $ = cheerio60.load(response.data);
     const seeds = /* @__PURE__ */ new Set();
     const title = $("title").text().toLowerCase();
     const titleWords = title.split(/[\s\-|:]+/).filter((w) => w.length > 3);
@@ -22762,7 +22956,7 @@ async function extractSeedKeywords(url) {
 }
 
 // src/keywords/site-crawler.ts
-var cheerio60 = __toESM(require("cheerio"));
+var cheerio61 = __toESM(require("cheerio"));
 init_http();
 var EXCLUDED_PATHS = [
   "/cdn-cgi/",
@@ -22875,7 +23069,7 @@ async function crawlPage(url, timeout) {
     validateStatus: (status) => status === 200
   });
   const html = response.data;
-  const $ = cheerio60.load(html);
+  const $ = cheerio61.load(html);
   $('script, style, noscript, iframe, nav, footer, header, aside, [role="navigation"]').remove();
   const title = $("title").text().trim();
   const description = $('meta[name="description"]').attr("content")?.trim() || "";
@@ -25533,7 +25727,7 @@ function getDateRange(days = 28) {
 
 // src/keywords/sources/competitor-analysis.ts
 init_http();
-var cheerio61 = __toESM(require("cheerio"));
+var cheerio62 = __toESM(require("cheerio"));
 var USER_AGENT2 = "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36";
 async function discoverCompetitorKeywords(yourDomain, seedKeywords, competitors) {
   const yourKeywords = /* @__PURE__ */ new Set();
@@ -25630,7 +25824,7 @@ async function analyzeSERP(query) {
       headers: { "User-Agent": USER_AGENT2 },
       timeout: 1e4
     });
-    const $ = cheerio61.load(response.data);
+    const $ = cheerio62.load(response.data);
     const results = [];
     const relatedSearches = [];
     const peopleAlsoAsk = [];