docs-ready 0.3.0 → 0.4.0

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":[]}

package/dist/{generate-LDVEG2WV.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,8 +2037,8 @@ 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))})`);
     }
   }
@@ -2203,8 +2059,8 @@ async function generateCommand(options = {}) {
       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");
+      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))})`);
     }
   }
@@ -2212,4 +2068,4 @@ async function generateCommand(options = {}) {
 export {
   generateCommand
 };
-//# sourceMappingURL=generate-LDVEG2WV.js.map
+//# sourceMappingURL=generate-N54SEQ7E.js.map