@doccov/cli 0.12.0 → 0.14.0

package/dist/cli.js

@@ -1,22 +1,4 @@
 #!/usr/bin/env node
-import { createRequire } from "node:module";
-var __create = Object.create;
-var __getProtoOf = Object.getPrototypeOf;
-var __defProp = Object.defineProperty;
-var __getOwnPropNames = Object.getOwnPropertyNames;
-var __hasOwnProp = Object.prototype.hasOwnProperty;
-var __toESM = (mod, isNodeMode, target) => {
-  target = mod != null ? __create(__getProtoOf(mod)) : {};
-  const to = isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target;
-  for (let key of __getOwnPropNames(mod))
-    if (!__hasOwnProp.call(to, key))
-      __defProp(to, key, {
-        get: () => mod[key],
-        enumerable: true
-      });
-  return to;
-};
-var __require = /* @__PURE__ */ createRequire(import.meta.url);
 
 // src/config/doccov-config.ts
 import { access } from "node:fs/promises";
@@ -178,8 +160,8 @@ ${formatIssues(issues)}`);
 // src/config/index.ts
 var defineConfig = (config) => config;
 // src/cli.ts
-import { readFileSync as readFileSync4 } from "node:fs";
-import * as path10 from "node:path";
+import { readFileSync as readFileSync3 } from "node:fs";
+import * as path8 from "node:path";
 import { fileURLToPath } from "node:url";
 import { Command } from "commander";
 
@@ -206,7 +188,7 @@ import {
 import {
   DRIFT_CATEGORIES as DRIFT_CATEGORIES2
 } from "@openpkg-ts/spec";
-import chalk2 from "chalk";
+import chalk3 from "chalk";
 
 // src/reports/diff-markdown.ts
 import * as path2 from "node:path";
@@ -788,6 +770,57 @@ async function parseAssertionsWithLLM(code) {
   }
 }
 
+// src/utils/progress.ts
+import chalk2 from "chalk";
+class StepProgress {
+  steps;
+  currentStep = 0;
+  startTime;
+  stepStartTime;
+  constructor(steps) {
+    this.steps = steps;
+    this.startTime = Date.now();
+    this.stepStartTime = Date.now();
+  }
+  start(stepIndex) {
+    this.currentStep = stepIndex ?? 0;
+    this.stepStartTime = Date.now();
+    this.render();
+  }
+  next() {
+    this.completeCurrentStep();
+    this.currentStep++;
+    if (this.currentStep < this.steps.length) {
+      this.stepStartTime = Date.now();
+      this.render();
+    }
+  }
+  complete(message) {
+    this.completeCurrentStep();
+    if (message) {
+      const elapsed = ((Date.now() - this.startTime) / 1000).toFixed(1);
+      console.log(`${chalk2.green("✓")} ${message} ${chalk2.dim(`(${elapsed}s)`)}`);
+    }
+  }
+  render() {
+    const step = this.steps[this.currentStep];
+    if (!step)
+      return;
+    const label = step.activeLabel ?? step.label;
+    const prefix = chalk2.dim(`[${this.currentStep + 1}/${this.steps.length}]`);
+    process.stdout.write(`\r${prefix} ${chalk2.cyan(label)}...`);
+  }
+  completeCurrentStep() {
+    const step = this.steps[this.currentStep];
+    if (!step)
+      return;
+    const elapsed = ((Date.now() - this.stepStartTime) / 1000).toFixed(1);
+    const prefix = chalk2.dim(`[${this.currentStep + 1}/${this.steps.length}]`);
+    process.stdout.write(`\r${" ".repeat(80)}\r`);
+    console.log(`${prefix} ${step.label} ${chalk2.green("✓")} ${chalk2.dim(`(${elapsed}s)`)}`);
+  }
+}
+
 // src/utils/validation.ts
 function clampPercentage(value, fallback = 80) {
   if (Number.isNaN(value))
@@ -830,24 +863,32 @@ function registerCheckCommand(program, dependencies = {}) {
   };
   program.command("check [entry]").description("Check documentation coverage and output reports").option("--cwd <dir>", "Working directory", process.cwd()).option("--package <name>", "Target package name (for monorepos)").option("--min-coverage <percentage>", "Minimum docs coverage percentage (0-100)", (value) => Number(value)).option("--max-drift <percentage>", "Maximum drift percentage allowed (0-100)", (value) => Number(value)).option("--examples [mode]", "Example validation: presence, typecheck, run (comma-separated). Bare flag runs all.").option("--skip-resolve", "Skip external type resolution from node_modules").option("--fix", "Auto-fix drift issues").option("--write", "Alias for --fix").option("--dry-run", "Preview fixes without writing (requires --fix)").option("--format <format>", "Output format: text, json, markdown, html, github", "text").option("-o, --output <file>", "Custom output path (overrides default .doccov/ path)").option("--stdout", "Output to stdout instead of writing to .doccov/").option("--update-snapshot", "Force regenerate .doccov/report.json").option("--limit <n>", "Max exports to show in report tables", "20").option("--max-type-depth <number>", "Maximum depth for type conversion (default: 20)").option("--no-cache", "Bypass spec cache and force regeneration").action(async (entry, options) => {
     try {
+      const validations = parseExamplesFlag(options.examples);
+      const hasExamples = validations.length > 0;
+      const stepList = [
+        { label: "Resolved target", activeLabel: "Resolving target" },
+        { label: "Loaded config", activeLabel: "Loading config" },
+        { label: "Generated spec", activeLabel: "Generating spec" },
+        { label: "Enriched spec", activeLabel: "Enriching spec" },
+        ...hasExamples ? [{ label: "Validated examples", activeLabel: "Validating examples" }] : [],
+        { label: "Processed results", activeLabel: "Processing results" }
+      ];
+      const steps = new StepProgress(stepList);
+      steps.start();
       const fileSystem = new NodeFileSystem(options.cwd);
       const resolved = await resolveTarget(fileSystem, {
         cwd: options.cwd,
         package: options.package,
         entry
       });
-      const { targetDir, entryFile, packageInfo, entryPointInfo } = resolved;
-      if (packageInfo) {
-        log(chalk2.gray(`Found package at ${packageInfo.path}`));
-      }
-      if (!entry) {
-        log(chalk2.gray(`Auto-detected entry point: ${entryPointInfo.path} (from ${entryPointInfo.source})`));
-      }
+      const { targetDir, entryFile } = resolved;
+      steps.next();
       const config = await loadDocCovConfig(targetDir);
       const minCoverageRaw = options.minCoverage ?? config?.check?.minCoverage;
       const minCoverage = minCoverageRaw !== undefined ? clampPercentage(minCoverageRaw) : undefined;
       const maxDriftRaw = options.maxDrift ?? config?.check?.maxDrift;
       const maxDrift = maxDriftRaw !== undefined ? clampPercentage(maxDriftRaw) : undefined;
+      steps.next();
       const resolveExternalTypes = !options.skipResolve;
       let specResult;
       const doccov = createDocCov({
@@ -857,14 +898,13 @@ function registerCheckCommand(program, dependencies = {}) {
         cwd: options.cwd
       });
       specResult = await doccov.analyzeFileWithDiagnostics(entryFile);
-      if (specResult.fromCache) {
-        log(chalk2.gray("Using cached spec"));
-      }
       if (!specResult) {
         throw new Error("Failed to analyze documentation coverage.");
       }
+      steps.next();
       const spec = enrichSpec(specResult.spec);
       const format = options.format ?? "text";
+      steps.next();
       const specWarnings = specResult.diagnostics.filter((d) => d.severity === "warning");
       const specInfos = specResult.diagnostics.filter((d) => d.severity === "info");
       const shouldFix = options.fix || options.write;
@@ -874,11 +914,10 @@ function registerCheckCommand(program, dependencies = {}) {
           violations.push({ exportName: exp.name, violation: v });
         }
       }
-      const validations = parseExamplesFlag(options.examples);
       let exampleResult;
       const typecheckErrors = [];
       const runtimeDrifts = [];
-      if (validations.length > 0) {
+      if (hasExamples) {
         exampleResult = await validateExamples(spec.exports ?? [], {
           validations,
           packagePath: targetDir,
@@ -909,22 +948,23 @@ function registerCheckCommand(program, dependencies = {}) {
             });
           }
         }
+        steps.next();
       }
       const coverageScore = spec.docs?.coverageScore ?? 0;
       const allDriftExports = [...collectDrift(spec.exports ?? []), ...runtimeDrifts];
-      let driftExports = validations.length > 0 ? allDriftExports : allDriftExports.filter((d) => d.category !== "example");
+      let driftExports = hasExamples ? allDriftExports : allDriftExports.filter((d) => d.category !== "example");
       const fixedDriftKeys = new Set;
       if (shouldFix && driftExports.length > 0) {
         const allDrifts = collectDriftsFromExports(spec.exports ?? []);
         if (allDrifts.length > 0) {
           const { fixable, nonFixable } = categorizeDrifts(allDrifts.map((d) => d.drift));
           if (fixable.length === 0) {
-            log(chalk2.yellow(`Found ${nonFixable.length} drift issue(s), but none are auto-fixable.`));
+            log(chalk3.yellow(`Found ${nonFixable.length} drift issue(s), but none are auto-fixable.`));
           } else {
             log("");
-            log(chalk2.bold(`Found ${fixable.length} fixable issue(s)`));
+            log(chalk3.bold(`Found ${fixable.length} fixable issue(s)`));
             if (nonFixable.length > 0) {
-              log(chalk2.gray(`(${nonFixable.length} non-fixable issue(s) skipped)`));
+              log(chalk3.gray(`(${nonFixable.length} non-fixable issue(s) skipped)`));
             }
             log("");
             const groupedDrifts = groupByExport(allDrifts.filter((d) => fixable.includes(d.drift)));
@@ -932,22 +972,22 @@ function registerCheckCommand(program, dependencies = {}) {
             const editsByFile = new Map;
             for (const [exp, drifts] of groupedDrifts) {
               if (!exp.source?.file) {
-                log(chalk2.gray(`  Skipping ${exp.name}: no source location`));
+                log(chalk3.gray(`  Skipping ${exp.name}: no source location`));
                 continue;
               }
               if (exp.source.file.endsWith(".d.ts")) {
-                log(chalk2.gray(`  Skipping ${exp.name}: declaration file`));
+                log(chalk3.gray(`  Skipping ${exp.name}: declaration file`));
                 continue;
               }
               const filePath = path4.resolve(targetDir, exp.source.file);
               if (!fs2.existsSync(filePath)) {
-                log(chalk2.gray(`  Skipping ${exp.name}: file not found`));
+                log(chalk3.gray(`  Skipping ${exp.name}: file not found`));
                 continue;
               }
               const sourceFile = createSourceFile(filePath);
               const location = findJSDocLocation(sourceFile, exp.name, exp.source.line);
               if (!location) {
-                log(chalk2.gray(`  Skipping ${exp.name}: could not find declaration`));
+                log(chalk3.gray(`  Skipping ${exp.name}: could not find declaration`));
                 continue;
               }
               let existingPatch = {};
@@ -980,26 +1020,26 @@ function registerCheckCommand(program, dependencies = {}) {
             }
             if (edits.length > 0) {
               if (options.dryRun) {
-                log(chalk2.bold("Dry run - changes that would be made:"));
+                log(chalk3.bold("Dry run - changes that would be made:"));
                 log("");
                 for (const [filePath, fileEdits] of editsByFile) {
                   const relativePath = path4.relative(targetDir, filePath);
-                  log(chalk2.cyan(`  ${relativePath}:`));
+                  log(chalk3.cyan(`  ${relativePath}:`));
                   for (const { export: exp, edit, fixes } of fileEdits) {
                     const lineInfo = edit.hasExisting ? `lines ${edit.startLine + 1}-${edit.endLine + 1}` : `line ${edit.startLine + 1}`;
-                    log(`    ${chalk2.bold(exp.name)} [${lineInfo}]`);
+                    log(`    ${chalk3.bold(exp.name)} [${lineInfo}]`);
                     for (const fix of fixes) {
-                      log(chalk2.green(`      + ${fix.description}`));
+                      log(chalk3.green(`      + ${fix.description}`));
                     }
                   }
                   log("");
                 }
-                log(chalk2.gray("Run without --dry-run to apply these changes."));
+                log(chalk3.gray("Run without --dry-run to apply these changes."));
               } else {
                 const applyResult = await applyEdits(edits);
                 if (applyResult.errors.length > 0) {
                   for (const err of applyResult.errors) {
-                    error(chalk2.red(`  ${err.file}: ${err.error}`));
+                    error(chalk3.red(`  ${err.file}: ${err.error}`));
                   }
                 }
               }
@@ -1010,6 +1050,7 @@ function registerCheckCommand(program, dependencies = {}) {
           driftExports = driftExports.filter((d) => !fixedDriftKeys.has(`${d.name}:${d.issue}`));
         }
       }
+      steps.complete("Check complete");
       if (format !== "text") {
         const limit = parseInt(options.limit, 10) || 20;
         const stats = computeStats(spec);
@@ -1069,15 +1110,15 @@ function registerCheckCommand(program, dependencies = {}) {
       if (specWarnings.length > 0 || specInfos.length > 0) {
         log("");
         for (const diag of specWarnings) {
-          log(chalk2.yellow(`⚠ ${diag.message}`));
+          log(chalk3.yellow(`⚠ ${diag.message}`));
           if (diag.suggestion) {
-            log(chalk2.gray(`  ${diag.suggestion}`));
+            log(chalk3.gray(`  ${diag.suggestion}`));
           }
         }
         for (const diag of specInfos) {
-          log(chalk2.cyan(`ℹ ${diag.message}`));
+          log(chalk3.cyan(`ℹ ${diag.message}`));
           if (diag.suggestion) {
-            log(chalk2.gray(`  ${diag.suggestion}`));
+            log(chalk3.gray(`  ${diag.suggestion}`));
           }
         }
       }
@@ -1087,23 +1128,23 @@ function registerCheckCommand(program, dependencies = {}) {
       const errorCount = violations.filter((v) => v.violation.severity === "error").length;
       const warnCount = violations.filter((v) => v.violation.severity === "warn").length;
       log("");
-      log(chalk2.bold(`${pkgName}${pkgVersion ? `@${pkgVersion}` : ""}`));
+      log(chalk3.bold(`${pkgName}${pkgVersion ? `@${pkgVersion}` : ""}`));
       log("");
       log(`  Exports:    ${totalExports}`);
       if (minCoverage !== undefined) {
         if (coverageFailed) {
-          log(chalk2.red(`  Coverage:   ✗ ${coverageScore}%`) + chalk2.dim(` (min ${minCoverage}%)`));
+          log(chalk3.red(`  Coverage:   ✗ ${coverageScore}%`) + chalk3.dim(` (min ${minCoverage}%)`));
         } else {
-          log(chalk2.green(`  Coverage:   ✓ ${coverageScore}%`) + chalk2.dim(` (min ${minCoverage}%)`));
+          log(chalk3.green(`  Coverage:   ✓ ${coverageScore}%`) + chalk3.dim(` (min ${minCoverage}%)`));
         }
       } else {
         log(`  Coverage:   ${coverageScore}%`);
       }
       if (maxDrift !== undefined) {
         if (driftFailed) {
-          log(chalk2.red(`  Drift:      ✗ ${driftScore}%`) + chalk2.dim(` (max ${maxDrift}%)`));
+          log(chalk3.red(`  Drift:      ✗ ${driftScore}%`) + chalk3.dim(` (max ${maxDrift}%)`));
         } else {
-          log(chalk2.green(`  Drift:      ✓ ${driftScore}%`) + chalk2.dim(` (max ${maxDrift}%)`));
+          log(chalk3.green(`  Drift:      ✓ ${driftScore}%`) + chalk3.dim(` (max ${maxDrift}%)`));
         }
       } else {
         log(`  Drift:      ${driftScore}%`);
@@ -1113,7 +1154,7 @@ function registerCheckCommand(program, dependencies = {}) {
         if (typecheckCount > 0) {
           log(`  Examples:   ${typecheckCount} type errors`);
         } else {
-          log(chalk2.green(`  Examples:   ✓ validated`));
+          log(chalk3.green(`  Examples:   ✓ validated`));
         }
       }
       if (errorCount > 0 || warnCount > 0) {
@@ -1135,24 +1176,24 @@ function registerCheckCommand(program, dependencies = {}) {
           thresholdParts.push(`drift ${driftScore}% ≤ ${maxDrift}%`);
         }
         if (thresholdParts.length > 0) {
-          log(chalk2.green(`✓ Check passed (${thresholdParts.join(", ")})`));
+          log(chalk3.green(`✓ Check passed (${thresholdParts.join(", ")})`));
         } else {
-          log(chalk2.green("✓ Check passed"));
-          log(chalk2.dim("  No thresholds configured. Use --min-coverage or --max-drift to enforce."));
+          log(chalk3.green("✓ Check passed"));
+          log(chalk3.dim("  No thresholds configured. Use --min-coverage or --max-drift to enforce."));
         }
         return;
       }
       if (hasQualityErrors) {
-        log(chalk2.red(`✗ ${errorCount} quality errors`));
+        log(chalk3.red(`✗ ${errorCount} quality errors`));
       }
       if (hasTypecheckErrors) {
-        log(chalk2.red(`✗ ${typecheckErrors.length} example type errors`));
+        log(chalk3.red(`✗ ${typecheckErrors.length} example type errors`));
       }
       log("");
-      log(chalk2.dim("Use --format json or --format markdown for detailed reports"));
+      log(chalk3.dim("Use --format json or --format markdown for detailed reports"));
       process.exit(1);
     } catch (commandError) {
-      error(chalk2.red("Error:"), commandError instanceof Error ? commandError.message : commandError);
+      error(chalk3.red("Error:"), commandError instanceof Error ? commandError.message : commandError);
       process.exit(1);
     }
   });
@@ -1189,7 +1230,7 @@ import {
   hashString,
   parseMarkdownFiles
 } from "@doccov/sdk";
-import chalk3 from "chalk";
+import chalk4 from "chalk";
 import { glob } from "glob";
 
 // src/utils/docs-impact-ai.ts
@@ -1335,8 +1376,8 @@ function registerDiffCommand(program, dependencies = {}) {
                 silent: true
               });
             }
-            const cacheNote = fromCache ? chalk3.cyan(" (cached)") : "";
-            log(chalk3.dim(`Report: ${jsonPath}`) + cacheNote);
+            const cacheNote = fromCache ? chalk4.cyan(" (cached)") : "";
+            log(chalk4.dim(`Report: ${jsonPath}`) + cacheNote);
           }
           break;
         case "json": {
@@ -1394,18 +1435,18 @@ function registerDiffCommand(program, dependencies = {}) {
         checks
       });
       if (failures.length > 0) {
-        log(chalk3.red(`
+        log(chalk4.red(`
 ✗ Check failed`));
         for (const f of failures) {
-          log(chalk3.red(`  - ${f}`));
+          log(chalk4.red(`  - ${f}`));
         }
         process.exitCode = 1;
       } else if (options.strict || minCoverage !== undefined || maxDrift !== undefined) {
-        log(chalk3.green(`
+        log(chalk4.green(`
 ✓ All checks passed`));
       }
     } catch (commandError) {
-      error(chalk3.red("Error:"), commandError instanceof Error ? commandError.message : commandError);
+      error(chalk4.red("Error:"), commandError instanceof Error ? commandError.message : commandError);
       process.exitCode = 1;
     }
   });
@@ -1432,7 +1473,7 @@ async function generateDiff(baseSpec, headSpec, options, config, log) {
   if (!docsPatterns || docsPatterns.length === 0) {
     if (config?.docs?.include) {
       docsPatterns = config.docs.include;
-      log(chalk3.gray(`Using docs patterns from config: ${docsPatterns.join(", ")}`));
+      log(chalk4.gray(`Using docs patterns from config: ${docsPatterns.join(", ")}`));
     }
   }
   if (docsPatterns && docsPatterns.length > 0) {
@@ -1455,46 +1496,46 @@ function loadSpec(filePath, readFileSync2) {
 }
 function printSummary(diff, baseName, headName, fromCache, log) {
   log("");
-  const cacheIndicator = fromCache ? chalk3.cyan(" (cached)") : "";
-  log(chalk3.bold(`Comparing: ${baseName} → ${headName}`) + cacheIndicator);
+  const cacheIndicator = fromCache ? chalk4.cyan(" (cached)") : "";
+  log(chalk4.bold(`Comparing: ${baseName} → ${headName}`) + cacheIndicator);
   log("─".repeat(40));
   log("");
-  const coverageColor = diff.coverageDelta > 0 ? chalk3.green : diff.coverageDelta < 0 ? chalk3.red : chalk3.gray;
+  const coverageColor = diff.coverageDelta > 0 ? chalk4.green : diff.coverageDelta < 0 ? chalk4.red : chalk4.gray;
   const coverageSign = diff.coverageDelta > 0 ? "+" : "";
   log(`  Coverage:   ${diff.oldCoverage}% → ${diff.newCoverage}% ${coverageColor(`(${coverageSign}${diff.coverageDelta}%)`)}`);
   const breakingCount = diff.breaking.length;
   const highSeverity = diff.categorizedBreaking?.filter((c) => c.severity === "high").length ?? 0;
   if (breakingCount > 0) {
-    const severityNote = highSeverity > 0 ? chalk3.red(` (${highSeverity} high severity)`) : "";
-    log(`  Breaking:   ${chalk3.red(breakingCount)} changes${severityNote}`);
+    const severityNote = highSeverity > 0 ? chalk4.red(` (${highSeverity} high severity)`) : "";
+    log(`  Breaking:   ${chalk4.red(breakingCount)} changes${severityNote}`);
   } else {
-    log(`  Breaking:   ${chalk3.green("0")} changes`);
+    log(`  Breaking:   ${chalk4.green("0")} changes`);
   }
   const newCount = diff.nonBreaking.length;
   const undocCount = diff.newUndocumented.length;
   if (newCount > 0) {
-    const undocNote = undocCount > 0 ? chalk3.yellow(` (${undocCount} undocumented)`) : "";
-    log(`  New:        ${chalk3.green(newCount)} exports${undocNote}`);
+    const undocNote = undocCount > 0 ? chalk4.yellow(` (${undocCount} undocumented)`) : "";
+    log(`  New:        ${chalk4.green(newCount)} exports${undocNote}`);
   }
   if (diff.driftIntroduced > 0 || diff.driftResolved > 0) {
     const parts = [];
     if (diff.driftIntroduced > 0)
-      parts.push(chalk3.red(`+${diff.driftIntroduced}`));
+      parts.push(chalk4.red(`+${diff.driftIntroduced}`));
     if (diff.driftResolved > 0)
-      parts.push(chalk3.green(`-${diff.driftResolved}`));
+      parts.push(chalk4.green(`-${diff.driftResolved}`));
     log(`  Drift:      ${parts.join(", ")}`);
   }
   log("");
 }
 async function printAISummary(diff, log) {
   if (!isAIDocsAnalysisAvailable()) {
-    log(chalk3.yellow(`
+    log(chalk4.yellow(`
 ⚠ AI analysis unavailable (set OPENAI_API_KEY or ANTHROPIC_API_KEY)`));
     return;
   }
   if (!diff.docsImpact)
     return;
-  log(chalk3.gray(`
+  log(chalk4.gray(`
 Generating AI summary...`));
   const impacts = diff.docsImpact.impactedFiles.flatMap((f) => f.references.map((r) => ({
     file: f.file,
@@ -1505,8 +1546,8 @@ Generating AI summary...`));
   const summary = await generateImpactSummary(impacts);
   if (summary) {
     log("");
-    log(chalk3.bold("AI Summary"));
-    log(chalk3.cyan(`  ${summary}`));
+    log(chalk4.bold("AI Summary"));
+    log(chalk4.cyan(`  ${summary}`));
   }
 }
 function validateDiff(diff, headSpec, options) {
@@ -1587,7 +1628,7 @@ function printGitHubAnnotations(diff, log) {
 
 // src/commands/info.ts
 import { DocCov as DocCov2, enrichSpec as enrichSpec2, NodeFileSystem as NodeFileSystem2, resolveTarget as resolveTarget2 } from "@doccov/sdk";
-import chalk4 from "chalk";
+import chalk5 from "chalk";
 function registerInfoCommand(program) {
   program.command("info [entry]").description("Show brief documentation coverage summary").option("--cwd <dir>", "Working directory", process.cwd()).option("--package <name>", "Target package name (for monorepos)").option("--skip-resolve", "Skip external type resolution from node_modules").action(async (entry, options) => {
     try {
@@ -1609,14 +1650,14 @@ function registerInfoCommand(program) {
       const spec = enrichSpec2(specResult.spec);
       const stats = computeStats(spec);
       console.log("");
-      console.log(chalk4.bold(`${stats.packageName}@${stats.version}`));
+      console.log(chalk5.bold(`${stats.packageName}@${stats.version}`));
       console.log("");
-      console.log(`  Exports:    ${chalk4.bold(stats.totalExports.toString())}`);
-      console.log(`  Coverage:   ${chalk4.bold(`${stats.coverageScore}%`)}`);
-      console.log(`  Drift:      ${chalk4.bold(`${stats.driftScore}%`)}`);
+      console.log(`  Exports:    ${chalk5.bold(stats.totalExports.toString())}`);
+      console.log(`  Coverage:   ${chalk5.bold(`${stats.coverageScore}%`)}`);
+      console.log(`  Drift:      ${chalk5.bold(`${stats.driftScore}%`)}`);
       console.log("");
     } catch (err) {
-      console.error(chalk4.red("Error:"), err instanceof Error ? err.message : err);
+      console.error(chalk5.red("Error:"), err instanceof Error ? err.message : err);
       process.exit(1);
     }
   });
@@ -1625,7 +1666,7 @@ function registerInfoCommand(program) {
 // src/commands/init.ts
 import * as fs4 from "node:fs";
 import * as path6 from "node:path";
-import chalk5 from "chalk";
+import chalk6 from "chalk";
 var defaultDependencies3 = {
   fileExists: fs4.existsSync,
   writeFileSync: fs4.writeFileSync,
@@ -1642,31 +1683,31 @@ function registerInitCommand(program, dependencies = {}) {
     const cwd = path6.resolve(options.cwd);
     const formatOption = String(options.format ?? "auto").toLowerCase();
     if (!isValidFormat(formatOption)) {
-      error(chalk5.red(`Invalid format "${formatOption}". Use auto, mjs, js, or cjs.`));
+      error(chalk6.red(`Invalid format "${formatOption}". Use auto, mjs, js, or cjs.`));
       process.exitCode = 1;
       return;
     }
     const existing = findExistingConfig(cwd, fileExists2);
     if (existing) {
-      error(chalk5.red(`A DocCov config already exists at ${path6.relative(cwd, existing) || "./doccov.config.*"}.`));
+      error(chalk6.red(`A DocCov config already exists at ${path6.relative(cwd, existing) || "./doccov.config.*"}.`));
       process.exitCode = 1;
       return;
     }
     const packageType = detectPackageType(cwd, fileExists2, readFileSync3);
     const targetFormat = resolveFormat(formatOption, packageType);
     if (targetFormat === "js" && packageType !== "module") {
-      log(chalk5.yellow('Package is not marked as "type": "module"; creating doccov.config.js may require enabling ESM.'));
+      log(chalk6.yellow('Package is not marked as "type": "module"; creating doccov.config.js may require enabling ESM.'));
     }
     const fileName = `doccov.config.${targetFormat}`;
     const outputPath = path6.join(cwd, fileName);
     if (fileExists2(outputPath)) {
-      error(chalk5.red(`Cannot create ${fileName}; file already exists.`));
+      error(chalk6.red(`Cannot create ${fileName}; file already exists.`));
       process.exitCode = 1;
       return;
     }
     const template = buildTemplate(targetFormat);
     writeFileSync3(outputPath, template, { encoding: "utf8" });
-    log(chalk5.green(`✓ Created ${path6.relative(process.cwd(), outputPath)}`));
+    log(chalk6.green(`✓ Created ${path6.relative(process.cwd(), outputPath)}`));
   });
 }
 var isValidFormat = (value) => {
@@ -1775,508 +1816,14 @@ var buildTemplate = (format) => {
 `);
 };
 
-// src/commands/scan.ts
-import * as fs6 from "node:fs";
-import * as fsPromises from "node:fs/promises";
-import * as os from "node:os";
-import * as path8 from "node:path";
-import {
-  buildCloneUrl,
-  buildDisplayUrl,
-  DocCov as DocCov3,
-  detectBuildInfo,
-  detectEntryPoint,
-  detectMonorepo,
-  detectPackageManager,
-  extractSpecSummary,
-  findPackageByName,
-  formatPackageList,
-  getInstallCommand,
-  NodeFileSystem as NodeFileSystem3,
-  parseGitHubUrl
-} from "@doccov/sdk";
-import {
-  DRIFT_CATEGORIES as DRIFT_CATEGORIES3,
-  DRIFT_CATEGORY_LABELS as DRIFT_CATEGORY_LABELS2
-} from "@openpkg-ts/spec";
-import chalk6 from "chalk";
-import { simpleGit } from "simple-git";
-
-// src/utils/llm-build-plan.ts
+// src/commands/spec.ts
 import * as fs5 from "node:fs";
 import * as path7 from "node:path";
-import { createAnthropic as createAnthropic3 } from "@ai-sdk/anthropic";
-import { createOpenAI as createOpenAI3 } from "@ai-sdk/openai";
-import { generateObject as generateObject3 } from "ai";
-import { z as z4 } from "zod";
-var BuildPlanSchema = z4.object({
-  installCommand: z4.string().optional().describe("Additional install command if needed"),
-  buildCommands: z4.array(z4.string()).describe('Build steps to run, e.g. ["npm run build:wasm"]'),
-  entryPoint: z4.string().describe("Path to TS/TSX entry file after build"),
-  notes: z4.string().optional().describe("Caveats or warnings")
-});
-var CONTEXT_FILES = [
-  "package.json",
-  "README.md",
-  "README",
-  "tsconfig.json",
-  "Cargo.toml",
-  ".nvmrc",
-  ".node-version",
-  "pnpm-workspace.yaml",
-  "lerna.json",
-  "wasm-pack.json"
-];
-var MAX_FILE_CHARS = 2000;
-function getModel3() {
-  const provider = process.env.DOCCOV_LLM_PROVIDER?.toLowerCase();
-  if (provider === "anthropic" || process.env.ANTHROPIC_API_KEY) {
-    const anthropic = createAnthropic3();
-    return anthropic("claude-sonnet-4-20250514");
-  }
-  const openai = createOpenAI3();
-  return openai("gpt-4o-mini");
-}
-async function gatherContextFiles(repoDir) {
-  const sections = [];
-  for (const fileName of CONTEXT_FILES) {
-    const filePath = path7.join(repoDir, fileName);
-    if (fs5.existsSync(filePath)) {
-      try {
-        let content = fs5.readFileSync(filePath, "utf-8");
-        if (content.length > MAX_FILE_CHARS) {
-          content = `${content.slice(0, MAX_FILE_CHARS)}
-... (truncated)`;
-        }
-        sections.push(`--- ${fileName} ---
-${content}`);
-      } catch {}
-    }
-  }
-  return sections.join(`
-
-`);
-}
-var BUILD_PLAN_PROMPT = (context) => `Analyze this project to determine how to build it for TypeScript API analysis.
-
-The standard entry detection failed. This might be a WASM project, unusual monorepo, or require a build step before the TypeScript entry point exists.
-
-<files>
-${context}
-</files>
-
-Return:
-- buildCommands: Commands to run in order (e.g., ["npm run build:wasm", "npm run build"]). Empty array if no build needed.
-- entryPoint: Path to the TypeScript entry file AFTER build completes (e.g., "src/index.ts" or "pkg/index.d.ts")
-- installCommand: Additional install command if needed beyond what was already run
-- notes: Any caveats (e.g., "requires Rust/wasm-pack installed")
-
-Important:
-- Look for build scripts in package.json that might generate TypeScript bindings
-- Check README for build instructions
-- For WASM projects, look for wasm-pack or similar tooling
-- The entry point should be a .ts, .tsx, or .d.ts file`;
-async function generateBuildPlan(repoDir) {
-  const hasApiKey = process.env.OPENAI_API_KEY || process.env.ANTHROPIC_API_KEY;
-  if (!hasApiKey) {
-    return null;
-  }
-  const context = await gatherContextFiles(repoDir);
-  if (!context.trim()) {
-    return null;
-  }
-  const model = getModel3();
-  const { object } = await generateObject3({
-    model,
-    schema: BuildPlanSchema,
-    prompt: BUILD_PLAN_PROMPT(context)
-  });
-  return object;
-}
-
-// src/commands/scan.ts
-var defaultDependencies4 = {
-  createDocCov: (options) => new DocCov3(options),
-  log: console.log,
-  error: console.error
-};
-function registerScanCommand(program, dependencies = {}) {
-  const { createDocCov, log, error } = {
-    ...defaultDependencies4,
-    ...dependencies
-  };
-  program.command("scan <url>").description("Analyze docs coverage for any public GitHub repository").option("--ref <branch>", "Branch or tag to analyze").option("--package <name>", "Target package in monorepo").option("--output <format>", "Output format: text or json", "text").option("--no-cleanup", "Keep cloned repo (for debugging)").option("--skip-install", "Skip dependency installation (faster, but may limit type resolution)").option("--skip-resolve", "Skip external type resolution from node_modules").option("--save-spec <path>", "Save full OpenPkg spec to file").action(async (url, options) => {
-    let tempDir;
-    try {
-      const parsed = parseGitHubUrl(url, options.ref ?? "main");
-      const cloneUrl = buildCloneUrl(parsed);
-      const displayUrl = buildDisplayUrl(parsed);
-      log("");
-      log(chalk6.bold(`Scanning ${displayUrl}`));
-      log(chalk6.gray(`Branch/tag: ${parsed.ref}`));
-      log("");
-      tempDir = path8.join(os.tmpdir(), `doccov-scan-${Date.now()}-${Math.random().toString(36).slice(2)}`);
-      fs6.mkdirSync(tempDir, { recursive: true });
-      process.stdout.write(chalk6.cyan(`> Cloning ${parsed.owner}/${parsed.repo}...
-`));
-      try {
-        const git = simpleGit({
-          timeout: {
-            block: 30000
-          }
-        });
-        const originalEnv = { ...process.env };
-        process.env.GIT_TERMINAL_PROMPT = "0";
-        process.env.GIT_ASKPASS = "echo";
-        try {
-          await git.clone(cloneUrl, tempDir, [
-            "--depth",
-            "1",
-            "--branch",
-            parsed.ref,
-            "--single-branch"
-          ]);
-        } finally {
-          process.env = originalEnv;
-        }
-        process.stdout.write(chalk6.green(`✓ Cloned ${parsed.owner}/${parsed.repo}
-`));
-      } catch (cloneError) {
-        process.stdout.write(chalk6.red(`✗ Failed to clone repository
-`));
-        const message = cloneError instanceof Error ? cloneError.message : String(cloneError);
-        if (message.includes("Authentication failed") || message.includes("could not read Username") || message.includes("terminal prompts disabled") || message.includes("Invalid username or password") || message.includes("Permission denied")) {
-          throw new Error(`Authentication required: This repository appears to be private. ` + `Public repositories only are currently supported.
-` + `Repository: ${displayUrl}`);
-        }
-        if (message.includes("not found") || message.includes("404")) {
-          throw new Error(`Repository not accessible or does not exist: ${displayUrl}
-` + `Note: Private repositories are not currently supported.`);
-        }
-        if (message.includes("Could not find remote branch")) {
-          throw new Error(`Branch or tag not found: ${parsed.ref}`);
-        }
-        throw new Error(`Clone failed: ${message}`);
-      }
-      const fileSystem = new NodeFileSystem3(tempDir);
-      if (options.skipInstall) {
-        log(chalk6.gray("Skipping dependency installation (--skip-install)"));
-      } else {
-        process.stdout.write(chalk6.cyan(`> Installing dependencies...
-`));
-        const installErrors = [];
-        try {
-          const { execSync } = await import("node:child_process");
-          const pmInfo = await detectPackageManager(fileSystem);
-          const installCmd = getInstallCommand(pmInfo);
-          const cmdString = installCmd.join(" ");
-          let installed = false;
-          if (pmInfo.lockfile) {
-            try {
-              execSync(cmdString, {
-                cwd: tempDir,
-                stdio: "pipe",
-                timeout: 180000
-              });
-              installed = true;
-            } catch (cmdError) {
-              const stderr = cmdError?.stderr?.toString() ?? "";
-              const msg = cmdError instanceof Error ? cmdError.message : String(cmdError);
-              installErrors.push(`[${cmdString}] ${stderr.slice(0, 150) || msg.slice(0, 150)}`);
-            }
-          }
-          if (!installed) {
-            try {
-              execSync("bun install", {
-                cwd: tempDir,
-                stdio: "pipe",
-                timeout: 120000
-              });
-              installed = true;
-            } catch (bunError) {
-              const stderr = bunError?.stderr?.toString() ?? "";
-              const msg = bunError instanceof Error ? bunError.message : String(bunError);
-              installErrors.push(`[bun install] ${stderr.slice(0, 150) || msg.slice(0, 150)}`);
-              try {
-                execSync("npm install --legacy-peer-deps --ignore-scripts", {
-                  cwd: tempDir,
-                  stdio: "pipe",
-                  timeout: 180000
-                });
-                installed = true;
-              } catch (npmError) {
-                const npmStderr = npmError?.stderr?.toString() ?? "";
-                const npmMsg = npmError instanceof Error ? npmError.message : String(npmError);
-                installErrors.push(`[npm install] ${npmStderr.slice(0, 150) || npmMsg.slice(0, 150)}`);
-              }
-            }
-          }
-          if (installed) {
-            process.stdout.write(chalk6.green(`✓ Dependencies installed
-`));
-          } else {
-            process.stdout.write(chalk6.yellow(`⚠ Could not install dependencies (analysis may be limited)
-`));
-            for (const err of installErrors) {
-              log(chalk6.gray(`  ${err}`));
-            }
-          }
-        } catch (outerError) {
-          const msg = outerError instanceof Error ? outerError.message : String(outerError);
-          process.stdout.write(chalk6.yellow(`⚠ Could not install dependencies: ${msg.slice(0, 100)}
-`));
-          for (const err of installErrors) {
-            log(chalk6.gray(`  ${err}`));
-          }
-        }
-      }
-      let targetDir = tempDir;
-      let packageName;
-      const mono = await detectMonorepo(fileSystem);
-      if (mono.isMonorepo) {
-        if (!options.package) {
-          error("");
-          error(chalk6.red(`Monorepo detected with ${mono.packages.length} packages. Specify target with --package:`));
-          error("");
-          error(formatPackageList(mono.packages));
-          error("");
-          throw new Error("Monorepo requires --package flag");
-        }
-        const pkg = findPackageByName(mono.packages, options.package);
-        if (!pkg) {
-          error("");
-          error(chalk6.red(`Package "${options.package}" not found. Available packages:`));
-          error("");
-          error(formatPackageList(mono.packages));
-          error("");
-          throw new Error(`Package not found: ${options.package}`);
-        }
-        targetDir = path8.join(tempDir, pkg.path);
-        packageName = pkg.name;
-        log(chalk6.gray(`Analyzing package: ${packageName}`));
-      }
-      process.stdout.write(chalk6.cyan(`> Detecting entry point...
-`));
-      let entryPath;
-      const targetFs = mono.isMonorepo ? new NodeFileSystem3(targetDir) : fileSystem;
-      let buildFailed = false;
-      const runLlmFallback = async (reason) => {
-        process.stdout.write(chalk6.cyan(`> ${reason}, trying LLM fallback...
-`));
-        const plan = await generateBuildPlan(targetDir);
-        if (!plan) {
-          return null;
-        }
-        if (plan.buildCommands.length > 0) {
-          const { execSync } = await import("node:child_process");
-          for (const cmd of plan.buildCommands) {
-            log(chalk6.gray(`  Running: ${cmd}`));
-            try {
-              execSync(cmd, { cwd: targetDir, stdio: "pipe", timeout: 300000 });
-            } catch (buildError) {
-              buildFailed = true;
-              const msg = buildError instanceof Error ? buildError.message : String(buildError);
-              if (msg.includes("rustc") || msg.includes("cargo") || msg.includes("wasm-pack")) {
-                log(chalk6.yellow(`  ⚠ Build requires Rust toolchain (not available)`));
-              } else if (msg.includes("rimraf") || msg.includes("command not found")) {
-                log(chalk6.yellow(`  ⚠ Build failed: missing dependencies`));
-              } else {
-                log(chalk6.yellow(`  ⚠ Build failed: ${msg.slice(0, 80)}`));
-              }
-            }
-          }
-        }
-        if (plan.notes) {
-          log(chalk6.gray(`  Note: ${plan.notes}`));
-        }
-        return plan.entryPoint;
-      };
-      try {
-        const entry = await detectEntryPoint(targetFs);
-        const buildInfo = await detectBuildInfo(targetFs);
-        const needsBuildStep = entry.isDeclarationOnly && buildInfo.exoticIndicators.wasm;
-        if (needsBuildStep) {
-          process.stdout.write(chalk6.cyan(`> Detected .d.ts entry with WASM indicators...
-`));
-          const llmEntry = await runLlmFallback("WASM project detected");
-          if (llmEntry) {
-            entryPath = path8.join(targetDir, llmEntry);
-            if (buildFailed) {
-              process.stdout.write(chalk6.green(`✓ Entry point: ${llmEntry} (using pre-committed declarations)
-`));
-              log(chalk6.gray("  Coverage may be limited - generated .d.ts files typically lack JSDoc"));
-            } else {
-              process.stdout.write(chalk6.green(`✓ Entry point: ${llmEntry} (from LLM fallback - WASM project)
-`));
-            }
-          } else {
-            entryPath = path8.join(targetDir, entry.path);
-            process.stdout.write(chalk6.green(`✓ Entry point: ${entry.path} (from ${entry.source})
-`));
-            log(chalk6.yellow("  ⚠ WASM project detected but no API key - analysis may be limited"));
-          }
-        } else {
-          entryPath = path8.join(targetDir, entry.path);
-          process.stdout.write(chalk6.green(`✓ Entry point: ${entry.path} (from ${entry.source})
-`));
-        }
-      } catch (entryError) {
-        const llmEntry = await runLlmFallback("Heuristics failed");
-        if (llmEntry) {
-          entryPath = path8.join(targetDir, llmEntry);
-          process.stdout.write(chalk6.green(`✓ Entry point: ${llmEntry} (from LLM fallback)
-`));
-        } else {
-          process.stdout.write(chalk6.red(`✗ Could not detect entry point (set OPENAI_API_KEY for smart fallback)
-`));
-          throw entryError;
-        }
-      }
-      process.stdout.write(chalk6.cyan(`> Analyzing documentation coverage...
-`));
-      let result;
-      try {
-        const resolveExternalTypes = !options.skipResolve;
-        const doccov = createDocCov({ resolveExternalTypes });
-        result = await doccov.analyzeFileWithDiagnostics(entryPath);
-        process.stdout.write(chalk6.green(`✓ Analysis complete
-`));
-      } catch (analysisError) {
-        process.stdout.write(chalk6.red(`✗ Analysis failed
-`));
-        throw analysisError;
-      }
-      const spec = result.spec;
-      if (options.saveSpec) {
-        const specPath = path8.resolve(process.cwd(), options.saveSpec);
-        fs6.writeFileSync(specPath, JSON.stringify(spec, null, 2));
-        log(chalk6.green(`✓ Saved spec to ${options.saveSpec}`));
-      }
-      const summary = extractSpecSummary(spec);
-      const scanResult = {
-        owner: parsed.owner,
-        repo: parsed.repo,
-        ref: parsed.ref,
-        packageName,
-        coverage: summary.coverage,
-        exportCount: summary.exportCount,
-        typeCount: summary.typeCount,
-        driftCount: summary.driftCount,
-        undocumented: summary.undocumented,
-        drift: summary.drift
-      };
-      if (options.output === "json") {
-        log(JSON.stringify(scanResult, null, 2));
-      } else {
-        printTextResult(scanResult, log);
-      }
-    } catch (commandError) {
-      error(chalk6.red("Error:"), commandError instanceof Error ? commandError.message : commandError);
-      process.exitCode = 1;
-    } finally {
-      if (tempDir && options.cleanup !== false) {
-        fsPromises.rm(tempDir, { recursive: true, force: true }).catch(() => {});
-      } else if (tempDir) {
-        log(chalk6.gray(`Repo preserved at: ${tempDir}`));
-      }
-    }
-  });
-}
-function categorizeDriftIssues(drift) {
-  const byCategory = {
-    structural: [],
-    semantic: [],
-    example: []
-  };
-  for (const d of drift) {
-    const category = DRIFT_CATEGORIES3[d.type] ?? "semantic";
-    byCategory[category].push(d);
-  }
-  return {
-    summary: {
-      total: drift.length,
-      byCategory: {
-        structural: byCategory.structural.length,
-        semantic: byCategory.semantic.length,
-        example: byCategory.example.length
-      }
-    },
-    byCategory
-  };
-}
-function formatDriftSummary(summary) {
-  if (summary.total === 0) {
-    return "No drift detected";
-  }
-  const parts = [];
-  if (summary.byCategory.structural > 0) {
-    parts.push(`${summary.byCategory.structural} structural`);
-  }
-  if (summary.byCategory.semantic > 0) {
-    parts.push(`${summary.byCategory.semantic} semantic`);
-  }
-  if (summary.byCategory.example > 0) {
-    parts.push(`${summary.byCategory.example} example`);
-  }
-  return `${summary.total} issues (${parts.join(", ")})`;
-}
-function printTextResult(result, log) {
-  log("");
-  log(chalk6.bold("DocCov Scan Results"));
-  log("─".repeat(40));
-  const repoName = result.packageName ? `${result.owner}/${result.repo} (${result.packageName})` : `${result.owner}/${result.repo}`;
-  log(`Repository: ${chalk6.cyan(repoName)}`);
-  log(`Branch: ${chalk6.gray(result.ref)}`);
-  log("");
-  const coverageColor = result.coverage >= 80 ? chalk6.green : result.coverage >= 50 ? chalk6.yellow : chalk6.red;
-  log(chalk6.bold("Coverage"));
-  log(`  ${coverageColor(`${result.coverage}%`)}`);
-  log("");
-  log(chalk6.bold("Stats"));
-  log(`  ${result.exportCount} exports`);
-  log(`  ${result.typeCount} types`);
-  log(`  ${result.undocumented.length} undocumented`);
-  const categorized = categorizeDriftIssues(result.drift);
-  const driftColor = result.driftCount > 0 ? chalk6.yellow : chalk6.green;
-  log(`  ${driftColor(formatDriftSummary(categorized.summary))}`);
-  if (result.undocumented.length > 0) {
-    log("");
-    log(chalk6.bold("Undocumented Exports"));
-    for (const name of result.undocumented.slice(0, 10)) {
-      log(chalk6.yellow(`  ! ${name}`));
-    }
-    if (result.undocumented.length > 10) {
-      log(chalk6.gray(`  ... and ${result.undocumented.length - 10} more`));
-    }
-  }
-  if (result.drift.length > 0) {
-    log("");
-    log(chalk6.bold("Drift Issues"));
-    const categories = ["structural", "semantic", "example"];
-    for (const category of categories) {
-      const issues = categorized.byCategory[category];
-      if (issues.length === 0)
-        continue;
-      const label = DRIFT_CATEGORY_LABELS2[category];
-      log("");
-      log(chalk6.dim(`  ${label} (${issues.length})`));
-      for (const d of issues.slice(0, 3)) {
-        log(chalk6.red(`    • ${d.export}: ${d.issue}`));
-      }
-      if (issues.length > 3) {
-        log(chalk6.gray(`    ... and ${issues.length - 3} more`));
-      }
-    }
-  }
-  log("");
-}
-
-// src/commands/spec.ts
-import * as fs7 from "node:fs";
-import * as path9 from "node:path";
-import { DocCov as DocCov4, NodeFileSystem as NodeFileSystem4, resolveTarget as resolveTarget3 } from "@doccov/sdk";
+import { DocCov as DocCov3, NodeFileSystem as NodeFileSystem3, resolveTarget as resolveTarget3 } from "@doccov/sdk";
 import { normalize, validateSpec } from "@openpkg-ts/spec";
 import chalk8 from "chalk";
+// package.json
+var version = "0.13.0";
 
 // src/utils/filter-options.ts
 import { mergeFilters, parseListFlag } from "@doccov/sdk";
@@ -2310,9 +1857,9 @@ var mergeFilterOptions = (config, cliOptions) => {
 };
 
 // src/commands/spec.ts
-var defaultDependencies5 = {
-  createDocCov: (options) => new DocCov4(options),
-  writeFileSync: fs7.writeFileSync,
+var defaultDependencies4 = {
+  createDocCov: (options) => new DocCov3(options),
+  writeFileSync: fs5.writeFileSync,
   log: console.log,
   error: console.error
 };
@@ -2321,82 +1868,76 @@ function getArrayLength(value) {
 }
 function formatDiagnosticOutput(prefix, diagnostic, baseDir) {
   const location = diagnostic.location;
-  const relativePath = location?.file ? path9.relative(baseDir, location.file) || location.file : undefined;
+  const relativePath = location?.file ? path7.relative(baseDir, location.file) || location.file : undefined;
   const locationText = location && relativePath ? chalk8.gray(`${relativePath}:${location.line ?? 1}:${location.column ?? 1}`) : null;
   const locationPrefix = locationText ? `${locationText} ` : "";
   return `${prefix} ${locationPrefix}${diagnostic.message}`;
 }
 function registerSpecCommand(program, dependencies = {}) {
-  const { createDocCov, writeFileSync: writeFileSync5, log, error } = {
-    ...defaultDependencies5,
+  const { createDocCov, writeFileSync: writeFileSync4, log, error } = {
+    ...defaultDependencies4,
     ...dependencies
   };
-  program.command("spec [entry]").description("Generate OpenPkg specification (JSON)").option("--cwd <dir>", "Working directory", process.cwd()).option("-p, --package <name>", "Target package name (for monorepos)").option("-o, --output <file>", "Output file path", "openpkg.json").option("--include <patterns>", "Include exports matching pattern (comma-separated)").option("--exclude <patterns>", "Exclude exports matching pattern (comma-separated)").option("--skip-resolve", "Skip external type resolution from node_modules").option("--max-type-depth <n>", "Maximum depth for type conversion", "20").option("--no-cache", "Bypass spec cache and force regeneration").option("--show-diagnostics", "Show TypeScript compiler diagnostics").action(async (entry, options) => {
+  program.command("spec [entry]").description("Generate OpenPkg specification (JSON)").option("--cwd <dir>", "Working directory", process.cwd()).option("-p, --package <name>", "Target package name (for monorepos)").option("-o, --output <file>", "Output file path", "openpkg.json").option("--include <patterns>", "Include exports matching pattern (comma-separated)").option("--exclude <patterns>", "Exclude exports matching pattern (comma-separated)").option("--skip-resolve", "Skip external type resolution from node_modules").option("--max-type-depth <n>", "Maximum depth for type conversion", "20").option("--no-cache", "Bypass spec cache and force regeneration").option("--show-diagnostics", "Show TypeScript compiler diagnostics").option("--verbose", "Show detailed generation metadata").action(async (entry, options) => {
     try {
-      const fileSystem = new NodeFileSystem4(options.cwd);
+      const steps = new StepProgress([
+        { label: "Resolved target", activeLabel: "Resolving target" },
+        { label: "Loaded config", activeLabel: "Loading config" },
+        { label: "Generated spec", activeLabel: "Generating spec" },
+        { label: "Validated schema", activeLabel: "Validating schema" },
+        { label: "Wrote output", activeLabel: "Writing output" }
+      ]);
+      steps.start();
+      const fileSystem = new NodeFileSystem3(options.cwd);
       const resolved = await resolveTarget3(fileSystem, {
         cwd: options.cwd,
         package: options.package,
         entry
       });
       const { targetDir, entryFile, packageInfo, entryPointInfo } = resolved;
-      if (packageInfo) {
-        log(chalk8.gray(`Found package at ${packageInfo.path}`));
-      }
-      if (!entry) {
-        log(chalk8.gray(`Auto-detected entry point: ${entryPointInfo.path} (from ${entryPointInfo.source})`));
-      }
+      steps.next();
       let config = null;
       try {
         config = await loadDocCovConfig(targetDir);
-        if (config?.filePath) {
-          log(chalk8.gray(`Loaded configuration from ${path9.relative(targetDir, config.filePath)}`));
-        }
       } catch (configError) {
         error(chalk8.red("Failed to load DocCov config:"), configError instanceof Error ? configError.message : configError);
         process.exit(1);
       }
+      steps.next();
       const cliFilters = {
         include: parseListFlag(options.include),
         exclude: parseListFlag(options.exclude)
       };
       const resolvedFilters = mergeFilterOptions(config, cliFilters);
-      for (const message of resolvedFilters.messages) {
-        log(chalk8.gray(`${message}`));
-      }
       const resolveExternalTypes = !options.skipResolve;
-      process.stdout.write(chalk8.cyan(`> Generating OpenPkg spec...
-`));
-      let result;
-      try {
-        const doccov = createDocCov({
-          resolveExternalTypes,
-          maxDepth: options.maxTypeDepth ? parseInt(options.maxTypeDepth, 10) : undefined,
-          useCache: options.cache !== false,
-          cwd: options.cwd
-        });
-        const analyzeOptions = resolvedFilters.include || resolvedFilters.exclude ? {
-          filters: {
-            include: resolvedFilters.include,
-            exclude: resolvedFilters.exclude
-          }
-        } : {};
-        result = await doccov.analyzeFileWithDiagnostics(entryFile, analyzeOptions);
-        if (result.fromCache) {
-          process.stdout.write(chalk8.gray(`> Using cached spec
-`));
-        } else {
-          process.stdout.write(chalk8.green(`> Generated OpenPkg spec
-`));
-        }
-      } catch (generationError) {
-        process.stdout.write(chalk8.red(`> Failed to generate spec
-`));
-        throw generationError;
-      }
+      const doccov = createDocCov({
+        resolveExternalTypes,
+        maxDepth: options.maxTypeDepth ? parseInt(options.maxTypeDepth, 10) : undefined,
+        useCache: options.cache !== false,
+        cwd: options.cwd
+      });
+      const generationInput = {
+        entryPoint: path7.relative(targetDir, entryFile),
+        entryPointSource: entryPointInfo.source,
+        isDeclarationOnly: entryPointInfo.isDeclarationOnly ?? false,
+        generatorName: "@doccov/cli",
+        generatorVersion: version,
+        packageManager: packageInfo?.packageManager,
+        isMonorepo: resolved.isMonorepo,
+        targetPackage: packageInfo?.name
+      };
+      const analyzeOptions = resolvedFilters.include || resolvedFilters.exclude ? {
+        filters: {
+          include: resolvedFilters.include,
+          exclude: resolvedFilters.exclude
+        },
+        generationInput
+      } : { generationInput };
+      const result = await doccov.analyzeFileWithDiagnostics(entryFile, analyzeOptions);
       if (!result) {
         throw new Error("Failed to produce an OpenPkg spec.");
       }
+      steps.next();
       const normalized = normalize(result.spec);
       const validation = validateSpec(normalized);
       if (!validation.ok) {
@@ -2406,11 +1947,49 @@ function registerSpecCommand(program, dependencies = {}) {
         }
         process.exit(1);
       }
-      const outputPath = path9.resolve(process.cwd(), options.output);
-      writeFileSync5(outputPath, JSON.stringify(normalized, null, 2));
-      log(chalk8.green(`> Wrote ${options.output}`));
+      steps.next();
+      const outputPath = path7.resolve(process.cwd(), options.output);
+      writeFileSync4(outputPath, JSON.stringify(normalized, null, 2));
+      steps.complete(`Generated ${options.output}`);
       log(chalk8.gray(`  ${getArrayLength(normalized.exports)} exports`));
       log(chalk8.gray(`  ${getArrayLength(normalized.types)} types`));
+      if (options.verbose && normalized.generation) {
+        const gen = normalized.generation;
+        log("");
+        log(chalk8.bold("Generation Info"));
+        log(chalk8.gray(`  Timestamp:        ${gen.timestamp}`));
+        log(chalk8.gray(`  Generator:        ${gen.generator.name}@${gen.generator.version}`));
+        log(chalk8.gray(`  Entry point:      ${gen.analysis.entryPoint}`));
+        log(chalk8.gray(`  Detected via:     ${gen.analysis.entryPointSource}`));
+        log(chalk8.gray(`  Declaration only: ${gen.analysis.isDeclarationOnly ? "yes" : "no"}`));
+        log(chalk8.gray(`  External types:   ${gen.analysis.resolvedExternalTypes ? "resolved" : "skipped"}`));
+        if (gen.analysis.maxTypeDepth) {
+          log(chalk8.gray(`  Max type depth:   ${gen.analysis.maxTypeDepth}`));
+        }
+        log("");
+        log(chalk8.bold("Environment"));
+        log(chalk8.gray(`  node_modules:     ${gen.environment.hasNodeModules ? "found" : "not found"}`));
+        if (gen.environment.packageManager) {
+          log(chalk8.gray(`  Package manager:  ${gen.environment.packageManager}`));
+        }
+        if (gen.environment.isMonorepo) {
+          log(chalk8.gray(`  Monorepo:         yes`));
+        }
+        if (gen.environment.targetPackage) {
+          log(chalk8.gray(`  Target package:   ${gen.environment.targetPackage}`));
+        }
+        if (gen.issues.length > 0) {
+          log("");
+          log(chalk8.bold("Issues"));
+          for (const issue of gen.issues) {
+            const prefix = issue.severity === "error" ? chalk8.red(">") : issue.severity === "warning" ? chalk8.yellow(">") : chalk8.cyan(">");
+            log(`${prefix} [${issue.code}] ${issue.message}`);
+            if (issue.suggestion) {
+              log(chalk8.gray(`    ${issue.suggestion}`));
+            }
+          }
+        }
+      }
       if (options.showDiagnostics && result.diagnostics.length > 0) {
         log("");
         log(chalk8.bold("Diagnostics"));
@@ -2428,8 +2007,8 @@ function registerSpecCommand(program, dependencies = {}) {
 
 // src/cli.ts
 var __filename2 = fileURLToPath(import.meta.url);
-var __dirname2 = path10.dirname(__filename2);
-var packageJson = JSON.parse(readFileSync4(path10.join(__dirname2, "../package.json"), "utf-8"));
+var __dirname2 = path8.dirname(__filename2);
+var packageJson = JSON.parse(readFileSync3(path8.join(__dirname2, "../package.json"), "utf-8"));
 var program = new Command;
 program.name("doccov").description("DocCov - Documentation coverage and drift detection for TypeScript").version(packageJson.version);
 registerCheckCommand(program);
@@ -2437,7 +2016,6 @@ registerInfoCommand(program);
 registerSpecCommand(program);
 registerDiffCommand(program);
 registerInitCommand(program);
-registerScanCommand(program);
 program.command("*", { hidden: true }).action(() => {
   program.outputHelp();
 });

package/dist/config/index.js

@@ -1,22 +1,3 @@
-import { createRequire } from "node:module";
-var __create = Object.create;
-var __getProtoOf = Object.getPrototypeOf;
-var __defProp = Object.defineProperty;
-var __getOwnPropNames = Object.getOwnPropertyNames;
-var __hasOwnProp = Object.prototype.hasOwnProperty;
-var __toESM = (mod, isNodeMode, target) => {
-  target = mod != null ? __create(__getProtoOf(mod)) : {};
-  const to = isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target;
-  for (let key of __getOwnPropNames(mod))
-    if (!__hasOwnProp.call(to, key))
-      __defProp(to, key, {
-        get: () => mod[key],
-        enumerable: true
-      });
-  return to;
-};
-var __require = /* @__PURE__ */ createRequire(import.meta.url);
-
 // src/config/doccov-config.ts
 import { access } from "node:fs/promises";
 import path from "node:path";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@doccov/cli",
-  "version": "0.12.0",
+  "version": "0.14.0",
   "description": "DocCov CLI - Documentation coverage and drift detection for TypeScript",
   "keywords": [
     "typescript",
@@ -48,14 +48,13 @@
   "dependencies": {
     "@ai-sdk/anthropic": "^1.0.0",
     "@ai-sdk/openai": "^1.0.0",
-    "@doccov/sdk": "^0.12.0",
+    "@doccov/sdk": "^0.13.0",
     "@inquirer/prompts": "^7.8.0",
-    "@openpkg-ts/spec": "^0.8.0",
+    "@openpkg-ts/spec": "^0.9.0",
     "ai": "^4.0.0",
     "chalk": "^5.4.1",
     "commander": "^14.0.0",
     "glob": "^11.0.0",
-    "ora": "^9.0.0",
     "simple-git": "^3.27.0",
     "zod": "^3.25.0"
   },