@goobits/docs-engine-cli 2.0.0

package/README.md

@@ -0,0 +1,324 @@
+# @goobits/docs-engine-cli
+
+Command-line tools for managing and validating documentation built with @goobits/docs-engine.
+
+## Features
+
+- ✅ **Link validation** - Check internal and external links
+- 🔍 **Anchor checking** - Validate anchor links (#section)
+- 📁 **File existence** - Ensure linked files exist
+- 🌐 **External validation** - HTTP requests to validate external URLs
+- 📦 **Version management** - Manage multiple documentation versions
+- ⚡ **Performance** - Concurrent checking with configurable limits
+- 🎨 **Beautiful output** - Color-coded results with chalk
+- ⚙️ **Configurable** - Support for config files
+- 🔄 **CI-friendly** - JSON output and non-zero exit codes
+
+## Installation
+
+```bash
+pnpm add -D @goobits/docs-engine-cli
+# or
+npm install --save-dev @goobits/docs-engine-cli
+```
+
+## Commands
+
+### Link Checker
+
+Check all links in your markdown documentation for broken internal references and optionally validate external URLs.
+
+```bash
+# Basic usage - check internal links
+docs-engine check-links
+
+# Check with external link validation
+docs-engine check-links --external
+
+# Custom base directory
+docs-engine check-links --base-dir ./documentation
+
+# Quiet mode (only show errors)
+docs-engine check-links --quiet
+
+# JSON output for CI integration
+docs-engine check-links --json
+```
+
+**Options:**
+
+- `-b, --base-dir <path>` - Base directory for documentation (default: current directory)
+- `-p, --pattern <glob>` - Glob pattern for files to check (default: `**/*.{md,mdx}`)
+- `-e, --external` - Validate external links (slower, default: `false`)
+- `-t, --timeout <ms>` - External link timeout in milliseconds (default: `5000`)
+- `-c, --concurrency <number>` - Max concurrent external requests (default: `10`)
+- `-q, --quiet` - Only show errors, hide valid links
+- `--json` - Output results as JSON
+- `--config <path>` - Path to config file
+
+**Exit Codes:**
+- `0` - All links valid
+- `1` - Broken links found or error occurred
+
+### Version Management
+
+Manage multiple versions of your documentation (similar to Docusaurus versioning).
+
+#### Create Version
+
+Create a new documentation version from current docs:
+
+```bash
+# Create version 2.0
+docs-engine version create 2.0
+
+# Create with custom docs directory
+docs-engine version create 2.0 --docs-dir ./documentation
+```
+
+This will:
+1. Copy current docs to `docs/versioned_docs/version-2.0/`
+2. Update `docs/versions.json` with the new version
+3. Mark the new version as "latest"
+
+#### List Versions
+
+List all available documentation versions:
+
+```bash
+docs-engine version list
+
+# Output:
+#   2.0 [latest]
+#   1.5 [stable]
+#   1.0 [legacy]
+```
+
+#### Delete Version
+
+Delete a documentation version:
+
+```bash
+docs-engine version delete 1.0
+
+# Skip confirmation
+docs-engine version delete 1.0 --force
+```
+
+## Configuration
+
+### Config File
+
+Create `.docs-engine.json` in your project root:
+
+```json
+{
+  "baseDir": ".",
+  "pattern": "docs/**/*.{md,mdx}",
+  "checkExternal": false,
+  "timeout": 5000,
+  "concurrency": 10,
+  "exclude": [
+    "**/node_modules/**",
+    "**/dist/**",
+    "**/.git/**"
+  ],
+  "skipDomains": [
+    "localhost",
+    "127.0.0.1",
+    "example.com"
+  ],
+  "validExtensions": [".md", ".mdx"]
+}
+```
+
+**Configuration Options:**
+
+- **`baseDir`** (string): Base directory for documentation
+- **`pattern`** (string): Glob pattern for files to check
+- **`checkExternal`** (boolean): Whether to validate external links
+- **`exclude`** (string[]): Patterns to exclude from checking
+- **`timeout`** (number): Timeout for external requests in milliseconds
+- **`concurrency`** (number): Maximum concurrent external requests
+- **`skipDomains`** (string[]): Domains to skip validation
+- **`validExtensions`** (string[]): File extensions to treat as valid
+
+## CI Integration
+
+### GitHub Actions
+
+```yaml
+name: Check Links
+
+on: [push, pull_request]
+
+jobs:
+  link-check:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v3
+      - uses: pnpm/action-setup@v2
+      - uses: actions/setup-node@v3
+        with:
+          node-version: 20
+          cache: 'pnpm'
+
+      - run: pnpm install
+      - run: pnpm docs-engine check-links
+
+      # Optional: Check external links on schedule
+      - name: Check external links
+        if: github.event_name == 'schedule'
+        run: pnpm docs-engine check-links --external
+```
+
+### Pre-commit Hook
+
+```bash
+#!/bin/sh
+docs-engine check-links --quiet || exit 1
+```
+
+## Versioning Workflow
+
+### 1. Initial Setup
+
+Start with your documentation in `docs/`:
+
+```
+docs/
+  getting-started.md
+  api-reference.md
+  guides/
+    ...
+```
+
+### 2. Create First Version
+
+When releasing v1.0:
+
+```bash
+docs-engine version create 1.0
+```
+
+This creates:
+
+```
+docs/
+  current/              # Development version
+  versioned_docs/
+    version-1.0/        # v1.0 release
+  versions.json         # Version metadata
+```
+
+### 3. Continue Development
+
+Keep editing files in `docs/current/` for the next release.
+
+### 4. Release Next Version
+
+When releasing v2.0:
+
+```bash
+docs-engine version create 2.0
+```
+
+Users can now view:
+- `/docs/` - Latest (v2.0)
+- `/docs/v2.0/` - v2.0 documentation
+- `/docs/v1.0/` - v1.0 documentation
+
+## Link Validation Details
+
+### Internal Links
+
+The link checker validates:
+
+- **Relative links**: `./page.md`, `../other.md`
+- **Absolute links**: `/docs/page.md`
+- **Anchor links**: `#section`, `page.md#section`
+- **Markdown links**: `[text](url)`
+- **HTML links**: `<a href="url">`
+- **Image links**: `![alt](image.png)`
+
+### External Links
+
+When `--external` is enabled:
+
+- ✅ HTTP/HTTPS URLs validated with HEAD/GET requests
+- ✅ Follow redirects (up to 5 hops)
+- ✅ Configurable timeout and concurrency
+- ✅ Result caching to avoid duplicate requests
+- ✅ Domain skipping for local/test URLs
+- ✅ Rate limiting to avoid overwhelming servers
+
+### Error Types
+
+- **File not found** - Internal link points to non-existent file
+- **Anchor not found** - Section anchor doesn't exist in target file
+- **External error** - HTTP error (404, 500, etc.)
+- **Timeout** - External URL didn't respond in time
+- **Network error** - Connection refused or DNS failure
+
+## Output Examples
+
+### Success Output
+
+```
+✔ Link checker initialized
+
+📊 Checked 127 links across 45 files
+
+✓ Valid: 125
+⚠ Warnings: 2
+
+All critical links are valid!
+```
+
+### Error Output
+
+```
+✖ Link checker found errors
+
+📊 Checked 127 links across 45 files
+
+✓ Valid: 123
+✗ Broken: 4
+
+Broken Links:
+
+src/content/docs/api.md:45
+  → /docs/missing-page.md
+  ✗ File not found
+
+src/content/docs/guide.md:12
+  → ./tutorial.md#non-existent
+  ✗ Anchor #non-existent not found
+
+src/content/docs/external.md:8
+  → https://example.com/broken
+  ✗ 404 Not Found
+```
+
+## Development
+
+```bash
+# Install dependencies
+pnpm install
+
+# Build the CLI
+pnpm build
+
+# Test locally
+node dist/index.js check-links
+
+# Watch mode during development
+pnpm dev
+
+# Test the CLI
+docs-engine check-links
+```
+
+## License
+
+MIT © GooBits

package/dist/index.d.ts

@@ -0,0 +1 @@
+#!/usr/bin/env node

package/dist/index.js

@@ -0,0 +1,796 @@
+#!/usr/bin/env node
+
+// src/index.ts
+import { Command } from "commander";
+import { glob } from "glob";
+import ora from "ora";
+import chalk2 from "chalk";
+import path3 from "path";
+import { readFileSync as readFileSync4 } from "fs";
+import { fileURLToPath } from "url";
+import { dirname as dirname2, join as join2 } from "path";
+
+// src/link-extractor.ts
+import { unified } from "unified";
+import remarkParse from "remark-parse";
+import remarkMdx from "remark-mdx";
+import { visit } from "unist-util-visit";
+import { readFileSync } from "fs";
+function isExternalUrl(url) {
+  return /^https?:\/\//i.test(url);
+}
+function isAnchorOnly(url) {
+  return url.startsWith("#");
+}
+function extractLinksFromFile(filePath) {
+  const content = readFileSync(filePath, "utf-8");
+  const links = [];
+  const tree = unified().use(remarkParse).use(remarkMdx).parse(content);
+  visit(tree, ["link", "image"], (node, _index, _parent) => {
+    const url = node.url;
+    if (!url) return;
+    const position = node.position;
+    const line = position?.start.line || 0;
+    let text = "";
+    if (node.type === "link") {
+      const linkNode = node;
+      if (linkNode.children && linkNode.children.length > 0) {
+        const firstChild = linkNode.children[0];
+        if ("value" in firstChild) {
+          text = firstChild.value;
+        }
+      }
+    } else if (node.type === "image") {
+      const imageNode = node;
+      text = imageNode.alt || "";
+    }
+    links.push({
+      url,
+      text,
+      file: filePath,
+      line,
+      type: node.type === "image" ? "image" : "link",
+      isExternal: isExternalUrl(url),
+      isAnchor: isAnchorOnly(url)
+    });
+  });
+  const htmlLinkRegex = /<a\s+(?:[^>]*?\s+)?href=["']([^"']+)["']/gi;
+  const lines = content.split("\n");
+  lines.forEach((lineContent, index) => {
+    let match;
+    while ((match = htmlLinkRegex.exec(lineContent)) !== null) {
+      const url = match[1];
+      links.push({
+        url,
+        text: "",
+        // Would need HTML parsing to extract text
+        file: filePath,
+        line: index + 1,
+        type: "html",
+        isExternal: isExternalUrl(url),
+        isAnchor: isAnchorOnly(url)
+      });
+    }
+  });
+  return links;
+}
+function extractLinksFromFiles(filePaths) {
+  const allLinks = [];
+  for (const file of filePaths) {
+    try {
+      const links = extractLinksFromFile(file);
+      allLinks.push(...links);
+    } catch (error) {
+      console.error(`Error extracting links from ${file}:`, error);
+    }
+  }
+  return allLinks;
+}
+
+// src/link-validator.ts
+import { existsSync, readFileSync as readFileSync2, statSync } from "fs";
+import { resolve, dirname, join } from "path";
+import pLimit from "p-limit";
+function resolveLinkPath(link, sourceFile, baseDir) {
+  const [pathPart] = link.split("#");
+  if (pathPart.startsWith("/")) {
+    return resolve(baseDir, pathPart.slice(1));
+  }
+  const sourceDir = dirname(sourceFile);
+  return resolve(sourceDir, pathPart);
+}
+function extractAnchor(url) {
+  const parts = url.split("#");
+  return parts.length > 1 ? parts[1] : void 0;
+}
+function anchorExistsInFile(filePath, anchor) {
+  try {
+    const content = readFileSync2(filePath, "utf-8");
+    const normalizedAnchor = anchor.toLowerCase().replace(/\s+/g, "-");
+    const headerRegex = /^#+\s+(.+)$/gm;
+    let match;
+    while ((match = headerRegex.exec(content)) !== null) {
+      const headerText = match[1];
+      const headerId = headerText.toLowerCase().replace(/[^\w\s-]/g, "").replace(/\s+/g, "-");
+      if (headerId === normalizedAnchor) {
+        return true;
+      }
+    }
+    const htmlAnchorRegex = /<a\s+(?:name|id)=["']([^"']+)["']/gi;
+    while ((match = htmlAnchorRegex.exec(content)) !== null) {
+      if (match[1] === anchor) {
+        return true;
+      }
+    }
+    return false;
+  } catch {
+    return false;
+  }
+}
+function validateInternalLink(link, options) {
+  const { baseDir, validExtensions = [".md", ".mdx"] } = options;
+  try {
+    let targetPath = resolveLinkPath(link.url, link.file, baseDir);
+    let fileExists = existsSync(targetPath);
+    if (!fileExists) {
+      for (const ext of validExtensions) {
+        const pathWithExt = targetPath + ext;
+        if (existsSync(pathWithExt)) {
+          targetPath = pathWithExt;
+          fileExists = true;
+          break;
+        }
+      }
+    }
+    if (!fileExists && existsSync(targetPath) && statSync(targetPath).isDirectory()) {
+      for (const ext of validExtensions) {
+        const indexPath = join(targetPath, `index${ext}`);
+        if (existsSync(indexPath)) {
+          targetPath = indexPath;
+          fileExists = true;
+          break;
+        }
+      }
+    }
+    if (!fileExists) {
+      return {
+        link,
+        isValid: false,
+        error: `File not found: ${targetPath}`
+      };
+    }
+    const anchor = extractAnchor(link.url);
+    if (anchor) {
+      const anchorExists = anchorExistsInFile(targetPath, anchor);
+      if (!anchorExists) {
+        return {
+          link,
+          isValid: false,
+          error: `Anchor #${anchor} not found in ${targetPath}`
+        };
+      }
+    }
+    return {
+      link,
+      isValid: true
+    };
+  } catch (error) {
+    return {
+      link,
+      isValid: false,
+      error: error instanceof Error ? error.message : "Unknown error"
+    };
+  }
+}
+async function validateExternalLink(link, options) {
+  const { timeout = 5e3, skipDomains = [] } = options;
+  try {
+    const url = new URL(link.url);
+    if (skipDomains.some((domain) => url.hostname.includes(domain))) {
+      return {
+        link,
+        isValid: true,
+        statusCode: 0
+        // Skipped
+      };
+    }
+    const controller = new AbortController();
+    const timeoutId = setTimeout(() => controller.abort(), timeout);
+    const response = await fetch(link.url, {
+      method: "HEAD",
+      signal: controller.signal,
+      redirect: "follow"
+    });
+    clearTimeout(timeoutId);
+    const isValid = response.ok;
+    return {
+      link,
+      isValid,
+      statusCode: response.status,
+      redirectUrl: response.redirected ? response.url : void 0,
+      error: isValid ? void 0 : `HTTP ${response.status} ${response.statusText}`
+    };
+  } catch (error) {
+    return {
+      link,
+      isValid: false,
+      statusCode: 0,
+      error: error instanceof Error ? error.message : "Request failed"
+    };
+  }
+}
+async function validateLinks(links, options) {
+  const { concurrency = 10, checkExternal = false } = options;
+  const results = [];
+  const internalLinks = links.filter((l) => !l.isExternal);
+  const externalLinks = links.filter((l) => l.isExternal);
+  for (const link of internalLinks) {
+    results.push(validateInternalLink(link, options));
+  }
+  if (checkExternal && externalLinks.length > 0) {
+    const limit = pLimit(concurrency);
+    const externalResults = await Promise.all(
+      externalLinks.map((link) => limit(() => validateExternalLink(link, options)))
+    );
+    results.push(...externalResults);
+  }
+  return results;
+}
+
+// src/reporter.ts
+import chalk from "chalk";
+function calculateStats(results) {
+  return {
+    total: results.length,
+    valid: results.filter((r) => r.isValid).length,
+    broken: results.filter((r) => !r.isValid).length,
+    external: results.filter((r) => r.link.isExternal).length,
+    internal: results.filter((r) => !r.link.isExternal).length
+  };
+}
+function groupByErrorType(results) {
+  const broken = results.filter((r) => !r.isValid);
+  return {
+    notFound: broken.filter((r) => r.error?.includes("not found")),
+    brokenAnchor: broken.filter((r) => r.error?.includes("Anchor")),
+    externalError: broken.filter((r) => r.link.isExternal && r.statusCode && r.statusCode >= 400),
+    timeout: broken.filter((r) => r.error?.includes("timeout") || r.error?.includes("aborted"))
+  };
+}
+function formatLinkLocation(link) {
+  return `${link.file}:${link.line}`;
+}
+function printResults(results, options = {}) {
+  const { quiet = false, verbose = false, json = false } = options;
+  if (json) {
+    console.log(JSON.stringify(results, null, 2));
+    return;
+  }
+  const stats = calculateStats(results);
+  const grouped = groupByErrorType(results);
+  if (quiet) {
+    const broken = results.filter((r) => !r.isValid);
+    broken.forEach((result) => {
+      console.error(`${formatLinkLocation(result.link)} - ${result.link.url} - ${result.error}`);
+    });
+    return;
+  }
+  console.log(chalk.bold("\n\u{1F50D} Link Validation Results\n"));
+  if (grouped.notFound.length > 0) {
+    console.log(chalk.red.bold(`
+\u274C Files Not Found (${grouped.notFound.length}):
+`));
+    grouped.notFound.forEach((result) => {
+      console.log(
+        `  ${chalk.gray(formatLinkLocation(result.link))} ${chalk.yellow(result.link.url)}`
+      );
+      console.log(`    ${chalk.red(result.error)}`);
+    });
+  }
+  if (grouped.brokenAnchor.length > 0) {
+    console.log(chalk.red.bold(`
+\u274C Broken Anchors (${grouped.brokenAnchor.length}):
+`));
+    grouped.brokenAnchor.forEach((result) => {
+      console.log(
+        `  ${chalk.gray(formatLinkLocation(result.link))} ${chalk.yellow(result.link.url)}`
+      );
+      console.log(`    ${chalk.red(result.error)}`);
+    });
+  }
+  if (grouped.externalError.length > 0) {
+    console.log(chalk.red.bold(`
+\u274C External Link Errors (${grouped.externalError.length}):
+`));
+    grouped.externalError.forEach((result) => {
+      console.log(
+        `  ${chalk.gray(formatLinkLocation(result.link))} ${chalk.yellow(result.link.url)}`
+      );
+      console.log(
+        `    ${chalk.red(`HTTP ${result.statusCode}`)} ${result.error ? `- ${result.error}` : ""}`
+      );
+    });
+  }
+  if (grouped.timeout.length > 0) {
+    console.log(chalk.yellow.bold(`
+\u26A0\uFE0F  Timeouts (${grouped.timeout.length}):
+`));
+    grouped.timeout.forEach((result) => {
+      console.log(
+        `  ${chalk.gray(formatLinkLocation(result.link))} ${chalk.yellow(result.link.url)}`
+      );
+      console.log(`    ${chalk.yellow(result.error)}`);
+    });
+  }
+  if (verbose) {
+    console.log(chalk.green.bold(`
+\u2713 Valid Links (${stats.valid}):
+`));
+    results.filter((r) => r.isValid).forEach((result) => {
+      console.log(
+        `  ${chalk.gray(formatLinkLocation(result.link))} ${chalk.green("\u2713")} ${result.link.url}`
+      );
+    });
+  }
+  console.log(chalk.bold("\n\u{1F4CA} Summary:\n"));
+  console.log(`  Total links:     ${chalk.cyan(stats.total.toString())}`);
+  console.log(`  Valid:           ${chalk.green(stats.valid.toString())}`);
+  console.log(
+    `  Broken:          ${stats.broken > 0 ? chalk.red(stats.broken.toString()) : chalk.green("0")}`
+  );
+  console.log(`  Internal:        ${chalk.cyan(stats.internal.toString())}`);
+  console.log(`  External:        ${chalk.cyan(stats.external.toString())}`);
+  if (stats.broken === 0) {
+    console.log(chalk.green.bold("\n\u2728 All links are valid!\n"));
+  } else {
+    console.log(chalk.red.bold(`
+\u{1F494} Found ${stats.broken} broken link(s)
+`));
+  }
+}
+
+// src/config.ts
+import { existsSync as existsSync2, readFileSync as readFileSync3 } from "fs";
+import { resolve as resolve2 } from "path";
+import { createLogger } from "@goobits/docs-engine/utils";
+var logger = createLogger("cli-config");
+var defaultConfig = {
+  baseDir: process.cwd(),
+  include: ["**/*.md", "**/*.mdx"],
+  exclude: ["**/node_modules/**", "**/dist/**", "**/.git/**"],
+  checkExternal: false,
+  timeout: 5e3,
+  concurrency: 10,
+  skipDomains: ["localhost", "127.0.0.1", "example.com"],
+  validExtensions: [".md", ".mdx"]
+};
+function loadConfig(cwd = process.cwd()) {
+  const configFiles = [
+    ".linkcheckerrc.json",
+    ".linkcheckerrc",
+    "linkchecker.config.json",
+    "linkchecker.config.js"
+  ];
+  for (const configFile of configFiles) {
+    const configPath = resolve2(cwd, configFile);
+    if (existsSync2(configPath)) {
+      try {
+        const content = readFileSync3(configPath, "utf-8");
+        return JSON.parse(content);
+      } catch (error) {
+        logger.error({ error, configPath }, "Error loading config file");
+      }
+    }
+  }
+  return void 0;
+}
+function mergeConfig(config = {}) {
+  return {
+    ...defaultConfig,
+    ...config,
+    // Deep merge arrays
+    include: config.include || defaultConfig.include,
+    exclude: config.exclude || defaultConfig.exclude,
+    skipDomains: [...defaultConfig.skipDomains, ...config.skipDomains || []],
+    validExtensions: [...defaultConfig.validExtensions, ...config.validExtensions || []]
+  };
+}
+
+// src/versioning.ts
+import { promises as fs } from "fs";
+import path from "path";
+async function createVersion(version, docsDir) {
+  const versionedDocsDir = path.join(docsDir, "versioned_docs");
+  const currentDocsDir = path.join(docsDir, "current");
+  const versionDir = path.join(versionedDocsDir, `version-${version}`);
+  await fs.mkdir(versionedDocsDir, { recursive: true });
+  const sourceDir = await fs.access(currentDocsDir).then(() => currentDocsDir).catch(() => docsDir);
+  await copyDirectory(sourceDir, versionDir);
+  const versionsFile = path.join(docsDir, "versions.json");
+  let config;
+  try {
+    const content = await fs.readFile(versionsFile, "utf-8");
+    config = JSON.parse(content);
+  } catch {
+    config = {
+      currentVersion: version,
+      versions: []
+    };
+  }
+  config.versions.unshift({
+    version,
+    label: "latest",
+    releaseDate: (/* @__PURE__ */ new Date()).toISOString()
+  });
+  if (config.versions.length > 1) {
+    const previousLatest = config.versions[1];
+    if (previousLatest.label === "latest") {
+      previousLatest.label = "stable";
+    }
+  }
+  config.currentVersion = version;
+  await fs.writeFile(versionsFile, JSON.stringify(config, null, 2));
+}
+async function listVersions(docsDir) {
+  const versionsFile = path.join(docsDir, "versions.json");
+  try {
+    const content = await fs.readFile(versionsFile, "utf-8");
+    const config = JSON.parse(content);
+    return config.versions;
+  } catch {
+    return [];
+  }
+}
+async function deleteVersion(version, docsDir) {
+  const versionedDocsDir = path.join(docsDir, "versioned_docs");
+  const versionDir = path.join(versionedDocsDir, `version-${version}`);
+  await fs.rm(versionDir, { recursive: true, force: true });
+  const versionsFile = path.join(docsDir, "versions.json");
+  const content = await fs.readFile(versionsFile, "utf-8");
+  const config = JSON.parse(content);
+  config.versions = config.versions.filter((v) => v.version !== version);
+  if (config.currentVersion === version && config.versions.length > 0) {
+    config.currentVersion = config.versions[0].version;
+  }
+  await fs.writeFile(versionsFile, JSON.stringify(config, null, 2));
+}
+async function copyDirectory(src, dest) {
+  await fs.mkdir(dest, { recursive: true });
+  const entries = await fs.readdir(src, { withFileTypes: true });
+  for (const entry of entries) {
+    const srcPath = path.join(src, entry.name);
+    const destPath = path.join(dest, entry.name);
+    if (entry.isDirectory()) {
+      await copyDirectory(srcPath, destPath);
+    } else {
+      await fs.copyFile(srcPath, destPath);
+    }
+  }
+}
+
+// src/api-generator.ts
+import { writeFileSync, mkdirSync, existsSync as existsSync3 } from "fs";
+import path2 from "path";
+import { parseApi, generateApiDocFile, generateIndexFile } from "@goobits/docs-engine/server";
+async function generateApiDocs(config) {
+  const parsedFiles = parseApi({
+    entryPoints: config.entryPoints,
+    tsConfigPath: config.tsConfigPath,
+    exclude: config.exclude
+  });
+  if (parsedFiles.length === 0) {
+    throw new Error("No API items found in the specified entry points");
+  }
+  if (!existsSync3(config.outputDir)) {
+    mkdirSync(config.outputDir, { recursive: true });
+  }
+  const generatedFiles = [];
+  for (const parsedFile of parsedFiles) {
+    const { content, fileName } = generateApiDocFile(parsedFile, config.markdownConfig);
+    const outputPath = path2.join(config.outputDir, fileName);
+    writeFileSync(outputPath, content, "utf-8");
+    generatedFiles.push({
+      fileName,
+      items: parsedFile.items
+    });
+  }
+  if (config.generateIndex !== false) {
+    const indexContent = generateIndexFile(generatedFiles);
+    const indexPath = path2.join(config.outputDir, "index.md");
+    writeFileSync(indexPath, indexContent, "utf-8");
+  }
+}
+
+// src/symbol-watcher.ts
+import { createSymbolMapGenerator } from "@goobits/docs-engine/server";
+async function watchSymbols(config, options = {}) {
+  const { debounce = 500, onChange, verbose = false } = options;
+  if (verbose) {
+    console.log("\u{1F680} Starting TypeScript file watcher...");
+    console.log(`   Source patterns: ${config.sourcePatterns.join(", ")}`);
+    console.log(`   Output: ${config.outputPath}`);
+  }
+  const generator = createSymbolMapGenerator(config);
+  const watcher = await generator.watch({
+    debounce,
+    onChange: (stats) => {
+      if (onChange) {
+        onChange(stats);
+      } else if (verbose) {
+        console.log(
+          `\u2705 Symbol map updated (${(stats.duration / 1e3).toFixed(1)}s, ${stats.symbolCount} symbols)`
+        );
+      }
+    }
+  });
+  if (verbose) {
+    console.log("\n\u{1F440} Watching TypeScript files for changes...");
+    console.log("   Press Ctrl+C to stop\n");
+  }
+  return watcher;
+}
+
+// src/symbol-benchmarker.ts
+import { createSymbolMapGenerator as createSymbolMapGenerator2 } from "@goobits/docs-engine/server";
+async function benchmarkSymbols(config) {
+  const generator = createSymbolMapGenerator2(config);
+  return await generator.benchmark();
+}
+function printBenchmarkResults(results) {
+  console.log("\n" + "=".repeat(50));
+  console.log("\u{1F4C8} Benchmark Results:\n");
+  console.log(`Cold run:             ${results.cold}ms (${(results.cold / 1e3).toFixed(2)}s)`);
+  console.log(`Warm run (no change): ${results.warm}ms (${(results.warm / 1e3).toFixed(2)}s)`);
+  console.log(
+    `Warm run (1 change):  ${results.warmWithChange}ms (${(results.warmWithChange / 1e3).toFixed(2)}s)`
+  );
+  console.log(`
+Improvement:          ${results.improvement.toFixed(1)}% faster`);
+  console.log(
+    `Target achieved:      ${results.warm < 1e3 ? "\u2705 Yes" : "\u274C No"} (target: <1000ms)`
+  );
+  console.log(`
+\u{1F4BE} Cache file size:    ${(results.cacheSize / 1024).toFixed(2)} KB`);
+  console.log(`\u{1F524} Symbol count:       ${results.symbolCount}`);
+  console.log("=".repeat(50) + "\n");
+}
+
+// src/index.ts
+function getVersion() {
+  try {
+    const __filename2 = fileURLToPath(import.meta.url);
+    const __dirname2 = dirname2(__filename2);
+    const packageJsonPath = join2(__dirname2, "../package.json");
+    const packageJson = JSON.parse(readFileSync4(packageJsonPath, "utf-8"));
+    return packageJson.version || "1.0.0";
+  } catch {
+    return "1.0.0";
+  }
+}
+var program = new Command();
+program.name("docs-engine").description("CLI tools for docs-engine - link checking, versioning, and validation").version(getVersion());
+program.command("check-links").description("Check all links in markdown documentation").option("-b, --base-dir <path>", "Base directory for docs (default: current directory)").option("-p, --pattern <glob>", "Glob pattern for markdown files (default: **/*.md)").option("-e, --external", "Validate external links (slower)").option("-t, --timeout <ms>", "Timeout for external requests in ms (default: 5000)", "5000").option("-c, --concurrency <num>", "Max concurrent external requests (default: 10)", "10").option("-q, --quiet", "Only show errors").option("-v, --verbose", "Show all links including valid ones").option("--json", "Output results as JSON").option("--config <path>", "Path to config file").action(async (options) => {
+  const spinner = ora("Initializing link checker...").start();
+  try {
+    let fileConfig;
+    if (options.config) {
+      try {
+        const { readFileSync: readFileSync5 } = await import("fs");
+        fileConfig = JSON.parse(readFileSync5(options.config, "utf-8"));
+      } catch {
+        fileConfig = void 0;
+      }
+    } else {
+      fileConfig = loadConfig();
+    }
+    const config = mergeConfig({
+      ...fileConfig,
+      baseDir: options.baseDir || fileConfig?.baseDir,
+      checkExternal: options.external || fileConfig?.checkExternal,
+      timeout: parseInt(options.timeout, 10),
+      concurrency: parseInt(options.concurrency, 10)
+    });
+    spinner.text = "Finding markdown files...";
+    const pattern = options.pattern || config.include.join(",");
+    const files = await glob(pattern, {
+      cwd: config.baseDir,
+      absolute: true,
+      ignore: config.exclude
+    });
+    if (files.length === 0) {
+      spinner.fail("No markdown files found");
+      process.exit(1);
+    }
+    spinner.succeed(`Found ${files.length} markdown file(s)`);
+    spinner.start("Extracting links...");
+    const links = extractLinksFromFiles(files);
+    spinner.succeed(`Extracted ${links.length} link(s)`);
+    spinner.start(
+      config.checkExternal ? "Validating links (including external)..." : "Validating internal links..."
+    );
+    const results = await validateLinks(links, {
+      baseDir: config.baseDir,
+      checkExternal: config.checkExternal,
+      timeout: config.timeout,
+      concurrency: config.concurrency,
+      skipDomains: config.skipDomains,
+      validExtensions: config.validExtensions
+    });
+    spinner.succeed("Validation complete");
+    printResults(results, {
+      quiet: options.quiet,
+      verbose: options.verbose,
+      json: options.json
+    });
+    const brokenCount = results.filter((r) => !r.isValid).length;
+    if (brokenCount > 0) {
+      process.exit(1);
+    }
+  } catch (error) {
+    spinner.fail("Link checking failed");
+    console.error(error);
+    process.exit(1);
+  }
+});
+var versionCmd = program.command("version").description("Manage documentation versions");
+versionCmd.command("create <version>").description("Create new documentation version from current docs").option("-d, --docs-dir <path>", "Documentation directory", "docs").action(async (version, options) => {
+  const spinner = ora(`Creating version ${version}...`).start();
+  try {
+    const docsDir = path3.resolve(process.cwd(), options.docsDir);
+    await createVersion(version, docsDir);
+    spinner.succeed(`Version ${version} created successfully!`);
+    console.log(chalk2.cyan("\nNext steps:"));
+    console.log(
+      chalk2.gray(
+        `  - Version created in ${path3.join(docsDir, "versioned_docs", `version-${version}`)}`
+      )
+    );
+    console.log(chalk2.gray(`  - Updated versions.json`));
+    console.log(chalk2.gray(`  - Deploy your updated documentation`));
+  } catch (error) {
+    spinner.fail("Failed to create version");
+    console.error(chalk2.red(error instanceof Error ? error.message : "Unknown error"));
+    process.exit(1);
+  }
+});
+versionCmd.command("list").description("List all documentation versions").option("-d, --docs-dir <path>", "Documentation directory", "docs").action(async (options) => {
+  try {
+    const docsDir = path3.resolve(process.cwd(), options.docsDir);
+    const versions = await listVersions(docsDir);
+    if (versions.length === 0) {
+      console.log(chalk2.yellow("No versions found"));
+      return;
+    }
+    console.log(chalk2.bold("\nDocumentation Versions:"));
+    versions.forEach((version) => {
+      const label = version.label ? chalk2.cyan(` [${version.label}]`) : "";
+      console.log(`  ${version.version}${label}`);
+    });
+    console.log();
+  } catch (error) {
+    console.error(chalk2.red(error instanceof Error ? error.message : "Unknown error"));
+    process.exit(1);
+  }
+});
+versionCmd.command("delete <version>").description("Delete a documentation version").option("-d, --docs-dir <path>", "Documentation directory", "docs").option("-f, --force", "Skip confirmation", false).action(async (version, options) => {
+  const spinner = ora(`Deleting version ${version}...`).start();
+  try {
+    const docsDir = path3.resolve(process.cwd(), options.docsDir);
+    await deleteVersion(version, docsDir);
+    spinner.succeed(`Version ${version} deleted successfully!`);
+  } catch (error) {
+    spinner.fail("Failed to delete version");
+    console.error(chalk2.red(error instanceof Error ? error.message : "Unknown error"));
+    process.exit(1);
+  }
+});
+program.command("generate-api").description("Generate API documentation from TypeScript source files").option("-e, --entry-points <paths...>", "TypeScript files or glob patterns to parse", [
+  "src/**/*.ts"
+]).option("-o, --output-dir <path>", "Output directory for generated markdown", "docs/api").option("-t, --tsconfig <path>", "Path to tsconfig.json").option("--exclude <patterns...>", "Patterns to exclude from parsing").option("--base-url <url>", "Base URL for type links (e.g., /api)").option("--repo-url <url>", "Repository URL for source links").option("--repo-branch <branch>", "Repository branch for source links", "main").option("--no-index", "Skip generating index file").option("--source-links", "Include links to source code").action(async (options) => {
+  const spinner = ora("Generating API documentation...").start();
+  try {
+    await generateApiDocs({
+      entryPoints: options.entryPoints,
+      outputDir: path3.resolve(process.cwd(), options.outputDir),
+      tsConfigPath: options.tsconfig ? path3.resolve(process.cwd(), options.tsconfig) : void 0,
+      exclude: options.exclude,
+      generateIndex: options.index,
+      markdownConfig: {
+        baseUrl: options.baseUrl,
+        repoUrl: options.repoUrl,
+        repoBranch: options.repoBranch,
+        includeSourceLinks: options.sourceLinks
+      }
+    });
+    const filesCount = options.entryPoints.length;
+    spinner.succeed(`API documentation generated successfully!`);
+    console.log(chalk2.cyan("\nGenerated files:"));
+    console.log(chalk2.gray(`  Output directory: ${options.outputDir}`));
+    console.log(chalk2.gray(`  Entry points: ${filesCount} pattern(s)`));
+    if (options.index) {
+      console.log(chalk2.gray(`  Index file: ${path3.join(options.outputDir, "index.md")}`));
+    }
+  } catch (error) {
+    spinner.fail("API documentation generation failed");
+    console.error(chalk2.red(error instanceof Error ? error.message : "Unknown error"));
+    if (error instanceof Error && error.stack) {
+      console.error(chalk2.gray(error.stack));
+    }
+    process.exit(1);
+  }
+});
+program.command("symbols").description("Generate, watch, or benchmark symbol map from TypeScript sources").option("-s, --source <patterns...>", "Source patterns to scan", ["src/**/*.ts"]).option("-o, --output <path>", "Output path for symbol map", "docs/symbol-map.json").option("-e, --exclude <patterns...>", "Patterns to exclude").option("--cache-dir <path>", "Cache directory", ".cache").option("--cache-version <version>", "Cache version", "1.0").option("-w, --watch", "Watch files and regenerate on changes").option("-b, --benchmark", "Run performance benchmark").option("--debounce <ms>", "Debounce delay for watch mode in ms", "500").option("-v, --verbose", "Show verbose output").action(async (options) => {
+  try {
+    const config = {
+      sourcePatterns: options.source,
+      excludePatterns: options.exclude || [
+        "**/*.test.ts",
+        "**/*.spec.ts",
+        "**/node_modules/**",
+        "**/dist/**"
+      ],
+      outputPath: path3.resolve(process.cwd(), options.output),
+      cacheDir: options.cacheDir,
+      cacheVersion: options.cacheVersion,
+      baseDir: process.cwd()
+    };
+    if (options.benchmark) {
+      const spinner2 = ora("Running benchmark...").start();
+      spinner2.text = "\u{1F52C} Symbol Map Generation Benchmark";
+      spinner2.stop();
+      console.log("=".repeat(50));
+      console.log("Running performance tests...\n");
+      const results = await benchmarkSymbols(config);
+      printBenchmarkResults(results);
+      return;
+    }
+    if (options.watch) {
+      console.log("\u{1F680} Starting TypeScript file watcher...");
+      console.log(`   Source: ${options.source.join(", ")}`);
+      console.log(`   Output: ${options.output}
+`);
+      const watcher = await watchSymbols(config, {
+        debounce: parseInt(options.debounce, 10),
+        verbose: options.verbose,
+        onChange: (stats) => {
+          console.log(
+            `\u2705 Symbol map updated (${(stats.duration / 1e3).toFixed(1)}s, ${stats.symbolCount} symbols)`
+          );
+          console.log("\n\u{1F440} Watching TypeScript files for changes...");
+        }
+      });
+      console.log("\u{1F440} Watching TypeScript files for changes...");
+      console.log("   Press Ctrl+C to stop\n");
+      const shutdown = async () => {
+        console.log("\n\n\u{1F44B} Stopping file watcher...");
+        await watcher.close();
+        console.log("\u2705 File watcher stopped");
+        process.exit(0);
+      };
+      process.on("SIGINT", shutdown);
+      process.on("SIGTERM", shutdown);
+      return;
+    }
+    const spinner = ora("Generating symbol map...").start();
+    const startTime = Date.now();
+    const { createSymbolMapGenerator: createSymbolMapGenerator3 } = await import("@goobits/docs-engine/server");
+    const generator = createSymbolMapGenerator3(config);
+    const symbolMap = await generator.generate();
+    const duration = Date.now() - startTime;
+    const symbolCount = Object.values(symbolMap).flat().length;
+    spinner.succeed("Symbol map generated successfully!");
+    console.log(chalk2.cyan("\nGenerated:"));
+    console.log(chalk2.gray(`  Output: ${options.output}`));
+    console.log(chalk2.gray(`  Symbols: ${symbolCount}`));
+    console.log(chalk2.gray(`  Duration: ${(duration / 1e3).toFixed(2)}s`));
+  } catch (error) {
+    console.error(chalk2.red("Symbol generation failed"));
+    console.error(chalk2.red(error instanceof Error ? error.message : "Unknown error"));
+    if (error instanceof Error && error.stack && options.verbose) {
+      console.error(chalk2.gray(error.stack));
+    }
+    process.exit(1);
+  }
+});
+program.parse();
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts","../src/link-extractor.ts","../src/link-validator.ts","../src/reporter.ts","../src/config.ts","../src/versioning.ts","../src/api-generator.ts","../src/symbol-watcher.ts","../src/symbol-benchmarker.ts"],"sourcesContent":["#!/usr/bin/env node\n\nimport { Command } from 'commander';\nimport { glob } from 'glob';\nimport ora from 'ora';\nimport chalk from 'chalk';\nimport path from 'path';\nimport { readFileSync } from 'fs';\nimport { fileURLToPath } from 'url';\nimport { dirname, join } from 'path';\nimport { extractLinksFromFiles } from './link-extractor.js';\nimport { validateLinks } from './link-validator.js';\nimport { printResults } from './reporter.js';\nimport { loadConfig, mergeConfig } from './config.js';\nimport type { LinkCheckerConfig } from './config.js';\nimport { createVersion, listVersions, deleteVersion } from './versioning.js';\nimport { generateApiDocs } from './api-generator.js';\nimport { watchSymbols } from './symbol-watcher.js';\nimport { benchmarkSymbols, printBenchmarkResults } from './symbol-benchmarker.js';\n\n/**\n * Get the CLI version from package.json\n */\nfunction getVersion(): string {\n  try {\n    const __filename = fileURLToPath(import.meta.url);\n    const __dirname = dirname(__filename);\n    const packageJsonPath = join(__dirname, '../package.json');\n    const packageJson = JSON.parse(readFileSync(packageJsonPath, 'utf-8'));\n    return packageJson.version || '1.0.0';\n  } catch {\n    return '1.0.0';\n  }\n}\n\n/**\n * Main CLI program\n *\n * Provides commands for:\n * - Link checking and validation\n * - Documentation versioning\n * - Symbol map generation and watching\n * - Documentation maintenance\n *\n * @public\n */\nconst program = new Command();\n\nprogram\n  .name('docs-engine')\n  .description('CLI tools for docs-engine - link checking, versioning, and validation')\n  .version(getVersion());\n\n/**\n * Check links command\n *\n * Usage:\n * ```bash\n * docs-engine check-links\n * docs-engine check-links --external\n * docs-engine check-links --quiet\n * docs-engine check-links --json > results.json\n * ```\n */\nprogram\n  .command('check-links')\n  .description('Check all links in markdown documentation')\n  .option('-b, --base-dir <path>', 'Base directory for docs (default: current directory)')\n  .option('-p, --pattern <glob>', 'Glob pattern for markdown files (default: **/*.md)')\n  .option('-e, --external', 'Validate external links (slower)')\n  .option('-t, --timeout <ms>', 'Timeout for external requests in ms (default: 5000)', '5000')\n  .option('-c, --concurrency <num>', 'Max concurrent external requests (default: 10)', '10')\n  .option('-q, --quiet', 'Only show errors')\n  .option('-v, --verbose', 'Show all links including valid ones')\n  .option('--json', 'Output results as JSON')\n  .option('--config <path>', 'Path to config file')\n  .action(async (options) => {\n    const spinner = ora('Initializing link checker...').start();\n\n    try {\n      // Load configuration\n      let fileConfig: LinkCheckerConfig | undefined;\n      if (options.config) {\n        try {\n          const { readFileSync } = await import('fs');\n          fileConfig = JSON.parse(readFileSync(options.config, 'utf-8')) as LinkCheckerConfig;\n        } catch {\n          fileConfig = undefined;\n        }\n      } else {\n        fileConfig = loadConfig();\n      }\n\n      const config = mergeConfig({\n        ...fileConfig,\n        baseDir: options.baseDir || fileConfig?.baseDir,\n        checkExternal: options.external || fileConfig?.checkExternal,\n        timeout: parseInt(options.timeout, 10),\n        concurrency: parseInt(options.concurrency, 10),\n      });\n\n      spinner.text = 'Finding markdown files...';\n\n      // Find all markdown files\n      const pattern = options.pattern || config.include.join(',');\n      const files = await glob(pattern, {\n        cwd: config.baseDir,\n        absolute: true,\n        ignore: config.exclude,\n      });\n\n      if (files.length === 0) {\n        spinner.fail('No markdown files found');\n        process.exit(1);\n      }\n\n      spinner.succeed(`Found ${files.length} markdown file(s)`);\n\n      // Extract links\n      spinner.start('Extracting links...');\n      const links = extractLinksFromFiles(files);\n      spinner.succeed(`Extracted ${links.length} link(s)`);\n\n      // Validate links\n      spinner.start(\n        config.checkExternal\n          ? 'Validating links (including external)...'\n          : 'Validating internal links...'\n      );\n\n      const results = await validateLinks(links, {\n        baseDir: config.baseDir,\n        checkExternal: config.checkExternal,\n        timeout: config.timeout,\n        concurrency: config.concurrency,\n        skipDomains: config.skipDomains,\n        validExtensions: config.validExtensions,\n      });\n\n      spinner.succeed('Validation complete');\n\n      // Print results\n      printResults(results, {\n        quiet: options.quiet,\n        verbose: options.verbose,\n        json: options.json,\n      });\n\n      // Exit with error code if broken links found\n      const brokenCount = results.filter((r) => !r.isValid).length;\n      if (brokenCount > 0) {\n        process.exit(1);\n      }\n    } catch (error) {\n      spinner.fail('Link checking failed');\n      console.error(error);\n      process.exit(1);\n    }\n  });\n\n/**\n * Version management commands\n */\nconst versionCmd = program.command('version').description('Manage documentation versions');\n\nversionCmd\n  .command('create <version>')\n  .description('Create new documentation version from current docs')\n  .option('-d, --docs-dir <path>', 'Documentation directory', 'docs')\n  .action(async (version: string, options) => {\n    const spinner = ora(`Creating version ${version}...`).start();\n\n    try {\n      const docsDir = path.resolve(process.cwd(), options.docsDir);\n      await createVersion(version, docsDir);\n      spinner.succeed(`Version ${version} created successfully!`);\n\n      console.log(chalk.cyan('\\nNext steps:'));\n      console.log(\n        chalk.gray(\n          `  - Version created in ${path.join(docsDir, 'versioned_docs', `version-${version}`)}`\n        )\n      );\n      console.log(chalk.gray(`  - Updated versions.json`));\n      console.log(chalk.gray(`  - Deploy your updated documentation`));\n    } catch (error) {\n      spinner.fail('Failed to create version');\n      console.error(chalk.red(error instanceof Error ? error.message : 'Unknown error'));\n      process.exit(1);\n    }\n  });\n\nversionCmd\n  .command('list')\n  .description('List all documentation versions')\n  .option('-d, --docs-dir <path>', 'Documentation directory', 'docs')\n  .action(async (options) => {\n    try {\n      const docsDir = path.resolve(process.cwd(), options.docsDir);\n      const versions = await listVersions(docsDir);\n\n      if (versions.length === 0) {\n        console.log(chalk.yellow('No versions found'));\n        return;\n      }\n\n      console.log(chalk.bold('\\nDocumentation Versions:'));\n      versions.forEach((version) => {\n        const label = version.label ? chalk.cyan(` [${version.label}]`) : '';\n        console.log(`  ${version.version}${label}`);\n      });\n      console.log();\n    } catch (error) {\n      console.error(chalk.red(error instanceof Error ? error.message : 'Unknown error'));\n      process.exit(1);\n    }\n  });\n\nversionCmd\n  .command('delete <version>')\n  .description('Delete a documentation version')\n  .option('-d, --docs-dir <path>', 'Documentation directory', 'docs')\n  .option('-f, --force', 'Skip confirmation', false)\n  .action(async (version: string, options) => {\n    const spinner = ora(`Deleting version ${version}...`).start();\n\n    try {\n      const docsDir = path.resolve(process.cwd(), options.docsDir);\n      await deleteVersion(version, docsDir);\n      spinner.succeed(`Version ${version} deleted successfully!`);\n    } catch (error) {\n      spinner.fail('Failed to delete version');\n      console.error(chalk.red(error instanceof Error ? error.message : 'Unknown error'));\n      process.exit(1);\n    }\n  });\n\n/**\n * API documentation generation command\n */\nprogram\n  .command('generate-api')\n  .description('Generate API documentation from TypeScript source files')\n  .option('-e, --entry-points <paths...>', 'TypeScript files or glob patterns to parse', [\n    'src/**/*.ts',\n  ])\n  .option('-o, --output-dir <path>', 'Output directory for generated markdown', 'docs/api')\n  .option('-t, --tsconfig <path>', 'Path to tsconfig.json')\n  .option('--exclude <patterns...>', 'Patterns to exclude from parsing')\n  .option('--base-url <url>', 'Base URL for type links (e.g., /api)')\n  .option('--repo-url <url>', 'Repository URL for source links')\n  .option('--repo-branch <branch>', 'Repository branch for source links', 'main')\n  .option('--no-index', 'Skip generating index file')\n  .option('--source-links', 'Include links to source code')\n  .action(async (options) => {\n    const spinner = ora('Generating API documentation...').start();\n\n    try {\n      await generateApiDocs({\n        entryPoints: options.entryPoints,\n        outputDir: path.resolve(process.cwd(), options.outputDir),\n        tsConfigPath: options.tsconfig ? path.resolve(process.cwd(), options.tsconfig) : undefined,\n        exclude: options.exclude,\n        generateIndex: options.index,\n        markdownConfig: {\n          baseUrl: options.baseUrl,\n          repoUrl: options.repoUrl,\n          repoBranch: options.repoBranch,\n          includeSourceLinks: options.sourceLinks,\n        },\n      });\n\n      const filesCount = options.entryPoints.length;\n      spinner.succeed(`API documentation generated successfully!`);\n\n      console.log(chalk.cyan('\\nGenerated files:'));\n      console.log(chalk.gray(`  Output directory: ${options.outputDir}`));\n      console.log(chalk.gray(`  Entry points: ${filesCount} pattern(s)`));\n\n      if (options.index) {\n        console.log(chalk.gray(`  Index file: ${path.join(options.outputDir, 'index.md')}`));\n      }\n    } catch (error) {\n      spinner.fail('API documentation generation failed');\n      console.error(chalk.red(error instanceof Error ? error.message : 'Unknown error'));\n      if (error instanceof Error && error.stack) {\n        console.error(chalk.gray(error.stack));\n      }\n      process.exit(1);\n    }\n  });\n\n/**\n * Symbol map generation command\n */\nprogram\n  .command('symbols')\n  .description('Generate, watch, or benchmark symbol map from TypeScript sources')\n  .option('-s, --source <patterns...>', 'Source patterns to scan', ['src/**/*.ts'])\n  .option('-o, --output <path>', 'Output path for symbol map', 'docs/symbol-map.json')\n  .option('-e, --exclude <patterns...>', 'Patterns to exclude')\n  .option('--cache-dir <path>', 'Cache directory', '.cache')\n  .option('--cache-version <version>', 'Cache version', '1.0')\n  .option('-w, --watch', 'Watch files and regenerate on changes')\n  .option('-b, --benchmark', 'Run performance benchmark')\n  .option('--debounce <ms>', 'Debounce delay for watch mode in ms', '500')\n  .option('-v, --verbose', 'Show verbose output')\n  .action(async (options) => {\n    try {\n      const config = {\n        sourcePatterns: options.source,\n        excludePatterns: options.exclude || [\n          '**/*.test.ts',\n          '**/*.spec.ts',\n          '**/node_modules/**',\n          '**/dist/**',\n        ],\n        outputPath: path.resolve(process.cwd(), options.output),\n        cacheDir: options.cacheDir,\n        cacheVersion: options.cacheVersion,\n        baseDir: process.cwd(),\n      };\n\n      // Benchmark mode\n      if (options.benchmark) {\n        const spinner = ora('Running benchmark...').start();\n        spinner.text = '🔬 Symbol Map Generation Benchmark';\n        spinner.stop();\n\n        console.log('='.repeat(50));\n        console.log('Running performance tests...\\n');\n\n        const results = await benchmarkSymbols(config);\n        printBenchmarkResults(results);\n        return;\n      }\n\n      // Watch mode\n      if (options.watch) {\n        console.log('🚀 Starting TypeScript file watcher...');\n        console.log(`   Source: ${options.source.join(', ')}`);\n        console.log(`   Output: ${options.output}\\n`);\n\n        const watcher = await watchSymbols(config, {\n          debounce: parseInt(options.debounce, 10),\n          verbose: options.verbose,\n          onChange: (stats) => {\n            console.log(\n              `✅ Symbol map updated (${(stats.duration / 1000).toFixed(1)}s, ${stats.symbolCount} symbols)`\n            );\n            console.log('\\n👀 Watching TypeScript files for changes...');\n          },\n        });\n\n        console.log('👀 Watching TypeScript files for changes...');\n        console.log('   Press Ctrl+C to stop\\n');\n\n        // Handle graceful shutdown\n        const shutdown = async (): Promise<void> => {\n          console.log('\\n\\n👋 Stopping file watcher...');\n          await watcher.close();\n          console.log('✅ File watcher stopped');\n          process.exit(0);\n        };\n\n        process.on('SIGINT', shutdown);\n        process.on('SIGTERM', shutdown);\n        return;\n      }\n\n      // Normal generation mode\n      const spinner = ora('Generating symbol map...').start();\n      const startTime = Date.now();\n      const { createSymbolMapGenerator } = await import('@goobits/docs-engine/server');\n\n      const generator = createSymbolMapGenerator(config);\n      const symbolMap = await generator.generate();\n      const duration = Date.now() - startTime;\n      const symbolCount = Object.values(symbolMap).flat().length;\n\n      spinner.succeed('Symbol map generated successfully!');\n      console.log(chalk.cyan('\\nGenerated:'));\n      console.log(chalk.gray(`  Output: ${options.output}`));\n      console.log(chalk.gray(`  Symbols: ${symbolCount}`));\n      console.log(chalk.gray(`  Duration: ${(duration / 1000).toFixed(2)}s`));\n    } catch (error) {\n      console.error(chalk.red('Symbol generation failed'));\n      console.error(chalk.red(error instanceof Error ? error.message : 'Unknown error'));\n      if (error instanceof Error && error.stack && options.verbose) {\n        console.error(chalk.gray(error.stack));\n      }\n      process.exit(1);\n    }\n  });\n\n// Parse CLI arguments\nprogram.parse();\n","import { unified } from 'unified';\nimport remarkParse from 'remark-parse';\nimport remarkMdx from 'remark-mdx';\nimport { visit } from 'unist-util-visit';\nimport type { Link, Image } from 'mdast';\nimport { readFileSync } from 'fs';\n\n/**\n * Represents a link found in a markdown file\n *\n * @public\n */\nexport interface ExtractedLink {\n  /** Link URL or path */\n  url: string;\n  /** Link text or alt text */\n  text: string;\n  /** Source file path */\n  file: string;\n  /** Line number in source file */\n  line: number;\n  /** Link type */\n  type: 'link' | 'image' | 'html';\n  /** Whether this is an external URL */\n  isExternal: boolean;\n  /** Whether this is an anchor link */\n  isAnchor: boolean;\n}\n\n// ============================================================================\n// Module-Private Helpers (True Privacy via ESM)\n// ============================================================================\n\n/**\n * Check if a URL is external (http/https)\n * Module-private helper - not exported, not accessible outside this module\n */\nfunction isExternalUrl(url: string): boolean {\n  return /^https?:\\/\\//i.test(url);\n}\n\n/**\n * Check if a URL is an anchor-only link\n * Module-private helper - not exported, not accessible outside this module\n */\nfunction isAnchorOnly(url: string): boolean {\n  return url.startsWith('#');\n}\n\n// ============================================================================\n// Public API\n// ============================================================================\n\n/**\n * Extract all links from a markdown file\n *\n * Extracts:\n * - Markdown links: `[text](url)`\n * - Images: `![alt](url)`\n * - HTML links: `<a href=\"url\">`\n *\n * @param filePath - Path to markdown file\n * @returns Array of extracted links\n *\n * @example\n * ```typescript\n * const links = extractLinksFromFile('./docs/guide.md');\n * links.forEach(link => {\n *   console.log(`${link.file}:${link.line} - ${link.url}`);\n * });\n * ```\n *\n * @public\n */\nexport function extractLinksFromFile(filePath: string): ExtractedLink[] {\n  const content = readFileSync(filePath, 'utf-8');\n  const links: ExtractedLink[] = [];\n\n  // Parse markdown with MDX support\n  const tree = unified().use(remarkParse).use(remarkMdx).parse(content);\n\n  // Extract markdown links and images\n  visit(tree, ['link', 'image'], (node: Link | Image, _index, _parent) => {\n    const url = node.url;\n    if (!url) return;\n\n    const position = node.position;\n    const line = position?.start.line || 0;\n\n    // Get link text\n    let text = '';\n    if (node.type === 'link') {\n      const linkNode = node as Link;\n      if (linkNode.children && linkNode.children.length > 0) {\n        const firstChild = linkNode.children[0];\n        if ('value' in firstChild) {\n          text = firstChild.value as string;\n        }\n      }\n    } else if (node.type === 'image') {\n      const imageNode = node as Image;\n      text = imageNode.alt || '';\n    }\n\n    links.push({\n      url,\n      text,\n      file: filePath,\n      line,\n      type: node.type === 'image' ? 'image' : 'link',\n      isExternal: isExternalUrl(url),\n      isAnchor: isAnchorOnly(url),\n    });\n  });\n\n  // Extract HTML links (basic regex for <a href=\"\">)\n  const htmlLinkRegex = /<a\\s+(?:[^>]*?\\s+)?href=[\"']([^\"']+)[\"']/gi;\n  const lines = content.split('\\n');\n\n  lines.forEach((lineContent, index) => {\n    let match;\n    while ((match = htmlLinkRegex.exec(lineContent)) !== null) {\n      const url = match[1];\n      links.push({\n        url,\n        text: '', // Would need HTML parsing to extract text\n        file: filePath,\n        line: index + 1,\n        type: 'html',\n        isExternal: isExternalUrl(url),\n        isAnchor: isAnchorOnly(url),\n      });\n    }\n  });\n\n  return links;\n}\n\n/**\n * Extract links from multiple markdown files\n *\n * @param filePaths - Array of file paths\n * @returns Array of all extracted links\n *\n * @example\n * ```typescript\n * const files = ['./docs/guide.md', './docs/api.md'];\n * const allLinks = extractLinksFromFiles(files);\n * console.log(`Found ${allLinks.length} links across ${files.length} files`);\n * ```\n *\n * @public\n */\nexport function extractLinksFromFiles(filePaths: string[]): ExtractedLink[] {\n  const allLinks: ExtractedLink[] = [];\n\n  for (const file of filePaths) {\n    try {\n      const links = extractLinksFromFile(file);\n      allLinks.push(...links);\n    } catch (error) {\n      console.error(`Error extracting links from ${file}:`, error);\n    }\n  }\n\n  return allLinks;\n}\n\n/**\n * Group links by type (internal, external, anchor)\n *\n * @param links - Array of links to group\n * @returns Grouped links object\n *\n * @example\n * ```typescript\n * const grouped = groupLinksByType(links);\n * console.log(`Internal: ${grouped.internal.length}`);\n * console.log(`External: ${grouped.external.length}`);\n * console.log(`Anchors: ${grouped.anchor.length}`);\n * ```\n *\n * @public\n */\nexport function groupLinksByType(links: ExtractedLink[]): {\n  internal: ExtractedLink[];\n  external: ExtractedLink[];\n  anchor: ExtractedLink[];\n} {\n  return {\n    internal: links.filter((l) => !l.isExternal && !l.isAnchor),\n    external: links.filter((l) => l.isExternal),\n    anchor: links.filter((l) => l.isAnchor),\n  };\n}\n","import { existsSync, readFileSync, statSync } from 'fs';\nimport { resolve, dirname, join } from 'path';\nimport type { ExtractedLink } from './link-extractor.js';\nimport pLimit from 'p-limit';\n\n/**\n * Link validation result\n *\n * @public\n */\nexport interface ValidationResult {\n  /** The link that was validated */\n  link: ExtractedLink;\n  /** Whether the link is valid */\n  isValid: boolean;\n  /** Error message if invalid */\n  error?: string;\n  /** HTTP status code (for external links) */\n  statusCode?: number;\n  /** Redirect URL (if redirected) */\n  redirectUrl?: string;\n}\n\n/**\n * Configuration options for link validation\n *\n * @public\n */\nexport interface ValidationOptions {\n  /** Base directory for resolving relative paths */\n  baseDir: string;\n  /** Validate external links (requires HTTP requests) */\n  checkExternal?: boolean;\n  /** Timeout for external link requests (ms) */\n  timeout?: number;\n  /** Maximum concurrent external requests */\n  concurrency?: number;\n  /** Domains to skip validation */\n  skipDomains?: string[];\n  /** File extensions to treat as valid */\n  validExtensions?: string[];\n}\n\n// ============================================================================\n// Module-Private Helpers (True Privacy via ESM)\n// ============================================================================\n\n/**\n * Resolve a relative link to an absolute file path\n * Module-private helper - not exported, not accessible outside this module\n *\n * Handles:\n * - Relative paths: `./file.md`, `../file.md`\n * - Absolute paths: `/docs/file.md`\n * - Removes `.md` extension for route matching\n * - Supports anchor links: `file.md#section`\n */\nfunction resolveLinkPath(link: string, sourceFile: string, baseDir: string): string {\n  // Remove anchor\n  const [pathPart] = link.split('#');\n\n  // Handle absolute paths\n  if (pathPart.startsWith('/')) {\n    return resolve(baseDir, pathPart.slice(1));\n  }\n\n  // Handle relative paths\n  const sourceDir = dirname(sourceFile);\n  return resolve(sourceDir, pathPart);\n}\n\n/**\n * Extract anchor from URL\n * Module-private helper - not exported, not accessible outside this module\n */\nfunction extractAnchor(url: string): string | undefined {\n  const parts = url.split('#');\n  return parts.length > 1 ? parts[1] : undefined;\n}\n\n/**\n * Check if an anchor exists in a markdown file\n * Module-private helper - not exported, not accessible outside this module\n *\n * Checks for:\n * - Headers: `## Section Name` → `#section-name`\n * - HTML anchors: `<a name=\"anchor\">` or `<a id=\"anchor\">`\n */\nfunction anchorExistsInFile(filePath: string, anchor: string): boolean {\n  try {\n    const content = readFileSync(filePath, 'utf-8');\n\n    // Convert anchor to expected format (lowercase, spaces to hyphens)\n    const normalizedAnchor = anchor.toLowerCase().replace(/\\s+/g, '-');\n\n    // Check for markdown headers\n    // Match: ## Header, ### Header, etc.\n    const headerRegex = /^#+\\s+(.+)$/gm;\n    let match;\n\n    while ((match = headerRegex.exec(content)) !== null) {\n      const headerText = match[1];\n      const headerId = headerText\n        .toLowerCase()\n        .replace(/[^\\w\\s-]/g, '') // Remove special chars\n        .replace(/\\s+/g, '-'); // Spaces to hyphens\n\n      if (headerId === normalizedAnchor) {\n        return true;\n      }\n    }\n\n    // Check for HTML anchors\n    const htmlAnchorRegex = /<a\\s+(?:name|id)=[\"']([^\"']+)[\"']/gi;\n    while ((match = htmlAnchorRegex.exec(content)) !== null) {\n      if (match[1] === anchor) {\n        return true;\n      }\n    }\n\n    return false;\n  } catch {\n    return false;\n  }\n}\n\n// ============================================================================\n// Public API\n// ============================================================================\n\n/**\n * Validate an internal link\n *\n * Checks:\n * - File exists\n * - Anchor exists (if present)\n * - Handles .md extension conversion\n *\n * @param link - Link to validate\n * @param options - Validation options\n * @returns Validation result\n *\n * @example\n * ```typescript\n * const result = validateInternalLink(link, { baseDir: '/project' });\n * if (!result.isValid) {\n *   console.error(`Broken link: ${result.error}`);\n * }\n * ```\n *\n * @public\n */\nexport function validateInternalLink(\n  link: ExtractedLink,\n  options: ValidationOptions\n): ValidationResult {\n  const { baseDir, validExtensions = ['.md', '.mdx'] } = options;\n\n  try {\n    // Resolve the link path\n    let targetPath = resolveLinkPath(link.url, link.file, baseDir);\n\n    // Check if file exists as-is\n    let fileExists = existsSync(targetPath);\n\n    // If not, try adding valid extensions\n    if (!fileExists) {\n      for (const ext of validExtensions) {\n        const pathWithExt = targetPath + ext;\n        if (existsSync(pathWithExt)) {\n          targetPath = pathWithExt;\n          fileExists = true;\n          break;\n        }\n      }\n    }\n\n    // Check if it's a directory with index file\n    if (!fileExists && existsSync(targetPath) && statSync(targetPath).isDirectory()) {\n      for (const ext of validExtensions) {\n        const indexPath = join(targetPath, `index${ext}`);\n        if (existsSync(indexPath)) {\n          targetPath = indexPath;\n          fileExists = true;\n          break;\n        }\n      }\n    }\n\n    if (!fileExists) {\n      return {\n        link,\n        isValid: false,\n        error: `File not found: ${targetPath}`,\n      };\n    }\n\n    // Check anchor if present\n    const anchor = extractAnchor(link.url);\n    if (anchor) {\n      const anchorExists = anchorExistsInFile(targetPath, anchor);\n      if (!anchorExists) {\n        return {\n          link,\n          isValid: false,\n          error: `Anchor #${anchor} not found in ${targetPath}`,\n        };\n      }\n    }\n\n    return {\n      link,\n      isValid: true,\n    };\n  } catch (error) {\n    return {\n      link,\n      isValid: false,\n      error: error instanceof Error ? error.message : 'Unknown error',\n    };\n  }\n}\n\n/**\n * Validate an external link with HTTP request\n *\n * @param link - Link to validate\n * @param options - Validation options\n * @returns Validation result\n *\n * @example\n * ```typescript\n * const result = await validateExternalLink(link, { timeout: 5000 });\n * console.log(`Status: ${result.statusCode}`);\n * ```\n *\n * @public\n */\nexport async function validateExternalLink(\n  link: ExtractedLink,\n  options: ValidationOptions\n): Promise<ValidationResult> {\n  const { timeout = 5000, skipDomains = [] } = options;\n\n  try {\n    // Check if domain should be skipped\n    const url = new URL(link.url);\n    if (skipDomains.some((domain) => url.hostname.includes(domain))) {\n      return {\n        link,\n        isValid: true,\n        statusCode: 0, // Skipped\n      };\n    }\n\n    // Make HEAD request with timeout\n    const controller = new AbortController();\n    const timeoutId = setTimeout(() => controller.abort(), timeout);\n\n    const response = await fetch(link.url, {\n      method: 'HEAD',\n      signal: controller.signal,\n      redirect: 'follow',\n    });\n\n    clearTimeout(timeoutId);\n\n    const isValid = response.ok; // 200-299\n\n    return {\n      link,\n      isValid,\n      statusCode: response.status,\n      redirectUrl: response.redirected ? response.url : undefined,\n      error: isValid ? undefined : `HTTP ${response.status} ${response.statusText}`,\n    };\n  } catch (error) {\n    return {\n      link,\n      isValid: false,\n      statusCode: 0,\n      error: error instanceof Error ? error.message : 'Request failed',\n    };\n  }\n}\n\n/**\n * Validate multiple links with concurrency control\n *\n * @param links - Links to validate\n * @param options - Validation options\n * @returns Array of validation results\n *\n * @example\n * ```typescript\n * const results = await validateLinks(allLinks, {\n *   baseDir: '/project',\n *   checkExternal: true,\n *   concurrency: 10\n * });\n *\n * const broken = results.filter(r => !r.isValid);\n * console.log(`Found ${broken.length} broken links`);\n * ```\n *\n * @public\n */\nexport async function validateLinks(\n  links: ExtractedLink[],\n  options: ValidationOptions\n): Promise<ValidationResult[]> {\n  const { concurrency = 10, checkExternal = false } = options;\n  const results: ValidationResult[] = [];\n\n  // Separate internal and external links\n  const internalLinks = links.filter((l) => !l.isExternal);\n  const externalLinks = links.filter((l) => l.isExternal);\n\n  // Validate internal links (synchronous)\n  for (const link of internalLinks) {\n    results.push(validateInternalLink(link, options));\n  }\n\n  // Validate external links (asynchronous with concurrency)\n  if (checkExternal && externalLinks.length > 0) {\n    const limit = pLimit(concurrency);\n    const externalResults = await Promise.all(\n      externalLinks.map((link) => limit(() => validateExternalLink(link, options)))\n    );\n    results.push(...externalResults);\n  }\n\n  return results;\n}\n","import chalk from 'chalk';\nimport type { ValidationResult } from './link-validator.js';\nimport type { ExtractedLink } from './link-extractor.js';\n\n/**\n * Report statistics\n *\n * @public\n */\nexport interface ReportStats {\n  /** Total links checked */\n  total: number;\n  /** Valid links */\n  valid: number;\n  /** Broken links */\n  broken: number;\n  /** External links checked */\n  external: number;\n  /** Internal links checked */\n  internal: number;\n}\n\n/**\n * Calculate statistics from validation results\n *\n * @param results - Validation results\n * @returns Report statistics\n *\n * @internal\n */\nexport function calculateStats(results: ValidationResult[]): ReportStats {\n  return {\n    total: results.length,\n    valid: results.filter((r) => r.isValid).length,\n    broken: results.filter((r) => !r.isValid).length,\n    external: results.filter((r) => r.link.isExternal).length,\n    internal: results.filter((r) => !r.link.isExternal).length,\n  };\n}\n\n/**\n * Group validation results by error type\n *\n * @param results - Validation results\n * @returns Grouped results\n *\n * @internal\n */\nexport function groupByErrorType(results: ValidationResult[]): {\n  notFound: ValidationResult[];\n  brokenAnchor: ValidationResult[];\n  externalError: ValidationResult[];\n  timeout: ValidationResult[];\n} {\n  const broken = results.filter((r) => !r.isValid);\n\n  return {\n    notFound: broken.filter((r) => r.error?.includes('not found')),\n    brokenAnchor: broken.filter((r) => r.error?.includes('Anchor')),\n    externalError: broken.filter((r) => r.link.isExternal && r.statusCode && r.statusCode >= 400),\n    timeout: broken.filter((r) => r.error?.includes('timeout') || r.error?.includes('aborted')),\n  };\n}\n\n/**\n * Format a link location for display\n *\n * @param link - Link to format\n * @returns Formatted string\n *\n * @example\n * ```typescript\n * formatLinkLocation(link);\n * // Returns: \"docs/guide.md:42\"\n * ```\n *\n * @internal\n */\nexport function formatLinkLocation(link: ExtractedLink): string {\n  return `${link.file}:${link.line}`;\n}\n\n/**\n * Print validation results to console\n *\n * @param results - Validation results\n * @param options - Output options\n *\n * @example\n * ```typescript\n * printResults(results, { quiet: false, verbose: true });\n * ```\n *\n * @public\n */\nexport function printResults(\n  results: ValidationResult[],\n  options: {\n    quiet?: boolean;\n    verbose?: boolean;\n    json?: boolean;\n  } = {}\n): void {\n  const { quiet = false, verbose = false, json = false } = options;\n\n  // JSON output\n  if (json) {\n    console.log(JSON.stringify(results, null, 2));\n    return;\n  }\n\n  const stats = calculateStats(results);\n  const grouped = groupByErrorType(results);\n\n  // Quiet mode - only show errors\n  if (quiet) {\n    const broken = results.filter((r) => !r.isValid);\n    broken.forEach((result) => {\n      console.error(`${formatLinkLocation(result.link)} - ${result.link.url} - ${result.error}`);\n    });\n    return;\n  }\n\n  // Print header\n  console.log(chalk.bold('\\n🔍 Link Validation Results\\n'));\n\n  // Print broken links by category\n  if (grouped.notFound.length > 0) {\n    console.log(chalk.red.bold(`\\n❌ Files Not Found (${grouped.notFound.length}):\\n`));\n    grouped.notFound.forEach((result) => {\n      console.log(\n        `  ${chalk.gray(formatLinkLocation(result.link))} ${chalk.yellow(result.link.url)}`\n      );\n      console.log(`    ${chalk.red(result.error)}`);\n    });\n  }\n\n  if (grouped.brokenAnchor.length > 0) {\n    console.log(chalk.red.bold(`\\n❌ Broken Anchors (${grouped.brokenAnchor.length}):\\n`));\n    grouped.brokenAnchor.forEach((result) => {\n      console.log(\n        `  ${chalk.gray(formatLinkLocation(result.link))} ${chalk.yellow(result.link.url)}`\n      );\n      console.log(`    ${chalk.red(result.error)}`);\n    });\n  }\n\n  if (grouped.externalError.length > 0) {\n    console.log(chalk.red.bold(`\\n❌ External Link Errors (${grouped.externalError.length}):\\n`));\n    grouped.externalError.forEach((result) => {\n      console.log(\n        `  ${chalk.gray(formatLinkLocation(result.link))} ${chalk.yellow(result.link.url)}`\n      );\n      console.log(\n        `    ${chalk.red(`HTTP ${result.statusCode}`)} ${result.error ? `- ${result.error}` : ''}`\n      );\n    });\n  }\n\n  if (grouped.timeout.length > 0) {\n    console.log(chalk.yellow.bold(`\\n⚠️  Timeouts (${grouped.timeout.length}):\\n`));\n    grouped.timeout.forEach((result) => {\n      console.log(\n        `  ${chalk.gray(formatLinkLocation(result.link))} ${chalk.yellow(result.link.url)}`\n      );\n      console.log(`    ${chalk.yellow(result.error)}`);\n    });\n  }\n\n  // Print verbose output (all links)\n  if (verbose) {\n    console.log(chalk.green.bold(`\\n✓ Valid Links (${stats.valid}):\\n`));\n    results\n      .filter((r) => r.isValid)\n      .forEach((result) => {\n        console.log(\n          `  ${chalk.gray(formatLinkLocation(result.link))} ${chalk.green('✓')} ${result.link.url}`\n        );\n      });\n  }\n\n  // Print summary\n  console.log(chalk.bold('\\n📊 Summary:\\n'));\n  console.log(`  Total links:     ${chalk.cyan(stats.total.toString())}`);\n  console.log(`  Valid:           ${chalk.green(stats.valid.toString())}`);\n  console.log(\n    `  Broken:          ${stats.broken > 0 ? chalk.red(stats.broken.toString()) : chalk.green('0')}`\n  );\n  console.log(`  Internal:        ${chalk.cyan(stats.internal.toString())}`);\n  console.log(`  External:        ${chalk.cyan(stats.external.toString())}`);\n\n  // Success or failure message\n  if (stats.broken === 0) {\n    console.log(chalk.green.bold('\\n✨ All links are valid!\\n'));\n  } else {\n    console.log(chalk.red.bold(`\\n💔 Found ${stats.broken} broken link(s)\\n`));\n  }\n}\n\n/**\n * Print progress update\n *\n * @param message - Progress message\n * @param current - Current item number\n * @param total - Total items\n *\n * @public\n */\nexport function printProgress(message: string, current: number, total: number): void {\n  const percentage = Math.round((current / total) * 100);\n  const bar = '█'.repeat(Math.floor(percentage / 5));\n  const empty = '░'.repeat(20 - bar.length);\n\n  process.stdout.write(`\\r${message} [${bar}${empty}] ${percentage}% (${current}/${total})`);\n\n  if (current === total) {\n    process.stdout.write('\\n');\n  }\n}\n","import { existsSync, readFileSync } from 'fs';\nimport { resolve } from 'path';\nimport { createLogger } from '@goobits/docs-engine/utils';\n\nconst logger = createLogger('cli-config');\n\n/**\n * Link checker configuration\n *\n * @public\n */\nexport interface LinkCheckerConfig {\n  /** Base directory for resolving links */\n  baseDir?: string;\n  /** Glob patterns to include */\n  include?: string[];\n  /** Glob patterns to exclude */\n  exclude?: string[];\n  /** Validate external links */\n  checkExternal?: boolean;\n  /** External link timeout (ms) */\n  timeout?: number;\n  /** Maximum concurrent requests */\n  concurrency?: number;\n  /** Domains to skip validation */\n  skipDomains?: string[];\n  /** Valid file extensions */\n  validExtensions?: string[];\n}\n\n/**\n * Default configuration\n *\n * @public\n */\nexport const defaultConfig: Required<LinkCheckerConfig> = {\n  baseDir: process.cwd(),\n  include: ['**/*.md', '**/*.mdx'],\n  exclude: ['**/node_modules/**', '**/dist/**', '**/.git/**'],\n  checkExternal: false,\n  timeout: 5000,\n  concurrency: 10,\n  skipDomains: ['localhost', '127.0.0.1', 'example.com'],\n  validExtensions: ['.md', '.mdx'],\n};\n\n/**\n * Load configuration from file\n *\n * Supports:\n * - `.linkcheckerrc.json`\n * - `.linkcheckerrc`\n * - `linkchecker.config.json`\n *\n * @param cwd - Current working directory\n * @returns Loaded configuration or undefined\n *\n * @example\n * ```typescript\n * const config = loadConfig('/project');\n * if (config) {\n *   console.log('Using config:', config);\n * }\n * ```\n *\n * @public\n */\nexport function loadConfig(cwd: string = process.cwd()): LinkCheckerConfig | undefined {\n  const configFiles = [\n    '.linkcheckerrc.json',\n    '.linkcheckerrc',\n    'linkchecker.config.json',\n    'linkchecker.config.js',\n  ];\n\n  for (const configFile of configFiles) {\n    const configPath = resolve(cwd, configFile);\n\n    if (existsSync(configPath)) {\n      try {\n        const content = readFileSync(configPath, 'utf-8');\n        return JSON.parse(content) as LinkCheckerConfig;\n      } catch (error) {\n        logger.error({ error, configPath }, 'Error loading config file');\n      }\n    }\n  }\n\n  return undefined;\n}\n\n/**\n * Merge configuration with defaults\n *\n * @param config - User configuration\n * @returns Merged configuration\n *\n * @example\n * ```typescript\n * const config = mergeConfig({ checkExternal: true });\n * // Returns: { ...defaults, checkExternal: true }\n * ```\n *\n * @public\n */\nexport function mergeConfig(config: LinkCheckerConfig = {}): Required<LinkCheckerConfig> {\n  return {\n    ...defaultConfig,\n    ...config,\n    // Deep merge arrays\n    include: config.include || defaultConfig.include,\n    exclude: config.exclude || defaultConfig.exclude,\n    skipDomains: [...defaultConfig.skipDomains, ...(config.skipDomains || [])],\n    validExtensions: [...defaultConfig.validExtensions, ...(config.validExtensions || [])],\n  };\n}\n","/**\n * Documentation Versioning Utilities\n *\n * Manages multiple versions of documentation with version-specific\n * navigation, search, and routing.\n */\n\nimport { promises as fs } from 'fs';\nimport path from 'path';\n\n/**\n * Version metadata\n */\nexport interface VersionMetadata {\n  version: string;\n  label?: 'latest' | 'stable' | 'legacy' | 'deprecated';\n  releaseDate?: string;\n  deprecationDate?: string;\n  message?: string;\n}\n\n/**\n * Versions configuration file\n */\nexport interface VersionsConfig {\n  currentVersion: string;\n  versions: VersionMetadata[];\n}\n\n/**\n * Create a new documentation version\n *\n * Copies current docs to versioned_docs/version-X and updates versions.json\n *\n * @public\n */\nexport async function createVersion(version: string, docsDir: string): Promise<void> {\n  const versionedDocsDir = path.join(docsDir, 'versioned_docs');\n  const currentDocsDir = path.join(docsDir, 'current');\n  const versionDir = path.join(versionedDocsDir, `version-${version}`);\n\n  // Ensure versioned_docs directory exists\n  await fs.mkdir(versionedDocsDir, { recursive: true });\n\n  // Copy current docs to versioned directory\n  const sourceDir = await fs\n    .access(currentDocsDir)\n    .then(() => currentDocsDir)\n    .catch(() => docsDir);\n  await copyDirectory(sourceDir, versionDir);\n\n  // Update versions.json\n  const versionsFile = path.join(docsDir, 'versions.json');\n  let config: VersionsConfig;\n\n  try {\n    const content = await fs.readFile(versionsFile, 'utf-8');\n    config = JSON.parse(content);\n  } catch {\n    // Create new versions config\n    config = {\n      currentVersion: version,\n      versions: [],\n    };\n  }\n\n  // Add new version\n  config.versions.unshift({\n    version,\n    label: 'latest',\n    releaseDate: new Date().toISOString(),\n  });\n\n  // Update previous latest\n  if (config.versions.length > 1) {\n    const previousLatest = config.versions[1];\n    if (previousLatest.label === 'latest') {\n      previousLatest.label = 'stable';\n    }\n  }\n\n  config.currentVersion = version;\n\n  // Save versions.json\n  await fs.writeFile(versionsFile, JSON.stringify(config, null, 2));\n}\n\n/**\n * List all documentation versions\n *\n * @public\n */\nexport async function listVersions(docsDir: string): Promise<VersionMetadata[]> {\n  const versionsFile = path.join(docsDir, 'versions.json');\n\n  try {\n    const content = await fs.readFile(versionsFile, 'utf-8');\n    const config: VersionsConfig = JSON.parse(content);\n    return config.versions;\n  } catch {\n    return [];\n  }\n}\n\n/**\n * Delete a documentation version\n *\n * @public\n */\nexport async function deleteVersion(version: string, docsDir: string): Promise<void> {\n  const versionedDocsDir = path.join(docsDir, 'versioned_docs');\n  const versionDir = path.join(versionedDocsDir, `version-${version}`);\n\n  // Remove version directory\n  await fs.rm(versionDir, { recursive: true, force: true });\n\n  // Update versions.json\n  const versionsFile = path.join(docsDir, 'versions.json');\n  const content = await fs.readFile(versionsFile, 'utf-8');\n  const config: VersionsConfig = JSON.parse(content);\n\n  config.versions = config.versions.filter((v) => v.version !== version);\n\n  // Update current version if deleted\n  if (config.currentVersion === version && config.versions.length > 0) {\n    config.currentVersion = config.versions[0].version;\n  }\n\n  await fs.writeFile(versionsFile, JSON.stringify(config, null, 2));\n}\n\n/**\n * Copy directory recursively\n */\nasync function copyDirectory(src: string, dest: string): Promise<void> {\n  await fs.mkdir(dest, { recursive: true });\n\n  const entries = await fs.readdir(src, { withFileTypes: true });\n\n  for (const entry of entries) {\n    const srcPath = path.join(src, entry.name);\n    const destPath = path.join(dest, entry.name);\n\n    if (entry.isDirectory()) {\n      await copyDirectory(srcPath, destPath);\n    } else {\n      await fs.copyFile(srcPath, destPath);\n    }\n  }\n}\n\n/**\n * Get version configuration\n *\n * @public\n */\nexport async function getVersionConfig(docsDir: string): Promise<VersionsConfig | null> {\n  const versionsFile = path.join(docsDir, 'versions.json');\n\n  try {\n    const content = await fs.readFile(versionsFile, 'utf-8');\n    return JSON.parse(content);\n  } catch {\n    return null;\n  }\n}\n","/**\n * API documentation generator CLI\n */\n\nimport { writeFileSync, mkdirSync, existsSync } from 'fs';\nimport path from 'path';\nimport { parseApi, generateApiDocFile, generateIndexFile } from '@goobits/docs-engine/server';\nimport type { MarkdownGeneratorConfig } from '@goobits/docs-engine/server';\n\n/**\n * Configuration for API documentation generation\n */\nexport interface ApiGeneratorConfig {\n  entryPoints: string[];\n  outputDir: string;\n  tsConfigPath?: string;\n  exclude?: string[];\n  markdownConfig?: MarkdownGeneratorConfig;\n  generateIndex?: boolean;\n}\n\n/**\n * Generate API documentation from TypeScript files\n */\nexport async function generateApiDocs(config: ApiGeneratorConfig): Promise<void> {\n  // Parse TypeScript files\n  const parsedFiles = parseApi({\n    entryPoints: config.entryPoints,\n    tsConfigPath: config.tsConfigPath,\n    exclude: config.exclude,\n  });\n\n  if (parsedFiles.length === 0) {\n    throw new Error('No API items found in the specified entry points');\n  }\n\n  // Ensure output directory exists\n  if (!existsSync(config.outputDir)) {\n    mkdirSync(config.outputDir, { recursive: true });\n  }\n\n  const generatedFiles: Array<{ fileName: string; items: unknown[] }> = [];\n\n  // Generate markdown for each file\n  for (const parsedFile of parsedFiles) {\n    const { content, fileName } = generateApiDocFile(parsedFile, config.markdownConfig);\n\n    const outputPath = path.join(config.outputDir, fileName);\n    writeFileSync(outputPath, content, 'utf-8');\n\n    generatedFiles.push({\n      fileName,\n      items: parsedFile.items,\n    });\n  }\n\n  // Generate index file\n  if (config.generateIndex !== false) {\n    const indexContent = generateIndexFile(generatedFiles);\n    const indexPath = path.join(config.outputDir, 'index.md');\n    writeFileSync(indexPath, indexContent, 'utf-8');\n  }\n}\n","/**\n * Symbol Map Watcher\n *\n * Watches TypeScript files and automatically regenerates symbol map\n * when changes are detected.\n *\n * @module\n */\n\nimport { createSymbolMapGenerator } from '@goobits/docs-engine/server';\nimport type { SymbolMapGeneratorConfig } from '@goobits/docs-engine/server';\n\nexport interface WatchOptions {\n  /** Debounce delay in milliseconds (default: 500) */\n  debounce?: number;\n  /** Callback when symbol map is updated */\n  onChange?: (stats: { duration: number; symbolCount: number }) => void;\n  /** Show verbose output */\n  verbose?: boolean;\n}\n\n/**\n * Watch TypeScript files and regenerate symbol map on changes\n *\n * @param config - Symbol map generator configuration\n * @param options - Watch options\n * @returns Promise that resolves with watcher instance\n *\n * @example\n * ```typescript\n * const watcher = await watchSymbols({\n *   sourcePatterns: ['src/**\\/*.ts'],\n *   outputPath: 'docs/symbol-map.json'\n * }, {\n *   debounce: 500,\n *   onChange: (stats) => console.log(`Updated: ${stats.symbolCount} symbols`)\n * });\n *\n * // Stop watching\n * await watcher.close();\n * ```\n *\n * @public\n */\nexport async function watchSymbols(\n  config: SymbolMapGeneratorConfig,\n  options: WatchOptions = {}\n): Promise<{ close: () => Promise<void> }> {\n  const { debounce = 500, onChange, verbose = false } = options;\n\n  if (verbose) {\n    console.log('🚀 Starting TypeScript file watcher...');\n    console.log(`   Source patterns: ${config.sourcePatterns.join(', ')}`);\n    console.log(`   Output: ${config.outputPath}`);\n  }\n\n  const generator = createSymbolMapGenerator(config);\n\n  // Start watching\n  const watcher = await generator.watch({\n    debounce,\n    onChange: (stats) => {\n      if (onChange) {\n        onChange(stats);\n      } else if (verbose) {\n        console.log(\n          `✅ Symbol map updated (${(stats.duration / 1000).toFixed(1)}s, ${stats.symbolCount} symbols)`\n        );\n      }\n    },\n  });\n\n  if (verbose) {\n    console.log('\\n👀 Watching TypeScript files for changes...');\n    console.log('   Press Ctrl+C to stop\\n');\n  }\n\n  return watcher;\n}\n","/**\n * Symbol Map Benchmarker\n *\n * Benchmarks symbol map generation performance with different cache scenarios.\n *\n * @module\n */\n\nimport { createSymbolMapGenerator } from '@goobits/docs-engine/server';\nimport type { SymbolMapGeneratorConfig } from '@goobits/docs-engine/server';\n\nexport interface BenchmarkResults {\n  /** Cold run time (no cache) in milliseconds */\n  cold: number;\n  /** Warm run time (with cache, no changes) in milliseconds */\n  warm: number;\n  /** Warm run time (with cache, 1 file changed) in milliseconds */\n  warmWithChange: number;\n  /** Performance improvement percentage */\n  improvement: number;\n  /** Cache file size in bytes */\n  cacheSize: number;\n  /** Number of symbols generated */\n  symbolCount: number;\n}\n\n/**\n * Run benchmark for symbol map generation\n *\n * Tests performance in three scenarios:\n * 1. Cold run (no cache)\n * 2. Warm run (with cache, no changes)\n * 3. Warm run (with cache, 1 file changed)\n *\n * @param config - Symbol map generator configuration\n * @returns Promise that resolves with benchmark results\n *\n * @example\n * ```typescript\n * const results = await benchmarkSymbols({\n *   sourcePatterns: ['src/**\\/*.ts'],\n *   outputPath: 'docs/symbol-map.json'\n * });\n *\n * console.log(`Cold: ${results.cold}ms`);\n * console.log(`Warm: ${results.warm}ms`);\n * console.log(`Improvement: ${results.improvement}%`);\n * ```\n *\n * @public\n */\nexport async function benchmarkSymbols(\n  config: SymbolMapGeneratorConfig\n): Promise<BenchmarkResults> {\n  const generator = createSymbolMapGenerator(config);\n  return await generator.benchmark();\n}\n\n/**\n * Format and print benchmark results\n *\n * @param results - Benchmark results\n *\n * @public\n */\nexport function printBenchmarkResults(results: BenchmarkResults): void {\n  console.log('\\n' + '='.repeat(50));\n  console.log('📈 Benchmark Results:\\n');\n  console.log(`Cold run:             ${results.cold}ms (${(results.cold / 1000).toFixed(2)}s)`);\n  console.log(`Warm run (no change): ${results.warm}ms (${(results.warm / 1000).toFixed(2)}s)`);\n  console.log(\n    `Warm run (1 change):  ${results.warmWithChange}ms (${(results.warmWithChange / 1000).toFixed(2)}s)`\n  );\n  console.log(`\\nImprovement:          ${results.improvement.toFixed(1)}% faster`);\n  console.log(\n    `Target achieved:      ${results.warm < 1000 ? '✅ Yes' : '❌ No'} (target: <1000ms)`\n  );\n  console.log(`\\n💾 Cache file size:    ${(results.cacheSize / 1024).toFixed(2)} KB`);\n  console.log(`🔤 Symbol count:       ${results.symbolCount}`);\n  console.log('='.repeat(50) + '\\n');\n}\n"],"mappings":"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","names":["chalk","path","readFileSync","dirname","join","readFileSync","existsSync","readFileSync","resolve","existsSync","path","createSymbolMapGenerator","__filename","__dirname","dirname","join","readFileSync","path","chalk","spinner","createSymbolMapGenerator"]}

package/package.json

@@ -0,0 +1,46 @@
+{
+  "name": "@goobits/docs-engine-cli",
+  "version": "2.0.0",
+  "description": "CLI tools for docs-engine - link checking, validation, versioning, and maintenance",
+  "type": "module",
+  "bin": {
+    "docs-engine": "./dist/index.js"
+  },
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "prepublishOnly": "pnpm run build"
+  },
+  "dependencies": {
+    "@goobits/docs-engine": "workspace:*",
+    "commander": "^14.0.2",
+    "chalk": "^5.6.2",
+    "ora": "^9.1.0",
+    "glob": "^13.0.0",
+    "unified": "^11.0.5",
+    "remark-parse": "^11.0.0",
+    "remark-mdx": "^3.1.1",
+    "unist-util-visit": "^5.1.0",
+    "p-limit": "^7.2.0"
+  },
+  "devDependencies": {
+    "@types/node": "^25.0.10",
+    "tsup": "^8.5.1",
+    "typescript": "^5.9.3"
+  },
+  "keywords": [
+    "documentation",
+    "link-checker",
+    "versioning",
+    "markdown",
+    "cli",
+    "validation"
+  ],
+  "license": "MIT",
+  "author": "GooBits"
+}