@doccov/cli 0.5.1 → 0.5.3

package/dist/cli.js

@@ -170,7 +170,6 @@ import {
   serializeJSDoc
 } from "@doccov/sdk";
 import chalk from "chalk";
-import ora from "ora";
 
 // src/utils/llm-assertion-parser.ts
 import { createAnthropic } from "@ai-sdk/anthropic";
@@ -243,11 +242,6 @@ async function parseAssertionsWithLLM(code) {
 // src/commands/check.ts
 var defaultDependencies = {
   createDocCov: (options) => new DocCov(options),
-  spinner: (text) => ora({
-    text,
-    discardStdin: false,
-    hideCursor: true
-  }),
   log: console.log,
   error: console.error
 };
@@ -276,7 +270,7 @@ function groupByExport(drifts) {
   return map;
 }
 function registerCheckCommand(program, dependencies = {}) {
-  const { createDocCov, spinner, log, error } = {
+  const { createDocCov, log, error } = {
     ...defaultDependencies,
     ...dependencies
   };
@@ -315,15 +309,17 @@ function registerCheckCommand(program, dependencies = {}) {
       }
       const minCoverage = clampCoverage(options.minCoverage ?? 80);
       const resolveExternalTypes = !options.skipResolve;
-      const spinnerInstance = spinner("Analyzing documentation coverage...");
-      spinnerInstance.start();
+      process.stdout.write(chalk.cyan(`> Analyzing documentation coverage...
+`));
       let specResult;
       try {
         const doccov = createDocCov({ resolveExternalTypes });
         specResult = await doccov.analyzeFileWithDiagnostics(entryFile);
-        spinnerInstance.succeed("Documentation analysis complete");
+        process.stdout.write(chalk.green(`✓ Documentation analysis complete
+`));
       } catch (analysisError) {
-        spinnerInstance.fail("Failed to analyze documentation coverage");
+        process.stdout.write(chalk.red(`✗ Failed to analyze documentation coverage
+`));
         throw analysisError;
       }
       if (!specResult) {
@@ -359,8 +355,8 @@ function registerCheckCommand(program, dependencies = {}) {
         if (allExamples.length === 0) {
           log(chalk.gray("No @example blocks found"));
         } else {
-          const examplesSpinner = spinner("Installing package for examples...");
-          examplesSpinner.start();
+          process.stdout.write(chalk.cyan(`> Installing package for examples...
+`));
           const flatExamples = allExamples.flatMap((e) => e.examples);
           const packageResult = await runExamplesWithPackage(flatExamples, {
             packagePath: targetDir,
@@ -369,10 +365,12 @@ function registerCheckCommand(program, dependencies = {}) {
             cwd: targetDir
           });
           if (!packageResult.installSuccess) {
-            examplesSpinner.fail(`Package install failed: ${packageResult.installError}`);
+            process.stdout.write(chalk.red(`✗ Package install failed: ${packageResult.installError}
+`));
             log(chalk.yellow("Skipping example execution. Ensure the package is built."));
           } else {
-            examplesSpinner.text = "Running @example blocks...";
+            process.stdout.write(chalk.cyan(`> Running @example blocks...
+`));
             let examplesRun = 0;
             let examplesFailed = 0;
             let exampleIndex = 0;
@@ -442,9 +440,11 @@ function registerCheckCommand(program, dependencies = {}) {
               }
             }
             if (examplesFailed > 0) {
-              examplesSpinner.fail(`${examplesFailed}/${examplesRun} example(s) failed`);
+              process.stdout.write(chalk.red(`✗ ${examplesFailed}/${examplesRun} example(s) failed
+`));
             } else {
-              examplesSpinner.succeed(`${examplesRun} example(s) passed`);
+              process.stdout.write(chalk.green(`✓ ${examplesRun} example(s) passed
+`));
             }
           }
         }
@@ -538,16 +538,18 @@ function registerCheckCommand(program, dependencies = {}) {
                 }
                 log(chalk.gray("Run without --dry-run to apply these changes."));
               } else {
-                const applySpinner = spinner("Applying fixes...");
-                applySpinner.start();
+                process.stdout.write(chalk.cyan(`> Applying fixes...
+`));
                 const applyResult = await applyEdits(edits);
                 if (applyResult.errors.length > 0) {
-                  applySpinner.warn("Some fixes could not be applied");
+                  process.stdout.write(chalk.yellow(`⚠ Some fixes could not be applied
+`));
                   for (const err of applyResult.errors) {
                     error(chalk.red(`  ${err.file}: ${err.error}`));
                   }
                 } else {
-                  applySpinner.succeed(`Applied ${applyResult.editsApplied} fix(es) to ${applyResult.filesModified} file(s)`);
+                  process.stdout.write(chalk.green(`✓ Applied ${applyResult.editsApplied} fix(es) to ${applyResult.filesModified} file(s)
+`));
                 }
                 log("");
                 for (const [filePath, fileEdits] of editsByFile) {
@@ -943,7 +945,6 @@ import {
 } from "@doccov/sdk";
 import { normalize, validateSpec } from "@openpkg-ts/spec";
 import chalk4 from "chalk";
-import ora2 from "ora";
 
 // src/utils/filter-options.ts
 import chalk3 from "chalk";
@@ -999,11 +1000,6 @@ var mergeFilterOptions = (config, cliOptions) => {
 var defaultDependencies3 = {
   createDocCov: (options) => new DocCov2(options),
   writeFileSync: fs3.writeFileSync,
-  spinner: (text) => ora2({
-    text,
-    discardStdin: false,
-    hideCursor: true
-  }),
   log: console.log,
   error: console.error
 };
@@ -1028,7 +1024,7 @@ function formatDiagnosticOutput(prefix, diagnostic, baseDir) {
   return `${prefix} ${locationPrefix}${diagnostic.message}`;
 }
 function registerGenerateCommand(program, dependencies = {}) {
-  const { createDocCov, writeFileSync: writeFileSync2, spinner, log, error } = {
+  const { createDocCov, writeFileSync: writeFileSync2, log, error } = {
     ...defaultDependencies3,
     ...dependencies
   };
@@ -1083,8 +1079,8 @@ function registerGenerateCommand(program, dependencies = {}) {
       for (const message of resolvedFilters.messages) {
         log(chalk4.gray(`• ${message}`));
       }
-      const spinnerInstance = spinner("Generating OpenPkg spec...");
-      spinnerInstance.start();
+      process.stdout.write(chalk4.cyan(`> Generating OpenPkg spec...
+`));
       let result;
       try {
         const doccov = createDocCov({
@@ -1097,9 +1093,11 @@ function registerGenerateCommand(program, dependencies = {}) {
           }
         } : {};
         result = await doccov.analyzeFileWithDiagnostics(entryFile, analyzeOptions);
-        spinnerInstance.succeed("Generated OpenPkg spec");
+        process.stdout.write(chalk4.green(`✓ Generated OpenPkg spec
+`));
       } catch (generationError) {
-        spinnerInstance.fail("Failed to generate spec");
+        process.stdout.write(chalk4.red(`✗ Failed to generate spec
+`));
         throw generationError;
       }
       if (!result) {
@@ -1278,7 +1276,6 @@ import {
   NodeFileSystem as NodeFileSystem3
 } from "@doccov/sdk";
 import chalk6 from "chalk";
-import ora3 from "ora";
 
 // src/reports/markdown.ts
 function bar(pct, width = 10) {
@@ -1480,16 +1477,20 @@ function registerReportCommand(program) {
         } else {
           entryFile = path6.resolve(targetDir, entryFile);
         }
-        const spinner = ora3({
-          text: "Analyzing...",
-          discardStdin: false,
-          hideCursor: true
-        }).start();
-        const resolveExternalTypes = !options.skipResolve;
-        const doccov = new DocCov3({ resolveExternalTypes });
-        const result = await doccov.analyzeFileWithDiagnostics(entryFile);
-        spinner.succeed("Analysis complete");
-        spec = result.spec;
+        process.stdout.write(chalk6.cyan(`> Analyzing...
+`));
+        try {
+          const resolveExternalTypes = !options.skipResolve;
+          const doccov = new DocCov3({ resolveExternalTypes });
+          const result = await doccov.analyzeFileWithDiagnostics(entryFile);
+          process.stdout.write(chalk6.green(`✓ Analysis complete
+`));
+          spec = result.spec;
+        } catch (analysisError) {
+          process.stdout.write(chalk6.red(`✗ Analysis failed
+`));
+          throw analysisError;
+        }
       }
       const stats = computeStats(spec);
       const format = options.output;
@@ -1532,7 +1533,6 @@ import {
   NodeFileSystem as NodeFileSystem4
 } from "@doccov/sdk";
 import chalk7 from "chalk";
-import ora4 from "ora";
 import { simpleGit } from "simple-git";
 
 // src/utils/github-url.ts
@@ -1660,16 +1660,11 @@ async function generateBuildPlan(repoDir) {
 // src/commands/scan.ts
 var defaultDependencies5 = {
   createDocCov: (options) => new DocCov4(options),
-  spinner: (text) => ora4({
-    text,
-    discardStdin: false,
-    hideCursor: true
-  }),
   log: console.log,
   error: console.error
 };
 function registerScanCommand(program, dependencies = {}) {
-  const { createDocCov, spinner, log, error } = {
+  const { createDocCov, log, error } = {
     ...defaultDependencies5,
     ...dependencies
   };
@@ -1685,8 +1680,8 @@ function registerScanCommand(program, dependencies = {}) {
       log("");
       tempDir = path8.join(os.tmpdir(), `doccov-scan-${Date.now()}-${Math.random().toString(36).slice(2)}`);
       fs7.mkdirSync(tempDir, { recursive: true });
-      const cloneSpinner = spinner(`Cloning ${parsed.owner}/${parsed.repo}...`);
-      cloneSpinner.start();
+      process.stdout.write(chalk7.cyan(`> Cloning ${parsed.owner}/${parsed.repo}...
+`));
       try {
         const git = simpleGit({
           timeout: {
@@ -1707,9 +1702,11 @@ function registerScanCommand(program, dependencies = {}) {
         } finally {
           process.env = originalEnv;
         }
-        cloneSpinner.succeed(`Cloned ${parsed.owner}/${parsed.repo}`);
+        process.stdout.write(chalk7.green(`✓ Cloned ${parsed.owner}/${parsed.repo}
+`));
       } catch (cloneError) {
-        cloneSpinner.fail("Failed to clone repository");
+        process.stdout.write(chalk7.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.
@@ -1728,8 +1725,8 @@ function registerScanCommand(program, dependencies = {}) {
       if (options.skipInstall) {
         log(chalk7.gray("Skipping dependency installation (--skip-install)"));
       } else {
-        const installSpinner = spinner("Installing dependencies...");
-        installSpinner.start();
+        process.stdout.write(chalk7.cyan(`> Installing dependencies...
+`));
         const installErrors = [];
         try {
           const { execSync } = await import("node:child_process");
@@ -1778,16 +1775,19 @@ function registerScanCommand(program, dependencies = {}) {
             }
           }
           if (installed) {
-            installSpinner.succeed("Dependencies installed");
+            process.stdout.write(chalk7.green(`✓ Dependencies installed
+`));
           } else {
-            installSpinner.warn("Could not install dependencies (analysis may be limited)");
+            process.stdout.write(chalk7.yellow(`⚠ Could not install dependencies (analysis may be limited)
+`));
             for (const err of installErrors) {
               log(chalk7.gray(`  ${err}`));
             }
           }
         } catch (outerError) {
           const msg = outerError instanceof Error ? outerError.message : String(outerError);
-          installSpinner.warn(`Could not install dependencies: ${msg.slice(0, 100)}`);
+          process.stdout.write(chalk7.yellow(`⚠ Could not install dependencies: ${msg.slice(0, 100)}
+`));
           for (const err of installErrors) {
             log(chalk7.gray(`  ${err}`));
           }
@@ -1818,13 +1818,14 @@ function registerScanCommand(program, dependencies = {}) {
         packageName = pkg.name;
         log(chalk7.gray(`Analyzing package: ${packageName}`));
       }
-      const entrySpinner = spinner("Detecting entry point...");
-      entrySpinner.start();
+      process.stdout.write(chalk7.cyan(`> Detecting entry point...
+`));
       let entryPath;
       const targetFs = mono.isMonorepo ? new NodeFileSystem4(targetDir) : fileSystem;
       let buildFailed = false;
       const runLlmFallback = async (reason) => {
-        entrySpinner.text = `${reason}, trying LLM fallback...`;
+        process.stdout.write(chalk7.cyan(`> ${reason}, trying LLM fallback...
+`));
         const plan = await generateBuildPlan(targetDir);
         if (!plan) {
           return null;
@@ -1858,45 +1859,54 @@ function registerScanCommand(program, dependencies = {}) {
         const buildInfo = await detectBuildInfo(targetFs);
         const needsBuildStep = entry.isDeclarationOnly && buildInfo.exoticIndicators.wasm;
         if (needsBuildStep) {
-          entrySpinner.text = "Detected .d.ts entry with WASM indicators...";
+          process.stdout.write(chalk7.cyan(`> Detected .d.ts entry with WASM indicators...
+`));
           const llmEntry = await runLlmFallback("WASM project detected");
           if (llmEntry) {
             entryPath = path8.join(targetDir, llmEntry);
             if (buildFailed) {
-              entrySpinner.succeed(`Entry point: ${llmEntry} (using pre-committed declarations)`);
+              process.stdout.write(chalk7.green(`✓ Entry point: ${llmEntry} (using pre-committed declarations)
+`));
               log(chalk7.gray("  Coverage may be limited - generated .d.ts files typically lack JSDoc"));
             } else {
-              entrySpinner.succeed(`Entry point: ${llmEntry} (from LLM fallback - WASM project)`);
+              process.stdout.write(chalk7.green(`✓ Entry point: ${llmEntry} (from LLM fallback - WASM project)
+`));
             }
           } else {
             entryPath = path8.join(targetDir, entry.path);
-            entrySpinner.succeed(`Entry point: ${entry.path} (from ${entry.source})`);
+            process.stdout.write(chalk7.green(`✓ Entry point: ${entry.path} (from ${entry.source})
+`));
             log(chalk7.yellow("  ⚠ WASM project detected but no API key - analysis may be limited"));
           }
         } else {
           entryPath = path8.join(targetDir, entry.path);
-          entrySpinner.succeed(`Entry point: ${entry.path} (from ${entry.source})`);
+          process.stdout.write(chalk7.green(`✓ Entry point: ${entry.path} (from ${entry.source})
+`));
         }
       } catch (entryError) {
         const llmEntry = await runLlmFallback("Heuristics failed");
         if (llmEntry) {
           entryPath = path8.join(targetDir, llmEntry);
-          entrySpinner.succeed(`Entry point: ${llmEntry} (from LLM fallback)`);
+          process.stdout.write(chalk7.green(`✓ Entry point: ${llmEntry} (from LLM fallback)
+`));
         } else {
-          entrySpinner.fail("Could not detect entry point (set OPENAI_API_KEY for smart fallback)");
+          process.stdout.write(chalk7.red(`✗ Could not detect entry point (set OPENAI_API_KEY for smart fallback)
+`));
           throw entryError;
         }
       }
-      const analyzeSpinner = spinner("Analyzing documentation coverage...");
-      analyzeSpinner.start();
+      process.stdout.write(chalk7.cyan(`> Analyzing documentation coverage...
+`));
       let result;
       try {
         const resolveExternalTypes = !options.skipResolve;
         const doccov = createDocCov({ resolveExternalTypes });
         result = await doccov.analyzeFileWithDiagnostics(entryPath);
-        analyzeSpinner.succeed("Analysis complete");
+        process.stdout.write(chalk7.green(`✓ Analysis complete
+`));
       } catch (analysisError) {
-        analyzeSpinner.fail("Analysis failed");
+        process.stdout.write(chalk7.red(`✗ Analysis failed
+`));
         throw analysisError;
       }
       const spec = result.spec;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@doccov/cli",
-  "version": "0.5.1",
+  "version": "0.5.3",
   "description": "DocCov CLI - Documentation coverage and drift detection for TypeScript",
   "keywords": [
     "typescript",
@@ -49,13 +49,12 @@
     "@ai-sdk/anthropic": "^1.0.0",
     "@ai-sdk/openai": "^1.0.0",
     "@inquirer/prompts": "^7.8.0",
-    "@doccov/sdk": "^0.3.3",
+    "@doccov/sdk": "^0.3.7",
     "@openpkg-ts/spec": "^0.3.1",
     "ai": "^4.0.0",
     "chalk": "^5.4.1",
     "commander": "^14.0.0",
     "glob": "^11.0.0",
-    "ora": "^8.2.0",
     "simple-git": "^3.27.0",
     "zod": "^3.23.8"
   },