aeo.js 0.0.1 → 0.0.3

package/dist/index.mjs

@@ -1 +1,1801 @@
-export const VERSION="0.0.1";
+import { existsSync, mkdirSync, writeFileSync, readFileSync, readdirSync, statSync, copyFileSync } from 'fs';
+import { join, dirname, extname, relative } from 'path';
+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, _y, _z, _A, _B, _C, _D, _E, _F, _G, _H, _I, _J, _K, _L, _M;
+  const frameworkInfo = detectFramework();
+  return {
+    title: config.title || "My Site",
+    description: config.description || "",
+    url: config.url || "https://example.com",
+    contentDir: config.contentDir || frameworkInfo.contentDir,
+    outDir: config.outDir || frameworkInfo.outDir,
+    pages: config.pages || [],
+    generators: {
+      robotsTxt: ((_a = config.generators) == null ? void 0 : _a.robotsTxt) !== false,
+      llmsTxt: ((_b = config.generators) == null ? void 0 : _b.llmsTxt) !== false,
+      llmsFullTxt: ((_c = config.generators) == null ? void 0 : _c.llmsFullTxt) !== false,
+      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,
+      schema: ((_h = config.generators) == null ? void 0 : _h.schema) !== false
+    },
+    robots: {
+      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: ((_A = config.widget) == null ? void 0 : _A.enabled) !== false,
+      position: ((_B = config.widget) == null ? void 0 : _B.position) || "bottom-right",
+      theme: {
+        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: ((_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
+    }
+  };
+}
+function parseFrontmatter(content) {
+  const frontmatterMatch = content.match(/^---\s*\n([\s\S]*?)\n---\s*\n([\s\S]*)/);
+  if (frontmatterMatch) {
+    const frontmatterStr = frontmatterMatch[1];
+    const contentWithoutFrontmatter = frontmatterMatch[2];
+    const frontmatter = {};
+    const lines = frontmatterStr.split("\n");
+    for (const line of lines) {
+      const [key, ...valueParts] = line.split(":");
+      if (key && valueParts.length > 0) {
+        const value = valueParts.join(":").trim();
+        frontmatter[key.trim()] = value.replace(/^["']|["']$/g, "");
+      }
+    }
+    return { frontmatter, content: contentWithoutFrontmatter };
+  }
+  return { frontmatter: {}, content };
+}
+function bumpHeadings(content, levels = 1) {
+  return content.replace(/^(#{1,6})\s/gm, (match, hashes) => {
+    const newLevel = Math.min(hashes.length + levels, 6);
+    return "#".repeat(newLevel) + " ";
+  });
+}
+function extractTitle(content) {
+  const h1Match = content.match(/^#\s+(.+)$/m);
+  if (h1Match) return h1Match[1];
+  const h2Match = content.match(/^##\s+(.+)$/m);
+  if (h2Match) return h2Match[1];
+  const firstLine = content.split("\n")[0];
+  return firstLine.slice(0, 100);
+}
+function readPackageJson(projectRoot = process.cwd()) {
+  const packageJsonPath = join(projectRoot, "package.json");
+  if (!existsSync(packageJsonPath)) {
+    return {};
+  }
+  try {
+    const content = readFileSync(packageJsonPath, "utf-8");
+    return JSON.parse(content);
+  } catch {
+    return {};
+  }
+}
+
+// src/core/detect.ts
+function detectFramework(projectRoot = process.cwd()) {
+  const packageJson = readPackageJson(projectRoot);
+  const dependencies = {
+    ...packageJson.dependencies,
+    ...packageJson.devDependencies
+  };
+  if (dependencies["next"]) {
+    return {
+      framework: "next",
+      contentDir: "app",
+      outDir: "out"
+    };
+  }
+  if (dependencies["nuxt"] || dependencies["@nuxt/kit"]) {
+    return {
+      framework: "nuxt",
+      contentDir: "content",
+      outDir: ".output/public"
+    };
+  }
+  if (dependencies["astro"] || dependencies["@astrojs/astro"]) {
+    return {
+      framework: "astro",
+      contentDir: "src/content",
+      outDir: "dist"
+    };
+  }
+  if (dependencies["@remix-run/dev"]) {
+    return {
+      framework: "remix",
+      contentDir: "app",
+      outDir: "build/client"
+    };
+  }
+  if (dependencies["@sveltejs/kit"]) {
+    return {
+      framework: "sveltekit",
+      contentDir: "src",
+      outDir: "build"
+    };
+  }
+  if (dependencies["@angular/core"]) {
+    return {
+      framework: "angular",
+      contentDir: "src",
+      outDir: "dist"
+    };
+  }
+  if (dependencies["@docusaurus/core"]) {
+    return {
+      framework: "docusaurus",
+      contentDir: "docs",
+      outDir: "build"
+    };
+  }
+  if (dependencies["vite"]) {
+    return {
+      framework: "vite",
+      contentDir: "src",
+      outDir: "dist"
+    };
+  }
+  return {
+    framework: "unknown",
+    contentDir: "src",
+    outDir: "dist"
+  };
+}
+
+// src/core/robots.ts
+var AI_CRAWLERS = [
+  "GPTBot",
+  "OAI-SearchBot",
+  "ChatGPT-User",
+  "ClaudeBot",
+  "Claude-Web",
+  "anthropic-ai",
+  "PerplexityBot",
+  "Google-Extended",
+  "Gemini-Deep-Research",
+  "Bingbot",
+  "FacebookBot",
+  "meta-externalagent",
+  "Amazonbot",
+  "Applebot",
+  "DeepSeekBot",
+  "Bytespider",
+  "cohere-ai",
+  "CCBot",
+  "DiffBot",
+  "YouBot",
+  "FirecrawlAgent",
+  "Crawl4AI",
+  "BraveBot",
+  "SemrushBot",
+  "AhrefsBot",
+  "MJ12bot",
+  "DotBot",
+  "DataForSeoBot",
+  "Screaming Frog SEO Spider",
+  "SEOkicks",
+  "SEMrushBot",
+  "BLEXBot",
+  "Yandex",
+  "Baiduspider",
+  "Sogou",
+  "Exabot",
+  "facebookexternalhit",
+  "LinkedInBot",
+  "WhatsApp",
+  "Slackbot",
+  "TwitterBot",
+  "TelegramBot",
+  "Discordbot",
+  "PinterestBot",
+  "TumblrBot",
+  "ViberBot",
+  "SkypeUriPreview",
+  "redditbot",
+  "Snapchat",
+  "TikTok"
+];
+function generateRobotsTxt(config) {
+  const lines = [
+    "# robots.txt generated by aeo.js",
+    "# Allow AI crawlers to index this site",
+    "",
+    "# Traditional search engines",
+    "User-agent: Googlebot",
+    "Allow: /",
+    "",
+    "User-agent: Bingbot",
+    "Allow: /",
+    "",
+    "# AI crawlers and answer engines"
+  ];
+  for (const crawler of AI_CRAWLERS) {
+    lines.push(`User-agent: ${crawler}`);
+    lines.push("Allow: /");
+    lines.push("");
+  }
+  lines.push("# Default for all other bots");
+  lines.push("User-agent: *");
+  lines.push("Allow: /");
+  lines.push("");
+  if (config.url) {
+    lines.push(`Sitemap: ${config.url}/sitemap.xml`);
+  }
+  lines.push("");
+  lines.push("# AEO (Answer Engine Optimization) files");
+  lines.push("# These help LLMs understand your content better");
+  lines.push(`# ${config.url}/llms.txt`);
+  lines.push(`# ${config.url}/llms-full.txt`);
+  lines.push(`# ${config.url}/docs.json`);
+  lines.push(`# ${config.url}/ai-index.json`);
+  return lines.join("\n");
+}
+function collectMarkdownFiles(dir, base = dir) {
+  const files = [];
+  try {
+    const entries = readdirSync(dir);
+    for (const entry of entries) {
+      const fullPath = join(dir, entry);
+      const stat = statSync(fullPath);
+      if (stat.isDirectory() && !entry.startsWith(".") && entry !== "node_modules") {
+        files.push(...collectMarkdownFiles(fullPath, base));
+      } else if (stat.isFile() && (extname(entry) === ".md" || extname(entry) === ".mdx")) {
+        const content = readFileSync(fullPath, "utf-8");
+        const { frontmatter, content: mainContent } = parseFrontmatter(content);
+        const relativePath = relative(base, fullPath);
+        files.push({
+          path: relativePath,
+          content: mainContent,
+          title: frontmatter.title || extractTitle(mainContent),
+          description: frontmatter.description,
+          frontmatter
+        });
+      }
+    }
+  } catch (error) {
+    console.warn(`Warning: Could not read directory ${dir}:`, error);
+  }
+  return files;
+}
+function generateLlmsTxt(config) {
+  const lines = [
+    `# ${config.title}`,
+    ""
+  ];
+  if (config.description) {
+    lines.push(`> ${config.description}`);
+    lines.push("");
+  }
+  lines.push("## About");
+  lines.push("");
+  lines.push("This file provides a structured overview of the documentation and content available on this site,");
+  lines.push("optimized for consumption by Large Language Models (LLMs) and AI assistants.");
+  lines.push("");
+  if (config.pages && config.pages.length > 0) {
+    lines.push("## Pages");
+    lines.push("");
+    for (const page of config.pages) {
+      const url = `${config.url}${page.pathname === "/" ? "" : page.pathname}`;
+      const title = page.title || page.pathname;
+      lines.push(`- [${title}](${url})`);
+      if (page.description) {
+        lines.push(`  ${page.description}`);
+      }
+    }
+    lines.push("");
+  }
+  const markdownFiles = collectMarkdownFiles(config.contentDir);
+  if (markdownFiles.length > 0) {
+    lines.push("## Documentation");
+    lines.push("");
+    const grouped = {};
+    for (const file of markdownFiles) {
+      const dir = file.path.split("/")[0] || "root";
+      if (!grouped[dir]) grouped[dir] = [];
+      grouped[dir].push(file);
+    }
+    for (const [dir, files] of Object.entries(grouped)) {
+      lines.push(`### ${dir === "root" ? "Main Documentation" : dir}`);
+      lines.push("");
+      for (const file of files) {
+        const url = `${config.url}/${file.path.replace(/\.mdx?$/, "")}`;
+        lines.push(`- [${file.title}](${url})`);
+        if (file.description) {
+          lines.push(`  ${file.description}`);
+        }
+      }
+      lines.push("");
+    }
+  }
+  lines.push("## Quick Links");
+  lines.push("");
+  lines.push(`- Full Documentation: ${config.url}/llms-full.txt`);
+  lines.push(`- Documentation Manifest: ${config.url}/docs.json`);
+  lines.push(`- AI-Optimized Index: ${config.url}/ai-index.json`);
+  lines.push(`- Sitemap: ${config.url}/sitemap.xml`);
+  lines.push("");
+  lines.push("## For LLMs");
+  lines.push("");
+  lines.push("To get the complete documentation in a single file, request:");
+  lines.push(`${config.url}/llms-full.txt`);
+  lines.push("");
+  lines.push("For structured access to individual pages with metadata:");
+  lines.push(`${config.url}/docs.json`);
+  lines.push("");
+  lines.push("For RAG (Retrieval Augmented Generation) systems:");
+  lines.push(`${config.url}/ai-index.json`);
+  lines.push("");
+  lines.push("---");
+  lines.push("Generated by aeo.js - Answer Engine Optimization for the modern web");
+  lines.push("Learn more at https://aeojs.org");
+  return lines.join("\n");
+}
+function collectAndConcatenateMarkdown(dir, base = dir) {
+  const sections = [];
+  try {
+    const entries = readdirSync(dir).sort();
+    for (const entry of entries) {
+      const fullPath = join(dir, entry);
+      const stat = statSync(fullPath);
+      if (stat.isDirectory() && !entry.startsWith(".") && entry !== "node_modules") {
+        const subSections = collectAndConcatenateMarkdown(fullPath, base);
+        if (subSections.length > 0) {
+          sections.push(...subSections);
+        }
+      } else if (stat.isFile() && (extname(entry) === ".md" || extname(entry) === ".mdx")) {
+        const content = readFileSync(fullPath, "utf-8");
+        const { frontmatter, content: mainContent } = parseFrontmatter(content);
+        const relativePath = relative(base, fullPath);
+        const sectionLines = [
+          "---",
+          "",
+          `# ${frontmatter.title || relativePath}`,
+          "",
+          `Source: ${relativePath}`,
+          ""
+        ];
+        if (frontmatter.description) {
+          sectionLines.push(`> ${frontmatter.description}`);
+          sectionLines.push("");
+        }
+        const bumpedContent = bumpHeadings(mainContent, 1);
+        sectionLines.push(bumpedContent);
+        sectionLines.push("");
+        sections.push(sectionLines.join("\n"));
+      }
+    }
+  } catch (error) {
+    console.warn(`Warning: Could not read directory ${dir}:`, error);
+  }
+  return sections;
+}
+function generateLlmsFullTxt(config) {
+  const lines = [
+    `# ${config.title} - Complete Documentation`,
+    "",
+    `This file contains all documentation concatenated into a single file for easy consumption by LLMs.`,
+    ""
+  ];
+  if (config.description) {
+    lines.push(`> ${config.description}`);
+    lines.push("");
+  }
+  lines.push("## Table of Contents");
+  lines.push("");
+  lines.push("This document includes all content from this project.");
+  lines.push("Each section is separated by a horizontal rule (---) for easy parsing.");
+  lines.push("");
+  let hasContent = false;
+  if (config.pages && config.pages.length > 0) {
+    for (const page of config.pages) {
+      const url = `${config.url}${page.pathname === "/" ? "" : page.pathname}`;
+      const title = page.title || page.pathname;
+      const sectionLines = [
+        "---",
+        "",
+        `# ${title}`,
+        "",
+        `URL: ${url}`,
+        ""
+      ];
+      if (page.description) {
+        sectionLines.push(`> ${page.description}`);
+        sectionLines.push("");
+      }
+      if (page.content) {
+        sectionLines.push(page.content);
+        sectionLines.push("");
+      }
+      lines.push(sectionLines.join("\n"));
+      hasContent = true;
+    }
+  }
+  const sections = collectAndConcatenateMarkdown(config.contentDir);
+  if (sections.length > 0) {
+    lines.push(...sections);
+    hasContent = true;
+  }
+  if (!hasContent) {
+    lines.push("---");
+    lines.push("");
+    lines.push(`# ${config.title}`);
+    lines.push("");
+    lines.push(`URL: ${config.url}`);
+    lines.push("");
+    if (config.description) {
+      lines.push(config.description);
+      lines.push("");
+    }
+  }
+  lines.push("---");
+  lines.push("");
+  lines.push("## About This Document");
+  lines.push("");
+  lines.push("This concatenated documentation file is generated automatically by aeo.js");
+  lines.push("to make it easier for AI systems to understand the complete context of this project.");
+  lines.push("");
+  lines.push(`For a structured index, see: ${config.url}/llms.txt`);
+  lines.push(`For individual files, see: ${config.url}/docs.json`);
+  lines.push("");
+  lines.push("Generated by aeo.js - https://aeojs.org");
+  return lines.join("\n");
+}
+function ensureDir(path) {
+  mkdirSync(path, { recursive: true });
+}
+function copyMarkdownFiles(config) {
+  const copiedFiles = [];
+  function copyRecursive(dir, base = config.contentDir) {
+    try {
+      const entries = readdirSync(dir);
+      for (const entry of entries) {
+        const fullPath = join(dir, entry);
+        const stat = statSync(fullPath);
+        if (stat.isDirectory() && !entry.startsWith(".") && entry !== "node_modules") {
+          copyRecursive(fullPath, base);
+        } else if (stat.isFile() && extname(entry) === ".md") {
+          const relativePath = relative(base, fullPath);
+          const destPath = join(config.outDir, relativePath);
+          ensureDir(dirname(destPath));
+          try {
+            copyFileSync(fullPath, destPath);
+            copiedFiles.push({
+              source: fullPath,
+              destination: destPath
+            });
+          } catch (error) {
+            console.warn(`Warning: Could not copy ${fullPath}:`, error);
+          }
+        }
+      }
+    } catch (error) {
+      console.warn(`Warning: Could not read directory ${dir}:`, error);
+    }
+  }
+  copyRecursive(config.contentDir);
+  return copiedFiles;
+}
+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);
+    let filename;
+    if (page.pathname === "/") {
+      filename = "index.md";
+    } else {
+      const clean = page.pathname.replace(/^\//, "").replace(/\/$/, "");
+      filename = clean.includes("/") ? `${clean}.md` : `${clean}.md`;
+    }
+    const destPath = join(config.outDir, filename);
+    const pageUrl = page.pathname === "/" ? config.url : `${config.url.replace(/\/$/, "")}${page.pathname}`;
+    const lines = [];
+    lines.push("---");
+    if (pageTitle) lines.push(`title: "${pageTitle}"`);
+    if (page.description) lines.push(`description: "${page.description}"`);
+    lines.push(`url: ${pageUrl}`);
+    lines.push(`source: ${pageUrl}`);
+    lines.push(`generated_by: aeo.js`);
+    lines.push("---", "");
+    if (pageTitle) {
+      lines.push(`# ${pageTitle}`, "");
+    }
+    if (page.description) {
+      lines.push(`${page.description}`, "");
+    }
+    if (page.content) {
+      lines.push(page.content);
+    }
+    const content = lines.join("\n");
+    ensureDir(dirname(destPath));
+    try {
+      writeFileSync(destPath, content, "utf-8");
+      generated.push({ pathname: page.pathname, destination: destPath });
+    } catch {
+    }
+  }
+  return generated;
+}
+function collectManifestEntries(dir, config, base = dir) {
+  const entries = [];
+  try {
+    const files = readdirSync(dir);
+    for (const file of files) {
+      const fullPath = join(dir, file);
+      const stat = statSync(fullPath);
+      if (stat.isDirectory() && !file.startsWith(".") && file !== "node_modules") {
+        entries.push(...collectManifestEntries(fullPath, config, base));
+      } else if (stat.isFile() && (extname(file) === ".md" || extname(file) === ".mdx")) {
+        const content = readFileSync(fullPath, "utf-8");
+        const { frontmatter, content: mainContent } = parseFrontmatter(content);
+        const relativePath = relative(base, fullPath);
+        const urlPath = relativePath.replace(/\.mdx?$/, "");
+        entries.push({
+          url: `${config.url}/${urlPath}`,
+          title: frontmatter.title || extractTitle(mainContent),
+          description: frontmatter.description,
+          lastModified: stat.mtime.toISOString()
+        });
+      }
+    }
+  } catch (error) {
+    console.warn(`Warning: Could not read directory ${dir}:`, error);
+  }
+  return entries;
+}
+function generateManifest(config) {
+  const entries = [];
+  if (config.pages && config.pages.length > 0) {
+    for (const page of config.pages) {
+      entries.push({
+        url: `${config.url}${page.pathname === "/" ? "" : page.pathname}`,
+        title: page.title || page.pathname,
+        description: page.description
+      });
+    }
+  }
+  entries.push(...collectManifestEntries(config.contentDir, config));
+  const manifest = {
+    version: "1.0",
+    generated: (/* @__PURE__ */ new Date()).toISOString(),
+    site: {
+      title: config.title,
+      description: config.description,
+      url: config.url
+    },
+    documents: entries.sort((a, b) => a.url.localeCompare(b.url)),
+    metadata: {
+      totalDocuments: entries.length,
+      generator: "aeo.js",
+      generatorUrl: "https://aeojs.org"
+    }
+  };
+  return JSON.stringify(manifest, null, 2);
+}
+function collectUrls(dir, config, base = dir) {
+  const urls = [];
+  try {
+    const entries = readdirSync(dir);
+    for (const entry of entries) {
+      const fullPath = join(dir, entry);
+      const stat = statSync(fullPath);
+      if (stat.isDirectory() && !entry.startsWith(".") && entry !== "node_modules") {
+        urls.push(...collectUrls(fullPath, config, base));
+      } else if (stat.isFile() && (extname(entry) === ".md" || extname(entry) === ".mdx" || extname(entry) === ".html")) {
+        const relativePath = relative(base, fullPath);
+        const urlPath = relativePath.replace(/\.(md|mdx|html)$/, "");
+        urls.push(`${config.url}/${urlPath}`);
+      }
+    }
+  } catch (error) {
+    console.warn(`Warning: Could not read directory ${dir}:`, error);
+  }
+  return urls;
+}
+function escapeXml(str) {
+  return str.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;").replace(/"/g, "&quot;").replace(/'/g, "&apos;");
+}
+function generateSitemap(config) {
+  const urls = [];
+  if (config.pages && config.pages.length > 0) {
+    for (const page of config.pages) {
+      urls.push(`${config.url}${page.pathname === "/" ? "" : page.pathname}`);
+    }
+  }
+  if (config.contentDir) {
+    urls.push(...collectUrls(config.contentDir, config));
+  }
+  const lines = [
+    '<?xml version="1.0" encoding="UTF-8"?>',
+    '<urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9">'
+  ];
+  urls.push(config.url);
+  const uniqueUrls = [...new Set(urls)].sort();
+  for (const url of uniqueUrls) {
+    lines.push("  <url>");
+    lines.push(`    <loc>${escapeXml(url)}</loc>`);
+    lines.push(`    <lastmod>${(/* @__PURE__ */ new Date()).toISOString().split("T")[0]}</lastmod>`);
+    lines.push("    <changefreq>weekly</changefreq>");
+    lines.push("    <priority>0.8</priority>");
+    lines.push("  </url>");
+  }
+  lines.push("</urlset>");
+  return lines.join("\n");
+}
+function extractKeywords(content) {
+  const words = content.toLowerCase().replace(/[^a-z0-9\s]/g, " ").split(/\s+/).filter((word) => word.length > 3);
+  const wordCount = {};
+  for (const word of words) {
+    wordCount[word] = (wordCount[word] || 0) + 1;
+  }
+  return Object.entries(wordCount).sort((a, b) => b[1] - a[1]).slice(0, 10).map(([word]) => word);
+}
+function chunkContent(content, maxLength = 2e3) {
+  const chunks = [];
+  const paragraphs = content.split("\n\n");
+  let currentChunk = "";
+  for (const paragraph of paragraphs) {
+    if (currentChunk.length + paragraph.length > maxLength && currentChunk.length > 0) {
+      chunks.push(currentChunk.trim());
+      currentChunk = "";
+    }
+    currentChunk += paragraph + "\n\n";
+  }
+  if (currentChunk.trim()) {
+    chunks.push(currentChunk.trim());
+  }
+  return chunks;
+}
+function collectAIIndexEntries(dir, config, base = dir) {
+  const entries = [];
+  try {
+    const files = readdirSync(dir);
+    for (const file of files) {
+      const fullPath = join(dir, file);
+      const stat = statSync(fullPath);
+      if (stat.isDirectory() && !file.startsWith(".") && file !== "node_modules") {
+        entries.push(...collectAIIndexEntries(fullPath, config, base));
+      } else if (stat.isFile() && (extname(file) === ".md" || extname(file) === ".mdx")) {
+        const content = readFileSync(fullPath, "utf-8");
+        const { frontmatter, content: mainContent } = parseFrontmatter(content);
+        const relativePath = relative(base, fullPath);
+        const urlPath = relativePath.replace(/\.mdx?$/, "");
+        const url = `${config.url}/${urlPath}`;
+        const chunks = chunkContent(mainContent);
+        const title = frontmatter.title || extractTitle(mainContent);
+        const keywords = extractKeywords(mainContent);
+        chunks.forEach((chunk, index) => {
+          const id = createHash("sha256").update(`${url}-${index}`).digest("hex").slice(0, 16);
+          entries.push({
+            id,
+            url,
+            title: chunks.length > 1 ? `${title} (Part ${index + 1})` : title,
+            content: chunk,
+            description: frontmatter.description,
+            keywords,
+            metadata: {
+              ...frontmatter,
+              chunkIndex: index,
+              totalChunks: chunks.length,
+              sourcePath: relativePath
+            }
+          });
+        });
+      }
+    }
+  } catch (error) {
+    console.warn(`Warning: Could not read directory ${dir}:`, error);
+  }
+  return entries;
+}
+function generateAIIndex(config) {
+  const entries = [];
+  if (config.pages && config.pages.length > 0) {
+    for (const page of config.pages) {
+      const url = `${config.url}${page.pathname === "/" ? "" : page.pathname}`;
+      const title = page.title || page.pathname;
+      const content = page.content || "";
+      if (content) {
+        const chunks = chunkContent(content);
+        const keywords = extractKeywords(content);
+        chunks.forEach((chunk, index2) => {
+          const id = createHash("sha256").update(`${url}-${index2}`).digest("hex").slice(0, 16);
+          entries.push({
+            id,
+            url,
+            title: chunks.length > 1 ? `${title} (Part ${index2 + 1})` : title,
+            content: chunk,
+            description: page.description,
+            keywords,
+            metadata: {
+              chunkIndex: index2,
+              totalChunks: chunks.length,
+              sourcePath: page.pathname
+            }
+          });
+        });
+      } else {
+        const id = createHash("sha256").update(url).digest("hex").slice(0, 16);
+        entries.push({
+          id,
+          url,
+          title,
+          content: page.description || title,
+          description: page.description,
+          keywords: []
+        });
+      }
+    }
+  }
+  entries.push(...collectAIIndexEntries(config.contentDir, config));
+  const index = {
+    version: "1.0",
+    generated: (/* @__PURE__ */ new Date()).toISOString(),
+    site: {
+      title: config.title,
+      description: config.description,
+      url: config.url
+    },
+    entries: entries.sort((a, b) => a.id.localeCompare(b.id)),
+    metadata: {
+      totalEntries: entries.length,
+      generator: "aeo.js",
+      generatorUrl: "https://aeojs.org",
+      embedding: {
+        recommended: "text-embedding-ada-002",
+        dimensions: 1536
+      }
+    }
+  };
+  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;
+  if (typeof configOrRoot === "string") {
+    config = resolveConfig({ ...maybeConfig, outDir: (maybeConfig == null ? void 0 : maybeConfig.outDir) || configOrRoot });
+  } else if (configOrRoot && typeof configOrRoot === "object" && "generators" in configOrRoot && typeof ((_a = configOrRoot.generators) == null ? void 0 : _a.robotsTxt) === "boolean") {
+    config = configOrRoot;
+  } else {
+    config = resolveConfig(configOrRoot);
+  }
+  const outDir = config.outDir;
+  const files = [];
+  const errors = [];
+  if (!existsSync(outDir)) {
+    mkdirSync(outDir, { recursive: true });
+  }
+  if (config.generators.robotsTxt) {
+    try {
+      const content = generateRobotsTxt(config);
+      writeFileSync(join(outDir, "robots.txt"), content, "utf-8");
+      files.push("robots.txt");
+    } catch (e) {
+      errors.push(`robots.txt: ${e.message}`);
+    }
+  }
+  if (config.generators.llmsTxt) {
+    try {
+      const content = generateLlmsTxt(config);
+      writeFileSync(join(outDir, "llms.txt"), content, "utf-8");
+      files.push("llms.txt");
+    } catch (e) {
+      errors.push(`llms.txt: ${e.message}`);
+    }
+  }
+  if (config.generators.llmsFullTxt) {
+    try {
+      const content = generateLlmsFullTxt(config);
+      writeFileSync(join(outDir, "llms-full.txt"), content, "utf-8");
+      files.push("llms-full.txt");
+    } catch (e) {
+      errors.push(`llms-full.txt: ${e.message}`);
+    }
+  }
+  if (config.generators.rawMarkdown) {
+    try {
+      const generated = generatePageMarkdownFiles(config);
+      for (const f of generated) {
+        files.push(f.destination);
+      }
+    } catch (e) {
+      errors.push(`page-markdown: ${e.message}`);
+    }
+    try {
+      const copied = copyMarkdownFiles(config);
+      for (const f of copied) {
+        files.push(f.destination);
+      }
+    } catch (e) {
+      errors.push(`raw-markdown: ${e.message}`);
+    }
+  }
+  if (config.generators.manifest) {
+    try {
+      const content = generateManifest(config);
+      writeFileSync(join(outDir, "docs.json"), content, "utf-8");
+      files.push("docs.json");
+    } catch (e) {
+      errors.push(`docs.json: ${e.message}`);
+    }
+  }
+  if (config.generators.sitemap) {
+    try {
+      const content = generateSitemap(config);
+      writeFileSync(join(outDir, "sitemap.xml"), content, "utf-8");
+      files.push("sitemap.xml");
+    } catch (e) {
+      errors.push(`sitemap.xml: ${e.message}`);
+    }
+  }
+  if (config.generators.aiIndex) {
+    try {
+      const content = generateAIIndex(config);
+      writeFileSync(join(outDir, "ai-index.json"), content, "utf-8");
+      files.push("ai-index.json");
+    } catch (e) {
+      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.3";
+function defineConfig(config) {
+  return config;
+}
+
+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