docs-ready 0.2.0 → 0.4.0

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

@@ -1,167 +1,23 @@
 #!/usr/bin/env node
+import {
+  loadConfig
+} from "./chunk-QI2AROM3.js";
 import {
   log,
   spinner
 } from "./chunk-7YN54Y4Y.js";
 
 // src/cli/commands/generate.ts
-import fs3 from "fs/promises";
-import path5 from "path";
+import fs2 from "fs/promises";
+import path4 from "path";
 
-// src/core/config.ts
+// src/core/scanner.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
-    }
-  };
-}
-
-// src/core/scanner.ts
-import fs2 from "fs/promises";
-import path2 from "path";
 import matter from "gray-matter";
 import { glob } from "glob";
 async function scanDocs(docsDir, options) {
-  const resolvedDir = path2.resolve(docsDir);
+  const resolvedDir = path.resolve(docsDir);
   const allFiles = [];
   for (const pattern of options.include) {
     const matches = await glob(pattern, {
@@ -175,8 +31,8 @@ async function scanDocs(docsDir, options) {
   const uniqueFiles = [...new Set(allFiles)];
   const pages = [];
   for (const relativePath of uniqueFiles) {
-    const filePath = path2.join(resolvedDir, relativePath);
-    const raw = await fs2.readFile(filePath, "utf-8");
+    const filePath = path.join(resolvedDir, relativePath);
+    const raw = await fs.readFile(filePath, "utf-8");
     const { data: frontmatter, content } = matter(raw);
     const title = resolveTitle(frontmatter, content, relativePath);
     const description = frontmatter.description ?? null;
@@ -205,12 +61,12 @@ function resolveTitle(frontmatter, content, relativePath) {
   if (h1Match) {
     return h1Match[1].trim();
   }
-  const basename = path2.basename(relativePath, path2.extname(relativePath));
+  const basename = path.basename(relativePath, path.extname(relativePath));
   return basename.charAt(0).toUpperCase() + basename.slice(1).replace(/[-_]/g, " ");
 }
 
 // src/generate/llms-txt.ts
-import path4 from "path";
+import path3 from "path";
 
 // node_modules/balanced-match/dist/esm/index.js
 var balanced = (a, b, str) => {
@@ -1264,11 +1120,11 @@ var qmarksTestNoExtDot = ([$0]) => {
   return (f) => f.length === len && f !== "." && f !== "..";
 };
 var defaultPlatform = typeof process === "object" && process ? typeof process.env === "object" && process.env && process.env.__MINIMATCH_TESTING_PLATFORM__ || process.platform : "posix";
-var path3 = {
+var path2 = {
   win32: { sep: "\\" },
   posix: { sep: "/" }
 };
-var sep = defaultPlatform === "win32" ? path3.win32.sep : path3.posix.sep;
+var sep = defaultPlatform === "win32" ? path2.win32.sep : path2.posix.sep;
 minimatch.sep = sep;
 var GLOBSTAR = /* @__PURE__ */ Symbol("globstar **");
 minimatch.GLOBSTAR = GLOBSTAR;
@@ -2089,7 +1945,7 @@ function extractFirstParagraph(content) {
 function groupByDirectory(pages) {
   const groups = /* @__PURE__ */ new Map();
   for (const page of pages) {
-    const dir = path4.dirname(page.relativePath);
+    const dir = path3.dirname(page.relativePath);
     const topDir = dir === "." ? "." : dir.split("/")[0];
     if (!groups.has(topDir)) {
       groups.set(topDir, []);
@@ -2147,7 +2003,7 @@ async function generateCommand(options = {}) {
   const config = await loadConfig(cwd);
   const spin = spinner("Scanning documentation...");
   spin.start();
-  const docsDir = path5.resolve(cwd, config.docs.dir);
+  const docsDir = path4.resolve(cwd, config.docs.dir);
   const pages = await scanDocs(docsDir, {
     include: config.docs.include,
     exclude: config.docs.exclude
@@ -2158,7 +2014,7 @@ async function generateCommand(options = {}) {
     return;
   }
   log.info(`Found ${pages.length} documentation pages`);
-  const outputDir = path5.resolve(cwd, config.generate.output_dir);
+  const outputDir = path4.resolve(cwd, config.generate.output_dir);
   if (config.generate.llms_txt && options.only !== "llms-full") {
     const llmsTxt = generateLlmsTxt(pages, {
       title: config.title,
@@ -2170,8 +2026,8 @@ async function generateCommand(options = {}) {
       log.info("[dry-run] Would write llms.txt");
       log.dim(`  ${llmsTxt.length} chars, ${formatTokens(estimateTokens(llmsTxt))}`);
     } else {
-      await fs3.mkdir(outputDir, { recursive: true });
-      await fs3.writeFile(path5.join(outputDir, "llms.txt"), llmsTxt, "utf-8");
+      await fs2.mkdir(outputDir, { recursive: true });
+      await fs2.writeFile(path4.join(outputDir, "llms.txt"), llmsTxt, "utf-8");
       log.success(`Generated llms.txt (${formatTokens(estimateTokens(llmsTxt))})`);
     }
   }
@@ -2181,13 +2037,35 @@ async function generateCommand(options = {}) {
       log.info("[dry-run] Would write llms-full.txt");
       log.dim(`  ${llmsFullTxt.length} chars, ${formatTokens(estimateTokens(llmsFullTxt))}`);
     } else {
-      await fs3.mkdir(outputDir, { recursive: true });
-      await fs3.writeFile(path5.join(outputDir, "llms-full.txt"), llmsFullTxt, "utf-8");
+      await fs2.mkdir(outputDir, { recursive: true });
+      await fs2.writeFile(path4.join(outputDir, "llms-full.txt"), llmsFullTxt, "utf-8");
       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 fs2.mkdir(outputDir, { recursive: true });
+      await fs2.writeFile(path4.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-N54SEQ7E.js.map