aeo.js 0.0.2 → 0.0.3

package/dist/index.mjs

@@ -4,8 +4,25 @@ import 'minimatch';
 import { createHash } from 'crypto';
 
 // src/core/utils.ts
+function validateConfig(config) {
+  var _a;
+  const warnings = [];
+  if (config.url && !/^https?:\/\//.test(config.url)) {
+    warnings.push(`url "${config.url}" should start with http:// or https://`);
+  }
+  if (config.url === "https://example.com") {
+    warnings.push('url is set to the default "https://example.com" \u2014 set your actual site URL');
+  }
+  if (!config.title) {
+    warnings.push('title is not set \u2014 your generated files will use "My Site"');
+  }
+  if (((_a = config.robots) == null ? void 0 : _a.crawlDelay) && config.robots.crawlDelay < 0) {
+    warnings.push("robots.crawlDelay should be a positive number");
+  }
+  return warnings;
+}
 function resolveConfig(config = {}) {
-  var _a, _b, _c, _d, _e, _f, _g, _h, _i, _j, _k, _l, _m, _n, _o, _p, _q, _r, _s, _t, _u, _v, _w, _x;
+  var _a, _b, _c, _d, _e, _f, _g, _h, _i, _j, _k, _l, _m, _n, _o, _p, _q, _r, _s, _t, _u, _v, _w, _x, _y, _z, _A, _B, _C, _D, _E, _F, _G, _H, _I, _J, _K, _L, _M;
   const frameworkInfo = detectFramework();
   return {
     title: config.title || "My Site",
@@ -21,26 +38,43 @@ function resolveConfig(config = {}) {
       rawMarkdown: ((_d = config.generators) == null ? void 0 : _d.rawMarkdown) !== false,
       manifest: ((_e = config.generators) == null ? void 0 : _e.manifest) !== false,
       sitemap: ((_f = config.generators) == null ? void 0 : _f.sitemap) !== false,
-      aiIndex: ((_g = config.generators) == null ? void 0 : _g.aiIndex) !== false
+      aiIndex: ((_g = config.generators) == null ? void 0 : _g.aiIndex) !== false,
+      schema: ((_h = config.generators) == null ? void 0 : _h.schema) !== false
     },
     robots: {
-      allow: ((_h = config.robots) == null ? void 0 : _h.allow) || ["/"],
-      disallow: ((_i = config.robots) == null ? void 0 : _i.disallow) || [],
-      crawlDelay: ((_j = config.robots) == null ? void 0 : _j.crawlDelay) || 0,
-      sitemap: ((_k = config.robots) == null ? void 0 : _k.sitemap) || ""
+      allow: ((_i = config.robots) == null ? void 0 : _i.allow) || ["/"],
+      disallow: ((_j = config.robots) == null ? void 0 : _j.disallow) || [],
+      crawlDelay: ((_k = config.robots) == null ? void 0 : _k.crawlDelay) || 0,
+      sitemap: ((_l = config.robots) == null ? void 0 : _l.sitemap) || ""
+    },
+    schema: {
+      enabled: ((_m = config.schema) == null ? void 0 : _m.enabled) !== false,
+      organization: {
+        name: ((_o = (_n = config.schema) == null ? void 0 : _n.organization) == null ? void 0 : _o.name) || config.title || "My Site",
+        url: ((_q = (_p = config.schema) == null ? void 0 : _p.organization) == null ? void 0 : _q.url) || config.url || "https://example.com",
+        logo: ((_s = (_r = config.schema) == null ? void 0 : _r.organization) == null ? void 0 : _s.logo) || "",
+        sameAs: ((_u = (_t = config.schema) == null ? void 0 : _t.organization) == null ? void 0 : _u.sameAs) || []
+      },
+      defaultType: ((_v = config.schema) == null ? void 0 : _v.defaultType) || "WebPage"
+    },
+    og: {
+      enabled: ((_w = config.og) == null ? void 0 : _w.enabled) !== false,
+      image: ((_x = config.og) == null ? void 0 : _x.image) || "",
+      twitterHandle: ((_y = config.og) == null ? void 0 : _y.twitterHandle) || "",
+      type: ((_z = config.og) == null ? void 0 : _z.type) || "website"
     },
     widget: {
-      enabled: ((_l = config.widget) == null ? void 0 : _l.enabled) !== false,
-      position: ((_m = config.widget) == null ? void 0 : _m.position) || "bottom-right",
+      enabled: ((_A = config.widget) == null ? void 0 : _A.enabled) !== false,
+      position: ((_B = config.widget) == null ? void 0 : _B.position) || "bottom-right",
       theme: {
-        background: ((_o = (_n = config.widget) == null ? void 0 : _n.theme) == null ? void 0 : _o.background) || "rgba(18, 18, 24, 0.9)",
-        text: ((_q = (_p = config.widget) == null ? void 0 : _p.theme) == null ? void 0 : _q.text) || "#C0C0C5",
-        accent: ((_s = (_r = config.widget) == null ? void 0 : _r.theme) == null ? void 0 : _s.accent) || "#E8E8EA",
-        badge: ((_u = (_t = config.widget) == null ? void 0 : _t.theme) == null ? void 0 : _u.badge) || "#4ADE80"
+        background: ((_D = (_C = config.widget) == null ? void 0 : _C.theme) == null ? void 0 : _D.background) || "rgba(18, 18, 24, 0.9)",
+        text: ((_F = (_E = config.widget) == null ? void 0 : _E.theme) == null ? void 0 : _F.text) || "#C0C0C5",
+        accent: ((_H = (_G = config.widget) == null ? void 0 : _G.theme) == null ? void 0 : _H.accent) || "#E8E8EA",
+        badge: ((_J = (_I = config.widget) == null ? void 0 : _I.theme) == null ? void 0 : _J.badge) || "#4ADE80"
       },
-      humanLabel: ((_v = config.widget) == null ? void 0 : _v.humanLabel) || "Human",
-      aiLabel: ((_w = config.widget) == null ? void 0 : _w.aiLabel) || "AI",
-      showBadge: ((_x = config.widget) == null ? void 0 : _x.showBadge) !== false
+      humanLabel: ((_K = config.widget) == null ? void 0 : _K.humanLabel) || "Human",
+      aiLabel: ((_L = config.widget) == null ? void 0 : _L.aiLabel) || "AI",
+      showBadge: ((_M = config.widget) == null ? void 0 : _M.showBadge) !== false
     }
   };
 }
@@ -496,8 +530,8 @@ function generatePageMarkdownFiles(config) {
   const generated = [];
   const pages = config.pages || [];
   for (const page of pages) {
+    if (!page.content) continue;
     const pageTitle = page.title || (page.pathname === "/" ? config.title : void 0);
-    if (!page.content && !pageTitle) continue;
     let filename;
     if (page.pathname === "/") {
       filename = "index.md";
@@ -767,6 +801,147 @@ function generateAIIndex(config) {
   };
   return JSON.stringify(index, null, 2);
 }
+
+// src/core/schema.ts
+function generateSchema(config) {
+  const output = generateSchemaObjects(config);
+  return JSON.stringify(output, null, 2);
+}
+function generateSchemaObjects(config) {
+  const siteSchemas = generateSiteSchemas(config);
+  const pageSchemas = {};
+  for (const page of config.pages) {
+    const schemas = generatePageSchemas(page, config);
+    if (schemas.length > 0) {
+      pageSchemas[page.pathname] = schemas;
+    }
+  }
+  return { site: siteSchemas, pages: pageSchemas };
+}
+function generateSiteSchemas(config) {
+  const schemas = [];
+  schemas.push({
+    "@context": "https://schema.org",
+    "@type": "WebSite",
+    name: config.title,
+    description: config.description || void 0,
+    url: config.url
+  });
+  const org = config.schema.organization;
+  if (org.name || org.sameAs.length > 0) {
+    const orgSchema = {
+      "@context": "https://schema.org",
+      "@type": "Organization",
+      name: org.name,
+      url: org.url
+    };
+    if (org.logo) orgSchema.logo = org.logo;
+    if (org.sameAs.length > 0) orgSchema.sameAs = org.sameAs;
+    schemas.push(orgSchema);
+  }
+  return schemas;
+}
+function generatePageSchemas(page, config) {
+  const schemas = [];
+  const pageUrl = page.pathname === "/" ? config.url : `${config.url.replace(/\/$/, "")}${page.pathname}`;
+  const faqItems = detectFaqPatterns(page.content || "");
+  if (faqItems.length > 0) {
+    schemas.push({
+      "@context": "https://schema.org",
+      "@type": "FAQPage",
+      mainEntity: faqItems.map(({ question, answer }) => ({
+        "@type": "Question",
+        name: question,
+        acceptedAnswer: {
+          "@type": "Answer",
+          text: answer
+        }
+      }))
+    });
+  }
+  const pageType = config.schema.defaultType;
+  const pageSchema = {
+    "@context": "https://schema.org",
+    "@type": pageType,
+    name: page.title || config.title,
+    url: pageUrl
+  };
+  if (page.description) pageSchema.description = page.description;
+  if (pageType === "Article") {
+    pageSchema.headline = page.title || config.title;
+    pageSchema.author = {
+      "@type": "Organization",
+      name: config.schema.organization.name
+    };
+  }
+  schemas.push(pageSchema);
+  if (page.pathname !== "/") {
+    const breadcrumbs = generateBreadcrumbs(page.pathname, config);
+    if (breadcrumbs.length > 1) {
+      schemas.push({
+        "@context": "https://schema.org",
+        "@type": "BreadcrumbList",
+        itemListElement: breadcrumbs.map((crumb, i) => ({
+          "@type": "ListItem",
+          position: i + 1,
+          name: crumb.name,
+          item: crumb.url
+        }))
+      });
+    }
+  }
+  return schemas;
+}
+function generateBreadcrumbs(pathname, config) {
+  const baseUrl = config.url.replace(/\/$/, "");
+  const parts = pathname.split("/").filter(Boolean);
+  const crumbs = [
+    { name: "Home", url: baseUrl + "/" }
+  ];
+  let currentPath = "";
+  for (const part of parts) {
+    currentPath += "/" + part;
+    crumbs.push({
+      name: part.charAt(0).toUpperCase() + part.slice(1).replace(/-/g, " "),
+      url: baseUrl + currentPath
+    });
+  }
+  return crumbs;
+}
+function detectFaqPatterns(content) {
+  const items = [];
+  const lines = content.split("\n");
+  for (let i = 0; i < lines.length; i++) {
+    const line = lines[i].trim();
+    const headingMatch = line.match(/^#{1,6}\s+(.+\?)\s*$/);
+    if (headingMatch) {
+      const answerLines = [];
+      for (let j = i + 1; j < lines.length; j++) {
+        const nextLine = lines[j].trim();
+        if (!nextLine) {
+          if (answerLines.length > 0) break;
+          continue;
+        }
+        if (/^#{1,6}\s/.test(nextLine)) break;
+        answerLines.push(nextLine);
+      }
+      if (answerLines.length > 0) {
+        items.push({
+          question: headingMatch[1],
+          answer: answerLines.join(" ").slice(0, 500)
+        });
+      }
+    }
+  }
+  return items;
+}
+function generateJsonLdScript(schemas) {
+  if (schemas.length === 0) return "";
+  if (schemas.length === 1) {
+    return `<script type="application/ld+json">${JSON.stringify(schemas[0])}</script>`;
+  }
+  return schemas.map((s) => `<script type="application/ld+json">${JSON.stringify(s)}</script>`).join("\n");
+}
 async function generateAEOFiles(configOrRoot, maybeConfig) {
   var _a;
   let config;
@@ -795,7 +970,7 @@ async function generateAEOFiles(configOrRoot, maybeConfig) {
   if (config.generators.llmsTxt) {
     try {
       const content = generateLlmsTxt(config);
-      writeFileSync(join(outDir, "llms.txt"), "\uFEFF" + content, "utf-8");
+      writeFileSync(join(outDir, "llms.txt"), content, "utf-8");
       files.push("llms.txt");
     } catch (e) {
       errors.push(`llms.txt: ${e.message}`);
@@ -804,7 +979,7 @@ async function generateAEOFiles(configOrRoot, maybeConfig) {
   if (config.generators.llmsFullTxt) {
     try {
       const content = generateLlmsFullTxt(config);
-      writeFileSync(join(outDir, "llms-full.txt"), "\uFEFF" + content, "utf-8");
+      writeFileSync(join(outDir, "llms-full.txt"), content, "utf-8");
       files.push("llms-full.txt");
     } catch (e) {
       errors.push(`llms-full.txt: ${e.message}`);
@@ -855,15 +1030,772 @@ async function generateAEOFiles(configOrRoot, maybeConfig) {
       errors.push(`ai-index.json: ${e.message}`);
     }
   }
+  if (config.generators.schema && config.schema.enabled) {
+    try {
+      const content = generateSchema(config);
+      writeFileSync(join(outDir, "schema.json"), content, "utf-8");
+      files.push("schema.json");
+    } catch (e) {
+      errors.push(`schema.json: ${e.message}`);
+    }
+  }
   return { files, errors };
 }
 
+// src/core/html-extract.ts
+function extractTextFromHtml(html) {
+  let text = html;
+  text = text.replace(/<script[\s\S]*?<\/script>/gi, "");
+  text = text.replace(/<style[\s\S]*?<\/style>/gi, "");
+  text = text.replace(/<svg[\s\S]*?<\/svg>/gi, "");
+  const mainMatch = text.match(/<main[^>]*>([\s\S]*)<\/main>/i);
+  if (mainMatch) {
+    text = mainMatch[1];
+  } else {
+    text = text.replace(/<nav[\s\S]*?<\/nav>/gi, "");
+    text = text.replace(/<header[\s\S]*?<\/header>/gi, "");
+    text = text.replace(/<footer[\s\S]*?<\/footer>/gi, "");
+  }
+  text = text.replace(/<a[^>]+href=["']([^"']*)["'][^>]*>([\s\S]*?)<\/a>/gi, (_, url, inner) => {
+    if (/<(?:h[1-6]|div|p|section)[^>]*>/i.test(inner)) {
+      const cleanInner = inner.replace(/<[^>]+>/g, " ").replace(/\s+/g, " ").trim();
+      return `
+[${cleanInner.slice(0, 120).trim()}](${url})
+`;
+    }
+    return `[${inner}](${url})`;
+  });
+  text = text.replace(/<h1[^>]*>([\s\S]*?)<\/h1>/gi, "\n\n## $1\n\n");
+  text = text.replace(/<h2[^>]*>([\s\S]*?)<\/h2>/gi, "\n\n## $1\n\n");
+  text = text.replace(/<h3[^>]*>([\s\S]*?)<\/h3>/gi, "\n\n### $1\n\n");
+  text = text.replace(/<h4[^>]*>([\s\S]*?)<\/h4>/gi, "\n\n#### $1\n\n");
+  text = text.replace(/<h5[^>]*>([\s\S]*?)<\/h5>/gi, "\n\n##### $1\n\n");
+  text = text.replace(/<h6[^>]*>([\s\S]*?)<\/h6>/gi, "\n\n###### $1\n\n");
+  text = text.replace(/<a[^>]+href=["']([^"']*)["'][^>]*>([\s\S]*?)<\/a>/gi, "[$2]($1)");
+  text = text.replace(/<(?:strong|b)[^>]*>([\s\S]*?)<\/(?:strong|b)>/gi, "**$1**");
+  text = text.replace(/<(?:em|i)[^>]*>([\s\S]*?)<\/(?:em|i)>/gi, "*$1*");
+  text = text.replace(/<li[^>]*>([\s\S]*?)<\/li>/gi, "\n- $1");
+  text = text.replace(/<blockquote[^>]*>([\s\S]*?)<\/blockquote>/gi, "\n\n> $1\n\n");
+  text = text.replace(/<hr[^>]*\/?>/gi, "\n\n---\n\n");
+  text = text.replace(/<br[^>]*\/?>/gi, "\n");
+  text = text.replace(/<\/p>/gi, "\n\n");
+  text = text.replace(/<p[^>]*>/gi, "");
+  text = text.replace(/<\/?(?:div|section|article|header|main|aside|figure|figcaption|table|thead|tbody|tr|td|th|ul|ol|dl|dt|dd)[^>]*>/gi, "\n");
+  text = text.replace(/<[^>]+>/g, "");
+  text = text.replace(/&amp;/g, "&").replace(/&lt;/g, "<").replace(/&gt;/g, ">").replace(/&quot;/g, '"').replace(/&#39;/g, "'").replace(/&nbsp;/g, " ").replace(/&copy;/g, "(c)");
+  text = text.replace(/[\u{1F1E0}-\u{1FAFF}\u{2600}-\u{27BF}\u{FE00}-\u{FE0F}\u{200D}\u{20E3}]/gu, "");
+  text = text.split("\n").map((l) => l.replace(/\s+/g, " ").trim()).join("\n");
+  text = text.replace(/\n{3,}/g, "\n\n");
+  text = text.replace(/\[[\s\n]+/g, "[").replace(/[\s\n]+\]/g, "]");
+  text = text.replace(/(#{2,6})\s*\n+\s*/g, "$1 ");
+  text = text.replace(/^#{2,6}\s*$/gm, "");
+  text = text.replace(/\n{3,}/g, "\n\n");
+  return text.trim().slice(0, 8e3);
+}
+function extractTitle2(html) {
+  var _a, _b;
+  const match = html.match(/<title>([^<]*)<\/title>/i);
+  if (!match) return void 0;
+  return ((_b = (_a = match[1]) == null ? void 0 : _a.split("|")[0]) == null ? void 0 : _b.trim()) || match[1];
+}
+function extractDescription(html) {
+  const match = html.match(/<meta\s+name=["']description["']\s+content=["']([^"']*)["']/i);
+  return match == null ? void 0 : match[1];
+}
+function extractJsonLd(html) {
+  const schemas = [];
+  const regex = /<script\s+type=["']application\/ld\+json["'][^>]*>([\s\S]*?)<\/script>/gi;
+  let match;
+  while ((match = regex.exec(html)) !== null) {
+    try {
+      const parsed = JSON.parse(match[1]);
+      schemas.push(parsed);
+    } catch {
+    }
+  }
+  return schemas;
+}
+function htmlToMarkdown(html, pagePath, config) {
+  const rawTitle = extractTitle2(html);
+  const description = extractDescription(html);
+  const textContent = extractTextFromHtml(html);
+  const pageUrl = pagePath === "/" ? config.url : `${config.url.replace(/\/$/, "")}${pagePath}`;
+  const lines = [];
+  lines.push("---");
+  if (rawTitle) lines.push(`title: "${rawTitle}"`);
+  if (description) lines.push(`description: "${description}"`);
+  lines.push(`url: ${pageUrl}`);
+  lines.push(`source: ${pageUrl}`);
+  lines.push(`generated_by: aeo.js`);
+  lines.push("---", "");
+  if (rawTitle) lines.push(`# ${rawTitle}`, "");
+  if (description) lines.push(`${description}`, "");
+  if (textContent) lines.push(textContent);
+  return lines.join("\n");
+}
+
+// src/core/opengraph.ts
+function generateOGTags(page, config) {
+  const tags = [];
+  const pageUrl = page.pathname === "/" ? config.url : `${config.url.replace(/\/$/, "")}${page.pathname}`;
+  const title = page.title || config.title;
+  const description = page.description || config.description;
+  tags.push({ property: "og:type", content: config.og.type });
+  tags.push({ property: "og:title", content: title });
+  if (description) tags.push({ property: "og:description", content: description });
+  tags.push({ property: "og:url", content: pageUrl });
+  tags.push({ property: "og:site_name", content: config.title });
+  if (config.og.image) tags.push({ property: "og:image", content: config.og.image });
+  tags.push({ name: "twitter:card", content: config.og.image ? "summary_large_image" : "summary" });
+  tags.push({ name: "twitter:title", content: title });
+  if (description) tags.push({ name: "twitter:description", content: description });
+  if (config.og.twitterHandle) tags.push({ name: "twitter:site", content: config.og.twitterHandle });
+  if (config.og.image) tags.push({ name: "twitter:image", content: config.og.image });
+  return tags;
+}
+function generateOGTagsHtml(page, config) {
+  const tags = generateOGTags(page, config);
+  return tags.map((tag) => {
+    if (tag.property) return `<meta property="${tag.property}" content="${escapeAttr(tag.content)}" />`;
+    return `<meta name="${tag.name}" content="${escapeAttr(tag.content)}" />`;
+  }).join("\n    ");
+}
+function escapeAttr(str) {
+  return str.replace(/&/g, "&amp;").replace(/"/g, "&quot;").replace(/</g, "&lt;").replace(/>/g, "&gt;");
+}
+
+// src/core/audit.ts
+function auditSite(config) {
+  const categories = [];
+  const issues = [];
+  const suggestions = [];
+  categories.push(auditAIAccess(config, issues));
+  categories.push(auditContentStructure(config, issues, suggestions));
+  categories.push(auditSchemaPresence(config, issues, suggestions));
+  categories.push(auditMetaQuality(config, issues, suggestions));
+  categories.push(auditCitability(config, issues, suggestions));
+  const score = categories.reduce((sum, c) => sum + c.score, 0);
+  return { score, categories, issues, suggestions };
+}
+function auditAIAccess(config, issues) {
+  const checks = [];
+  config.outDir;
+  const robotsEnabled = config.generators.robotsTxt;
+  checks.push({ label: "robots.txt generation enabled", passed: robotsEnabled, points: robotsEnabled ? 4 : 0 });
+  if (!robotsEnabled) {
+    issues.push({ category: "AI Access", severity: "error", message: "robots.txt generation is disabled", fix: "Set generators.robotsTxt: true" });
+  }
+  const llmsEnabled = config.generators.llmsTxt;
+  checks.push({ label: "llms.txt generation enabled", passed: llmsEnabled, points: llmsEnabled ? 4 : 0 });
+  if (!llmsEnabled) {
+    issues.push({ category: "AI Access", severity: "error", message: "llms.txt generation is disabled \u2014 AI crawlers won't find your content summary", fix: "Set generators.llmsTxt: true" });
+  }
+  const sitemapEnabled = config.generators.sitemap;
+  checks.push({ label: "sitemap.xml generation enabled", passed: sitemapEnabled, points: sitemapEnabled ? 4 : 0 });
+  if (!sitemapEnabled) {
+    issues.push({ category: "AI Access", severity: "warning", message: "sitemap.xml generation is disabled", fix: "Set generators.sitemap: true" });
+  }
+  const aiIndexEnabled = config.generators.aiIndex;
+  checks.push({ label: "ai-index.json generation enabled", passed: aiIndexEnabled, points: aiIndexEnabled ? 4 : 0 });
+  if (!aiIndexEnabled) {
+    issues.push({ category: "AI Access", severity: "warning", message: "ai-index.json generation is disabled", fix: "Set generators.aiIndex: true" });
+  }
+  const hasBlockingRules = config.robots.disallow.includes("/") || config.robots.disallow.includes("/*");
+  const noBlocking = !hasBlockingRules;
+  checks.push({ label: "No blanket disallow rules blocking AI crawlers", passed: noBlocking, points: noBlocking ? 4 : 0 });
+  if (hasBlockingRules) {
+    issues.push({ category: "AI Access", severity: "error", message: "robots.txt has blanket disallow (/ or /*) which blocks AI crawlers", fix: "Remove overly broad disallow rules from robots.disallow" });
+  }
+  return {
+    name: "AI Access",
+    score: checks.reduce((s, c) => s + c.points, 0),
+    maxScore: 20,
+    checks
+  };
+}
+function auditContentStructure(config, issues, suggestions) {
+  const checks = [];
+  const pages = config.pages;
+  const hasPages = pages.length > 0;
+  checks.push({ label: "Pages are defined", passed: hasPages, points: hasPages ? 4 : 0 });
+  if (!hasPages) {
+    issues.push({ category: "Content Structure", severity: "error", message: "No pages defined \u2014 AEO files will have no content", fix: "Add pages to your config or ensure your framework plugin scans pages" });
+  }
+  const pagesWithContent = pages.filter((p) => p.content && p.content.length > 50);
+  const hasContent = pagesWithContent.length > 0;
+  checks.push({ label: "Pages have extractable content", passed: hasContent, points: hasContent ? 4 : 0 });
+  if (!hasContent && hasPages) {
+    issues.push({ category: "Content Structure", severity: "warning", message: "No pages have substantial text content (>50 chars)", fix: "Ensure pages have meaningful text content for AI extraction" });
+  }
+  const headingPattern = /^#{1,6}\s|<h[1-6]/m;
+  const pagesWithHeadings = pagesWithContent.filter((p) => headingPattern.test(p.content || ""));
+  const hasHeadings = pagesWithHeadings.length >= Math.max(1, Math.floor(pagesWithContent.length * 0.5));
+  checks.push({ label: "Content uses heading hierarchy", passed: hasHeadings, points: hasHeadings ? 4 : 0 });
+  if (!hasHeadings && pagesWithContent.length > 0) {
+    suggestions.push("Add structured headings (H1-H6) to improve AI content extraction");
+  }
+  const goodParagraphLength = pagesWithContent.every((p) => {
+    const paragraphs = (p.content || "").split(/\n\n+/).filter((p2) => p2.trim().length > 20);
+    if (paragraphs.length === 0) return true;
+    const avgWords = paragraphs.reduce((sum, para) => sum + para.split(/\s+/).length, 0) / paragraphs.length;
+    return avgWords <= 200;
+  });
+  checks.push({ label: "Paragraphs are reasonable length (<200 words avg)", passed: goodParagraphLength, points: goodParagraphLength ? 4 : 0 });
+  if (!goodParagraphLength) {
+    suggestions.push("Break up long paragraphs (>200 words) for better AI extraction \u2014 aim for 100-167 words");
+  }
+  const multiplePages = pages.length >= 3;
+  checks.push({ label: "Site has 3+ pages for comprehensive coverage", passed: multiplePages, points: multiplePages ? 4 : 0 });
+  if (!multiplePages && hasPages) {
+    suggestions.push("Add more pages to improve site coverage for AI crawlers");
+  }
+  return {
+    name: "Content Structure",
+    score: checks.reduce((s, c) => s + c.points, 0),
+    maxScore: 20,
+    checks
+  };
+}
+function auditSchemaPresence(config, issues, suggestions) {
+  const checks = [];
+  const schemaEnabled = config.schema.enabled && config.generators.schema;
+  checks.push({ label: "Schema.org/JSON-LD generation enabled", passed: schemaEnabled, points: schemaEnabled ? 4 : 0 });
+  if (!schemaEnabled) {
+    issues.push({ category: "Schema Presence", severity: "error", message: "Schema.org generation is disabled", fix: "Set schema.enabled: true and generators.schema: true" });
+  }
+  const hasOrgName = config.schema.organization.name !== "" && config.schema.organization.name !== "My Site";
+  checks.push({ label: "Organization name configured", passed: hasOrgName, points: hasOrgName ? 4 : 0 });
+  if (!hasOrgName) {
+    issues.push({ category: "Schema Presence", severity: "warning", message: "Organization name is not configured (using default)", fix: "Set schema.organization.name to your actual organization name" });
+  }
+  const hasLogo = !!config.schema.organization.logo;
+  checks.push({ label: "Organization logo URL set", passed: hasLogo, points: hasLogo ? 4 : 0 });
+  if (!hasLogo) {
+    suggestions.push("Add schema.organization.logo for richer search results and AI knowledge");
+  }
+  const hasSameAs = config.schema.organization.sameAs.length > 0;
+  checks.push({ label: "Social profiles linked (sameAs)", passed: hasSameAs, points: hasSameAs ? 4 : 0 });
+  if (!hasSameAs) {
+    issues.push({ category: "Schema Presence", severity: "warning", message: "No social profiles (sameAs) \u2014 critical for GEO/E-E-A-T signals", fix: "Add schema.organization.sameAs with social profile URLs" });
+  }
+  const hasRealUrl = config.url !== "https://example.com" && config.url !== "";
+  checks.push({ label: "Site URL is configured (not default)", passed: hasRealUrl, points: hasRealUrl ? 4 : 0 });
+  if (!hasRealUrl) {
+    issues.push({ category: "Schema Presence", severity: "error", message: "Site URL is still the default (https://example.com)", fix: "Set url to your actual site URL" });
+  }
+  return {
+    name: "Schema Presence",
+    score: checks.reduce((s, c) => s + c.points, 0),
+    maxScore: 20,
+    checks
+  };
+}
+function auditMetaQuality(config, issues, suggestions) {
+  const checks = [];
+  const titleLen = config.title.length;
+  const goodTitle = titleLen >= 10 && titleLen <= 70;
+  checks.push({ label: "Site title is 10-70 characters", passed: goodTitle, points: goodTitle ? 4 : 0 });
+  if (titleLen < 10) {
+    issues.push({ category: "Meta Quality", severity: "warning", message: `Site title is too short (${titleLen} chars)`, fix: "Use a descriptive title between 10-70 characters" });
+  } else if (titleLen > 70) {
+    suggestions.push(`Site title is long (${titleLen} chars) \u2014 consider shortening to under 70`);
+  }
+  const descLen = config.description.length;
+  const goodDesc = descLen >= 50 && descLen <= 200;
+  checks.push({ label: "Site description is 50-200 characters", passed: goodDesc, points: goodDesc ? 4 : 0 });
+  if (descLen === 0) {
+    issues.push({ category: "Meta Quality", severity: "error", message: "No site description configured", fix: "Add a description (50-200 characters)" });
+  } else if (descLen < 50) {
+    issues.push({ category: "Meta Quality", severity: "warning", message: `Description is too short (${descLen} chars)`, fix: "Expand description to 50-200 characters" });
+  }
+  const ogEnabled = config.og.enabled;
+  checks.push({ label: "Open Graph meta tags enabled", passed: ogEnabled, points: ogEnabled ? 4 : 0 });
+  if (!ogEnabled) {
+    issues.push({ category: "Meta Quality", severity: "warning", message: "OG meta tags are disabled \u2014 social sharing and AI previews will be limited", fix: "Set og.enabled: true" });
+  }
+  const pagesWithTitles = config.pages.filter((p) => p.title && p.title.length > 0);
+  const titleCoverage = config.pages.length > 0 ? pagesWithTitles.length / config.pages.length : 0;
+  const goodTitleCoverage = titleCoverage >= 0.8;
+  checks.push({ label: "80%+ of pages have titles", passed: goodTitleCoverage, points: goodTitleCoverage ? 4 : 0 });
+  if (!goodTitleCoverage && config.pages.length > 0) {
+    issues.push({ category: "Meta Quality", severity: "warning", message: `Only ${pagesWithTitles.length}/${config.pages.length} pages have titles`, fix: "Add titles to all pages" });
+  }
+  const pagesWithDesc = config.pages.filter((p) => p.description && p.description.length > 0);
+  const descCoverage = config.pages.length > 0 ? pagesWithDesc.length / config.pages.length : 0;
+  const goodDescCoverage = descCoverage >= 0.5;
+  checks.push({ label: "50%+ of pages have descriptions", passed: goodDescCoverage, points: goodDescCoverage ? 4 : 0 });
+  if (!goodDescCoverage && config.pages.length > 0) {
+    suggestions.push(`Only ${pagesWithDesc.length}/${config.pages.length} pages have descriptions \u2014 add per-page descriptions`);
+  }
+  return {
+    name: "Meta Quality",
+    score: checks.reduce((s, c) => s + c.points, 0),
+    maxScore: 20,
+    checks
+  };
+}
+function auditCitability(config, issues, suggestions) {
+  const checks = [];
+  const allContent = config.pages.map((p) => p.content || "").join("\n\n");
+  const directAnswerPattern = /^[A-Z][^.!?]{20,150}[.!?]/m;
+  const hasDirectAnswers = directAnswerPattern.test(allContent);
+  checks.push({ label: "Content has direct answer patterns", passed: hasDirectAnswers, points: hasDirectAnswers ? 4 : 0 });
+  if (!hasDirectAnswers) {
+    suggestions.push("Add self-contained factual statements that AI can cite directly");
+  }
+  const statPattern = /\d+%|\$[\d,.]+|\d{4}|\d+\s*(million|billion|thousand|users|customers|downloads)/i;
+  const hasStats = statPattern.test(allContent);
+  checks.push({ label: "Content includes statistics/factual claims", passed: hasStats, points: hasStats ? 4 : 0 });
+  if (!hasStats) {
+    suggestions.push("Include concrete statistics, numbers, and dates \u2014 AI favors content with factual claims");
+  }
+  const faqPattern = /^#{1,6}\s+.+\?\s*$/m;
+  const hasFaq = faqPattern.test(allContent);
+  checks.push({ label: "Content has FAQ patterns (question headings)", passed: hasFaq, points: hasFaq ? 4 : 0 });
+  if (!hasFaq) {
+    suggestions.push("Add FAQ sections with question headings \u2014 these generate FAQPage schema automatically");
+  }
+  const listPattern = /^[\s]*[-*+]\s|^\d+\.\s/m;
+  const hasLists = listPattern.test(allContent);
+  checks.push({ label: "Content uses lists for structured information", passed: hasLists, points: hasLists ? 4 : 0 });
+  if (!hasLists) {
+    suggestions.push("Use bullet or numbered lists for key information \u2014 improves AI extraction");
+  }
+  const wordCount = allContent.split(/\s+/).filter((w) => w.length > 0).length;
+  const substantialContent = wordCount >= 500;
+  checks.push({ label: "Total content is substantial (500+ words)", passed: substantialContent, points: substantialContent ? 4 : 0 });
+  if (!substantialContent) {
+    issues.push({ category: "Citability", severity: "warning", message: `Total content is only ${wordCount} words`, fix: "Add more content \u2014 aim for at least 500 words across all pages" });
+  }
+  return {
+    name: "Citability",
+    score: checks.reduce((s, c) => s + c.points, 0),
+    maxScore: 20,
+    checks
+  };
+}
+function formatAuditReport(result) {
+  const lines = [];
+  const grade = getGrade(result.score);
+  lines.push(`GEO Readiness Score: ${result.score}/100 (${grade})`);
+  lines.push("\u2550".repeat(50));
+  lines.push("");
+  for (const cat of result.categories) {
+    lines.push(`${cat.name}: ${cat.score}/${cat.maxScore}`);
+    const bar = "\u2588".repeat(cat.score) + "\u2591".repeat(cat.maxScore - cat.score);
+    lines.push(`  ${bar}`);
+    for (const check of cat.checks) {
+      lines.push(`  ${check.passed ? "+" : "-"} ${check.label}`);
+    }
+    lines.push("");
+  }
+  if (result.issues.length > 0) {
+    lines.push("Issues:");
+    for (const issue of result.issues) {
+      const icon = issue.severity === "error" ? "!" : issue.severity === "warning" ? "~" : "i";
+      lines.push(`  ${icon} [${issue.category}] ${issue.message}`);
+      if (issue.fix) lines.push(`    Fix: ${issue.fix}`);
+    }
+    lines.push("");
+  }
+  if (result.suggestions.length > 0) {
+    lines.push("Suggestions:");
+    for (const suggestion of result.suggestions) {
+      lines.push(`  * ${suggestion}`);
+    }
+    lines.push("");
+  }
+  return lines.join("\n");
+}
+function getGrade(score) {
+  if (score >= 90) return "Excellent";
+  if (score >= 75) return "Good";
+  if (score >= 50) return "Fair";
+  if (score >= 25) return "Needs Work";
+  return "Poor";
+}
+
+// src/core/citability.ts
+function scorePageCitability(page) {
+  const content = page.content || "";
+  const dimensions = [];
+  const hints = [];
+  dimensions.push(scoreAnswerBlocks(content, hints));
+  dimensions.push(scoreSelfContainment(content, hints));
+  dimensions.push(scoreStatisticalDensity(content, hints));
+  dimensions.push(scoreStructureQuality(content, hints));
+  const score = dimensions.reduce((sum, d) => sum + d.score, 0);
+  return {
+    pathname: page.pathname,
+    score,
+    dimensions,
+    hints
+  };
+}
+function scoreSiteCitability(config) {
+  const pages = config.pages.map((p) => scorePageCitability(p));
+  const averageScore = pages.length > 0 ? Math.round(pages.reduce((sum, p) => sum + p.score, 0) / pages.length) : 0;
+  return { averageScore, pages };
+}
+function scoreAnswerBlocks(content, hints) {
+  if (!content.trim()) {
+    return { name: "Answer Blocks", score: 0, maxScore: 25, details: "No content" };
+  }
+  const paragraphs = splitParagraphs(content);
+  let answerCount = 0;
+  for (let i = 0; i < paragraphs.length; i++) {
+    const para = paragraphs[i];
+    const words = para.text.split(/\s+/).length;
+    if (para.text.startsWith("#") || words < 15) continue;
+    const startsWithSubject = /^[A-Z][a-z]/.test(para.text) && !/^(This|That|These|Those|It|They|We|He|She|I)\b/.test(para.text);
+    const goodLength = words >= 20 && words <= 200;
+    if (startsWithSubject && goodLength) {
+      answerCount++;
+    }
+  }
+  const answerRatio = paragraphs.length > 0 ? answerCount / Math.max(paragraphs.filter((p) => !p.text.startsWith("#")).length, 1) : 0;
+  let score = 0;
+  if (answerCount >= 3 && answerRatio >= 0.5) score = 25;
+  else if (answerCount >= 2 && answerRatio >= 0.3) score = 20;
+  else if (answerCount >= 1) score = 12;
+  else score = 0;
+  if (answerCount === 0) {
+    hints.push({ type: "warning", message: "No direct answer paragraphs found \u2014 add self-contained factual paragraphs that start with a clear subject" });
+  }
+  for (const para of paragraphs) {
+    const words = para.text.split(/\s+/).length;
+    if (words > 200 && !para.text.startsWith("#")) {
+      hints.push({ type: "suggestion", message: `Paragraph at line ${para.line} is ${words} words \u2014 split for better AI extraction (aim for <200)`, line: para.line });
+    }
+  }
+  return { name: "Answer Blocks", score, maxScore: 25, details: `${answerCount} answer-quality paragraphs found` };
+}
+function scoreSelfContainment(content, hints) {
+  if (!content.trim()) {
+    return { name: "Self-Containment", score: 0, maxScore: 25, details: "No content" };
+  }
+  const paragraphs = splitParagraphs(content).filter((p) => !p.text.startsWith("#") && p.text.split(/\s+/).length >= 10);
+  if (paragraphs.length === 0) {
+    return { name: "Self-Containment", score: 5, maxScore: 25, details: "No substantial paragraphs" };
+  }
+  const contextPatterns = [
+    /^(As mentioned|As noted|As described|As shown|As stated|As discussed)\b/i,
+    /^(However|Furthermore|Moreover|Additionally|In addition|Nevertheless)\b/,
+    /\b(above|below|previously|the following|as follows|see also)\b/i,
+    /^(This|That|These|Those|It) (is|was|are|were|has|have|will|can|should|means)\b/
+  ];
+  let contextDependentCount = 0;
+  for (const para of paragraphs) {
+    const isContextDependent = contextPatterns.some((p) => p.test(para.text));
+    if (isContextDependent) {
+      contextDependentCount++;
+    }
+  }
+  const selfContainedRatio = 1 - contextDependentCount / paragraphs.length;
+  let score;
+  if (selfContainedRatio >= 0.8) score = 25;
+  else if (selfContainedRatio >= 0.6) score = 18;
+  else if (selfContainedRatio >= 0.4) score = 12;
+  else score = 5;
+  if (contextDependentCount > 0) {
+    hints.push({ type: "suggestion", message: `${contextDependentCount} paragraph(s) depend on surrounding context \u2014 rephrase to be self-contained for better AI citation` });
+  }
+  return { name: "Self-Containment", score, maxScore: 25, details: `${Math.round(selfContainedRatio * 100)}% of paragraphs are self-contained` };
+}
+function scoreStatisticalDensity(content, hints) {
+  if (!content.trim()) {
+    return { name: "Statistical Density", score: 0, maxScore: 25, details: "No content" };
+  }
+  const patterns = {
+    percentages: /\d+(\.\d+)?%/g,
+    currencies: /\$[\d,.]+|\€[\d,.]+|£[\d,.]+/g,
+    years: /\b(19|20)\d{2}\b/g,
+    quantities: /\b\d+[\s,]*(million|billion|thousand|hundred|K|M|B)\b/gi,
+    metrics: /\b\d+(\.\d+)?\s*(users|customers|downloads|visitors|employees|countries|cities|hours|minutes|seconds|pages|files|requests)\b/gi,
+    comparisons: /\b\d+x\b|\b\d+(\.\d+)?%\s*(faster|slower|more|less|better|worse|increase|decrease|growth|reduction)\b/gi
+  };
+  let totalMatches = 0;
+  for (const [, pattern] of Object.entries(patterns)) {
+    const matches = content.match(pattern);
+    if (matches) totalMatches += matches.length;
+  }
+  const words = content.split(/\s+/).length;
+  const density = words > 0 ? totalMatches / (words / 100) : 0;
+  let score;
+  if (density >= 3) score = 25;
+  else if (density >= 1.5) score = 20;
+  else if (density >= 0.5) score = 12;
+  else if (totalMatches > 0) score = 6;
+  else score = 0;
+  if (totalMatches === 0) {
+    hints.push({ type: "suggestion", message: "No statistics or factual claims found \u2014 AI favors content with concrete numbers, percentages, and dates" });
+  }
+  return { name: "Statistical Density", score, maxScore: 25, details: `${totalMatches} statistical claims (${density.toFixed(1)} per 100 words)` };
+}
+function scoreStructureQuality(content, hints) {
+  if (!content.trim()) {
+    return { name: "Structure Quality", score: 0, maxScore: 25, details: "No content" };
+  }
+  let points = 0;
+  const details = [];
+  const headings = content.match(/^#{1,6}\s.+$/gm) || [];
+  if (headings.length > 0) {
+    points += 7;
+    details.push(`${headings.length} headings`);
+  } else {
+    hints.push({ type: "warning", message: "No headings found \u2014 add H1-H6 headings to structure content for AI extraction" });
+  }
+  const listItems = content.match(/^[\s]*[-*+]\s.+$|^\d+\.\s.+$/gm) || [];
+  if (listItems.length >= 3) {
+    points += 6;
+    details.push(`${listItems.length} list items`);
+  } else if (listItems.length > 0) {
+    points += 3;
+    details.push(`${listItems.length} list items`);
+  } else {
+    hints.push({ type: "suggestion", message: "No lists found \u2014 use bullet or numbered lists for key information" });
+  }
+  const paragraphs = splitParagraphs(content).filter((p) => !p.text.startsWith("#") && p.text.split(/\s+/).length >= 10);
+  const avgWords = paragraphs.length > 0 ? paragraphs.reduce((sum, p) => sum + p.text.split(/\s+/).length, 0) / paragraphs.length : 0;
+  if (avgWords > 0 && avgWords <= 167) {
+    points += 6;
+    details.push(`avg ${Math.round(avgWords)} words/paragraph`);
+  } else if (avgWords > 0 && avgWords <= 250) {
+    points += 3;
+    details.push(`avg ${Math.round(avgWords)} words/paragraph (aim for <167)`);
+  }
+  const hasSummary = /^(#{1,3}\s*)?(summary|tl;?dr|overview|introduction|key takeaways|in brief)\s*$/im.test(content);
+  const firstPara = paragraphs[0];
+  const hasShortIntro = firstPara && firstPara.text.split(/\s+/).length <= 60;
+  if (hasSummary) {
+    points += 6;
+    details.push("has summary section");
+  } else if (hasShortIntro) {
+    points += 3;
+    details.push("has short intro");
+  } else {
+    hints.push({ type: "suggestion", message: "Add a summary or TL;DR section at the top \u2014 helps AI extract the key message" });
+  }
+  return { name: "Structure Quality", score: Math.min(points, 25), maxScore: 25, details: details.join(", ") || "minimal structure" };
+}
+function splitParagraphs(content) {
+  const lines = content.split("\n");
+  const paragraphs = [];
+  let currentText = "";
+  let currentLine = 1;
+  for (let i = 0; i < lines.length; i++) {
+    const line = lines[i].trim();
+    if (line === "") {
+      if (currentText) {
+        paragraphs.push({ text: currentText.trim(), line: currentLine });
+        currentText = "";
+      }
+    } else {
+      if (!currentText) currentLine = i + 1;
+      currentText += (currentText ? " " : "") + line;
+    }
+  }
+  if (currentText) {
+    paragraphs.push({ text: currentText.trim(), line: currentLine });
+  }
+  return paragraphs;
+}
+function formatPageCitability(result) {
+  const lines = [];
+  lines.push(`Page: ${result.pathname} \u2014 Score: ${result.score}/100`);
+  lines.push("\u2500".repeat(40));
+  for (const dim of result.dimensions) {
+    const bar = "\u2588".repeat(dim.score) + "\u2591".repeat(dim.maxScore - dim.score);
+    lines.push(`  ${dim.name}: ${dim.score}/${dim.maxScore} ${bar}`);
+    lines.push(`    ${dim.details}`);
+  }
+  if (result.hints.length > 0) {
+    lines.push("");
+    lines.push("  Hints:");
+    for (const hint of result.hints) {
+      const icon = hint.type === "error" ? "!" : hint.type === "warning" ? "~" : "*";
+      const loc = hint.line ? ` (line ${hint.line})` : "";
+      lines.push(`    ${icon} ${hint.message}${loc}`);
+    }
+  }
+  return lines.join("\n");
+}
+
+// src/core/platform-hints.ts
+function generatePlatformHints(audit, citability) {
+  const hints = [];
+  hints.push(chatgptHints(audit, citability));
+  hints.push(perplexityHints(audit, citability));
+  hints.push(googleAIHints(audit));
+  hints.push(bingCopilotHints(audit, citability));
+  return hints;
+}
+function chatgptHints(audit, citability) {
+  const tips = [];
+  const aiAccess = audit.categories.find((c) => c.name === "AI Access");
+  const schema = audit.categories.find((c) => c.name === "Schema Presence");
+  const content = audit.categories.find((c) => c.name === "Content Structure");
+  const llmsCheck = aiAccess == null ? void 0 : aiAccess.checks.find((c) => c.label.includes("llms.txt"));
+  if (!(llmsCheck == null ? void 0 : llmsCheck.passed)) {
+    tips.push("Enable llms.txt \u2014 ChatGPT uses this to understand your site content");
+  }
+  const robotsCheck = aiAccess == null ? void 0 : aiAccess.checks.find((c) => c.label.includes("blanket disallow"));
+  if (!(robotsCheck == null ? void 0 : robotsCheck.passed)) {
+    tips.push("Allow GPTBot in robots.txt \u2014 blanket disallow blocks ChatGPT crawling");
+  }
+  if (schema && schema.score < 12) {
+    tips.push("Add Article or WebPage schema \u2014 helps ChatGPT extract structured content");
+  }
+  if (citability && citability.averageScore < 50) {
+    tips.push("Improve answer blocks \u2014 ChatGPT citations favor self-contained factual paragraphs");
+  }
+  if (content && content.score < 12) {
+    tips.push("Add more structured content \u2014 headings and paragraphs help SearchGPT parse your pages");
+  }
+  if (tips.length === 0) tips.push("Your site is well-optimized for ChatGPT/SearchGPT");
+  return {
+    platform: "ChatGPT / SearchGPT",
+    status: tips.length <= 1 ? "good" : tips.length <= 3 ? "needs-work" : "critical",
+    tips
+  };
+}
+function perplexityHints(audit, citability) {
+  const tips = [];
+  const meta = audit.categories.find((c) => c.name === "Meta Quality");
+  const citabilityScore = audit.categories.find((c) => c.name === "Citability");
+  if (citabilityScore && citabilityScore.score < 12) {
+    tips.push("Add statistical claims and concrete data \u2014 Perplexity favors cite-able facts");
+  }
+  if (meta && meta.score < 12) {
+    tips.push("Improve page titles and descriptions \u2014 Perplexity uses meta tags for source attribution");
+  }
+  const faqCheck = citabilityScore == null ? void 0 : citabilityScore.checks.find((c) => c.label.includes("FAQ"));
+  if (!(faqCheck == null ? void 0 : faqCheck.passed)) {
+    tips.push("Add FAQ sections with question headings \u2014 Perplexity surfaces Q&A content prominently");
+  }
+  if (citability && citability.averageScore < 40) {
+    tips.push("Improve self-contained paragraphs \u2014 Perplexity extracts and cites individual passages");
+  }
+  if (tips.length === 0) tips.push("Your site is well-optimized for Perplexity");
+  return {
+    platform: "Perplexity",
+    status: tips.length <= 1 ? "good" : tips.length <= 3 ? "needs-work" : "critical",
+    tips
+  };
+}
+function googleAIHints(audit, citability) {
+  const tips = [];
+  const schema = audit.categories.find((c) => c.name === "Schema Presence");
+  const orgCheck = schema == null ? void 0 : schema.checks.find((c) => c.label.includes("Organization"));
+  if (!(orgCheck == null ? void 0 : orgCheck.passed)) {
+    tips.push("Configure Organization name \u2014 Google AI uses this for E-E-A-T authority signals");
+  }
+  const sameAsCheck = schema == null ? void 0 : schema.checks.find((c) => c.label.includes("sameAs"));
+  if (!(sameAsCheck == null ? void 0 : sameAsCheck.passed)) {
+    tips.push("Add sameAs social profiles \u2014 critical for Google Knowledge Panel and E-E-A-T");
+  }
+  const logoCheck = schema == null ? void 0 : schema.checks.find((c) => c.label.includes("logo"));
+  if (!(logoCheck == null ? void 0 : logoCheck.passed)) {
+    tips.push("Add Organization logo \u2014 enhances Google search presence and AI Overviews");
+  }
+  const schemaEnabled = schema == null ? void 0 : schema.checks.find((c) => c.label.includes("JSON-LD"));
+  if (!(schemaEnabled == null ? void 0 : schemaEnabled.passed)) {
+    tips.push("Enable Schema.org/JSON-LD \u2014 Google AI Overviews heavily rely on structured data");
+  }
+  if (tips.length === 0) tips.push("Your site is well-optimized for Google AI Overviews");
+  return {
+    platform: "Google AI Overviews",
+    status: tips.length <= 1 ? "good" : tips.length <= 3 ? "needs-work" : "critical",
+    tips
+  };
+}
+function bingCopilotHints(audit, citability) {
+  const tips = [];
+  const aiAccess = audit.categories.find((c) => c.name === "AI Access");
+  const meta = audit.categories.find((c) => c.name === "Meta Quality");
+  const robotsCheck = aiAccess == null ? void 0 : aiAccess.checks.find((c) => c.label.includes("blanket disallow"));
+  if (!(robotsCheck == null ? void 0 : robotsCheck.passed)) {
+    tips.push("Remove blanket disallow \u2014 Bing Copilot requires Bingbot access");
+  }
+  const sitemapCheck = aiAccess == null ? void 0 : aiAccess.checks.find((c) => c.label.includes("sitemap"));
+  if (!(sitemapCheck == null ? void 0 : sitemapCheck.passed)) {
+    tips.push("Enable sitemap.xml \u2014 Bing Copilot relies on sitemaps for content discovery");
+  }
+  const ogCheck = meta == null ? void 0 : meta.checks.find((c) => c.label.includes("Open Graph"));
+  if (!(ogCheck == null ? void 0 : ogCheck.passed)) {
+    tips.push("Enable OG meta tags \u2014 Bing Copilot uses OG metadata for rich answers");
+  }
+  if (citability && citability.averageScore < 40) {
+    tips.push("Improve content structure \u2014 Bing Copilot favors well-organized content with clear answers");
+  }
+  if (tips.length === 0) tips.push("Your site is well-optimized for Bing Copilot");
+  return {
+    platform: "Bing Copilot",
+    status: tips.length <= 1 ? "good" : tips.length <= 3 ? "needs-work" : "critical",
+    tips
+  };
+}
+
+// src/core/report.ts
+function generateReport(config) {
+  const audit = auditSite(config);
+  const citability = scoreSiteCitability(config);
+  const platformHints = generatePlatformHints(audit, citability);
+  return {
+    generatedAt: (/* @__PURE__ */ new Date()).toISOString(),
+    site: {
+      title: config.title,
+      url: config.url,
+      pageCount: config.pages.length
+    },
+    audit,
+    citability,
+    platformHints
+  };
+}
+function formatReportMarkdown(report) {
+  const lines = [];
+  lines.push(`# AEO/GEO Report \u2014 ${report.site.title}`);
+  lines.push("");
+  lines.push(`Generated: ${report.generatedAt}`);
+  lines.push(`URL: ${report.site.url}`);
+  lines.push(`Pages: ${report.site.pageCount}`);
+  lines.push("");
+  lines.push("## GEO Readiness Score");
+  lines.push("");
+  lines.push(formatAuditReport(report.audit));
+  lines.push("");
+  lines.push("## AI Citability");
+  lines.push("");
+  lines.push(`Average Citability Score: ${report.citability.averageScore}/100`);
+  lines.push("");
+  for (const page of report.citability.pages) {
+    lines.push(formatPageCitability(page));
+    lines.push("");
+  }
+  lines.push("## Platform Optimization");
+  lines.push("");
+  for (const hint of report.platformHints) {
+    const statusIcon = hint.status === "good" ? "+" : hint.status === "needs-work" ? "~" : "!";
+    lines.push(`### ${statusIcon} ${hint.platform} (${hint.status})`);
+    lines.push("");
+    for (const tip of hint.tips) {
+      lines.push(`- ${tip}`);
+    }
+    lines.push("");
+  }
+  return lines.join("\n");
+}
+function formatReportJson(report) {
+  return JSON.stringify(report, null, 2);
+}
+
 // src/index.ts
-var VERSION = "0.0.1";
+var VERSION = "0.0.3";
 function defineConfig(config) {
   return config;
 }
 
-export { VERSION, defineConfig, detectFramework, generateAEOFiles, generateAEOFiles as generateAll, resolveConfig };
+export { VERSION, auditSite, defineConfig, detectFramework, extractDescription, extractJsonLd, extractTextFromHtml, extractTitle2 as extractTitle, formatAuditReport, formatPageCitability, formatReportJson, formatReportMarkdown, generateAEOFiles, generateAEOFiles as generateAll, generateJsonLdScript, generateOGTags, generateOGTagsHtml, generatePageSchemas, generatePlatformHints, generateReport, generateSchema, generateSchemaObjects, htmlToMarkdown, resolveConfig, scorePageCitability, scoreSiteCitability, validateConfig };
 //# sourceMappingURL=index.mjs.map
 //# sourceMappingURL=index.mjs.map