@litodocs/cli 1.3.2 → 1.4.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@litodocs/cli",
-  "version": "1.3.2",
+  "version": "1.4.0",
   "description": "Beautiful documentation sites from Markdown. Fast, simple, and open-source.",
   "type": "module",
   "bin": {

package/src/commands/build.js

@@ -31,7 +31,7 @@ export async function buildCommand(options) {
 
     // Step 1: Scaffold temporary project
     s.start('Setting up project...');
-    const projectDir = await scaffoldProject(templatePath);
+    const projectDir = await scaffoldProject(templatePath, inputPath);
     s.stop('Project scaffolded');
 
     // Step 1.5: Detect framework
@@ -88,7 +88,7 @@ export async function buildCommand(options) {
 
     // Cleanup temp directory
     s.start('Cleaning up...');
-    await cleanupProject();
+    await cleanupProject(projectDir);
     s.stop('Cleanup complete');
 
     outro(pc.green('Build completed successfully!'));
@@ -100,7 +100,7 @@ export async function buildCommand(options) {
 
     // Attempt to cleanup even on error
     try {
-      await cleanupProject();
+      await cleanupProject(projectDir);
     } catch (e) {
       // failed to cleanup
     }

package/src/commands/dev.js

@@ -31,7 +31,7 @@ export async function devCommand(options) {
 
     // Step 1: Scaffold temporary project
     s.start('Setting up project...');
-    const projectDir = await scaffoldProject(templatePath);
+    const projectDir = await scaffoldProject(templatePath, inputPath);
     s.stop('Project scaffolded');
 
     // Step 1.5: Detect framework
@@ -42,7 +42,7 @@ export async function devCommand(options) {
     // Register cleanup handlers
     const cleanup = async () => {
       s.start('Cleaning up...');
-      await cleanupProject();
+      await cleanupProject(projectDir);
       s.stop('Cleanup complete');
       process.exit(0);
     };

package/src/commands/eject.js

@@ -37,7 +37,7 @@ export async function ejectCommand(options) {
 
     // Step 1: Scaffold temporary Astro project
     s.start('Scaffolding Astro project...');
-    const projectDir = await scaffoldProject(templatePath);
+    const projectDir = await scaffoldProject(templatePath, inputPath);
     s.stop('Astro project scaffolded');
 
     // Step 2: Sync docs to Astro
@@ -63,7 +63,7 @@ export async function ejectCommand(options) {
 
     // Clean up temp directory
     s.start('Cleaning up...');
-    await cleanupProject();
+    await cleanupProject(projectDir);
     s.stop('Cleanup complete');
 
     // Step 6: Final instructions

package/src/core/scaffold.js

@@ -1,29 +1,110 @@
 import pkg from 'fs-extra';
 const { ensureDir, emptyDir, copy, remove } = pkg;
 import { homedir } from 'os';
-import { join, basename } from 'path';
+import { join, basename, resolve } from 'path';
 import { fileURLToPath } from 'url';
 import { dirname } from 'path';
+import { platform } from 'os';
+import { execSync } from 'child_process';
+import { createHash } from 'crypto';
 
 const __filename = fileURLToPath(import.meta.url);
 const __dirname = dirname(__filename);
 
-// Use a directory under the user's home to avoid resolution issues
-// with bundlers (e.g. Turbopack) that fail to resolve node_modules from /tmp
-const LITO_DIR = join(homedir(), '.lito', 'dev-project');
+// Base directory for all dev projects
+const LITO_PROJECTS_DIR = join(homedir(), '.lito', 'dev-projects');
 
-export async function scaffoldProject(customTemplatePath = null) {
-  // Ensure the directory exists (creates if it doesn't)
-  await ensureDir(LITO_DIR);
+// Legacy single dev-project path (for migration cleanup)
+const LEGACY_DIR = join(homedir(), '.lito', 'dev-project');
 
-  // Empty the directory to ensure a clean state
-  await emptyDir(LITO_DIR);
+/**
+ * Derive a short, unique directory name from an input path.
+ * e.g. /home/user/my-docs → "my-docs-a1b2c3"
+ */
+function getProjectSlug(inputPath) {
+  const resolved = resolve(inputPath);
+  const hash = createHash('md5').update(resolved).digest('hex').slice(0, 8);
+  const name = basename(resolved).replace(/[^a-zA-Z0-9_-]/g, '_');
+  return `${name}-${hash}`;
+}
+
+/**
+ * Get the project directory for a given input path.
+ */
+export function getProjectDir(inputPath) {
+  const slug = getProjectSlug(inputPath);
+  return join(LITO_PROJECTS_DIR, slug);
+}
 
-  const tempDir = LITO_DIR;
+/**
+ * Kill stale processes spawned from a specific project directory (Windows).
+ * On Windows, .bin/*.exe files stay locked if a previous dev server
+ * wasn't shut down cleanly. This finds and kills those processes.
+ */
+function killStaleProcesses(projectDir) {
+  if (platform() !== 'win32') return;
+
+  try {
+    // Escape backslashes for WMIC LIKE pattern
+    const escapedPath = projectDir.replace(/\\/g, '\\\\');
+    const cmd = `wmic process where "ExecutablePath like '%${escapedPath}%'" get ProcessId /format:list 2>nul`;
+    const output = execSync(cmd, { encoding: 'utf-8', timeout: 5000 });
+    const pids = output.match(/ProcessId=(\d+)/g);
+    if (pids) {
+      for (const match of pids) {
+        const pid = match.split('=')[1];
+        try {
+          execSync(`taskkill /F /PID ${pid}`, { stdio: 'ignore', timeout: 3000 });
+        } catch { /* process may already be gone */ }
+      }
+      // Brief wait for OS to release file handles
+      execSync('timeout /t 1 /nobreak >nul 2>&1', { timeout: 3000 });
+    }
+  } catch { /* wmic/taskkill not available or no matching processes */ }
+}
+
+/**
+ * Safely empty a directory.
+ * Retries with stale process cleanup on EPERM (Windows file lock).
+ */
+async function safeEmptyDir(dir) {
+  try {
+    await emptyDir(dir);
+  } catch (err) {
+    if (err.code === 'EPERM' || err.code === 'EBUSY') {
+      killStaleProcesses(dir);
+
+      // Retry — remove entirely then recreate
+      try {
+        await remove(dir);
+      } catch { /* ignore */ }
+      await ensureDir(dir);
+    } else {
+      throw err;
+    }
+  }
+}
+
+/**
+ * Clean up the legacy single dev-project directory if it exists.
+ */
+async function cleanupLegacyDir() {
+  try {
+    await remove(LEGACY_DIR);
+  } catch { /* ignore — may not exist or may be locked */ }
+}
+
+export async function scaffoldProject(customTemplatePath = null, inputPath = null) {
+  const projectDir = inputPath ? getProjectDir(inputPath) : join(LITO_PROJECTS_DIR, '_default');
+
+  await ensureDir(projectDir);
+  await safeEmptyDir(projectDir);
+
+  // Clean up legacy directory from older CLI versions
+  await cleanupLegacyDir();
 
-  // Use custom template path if provided, otherwise use bundled template
   const templatePath = customTemplatePath || join(__dirname, '../template');
-  await copy(templatePath, tempDir, {
+  await copy(templatePath, projectDir, {
     filter: (src) => {
       const name = basename(src);
 
@@ -41,14 +122,21 @@ export async function scaffoldProject(customTemplatePath = null) {
     }
   });
 
-  return tempDir;
+  return projectDir;
 }
 
-// Cleanup function to remove the temp directory on exit
-export async function cleanupProject() {
+// Cleanup function to remove a specific project directory on exit
+export async function cleanupProject(projectDir) {
+  if (!projectDir) return;
+
   try {
-    await remove(LITO_DIR);
+    await remove(projectDir);
   } catch (error) {
-    // Ignore errors during cleanup (directory might not exist)
+    if (error.code === 'EPERM' || error.code === 'EBUSY') {
+      killStaleProcesses(projectDir);
+      try {
+        await remove(projectDir);
+      } catch { /* best-effort cleanup */ }
+    }
   }
 }

package/src/core/template-fetcher.js

@@ -123,11 +123,15 @@ export async function fetchGitHubTemplate(owner, repo, ref) {
 
   // Use tar to extract (available on all Unix systems and modern Windows)
   const { execa } = await import('execa');
-  await execa('tar', [
-    '-xzf', tempTarPath,
-    '-C', cachePath,
-    '--strip-components=1'
-  ]);
+  const isWin = process.platform === 'win32';
+  const tarArgs = [
+    '-xzf', isWin ? tempTarPath.replace(/\\/g, '/') : tempTarPath,
+    '-C', isWin ? cachePath.replace(/\\/g, '/') : cachePath,
+    '--strip-components=1',
+    // On Windows, GNU tar misinterprets drive letters (C:) as remote hosts
+    ...(isWin ? ['--force-local'] : [])
+  ];
+  await execa('tar', tarArgs);
 
   // Cleanup temp tarball
   await remove(tempTarPath);