docs-ready 0.2.0 → 0.3.0

package/dist/ai-context-QVGQK3GD.js

@@ -0,0 +1,338 @@
+#!/usr/bin/env node
+
+// src/generate/key-pages.ts
+var PATH_KEYWORDS = [
+  "getting-started",
+  "quickstart",
+  "quick-start",
+  "setup",
+  "install",
+  "tutorial",
+  "overview",
+  "introduction",
+  "api",
+  "sdk",
+  "reference",
+  "config",
+  "configuration",
+  "network",
+  "deploy",
+  "migration"
+];
+var TITLE_KEYWORDS = [
+  "getting started",
+  "quickstart",
+  "quick start",
+  "setup",
+  "install",
+  "tutorial",
+  "overview",
+  "introduction",
+  "api reference",
+  "sdk",
+  "reference",
+  "config",
+  "configuration",
+  "network",
+  "deploy",
+  "migration"
+];
+var CONTENT_PATTERNS = [
+  { pattern: /0x[a-fA-F0-9]{40}/, label: "contract-address" },
+  { pattern: /chain\s*id/i, label: "chain-id" },
+  { pattern: /rpc\s*(url|endpoint)/i, label: "rpc-url" },
+  { pattern: /npm install\s+\S+/, label: "npm-install" },
+  { pattern: /go get\s+\S+/, label: "go-get" },
+  { pattern: /pip install\s+\S+/, label: "pip-install" }
+];
+function detectKeyPages(pages) {
+  const results = [];
+  for (const page of pages) {
+    const reasons = [];
+    const pathLower = page.relativePath.toLowerCase();
+    const titleLower = page.title.toLowerCase();
+    if (PATH_KEYWORDS.some((kw) => pathLower.includes(kw))) {
+      reasons.push("path-keyword");
+    }
+    if (TITLE_KEYWORDS.some((kw) => titleLower.includes(kw))) {
+      reasons.push("title-keyword");
+    }
+    if (CONTENT_PATTERNS.some((cp) => cp.pattern.test(page.content))) {
+      reasons.push("content-pattern");
+    }
+    if (reasons.length > 0) {
+      results.push({ page, reasons });
+    }
+  }
+  return results;
+}
+
+// src/generate/extractors.ts
+function extractContractAddresses(content) {
+  const regex = /0x[a-fA-F0-9]{40}/g;
+  const matches = content.match(regex);
+  return matches ?? [];
+}
+function extractCodeBlocks(content) {
+  const blocks = /* @__PURE__ */ new Map();
+  const regex = /```(\w+)\n([\s\S]*?)```/g;
+  let match;
+  while ((match = regex.exec(content)) !== null) {
+    const lang = match[1];
+    const code = match[2].trim();
+    if (!blocks.has(lang)) {
+      blocks.set(lang, []);
+    }
+    blocks.get(lang).push(code);
+  }
+  return blocks;
+}
+function extractTables(content) {
+  const tables = [];
+  const lines = content.split("\n");
+  let current = [];
+  let inTable = false;
+  for (const line of lines) {
+    const trimmed = line.trim();
+    if (trimmed.startsWith("|") && trimmed.endsWith("|")) {
+      inTable = true;
+      current.push(line);
+    } else {
+      if (inTable && current.length >= 2) {
+        tables.push(current.join("\n"));
+      }
+      current = [];
+      inTable = false;
+    }
+  }
+  if (inTable && current.length >= 2) {
+    tables.push(current.join("\n"));
+  }
+  return tables;
+}
+function extractLinks(content) {
+  const links = [];
+  const regex = /\[([^\]]+)\]\((https?:\/\/[^)]+)\)/g;
+  let match;
+  while ((match = regex.exec(content)) !== null) {
+    const text = match[1];
+    const url = match[2];
+    let category = "external";
+    if (url.includes("github.com")) {
+      category = "github";
+    } else if (url.includes("npmjs.com") || url.includes("npm.im")) {
+      category = "npm";
+    }
+    links.push({ text, url, category });
+  }
+  return links;
+}
+function deduplicateBlocks(blocks) {
+  const result = /* @__PURE__ */ new Map();
+  for (const [lang, codeList] of blocks) {
+    result.set(lang, [...new Set(codeList)]);
+  }
+  return result;
+}
+
+// src/generate/ai-context.ts
+var NETWORK_PATTERNS = [/chain\s*id/i, /rpc\s*(url|endpoint)/i];
+var QUICKSTART_PATH_KEYWORDS = [
+  "getting-started",
+  "quickstart",
+  "quick-start",
+  "setup",
+  "install",
+  "sdk"
+];
+function generateAiContext(pages, config) {
+  const keyPages = resolveKeyPages(pages, config);
+  const sections = [];
+  sections.push(
+    "<!-- Auto-generated by docs-ready. Review and customize. -->"
+  );
+  sections.push("");
+  sections.push(`# ${config.title} \u2014 AI Context`);
+  sections.push("");
+  sections.push("## Overview");
+  sections.push("");
+  sections.push(config.description);
+  const networkSection = buildNetworkSection(keyPages);
+  if (networkSection) {
+    sections.push("");
+    sections.push("## Network Configuration");
+    sections.push("");
+    sections.push(networkSection);
+  }
+  const contractSection = buildContractSection(keyPages);
+  if (contractSection) {
+    sections.push("");
+    sections.push("## Contract Addresses");
+    sections.push("");
+    sections.push(contractSection);
+  }
+  const quickStartSection = buildQuickStartSection(keyPages);
+  if (quickStartSection) {
+    sections.push("");
+    sections.push("## Quick Start");
+    sections.push("");
+    sections.push(quickStartSection);
+  }
+  const linksSection = buildLinksSection(keyPages);
+  if (linksSection) {
+    sections.push("");
+    sections.push("## Links & Resources");
+    sections.push("");
+    sections.push(linksSection);
+  }
+  if (config.aiContextConfig?.extra_sections) {
+    for (const extra of config.aiContextConfig.extra_sections) {
+      sections.push("");
+      sections.push(`## ${extra.title}`);
+      sections.push("");
+      sections.push(extra.content);
+    }
+  }
+  return sections.join("\n") + "\n";
+}
+function resolveKeyPages(pages, config) {
+  if (config.aiContextConfig?.key_pages?.length) {
+    const manual = [];
+    for (const kp of config.aiContextConfig.key_pages) {
+      const match = pages.find(
+        (p) => p.relativePath === kp.path || p.relativePath === kp.path.replace(/\\/g, "/")
+      );
+      if (match) {
+        manual.push(match);
+      }
+    }
+    if (manual.length > 0) {
+      return manual;
+    }
+  }
+  const detected = detectKeyPages(pages);
+  if (detected.length > 0) {
+    return detected.map((d) => d.page);
+  }
+  return pages;
+}
+function buildNetworkSection(pages) {
+  const networkTables = [];
+  for (const page of pages) {
+    const hasNetworkContent = NETWORK_PATTERNS.some(
+      (p) => p.test(page.content)
+    );
+    if (!hasNetworkContent) continue;
+    const tables = extractTables(page.content);
+    for (const table of tables) {
+      if (NETWORK_PATTERNS.some((p) => p.test(table))) {
+        networkTables.push(`### ${page.title}
+
+${table}`);
+      }
+    }
+  }
+  if (networkTables.length === 0) return null;
+  return networkTables.join("\n\n");
+}
+function buildContractSection(pages) {
+  const addressTables = [];
+  const looseAddresses = [];
+  for (const page of pages) {
+    const addresses = extractContractAddresses(page.content);
+    if (addresses.length === 0) continue;
+    const tables = extractTables(page.content);
+    const tablesWithAddresses = tables.filter(
+      (t) => addresses.some((addr) => t.includes(addr))
+    );
+    if (tablesWithAddresses.length > 0) {
+      for (const table of tablesWithAddresses) {
+        addressTables.push(`### ${page.title}
+
+${table}`);
+      }
+    } else {
+      for (const addr of addresses) {
+        looseAddresses.push(`- \`${addr}\``);
+      }
+    }
+  }
+  if (addressTables.length === 0 && looseAddresses.length === 0) return null;
+  const parts = [];
+  if (addressTables.length > 0) {
+    parts.push(addressTables.join("\n\n"));
+  }
+  if (looseAddresses.length > 0) {
+    parts.push([...new Set(looseAddresses)].join("\n"));
+  }
+  return parts.join("\n\n");
+}
+function buildQuickStartSection(pages) {
+  const allBlocks = /* @__PURE__ */ new Map();
+  for (const page of pages) {
+    const pathLower = page.relativePath.toLowerCase();
+    const titleLower = page.title.toLowerCase();
+    const isQuickstartPage = QUICKSTART_PATH_KEYWORDS.some((kw) => pathLower.includes(kw)) || QUICKSTART_PATH_KEYWORDS.some((kw) => titleLower.includes(kw));
+    if (!isQuickstartPage) continue;
+    const blocks = extractCodeBlocks(page.content);
+    for (const [lang, codeList] of blocks) {
+      if (!allBlocks.has(lang)) {
+        allBlocks.set(lang, []);
+      }
+      allBlocks.get(lang).push(...codeList);
+    }
+  }
+  if (allBlocks.size === 0) return null;
+  const deduplicated = deduplicateBlocks(allBlocks);
+  const parts = [];
+  for (const [lang, codeList] of deduplicated) {
+    for (const code of codeList) {
+      parts.push(`\`\`\`${lang}
+${code}
+\`\`\``);
+    }
+  }
+  return parts.join("\n\n");
+}
+function buildLinksSection(pages) {
+  const allLinks = [];
+  for (const page of pages) {
+    const links = extractLinks(page.content);
+    allLinks.push(...links);
+  }
+  if (allLinks.length === 0) return null;
+  const seen = /* @__PURE__ */ new Set();
+  const unique = [];
+  for (const link of allLinks) {
+    if (!seen.has(link.url)) {
+      seen.add(link.url);
+      unique.push(link);
+    }
+  }
+  const github = unique.filter((l) => l.category === "github");
+  const npm = unique.filter((l) => l.category === "npm");
+  const external = unique.filter((l) => l.category === "external");
+  const parts = [];
+  if (github.length > 0) {
+    parts.push("### GitHub");
+    parts.push("");
+    parts.push(...github.map((l) => `- [${l.text}](${l.url})`));
+  }
+  if (npm.length > 0) {
+    parts.push("");
+    parts.push("### npm");
+    parts.push("");
+    parts.push(...npm.map((l) => `- [${l.text}](${l.url})`));
+  }
+  if (external.length > 0) {
+    parts.push("");
+    parts.push("### External");
+    parts.push("");
+    parts.push(...external.map((l) => `- [${l.text}](${l.url})`));
+  }
+  return parts.join("\n");
+}
+export {
+  generateAiContext
+};
+//# sourceMappingURL=ai-context-QVGQK3GD.js.map

package/dist/ai-context-QVGQK3GD.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/generate/key-pages.ts","../src/generate/extractors.ts","../src/generate/ai-context.ts"],"sourcesContent":["import type { ScannedPage } from \"../core/scanner.js\";\n\nexport interface KeyPageResult {\n  page: ScannedPage;\n  reasons: string[];\n}\n\nconst PATH_KEYWORDS = [\n  \"getting-started\", \"quickstart\", \"quick-start\", \"setup\", \"install\",\n  \"tutorial\", \"overview\", \"introduction\", \"api\", \"sdk\", \"reference\",\n  \"config\", \"configuration\", \"network\", \"deploy\", \"migration\",\n];\n\nconst TITLE_KEYWORDS = [\n  \"getting started\", \"quickstart\", \"quick start\", \"setup\", \"install\",\n  \"tutorial\", \"overview\", \"introduction\", \"api reference\", \"sdk\",\n  \"reference\", \"config\", \"configuration\", \"network\", \"deploy\", \"migration\",\n];\n\nconst CONTENT_PATTERNS: Array<{ pattern: RegExp; label: string }> = [\n  { pattern: /0x[a-fA-F0-9]{40}/, label: \"contract-address\" },\n  { pattern: /chain\\s*id/i, label: \"chain-id\" },\n  { pattern: /rpc\\s*(url|endpoint)/i, label: \"rpc-url\" },\n  { pattern: /npm install\\s+\\S+/, label: \"npm-install\" },\n  { pattern: /go get\\s+\\S+/, label: \"go-get\" },\n  { pattern: /pip install\\s+\\S+/, label: \"pip-install\" },\n];\n\nexport function detectKeyPages(pages: ScannedPage[]): KeyPageResult[] {\n  const results: KeyPageResult[] = [];\n\n  for (const page of pages) {\n    const reasons: string[] = [];\n    const pathLower = page.relativePath.toLowerCase();\n    const titleLower = page.title.toLowerCase();\n\n    if (PATH_KEYWORDS.some((kw) => pathLower.includes(kw))) {\n      reasons.push(\"path-keyword\");\n    }\n\n    if (TITLE_KEYWORDS.some((kw) => titleLower.includes(kw))) {\n      reasons.push(\"title-keyword\");\n    }\n\n    if (CONTENT_PATTERNS.some((cp) => cp.pattern.test(page.content))) {\n      reasons.push(\"content-pattern\");\n    }\n\n    if (reasons.length > 0) {\n      results.push({ page, reasons });\n    }\n  }\n\n  return results;\n}\n","export function extractContractAddresses(content: string): string[] {\n  const regex = /0x[a-fA-F0-9]{40}/g;\n  const matches = content.match(regex);\n  return matches ?? [];\n}\n\nexport function extractCodeBlocks(content: string): Map<string, string[]> {\n  const blocks = new Map<string, string[]>();\n  const regex = /```(\\w+)\\n([\\s\\S]*?)```/g;\n  let match;\n\n  while ((match = regex.exec(content)) !== null) {\n    const lang = match[1];\n    const code = match[2].trim();\n    if (!blocks.has(lang)) {\n      blocks.set(lang, []);\n    }\n    blocks.get(lang)!.push(code);\n  }\n\n  return blocks;\n}\n\nexport function extractTables(content: string): string[] {\n  const tables: string[] = [];\n  const lines = content.split(\"\\n\");\n  let current: string[] = [];\n  let inTable = false;\n\n  for (const line of lines) {\n    const trimmed = line.trim();\n    if (trimmed.startsWith(\"|\") && trimmed.endsWith(\"|\")) {\n      inTable = true;\n      current.push(line);\n    } else {\n      if (inTable && current.length >= 2) {\n        tables.push(current.join(\"\\n\"));\n      }\n      current = [];\n      inTable = false;\n    }\n  }\n\n  if (inTable && current.length >= 2) {\n    tables.push(current.join(\"\\n\"));\n  }\n\n  return tables;\n}\n\nexport interface ExtractedLink {\n  text: string;\n  url: string;\n  category: \"github\" | \"npm\" | \"external\";\n}\n\nexport function extractLinks(content: string): ExtractedLink[] {\n  const links: ExtractedLink[] = [];\n  const regex = /\\[([^\\]]+)\\]\\((https?:\\/\\/[^)]+)\\)/g;\n  let match;\n\n  while ((match = regex.exec(content)) !== null) {\n    const text = match[1];\n    const url = match[2];\n    let category: ExtractedLink[\"category\"] = \"external\";\n    if (url.includes(\"github.com\")) {\n      category = \"github\";\n    } else if (url.includes(\"npmjs.com\") || url.includes(\"npm.im\")) {\n      category = \"npm\";\n    }\n    links.push({ text, url, category });\n  }\n\n  return links;\n}\n\nexport function deduplicateBlocks(blocks: Map<string, string[]>): Map<string, string[]> {\n  const result = new Map<string, string[]>();\n  for (const [lang, codeList] of blocks) {\n    result.set(lang, [...new Set(codeList)]);\n  }\n  return result;\n}\n","import type { ScannedPage } from \"../core/scanner.js\";\nimport { detectKeyPages } from \"./key-pages.js\";\nimport {\n  extractContractAddresses,\n  extractCodeBlocks,\n  extractTables,\n  extractLinks,\n  deduplicateBlocks,\n  type ExtractedLink,\n} from \"./extractors.js\";\n\nexport interface AiContextConfig {\n  title: string;\n  description: string;\n  aiContextConfig?: {\n    key_pages?: Array<{ path: string; section: string }>;\n    extra_sections?: Array<{ title: string; content: string }>;\n  };\n}\n\nconst NETWORK_PATTERNS = [/chain\\s*id/i, /rpc\\s*(url|endpoint)/i];\nconst QUICKSTART_PATH_KEYWORDS = [\n  \"getting-started\",\n  \"quickstart\",\n  \"quick-start\",\n  \"setup\",\n  \"install\",\n  \"sdk\",\n];\n\nexport function generateAiContext(\n  pages: ScannedPage[],\n  config: AiContextConfig,\n): string {\n  const keyPages = resolveKeyPages(pages, config);\n  const sections: string[] = [];\n\n  // Header\n  sections.push(\n    \"<!-- Auto-generated by docs-ready. Review and customize. -->\",\n  );\n  sections.push(\"\");\n  sections.push(`# ${config.title} — AI Context`);\n\n  // Overview — always present\n  sections.push(\"\");\n  sections.push(\"## Overview\");\n  sections.push(\"\");\n  sections.push(config.description);\n\n  // Network Configuration\n  const networkSection = buildNetworkSection(keyPages);\n  if (networkSection) {\n    sections.push(\"\");\n    sections.push(\"## Network Configuration\");\n    sections.push(\"\");\n    sections.push(networkSection);\n  }\n\n  // Contract Addresses\n  const contractSection = buildContractSection(keyPages);\n  if (contractSection) {\n    sections.push(\"\");\n    sections.push(\"## Contract Addresses\");\n    sections.push(\"\");\n    sections.push(contractSection);\n  }\n\n  // Quick Start\n  const quickStartSection = buildQuickStartSection(keyPages);\n  if (quickStartSection) {\n    sections.push(\"\");\n    sections.push(\"## Quick Start\");\n    sections.push(\"\");\n    sections.push(quickStartSection);\n  }\n\n  // Links & Resources\n  const linksSection = buildLinksSection(keyPages);\n  if (linksSection) {\n    sections.push(\"\");\n    sections.push(\"## Links & Resources\");\n    sections.push(\"\");\n    sections.push(linksSection);\n  }\n\n  // Extra sections from config\n  if (config.aiContextConfig?.extra_sections) {\n    for (const extra of config.aiContextConfig.extra_sections) {\n      sections.push(\"\");\n      sections.push(`## ${extra.title}`);\n      sections.push(\"\");\n      sections.push(extra.content);\n    }\n  }\n\n  return sections.join(\"\\n\") + \"\\n\";\n}\n\nfunction resolveKeyPages(\n  pages: ScannedPage[],\n  config: AiContextConfig,\n): ScannedPage[] {\n  // Manual override\n  if (config.aiContextConfig?.key_pages?.length) {\n    const manual: ScannedPage[] = [];\n    for (const kp of config.aiContextConfig.key_pages) {\n      const match = pages.find(\n        (p) =>\n          p.relativePath === kp.path ||\n          p.relativePath === kp.path.replace(/\\\\/g, \"/\"),\n      );\n      if (match) {\n        manual.push(match);\n      }\n    }\n    // If manual pages resolved, return them; otherwise fall through\n    if (manual.length > 0) {\n      return manual;\n    }\n  }\n\n  // Auto-detect\n  const detected = detectKeyPages(pages);\n  if (detected.length > 0) {\n    return detected.map((d) => d.page);\n  }\n\n  // Fallback: all pages\n  return pages;\n}\n\nfunction buildNetworkSection(pages: ScannedPage[]): string | null {\n  const networkTables: string[] = [];\n\n  for (const page of pages) {\n    const hasNetworkContent = NETWORK_PATTERNS.some((p) =>\n      p.test(page.content),\n    );\n    if (!hasNetworkContent) continue;\n\n    const tables = extractTables(page.content);\n    // Only include tables that contain network-related content\n    for (const table of tables) {\n      if (NETWORK_PATTERNS.some((p) => p.test(table))) {\n        networkTables.push(`### ${page.title}\\n\\n${table}`);\n      }\n    }\n  }\n\n  if (networkTables.length === 0) return null;\n  return networkTables.join(\"\\n\\n\");\n}\n\nfunction buildContractSection(pages: ScannedPage[]): string | null {\n  const addressTables: string[] = [];\n  const looseAddresses: string[] = [];\n\n  for (const page of pages) {\n    const addresses = extractContractAddresses(page.content);\n    if (addresses.length === 0) continue;\n\n    // Check if the addresses appear inside tables\n    const tables = extractTables(page.content);\n    const tablesWithAddresses = tables.filter((t) =>\n      addresses.some((addr) => t.includes(addr)),\n    );\n\n    if (tablesWithAddresses.length > 0) {\n      for (const table of tablesWithAddresses) {\n        addressTables.push(`### ${page.title}\\n\\n${table}`);\n      }\n    } else {\n      // Fallback: bullet list\n      for (const addr of addresses) {\n        looseAddresses.push(`- \\`${addr}\\``);\n      }\n    }\n  }\n\n  if (addressTables.length === 0 && looseAddresses.length === 0) return null;\n\n  const parts: string[] = [];\n  if (addressTables.length > 0) {\n    parts.push(addressTables.join(\"\\n\\n\"));\n  }\n  if (looseAddresses.length > 0) {\n    parts.push([...new Set(looseAddresses)].join(\"\\n\"));\n  }\n  return parts.join(\"\\n\\n\");\n}\n\nfunction buildQuickStartSection(pages: ScannedPage[]): string | null {\n  const allBlocks = new Map<string, string[]>();\n\n  for (const page of pages) {\n    const pathLower = page.relativePath.toLowerCase();\n    const titleLower = page.title.toLowerCase();\n    const isQuickstartPage =\n      QUICKSTART_PATH_KEYWORDS.some((kw) => pathLower.includes(kw)) ||\n      QUICKSTART_PATH_KEYWORDS.some((kw) => titleLower.includes(kw));\n\n    if (!isQuickstartPage) continue;\n\n    const blocks = extractCodeBlocks(page.content);\n    for (const [lang, codeList] of blocks) {\n      if (!allBlocks.has(lang)) {\n        allBlocks.set(lang, []);\n      }\n      allBlocks.get(lang)!.push(...codeList);\n    }\n  }\n\n  if (allBlocks.size === 0) return null;\n\n  const deduplicated = deduplicateBlocks(allBlocks);\n  const parts: string[] = [];\n\n  for (const [lang, codeList] of deduplicated) {\n    for (const code of codeList) {\n      parts.push(`\\`\\`\\`${lang}\\n${code}\\n\\`\\`\\``);\n    }\n  }\n\n  return parts.join(\"\\n\\n\");\n}\n\nfunction buildLinksSection(pages: ScannedPage[]): string | null {\n  const allLinks: ExtractedLink[] = [];\n\n  for (const page of pages) {\n    const links = extractLinks(page.content);\n    allLinks.push(...links);\n  }\n\n  if (allLinks.length === 0) return null;\n\n  // Deduplicate by URL\n  const seen = new Set<string>();\n  const unique: ExtractedLink[] = [];\n  for (const link of allLinks) {\n    if (!seen.has(link.url)) {\n      seen.add(link.url);\n      unique.push(link);\n    }\n  }\n\n  // Categorize\n  const github = unique.filter((l) => l.category === \"github\");\n  const npm = unique.filter((l) => l.category === \"npm\");\n  const external = unique.filter((l) => l.category === \"external\");\n\n  const parts: string[] = [];\n\n  if (github.length > 0) {\n    parts.push(\"### GitHub\");\n    parts.push(\"\");\n    parts.push(...github.map((l) => `- [${l.text}](${l.url})`));\n  }\n\n  if (npm.length > 0) {\n    parts.push(\"\");\n    parts.push(\"### npm\");\n    parts.push(\"\");\n    parts.push(...npm.map((l) => `- [${l.text}](${l.url})`));\n  }\n\n  if (external.length > 0) {\n    parts.push(\"\");\n    parts.push(\"### External\");\n    parts.push(\"\");\n    parts.push(...external.map((l) => `- [${l.text}](${l.url})`));\n  }\n\n  return parts.join(\"\\n\");\n}\n"],"mappings":"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","names":[]}

package/dist/{generate-56HFRN5I.js → generate-LDVEG2WV.js}

@@ -2186,8 +2186,30 @@ async function generateCommand(options = {}) {
       log.success(`Generated llms-full.txt (${formatTokens(estimateTokens(llmsFullTxt))})`);
     }
   }
+  if (config.generate.ai_context && options.only !== "llms-txt" && options.only !== "llms-full") {
+    const { generateAiContext } = await import("./ai-context-QVGQK3GD.js");
+    const aiContext = generateAiContext(pages, {
+      title: config.title,
+      description: config.description,
+      aiContextConfig: config.generate.ai_context_config ? {
+        key_pages: config.generate.ai_context_config.key_pages,
+        extra_sections: config.generate.ai_context_config.extra_sections?.map((s) => ({
+          title: s.title,
+          content: s.source ?? ""
+        }))
+      } : void 0
+    });
+    if (options.dryRun) {
+      log.info("[dry-run] Would write ai-context.md");
+      log.dim(`  ${aiContext.length} chars, ${formatTokens(estimateTokens(aiContext))}`);
+    } else {
+      await fs3.mkdir(outputDir, { recursive: true });
+      await fs3.writeFile(path5.join(outputDir, "ai-context.md"), aiContext, "utf-8");
+      log.success(`Generated ai-context.md (${formatTokens(estimateTokens(aiContext))})`);
+    }
+  }
 }
 export {
   generateCommand
 };
-//# sourceMappingURL=generate-56HFRN5I.js.map
+//# sourceMappingURL=generate-LDVEG2WV.js.map