barodoc 2.0.0 → 3.0.0

package/dist/{chunk-JIP64MDC.js → chunk-RK4USU7V.js}

@@ -102,6 +102,12 @@ async function createProject(options) {
   } else {
     await fs.ensureDir(publicLink);
   }
+  const overridesDir = path.join(root, "overrides");
+  const overridesLink = path.join(projectDir, "overrides");
+  if (fs.existsSync(overridesDir)) {
+    await fs.symlink(overridesDir, overridesLink, "dir");
+    console.log(pc.dim("  Linked overrides/ directory"));
+  }
   return projectDir;
 }
 async function installDependencies(projectDir, force = false) {
@@ -160,6 +166,12 @@ const docsCollection = defineCollection({
   schema: z.object({
     title: z.string().optional(),
     description: z.string().optional(),
+    tags: z.array(z.string()).optional(),
+    related: z.array(z.string()).optional(),
+    category: z.string().optional(),
+    api_reference: z.boolean().optional(),
+    difficulty: z.enum(["beginner", "intermediate", "advanced"]).optional(),
+    lastUpdated: z.date().optional(),
   }),
 });
 

package/dist/cli.js

@@ -6,14 +6,14 @@ import {
   installDependencies,
   isCustomProject,
   loadProjectConfig
-} from "./chunk-JIP64MDC.js";
+} from "./chunk-RK4USU7V.js";
 
 // src/cli.ts
 import cac from "cac";
-import pc8 from "picocolors";
+import pc10 from "picocolors";
 
 // package.json
-var version = "2.0.0";
+var version = "3.0.0";
 
 // src/commands/serve.ts
 import path from "path";
@@ -160,16 +160,22 @@ markdown files that are fully compatible with barodoc.
 
 \`\`\`
 docs/
-  {locale}/          # e.g., en/, ko/, ja/
-    {slug}.md        # Markdown or MDX files
+  {locale}/              # e.g., en/, ko/, ja/
+    {slug}.md            # Markdown or MDX files
     {slug}.mdx
+    {category}/{slug}.mdx  # Nested paths (e.g., guides/installation.mdx)
+
+overrides/               # Optional: component/layout overrides
+  components/            # Custom or overridden MDX components
+  layouts/               # Layout overrides
 
-public/              # Static assets (images, logo, etc.)
-barodoc.config.json  # Site configuration
+public/                  # Static assets (images, logo, etc.)
+barodoc.config.json      # Site configuration
 \`\`\`
 
 - Each page is a single \`.md\` or \`.mdx\` file inside \`docs/{locale}/\`.
 - The filename (without extension) becomes the **slug** used in navigation.
+- Nested paths are supported: \`docs/en/guides/installation.mdx\` \u2192 slug \`guides/installation\`.
 - Use \`.mdx\` when you need to include interactive components (Callout, Steps, etc.).
 - Use \`.md\` for plain text-only pages.
 
@@ -183,11 +189,25 @@ Every page **should** include frontmatter at the top:
 ---
 title: Page Title
 description: A brief description shown in search results and meta tags.
+tags: [topic1, topic2]
+related: [other-page-slug, guides/related-guide]
+category: guides
+difficulty: beginner
 ---
 \`\`\`
 
-- \`title\` \u2014 Optional. If omitted, the first \`#\` heading is used.
-- \`description\` \u2014 Recommended. Used for SEO and search result snippets.
+| Field | Type | Description |
+|-------|------|-------------|
+| \`title\` | string | Optional. If omitted, the first \`#\` heading is used. |
+| \`description\` | string | Recommended. Used for SEO and search result snippets. |
+| \`tags\` | string[] | Classification tags for search and AI filtering. |
+| \`related\` | string[] | Slugs of related pages. Must be valid slugs in navigation. |
+| \`category\` | string | Explicit category. Auto-detected from navigation group if omitted. |
+| \`difficulty\` | \`"beginner"\` | \`"intermediate"\` | \`"advanced"\` | Content difficulty. |
+| \`api_reference\` | boolean | Marks the page as API reference content. |
+| \`lastUpdated\` | date | Manual override for last-updated timestamp. |
+
+**Rules for \`related\`:** Only use slugs that exist in \`barodoc.config.json\` navigation. \`barodoc check\` validates these.
 
 ---
 
@@ -346,22 +366,53 @@ If the project has multiple locales:
 
 - Use \`##\` for top-level sections within a page (the page \`#\` title is auto-rendered).
 - Keep descriptions concise (1\u20132 sentences for \`description\` frontmatter).
-- Use fenced code blocks with language identifiers for syntax highlighting.
+- **Always include a language identifier on fenced code blocks** (e.g., \\\`\\\`\\\`bash, \\\`\\\`\\\`json, \\\`\\\`\\\`typescript). This is required for syntax highlighting and AI code classification.
 - Prefer \`<Callout type="warning">\` over bold text for important notices.
 - Use \`<Steps>\` for any multi-step process (installation, setup, etc.).
 - Images go in \`public/\` and are referenced as \`/image.png\`.
+- When referencing other doc pages, use the slug (e.g., \`guides/configuration\`), not file paths.
+
+---
+
+## Overrides (Custom Components)
+
+Place custom components in \`overrides/components/\` to extend or replace theme components:
+
+\`\`\`
+overrides/
+  components/
+    CustomBanner.tsx      # New component
+    Callout.tsx           # Overrides built-in Callout
+\`\`\`
+
+Import in MDX via the alias:
+
+\`\`\`mdx
+import CustomBanner from "@overrides/components/CustomBanner";
+
+<CustomBanner text="Hello" />
+\`\`\`
 
 ---
 
-## Validation
+## CLI Commands
 
 \`\`\`bash
-# Check for issues (missing files, orphan pages, frontmatter)
+# Check for issues (missing files, orphan pages, frontmatter, invalid related links)
 barodoc check
 
 # Auto-fix navigation mismatches
 barodoc check --fix
 
+# Generate docs-manifest.json (structured metadata + content for AI agents)
+barodoc manifest
+
+# Generate RAG-optimized chunks
+barodoc manifest --chunks
+
+# Generate JSON Schema for config and frontmatter
+barodoc schema
+
 # Start dev server
 barodoc serve
 
@@ -791,6 +842,25 @@ async function eject(dir, options) {
 import path7 from "path";
 import pc7 from "picocolors";
 import fs6 from "fs-extra";
+async function collectSlugs(baseDir, prefix = "") {
+  const slugs = [];
+  if (!await fs6.pathExists(baseDir)) return slugs;
+  const entries = await fs6.readdir(baseDir, { withFileTypes: true });
+  for (const entry of entries) {
+    if (entry.isDirectory()) {
+      slugs.push(...await collectSlugs(path7.join(baseDir, entry.name), prefix ? `${prefix}/${entry.name}` : entry.name));
+    } else if (entry.name.endsWith(".md") || entry.name.endsWith(".mdx")) {
+      const slug = entry.name.replace(/\.(mdx?)$/, "");
+      slugs.push(prefix ? `${prefix}/${slug}` : slug);
+    }
+  }
+  return slugs;
+}
+function resolveDocsDir(root) {
+  const customMode = path7.join(root, "src", "content", "docs");
+  if (fs6.existsSync(customMode)) return customMode;
+  return path7.join(root, "docs");
+}
 async function scanDocsFiles(docsDir) {
   const result = /* @__PURE__ */ new Map();
   if (!await fs6.pathExists(docsDir)) {
@@ -801,13 +871,7 @@ async function scanDocsFiles(docsDir) {
     const localeDir = path7.join(docsDir, locale);
     const stat = await fs6.stat(localeDir);
     if (!stat.isDirectory()) continue;
-    const slugs = [];
-    const files = await fs6.readdir(localeDir);
-    for (const file of files) {
-      if (file.endsWith(".md") || file.endsWith(".mdx")) {
-        slugs.push(file.replace(/\.(mdx?)$/, ""));
-      }
-    }
+    const slugs = await collectSlugs(localeDir);
     result.set(locale, slugs);
   }
   return result;
@@ -827,27 +891,67 @@ function getNavSlugs(config) {
   }
   return result;
 }
+function parseFrontmatter(content) {
+  if (!content.startsWith("---")) return null;
+  const end = content.indexOf("---", 3);
+  if (end === -1) return null;
+  const block = content.slice(3, end).trim();
+  const result = {};
+  for (const line of block.split("\n")) {
+    const match = line.match(/^(\w[\w_]*):\s*(.*)/);
+    if (!match) continue;
+    const [, key, raw] = match;
+    const value = raw.trim();
+    if (value.startsWith("[") && value.endsWith("]")) {
+      result[key] = value.slice(1, -1).split(",").map((s) => s.trim().replace(/^['"]|['"]$/g, ""));
+    } else if (value === "true") {
+      result[key] = true;
+    } else if (value === "false") {
+      result[key] = false;
+    } else {
+      result[key] = value;
+    }
+  }
+  return result;
+}
 async function checkFrontmatter(filePath) {
   const content = await fs6.readFile(filePath, "utf-8");
   const missing = [];
   if (!content.startsWith("---")) {
     return missing;
   }
-  const end = content.indexOf("---", 3);
-  if (end === -1) return missing;
-  const frontmatter = content.slice(3, end);
-  if (!frontmatter.includes("description:")) {
-    missing.push("description");
-  }
+  const fm = parseFrontmatter(content);
+  if (!fm) return missing;
+  if (!fm.description) missing.push("description");
   return missing;
 }
+async function checkRelatedLinks(docsDir, locales, defaultLocale, navSlugs) {
+  const issues = [];
+  const allSlugs = navSlugs.get(defaultLocale) ?? /* @__PURE__ */ new Set();
+  const defaultDir = path7.join(docsDir, defaultLocale);
+  if (!await fs6.pathExists(defaultDir)) return issues;
+  const files = await fs6.readdir(defaultDir);
+  for (const file of files) {
+    if (!file.endsWith(".md") && !file.endsWith(".mdx")) continue;
+    const slug = file.replace(/\.(mdx?)$/, "");
+    const filePath = path7.join(defaultDir, file);
+    const content = await fs6.readFile(filePath, "utf-8");
+    const fm = parseFrontmatter(content);
+    if (!fm || !Array.isArray(fm.related)) continue;
+    const invalid = fm.related.filter((r) => !allSlugs.has(r));
+    if (invalid.length > 0) {
+      issues.push({ filePath: path7.relative(path7.dirname(docsDir), filePath), slug, invalidRelated: invalid });
+    }
+  }
+  return issues;
+}
 async function check(dir, options) {
   const root = path7.resolve(process.cwd(), dir);
   const { config } = await loadProjectConfig(root, options.config);
   console.log();
   console.log(pc7.bold(pc7.cyan("  barodoc check")));
   console.log();
-  const docsDir = path7.join(root, "docs");
+  const docsDir = resolveDocsDir(root);
   const locales = config.i18n?.locales ?? ["en"];
   const defaultLocale = config.i18n?.defaultLocale ?? "en";
   const fileMap = await scanDocsFiles(docsDir);
@@ -904,6 +1008,7 @@ async function check(dir, options) {
       });
     }
   }
+  const relatedIssues = await checkRelatedLinks(docsDir, locales, defaultLocale, navSlugs);
   let hasIssues = false;
   if (result.missingFiles.length > 0) {
     hasIssues = true;
@@ -940,6 +1045,18 @@ async function check(dir, options) {
     }
     console.log();
   }
+  if (relatedIssues.length > 0) {
+    hasIssues = true;
+    console.log(pc7.bold(pc7.yellow(`  Invalid related links (${relatedIssues.length})`)));
+    console.log(pc7.dim("  Frontmatter 'related' references slugs not in navigation."));
+    console.log();
+    for (const item of relatedIssues) {
+      console.log(
+        `  ${pc7.yellow("\u26A0")} ${pc7.bold(item.slug)} ${pc7.dim(`\u2192 invalid: ${item.invalidRelated.join(", ")}`)}`
+      );
+    }
+    console.log();
+  }
   if (options.fix && (result.missingFiles.length > 0 || result.orphanFiles.length > 0)) {
     console.log(pc7.bold(pc7.cyan("  Fixing issues...")));
     console.log();
@@ -1008,6 +1125,326 @@ Add your content here.
   }
 }
 
+// src/commands/manifest.ts
+import path8 from "path";
+import pc8 from "picocolors";
+import fs7 from "fs-extra";
+import matter from "gray-matter";
+function extractHeadings(content) {
+  const headings = [];
+  const lines = content.split("\n");
+  let inCodeBlock = false;
+  for (const line of lines) {
+    if (line.startsWith("```")) {
+      inCodeBlock = !inCodeBlock;
+      continue;
+    }
+    if (inCodeBlock) continue;
+    const match = line.match(/^(#{1,6})\s+(.+)/);
+    if (match) {
+      headings.push({ depth: match[1].length, text: match[2].trim() });
+    }
+  }
+  return headings;
+}
+function extractCodeBlocksFull(content) {
+  const blocks = [];
+  const regex = /```(\w*)\n([\s\S]*?)```/g;
+  let m;
+  while ((m = regex.exec(content)) !== null) {
+    blocks.push({
+      lang: m[1] || "text",
+      code: m[2].trimEnd(),
+      lines: m[2].split("\n").length - (m[2].endsWith("\n") ? 1 : 0)
+    });
+  }
+  return blocks;
+}
+function extractSections(content) {
+  const sections = [];
+  const lines = content.split("\n");
+  let current = null;
+  let buffer = [];
+  let inCodeBlock = false;
+  function flush() {
+    if (current) {
+      current.content = buffer.join("\n").trim();
+      if (current.content) sections.push(current);
+    }
+  }
+  for (const line of lines) {
+    if (line.startsWith("```")) inCodeBlock = !inCodeBlock;
+    if (!inCodeBlock) {
+      const match = line.match(/^(#{2,3})\s+(.+)/);
+      if (match) {
+        flush();
+        current = { heading: match[2].trim(), depth: match[1].length, content: "" };
+        buffer = [];
+        continue;
+      }
+    }
+    if (current) {
+      buffer.push(line);
+    } else if (!sections.length) {
+      if (!current) {
+        current = { heading: "(intro)", depth: 0, content: "" };
+      }
+      buffer.push(line);
+    }
+  }
+  flush();
+  return sections;
+}
+function extractSummary(content, description) {
+  if (description) return description;
+  const stripped = content.replace(/^import\s+.*$/gm, "").replace(/<[^>]+>/g, "").replace(/```[\s\S]*?```/g, "").replace(/^#{1,6}\s+.*$/gm, "").trim();
+  const sentences = stripped.split(/(?<=[.!?])\s+/);
+  return sentences.slice(0, 2).join(" ").trim().slice(0, 300);
+}
+function extractComponentAPI(content, slug) {
+  const props = [];
+  const paramRegex = /<ParamField\s+([^>]*?)(?:\/>|>([\s\S]*?)<\/ParamField>)/g;
+  let m;
+  while ((m = paramRegex.exec(content)) !== null) {
+    const attrs = m[1];
+    const innerText = m[2]?.trim() || "";
+    const nameMatch = attrs.match(/name=["']([^"']+)["']/);
+    const typeMatch = attrs.match(/type=["']([^"']+)["']/);
+    const defaultMatch = attrs.match(/default=["']([^"']+)["']/);
+    const required = /\brequired\b/.test(attrs);
+    if (nameMatch) {
+      props.push({
+        name: nameMatch[1],
+        type: typeMatch?.[1] ?? "unknown",
+        required,
+        description: innerText.replace(/<[^>]+>/g, "").replace(/\s+/g, " ").trim(),
+        ...defaultMatch ? { default: defaultMatch[1] } : {}
+      });
+    }
+  }
+  if (props.length === 0) return void 0;
+  const name = slug.split("/").pop().split("-").map((w) => w.charAt(0).toUpperCase() + w.slice(1)).join("");
+  return { name, props };
+}
+function labelCodeExamples(content) {
+  const sections = extractSections(content);
+  const examples = [];
+  for (const section of sections) {
+    const regex = /```(\w*)\n([\s\S]*?)```/g;
+    let m;
+    while ((m = regex.exec(section.content)) !== null) {
+      examples.push({
+        lang: m[1] || "text",
+        code: m[2].trimEnd(),
+        section: section.heading
+      });
+    }
+  }
+  return examples;
+}
+function countWords(content) {
+  const stripped = content.replace(/```[\s\S]*?```/g, "").replace(/<[^>]+>/g, "").replace(/^---[\s\S]*?---/m, "").replace(/[#*_~`\[\]()>|]/g, "");
+  return stripped.split(/\s+/).filter((w) => w.length > 0).length;
+}
+function findCategory(slug, navigation) {
+  for (const group of navigation) {
+    if (group.pages.includes(slug)) return group.group;
+  }
+  return null;
+}
+function approxTokens(text) {
+  return Math.ceil(text.length / 4);
+}
+function slugToType(slug) {
+  if (slug.startsWith("components/")) return "component";
+  if (slug.startsWith("guides/")) return "guide";
+  return "page";
+}
+async function scanDir(dir) {
+  if (!await fs7.pathExists(dir)) return [];
+  const entries = await fs7.readdir(dir, { withFileTypes: true });
+  let results = [];
+  for (const entry of entries) {
+    const full = path8.join(dir, entry.name);
+    if (entry.isDirectory()) {
+      results = results.concat(await scanDir(full));
+    } else if (entry.name.endsWith(".md") || entry.name.endsWith(".mdx")) {
+      results.push(full);
+    }
+  }
+  return results;
+}
+function generateChunks(pages) {
+  const chunks = [];
+  for (const page of pages) {
+    if (!page.sections) continue;
+    for (const section of page.sections) {
+      const sectionId = section.heading.toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/^-|-$/g, "");
+      const id = `${page.locale}/${page.slug}#${sectionId}`;
+      const tokens = approxTokens(section.content);
+      if (tokens <= 500 || section.depth >= 3) {
+        chunks.push({
+          id,
+          page_slug: page.slug,
+          section: section.heading,
+          locale: page.locale,
+          content: section.content,
+          tokens_approx: tokens,
+          tags: page.tags,
+          difficulty: page.difficulty,
+          type: slugToType(page.slug)
+        });
+      } else {
+        const subSections = splitByH3(section.content, section.heading);
+        for (const sub of subSections) {
+          const subId = sub.heading.toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/^-|-$/g, "");
+          chunks.push({
+            id: `${page.locale}/${page.slug}#${subId}`,
+            page_slug: page.slug,
+            section: sub.heading,
+            locale: page.locale,
+            content: sub.content,
+            tokens_approx: approxTokens(sub.content),
+            tags: page.tags,
+            difficulty: page.difficulty,
+            type: slugToType(page.slug)
+          });
+        }
+      }
+    }
+  }
+  return chunks;
+}
+function splitByH3(content, parentHeading) {
+  const parts = [];
+  const lines = content.split("\n");
+  let current = { heading: parentHeading, content: "" };
+  let buffer = [];
+  let inCode = false;
+  function flush() {
+    current.content = buffer.join("\n").trim();
+    if (current.content) parts.push({ ...current });
+  }
+  for (const line of lines) {
+    if (line.startsWith("```")) inCode = !inCode;
+    if (!inCode) {
+      const match = line.match(/^###\s+(.+)/);
+      if (match) {
+        flush();
+        current = { heading: match[1].trim(), content: "" };
+        buffer = [];
+        continue;
+      }
+    }
+    buffer.push(line);
+  }
+  flush();
+  return parts;
+}
+async function manifest(dir, options) {
+  const root = path8.resolve(process.cwd(), dir);
+  const { config } = await loadProjectConfig(root, options.config);
+  const isLite = options.lite === true;
+  const emitChunks = options.chunks === true;
+  console.log();
+  console.log(pc8.bold(pc8.cyan("  barodoc manifest")));
+  if (isLite) console.log(pc8.dim("  (lite mode \u2014 metadata only)"));
+  console.log();
+  const customModeDir = path8.join(root, "src", "content", "docs");
+  const quickModeDir = path8.join(root, "docs");
+  const docsDir = fs7.existsSync(customModeDir) ? customModeDir : quickModeDir;
+  const locales = config.i18n?.locales ?? ["en"];
+  const defaultLocale = config.i18n?.defaultLocale ?? "en";
+  const navigation = config.navigation ?? [];
+  const pages = [];
+  for (const locale of locales) {
+    const localeDir = path8.join(docsDir, locale);
+    const files = await scanDir(localeDir);
+    for (const filePath of files) {
+      const raw = await fs7.readFile(filePath, "utf-8");
+      const { data: fm, content } = matter(raw);
+      const relPath = path8.relative(localeDir, filePath);
+      const slug = relPath.replace(/\.(mdx?)$/, "").replace(/\\/g, "/");
+      const title = fm.title || extractHeadings(content).find((h) => h.depth === 1)?.text || slug.split("/").pop().split("-").map((w) => w.charAt(0).toUpperCase() + w.slice(1)).join(" ");
+      const codeBlocksFull = extractCodeBlocksFull(content);
+      const page = {
+        slug,
+        title,
+        description: fm.description ?? "",
+        summary: extractSummary(content, fm.description ?? ""),
+        category: fm.category ?? findCategory(slug, navigation),
+        locale,
+        tags: Array.isArray(fm.tags) ? fm.tags : [],
+        related: Array.isArray(fm.related) ? fm.related : [],
+        difficulty: fm.difficulty ?? null,
+        api_reference: fm.api_reference === true,
+        headings: extractHeadings(content),
+        codeBlocks: codeBlocksFull.map((b) => ({ lang: b.lang, lines: b.lines })),
+        wordCount: countWords(raw),
+        filePath: `${locale}/${relPath}`
+      };
+      if (!isLite) {
+        page.sections = extractSections(content);
+        page.codeExamples = labelCodeExamples(content);
+        const api = extractComponentAPI(content, slug);
+        if (api) page.componentAPI = api;
+      }
+      pages.push(page);
+    }
+  }
+  const result = {
+    name: config.name ?? "Docs",
+    generatedAt: (/* @__PURE__ */ new Date()).toISOString(),
+    locales,
+    defaultLocale,
+    pages,
+    navigation: navigation.map((g) => ({ group: g.group, pages: g.pages }))
+  };
+  const outPath = options.output ? path8.resolve(root, options.output) : path8.join(root, "docs-manifest.json");
+  await fs7.writeJSON(outPath, result, { spaces: 2 });
+  console.log(pc8.green(`  \u2713 Generated ${path8.relative(root, outPath)}`));
+  console.log(pc8.dim(`    ${pages.length} pages across ${locales.length} locale(s)`));
+  if (emitChunks) {
+    const chunks = generateChunks(pages);
+    const chunksPath = outPath.replace(/\.json$/, "") + "-chunks.jsonl";
+    const jsonl = chunks.map((c) => JSON.stringify(c)).join("\n");
+    await fs7.writeFile(chunksPath, jsonl, "utf-8");
+    console.log(pc8.green(`  \u2713 Generated ${path8.relative(root, chunksPath)}`));
+    console.log(pc8.dim(`    ${chunks.length} chunks`));
+  }
+  console.log();
+}
+
+// src/commands/schema.ts
+import path9 from "path";
+import pc9 from "picocolors";
+import fs8 from "fs-extra";
+import { zodToJsonSchema } from "zod-to-json-schema";
+import { barodocConfigSchema, docsFrontmatterSchema } from "@barodoc/core";
+async function schema(dir, options) {
+  const root = path9.resolve(process.cwd(), dir);
+  const outDir = options.output ? path9.resolve(root, options.output) : root;
+  console.log();
+  console.log(pc9.bold(pc9.cyan("  barodoc schema")));
+  console.log();
+  await fs8.ensureDir(outDir);
+  const configSchema = zodToJsonSchema(barodocConfigSchema, {
+    name: "BarodocConfig",
+    $refStrategy: "none"
+  });
+  const fmSchema = zodToJsonSchema(docsFrontmatterSchema, {
+    name: "DocsFrontmatter",
+    $refStrategy: "none"
+  });
+  const configPath = path9.join(outDir, "config-schema.json");
+  const fmPath = path9.join(outDir, "frontmatter-schema.json");
+  await fs8.writeJSON(configPath, configSchema, { spaces: 2 });
+  await fs8.writeJSON(fmPath, fmSchema, { spaces: 2 });
+  console.log(pc9.green(`  \u2713 Generated ${path9.relative(root, configPath)}`));
+  console.log(pc9.green(`  \u2713 Generated ${path9.relative(root, fmPath)}`));
+  console.log();
+}
+
 // src/cli.ts
 var cli = cac("barodoc");
 cli.command("serve [dir]", "Start development server").option("-p, --port <port>", "Port to listen on", { default: 4321 }).option("-h, --host", "Expose to network").option("--open", "Open browser on start").option("--clean", "Force reinstall dependencies").option("-c, --config <file>", "Config file path").action(async (dir = ".", options) => {
@@ -1028,6 +1465,12 @@ cli.command("init [dir]", "Initialize Barodoc in an existing directory").option(
 cli.command("check [dir]", "Validate docs against navigation config").option("--fix", "Auto-fix missing files and orphan navigation entries").option("-c, --config <file>", "Config file path").action(async (dir = ".", options) => {
   await check(dir, options);
 });
+cli.command("manifest [dir]", "Generate docs-manifest.json for AI consumption").option("-o, --output <file>", "Output file path", { default: "docs-manifest.json" }).option("--lite", "Metadata only (no sections/content)").option("--chunks", "Also generate JSONL chunks for RAG").option("-c, --config <file>", "Config file path").action(async (dir = ".", options) => {
+  await manifest(dir, options);
+});
+cli.command("schema [dir]", "Export JSON Schema for config and frontmatter").option("-o, --output <dir>", "Output directory").action(async (dir = ".", options) => {
+  await schema(dir, options);
+});
 cli.command("eject [dir]", "Eject to a full Astro project").option("-c, --config <file>", "Config file path").action(async (dir = ".", options) => {
   await eject(dir, options);
 });
@@ -1036,8 +1479,8 @@ cli.version(version);
 cli.parse();
 if (!process.argv.slice(2).length) {
   console.log();
-  console.log(pc8.bold(pc8.cyan("  barodoc")));
-  console.log(pc8.dim("  Documentation framework powered by Astro"));
+  console.log(pc10.bold(pc10.cyan("  barodoc")));
+  console.log(pc10.dim("  Documentation framework powered by Astro"));
   console.log();
   cli.outputHelp();
 }

package/dist/index.js

@@ -1,7 +1,7 @@
 import {
   cleanupProject,
   createProject
-} from "./chunk-JIP64MDC.js";
+} from "./chunk-RK4USU7V.js";
 
 // src/index.ts
 export * from "@barodoc/core";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "barodoc",
-  "version": "2.0.0",
+  "version": "3.0.0",
   "description": "Documentation framework powered by Astro",
   "type": "module",
   "bin": {
@@ -24,8 +24,10 @@
     "fs-extra": "^11.2.0",
     "gray-matter": "^4.0.3",
     "picocolors": "^1.1.1",
-    "@barodoc/core": "2.0.0",
-    "@barodoc/theme-docs": "2.0.0"
+    "zod": "^3.24.0",
+    "zod-to-json-schema": "^3.25.1",
+    "@barodoc/core": "3.0.0",
+    "@barodoc/theme-docs": "3.0.0"
   },
   "devDependencies": {
     "@types/fs-extra": "^11.0.4",