barodoc 1.0.1 → 2.0.0

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

@@ -2,6 +2,7 @@
 import fs from "fs-extra";
 import path from "path";
 import pc from "picocolors";
+import { execa } from "execa";
 var BARODOC_DIR = ".barodoc";
 function isCustomProject(dir) {
   return fs.existsSync(path.join(dir, "astro.config.mjs")) || fs.existsSync(path.join(dir, "astro.config.ts")) || fs.existsSync(path.join(dir, "astro.config.js"));
@@ -37,14 +38,32 @@ async function createProject(options) {
   const { root, docsDir, config, configPath } = options;
   const projectDir = path.join(root, BARODOC_DIR);
   console.log(pc.dim(`Creating temporary project in ${BARODOC_DIR}/`));
-  await fs.remove(projectDir);
-  await fs.ensureDir(projectDir);
+  const nodeModulesDir = path.join(projectDir, "node_modules");
+  const hasNodeModules = fs.existsSync(nodeModulesDir);
+  if (hasNodeModules) {
+    const entries = await fs.readdir(projectDir);
+    for (const entry of entries) {
+      if (entry !== "node_modules") {
+        await fs.remove(path.join(projectDir, entry));
+      }
+    }
+  } else {
+    await fs.remove(projectDir);
+    await fs.ensureDir(projectDir);
+  }
   await fs.writeJSON(
     path.join(projectDir, "package.json"),
     {
       name: "barodoc-temp",
       type: "module",
-      private: true
+      private: true,
+      dependencies: {
+        astro: "^5.0.0",
+        "@barodoc/core": "^1.0.0",
+        "@barodoc/theme-docs": "^1.0.0",
+        react: "^19.0.0",
+        "react-dom": "^19.0.0"
+      }
     },
     { spaces: 2 }
   );
@@ -85,16 +104,45 @@ async function createProject(options) {
   }
   return projectDir;
 }
+async function installDependencies(projectDir, force = false) {
+  const nodeModulesDir = path.join(projectDir, "node_modules");
+  if (!force && fs.existsSync(nodeModulesDir)) {
+    console.log(pc.dim("Using cached dependencies..."));
+    console.log();
+    return;
+  }
+  if (force && fs.existsSync(nodeModulesDir)) {
+    console.log(pc.dim("Clearing cached dependencies..."));
+    await fs.remove(nodeModulesDir);
+  }
+  console.log(pc.dim("Installing dependencies..."));
+  await execa("npm", ["install", "--prefer-offline"], {
+    cwd: projectDir,
+    stdio: "inherit"
+  });
+  console.log(pc.green("\u2713 Dependencies installed"));
+  console.log();
+}
 async function cleanupProject(root) {
   const projectDir = path.join(root, BARODOC_DIR);
-  await fs.remove(projectDir);
+  if (!fs.existsSync(projectDir)) return;
+  const entries = await fs.readdir(projectDir);
+  for (const entry of entries) {
+    if (entry !== "node_modules") {
+      await fs.remove(path.join(projectDir, entry));
+    }
+  }
 }
 function generateAstroConfig(config, configPath, docsDir) {
+  const siteLine = config.site ? `
+  site: ${JSON.stringify(config.site)},` : "";
+  const baseLine = config.base ? `
+  base: ${JSON.stringify(config.base)},` : "";
   return `import { defineConfig } from "astro/config";
 import barodoc from "@barodoc/core";
 import docsTheme from "@barodoc/theme-docs";
 
-export default defineConfig({
+export default defineConfig({${siteLine}${baseLine}
   integrations: [
     barodoc({
       config: "./barodoc.config.json",
@@ -110,7 +158,7 @@ function generateContentConfig() {
 const docsCollection = defineCollection({
   type: "content",
   schema: z.object({
-    title: z.string(),
+    title: z.string().optional(),
     description: z.string().optional(),
   }),
 });
@@ -135,6 +183,7 @@ export {
   isCustomProject,
   loadProjectConfig,
   createProject,
+  installDependencies,
   cleanupProject,
   findDocsDir
 };

package/dist/cli.js

@@ -3,16 +3,17 @@ import {
   cleanupProject,
   createProject,
   findDocsDir,
+  installDependencies,
   isCustomProject,
   loadProjectConfig
-} from "./chunk-KI3NAGJ3.js";
+} from "./chunk-JIP64MDC.js";
 
 // src/cli.ts
 import cac from "cac";
-import pc5 from "picocolors";
+import pc8 from "picocolors";
 
 // package.json
-var version = "1.0.1";
+var version = "2.0.0";
 
 // src/commands/serve.ts
 import path from "path";
@@ -41,6 +42,7 @@ async function serve(dir, options) {
   });
   console.log(pc.green("\u2713 Project created"));
   console.log();
+  await installDependencies(projectDir, options.clean);
   await runAstroDev(projectDir, options);
 }
 async function runAstroDev(projectDir, options) {
@@ -51,6 +53,9 @@ async function runAstroDev(projectDir, options) {
   if (options.host) {
     args.push("--host");
   }
+  if (options.open) {
+    args.push("--open");
+  }
   try {
     await execa("npx", args, {
       cwd: projectDir,
@@ -95,6 +100,7 @@ async function build(dir, options) {
   });
   console.log(pc2.green("\u2713 Project created"));
   console.log();
+  await installDependencies(projectDir, options.clean);
   try {
     await runAstroBuild(projectDir, path2.join(projectDir, "dist"));
     const tempDist = path2.join(projectDir, "dist");
@@ -137,6 +143,235 @@ async function runAstroBuild(projectDir, outputDir) {
 import path3 from "path";
 import pc3 from "picocolors";
 import fs2 from "fs-extra";
+
+// src/runtime/agentRules.ts
+function generateAgentRules(projectName) {
+  return `# Barodoc Documentation Rules for AI Agents
+
+This file defines the rules for generating and editing documentation in this project.
+It is used by AI assistants (Claude, Cursor, GitHub Copilot, etc.) to produce
+markdown files that are fully compatible with barodoc.
+
+## Project: ${projectName}
+
+---
+
+## File Structure
+
+\`\`\`
+docs/
+  {locale}/          # e.g., en/, ko/, ja/
+    {slug}.md        # Markdown or MDX files
+    {slug}.mdx
+
+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.
+- Use \`.mdx\` when you need to include interactive components (Callout, Steps, etc.).
+- Use \`.md\` for plain text-only pages.
+
+---
+
+## Frontmatter
+
+Every page **should** include frontmatter at the top:
+
+\`\`\`md
+---
+title: Page Title
+description: A brief description shown in search results and meta tags.
+---
+\`\`\`
+
+- \`title\` \u2014 Optional. If omitted, the first \`#\` heading is used.
+- \`description\` \u2014 Recommended. Used for SEO and search result snippets.
+
+---
+
+## Navigation Registration
+
+After creating a new file, register it in \`barodoc.config.json\`:
+
+\`\`\`json
+{
+  "navigation": [
+    {
+      "group": "Getting Started",
+      "group:ko": "\uC2DC\uC791\uD558\uAE30",
+      "pages": ["introduction", "quickstart"]
+    },
+    {
+      "group": "Guides",
+      "pages": ["installation", "configuration", "deployment"]
+    }
+  ]
+}
+\`\`\`
+
+- \`pages\` contains **slugs only** (filename without extension, without locale prefix).
+- \`group:ko\`, \`group:ja\` etc. provide localized group names.
+- **Every created file must appear in \`navigation\`** or it won't be reachable.
+- Run \`barodoc check\` to detect orphaned files or missing nav entries.
+- Run \`barodoc check --fix\` to auto-repair navigation.
+
+---
+
+## MDX Components
+
+When using \`.mdx\` files, these components are available globally (no import needed):
+
+### Callout
+
+\`\`\`mdx
+<Callout type="info">This is an informational note.</Callout>
+
+<Callout type="warning" title="Watch out!">
+  This action cannot be undone.
+</Callout>
+
+<Callout type="tip">Use keyboard shortcuts to save time.</Callout>
+
+<Callout type="danger">This will permanently delete your data.</Callout>
+
+<Callout type="note">Additional context goes here.</Callout>
+\`\`\`
+
+Supported types: \`info\` | \`warning\` | \`tip\` | \`danger\` | \`note\`
+
+---
+
+### Steps
+
+Use for sequential step-by-step guides:
+
+\`\`\`mdx
+<Steps>
+  <Step title="Install dependencies">
+    \`\`\`bash
+    npm install
+    \`\`\`
+  </Step>
+  <Step title="Configure environment">
+    Copy \`.env.example\` to \`.env\` and fill in the values.
+  </Step>
+  <Step title="Run the server">
+    \`\`\`bash
+    npm run dev
+    \`\`\`
+  </Step>
+</Steps>
+\`\`\`
+
+---
+
+### Card and CardGroup
+
+Use to display a grid of linked cards:
+
+\`\`\`mdx
+<CardGroup cols={2}>
+  <Card title="Quickstart" href="/quickstart">
+    Get up and running in minutes.
+  </Card>
+  <Card title="API Reference" href="/api-reference">
+    Explore the full API documentation.
+  </Card>
+</CardGroup>
+\`\`\`
+
+- \`cols\` accepts \`1\`, \`2\`, or \`3\`.
+- \`href\` is optional \u2014 cards can be informational without a link.
+
+---
+
+### CodeGroup
+
+Display multiple code examples with tabs:
+
+\`\`\`mdx
+<CodeGroup>
+\`\`\`bash npm
+npm install @barodoc/core
+\`\`\`
+
+\`\`\`bash pnpm
+pnpm add @barodoc/core
+\`\`\`
+
+\`\`\`bash yarn
+yarn add @barodoc/core
+\`\`\`
+</CodeGroup>
+\`\`\`
+
+The text after the language name becomes the tab label.
+
+---
+
+## i18n (Internationalization)
+
+If the project has multiple locales:
+
+- Create parallel files: \`docs/en/page.md\` and \`docs/ko/page.md\`.
+- Slugs must match across locales.
+- Navigation uses the same slug for all locales \u2014 only group names can be localized.
+
+\`\`\`json
+{
+  "i18n": {
+    "defaultLocale": "en",
+    "locales": ["en", "ko"],
+    "labels": { "en": "English", "ko": "\uD55C\uAD6D\uC5B4" }
+  }
+}
+\`\`\`
+
+---
+
+## Workflow for Adding a New Page
+
+1. Create \`docs/{locale}/{slug}.md\` (or \`.mdx\` for components).
+2. Add frontmatter with \`title\` and \`description\`.
+3. Write content using standard markdown + MDX components if needed.
+4. Register the slug in \`barodoc.config.json\` under the appropriate navigation group.
+5. Run \`barodoc check\` to verify everything is correct.
+6. Run \`barodoc serve\` to preview in the browser.
+
+---
+
+## Content Guidelines
+
+- 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.
+- 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\`.
+
+---
+
+## Validation
+
+\`\`\`bash
+# Check for issues (missing files, orphan pages, frontmatter)
+barodoc check
+
+# Auto-fix navigation mismatches
+barodoc check --fix
+
+# Start dev server
+barodoc serve
+
+# Production build
+barodoc build
+\`\`\`
+`;
+}
+
+// src/commands/create.ts
 async function create(name) {
   const targetDir = path3.resolve(process.cwd(), name);
   console.log();
@@ -222,6 +457,10 @@ barodoc preview
 </svg>
 `
   );
+  await fs2.writeFile(
+    path3.join(targetDir, "CLAUDE.md"),
+    generateAgentRules(name)
+  );
   await fs2.writeFile(
     path3.join(targetDir, ".gitignore"),
     `.barodoc/
@@ -279,12 +518,502 @@ async function preview(dir, options) {
   }
 }
 
+// src/commands/init.ts
+import path5 from "path";
+import pc5 from "picocolors";
+import fs4 from "fs-extra";
+async function init(dir) {
+  const root = path5.resolve(process.cwd(), dir);
+  console.log();
+  console.log(pc5.bold(pc5.cyan("  barodoc init")));
+  console.log();
+  const configPath = path5.join(root, "barodoc.config.json");
+  if (await fs4.pathExists(configPath)) {
+    console.log(pc5.yellow("\u26A0 barodoc.config.json already exists."));
+    console.log(pc5.dim("  Run barodoc serve to start the development server."));
+    console.log();
+    return;
+  }
+  const hasAstroConfig = await fs4.pathExists(path5.join(root, "astro.config.mjs")) || await fs4.pathExists(path5.join(root, "astro.config.ts")) || await fs4.pathExists(path5.join(root, "astro.config.js"));
+  if (hasAstroConfig) {
+    console.log(pc5.yellow("\u26A0 Detected existing Astro config."));
+    console.log(
+      pc5.dim(
+        "  This looks like a full Astro project. barodoc init is for quick mode only."
+      )
+    );
+    console.log();
+    return;
+  }
+  const projectName = path5.basename(root);
+  console.log(pc5.dim(`Initializing barodoc in ${dir === "." ? "current directory" : dir}/`));
+  const docsDir = path5.join(root, "docs", "en");
+  const docsExists = await fs4.pathExists(docsDir);
+  if (!docsExists) {
+    await fs4.ensureDir(docsDir);
+    await fs4.writeFile(
+      path5.join(docsDir, "introduction.md"),
+      `# Introduction
+
+Welcome to your documentation site!
+
+## Getting Started
+
+Edit this file at \`docs/en/introduction.md\` to customize your documentation.
+
+## Features
+
+- Write documentation in Markdown
+- Dark mode support
+- Full-text search
+- i18n support
+`
+    );
+    await fs4.writeFile(
+      path5.join(docsDir, "quickstart.md"),
+      `# Quick Start
+
+## Development
+
+\`\`\`bash
+barodoc serve
+\`\`\`
+
+## Build
+
+\`\`\`bash
+barodoc build
+\`\`\`
+
+## Preview
+
+\`\`\`bash
+barodoc preview
+\`\`\`
+`
+    );
+    console.log(pc5.green("\u2713 Created docs/en/introduction.md"));
+    console.log(pc5.green("\u2713 Created docs/en/quickstart.md"));
+  } else {
+    console.log(pc5.dim("  docs/ directory already exists, skipping sample docs"));
+  }
+  await fs4.writeJSON(
+    configPath,
+    {
+      name: projectName,
+      navigation: [
+        {
+          group: "Getting Started",
+          pages: ["introduction", "quickstart"]
+        }
+      ],
+      i18n: {
+        defaultLocale: "en",
+        locales: ["en"]
+      },
+      search: {
+        enabled: true
+      }
+    },
+    { spaces: 2 }
+  );
+  console.log(pc5.green("\u2713 Created barodoc.config.json"));
+  const publicDir = path5.join(root, "public");
+  if (!await fs4.pathExists(publicDir)) {
+    await fs4.ensureDir(publicDir);
+    console.log(pc5.green("\u2713 Created public/"));
+  }
+  const claudeMdPath = path5.join(root, "CLAUDE.md");
+  if (!await fs4.pathExists(claudeMdPath)) {
+    await fs4.writeFile(claudeMdPath, generateAgentRules(projectName));
+    console.log(pc5.green("\u2713 Created CLAUDE.md (AI agent documentation rules)"));
+  }
+  const gitignorePath = path5.join(root, ".gitignore");
+  const gitignoreEntries = [".barodoc/", "dist/", "node_modules/", ".DS_Store"];
+  if (await fs4.pathExists(gitignorePath)) {
+    const existing = await fs4.readFile(gitignorePath, "utf-8");
+    const toAdd = gitignoreEntries.filter((e) => !existing.includes(e));
+    if (toAdd.length > 0) {
+      await fs4.appendFile(gitignorePath, "\n" + toAdd.join("\n") + "\n");
+      console.log(pc5.green("\u2713 Updated .gitignore"));
+    }
+  } else {
+    await fs4.writeFile(gitignorePath, gitignoreEntries.join("\n") + "\n");
+    console.log(pc5.green("\u2713 Created .gitignore"));
+  }
+  console.log();
+  console.log(pc5.bold("Done! Your project is ready."));
+  console.log();
+  console.log("Next steps:");
+  console.log();
+  if (dir !== ".") {
+    console.log(`  ${pc5.cyan(`cd ${dir}`)}`);
+  }
+  console.log(`  ${pc5.cyan("barodoc serve")}`);
+  console.log();
+}
+
+// src/commands/eject.ts
+import path6 from "path";
+import pc6 from "picocolors";
+import fs5 from "fs-extra";
+var BARODOC_DIR = ".barodoc";
+async function eject(dir, options) {
+  const root = path6.resolve(process.cwd(), dir);
+  console.log();
+  console.log(pc6.bold(pc6.cyan("  barodoc eject")));
+  console.log();
+  if (isCustomProject(root)) {
+    console.log(pc6.yellow("\u26A0 This is already a full Astro project."));
+    console.log(pc6.dim("  Nothing to eject."));
+    console.log();
+    return;
+  }
+  console.log(
+    pc6.dim("Ejecting to a full Astro project in the current directory...")
+  );
+  console.log();
+  console.log(
+    pc6.yellow(
+      "This will create astro.config.mjs, tsconfig.json, and package.json"
+    )
+  );
+  console.log(
+    pc6.yellow("in the current directory. You can then run astro commands directly.")
+  );
+  console.log();
+  const conflictFiles = ["astro.config.mjs", "tsconfig.json"];
+  const conflicts = [];
+  for (const file of conflictFiles) {
+    if (await fs5.pathExists(path6.join(root, file))) {
+      conflicts.push(file);
+    }
+  }
+  if (conflicts.length > 0) {
+    console.log(pc6.red("Error: The following files already exist and would be overwritten:"));
+    for (const f of conflicts) {
+      console.log(`  ${pc6.dim(f)}`);
+    }
+    console.log();
+    console.log(pc6.dim("Remove them first, then run barodoc eject again."));
+    console.log();
+    process.exit(1);
+  }
+  const docsDir = findDocsDir(root);
+  const { config } = await loadProjectConfig(root, options.config);
+  const projectDir = await createProject({
+    root,
+    docsDir,
+    config,
+    configPath: options.config
+  });
+  console.log(pc6.green("\u2713 Generated project files"));
+  await installDependencies(projectDir);
+  const astroConfigSrc = path6.join(projectDir, "astro.config.mjs");
+  let astroConfigContent = await fs5.readFile(astroConfigSrc, "utf-8");
+  await fs5.writeFile(path6.join(root, "astro.config.mjs"), astroConfigContent);
+  console.log(pc6.green("\u2713 Created astro.config.mjs"));
+  await fs5.copy(
+    path6.join(projectDir, "tsconfig.json"),
+    path6.join(root, "tsconfig.json")
+  );
+  console.log(pc6.green("\u2713 Created tsconfig.json"));
+  const tempPkg = await fs5.readJSON(path6.join(projectDir, "package.json"));
+  const rootPkgPath = path6.join(root, "package.json");
+  if (await fs5.pathExists(rootPkgPath)) {
+    const existingPkg = await fs5.readJSON(rootPkgPath);
+    const merged = {
+      ...existingPkg,
+      type: "module",
+      dependencies: {
+        ...existingPkg.dependencies ?? {},
+        ...tempPkg.dependencies
+      }
+    };
+    await fs5.writeJSON(rootPkgPath, merged, { spaces: 2 });
+    console.log(pc6.green("\u2713 Updated package.json (merged dependencies)"));
+  } else {
+    const newPkg = {
+      name: path6.basename(root),
+      type: "module",
+      private: true,
+      scripts: {
+        dev: "astro dev",
+        build: "astro build",
+        preview: "astro preview"
+      },
+      dependencies: tempPkg.dependencies
+    };
+    await fs5.writeJSON(rootPkgPath, newPkg, { spaces: 2 });
+    console.log(pc6.green("\u2713 Created package.json"));
+  }
+  const contentConfigSrc = path6.join(projectDir, "src", "content", "config.ts");
+  const contentConfigDst = path6.join(root, "src", "content", "config.ts");
+  if (!await fs5.pathExists(contentConfigDst)) {
+    await fs5.ensureDir(path6.dirname(contentConfigDst));
+    await fs5.copy(contentConfigSrc, contentConfigDst);
+    console.log(pc6.green("\u2713 Created src/content/config.ts"));
+  }
+  const srcNodeModules = path6.join(projectDir, "node_modules");
+  const dstNodeModules = path6.join(root, "node_modules");
+  if (await fs5.pathExists(srcNodeModules)) {
+    if (!await fs5.pathExists(dstNodeModules)) {
+      console.log(pc6.dim("Moving node_modules to project root..."));
+      await fs5.move(srcNodeModules, dstNodeModules);
+      console.log(pc6.green("\u2713 Moved node_modules"));
+    } else {
+      console.log(pc6.dim("node_modules already exists in root, skipping move"));
+    }
+  }
+  await fs5.remove(path6.join(root, BARODOC_DIR));
+  console.log(pc6.green("\u2713 Removed .barodoc/ directory"));
+  const gitignorePath = path6.join(root, ".gitignore");
+  if (await fs5.pathExists(gitignorePath)) {
+    const content = await fs5.readFile(gitignorePath, "utf-8");
+    const updated = content.split("\n").filter((line) => line.trim() !== ".barodoc/").join("\n");
+    await fs5.writeFile(gitignorePath, updated);
+    console.log(pc6.green("\u2713 Updated .gitignore (removed .barodoc/ entry)"));
+  }
+  console.log();
+  console.log(pc6.bold(pc6.green("Eject complete!")));
+  console.log();
+  console.log("You now have a full Astro project. You can run:");
+  console.log();
+  console.log(`  ${pc6.cyan("npx astro dev")}     ${pc6.dim("# development server")}`);
+  console.log(`  ${pc6.cyan("npx astro build")}   ${pc6.dim("# production build")}`);
+  console.log(`  ${pc6.cyan("npx astro preview")} ${pc6.dim("# preview build")}`);
+  console.log();
+  console.log(pc6.dim("You can also install astro globally or add it as a dev dependency."));
+  console.log();
+}
+
+// src/commands/check.ts
+import path7 from "path";
+import pc7 from "picocolors";
+import fs6 from "fs-extra";
+async function scanDocsFiles(docsDir) {
+  const result = /* @__PURE__ */ new Map();
+  if (!await fs6.pathExists(docsDir)) {
+    return result;
+  }
+  const locales = await fs6.readdir(docsDir);
+  for (const locale of locales) {
+    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?)$/, ""));
+      }
+    }
+    result.set(locale, slugs);
+  }
+  return result;
+}
+function getNavSlugs(config) {
+  const locales = config.i18n?.locales ?? ["en"];
+  const result = /* @__PURE__ */ new Map();
+  for (const locale of locales) {
+    result.set(locale, /* @__PURE__ */ new Set());
+  }
+  for (const group of config.navigation ?? []) {
+    for (const page of group.pages ?? []) {
+      for (const locale of locales) {
+        result.get(locale).add(page);
+      }
+    }
+  }
+  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");
+  }
+  return missing;
+}
+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 locales = config.i18n?.locales ?? ["en"];
+  const defaultLocale = config.i18n?.defaultLocale ?? "en";
+  const fileMap = await scanDocsFiles(docsDir);
+  const navSlugs = getNavSlugs(config);
+  const result = {
+    missingFiles: [],
+    orphanFiles: [],
+    missingFrontmatter: []
+  };
+  for (const locale of locales) {
+    const slugsInNav = navSlugs.get(locale) ?? /* @__PURE__ */ new Set();
+    const filesOnDisk = new Set(fileMap.get(locale) ?? []);
+    for (const slug of slugsInNav) {
+      if (!filesOnDisk.has(slug)) {
+        let groupIndex = 0;
+        let pageIndex = 0;
+        const nav = config.navigation ?? [];
+        for (let gi = 0; gi < nav.length; gi++) {
+          const pages = nav[gi].pages ?? [];
+          const pi = pages.indexOf(slug);
+          if (pi !== -1) {
+            groupIndex = gi;
+            pageIndex = pi;
+            break;
+          }
+        }
+        result.missingFiles.push({ slug, locale, groupIndex, pageIndex });
+      }
+    }
+  }
+  for (const locale of locales) {
+    const slugsInNav = navSlugs.get(locale) ?? /* @__PURE__ */ new Set();
+    const filesOnDisk = fileMap.get(locale) ?? [];
+    for (const slug of filesOnDisk) {
+      if (!slugsInNav.has(slug)) {
+        const ext = await fs6.pathExists(path7.join(docsDir, locale, `${slug}.mdx`)) ? ".mdx" : ".md";
+        result.orphanFiles.push({
+          slug,
+          locale,
+          filePath: path7.join(docsDir, locale, `${slug}${ext}`)
+        });
+      }
+    }
+  }
+  const defaultFiles = fileMap.get(defaultLocale) ?? [];
+  for (const slug of defaultFiles) {
+    const ext = await fs6.pathExists(path7.join(docsDir, defaultLocale, `${slug}.mdx`)) ? ".mdx" : ".md";
+    const filePath = path7.join(docsDir, defaultLocale, `${slug}${ext}`);
+    const missing = await checkFrontmatter(filePath);
+    if (missing.length > 0) {
+      result.missingFrontmatter.push({
+        filePath: path7.relative(root, filePath),
+        fields: missing
+      });
+    }
+  }
+  let hasIssues = false;
+  if (result.missingFiles.length > 0) {
+    hasIssues = true;
+    console.log(pc7.bold(pc7.red(`  Missing files (${result.missingFiles.length})`)));
+    console.log(pc7.dim("  Navigation references files that don't exist on disk."));
+    console.log();
+    for (const item of result.missingFiles) {
+      const ext = ".md";
+      const relPath = `docs/${item.locale}/${item.slug}${ext}`;
+      console.log(`  ${pc7.red("\u2717")} ${pc7.bold(item.slug)} ${pc7.dim(`\u2192 ${relPath}`)}`);
+    }
+    console.log();
+  }
+  if (result.orphanFiles.length > 0) {
+    hasIssues = true;
+    console.log(pc7.bold(pc7.yellow(`  Orphan files (${result.orphanFiles.length})`)));
+    console.log(pc7.dim("  Files exist on disk but are not referenced in navigation."));
+    console.log();
+    for (const item of result.orphanFiles) {
+      const relPath = `docs/${item.locale}/${item.slug}`;
+      console.log(
+        `  ${pc7.yellow("\u26A0")} ${pc7.bold(item.slug)} ${pc7.dim(`\u2192 ${relPath}`)}`
+      );
+    }
+    console.log();
+  }
+  if (result.missingFrontmatter.length > 0) {
+    console.log(pc7.bold(pc7.dim(`  Missing frontmatter fields (${result.missingFrontmatter.length})`)));
+    console.log();
+    for (const item of result.missingFrontmatter) {
+      console.log(
+        `  ${pc7.dim("\u25CB")} ${item.filePath} ${pc7.dim(`\u2014 missing: ${item.fields.join(", ")}`)}`
+      );
+    }
+    console.log();
+  }
+  if (options.fix && (result.missingFiles.length > 0 || result.orphanFiles.length > 0)) {
+    console.log(pc7.bold(pc7.cyan("  Fixing issues...")));
+    console.log();
+    if (result.orphanFiles.length > 0) {
+      const configPath = options.config ? path7.resolve(root, options.config) : path7.join(root, "barodoc.config.json");
+      if (await fs6.pathExists(configPath)) {
+        const configJson = await fs6.readJSON(configPath);
+        const nav = configJson.navigation ?? [];
+        const defaultLocaleOrphans = result.orphanFiles.filter(
+          (o) => o.locale === defaultLocale
+        );
+        if (defaultLocaleOrphans.length > 0) {
+          if (nav.length === 0) {
+            nav.push({ group: "Documentation", pages: [] });
+          }
+          for (const orphan of defaultLocaleOrphans) {
+            const lastGroup = nav[nav.length - 1];
+            if (!lastGroup.pages.includes(orphan.slug)) {
+              lastGroup.pages.push(orphan.slug);
+              console.log(
+                `  ${pc7.green("\u2713")} Added ${pc7.bold(orphan.slug)} to navigation group "${lastGroup.group}"`
+              );
+            }
+          }
+          await fs6.writeJSON(configPath, configJson, { spaces: 2 });
+          console.log(pc7.green("  \u2713 Updated barodoc.config.json"));
+        }
+      } else {
+        console.log(pc7.yellow("  \u26A0 Could not find barodoc.config.json to update navigation."));
+      }
+    }
+    if (result.missingFiles.length > 0) {
+      for (const item of result.missingFiles) {
+        const fileDir = path7.join(docsDir, item.locale);
+        await fs6.ensureDir(fileDir);
+        const filePath = path7.join(fileDir, `${item.slug}.md`);
+        const title = item.slug.replace(/-/g, " ").replace(/\b\w/g, (c) => c.toUpperCase());
+        await fs6.writeFile(
+          filePath,
+          `---
+description: ${title}
+---
+
+# ${title}
+
+Add your content here.
+`
+        );
+        console.log(`  ${pc7.green("\u2713")} Created docs/${item.locale}/${item.slug}.md`);
+      }
+    }
+    console.log();
+    console.log(pc7.bold("  Done! Run barodoc check again to verify."));
+    console.log();
+    return;
+  }
+  if (!hasIssues) {
+    console.log(pc7.green("  \u2713 All good! No issues found."));
+    console.log();
+  } else {
+    console.log(
+      pc7.dim(`  Run ${pc7.cyan("barodoc check --fix")} to automatically fix missing/orphan files.`)
+    );
+    console.log();
+    process.exit(1);
+  }
+}
+
 // 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("-c, --config <file>", "Config file path").action(async (dir = ".", options) => {
+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) => {
   await serve(dir, options);
 });
-cli.command("build [dir]", "Build for production").option("-o, --output <dir>", "Output directory", { default: "dist" }).option("-c, --config <file>", "Config file path").action(async (dir = ".", options) => {
+cli.command("build [dir]", "Build for production").option("-o, --output <dir>", "Output directory", { default: "dist" }).option("--clean", "Force reinstall dependencies").option("-c, --config <file>", "Config file path").action(async (dir = ".", options) => {
   await build(dir, options);
 });
 cli.command("preview [dir]", "Preview production build").option("-p, --port <port>", "Port to listen on", { default: 4321 }).option("-o, --output <dir>", "Build output directory", { default: "dist" }).action(async (dir = ".", options) => {
@@ -293,13 +1022,22 @@ cli.command("preview [dir]", "Preview production build").option("-p, --port <por
 cli.command("create <name>", "Create a new Barodoc project").action(async (name) => {
   await create(name);
 });
+cli.command("init [dir]", "Initialize Barodoc in an existing directory").option("-c, --config <file>", "Config file path").action(async (dir = ".", options) => {
+  await init(dir);
+});
+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("eject [dir]", "Eject to a full Astro project").option("-c, --config <file>", "Config file path").action(async (dir = ".", options) => {
+  await eject(dir, options);
+});
 cli.help();
 cli.version(version);
 cli.parse();
 if (!process.argv.slice(2).length) {
   console.log();
-  console.log(pc5.bold(pc5.cyan("  barodoc")));
-  console.log(pc5.dim("  Documentation framework powered by Astro"));
+  console.log(pc8.bold(pc8.cyan("  barodoc")));
+  console.log(pc8.dim("  Documentation framework powered by Astro"));
   console.log();
   cli.outputHelp();
 }

package/dist/index.d.ts

@@ -12,7 +12,7 @@ interface ProjectOptions {
  */
 declare function createProject(options: ProjectOptions): Promise<string>;
 /**
- * Clean up temporary project
+ * Clean up temporary project files but preserve node_modules cache
  */
 declare function cleanupProject(root: string): Promise<void>;
 

package/dist/index.js

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

package/package.json

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