@doccov/cli 0.25.9 → 0.26.0

package/dist/cli.js

@@ -25,10 +25,17 @@ var exampleModesSchema = z.union([
   z.array(exampleModeSchema),
   z.string()
 ]);
+var apiSurfaceConfigSchema = z.object({
+  minCompleteness: z.number().min(0).max(100).optional(),
+  warnBelow: z.number().min(0).max(100).optional(),
+  ignore: z.array(z.string()).optional()
+});
 var checkConfigSchema = z.object({
   examples: exampleModesSchema.optional(),
   minCoverage: z.number().min(0).max(100).optional(),
-  maxDrift: z.number().min(0).max(100).optional()
+  maxDrift: z.number().min(0).max(100).optional(),
+  minApiSurface: z.number().min(0).max(100).optional(),
+  apiSurface: apiSurfaceConfigSchema.optional()
 });
 var docCovConfigSchema = z.object({
   include: stringList.optional(),
@@ -64,7 +71,9 @@ var normalizeConfig = (input) => {
     check = {
       examples: input.check.examples,
       minCoverage: input.check.minCoverage,
-      maxDrift: input.check.maxDrift
+      maxDrift: input.check.maxDrift,
+      minApiSurface: input.check.minApiSurface,
+      apiSurface: input.check.apiSurface
     };
   }
   return {
@@ -151,9 +160,20 @@ import * as path10 from "node:path";
 import { fileURLToPath } from "node:url";
 import { Command } from "commander";
 
+// src/commands/check/index.ts
+import {
+  buildDocCovSpec,
+  DocCov,
+  NodeFileSystem,
+  parseExamplesFlag,
+  resolveTarget
+} from "@doccov/sdk";
+import chalk7 from "chalk";
+
 // ../cli-utils/dist/index.js
 import chalk from "chalk";
 import chalk2 from "chalk";
+import { Worker } from "node:worker_threads";
 var colors = {
   success: chalk.green,
   error: chalk.red,
@@ -312,8 +332,8 @@ class MultiProgress {
     hideCursor();
     this.setupSignalHandler();
     this.timer = setInterval(() => {
-      this.spinnerIndex = (this.spinnerIndex + 1) % this.spinnerFrames.length;
       if (this.bars.size > 0 && [...this.bars.values()].some((b) => b.status === "active")) {
+        this.spinnerIndex = (this.spinnerIndex + 1) % this.spinnerFrames.length;
         this.render();
       }
     }, this.options.spinnerInterval);
@@ -686,11 +706,13 @@ class Spinner {
   symbols = getSymbols(supportsUnicode());
   lastRenderedLines = 0;
   sigintHandler = null;
+  animate;
   constructor(options = {}) {
     this.label = options.label ?? "";
     this.detail = options.detail;
     this.interval = options.interval ?? 80;
     this.colorFn = spinnerColors[options.color ?? "cyan"];
+    this.animate = options.animate ?? true;
     const style = options.style ?? "circle";
     this.frames = supportsUnicode() ? FRAME_SETS[style] : ASCII_FRAME_SET;
   }
@@ -702,7 +724,7 @@ class Spinner {
     this.state = "spinning";
     this.frameIndex = 0;
     this.lastRenderedLines = 0;
-    if (!isInteractive()) {
+    if (!isInteractive() || !this.animate) {
       console.log(`${this.symbols.bullet} ${this.label}`);
       return this;
     }
@@ -760,14 +782,12 @@ class Spinner {
       this.timer = null;
     }
     this.state = state;
-    if (!isInteractive()) {
-      const symbol = state === "success" ? this.symbols.success : this.symbols.error;
-      const colorFn = state === "success" ? colors.success : colors.error;
+    const symbol = state === "success" ? this.symbols.success : this.symbols.error;
+    const colorFn = state === "success" ? colors.success : colors.error;
+    if (!isInteractive() || !this.animate) {
       console.log(`${colorFn(symbol)} ${this.label}`);
     } else {
       this.clearOutput();
-      const symbol = state === "success" ? this.symbols.success : this.symbols.error;
-      const colorFn = state === "success" ? colors.success : colors.error;
       process.stdout.write(`${colorFn(symbol)} ${this.label}
 `);
     }
@@ -843,8 +863,8 @@ class StepProgress {
     this.setupSignalHandler();
     this.render();
     this.timer = setInterval(() => {
-      this.spinnerIndex = (this.spinnerIndex + 1) % this.spinnerFrames.length;
       if (this.steps.some((s) => s.status === "active")) {
+        this.spinnerIndex = (this.spinnerIndex + 1) % this.spinnerFrames.length;
         this.render();
       }
     }, this.spinnerInterval);
@@ -1140,16 +1160,6 @@ function summary(options) {
   return new Summary(options);
 }
 
-// src/commands/check/index.ts
-import {
-  buildDocCovSpec,
-  DocCov,
-  NodeFileSystem,
-  parseExamplesFlag,
-  resolveTarget
-} from "@doccov/sdk";
-import chalk7 from "chalk";
-
 // src/utils/filter-options.ts
 import { mergeFilters, parseListFlag } from "@doccov/sdk";
 import chalk3 from "chalk";
@@ -1217,12 +1227,15 @@ import * as fs2 from "node:fs";
 import * as path3 from "node:path";
 import {
   applyEdits,
+  applyForgottenExportFixes,
   categorizeDrifts,
   createSourceFile,
   findJSDocLocation,
   generateFixesForExport,
+  generateForgottenExportFixes,
   mergeFixes,
   parseJSDocToPatch,
+  previewForgottenExportFixes,
   serializeJSDoc
 } from "@doccov/sdk";
 import chalk5 from "chalk";
@@ -1295,12 +1308,12 @@ async function handleFixes(openpkg, doccov, options, deps) {
   const fixedDriftKeys = new Set;
   const allDrifts = collectDriftsFromExports(openpkg.exports ?? [], doccov);
   if (allDrifts.length === 0) {
-    return { fixedDriftKeys, editsApplied: 0, filesModified: 0 };
+    return { fixedDriftKeys, editsApplied: 0, filesModified: 0, forgottenExportsFixed: 0 };
   }
   const { fixable, nonFixable } = categorizeDrifts(allDrifts.map((d) => d.drift));
   if (fixable.length === 0) {
     log(chalk5.yellow(`Found ${nonFixable.length} drift issue(s), but none are auto-fixable.`));
-    return { fixedDriftKeys, editsApplied: 0, filesModified: 0 };
+    return { fixedDriftKeys, editsApplied: 0, filesModified: 0, forgottenExportsFixed: 0 };
   }
   log("");
   log(chalk5.bold(`Found ${fixable.length} fixable issue(s)`));
@@ -1329,11 +1342,11 @@ async function handleFixes(openpkg, doccov, options, deps) {
     editsByFile.set(edit.filePath, fileEdits);
   }
   if (edits.length === 0) {
-    return { fixedDriftKeys, editsApplied: 0, filesModified: 0 };
+    return { fixedDriftKeys, editsApplied: 0, filesModified: 0, forgottenExportsFixed: 0 };
   }
   if (isPreview) {
     displayPreview(editsByFile, targetDir, log);
-    return { fixedDriftKeys, editsApplied: 0, filesModified: 0 };
+    return { fixedDriftKeys, editsApplied: 0, filesModified: 0, forgottenExportsFixed: 0 };
   }
   const applyResult = await applyEdits(edits);
   if (applyResult.errors.length > 0) {
@@ -1352,9 +1365,71 @@ async function handleFixes(openpkg, doccov, options, deps) {
   return {
     fixedDriftKeys,
     editsApplied: totalFixes,
-    filesModified: applyResult.filesModified
+    filesModified: applyResult.filesModified,
+    forgottenExportsFixed: 0
   };
 }
+async function handleForgottenExportFixes(doccov, options, deps) {
+  const { isPreview, targetDir, entryFile } = options;
+  const { log, error } = deps;
+  if (!doccov.apiSurface || doccov.apiSurface.forgotten.length === 0) {
+    return { fixesApplied: 0, filesModified: 0 };
+  }
+  const fixable = doccov.apiSurface.forgotten.filter((f) => !f.isExternal && f.fix);
+  if (fixable.length === 0) {
+    return { fixesApplied: 0, filesModified: 0 };
+  }
+  const fixes = generateForgottenExportFixes(doccov.apiSurface, {
+    baseDir: targetDir,
+    entryFile: entryFile ?? "src/index.ts"
+  });
+  if (fixes.length === 0) {
+    return { fixesApplied: 0, filesModified: 0 };
+  }
+  log("");
+  log(chalk5.bold(`Found ${fixes.length} forgotten export(s) to fix`));
+  if (isPreview) {
+    displayForgottenExportPreview(fixes, targetDir, log);
+    return { fixesApplied: 0, filesModified: 0 };
+  }
+  const result = await applyForgottenExportFixes(fixes);
+  if (result.errors.length > 0) {
+    for (const err of result.errors) {
+      error(chalk5.red(`  ${err.file}: ${err.error}`));
+    }
+  }
+  if (result.fixesApplied > 0) {
+    log("");
+    log(chalk5.green(`✓ Added ${result.fixesApplied} export(s) to ${result.filesModified} file(s)`));
+    const grouped = new Map;
+    for (const fix of fixes) {
+      const relativePath = path3.relative(targetDir, fix.targetFile);
+      const types = grouped.get(relativePath) ?? [];
+      types.push(fix.typeName);
+      grouped.set(relativePath, types);
+    }
+    for (const [file, types] of grouped) {
+      log(chalk5.dim(`  ${file}: ${types.join(", ")}`));
+    }
+  }
+  return { fixesApplied: result.fixesApplied, filesModified: result.filesModified };
+}
+function displayForgottenExportPreview(fixes, targetDir, log) {
+  log(chalk5.bold("Preview - forgotten exports that would be added:"));
+  log("");
+  const previews = previewForgottenExportFixes(fixes);
+  for (const [filePath, preview] of previews) {
+    const relativePath = path3.relative(targetDir, filePath);
+    log(chalk5.cyan(`${relativePath}:${preview.insertLine + 1}`));
+    log("");
+    for (const stmt of preview.statements) {
+      log(chalk5.green(`  + ${stmt}`));
+    }
+    log("");
+  }
+  log(chalk5.yellow(`${fixes.length} export(s) would be added.`));
+  log(chalk5.gray("Run with --fix to apply these changes."));
+}
 function generateEditForExport(exp, drifts, targetDir, log) {
   if (!exp.source?.file) {
     log(chalk5.gray(`  Skipping ${exp.name}: no source location`));
@@ -1835,6 +1910,24 @@ function renderMarkdown(stats, options = {}) {
       lines.push("");
     }
   }
+  if (stats.apiSurface && stats.apiSurface.forgotten.length > 0) {
+    lines.push("");
+    lines.push("## API Surface");
+    lines.push("");
+    lines.push(`**${stats.apiSurface.completeness}% complete** (${stats.apiSurface.forgotten.length} forgotten exports)`);
+    lines.push("");
+    lines.push("| Type | Defined In | Referenced By |");
+    lines.push("|------|------------|---------------|");
+    for (const f of stats.apiSurface.forgotten.slice(0, limit)) {
+      const definedIn = f.definedIn ? `${f.definedIn.file}${f.definedIn.line ? `:${f.definedIn.line}` : ""}` : "-";
+      const refs = f.referencedBy.slice(0, 2).map((r) => `${r.exportName} (${r.location})`).join(", ");
+      const moreRefs = f.referencedBy.length > 2 ? ` +${f.referencedBy.length - 2}` : "";
+      lines.push(`| \`${f.name}\` | ${definedIn} | ${refs}${moreRefs} |`);
+    }
+    if (stats.apiSurface.forgotten.length > limit) {
+      lines.push(`| ... | | ${stats.apiSurface.forgotten.length - limit} more |`);
+    }
+  }
   lines.push("");
   lines.push("---");
   lines.push("*Generated by [DocCov](https://doccov.com)*");
@@ -2252,7 +2345,8 @@ function computeStats(openpkg, doccov) {
     exports: sortedExports,
     driftIssues,
     driftByCategory,
-    driftSummary
+    driftSummary,
+    apiSurface: doccov.apiSurface
   };
 }
 // src/reports/writer.ts
@@ -2297,23 +2391,32 @@ function writeReports(options) {
 function displayTextOutput(options, deps) {
   const {
     openpkg,
+    doccov,
     coverageScore,
     minCoverage,
     maxDrift,
+    minApiSurface,
+    warnBelowApiSurface,
     driftExports,
     typecheckErrors,
     staleRefs,
     exampleResult,
     specWarnings,
-    specInfos
+    specInfos,
+    verbose
   } = options;
   const { log } = deps;
   const sym = getSymbols(supportsUnicode());
   const totalExportsForDrift = openpkg.exports?.length ?? 0;
   const exportsWithDrift = new Set(driftExports.map((d) => d.name)).size;
   const driftScore = totalExportsForDrift === 0 ? 0 : Math.round(exportsWithDrift / totalExportsForDrift * 100);
+  const apiSurface = doccov.apiSurface;
+  const apiSurfaceScore = apiSurface?.completeness ?? 100;
+  const forgottenCount = apiSurface?.forgotten?.length ?? 0;
   const coverageFailed = coverageScore < minCoverage;
   const driftFailed = maxDrift !== undefined && driftScore > maxDrift;
+  const apiSurfaceFailed = minApiSurface !== undefined && apiSurfaceScore < minApiSurface;
+  const apiSurfaceWarn = warnBelowApiSurface !== undefined && apiSurfaceScore < warnBelowApiSurface && !apiSurfaceFailed;
   const hasTypecheckErrors = typecheckErrors.length > 0;
   if (specWarnings.length > 0 || specInfos.length > 0) {
     log("");
@@ -2344,6 +2447,18 @@ function displayTextOutput(options, deps) {
   } else {
     summaryBuilder.addKeyValue("Drift", `${driftScore}%`);
   }
+  if (forgottenCount > 0 || minApiSurface !== undefined || warnBelowApiSurface !== undefined) {
+    const surfaceLabel = forgottenCount > 0 ? `${apiSurfaceScore}% (${forgottenCount} forgotten)` : `${apiSurfaceScore}%`;
+    if (apiSurfaceFailed) {
+      summaryBuilder.addKeyValue("API Surface", surfaceLabel, "fail");
+    } else if (apiSurfaceWarn) {
+      summaryBuilder.addKeyValue("API Surface", surfaceLabel, "warn");
+    } else if (minApiSurface !== undefined) {
+      summaryBuilder.addKeyValue("API Surface", surfaceLabel, "pass");
+    } else {
+      summaryBuilder.addKeyValue("API Surface", surfaceLabel, forgottenCount > 0 ? "warn" : undefined);
+    }
+  }
   if (exampleResult) {
     const typecheckCount = exampleResult.typecheck?.errors.length ?? 0;
     if (typecheckCount > 0) {
@@ -2377,15 +2492,48 @@ function displayTextOutput(options, deps) {
       log(colors.muted(`  ... and ${staleRefs.length - 5} more`));
     }
   }
+  if (verbose && forgottenCount > 0 && apiSurface?.forgotten) {
+    log("");
+    log(colors.bold(`Forgotten Exports (${forgottenCount})`));
+    log("");
+    for (const forgotten of apiSurface.forgotten.slice(0, 10)) {
+      log(`  ${colors.warning(forgotten.name)}`);
+      if (forgotten.definedIn) {
+        log(colors.muted(`    Defined in: ${forgotten.definedIn.file}${forgotten.definedIn.line ? `:${forgotten.definedIn.line}` : ""}`));
+      }
+      if (forgotten.referencedBy.length > 0) {
+        log(colors.muted("    Referenced by:"));
+        for (const ref of forgotten.referencedBy.slice(0, 3)) {
+          log(colors.muted(`      - ${ref.exportName} (${ref.location})`));
+        }
+        if (forgotten.referencedBy.length > 3) {
+          log(colors.muted(`      ... and ${forgotten.referencedBy.length - 3} more`));
+        }
+      }
+      if (forgotten.fix) {
+        log(colors.info(`    Fix: Add to ${forgotten.fix.targetFile}:`));
+        log(colors.info(`      ${forgotten.fix.exportStatement}`));
+      }
+    }
+    if (apiSurface.forgotten.length > 10) {
+      log(colors.muted(`  ... and ${apiSurface.forgotten.length - 10} more`));
+    }
+  }
   log("");
-  const failed = coverageFailed || driftFailed || hasTypecheckErrors || hasStaleRefs;
+  const failed = coverageFailed || driftFailed || apiSurfaceFailed || hasTypecheckErrors || hasStaleRefs;
   if (!failed) {
     const thresholdParts = [];
     thresholdParts.push(`coverage ${coverageScore}% ≥ ${minCoverage}%`);
     if (maxDrift !== undefined) {
       thresholdParts.push(`drift ${driftScore}% ≤ ${maxDrift}%`);
     }
+    if (minApiSurface !== undefined) {
+      thresholdParts.push(`api-surface ${apiSurfaceScore}% ≥ ${minApiSurface}%`);
+    }
     log(colors.success(`${sym.success} Check passed (${thresholdParts.join(", ")})`));
+    if (apiSurfaceWarn) {
+      log(colors.warning(`${sym.warning} API Surface ${apiSurfaceScore}% below warning threshold ${warnBelowApiSurface}%`));
+    }
     return true;
   }
   if (coverageFailed) {
@@ -2394,6 +2542,9 @@ function displayTextOutput(options, deps) {
   if (driftFailed) {
     log(colors.error(`${sym.error} Drift ${driftScore}% exceeds maximum ${maxDrift}%`));
   }
+  if (apiSurfaceFailed) {
+    log(colors.error(`${sym.error} API Surface ${apiSurfaceScore}% below minimum ${minApiSurface}%`));
+  }
   if (hasTypecheckErrors) {
     log(colors.error(`${sym.error} ${typecheckErrors.length} example type errors`));
   }
@@ -2412,6 +2563,7 @@ function handleNonTextOutput(options, deps) {
     coverageScore,
     minCoverage,
     maxDrift,
+    minApiSurface,
     driftExports,
     typecheckErrors,
     limit,
@@ -2459,8 +2611,56 @@ function handleNonTextOutput(options, deps) {
   const driftScore = totalExportsForDrift === 0 ? 0 : Math.round(exportsWithDrift / totalExportsForDrift * 100);
   const coverageFailed = coverageScore < minCoverage;
   const driftFailed = maxDrift !== undefined && driftScore > maxDrift;
+  const apiSurfaceScore = doccov.apiSurface?.completeness ?? 100;
+  const apiSurfaceFailed = minApiSurface !== undefined && apiSurfaceScore < minApiSurface;
   const hasTypecheckErrors = typecheckErrors.length > 0;
-  return !(coverageFailed || driftFailed || hasTypecheckErrors);
+  return !(coverageFailed || driftFailed || apiSurfaceFailed || hasTypecheckErrors);
+}
+function displayApiSurfaceOutput(doccov, deps) {
+  const { log } = deps;
+  const apiSurface = doccov.apiSurface;
+  log("");
+  log(colors.bold("API Surface Analysis"));
+  log("");
+  if (!apiSurface) {
+    log(colors.muted("No API surface data available"));
+    return;
+  }
+  const sym = getSymbols(supportsUnicode());
+  const summaryBuilder = summary({ keyWidth: 12 });
+  summaryBuilder.addKeyValue("Referenced", apiSurface.totalReferenced);
+  summaryBuilder.addKeyValue("Exported", apiSurface.exported);
+  summaryBuilder.addKeyValue("Forgotten", apiSurface.forgotten.length);
+  summaryBuilder.addKeyValue("Completeness", `${apiSurface.completeness}%`, apiSurface.forgotten.length > 0 ? "warn" : "pass");
+  summaryBuilder.print();
+  if (apiSurface.forgotten.length > 0) {
+    log("");
+    log(colors.bold(`Forgotten Exports (${apiSurface.forgotten.length})`));
+    log("");
+    for (const forgotten of apiSurface.forgotten) {
+      log(`  ${colors.warning(forgotten.name)}`);
+      if (forgotten.definedIn) {
+        log(colors.muted(`    Defined in: ${forgotten.definedIn.file}${forgotten.definedIn.line ? `:${forgotten.definedIn.line}` : ""}`));
+      }
+      if (forgotten.referencedBy.length > 0) {
+        log(colors.muted("    Referenced by:"));
+        for (const ref of forgotten.referencedBy.slice(0, 5)) {
+          log(colors.muted(`      - ${ref.exportName} (${ref.location})`));
+        }
+        if (forgotten.referencedBy.length > 5) {
+          log(colors.muted(`      ... and ${forgotten.referencedBy.length - 5} more`));
+        }
+      }
+      if (forgotten.fix) {
+        log(colors.info(`    Fix: Add to ${forgotten.fix.targetFile}:`));
+        log(colors.info(`      ${forgotten.fix.exportStatement}`));
+      }
+      log("");
+    }
+  } else {
+    log("");
+    log(colors.success(`${sym.success} All referenced types are exported`));
+  }
 }
 
 // src/commands/check/validation.ts
@@ -2550,7 +2750,7 @@ function registerCheckCommand(program, dependencies = {}) {
     if (Number.isNaN(n) || n < 1)
       throw new Error("--max-type-depth must be a positive integer");
     return n;
-  }).option("--no-cache", "Bypass spec cache and force regeneration").option("--visibility <tags>", "Filter by release stage: public,beta,alpha,internal (comma-separated)").action(async (entry, options) => {
+  }).option("--no-cache", "Bypass spec cache and force regeneration").option("--visibility <tags>", "Filter by release stage: public,beta,alpha,internal (comma-separated)").option("--min-api-surface <percentage>", "Minimum API surface completeness percentage (0-100)", (value) => Number(value)).option("--api-surface", "Show only API surface / forgotten exports info").option("-v, --verbose", "Show detailed output including forgotten exports").action(async (entry, options) => {
     try {
       const spin = spinner("Analyzing...");
       let validations = parseExamplesFlag(options.examples);
@@ -2577,6 +2777,11 @@ function registerCheckCommand(program, dependencies = {}) {
       const minCoverage = clampPercentage(minCoverageRaw);
       const maxDriftRaw = options.maxDrift ?? config?.check?.maxDrift;
       const maxDrift = maxDriftRaw !== undefined ? clampPercentage(maxDriftRaw) : undefined;
+      const apiSurfaceConfig = config?.check?.apiSurface;
+      const minApiSurfaceRaw = options.minApiSurface ?? apiSurfaceConfig?.minCompleteness ?? config?.check?.minApiSurface;
+      const minApiSurface = minApiSurfaceRaw !== undefined ? clampPercentage(minApiSurfaceRaw) : undefined;
+      const warnBelowApiSurface = apiSurfaceConfig?.warnBelow ? clampPercentage(apiSurfaceConfig.warnBelow) : undefined;
+      const apiSurfaceIgnore = apiSurfaceConfig?.ignore ?? [];
       const cliFilters = {
         include: undefined,
         exclude: undefined,
@@ -2603,7 +2808,9 @@ function registerCheckCommand(program, dependencies = {}) {
       const doccov = buildDocCovSpec({
         openpkg,
         openpkgPath: entryFile,
-        packagePath: targetDir
+        packagePath: targetDir,
+        forgottenExports: specResult.forgottenExports,
+        apiSurfaceIgnore
       });
       const format = options.format ?? "text";
       const specWarnings = specResult.diagnostics.filter((d) => d.severity === "warning");
@@ -2635,12 +2842,23 @@ function registerCheckCommand(program, dependencies = {}) {
       const allDriftExports = [...collectDrift(openpkg.exports ?? [], doccov), ...runtimeDrifts];
       let driftExports = hasExamples ? allDriftExports : allDriftExports.filter((d) => d.category !== "example");
       if (shouldFix && driftExports.length > 0) {
-        const fixResult = await handleFixes(openpkg, doccov, { isPreview, targetDir }, { log, error });
+        const fixResult = await handleFixes(openpkg, doccov, { isPreview, targetDir, entryFile }, { log, error });
         if (!isPreview) {
           driftExports = driftExports.filter((d) => !fixResult.fixedDriftKeys.has(`${d.name}:${d.issue}`));
         }
       }
+      if (shouldFix && doccov.apiSurface?.forgotten.length) {
+        await handleForgottenExportFixes(doccov, { isPreview, targetDir, entryFile }, { log, error });
+      }
       spin.success("Analysis complete");
+      if (options.apiSurface) {
+        displayApiSurfaceOutput(doccov, { log });
+        const apiSurfaceScore = doccov.apiSurface?.completeness ?? 100;
+        if (minApiSurface !== undefined && apiSurfaceScore < minApiSurface) {
+          process.exit(1);
+        }
+        return;
+      }
       if (format !== "text") {
         const passed2 = handleNonTextOutput({
           format,
@@ -2649,6 +2867,7 @@ function registerCheckCommand(program, dependencies = {}) {
           coverageScore,
           minCoverage,
           maxDrift,
+          minApiSurface,
           driftExports,
           typecheckErrors,
           limit: parseInt(options.limit, 10) || 20,
@@ -2667,12 +2886,15 @@ function registerCheckCommand(program, dependencies = {}) {
         coverageScore,
         minCoverage,
         maxDrift,
+        minApiSurface,
+        warnBelowApiSurface,
         driftExports,
         typecheckErrors,
         staleRefs,
         exampleResult,
         specWarnings,
-        specInfos
+        specInfos,
+        verbose: options.verbose ?? false
       }, { log });
       if (!passed) {
         process.exit(1);
@@ -3097,7 +3319,8 @@ function registerInfoCommand(program) {
       const doccov = buildDocCovSpec2({
         openpkg,
         openpkgPath: entryFile,
-        packagePath: targetDir
+        packagePath: targetDir,
+        forgottenExports: specResult.forgottenExports
       });
       const stats = computeStats(openpkg, doccov);
       spin.success("Analysis complete");
@@ -3314,7 +3537,7 @@ import { validateDocCovSpec } from "@doccov/spec";
 import { normalize, validateSpec } from "@openpkg-ts/spec";
 import chalk11 from "chalk";
 // package.json
-var version = "0.25.8";
+var version = "0.25.11";
 
 // src/commands/spec.ts
 var defaultDependencies4 = {
@@ -3408,7 +3631,8 @@ function registerSpecCommand(program, dependencies = {}) {
         doccovSpec = buildDocCovSpec3({
           openpkgPath: "openpkg.json",
           openpkg: normalized,
-          packagePath: targetDir
+          packagePath: targetDir,
+          forgottenExports: result.forgottenExports
         });
         const doccovValidation = validateDocCovSpec(doccovSpec);
         if (!doccovValidation.ok) {

package/dist/config/index.d.ts

@@ -13,12 +13,22 @@ declare const exampleModeSchema: z.ZodEnum<["presence", "typecheck", "run"]>;
 /** Example validation modes - can be single, array, or comma-separated */
 declare const exampleModesSchema: z.ZodUnion<[typeof exampleModeSchema, z.ZodArray<typeof exampleModeSchema>, z.ZodString]>;
 /**
+* API surface configuration schema.
+*/
+declare const apiSurfaceConfigSchema: z.ZodObject<{
+	minCompleteness: z.ZodOptional<z.ZodNumber>;
+	warnBelow: z.ZodOptional<z.ZodNumber>;
+	ignore: z.ZodOptional<z.ZodArray<z.ZodString>>;
+}>;
+/**
 * Check command configuration schema.
 */
 declare const checkConfigSchema: z.ZodObject<{
 	examples: z.ZodOptional<typeof exampleModesSchema>;
 	minCoverage: z.ZodOptional<z.ZodNumber>;
 	maxDrift: z.ZodOptional<z.ZodNumber>;
+	minApiSurface: z.ZodOptional<z.ZodNumber>;
+	apiSurface: z.ZodOptional<typeof apiSurfaceConfigSchema>;
 }>;
 declare const docCovConfigSchema: z.ZodObject<{
 	include: z.ZodOptional<typeof stringList>;

package/dist/config/index.js

@@ -23,10 +23,17 @@ var exampleModesSchema = z.union([
   z.array(exampleModeSchema),
   z.string()
 ]);
+var apiSurfaceConfigSchema = z.object({
+  minCompleteness: z.number().min(0).max(100).optional(),
+  warnBelow: z.number().min(0).max(100).optional(),
+  ignore: z.array(z.string()).optional()
+});
 var checkConfigSchema = z.object({
   examples: exampleModesSchema.optional(),
   minCoverage: z.number().min(0).max(100).optional(),
-  maxDrift: z.number().min(0).max(100).optional()
+  maxDrift: z.number().min(0).max(100).optional(),
+  minApiSurface: z.number().min(0).max(100).optional(),
+  apiSurface: apiSurfaceConfigSchema.optional()
 });
 var docCovConfigSchema = z.object({
   include: stringList.optional(),
@@ -62,7 +69,9 @@ var normalizeConfig = (input) => {
     check = {
       examples: input.check.examples,
       minCoverage: input.check.minCoverage,
-      maxDrift: input.check.maxDrift
+      maxDrift: input.check.maxDrift,
+      minApiSurface: input.check.minApiSurface,
+      apiSurface: input.check.apiSurface
     };
   }
   return {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@doccov/cli",
-  "version": "0.25.9",
+  "version": "0.26.0",
   "description": "DocCov CLI - Documentation coverage and drift detection for TypeScript",
   "keywords": [
     "typescript",
@@ -48,8 +48,8 @@
   "dependencies": {
     "@ai-sdk/anthropic": "^1.0.0",
     "@ai-sdk/openai": "^1.0.0",
-    "@doccov/sdk": "^0.25.9",
-    "@doccov/spec": "^0.24.1",
+    "@doccov/sdk": "^0.26.0",
+    "@doccov/spec": "^0.26.0",
     "@inquirer/prompts": "^7.8.0",
     "@openpkg-ts/spec": "^0.12.0",
     "ai": "^4.0.0",