lean-spec 0.2.5 → 0.2.6-dev.20251125015611

package/dist/{chunk-7WXYOHZU.js → chunk-RTEGSMVL.js}

@@ -3,12 +3,12 @@ import { McpServer, ResourceTemplate } from '@modelcontextprotocol/sdk/server/mc
 import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
 import { readFileSync, existsSync } from 'fs';
 import { fileURLToPath } from 'url';
-import * as path4 from 'path';
+import * as path15 from 'path';
 import { dirname, join, resolve } from 'path';
 import { z } from 'zod';
 import * as fs9 from 'fs/promises';
 import { readFile, writeFile } from 'fs/promises';
-import chalk18 from 'chalk';
+import chalk19 from 'chalk';
 import matter2 from 'gray-matter';
 import yaml2 from 'js-yaml';
 import { Command } from 'commander';
@@ -16,7 +16,6 @@ import { execSync, spawn } from 'child_process';
 import ora from 'ora';
 import stripAnsi from 'strip-ansi';
 import { select } from '@inquirer/prompts';
-import { encoding_for_model } from 'tiktoken';
 import dayjs3 from 'dayjs';
 import { marked } from 'marked';
 import { markedTerminal } from 'marked-terminal';
@@ -42,7 +41,7 @@ var DEFAULT_CONFIG = {
   }
 };
 async function loadConfig(cwd = process.cwd()) {
-  const configPath = path4.join(cwd, ".lean-spec", "config.json");
+  const configPath = path15.join(cwd, ".lean-spec", "config.json");
   try {
     const content = await fs9.readFile(configPath, "utf-8");
     const userConfig = JSON.parse(content);
@@ -54,8 +53,8 @@ async function loadConfig(cwd = process.cwd()) {
   }
 }
 async function saveConfig(config, cwd = process.cwd()) {
-  const configDir = path4.join(cwd, ".lean-spec");
-  const configPath = path4.join(configDir, "config.json");
+  const configDir = path15.join(cwd, ".lean-spec");
+  const configPath = path15.join(configDir, "config.json");
   await fs9.mkdir(configDir, { recursive: true });
   await fs9.writeFile(configPath, JSON.stringify(config, null, 2), "utf-8");
 }
@@ -154,7 +153,7 @@ async function getGlobalNextSeq(specsDir, digits) {
             }
           }
           if (entry.name === "archived") continue;
-          const subDir = path4.join(dir, entry.name);
+          const subDir = path15.join(dir, entry.name);
           await scanDirectory(subDir);
         }
       } catch {
@@ -171,7 +170,7 @@ async function getGlobalNextSeq(specsDir, digits) {
   }
 }
 async function resolveSpecPath(specPath, cwd, specsDir) {
-  if (path4.isAbsolute(specPath)) {
+  if (path15.isAbsolute(specPath)) {
     try {
       await fs9.access(specPath);
       return specPath;
@@ -179,13 +178,13 @@ async function resolveSpecPath(specPath, cwd, specsDir) {
       return null;
     }
   }
-  const cwdPath = path4.resolve(cwd, specPath);
+  const cwdPath = path15.resolve(cwd, specPath);
   try {
     await fs9.access(cwdPath);
     return cwdPath;
   } catch {
   }
-  const specsPath = path4.join(specsDir, specPath);
+  const specsPath = path15.join(specsDir, specPath);
   try {
     await fs9.access(specsPath);
     return specsPath;
@@ -212,10 +211,10 @@ async function searchBySequence(specsDir, seqNum) {
         if (match) {
           const entrySeq = parseInt(match[1], 10);
           if (entrySeq === seqNum) {
-            return path4.join(dir, entry.name);
+            return path15.join(dir, entry.name);
           }
         }
-        const subDir = path4.join(dir, entry.name);
+        const subDir = path15.join(dir, entry.name);
         const result = await scanDirectory(subDir);
         if (result) return result;
       }
@@ -232,9 +231,9 @@ async function searchInAllDirectories(specsDir, specName) {
       for (const entry of entries) {
         if (!entry.isDirectory()) continue;
         if (entry.name === specName) {
-          return path4.join(dir, entry.name);
+          return path15.join(dir, entry.name);
         }
-        const subDir = path4.join(dir, entry.name);
+        const subDir = path15.join(dir, entry.name);
         const result = await scanDirectory(subDir);
         if (result) return result;
       }
@@ -265,7 +264,7 @@ async function getGitInfo() {
 }
 async function getProjectName(cwd = process.cwd()) {
   try {
-    const packageJsonPath = path4.join(cwd, "package.json");
+    const packageJsonPath = path15.join(cwd, "package.json");
     const content = await fs9.readFile(packageJsonPath, "utf-8");
     const packageJson2 = JSON.parse(content);
     return packageJson2.name || null;
@@ -354,9 +353,9 @@ async function loadSubFiles(specDir, options = {}) {
     for (const entry of entries) {
       if (entry.name === "README.md") continue;
       if (entry.isDirectory()) continue;
-      const filePath = path4.join(specDir, entry.name);
+      const filePath = path15.join(specDir, entry.name);
       const stat6 = await fs9.stat(filePath);
-      const ext = path4.extname(entry.name).toLowerCase();
+      const ext = path15.extname(entry.name).toLowerCase();
       const isDocument = ext === ".md";
       const subFile = {
         name: entry.name,
@@ -382,7 +381,7 @@ async function loadSubFiles(specDir, options = {}) {
 async function loadAllSpecs(options = {}) {
   const config = await loadConfig();
   const cwd = process.cwd();
-  const specsDir = path4.join(cwd, config.specsDir);
+  const specsDir = path15.join(cwd, config.specsDir);
   const specs = [];
   try {
     await fs9.access(specsDir);
@@ -396,7 +395,7 @@ async function loadAllSpecs(options = {}) {
       for (const entry of entries) {
         if (!entry.isDirectory()) continue;
         if (entry.name === "archived" && relativePath === "") continue;
-        const entryPath = path4.join(dir, entry.name);
+        const entryPath = path15.join(dir, entry.name);
         const entryRelativePath = relativePath ? `${relativePath}/${entry.name}` : entry.name;
         if (specPattern.test(entry.name)) {
           const specFile = await getSpecFile(entryPath, config.structure.defaultFile);
@@ -445,7 +444,7 @@ async function loadAllSpecs(options = {}) {
   }
   await loadSpecsFromDir(specsDir);
   if (options.includeArchived) {
-    const archivedPath = path4.join(specsDir, "archived");
+    const archivedPath = path15.join(specsDir, "archived");
     await loadSpecsFromDir(archivedPath, "archived");
   }
   const sortBy = options.sortBy || "id";
@@ -493,12 +492,12 @@ async function loadAllSpecs(options = {}) {
 async function getSpec(specPath) {
   const config = await loadConfig();
   const cwd = process.cwd();
-  const specsDir = path4.join(cwd, config.specsDir);
+  const specsDir = path15.join(cwd, config.specsDir);
   let fullPath;
-  if (path4.isAbsolute(specPath)) {
+  if (path15.isAbsolute(specPath)) {
     fullPath = specPath;
   } else {
-    fullPath = path4.join(specsDir, specPath);
+    fullPath = path15.join(specsDir, specPath);
   }
   try {
     await fs9.access(fullPath);
@@ -510,8 +509,8 @@ async function getSpec(specPath) {
   const frontmatter = await parseFrontmatter(specFile, config);
   if (!frontmatter) return null;
   const content = await fs9.readFile(specFile, "utf-8");
-  const relativePath = path4.relative(specsDir, fullPath);
-  const parts = relativePath.split(path4.sep);
+  const relativePath = path15.relative(specsDir, fullPath);
+  const parts = relativePath.split(path15.sep);
   const date = parts[0] === "archived" ? parts[1] : parts[0];
   const name = parts[parts.length - 1];
   return {
@@ -551,7 +550,7 @@ async function withSpinner(text, fn, options) {
 
 // src/commands/check.ts
 function checkCommand() {
-  return new Command("check").description("Check for sequence conflicts").option("-q, --quiet", "Brief output").action(async (options) => {
+  return new Command("check").description("Check for sequence conflicts").option("-q, --quiet", "Brief output").option("--json", "Output as JSON").action(async (options) => {
     const hasNoConflicts = await checkSpecs(options);
     process.exit(hasNoConflicts ? 0 : 1);
   });
@@ -559,12 +558,12 @@ function checkCommand() {
 async function checkSpecs(options = {}) {
   const config = await loadConfig();
   const cwd = process.cwd();
-  path4.join(cwd, config.specsDir);
+  path15.join(cwd, config.specsDir);
   const specs = await loadAllSpecs();
   const sequenceMap = /* @__PURE__ */ new Map();
   const specPattern = createSpecDirPattern();
   for (const spec of specs) {
-    const specName = path4.basename(spec.path);
+    const specName = path15.basename(spec.path);
     const match = specName.match(specPattern);
     if (match) {
       const seq = parseInt(match[1], 10);
@@ -579,30 +578,45 @@ async function checkSpecs(options = {}) {
   const conflicts = Array.from(sequenceMap.entries()).filter(([_, paths]) => paths.length > 1).sort(([a], [b]) => a - b);
   if (conflicts.length === 0) {
     if (!options.quiet && !options.silent) {
-      console.log(chalk18.green("\u2713 No sequence conflicts detected"));
+      if (options.json) {
+        console.log(JSON.stringify({ conflicts: [], hasConflicts: false }, null, 2));
+      } else {
+        console.log(chalk19.green("\u2713 No sequence conflicts detected"));
+      }
     }
     return true;
   }
+  if (options.json) {
+    const jsonOutput = {
+      hasConflicts: true,
+      conflicts: conflicts.map(([seq, paths]) => ({
+        sequence: seq,
+        specs: paths
+      }))
+    };
+    console.log(JSON.stringify(jsonOutput, null, 2));
+    return false;
+  }
   if (!options.silent) {
     if (!options.quiet) {
       console.log("");
-      console.log(chalk18.yellow("\u26A0\uFE0F  Sequence conflicts detected:\n"));
+      console.log(chalk19.yellow("\u26A0\uFE0F  Sequence conflicts detected:\n"));
       for (const [seq, paths] of conflicts) {
-        console.log(chalk18.red(`  Sequence ${String(seq).padStart(config.structure.sequenceDigits, "0")}:`));
+        console.log(chalk19.red(`  Sequence ${String(seq).padStart(config.structure.sequenceDigits, "0")}:`));
         for (const p of paths) {
-          console.log(chalk18.gray(`    - ${sanitizeUserInput(p)}`));
+          console.log(chalk19.gray(`    - ${sanitizeUserInput(p)}`));
         }
         console.log("");
       }
-      console.log(chalk18.cyan("Tip: Use date prefix to prevent conflicts:"));
-      console.log(chalk18.gray('  Edit .lean-spec/config.json \u2192 structure.prefix: "{YYYYMMDD}-"'));
+      console.log(chalk19.cyan("Tip: Use date prefix to prevent conflicts:"));
+      console.log(chalk19.gray('  Edit .lean-spec/config.json \u2192 structure.prefix: "{YYYYMMDD}-"'));
       console.log("");
-      console.log(chalk18.cyan("Or rename folders manually to resolve."));
+      console.log(chalk19.cyan("Or rename folders manually to resolve."));
       console.log("");
     } else {
       console.log("");
-      console.log(chalk18.yellow(`\u26A0\uFE0F  Conflict warning: ${conflicts.length} sequence conflict(s) detected`));
-      console.log(chalk18.gray("Run: lean-spec check"));
+      console.log(chalk19.yellow(`\u26A0\uFE0F  Conflict warning: ${conflicts.length} sequence conflict(s) detected`));
+      console.log(chalk19.gray("Run: lean-spec check"));
       console.log("");
     }
   }
@@ -655,7 +669,7 @@ function createCommand() {
 async function createSpec(name, options = {}) {
   const config = await loadConfig();
   const cwd = process.cwd();
-  const specsDir = path4.join(cwd, config.specsDir);
+  const specsDir = path15.join(cwd, config.specsDir);
   await fs9.mkdir(specsDir, { recursive: true });
   const seq = await getGlobalNextSeq(specsDir, config.structure.sequenceDigits);
   let specRelativePath;
@@ -676,8 +690,8 @@ async function createSpec(name, options = {}) {
   } else {
     throw new Error(`Unknown pattern: ${config.structure.pattern}`);
   }
-  const specDir = path4.join(specsDir, specRelativePath);
-  const specFile = path4.join(specDir, config.structure.defaultFile);
+  const specDir = path15.join(specsDir, specRelativePath);
+  const specFile = path15.join(specDir, config.structure.defaultFile);
   try {
     await fs9.access(specDir);
     throw new Error(`Spec already exists: ${sanitizeUserInput(specDir)}`);
@@ -687,7 +701,7 @@ async function createSpec(name, options = {}) {
     }
   }
   await fs9.mkdir(specDir, { recursive: true });
-  const templatesDir = path4.join(cwd, ".lean-spec", "templates");
+  const templatesDir = path15.join(cwd, ".lean-spec", "templates");
   let templateName;
   if (options.template) {
     if (config.templates?.[options.template]) {
@@ -699,13 +713,33 @@ async function createSpec(name, options = {}) {
   } else {
     templateName = config.template || "spec-template.md";
   }
-  const templatePath = path4.join(templatesDir, templateName);
+  let templatePath = path15.join(templatesDir, templateName);
+  try {
+    await fs9.access(templatePath);
+  } catch {
+    const legacyPath = path15.join(templatesDir, "spec-template.md");
+    try {
+      await fs9.access(legacyPath);
+      templatePath = legacyPath;
+      templateName = "spec-template.md";
+    } catch {
+      const readmePath = path15.join(templatesDir, "README.md");
+      try {
+        await fs9.access(readmePath);
+        templatePath = readmePath;
+        templateName = "README.md";
+      } catch {
+        throw new Error(`Template not found: ${templatePath}. Run: lean-spec init`);
+      }
+    }
+  }
   let content;
+  let varContext;
   try {
     const template = await fs9.readFile(templatePath, "utf-8");
     const date = (/* @__PURE__ */ new Date()).toISOString().split("T")[0];
     const title = options.title || name;
-    const varContext = await buildVariableContext(config, { name: title, date });
+    varContext = await buildVariableContext(config, { name: title, date });
     content = resolveVariables(template, varContext);
     const parsed = matter2(content, {
       engines: {
@@ -747,8 +781,29 @@ ${options.description}`
     throw new Error(`Template not found: ${templatePath}. Run: lean-spec init`);
   }
   await fs9.writeFile(specFile, content, "utf-8");
-  console.log(chalk18.green(`\u2713 Created: ${sanitizeUserInput(specDir)}/`));
-  console.log(chalk18.gray(`  Edit: ${sanitizeUserInput(specFile)}`));
+  try {
+    const templateFiles = await fs9.readdir(templatesDir);
+    const additionalFiles = templateFiles.filter(
+      (f) => f.endsWith(".md") && f !== templateName && f !== "spec-template.md" && f !== config.structure.defaultFile
+    );
+    if (additionalFiles.length > 0) {
+      for (const file of additionalFiles) {
+        const srcPath = path15.join(templatesDir, file);
+        const destPath = path15.join(specDir, file);
+        let fileContent = await fs9.readFile(srcPath, "utf-8");
+        fileContent = resolveVariables(fileContent, varContext);
+        await fs9.writeFile(destPath, fileContent, "utf-8");
+      }
+      console.log(chalk19.green(`\u2713 Created: ${sanitizeUserInput(specDir)}/`));
+      console.log(chalk19.gray(`  Files: ${config.structure.defaultFile}, ${additionalFiles.join(", ")}`));
+    } else {
+      console.log(chalk19.green(`\u2713 Created: ${sanitizeUserInput(specDir)}/`));
+      console.log(chalk19.gray(`  Edit: ${sanitizeUserInput(specFile)}`));
+    }
+  } catch (error) {
+    console.log(chalk19.green(`\u2713 Created: ${sanitizeUserInput(specDir)}/`));
+    console.log(chalk19.gray(`  Edit: ${sanitizeUserInput(specFile)}`));
+  }
   await autoCheckIfEnabled();
 }
 function archiveCommand() {
@@ -760,7 +815,7 @@ async function archiveSpec(specPath) {
   await autoCheckIfEnabled();
   const config = await loadConfig();
   const cwd = process.cwd();
-  const specsDir = path4.join(cwd, config.specsDir);
+  const specsDir = path15.join(cwd, config.specsDir);
   const resolvedPath = await resolveSpecPath(specPath, cwd, specsDir);
   if (!resolvedPath) {
     throw new Error(`Spec not found: ${sanitizeUserInput(specPath)}`);
@@ -769,12 +824,12 @@ async function archiveSpec(specPath) {
   if (specFile) {
     await updateFrontmatter(specFile, { status: "archived" });
   }
-  const archiveDir = path4.join(specsDir, "archived");
+  const archiveDir = path15.join(specsDir, "archived");
   await fs9.mkdir(archiveDir, { recursive: true });
-  const specName = path4.basename(resolvedPath);
-  const archivePath = path4.join(archiveDir, specName);
+  const specName = path15.basename(resolvedPath);
+  const archivePath = path15.join(archiveDir, specName);
   await fs9.rename(resolvedPath, archivePath);
-  console.log(chalk18.green(`\u2713 Archived: ${sanitizeUserInput(archivePath)}`));
+  console.log(chalk19.green(`\u2713 Archived: ${sanitizeUserInput(archivePath)}`));
 }
 
 // src/utils/pattern-detection.ts
@@ -804,59 +859,59 @@ var STATUS_CONFIG = {
   planned: {
     emoji: "\u{1F4C5}",
     label: "Planned",
-    colorFn: chalk18.blue,
-    badge: (s = "planned") => chalk18.blue(`[${s}]`)
+    colorFn: chalk19.blue,
+    badge: (s = "planned") => chalk19.blue(`[${s}]`)
   },
   "in-progress": {
     emoji: "\u23F3",
     label: "In Progress",
-    colorFn: chalk18.yellow,
-    badge: (s = "in-progress") => chalk18.yellow(`[${s}]`)
+    colorFn: chalk19.yellow,
+    badge: (s = "in-progress") => chalk19.yellow(`[${s}]`)
   },
   complete: {
     emoji: "\u2705",
     label: "Complete",
-    colorFn: chalk18.green,
-    badge: (s = "complete") => chalk18.green(`[${s}]`)
+    colorFn: chalk19.green,
+    badge: (s = "complete") => chalk19.green(`[${s}]`)
   },
   archived: {
     emoji: "\u{1F4E6}",
     label: "Archived",
-    colorFn: chalk18.gray,
-    badge: (s = "archived") => chalk18.gray(`[${s}]`)
+    colorFn: chalk19.gray,
+    badge: (s = "archived") => chalk19.gray(`[${s}]`)
   }
 };
 var PRIORITY_CONFIG = {
   critical: {
     emoji: "\u{1F534}",
-    colorFn: chalk18.red.bold,
-    badge: (s = "critical") => chalk18.red.bold(`[${s}]`)
+    colorFn: chalk19.red.bold,
+    badge: (s = "critical") => chalk19.red.bold(`[${s}]`)
   },
   high: {
     emoji: "\u{1F7E0}",
-    colorFn: chalk18.hex("#FFA500"),
-    badge: (s = "high") => chalk18.hex("#FFA500")(`[${s}]`)
+    colorFn: chalk19.hex("#FFA500"),
+    badge: (s = "high") => chalk19.hex("#FFA500")(`[${s}]`)
   },
   medium: {
     emoji: "\u{1F7E1}",
-    colorFn: chalk18.yellow,
-    badge: (s = "medium") => chalk18.yellow(`[${s}]`)
+    colorFn: chalk19.yellow,
+    badge: (s = "medium") => chalk19.yellow(`[${s}]`)
   },
   low: {
     emoji: "\u{1F7E2}",
-    colorFn: chalk18.gray,
-    badge: (s = "low") => chalk18.gray(`[${s}]`)
+    colorFn: chalk19.gray,
+    badge: (s = "low") => chalk19.gray(`[${s}]`)
   }
 };
 function formatStatusBadge(status) {
-  return STATUS_CONFIG[status]?.badge() || chalk18.white(`[${status}]`);
+  return STATUS_CONFIG[status]?.badge() || chalk19.white(`[${status}]`);
 }
 function formatPriorityBadge(priority) {
-  return PRIORITY_CONFIG[priority]?.badge() || chalk18.white(`[${priority}]`);
+  return PRIORITY_CONFIG[priority]?.badge() || chalk19.white(`[${priority}]`);
 }
 function getStatusIndicator(status) {
   const config = STATUS_CONFIG[status];
-  if (!config) return chalk18.gray("[unknown]");
+  if (!config) return chalk19.gray("[unknown]");
   return config.colorFn(`[${status}]`);
 }
 function getStatusEmoji(status) {
@@ -868,7 +923,7 @@ function getPriorityEmoji(priority) {
 
 // src/commands/list.ts
 function listCommand() {
-  return new Command("list").description("List all specs").option("--archived", "Include archived specs").option("--status <status>", "Filter by status (planned, in-progress, complete, archived)").option("--tag <tag...>", "Filter by tag (can specify multiple)").option("--priority <priority>", "Filter by priority (low, medium, high, critical)").option("--assignee <name>", "Filter by assignee").option("--field <name=value...>", "Filter by custom field (can specify multiple)").option("--sort <field>", "Sort by field (id, created, name, status, priority)", "id").option("--order <order>", "Sort order (asc, desc)", "desc").action(async (options) => {
+  return new Command("list").description("List all specs").option("--archived", "Include archived specs").option("--status <status>", "Filter by status (planned, in-progress, complete, archived)").option("--tag <tag...>", "Filter by tag (can specify multiple)").option("--priority <priority>", "Filter by priority (low, medium, high, critical)").option("--assignee <name>", "Filter by assignee").option("--field <name=value...>", "Filter by custom field (can specify multiple)").option("--sort <field>", "Sort by field (id, created, name, status, priority)", "id").option("--order <order>", "Sort order (asc, desc)", "desc").option("--json", "Output as JSON").action(async (options) => {
     const customFields = parseCustomFieldOptions(options.field);
     const listOptions = {
       showArchived: options.archived,
@@ -878,7 +933,8 @@ function listCommand() {
       assignee: options.assignee,
       customFields: Object.keys(customFields).length > 0 ? customFields : void 0,
       sortBy: options.sort || "id",
-      sortOrder: options.order || "desc"
+      sortOrder: options.order || "desc",
+      json: options.json
     };
     await listSpecs(listOptions);
   });
@@ -887,7 +943,7 @@ async function listSpecs(options = {}) {
   await autoCheckIfEnabled();
   const config = await loadConfig();
   const cwd = process.cwd();
-  const specsDir = path4.join(cwd, config.specsDir);
+  const specsDir = path15.join(cwd, config.specsDir);
   try {
     await fs9.access(specsDir);
   } catch {
@@ -914,10 +970,33 @@ async function listSpecs(options = {}) {
     })
   );
   if (specs.length === 0) {
-    console.log(chalk18.dim("No specs found."));
+    if (options.json) {
+      console.log(JSON.stringify({ specs: [], total: 0 }, null, 2));
+    } else {
+      console.log(chalk19.dim("No specs found."));
+    }
     return;
   }
-  console.log(chalk18.bold.cyan("\u{1F4C4} Spec List"));
+  if (options.json) {
+    const jsonOutput = {
+      specs: specs.map((spec) => ({
+        path: spec.path,
+        name: spec.name,
+        status: spec.frontmatter.status,
+        priority: spec.frontmatter.priority,
+        tags: spec.frontmatter.tags,
+        assignee: spec.frontmatter.assignee,
+        created: spec.frontmatter.created,
+        completed: spec.frontmatter.completed,
+        subFiles: spec.subFiles?.length || 0
+      })),
+      total: specs.length,
+      filter: options
+    };
+    console.log(JSON.stringify(jsonOutput, null, 2));
+    return;
+  }
+  console.log(chalk19.bold.cyan("\u{1F4C4} Spec List"));
   const filterParts = [];
   if (options.status) {
     const statusStr = Array.isArray(options.status) ? options.status.join(",") : options.status;
@@ -930,7 +1009,7 @@ async function listSpecs(options = {}) {
   }
   if (options.assignee) filterParts.push(`assignee=${options.assignee}`);
   if (filterParts.length > 0) {
-    console.log(chalk18.dim(`Filtered by: ${filterParts.join(", ")}`));
+    console.log(chalk19.dim(`Filtered by: ${filterParts.join(", ")}`));
   }
   console.log("");
   const patternInfo = detectPatternType(config);
@@ -940,7 +1019,7 @@ async function listSpecs(options = {}) {
     renderFlatList(specs);
   }
   console.log("");
-  console.log(chalk18.bold(`Total: ${chalk18.green(specs.length)} spec${specs.length !== 1 ? "s" : ""}`));
+  console.log(chalk19.bold(`Total: ${chalk19.green(specs.length)} spec${specs.length !== 1 ? "s" : ""}`));
 }
 function renderFlatList(specs) {
   for (const spec of specs) {
@@ -948,25 +1027,25 @@ function renderFlatList(specs) {
     const priorityEmoji = getPriorityEmoji(spec.frontmatter.priority);
     let assigneeStr = "";
     if (spec.frontmatter.assignee) {
-      assigneeStr = " " + chalk18.cyan(`@${sanitizeUserInput(spec.frontmatter.assignee)}`);
+      assigneeStr = " " + chalk19.cyan(`@${sanitizeUserInput(spec.frontmatter.assignee)}`);
     }
     let tagsStr = "";
     if (spec.frontmatter.tags?.length) {
       const tags = Array.isArray(spec.frontmatter.tags) ? spec.frontmatter.tags : [];
       if (tags.length > 0) {
         const tagStr = tags.map((tag) => `#${sanitizeUserInput(tag)}`).join(" ");
-        tagsStr = " " + chalk18.dim(chalk18.magenta(tagStr));
+        tagsStr = " " + chalk19.dim(chalk19.magenta(tagStr));
       }
     }
     let subSpecStr = "";
     if (spec.subFiles) {
       const docCount = spec.subFiles.filter((f) => f.type === "document").length;
       if (docCount > 0) {
-        subSpecStr = " " + chalk18.dim(chalk18.yellow(`(+${docCount} sub-spec${docCount > 1 ? "s" : ""})`));
+        subSpecStr = " " + chalk19.dim(chalk19.yellow(`(+${docCount} sub-spec${docCount > 1 ? "s" : ""})`));
       }
     }
     const priorityPrefix = priorityEmoji ? `${priorityEmoji} ` : "";
-    console.log(`${priorityPrefix}${statusEmoji} ${chalk18.cyan(sanitizeUserInput(spec.path))}${assigneeStr}${tagsStr}${subSpecStr}`);
+    console.log(`${priorityPrefix}${statusEmoji} ${chalk19.cyan(sanitizeUserInput(spec.path))}${assigneeStr}${tagsStr}${subSpecStr}`);
   }
 }
 function renderGroupedList(specs, groupExtractor) {
@@ -995,7 +1074,7 @@ function renderGroupedList(specs, groupExtractor) {
     const groupName = sortedGroups[i];
     const groupSpecs = groups.get(groupName);
     const groupEmoji = /^\d{8}$/.test(groupName) ? "\u{1F4C5}" : groupName.startsWith("milestone") ? "\u{1F3AF}" : "\u{1F4C1}";
-    console.log(`${chalk18.bold.cyan(`${groupEmoji} ${groupName}/`)} ${chalk18.dim(`(${groupSpecs.length})`)}`);
+    console.log(`${chalk19.bold.cyan(`${groupEmoji} ${groupName}/`)} ${chalk19.dim(`(${groupSpecs.length})`)}`);
     console.log("");
     for (const spec of groupSpecs) {
       const statusEmoji = getStatusEmoji(spec.frontmatter.status);
@@ -1003,25 +1082,25 @@ function renderGroupedList(specs, groupExtractor) {
       const displayPath = spec.path.includes("/") ? spec.path.split("/").slice(1).join("/") : spec.path;
       let assigneeStr = "";
       if (spec.frontmatter.assignee) {
-        assigneeStr = " " + chalk18.cyan(`@${sanitizeUserInput(spec.frontmatter.assignee)}`);
+        assigneeStr = " " + chalk19.cyan(`@${sanitizeUserInput(spec.frontmatter.assignee)}`);
       }
       let tagsStr = "";
       if (spec.frontmatter.tags?.length) {
         const tags = Array.isArray(spec.frontmatter.tags) ? spec.frontmatter.tags : [];
         if (tags.length > 0) {
           const tagStr = tags.map((tag) => `#${sanitizeUserInput(tag)}`).join(" ");
-          tagsStr = " " + chalk18.dim(chalk18.magenta(tagStr));
+          tagsStr = " " + chalk19.dim(chalk19.magenta(tagStr));
         }
       }
       let subSpecStr = "";
       if (spec.subFiles) {
         const docCount = spec.subFiles.filter((f) => f.type === "document").length;
         if (docCount > 0) {
-          subSpecStr = " " + chalk18.dim(chalk18.yellow(`(+${docCount} sub-spec${docCount > 1 ? "s" : ""})`));
+          subSpecStr = " " + chalk19.dim(chalk19.yellow(`(+${docCount} sub-spec${docCount > 1 ? "s" : ""})`));
         }
       }
       const priorityPrefix = priorityEmoji ? `${priorityEmoji} ` : "";
-      console.log(`  ${priorityPrefix}${statusEmoji} ${chalk18.cyan(sanitizeUserInput(displayPath))}${assigneeStr}${tagsStr}${subSpecStr}`);
+      console.log(`  ${priorityPrefix}${statusEmoji} ${chalk19.cyan(sanitizeUserInput(displayPath))}${assigneeStr}${tagsStr}${subSpecStr}`);
     }
     if (i < sortedGroups.length - 1) {
       console.log("");
@@ -1050,11 +1129,11 @@ function updateCommand() {
     await updateSpec(specPath, updates);
   });
 }
-async function updateSpec(specPath, updates) {
+async function updateSpec(specPath, updates, options = {}) {
   await autoCheckIfEnabled();
-  const config = await loadConfig();
-  const cwd = process.cwd();
-  const specsDir = path4.join(cwd, config.specsDir);
+  const cwd = options.cwd ?? process.cwd();
+  const config = await loadConfig(cwd);
+  const specsDir = path15.join(cwd, config.specsDir);
   const resolvedPath = await resolveSpecPath(specPath, cwd, specsDir);
   if (!resolvedPath) {
     throw new Error(`Spec not found: ${sanitizeUserInput(specPath)}. Tried: ${sanitizeUserInput(specPath)}, specs/${sanitizeUserInput(specPath)}, and searching in date directories`);
@@ -1076,12 +1155,12 @@ async function updateSpec(specPath, updates) {
     });
   }
   await updateFrontmatter(specFile, allUpdates);
-  console.log(chalk18.green(`\u2713 Updated: ${sanitizeUserInput(path4.relative(cwd, resolvedPath))}`));
+  console.log(chalk19.green(`\u2713 Updated: ${sanitizeUserInput(path15.relative(cwd, resolvedPath))}`));
   const updatedFields = Object.keys(updates).filter((k) => k !== "customFields");
   if (updates.customFields) {
     updatedFields.push(...Object.keys(updates.customFields));
   }
-  console.log(chalk18.gray(`  Fields: ${updatedFields.join(", ")}`));
+  console.log(chalk19.gray(`  Fields: ${updatedFields.join(", ")}`));
 }
 function linkCommand() {
   return new Command("link").description("Add relationships between specs (depends_on, related)").argument("<spec>", "Spec to update").option("--depends-on <specs>", "Add dependencies (comma-separated spec numbers or names)").option("--related <specs>", "Add related specs (comma-separated spec numbers or names)").action(async (specPath, options) => {
@@ -1096,7 +1175,7 @@ async function linkSpec(specPath, options) {
   await autoCheckIfEnabled();
   const config = await loadConfig();
   const cwd = process.cwd();
-  const specsDir = path4.join(cwd, config.specsDir);
+  const specsDir = path15.join(cwd, config.specsDir);
   const resolvedPath = await resolveSpecPath(specPath, cwd, specsDir);
   if (!resolvedPath) {
     throw new Error(`Spec not found: ${sanitizeUserInput(specPath)}`);
@@ -1109,7 +1188,7 @@ async function linkSpec(specPath, options) {
   const specMap = new Map(allSpecs.map((s) => [s.path, s]));
   const dependsOnSpecs = options.dependsOn ? options.dependsOn.split(",").map((s) => s.trim()) : [];
   const relatedSpecs = options.related ? options.related.split(",").map((s) => s.trim()) : [];
-  const targetSpecName = path4.basename(resolvedPath);
+  const targetSpecName = path15.basename(resolvedPath);
   const allRelationshipSpecs = [...dependsOnSpecs, ...relatedSpecs];
   const resolvedRelationships = /* @__PURE__ */ new Map();
   for (const relSpec of allRelationshipSpecs) {
@@ -1123,7 +1202,7 @@ async function linkSpec(specPath, options) {
     if (relResolvedPath === resolvedPath) {
       throw new Error(`Cannot link spec to itself: ${sanitizeUserInput(relSpec)}`);
     }
-    const relSpecName = path4.basename(relResolvedPath);
+    const relSpecName = path15.basename(relResolvedPath);
     resolvedRelationships.set(relSpec, relSpecName);
   }
   const { parseFrontmatter: parseFrontmatter2 } = await import('./frontmatter-R2DANL5X.js');
@@ -1143,7 +1222,7 @@ async function linkSpec(specPath, options) {
     }
     updates.depends_on = newDependsOn;
     if (added === 0) {
-      console.log(chalk18.gray(`\u2139 Dependencies already exist, no changes made`));
+      console.log(chalk19.gray(`\u2139 Dependencies already exist, no changes made`));
     }
   }
   if (relatedSpecs.length > 0) {
@@ -1170,19 +1249,19 @@ async function linkSpec(specPath, options) {
             await updateFrontmatter(relSpecFile, {
               related: [...relCurrentRelated, targetSpecName]
             });
-            console.log(chalk18.gray(`  Updated: ${sanitizeUserInput(relSpecName)} (bidirectional)`));
+            console.log(chalk19.gray(`  Updated: ${sanitizeUserInput(relSpecName)} (bidirectional)`));
           }
         }
       }
     }
     if (added === 0) {
-      console.log(chalk18.gray(`\u2139 Related specs already exist, no changes made`));
+      console.log(chalk19.gray(`\u2139 Related specs already exist, no changes made`));
     }
   }
   if (updates.depends_on && updates.depends_on.length > 0) {
     const cycles = detectCycles(targetSpecName, updates.depends_on, specMap);
     if (cycles.length > 0) {
-      console.log(chalk18.yellow(`\u26A0\uFE0F  Dependency cycle detected: ${cycles.join(" \u2192 ")}`));
+      console.log(chalk19.yellow(`\u26A0\uFE0F  Dependency cycle detected: ${cycles.join(" \u2192 ")}`));
     }
   }
   await updateFrontmatter(specFile, updates);
@@ -1193,8 +1272,8 @@ async function linkSpec(specPath, options) {
   if (relatedSpecs.length > 0) {
     updatedFields.push(`related: ${relatedSpecs.join(", ")}`);
   }
-  console.log(chalk18.green(`\u2713 Added relationships: ${updatedFields.join(", ")}`));
-  console.log(chalk18.gray(`  Updated: ${sanitizeUserInput(path4.relative(cwd, resolvedPath))}`));
+  console.log(chalk19.green(`\u2713 Added relationships: ${updatedFields.join(", ")}`));
+  console.log(chalk19.gray(`  Updated: ${sanitizeUserInput(path15.relative(cwd, resolvedPath))}`));
 }
 function detectCycles(startSpec, dependsOn, specMap, visited = /* @__PURE__ */ new Set(), path31 = []) {
   if (visited.has(startSpec)) {
@@ -1230,7 +1309,7 @@ async function unlinkSpec(specPath, options) {
   await autoCheckIfEnabled();
   const config = await loadConfig();
   const cwd = process.cwd();
-  const specsDir = path4.join(cwd, config.specsDir);
+  const specsDir = path15.join(cwd, config.specsDir);
   const resolvedPath = await resolveSpecPath(specPath, cwd, specsDir);
   if (!resolvedPath) {
     throw new Error(`Spec not found: ${sanitizeUserInput(specPath)}`);
@@ -1239,7 +1318,7 @@ async function unlinkSpec(specPath, options) {
   if (!specFile) {
     throw new Error(`No spec file found in: ${sanitizeUserInput(specPath)}`);
   }
-  const targetSpecName = path4.basename(resolvedPath);
+  const targetSpecName = path15.basename(resolvedPath);
   const { parseFrontmatter: parseFrontmatter2 } = await import('./frontmatter-R2DANL5X.js');
   const currentFrontmatter = await parseFrontmatter2(specFile);
   const currentDependsOn = currentFrontmatter?.depends_on || [];
@@ -1256,7 +1335,7 @@ async function unlinkSpec(specPath, options) {
       for (const spec of toRemove) {
         const resolvedSpecPath = await resolveSpecPath(spec, cwd, specsDir);
         if (resolvedSpecPath) {
-          resolvedToRemove.add(path4.basename(resolvedSpecPath));
+          resolvedToRemove.add(path15.basename(resolvedSpecPath));
         } else {
           resolvedToRemove.add(spec);
         }
@@ -1280,7 +1359,7 @@ async function unlinkSpec(specPath, options) {
               await updateFrontmatter(relSpecFile, {
                 related: relNewRelated
               });
-              console.log(chalk18.gray(`  Updated: ${sanitizeUserInput(relSpec)} (bidirectional)`));
+              console.log(chalk19.gray(`  Updated: ${sanitizeUserInput(relSpec)} (bidirectional)`));
             }
           }
         }
@@ -1293,7 +1372,7 @@ async function unlinkSpec(specPath, options) {
       for (const spec of toRemove) {
         const resolvedSpecPath = await resolveSpecPath(spec, cwd, specsDir);
         if (resolvedSpecPath) {
-          const specName = path4.basename(resolvedSpecPath);
+          const specName = path15.basename(resolvedSpecPath);
           resolvedToRemove.add(specName);
           const relSpecFile = await getSpecFile(resolvedSpecPath, config.structure.defaultFile);
           if (relSpecFile) {
@@ -1304,7 +1383,7 @@ async function unlinkSpec(specPath, options) {
               await updateFrontmatter(relSpecFile, {
                 related: relNewRelated
               });
-              console.log(chalk18.gray(`  Updated: ${sanitizeUserInput(specName)} (bidirectional)`));
+              console.log(chalk19.gray(`  Updated: ${sanitizeUserInput(specName)} (bidirectional)`));
             }
           }
         } else {
@@ -1318,7 +1397,7 @@ async function unlinkSpec(specPath, options) {
   }
   await updateFrontmatter(specFile, updates);
   if (removedCount === 0) {
-    console.log(chalk18.gray(`\u2139 No matching relationships found to remove`));
+    console.log(chalk19.gray(`\u2139 No matching relationships found to remove`));
   } else {
     const updatedFields = [];
     if (options.dependsOn !== void 0) {
@@ -1327,8 +1406,8 @@ async function unlinkSpec(specPath, options) {
     if (options.related !== void 0) {
       updatedFields.push(`related`);
     }
-    console.log(chalk18.green(`\u2713 Removed relationships: ${updatedFields.join(", ")} (${removedCount} total)`));
-    console.log(chalk18.gray(`  Updated: ${sanitizeUserInput(path4.relative(cwd, resolvedPath))}`));
+    console.log(chalk19.green(`\u2713 Removed relationships: ${updatedFields.join(", ")} (${removedCount} total)`));
+    console.log(chalk19.gray(`  Updated: ${sanitizeUserInput(path15.relative(cwd, resolvedPath))}`));
   }
 }
 function isGitRepository() {
@@ -1459,13 +1538,14 @@ function fileExistsInGit(filePath) {
 
 // src/commands/backfill.ts
 function backfillCommand() {
-  return new Command("backfill").description("Backfill timestamps from git history").argument("[specs...]", "Specific specs to backfill (optional)").option("--dry-run", "Show what would be updated without making changes").option("--force", "Overwrite existing timestamp values").option("--assignee", "Include assignee from first commit author").option("--transitions", "Include full status transition history").option("--all", "Include all optional fields (assignee + transitions)").action(async (specs, options) => {
+  return new Command("backfill").description("Backfill timestamps from git history").argument("[specs...]", "Specific specs to backfill (optional)").option("--dry-run", "Show what would be updated without making changes").option("--force", "Overwrite existing timestamp values").option("--assignee", "Include assignee from first commit author").option("--transitions", "Include full status transition history").option("--all", "Include all optional fields (assignee + transitions)").option("--json", "Output as JSON").action(async (specs, options) => {
     await backfillTimestamps({
       dryRun: options.dryRun,
       force: options.force,
       includeAssignee: options.assignee || options.all,
       includeTransitions: options.transitions || options.all,
-      specs: specs && specs.length > 0 ? specs : void 0
+      specs: specs && specs.length > 0 ? specs : void 0,
+      json: options.json
     });
   });
 }
@@ -1481,7 +1561,7 @@ async function backfillTimestamps(options = {}) {
     specs = [];
     const config = await loadConfig();
     const cwd = process.cwd();
-    const specsDir = path4.join(cwd, config.specsDir);
+    const specsDir = path15.join(cwd, config.specsDir);
     for (const specPath of options.specs) {
       const resolved = await resolveSpecPath(specPath, cwd, specsDir);
       if (!resolved) {
@@ -1677,79 +1757,79 @@ function templatesCommand() {
 }
 async function listTemplates(cwd = process.cwd()) {
   const config = await loadConfig(cwd);
-  const templatesDir = path4.join(cwd, ".lean-spec", "templates");
+  const templatesDir = path15.join(cwd, ".lean-spec", "templates");
   console.log("");
-  console.log(chalk18.green("=== Project Templates ==="));
+  console.log(chalk19.green("=== Project Templates ==="));
   console.log("");
   try {
     await fs9.access(templatesDir);
   } catch {
-    console.log(chalk18.yellow("No templates directory found."));
-    console.log(chalk18.gray("Run: lean-spec init"));
+    console.log(chalk19.yellow("No templates directory found."));
+    console.log(chalk19.gray("Run: lean-spec init"));
     console.log("");
     return;
   }
   const files = await fs9.readdir(templatesDir);
   const templateFiles = files.filter((f) => f.endsWith(".md"));
   if (templateFiles.length === 0) {
-    console.log(chalk18.yellow("No templates found."));
+    console.log(chalk19.yellow("No templates found."));
     console.log("");
     return;
   }
   if (config.templates && Object.keys(config.templates).length > 0) {
-    console.log(chalk18.cyan("Registered:"));
+    console.log(chalk19.cyan("Registered:"));
     for (const [name, file] of Object.entries(config.templates)) {
       const isDefault = config.template === file;
-      const marker = isDefault ? chalk18.green("\u2713 (default)") : "";
-      console.log(`  ${chalk18.bold(name)}: ${file} ${marker}`);
+      const marker = isDefault ? chalk19.green("\u2713 (default)") : "";
+      console.log(`  ${chalk19.bold(name)}: ${file} ${marker}`);
     }
     console.log("");
   }
-  console.log(chalk18.cyan("Available files:"));
+  console.log(chalk19.cyan("Available files:"));
   for (const file of templateFiles) {
-    const filePath = path4.join(templatesDir, file);
+    const filePath = path15.join(templatesDir, file);
     const stat6 = await fs9.stat(filePath);
     const sizeKB = (stat6.size / 1024).toFixed(1);
     console.log(`  ${file} (${sizeKB} KB)`);
   }
   console.log("");
-  console.log(chalk18.gray("Use templates with: lean-spec create <name> --template=<template-name>"));
+  console.log(chalk19.gray("Use templates with: lean-spec create <name> --template=<template-name>"));
   console.log("");
 }
 async function showTemplate(templateName, cwd = process.cwd()) {
   const config = await loadConfig(cwd);
   if (!config.templates?.[templateName]) {
-    console.error(chalk18.red(`Template not found: ${templateName}`));
-    console.error(chalk18.gray(`Available: ${Object.keys(config.templates || {}).join(", ")}`));
+    console.error(chalk19.red(`Template not found: ${templateName}`));
+    console.error(chalk19.gray(`Available: ${Object.keys(config.templates || {}).join(", ")}`));
     process.exit(1);
   }
-  const templatesDir = path4.join(cwd, ".lean-spec", "templates");
+  const templatesDir = path15.join(cwd, ".lean-spec", "templates");
   const templateFile = config.templates[templateName];
-  const templatePath = path4.join(templatesDir, templateFile);
+  const templatePath = path15.join(templatesDir, templateFile);
   try {
     const content = await fs9.readFile(templatePath, "utf-8");
     console.log("");
-    console.log(chalk18.cyan(`=== Template: ${templateName} (${templateFile}) ===`));
+    console.log(chalk19.cyan(`=== Template: ${templateName} (${templateFile}) ===`));
     console.log("");
     console.log(content);
     console.log("");
   } catch (error) {
-    console.error(chalk18.red(`Error reading template: ${templateFile}`));
+    console.error(chalk19.red(`Error reading template: ${templateFile}`));
     console.error(error);
     process.exit(1);
   }
 }
 async function addTemplate(name, file, cwd = process.cwd()) {
   const config = await loadConfig(cwd);
-  const templatesDir = path4.join(cwd, ".lean-spec", "templates");
-  const templatePath = path4.join(templatesDir, file);
+  const templatesDir = path15.join(cwd, ".lean-spec", "templates");
+  const templatePath = path15.join(templatesDir, file);
   try {
     await fs9.access(templatePath);
   } catch {
-    console.error(chalk18.red(`Template file not found: ${file}`));
-    console.error(chalk18.gray(`Expected at: ${templatePath}`));
+    console.error(chalk19.red(`Template file not found: ${file}`));
+    console.error(chalk19.gray(`Expected at: ${templatePath}`));
     console.error(
-      chalk18.yellow("Create the file first or use: lean-spec templates copy <source> <target>")
+      chalk19.yellow("Create the file first or use: lean-spec templates copy <source> <target>")
     );
     process.exit(1);
   }
@@ -1757,60 +1837,60 @@ async function addTemplate(name, file, cwd = process.cwd()) {
     config.templates = {};
   }
   if (config.templates[name]) {
-    console.log(chalk18.yellow(`Warning: Template '${name}' already exists, updating...`));
+    console.log(chalk19.yellow(`Warning: Template '${name}' already exists, updating...`));
   }
   config.templates[name] = file;
   await saveConfig(config, cwd);
-  console.log(chalk18.green(`\u2713 Added template: ${name} \u2192 ${file}`));
-  console.log(chalk18.gray(`  Use with: lean-spec create <spec-name> --template=${name}`));
+  console.log(chalk19.green(`\u2713 Added template: ${name} \u2192 ${file}`));
+  console.log(chalk19.gray(`  Use with: lean-spec create <spec-name> --template=${name}`));
 }
 async function removeTemplate(name, cwd = process.cwd()) {
   const config = await loadConfig(cwd);
   if (!config.templates?.[name]) {
-    console.error(chalk18.red(`Template not found: ${name}`));
-    console.error(chalk18.gray(`Available: ${Object.keys(config.templates || {}).join(", ")}`));
+    console.error(chalk19.red(`Template not found: ${name}`));
+    console.error(chalk19.gray(`Available: ${Object.keys(config.templates || {}).join(", ")}`));
     process.exit(1);
   }
   if (name === "default") {
-    console.error(chalk18.red("Cannot remove default template"));
+    console.error(chalk19.red("Cannot remove default template"));
     process.exit(1);
   }
   const file = config.templates[name];
   delete config.templates[name];
   await saveConfig(config, cwd);
-  console.log(chalk18.green(`\u2713 Removed template: ${name}`));
-  console.log(chalk18.gray(`  Note: Template file ${file} still exists in .lean-spec/templates/`));
+  console.log(chalk19.green(`\u2713 Removed template: ${name}`));
+  console.log(chalk19.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 = path4.join(cwd, ".lean-spec", "templates");
+  const templatesDir = path15.join(cwd, ".lean-spec", "templates");
   let sourceFile;
   if (config.templates?.[source]) {
     sourceFile = config.templates[source];
   } else {
     sourceFile = source;
   }
-  const sourcePath = path4.join(templatesDir, sourceFile);
+  const sourcePath = path15.join(templatesDir, sourceFile);
   try {
     await fs9.access(sourcePath);
   } catch {
-    console.error(chalk18.red(`Source template not found: ${source}`));
-    console.error(chalk18.gray(`Expected at: ${sourcePath}`));
+    console.error(chalk19.red(`Source template not found: ${source}`));
+    console.error(chalk19.gray(`Expected at: ${sourcePath}`));
     process.exit(1);
   }
   const targetFile = target.endsWith(".md") ? target : `${target}.md`;
-  const targetPath = path4.join(templatesDir, targetFile);
+  const targetPath = path15.join(templatesDir, targetFile);
   await fs9.copyFile(sourcePath, targetPath);
-  console.log(chalk18.green(`\u2713 Copied: ${sourceFile} \u2192 ${targetFile}`));
+  console.log(chalk19.green(`\u2713 Copied: ${sourceFile} \u2192 ${targetFile}`));
   if (!config.templates) {
     config.templates = {};
   }
   const templateName = target.replace(/\.md$/, "");
   config.templates[templateName] = targetFile;
   await saveConfig(config, cwd);
-  console.log(chalk18.green(`\u2713 Registered template: ${templateName}`));
-  console.log(chalk18.gray(`  Edit: ${targetPath}`));
-  console.log(chalk18.gray(`  Use with: lean-spec create <spec-name> --template=${templateName}`));
+  console.log(chalk19.green(`\u2713 Registered template: ${templateName}`));
+  console.log(chalk19.gray(`  Edit: ${targetPath}`));
+  console.log(chalk19.gray(`  Use with: lean-spec create <spec-name> --template=${templateName}`));
 }
 async function detectExistingSystemPrompts(cwd) {
   const commonFiles = [
@@ -1821,7 +1901,7 @@ async function detectExistingSystemPrompts(cwd) {
   const found = [];
   for (const file of commonFiles) {
     try {
-      await fs9.access(path4.join(cwd, file));
+      await fs9.access(path15.join(cwd, file));
       found.push(file);
     } catch {
     }
@@ -1830,8 +1910,8 @@ async function detectExistingSystemPrompts(cwd) {
 }
 async function handleExistingFiles(action, existingFiles, templateDir, cwd, variables = {}) {
   for (const file of existingFiles) {
-    const filePath = path4.join(cwd, file);
-    const templateFilePath = path4.join(templateDir, "files", file);
+    const filePath = path15.join(cwd, file);
+    const templateFilePath = path15.join(templateDir, file);
     try {
       await fs9.access(templateFilePath);
     } catch {
@@ -1843,7 +1923,7 @@ async function handleExistingFiles(action, existingFiles, templateDir, cwd, vari
       for (const [key, value] of Object.entries(variables)) {
         template = template.replace(new RegExp(`\\{${key}\\}`, "g"), value);
       }
-      const promptPath = path4.join(cwd, ".lean-spec", "MERGE-AGENTS-PROMPT.md");
+      const promptPath = path15.join(cwd, ".lean-spec", "MERGE-AGENTS-PROMPT.md");
       const aiPrompt = `# AI Prompt: Consolidate AGENTS.md
 
 ## Task
@@ -1875,16 +1955,16 @@ Create a single consolidated AGENTS.md that:
 - Maintains clear structure and readability
 - Removes any duplicate or conflicting guidance
 `;
-      await fs9.mkdir(path4.dirname(promptPath), { recursive: true });
+      await fs9.mkdir(path15.dirname(promptPath), { recursive: true });
       await fs9.writeFile(promptPath, aiPrompt, "utf-8");
-      console.log(chalk18.green(`\u2713 Created AI consolidation prompt`));
-      console.log(chalk18.cyan(`  \u2192 ${promptPath}`));
+      console.log(chalk19.green(`\u2713 Created AI consolidation prompt`));
+      console.log(chalk19.cyan(`  \u2192 ${promptPath}`));
       console.log("");
-      console.log(chalk18.yellow("\u{1F4DD} Next steps:"));
-      console.log(chalk18.gray("  1. Open .lean-spec/MERGE-AGENTS-PROMPT.md"));
-      console.log(chalk18.gray("  2. Send it to your AI coding assistant (GitHub Copilot, Cursor, etc.)"));
-      console.log(chalk18.gray("  3. Let AI create the consolidated AGENTS.md"));
-      console.log(chalk18.gray("  4. Review and commit the result"));
+      console.log(chalk19.yellow("\u{1F4DD} Next steps:"));
+      console.log(chalk19.gray("  1. Open .lean-spec/MERGE-AGENTS-PROMPT.md"));
+      console.log(chalk19.gray("  2. Send it to your AI coding assistant (GitHub Copilot, Cursor, etc.)"));
+      console.log(chalk19.gray("  3. Let AI create the consolidated AGENTS.md"));
+      console.log(chalk19.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");
@@ -1900,19 +1980,19 @@ Create a single consolidated AGENTS.md that:
 
 ${template.split("\n").slice(1).join("\n")}`;
       await fs9.writeFile(filePath, merged, "utf-8");
-      console.log(chalk18.green(`\u2713 Appended LeanSpec section to ${file}`));
-      console.log(chalk18.yellow("  \u26A0 Note: May be verbose. Consider consolidating later."));
+      console.log(chalk19.green(`\u2713 Appended LeanSpec section to ${file}`));
+      console.log(chalk19.yellow("  \u26A0 Note: May be verbose. Consider consolidating later."));
     } else if (action === "overwrite") {
       const backupPath = `${filePath}.backup`;
       await fs9.rename(filePath, backupPath);
-      console.log(chalk18.yellow(`\u2713 Backed up ${file} \u2192 ${file}.backup`));
+      console.log(chalk19.yellow(`\u2713 Backed up ${file} \u2192 ${file}.backup`));
       let content = await fs9.readFile(templateFilePath, "utf-8");
       for (const [key, value] of Object.entries(variables)) {
         content = content.replace(new RegExp(`\\{${key}\\}`, "g"), value);
       }
       await fs9.writeFile(filePath, content, "utf-8");
-      console.log(chalk18.green(`\u2713 Created new ${file}`));
-      console.log(chalk18.gray(`  \u{1F4A1} Your original content is preserved in ${file}.backup`));
+      console.log(chalk19.green(`\u2713 Created new ${file}`));
+      console.log(chalk19.gray(`  \u{1F4A1} Your original content is preserved in ${file}.backup`));
     }
   }
 }
@@ -1920,8 +2000,8 @@ async function copyDirectory(src, dest, skipFiles = [], variables = {}) {
   await fs9.mkdir(dest, { recursive: true });
   const entries = await fs9.readdir(src, { withFileTypes: true });
   for (const entry of entries) {
-    const srcPath = path4.join(src, entry.name);
-    const destPath = path4.join(dest, entry.name);
+    const srcPath = path15.join(src, entry.name);
+    const destPath = path15.join(dest, entry.name);
     if (skipFiles.includes(entry.name)) {
       continue;
     }
@@ -1942,7 +2022,7 @@ async function copyDirectory(src, dest, skipFiles = [], variables = {}) {
 }
 async function getProjectName2(cwd) {
   try {
-    const packageJsonPath = path4.join(cwd, "package.json");
+    const packageJsonPath = path15.join(cwd, "package.json");
     const content = await fs9.readFile(packageJsonPath, "utf-8");
     const pkg = JSON.parse(content);
     if (pkg.name) {
@@ -1950,77 +2030,148 @@ async function getProjectName2(cwd) {
     }
   } catch {
   }
-  return path4.basename(cwd);
+  return path15.basename(cwd);
+}
+
+// src/utils/examples.ts
+var EXAMPLES = {
+  "dark-theme": {
+    name: "dark-theme",
+    title: "Dark Theme Support",
+    description: "Add dark theme support to a professional admin dashboard with charts",
+    difficulty: "beginner",
+    tutorial: "Your First Spec with AI",
+    tutorialUrl: "https://leanspec.dev/docs/tutorials/first-spec-with-ai",
+    tech: ["HTML", "CSS", "JavaScript", "Chart.js", "Express.js"],
+    files: 6,
+    lines: 420
+  },
+  "dashboard-widgets": {
+    name: "dashboard-widgets",
+    title: "Dashboard Widgets",
+    description: "Add three new widgets to an analytics dashboard",
+    difficulty: "intermediate",
+    tutorial: "Managing Multiple Features",
+    tutorialUrl: "https://leanspec.dev/docs/tutorials/multiple-features",
+    tech: ["React", "Vite"],
+    files: 17,
+    lines: 300
+  },
+  "api-refactor": {
+    name: "api-refactor",
+    title: "API Client Refactor",
+    description: "Extract reusable API client from monolithic code",
+    difficulty: "intermediate",
+    tutorial: "Refactoring with Specs",
+    tutorialUrl: "https://leanspec.dev/docs/tutorials/refactoring-specs",
+    tech: ["Node.js"],
+    files: 7,
+    lines: 250
+  }
+};
+function getExamplesList() {
+  return Object.values(EXAMPLES);
+}
+function getExample(name) {
+  return EXAMPLES[name];
+}
+function exampleExists(name) {
+  return name in EXAMPLES;
 }
 
 // src/commands/init.ts
-var __dirname = path4.dirname(fileURLToPath(import.meta.url));
-var TEMPLATES_DIR = path4.join(__dirname, "..", "templates");
+var __dirname = path15.dirname(fileURLToPath(import.meta.url));
+var TEMPLATES_DIR = path15.join(__dirname, "..", "templates");
+var EXAMPLES_DIR = path15.join(TEMPLATES_DIR, "examples");
 function initCommand() {
-  return new Command("init").description("Initialize LeanSpec in current directory").action(async () => {
-    await initProject();
+  return new Command("init").description("Initialize LeanSpec in current directory").option("-y, --yes", "Skip prompts and use defaults (quick start with standard template)").option("--template <name>", "Use specific template (standard or detailed)").option("--example [name]", "Scaffold an example project for tutorials (interactive if no name provided)").option("--name <dirname>", "Custom directory name for example project").option("--list", "List available example projects").action(async (options) => {
+    if (options.list) {
+      await listExamples();
+      return;
+    }
+    if (options.example !== void 0) {
+      await scaffoldExample(options.example, options.name);
+      return;
+    }
+    await initProject(options.yes, options.template);
   });
 }
-async function initProject() {
+async function initProject(skipPrompts = false, templateOption) {
   const cwd = process.cwd();
   try {
-    await fs9.access(path4.join(cwd, ".lean-spec", "config.json"));
-    console.log(chalk18.yellow("\u26A0 LeanSpec already initialized in this directory."));
-    console.log(chalk18.gray("To reinitialize, delete .lean-spec/ directory first."));
+    await fs9.access(path15.join(cwd, ".lean-spec", "config.json"));
+    console.log(chalk19.yellow("\u26A0 LeanSpec already initialized in this directory."));
+    console.log(chalk19.gray("To reinitialize, delete .lean-spec/ directory first."));
     return;
   } catch {
   }
   console.log("");
-  console.log(chalk18.green("Welcome to LeanSpec!"));
+  console.log(chalk19.green("Welcome to LeanSpec!"));
   console.log("");
-  const setupMode = await select({
-    message: "How would you like to set up?",
-    choices: [
-      {
-        name: "Quick start (recommended)",
-        value: "quick",
-        description: "Use standard template, start immediately"
-      },
-      {
-        name: "Choose template",
-        value: "template",
-        description: "Pick from: minimal, standard, enterprise"
-      }
-      // TODO: Re-enable when custom setup mode is implemented
-      // {
-      //   name: 'Customize everything',
-      //   value: 'custom',
-      //   description: 'Full control over structure and settings',
-      // },
-    ]
-  });
-  let templateName = "standard";
-  if (setupMode === "template") {
-    templateName = await select({
-      message: "Select template:",
+  let setupMode = "quick";
+  let templateName = templateOption || "standard";
+  if (skipPrompts) {
+    console.log(chalk19.gray("Using defaults: quick start with standard template"));
+    console.log("");
+  } else if (!templateOption) {
+    setupMode = await select({
+      message: "How would you like to set up?",
       choices: [
-        { name: "minimal", value: "minimal", description: "Just folder structure, no extras" },
-        { name: "standard", value: "standard", description: "Recommended - includes AGENTS.md" },
         {
-          name: "enterprise",
-          value: "enterprise",
-          description: "Governance with approvals and compliance"
+          name: "Quick start (recommended)",
+          value: "quick",
+          description: "Use standard template, start immediately"
+        },
+        {
+          name: "Choose template",
+          value: "template",
+          description: "Pick from: standard, detailed"
         }
+        // TODO: Re-enable when custom setup mode is implemented
+        // {
+        //   name: 'Customize everything',
+        //   value: 'custom',
+        //   description: 'Full control over structure and settings',
+        // },
       ]
     });
+    if (setupMode === "template") {
+      templateName = await select({
+        message: "Select template:",
+        choices: [
+          { name: "standard", value: "standard", description: "Recommended - single-file specs with AGENTS.md" },
+          {
+            name: "detailed",
+            value: "detailed",
+            description: "Complex specs with sub-spec structure (DESIGN, PLAN, TEST)"
+          }
+        ]
+      });
+    }
   }
-  const templateDir = path4.join(TEMPLATES_DIR, templateName);
-  const templateConfigPath = path4.join(templateDir, "config.json");
+  if (templateName === "minimal") {
+    console.log(chalk19.yellow('\u26A0 The "minimal" template has been removed.'));
+    console.log(chalk19.gray('  Using "standard" template instead (same lightweight approach).'));
+    console.log("");
+    templateName = "standard";
+  } else if (templateName === "enterprise") {
+    console.log(chalk19.yellow('\u26A0 The "enterprise" template has been renamed to "detailed".'));
+    console.log(chalk19.gray('  Using "detailed" template (sub-spec structure for complex specs).'));
+    console.log("");
+    templateName = "detailed";
+  }
+  const templateDir = path15.join(TEMPLATES_DIR, templateName);
+  const templateConfigPath = path15.join(templateDir, "config.json");
   let templateConfig;
   try {
     const content = await fs9.readFile(templateConfigPath, "utf-8");
     templateConfig = JSON.parse(content).config;
   } catch {
-    console.error(chalk18.red(`Error: Template not found: ${templateName}`));
+    console.error(chalk19.red(`Error: Template not found: ${templateName}`));
     process.exit(1);
   }
   let patternChoice = "simple";
-  if (setupMode !== "quick") {
+  if (setupMode !== "quick" && !skipPrompts) {
     patternChoice = await select({
       message: "Select folder pattern:",
       choices: [
@@ -2059,89 +2210,272 @@ async function initProject() {
     templateConfig.structure.prefix = "{YYYYMMDD}-";
   } else if (patternChoice === "custom") {
     console.log("");
-    console.log(chalk18.yellow("\u26A0 Custom pattern input is not yet implemented."));
-    console.log(chalk18.gray("  You can manually edit .lean-spec/config.json after initialization."));
-    console.log(chalk18.gray("  Using simple pattern for now."));
+    console.log(chalk19.yellow("\u26A0 Custom pattern input is not yet implemented."));
+    console.log(chalk19.gray("  You can manually edit .lean-spec/config.json after initialization."));
+    console.log(chalk19.gray("  Using simple pattern for now."));
     console.log("");
     templateConfig.structure.pattern = "flat";
     templateConfig.structure.prefix = "";
   }
-  const templatesDir = path4.join(cwd, ".lean-spec", "templates");
+  const templatesDir = path15.join(cwd, ".lean-spec", "templates");
   try {
     await fs9.mkdir(templatesDir, { recursive: true });
   } catch (error) {
-    console.error(chalk18.red("Error creating templates directory:"), error);
+    console.error(chalk19.red("Error creating templates directory:"), error);
     process.exit(1);
   }
-  const templateSpecPath = path4.join(templateDir, "spec-template.md");
-  const targetSpecPath = path4.join(templatesDir, "spec-template.md");
+  const templateFilesDir = path15.join(templateDir, "files");
   try {
-    await fs9.copyFile(templateSpecPath, targetSpecPath);
-    console.log(chalk18.green("\u2713 Created .lean-spec/templates/spec-template.md"));
+    const files = await fs9.readdir(templateFilesDir);
+    if (templateName === "standard") {
+      const readmePath = path15.join(templateFilesDir, "README.md");
+      const targetSpecPath = path15.join(templatesDir, "spec-template.md");
+      await fs9.copyFile(readmePath, targetSpecPath);
+      console.log(chalk19.green("\u2713 Created .lean-spec/templates/spec-template.md"));
+      templateConfig.template = "spec-template.md";
+      templateConfig.templates = {
+        default: "spec-template.md"
+      };
+    } else if (templateName === "detailed") {
+      for (const file of files) {
+        const srcPath = path15.join(templateFilesDir, file);
+        const destPath = path15.join(templatesDir, file);
+        await fs9.copyFile(srcPath, destPath);
+      }
+      console.log(chalk19.green(`\u2713 Created .lean-spec/templates/ with ${files.length} files`));
+      console.log(chalk19.gray(`  Files: ${files.join(", ")}`));
+      templateConfig.template = "README.md";
+      templateConfig.templates = {
+        default: "README.md"
+      };
+    }
   } catch (error) {
-    console.error(chalk18.red("Error copying template:"), error);
+    console.error(chalk19.red("Error copying template files:"), error);
     process.exit(1);
   }
-  templateConfig.template = "spec-template.md";
-  templateConfig.templates = {
-    default: "spec-template.md"
-  };
   await saveConfig(templateConfig, cwd);
-  console.log(chalk18.green("\u2713 Created .lean-spec/config.json"));
+  console.log(chalk19.green("\u2713 Created .lean-spec/config.json"));
   const existingFiles = await detectExistingSystemPrompts(cwd);
   let skipFiles = [];
   if (existingFiles.length > 0) {
     console.log("");
-    console.log(chalk18.yellow(`Found existing: ${existingFiles.join(", ")}`));
-    const action = await select({
-      message: "How would you like to handle existing AGENTS.md?",
-      choices: [
-        {
-          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: "Replace with LeanSpec",
-          value: "overwrite",
-          description: "Backs up existing, creates fresh AGENTS.md from template"
-        },
-        {
-          name: "Keep Existing Only",
-          value: "skip",
-          description: "Skips AGENTS.md, only adds .lean-spec config and specs/"
-        }
-      ]
-    });
-    const projectName2 = await getProjectName2(cwd);
-    await handleExistingFiles(action, existingFiles, templateDir, cwd, { project_name: projectName2 });
-    if (action === "skip") {
-      skipFiles = existingFiles;
+    console.log(chalk19.yellow(`Found existing: ${existingFiles.join(", ")}`));
+    if (skipPrompts) {
+      console.log(chalk19.gray("Using AI-Assisted Merge for existing AGENTS.md"));
+      const projectName2 = await getProjectName2(cwd);
+      await handleExistingFiles("merge-ai", existingFiles, templateDir, cwd, { project_name: projectName2 });
+    } else {
+      const action = await select({
+        message: "How would you like to handle existing AGENTS.md?",
+        choices: [
+          {
+            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: "Replace with LeanSpec",
+            value: "overwrite",
+            description: "Backs up existing, creates fresh AGENTS.md from template"
+          },
+          {
+            name: "Keep Existing Only",
+            value: "skip",
+            description: "Skips AGENTS.md, only adds .lean-spec config and specs/"
+          }
+        ]
+      });
+      const projectName2 = await getProjectName2(cwd);
+      await handleExistingFiles(action, existingFiles, templateDir, cwd, { project_name: projectName2 });
+      if (action === "skip") {
+        skipFiles = existingFiles;
+      }
     }
   }
   const projectName = await getProjectName2(cwd);
-  const filesDir = path4.join(templateDir, "files");
+  if (!skipFiles.includes("AGENTS.md")) {
+    const agentsSourcePath = path15.join(templateDir, "AGENTS.md");
+    const agentsTargetPath = path15.join(cwd, "AGENTS.md");
+    try {
+      let agentsContent = await fs9.readFile(agentsSourcePath, "utf-8");
+      agentsContent = agentsContent.replace(/\{project_name\}/g, projectName);
+      await fs9.writeFile(agentsTargetPath, agentsContent, "utf-8");
+      console.log(chalk19.green("\u2713 Created AGENTS.md"));
+    } catch (error) {
+      console.error(chalk19.red("Error copying AGENTS.md:"), error);
+      process.exit(1);
+    }
+  }
+  const filesDir = path15.join(templateDir, "files");
+  try {
+    const filesToCopy = await fs9.readdir(filesDir);
+    const hasOtherFiles = filesToCopy.some((f) => !f.match(/\.(md)$/i) || !["README.md", "DESIGN.md", "PLAN.md", "TEST.md"].includes(f));
+    if (hasOtherFiles) {
+      await copyDirectory(filesDir, cwd, [...skipFiles, "README.md", "DESIGN.md", "PLAN.md", "TEST.md"], { project_name: projectName });
+    }
+    console.log(chalk19.green("\u2713 Initialized project structure"));
+  } catch (error) {
+    console.error(chalk19.red("Error copying template files:"), error);
+    process.exit(1);
+  }
+  const specsDir = path15.join(cwd, "specs");
   try {
-    await copyDirectory(filesDir, cwd, skipFiles, { project_name: projectName });
-    console.log(chalk18.green("\u2713 Initialized project structure"));
+    await fs9.mkdir(specsDir, { recursive: true });
+    console.log(chalk19.green("\u2713 Created specs/ directory"));
   } catch (error) {
-    console.error(chalk18.red("Error copying template files:"), error);
+    console.error(chalk19.red("Error creating specs directory:"), error);
     process.exit(1);
   }
   console.log("");
-  console.log(chalk18.green("\u2713 LeanSpec initialized!"));
+  console.log(chalk19.green("\u2713 LeanSpec initialized!"));
   console.log("");
   console.log("Next steps:");
-  console.log(chalk18.gray("  - Review and customize AGENTS.md"));
-  console.log(chalk18.gray("  - Check out example spec in specs/"));
-  console.log(chalk18.gray("  - Create your first spec: lean-spec create my-feature"));
+  console.log(chalk19.gray("  - Review and customize AGENTS.md"));
+  console.log(chalk19.gray("  - Check out example spec in specs/"));
+  console.log(chalk19.gray("  - Create your first spec: lean-spec create my-feature"));
+  console.log("");
+}
+async function listExamples() {
+  const examples = getExamplesList();
+  console.log("");
+  console.log(chalk19.bold("Available Examples:"));
+  console.log("");
+  for (const example of examples) {
+    const difficultyColor = example.difficulty === "beginner" ? chalk19.green : example.difficulty === "intermediate" ? chalk19.yellow : chalk19.red;
+    console.log(chalk19.cyan(`  ${example.name}`));
+    console.log(`    ${example.description}`);
+    console.log(`    ${difficultyColor(example.difficulty)} \u2022 ${example.tech.join(", ")} \u2022 ~${example.lines} lines`);
+    console.log(`    Tutorial: ${chalk19.gray(example.tutorialUrl)}`);
+    console.log("");
+  }
+  console.log("Usage:");
+  console.log(chalk19.gray("  lean-spec init --example <name>"));
+  console.log(chalk19.gray("  lean-spec init --example dark-theme"));
   console.log("");
 }
+async function scaffoldExample(exampleName, customName) {
+  if (!exampleName) {
+    exampleName = await selectExample();
+  }
+  if (!exampleExists(exampleName)) {
+    console.error(chalk19.red(`Error: Example "${exampleName}" not found.`));
+    console.log("");
+    console.log("Available examples:");
+    getExamplesList().forEach((ex) => {
+      console.log(`  - ${ex.name}`);
+    });
+    console.log("");
+    console.log("Use: lean-spec init --list");
+    process.exit(1);
+  }
+  const example = getExample(exampleName);
+  const targetDirName = customName || exampleName;
+  const targetPath = path15.join(process.cwd(), targetDirName);
+  try {
+    const files = await fs9.readdir(targetPath);
+    const nonGitFiles = files.filter((f) => f !== ".git");
+    if (nonGitFiles.length > 0) {
+      console.error(chalk19.red(`Error: Directory "${targetDirName}" already exists and is not empty.`));
+      console.log(chalk19.gray("Choose a different name with --name option."));
+      process.exit(1);
+    }
+  } catch {
+  }
+  console.log("");
+  console.log(chalk19.green(`Setting up example: ${example.title}`));
+  console.log(chalk19.gray(example.description));
+  console.log("");
+  await fs9.mkdir(targetPath, { recursive: true });
+  console.log(chalk19.green(`\u2713 Created directory: ${targetDirName}/`));
+  const examplePath = path15.join(EXAMPLES_DIR, exampleName);
+  await copyDirectoryRecursive(examplePath, targetPath);
+  console.log(chalk19.green("\u2713 Copied example project"));
+  const originalCwd = process.cwd();
+  try {
+    process.chdir(targetPath);
+    console.log(chalk19.gray("Initializing LeanSpec..."));
+    await initProject(true);
+    console.log(chalk19.green("\u2713 Initialized LeanSpec"));
+  } catch (error) {
+    console.error(chalk19.red("Error initializing LeanSpec:"), error);
+    process.exit(1);
+  } finally {
+    process.chdir(originalCwd);
+  }
+  const packageManager = await detectPackageManager();
+  console.log(chalk19.gray(`Installing dependencies with ${packageManager}...`));
+  try {
+    const { execSync: execSync3 } = await import('child_process');
+    execSync3(`${packageManager} install`, {
+      cwd: targetPath,
+      stdio: "inherit"
+    });
+    console.log(chalk19.green("\u2713 Installed dependencies"));
+  } catch (error) {
+    console.log(chalk19.yellow("\u26A0 Failed to install dependencies automatically"));
+    console.log(chalk19.gray(`  Run: cd ${targetDirName} && ${packageManager} install`));
+  }
+  console.log("");
+  console.log(chalk19.green("\u2713 Example project ready!"));
+  console.log("");
+  console.log(chalk19.gray("Created:"));
+  console.log(chalk19.gray(`  - Application code (${example.tech.join(", ")})`));
+  console.log(chalk19.gray("  - LeanSpec files (AGENTS.md, .lean-spec/, specs/)"));
+  console.log("");
+  console.log("Next steps:");
+  console.log(chalk19.cyan(`  1. cd ${targetDirName}`));
+  console.log(chalk19.cyan("  2. Open this project in your editor"));
+  console.log(chalk19.cyan(`  3. Follow the tutorial: ${example.tutorialUrl}`));
+  console.log(chalk19.cyan(`  4. Ask your AI: "Help me with this tutorial using LeanSpec"`));
+  console.log("");
+}
+async function selectExample() {
+  const examples = getExamplesList();
+  const choice = await select({
+    message: "Select an example project:",
+    choices: examples.map((ex) => {
+      const difficultyLabel = ex.difficulty === "beginner" ? "\u2605\u2606\u2606" : ex.difficulty === "intermediate" ? "\u2605\u2605\u2606" : "\u2605\u2605\u2605";
+      return {
+        name: `${ex.title} (${difficultyLabel})`,
+        value: ex.name,
+        description: `${ex.description} \u2022 ${ex.tech.join(", ")}`
+      };
+    })
+  });
+  return choice;
+}
+async function copyDirectoryRecursive(src, dest) {
+  const entries = await fs9.readdir(src, { withFileTypes: true });
+  for (const entry of entries) {
+    const srcPath = path15.join(src, entry.name);
+    const destPath = path15.join(dest, entry.name);
+    if (entry.isDirectory()) {
+      await fs9.mkdir(destPath, { recursive: true });
+      await copyDirectoryRecursive(srcPath, destPath);
+    } else {
+      await fs9.copyFile(srcPath, destPath);
+    }
+  }
+}
+async function detectPackageManager() {
+  const cwd = process.cwd();
+  try {
+    await fs9.access(path15.join(cwd, "..", "pnpm-lock.yaml"));
+    return "pnpm";
+  } catch {
+  }
+  try {
+    await fs9.access(path15.join(cwd, "..", "yarn.lock"));
+    return "yarn";
+  } catch {
+  }
+  return "npm";
+}
 function normalizeDateFields2(data) {
   const dateFields = ["created", "completed", "updated", "due"];
   for (const field of dateFields) {
@@ -2449,21 +2783,28 @@ function analyzeMarkdownStructure(content) {
   };
 }
 var TokenCounter = class {
-  encoding;
-  constructor() {
-    this.encoding = encoding_for_model("gpt-4");
+  encoding = null;
+  async getEncoding() {
+    if (!this.encoding) {
+      const { encoding_for_model } = await import('tiktoken');
+      this.encoding = encoding_for_model("gpt-4");
+    }
+    return this.encoding;
   }
   /**
    * Clean up resources (important to prevent memory leaks)
    */
   dispose() {
-    this.encoding.free();
+    if (this.encoding) {
+      this.encoding.free();
+    }
   }
   /**
    * Count tokens in a string
    */
-  countString(text) {
-    const tokens = this.encoding.encode(text);
+  async countString(text) {
+    const encoding = await this.getEncoding();
+    const tokens = encoding.encode(text);
     return tokens.length;
   }
   /**
@@ -2478,7 +2819,7 @@ var TokenCounter = class {
    */
   async countFile(filePath, options = {}) {
     const content = await fs9.readFile(filePath, "utf-8");
-    const tokens = this.countString(content);
+    const tokens = await this.countString(content);
     const lines = content.split("\n").length;
     const result = {
       total: tokens,
@@ -2526,9 +2867,9 @@ var TokenCounter = class {
       };
     }
     for (const file of filesToCount) {
-      const filePath = path4.join(specPath, file);
+      const filePath = path15.join(specPath, file);
       const content = await fs9.readFile(filePath, "utf-8");
-      const tokens = this.countString(content);
+      const tokens = await this.countString(content);
       const lines = content.split("\n").length;
       fileCounts.push({
         path: file,
@@ -2566,7 +2907,7 @@ var TokenCounter = class {
       const parsed = matter2(content);
       body = parsed.content;
       frontmatterContent = parsed.matter;
-      breakdown.frontmatter = this.countString(frontmatterContent);
+      breakdown.frontmatter = await this.countString(frontmatterContent);
     } catch {
     }
     let inCodeBlock = false;
@@ -2577,23 +2918,23 @@ var TokenCounter = class {
       const trimmed = line.trim();
       if (trimmed.startsWith("```")) {
         inCodeBlock = !inCodeBlock;
-        breakdown.code += this.countString(line + "\n");
+        breakdown.code += await this.countString(line + "\n");
         continue;
       }
       if (inCodeBlock) {
-        breakdown.code += this.countString(line + "\n");
+        breakdown.code += await this.countString(line + "\n");
         continue;
       }
       const isTableSeparator = trimmed.includes("|") && /[-:]{3,}/.test(trimmed);
       const isTableRow = trimmed.includes("|") && trimmed.startsWith("|");
       if (isTableSeparator || inTable && isTableRow) {
         inTable = true;
-        breakdown.tables += this.countString(line + "\n");
+        breakdown.tables += await this.countString(line + "\n");
         continue;
       } else if (inTable && !isTableRow) {
         inTable = false;
       }
-      breakdown.prose += this.countString(line + "\n");
+      breakdown.prose += await this.countString(line + "\n");
     }
     return breakdown;
   }
@@ -2674,12 +3015,12 @@ async function countTokens(input, options) {
   try {
     if (typeof input === "string") {
       return {
-        total: counter.countString(input),
+        total: await counter.countString(input),
         files: []
       };
     } else if ("content" in input) {
       return {
-        total: counter.countString(input.content),
+        total: await counter.countString(input.content),
         files: []
       };
     } else if ("filePath" in input) {
@@ -2857,12 +3198,12 @@ var ComplexityValidator = class {
     const listItemCount = lines.filter((line) => line.match(/^[\s]*[-*]\s/) || line.match(/^[\s]*\d+\.\s/)).length;
     const tableCount = lines.filter((line) => line.includes("|") && line.match(/[-:]{3,}/)).length;
     const counter = new TokenCounter();
-    const tokenCount = counter.countString(content);
+    const tokenCount = await counter.countString(content);
     counter.dispose();
     let hasSubSpecs = false;
     let subSpecCount = 0;
     try {
-      const specDir = path4.dirname(spec.filePath);
+      const specDir = path15.dirname(spec.filePath);
       const files = await fs9.readdir(specDir);
       const mdFiles = files.filter(
         (f) => f.endsWith(".md") && f !== "README.md"
@@ -3431,7 +3772,7 @@ function filesCommand(specPath, options = {}) {
   if (typeof specPath === "string") {
     return showFiles(specPath, options);
   }
-  return new Command("files").description("List files in a spec").argument("<spec>", "Spec to list files for").option("--type <type>", "Filter by type: docs, assets").option("--tree", "Show tree structure").action(async (target, opts) => {
+  return new Command("files").description("List files in a spec").argument("<spec>", "Spec to list files for").option("--type <type>", "Filter by type: docs, assets").option("--tree", "Show tree structure").option("--json", "Output as JSON").action(async (target, opts) => {
     await showFiles(target, opts);
   });
 }
@@ -3439,7 +3780,7 @@ async function showFiles(specPath, options = {}) {
   await autoCheckIfEnabled();
   const config = await loadConfig();
   const cwd = process.cwd();
-  const specsDir = path4.join(cwd, config.specsDir);
+  const specsDir = path15.join(cwd, config.specsDir);
   const resolvedPath = await resolveSpecPath(specPath, cwd, specsDir);
   if (!resolvedPath) {
     throw new Error(`Spec not found: ${sanitizeUserInput(specPath)}. Try using the full path or spec name (e.g., 001-my-spec)`);
@@ -3449,15 +3790,40 @@ async function showFiles(specPath, options = {}) {
     throw new Error(`Could not load spec: ${sanitizeUserInput(specPath)}`);
   }
   const subFiles = await loadSubFiles(spec.fullPath);
+  if (options.json) {
+    const readmeStat2 = await fs9.stat(spec.filePath);
+    const readmeContent2 = await fs9.readFile(spec.filePath, "utf-8");
+    const readmeTokens2 = await countTokens({ content: readmeContent2 });
+    const jsonOutput = {
+      spec: spec.name,
+      path: spec.fullPath,
+      files: [
+        {
+          name: "README.md",
+          type: "required",
+          size: readmeStat2.size,
+          tokens: readmeTokens2.total
+        },
+        ...subFiles.map((f) => ({
+          name: f.name,
+          type: f.type,
+          size: f.size
+        }))
+      ],
+      total: subFiles.length + 1
+    };
+    console.log(JSON.stringify(jsonOutput, null, 2));
+    return;
+  }
   console.log("");
-  console.log(chalk18.cyan(`\u{1F4C4} Files in ${sanitizeUserInput(spec.name)}`));
+  console.log(chalk19.cyan(`\u{1F4C4} Files in ${sanitizeUserInput(spec.name)}`));
   console.log("");
-  console.log(chalk18.green("Required:"));
+  console.log(chalk19.green("Required:"));
   const readmeStat = await fs9.stat(spec.filePath);
   const readmeSize = formatSize(readmeStat.size);
   const readmeContent = await fs9.readFile(spec.filePath, "utf-8");
   const readmeTokens = await countTokens({ content: readmeContent });
-  console.log(chalk18.green(`  \u2713 README.md              (${readmeSize}, ~${readmeTokens.total.toLocaleString()} tokens)  Main spec`));
+  console.log(chalk19.green(`  \u2713 README.md              (${readmeSize}, ~${readmeTokens.total.toLocaleString()} tokens)  Main spec`));
   console.log("");
   let filteredFiles = subFiles;
   if (options.type === "docs") {
@@ -3466,27 +3832,27 @@ async function showFiles(specPath, options = {}) {
     filteredFiles = subFiles.filter((f) => f.type === "asset");
   }
   if (filteredFiles.length === 0) {
-    console.log(chalk18.gray("No additional files"));
+    console.log(chalk19.gray("No additional files"));
     console.log("");
     return;
   }
   const documents = filteredFiles.filter((f) => f.type === "document");
   const assets = filteredFiles.filter((f) => f.type === "asset");
   if (documents.length > 0 && (!options.type || options.type === "docs")) {
-    console.log(chalk18.cyan("Documents:"));
+    console.log(chalk19.cyan("Documents:"));
     for (const file of documents) {
       const size = formatSize(file.size);
       const content = await fs9.readFile(file.path, "utf-8");
       const tokenCount = await countTokens({ content });
-      console.log(chalk18.cyan(`  \u2713 ${sanitizeUserInput(file.name).padEnd(20)} (${size}, ~${tokenCount.total.toLocaleString()} tokens)`));
+      console.log(chalk19.cyan(`  \u2713 ${sanitizeUserInput(file.name).padEnd(20)} (${size}, ~${tokenCount.total.toLocaleString()} tokens)`));
     }
     console.log("");
   }
   if (assets.length > 0 && (!options.type || options.type === "assets")) {
-    console.log(chalk18.yellow("Assets:"));
+    console.log(chalk19.yellow("Assets:"));
     for (const file of assets) {
       const size = formatSize(file.size);
-      console.log(chalk18.yellow(`  \u2713 ${sanitizeUserInput(file.name).padEnd(20)} (${size})`));
+      console.log(chalk19.yellow(`  \u2713 ${sanitizeUserInput(file.name).padEnd(20)} (${size})`));
     }
     console.log("");
   }
@@ -3494,7 +3860,7 @@ async function showFiles(specPath, options = {}) {
   const totalSize = formatSize(
     readmeStat.size + filteredFiles.reduce((sum, f) => sum + f.size, 0)
   );
-  console.log(chalk18.gray(`Total: ${totalFiles} files, ${totalSize}`));
+  console.log(chalk19.gray(`Total: ${totalFiles} files, ${totalSize}`));
   console.log("");
 }
 function formatSize(bytes) {
@@ -3506,6 +3872,41 @@ function formatSize(bytes) {
     return `${(bytes / (1024 * 1024)).toFixed(1)} MB`;
   }
 }
+function examplesCommand() {
+  return new Command("examples").description("List available example projects for tutorials").action(async () => {
+    await listExamples2();
+  });
+}
+async function listExamples2() {
+  const examples = getExamplesList();
+  console.log("");
+  console.log(chalk19.bold("LeanSpec Example Projects"));
+  console.log("");
+  console.log("Scaffold complete example projects to follow tutorials:");
+  console.log("");
+  for (const example of examples) {
+    const difficultyColor = example.difficulty === "beginner" ? chalk19.green : example.difficulty === "intermediate" ? chalk19.yellow : chalk19.red;
+    const difficultyStars = example.difficulty === "beginner" ? "\u2605\u2606\u2606" : example.difficulty === "intermediate" ? "\u2605\u2605\u2606" : "\u2605\u2605\u2605";
+    console.log(chalk19.cyan.bold(`  ${example.title}`));
+    console.log(`    ${chalk19.gray(example.name)}`);
+    console.log(`    ${example.description}`);
+    console.log(`    ${difficultyColor(difficultyStars + " " + example.difficulty)} \u2022 ${example.tech.join(", ")} \u2022 ~${example.lines} lines`);
+    console.log(`    ${chalk19.gray("Tutorial:")} ${example.tutorial}`);
+    console.log(`    ${chalk19.gray(example.tutorialUrl)}`);
+    console.log("");
+  }
+  console.log(chalk19.bold("Usage:"));
+  console.log("");
+  console.log("  # Scaffold an example");
+  console.log(chalk19.cyan("  lean-spec init --example <name>"));
+  console.log("");
+  console.log("  # Interactive selection");
+  console.log(chalk19.cyan("  lean-spec init --example"));
+  console.log("");
+  console.log("  # Custom directory name");
+  console.log(chalk19.cyan("  lean-spec init --example dark-theme --name my-demo"));
+  console.log("");
+}
 var FrontmatterValidator = class {
   name = "frontmatter";
   description = "Validate spec frontmatter for required fields and valid values";
@@ -3993,7 +4394,7 @@ var SubSpecValidator = class {
    */
   validateNamingConventions(subSpecs, warnings) {
     for (const subSpec of subSpecs) {
-      const baseName = path4.basename(subSpec.name, ".md");
+      const baseName = path15.basename(subSpec.name, ".md");
       if (baseName !== baseName.toUpperCase()) {
         warnings.push({
           message: `Sub-spec filename should be uppercase: ${subSpec.name}`,
@@ -4157,17 +4558,17 @@ function formatFileIssues(fileResult, specsDir) {
     const priority = fileResult.spec.frontmatter.priority || "medium";
     const statusBadge = formatStatusBadge(status);
     const priorityBadge = formatPriorityBadge(priority);
-    lines.push(chalk18.bold.cyan(`${specName} ${statusBadge} ${priorityBadge}`));
+    lines.push(chalk19.bold.cyan(`${specName} ${statusBadge} ${priorityBadge}`));
   } else {
-    lines.push(chalk18.cyan.underline(relativePath));
+    lines.push(chalk19.cyan.underline(relativePath));
   }
   for (const issue of fileResult.issues) {
-    const severityColor = issue.severity === "error" ? chalk18.red : chalk18.yellow;
+    const severityColor = issue.severity === "error" ? chalk19.red : chalk19.yellow;
     const severityText = severityColor(issue.severity.padEnd(9));
-    const ruleText = chalk18.gray(issue.ruleName);
+    const ruleText = chalk19.gray(issue.ruleName);
     lines.push(`  ${severityText}${issue.message.padEnd(60)} ${ruleText}`);
     if (issue.suggestion) {
-      lines.push(chalk18.gray(`           \u2192 ${issue.suggestion}`));
+      lines.push(chalk19.gray(`           \u2192 ${issue.suggestion}`));
     }
   }
   lines.push("");
@@ -4177,25 +4578,25 @@ function formatSummary(totalSpecs, errorCount, warningCount, cleanCount) {
   if (errorCount > 0) {
     const errorText = errorCount === 1 ? "error" : "errors";
     const warningText = warningCount === 1 ? "warning" : "warnings";
-    return chalk18.red.bold(
+    return chalk19.red.bold(
       `\u2716 ${errorCount} ${errorText}, ${warningCount} ${warningText} (${totalSpecs} specs checked, ${cleanCount} clean)`
     );
   } else if (warningCount > 0) {
     const warningText = warningCount === 1 ? "warning" : "warnings";
-    return chalk18.yellow.bold(
+    return chalk19.yellow.bold(
       `\u26A0 ${warningCount} ${warningText} (${totalSpecs} specs checked, ${cleanCount} clean)`
     );
   } else {
-    return chalk18.green.bold(`\u2713 All ${totalSpecs} specs passed`);
+    return chalk19.green.bold(`\u2713 All ${totalSpecs} specs passed`);
   }
 }
 function formatPassingSpecs(specs, specsDir) {
   const lines = [];
-  lines.push(chalk18.green.bold(`
+  lines.push(chalk19.green.bold(`
 \u2713 ${specs.length} specs passed:`));
   for (const spec of specs) {
     const relativePath = normalizeFilePath(spec.filePath);
-    lines.push(chalk18.gray(`  ${relativePath}`));
+    lines.push(chalk19.gray(`  ${relativePath}`));
   }
   return lines.join("\n");
 }
@@ -4241,13 +4642,13 @@ function formatValidationResults(results, specs, specsDir, options = {}) {
     return formatJson(displayResults, specs.length, errorCount2, warningCount2);
   }
   const lines = [];
-  lines.push(chalk18.bold(`
+  lines.push(chalk19.bold(`
 Validating ${specs.length} specs...
 `));
   let previousSpecName;
   for (const fileResult of displayResults) {
     if (fileResult.spec && previousSpecName && fileResult.spec.name !== previousSpecName) {
-      lines.push(chalk18.gray("\u2500".repeat(80)));
+      lines.push(chalk19.gray("\u2500".repeat(80)));
       lines.push("");
     }
     lines.push(formatFileIssues(fileResult));
@@ -4271,20 +4672,20 @@ Validating ${specs.length} specs...
     lines.push(formatPassingSpecs(passingSpecs));
   }
   if (!options.verbose && cleanCount > 0 && displayResults.length > 0) {
-    lines.push(chalk18.gray("\nRun with --verbose to see passing specs."));
+    lines.push(chalk19.gray("\nRun with --verbose to see passing specs."));
   }
   return lines.join("\n");
 }
 
 // src/commands/validate.ts
 function validateCommand() {
-  return new Command("validate").description("Validate specs for quality issues").argument("[specs...]", "Specific specs to validate (optional)").option("--max-lines <number>", "Custom line limit (default: 400)", parseInt).option("--verbose", "Show passing specs").option("--quiet", "Suppress warnings, only show errors").option("--format <format>", "Output format: default, json, compact", "default").option("--rule <rule>", "Filter by specific rule name (e.g., max-lines, frontmatter)").option("--warnings-only", "Treat all issues as warnings, never fail (useful for CI pre-release checks)").action(async (specs, options) => {
+  return new Command("validate").description("Validate specs for quality issues").argument("[specs...]", "Specific specs to validate (optional)").option("--max-lines <number>", "Custom line limit (default: 400)", parseInt).option("--verbose", "Show passing specs").option("--quiet", "Suppress warnings, only show errors").option("--format <format>", "Output format: default, json, compact", "default").option("--json", "Output as JSON (shorthand for --format json)").option("--rule <rule>", "Filter by specific rule name (e.g., max-lines, frontmatter)").option("--warnings-only", "Treat all issues as warnings, never fail (useful for CI pre-release checks)").action(async (specs, options) => {
     const passed = await validateSpecs({
       maxLines: options.maxLines,
       specs: specs && specs.length > 0 ? specs : void 0,
       verbose: options.verbose,
       quiet: options.quiet,
-      format: options.format,
+      format: options.json ? "json" : options.format,
       rule: options.rule,
       warningsOnly: options.warningsOnly
     });
@@ -4299,12 +4700,12 @@ async function validateSpecs(options = {}) {
     specs = [];
     for (const specPath of options.specs) {
       const spec = allSpecs.find(
-        (s) => s.path.includes(specPath) || path4.basename(s.path).includes(specPath)
+        (s) => s.path.includes(specPath) || path15.basename(s.path).includes(specPath)
       );
       if (spec) {
         specs.push(spec);
       } else {
-        console.error(chalk18.red(`Error: Spec not found: ${specPath}`));
+        console.error(chalk19.red(`Error: Spec not found: ${specPath}`));
         return false;
       }
     }
@@ -4332,7 +4733,7 @@ async function validateSpecs(options = {}) {
     try {
       content = await fs9.readFile(spec.filePath, "utf-8");
     } catch (error) {
-      console.error(chalk18.red(`Error reading ${spec.filePath}:`), error);
+      console.error(chalk19.red(`Error reading ${spec.filePath}:`), error);
       continue;
     }
     for (const validator of validators) {
@@ -4345,7 +4746,7 @@ async function validateSpecs(options = {}) {
           content
         });
       } catch (error) {
-        console.error(chalk18.yellow(`Warning: Validator ${validator.name} failed:`), error instanceof Error ? error.message : error);
+        console.error(chalk19.yellow(`Warning: Validator ${validator.name} failed:`), error instanceof Error ? error.message : error);
       }
     }
   }
@@ -4414,7 +4815,7 @@ async function scanDocuments(dirPath) {
   async function scanRecursive(currentPath) {
     const entries = await fs9.readdir(currentPath, { withFileTypes: true });
     for (const entry of entries) {
-      const fullPath = path4.join(currentPath, entry.name);
+      const fullPath = path15.join(currentPath, entry.name);
       if (entry.isDirectory()) {
         if (!entry.name.startsWith(".") && entry.name !== "node_modules") {
           await scanRecursive(fullPath);
@@ -4759,7 +5160,7 @@ function calculateVelocityMetrics(specs) {
 
 // src/commands/board.ts
 function boardCommand() {
-  return new Command("board").description("Show Kanban-style board view with project completion summary").option("--complete", "Include complete specs (default: hidden)").option("--simple", "Hide completion summary (kanban only)").option("--completion-only", "Show only completion summary (no kanban)").option("--tag <tag>", "Filter by tag").option("--assignee <name>", "Filter by assignee").action(async (options) => {
+  return new Command("board").description("Show Kanban-style board view with project completion summary").option("--complete", "Include complete specs (default: hidden)").option("--simple", "Hide completion summary (kanban only)").option("--completion-only", "Show only completion summary (no kanban)").option("--tag <tag>", "Filter by tag").option("--assignee <name>", "Filter by assignee").option("--json", "Output as JSON").action(async (options) => {
     await showBoard(options);
   });
 }
@@ -4780,7 +5181,11 @@ async function showBoard(options) {
     })
   );
   if (specs.length === 0) {
-    console.log(chalk18.dim("No specs found."));
+    if (options.json) {
+      console.log(JSON.stringify({ columns: {}, total: 0 }, null, 2));
+    } else {
+      console.log(chalk19.dim("No specs found."));
+    }
     return;
   }
   const columns = {
@@ -4795,12 +5200,35 @@ async function showBoard(options) {
       columns[status].push(spec);
     }
   }
-  console.log(chalk18.bold.cyan("\u{1F4CB} Spec Kanban Board"));
+  if (options.json) {
+    const completionMetrics = calculateCompletion(specs);
+    const velocityMetrics = calculateVelocityMetrics(specs);
+    const jsonOutput = {
+      columns: {
+        planned: columns.planned.map((s) => ({ path: s.path, priority: s.frontmatter.priority, assignee: s.frontmatter.assignee, tags: s.frontmatter.tags })),
+        "in-progress": columns["in-progress"].map((s) => ({ path: s.path, priority: s.frontmatter.priority, assignee: s.frontmatter.assignee, tags: s.frontmatter.tags })),
+        complete: columns.complete.map((s) => ({ path: s.path, priority: s.frontmatter.priority, assignee: s.frontmatter.assignee, tags: s.frontmatter.tags }))
+      },
+      summary: {
+        total: completionMetrics.totalSpecs,
+        active: completionMetrics.activeSpecs,
+        complete: completionMetrics.completeSpecs,
+        completionRate: completionMetrics.score,
+        velocity: {
+          avgCycleTime: velocityMetrics.cycleTime.average,
+          throughputPerWeek: velocityMetrics.throughput.perWeek / 7 * 7
+        }
+      }
+    };
+    console.log(JSON.stringify(jsonOutput, null, 2));
+    return;
+  }
+  console.log(chalk19.bold.cyan("\u{1F4CB} Spec Kanban Board"));
   if (options.tag || options.assignee) {
     const filterParts = [];
     if (options.tag) filterParts.push(`tag=${options.tag}`);
     if (options.assignee) filterParts.push(`assignee=${options.assignee}`);
-    console.log(chalk18.dim(`Filtered by: ${filterParts.join(", ")}`));
+    console.log(chalk19.dim(`Filtered by: ${filterParts.join(", ")}`));
   }
   console.log("");
   if (!options.simple) {
@@ -4815,12 +5243,12 @@ async function showBoard(options) {
       const padding = boxWidth - 2 - visibleLength;
       return content + " ".repeat(Math.max(0, padding));
     };
-    console.log(chalk18.dim(topBorder));
-    const headerLine = chalk18.bold("  Project Overview");
-    console.log(chalk18.dim("\u2551") + padLine(headerLine) + chalk18.dim("\u2551"));
-    const percentageColor = completionMetrics.score >= 70 ? chalk18.green : completionMetrics.score >= 40 ? chalk18.yellow : chalk18.red;
+    console.log(chalk19.dim(topBorder));
+    const headerLine = chalk19.bold("  Project Overview");
+    console.log(chalk19.dim("\u2551") + padLine(headerLine) + chalk19.dim("\u2551"));
+    const percentageColor = completionMetrics.score >= 70 ? chalk19.green : completionMetrics.score >= 40 ? chalk19.yellow : chalk19.red;
     const line1 = `  ${completionMetrics.totalSpecs} total \xB7 ${completionMetrics.activeSpecs} active \xB7 ${completionMetrics.completeSpecs} complete ${percentageColor("(" + completionMetrics.score + "%)")}`;
-    console.log(chalk18.dim("\u2551") + padLine(line1) + chalk18.dim("\u2551"));
+    console.log(chalk19.dim("\u2551") + padLine(line1) + chalk19.dim("\u2551"));
     if (completionMetrics.criticalIssues.length > 0 || completionMetrics.warnings.length > 0) {
       const alerts = [];
       if (completionMetrics.criticalIssues.length > 0) {
@@ -4829,27 +5257,27 @@ async function showBoard(options) {
       if (completionMetrics.warnings.length > 0) {
         alerts.push(`${completionMetrics.warnings.length} specs WIP > 7 days`);
       }
-      const alertLine = `  ${chalk18.yellow("\u26A0\uFE0F  " + alerts.join(" \xB7 "))}`;
-      console.log(chalk18.dim("\u2551") + padLine(alertLine) + chalk18.dim("\u2551"));
+      const alertLine = `  ${chalk19.yellow("\u26A0\uFE0F  " + alerts.join(" \xB7 "))}`;
+      console.log(chalk19.dim("\u2551") + padLine(alertLine) + chalk19.dim("\u2551"));
     }
-    const velocityLine = `  ${chalk18.cyan("\u{1F680} Velocity:")} ${velocityMetrics.cycleTime.average.toFixed(1)}d avg cycle \xB7 ${(velocityMetrics.throughput.perWeek / 7 * 7).toFixed(1)}/wk throughput`;
-    console.log(chalk18.dim("\u2551") + padLine(velocityLine) + chalk18.dim("\u2551"));
-    console.log(chalk18.dim(bottomBorder));
+    const velocityLine = `  ${chalk19.cyan("\u{1F680} Velocity:")} ${velocityMetrics.cycleTime.average.toFixed(1)}d avg cycle \xB7 ${(velocityMetrics.throughput.perWeek / 7 * 7).toFixed(1)}/wk throughput`;
+    console.log(chalk19.dim("\u2551") + padLine(velocityLine) + chalk19.dim("\u2551"));
+    console.log(chalk19.dim(bottomBorder));
     console.log("");
     if (options.completionOnly) {
       return;
     }
   }
   renderColumn(STATUS_CONFIG.planned.label, STATUS_CONFIG.planned.emoji, columns.planned, true, STATUS_CONFIG.planned.colorFn);
-  console.log(chalk18.dim("\u2501".repeat(70)));
+  console.log(chalk19.dim("\u2501".repeat(70)));
   console.log("");
   renderColumn(STATUS_CONFIG["in-progress"].label, STATUS_CONFIG["in-progress"].emoji, columns["in-progress"], true, STATUS_CONFIG["in-progress"].colorFn);
-  console.log(chalk18.dim("\u2501".repeat(70)));
+  console.log(chalk19.dim("\u2501".repeat(70)));
   console.log("");
   renderColumn(STATUS_CONFIG.complete.label, STATUS_CONFIG.complete.emoji, columns.complete, options.showComplete || false, STATUS_CONFIG.complete.colorFn);
 }
 function renderColumn(title, emoji, specs, expanded, colorFn) {
-  console.log(`${emoji} ${colorFn(chalk18.bold(`${title} (${specs.length})`))}`);
+  console.log(`${emoji} ${colorFn(chalk19.bold(`${title} (${specs.length})`))}`);
   console.log("");
   if (expanded && specs.length > 0) {
     const priorityGroups = {
@@ -4874,30 +5302,30 @@ function renderColumn(title, emoji, specs, expanded, colorFn) {
       firstGroup = false;
       const priorityLabel = priority === "none" ? "No Priority" : priority.charAt(0).toUpperCase() + priority.slice(1);
       const priorityEmoji = priority === "none" ? "\u26AA" : PRIORITY_CONFIG[priority].emoji;
-      const priorityColor = priority === "none" ? chalk18.dim : PRIORITY_CONFIG[priority].colorFn;
-      console.log(`  ${priorityColor(`${priorityEmoji} ${chalk18.bold(priorityLabel)} ${chalk18.dim(`(${groupSpecs.length})`)}`)}`);
+      const priorityColor = priority === "none" ? chalk19.dim : PRIORITY_CONFIG[priority].colorFn;
+      console.log(`  ${priorityColor(`${priorityEmoji} ${chalk19.bold(priorityLabel)} ${chalk19.dim(`(${groupSpecs.length})`)}`)}`);
       for (const spec of groupSpecs) {
         let assigneeStr = "";
         if (spec.frontmatter.assignee) {
-          assigneeStr = " " + chalk18.cyan(`@${sanitizeUserInput(spec.frontmatter.assignee)}`);
+          assigneeStr = " " + chalk19.cyan(`@${sanitizeUserInput(spec.frontmatter.assignee)}`);
         }
         let tagsStr = "";
         if (spec.frontmatter.tags?.length) {
           const tags = Array.isArray(spec.frontmatter.tags) ? spec.frontmatter.tags : [];
           if (tags.length > 0) {
             const tagStr = tags.map((tag) => `#${sanitizeUserInput(tag)}`).join(" ");
-            tagsStr = " " + chalk18.dim(chalk18.magenta(tagStr));
+            tagsStr = " " + chalk19.dim(chalk19.magenta(tagStr));
           }
         }
-        console.log(`    ${chalk18.cyan(sanitizeUserInput(spec.path))}${assigneeStr}${tagsStr}`);
+        console.log(`    ${chalk19.cyan(sanitizeUserInput(spec.path))}${assigneeStr}${tagsStr}`);
       }
     }
     console.log("");
   } else if (!expanded && specs.length > 0) {
-    console.log(`  ${chalk18.dim("(collapsed, use --complete to expand)")}`);
+    console.log(`  ${chalk19.dim("(collapsed, use --complete to expand)")}`);
     console.log("");
   } else {
-    console.log(`  ${chalk18.dim("(empty)")}`);
+    console.log(`  ${chalk19.dim("(empty)")}`);
     console.log("");
   }
 }
@@ -5066,26 +5494,26 @@ async function showStats(options) {
     console.log(JSON.stringify(data, null, 2));
     return;
   }
-  console.log(chalk18.bold.cyan("\u{1F4CA} Spec Stats"));
+  console.log(chalk19.bold.cyan("\u{1F4CA} Spec Stats"));
   console.log("");
   if (options.tag || options.assignee) {
     const filterParts = [];
     if (options.tag) filterParts.push(`tag=${options.tag}`);
     if (options.assignee) filterParts.push(`assignee=${options.assignee}`);
-    console.log(chalk18.dim(`Filtered by: ${filterParts.join(", ")}`));
+    console.log(chalk19.dim(`Filtered by: ${filterParts.join(", ")}`));
     console.log("");
   }
   if (showSimplified) {
-    console.log(chalk18.bold("\u{1F4C8} Overview"));
+    console.log(chalk19.bold("\u{1F4C8} Overview"));
     console.log("");
     const completionStatus = getCompletionStatus(completionMetrics.score);
-    const completionColor = completionStatus.color === "green" ? chalk18.green : completionStatus.color === "yellow" ? chalk18.yellow : chalk18.red;
-    console.log(`  Total Specs           ${chalk18.cyan(completionMetrics.totalSpecs)}`);
-    console.log(`  Active (Planned+WIP)  ${chalk18.yellow(completionMetrics.activeSpecs)}`);
-    console.log(`  Complete              ${chalk18.green(completionMetrics.completeSpecs)}`);
+    const completionColor = completionStatus.color === "green" ? chalk19.green : completionStatus.color === "yellow" ? chalk19.yellow : chalk19.red;
+    console.log(`  Total Specs           ${chalk19.cyan(completionMetrics.totalSpecs)}`);
+    console.log(`  Active (Planned+WIP)  ${chalk19.yellow(completionMetrics.activeSpecs)}`);
+    console.log(`  Complete              ${chalk19.green(completionMetrics.completeSpecs)}`);
     console.log(`  Completion Rate       ${completionColor(`${completionMetrics.score}% ${completionStatus.emoji}`)}`);
     console.log("");
-    console.log(chalk18.bold("\u{1F4CA} Status"));
+    console.log(chalk19.bold("\u{1F4CA} Status"));
     console.log("");
     const labelWidth2 = 15;
     const barWidth2 = 20;
@@ -5094,19 +5522,19 @@ async function showStats(options) {
       const width = Math.round(count / maxCount * barWidth2);
       const filledWidth = Math.min(width, barWidth2);
       const emptyWidth = barWidth2 - filledWidth;
-      return char.repeat(filledWidth) + chalk18.dim("\u2591").repeat(emptyWidth);
+      return char.repeat(filledWidth) + chalk19.dim("\u2591").repeat(emptyWidth);
     };
-    console.log(`  \u{1F4C5} ${"Planned".padEnd(labelWidth2)}  ${chalk18.cyan(createBar2(statusCounts.planned, maxStatusCount))}  ${chalk18.cyan(statusCounts.planned)}`);
-    console.log(`  \u23F3 ${"In Progress".padEnd(labelWidth2)}  ${chalk18.yellow(createBar2(statusCounts["in-progress"], maxStatusCount))}  ${chalk18.yellow(statusCounts["in-progress"])}`);
-    console.log(`  \u2705 ${"Complete".padEnd(labelWidth2)}  ${chalk18.green(createBar2(statusCounts.complete, maxStatusCount))}  ${chalk18.green(statusCounts.complete)}`);
+    console.log(`  \u{1F4C5} ${"Planned".padEnd(labelWidth2)}  ${chalk19.cyan(createBar2(statusCounts.planned, maxStatusCount))}  ${chalk19.cyan(statusCounts.planned)}`);
+    console.log(`  \u23F3 ${"In Progress".padEnd(labelWidth2)}  ${chalk19.yellow(createBar2(statusCounts["in-progress"], maxStatusCount))}  ${chalk19.yellow(statusCounts["in-progress"])}`);
+    console.log(`  \u2705 ${"Complete".padEnd(labelWidth2)}  ${chalk19.green(createBar2(statusCounts.complete, maxStatusCount))}  ${chalk19.green(statusCounts.complete)}`);
     if (statusCounts.archived > 0) {
-      console.log(`  \u{1F4E6} ${"Archived".padEnd(labelWidth2)}  ${chalk18.dim(createBar2(statusCounts.archived, maxStatusCount))}  ${chalk18.dim(statusCounts.archived)}`);
+      console.log(`  \u{1F4E6} ${"Archived".padEnd(labelWidth2)}  ${chalk19.dim(createBar2(statusCounts.archived, maxStatusCount))}  ${chalk19.dim(statusCounts.archived)}`);
     }
     console.log("");
     const criticalCount = priorityCounts.critical || 0;
     const highCount = priorityCounts.high || 0;
     if (criticalCount > 0 || highCount > 0) {
-      console.log(chalk18.bold("\u{1F3AF} Priority Focus"));
+      console.log(chalk19.bold("\u{1F3AF} Priority Focus"));
       console.log("");
       if (criticalCount > 0) {
         const criticalPlanned = specs.filter((s) => s.frontmatter.priority === "critical" && s.frontmatter.status === "planned").length;
@@ -5116,11 +5544,11 @@ async function showStats(options) {
           (s) => s.frontmatter.priority === "critical" && s.frontmatter.due && dayjs3(s.frontmatter.due).isBefore(dayjs3(), "day") && s.frontmatter.status !== "complete"
         ).length;
         const parts = [];
-        if (criticalPlanned > 0) parts.push(chalk18.dim(`${criticalPlanned} planned`));
+        if (criticalPlanned > 0) parts.push(chalk19.dim(`${criticalPlanned} planned`));
         if (criticalInProgress > 0) parts.push(`${criticalInProgress} in-progress`);
-        if (criticalComplete > 0) parts.push(chalk18.green(`${criticalComplete} complete`));
-        if (criticalOverdue > 0) parts.push(chalk18.red(`${criticalOverdue} overdue!`));
-        console.log(`  \u{1F534} Critical      ${chalk18.red(criticalCount)} specs${parts.length > 0 ? ` (${parts.join(", ")})` : ""}`);
+        if (criticalComplete > 0) parts.push(chalk19.green(`${criticalComplete} complete`));
+        if (criticalOverdue > 0) parts.push(chalk19.red(`${criticalOverdue} overdue!`));
+        console.log(`  \u{1F534} Critical      ${chalk19.red(criticalCount)} specs${parts.length > 0 ? ` (${parts.join(", ")})` : ""}`);
       }
       if (highCount > 0) {
         const highPlanned = specs.filter((s) => s.frontmatter.priority === "high" && s.frontmatter.status === "planned").length;
@@ -5130,52 +5558,52 @@ async function showStats(options) {
           (s) => s.frontmatter.priority === "high" && s.frontmatter.due && dayjs3(s.frontmatter.due).isBefore(dayjs3(), "day") && s.frontmatter.status !== "complete"
         ).length;
         const parts = [];
-        if (highPlanned > 0) parts.push(chalk18.dim(`${highPlanned} planned`));
+        if (highPlanned > 0) parts.push(chalk19.dim(`${highPlanned} planned`));
         if (highInProgress > 0) parts.push(`${highInProgress} in-progress`);
-        if (highComplete > 0) parts.push(chalk18.green(`${highComplete} complete`));
-        if (highOverdue > 0) parts.push(chalk18.yellow(`${highOverdue} overdue`));
-        console.log(`  \u{1F7E0} High          ${chalk18.hex("#FFA500")(highCount)} specs${parts.length > 0 ? ` (${parts.join(", ")})` : ""}`);
+        if (highComplete > 0) parts.push(chalk19.green(`${highComplete} complete`));
+        if (highOverdue > 0) parts.push(chalk19.yellow(`${highOverdue} overdue`));
+        console.log(`  \u{1F7E0} High          ${chalk19.hex("#FFA500")(highCount)} specs${parts.length > 0 ? ` (${parts.join(", ")})` : ""}`);
       }
       console.log("");
     }
     if (insights.length > 0) {
-      console.log(chalk18.bold.yellow("\u26A0\uFE0F  Needs Attention"));
+      console.log(chalk19.bold.yellow("\u26A0\uFE0F  Needs Attention"));
       console.log("");
       for (const insight of insights) {
-        const color = insight.severity === "critical" ? chalk18.red : insight.severity === "warning" ? chalk18.yellow : chalk18.cyan;
+        const color = insight.severity === "critical" ? chalk19.red : insight.severity === "warning" ? chalk19.yellow : chalk19.cyan;
         console.log(`  ${color("\u2022")} ${insight.message}`);
         for (const specPath of insight.specs.slice(0, 3)) {
           const spec = specs.find((s) => s.path === specPath);
           const details = spec ? getSpecInsightDetails(spec) : null;
-          console.log(`    ${chalk18.dim(specPath)}${details ? chalk18.dim(` (${details})`) : ""}`);
+          console.log(`    ${chalk19.dim(specPath)}${details ? chalk19.dim(` (${details})`) : ""}`);
         }
         if (insight.specs.length > 3) {
-          console.log(`    ${chalk18.dim(`...and ${insight.specs.length - 3} more`)}`);
+          console.log(`    ${chalk19.dim(`...and ${insight.specs.length - 3} more`)}`);
         }
       }
       console.log("");
     } else if (completionMetrics.activeSpecs === 0 && completionMetrics.completeSpecs > 0) {
-      console.log(chalk18.bold.green("\u{1F389} All Specs Complete!"));
+      console.log(chalk19.bold.green("\u{1F389} All Specs Complete!"));
       console.log("");
-      console.log(`  ${chalk18.dim("Great work! All active specs are complete.")}`);
+      console.log(`  ${chalk19.dim("Great work! All active specs are complete.")}`);
       console.log("");
     } else if (completionMetrics.activeSpecs > 0) {
-      console.log(chalk18.bold.green("\u2728 All Clear!"));
+      console.log(chalk19.bold.green("\u2728 All Clear!"));
       console.log("");
-      console.log(`  ${chalk18.dim("No critical issues detected. Keep up the good work!")}`);
+      console.log(`  ${chalk19.dim("No critical issues detected. Keep up the good work!")}`);
       console.log("");
     }
-    console.log(chalk18.bold("\u{1F680} Velocity Summary"));
+    console.log(chalk19.bold("\u{1F680} Velocity Summary"));
     console.log("");
-    const cycleTimeStatus = velocityMetrics.cycleTime.average <= 7 ? chalk18.green("\u2713") : chalk18.yellow("\u26A0");
-    const throughputTrend = velocityMetrics.throughput.trend === "up" ? chalk18.green("\u2191") : velocityMetrics.throughput.trend === "down" ? chalk18.red("\u2193") : chalk18.yellow("\u2192");
-    console.log(`  Avg Cycle Time   ${chalk18.cyan(velocityMetrics.cycleTime.average.toFixed(1))} days ${cycleTimeStatus}${velocityMetrics.cycleTime.average <= 7 ? chalk18.dim(" (target: 7d)") : ""}`);
-    console.log(`  Throughput       ${chalk18.cyan((velocityMetrics.throughput.perWeek / 7 * 7).toFixed(1))}/week ${throughputTrend}`);
-    console.log(`  WIP              ${chalk18.yellow(velocityMetrics.wip.current)} specs`);
+    const cycleTimeStatus = velocityMetrics.cycleTime.average <= 7 ? chalk19.green("\u2713") : chalk19.yellow("\u26A0");
+    const throughputTrend = velocityMetrics.throughput.trend === "up" ? chalk19.green("\u2191") : velocityMetrics.throughput.trend === "down" ? chalk19.red("\u2193") : chalk19.yellow("\u2192");
+    console.log(`  Avg Cycle Time   ${chalk19.cyan(velocityMetrics.cycleTime.average.toFixed(1))} days ${cycleTimeStatus}${velocityMetrics.cycleTime.average <= 7 ? chalk19.dim(" (target: 7d)") : ""}`);
+    console.log(`  Throughput       ${chalk19.cyan((velocityMetrics.throughput.perWeek / 7 * 7).toFixed(1))}/week ${throughputTrend}`);
+    console.log(`  WIP              ${chalk19.yellow(velocityMetrics.wip.current)} specs`);
     console.log("");
-    console.log(chalk18.dim("\u{1F4A1} Use `lean-spec stats --full` for detailed analytics"));
-    console.log(chalk18.dim("   Use `lean-spec stats --velocity` for velocity breakdown"));
-    console.log(chalk18.dim("   Use `lean-spec stats --timeline` for activity timeline"));
+    console.log(chalk19.dim("\u{1F4A1} Use `lean-spec stats --full` for detailed analytics"));
+    console.log(chalk19.dim("   Use `lean-spec stats --velocity` for velocity breakdown"));
+    console.log(chalk19.dim("   Use `lean-spec stats --timeline` for activity timeline"));
     console.log("");
     return;
   }
@@ -5191,97 +5619,97 @@ async function showStats(options) {
       (sum, count) => sum + count,
       0
     );
-    console.log(chalk18.bold("\u{1F4C8} Overview"));
+    console.log(chalk19.bold("\u{1F4C8} Overview"));
     console.log("");
     console.log(
       `  ${"Metric".padEnd(labelWidth)}  ${"Value".padStart(valueWidth)}`
     );
     console.log(
-      `  ${chalk18.dim("\u2500".repeat(labelWidth))}  ${chalk18.dim("\u2500".repeat(valueWidth))}`
+      `  ${chalk19.dim("\u2500".repeat(labelWidth))}  ${chalk19.dim("\u2500".repeat(valueWidth))}`
     );
     console.log(
-      `  ${"Total Specs".padEnd(labelWidth)}  ${chalk18.green(specs.length.toString().padStart(valueWidth))}`
+      `  ${"Total Specs".padEnd(labelWidth)}  ${chalk19.green(specs.length.toString().padStart(valueWidth))}`
     );
     console.log(
-      `  ${"With Priority".padEnd(labelWidth)}  ${chalk18.cyan(totalWithPriority.toString().padStart(valueWidth))}`
+      `  ${"With Priority".padEnd(labelWidth)}  ${chalk19.cyan(totalWithPriority.toString().padStart(valueWidth))}`
     );
     console.log(
-      `  ${"Unique Tags".padEnd(labelWidth)}  ${chalk18.magenta(Object.keys(tagCounts).length.toString().padStart(valueWidth))}`
+      `  ${"Unique Tags".padEnd(labelWidth)}  ${chalk19.magenta(Object.keys(tagCounts).length.toString().padStart(valueWidth))}`
     );
     console.log("");
-    console.log(chalk18.bold("\u{1F4CA} Status Distribution"));
+    console.log(chalk19.bold("\u{1F4CA} Status Distribution"));
     console.log("");
     const maxStatusCount = Math.max(...Object.values(statusCounts));
     const colWidth = barWidth + 3;
     console.log(
-      `  ${"Status".padEnd(labelWidth)}  ${chalk18.cyan("Count".padEnd(colWidth))}`
+      `  ${"Status".padEnd(labelWidth)}  ${chalk19.cyan("Count".padEnd(colWidth))}`
     );
     console.log(
-      `  ${chalk18.dim("\u2500".repeat(labelWidth))}  ${chalk18.dim("\u2500".repeat(colWidth))}`
+      `  ${chalk19.dim("\u2500".repeat(labelWidth))}  ${chalk19.dim("\u2500".repeat(colWidth))}`
     );
     console.log(
-      `  \u{1F4CB} ${"Planned".padEnd(labelWidth - 3)}  ${chalk18.cyan(createBar(statusCounts.planned, maxStatusCount).padEnd(barWidth))}${chalk18.cyan(statusCounts.planned.toString().padStart(3))}`
+      `  \u{1F4CB} ${"Planned".padEnd(labelWidth - 3)}  ${chalk19.cyan(createBar(statusCounts.planned, maxStatusCount).padEnd(barWidth))}${chalk19.cyan(statusCounts.planned.toString().padStart(3))}`
     );
     console.log(
-      `  \u23F3 ${"In Progress".padEnd(labelWidth - 3)}  ${chalk18.yellow(createBar(statusCounts["in-progress"], maxStatusCount).padEnd(barWidth))}${chalk18.yellow(statusCounts["in-progress"].toString().padStart(3))}`
+      `  \u23F3 ${"In Progress".padEnd(labelWidth - 3)}  ${chalk19.yellow(createBar(statusCounts["in-progress"], maxStatusCount).padEnd(barWidth))}${chalk19.yellow(statusCounts["in-progress"].toString().padStart(3))}`
     );
     console.log(
-      `  \u2705 ${"Complete".padEnd(labelWidth - 3)}  ${chalk18.green(createBar(statusCounts.complete, maxStatusCount).padEnd(barWidth))}${chalk18.green(statusCounts.complete.toString().padStart(3))}`
+      `  \u2705 ${"Complete".padEnd(labelWidth - 3)}  ${chalk19.green(createBar(statusCounts.complete, maxStatusCount).padEnd(barWidth))}${chalk19.green(statusCounts.complete.toString().padStart(3))}`
     );
     console.log(
-      `  \u{1F4E6} ${"Archived".padEnd(labelWidth - 3)}  ${chalk18.dim(createBar(statusCounts.archived, maxStatusCount).padEnd(barWidth))}${chalk18.dim(statusCounts.archived.toString().padStart(3))}`
+      `  \u{1F4E6} ${"Archived".padEnd(labelWidth - 3)}  ${chalk19.dim(createBar(statusCounts.archived, maxStatusCount).padEnd(barWidth))}${chalk19.dim(statusCounts.archived.toString().padStart(3))}`
     );
     console.log("");
     if (totalWithPriority > 0) {
-      console.log(chalk18.bold("\u{1F3AF} Priority Breakdown"));
+      console.log(chalk19.bold("\u{1F3AF} Priority Breakdown"));
       console.log("");
       const maxPriorityCount = Math.max(
         ...Object.values(priorityCounts).filter((c) => c > 0)
       );
       console.log(
-        `  ${"Priority".padEnd(labelWidth)}  ${chalk18.cyan("Count".padEnd(colWidth))}`
+        `  ${"Priority".padEnd(labelWidth)}  ${chalk19.cyan("Count".padEnd(colWidth))}`
       );
       console.log(
-        `  ${chalk18.dim("\u2500".repeat(labelWidth))}  ${chalk18.dim("\u2500".repeat(colWidth))}`
+        `  ${chalk19.dim("\u2500".repeat(labelWidth))}  ${chalk19.dim("\u2500".repeat(colWidth))}`
       );
       if (priorityCounts.critical > 0) {
         console.log(
-          `  \u{1F534} ${"Critical".padEnd(labelWidth - 3)}  ${chalk18.red(createBar(priorityCounts.critical, maxPriorityCount).padEnd(barWidth))}${chalk18.red(priorityCounts.critical.toString().padStart(3))}`
+          `  \u{1F534} ${"Critical".padEnd(labelWidth - 3)}  ${chalk19.red(createBar(priorityCounts.critical, maxPriorityCount).padEnd(barWidth))}${chalk19.red(priorityCounts.critical.toString().padStart(3))}`
         );
       }
       if (priorityCounts.high > 0) {
         console.log(
-          `  \u{1F7E0} ${"High".padEnd(labelWidth - 3)}  ${chalk18.hex("#FFA500")(createBar(priorityCounts.high, maxPriorityCount).padEnd(barWidth))}${chalk18.hex("#FFA500")(priorityCounts.high.toString().padStart(3))}`
+          `  \u{1F7E0} ${"High".padEnd(labelWidth - 3)}  ${chalk19.hex("#FFA500")(createBar(priorityCounts.high, maxPriorityCount).padEnd(barWidth))}${chalk19.hex("#FFA500")(priorityCounts.high.toString().padStart(3))}`
         );
       }
       if (priorityCounts.medium > 0) {
         console.log(
-          `  \u{1F7E1} ${"Medium".padEnd(labelWidth - 3)}  ${chalk18.yellow(createBar(priorityCounts.medium, maxPriorityCount).padEnd(barWidth))}${chalk18.yellow(priorityCounts.medium.toString().padStart(3))}`
+          `  \u{1F7E1} ${"Medium".padEnd(labelWidth - 3)}  ${chalk19.yellow(createBar(priorityCounts.medium, maxPriorityCount).padEnd(barWidth))}${chalk19.yellow(priorityCounts.medium.toString().padStart(3))}`
         );
       }
       if (priorityCounts.low > 0) {
         console.log(
-          `  \u{1F7E2} ${"Low".padEnd(labelWidth - 3)}  ${chalk18.green(createBar(priorityCounts.low, maxPriorityCount).padEnd(barWidth))}${chalk18.green(priorityCounts.low.toString().padStart(3))}`
+          `  \u{1F7E2} ${"Low".padEnd(labelWidth - 3)}  ${chalk19.green(createBar(priorityCounts.low, maxPriorityCount).padEnd(barWidth))}${chalk19.green(priorityCounts.low.toString().padStart(3))}`
         );
       }
       console.log("");
     }
     const topTags = Object.entries(tagCounts).sort((a, b) => b[1] - a[1]).slice(0, 5);
     if (topTags.length > 0) {
-      console.log(chalk18.bold("\u{1F3F7}\uFE0F  Popular Tags"));
+      console.log(chalk19.bold("\u{1F3F7}\uFE0F  Popular Tags"));
       console.log("");
       const maxTagCount = Math.max(...topTags.map(([, count]) => count));
       console.log(
-        `  ${"Tag".padEnd(labelWidth)}  ${chalk18.magenta("Count".padEnd(colWidth))}`
+        `  ${"Tag".padEnd(labelWidth)}  ${chalk19.magenta("Count".padEnd(colWidth))}`
       );
       console.log(
-        `  ${chalk18.dim("\u2500".repeat(labelWidth))}  ${chalk18.dim("\u2500".repeat(colWidth))}`
+        `  ${chalk19.dim("\u2500".repeat(labelWidth))}  ${chalk19.dim("\u2500".repeat(colWidth))}`
       );
       for (const [tag, count] of topTags) {
         const truncatedTag = tag.length > labelWidth ? tag.substring(0, labelWidth - 1) + "\u2026" : tag;
         const bar = createBar(count, maxTagCount);
         console.log(
-          `  ${truncatedTag.padEnd(labelWidth)}  ${chalk18.magenta(bar.padEnd(barWidth))}${chalk18.magenta(count.toString().padStart(3))}`
+          `  ${truncatedTag.padEnd(labelWidth)}  ${chalk19.magenta(bar.padEnd(barWidth))}${chalk19.magenta(count.toString().padStart(3))}`
         );
       }
       console.log("");
@@ -5313,14 +5741,14 @@ async function showStats(options) {
     ]);
     const sortedDates = Array.from(allDates).sort();
     if (sortedDates.length > 0) {
-      console.log(chalk18.bold(`\u{1F4C5} Activity (Last ${days} Days)`));
+      console.log(chalk19.bold(`\u{1F4C5} Activity (Last ${days} Days)`));
       console.log("");
       const colWidth = barWidth + 3;
       console.log(
-        `  ${"Date".padEnd(15)}  ${chalk18.cyan("Created".padEnd(colWidth))}  ${chalk18.green("Completed".padEnd(colWidth))}`
+        `  ${"Date".padEnd(15)}  ${chalk19.cyan("Created".padEnd(colWidth))}  ${chalk19.green("Completed".padEnd(colWidth))}`
       );
       console.log(
-        `  ${chalk18.dim("\u2500".repeat(15))}  ${chalk18.dim("\u2500".repeat(colWidth))}  ${chalk18.dim("\u2500".repeat(colWidth))}`
+        `  ${chalk19.dim("\u2500".repeat(15))}  ${chalk19.dim("\u2500".repeat(colWidth))}  ${chalk19.dim("\u2500".repeat(colWidth))}`
       );
       const maxCount = Math.max(
         ...Object.values(createdByDate),
@@ -5334,85 +5762,85 @@ async function showStats(options) {
         const createdCol = `${createdBar.padEnd(barWidth)}${created.toString().padStart(3)}`;
         const completedCol = `${completedBar.padEnd(barWidth)}${completed.toString().padStart(3)}`;
         console.log(
-          `  ${chalk18.dim(date.padEnd(15))}  ${chalk18.cyan(createdCol)}  ${chalk18.green(completedCol)}`
+          `  ${chalk19.dim(date.padEnd(15))}  ${chalk19.cyan(createdCol)}  ${chalk19.green(completedCol)}`
         );
       }
       console.log("");
     }
   }
   if (showVelocity) {
-    console.log(chalk18.bold("\u{1F680} Velocity Metrics"));
+    console.log(chalk19.bold("\u{1F680} Velocity Metrics"));
     console.log("");
-    console.log(chalk18.bold("\u23F1\uFE0F  Cycle Time (Created \u2192 Completed)"));
+    console.log(chalk19.bold("\u23F1\uFE0F  Cycle Time (Created \u2192 Completed)"));
     console.log("");
     console.log(
       `  ${"Metric".padEnd(labelWidth)}  ${"Days".padStart(valueWidth)}`
     );
     console.log(
-      `  ${chalk18.dim("\u2500".repeat(labelWidth))}  ${chalk18.dim("\u2500".repeat(valueWidth))}`
+      `  ${chalk19.dim("\u2500".repeat(labelWidth))}  ${chalk19.dim("\u2500".repeat(valueWidth))}`
     );
     console.log(
-      `  ${"Average".padEnd(labelWidth)}  ${chalk18.cyan(velocityMetrics.cycleTime.average.toFixed(1).padStart(valueWidth))}`
+      `  ${"Average".padEnd(labelWidth)}  ${chalk19.cyan(velocityMetrics.cycleTime.average.toFixed(1).padStart(valueWidth))}`
     );
     console.log(
-      `  ${"Median".padEnd(labelWidth)}  ${chalk18.cyan(velocityMetrics.cycleTime.median.toFixed(1).padStart(valueWidth))}`
+      `  ${"Median".padEnd(labelWidth)}  ${chalk19.cyan(velocityMetrics.cycleTime.median.toFixed(1).padStart(valueWidth))}`
     );
     console.log(
-      `  ${"90th Percentile".padEnd(labelWidth)}  ${chalk18.yellow(velocityMetrics.cycleTime.p90.toFixed(1).padStart(valueWidth))}`
+      `  ${"90th Percentile".padEnd(labelWidth)}  ${chalk19.yellow(velocityMetrics.cycleTime.p90.toFixed(1).padStart(valueWidth))}`
     );
     console.log("");
-    console.log(chalk18.bold("\u{1F4E6} Throughput"));
+    console.log(chalk19.bold("\u{1F4E6} Throughput"));
     console.log("");
     console.log(
       `  ${"Period".padEnd(labelWidth)}  ${"Specs".padStart(valueWidth)}`
     );
     console.log(
-      `  ${chalk18.dim("\u2500".repeat(labelWidth))}  ${chalk18.dim("\u2500".repeat(valueWidth))}`
+      `  ${chalk19.dim("\u2500".repeat(labelWidth))}  ${chalk19.dim("\u2500".repeat(valueWidth))}`
     );
     console.log(
-      `  ${"Last 7 days".padEnd(labelWidth)}  ${chalk18.green(velocityMetrics.throughput.perWeek.toString().padStart(valueWidth))}`
+      `  ${"Last 7 days".padEnd(labelWidth)}  ${chalk19.green(velocityMetrics.throughput.perWeek.toString().padStart(valueWidth))}`
     );
     console.log(
-      `  ${"Last 30 days".padEnd(labelWidth)}  ${chalk18.green(velocityMetrics.throughput.perMonth.toString().padStart(valueWidth))}`
+      `  ${"Last 30 days".padEnd(labelWidth)}  ${chalk19.green(velocityMetrics.throughput.perMonth.toString().padStart(valueWidth))}`
     );
-    const trendColor = velocityMetrics.throughput.trend === "up" ? chalk18.green : velocityMetrics.throughput.trend === "down" ? chalk18.red : chalk18.yellow;
+    const trendColor = velocityMetrics.throughput.trend === "up" ? chalk19.green : velocityMetrics.throughput.trend === "down" ? chalk19.red : chalk19.yellow;
     const trendSymbol = velocityMetrics.throughput.trend === "up" ? "\u2191" : velocityMetrics.throughput.trend === "down" ? "\u2193" : "\u2192";
     console.log(
       `  ${"Trend".padEnd(labelWidth)}  ${trendColor(trendSymbol + " " + velocityMetrics.throughput.trend.padStart(valueWidth - 2))}`
     );
     console.log("");
-    console.log(chalk18.bold("\u{1F504} Work In Progress"));
+    console.log(chalk19.bold("\u{1F504} Work In Progress"));
     console.log("");
     console.log(
       `  ${"Metric".padEnd(labelWidth)}  ${"Specs".padStart(valueWidth)}`
     );
     console.log(
-      `  ${chalk18.dim("\u2500".repeat(labelWidth))}  ${chalk18.dim("\u2500".repeat(valueWidth))}`
+      `  ${chalk19.dim("\u2500".repeat(labelWidth))}  ${chalk19.dim("\u2500".repeat(valueWidth))}`
     );
     console.log(
-      `  ${"Current".padEnd(labelWidth)}  ${chalk18.yellow(velocityMetrics.wip.current.toString().padStart(valueWidth))}`
+      `  ${"Current".padEnd(labelWidth)}  ${chalk19.yellow(velocityMetrics.wip.current.toString().padStart(valueWidth))}`
     );
     console.log(
-      `  ${"30-day Average".padEnd(labelWidth)}  ${chalk18.cyan(velocityMetrics.wip.average.toFixed(1).padStart(valueWidth))}`
+      `  ${"30-day Average".padEnd(labelWidth)}  ${chalk19.cyan(velocityMetrics.wip.average.toFixed(1).padStart(valueWidth))}`
     );
     console.log("");
     if (velocityMetrics.leadTime.plannedToInProgress > 0 || velocityMetrics.leadTime.inProgressToComplete > 0) {
-      console.log(chalk18.bold("\u{1F500} Lead Time by Stage"));
+      console.log(chalk19.bold("\u{1F500} Lead Time by Stage"));
       console.log("");
       console.log(
         `  ${"Stage".padEnd(labelWidth)}  ${"Days".padStart(valueWidth)}`
       );
       console.log(
-        `  ${chalk18.dim("\u2500".repeat(labelWidth))}  ${chalk18.dim("\u2500".repeat(valueWidth))}`
+        `  ${chalk19.dim("\u2500".repeat(labelWidth))}  ${chalk19.dim("\u2500".repeat(valueWidth))}`
       );
       if (velocityMetrics.leadTime.plannedToInProgress > 0) {
         console.log(
-          `  ${"Planned \u2192 In Progress".padEnd(labelWidth)}  ${chalk18.cyan(velocityMetrics.leadTime.plannedToInProgress.toFixed(1).padStart(valueWidth))}`
+          `  ${"Planned \u2192 In Progress".padEnd(labelWidth)}  ${chalk19.cyan(velocityMetrics.leadTime.plannedToInProgress.toFixed(1).padStart(valueWidth))}`
         );
       }
       if (velocityMetrics.leadTime.inProgressToComplete > 0) {
         console.log(
-          `  ${"In Progress \u2192 Complete".padEnd(labelWidth)}  ${chalk18.green(velocityMetrics.leadTime.inProgressToComplete.toFixed(1).padStart(valueWidth))}`
+          `  ${"In Progress \u2192 Complete".padEnd(labelWidth)}  ${chalk19.green(velocityMetrics.leadTime.inProgressToComplete.toFixed(1).padStart(valueWidth))}`
         );
       }
       console.log("");
@@ -5420,14 +5848,15 @@ async function showStats(options) {
   }
 }
 function searchCommand() {
-  return new Command("search").description("Full-text search with metadata filters").argument("<query>", "Search query").option("--status <status>", "Filter by status").option("--tag <tag>", "Filter by tag").option("--priority <priority>", "Filter by priority").option("--assignee <name>", "Filter by assignee").option("--field <name=value...>", "Filter by custom field (can specify multiple)").action(async (query, options) => {
+  return new Command("search").description("Full-text search with metadata filters").argument("<query>", "Search query").option("--status <status>", "Filter by status").option("--tag <tag>", "Filter by tag").option("--priority <priority>", "Filter by priority").option("--assignee <name>", "Filter by assignee").option("--field <name=value...>", "Filter by custom field (can specify multiple)").option("--json", "Output as JSON").action(async (query, options) => {
     const customFields = parseCustomFieldOptions(options.field);
     await performSearch(query, {
       status: options.status,
       tag: options.tag,
       priority: options.priority,
       assignee: options.assignee,
-      customFields: Object.keys(customFields).length > 0 ? customFields : void 0
+      customFields: Object.keys(customFields).length > 0 ? customFields : void 0,
+      json: options.json
     });
   });
 }
@@ -5466,36 +5895,55 @@ async function performSearch(query, options) {
     contextLength: 80
   });
   const { results, metadata } = searchResult;
+  if (options.json) {
+    const jsonOutput = {
+      query,
+      results: results.map((r) => ({
+        spec: r.spec.path,
+        score: r.score,
+        totalMatches: r.totalMatches,
+        matches: r.matches.map((m) => ({
+          field: m.field,
+          text: m.text,
+          lineNumber: m.lineNumber
+        }))
+      })),
+      metadata,
+      filters: filter
+    };
+    console.log(JSON.stringify(jsonOutput, null, 2));
+    return;
+  }
   if (results.length === 0) {
     console.log("");
-    console.log(chalk18.yellow(`\u{1F50D} No specs found matching "${sanitizeUserInput(query)}"`));
+    console.log(chalk19.yellow(`\u{1F50D} No specs found matching "${sanitizeUserInput(query)}"`));
     if (Object.keys(filter).length > 0) {
       const filters = [];
       if (options.status) filters.push(`status=${sanitizeUserInput(options.status)}`);
       if (options.tag) filters.push(`tag=${sanitizeUserInput(options.tag)}`);
       if (options.priority) filters.push(`priority=${sanitizeUserInput(options.priority)}`);
       if (options.assignee) filters.push(`assignee=${sanitizeUserInput(options.assignee)}`);
-      console.log(chalk18.gray(`With filters: ${filters.join(", ")}`));
+      console.log(chalk19.gray(`With filters: ${filters.join(", ")}`));
     }
     console.log("");
     return;
   }
   console.log("");
-  console.log(chalk18.green(`\u{1F50D} Found ${results.length} spec${results.length === 1 ? "" : "s"} matching "${sanitizeUserInput(query)}"`));
-  console.log(chalk18.gray(`   Searched ${metadata.specsSearched} specs in ${metadata.searchTime}ms`));
+  console.log(chalk19.green(`\u{1F50D} Found ${results.length} spec${results.length === 1 ? "" : "s"} matching "${sanitizeUserInput(query)}"`));
+  console.log(chalk19.gray(`   Searched ${metadata.specsSearched} specs in ${metadata.searchTime}ms`));
   if (Object.keys(filter).length > 0) {
     const filters = [];
     if (options.status) filters.push(`status=${sanitizeUserInput(options.status)}`);
     if (options.tag) filters.push(`tag=${sanitizeUserInput(options.tag)}`);
     if (options.priority) filters.push(`priority=${sanitizeUserInput(options.priority)}`);
     if (options.assignee) filters.push(`assignee=${sanitizeUserInput(options.assignee)}`);
-    console.log(chalk18.gray(`   With filters: ${filters.join(", ")}`));
+    console.log(chalk19.gray(`   With filters: ${filters.join(", ")}`));
   }
   console.log("");
   for (const result of results) {
     const { spec, matches, score, totalMatches } = result;
     const statusEmoji = spec.status === "in-progress" ? "\u{1F528}" : spec.status === "complete" ? "\u2705" : "\u{1F4C5}";
-    console.log(chalk18.cyan(`${statusEmoji} ${sanitizeUserInput(spec.path)} ${chalk18.gray(`(${score}% match)`)}`));
+    console.log(chalk19.cyan(`${statusEmoji} ${sanitizeUserInput(spec.path)} ${chalk19.gray(`(${score}% match)`)}`));
     const meta = [];
     if (spec.priority) {
       const priorityEmoji = spec.priority === "critical" ? "\u{1F534}" : spec.priority === "high" ? "\u{1F7E1}" : spec.priority === "medium" ? "\u{1F7E0}" : "\u{1F7E2}";
@@ -5505,30 +5953,30 @@ async function performSearch(query, options) {
       meta.push(`[${spec.tags.map((tag) => sanitizeUserInput(tag)).join(", ")}]`);
     }
     if (meta.length > 0) {
-      console.log(chalk18.gray(`   ${meta.join(" \u2022 ")}`));
+      console.log(chalk19.gray(`   ${meta.join(" \u2022 ")}`));
     }
     const titleMatch = matches.find((m) => m.field === "title");
     if (titleMatch) {
-      console.log(`   ${chalk18.bold("Title:")} ${highlightMatches(titleMatch.text, titleMatch.highlights)}`);
+      console.log(`   ${chalk19.bold("Title:")} ${highlightMatches(titleMatch.text, titleMatch.highlights)}`);
     }
     const descMatch = matches.find((m) => m.field === "description");
     if (descMatch) {
-      console.log(`   ${chalk18.bold("Description:")} ${highlightMatches(descMatch.text, descMatch.highlights)}`);
+      console.log(`   ${chalk19.bold("Description:")} ${highlightMatches(descMatch.text, descMatch.highlights)}`);
     }
     const tagMatches = matches.filter((m) => m.field === "tags");
     if (tagMatches.length > 0) {
-      console.log(`   ${chalk18.bold("Tags:")} ${tagMatches.map((m) => highlightMatches(m.text, m.highlights)).join(", ")}`);
+      console.log(`   ${chalk19.bold("Tags:")} ${tagMatches.map((m) => highlightMatches(m.text, m.highlights)).join(", ")}`);
     }
     const contentMatches = matches.filter((m) => m.field === "content");
     if (contentMatches.length > 0) {
-      console.log(`   ${chalk18.bold("Content matches:")}`);
+      console.log(`   ${chalk19.bold("Content matches:")}`);
       for (const match of contentMatches) {
-        const lineInfo = match.lineNumber ? chalk18.gray(`[L${match.lineNumber}]`) : "";
+        const lineInfo = match.lineNumber ? chalk19.gray(`[L${match.lineNumber}]`) : "";
         console.log(`   ${lineInfo} ${highlightMatches(match.text, match.highlights)}`);
       }
     }
     if (totalMatches > matches.length) {
-      console.log(chalk18.gray(`   ... and ${totalMatches - matches.length} more match${totalMatches - matches.length === 1 ? "" : "es"}`));
+      console.log(chalk19.gray(`   ... and ${totalMatches - matches.length} more match${totalMatches - matches.length === 1 ? "" : "es"}`));
     }
     console.log("");
   }
@@ -5539,7 +5987,7 @@ function highlightMatches(text, highlights) {
   let lastEnd = 0;
   for (const [start, end] of highlights) {
     result += text.substring(lastEnd, start);
-    result += chalk18.yellow(text.substring(start, end));
+    result += chalk19.yellow(text.substring(start, end));
     lastEnd = end;
   }
   result += text.substring(lastEnd);
@@ -5557,7 +6005,7 @@ async function showDeps(specPath, options = {}) {
   await autoCheckIfEnabled();
   const config = await loadConfig();
   const cwd = process.cwd();
-  const specsDir = path4.join(cwd, config.specsDir);
+  const specsDir = path15.join(cwd, config.specsDir);
   const resolvedPath = await resolveSpecPath(specPath, cwd, specsDir);
   if (!resolvedPath) {
     throw new Error(`Spec not found: ${sanitizeUserInput(specPath)}`);
@@ -5621,17 +6069,17 @@ async function showDeps(specPath, options = {}) {
     return;
   }
   console.log("");
-  console.log(chalk18.green(`\u{1F4E6} Dependencies for ${chalk18.cyan(sanitizeUserInput(spec.path))}`));
+  console.log(chalk19.green(`\u{1F4E6} Dependencies for ${chalk19.cyan(sanitizeUserInput(spec.path))}`));
   console.log("");
   const hasAnyRelationships = dependsOn.length > 0 || requiredBy.length > 0 || related.length > 0;
   if (!hasAnyRelationships) {
-    console.log(chalk18.gray("  No dependencies or relationships"));
+    console.log(chalk19.gray("  No dependencies or relationships"));
     console.log("");
     return;
   }
   if ((mode === "complete" || mode === "upstream" || mode === "impact") && dependsOn.length > 0) {
     const label = mode === "complete" ? "Depends On" : mode === "upstream" ? "Upstream Dependencies" : "Upstream (Impact)";
-    console.log(chalk18.bold(`${label}:`));
+    console.log(chalk19.bold(`${label}:`));
     for (const dep of dependsOn) {
       const status = getStatusIndicator(dep.frontmatter.status);
       console.log(`  \u2192 ${sanitizeUserInput(dep.path)} ${status}`);
@@ -5640,7 +6088,7 @@ async function showDeps(specPath, options = {}) {
   }
   if ((mode === "complete" || mode === "downstream" || mode === "impact") && requiredBy.length > 0) {
     const label = mode === "complete" ? "Required By" : mode === "downstream" ? "Downstream Dependents" : "Downstream (Impact)";
-    console.log(chalk18.bold(`${label}:`));
+    console.log(chalk19.bold(`${label}:`));
     for (const blocked of requiredBy) {
       const status = getStatusIndicator(blocked.frontmatter.status);
       console.log(`  \u2190 ${sanitizeUserInput(blocked.path)} ${status}`);
@@ -5648,7 +6096,7 @@ async function showDeps(specPath, options = {}) {
     console.log("");
   }
   if ((mode === "complete" || mode === "impact") && related.length > 0) {
-    console.log(chalk18.bold("Related Specs:"));
+    console.log(chalk19.bold("Related Specs:"));
     for (const rel of related) {
       const status = getStatusIndicator(rel.frontmatter.status);
       console.log(`  \u27F7 ${sanitizeUserInput(rel.path)} ${status}`);
@@ -5656,15 +6104,15 @@ async function showDeps(specPath, options = {}) {
     console.log("");
   }
   if (mode === "complete" && (options.graph || dependsOn.length > 0)) {
-    console.log(chalk18.bold("Dependency Chain:"));
+    console.log(chalk19.bold("Dependency Chain:"));
     const chain = buildDependencyChain(spec, specMap, options.depth || 3);
     displayChain(chain, 0);
     console.log("");
   }
   if (mode === "impact") {
     const total = dependsOn.length + requiredBy.length + related.length;
-    console.log(chalk18.bold(`Impact Summary:`));
-    console.log(`  Changing this spec affects ${chalk18.yellow(total)} specs total`);
+    console.log(chalk19.bold(`Impact Summary:`));
+    console.log(`  Changing this spec affects ${chalk19.yellow(total)} specs total`);
     console.log(`    Upstream: ${dependsOn.length} | Downstream: ${requiredBy.length} | Related: ${related.length}`);
     console.log("");
   }
@@ -5694,7 +6142,7 @@ function buildDependencyChain(spec, specMap, maxDepth, currentDepth = 0, visited
 function displayChain(node, level) {
   const indent = "  ".repeat(level);
   const status = getStatusIndicator(node.spec.frontmatter.status);
-  const name = level === 0 ? chalk18.cyan(node.spec.path) : node.spec.path;
+  const name = level === 0 ? chalk19.cyan(node.spec.path) : node.spec.path;
   console.log(`${indent}${name} ${status}`);
   for (const dep of node.dependencies) {
     const prefix = "  ".repeat(level) + "\u2514\u2500 ";
@@ -5706,7 +6154,7 @@ function displayChain(node, level) {
   }
 }
 function timelineCommand() {
-  return new Command("timeline").description("Show creation/completion over time").option("--days <n>", "Show last N days (default: 30)", parseInt).option("--by-tag", "Group by tag").option("--by-assignee", "Group by assignee").action(async (options) => {
+  return new Command("timeline").description("Show creation/completion over time").option("--days <n>", "Show last N days (default: 30)", parseInt).option("--by-tag", "Group by tag").option("--by-assignee", "Group by assignee").option("--json", "Output as JSON").action(async (options) => {
     await showTimeline(options);
   });
 }
@@ -5745,19 +6193,29 @@ async function showTimeline(options) {
       }
     }
   }
-  console.log(chalk18.bold.cyan("\u{1F4C8} Spec Timeline"));
+  if (options.json) {
+    const jsonOutput = {
+      days,
+      createdByDate,
+      completedByDate,
+      createdByMonth
+    };
+    console.log(JSON.stringify(jsonOutput, null, 2));
+    return;
+  }
+  console.log(chalk19.bold.cyan("\u{1F4C8} Spec Timeline"));
   console.log("");
   const allDates = /* @__PURE__ */ new Set([...Object.keys(createdByDate), ...Object.keys(completedByDate)]);
   const sortedDates = Array.from(allDates).sort();
   if (sortedDates.length > 0) {
-    console.log(chalk18.bold(`\u{1F4C5} Activity (Last ${days} Days)`));
+    console.log(chalk19.bold(`\u{1F4C5} Activity (Last ${days} Days)`));
     console.log("");
     const labelWidth2 = 15;
     const barWidth = 20;
     const specsWidth = 3;
     const colWidth = barWidth + specsWidth;
-    console.log(`  ${"Date".padEnd(labelWidth2)}  ${chalk18.cyan("Created".padEnd(colWidth))}  ${chalk18.green("Completed".padEnd(colWidth))}`);
-    console.log(`  ${chalk18.dim("\u2500".repeat(labelWidth2))}  ${chalk18.dim("\u2500".repeat(colWidth))}  ${chalk18.dim("\u2500".repeat(colWidth))}`);
+    console.log(`  ${"Date".padEnd(labelWidth2)}  ${chalk19.cyan("Created".padEnd(colWidth))}  ${chalk19.green("Completed".padEnd(colWidth))}`);
+    console.log(`  ${chalk19.dim("\u2500".repeat(labelWidth2))}  ${chalk19.dim("\u2500".repeat(colWidth))}  ${chalk19.dim("\u2500".repeat(colWidth))}`);
     const maxCount = Math.max(...Object.values(createdByDate), ...Object.values(completedByDate));
     for (const date of sortedDates) {
       const created = createdByDate[date] || 0;
@@ -5766,7 +6224,7 @@ async function showTimeline(options) {
       const completedBar = createBar(completed, maxCount, barWidth);
       const createdCol = `${createdBar.padEnd(barWidth)}${created.toString().padStart(specsWidth)}`;
       const completedCol = `${completedBar.padEnd(barWidth)}${completed.toString().padStart(specsWidth)}`;
-      console.log(`  ${chalk18.dim(date.padEnd(labelWidth2))}  ${chalk18.cyan(createdCol)}  ${chalk18.green(completedCol)}`);
+      console.log(`  ${chalk19.dim(date.padEnd(labelWidth2))}  ${chalk19.cyan(createdCol)}  ${chalk19.green(completedCol)}`);
     }
     console.log("");
   }
@@ -5776,18 +6234,18 @@ async function showTimeline(options) {
     return dateB.diff(dateA);
   }).slice(0, 6);
   if (sortedMonths.length > 0) {
-    console.log(chalk18.bold("\u{1F4CA} Monthly Overview"));
+    console.log(chalk19.bold("\u{1F4CA} Monthly Overview"));
     console.log("");
     const labelWidth2 = 15;
     const barWidth = 20;
     const specsWidth = 3;
     const colWidth = barWidth + specsWidth;
-    console.log(`  ${"Month".padEnd(labelWidth2)}  ${chalk18.magenta("Specs".padEnd(colWidth))}`);
-    console.log(`  ${chalk18.dim("\u2500".repeat(labelWidth2))}  ${chalk18.dim("\u2500".repeat(colWidth))}`);
+    console.log(`  ${"Month".padEnd(labelWidth2)}  ${chalk19.magenta("Specs".padEnd(colWidth))}`);
+    console.log(`  ${chalk19.dim("\u2500".repeat(labelWidth2))}  ${chalk19.dim("\u2500".repeat(colWidth))}`);
     const maxCount = Math.max(...sortedMonths.map(([, count]) => count));
     for (const [month, count] of sortedMonths) {
       const bar = createBar(count, maxCount, barWidth);
-      console.log(`  ${month.padEnd(labelWidth2)}  ${chalk18.magenta(bar.padEnd(barWidth))}${chalk18.magenta(count.toString().padStart(specsWidth))}`);
+      console.log(`  ${month.padEnd(labelWidth2)}  ${chalk19.magenta(bar.padEnd(barWidth))}${chalk19.magenta(count.toString().padStart(specsWidth))}`);
     }
     console.log("");
   }
@@ -5801,14 +6259,14 @@ async function showTimeline(options) {
     const completed = dayjs3(s.frontmatter.completed);
     return completed.isAfter(today.subtract(30, "day"));
   }).length;
-  console.log(chalk18.bold("\u2705 Completion Rate"));
+  console.log(chalk19.bold("\u2705 Completion Rate"));
   console.log("");
   const labelWidth = 15;
   const valueWidth = 5;
   console.log(`  ${"Period".padEnd(labelWidth)}  ${"Specs".padStart(valueWidth)}`);
-  console.log(`  ${chalk18.dim("\u2500".repeat(labelWidth))}  ${chalk18.dim("\u2500".repeat(valueWidth))}`);
-  console.log(`  ${"Last 7 days".padEnd(labelWidth)}  ${chalk18.green(last7Days.toString().padStart(valueWidth))}`);
-  console.log(`  ${"Last 30 days".padEnd(labelWidth)}  ${chalk18.green(last30Days.toString().padStart(valueWidth))}`);
+  console.log(`  ${chalk19.dim("\u2500".repeat(labelWidth))}  ${chalk19.dim("\u2500".repeat(valueWidth))}`);
+  console.log(`  ${"Last 7 days".padEnd(labelWidth)}  ${chalk19.green(last7Days.toString().padStart(valueWidth))}`);
+  console.log(`  ${"Last 30 days".padEnd(labelWidth)}  ${chalk19.green(last30Days.toString().padStart(valueWidth))}`);
   console.log("");
   if (options.byTag) {
     const tagStats = {};
@@ -5830,9 +6288,9 @@ async function showTimeline(options) {
     }
     const sortedTags = Object.entries(tagStats).sort((a, b) => b[1].created - a[1].created).slice(0, 10);
     if (sortedTags.length > 0) {
-      console.log(chalk18.bold("\u{1F3F7}\uFE0F  By Tag"));
+      console.log(chalk19.bold("\u{1F3F7}\uFE0F  By Tag"));
       for (const [tag, stats] of sortedTags) {
-        console.log(`  ${chalk18.dim("#")}${tag.padEnd(20)} ${chalk18.cyan(stats.created)} created \xB7 ${chalk18.green(stats.completed)} completed`);
+        console.log(`  ${chalk19.dim("#")}${tag.padEnd(20)} ${chalk19.cyan(stats.created)} created \xB7 ${chalk19.green(stats.completed)} completed`);
       }
       console.log("");
     }
@@ -5857,9 +6315,9 @@ async function showTimeline(options) {
     }
     const sortedAssignees = Object.entries(assigneeStats).sort((a, b) => b[1].created - a[1].created);
     if (sortedAssignees.length > 0) {
-      console.log(chalk18.bold("\u{1F464} By Assignee"));
+      console.log(chalk19.bold("\u{1F464} By Assignee"));
       for (const [assignee, stats] of sortedAssignees) {
-        console.log(`  ${chalk18.dim("@")}${assignee.padEnd(20)} ${chalk18.cyan(stats.created)} created \xB7 ${chalk18.green(stats.completed)} completed`);
+        console.log(`  ${chalk19.dim("@")}${assignee.padEnd(20)} ${chalk19.cyan(stats.created)} created \xB7 ${chalk19.green(stats.completed)} completed`);
       }
       console.log("");
     }
@@ -5877,13 +6335,13 @@ var STATUS_CONFIG2 = {
   archived: { emoji: "\u{1F4E6}", color: "gray" }
 };
 var PRIORITY_CONFIG3 = {
-  critical: { emoji: "\u{1F534}", label: "CRITICAL", colorFn: chalk18.red },
-  high: { emoji: "\u{1F7E0}", label: "HIGH", colorFn: chalk18.hex("#FFA500") },
-  medium: { emoji: "\u{1F7E1}", label: "MEDIUM", colorFn: chalk18.yellow },
-  low: { emoji: "\u{1F7E2}", label: "LOW", colorFn: chalk18.green }
+  critical: { emoji: "\u{1F534}", label: "CRITICAL", colorFn: chalk19.red },
+  high: { emoji: "\u{1F7E0}", label: "HIGH", colorFn: chalk19.hex("#FFA500") },
+  medium: { emoji: "\u{1F7E1}", label: "MEDIUM", colorFn: chalk19.yellow },
+  low: { emoji: "\u{1F7E2}", label: "LOW", colorFn: chalk19.green }
 };
 function ganttCommand() {
-  return new Command("gantt").description("Show timeline with dependencies").option("--weeks <n>", "Show N weeks (default: 4)", parseInt).option("--show-complete", "Include completed specs").option("--critical-path", "Highlight critical path").action(async (options) => {
+  return new Command("gantt").description("Show timeline with dependencies").option("--weeks <n>", "Show N weeks (default: 4)", parseInt).option("--show-complete", "Include completed specs").option("--critical-path", "Highlight critical path").option("--json", "Output as JSON").action(async (options) => {
     await showGantt(options);
   });
 }
@@ -5908,8 +6366,28 @@ async function showGantt(options) {
     return spec.frontmatter.status !== "archived";
   });
   if (relevantSpecs.length === 0) {
-    console.log(chalk18.dim("No active specs found."));
-    console.log(chalk18.dim("Tip: Use --show-complete to include completed specs."));
+    if (options.json) {
+      console.log(JSON.stringify({ specs: [], weeks }, null, 2));
+    } else {
+      console.log(chalk19.dim("No active specs found."));
+      console.log(chalk19.dim("Tip: Use --show-complete to include completed specs."));
+    }
+    return;
+  }
+  if (options.json) {
+    const jsonOutput = {
+      weeks,
+      specs: relevantSpecs.map((spec) => ({
+        path: spec.path,
+        status: spec.frontmatter.status,
+        priority: spec.frontmatter.priority,
+        created: spec.frontmatter.created,
+        completed: spec.frontmatter.completed,
+        due: spec.frontmatter.due,
+        dependsOn: spec.frontmatter.depends_on
+      }))
+    };
+    console.log(JSON.stringify(jsonOutput, null, 2));
     return;
   }
   const groupedSpecs = {
@@ -5945,7 +6423,7 @@ async function showGantt(options) {
   const overdue = relevantSpecs.filter(
     (s) => s.frontmatter.due && dayjs3(s.frontmatter.due).isBefore(today) && s.frontmatter.status !== "complete"
   ).length;
-  console.log(chalk18.bold.cyan(`\u{1F4C5} Gantt Chart (${weeks} weeks from ${startDate.format("MMM D, YYYY")})`));
+  console.log(chalk19.bold.cyan(`\u{1F4C5} Gantt Chart (${weeks} weeks from ${startDate.format("MMM D, YYYY")})`));
   console.log("");
   const specHeader = "Spec".padEnd(SPEC_COLUMN_WIDTH);
   const timelineHeader = "Timeline";
@@ -5957,17 +6435,17 @@ async function showGantt(options) {
     calendarDates.push(dateStr);
   }
   const dateRow = " ".repeat(SPEC_COLUMN_WIDTH) + COLUMN_SEPARATOR + calendarDates.join("");
-  console.log(chalk18.dim(dateRow));
+  console.log(chalk19.dim(dateRow));
   const specSeparator = "\u2500".repeat(SPEC_COLUMN_WIDTH);
   const timelineSeparator = "\u2500".repeat(timelineColumnWidth);
-  console.log(chalk18.dim(specSeparator + COLUMN_SEPARATOR + timelineSeparator));
+  console.log(chalk19.dim(specSeparator + COLUMN_SEPARATOR + timelineSeparator));
   const todayWeekOffset = today.diff(startDate, "week");
   const todayMarkerPos = todayWeekOffset * 8;
   let todayMarker = " ".repeat(SPEC_COLUMN_WIDTH) + COLUMN_SEPARATOR;
   if (todayMarkerPos >= 0 && todayMarkerPos < timelineColumnWidth) {
     todayMarker += " ".repeat(todayMarkerPos) + "\u2502 Today";
   }
-  console.log(chalk18.dim(todayMarker));
+  console.log(chalk19.dim(todayMarker));
   console.log("");
   const priorities = ["critical", "high", "medium", "low"];
   for (const priority of priorities) {
@@ -5985,9 +6463,9 @@ async function showGantt(options) {
   const summaryParts = [];
   if (inProgress > 0) summaryParts.push(`${inProgress} in-progress`);
   if (planned > 0) summaryParts.push(`${planned} planned`);
-  if (overdue > 0) summaryParts.push(chalk18.red(`${overdue} overdue`));
-  console.log(chalk18.bold("Summary: ") + summaryParts.join(" \xB7 "));
-  console.log(chalk18.dim('\u{1F4A1} Tip: Add "due: YYYY-MM-DD" to frontmatter for timeline planning'));
+  if (overdue > 0) summaryParts.push(chalk19.red(`${overdue} overdue`));
+  console.log(chalk19.bold("Summary: ") + summaryParts.join(" \xB7 "));
+  console.log(chalk19.dim('\u{1F4A1} Tip: Add "due: YYYY-MM-DD" to frontmatter for timeline planning'));
 }
 function renderSpecRow(spec, startDate, endDate, weeks, today) {
   const statusConfig = STATUS_CONFIG2[spec.frontmatter.status];
@@ -6000,7 +6478,7 @@ function renderSpecRow(spec, startDate, endDate, weeks, today) {
   const specColumn = `${SPEC_INDENT}${emoji} ${specName}`.padEnd(SPEC_COLUMN_WIDTH);
   let timelineColumn;
   if (!spec.frontmatter.due) {
-    timelineColumn = chalk18.dim("(no due date set)");
+    timelineColumn = chalk19.dim("(no due date set)");
   } else {
     timelineColumn = renderTimelineBar(spec, startDate, endDate, weeks, today);
   }
@@ -6023,13 +6501,13 @@ function renderTimelineBar(spec, startDate, endDate, weeks, today) {
     result += " ".repeat(barStart);
   }
   if (spec.frontmatter.status === "complete") {
-    result += chalk18.green(FILLED_BAR_CHAR.repeat(barLength));
+    result += chalk19.green(FILLED_BAR_CHAR.repeat(barLength));
   } else if (spec.frontmatter.status === "in-progress") {
     const halfLength = Math.floor(barLength / 2);
-    result += chalk18.yellow(FILLED_BAR_CHAR.repeat(halfLength));
-    result += chalk18.dim(EMPTY_BAR_CHAR.repeat(barLength - halfLength));
+    result += chalk19.yellow(FILLED_BAR_CHAR.repeat(halfLength));
+    result += chalk19.dim(EMPTY_BAR_CHAR.repeat(barLength - halfLength));
   } else {
-    result += chalk18.dim(EMPTY_BAR_CHAR.repeat(barLength));
+    result += chalk19.dim(EMPTY_BAR_CHAR.repeat(barLength));
   }
   const trailingSpace = totalChars - barEnd;
   if (trailingSpace > 0) {
@@ -6055,12 +6533,12 @@ async function countSpecTokens(specPath, options = {}) {
   try {
     const config = await loadConfig();
     const cwd = process.cwd();
-    const specsDir = path4.join(cwd, config.specsDir);
+    const specsDir = path15.join(cwd, config.specsDir);
     const resolvedPath = await resolveSpecPath(specPath, cwd, specsDir);
     if (!resolvedPath) {
       throw new Error(`Spec not found: ${sanitizeUserInput(specPath)}`);
     }
-    const specName = path4.basename(resolvedPath);
+    const specName = path15.basename(resolvedPath);
     const result = await counter.countSpec(resolvedPath, {
       detailed: options.detailed,
       includeSubSpecs: options.includeSubSpecs
@@ -6073,42 +6551,42 @@ async function countSpecTokens(specPath, options = {}) {
       }, null, 2));
       return;
     }
-    console.log(chalk18.bold.cyan(`\u{1F4CA} Token Count: ${specName}`));
+    console.log(chalk19.bold.cyan(`\u{1F4CA} Token Count: ${specName}`));
     console.log("");
     const indicators = counter.getPerformanceIndicators(result.total);
     const levelEmoji = indicators.level === "excellent" ? "\u2705" : indicators.level === "good" ? "\u{1F44D}" : indicators.level === "warning" ? "\u26A0\uFE0F" : "\u{1F534}";
-    console.log(`  Total: ${chalk18.cyan(result.total.toLocaleString())} tokens ${levelEmoji}`);
+    console.log(`  Total: ${chalk19.cyan(result.total.toLocaleString())} tokens ${levelEmoji}`);
     console.log("");
     if (result.files.length > 1 || options.detailed) {
-      console.log(chalk18.bold("Files:"));
+      console.log(chalk19.bold("Files:"));
       console.log("");
       for (const file of result.files) {
-        const lineInfo = file.lines ? chalk18.dim(` (${file.lines} lines)`) : "";
-        console.log(`  ${file.path.padEnd(25)}  ${chalk18.cyan(file.tokens.toLocaleString().padStart(6))} tokens${lineInfo}`);
+        const lineInfo = file.lines ? chalk19.dim(` (${file.lines} lines)`) : "";
+        console.log(`  ${file.path.padEnd(25)}  ${chalk19.cyan(file.tokens.toLocaleString().padStart(6))} tokens${lineInfo}`);
       }
       console.log("");
     }
     if (options.detailed && result.breakdown) {
       const b = result.breakdown;
       const total = b.code + b.prose + b.tables + b.frontmatter;
-      console.log(chalk18.bold("Content Breakdown:"));
+      console.log(chalk19.bold("Content Breakdown:"));
       console.log("");
-      console.log(`  Prose       ${chalk18.cyan(b.prose.toLocaleString().padStart(6))} tokens  ${chalk18.dim(`(${Math.round(b.prose / total * 100)}%)`)}`);
-      console.log(`  Code        ${chalk18.cyan(b.code.toLocaleString().padStart(6))} tokens  ${chalk18.dim(`(${Math.round(b.code / total * 100)}%)`)}`);
-      console.log(`  Tables      ${chalk18.cyan(b.tables.toLocaleString().padStart(6))} tokens  ${chalk18.dim(`(${Math.round(b.tables / total * 100)}%)`)}`);
-      console.log(`  Frontmatter ${chalk18.cyan(b.frontmatter.toLocaleString().padStart(6))} tokens  ${chalk18.dim(`(${Math.round(b.frontmatter / total * 100)}%)`)}`);
+      console.log(`  Prose       ${chalk19.cyan(b.prose.toLocaleString().padStart(6))} tokens  ${chalk19.dim(`(${Math.round(b.prose / total * 100)}%)`)}`);
+      console.log(`  Code        ${chalk19.cyan(b.code.toLocaleString().padStart(6))} tokens  ${chalk19.dim(`(${Math.round(b.code / total * 100)}%)`)}`);
+      console.log(`  Tables      ${chalk19.cyan(b.tables.toLocaleString().padStart(6))} tokens  ${chalk19.dim(`(${Math.round(b.tables / total * 100)}%)`)}`);
+      console.log(`  Frontmatter ${chalk19.cyan(b.frontmatter.toLocaleString().padStart(6))} tokens  ${chalk19.dim(`(${Math.round(b.frontmatter / total * 100)}%)`)}`);
       console.log("");
     }
-    console.log(chalk18.bold("Performance Indicators:"));
+    console.log(chalk19.bold("Performance Indicators:"));
     console.log("");
-    const costColor = indicators.costMultiplier < 2 ? chalk18.green : indicators.costMultiplier < 4 ? chalk18.yellow : chalk18.red;
-    const effectivenessColor = indicators.effectiveness >= 95 ? chalk18.green : indicators.effectiveness >= 85 ? chalk18.yellow : chalk18.red;
-    console.log(`  Cost multiplier:  ${costColor(`${indicators.costMultiplier}x`)} ${chalk18.dim("vs 1,200 token baseline")}`);
-    console.log(`  AI effectiveness: ${effectivenessColor(`~${indicators.effectiveness}%`)} ${chalk18.dim("(hypothesis)")}`);
+    const costColor = indicators.costMultiplier < 2 ? chalk19.green : indicators.costMultiplier < 4 ? chalk19.yellow : chalk19.red;
+    const effectivenessColor = indicators.effectiveness >= 95 ? chalk19.green : indicators.effectiveness >= 85 ? chalk19.yellow : chalk19.red;
+    console.log(`  Cost multiplier:  ${costColor(`${indicators.costMultiplier}x`)} ${chalk19.dim("vs 1,200 token baseline")}`);
+    console.log(`  AI effectiveness: ${effectivenessColor(`~${indicators.effectiveness}%`)} ${chalk19.dim("(hypothesis)")}`);
     console.log(`  Context Economy:  ${levelEmoji} ${indicators.recommendation}`);
     console.log("");
     if (!options.includeSubSpecs && result.files.length === 1) {
-      console.log(chalk18.dim("\u{1F4A1} Use `--include-sub-specs` to count all sub-spec files"));
+      console.log(chalk19.dim("\u{1F4A1} Use `--include-sub-specs` to count all sub-spec files"));
     }
   } finally {
     counter.dispose();
@@ -6154,46 +6632,46 @@ async function tokensAllCommand(options = {}) {
     console.log(JSON.stringify(results, null, 2));
     return;
   }
-  console.log(chalk18.bold.cyan("\u{1F4CA} Token Counts"));
+  console.log(chalk19.bold.cyan("\u{1F4CA} Token Counts"));
   console.log("");
-  console.log(chalk18.dim(`Sorted by: ${sortBy}`));
+  console.log(chalk19.dim(`Sorted by: ${sortBy}`));
   console.log("");
   const totalTokens = results.reduce((sum, r) => sum + r.tokens, 0);
   const avgTokens = Math.round(totalTokens / results.length);
   const warningCount = results.filter((r) => r.level === "warning" || r.level === "problem").length;
-  console.log(chalk18.bold("Summary:"));
+  console.log(chalk19.bold("Summary:"));
   console.log("");
-  console.log(`  Total specs:    ${chalk18.cyan(results.length)}`);
-  console.log(`  Total tokens:   ${chalk18.cyan(totalTokens.toLocaleString())}`);
-  console.log(`  Average tokens: ${chalk18.cyan(avgTokens.toLocaleString())}`);
+  console.log(`  Total specs:    ${chalk19.cyan(results.length)}`);
+  console.log(`  Total tokens:   ${chalk19.cyan(totalTokens.toLocaleString())}`);
+  console.log(`  Average tokens: ${chalk19.cyan(avgTokens.toLocaleString())}`);
   if (warningCount > 0) {
-    console.log(`  Needs review:   ${chalk18.yellow(warningCount)} specs ${chalk18.dim("(\u26A0\uFE0F  or \u{1F534})")}`);
+    console.log(`  Needs review:   ${chalk19.yellow(warningCount)} specs ${chalk19.dim("(\u26A0\uFE0F  or \u{1F534})")}`);
   }
   console.log("");
   const nameCol = 35;
   const tokensCol = 10;
   const linesCol = 8;
-  console.log(chalk18.bold(
+  console.log(chalk19.bold(
     "Spec".padEnd(nameCol) + "Tokens".padStart(tokensCol) + "Lines".padStart(linesCol) + "  Status"
   ));
-  console.log(chalk18.dim("\u2500".repeat(nameCol + tokensCol + linesCol + 10)));
+  console.log(chalk19.dim("\u2500".repeat(nameCol + tokensCol + linesCol + 10)));
   const displayCount = options.all ? results.length : Math.min(20, results.length);
   for (let i = 0; i < displayCount; i++) {
     const r = results[i];
     const emoji = r.level === "excellent" ? "\u2705" : r.level === "good" ? "\u{1F44D}" : r.level === "warning" ? "\u26A0\uFE0F" : "\u{1F534}";
-    const tokensColor = r.level === "excellent" || r.level === "good" ? chalk18.cyan : r.level === "warning" ? chalk18.yellow : chalk18.red;
+    const tokensColor = r.level === "excellent" || r.level === "good" ? chalk19.cyan : r.level === "warning" ? chalk19.yellow : chalk19.red;
     const name = r.name.length > nameCol - 2 ? r.name.substring(0, nameCol - 3) + "\u2026" : r.name;
     console.log(
-      name.padEnd(nameCol) + tokensColor(r.tokens.toLocaleString().padStart(tokensCol)) + chalk18.dim(r.lines.toString().padStart(linesCol)) + `  ${emoji}`
+      name.padEnd(nameCol) + tokensColor(r.tokens.toLocaleString().padStart(tokensCol)) + chalk19.dim(r.lines.toString().padStart(linesCol)) + `  ${emoji}`
     );
   }
   if (results.length > displayCount) {
     console.log("");
-    console.log(chalk18.dim(`... and ${results.length - displayCount} more specs`));
-    console.log(chalk18.dim(`Use --all to show all specs`));
+    console.log(chalk19.dim(`... and ${results.length - displayCount} more specs`));
+    console.log(chalk19.dim(`Use --all to show all specs`));
   }
   console.log("");
-  console.log(chalk18.dim("Legend: \u2705 excellent (<2K) | \u{1F44D} good (<3.5K) | \u26A0\uFE0F  warning (<5K) | \u{1F534} problem (>5K)"));
+  console.log(chalk19.dim("Legend: \u2705 excellent (<2K) | \u{1F44D} good (<3.5K) | \u26A0\uFE0F  warning (<5K) | \u{1F534} problem (>5K)"));
   console.log("");
 }
 function analyzeCommand() {
@@ -6207,13 +6685,13 @@ async function analyzeSpec(specPath, options = {}) {
   try {
     const config = await loadConfig();
     const cwd = process.cwd();
-    const specsDir = path4.join(cwd, config.specsDir);
+    const specsDir = path15.join(cwd, config.specsDir);
     const resolvedPath = await resolveSpecPath(specPath, cwd, specsDir);
     if (!resolvedPath) {
       throw new Error(`Spec not found: ${sanitizeUserInput(specPath)}`);
     }
-    const specName = path4.basename(resolvedPath);
-    const readmePath = path4.join(resolvedPath, "README.md");
+    const specName = path15.basename(resolvedPath);
+    const readmePath = path15.join(resolvedPath, "README.md");
     const content = await readFile(readmePath, "utf-8");
     const structure = analyzeMarkdownStructure(content);
     const tokenResult = await counter.countSpec(resolvedPath, {
@@ -6316,44 +6794,44 @@ function getThresholdLimit(level) {
   }
 }
 function displayAnalysis(result, verbose) {
-  console.log(chalk18.bold.cyan(`\u{1F4CA} Spec Analysis: ${result.spec}`));
+  console.log(chalk19.bold.cyan(`\u{1F4CA} Spec Analysis: ${result.spec}`));
   console.log("");
   const statusEmoji = result.threshold.status === "excellent" ? "\u2705" : result.threshold.status === "good" ? "\u{1F44D}" : result.threshold.status === "warning" ? "\u26A0\uFE0F" : "\u{1F534}";
-  const tokenColor = result.threshold.status === "excellent" || result.threshold.status === "good" ? chalk18.cyan : result.threshold.status === "warning" ? chalk18.yellow : chalk18.red;
-  console.log(chalk18.bold("Token Count:"), tokenColor(result.metrics.tokens.toLocaleString()), "tokens", statusEmoji);
-  console.log(chalk18.dim(`  Threshold: ${result.threshold.limit.toLocaleString()} tokens`));
-  console.log(chalk18.dim(`  Status: ${result.threshold.message}`));
+  const tokenColor = result.threshold.status === "excellent" || result.threshold.status === "good" ? chalk19.cyan : result.threshold.status === "warning" ? chalk19.yellow : chalk19.red;
+  console.log(chalk19.bold("Token Count:"), tokenColor(result.metrics.tokens.toLocaleString()), "tokens", statusEmoji);
+  console.log(chalk19.dim(`  Threshold: ${result.threshold.limit.toLocaleString()} tokens`));
+  console.log(chalk19.dim(`  Status: ${result.threshold.message}`));
   console.log("");
-  console.log(chalk18.bold("Structure:"));
-  console.log(`  Lines: ${chalk18.cyan(result.metrics.lines.toLocaleString())}`);
-  console.log(`  Sections: ${chalk18.cyan(result.metrics.sections.total)} (H1:${result.metrics.sections.h1}, H2:${result.metrics.sections.h2}, H3:${result.metrics.sections.h3}, H4:${result.metrics.sections.h4})`);
-  console.log(`  Code blocks: ${chalk18.cyan(result.metrics.codeBlocks)}`);
-  console.log(`  Max nesting: ${chalk18.cyan(result.metrics.maxNesting)} levels`);
+  console.log(chalk19.bold("Structure:"));
+  console.log(`  Lines: ${chalk19.cyan(result.metrics.lines.toLocaleString())}`);
+  console.log(`  Sections: ${chalk19.cyan(result.metrics.sections.total)} (H1:${result.metrics.sections.h1}, H2:${result.metrics.sections.h2}, H3:${result.metrics.sections.h3}, H4:${result.metrics.sections.h4})`);
+  console.log(`  Code blocks: ${chalk19.cyan(result.metrics.codeBlocks)}`);
+  console.log(`  Max nesting: ${chalk19.cyan(result.metrics.maxNesting)} levels`);
   console.log("");
   if (verbose && result.structure.length > 0) {
     const topSections = result.structure.filter((s) => s.level <= 2).sort((a, b) => b.tokens - a.tokens).slice(0, 5);
-    console.log(chalk18.bold("Top Sections by Size:"));
+    console.log(chalk19.bold("Top Sections by Size:"));
     console.log("");
     for (let i = 0; i < topSections.length; i++) {
       const s = topSections[i];
       const percentage = Math.round(s.tokens / result.metrics.tokens * 100);
       const indent = "  ".repeat(s.level - 1);
       console.log(`  ${i + 1}. ${indent}${s.section}`);
-      console.log(`     ${chalk18.cyan(s.tokens.toLocaleString())} tokens / ${s.lineRange[1] - s.lineRange[0] + 1} lines ${chalk18.dim(`(${percentage}%)`)}`);
-      console.log(chalk18.dim(`     Lines ${s.lineRange[0]}-${s.lineRange[1]}`));
+      console.log(`     ${chalk19.cyan(s.tokens.toLocaleString())} tokens / ${s.lineRange[1] - s.lineRange[0] + 1} lines ${chalk19.dim(`(${percentage}%)`)}`);
+      console.log(chalk19.dim(`     Lines ${s.lineRange[0]}-${s.lineRange[1]}`));
     }
     console.log("");
   }
-  const actionColor = result.recommendation.action === "none" ? chalk18.green : result.recommendation.action === "compact" ? chalk18.yellow : result.recommendation.action === "split" ? chalk18.red : chalk18.blue;
-  console.log(chalk18.bold("Recommendation:"), actionColor(result.recommendation.action.toUpperCase()));
-  console.log(chalk18.dim(`  ${result.recommendation.reason}`));
-  console.log(chalk18.dim(`  Confidence: ${result.recommendation.confidence}`));
+  const actionColor = result.recommendation.action === "none" ? chalk19.green : result.recommendation.action === "compact" ? chalk19.yellow : result.recommendation.action === "split" ? chalk19.red : chalk19.blue;
+  console.log(chalk19.bold("Recommendation:"), actionColor(result.recommendation.action.toUpperCase()));
+  console.log(chalk19.dim(`  ${result.recommendation.reason}`));
+  console.log(chalk19.dim(`  Confidence: ${result.recommendation.confidence}`));
   console.log("");
   if (result.recommendation.action === "split") {
-    console.log(chalk18.dim("\u{1F4A1} Use `lean-spec split` to partition into sub-specs"));
-    console.log(chalk18.dim("\u{1F4A1} Consider splitting by H2 sections (concerns)"));
+    console.log(chalk19.dim("\u{1F4A1} Use `lean-spec split` to partition into sub-specs"));
+    console.log(chalk19.dim("\u{1F4A1} Consider splitting by H2 sections (concerns)"));
   } else if (result.recommendation.action === "compact") {
-    console.log(chalk18.dim("\u{1F4A1} Use `lean-spec compact` to remove redundancy"));
+    console.log(chalk19.dim("\u{1F4A1} Use `lean-spec compact` to remove redundancy"));
   }
   console.log("");
 }
@@ -6385,13 +6863,13 @@ async function splitSpec(specPath, options) {
     }
     const config = await loadConfig();
     const cwd = process.cwd();
-    const specsDir = path4.join(cwd, config.specsDir);
+    const specsDir = path15.join(cwd, config.specsDir);
     const resolvedPath = await resolveSpecPath(specPath, cwd, specsDir);
     if (!resolvedPath) {
       throw new Error(`Spec not found: ${sanitizeUserInput(specPath)}`);
     }
-    const specName = path4.basename(resolvedPath);
-    const readmePath = path4.join(resolvedPath, "README.md");
+    const specName = path15.basename(resolvedPath);
+    const readmePath = path15.join(resolvedPath, "README.md");
     const content = await readFile(readmePath, "utf-8");
     const parsedOutputs = parseOutputSpecs(options.outputs);
     validateNoOverlaps(parsedOutputs);
@@ -6414,7 +6892,7 @@ async function splitSpec(specPath, options) {
     await executeSplit(resolvedPath, specName, content, extractions, options);
   } catch (error) {
     if (error instanceof Error) {
-      console.error(chalk18.red(`Error: ${error.message}`));
+      console.error(chalk19.red(`Error: ${error.message}`));
     }
     throw error;
   }
@@ -6452,30 +6930,30 @@ function validateNoOverlaps(outputs) {
   }
 }
 async function displayDryRun(specName, extractions) {
-  console.log(chalk18.bold.cyan(`\u{1F4CB} Split Preview: ${specName}`));
+  console.log(chalk19.bold.cyan(`\u{1F4CB} Split Preview: ${specName}`));
   console.log("");
-  console.log(chalk18.bold("Would create:"));
+  console.log(chalk19.bold("Would create:"));
   console.log("");
   for (const ext of extractions) {
-    console.log(`  ${chalk18.cyan(ext.file)}`);
+    console.log(`  ${chalk19.cyan(ext.file)}`);
     console.log(`    Lines: ${ext.lines}`);
     const previewLines = ext.content.split("\n").slice(0, 3);
-    console.log(chalk18.dim("    Preview:"));
+    console.log(chalk19.dim("    Preview:"));
     for (const line of previewLines) {
-      console.log(chalk18.dim(`      ${line.substring(0, 60)}${line.length > 60 ? "..." : ""}`));
+      console.log(chalk19.dim(`      ${line.substring(0, 60)}${line.length > 60 ? "..." : ""}`));
     }
     console.log("");
   }
-  console.log(chalk18.dim("No files modified (dry run)"));
-  console.log(chalk18.dim("Run without --dry-run to apply changes"));
+  console.log(chalk19.dim("No files modified (dry run)"));
+  console.log(chalk19.dim("Run without --dry-run to apply changes"));
   console.log("");
 }
 async function executeSplit(specPath, specName, originalContent, extractions, options) {
-  console.log(chalk18.bold.cyan(`\u2702\uFE0F  Splitting: ${specName}`));
+  console.log(chalk19.bold.cyan(`\u2702\uFE0F  Splitting: ${specName}`));
   console.log("");
   const frontmatter = parseFrontmatterFromString(originalContent);
   for (const ext of extractions) {
-    const outputPath = path4.join(specPath, ext.file);
+    const outputPath = path15.join(specPath, ext.file);
     let finalContent = ext.content;
     if (ext.file === "README.md" && frontmatter) {
       const { content: contentWithFrontmatter } = createUpdatedFrontmatter(
@@ -6485,21 +6963,21 @@ async function executeSplit(specPath, specName, originalContent, extractions, op
       finalContent = contentWithFrontmatter;
     }
     await writeFile(outputPath, finalContent, "utf-8");
-    console.log(chalk18.green(`\u2713 Created ${ext.file} (${ext.lines} lines)`));
+    console.log(chalk19.green(`\u2713 Created ${ext.file} (${ext.lines} lines)`));
   }
   if (options.updateRefs) {
-    const readmePath = path4.join(specPath, "README.md");
+    const readmePath = path15.join(specPath, "README.md");
     const readmeContent = await readFile(readmePath, "utf-8");
     const updatedReadme = await addSubSpecLinks(
       readmeContent,
       extractions.map((e) => e.file).filter((f) => f !== "README.md")
     );
     await writeFile(readmePath, updatedReadme, "utf-8");
-    console.log(chalk18.green(`\u2713 Updated README.md with sub-spec links`));
+    console.log(chalk19.green(`\u2713 Updated README.md with sub-spec links`));
   }
   console.log("");
-  console.log(chalk18.bold.green("Split complete!"));
-  console.log(chalk18.dim(`Created ${extractions.length} files in ${specName}`));
+  console.log(chalk19.bold.green("Split complete!"));
+  console.log(chalk19.dim(`Created ${extractions.length} files in ${specName}`));
   console.log("");
 }
 async function addSubSpecLinks(content, subSpecs) {
@@ -6567,13 +7045,13 @@ async function compactSpec(specPath, options) {
     }
     const config = await loadConfig();
     const cwd = process.cwd();
-    const specsDir = path4.join(cwd, config.specsDir);
+    const specsDir = path15.join(cwd, config.specsDir);
     const resolvedPath = await resolveSpecPath(specPath, cwd, specsDir);
     if (!resolvedPath) {
       throw new Error(`Spec not found: ${sanitizeUserInput(specPath)}`);
     }
-    const specName = path4.basename(resolvedPath);
-    const readmePath = path4.join(resolvedPath, "README.md");
+    const specName = path15.basename(resolvedPath);
+    const readmePath = path15.join(resolvedPath, "README.md");
     const content = await readFile(readmePath, "utf-8");
     const parsedRemoves = parseRemoveSpecs(options.removes);
     validateNoOverlaps2(parsedRemoves);
@@ -6584,7 +7062,7 @@ async function compactSpec(specPath, options) {
     await executeCompact(readmePath, specName, content, parsedRemoves);
   } catch (error) {
     if (error instanceof Error) {
-      console.error(chalk18.red(`Error: ${error.message}`));
+      console.error(chalk19.red(`Error: ${error.message}`));
     }
     throw error;
   }
@@ -6623,9 +7101,9 @@ function validateNoOverlaps2(removes) {
   }
 }
 async function displayDryRun2(specName, content, removes) {
-  console.log(chalk18.bold.cyan(`\u{1F4CB} Compact Preview: ${specName}`));
+  console.log(chalk19.bold.cyan(`\u{1F4CB} Compact Preview: ${specName}`));
   console.log("");
-  console.log(chalk18.bold("Would remove:"));
+  console.log(chalk19.bold("Would remove:"));
   console.log("");
   let totalLines = 0;
   for (const remove of removes) {
@@ -6634,29 +7112,29 @@ async function displayDryRun2(specName, content, removes) {
     const removedContent = extractLines(content, remove.startLine, remove.endLine);
     const previewLines = removedContent.split("\n").slice(0, 3);
     console.log(`  Lines ${remove.startLine}-${remove.endLine} (${lineCount} lines)`);
-    console.log(chalk18.dim("    Preview:"));
+    console.log(chalk19.dim("    Preview:"));
     for (const line of previewLines) {
-      console.log(chalk18.dim(`      ${line.substring(0, 60)}${line.length > 60 ? "..." : ""}`));
+      console.log(chalk19.dim(`      ${line.substring(0, 60)}${line.length > 60 ? "..." : ""}`));
     }
     if (removedContent.split("\n").length > 3) {
-      console.log(chalk18.dim(`      ... (${removedContent.split("\n").length - 3} more lines)`));
+      console.log(chalk19.dim(`      ... (${removedContent.split("\n").length - 3} more lines)`));
     }
     console.log("");
   }
   const originalLines = countLines(content);
   const remainingLines = originalLines - totalLines;
   const percentage = Math.round(totalLines / originalLines * 100);
-  console.log(chalk18.bold("Summary:"));
-  console.log(`  Original lines:  ${chalk18.cyan(originalLines)}`);
-  console.log(`  Removing:        ${chalk18.yellow(totalLines)} lines (${percentage}%)`);
-  console.log(`  Remaining lines: ${chalk18.cyan(remainingLines)}`);
+  console.log(chalk19.bold("Summary:"));
+  console.log(`  Original lines:  ${chalk19.cyan(originalLines)}`);
+  console.log(`  Removing:        ${chalk19.yellow(totalLines)} lines (${percentage}%)`);
+  console.log(`  Remaining lines: ${chalk19.cyan(remainingLines)}`);
   console.log("");
-  console.log(chalk18.dim("No files modified (dry run)"));
-  console.log(chalk18.dim("Run without --dry-run to apply changes"));
+  console.log(chalk19.dim("No files modified (dry run)"));
+  console.log(chalk19.dim("Run without --dry-run to apply changes"));
   console.log("");
 }
 async function executeCompact(readmePath, specName, content, removes) {
-  console.log(chalk18.bold.cyan(`\u{1F5DC}\uFE0F  Compacting: ${specName}`));
+  console.log(chalk19.bold.cyan(`\u{1F5DC}\uFE0F  Compacting: ${specName}`));
   console.log("");
   const sorted = [...removes].sort((a, b) => b.startLine - a.startLine);
   let updatedContent = content;
@@ -6665,22 +7143,22 @@ async function executeCompact(readmePath, specName, content, removes) {
     const lineCount = remove.endLine - remove.startLine + 1;
     updatedContent = removeLines(updatedContent, remove.startLine, remove.endLine);
     totalRemoved += lineCount;
-    console.log(chalk18.green(`\u2713 Removed lines ${remove.startLine}-${remove.endLine} (${lineCount} lines)`));
+    console.log(chalk19.green(`\u2713 Removed lines ${remove.startLine}-${remove.endLine} (${lineCount} lines)`));
   }
   await writeFile(readmePath, updatedContent, "utf-8");
   const originalLines = countLines(content);
   const finalLines = countLines(updatedContent);
   const percentage = Math.round(totalRemoved / originalLines * 100);
   console.log("");
-  console.log(chalk18.bold.green("Compaction complete!"));
-  console.log(chalk18.dim(`Removed ${totalRemoved} lines (${percentage}%)`));
-  console.log(chalk18.dim(`${originalLines} \u2192 ${finalLines} lines`));
+  console.log(chalk19.bold.green("Compaction complete!"));
+  console.log(chalk19.dim(`Removed ${totalRemoved} lines (${percentage}%)`));
+  console.log(chalk19.dim(`${originalLines} \u2192 ${finalLines} lines`));
   console.log("");
 }
 marked.use(markedTerminal());
 async function readSpecContent(specPath, cwd = process.cwd()) {
   const config = await loadConfig(cwd);
-  const specsDir = path4.join(cwd, config.specsDir);
+  const specsDir = path15.join(cwd, config.specsDir);
   let resolvedPath = null;
   let targetFile = null;
   const pathParts = specPath.split("/").filter((p) => p);
@@ -6689,7 +7167,7 @@ async function readSpecContent(specPath, cwd = process.cwd()) {
     const filePart = pathParts[pathParts.length - 1];
     resolvedPath = await resolveSpecPath(specPart, cwd, specsDir);
     if (resolvedPath) {
-      targetFile = path4.join(resolvedPath, filePart);
+      targetFile = path15.join(resolvedPath, filePart);
       try {
         await fs9.access(targetFile);
       } catch {
@@ -6711,7 +7189,7 @@ async function readSpecContent(specPath, cwd = process.cwd()) {
     return null;
   }
   const rawContent = await fs9.readFile(targetFile, "utf-8");
-  const fileName = path4.basename(targetFile);
+  const fileName = path15.basename(targetFile);
   const isSubSpec = fileName !== config.structure.defaultFile;
   let frontmatter = null;
   if (!isSubSpec) {
@@ -6740,7 +7218,7 @@ async function readSpecContent(specPath, cwd = process.cwd()) {
     }
   }
   const content = lines.slice(contentStartIndex).join("\n").trim();
-  const specName = path4.basename(resolvedPath);
+  const specName = path15.basename(resolvedPath);
   const displayName = isSubSpec ? `${specName}/${fileName}` : specName;
   return {
     frontmatter,
@@ -6763,7 +7241,7 @@ function formatFrontmatter(frontmatter) {
     archived: "\u{1F4E6}"
   };
   const statusEmoji = statusEmojis[frontmatter.status] || "\u{1F4C4}";
-  lines.push(chalk18.bold(`${statusEmoji} Status: `) + chalk18.cyan(frontmatter.status));
+  lines.push(chalk19.bold(`${statusEmoji} Status: `) + chalk19.cyan(frontmatter.status));
   if (frontmatter.priority) {
     const priorityEmojis = {
       low: "\u{1F7E2}",
@@ -6772,25 +7250,25 @@ function formatFrontmatter(frontmatter) {
       critical: "\u{1F534}"
     };
     const priorityEmoji = priorityEmojis[frontmatter.priority] || "";
-    lines.push(chalk18.bold(`${priorityEmoji} Priority: `) + chalk18.yellow(frontmatter.priority));
+    lines.push(chalk19.bold(`${priorityEmoji} Priority: `) + chalk19.yellow(frontmatter.priority));
   }
   if (frontmatter.created) {
-    lines.push(chalk18.bold("\u{1F4C6} Created: ") + chalk18.gray(String(frontmatter.created)));
+    lines.push(chalk19.bold("\u{1F4C6} Created: ") + chalk19.gray(String(frontmatter.created)));
   }
   if (frontmatter.tags && frontmatter.tags.length > 0) {
-    const tagStr = frontmatter.tags.map((tag) => chalk18.blue(`#${tag}`)).join(" ");
-    lines.push(chalk18.bold("\u{1F3F7}\uFE0F  Tags: ") + tagStr);
+    const tagStr = frontmatter.tags.map((tag) => chalk19.blue(`#${tag}`)).join(" ");
+    lines.push(chalk19.bold("\u{1F3F7}\uFE0F  Tags: ") + tagStr);
   }
   if (frontmatter.assignee) {
-    lines.push(chalk18.bold("\u{1F464} Assignee: ") + chalk18.green(frontmatter.assignee));
+    lines.push(chalk19.bold("\u{1F464} Assignee: ") + chalk19.green(frontmatter.assignee));
   }
   const standardFields = ["status", "priority", "created", "tags", "assignee"];
   const customFields = Object.entries(frontmatter).filter(([key]) => !standardFields.includes(key)).filter(([_, value]) => value !== void 0 && value !== null);
   if (customFields.length > 0) {
     lines.push("");
-    lines.push(chalk18.bold("Custom Fields:"));
+    lines.push(chalk19.bold("Custom Fields:"));
     for (const [key, value] of customFields) {
-      lines.push(`  ${chalk18.gray(key)}: ${chalk18.white(String(value))}`);
+      lines.push(`  ${chalk19.gray(key)}: ${chalk19.white(String(value))}`);
     }
   }
   return lines.join("\n");
@@ -6798,11 +7276,11 @@ function formatFrontmatter(frontmatter) {
 function displayFormattedSpec(spec) {
   const output = [];
   output.push("");
-  output.push(chalk18.bold.cyan(`\u2501\u2501\u2501 ${spec.name} \u2501\u2501\u2501`));
+  output.push(chalk19.bold.cyan(`\u2501\u2501\u2501 ${spec.name} \u2501\u2501\u2501`));
   output.push("");
   output.push(formatFrontmatter(spec.frontmatter));
   output.push("");
-  output.push(chalk18.gray("\u2500".repeat(60)));
+  output.push(chalk19.gray("\u2500".repeat(60)));
   output.push("");
   return output.join("\n");
 }
@@ -6864,7 +7342,7 @@ function openCommand(specPath, options = {}) {
 async function openSpec(specPath, options = {}) {
   const cwd = process.cwd();
   const config = await loadConfig(cwd);
-  const specsDir = path4.join(cwd, config.specsDir);
+  const specsDir = path15.join(cwd, config.specsDir);
   let resolvedPath = null;
   let targetFile = null;
   const pathParts = specPath.split("/").filter((p) => p);
@@ -6873,7 +7351,7 @@ async function openSpec(specPath, options = {}) {
     const filePart = pathParts[pathParts.length - 1];
     resolvedPath = await resolveSpecPath(specPart, cwd, specsDir);
     if (resolvedPath) {
-      targetFile = path4.join(resolvedPath, filePart);
+      targetFile = path15.join(resolvedPath, filePart);
       try {
         await fs9.access(targetFile);
       } catch {
@@ -6907,7 +7385,7 @@ async function openSpec(specPath, options = {}) {
       editor = "xdg-open";
     }
   }
-  console.log(chalk18.gray(`Opening ${targetFile} with ${editor}...`));
+  console.log(chalk19.gray(`Opening ${targetFile} with ${editor}...`));
   const child = spawn(editor, [targetFile], {
     stdio: "inherit",
     shell: true
@@ -6953,7 +7431,7 @@ async function startMcpServer() {
     process.exit(1);
   }
 }
-function detectPackageManager(baseDir = process.cwd()) {
+function detectPackageManager2(baseDir = process.cwd()) {
   const userAgent = process.env.npm_config_user_agent || "";
   if (userAgent.includes("pnpm")) {
     return "pnpm";
@@ -6978,7 +7456,7 @@ function detectPackageManager(baseDir = process.cwd()) {
 
 // src/commands/ui.ts
 function uiCommand() {
-  return new Command("ui").description("Start local web UI for spec management").option("-s, --specs <dir>", "Specs directory (auto-detected if not specified)").option("-p, --port <port>", "Port to run on", "3000").option("--no-open", "Don't open browser automatically").option("--dev", "Run in development mode (only works in LeanSpec monorepo)").option("--dry-run", "Show what would run without executing").action(async (options) => {
+  return new Command("ui").description("Start local web UI for spec management").option("-s, --specs <dir>", "Specs directory (auto-detected if not specified)").option("-p, --port <port>", "Port to run on", "3000").option("--no-open", "Don't open browser automatically").option("--multi-project", "Enable multi-project mode").option("--add-project <path>", "Add a project to multi-project registry").option("--discover <path>", "Discover LeanSpec projects in directory tree").option("--dev", "Run in development mode (only works in LeanSpec monorepo)").option("--dry-run", "Show what would run without executing").action(async (options) => {
     try {
       await startUi(options);
     } catch (error) {
@@ -6989,34 +7467,45 @@ function uiCommand() {
 async function startUi(options) {
   const portNum = parseInt(options.port, 10);
   if (isNaN(portNum) || portNum < 1 || portNum > 65535) {
-    console.error(chalk18.red(`\u2717 Invalid port number: ${options.port}`));
-    console.log(chalk18.dim("Port must be between 1 and 65535"));
+    console.error(chalk19.red(`\u2717 Invalid port number: ${options.port}`));
+    console.log(chalk19.dim("Port must be between 1 and 65535"));
     throw new Error(`Invalid port: ${options.port}`);
   }
   const cwd = process.cwd();
-  let specsDir;
-  if (options.specs) {
-    specsDir = resolve(cwd, options.specs);
+  const specsMode = options.multiProject ? "multi-project" : "filesystem";
+  let specsDir = "";
+  if (!options.multiProject) {
+    if (options.specs) {
+      specsDir = resolve(cwd, options.specs);
+    } else {
+      const config = await loadConfig(cwd);
+      specsDir = join(cwd, config.specsDir);
+    }
+    if (!existsSync(specsDir)) {
+      console.error(chalk19.red(`\u2717 Specs directory not found: ${specsDir}`));
+      console.log(chalk19.dim("\nRun `lean-spec init` to initialize LeanSpec in this directory."));
+      throw new Error(`Specs directory not found: ${specsDir}`);
+    }
   } else {
-    const config = await loadConfig(cwd);
-    specsDir = join(cwd, config.specsDir);
-  }
-  if (!existsSync(specsDir)) {
-    console.error(chalk18.red(`\u2717 Specs directory not found: ${specsDir}`));
-    console.log(chalk18.dim("\nRun `lean-spec init` to initialize LeanSpec in this directory."));
-    throw new Error(`Specs directory not found: ${specsDir}`);
+    console.log(chalk19.cyan("\u2192 Multi-project mode enabled"));
+    if (options.addProject) {
+      console.log(chalk19.dim(`  Adding project: ${options.addProject}`));
+    }
+    if (options.discover) {
+      console.log(chalk19.dim(`  Will discover projects in: ${options.discover}`));
+    }
   }
   if (options.dev) {
     const isLeanSpecMonorepo = checkIsLeanSpecMonorepo(cwd);
     if (!isLeanSpecMonorepo) {
-      console.error(chalk18.red(`\u2717 Development mode only works in the LeanSpec monorepo`));
-      console.log(chalk18.dim("Remove --dev flag to use production mode"));
+      console.error(chalk19.red(`\u2717 Development mode only works in the LeanSpec monorepo`));
+      console.log(chalk19.dim("Remove --dev flag to use production mode"));
       throw new Error("Not in LeanSpec monorepo");
     }
     const localUiDir = join(cwd, "packages/ui");
-    return runLocalWeb(localUiDir, specsDir, options);
+    return runLocalWeb(localUiDir, specsDir, specsMode, options);
   }
-  return runPublishedUI(cwd, specsDir, options);
+  return runPublishedUI(cwd, specsDir, specsMode, options);
 }
 function checkIsLeanSpecMonorepo(cwd) {
   const localUiDir = join(cwd, "packages/ui");
@@ -7031,24 +7520,24 @@ function checkIsLeanSpecMonorepo(cwd) {
     return false;
   }
 }
-async function runLocalWeb(uiDir, specsDir, options) {
-  console.log(chalk18.dim("\u2192 Detected LeanSpec monorepo, using local ui package\n"));
+async function runLocalWeb(uiDir, specsDir, specsMode, options) {
+  console.log(chalk19.dim("\u2192 Detected LeanSpec monorepo, using local ui package\n"));
   const repoRoot = resolve(uiDir, "..", "..");
-  const packageManager = detectPackageManager(repoRoot);
+  const packageManager = detectPackageManager2(repoRoot);
   if (options.dryRun) {
-    console.log(chalk18.cyan("Would run:"));
-    console.log(chalk18.dim(`  cd ${uiDir}`));
-    console.log(chalk18.dim(`  SPECS_MODE=filesystem SPECS_DIR=${specsDir} PORT=${options.port} ${packageManager} run dev`));
+    console.log(chalk19.cyan("Would run:"));
+    console.log(chalk19.dim(`  cd ${uiDir}`));
+    console.log(chalk19.dim(`  SPECS_MODE=${specsMode} SPECS_DIR=${specsDir} PORT=${options.port} ${packageManager} run dev`));
     if (options.open) {
-      console.log(chalk18.dim(`  open http://localhost:${options.port}`));
+      console.log(chalk19.dim(`  open http://localhost:${options.port}`));
     }
     return;
   }
   const spinner = ora("Starting web UI...").start();
   const env = {
     ...process.env,
-    SPECS_MODE: "filesystem",
-    SPECS_DIR: specsDir,
+    SPECS_MODE: specsMode,
+    SPECS_DIR: specsDir || "",
     PORT: options.port
   };
   const child = spawn(packageManager, ["run", "dev"], {
@@ -7059,19 +7548,67 @@ async function runLocalWeb(uiDir, specsDir, options) {
   });
   const readyTimeout = setTimeout(async () => {
     spinner.succeed("Web UI running");
-    console.log(chalk18.green(`
+    console.log(chalk19.green(`
 \u2728 LeanSpec UI: http://localhost:${options.port}
 `));
-    console.log(chalk18.dim("Press Ctrl+C to stop\n"));
+    if (options.multiProject) {
+      console.log(chalk19.cyan("Multi-project mode is active"));
+      if (options.addProject) {
+        try {
+          const res = await fetch(`http://localhost:${options.port}/api/projects`, {
+            method: "POST",
+            headers: { "Content-Type": "application/json" },
+            body: JSON.stringify({ path: options.addProject })
+          });
+          if (res.ok) {
+            console.log(chalk19.green(`  \u2713 Added project: ${options.addProject}`));
+          } else {
+            console.error(chalk19.red(`  \u2717 Failed to add project: ${options.addProject}`));
+          }
+        } catch (e) {
+          console.error(chalk19.red(`  \u2717 Failed to connect to server for adding project`));
+        }
+      }
+      if (options.discover) {
+        console.log(chalk19.dim(`  Discovering projects in: ${options.discover}...`));
+        try {
+          const res = await fetch(`http://localhost:${options.port}/api/local-projects/discover`, {
+            method: "POST",
+            headers: { "Content-Type": "application/json" },
+            body: JSON.stringify({ path: options.discover })
+          });
+          if (res.ok) {
+            const data = await res.json();
+            const discovered = data.discovered || [];
+            console.log(chalk19.green(`  \u2713 Found ${discovered.length} projects`));
+            for (const p of discovered) {
+              const addRes = await fetch(`http://localhost:${options.port}/api/projects`, {
+                method: "POST",
+                headers: { "Content-Type": "application/json" },
+                body: JSON.stringify({ path: p.path })
+              });
+              if (addRes.ok) {
+                console.log(chalk19.dim(`    + Added: ${p.name} (${p.path})`));
+              }
+            }
+          } else {
+            console.error(chalk19.red(`  \u2717 Failed to discover projects`));
+          }
+        } catch (e) {
+          console.error(chalk19.red(`  \u2717 Failed to connect to server for discovery`));
+        }
+      }
+    }
+    console.log(chalk19.dim("\nPress Ctrl+C to stop\n"));
     if (options.open) {
       try {
         const openModule = await import('open');
         const open = openModule.default;
         await open(`http://localhost:${options.port}`);
       } catch (error) {
-        console.log(chalk18.yellow("\u26A0 Could not open browser automatically"));
-        console.log(chalk18.dim("Please visit the URL above manually\n"));
-        console.error(chalk18.dim(`Debug: ${error instanceof Error ? error.message : String(error)}`));
+        console.log(chalk19.yellow("\u26A0 Could not open browser automatically"));
+        console.log(chalk19.dim("Please visit the URL above manually\n"));
+        console.error(chalk19.dim(`Debug: ${error instanceof Error ? error.message : String(error)}`));
       }
     }
   }, 3e3);
@@ -7088,7 +7625,7 @@ async function runLocalWeb(uiDir, specsDir, options) {
       }
     } catch (err) {
     }
-    console.log(chalk18.dim("\n\u2713 Web UI stopped"));
+    console.log(chalk19.dim("\n\u2713 Web UI stopped"));
     process.exit(0);
   };
   process.once("SIGINT", () => shutdown("SIGINT"));
@@ -7102,20 +7639,20 @@ async function runLocalWeb(uiDir, specsDir, options) {
     spinner.stop();
     if (code !== 0 && code !== null) {
       spinner.fail("Web UI failed to start");
-      console.error(chalk18.red(`
+      console.error(chalk19.red(`
 Process exited with code ${code}`));
       process.exit(code);
     }
     process.exit(0);
   });
 }
-async function runPublishedUI(cwd, specsDir, options) {
-  console.log(chalk18.dim("\u2192 Using published @leanspec/ui package\n"));
-  const packageManager = detectPackageManager(cwd);
-  const { command, args, preview } = buildUiRunner(packageManager, specsDir, options.port, options.open);
+async function runPublishedUI(cwd, specsDir, specsMode, options) {
+  console.log(chalk19.dim("\u2192 Using published @leanspec/ui package\n"));
+  const packageManager = detectPackageManager2(cwd);
+  const { command, args, preview } = buildUiRunner(packageManager, specsDir, specsMode, options.port, options.open, options.multiProject);
   if (options.dryRun) {
-    console.log(chalk18.cyan("Would run:"));
-    console.log(chalk18.dim(`  ${preview}`));
+    console.log(chalk19.cyan("Would run:"));
+    console.log(chalk19.dim(`  ${preview}`));
     return;
   }
   const child = spawn(command, args, {
@@ -7134,7 +7671,7 @@ async function runPublishedUI(cwd, specsDir, options) {
       }
     } catch (err) {
     }
-    console.log(chalk18.dim("\n\u2713 Web UI stopped"));
+    console.log(chalk19.dim("\n\u2713 Web UI stopped"));
     process.exit(0);
   };
   process.once("SIGINT", () => shutdownPublished("SIGINT"));
@@ -7148,19 +7685,25 @@ async function runPublishedUI(cwd, specsDir, options) {
       process.exit(0);
       return;
     }
-    console.error(chalk18.red(`
+    console.error(chalk19.red(`
 @leanspec/ui exited with code ${code}`));
-    console.log(chalk18.dim("Make sure npm can download @leanspec/ui (https://www.npmjs.com/package/@leanspec/ui)."));
+    console.log(chalk19.dim("Make sure npm can download @leanspec/ui (https://www.npmjs.com/package/@leanspec/ui)."));
     process.exit(code);
   });
   child.on("error", (error) => {
-    console.error(chalk18.red(`Failed to launch @leanspec/ui: ${error instanceof Error ? error.message : String(error)}`));
-    console.log(chalk18.dim("You can also run it manually with `npx @leanspec/ui --specs <dir>`"));
+    console.error(chalk19.red(`Failed to launch @leanspec/ui: ${error instanceof Error ? error.message : String(error)}`));
+    console.log(chalk19.dim("You can also run it manually with `npx @leanspec/ui --specs <dir>`"));
     process.exit(1);
   });
 }
-function buildUiRunner(packageManager, specsDir, port, openBrowser) {
-  const uiArgs = ["@leanspec/ui", "--specs", specsDir, "--port", port];
+function buildUiRunner(packageManager, specsDir, specsMode, port, openBrowser, multiProject) {
+  const uiArgs = ["@leanspec/ui"];
+  if (!multiProject) {
+    uiArgs.push("--specs", specsDir);
+  } else {
+    uiArgs.push("--multi-project");
+  }
+  uiArgs.push("--port", port);
   if (!openBrowser) {
     uiArgs.push("--no-open");
   }
@@ -7492,7 +8035,7 @@ function createTool() {
 async function getDepsData(specPath, mode = "complete") {
   const config = await loadConfig();
   const cwd = process.cwd();
-  const specsDir = path4.join(cwd, config.specsDir);
+  const specsDir = path15.join(cwd, config.specsDir);
   const resolvedPath = await resolveSpecPath(specPath, cwd, specsDir);
   if (!resolvedPath) {
     throw new Error(`Spec not found: ${specPath}`);
@@ -7940,7 +8483,7 @@ function tokensTool() {
       try {
         const config = await loadConfig();
         const cwd = process.cwd();
-        const specsDir = path4.join(cwd, config.specsDir);
+        const specsDir = path15.join(cwd, config.specsDir);
         const resolvedPath = await resolveSpecPath(input.specPath, cwd, specsDir);
         if (!resolvedPath) {
           return {
@@ -7951,7 +8494,7 @@ function tokensTool() {
             isError: true
           };
         }
-        const specName = path4.basename(resolvedPath);
+        const specName = path15.basename(resolvedPath);
         const result = await counter.countSpec(resolvedPath, {
           detailed: input.detailed,
           includeSubSpecs: input.includeSubSpecs
@@ -8342,53 +8885,83 @@ function registerResources(server) {
   server.registerResource(...specResource());
   server.registerResource(...statsResource());
 }
-function createFeatureSpecPrompt() {
+function planProjectRoadmapPrompt() {
   return [
-    "create-feature-spec",
+    "plan-project-roadmap",
     {
-      title: "Create Feature Spec",
-      description: "Guided workflow to create a new feature specification",
+      title: "Plan Project Roadmap",
+      description: "Interactive roadmap planning with phases, tasks, and dependencies",
       argsSchema: {
-        featureName: z.string(),
-        description: z.string().optional()
+        goal: z.string()
       }
     },
-    ({ featureName, description }) => ({
+    ({ goal }) => ({
       messages: [
         {
           role: "user",
           content: {
             type: "text",
-            text: `Create a new feature specification for: ${featureName}${description ? `
+            text: `Plan a project roadmap for: ${goal}
 
-Description: ${description}` : ""}
+1. **Review Existing Work**: Analyze current specs using \`list\`/\`board\`, identify what's already planned/in-progress, assess how existing work relates to the new goal
+2. **Break Down Goal**: Decompose the goal into logical phases or milestones
+3. **Identify Tasks**: List key tasks and work items for each phase
+4. **Map Dependencies**: Establish dependencies between tasks (what must be done first)
+5. **Create Specs**: Create specification documents for major work items using the \`create\` tool
+6. **Set Relationships**: Use \`link\` tool to establish \`depends_on\` and \`related\` relationships
+7. **Timeline Estimation**: Provide realistic timeline based on task complexity and project velocity
+8. **Risk Analysis**: Identify risks, unknowns, and mitigation strategies
 
-Please create this spec with appropriate metadata (status, priority, tags) and include standard sections like Overview, Design, Plan, and Test.`
+Use the following tools to build the roadmap:
+- \`list\` / \`board\` / \`stats\` - Understand current project state
+- \`create\` - Create new specs for roadmap items
+- \`link\` - Establish dependencies between specs
+- \`update\` - Set priority and metadata
+
+Provide a clear roadmap with:
+- Phases/milestones with descriptions
+- Key specs to create
+- Dependency relationships
+- Recommended execution order
+- Actionable next steps to implement this plan`
           }
         }
       ]
     })
   ];
 }
-function findRelatedSpecsPrompt() {
+
+// src/mcp/prompts/project-progress-overview.ts
+function projectProgressOverviewPrompt() {
   return [
-    "find-related-specs",
+    "project-progress-overview",
     {
-      title: "Find Related Specs",
-      description: "Discover specifications related to a topic or feature",
-      argsSchema: {
-        topic: z.string()
-      }
+      title: "Project Progress Overview",
+      description: "Generate comprehensive project status report combining specs, git history, and metrics"
     },
-    ({ topic }) => ({
+    () => ({
       messages: [
         {
           role: "user",
           content: {
             type: "text",
-            text: `Find all specifications related to: ${topic}
+            text: `Analyze project progress and provide a comprehensive overview:
 
-Please search for this topic and show me the dependencies between related specs.`
+1. **Spec Analysis**: Review all specs using \`board\` and \`stats\`, group by status (planned/in-progress/complete), highlight any blockers or dependencies
+2. **Recent Activity**: Examine git commit history (last 2 weeks), identify key changes and development patterns
+3. **Current State**: Assess what's actively being worked on, what's completed, what's planned
+4. **Velocity Metrics**: Calculate completion rates, average time in each status, and throughput trends
+5. **Risk Assessment**: Identify stalled specs, missing dependencies, potential bottlenecks
+6. **Next Steps**: Recommend priority actions based on current project state
+
+Use the following tools to gather data:
+- \`board\` - Get Kanban view of specs by status
+- \`stats\` - Get project metrics
+- \`list\` - List specs with filters
+- \`deps\` - Analyze dependencies for critical specs
+- Terminal git commands - Analyze recent commit history
+
+Provide a clear, actionable summary that helps understand project health and next steps.`
           }
         }
       ]
@@ -8403,16 +8976,18 @@ function updateSpecStatusPrompt() {
       description: "Quick workflow to update specification status",
       argsSchema: {
         specPath: z.string(),
-        newStatus: z.enum(["planned", "in-progress", "complete", "archived"])
+        status: z.enum(["planned", "in-progress", "complete", "archived"])
       }
     },
-    ({ specPath, newStatus }) => ({
+    ({ specPath, status }) => ({
       messages: [
         {
           role: "user",
           content: {
             type: "text",
-            text: `Update the status of spec "${specPath}" to "${newStatus}". Use the update tool to make this change.`
+            text: `Update the status of spec "${specPath}" to "${status}".
+
+Use the \`update\` tool: \`update <spec> --status ${status}\``
           }
         }
       ]
@@ -8422,8 +8997,8 @@ function updateSpecStatusPrompt() {
 
 // src/mcp/prompts/registry.ts
 function registerPrompts(server) {
-  server.registerPrompt(...createFeatureSpecPrompt());
-  server.registerPrompt(...findRelatedSpecsPrompt());
+  server.registerPrompt(...projectProgressOverviewPrompt());
+  server.registerPrompt(...planProjectRoadmapPrompt());
   server.registerPrompt(...updateSpecStatusPrompt());
 }
 
@@ -8458,6 +9033,6 @@ if (import.meta.url === `file://${process.argv[1]}`) {
   main().catch(console.error);
 }
 
-export { analyzeCommand, archiveCommand, backfillCommand, boardCommand, checkCommand, compactCommand, createCommand, createMcpServer, depsCommand, filesCommand, ganttCommand, initCommand, linkCommand, listCommand, mcpCommand, migrateCommand, openCommand, searchCommand, splitCommand, statsCommand, templatesCommand, timelineCommand, tokensCommand, uiCommand, unlinkCommand, updateCommand, validateCommand, viewCommand };
-//# sourceMappingURL=chunk-7WXYOHZU.js.map
-//# sourceMappingURL=chunk-7WXYOHZU.js.map
+export { analyzeCommand, archiveCommand, backfillCommand, boardCommand, checkCommand, compactCommand, createCommand, createMcpServer, depsCommand, examplesCommand, filesCommand, ganttCommand, initCommand, linkCommand, listCommand, mcpCommand, migrateCommand, openCommand, searchCommand, splitCommand, statsCommand, templatesCommand, timelineCommand, tokensCommand, uiCommand, unlinkCommand, updateCommand, validateCommand, viewCommand };
+//# sourceMappingURL=chunk-RTEGSMVL.js.map
+//# sourceMappingURL=chunk-RTEGSMVL.js.map