aeo.js 0.0.1 → 0.0.3

package/dist/cli.mjs

@@ -0,0 +1,1878 @@
+#!/usr/bin/env node
+import { existsSync, writeFileSync, mkdirSync, readFileSync, readdirSync, statSync, copyFileSync } from 'fs';
+import { join, dirname, extname, relative } from 'path';
+import 'minimatch';
+import { createHash } from 'crypto';
+
+// 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");
+}
+
+// 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"
+  };
+}
+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/llms-txt.ts
+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;
+}
+async function generateAEOFiles(configOrRoot, maybeConfig) {
+  var _a;
+  let config;
+  if (typeof configOrRoot === "string") {
+    config = resolveConfig({ ...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/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);
+}
+var VERSION = "0.0.2";
+var HELP = `
+aeo.js v${VERSION} \u2014 Answer Engine Optimization for the modern web
+
+Usage:
+  npx aeo.js <command> [options]
+
+Commands:
+  generate    Generate all AEO files (robots.txt, llms.txt, sitemap.xml, etc.)
+  init        Create an aeo.config.ts configuration file
+  check       Validate AEO setup + GEO readiness score (0-100)
+  report      Full AEO/GEO report with citability scores and platform hints
+
+Options:
+  --out <dir>       Output directory (default: auto-detected)
+  --url <url>       Site URL (default: https://example.com)
+  --title <title>   Site title (default: My Site)
+  --no-widget       Disable widget generation
+  --json            Output audit results as JSON (check command)
+  --help, -h        Show this help message
+  --version, -v     Show version
+
+Examples:
+  npx aeo.js generate
+  npx aeo.js generate --url https://mysite.com --title "My Site"
+  npx aeo.js init
+  npx aeo.js check
+  npx aeo.js check --json
+  npx aeo.js report
+  npx aeo.js report --json
+`;
+function parseArgs(args) {
+  let command = "help";
+  const flags = {};
+  for (let i = 0; i < args.length; i++) {
+    const arg = args[i];
+    if (arg === "--help" || arg === "-h") {
+      flags.help = true;
+    } else if (arg === "--version" || arg === "-v") {
+      flags.version = true;
+    } else if (arg === "--no-widget") {
+      flags.noWidget = true;
+    } else if (arg === "--json") {
+      flags.json = true;
+    } else if (arg.startsWith("--") && i + 1 < args.length) {
+      const key = arg.slice(2);
+      flags[key] = args[++i];
+    } else if (!arg.startsWith("-") && command === "help") {
+      command = arg;
+    }
+  }
+  return { command, flags };
+}
+async function cmdGenerate(flags) {
+  const framework = detectFramework();
+  console.log(`[aeo.js] Detected framework: ${framework.framework}`);
+  const config = resolveConfig({
+    title: typeof flags.title === "string" ? flags.title : void 0,
+    url: typeof flags.url === "string" ? flags.url : void 0,
+    outDir: typeof flags.out === "string" ? flags.out : void 0,
+    widget: flags.noWidget ? { enabled: false } : void 0
+  });
+  console.log(`[aeo.js] Output directory: ${config.outDir}`);
+  console.log(`[aeo.js] Generating AEO files...`);
+  const result = await generateAEOFiles(config);
+  if (result.files.length > 0) {
+    console.log(`[aeo.js] Generated ${result.files.length} files:`);
+    for (const file of result.files) {
+      console.log(`  - ${file}`);
+    }
+  } else {
+    console.log("[aeo.js] No files generated.");
+  }
+  if (result.errors.length > 0) {
+    console.error(`[aeo.js] ${result.errors.length} error(s):`);
+    for (const error of result.errors) {
+      console.error(`  - ${error}`);
+    }
+    process.exit(1);
+  }
+}
+function cmdInit() {
+  const configPath = join(process.cwd(), "aeo.config.ts");
+  if (existsSync(configPath)) {
+    console.error("[aeo.js] aeo.config.ts already exists. Remove it first to reinitialize.");
+    process.exit(1);
+  }
+  const template = `import { defineConfig } from 'aeo.js';
+
+export default defineConfig({
+  // Required
+  title: 'My Site',
+  url: 'https://example.com',
+
+  // Optional
+  description: 'A site optimized for AI discovery',
+
+  // Toggle individual generators
+  generators: {
+    robotsTxt: true,
+    llmsTxt: true,
+    llmsFullTxt: true,
+    rawMarkdown: true,
+    manifest: true,
+    sitemap: true,
+    aiIndex: true,
+  },
+
+  // Customize robots.txt
+  robots: {
+    allow: ['/'],
+    disallow: ['/admin'],
+    crawlDelay: 0,
+  },
+
+  // Widget configuration
+  widget: {
+    enabled: true,
+    position: 'bottom-right',
+    humanLabel: 'Human',
+    aiLabel: 'AI',
+    showBadge: true,
+    theme: {
+      background: 'rgba(18, 18, 24, 0.9)',
+      text: '#C0C0C5',
+      accent: '#E8E8EA',
+      badge: '#4ADE80',
+    },
+  },
+});
+`;
+  writeFileSync(configPath, template, "utf-8");
+  console.log("[aeo.js] Created aeo.config.ts");
+  console.log("[aeo.js] Edit the config and run `npx aeo.js generate` to generate AEO files.");
+}
+function cmdCheck(flags) {
+  const framework = detectFramework();
+  const config = resolveConfig({
+    title: typeof flags.title === "string" ? flags.title : void 0,
+    url: typeof flags.url === "string" ? flags.url : void 0,
+    outDir: typeof flags.out === "string" ? flags.out : void 0
+  });
+  const auditResult = auditSite(config);
+  if (flags.json) {
+    console.log(JSON.stringify({ framework: framework.framework, config: { title: config.title, url: config.url, outDir: config.outDir }, audit: auditResult }, null, 2));
+    return;
+  }
+  console.log(`[aeo.js] AEO Configuration Check`);
+  console.log(`${"\u2500".repeat(40)}`);
+  console.log(`  Framework:    ${framework.framework}`);
+  console.log(`  Content dir:  ${config.contentDir}`);
+  console.log(`  Output dir:   ${config.outDir}`);
+  console.log(`  Title:        ${config.title}`);
+  console.log(`  URL:          ${config.url}`);
+  console.log(`  Widget:       ${config.widget.enabled ? "enabled" : "disabled"}`);
+  console.log();
+  console.log(`  Generators:`);
+  const generators = [
+    ["robots.txt", config.generators.robotsTxt],
+    ["llms.txt", config.generators.llmsTxt],
+    ["llms-full.txt", config.generators.llmsFullTxt],
+    ["raw markdown", config.generators.rawMarkdown],
+    ["docs.json", config.generators.manifest],
+    ["sitemap.xml", config.generators.sitemap],
+    ["ai-index.json", config.generators.aiIndex],
+    ["schema.json", config.generators.schema]
+  ];
+  for (const [name, enabled] of generators) {
+    console.log(`    ${enabled ? "+" : "-"} ${name}`);
+  }
+  const configPath = join(process.cwd(), "aeo.config.ts");
+  const configPathJs = join(process.cwd(), "aeo.config.js");
+  const hasConfig = existsSync(configPath) || existsSync(configPathJs);
+  console.log();
+  if (hasConfig) {
+    console.log(`  Config file: found`);
+  } else {
+    console.log(`  Config file: not found (using defaults)`);
+    console.log(`  Run \`npx aeo.js init\` to create one.`);
+  }
+  console.log();
+  console.log(formatAuditReport(auditResult));
+}
+function cmdReport(flags) {
+  const config = resolveConfig({
+    title: typeof flags.title === "string" ? flags.title : void 0,
+    url: typeof flags.url === "string" ? flags.url : void 0,
+    outDir: typeof flags.out === "string" ? flags.out : void 0
+  });
+  const report = generateReport(config);
+  if (flags.json) {
+    console.log(formatReportJson(report));
+  } else {
+    console.log(formatReportMarkdown(report));
+  }
+}
+async function main() {
+  const args = process.argv.slice(2);
+  const { command, flags } = parseArgs(args);
+  if (flags.version) {
+    console.log(VERSION);
+    return;
+  }
+  if (flags.help || command === "help") {
+    console.log(HELP);
+    return;
+  }
+  switch (command) {
+    case "generate":
+      await cmdGenerate(flags);
+      break;
+    case "init":
+      cmdInit();
+      break;
+    case "check":
+      cmdCheck(flags);
+      break;
+    case "report":
+      cmdReport(flags);
+      break;
+    default:
+      console.error(`Unknown command: ${command}`);
+      console.log(HELP);
+      process.exit(1);
+  }
+}
+main().catch((error) => {
+  console.error("[aeo.js] Fatal error:", error.message);
+  process.exit(1);
+});
+//# sourceMappingURL=cli.mjs.map
+//# sourceMappingURL=cli.mjs.map