docs-ready 0.2.0 → 0.4.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/chunk-QI2AROM3.js

@@ -0,0 +1,153 @@
+#!/usr/bin/env node
+
+// src/core/config.ts
+import fs from "fs/promises";
+import path from "path";
+import YAML from "yaml";
+var DEFAULTS = {
+  docs: {
+    dir: "./docs",
+    include: ["**/*.md", "**/*.mdx"],
+    exclude: ["**/node_modules/**", "**/_*"]
+  },
+  generate: {
+    llms_txt: true,
+    llms_full_txt: true,
+    ai_context: true,
+    output_dir: "./build"
+  },
+  guard: {
+    npm_packages: [],
+    github_releases: [],
+    endpoints: [],
+    readme_scans: [],
+    workflow: {
+      enabled: true,
+      schedule: "0 9 */3 * *",
+      create_issues: true,
+      labels: ["ai-context-review", "documentation"]
+    }
+  },
+  deploy: {
+    platform: "none",
+    cors: { enabled: true, origins: ["*"] }
+  },
+  validate: {
+    max_tokens: 15e4,
+    check_links: true,
+    check_coverage: true,
+    coverage_threshold: 0.95
+  }
+};
+var CONFIG_FILES = [
+  { name: ".docs-ready.yaml", parser: "yaml" },
+  { name: ".docs-ready.yml", parser: "yaml" },
+  { name: ".docs-ready.json", parser: "json" },
+  { name: ".docs-ready.toml", parser: "toml" }
+];
+async function loadConfig(dir, configPath) {
+  let raw;
+  if (configPath) {
+    const content = await fs.readFile(configPath, "utf-8");
+    raw = parseConfig(content, configPath);
+  } else {
+    for (const { name, parser } of CONFIG_FILES) {
+      const fullPath = path.join(dir, name);
+      try {
+        const content = await fs.readFile(fullPath, "utf-8");
+        if (parser === "toml") {
+          throw new Error("TOML support requires a TOML parser. Use .yaml or .json instead.");
+        }
+        raw = parseConfig(content, fullPath);
+        break;
+      } catch (err) {
+        if (err.code === "ENOENT") continue;
+        throw err;
+      }
+    }
+  }
+  if (!raw) {
+    throw new Error(
+      "No config file found. Run `docs-ready init` to create one, or create .docs-ready.yaml manually."
+    );
+  }
+  validate(raw);
+  return applyDefaults(raw);
+}
+function parseConfig(content, filePath) {
+  if (filePath.endsWith(".json")) {
+    return JSON.parse(content);
+  }
+  const parsed = YAML.parse(content);
+  if (parsed === null || typeof parsed !== "object") {
+    throw new Error(`Failed to parse config file: ${filePath}`);
+  }
+  return parsed;
+}
+function validate(raw) {
+  const missing = [];
+  if (!raw.title || typeof raw.title !== "string") missing.push("title");
+  if (!raw.description || typeof raw.description !== "string") missing.push("description");
+  if (!raw.url || typeof raw.url !== "string") missing.push("url");
+  if (missing.length > 0) {
+    throw new Error(
+      `Missing required config fields: ${missing.join(", ")}. Add them to your .docs-ready.yaml file.`
+    );
+  }
+}
+function applyDefaults(raw) {
+  const docs = raw.docs;
+  const generate = raw.generate;
+  const guard = raw.guard;
+  const deploy = raw.deploy;
+  const validateConf = raw.validate;
+  const guardWorkflow = guard?.workflow ?? {};
+  return {
+    title: raw.title,
+    description: raw.description,
+    url: raw.url,
+    docs: {
+      dir: docs?.dir ?? DEFAULTS.docs.dir,
+      include: docs?.include ?? DEFAULTS.docs.include,
+      exclude: docs?.exclude ?? DEFAULTS.docs.exclude
+    },
+    generate: {
+      llms_txt: generate?.llms_txt ?? DEFAULTS.generate.llms_txt,
+      llms_full_txt: generate?.llms_full_txt ?? DEFAULTS.generate.llms_full_txt,
+      ai_context: generate?.ai_context ?? DEFAULTS.generate.ai_context,
+      output_dir: generate?.output_dir ?? DEFAULTS.generate.output_dir,
+      sections: generate?.sections,
+      ai_context_config: generate?.ai_context_config
+    },
+    guard: {
+      npm_packages: guard?.npm_packages ?? DEFAULTS.guard.npm_packages,
+      github_releases: guard?.github_releases ?? DEFAULTS.guard.github_releases,
+      endpoints: guard?.endpoints ?? DEFAULTS.guard.endpoints,
+      readme_scans: guard?.readme_scans ?? DEFAULTS.guard.readme_scans,
+      workflow: {
+        enabled: guardWorkflow.enabled ?? DEFAULTS.guard.workflow.enabled,
+        schedule: guardWorkflow.schedule ?? DEFAULTS.guard.workflow.schedule,
+        create_issues: guardWorkflow.create_issues ?? DEFAULTS.guard.workflow.create_issues,
+        labels: guardWorkflow.labels ?? DEFAULTS.guard.workflow.labels
+      }
+    },
+    deploy: {
+      platform: deploy?.platform ?? DEFAULTS.deploy.platform,
+      cors: {
+        enabled: deploy?.cors?.enabled ?? DEFAULTS.deploy.cors.enabled,
+        origins: deploy?.cors?.origins ?? DEFAULTS.deploy.cors.origins
+      }
+    },
+    validate: {
+      max_tokens: validateConf?.max_tokens ?? DEFAULTS.validate.max_tokens,
+      check_links: validateConf?.check_links ?? DEFAULTS.validate.check_links,
+      check_coverage: validateConf?.check_coverage ?? DEFAULTS.validate.check_coverage,
+      coverage_threshold: validateConf?.coverage_threshold ?? DEFAULTS.validate.coverage_threshold
+    }
+  };
+}
+
+export {
+  loadConfig
+};
+//# sourceMappingURL=chunk-QI2AROM3.js.map

package/dist/chunk-QI2AROM3.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/core/config.ts"],"sourcesContent":["import fs from \"node:fs/promises\";\nimport path from \"node:path\";\nimport YAML from \"yaml\";\n\nexport interface DocsReadyConfig {\n  title: string;\n  description: string;\n  url: string;\n  docs: {\n    dir: string;\n    include: string[];\n    exclude: string[];\n  };\n  generate: {\n    llms_txt: boolean;\n    llms_full_txt: boolean;\n    ai_context: boolean;\n    output_dir: string;\n    sections?: Array<{ title: string; patterns: string[] }>;\n    ai_context_config?: {\n      key_pages?: Array<{ path: string; section: string }>;\n      extra_sections?: Array<{ title: string; source?: string; auto_extract?: boolean }>;\n    };\n  };\n  guard: {\n    npm_packages: Array<{ name: string; label: string }>;\n    github_releases: Array<{ repo: string; label: string }>;\n    endpoints: Array<{ url: string; label: string; expected_status?: number[] }>;\n    readme_scans: Array<{ repo: string; keywords: string[] }>;\n    workflow: {\n      enabled: boolean;\n      schedule: string;\n      create_issues: boolean;\n      labels: string[];\n    };\n  };\n  deploy: {\n    platform: \"vercel\" | \"netlify\" | \"cloudflare\" | \"none\";\n    cors: { enabled: boolean; origins: string[] };\n  };\n  validate: {\n    max_tokens: number;\n    check_links: boolean;\n    check_coverage: boolean;\n    coverage_threshold: number;\n  };\n}\n\nconst DEFAULTS: Omit<DocsReadyConfig, \"title\" | \"description\" | \"url\"> = {\n  docs: {\n    dir: \"./docs\",\n    include: [\"**/*.md\", \"**/*.mdx\"],\n    exclude: [\"**/node_modules/**\", \"**/_*\"],\n  },\n  generate: {\n    llms_txt: true,\n    llms_full_txt: true,\n    ai_context: true,\n    output_dir: \"./build\",\n  },\n  guard: {\n    npm_packages: [],\n    github_releases: [],\n    endpoints: [],\n    readme_scans: [],\n    workflow: {\n      enabled: true,\n      schedule: \"0 9 */3 * *\",\n      create_issues: true,\n      labels: [\"ai-context-review\", \"documentation\"],\n    },\n  },\n  deploy: {\n    platform: \"none\",\n    cors: { enabled: true, origins: [\"*\"] },\n  },\n  validate: {\n    max_tokens: 150000,\n    check_links: true,\n    check_coverage: true,\n    coverage_threshold: 0.95,\n  },\n};\n\nconst CONFIG_FILES = [\n  { name: \".docs-ready.yaml\", parser: \"yaml\" as const },\n  { name: \".docs-ready.yml\", parser: \"yaml\" as const },\n  { name: \".docs-ready.json\", parser: \"json\" as const },\n  { name: \".docs-ready.toml\", parser: \"toml\" as const },\n];\n\nexport async function loadConfig(dir: string, configPath?: string): Promise<DocsReadyConfig> {\n  let raw: Record<string, unknown> | undefined;\n\n  if (configPath) {\n    const content = await fs.readFile(configPath, \"utf-8\");\n    raw = parseConfig(content, configPath);\n  } else {\n    for (const { name, parser } of CONFIG_FILES) {\n      const fullPath = path.join(dir, name);\n      try {\n        const content = await fs.readFile(fullPath, \"utf-8\");\n        if (parser === \"toml\") {\n          throw new Error(\"TOML support requires a TOML parser. Use .yaml or .json instead.\");\n        }\n        raw = parseConfig(content, fullPath);\n        break;\n      } catch (err) {\n        if ((err as NodeJS.ErrnoException).code === \"ENOENT\") continue;\n        throw err;\n      }\n    }\n  }\n\n  if (!raw) {\n    throw new Error(\n      \"No config file found. Run `docs-ready init` to create one, or create .docs-ready.yaml manually.\"\n    );\n  }\n\n  validate(raw);\n  return applyDefaults(raw);\n}\n\nfunction parseConfig(content: string, filePath: string): Record<string, unknown> {\n  if (filePath.endsWith(\".json\")) {\n    return JSON.parse(content);\n  }\n  const parsed = YAML.parse(content);\n  if (parsed === null || typeof parsed !== \"object\") {\n    throw new Error(`Failed to parse config file: ${filePath}`);\n  }\n  return parsed;\n}\n\nfunction validate(raw: Record<string, unknown>): void {\n  const missing: string[] = [];\n  if (!raw.title || typeof raw.title !== \"string\") missing.push(\"title\");\n  if (!raw.description || typeof raw.description !== \"string\") missing.push(\"description\");\n  if (!raw.url || typeof raw.url !== \"string\") missing.push(\"url\");\n\n  if (missing.length > 0) {\n    throw new Error(\n      `Missing required config fields: ${missing.join(\", \")}. ` +\n      `Add them to your .docs-ready.yaml file.`\n    );\n  }\n}\n\nfunction applyDefaults(raw: Record<string, unknown>): DocsReadyConfig {\n  const docs = raw.docs as Record<string, unknown> | undefined;\n  const generate = raw.generate as Record<string, unknown> | undefined;\n  const guard = raw.guard as Record<string, unknown> | undefined;\n  const deploy = raw.deploy as Record<string, unknown> | undefined;\n  const validateConf = raw.validate as Record<string, unknown> | undefined;\n  const guardWorkflow = (guard?.workflow as Record<string, unknown>) ?? {};\n\n  return {\n    title: raw.title as string,\n    description: raw.description as string,\n    url: raw.url as string,\n    docs: {\n      dir: (docs?.dir as string) ?? DEFAULTS.docs.dir,\n      include: (docs?.include as string[]) ?? DEFAULTS.docs.include,\n      exclude: (docs?.exclude as string[]) ?? DEFAULTS.docs.exclude,\n    },\n    generate: {\n      llms_txt: (generate?.llms_txt as boolean) ?? DEFAULTS.generate.llms_txt,\n      llms_full_txt: (generate?.llms_full_txt as boolean) ?? DEFAULTS.generate.llms_full_txt,\n      ai_context: (generate?.ai_context as boolean) ?? DEFAULTS.generate.ai_context,\n      output_dir: (generate?.output_dir as string) ?? DEFAULTS.generate.output_dir,\n      sections: generate?.sections as DocsReadyConfig[\"generate\"][\"sections\"],\n      ai_context_config: generate?.ai_context_config as DocsReadyConfig[\"generate\"][\"ai_context_config\"],\n    },\n    guard: {\n      npm_packages: (guard?.npm_packages as DocsReadyConfig[\"guard\"][\"npm_packages\"]) ?? DEFAULTS.guard.npm_packages,\n      github_releases: (guard?.github_releases as DocsReadyConfig[\"guard\"][\"github_releases\"]) ?? DEFAULTS.guard.github_releases,\n      endpoints: (guard?.endpoints as DocsReadyConfig[\"guard\"][\"endpoints\"]) ?? DEFAULTS.guard.endpoints,\n      readme_scans: (guard?.readme_scans as DocsReadyConfig[\"guard\"][\"readme_scans\"]) ?? DEFAULTS.guard.readme_scans,\n      workflow: {\n        enabled: (guardWorkflow.enabled as boolean) ?? DEFAULTS.guard.workflow.enabled,\n        schedule: (guardWorkflow.schedule as string) ?? DEFAULTS.guard.workflow.schedule,\n        create_issues: (guardWorkflow.create_issues as boolean) ?? DEFAULTS.guard.workflow.create_issues,\n        labels: (guardWorkflow.labels as string[]) ?? DEFAULTS.guard.workflow.labels,\n      },\n    },\n    deploy: {\n      platform: (deploy?.platform as DocsReadyConfig[\"deploy\"][\"platform\"]) ?? DEFAULTS.deploy.platform,\n      cors: {\n        enabled: ((deploy?.cors as Record<string, unknown>)?.enabled as boolean) ?? DEFAULTS.deploy.cors.enabled,\n        origins: ((deploy?.cors as Record<string, unknown>)?.origins as string[]) ?? DEFAULTS.deploy.cors.origins,\n      },\n    },\n    validate: {\n      max_tokens: (validateConf?.max_tokens as number) ?? DEFAULTS.validate.max_tokens,\n      check_links: (validateConf?.check_links as boolean) ?? DEFAULTS.validate.check_links,\n      check_coverage: (validateConf?.check_coverage as boolean) ?? DEFAULTS.validate.check_coverage,\n      coverage_threshold: (validateConf?.coverage_threshold as number) ?? DEFAULTS.validate.coverage_threshold,\n    },\n  };\n}\n"],"mappings":"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","names":[]}