docmk 1.0.5 → 1.0.7

package/dist/index.js

@@ -306,14 +306,15 @@ import vue from "@vitejs/plugin-vue";
 import path2 from "path";
 import { fileURLToPath } from "url";
 var __dirname = path2.dirname(fileURLToPath(import.meta.url));
-var packageRoot = path2.resolve(__dirname, "../..");
+var packageRoot = path2.resolve(__dirname, "..");
 async function createViteDevServer(options) {
   let currentConfig = options.config;
   const server = await createServer({
     root: path2.resolve(packageRoot, "src/client"),
     server: {
       port: options.port,
-      host: "localhost"
+      host: true
+      // Listen on all addresses
     },
     publicDir: false,
     // Disable public dir in dev mode
@@ -323,22 +324,20 @@ async function createViteDevServer(options) {
       {
         name: "docgen-dev",
         configureServer(server2) {
-          server2.middlewares.use("/api/config", (req, res, next) => {
-            if (req.method === "GET") {
-              res.setHeader("Content-Type", "application/json");
-              res.end(JSON.stringify(currentConfig));
-            } else {
-              next();
-            }
-          });
           return () => {
+            server2.middlewares.use("/api/config", (req, res, next) => {
+              if (req.method === "GET") {
+                res.setHeader("Content-Type", "application/json");
+                res.end(JSON.stringify(currentConfig));
+              } else {
+                next();
+              }
+            });
             server2.middlewares.use((req, res, next) => {
-              if (req.url?.startsWith("/api/") || req.url?.startsWith("/@") || req.url?.includes(".html")) {
+              if (req.url?.startsWith("/api/") || req.url?.startsWith("/@") || req.url?.includes(".")) {
                 return next();
               }
-              if (req.url && !req.url.includes(".")) {
-                req.url = "/index.html";
-              }
+              req.url = "/index.html";
               next();
             });
           };
@@ -386,7 +385,8 @@ async function createViteDevServer(options) {
     }
   });
   await server.listen();
-  const actualPort = server.config.server.port;
+  const address = server.httpServer.address();
+  const actualPort = typeof address === "object" && address ? address.port : options.port;
   const originalClose = server.close.bind(server);
   server.close = async () => {
     await watcher?.close();
@@ -398,10 +398,195 @@ async function createViteDevServer(options) {
 // src/cli/commands/dev.ts
 init_scanner();
 init_parser();
+
+// src/utils/port.ts
+var UNSAFE_PORTS = /* @__PURE__ */ new Set([
+  1,
+  // tcpmux
+  7,
+  // echo
+  9,
+  // discard
+  11,
+  // systat
+  13,
+  // daytime
+  15,
+  // netstat
+  17,
+  // qotd
+  19,
+  // chargen
+  20,
+  // ftp data
+  21,
+  // ftp access
+  22,
+  // ssh
+  23,
+  // telnet
+  25,
+  // smtp
+  37,
+  // time
+  42,
+  // name
+  43,
+  // nicname
+  53,
+  // domain
+  69,
+  // tftp
+  77,
+  // priv-rjs
+  79,
+  // finger
+  87,
+  // ttylink
+  95,
+  // supdup
+  101,
+  // hostriame
+  102,
+  // iso-tsap
+  103,
+  // gppitnp
+  104,
+  // acr-nema
+  109,
+  // pop2
+  110,
+  // pop3
+  111,
+  // sunrpc
+  113,
+  // auth
+  115,
+  // sftp
+  117,
+  // uucp-path
+  119,
+  // nntp
+  123,
+  // NTP
+  135,
+  // loc-srv / epmap
+  137,
+  // netbios
+  139,
+  // netbios
+  143,
+  // imap2
+  161,
+  // snmp
+  179,
+  // BGP
+  389,
+  // ldap
+  427,
+  // SLP (Also used by determine_refmode)
+  465,
+  // smtp+ssl
+  512,
+  // print / exec
+  513,
+  // login
+  514,
+  // shell
+  515,
+  // printer
+  526,
+  // tempo
+  530,
+  // courier
+  531,
+  // chat
+  532,
+  // netnews
+  540,
+  // uucp
+  548,
+  // AFP (Apple Filing Protocol)
+  554,
+  // rtsp
+  556,
+  // remotefs
+  563,
+  // nntp+ssl
+  587,
+  // smtp (rfc6409)
+  601,
+  // syslog-conn (rfc3195)
+  636,
+  // ldap+ssl
+  989,
+  // ftps-data
+  990,
+  // ftps
+  993,
+  // ldap+ssl
+  995,
+  // pop3+ssl
+  1719,
+  // h323gatestat
+  1720,
+  // h323hostcall
+  1723,
+  // pptp
+  2049,
+  // nfs
+  3659,
+  // apple-sasl / PasswordServer
+  4045,
+  // lockd
+  5060,
+  // sip
+  5061,
+  // sips
+  6e3,
+  // X11
+  6566,
+  // sane-port
+  6665,
+  // Alternate IRC [Apple addition]
+  6666,
+  // Alternate IRC [Apple addition]
+  6667,
+  // Standard IRC [Apple addition]
+  6668,
+  // Alternate IRC [Apple addition]
+  6669,
+  // Alternate IRC [Apple addition]
+  6697,
+  // IRC + TLS
+  10080
+  // Amanda
+]);
+function isPortSafe(port) {
+  return !UNSAFE_PORTS.has(port);
+}
+function validatePort(port) {
+  if (isPortSafe(port)) {
+    return { port, wasUnsafe: false };
+  }
+  const safePort = findNextSafePort(port);
+  console.warn(`\u26A0\uFE0F  \u7AEF\u53E3 ${port} \u88AB\u6D4F\u89C8\u5668\u89C6\u4E3A\u4E0D\u5B89\u5168\u7AEF\u53E3\uFF0C\u5DF2\u81EA\u52A8\u5207\u6362\u5230 ${safePort}`);
+  console.warn(`   \u4E0D\u5B89\u5168\u7AEF\u53E3\u4F1A\u88AB\u6D4F\u89C8\u5668\u963B\u6B62\u8BBF\u95EE (ERR_UNSAFE_PORT)`);
+  return { port: safePort, wasUnsafe: true };
+}
+function findNextSafePort(startPort) {
+  let port = startPort;
+  while (!isPortSafe(port) && port < 65535) {
+    port++;
+  }
+  return port < 65535 ? port : 3e3;
+}
+
+// src/cli/commands/dev.ts
 async function devCommand(options) {
   console.log("\u{1F680} Starting DocGen development server...");
   const sourceDir = path3.resolve(process.cwd(), options.dir);
-  const port = parseInt(options.port, 10);
+  const { port } = validatePort(parseInt(options.port, 10));
   try {
     console.log(`\u{1F4C1} Scanning source directory: ${sourceDir}`);
     const directories = await scanSkillsDirectory(sourceDir);
@@ -601,7 +786,7 @@ import { createServer as createServer2 } from "http";
 async function previewCommand(options) {
   console.log("\u{1F440} Starting DocGen preview server...");
   const outputDir = path6.resolve(process.cwd(), options.output);
-  const port = parseInt(options.port, 10);
+  const { port } = validatePort(parseInt(options.port, 10));
   try {
     try {
       await fs3.access(outputDir);
@@ -639,10 +824,8 @@ async function previewCommand(options) {
 
 // src/cli/index.ts
 var program = new Command();
-program.name("docmk").description("CLI tool for generating documentation from any directory").version("1.0.0").argument("[directory]", "Source directory path (starts dev server)", "./docs").option("-p, --port <port>", "Port to run dev server on", "3000").action((directory, options) => {
-  devCommand({ dir: directory, port: options.port });
-});
-program.command("dev").description("Start development server").option("-p, --port <port>", "Port to run dev server on", "3000").option("-d, --dir <directory>", "Source directory path", "./docs").action(devCommand);
+program.name("docmk").description("CLI tool for generating documentation from any directory").version("1.0.0");
+program.command("dev", { isDefault: true }).description("Start development server").option("-p, --port <port>", "Port to run dev server on", "3000").option("-d, --dir <directory>", "Source directory path", "./docs").action(devCommand);
 program.command("build").description("Build static documentation site").option("-d, --dir <directory>", "Source directory path", "./docs").option("-o, --output <directory>", "Output directory", "dist").action(buildCommand);
 program.command("preview").description("Preview built documentation site").option("-p, --port <port>", "Port to run preview server on", "4173").option("-o, --output <directory>", "Built site directory", "dist").action(previewCommand);
 program.parse();

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/scanner/index.ts","../src/parser/index.ts","../src/cli/index.ts","../src/cli/commands/dev.ts","../src/builder/vite-dev.ts","../src/cli/commands/build.ts","../src/builder/index.ts","../src/cli/commands/preview.ts"],"sourcesContent":["import fs from 'fs/promises'\nimport path from 'path'\nimport { SkillDirectory, SkillFile } from '../types/index.js'\n\nexport async function scanSkillsDirectory(sourceDir: string): Promise<SkillDirectory[]> {\n  try {\n    await fs.access(sourceDir)\n  } catch {\n    throw new Error(`Source directory not found: ${sourceDir}`)\n  }\n\n  const entries = await fs.readdir(sourceDir, { withFileTypes: true })\n  const directories: SkillDirectory[] = []\n\n  for (const entry of entries) {\n    if (entry.isDirectory()) {\n      const dirPath = path.join(sourceDir, entry.name)\n      const skillDirectory = await scanDirectory(dirPath, entry.name)\n      directories.push(skillDirectory)\n    }\n  }\n\n  return directories\n}\n\nasync function scanDirectory(dirPath: string, name: string): Promise<SkillDirectory> {\n  const entries = await fs.readdir(dirPath, { withFileTypes: true })\n  const children: (SkillDirectory | SkillFile)[] = []\n  let skillFile: SkillFile | undefined\n\n  for (const entry of entries) {\n    const entryPath = path.join(dirPath, entry.name)\n\n    if (entry.isDirectory()) {\n      const subDir = await scanDirectory(entryPath, entry.name)\n      children.push(subDir)\n    } else if (entry.isFile() && entry.name.endsWith('.md')) {\n      const file = await parseMarkdownFile(entryPath, entry.name)\n      \n      if (entry.name === 'SKILL.md') {\n        skillFile = file\n      } else {\n        children.push(file)\n      }\n    }\n  }\n\n  return {\n    path: dirPath,\n    name,\n    children,\n    skillFile\n  }\n}\n\nasync function parseMarkdownFile(filePath: string, fileName: string): Promise<SkillFile> {\n  const content = await fs.readFile(filePath, 'utf-8')\n  const stats = await fs.stat(filePath)\n\n  // Basic frontmatter extraction\n  const frontmatterMatch = content.match(/^---\\r?\\n([\\s\\S]*?)\\r?\\n---\\r?\\n/)\n  const frontmatter: Record<string, any> = {}\n  let markdownContent = content\n\n  if (frontmatterMatch) {\n    // Remove frontmatter from content\n    markdownContent = content.slice(frontmatterMatch[0].length)\n    \n    // Parse frontmatter key-value pairs\n    const fmLines = frontmatterMatch[1].split(/\\r?\\n/)\n    for (const line of fmLines) {\n      const colonIndex = line.indexOf(':')\n      if (colonIndex > 0) {\n        const key = line.slice(0, colonIndex).trim()\n        const value = line.slice(colonIndex + 1).trim().replace(/^[\"']|[\"']$/g, '')\n        if (key && value) {\n          frontmatter[key] = value\n        }\n      }\n    }\n  }\n\n  return {\n    path: filePath,\n    name: fileName,\n    title: frontmatter.title || fileName.replace('.md', ''),\n    description: frontmatter.description,\n    content: markdownContent,\n    frontmatter,\n    lastModified: stats.mtime.getTime()\n  }\n}\n\nexport async function watchSkillsDirectory(\n  sourceDir: string, \n  callback: (directories: SkillDirectory[]) => void\n) {\n  const chokidar = await import('chokidar')\n  \n  const watcher = chokidar.watch(sourceDir, {\n    ignored: /node_modules/,\n    persistent: true,\n    ignoreInitial: true\n  })\n\n  let debounceTimer: NodeJS.Timeout\n\n  const handleChange = () => {\n    clearTimeout(debounceTimer)\n    debounceTimer = setTimeout(async () => {\n      try {\n        const directories = await scanSkillsDirectory(sourceDir)\n        callback(directories)\n      } catch (error) {\n        console.error('Error rescanning source directory:', error)\n      }\n    }, 300)\n  }\n\n  watcher.on('add', handleChange)\n  watcher.on('change', handleChange)\n  watcher.on('unlink', handleChange)\n  watcher.on('addDir', handleChange)\n  watcher.on('unlinkDir', handleChange)\n\n  return watcher\n}","import matter from 'gray-matter'\nimport MarkdownIt from 'markdown-it'\nimport { createHighlighter, Highlighter } from 'shiki'\nimport { SkillDirectory, SkillFile, SiteConfig, DocGenConfig, Navigation } from '../types/index.js'\n\nlet highlighter: Highlighter | null = null\n\nasync function getHighlighter() {\n  if (!highlighter) {\n    highlighter = await createHighlighter({\n      themes: ['github-dark', 'github-light'],\n      langs: ['javascript', 'typescript', 'bash', 'shell', 'json', 'html', 'css', 'vue', 'jsx', 'tsx', 'python', 'markdown', 'yaml', 'sql', 'go', 'rust', 'java', 'c', 'cpp']\n    })\n  }\n  return highlighter\n}\n\nconst md = new MarkdownIt({\n  html: true,\n  linkify: true,\n  typographer: true,\n  highlight: function (str: string, lang: string) {\n    // Synchronous fallback - actual highlighting done in enhanceFileContent\n    return `<pre class=\"shiki-pending\" data-lang=\"${lang || 'text'}\"><code>${md.utils.escapeHtml(str)}</code></pre>`\n  }\n})\n\nexport async function parseSkillsToConfig(\n  directories: SkillDirectory[],\n  siteConfig: SiteConfig\n): Promise<DocGenConfig> {\n  const files: SkillFile[] = []\n  const navigation = await generateNavigation(directories)\n\n  // Collect all files for search indexing\n  collectAllFiles(directories, files)\n\n  // Enhance files with parsed content\n  for (const file of files) {\n    await enhanceFileContent(file)\n  }\n\n  return {\n    siteConfig,\n    navigation,\n    files,\n    directories\n  }\n}\n\nfunction collectAllFiles(items: (SkillDirectory | SkillFile)[], files: SkillFile[]) {\n  for (const item of items) {\n    if ('content' in item) {\n      // It's a SkillFile\n      files.push(item)\n    } else {\n      // It's a SkillDirectory\n      if (item.skillFile) {\n        files.push(item.skillFile)\n      }\n      collectAllFiles(item.children, files)\n    }\n  }\n}\n\nasync function enhanceFileContent(file: SkillFile) {\n  try {\n    let content = file.content\n\n    // Update title and description from frontmatter if available\n    file.title = file.frontmatter.title || file.title\n    file.description = file.frontmatter.description || file.description\n\n    // Remove duplicate h1 if it matches frontmatter title\n    if (file.frontmatter.title) {\n      // Match first h1 heading in content (may have leading whitespace/newlines)\n      const h1Match = content.match(/^\\s*#\\s+(.+)$/m)\n      if (h1Match) {\n        const h1Text = h1Match[1].trim()\n        // If h1 matches title, remove it to avoid duplication\n        if (h1Text === file.frontmatter.title) {\n          content = content.replace(/^\\s*#\\s+.+\\n*/, '')\n        }\n      }\n    }\n\n    // Render markdown to HTML\n    let html = md.render(content)\n    \n    // Apply syntax highlighting with shiki\n    html = await highlightCodeBlocks(html)\n    file.frontmatter.html = html\n\n    // Extract headings for TOC\n    const headings = extractHeadings(content)\n    file.frontmatter.headings = headings\n\n  } catch (error) {\n    console.warn(`Failed to enhance content for ${file.path}:`, error)\n    try {\n      file.frontmatter.html = md.render(file.content)\n    } catch (e) {\n      console.error(`Failed to render markdown for ${file.path}:`, e)\n    }\n  }\n}\n\nasync function highlightCodeBlocks(html: string): Promise<string> {\n  const hl = await getHighlighter()\n  \n  // Find all pending shiki code blocks and highlight them\n  const codeBlockRegex = /<pre class=\"shiki-pending\" data-lang=\"([^\"]*)\"[^>]*><code>([^]*?)<\\/code><\\/pre>/g\n  \n  const matches = [...html.matchAll(codeBlockRegex)]\n  \n  for (const match of matches) {\n    const [fullMatch, lang, escapedCode] = match\n    // Unescape HTML entities\n    const code = escapedCode\n      .replace(/&lt;/g, '<')\n      .replace(/&gt;/g, '>')\n      .replace(/&amp;/g, '&')\n      .replace(/&quot;/g, '\"')\n      .replace(/&#39;/g, \"'\")\n    \n    try {\n      const validLang = hl.getLoadedLanguages().includes(lang) ? lang : 'text'\n      const highlighted = hl.codeToHtml(code, {\n        lang: validLang,\n        theme: 'github-dark'\n      })\n      html = html.replace(fullMatch, highlighted)\n    } catch (e) {\n      // Keep original if highlighting fails\n      console.warn(`Failed to highlight ${lang}:`, e)\n    }\n  }\n  \n  return html\n}\n\nfunction extractHeadings(content: string) {\n  const headings: Array<{ level: number; text: string; anchor: string }> = []\n  const lines = content.split('\\n')\n\n  for (const line of lines) {\n    const match = line.match(/^(#{1,6})\\\\s+(.+)$/)\n    if (match) {\n      const level = match[1].length\n      const text = match[2].trim()\n      const anchor = text.toLowerCase()\n        .replace(/[^\\\\w\\\\s-]/g, '')\n        .replace(/\\\\s+/g, '-')\n        .trim()\n\n      headings.push({ level, text, anchor })\n    }\n  }\n\n  return headings\n}\n\nasync function generateNavigation(directories: SkillDirectory[]): Promise<Navigation[]> {\n  const navigation: Navigation[] = []\n\n  for (const dir of directories) {\n    const navItem: Navigation = {\n      text: dir.skillFile?.title || formatDirName(dir.name),\n      link: dir.skillFile ? getFileRoute(dir.skillFile) : undefined\n    }\n\n    if (dir.children.length > 0) {\n      navItem.children = []\n      \n      for (const child of dir.children) {\n        if ('content' in child) {\n          // It's a file\n          navItem.children.push({\n            text: child.title || formatFileName(child.name),\n            link: getFileRoute(child)\n          })\n        } else {\n          // It's a subdirectory\n          const subNav = await generateNavigation([child])\n          navItem.children.push(...subNav)\n        }\n      }\n    }\n\n    navigation.push(navItem)\n  }\n\n  return navigation\n}\n\nfunction getFileRoute(file: SkillFile): string {\n  // Import the utility function from client utils\n  // For now, use inline implementation\n  const filePath = file.path\n  \n  // Try common patterns\n  const patterns = ['my-docs', 'docs', 'documentation', '.claude/skills']\n  let relativePath = ''\n  \n  for (const pattern of patterns) {\n    const index = filePath.indexOf(pattern)\n    if (index !== -1) {\n      relativePath = filePath.slice(index + pattern.length)\n      break\n    }\n  }\n  \n  if (!relativePath) {\n    // Fallback: use last 2 segments\n    const segments = filePath.split('/').filter(Boolean)\n    if (segments.length >= 2) {\n      relativePath = '/' + segments.slice(-2).join('/')\n    } else {\n      return '/'\n    }\n  }\n  \n  const segments = relativePath.split('/').filter(Boolean)\n  \n  if (segments.length === 0) return '/'\n  \n  // Remove file extension\n  const lastSegment = segments[segments.length - 1]\n  if (lastSegment.endsWith('.md')) {\n    segments[segments.length - 1] = lastSegment.slice(0, -3)\n  }\n  \n  // SKILL.md and README.md should map to parent directory route\n  const finalSegment = segments[segments.length - 1]\n  if (finalSegment === 'SKILL' || finalSegment === 'README') {\n    segments.pop()\n  }\n  \n  return '/' + segments.join('/')\n}\n\nfunction formatDirName(name: string): string {\n  return name.split('-').map(word => \n    word.charAt(0).toUpperCase() + word.slice(1)\n  ).join(' ')\n}\n\nfunction formatFileName(name: string): string {\n  const baseName = name.replace('.md', '')\n  return formatDirName(baseName)\n}\n\nexport { md as markdownRenderer }","#!/usr/bin/env node\n\nimport { Command } from 'commander'\nimport { devCommand } from './commands/dev.js'\nimport { buildCommand } from './commands/build.js'\nimport { previewCommand } from './commands/preview.js'\n\nconst program = new Command()\n\nprogram\n  .name('docmk')\n  .description('CLI tool for generating documentation from any directory')\n  .version('1.0.0')\n  .argument('[directory]', 'Source directory path (starts dev server)', './docs')\n  .option('-p, --port <port>', 'Port to run dev server on', '3000')\n  .action((directory, options) => {\n    // Default action: start dev server\n    devCommand({ dir: directory, port: options.port })\n  })\n\nprogram\n  .command('dev')\n  .description('Start development server')\n  .option('-p, --port <port>', 'Port to run dev server on', '3000')\n  .option('-d, --dir <directory>', 'Source directory path', './docs')\n  .action(devCommand)\n\nprogram\n  .command('build')\n  .description('Build static documentation site')\n  .option('-d, --dir <directory>', 'Source directory path', './docs')\n  .option('-o, --output <directory>', 'Output directory', 'dist')\n  .action(buildCommand)\n\nprogram\n  .command('preview')\n  .description('Preview built documentation site')\n  .option('-p, --port <port>', 'Port to run preview server on', '4173')\n  .option('-o, --output <directory>', 'Built site directory', 'dist')\n  .action(previewCommand)\n\nprogram.parse()","import path from 'path'\nimport { createViteDevServer } from '../../builder/vite-dev.js'\nimport { scanSkillsDirectory } from '../../scanner/index.js'\nimport { parseSkillsToConfig } from '../../parser/index.js'\n\ninterface DevOptions {\n  port: string\n  dir: string\n}\n\nexport async function devCommand(options: DevOptions) {\n  console.log('🚀 Starting DocGen development server...')\n  \n  const sourceDir = path.resolve(process.cwd(), options.dir)\n  const port = parseInt(options.port, 10)\n  \n  try {\n    // Check if source directory exists\n    console.log(`📁 Scanning source directory: ${sourceDir}`)\n    const directories = await scanSkillsDirectory(sourceDir)\n    \n    console.log(`✅ Found ${directories.length} directories`)\n    \n    // Parse to config\n    const config = await parseSkillsToConfig(directories, {\n      title: 'Documentation',\n      description: 'Documentation generated from source directory',\n      baseUrl: '/',\n      skillsDir: sourceDir,\n      outputDir: 'dist'\n    })\n    \n    // Start Vite dev server\n    const { server, actualPort } = await createViteDevServer({\n      port,\n      skillsDir: sourceDir,\n      config\n    })\n\n    console.log(`🎉 Dev server running at http://localhost:${actualPort}`)\n    \n    // Handle graceful shutdown\n    process.on('SIGINT', async () => {\n      console.log('\\\\n👋 Shutting down dev server...')\n      await server.close()\n      process.exit(0)\n    })\n    \n  } catch (error) {\n    console.error('❌ Failed to start dev server:', error)\n    process.exit(1)\n  }\n}","import { createServer, ViteDevServer } from 'vite'\nimport vue from '@vitejs/plugin-vue'\nimport path from 'path'\nimport { fileURLToPath } from 'url'\nimport { DocGenConfig } from '../types/index.js'\nimport { scanSkillsDirectory, watchSkillsDirectory } from '../scanner/index.js'\nimport { parseSkillsToConfig } from '../parser/index.js'\n\n// Get the package root directory (where src/client is located)\nconst __dirname = path.dirname(fileURLToPath(import.meta.url))\nconst packageRoot = path.resolve(__dirname, '../..')\n\ninterface DevServerOptions {\n  port: number\n  skillsDir: string\n  config: DocGenConfig\n}\n\nexport async function createViteDevServer(options: DevServerOptions): Promise<ViteDevServer> {\n  let currentConfig = options.config\n\n  const server = await createServer({\n    root: path.resolve(packageRoot, 'src/client'),\n    server: {\n      port: options.port,\n      host: 'localhost'\n    },\n    publicDir: false, // Disable public dir in dev mode\n    plugins: [\n      vue(),\n      // Custom plugin to inject config and handle API routes\n      {\n        name: 'docgen-dev',\n        configureServer(server) {\n          // API endpoint for configuration\n          server.middlewares.use('/api/config', (req, res, next) => {\n            if (req.method === 'GET') {\n              res.setHeader('Content-Type', 'application/json')\n              res.end(JSON.stringify(currentConfig))\n            } else {\n              next()\n            }\n          })\n\n          // SPA fallback - return index.html for all non-API routes\n          return () => {\n            server.middlewares.use((req, res, next) => {\n              // Skip API routes and vite's own routes\n              if (req.url?.startsWith('/api/') || req.url?.startsWith('/@') || req.url?.includes('.html')) {\n                return next()\n              }\n              // For all other routes, serve index.html for SPA routing\n              if (req.url && !req.url.includes('.')) {\n                req.url = '/index.html'\n              }\n              next()\n            })\n          }\n        },\n        transformIndexHtml: {\n          order: 'pre',\n          handler(html) {\n            // Inject lightweight config placeholder\n            // Full config will be loaded via API to avoid HTML parsing issues\n            const configScript = `\n              <script>\n                // Config will be loaded from /api/config\n                globalThis.__DOCGEN_CONFIG__ = null;\n              </script>\n            `\n            return html.replace('<head>', `<head>${configScript}`)\n          }\n        }\n      }\n    ],\n    resolve: {\n      alias: {\n        '@': path.resolve(packageRoot, 'src/client')\n      }\n    },\n    define: {\n      __DOCGEN_CONFIG__: JSON.stringify(currentConfig)\n    }\n  })\n\n  // Watch skills directory for changes\n  const watcher = await watchSkillsDirectory(options.skillsDir, async (directories) => {\n    console.log('📝 Skills directory changed, updating configuration...')\n    \n    try {\n      currentConfig = await parseSkillsToConfig(directories, currentConfig.siteConfig)\n      \n      // Notify all connected clients to reload\n      server.ws.send({\n        type: 'full-reload'\n      })\n      \n      console.log('✅ Configuration updated')\n    } catch (error) {\n      console.error('❌ Failed to update configuration:', error)\n      \n      // Send error to clients\n      server.ws.send({\n        type: 'error',\n        err: {\n          message: `Failed to update configuration: ${error.message}`,\n          stack: error.stack\n        }\n      })\n    }\n  })\n\n  // Start the server\n  await server.listen()\n\n  // Get actual port (in case requested port was taken)\n  const actualPort = server.config.server.port\n\n  // Extend server with cleanup method\n  const originalClose = server.close.bind(server)\n  server.close = async () => {\n    await watcher?.close()\n    return originalClose()\n  }\n\n  return { server, actualPort }\n}\n\nexport async function createProductionBuild() {\n  // This will be implemented in the builder\n}","import path from 'path'\nimport { buildSite } from '../../builder/index.js'\nimport { scanSkillsDirectory } from '../../scanner/index.js'\nimport { parseSkillsToConfig } from '../../parser/index.js'\n\ninterface BuildOptions {\n  dir: string\n  output: string\n}\n\nexport async function buildCommand(options: BuildOptions) {\n  console.log('🏗️  Building DocGen documentation site...')\n  \n  const sourceDir = path.resolve(process.cwd(), options.dir)\n  const outputDir = path.resolve(process.cwd(), options.output)\n  \n  try {\n    // Scan source directory\n    console.log(`📁 Scanning source directory: ${sourceDir}`)\n    const directories = await scanSkillsDirectory(sourceDir)\n    \n    console.log(`✅ Found ${directories.length} directories`)\n    \n    // Parse to config\n    const config = await parseSkillsToConfig(directories, {\n      title: 'Documentation',\n      description: 'Documentation generated from source directory',\n      baseUrl: '/',\n      skillsDir: sourceDir,\n      outputDir\n    })\n    \n    // Build site\n    console.log(`📦 Building to: ${outputDir}`)\n    await buildSite({\n      input: sourceDir,\n      output: outputDir,\n      mode: 'production'\n    }, config)\n    \n    console.log('✅ Build completed successfully!')\n    console.log(`📂 Built files are in: ${outputDir}`)\n    \n  } catch (error) {\n    console.error('❌ Build failed:', error)\n    process.exit(1)\n  }\n}","import { build } from 'vite'\nimport vue from '@vitejs/plugin-vue'\nimport path from 'path'\nimport { fileURLToPath } from 'url'\nimport fs from 'fs/promises'\nimport { DocGenConfig, BuildOptions } from '../types/index.js'\n\n// Get the package root directory\nconst __dirname = path.dirname(fileURLToPath(import.meta.url))\nconst packageRoot = path.resolve(__dirname, '../..')\n\nexport async function buildSite(options: BuildOptions, config: DocGenConfig) {\n  console.log('🏗️  Building documentation site...')\n\n  // Ensure output directory exists\n  await fs.mkdir(options.output, { recursive: true })\n\n  // Write config to a temporary file for the build process\n  const configPath = path.join(process.cwd(), 'temp-config.json')\n  await fs.writeFile(configPath, JSON.stringify(config, null, 2))\n\n  try {\n    // Build the client application\n    await build({\n      root: path.resolve(packageRoot, 'src/client'),\n      base: config.siteConfig.baseUrl,\n      build: {\n        outDir: options.output,\n        emptyOutDir: true,\n        rollupOptions: {\n          input: {\n            main: path.resolve(packageRoot, 'src/client/index.html')\n          }\n        }\n      },\n      plugins: [\n        vue(),\n        // Plugin to inject config during build\n        {\n          name: 'docgen-build',\n          transformIndexHtml: {\n            order: 'pre',\n            handler(html) {\n              // Encode config as base64 with proper UTF-8 handling\n              const configJson = JSON.stringify(config)\n              // Use encodeURIComponent to handle UTF-8 properly before base64\n              const utf8Encoded = unescape(encodeURIComponent(configJson))\n              const configBase64 = Buffer.from(utf8Encoded, 'binary').toString('base64')\n              // Decode: atob -> decodeURIComponent(escape()) to restore UTF-8\n              const configScript = `<script>globalThis.__DOCGEN_CONFIG__=JSON.parse(decodeURIComponent(escape(atob(\"${configBase64}\"))));</script>`\n              return html.replace('</head>', `${configScript}\\n</head>`)\n            }\n          }\n        }\n      ],\n      resolve: {\n        alias: {\n          '@': path.resolve(packageRoot, 'src/client')\n        }\n      },\n      define: {\n        __DOCGEN_CONFIG__: JSON.stringify(config)\n      }\n    })\n    \n    // Generate additional static files\n    await generateSitemap(options.output, config)\n    await generateRobotsTxt(options.output, config)\n    await copyAssets(options.output)\n    \n    console.log('✅ Build completed successfully!')\n    \n  } finally {\n    // Clean up temporary config file\n    try {\n      await fs.unlink(configPath)\n    } catch {\n      // Ignore if file doesn't exist\n    }\n  }\n}\n\nasync function generateSitemap(outputDir: string, config: DocGenConfig) {\n  console.log('📄 Generating sitemap...')\n  \n  const baseUrl = config.siteConfig.baseUrl.replace(/\\/$/, '')\n  const urls: string[] = []\n  \n  // Add home page\n  urls.push(`${baseUrl}/`)\n  \n  // Add all skill pages\n  for (const file of config.files) {\n    const route = getFileRoute(file.path, config.siteConfig.skillsDir)\n    if (route !== '/') {\n      urls.push(`${baseUrl}${route}`)\n    }\n  }\n  \n  const sitemap = `<?xml version=\"1.0\" encoding=\"UTF-8\"?>\n<urlset xmlns=\"http://www.sitemaps.org/schemas/sitemap/0.9\">\n${urls.map(url => `  <url>\n    <loc>${url}</loc>\n    <lastmod>${new Date().toISOString().split('T')[0]}</lastmod>\n    <changefreq>weekly</changefreq>\n    <priority>0.8</priority>\n  </url>`).join('\\\\n')}\n</urlset>`\n  \n  await fs.writeFile(path.join(outputDir, 'sitemap.xml'), sitemap)\n}\n\nasync function generateRobotsTxt(outputDir: string, config: DocGenConfig) {\n  console.log('🤖 Generating robots.txt...')\n  \n  const baseUrl = config.siteConfig.baseUrl.replace(/\\/$/, '')\n  const robotsTxt = `User-agent: *\nAllow: /\n\nSitemap: ${baseUrl}/sitemap.xml`\n  \n  await fs.writeFile(path.join(outputDir, 'robots.txt'), robotsTxt)\n}\n\nasync function copyAssets(outputDir: string) {\n  console.log('📁 Copying static assets...')\n  \n  // Create a simple favicon if it doesn't exist\n  const faviconPath = path.join(outputDir, 'favicon.ico')\n  \n  try {\n    await fs.access(faviconPath)\n  } catch {\n    // Create a simple SVG favicon\n    const faviconSvg = `<svg xmlns=\"http://www.w3.org/2000/svg\" viewBox=\"0 0 32 32\">\n  <rect width=\"32\" height=\"32\" rx=\"4\" fill=\"#3182ce\"/>\n  <text x=\"16\" y=\"22\" text-anchor=\"middle\" fill=\"white\" font-family=\"system-ui\" font-size=\"18\" font-weight=\"bold\">D</text>\n</svg>`\n    \n    await fs.writeFile(path.join(outputDir, 'favicon.svg'), faviconSvg)\n  }\n}\n\nfunction getFileRoute(filePath: string, baseDir: string): string {\n  // Normalize paths for comparison\n  const normalizedFilePath = path.normalize(filePath)\n  const normalizedBaseDir = path.normalize(baseDir)\n  \n  // Check if file is within base directory\n  if (!normalizedFilePath.startsWith(normalizedBaseDir)) {\n    return '/'\n  }\n  \n  // Get relative path from base directory\n  const relativePath = normalizedFilePath.slice(normalizedBaseDir.length)\n  const segments = relativePath.split(path.sep).filter(Boolean)\n  \n  if (segments.length === 0) return '/'\n  \n  const lastSegment = segments[segments.length - 1]\n  if (lastSegment.endsWith('.md')) {\n    segments[segments.length - 1] = lastSegment.slice(0, -3)\n  }\n  \n  // SKILL.md and README.md should map to parent directory route\n  const finalSegment = segments[segments.length - 1]\n  if (finalSegment === 'SKILL' || finalSegment === 'README') {\n    segments.pop()\n  }\n\n  return '/' + segments.join('/')\n}\n\nexport async function buildForProduction(sourceDir: string, outputDir: string): Promise<DocGenConfig> {\n  const { scanSkillsDirectory } = await import('../scanner/index.js')\n  const { parseSkillsToConfig } = await import('../parser/index.js')\n  \n  const directories = await scanSkillsDirectory(sourceDir)\n  const config = await parseSkillsToConfig(directories, {\n    title: 'Documentation',\n    description: 'Documentation generated from source directory',\n    baseUrl: '/',\n    skillsDir: sourceDir,\n    outputDir\n  })\n  \n  await buildSite({\n    input: sourceDir,\n    output: outputDir,\n    mode: 'production'\n  }, config)\n  \n  return config\n}","import path from 'path'\nimport fs from 'fs/promises'\nimport sirv from 'sirv'\nimport { createServer } from 'http'\n\ninterface PreviewOptions {\n  port: string\n  output: string\n}\n\nexport async function previewCommand(options: PreviewOptions) {\n  console.log('👀 Starting DocGen preview server...')\n  \n  const outputDir = path.resolve(process.cwd(), options.output)\n  const port = parseInt(options.port, 10)\n  \n  try {\n    // Check if build directory exists\n    try {\n      await fs.access(outputDir)\n    } catch {\n      console.error(`❌ Build directory not found: ${outputDir}`)\n      console.log('💡 Run \"docgen build\" first to generate the static site')\n      process.exit(1)\n    }\n    \n    // Create static file server\n    const serve = sirv(outputDir, {\n      single: true, // SPA mode\n      dev: false,\n      setHeaders: (res, pathname) => {\n        if (pathname.endsWith('.html') || pathname === '/') {\n          res.setHeader('Content-Type', 'text/html; charset=utf-8')\n        }\n      }\n    })\n    \n    const server = createServer(serve)\n    \n    server.listen(port, () => {\n      console.log(`🎉 Preview server running at http://localhost:${port}`)\n      console.log(`📂 Serving files from: ${outputDir}`)\n    })\n    \n    // Handle graceful shutdown\n    process.on('SIGINT', () => {\n      console.log('\\\\n👋 Shutting down preview server...')\n      server.close(() => {\n        process.exit(0)\n      })\n    })\n    \n  } catch (error) {\n    console.error('❌ Failed to start preview server:', error)\n    process.exit(1)\n  }\n}"],"mappings":"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","names":["segments","path","path","server","path","path","vue","path","fileURLToPath","fs","__dirname","packageRoot","getFileRoute","path","path","fs","createServer"]}
+{"version":3,"sources":["../src/scanner/index.ts","../src/parser/index.ts","../src/cli/index.ts","../src/cli/commands/dev.ts","../src/builder/vite-dev.ts","../src/utils/port.ts","../src/cli/commands/build.ts","../src/builder/index.ts","../src/cli/commands/preview.ts"],"sourcesContent":["import fs from 'fs/promises'\nimport path from 'path'\nimport { SkillDirectory, SkillFile } from '../types/index.js'\n\nexport async function scanSkillsDirectory(sourceDir: string): Promise<SkillDirectory[]> {\n  try {\n    await fs.access(sourceDir)\n  } catch {\n    throw new Error(`Source directory not found: ${sourceDir}`)\n  }\n\n  const entries = await fs.readdir(sourceDir, { withFileTypes: true })\n  const directories: SkillDirectory[] = []\n\n  for (const entry of entries) {\n    if (entry.isDirectory()) {\n      const dirPath = path.join(sourceDir, entry.name)\n      const skillDirectory = await scanDirectory(dirPath, entry.name)\n      directories.push(skillDirectory)\n    }\n  }\n\n  return directories\n}\n\nasync function scanDirectory(dirPath: string, name: string): Promise<SkillDirectory> {\n  const entries = await fs.readdir(dirPath, { withFileTypes: true })\n  const children: (SkillDirectory | SkillFile)[] = []\n  let skillFile: SkillFile | undefined\n\n  for (const entry of entries) {\n    const entryPath = path.join(dirPath, entry.name)\n\n    if (entry.isDirectory()) {\n      const subDir = await scanDirectory(entryPath, entry.name)\n      children.push(subDir)\n    } else if (entry.isFile() && entry.name.endsWith('.md')) {\n      const file = await parseMarkdownFile(entryPath, entry.name)\n      \n      if (entry.name === 'SKILL.md') {\n        skillFile = file\n      } else {\n        children.push(file)\n      }\n    }\n  }\n\n  return {\n    path: dirPath,\n    name,\n    children,\n    skillFile\n  }\n}\n\nasync function parseMarkdownFile(filePath: string, fileName: string): Promise<SkillFile> {\n  const content = await fs.readFile(filePath, 'utf-8')\n  const stats = await fs.stat(filePath)\n\n  // Basic frontmatter extraction\n  const frontmatterMatch = content.match(/^---\\r?\\n([\\s\\S]*?)\\r?\\n---\\r?\\n/)\n  const frontmatter: Record<string, any> = {}\n  let markdownContent = content\n\n  if (frontmatterMatch) {\n    // Remove frontmatter from content\n    markdownContent = content.slice(frontmatterMatch[0].length)\n    \n    // Parse frontmatter key-value pairs\n    const fmLines = frontmatterMatch[1].split(/\\r?\\n/)\n    for (const line of fmLines) {\n      const colonIndex = line.indexOf(':')\n      if (colonIndex > 0) {\n        const key = line.slice(0, colonIndex).trim()\n        const value = line.slice(colonIndex + 1).trim().replace(/^[\"']|[\"']$/g, '')\n        if (key && value) {\n          frontmatter[key] = value\n        }\n      }\n    }\n  }\n\n  return {\n    path: filePath,\n    name: fileName,\n    title: frontmatter.title || fileName.replace('.md', ''),\n    description: frontmatter.description,\n    content: markdownContent,\n    frontmatter,\n    lastModified: stats.mtime.getTime()\n  }\n}\n\nexport async function watchSkillsDirectory(\n  sourceDir: string, \n  callback: (directories: SkillDirectory[]) => void\n) {\n  const chokidar = await import('chokidar')\n  \n  const watcher = chokidar.watch(sourceDir, {\n    ignored: /node_modules/,\n    persistent: true,\n    ignoreInitial: true\n  })\n\n  let debounceTimer: NodeJS.Timeout\n\n  const handleChange = () => {\n    clearTimeout(debounceTimer)\n    debounceTimer = setTimeout(async () => {\n      try {\n        const directories = await scanSkillsDirectory(sourceDir)\n        callback(directories)\n      } catch (error) {\n        console.error('Error rescanning source directory:', error)\n      }\n    }, 300)\n  }\n\n  watcher.on('add', handleChange)\n  watcher.on('change', handleChange)\n  watcher.on('unlink', handleChange)\n  watcher.on('addDir', handleChange)\n  watcher.on('unlinkDir', handleChange)\n\n  return watcher\n}","import matter from 'gray-matter'\nimport MarkdownIt from 'markdown-it'\nimport { createHighlighter, Highlighter } from 'shiki'\nimport { SkillDirectory, SkillFile, SiteConfig, DocGenConfig, Navigation } from '../types/index.js'\n\nlet highlighter: Highlighter | null = null\n\nasync function getHighlighter() {\n  if (!highlighter) {\n    highlighter = await createHighlighter({\n      themes: ['github-dark', 'github-light'],\n      langs: ['javascript', 'typescript', 'bash', 'shell', 'json', 'html', 'css', 'vue', 'jsx', 'tsx', 'python', 'markdown', 'yaml', 'sql', 'go', 'rust', 'java', 'c', 'cpp']\n    })\n  }\n  return highlighter\n}\n\nconst md = new MarkdownIt({\n  html: true,\n  linkify: true,\n  typographer: true,\n  highlight: function (str: string, lang: string) {\n    // Synchronous fallback - actual highlighting done in enhanceFileContent\n    return `<pre class=\"shiki-pending\" data-lang=\"${lang || 'text'}\"><code>${md.utils.escapeHtml(str)}</code></pre>`\n  }\n})\n\nexport async function parseSkillsToConfig(\n  directories: SkillDirectory[],\n  siteConfig: SiteConfig\n): Promise<DocGenConfig> {\n  const files: SkillFile[] = []\n  const navigation = await generateNavigation(directories)\n\n  // Collect all files for search indexing\n  collectAllFiles(directories, files)\n\n  // Enhance files with parsed content\n  for (const file of files) {\n    await enhanceFileContent(file)\n  }\n\n  return {\n    siteConfig,\n    navigation,\n    files,\n    directories\n  }\n}\n\nfunction collectAllFiles(items: (SkillDirectory | SkillFile)[], files: SkillFile[]) {\n  for (const item of items) {\n    if ('content' in item) {\n      // It's a SkillFile\n      files.push(item)\n    } else {\n      // It's a SkillDirectory\n      if (item.skillFile) {\n        files.push(item.skillFile)\n      }\n      collectAllFiles(item.children, files)\n    }\n  }\n}\n\nasync function enhanceFileContent(file: SkillFile) {\n  try {\n    let content = file.content\n\n    // Update title and description from frontmatter if available\n    file.title = file.frontmatter.title || file.title\n    file.description = file.frontmatter.description || file.description\n\n    // Remove duplicate h1 if it matches frontmatter title\n    if (file.frontmatter.title) {\n      // Match first h1 heading in content (may have leading whitespace/newlines)\n      const h1Match = content.match(/^\\s*#\\s+(.+)$/m)\n      if (h1Match) {\n        const h1Text = h1Match[1].trim()\n        // If h1 matches title, remove it to avoid duplication\n        if (h1Text === file.frontmatter.title) {\n          content = content.replace(/^\\s*#\\s+.+\\n*/, '')\n        }\n      }\n    }\n\n    // Render markdown to HTML\n    let html = md.render(content)\n    \n    // Apply syntax highlighting with shiki\n    html = await highlightCodeBlocks(html)\n    file.frontmatter.html = html\n\n    // Extract headings for TOC\n    const headings = extractHeadings(content)\n    file.frontmatter.headings = headings\n\n  } catch (error) {\n    console.warn(`Failed to enhance content for ${file.path}:`, error)\n    try {\n      file.frontmatter.html = md.render(file.content)\n    } catch (e) {\n      console.error(`Failed to render markdown for ${file.path}:`, e)\n    }\n  }\n}\n\nasync function highlightCodeBlocks(html: string): Promise<string> {\n  const hl = await getHighlighter()\n  \n  // Find all pending shiki code blocks and highlight them\n  const codeBlockRegex = /<pre class=\"shiki-pending\" data-lang=\"([^\"]*)\"[^>]*><code>([^]*?)<\\/code><\\/pre>/g\n  \n  const matches = [...html.matchAll(codeBlockRegex)]\n  \n  for (const match of matches) {\n    const [fullMatch, lang, escapedCode] = match\n    // Unescape HTML entities\n    const code = escapedCode\n      .replace(/&lt;/g, '<')\n      .replace(/&gt;/g, '>')\n      .replace(/&amp;/g, '&')\n      .replace(/&quot;/g, '\"')\n      .replace(/&#39;/g, \"'\")\n    \n    try {\n      const validLang = hl.getLoadedLanguages().includes(lang) ? lang : 'text'\n      const highlighted = hl.codeToHtml(code, {\n        lang: validLang,\n        theme: 'github-dark'\n      })\n      html = html.replace(fullMatch, highlighted)\n    } catch (e) {\n      // Keep original if highlighting fails\n      console.warn(`Failed to highlight ${lang}:`, e)\n    }\n  }\n  \n  return html\n}\n\nfunction extractHeadings(content: string) {\n  const headings: Array<{ level: number; text: string; anchor: string }> = []\n  const lines = content.split('\\n')\n\n  for (const line of lines) {\n    const match = line.match(/^(#{1,6})\\\\s+(.+)$/)\n    if (match) {\n      const level = match[1].length\n      const text = match[2].trim()\n      const anchor = text.toLowerCase()\n        .replace(/[^\\\\w\\\\s-]/g, '')\n        .replace(/\\\\s+/g, '-')\n        .trim()\n\n      headings.push({ level, text, anchor })\n    }\n  }\n\n  return headings\n}\n\nasync function generateNavigation(directories: SkillDirectory[]): Promise<Navigation[]> {\n  const navigation: Navigation[] = []\n\n  for (const dir of directories) {\n    const navItem: Navigation = {\n      text: dir.skillFile?.title || formatDirName(dir.name),\n      link: dir.skillFile ? getFileRoute(dir.skillFile) : undefined\n    }\n\n    if (dir.children.length > 0) {\n      navItem.children = []\n      \n      for (const child of dir.children) {\n        if ('content' in child) {\n          // It's a file\n          navItem.children.push({\n            text: child.title || formatFileName(child.name),\n            link: getFileRoute(child)\n          })\n        } else {\n          // It's a subdirectory\n          const subNav = await generateNavigation([child])\n          navItem.children.push(...subNav)\n        }\n      }\n    }\n\n    navigation.push(navItem)\n  }\n\n  return navigation\n}\n\nfunction getFileRoute(file: SkillFile): string {\n  // Import the utility function from client utils\n  // For now, use inline implementation\n  const filePath = file.path\n  \n  // Try common patterns\n  const patterns = ['my-docs', 'docs', 'documentation', '.claude/skills']\n  let relativePath = ''\n  \n  for (const pattern of patterns) {\n    const index = filePath.indexOf(pattern)\n    if (index !== -1) {\n      relativePath = filePath.slice(index + pattern.length)\n      break\n    }\n  }\n  \n  if (!relativePath) {\n    // Fallback: use last 2 segments\n    const segments = filePath.split('/').filter(Boolean)\n    if (segments.length >= 2) {\n      relativePath = '/' + segments.slice(-2).join('/')\n    } else {\n      return '/'\n    }\n  }\n  \n  const segments = relativePath.split('/').filter(Boolean)\n  \n  if (segments.length === 0) return '/'\n  \n  // Remove file extension\n  const lastSegment = segments[segments.length - 1]\n  if (lastSegment.endsWith('.md')) {\n    segments[segments.length - 1] = lastSegment.slice(0, -3)\n  }\n  \n  // SKILL.md and README.md should map to parent directory route\n  const finalSegment = segments[segments.length - 1]\n  if (finalSegment === 'SKILL' || finalSegment === 'README') {\n    segments.pop()\n  }\n  \n  return '/' + segments.join('/')\n}\n\nfunction formatDirName(name: string): string {\n  return name.split('-').map(word => \n    word.charAt(0).toUpperCase() + word.slice(1)\n  ).join(' ')\n}\n\nfunction formatFileName(name: string): string {\n  const baseName = name.replace('.md', '')\n  return formatDirName(baseName)\n}\n\nexport { md as markdownRenderer }","#!/usr/bin/env node\n\nimport { Command } from 'commander'\nimport { devCommand } from './commands/dev.js'\nimport { buildCommand } from './commands/build.js'\nimport { previewCommand } from './commands/preview.js'\n\nconst program = new Command()\n\nprogram\n  .name('docmk')\n  .description('CLI tool for generating documentation from any directory')\n  .version('1.0.0')\n\nprogram\n  .command('dev', { isDefault: true })\n  .description('Start development server')\n  .option('-p, --port <port>', 'Port to run dev server on', '3000')\n  .option('-d, --dir <directory>', 'Source directory path', './docs')\n  .action(devCommand)\n\nprogram\n  .command('build')\n  .description('Build static documentation site')\n  .option('-d, --dir <directory>', 'Source directory path', './docs')\n  .option('-o, --output <directory>', 'Output directory', 'dist')\n  .action(buildCommand)\n\nprogram\n  .command('preview')\n  .description('Preview built documentation site')\n  .option('-p, --port <port>', 'Port to run preview server on', '4173')\n  .option('-o, --output <directory>', 'Built site directory', 'dist')\n  .action(previewCommand)\n\nprogram.parse()","import path from 'path'\nimport { createViteDevServer } from '../../builder/vite-dev.js'\nimport { scanSkillsDirectory } from '../../scanner/index.js'\nimport { parseSkillsToConfig } from '../../parser/index.js'\nimport { validatePort } from '../../utils/port.js'\n\ninterface DevOptions {\n  port: string\n  dir: string\n}\n\nexport async function devCommand(options: DevOptions) {\n  console.log('🚀 Starting DocGen development server...')\n\n  const sourceDir = path.resolve(process.cwd(), options.dir)\n  const { port } = validatePort(parseInt(options.port, 10))\n  \n  try {\n    // Check if source directory exists\n    console.log(`📁 Scanning source directory: ${sourceDir}`)\n    const directories = await scanSkillsDirectory(sourceDir)\n    \n    console.log(`✅ Found ${directories.length} directories`)\n    \n    // Parse to config\n    const config = await parseSkillsToConfig(directories, {\n      title: 'Documentation',\n      description: 'Documentation generated from source directory',\n      baseUrl: '/',\n      skillsDir: sourceDir,\n      outputDir: 'dist'\n    })\n    \n    // Start Vite dev server\n    const { server, actualPort } = await createViteDevServer({\n      port,\n      skillsDir: sourceDir,\n      config\n    })\n\n    console.log(`🎉 Dev server running at http://localhost:${actualPort}`)\n    \n    // Handle graceful shutdown\n    process.on('SIGINT', async () => {\n      console.log('\\\\n👋 Shutting down dev server...')\n      await server.close()\n      process.exit(0)\n    })\n    \n  } catch (error) {\n    console.error('❌ Failed to start dev server:', error)\n    process.exit(1)\n  }\n}","import { createServer, ViteDevServer } from 'vite'\nimport vue from '@vitejs/plugin-vue'\nimport path from 'path'\nimport { fileURLToPath } from 'url'\nimport { DocGenConfig } from '../types/index.js'\nimport { scanSkillsDirectory, watchSkillsDirectory } from '../scanner/index.js'\nimport { parseSkillsToConfig } from '../parser/index.js'\n\n// Get the package root directory (where src/client is located)\n// When bundled with tsup, the code runs from dist/index.js, so we only need to go up one level\nconst __dirname = path.dirname(fileURLToPath(import.meta.url))\nconst packageRoot = path.resolve(__dirname, '..')\n\ninterface DevServerOptions {\n  port: number\n  skillsDir: string\n  config: DocGenConfig\n}\n\nexport async function createViteDevServer(options: DevServerOptions): Promise<ViteDevServer> {\n  let currentConfig = options.config\n\n  const server = await createServer({\n    root: path.resolve(packageRoot, 'src/client'),\n    server: {\n      port: options.port,\n      host: true // Listen on all addresses\n    },\n    publicDir: false, // Disable public dir in dev mode\n    plugins: [\n      vue(),\n      // Custom plugin to inject config and handle API routes\n      {\n        name: 'docgen-dev',\n        configureServer(server) {\n          // Return a function to be called after all Vite middlewares are set up\n          return () => {\n            // API endpoint for configuration\n            server.middlewares.use('/api/config', (req, res, next) => {\n              if (req.method === 'GET') {\n                res.setHeader('Content-Type', 'application/json')\n                res.end(JSON.stringify(currentConfig))\n              } else {\n                next()\n              }\n            })\n\n            // SPA fallback - return index.html for all non-API routes\n            // This must be registered AFTER all other middlewares\n            server.middlewares.use((req, res, next) => {\n              // Skip API routes and vite's own routes\n              if (req.url?.startsWith('/api/') || req.url?.startsWith('/@') || req.url?.includes('.')) {\n                return next()\n              }\n              // For all other routes, serve index.html for SPA routing\n              req.url = '/index.html'\n              next()\n            })\n          }\n        },\n        transformIndexHtml: {\n          order: 'pre',\n          handler(html) {\n            // Inject lightweight config placeholder\n            // Full config will be loaded via API to avoid HTML parsing issues\n            const configScript = `\n              <script>\n                // Config will be loaded from /api/config\n                globalThis.__DOCGEN_CONFIG__ = null;\n              </script>\n            `\n            return html.replace('<head>', `<head>${configScript}`)\n          }\n        }\n      }\n    ],\n    resolve: {\n      alias: {\n        '@': path.resolve(packageRoot, 'src/client')\n      }\n    },\n    define: {\n      __DOCGEN_CONFIG__: JSON.stringify(currentConfig)\n    }\n  })\n\n  // Watch skills directory for changes\n  const watcher = await watchSkillsDirectory(options.skillsDir, async (directories) => {\n    console.log('📝 Skills directory changed, updating configuration...')\n    \n    try {\n      currentConfig = await parseSkillsToConfig(directories, currentConfig.siteConfig)\n      \n      // Notify all connected clients to reload\n      server.ws.send({\n        type: 'full-reload'\n      })\n      \n      console.log('✅ Configuration updated')\n    } catch (error) {\n      console.error('❌ Failed to update configuration:', error)\n      \n      // Send error to clients\n      server.ws.send({\n        type: 'error',\n        err: {\n          message: `Failed to update configuration: ${error.message}`,\n          stack: error.stack\n        }\n      })\n    }\n  })\n\n  // Start the server\n  await server.listen()\n\n  // Get actual port (in case requested port was taken)\n  const address = server.httpServer.address()\n  const actualPort = typeof address === 'object' && address ? address.port : options.port\n\n  // Extend server with cleanup method\n  const originalClose = server.close.bind(server)\n  server.close = async () => {\n    await watcher?.close()\n    return originalClose()\n  }\n\n  return { server, actualPort }\n}\n\nexport async function createProductionBuild() {\n  // This will be implemented in the builder\n}","/**\n * 浏览器认为不安全的端口列表\n * 参考: https://chromium.googlesource.com/chromium/src/+/refs/heads/main/net/base/port_util.cc\n */\nconst UNSAFE_PORTS = new Set([\n  1,      // tcpmux\n  7,      // echo\n  9,      // discard\n  11,     // systat\n  13,     // daytime\n  15,     // netstat\n  17,     // qotd\n  19,     // chargen\n  20,     // ftp data\n  21,     // ftp access\n  22,     // ssh\n  23,     // telnet\n  25,     // smtp\n  37,     // time\n  42,     // name\n  43,     // nicname\n  53,     // domain\n  69,     // tftp\n  77,     // priv-rjs\n  79,     // finger\n  87,     // ttylink\n  95,     // supdup\n  101,    // hostriame\n  102,    // iso-tsap\n  103,    // gppitnp\n  104,    // acr-nema\n  109,    // pop2\n  110,    // pop3\n  111,    // sunrpc\n  113,    // auth\n  115,    // sftp\n  117,    // uucp-path\n  119,    // nntp\n  123,    // NTP\n  135,    // loc-srv / epmap\n  137,    // netbios\n  139,    // netbios\n  143,    // imap2\n  161,    // snmp\n  179,    // BGP\n  389,    // ldap\n  427,    // SLP (Also used by determine_refmode)\n  465,    // smtp+ssl\n  512,    // print / exec\n  513,    // login\n  514,    // shell\n  515,    // printer\n  526,    // tempo\n  530,    // courier\n  531,    // chat\n  532,    // netnews\n  540,    // uucp\n  548,    // AFP (Apple Filing Protocol)\n  554,    // rtsp\n  556,    // remotefs\n  563,    // nntp+ssl\n  587,    // smtp (rfc6409)\n  601,    // syslog-conn (rfc3195)\n  636,    // ldap+ssl\n  989,    // ftps-data\n  990,    // ftps\n  993,    // ldap+ssl\n  995,    // pop3+ssl\n  1719,   // h323gatestat\n  1720,   // h323hostcall\n  1723,   // pptp\n  2049,   // nfs\n  3659,   // apple-sasl / PasswordServer\n  4045,   // lockd\n  5060,   // sip\n  5061,   // sips\n  6000,   // X11\n  6566,   // sane-port\n  6665,   // Alternate IRC [Apple addition]\n  6666,   // Alternate IRC [Apple addition]\n  6667,   // Standard IRC [Apple addition]\n  6668,   // Alternate IRC [Apple addition]\n  6669,   // Alternate IRC [Apple addition]\n  6697,   // IRC + TLS\n  10080,  // Amanda\n])\n\n/**\n * 检查端口是否安全（不被浏览器阻止）\n */\nexport function isPortSafe(port: number): boolean {\n  return !UNSAFE_PORTS.has(port)\n}\n\n/**\n * 获取一个安全的端口，如果当前端口不安全则返回替代端口\n */\nexport function getSafePort(port: number, fallback = 3000): number {\n  return isPortSafe(port) ? port : fallback\n}\n\n/**\n * 验证端口并返回结果，如果不安全则打印警告\n */\nexport function validatePort(port: number): { port: number; wasUnsafe: boolean } {\n  if (isPortSafe(port)) {\n    return { port, wasUnsafe: false }\n  }\n\n  // 找一个安全的替代端口\n  const safePort = findNextSafePort(port)\n  console.warn(`⚠️  端口 ${port} 被浏览器视为不安全端口，已自动切换到 ${safePort}`)\n  console.warn(`   不安全端口会被浏览器阻止访问 (ERR_UNSAFE_PORT)`)\n\n  return { port: safePort, wasUnsafe: true }\n}\n\n/**\n * 从给定端口开始寻找下一个安全端口\n */\nexport function findNextSafePort(startPort: number): number {\n  let port = startPort\n  while (!isPortSafe(port) && port < 65535) {\n    port++\n  }\n  // 如果找不到（不太可能），回退到 3000\n  return port < 65535 ? port : 3000\n}\n","import path from 'path'\nimport { buildSite } from '../../builder/index.js'\nimport { scanSkillsDirectory } from '../../scanner/index.js'\nimport { parseSkillsToConfig } from '../../parser/index.js'\n\ninterface BuildOptions {\n  dir: string\n  output: string\n}\n\nexport async function buildCommand(options: BuildOptions) {\n  console.log('🏗️  Building DocGen documentation site...')\n  \n  const sourceDir = path.resolve(process.cwd(), options.dir)\n  const outputDir = path.resolve(process.cwd(), options.output)\n  \n  try {\n    // Scan source directory\n    console.log(`📁 Scanning source directory: ${sourceDir}`)\n    const directories = await scanSkillsDirectory(sourceDir)\n    \n    console.log(`✅ Found ${directories.length} directories`)\n    \n    // Parse to config\n    const config = await parseSkillsToConfig(directories, {\n      title: 'Documentation',\n      description: 'Documentation generated from source directory',\n      baseUrl: '/',\n      skillsDir: sourceDir,\n      outputDir\n    })\n    \n    // Build site\n    console.log(`📦 Building to: ${outputDir}`)\n    await buildSite({\n      input: sourceDir,\n      output: outputDir,\n      mode: 'production'\n    }, config)\n    \n    console.log('✅ Build completed successfully!')\n    console.log(`📂 Built files are in: ${outputDir}`)\n    \n  } catch (error) {\n    console.error('❌ Build failed:', error)\n    process.exit(1)\n  }\n}","import { build } from 'vite'\nimport vue from '@vitejs/plugin-vue'\nimport path from 'path'\nimport { fileURLToPath } from 'url'\nimport fs from 'fs/promises'\nimport { DocGenConfig, BuildOptions } from '../types/index.js'\n\n// Get the package root directory\nconst __dirname = path.dirname(fileURLToPath(import.meta.url))\nconst packageRoot = path.resolve(__dirname, '../..')\n\nexport async function buildSite(options: BuildOptions, config: DocGenConfig) {\n  console.log('🏗️  Building documentation site...')\n\n  // Ensure output directory exists\n  await fs.mkdir(options.output, { recursive: true })\n\n  // Write config to a temporary file for the build process\n  const configPath = path.join(process.cwd(), 'temp-config.json')\n  await fs.writeFile(configPath, JSON.stringify(config, null, 2))\n\n  try {\n    // Build the client application\n    await build({\n      root: path.resolve(packageRoot, 'src/client'),\n      base: config.siteConfig.baseUrl,\n      build: {\n        outDir: options.output,\n        emptyOutDir: true,\n        rollupOptions: {\n          input: {\n            main: path.resolve(packageRoot, 'src/client/index.html')\n          }\n        }\n      },\n      plugins: [\n        vue(),\n        // Plugin to inject config during build\n        {\n          name: 'docgen-build',\n          transformIndexHtml: {\n            order: 'pre',\n            handler(html) {\n              // Encode config as base64 with proper UTF-8 handling\n              const configJson = JSON.stringify(config)\n              // Use encodeURIComponent to handle UTF-8 properly before base64\n              const utf8Encoded = unescape(encodeURIComponent(configJson))\n              const configBase64 = Buffer.from(utf8Encoded, 'binary').toString('base64')\n              // Decode: atob -> decodeURIComponent(escape()) to restore UTF-8\n              const configScript = `<script>globalThis.__DOCGEN_CONFIG__=JSON.parse(decodeURIComponent(escape(atob(\"${configBase64}\"))));</script>`\n              return html.replace('</head>', `${configScript}\\n</head>`)\n            }\n          }\n        }\n      ],\n      resolve: {\n        alias: {\n          '@': path.resolve(packageRoot, 'src/client')\n        }\n      },\n      define: {\n        __DOCGEN_CONFIG__: JSON.stringify(config)\n      }\n    })\n    \n    // Generate additional static files\n    await generateSitemap(options.output, config)\n    await generateRobotsTxt(options.output, config)\n    await copyAssets(options.output)\n    \n    console.log('✅ Build completed successfully!')\n    \n  } finally {\n    // Clean up temporary config file\n    try {\n      await fs.unlink(configPath)\n    } catch {\n      // Ignore if file doesn't exist\n    }\n  }\n}\n\nasync function generateSitemap(outputDir: string, config: DocGenConfig) {\n  console.log('📄 Generating sitemap...')\n  \n  const baseUrl = config.siteConfig.baseUrl.replace(/\\/$/, '')\n  const urls: string[] = []\n  \n  // Add home page\n  urls.push(`${baseUrl}/`)\n  \n  // Add all skill pages\n  for (const file of config.files) {\n    const route = getFileRoute(file.path, config.siteConfig.skillsDir)\n    if (route !== '/') {\n      urls.push(`${baseUrl}${route}`)\n    }\n  }\n  \n  const sitemap = `<?xml version=\"1.0\" encoding=\"UTF-8\"?>\n<urlset xmlns=\"http://www.sitemaps.org/schemas/sitemap/0.9\">\n${urls.map(url => `  <url>\n    <loc>${url}</loc>\n    <lastmod>${new Date().toISOString().split('T')[0]}</lastmod>\n    <changefreq>weekly</changefreq>\n    <priority>0.8</priority>\n  </url>`).join('\\\\n')}\n</urlset>`\n  \n  await fs.writeFile(path.join(outputDir, 'sitemap.xml'), sitemap)\n}\n\nasync function generateRobotsTxt(outputDir: string, config: DocGenConfig) {\n  console.log('🤖 Generating robots.txt...')\n  \n  const baseUrl = config.siteConfig.baseUrl.replace(/\\/$/, '')\n  const robotsTxt = `User-agent: *\nAllow: /\n\nSitemap: ${baseUrl}/sitemap.xml`\n  \n  await fs.writeFile(path.join(outputDir, 'robots.txt'), robotsTxt)\n}\n\nasync function copyAssets(outputDir: string) {\n  console.log('📁 Copying static assets...')\n  \n  // Create a simple favicon if it doesn't exist\n  const faviconPath = path.join(outputDir, 'favicon.ico')\n  \n  try {\n    await fs.access(faviconPath)\n  } catch {\n    // Create a simple SVG favicon\n    const faviconSvg = `<svg xmlns=\"http://www.w3.org/2000/svg\" viewBox=\"0 0 32 32\">\n  <rect width=\"32\" height=\"32\" rx=\"4\" fill=\"#3182ce\"/>\n  <text x=\"16\" y=\"22\" text-anchor=\"middle\" fill=\"white\" font-family=\"system-ui\" font-size=\"18\" font-weight=\"bold\">D</text>\n</svg>`\n    \n    await fs.writeFile(path.join(outputDir, 'favicon.svg'), faviconSvg)\n  }\n}\n\nfunction getFileRoute(filePath: string, baseDir: string): string {\n  // Normalize paths for comparison\n  const normalizedFilePath = path.normalize(filePath)\n  const normalizedBaseDir = path.normalize(baseDir)\n  \n  // Check if file is within base directory\n  if (!normalizedFilePath.startsWith(normalizedBaseDir)) {\n    return '/'\n  }\n  \n  // Get relative path from base directory\n  const relativePath = normalizedFilePath.slice(normalizedBaseDir.length)\n  const segments = relativePath.split(path.sep).filter(Boolean)\n  \n  if (segments.length === 0) return '/'\n  \n  const lastSegment = segments[segments.length - 1]\n  if (lastSegment.endsWith('.md')) {\n    segments[segments.length - 1] = lastSegment.slice(0, -3)\n  }\n  \n  // SKILL.md and README.md should map to parent directory route\n  const finalSegment = segments[segments.length - 1]\n  if (finalSegment === 'SKILL' || finalSegment === 'README') {\n    segments.pop()\n  }\n\n  return '/' + segments.join('/')\n}\n\nexport async function buildForProduction(sourceDir: string, outputDir: string): Promise<DocGenConfig> {\n  const { scanSkillsDirectory } = await import('../scanner/index.js')\n  const { parseSkillsToConfig } = await import('../parser/index.js')\n  \n  const directories = await scanSkillsDirectory(sourceDir)\n  const config = await parseSkillsToConfig(directories, {\n    title: 'Documentation',\n    description: 'Documentation generated from source directory',\n    baseUrl: '/',\n    skillsDir: sourceDir,\n    outputDir\n  })\n  \n  await buildSite({\n    input: sourceDir,\n    output: outputDir,\n    mode: 'production'\n  }, config)\n  \n  return config\n}","import path from 'path'\nimport fs from 'fs/promises'\nimport sirv from 'sirv'\nimport { createServer } from 'http'\nimport { validatePort } from '../../utils/port.js'\n\ninterface PreviewOptions {\n  port: string\n  output: string\n}\n\nexport async function previewCommand(options: PreviewOptions) {\n  console.log('👀 Starting DocGen preview server...')\n\n  const outputDir = path.resolve(process.cwd(), options.output)\n  const { port } = validatePort(parseInt(options.port, 10))\n  \n  try {\n    // Check if build directory exists\n    try {\n      await fs.access(outputDir)\n    } catch {\n      console.error(`❌ Build directory not found: ${outputDir}`)\n      console.log('💡 Run \"docgen build\" first to generate the static site')\n      process.exit(1)\n    }\n    \n    // Create static file server\n    const serve = sirv(outputDir, {\n      single: true, // SPA mode\n      dev: false,\n      setHeaders: (res, pathname) => {\n        if (pathname.endsWith('.html') || pathname === '/') {\n          res.setHeader('Content-Type', 'text/html; charset=utf-8')\n        }\n      }\n    })\n    \n    const server = createServer(serve)\n    \n    server.listen(port, () => {\n      console.log(`🎉 Preview server running at http://localhost:${port}`)\n      console.log(`📂 Serving files from: ${outputDir}`)\n    })\n    \n    // Handle graceful shutdown\n    process.on('SIGINT', () => {\n      console.log('\\\\n👋 Shutting down preview server...')\n      server.close(() => {\n        process.exit(0)\n      })\n    })\n    \n  } catch (error) {\n    console.error('❌ Failed to start preview server:', error)\n    process.exit(1)\n  }\n}"],"mappings":"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","names":["segments","path","path","server","path","path","vue","path","fileURLToPath","fs","__dirname","packageRoot","getFileRoute","path","path","fs","createServer","path","fs","createServer"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "docmk",
-  "version": "1.0.5",
+  "version": "1.0.7",
   "description": "A CLI tool for scanning directories and generating static documentation websites",
   "main": "dist/index.js",
   "bin": {

package/src/builder/vite-dev.ts

@@ -7,8 +7,9 @@ import { scanSkillsDirectory, watchSkillsDirectory } from '../scanner/index.js'
 import { parseSkillsToConfig } from '../parser/index.js'
 
 // Get the package root directory (where src/client is located)
+// When bundled with tsup, the code runs from dist/index.js, so we only need to go up one level
 const __dirname = path.dirname(fileURLToPath(import.meta.url))
-const packageRoot = path.resolve(__dirname, '../..')
+const packageRoot = path.resolve(__dirname, '..')
 
 interface DevServerOptions {
   port: number
@@ -23,7 +24,7 @@ export async function createViteDevServer(options: DevServerOptions): Promise<Vi
     root: path.resolve(packageRoot, 'src/client'),
     server: {
       port: options.port,
-      host: 'localhost'
+      host: true // Listen on all addresses
     },
     publicDir: false, // Disable public dir in dev mode
     plugins: [
@@ -32,27 +33,27 @@ export async function createViteDevServer(options: DevServerOptions): Promise<Vi
       {
         name: 'docgen-dev',
         configureServer(server) {
-          // API endpoint for configuration
-          server.middlewares.use('/api/config', (req, res, next) => {
-            if (req.method === 'GET') {
-              res.setHeader('Content-Type', 'application/json')
-              res.end(JSON.stringify(currentConfig))
-            } else {
-              next()
-            }
-          })
-
-          // SPA fallback - return index.html for all non-API routes
+          // Return a function to be called after all Vite middlewares are set up
           return () => {
+            // API endpoint for configuration
+            server.middlewares.use('/api/config', (req, res, next) => {
+              if (req.method === 'GET') {
+                res.setHeader('Content-Type', 'application/json')
+                res.end(JSON.stringify(currentConfig))
+              } else {
+                next()
+              }
+            })
+
+            // SPA fallback - return index.html for all non-API routes
+            // This must be registered AFTER all other middlewares
             server.middlewares.use((req, res, next) => {
               // Skip API routes and vite's own routes
-              if (req.url?.startsWith('/api/') || req.url?.startsWith('/@') || req.url?.includes('.html')) {
+              if (req.url?.startsWith('/api/') || req.url?.startsWith('/@') || req.url?.includes('.')) {
                 return next()
               }
               // For all other routes, serve index.html for SPA routing
-              if (req.url && !req.url.includes('.')) {
-                req.url = '/index.html'
-              }
+              req.url = '/index.html'
               next()
             })
           }
@@ -114,7 +115,8 @@ export async function createViteDevServer(options: DevServerOptions): Promise<Vi
   await server.listen()
 
   // Get actual port (in case requested port was taken)
-  const actualPort = server.config.server.port
+  const address = server.httpServer.address()
+  const actualPort = typeof address === 'object' && address ? address.port : options.port
 
   // Extend server with cleanup method
   const originalClose = server.close.bind(server)

package/src/cli/commands/dev.ts

@@ -2,6 +2,7 @@ import path from 'path'
 import { createViteDevServer } from '../../builder/vite-dev.js'
 import { scanSkillsDirectory } from '../../scanner/index.js'
 import { parseSkillsToConfig } from '../../parser/index.js'
+import { validatePort } from '../../utils/port.js'
 
 interface DevOptions {
   port: string
@@ -10,9 +11,9 @@ interface DevOptions {
 
 export async function devCommand(options: DevOptions) {
   console.log('🚀 Starting DocGen development server...')
-  
+
   const sourceDir = path.resolve(process.cwd(), options.dir)
-  const port = parseInt(options.port, 10)
+  const { port } = validatePort(parseInt(options.port, 10))
   
   try {
     // Check if source directory exists

package/src/cli/commands/preview.ts

@@ -2,6 +2,7 @@ import path from 'path'
 import fs from 'fs/promises'
 import sirv from 'sirv'
 import { createServer } from 'http'
+import { validatePort } from '../../utils/port.js'
 
 interface PreviewOptions {
   port: string
@@ -10,9 +11,9 @@ interface PreviewOptions {
 
 export async function previewCommand(options: PreviewOptions) {
   console.log('👀 Starting DocGen preview server...')
-  
+
   const outputDir = path.resolve(process.cwd(), options.output)
-  const port = parseInt(options.port, 10)
+  const { port } = validatePort(parseInt(options.port, 10))
   
   try {
     // Check if build directory exists

package/src/cli/index.ts

@@ -11,15 +11,9 @@ program
   .name('docmk')
   .description('CLI tool for generating documentation from any directory')
   .version('1.0.0')
-  .argument('[directory]', 'Source directory path (starts dev server)', './docs')
-  .option('-p, --port <port>', 'Port to run dev server on', '3000')
-  .action((directory, options) => {
-    // Default action: start dev server
-    devCommand({ dir: directory, port: options.port })
-  })
 
 program
-  .command('dev')
+  .command('dev', { isDefault: true })
   .description('Start development server')
   .option('-p, --port <port>', 'Port to run dev server on', '3000')
   .option('-d, --dir <directory>', 'Source directory path', './docs')

package/src/utils/port.ts

@@ -0,0 +1,128 @@
+/**
+ * 浏览器认为不安全的端口列表
+ * 参考: https://chromium.googlesource.com/chromium/src/+/refs/heads/main/net/base/port_util.cc
+ */
+const UNSAFE_PORTS = new Set([
+  1,      // tcpmux
+  7,      // echo
+  9,      // discard
+  11,     // systat
+  13,     // daytime
+  15,     // netstat
+  17,     // qotd
+  19,     // chargen
+  20,     // ftp data
+  21,     // ftp access
+  22,     // ssh
+  23,     // telnet
+  25,     // smtp
+  37,     // time
+  42,     // name
+  43,     // nicname
+  53,     // domain
+  69,     // tftp
+  77,     // priv-rjs
+  79,     // finger
+  87,     // ttylink
+  95,     // supdup
+  101,    // hostriame
+  102,    // iso-tsap
+  103,    // gppitnp
+  104,    // acr-nema
+  109,    // pop2
+  110,    // pop3
+  111,    // sunrpc
+  113,    // auth
+  115,    // sftp
+  117,    // uucp-path
+  119,    // nntp
+  123,    // NTP
+  135,    // loc-srv / epmap
+  137,    // netbios
+  139,    // netbios
+  143,    // imap2
+  161,    // snmp
+  179,    // BGP
+  389,    // ldap
+  427,    // SLP (Also used by determine_refmode)
+  465,    // smtp+ssl
+  512,    // print / exec
+  513,    // login
+  514,    // shell
+  515,    // printer
+  526,    // tempo
+  530,    // courier
+  531,    // chat
+  532,    // netnews
+  540,    // uucp
+  548,    // AFP (Apple Filing Protocol)
+  554,    // rtsp
+  556,    // remotefs
+  563,    // nntp+ssl
+  587,    // smtp (rfc6409)
+  601,    // syslog-conn (rfc3195)
+  636,    // ldap+ssl
+  989,    // ftps-data
+  990,    // ftps
+  993,    // ldap+ssl
+  995,    // pop3+ssl
+  1719,   // h323gatestat
+  1720,   // h323hostcall
+  1723,   // pptp
+  2049,   // nfs
+  3659,   // apple-sasl / PasswordServer
+  4045,   // lockd
+  5060,   // sip
+  5061,   // sips
+  6000,   // X11
+  6566,   // sane-port
+  6665,   // Alternate IRC [Apple addition]
+  6666,   // Alternate IRC [Apple addition]
+  6667,   // Standard IRC [Apple addition]
+  6668,   // Alternate IRC [Apple addition]
+  6669,   // Alternate IRC [Apple addition]
+  6697,   // IRC + TLS
+  10080,  // Amanda
+])
+
+/**
+ * 检查端口是否安全（不被浏览器阻止）
+ */
+export function isPortSafe(port: number): boolean {
+  return !UNSAFE_PORTS.has(port)
+}
+
+/**
+ * 获取一个安全的端口，如果当前端口不安全则返回替代端口
+ */
+export function getSafePort(port: number, fallback = 3000): number {
+  return isPortSafe(port) ? port : fallback
+}
+
+/**
+ * 验证端口并返回结果，如果不安全则打印警告
+ */
+export function validatePort(port: number): { port: number; wasUnsafe: boolean } {
+  if (isPortSafe(port)) {
+    return { port, wasUnsafe: false }
+  }
+
+  // 找一个安全的替代端口
+  const safePort = findNextSafePort(port)
+  console.warn(`⚠️  端口 ${port} 被浏览器视为不安全端口，已自动切换到 ${safePort}`)
+  console.warn(`   不安全端口会被浏览器阻止访问 (ERR_UNSAFE_PORT)`)
+
+  return { port: safePort, wasUnsafe: true }
+}
+
+/**
+ * 从给定端口开始寻找下一个安全端口
+ */
+export function findNextSafePort(startPort: number): number {
+  let port = startPort
+  while (!isPortSafe(port) && port < 65535) {
+    port++
+  }
+  // 如果找不到（不太可能），回退到 3000
+  return port < 65535 ? port : 3000
+}