lean-spec 0.1.1 → 0.1.3

package/dist/{chunk-GLXYUS7F.js → chunk-S6TGAL75.js}

@@ -39,7 +39,7 @@ var DEFAULT_CONFIG = {
   }
 };
 async function loadConfig(cwd = process.cwd()) {
-  const configPath = path.join(cwd, ".lspec", "config.json");
+  const configPath = path.join(cwd, ".lean-spec", "config.json");
   try {
     const content = await fs.readFile(configPath, "utf-8");
     const userConfig = JSON.parse(content);
@@ -51,7 +51,7 @@ async function loadConfig(cwd = process.cwd()) {
   }
 }
 async function saveConfig(config, cwd = process.cwd()) {
-  const configDir = path.join(cwd, ".lspec");
+  const configDir = path.join(cwd, ".lean-spec");
   const configPath = path.join(configDir, "config.json");
   await fs.mkdir(configDir, { recursive: true });
   await fs.writeFile(configPath, JSON.stringify(config, null, 2), "utf-8");
@@ -141,13 +141,13 @@ async function loadSubFiles(specDir, options = {}) {
       if (entry.name === "README.md") continue;
       if (entry.isDirectory()) continue;
       const filePath = path2.join(specDir, entry.name);
-      const stat4 = await fs2.stat(filePath);
+      const stat5 = await fs2.stat(filePath);
       const ext = path2.extname(entry.name).toLowerCase();
       const isDocument = ext === ".md";
       const subFile = {
         name: entry.name,
         path: filePath,
-        size: stat4.size,
+        size: stat5.size,
         type: isDocument ? "document" : "asset"
       };
       if (isDocument && options.includeContent) {
@@ -616,14 +616,14 @@ async function checkSpecs(options = {}) {
         console.log("");
       }
       console.log(chalk3.cyan("Tip: Use date prefix to prevent conflicts:"));
-      console.log(chalk3.gray('  Edit .lspec/config.json \u2192 structure.prefix: "{YYYYMMDD}-"'));
+      console.log(chalk3.gray('  Edit .lean-spec/config.json \u2192 structure.prefix: "{YYYYMMDD}-"'));
       console.log("");
       console.log(chalk3.cyan("Or rename folders manually to resolve."));
       console.log("");
     } else {
       console.log("");
       console.log(chalk3.yellow(`\u26A0\uFE0F  Conflict warning: ${conflicts.length} sequence conflict(s) detected`));
-      console.log(chalk3.gray("Run: lspec check"));
+      console.log(chalk3.gray("Run: lean-spec check"));
       console.log("");
     }
   }
@@ -677,7 +677,7 @@ async function createSpec(name, options = {}) {
     }
   }
   await fs5.mkdir(specDir, { recursive: true });
-  const templatesDir = path6.join(cwd, ".lspec", "templates");
+  const templatesDir = path6.join(cwd, ".lean-spec", "templates");
   let templateName;
   if (options.template) {
     if (config.templates?.[options.template]) {
@@ -734,7 +734,7 @@ ${options.description}`
       );
     }
   } catch (error) {
-    throw new Error(`Template not found: ${templatePath}. Run: lspec init`);
+    throw new Error(`Template not found: ${templatePath}. Run: lean-spec init`);
   }
   await fs5.writeFile(specFile, content, "utf-8");
   console.log(chalk4.green(`\u2713 Created: ${sanitizeUserInput(specDir)}/`));
@@ -755,6 +755,10 @@ async function archiveSpec(specPath) {
   if (!resolvedPath) {
     throw new Error(`Spec not found: ${sanitizeUserInput(specPath)}`);
   }
+  const specFile = await getSpecFile(resolvedPath, config.structure.defaultFile);
+  if (specFile) {
+    await updateFrontmatter(specFile, { status: "archived" });
+  }
   const archiveDir = path7.join(specsDir, "archived");
   await fs6.mkdir(archiveDir, { recursive: true });
   const specName = path7.basename(resolvedPath);
@@ -870,7 +874,7 @@ async function listSpecs(options = {}) {
     await fs7.access(specsDir);
   } catch {
     console.log("");
-    console.log("No specs directory found. Initialize with: lspec init");
+    console.log("No specs directory found. Initialize with: lean-spec init");
     console.log("");
     return;
   }
@@ -1351,7 +1355,7 @@ import * as path11 from "path";
 import chalk9 from "chalk";
 async function listTemplates(cwd = process.cwd()) {
   const config = await loadConfig(cwd);
-  const templatesDir = path11.join(cwd, ".lspec", "templates");
+  const templatesDir = path11.join(cwd, ".lean-spec", "templates");
   console.log("");
   console.log(chalk9.green("=== Project Templates ==="));
   console.log("");
@@ -1359,7 +1363,7 @@ async function listTemplates(cwd = process.cwd()) {
     await fs8.access(templatesDir);
   } catch {
     console.log(chalk9.yellow("No templates directory found."));
-    console.log(chalk9.gray("Run: lspec init"));
+    console.log(chalk9.gray("Run: lean-spec init"));
     console.log("");
     return;
   }
@@ -1382,12 +1386,12 @@ async function listTemplates(cwd = process.cwd()) {
   console.log(chalk9.cyan("Available files:"));
   for (const file of templateFiles) {
     const filePath = path11.join(templatesDir, file);
-    const stat4 = await fs8.stat(filePath);
-    const sizeKB = (stat4.size / 1024).toFixed(1);
+    const stat5 = await fs8.stat(filePath);
+    const sizeKB = (stat5.size / 1024).toFixed(1);
     console.log(`  ${file} (${sizeKB} KB)`);
   }
   console.log("");
-  console.log(chalk9.gray("Use templates with: lspec create <name> --template=<template-name>"));
+  console.log(chalk9.gray("Use templates with: lean-spec create <name> --template=<template-name>"));
   console.log("");
 }
 async function showTemplate(templateName, cwd = process.cwd()) {
@@ -1397,7 +1401,7 @@ async function showTemplate(templateName, cwd = process.cwd()) {
     console.error(chalk9.gray(`Available: ${Object.keys(config.templates || {}).join(", ")}`));
     process.exit(1);
   }
-  const templatesDir = path11.join(cwd, ".lspec", "templates");
+  const templatesDir = path11.join(cwd, ".lean-spec", "templates");
   const templateFile = config.templates[templateName];
   const templatePath = path11.join(templatesDir, templateFile);
   try {
@@ -1415,7 +1419,7 @@ async function showTemplate(templateName, cwd = process.cwd()) {
 }
 async function addTemplate(name, file, cwd = process.cwd()) {
   const config = await loadConfig(cwd);
-  const templatesDir = path11.join(cwd, ".lspec", "templates");
+  const templatesDir = path11.join(cwd, ".lean-spec", "templates");
   const templatePath = path11.join(templatesDir, file);
   try {
     await fs8.access(templatePath);
@@ -1423,7 +1427,7 @@ async function addTemplate(name, file, cwd = process.cwd()) {
     console.error(chalk9.red(`Template file not found: ${file}`));
     console.error(chalk9.gray(`Expected at: ${templatePath}`));
     console.error(
-      chalk9.yellow("Create the file first or use: lspec templates copy <source> <target>")
+      chalk9.yellow("Create the file first or use: lean-spec templates copy <source> <target>")
     );
     process.exit(1);
   }
@@ -1436,7 +1440,7 @@ async function addTemplate(name, file, cwd = process.cwd()) {
   config.templates[name] = file;
   await saveConfig(config, cwd);
   console.log(chalk9.green(`\u2713 Added template: ${name} \u2192 ${file}`));
-  console.log(chalk9.gray(`  Use with: lspec create <spec-name> --template=${name}`));
+  console.log(chalk9.gray(`  Use with: lean-spec create <spec-name> --template=${name}`));
 }
 async function removeTemplate(name, cwd = process.cwd()) {
   const config = await loadConfig(cwd);
@@ -1453,11 +1457,11 @@ async function removeTemplate(name, cwd = process.cwd()) {
   delete config.templates[name];
   await saveConfig(config, cwd);
   console.log(chalk9.green(`\u2713 Removed template: ${name}`));
-  console.log(chalk9.gray(`  Note: Template file ${file} still exists in .lspec/templates/`));
+  console.log(chalk9.gray(`  Note: Template file ${file} still exists in .lean-spec/templates/`));
 }
 async function copyTemplate(source, target, cwd = process.cwd()) {
   const config = await loadConfig(cwd);
-  const templatesDir = path11.join(cwd, ".lspec", "templates");
+  const templatesDir = path11.join(cwd, ".lean-spec", "templates");
   let sourceFile;
   if (config.templates?.[source]) {
     sourceFile = config.templates[source];
@@ -1484,7 +1488,7 @@ async function copyTemplate(source, target, cwd = process.cwd()) {
   await saveConfig(config, cwd);
   console.log(chalk9.green(`\u2713 Registered template: ${templateName}`));
   console.log(chalk9.gray(`  Edit: ${targetPath}`));
-  console.log(chalk9.gray(`  Use with: lspec create <spec-name> --template=${templateName}`));
+  console.log(chalk9.gray(`  Use with: lean-spec create <spec-name> --template=${templateName}`));
 }
 
 // src/commands/init.ts
@@ -1523,7 +1527,56 @@ async function handleExistingFiles(action, existingFiles, templateDir, cwd, vari
     } catch {
       continue;
     }
-    if (action === "merge" && file === "AGENTS.md") {
+    if (action === "merge-ai" && file === "AGENTS.md") {
+      const existing = await fs9.readFile(filePath, "utf-8");
+      let template = await fs9.readFile(templateFilePath, "utf-8");
+      for (const [key, value] of Object.entries(variables)) {
+        template = template.replace(new RegExp(`\\{${key}\\}`, "g"), value);
+      }
+      const promptPath = path12.join(cwd, ".lean-spec", "MERGE-AGENTS-PROMPT.md");
+      const aiPrompt = `# AI Prompt: Consolidate AGENTS.md
+
+## Task
+Consolidate the existing AGENTS.md with LeanSpec instructions into a single, coherent document.
+
+## Instructions
+1. Read both documents below
+2. Merge them intelligently:
+   - Preserve ALL existing project-specific information (workflows, SOPs, architecture, conventions)
+   - Integrate LeanSpec sections where they fit naturally
+   - Remove redundancy and ensure coherent flow
+   - Keep the tone and style consistent
+3. Replace the existing AGENTS.md with the consolidated version
+
+## Existing AGENTS.md
+\`\`\`markdown
+${existing}
+\`\`\`
+
+## LeanSpec Instructions to Integrate
+\`\`\`markdown
+${template}
+\`\`\`
+
+## Output
+Create a single consolidated AGENTS.md that:
+- Keeps all existing project context and workflows
+- Adds LeanSpec commands and principles where appropriate
+- Maintains clear structure and readability
+- Removes any duplicate or conflicting guidance
+`;
+      await fs9.mkdir(path12.dirname(promptPath), { recursive: true });
+      await fs9.writeFile(promptPath, aiPrompt, "utf-8");
+      console.log(chalk10.green(`\u2713 Created AI consolidation prompt`));
+      console.log(chalk10.cyan(`  \u2192 ${promptPath}`));
+      console.log("");
+      console.log(chalk10.yellow("\u{1F4DD} Next steps:"));
+      console.log(chalk10.gray("  1. Open .lean-spec/MERGE-AGENTS-PROMPT.md"));
+      console.log(chalk10.gray("  2. Send it to your AI coding assistant (GitHub Copilot, Cursor, etc.)"));
+      console.log(chalk10.gray("  3. Let AI create the consolidated AGENTS.md"));
+      console.log(chalk10.gray("  4. Review and commit the result"));
+      console.log("");
+    } else if (action === "merge-append" && file === "AGENTS.md") {
       const existing = await fs9.readFile(filePath, "utf-8");
       let template = await fs9.readFile(templateFilePath, "utf-8");
       for (const [key, value] of Object.entries(variables)) {
@@ -1537,8 +1590,9 @@ async function handleExistingFiles(action, existingFiles, templateDir, cwd, vari
 
 ${template.split("\n").slice(1).join("\n")}`;
       await fs9.writeFile(filePath, merged, "utf-8");
-      console.log(chalk10.green(`\u2713 Merged LeanSpec section into ${file}`));
-    } else if (action === "backup") {
+      console.log(chalk10.green(`\u2713 Appended LeanSpec section to ${file}`));
+      console.log(chalk10.yellow("  \u26A0 Note: May be verbose. Consider consolidating later."));
+    } else if (action === "overwrite") {
       const backupPath = `${filePath}.backup`;
       await fs9.rename(filePath, backupPath);
       console.log(chalk10.yellow(`\u2713 Backed up ${file} \u2192 ${file}.backup`));
@@ -1548,6 +1602,7 @@ ${template.split("\n").slice(1).join("\n")}`;
       }
       await fs9.writeFile(filePath, content, "utf-8");
       console.log(chalk10.green(`\u2713 Created new ${file}`));
+      console.log(chalk10.gray(`  \u{1F4A1} Your original content is preserved in ${file}.backup`));
     }
   }
 }
@@ -1594,9 +1649,9 @@ var TEMPLATES_DIR = path13.join(__dirname2, "..", "templates");
 async function initProject() {
   const cwd = process.cwd();
   try {
-    await fs10.access(path13.join(cwd, ".lspec", "config.json"));
-    console.log(chalk11.yellow("LeanSpec already initialized in this directory."));
-    console.log(chalk11.gray("To reinitialize, delete .lspec/ directory first."));
+    await fs10.access(path13.join(cwd, ".lean-spec", "config.json"));
+    console.log(chalk11.yellow("\u26A0 LeanSpec already initialized in this directory."));
+    console.log(chalk11.gray("To reinitialize, delete .lean-spec/ directory first."));
     return;
   } catch {
   }
@@ -1615,12 +1670,13 @@ async function initProject() {
         name: "Choose template",
         value: "template",
         description: "Pick from: minimal, standard, enterprise"
-      },
-      {
-        name: "Customize everything",
-        value: "custom",
-        description: "Full control over structure and settings"
       }
+      // TODO: Re-enable when custom setup mode is implemented
+      // {
+      //   name: 'Customize everything',
+      //   value: 'custom',
+      //   description: 'Full control over structure and settings',
+      // },
     ]
   });
   let templateName = "standard";
@@ -1637,8 +1693,6 @@ async function initProject() {
         }
       ]
     });
-  } else if (setupMode === "custom") {
-    console.log(chalk11.yellow("Full customization coming soon. Using standard for now."));
   }
   const templateDir = path13.join(TEMPLATES_DIR, templateName);
   const templateConfigPath = path13.join(templateDir, "config.json");
@@ -1650,31 +1704,34 @@ async function initProject() {
     console.error(chalk11.red(`Error: Template not found: ${templateName}`));
     process.exit(1);
   }
-  const patternChoice = await select({
-    message: "Select folder pattern:",
-    choices: [
-      {
-        name: "Simple: 001-my-spec/",
-        value: "simple",
-        description: "Global sequential numbering (recommended)"
-      },
-      {
-        name: "Date-grouped: 20251105/001-my-spec/",
-        value: "date-grouped",
-        description: "Group specs by creation date (good for teams)"
-      },
-      {
-        name: "Flat with date: 20251105-001-my-spec/",
-        value: "date-prefix",
-        description: "Date prefix with global numbering"
-      },
-      {
-        name: "Custom pattern",
-        value: "custom",
-        description: "Enter your own pattern"
-      }
-    ]
-  });
+  let patternChoice = "simple";
+  if (setupMode !== "quick") {
+    patternChoice = await select({
+      message: "Select folder pattern:",
+      choices: [
+        {
+          name: "Simple: 001-my-spec/",
+          value: "simple",
+          description: "Global sequential numbering (recommended)"
+        },
+        {
+          name: "Date-grouped: 20251105/001-my-spec/",
+          value: "date-grouped",
+          description: "Group specs by creation date (good for teams)"
+        },
+        {
+          name: "Flat with date: 20251105-001-my-spec/",
+          value: "date-prefix",
+          description: "Date prefix with global numbering"
+        },
+        {
+          name: "Custom pattern",
+          value: "custom",
+          description: "Enter your own pattern"
+        }
+      ]
+    });
+  }
   if (patternChoice === "simple") {
     templateConfig.structure.pattern = "flat";
     templateConfig.structure.prefix = "";
@@ -1688,13 +1745,13 @@ async function initProject() {
   } else if (patternChoice === "custom") {
     console.log("");
     console.log(chalk11.yellow("\u26A0 Custom pattern input is not yet implemented."));
-    console.log(chalk11.gray("  You can manually edit .lspec/config.json after initialization."));
+    console.log(chalk11.gray("  You can manually edit .lean-spec/config.json after initialization."));
     console.log(chalk11.gray("  Using simple pattern for now."));
     console.log("");
     templateConfig.structure.pattern = "flat";
     templateConfig.structure.prefix = "";
   }
-  const templatesDir = path13.join(cwd, ".lspec", "templates");
+  const templatesDir = path13.join(cwd, ".lean-spec", "templates");
   try {
     await fs10.mkdir(templatesDir, { recursive: true });
   } catch (error) {
@@ -1705,7 +1762,7 @@ async function initProject() {
   const targetSpecPath = path13.join(templatesDir, "spec-template.md");
   try {
     await fs10.copyFile(templateSpecPath, targetSpecPath);
-    console.log(chalk11.green("\u2713 Created .lspec/templates/spec-template.md"));
+    console.log(chalk11.green("\u2713 Created .lean-spec/templates/spec-template.md"));
   } catch (error) {
     console.error(chalk11.red("Error copying template:"), error);
     process.exit(1);
@@ -1715,29 +1772,34 @@ async function initProject() {
     default: "spec-template.md"
   };
   await saveConfig(templateConfig, cwd);
-  console.log(chalk11.green("\u2713 Created .lspec/config.json"));
+  console.log(chalk11.green("\u2713 Created .lean-spec/config.json"));
   const existingFiles = await detectExistingSystemPrompts(cwd);
   let skipFiles = [];
   if (existingFiles.length > 0) {
     console.log("");
     console.log(chalk11.yellow(`Found existing: ${existingFiles.join(", ")}`));
     const action = await select({
-      message: "How would you like to proceed?",
+      message: "How would you like to handle existing AGENTS.md?",
       choices: [
         {
-          name: "Merge - Add LeanSpec section to existing files",
-          value: "merge",
-          description: "Appends LeanSpec guidance to your existing AGENTS.md"
+          name: "AI-Assisted Merge (recommended)",
+          value: "merge-ai",
+          description: "Creates prompt for AI to intelligently consolidate both files"
+        },
+        {
+          name: "Simple Append",
+          value: "merge-append",
+          description: "Quickly appends LeanSpec section (may be verbose)"
         },
         {
-          name: "Backup - Save existing and create new",
-          value: "backup",
-          description: "Renames existing files to .backup and creates fresh ones"
+          name: "Replace with LeanSpec",
+          value: "overwrite",
+          description: "Backs up existing, creates fresh AGENTS.md from template"
         },
         {
-          name: "Skip - Keep existing files as-is",
+          name: "Keep Existing Only",
           value: "skip",
-          description: "Only adds .lspec config and specs/ directory"
+          description: "Skips AGENTS.md, only adds .lean-spec config and specs/"
         }
       ]
     });
@@ -1762,7 +1824,7 @@ async function initProject() {
   console.log("Next steps:");
   console.log(chalk11.gray("  - Review and customize AGENTS.md"));
   console.log(chalk11.gray("  - Check out example spec in specs/"));
-  console.log(chalk11.gray("  - Create your first spec: lspec create my-feature"));
+  console.log(chalk11.gray("  - Create your first spec: lean-spec create my-feature"));
   console.log("");
 }
 
@@ -2728,6 +2790,220 @@ async function validateCommand(options = {}) {
   return !hasErrors;
 }
 
+// src/commands/migrate.ts
+import * as fs13 from "fs/promises";
+import * as path17 from "path";
+async function migrateCommand(inputPath, options = {}) {
+  const config = await loadConfig();
+  try {
+    const stats = await fs13.stat(inputPath);
+    if (!stats.isDirectory()) {
+      console.error("\x1B[31m\u274C Error:\x1B[0m Input path must be a directory");
+      process.exit(1);
+    }
+  } catch (error) {
+    console.error(`\x1B[31m\u274C Error:\x1B[0m Path not found: ${inputPath}`);
+    process.exit(1);
+  }
+  console.log(`\x1B[36mScanning:\x1B[0m ${inputPath}
+`);
+  const documents = await scanDocuments(inputPath);
+  if (documents.length === 0) {
+    console.error(`\x1B[31m\u274C Error:\x1B[0m No documents found in ${inputPath}`);
+    console.error("   Check path and try again");
+    process.exit(1);
+  }
+  console.log(`\x1B[32m\u2713\x1B[0m Found ${documents.length} document${documents.length === 1 ? "" : "s"}
+`);
+  if (options.aiProvider) {
+    await migrateWithAI(inputPath, documents, options);
+  } else {
+    await outputManualInstructions(inputPath, documents, config);
+  }
+}
+async function scanDocuments(dirPath) {
+  const documents = [];
+  async function scanRecursive(currentPath) {
+    const entries = await fs13.readdir(currentPath, { withFileTypes: true });
+    for (const entry of entries) {
+      const fullPath = path17.join(currentPath, entry.name);
+      if (entry.isDirectory()) {
+        if (!entry.name.startsWith(".") && entry.name !== "node_modules") {
+          await scanRecursive(fullPath);
+        }
+      } else if (entry.isFile()) {
+        if (entry.name.endsWith(".md") || entry.name.endsWith(".markdown")) {
+          const stats = await fs13.stat(fullPath);
+          documents.push({
+            path: fullPath,
+            name: entry.name,
+            size: stats.size
+          });
+        }
+      }
+    }
+  }
+  await scanRecursive(dirPath);
+  return documents;
+}
+async function outputManualInstructions(inputPath, documents, config) {
+  const specsDir = config.specsDir || "specs";
+  console.log("\u2550".repeat(70));
+  console.log("\x1B[1m\x1B[36m\u{1F4CB} LeanSpec Migration Instructions\x1B[0m");
+  console.log("\u2550".repeat(70));
+  console.log();
+  console.log("\x1B[1mSource Location:\x1B[0m");
+  console.log(`  ${inputPath} (${documents.length} documents found)`);
+  console.log();
+  console.log("\x1B[1mMigration Prompt:\x1B[0m");
+  console.log("  Copy this prompt to your AI assistant (Copilot, Claude, ChatGPT, etc.):");
+  console.log();
+  console.log("\u2500".repeat(70));
+  console.log();
+  console.log("You are helping migrate specification documents to LeanSpec format.");
+  console.log();
+  console.log(`\x1B[1mSource:\x1B[0m ${inputPath}`);
+  console.log();
+  console.log("\x1B[1mYour Task:\x1B[0m");
+  console.log("1. Analyze the source documents to understand their format and structure");
+  console.log("2. For each document, extract:");
+  console.log("   - Title/name");
+  console.log("   - Status (map to: planned, in-progress, complete, archived)");
+  console.log("   - Creation date");
+  console.log("   - Priority (if present)");
+  console.log("   - Main content sections");
+  console.log("   - Relationships to other documents");
+  console.log();
+  console.log("3. Migrate each document by running these commands:");
+  console.log();
+  console.log("   # Create spec");
+  console.log("   lean-spec create <name>");
+  console.log();
+  console.log("   # Set metadata (NEVER edit frontmatter manually)");
+  console.log("   lean-spec update <name> --status <status>");
+  console.log("   lean-spec update <name> --priority <priority>");
+  console.log("   lean-spec update <name> --tags <tag1,tag2>");
+  console.log();
+  console.log("   # Edit content with your preferred tool");
+  console.log("   # Map original sections to LeanSpec structure:");
+  console.log("   # - Overview: Problem statement and context");
+  console.log("   # - Design: Technical approach and decisions");
+  console.log("   # - Plan: Implementation steps (if applicable)");
+  console.log("   # - Test: Validation criteria (if applicable)");
+  console.log("   # - Notes: Additional context, trade-offs, alternatives");
+  console.log();
+  console.log("4. After migration, run:");
+  console.log();
+  console.log("   lean-spec validate  # Check for issues");
+  console.log("   lean-spec board     # Verify migration");
+  console.log();
+  console.log("\x1B[1mImportant Rules:\x1B[0m");
+  console.log("- Preserve decision rationale and context");
+  console.log("- Map status appropriately to LeanSpec states");
+  console.log("- Link related specs using `related` field (manual frontmatter edit)");
+  console.log("- Follow LeanSpec first principles: clarity over completeness");
+  console.log("- Keep specs under 400 lines (split if needed)");
+  console.log();
+  console.log("\u2500".repeat(70));
+  console.log();
+  console.log("\x1B[36m\u2139\x1B[0m  \x1B[1mTip:\x1B[0m For AI-assisted migration, use:");
+  console.log("   \x1B[90mlean-spec migrate <path> --with copilot\x1B[0m");
+  console.log();
+}
+async function migrateWithAI(inputPath, documents, options) {
+  const provider = options.aiProvider;
+  console.log(`\x1B[36m\u{1F916} AI-Assisted Migration:\x1B[0m ${provider}
+`);
+  const tool = await verifyAITool(provider);
+  if (!tool.installed) {
+    console.error(`\x1B[31m\u274C ${tool.name} CLI not found\x1B[0m`);
+    console.error(`   Install: ${tool.installCmd}`);
+    console.error("   Or run without --with flag for manual instructions");
+    process.exit(1);
+  }
+  if (!tool.compatible) {
+    console.error(`\x1B[31m\u274C ${tool.name} version ${tool.version} too old\x1B[0m`);
+    console.error(`   Required: >=${tool.minVersion}`);
+    console.error(`   Update: ${tool.updateCmd}`);
+    process.exit(1);
+  }
+  console.log(`\x1B[32m\u2713\x1B[0m ${tool.name} CLI verified (v${tool.version})
+`);
+  console.log("\x1B[33m\u26A0 AI-assisted migration is not yet fully implemented\x1B[0m");
+  console.log("  This feature will automatically execute migration via AI CLI tools.");
+  console.log();
+  console.log("  For now, use manual mode (without --with flag) to get migration instructions.");
+  console.log();
+}
+async function verifyAITool(provider) {
+  const tools = {
+    copilot: {
+      name: "GitHub Copilot CLI",
+      cliCommand: "github-copilot-cli",
+      installCmd: "npm install -g @githubnext/github-copilot-cli",
+      updateCmd: "npm update -g @githubnext/github-copilot-cli",
+      versionCmd: "github-copilot-cli --version",
+      minVersion: "0.1.0"
+    },
+    claude: {
+      name: "Claude CLI",
+      cliCommand: "claude",
+      installCmd: "pip install claude-cli",
+      updateCmd: "pip install --upgrade claude-cli",
+      versionCmd: "claude --version",
+      minVersion: "1.0.0"
+    },
+    gemini: {
+      name: "Gemini CLI",
+      cliCommand: "gemini-cli",
+      installCmd: "npm install -g @google/gemini-cli",
+      updateCmd: "npm update -g @google/gemini-cli",
+      versionCmd: "gemini-cli --version",
+      minVersion: "1.0.0"
+    }
+  };
+  const toolDef = tools[provider];
+  let installed = false;
+  let version;
+  try {
+    const { execSync: execSync3 } = await import("child_process");
+    execSync3(`which ${toolDef.cliCommand}`, { stdio: "ignore" });
+    installed = true;
+    try {
+      const versionOutput = execSync3(toolDef.versionCmd, {
+        encoding: "utf-8",
+        stdio: ["ignore", "pipe", "ignore"]
+      });
+      const versionMatch = versionOutput.match(/(\d+\.\d+\.\d+)/);
+      if (versionMatch) {
+        version = versionMatch[1];
+      }
+    } catch {
+      version = "unknown";
+    }
+  } catch {
+    installed = false;
+  }
+  const compatible = installed && (version === "unknown" || version !== void 0 && satisfiesVersion(version, toolDef.minVersion));
+  return {
+    ...toolDef,
+    installed,
+    version,
+    compatible
+  };
+}
+function satisfiesVersion(version, minVersion) {
+  const vParts = version.split(".").map(Number);
+  const minParts = minVersion.split(".").map(Number);
+  for (let i = 0; i < 3; i++) {
+    const v = vParts[i] || 0;
+    const min = minParts[i] || 0;
+    if (v > min) return true;
+    if (v < min) return false;
+  }
+  return true;
+}
+
 // src/commands/board.ts
 import chalk15 from "chalk";
 
@@ -3035,7 +3311,7 @@ function renderColumn(title, emoji, specs, expanded, colorFn) {
     }
     console.log("");
   } else if (!expanded && specs.length > 0) {
-    console.log(`  ${chalk15.dim("(collapsed, use --show-complete to expand)")}`);
+    console.log(`  ${chalk15.dim("(collapsed, use --complete to expand)")}`);
     console.log("");
   } else {
     console.log(`  ${chalk15.dim("(empty)")}`);
@@ -3316,9 +3592,9 @@ async function statsCommand(options) {
     console.log(`  Throughput       ${chalk16.cyan((velocityMetrics.throughput.perWeek / 7 * 7).toFixed(1))}/week ${throughputTrend}`);
     console.log(`  WIP              ${chalk16.yellow(velocityMetrics.wip.current)} specs`);
     console.log("");
-    console.log(chalk16.dim("\u{1F4A1} Use `lspec stats --full` for detailed analytics"));
-    console.log(chalk16.dim("   Use `lspec stats --velocity` for velocity breakdown"));
-    console.log(chalk16.dim("   Use `lspec stats --timeline` for activity timeline"));
+    console.log(chalk16.dim("\u{1F4A1} Use `lean-spec stats --full` for detailed analytics"));
+    console.log(chalk16.dim("   Use `lean-spec stats --velocity` for velocity breakdown"));
+    console.log(chalk16.dim("   Use `lean-spec stats --timeline` for activity timeline"));
     console.log("");
     return;
   }
@@ -3665,12 +3941,12 @@ function escapeRegex(str) {
 
 // src/commands/deps.ts
 import chalk18 from "chalk";
-import * as path17 from "path";
+import * as path18 from "path";
 async function depsCommand(specPath, options) {
   await autoCheckIfEnabled();
   const config = await loadConfig();
   const cwd = process.cwd();
-  const specsDir = path17.join(cwd, config.specsDir);
+  const specsDir = path18.join(cwd, config.specsDir);
   const resolvedPath = await resolveSpecPath(specPath, cwd, specsDir);
   if (!resolvedPath) {
     throw new Error(`Spec not found: ${sanitizeUserInput(specPath)}`);
@@ -3701,26 +3977,28 @@ async function depsCommand(specPath, options) {
   console.log("");
   console.log(chalk18.green(`\u{1F4E6} Dependencies for ${chalk18.cyan(sanitizeUserInput(spec.path))}`));
   console.log("");
-  console.log(chalk18.bold("Depends On:"));
+  const hasAnyRelationships = dependsOn.length > 0 || blocks.length > 0 || relatedSpecs.length > 0;
+  if (!hasAnyRelationships) {
+    console.log(chalk18.gray("  No dependencies or relationships"));
+    console.log("");
+    return;
+  }
   if (dependsOn.length > 0) {
+    console.log(chalk18.bold("Depends On:"));
     for (const dep of dependsOn) {
       const status = getStatusIndicator(dep.frontmatter.status);
       console.log(`  \u2192 ${sanitizeUserInput(dep.path)} ${status}`);
     }
-  } else {
-    console.log(chalk18.gray("  (none)"));
+    console.log("");
   }
-  console.log("");
-  console.log(chalk18.bold("Blocks:"));
   if (blocks.length > 0) {
+    console.log(chalk18.bold("Required By:"));
     for (const blocked of blocks) {
       const status = getStatusIndicator(blocked.frontmatter.status);
       console.log(`  \u2190 ${sanitizeUserInput(blocked.path)} ${status}`);
     }
-  } else {
-    console.log(chalk18.gray("  (none)"));
+    console.log("");
   }
-  console.log("");
   if (relatedSpecs.length > 0) {
     console.log(chalk18.bold("Related Specs:"));
     for (const rel of relatedSpecs) {
@@ -4183,8 +4461,8 @@ function renderTimelineBar(spec, startDate, endDate, weeks, today) {
 }
 
 // src/commands/viewer.ts
-import * as fs13 from "fs/promises";
-import * as path18 from "path";
+import * as fs14 from "fs/promises";
+import * as path19 from "path";
 import chalk21 from "chalk";
 import { marked } from "marked";
 import { markedTerminal } from "marked-terminal";
@@ -4192,7 +4470,7 @@ import { spawn } from "child_process";
 marked.use(markedTerminal());
 async function readSpecContent(specPath, cwd = process.cwd()) {
   const config = await loadConfig(cwd);
-  const specsDir = path18.join(cwd, config.specsDir);
+  const specsDir = path19.join(cwd, config.specsDir);
   let resolvedPath = null;
   let targetFile = null;
   const pathParts = specPath.split("/").filter((p) => p);
@@ -4201,9 +4479,9 @@ async function readSpecContent(specPath, cwd = process.cwd()) {
     const filePart = pathParts[pathParts.length - 1];
     resolvedPath = await resolveSpecPath(specPart, cwd, specsDir);
     if (resolvedPath) {
-      targetFile = path18.join(resolvedPath, filePart);
+      targetFile = path19.join(resolvedPath, filePart);
       try {
-        await fs13.access(targetFile);
+        await fs14.access(targetFile);
       } catch {
         return null;
       }
@@ -4222,8 +4500,8 @@ async function readSpecContent(specPath, cwd = process.cwd()) {
   if (!targetFile) {
     return null;
   }
-  const rawContent = await fs13.readFile(targetFile, "utf-8");
-  const fileName = path18.basename(targetFile);
+  const rawContent = await fs14.readFile(targetFile, "utf-8");
+  const fileName = path19.basename(targetFile);
   const isSubSpec = fileName !== config.structure.defaultFile;
   let frontmatter = null;
   if (!isSubSpec) {
@@ -4252,7 +4530,7 @@ async function readSpecContent(specPath, cwd = process.cwd()) {
     }
   }
   const content = lines.slice(contentStartIndex).join("\n").trim();
-  const specName = path18.basename(resolvedPath);
+  const specName = path19.basename(resolvedPath);
   const displayName = isSubSpec ? `${specName}/${fileName}` : specName;
   return {
     frontmatter,
@@ -4319,7 +4597,7 @@ function displayFormattedSpec(spec) {
 async function viewCommand(specPath, options = {}) {
   const spec = await readSpecContent(specPath, process.cwd());
   if (!spec) {
-    throw new Error(`Spec not found: ${specPath}. Try: lspec list`);
+    throw new Error(`Spec not found: ${specPath}. Try: lean-spec list`);
   }
   if (options.json) {
     const jsonOutput = {
@@ -4342,7 +4620,7 @@ async function viewCommand(specPath, options = {}) {
 async function openCommand(specPath, options = {}) {
   const cwd = process.cwd();
   const config = await loadConfig(cwd);
-  const specsDir = path18.join(cwd, config.specsDir);
+  const specsDir = path19.join(cwd, config.specsDir);
   let resolvedPath = null;
   let targetFile = null;
   const pathParts = specPath.split("/").filter((p) => p);
@@ -4351,9 +4629,9 @@ async function openCommand(specPath, options = {}) {
     const filePart = pathParts[pathParts.length - 1];
     resolvedPath = await resolveSpecPath(specPart, cwd, specsDir);
     if (resolvedPath) {
-      targetFile = path18.join(resolvedPath, filePart);
+      targetFile = path19.join(resolvedPath, filePart);
       try {
-        await fs13.access(targetFile);
+        await fs14.access(targetFile);
       } catch {
         targetFile = null;
       }
@@ -4432,7 +4710,6 @@ async function mcpCommand() {
 }
 
 // src/mcp-server.ts
-import * as path19 from "path";
 function formatErrorMessage(prefix, error) {
   const errorMsg = error instanceof Error ? error.message : String(error);
   return `${prefix}: ${errorMsg}`;
@@ -4496,20 +4773,22 @@ async function searchSpecsData(query, options) {
   return results;
 }
 async function readSpecData(specPath) {
-  const config = await loadConfig();
   const cwd = process.cwd();
-  const specsDir = path19.join(cwd, config.specsDir);
-  const resolvedPath = await resolveSpecPath(specPath, cwd, specsDir);
-  if (!resolvedPath) {
-    throw new Error(`Spec not found: ${specPath}`);
-  }
-  const specInfo = await getSpec(resolvedPath);
-  if (!specInfo) {
+  const specContent = await readSpecContent(specPath, cwd);
+  if (!specContent) {
     throw new Error(`Spec not found: ${specPath}`);
   }
   return {
-    spec: specToData(specInfo),
-    content: specInfo.content || ""
+    spec: {
+      name: specContent.name,
+      path: specContent.path,
+      status: specContent.frontmatter.status,
+      created: String(specContent.frontmatter.created),
+      priority: specContent.frontmatter.priority,
+      tags: specContent.frontmatter.tags,
+      assignee: specContent.frontmatter.assignee
+    },
+    content: specContent.content
   };
 }
 async function getStatsData() {
@@ -4665,7 +4944,7 @@ async function createMcpServer() {
       title: "View Spec",
       description: "Read the complete content of a specification. Use this to understand spec details, review design decisions, or check implementation status. Returns metadata and full content.",
       inputSchema: {
-        specPath: z.string().describe('The spec to view. Can be: spec name (e.g., "unified-dashboard"), sequence number (e.g., "045" or "45"), or full folder name (e.g., "045-unified-dashboard").'),
+        specPath: z.string().describe('The spec to view. Can be: spec name (e.g., "unified-dashboard"), sequence number (e.g., "045" or "45"), full folder name (e.g., "045-unified-dashboard"), or sub-spec file (e.g., "045/DESIGN.md" or "unified-dashboard/TESTING.md").'),
         raw: z.boolean().optional().describe("Output raw markdown instead of formatted"),
         json: z.boolean().optional().describe("Output as JSON instead of formatted")
       },
@@ -5354,6 +5633,7 @@ export {
   initProject,
   filesCommand,
   validateCommand,
+  migrateCommand,
   boardCommand,
   statsCommand,
   searchCommand,
@@ -5365,4 +5645,4 @@ export {
   createMcpServer,
   mcpCommand
 };
-//# sourceMappingURL=chunk-GLXYUS7F.js.map
+//# sourceMappingURL=chunk-S6TGAL75.js.map