@doccov/cli 0.33.1 → 0.34.1

package/dist/drift.js

@@ -175568,6 +175568,9 @@ function renderBatchCoverage(data) {
   }
   lines.push("");
   lines.push(indent(`${c.bold("Total")}: ${data.aggregate.score}% (${data.aggregate.documented}/${data.aggregate.total})`));
+  if (data.skipped && data.skipped.length > 0) {
+    lines.push(indent(`${c.gray(`Skipped ${data.skipped.length} private: ${data.skipped.join(", ")}`)}`));
+  }
   lines.push("");
   return lines.join(`
 `);
@@ -175583,6 +175586,9 @@ function renderBatchLint(data) {
   }
   lines.push("");
   lines.push(indent(`${c.bold("Total")}: ${data.aggregate.count} issue${data.aggregate.count === 1 ? "" : "s"}`));
+  if (data.skipped && data.skipped.length > 0) {
+    lines.push(indent(`${c.gray(`Skipped ${data.skipped.length} private: ${data.skipped.join(", ")}`)}`));
+  }
   lines.push("");
   return lines.join(`
 `);
@@ -175700,21 +175706,27 @@ function discoverPackages(cwd) {
     if (!existsSync10(absDir))
       continue;
     let name = dir;
+    let isPrivate = false;
     const pkgPath = path13.join(absDir, "package.json");
     if (existsSync10(pkgPath)) {
       try {
         const pkg = JSON.parse(readFileSync9(pkgPath, "utf-8"));
         if (pkg.name)
           name = pkg.name;
+        if (pkg.private === true)
+          isPrivate = true;
       } catch {}
     }
     try {
       const entry = detectEntry(absDir);
-      packages.push({ name, dir, entry });
+      packages.push({ name, dir, entry, ...isPrivate ? { private: true } : {} });
     } catch {}
   }
   return packages;
 }
+function filterPublic(packages) {
+  return packages.filter((p) => !p.private);
+}
 
 // src/utils/detect-entry.ts
 function detectEntry(cwd = process.cwd()) {
@@ -175926,13 +175938,19 @@ function getPackageInfo(cwd) {
   }
 }
 function registerHealthCommand(program) {
-  program.command("health [entry]", { isDefault: true }).description("Show documentation health score (default command)").option("--min <n>", "Minimum health threshold (exit 1 if below)").option("--all", "Run across all workspace packages").action(async (entry, options) => {
+  program.command("health [entry]", { isDefault: true }).description("Show documentation health score (default command)").option("--min <n>", "Minimum health threshold (exit 1 if below)").option("--all", "Run across all workspace packages").option("--private", "Include private packages in --all mode").action(async (entry, options) => {
     const startTime = Date.now();
     const version = getVersion();
     try {
       if (options.all) {
-        const packages = discoverPackages(process.cwd());
-        if (!packages || packages.length === 0) {
+        const allPackages = discoverPackages(process.cwd());
+        if (!allPackages || allPackages.length === 0) {
+          formatError("health", "No workspace packages found", startTime, version);
+          return;
+        }
+        const skipped = options.private ? [] : allPackages.filter((p) => p.private).map((p) => p.name);
+        const packages = options.private ? allPackages : filterPublic(allPackages);
+        if (packages.length === 0) {
           formatError("health", "No workspace packages found", startTime, version);
           return;
         }
@@ -175953,7 +175971,7 @@ function registerHealthCommand(program) {
           totalAll += exps.length;
         }
         const aggScore = totalAll > 0 ? Math.round(totalDoc / totalAll * 100) : 100;
-        const data2 = { packages: rows, aggregate: { score: aggScore, documented: totalDoc, total: totalAll } };
+        const data2 = { packages: rows, aggregate: { score: aggScore, documented: totalDoc, total: totalAll }, ...skipped.length > 0 ? { skipped } : {} };
         formatOutput("health", data2, startTime, version, renderBatchCoverage);
         return;
       }
@@ -176593,7 +176611,7 @@ function buildMarkdownTable(results, pass) {
 `);
 }
 function registerCiCommand(program) {
-  program.command("ci").description("Run CI checks on changed packages").option("--all", "Check all packages, not just changed ones").action(async (options) => {
+  program.command("ci").description("Run CI checks on changed packages").option("--all", "Check all packages, not just changed ones").option("--private", "Include private packages").action(async (options) => {
     const startTime = Date.now();
     const version = getVersion5();
     const cwd = process.cwd();
@@ -176612,20 +176630,28 @@ function registerCiCommand(program) {
         packageDirs = allDirs;
       const minThreshold = config.coverage?.min ?? 0;
       const results = [];
+      const skipped = [];
       const commit = gh.sha?.slice(0, 7) ?? getCommitSha();
       for (const dir of packageDirs) {
         const absDir = dir === "." ? cwd : path23.join(cwd, dir);
         if (!existsSync17(absDir))
           continue;
         let name = dir;
+        let isPrivate = false;
         const pkgPath = path23.join(absDir, "package.json");
         if (existsSync17(pkgPath)) {
           try {
             const pkg = JSON.parse(readFileSync20(pkgPath, "utf-8"));
             if (pkg.name)
               name = pkg.name;
+            if (pkg.private === true)
+              isPrivate = true;
           } catch {}
         }
+        if (isPrivate && !options.private) {
+          skipped.push(name);
+          continue;
+        }
         try {
           const entryFile = detectEntry(absDir);
           const { spec } = await cachedExtract(entryFile);
@@ -176685,7 +176711,7 @@ function registerCiCommand(program) {
           } catch {}
         }
       }
-      const data = { results, pass: allPass, min: minThreshold };
+      const data = { results, pass: allPass, min: minThreshold, ...skipped.length > 0 ? { skipped } : {} };
       formatOutput("ci", data, startTime, version, renderCi);
       if (!allPass)
         process.exitCode = 1;
@@ -176735,13 +176761,19 @@ function getVersion6() {
   }
 }
 function registerCoverageCommand(program) {
-  program.command("coverage [entry]").description("Measure documentation coverage for a TypeScript entry file").option("--min <n>", "Minimum coverage threshold (exit 1 if below)").option("--all", "Run across all workspace packages").action(async (entry, options) => {
+  program.command("coverage [entry]").description("Measure documentation coverage for a TypeScript entry file").option("--min <n>", "Minimum coverage threshold (exit 1 if below)").option("--all", "Run across all workspace packages").option("--private", "Include private packages in --all mode").action(async (entry, options) => {
     const startTime = Date.now();
     const version = getVersion6();
     try {
       if (options.all) {
-        const packages = discoverPackages(process.cwd());
-        if (!packages || packages.length === 0) {
+        const allPackages = discoverPackages(process.cwd());
+        if (!allPackages || allPackages.length === 0) {
+          formatError("coverage", "No workspace packages found", startTime, version);
+          return;
+        }
+        const skipped = options.private ? [] : allPackages.filter((p) => p.private).map((p) => p.name);
+        const packages = options.private ? allPackages : filterPublic(allPackages);
+        if (packages.length === 0) {
           formatError("coverage", "No workspace packages found", startTime, version);
           return;
         }
@@ -176762,7 +176794,7 @@ function registerCoverageCommand(program) {
           totalAll += exps.length;
         }
         const aggScore = totalAll > 0 ? Math.round(totalDoc / totalAll * 100) : 100;
-        const data2 = { packages: rows, aggregate: { score: aggScore, documented: totalDoc, total: totalAll } };
+        const data2 = { packages: rows, aggregate: { score: aggScore, documented: totalDoc, total: totalAll }, ...skipped.length > 0 ? { skipped } : {} };
         formatOutput("coverage", data2, startTime, version, renderBatchCoverage);
         const minT = options.min ? parseInt(options.min, 10) : undefined;
         if (minT !== undefined && aggScore < minT)
@@ -176946,13 +176978,19 @@ function getVersion8() {
   }
 }
 function registerExtractCommand(program) {
-  program.command("extract [entry]").description("Extract OpenPkg spec from TypeScript entry file").option("-o, --output <file>", "Write JSON to file instead of stdout").option("--only <patterns>", "Include exports matching glob (comma-separated)").option("--ignore <patterns>", "Exclude exports matching glob (comma-separated)").option("--max-depth <n>", "Max type resolution depth", "10").option("--all", "Extract from all workspace packages").action(async (entry, options) => {
+  program.command("extract [entry]").description("Extract OpenPkg spec from TypeScript entry file").option("-o, --output <file>", "Write JSON to file instead of stdout").option("--only <patterns>", "Include exports matching glob (comma-separated)").option("--ignore <patterns>", "Exclude exports matching glob (comma-separated)").option("--max-depth <n>", "Max type resolution depth", "10").option("--all", "Extract from all workspace packages").option("--private", "Include private packages in --all mode").action(async (entry, options) => {
     const startTime = Date.now();
     const version = getVersion8();
     try {
       if (options.all) {
-        const packages = discoverPackages(process.cwd());
-        if (!packages || packages.length === 0) {
+        const allPackages = discoverPackages(process.cwd());
+        if (!allPackages || allPackages.length === 0) {
+          formatError("extract", "No workspace packages found", startTime, version);
+          return;
+        }
+        const skipped = options.private ? [] : allPackages.filter((p) => p.private).map((p) => p.name);
+        const packages = options.private ? allPackages : filterPublic(allPackages);
+        if (packages.length === 0) {
           formatError("extract", "No workspace packages found", startTime, version);
           return;
         }
@@ -176961,7 +176999,7 @@ function registerExtractCommand(program) {
           const { spec: spec2 } = await cachedExtract(pkg.entry);
           specs.push({ name: pkg.name, spec: spec2 });
         }
-        formatOutput("extract", { packages: specs }, startTime, version);
+        formatOutput("extract", { packages: specs, ...skipped.length > 0 ? { skipped } : {} }, startTime, version);
         return;
       }
       const entryFile = entry ? path26.resolve(process.cwd(), entry) : detectEntry();
@@ -177468,13 +177506,19 @@ function getVersion12() {
   }
 }
 function registerLintCommand(program) {
-  program.command("lint [entry]").description("Cross-reference JSDoc against code for accuracy issues").option("--all", "Run across all workspace packages").action(async (entry, options) => {
+  program.command("lint [entry]").description("Cross-reference JSDoc against code for accuracy issues").option("--all", "Run across all workspace packages").option("--private", "Include private packages in --all mode").action(async (entry, options) => {
     const startTime = Date.now();
     const version = getVersion12();
     try {
       if (options.all) {
-        const packages = discoverPackages(process.cwd());
-        if (!packages || packages.length === 0) {
+        const allPackages = discoverPackages(process.cwd());
+        if (!allPackages || allPackages.length === 0) {
+          formatError("lint", "No workspace packages found", startTime, version);
+          return;
+        }
+        const skipped = options.private ? [] : allPackages.filter((p) => p.private).map((p) => p.name);
+        const packages = options.private ? allPackages : filterPublic(allPackages);
+        if (packages.length === 0) {
           formatError("lint", "No workspace packages found", startTime, version);
           return;
         }
@@ -177489,7 +177533,7 @@ function registerLintCommand(program) {
           rows.push({ name: pkg.name, exports: (spec2.exports ?? []).length, issues: issues2 });
           totalIssues += issues2;
         }
-        const data2 = { packages: rows, aggregate: { count: totalIssues } };
+        const data2 = { packages: rows, aggregate: { count: totalIssues }, ...skipped.length > 0 ? { skipped } : {} };
         formatOutput("lint", data2, startTime, version, renderBatchLint);
         if (totalIssues > 0)
           process.exitCode = 1;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@doccov/cli",
-  "version": "0.33.1",
+  "version": "0.34.1",
   "description": "DocCov CLI - Documentation coverage and drift detection for TypeScript",
   "keywords": [
     "typescript",