@rankcli/agent-runtime 0.0.38 → 0.0.39

package/dist/index.js

@@ -263,7 +263,7 @@ async function crawlUrl(params) {
 async function extractMeta(params) {
   const { html, url } = params;
   try {
-    const $ = cheerio42.load(html);
+    const $ = cheerio43.load(html);
     const meta = {
       title: $("title").text().trim() || void 0,
       description: $('meta[name="description"]').attr("content")?.trim(),
@@ -308,7 +308,7 @@ async function extractMeta(params) {
 async function analyzeHeadings(params) {
   const { html } = params;
   try {
-    const $ = cheerio42.load(html);
+    const $ = cheerio43.load(html);
     const headings = [];
     $("h1, h2, h3, h4, h5, h6").each((_, el) => {
       const tag = el.tagName.toLowerCase();
@@ -329,7 +329,7 @@ async function analyzeHeadings(params) {
 async function extractImages2(params) {
   const { html } = params;
   try {
-    const $ = cheerio42.load(html);
+    const $ = cheerio43.load(html);
     const images = [];
     $("img").each((_, el) => {
       images.push({
@@ -351,7 +351,7 @@ async function extractImages2(params) {
 async function extractLinks2(params) {
   const { html, baseUrl } = params;
   try {
-    const $ = cheerio42.load(html);
+    const $ = cheerio43.load(html);
     const links = [];
     const baseHostname = new URL(baseUrl).hostname;
     $("a[href]").each((_, el) => {
@@ -386,7 +386,7 @@ async function extractLinks2(params) {
 async function extractSchema2(params) {
   const { html } = params;
   try {
-    const $ = cheerio42.load(html);
+    const $ = cheerio43.load(html);
     const schemas = [];
     $('script[type="application/ld+json"]').each((_, el) => {
       try {
@@ -455,7 +455,7 @@ async function checkSitemap2(params) {
           timeout: 1e4
         });
         if (response.status === 200 && response.data.includes("<?xml")) {
-          const $ = cheerio42.load(response.data, { xmlMode: true });
+          const $ = cheerio43.load(response.data, { xmlMode: true });
           const urlCount = $("url").length || $("sitemap").length;
           return {
             success: true,
@@ -484,12 +484,12 @@ async function checkSitemap2(params) {
     };
   }
 }
-var cheerio42;
+var cheerio43;
 var init_crawl = __esm({
   "src/tools/crawl.ts"() {
     "use strict";
     init_http();
-    cheerio42 = __toESM(require("cheerio"));
+    cheerio43 = __toESM(require("cheerio"));
   }
 });
 
@@ -886,7 +886,7 @@ function analyzeRobotsTxtForAI(robotsTxt) {
   return { allowed, blocked, recommendations };
 }
 function detectRenderingMode(html) {
-  const $ = cheerio43.load(html);
+  const $ = cheerio44.load(html);
   const signals = [];
   const hasNextData = html.includes("__NEXT_DATA__");
   const hasNuxtData = html.includes("__NUXT__");
@@ -927,7 +927,7 @@ function detectRenderingMode(html) {
   };
 }
 function analyzeContentStructure(html) {
-  const $ = cheerio43.load(html);
+  const $ = cheerio44.load(html);
   const jsonLdScripts = $('script[type="application/ld+json"]');
   let hasStructuredData = jsonLdScripts.length > 0;
   let hasFAQSchema = false;
@@ -977,7 +977,7 @@ function analyzeContentStructure(html) {
   };
 }
 function analyzeCitationReadiness(html) {
-  const $ = cheerio43.load(html);
+  const $ = cheerio44.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) => {
@@ -1010,7 +1010,7 @@ function analyzeCitationReadiness(html) {
   };
 }
 function analyzeEntityExtraction(html) {
-  const $ = cheerio43.load(html);
+  const $ = cheerio44.load(html);
   const bodyText = $("body").text();
   const definedTerms = [];
   $("dfn, abbr[title]").each((_, el) => {
@@ -1046,7 +1046,7 @@ function analyzeEntityExtraction(html) {
   };
 }
 function calculateLLMSignals(structure, citation, entity, html) {
-  const $ = cheerio43.load(html);
+  const $ = cheerio44.load(html);
   let contentClarity = 0;
   if (structure.headingHierarchy === "good") contentClarity += 30;
   else if (structure.headingHierarchy === "needs-work") contentClarity += 15;
@@ -1352,11 +1352,11 @@ Allow: /
 Sitemap: ${siteUrl}/sitemap.xml
 `;
 }
-var cheerio43, AI_CRAWLERS, AI_CRAWLERS_INFO;
+var cheerio44, AI_CRAWLERS, AI_CRAWLERS_INFO;
 var init_geo_analyzer = __esm({
   "src/analyzers/geo-analyzer.ts"() {
     "use strict";
-    cheerio43 = __toESM(require("cheerio"));
+    cheerio44 = __toESM(require("cheerio"));
     AI_CRAWLERS = {
       // OpenAI
       GPTBot: { userAgent: "GPTBot", company: "OpenAI", purpose: "ChatGPT training & browsing" },
@@ -1715,7 +1715,7 @@ function generateCWVIssues(lcp, fidInp, cls, ttfb, url) {
   return issues;
 }
 function analyzeCoreWebVitals(html, url, headers) {
-  const $ = cheerio44.load(html);
+  const $ = cheerio45.load(html);
   const lcp = analyzeLCP(html, $);
   const fidInp = analyzeFID_INP(html, $);
   const cls = analyzeCLS(html, $);
@@ -1760,11 +1760,11 @@ function analyzeCoreWebVitals(html, url, headers) {
     issues
   };
 }
-var cheerio44;
+var cheerio45;
 var init_core_web_vitals_analyzer = __esm({
   "src/analyzers/core-web-vitals-analyzer.ts"() {
     "use strict";
-    cheerio44 = __toESM(require("cheerio"));
+    cheerio45 = __toESM(require("cheerio"));
   }
 });
 
@@ -2099,7 +2099,7 @@ function validateSchema(data, type) {
   };
 }
 function analyzeStructuredData2(html, url) {
-  const $ = cheerio45.load(html);
+  const $ = cheerio46.load(html);
   const schemas = [];
   const issues = [];
   const recommendations = [];
@@ -2363,11 +2363,11 @@ function generateSchemaTemplate(pageType, options) {
   }
   return JSON.stringify(result, null, 2);
 }
-var cheerio45, SCHEMA_REQUIREMENTS;
+var cheerio46, SCHEMA_REQUIREMENTS;
 var init_structured_data_analyzer = __esm({
   "src/analyzers/structured-data-analyzer.ts"() {
     "use strict";
-    cheerio45 = __toESM(require("cheerio"));
+    cheerio46 = __toESM(require("cheerio"));
     SCHEMA_REQUIREMENTS = {
       "Organization": {
         required: ["name", "url"],
@@ -2483,7 +2483,7 @@ function getImageFormat2(src) {
   }
 }
 function analyzeImages3(html, url) {
-  const $ = cheerio46.load(html);
+  const $ = cheerio47.load(html);
   const issues = [];
   const recommendations = [];
   let score = 100;
@@ -2701,11 +2701,11 @@ function generateResponsiveImage(options) {
   />
 </picture>`;
 }
-var cheerio46, MODERN_FORMATS3, LEGACY_FORMATS2, MAX_RECOMMENDED_DIMENSION;
+var cheerio47, MODERN_FORMATS3, LEGACY_FORMATS2, MAX_RECOMMENDED_DIMENSION;
 var init_image_optimization_analyzer = __esm({
   "src/analyzers/image-optimization-analyzer.ts"() {
     "use strict";
-    cheerio46 = __toESM(require("cheerio"));
+    cheerio47 = __toESM(require("cheerio"));
     MODERN_FORMATS3 = ["webp", "avif"];
     LEGACY_FORMATS2 = ["jpg", "jpeg", "png", "gif", "bmp"];
     MAX_RECOMMENDED_DIMENSION = 2e3;
@@ -2746,7 +2746,7 @@ function analyzeAnchorText2(text) {
   };
 }
 function analyzeInternalLinking(html, url) {
-  const $ = cheerio47.load(html);
+  const $ = cheerio48.load(html);
   const issues = [];
   const recommendations = [];
   let score = 100;
@@ -2985,11 +2985,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 cheerio47, GENERIC_ANCHOR_TEXTS;
+var cheerio48, GENERIC_ANCHOR_TEXTS;
 var init_internal_linking_analyzer = __esm({
   "src/analyzers/internal-linking-analyzer.ts"() {
     "use strict";
-    cheerio47 = __toESM(require("cheerio"));
+    cheerio48 = __toESM(require("cheerio"));
     GENERIC_ANCHOR_TEXTS = [
       "click here",
       "read more",
@@ -3183,7 +3183,7 @@ function analyzeMobileSpecific($) {
   };
 }
 function analyzeMobileSEO(html, url) {
-  const $ = cheerio48.load(html);
+  const $ = cheerio49.load(html);
   const issues = [];
   const recommendations = [];
   let score = 100;
@@ -3314,11 +3314,11 @@ function analyzeMobileSEO(html, url) {
     recommendations
   };
 }
-var cheerio48;
+var cheerio49;
 var init_mobile_seo_analyzer = __esm({
   "src/analyzers/mobile-seo-analyzer.ts"() {
     "use strict";
-    cheerio48 = __toESM(require("cheerio"));
+    cheerio49 = __toESM(require("cheerio"));
   }
 });
 
@@ -3330,6 +3330,7 @@ __export(index_exports, {
   LOCATION_CODES: () => LOCATION_CODES,
   OG_IMAGE_SPECS: () => OG_IMAGE_SPECS,
   PRIORITY_WEIGHTS: () => PRIORITY_WEIGHTS,
+  REDUNDANT_WHEN_PRESENT: () => REDUNDANT_WHEN_PRESENT,
   RankTracker: () => RankTracker,
   SEO_SCOPES: () => SEO_SCOPES,
   SITE_PROFILE_QUESTIONS: () => SITE_PROFILE_QUESTIONS,
@@ -3413,6 +3414,7 @@ __export(index_exports, {
   createPullRequest: () => createPullRequest,
   createSEOCommit: () => createSEOCommit,
   createSEOCommits: () => createSEOCommits,
+  dedupeIssues: () => dedupeIssues,
   describeConcerns: () => describeConcerns,
   detectDuplicates: () => detectDuplicates,
   detectFramework: () => detectFramework4,
@@ -3549,6 +3551,7 @@ __export(index_exports, {
   loadAgent: () => loadAgent,
   loadAgentByName: () => loadAgentByName,
   mergePages: () => mergePages,
+  metaRefreshTarget: () => metaRefreshTarget,
   openAIKeywordLLM: () => openAIKeywordLLM,
   optimizeForAI: () => optimizeForAI,
   optimizeReadme: () => optimizeReadme,
@@ -6371,7 +6374,7 @@ var ISSUE_DEFINITIONS = {
     severity: "warning",
     category: "performance",
     title: "HTML document too large",
-    description: "HTML size exceeds 100KB.",
+    description: "HTML size exceeds 300KB.",
     impact: "Increases load time and memory usage.",
     howToFix: "Reduce inline CSS/JS, remove unnecessary HTML."
   },
@@ -9113,7 +9116,7 @@ async function analyzePerformance(url) {
         details: { ttfb: `${ttfbTime}ms` }
       });
     }
-    if (htmlSize > 100 * 1024) {
+    if (htmlSize > 300 * 1024) {
       issues.push({
         ...ISSUE_DEFINITIONS.HTML_TOO_LARGE,
         affectedUrls: [url],
@@ -11277,7 +11280,7 @@ function analyzeLocalSEO(html, url) {
   const detectedPhones = detectPhones(html);
   const detectedAddresses = detectAddresses(html);
   const socialProfiles = detectSocialProfiles(html);
-  if (!hasLocalBusiness) {
+  if (!hasLocalBusiness && (detectedPhones.length > 0 || detectedAddresses.length > 0)) {
     issues.push({
       ...ISSUE_DEFINITIONS.LOCAL_BUSINESS_SCHEMA_MISSING,
       affectedUrls: [url]
@@ -12340,7 +12343,17 @@ function analyzeKeywords(html, url) {
   const sortPhrases = (phrases, n) => {
     return Array.from(phrases).filter(([_, count]) => count >= 2).sort((a, b) => b[1] - a[1]).slice(0, 10).map(([phrase, count]) => ({ phrase, count, wordCount: n }));
   };
-  const potentialStuffing = topKeywords.filter((k) => k.density > 3).map((k) => k.word);
+  const brandLabels = /* @__PURE__ */ new Set();
+  try {
+    const host = new URL(url).hostname.toLowerCase().replace(/^www\./, "");
+    for (const label of host.split(".").slice(0, -1)) brandLabels.add(label);
+  } catch {
+  }
+  for (const name of [$('meta[property="og:site_name"]').attr("content"), $('meta[name="application-name"]').attr("content")]) {
+    for (const token of tokenize(name || "")) brandLabels.add(token);
+  }
+  const isBrandWord = (word) => [...brandLabels].some((label) => label.includes(word) || word.includes(label));
+  const potentialStuffing = totalWords >= 200 ? topKeywords.filter((k) => k.density > 4 && !isBrandWord(k.word)).map((k) => k.word) : [];
   if (potentialStuffing.length > 0) {
     issues.push({
       ...ISSUE_DEFINITIONS.KEYWORD_STUFFING,
@@ -12567,13 +12580,6 @@ function checkAMP(html, url) {
       }
     };
   }
-  const isArticle = $("article").length > 0 || $('meta[property="og:type"][content="article"]').length > 0 || html.toLowerCase().includes("blog") || html.toLowerCase().includes("news");
-  if (isArticle) {
-    issues.push({
-      ...ISSUE_DEFINITIONS.AMP_MISSING,
-      affectedUrls: [url]
-    });
-  }
   return {
     issues,
     data: {
@@ -13285,13 +13291,13 @@ async function analyzeSiteMaturity(html, url) {
     contentToAuthorityRatio
   };
   const { strategy, recommendations } = determineStrategy(maturityLevel, authorityIndicators, contentMetrics);
-  if (maturityLevel === "new") {
+  if (maturityLevel === "new" && ageSource === "wayback" && estimatedAgeDays !== null) {
     issues.push({
       code: "NEW_SITE_STRATEGY",
       severity: "notice",
       category: "content",
       title: "New website detected - Authority-first strategy recommended",
-      description: "Your site appears to be new (<90 days). Standard SEO advice won't work well for new sites.",
+      description: `The Wayback Machine first saw this site ${estimatedAgeDays} days ago. Standard SEO advice won't work well for a site under 90 days old.`,
       impact: "Creating lots of content without authority is wasted effort. Content from new sites rarely ranks.",
       howToFix: "Focus on building 10+ quality backlinks to ONE great page before expanding content. See strategic recommendations.",
       affectedUrls: [url],
@@ -13302,24 +13308,7 @@ async function analyzeSiteMaturity(html, url) {
       }
     });
   }
-  if (contentToAuthorityRatio === "content-heavy") {
-    issues.push({
-      code: "CONTENT_AUTHORITY_IMBALANCE",
-      severity: "warning",
-      category: "content",
-      title: "Content-to-authority imbalance",
-      description: `Site has ~${indexedPages} pages but limited backlink signals. Content is unlikely to rank.`,
-      impact: "Most of your content may be invisible to search engines due to low domain authority.",
-      howToFix: "Stop publishing new content. Focus 100% on link building until you see ranking improvements.",
-      affectedUrls: [url],
-      details: {
-        indexedPages,
-        contentToAuthorityRatio,
-        maturityLevel
-      }
-    });
-  }
-  if (maturityLevel === "growing" && !htmlSignals.hasBlog) {
+  if (maturityLevel === "growing" && ageSource === "wayback" && !htmlSignals.hasBlog) {
     issues.push({
       code: "GROWING_SITE_NO_BLOG",
       severity: "notice",
@@ -13813,8 +13802,8 @@ function analyzeRendering(html) {
   const hasSemanticStructure = hasH1 && (hasMain || hasArticle);
   const title = $("title").text().trim();
   const h1Text = $("h1").first().text().trim();
-  const firstParagraph = $("p").first().text().trim();
-  const keyContentInHTML = title.length > 10 && h1Text.length > 5 && firstParagraph.length > 50;
+  const hasSubstantialParagraph = $("p").toArray().some((p) => $(p).text().trim().length > 50);
+  const keyContentInHTML = title.length > 0 && h1Text.length > 0 && hasSubstantialParagraph;
   const EXPECTED_MIN_CONTENT = 1e3;
   const htmlContentRatio = Math.min(100, mainContentCharCount / EXPECTED_MIN_CONTENT * 100);
   let aiReadableScore = 50;
@@ -14034,9 +14023,9 @@ function analyzeClientRendering(html, url) {
       howToFix: "Ensure the initial HTML contains: meaningful <title>, descriptive <h1>, and a substantial first paragraph with your key message.",
       affectedUrls: [url],
       details: {
-        hasTitle: $("title").text().trim().length > 10,
-        hasH1: $("h1").text().trim().length > 5,
-        hasFirstParagraph: $("p").first().text().trim().length > 50
+        hasTitle: $("title").text().trim().length > 0,
+        hasH1: $("h1").text().trim().length > 0,
+        hasSubstantialParagraph: $("p").toArray().some((p) => $(p).text().trim().length > 50)
       }
     });
   }
@@ -14748,7 +14737,9 @@ async function analyzeBingOptimization(html, url) {
     detectedIssues.push("No Bing site verification");
     issues.push({
       code: "BING_NOT_VERIFIED",
-      severity: "warning",
+      // A notice: verification done through Search Console import or a DNS record this run
+      // could not see leaves no trace in the HTML, so this cannot be a warning.
+      severity: "notice",
       category: "ai-readiness",
       title: verification.dnsChecked ? "Site not verified with Bing Webmaster Tools" : "Bing Webmaster Tools verification not visible in the HTML",
       description: verification.dnsChecked ? "No msvalidate.01 meta tag in the HTML, no MS= TXT record on the domain and no /BingSiteAuth.xml file. ChatGPT Search uses Bing's index. Verifying your site with Bing Webmaster Tools ensures proper indexing and access to Bing-specific SEO tools." : "No msvalidate.01 meta tag in the HTML and no /BingSiteAuth.xml file. The site may be verified through a DNS record instead, which this run could not check. ChatGPT Search uses Bing's index. Verifying your site with Bing Webmaster Tools ensures proper indexing and access to Bing-specific SEO tools.",
@@ -14799,7 +14790,7 @@ async function analyzeBingOptimization(html, url) {
     });
   }
   const hasLocalBusinessSchema = bingPlacesDetected;
-  const hasAddressOnPage = $("address").length > 0 || html.toLowerCase().includes("street") || /\d{5}(-\d{4})?/.test(html);
+  const hasAddressOnPage = $("address").text().trim().length > 0 || detectAddresses(html).length > 0;
   if (hasAddressOnPage && !hasLocalBusinessSchema) {
     detectedIssues.push("Local business may not be on Bing Places");
     issues.push({
@@ -16330,23 +16321,6 @@ function analyzeColorContrast(html, url) {
       });
     }
   }
-  if (cannotDetermine > elementsAnalyzed * 0.8) {
-    issues.push({
-      code: "A11Y_CONTRAST_UNDETERMINED",
-      severity: "notice",
-      category: "accessibility",
-      title: "Color contrast could not be fully analyzed",
-      description: "Most text colors are set via CSS stylesheets rather than inline styles. Full contrast checking requires browser rendering.",
-      impact: "Potential contrast issues may exist that were not detected.",
-      howToFix: "Use browser DevTools (Lighthouse accessibility audit) or dedicated tools like axe-core for comprehensive contrast checking.",
-      affectedUrls: [url],
-      details: {
-        elementsAnalyzed,
-        cannotDetermine,
-        recommendation: "Run Lighthouse accessibility audit for complete contrast analysis."
-      }
-    });
-  }
   return {
     issues,
     data: {
@@ -17671,7 +17645,8 @@ async function analyzeTrackingVerification(html, url) {
   if (!hasGa4 && !hasGtm && otherAnalytics.length === 0) {
     issues.push({
       code: "GA4_MISSING",
-      severity: "warning",
+      // A notice: which analytics a site runs is a choice, not an SEO defect.
+      severity: "notice",
       category: "on-page",
       title: "Google Analytics 4 not detected",
       description: "No GA4 tracking code found. GA4 is essential for measuring organic traffic and conversions.",
@@ -17684,7 +17659,8 @@ async function analyzeTrackingVerification(html, url) {
     const dnsChecked = verification.dnsChecked;
     issues.push({
       code: "GSC_VERIFICATION_MISSING",
-      severity: "warning",
+      // A notice: a site verified by DNS, Google Analytics or Tag Manager leaves no trace here.
+      severity: "notice",
       category: "on-page",
       title: dnsChecked ? "Google Search Console verification not found" : "Google Search Console verification not visible in the HTML",
       description: dnsChecked ? "No google-site-verification meta tag in the HTML and no google-site-verification TXT record on the domain. GSC provides essential data about your search performance." : "No google-site-verification meta tag in the HTML. The site may be verified through a DNS TXT record instead, which this run could not check. GSC provides essential data about your search performance.",
@@ -17759,6 +17735,113 @@ async function analyzeTrackingVerification(html, url) {
   return { issues, data };
 }
 
+// src/audit/meta-refresh.ts
+var cheerio37 = __toESM(require("cheerio"));
+function metaRefreshTarget(html, pageUrl) {
+  if (!/http-equiv\s*=\s*["']?refresh/i.test(html)) return null;
+  const $ = cheerio37.load(html);
+  for (const el of $("meta[http-equiv]").toArray()) {
+    if (($(el).attr("http-equiv") || "").trim().toLowerCase() !== "refresh") continue;
+    const content = $(el).attr("content") || "";
+    const match = content.match(/^\s*(\d+(?:\.\d+)?)\s*[;,]\s*(?:url\s*=\s*)?['"]?\s*([^'"\s>]+)/i);
+    if (!match) continue;
+    if (Number(match[1]) > 5) continue;
+    try {
+      const target = new URL(match[2], pageUrl);
+      if (target.protocol !== "http:" && target.protocol !== "https:") continue;
+      const strip = (u) => u.origin + (u.pathname.replace(/\/+$/, "") || "/") + u.search;
+      if (strip(target) === strip(new URL(pageUrl))) continue;
+      return target.toString();
+    } catch {
+      continue;
+    }
+  }
+  return null;
+}
+
+// src/audit/dedupe.ts
+var REDUNDANT_WHEN_PRESENT = [
+  // The same tag, reported by three checks.
+  { keep: "VIEWPORT_MISSING", drop: ["HTML_NO_VIEWPORT", "RESPONSIVE_NO_VIEWPORT"] },
+  { keep: "LANG_ATTR_MISSING", drop: ["HTML_NO_LANG"] },
+  { keep: "APPLE_TOUCH_ICON_MISSING", drop: ["HTML_NO_APPLE_TOUCH_ICON"] },
+  { keep: "LLMS_TXT_MISSING", drop: ["AI_NO_LLMS_TXT"] },
+  { keep: "INDEXNOW_NOT_IMPLEMENTED", drop: ["BING_NO_INDEXNOW"] },
+  { keep: "BING_VERIFICATION_MISSING", drop: ["BING_NOT_VERIFIED"] },
+  { keep: "SITEMAP_MISSING", drop: ["BING_SITEMAP_MISSING", "SITEMAP_NOT_IN_ROBOTS"] },
+  { keep: "ROBOTS_TXT_MISSING", drop: ["SITEMAP_NOT_IN_ROBOTS"] },
+  { keep: "IMAGES_MISSING_DIMENSIONS", drop: ["IMG_NO_DIMENSIONS"] },
+  { keep: "NO_MODERN_IMAGE_FORMATS", drop: ["IMAGE_NOT_WEBP_AVIF"] },
+  { keep: "SOCIAL_PROFILES_NOT_LINKED", drop: ["NO_SOCIAL_PROFILES"] },
+  { keep: "NO_EXPERIENCE_SIGNALS", drop: ["AI_NO_EXPERIENCE_SIGNALS"] },
+  // No structured data at all makes every "your schema lacks X" finding moot.
+  {
+    keep: "SCHEMA_MISSING",
+    drop: [
+      "SCHEMA_ORG_MISSING",
+      "NO_ORGANIZATION_SCHEMA",
+      "ORGANIZATION_SCHEMA_MISSING",
+      "NO_ENTITY_SCHEMA",
+      "NO_DATE_MODIFIED_SCHEMA",
+      "NO_MAIN_ENTITY_OF_PAGE",
+      "AUTHOR_NO_SCHEMA",
+      "AI_NO_REVIEW_SCHEMA",
+      "NO_SCHEMA_SAMEAS"
+    ]
+  },
+  { keep: "NO_ORGANIZATION_SCHEMA", drop: ["ORGANIZATION_SCHEMA_MISSING"] },
+  // No title, no H1: the findings about their wording are implied.
+  { keep: "TITLE_MISSING", drop: ["LOW_CTR_POTENTIAL", "NO_KEYWORDS_IN_TITLE", "TITLE_TOO_SHORT"] },
+  { keep: "META_DESC_MISSING", drop: ["LOW_CTR_POTENTIAL"] },
+  { keep: "H1_MISSING", drop: ["NO_VISIBLE_HEADLINE", "NO_KEYWORDS_IN_H1", "H1_MISSING_KEYWORD"] },
+  // Client-side rendering, diagnosed once. CLIENT_SIDE_RENDERING carries the per-framework fix.
+  {
+    keep: "CLIENT_SIDE_RENDERING",
+    drop: [
+      "REACT_CSR_DETECTED",
+      "VUE_CSR_DETECTED",
+      "ANGULAR_NO_UNIVERSAL",
+      "SPA_WITHOUT_SSR",
+      "EMPTY_BODY_CONTENT",
+      "HIGH_JS_RENDERING_RATIO",
+      "AI_LOW_HTML_READABILITY"
+    ]
+  },
+  // An empty body has no vocabulary to be undiverse.
+  { keep: "EMPTY_BODY_CONTENT", drop: ["THIN_CONTENT", "LOW_CONTENT_ENTROPY", "HIGH_CONTENT_REPETITION", "LOW_DWELL_TIME_CONTENT", "LOW_TEXT_HTML_RATIO"] },
+  { keep: "THIN_CONTENT", drop: ["LOW_DWELL_TIME_CONTENT"] },
+  { keep: "NO_INTERNAL_LINKS", drop: ["NO_CONTENT_INTERNAL_LINKS", "HIGH_ORPHAN_RISK", "LINKS_NO_INTERNAL"] },
+  // No testimonials on the page, said once instead of six times.
+  { keep: "NO_SOCIAL_PROOF", drop: ["BOFU_NO_SOCIAL_PROOF", "AI_NO_TESTIMONIALS", "AI_NO_REVIEW_INTEGRATION", "AI_NO_REVIEW_PLATFORMS", "AI_WEAK_REVIEW_ECOSYSTEM"] },
+  { keep: "AI_NO_TESTIMONIALS", drop: ["AI_NO_REVIEW_INTEGRATION", "AI_NO_REVIEW_PLATFORMS", "AI_WEAK_REVIEW_ECOSYSTEM"] },
+  // The brand-score composite restates the brand-definition finding it is built from.
+  { keep: "AI_NO_BRAND_DEFINITION", drop: ["AI_LOW_BRAND_SCORE", "NO_ENTITY_DEFINITION"] }
+];
+function dedupeIssues(issues) {
+  const present = new Set(issues.map((i) => i.code));
+  const redundant = /* @__PURE__ */ new Set();
+  for (const rule of REDUNDANT_WHEN_PRESENT) {
+    const fires = typeof rule.keep === "string" ? present.has(rule.keep) : [...present].some((code) => rule.keep.test(code));
+    if (!fires) continue;
+    for (const code of rule.drop) redundant.add(code);
+  }
+  const kept = /* @__PURE__ */ new Map();
+  const out = [];
+  for (const issue of issues) {
+    if (redundant.has(issue.code)) continue;
+    const earlier = kept.get(issue.code);
+    if (earlier) {
+      const urls = /* @__PURE__ */ new Set([...earlier.affectedUrls || [], ...issue.affectedUrls || []]);
+      earlier.affectedUrls = [...urls];
+      continue;
+    }
+    const copy = { ...issue };
+    kept.set(issue.code, copy);
+    out.push(copy);
+  }
+  return out;
+}
+
 // src/audit/engine.ts
 function sameUrl(a, b) {
   try {
@@ -17771,15 +17854,15 @@ function sameUrl(a, b) {
   }
 }
 async function runFullAudit(options) {
-  const { url, checkBrokenLinks = false, checkHreflangUrls = false, checkCanonicalChain = false, cruxApiKey, checksLimit = 280, premiumChecks } = options;
+  const { checkBrokenLinks = false, checkHreflangUrls = false, checkCanonicalChain = false, cruxApiKey, checksLimit = 280, premiumChecks } = options;
+  let url = options.url;
   const auditRoot = isSiteRoot(url) || sameUrl(url, options.auditRootUrl ?? url);
   const allIssues = [];
   const pages = [];
   const tier = checksLimit <= 50 ? "free" : checksLimit <= 100 ? "registered" : "paid";
   const runPremiumChecks = tier === "paid" && !!premiumChecks;
   const runExtendedChecks = tier !== "free";
-  const parsedUrl = new URL(url);
-  const domain = parsedUrl.hostname;
+  let domain = new URL(url).hostname;
   console.error(`
 \u{1F50D} Running comprehensive SEO audit on ${url}...
 `);
@@ -17806,7 +17889,9 @@ async function runFullAudit(options) {
       timeout: 3e4,
       validateStatus: () => true
     }).catch((err) => {
-      console.error("Main page fetch failed:", err instanceof Error ? { message: err.message, cause: err.cause } : err);
+      const cause = err instanceof Error ? err.cause : void 0;
+      const causeText = cause instanceof Error ? ` (${cause.code || cause.message})` : "";
+      console.error(`Main page fetch failed: ${err instanceof Error ? err.message : String(err)}${causeText}`);
       return { error: err, data: "", headers: {} };
     })
   ]);
@@ -17829,7 +17914,7 @@ async function runFullAudit(options) {
     });
     return createReport(url, domain, allIssues, pages, { kind: "unreachable" });
   }
-  const statusCode = fetchResult.status;
+  let statusCode = fetchResult.status;
   if (statusCode >= 400) {
     const blocked = statusCode === 401 || statusCode === 403 || statusCode === 429;
     allIssues.push({
@@ -17842,10 +17927,42 @@ async function runFullAudit(options) {
     pages.push({ url, statusCode, wordCount: 0, loadTime: 0, issues: allIssues.map((i) => i.code) });
     return createReport(url, domain, allIssues, pages, { kind: "http-error", statusCode });
   }
-  const body = typeof fetchResult.data === "string" ? fetchResult.data : JSON.stringify(fetchResult.data ?? "");
+  const asText = (data) => typeof data === "string" ? data : JSON.stringify(data ?? "");
+  let body = asText(fetchResult.data);
+  let headers = fetchResult.headers;
+  const requestedUrl = url;
+  const refreshHops = [];
+  for (let hop = 0; hop < 3; hop++) {
+    const target = metaRefreshTarget(body, url);
+    if (!target) break;
+    try {
+      const next = await httpGet(target, { timeout: 3e4, validateStatus: () => true });
+      if (next.status >= 400) break;
+      refreshHops.push(target);
+      url = target;
+      body = asText(next.data);
+      headers = next.headers;
+      statusCode = next.status;
+    } catch {
+      break;
+    }
+  }
+  if (refreshHops.length > 0) {
+    domain = new URL(url).hostname;
+    allIssues.push({
+      code: "META_REFRESH_REDIRECT",
+      severity: "notice",
+      category: "crawlability",
+      title: "Page redirects with a meta refresh",
+      description: `${requestedUrl} answers HTTP 200 with a <meta http-equiv="refresh"> to ${url}, so that page was audited. Search engines follow an instant meta refresh, but a server redirect is the documented way to move a URL and the only one every crawler and tool honours.`,
+      impact: "Some crawlers and link-checking tools stop at the stub; link signals to the original URL may not all pass to the target.",
+      howToFix: "Return a 301 (or 308) redirect from the server or CDN for this URL instead of a meta refresh.",
+      affectedUrls: [requestedUrl],
+      details: { from: requestedUrl, to: url, hops: refreshHops }
+    });
+  }
   const html = body.replace(/<\/?noscript[^>]*>/gi, "");
-  const headers = fetchResult.headers;
-  console.error(`\u{1F4DD} Phase 2: Running synchronous HTML checks (tier: ${tier}, limit: ${checksLimit})...`);
+  console.error("\u{1F4DD} Phase 2: Running HTML checks...");
   const onPageResult = analyzeOnPage(html, url, headers, { auditRoot });
   const structuredDataResult = analyzeStructuredData(html, url);
   const mobileResult = analyzeMobile(html, url);
@@ -18012,10 +18129,10 @@ async function runFullAudit(options) {
     if (cruxApiKey) {
       asyncChecks.push(safeAsyncIssues("Core Web Vitals", async () => {
         const cwv = await fetchCoreWebVitals(url, cruxApiKey);
-        const issues = [];
+        const issues2 = [];
         if (cwv) {
           if (cwv.lcp?.rating === "poor") {
-            issues.push({
+            issues2.push({
               code: "LCP_POOR",
               severity: "error",
               category: "performance",
@@ -18028,7 +18145,7 @@ async function runFullAudit(options) {
             });
           }
           if (cwv.cls?.rating === "poor") {
-            issues.push({
+            issues2.push({
               code: "CLS_POOR",
               severity: "error",
               category: "performance",
@@ -18041,14 +18158,15 @@ async function runFullAudit(options) {
             });
           }
         }
-        return issues;
+        return issues2;
       }));
     }
   }
   const asyncResults = await Promise.all(asyncChecks);
-  for (const issues of asyncResults) {
-    allIssues.push(...issues);
+  for (const issues2 of asyncResults) {
+    allIssues.push(...issues2);
   }
+  const issues = dedupeIssues(allIssues);
   pages.push({
     url,
     statusCode,
@@ -18058,10 +18176,10 @@ async function runFullAudit(options) {
     h1: onPageResult.data.h1s,
     wordCount: onPageResult.data.wordCount,
     loadTime: perfData.loadTime,
-    issues: allIssues.map((i) => i.code)
+    issues: issues.map((i) => i.code)
   });
   console.error("\n\u2705 Audit complete!\n");
-  return createReport(url, domain, allIssues, pages);
+  return createReport(url, domain, issues, pages);
 }
 function createReport(url, domain, issues, pages, pageFailure) {
   const healthScore = calculateHealthScore(issues);
@@ -18226,10 +18344,10 @@ function groupIssuesByCategory(issues) {
 }
 
 // src/audit/checks/duplicate-content.ts
-var cheerio37 = __toESM(require("cheerio"));
+var cheerio38 = __toESM(require("cheerio"));
 var import_crypto = require("crypto");
 function extractContentHash(html, url) {
-  const $ = cheerio37.load(html);
+  const $ = cheerio38.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();
@@ -19457,7 +19575,7 @@ var PRIORITY_WEIGHTS = {
 };
 
 // src/keywords/engine.ts
-var cheerio39 = __toESM(require("cheerio"));
+var cheerio40 = __toESM(require("cheerio"));
 init_http();
 
 // src/keywords/prioritizer.ts
@@ -19754,7 +19872,7 @@ function enrichKeywordsWithEstimates(keywords) {
 
 // src/keywords/sources/free-sources.ts
 init_http();
-var cheerio38 = __toESM(require("cheerio"));
+var cheerio39 = __toESM(require("cheerio"));
 var USER_AGENT = "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36";
 async function getPeopleAlsoAsk(query) {
   try {
@@ -19763,7 +19881,7 @@ async function getPeopleAlsoAsk(query) {
       headers: { "User-Agent": USER_AGENT },
       timeout: 1e4
     });
-    const $ = cheerio38.load(response.data);
+    const $ = cheerio39.load(response.data);
     const questions = [];
     $("[data-sgrd]").each((_, el) => {
       const text = $(el).text().trim();
@@ -19789,7 +19907,7 @@ async function getRelatedSearches(query) {
       headers: { "User-Agent": USER_AGENT },
       timeout: 1e4
     });
-    const $ = cheerio38.load(response.data);
+    const $ = cheerio39.load(response.data);
     const related = [];
     $("div[data-ved] a").each((_, el) => {
       const href = $(el).attr("href");
@@ -19879,7 +19997,7 @@ async function analyzeCompetitorTitles(query) {
       headers: { "User-Agent": USER_AGENT },
       timeout: 1e4
     });
-    const $ = cheerio38.load(response.data);
+    const $ = cheerio39.load(response.data);
     const titles = [];
     const keywords = /* @__PURE__ */ new Set();
     $("h3").each((_, el) => {
@@ -20212,7 +20330,7 @@ async function fetchPageMeta(url) {
     const response = await httpGet(url, {
       timeout: 1e4
     });
-    const $ = cheerio39.load(response.data);
+    const $ = cheerio40.load(response.data);
     return {
       url,
       title: $("title").text().trim() || void 0,
@@ -20343,20 +20461,17 @@ async function extractSeedKeywords(url) {
     const response = await httpGet(url, {
       timeout: 1e4
     });
-    const $ = cheerio39.load(response.data);
+    const $ = cheerio40.load(response.data);
     const seeds = /* @__PURE__ */ new Set();
-    const title = $("title").text().toLowerCase();
-    const titleWords = title.split(/[\s\-|:]+/).filter((w) => w.length > 3);
-    titleWords.forEach((w) => seeds.add(w));
-    const h1 = $("h1").first().text().toLowerCase();
-    const h1Words = h1.split(/[\s\-|:]+/).filter((w) => w.length > 3);
-    h1Words.forEach((w) => seeds.add(w));
+    const words = (text) => text.toLowerCase().split(/[\s\-|:]+/).map((w) => w.replace(/^[^\p{L}\p{N}]+|[^\p{L}\p{N}]+$/gu, "")).filter((w) => w.length > 3);
+    words($("title").text()).forEach((w) => seeds.add(w));
+    words($("h1").first().text()).forEach((w) => seeds.add(w));
     const metaKeywords = $('meta[name="keywords"]').attr("content");
     if (metaKeywords) {
       metaKeywords.split(",").forEach((k) => seeds.add(k.trim().toLowerCase()));
     }
     const desc = $('meta[name="description"]').attr("content")?.toLowerCase() || "";
-    const descWords = desc.split(/\s+/).filter((w) => w.length > 5);
+    const descWords = words(desc).filter((w) => w.length > 5);
     descWords.slice(0, 5).forEach((w) => seeds.add(w));
     return Array.from(seeds).slice(0, 10);
   } catch {
@@ -20409,7 +20524,7 @@ function parseJsonReply(text) {
 }
 
 // src/keywords/site-crawler.ts
-var cheerio40 = __toESM(require("cheerio"));
+var cheerio41 = __toESM(require("cheerio"));
 init_http();
 var EXCLUDED_PATHS = [
   "/cdn-cgi/",
@@ -20522,7 +20637,7 @@ async function crawlPage(url, timeout) {
     validateStatus: (status) => status === 200
   });
   const html = response.data;
-  const $ = cheerio40.load(html);
+  const $ = cheerio41.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() || "";
@@ -23158,7 +23273,7 @@ function getDateRange(days = 28) {
 
 // src/keywords/sources/competitor-analysis.ts
 init_http();
-var cheerio41 = __toESM(require("cheerio"));
+var cheerio42 = __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();
@@ -23255,7 +23370,7 @@ async function analyzeSERP(query) {
       headers: { "User-Agent": USER_AGENT2 },
       timeout: 1e4
     });
-    const $ = cheerio41.load(response.data);
+    const $ = cheerio42.load(response.data);
     const results = [];
     const relatedSearches = [];
     const peopleAlsoAsk = [];
@@ -23708,7 +23823,7 @@ function formatTopicReport(result) {
 
 // src/content/readability.ts
 function analyzeReadability(text) {
-  const cleanText = text.replace(/<[^>]*>/g, " ").replace(/\s+/g, " ").trim();
+  const cleanText = text.replace(/<[^>]*>/g, " ").replace(/[ \t\r\f\v]+/g, " ").replace(/ ?\n ?/g, "\n").replace(/\n{3,}/g, "\n\n").trim();
   const words = getWords(cleanText);
   const sentences = getSentences(cleanText);
   const paragraphs = getParagraphs(cleanText);
@@ -23777,7 +23892,7 @@ function getSentences(text) {
   return text.split(/[.!?]+/).filter((s) => s.trim().length > 0);
 }
 function getParagraphs(text) {
-  return text.split(/\n\n+/).filter((p) => p.trim().length > 0);
+  return text.split(/\n\n+/).filter((p) => p.trim().split(/\s+/).length >= 3);
 }
 function countSyllables(word) {
   word = word.toLowerCase().replace(/[^a-z]/g, "");
@@ -36062,6 +36177,7 @@ var SUPPORTED_FRAMEWORKS = [
   LOCATION_CODES,
   OG_IMAGE_SPECS,
   PRIORITY_WEIGHTS,
+  REDUNDANT_WHEN_PRESENT,
   RankTracker,
   SEO_SCOPES,
   SITE_PROFILE_QUESTIONS,
@@ -36145,6 +36261,7 @@ var SUPPORTED_FRAMEWORKS = [
   createPullRequest,
   createSEOCommit,
   createSEOCommits,
+  dedupeIssues,
   describeConcerns,
   detectDuplicates,
   detectFramework,
@@ -36281,6 +36398,7 @@ var SUPPORTED_FRAMEWORKS = [
   loadAgent,
   loadAgentByName,
   mergePages,
+  metaRefreshTarget,
   openAIKeywordLLM,
   optimizeForAI,
   optimizeReadme,