lean-spec 0.2.5-dev.20251124070920 → 0.2.5-dev.20251125010225

package/dist/{chunk-LV7XEQ4D.js → chunk-RTEGSMVL.js}

@@ -550,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);
   });
@@ -578,10 +578,25 @@ 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(chalk19.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("");
@@ -698,13 +713,33 @@ async function createSpec(name, options = {}) {
   } else {
     templateName = config.template || "spec-template.md";
   }
-  const templatePath = path15.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: {
@@ -746,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(chalk19.green(`\u2713 Created: ${sanitizeUserInput(specDir)}/`));
-  console.log(chalk19.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() {
@@ -867,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,
@@ -877,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);
   });
@@ -913,7 +970,30 @@ async function listSpecs(options = {}) {
     })
   );
   if (specs.length === 0) {
-    console.log(chalk19.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;
+  }
+  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"));
@@ -1458,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
     });
   });
 }
@@ -1830,7 +1911,7 @@ async function detectExistingSystemPrompts(cwd) {
 async function handleExistingFiles(action, existingFiles, templateDir, cwd, variables = {}) {
   for (const file of existingFiles) {
     const filePath = path15.join(cwd, file);
-    const templateFilePath = path15.join(templateDir, "files", file);
+    const templateFilePath = path15.join(templateDir, file);
     try {
       await fs9.access(templateFilePath);
     } catch {
@@ -2003,7 +2084,7 @@ 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").option("-y, --yes", "Skip prompts and use defaults (quick start with standard template)").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) => {
+  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;
@@ -2012,10 +2093,10 @@ function initCommand() {
       await scaffoldExample(options.example, options.name);
       return;
     }
-    await initProject(options.yes);
+    await initProject(options.yes, options.template);
   });
 }
-async function initProject(skipPrompts = false) {
+async function initProject(skipPrompts = false, templateOption) {
   const cwd = process.cwd();
   try {
     await fs9.access(path15.join(cwd, ".lean-spec", "config.json"));
@@ -2028,11 +2109,11 @@ async function initProject(skipPrompts = false) {
   console.log(chalk19.green("Welcome to LeanSpec!"));
   console.log("");
   let setupMode = "quick";
-  let templateName = "standard";
+  let templateName = templateOption || "standard";
   if (skipPrompts) {
     console.log(chalk19.gray("Using defaults: quick start with standard template"));
     console.log("");
-  } else {
+  } else if (!templateOption) {
     setupMode = await select({
       message: "How would you like to set up?",
       choices: [
@@ -2044,7 +2125,7 @@ async function initProject(skipPrompts = false) {
         {
           name: "Choose template",
           value: "template",
-          description: "Pick from: minimal, standard, enterprise"
+          description: "Pick from: standard, detailed"
         }
         // TODO: Re-enable when custom setup mode is implemented
         // {
@@ -2058,17 +2139,27 @@ async function initProject(skipPrompts = false) {
       templateName = await select({
         message: "Select template:",
         choices: [
-          { name: "minimal", value: "minimal", description: "Just folder structure, no extras" },
-          { name: "standard", value: "standard", description: "Recommended - includes AGENTS.md" },
+          { name: "standard", value: "standard", description: "Recommended - single-file specs with AGENTS.md" },
           {
-            name: "enterprise",
-            value: "enterprise",
-            description: "Governance with approvals and compliance"
+            name: "detailed",
+            value: "detailed",
+            description: "Complex specs with sub-spec structure (DESIGN, PLAN, TEST)"
           }
         ]
       });
     }
   }
+  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;
@@ -2133,19 +2224,35 @@ async function initProject(skipPrompts = false) {
     console.error(chalk19.red("Error creating templates directory:"), error);
     process.exit(1);
   }
-  const templateSpecPath = path15.join(templateDir, "spec-template.md");
-  const targetSpecPath = path15.join(templatesDir, "spec-template.md");
+  const templateFilesDir = path15.join(templateDir, "files");
   try {
-    await fs9.copyFile(templateSpecPath, targetSpecPath);
-    console.log(chalk19.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(chalk19.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(chalk19.green("\u2713 Created .lean-spec/config.json"));
   const existingFiles = await detectExistingSystemPrompts(cwd);
@@ -2191,9 +2298,26 @@ async function initProject(skipPrompts = false) {
     }
   }
   const projectName = await getProjectName2(cwd);
+  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 {
-    await copyDirectory(filesDir, cwd, skipFiles, { project_name: projectName });
+    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);
@@ -3648,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);
   });
 }
@@ -3666,6 +3790,31 @@ 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(chalk19.cyan(`\u{1F4C4} Files in ${sanitizeUserInput(spec.name)}`));
   console.log("");
@@ -4530,13 +4679,13 @@ Validating ${specs.length} specs...
 
 // 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
     });
@@ -5011,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);
   });
 }
@@ -5032,7 +5181,11 @@ async function showBoard(options) {
     })
   );
   if (specs.length === 0) {
-    console.log(chalk19.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 = {
@@ -5047,6 +5200,29 @@ async function showBoard(options) {
       columns[status].push(spec);
     }
   }
+  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 = [];
@@ -5672,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
     });
   });
 }
@@ -5718,6 +5895,25 @@ 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(chalk19.yellow(`\u{1F50D} No specs found matching "${sanitizeUserInput(query)}"`));
@@ -5958,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);
   });
 }
@@ -5997,6 +6193,16 @@ async function showTimeline(options) {
       }
     }
   }
+  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)]);
@@ -6135,7 +6341,7 @@ var PRIORITY_CONFIG3 = {
   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);
   });
 }
@@ -6160,8 +6366,28 @@ async function showGantt(options) {
     return spec.frontmatter.status !== "archived";
   });
   if (relevantSpecs.length === 0) {
-    console.log(chalk19.dim("No active specs found."));
-    console.log(chalk19.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 = {
@@ -8808,5 +9034,5 @@ if (import.meta.url === `file://${process.argv[1]}`) {
 }
 
 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-LV7XEQ4D.js.map
-//# sourceMappingURL=chunk-LV7XEQ4D.js.map
+//# sourceMappingURL=chunk-RTEGSMVL.js.map
+//# sourceMappingURL=chunk-RTEGSMVL.js.map