@doccov/cli 0.21.0 → 0.22.0

package/dist/cli.js

@@ -613,6 +613,22 @@ function renderHtml(stats, options = {}) {
 </html>`;
 }
 // src/reports/pr-comment.ts
+function extractReturnType(schema) {
+  if (!schema)
+    return "void";
+  if (typeof schema === "string")
+    return schema;
+  if (typeof schema === "object") {
+    const s = schema;
+    if (typeof s.type === "string")
+      return s.type;
+    if (typeof s.$ref === "string") {
+      const ref = s.$ref;
+      return ref.startsWith("#/types/") ? ref.slice("#/types/".length) : ref;
+    }
+  }
+  return "unknown";
+}
 function renderPRComment(data, opts = {}) {
   const { diff, headSpec } = data;
   const limit = opts.limit ?? 10;
@@ -773,7 +789,7 @@ function formatExportSignature(exp) {
   if (exp.kind === "function" && exp.signatures?.[0]) {
     const sig = exp.signatures[0];
     const params = sig.parameters?.map((p) => `${p.name}${p.required === false ? "?" : ""}`).join(", ") ?? "";
-    const ret = sig.returns?.tsType ?? "void";
+    const ret = extractReturnType(sig.returns?.schema);
     return `${prefix} ${exp.name}(${params}): ${ret}`;
   }
   if (exp.kind === "type" || exp.kind === "interface") {
@@ -795,7 +811,7 @@ function getMissingSignals(exp) {
     if (undocParams.length > 0) {
       missing.push(`\`@param ${undocParams.map((p) => p.name).join(", ")}\``);
     }
-    if (!sig.returns?.description && sig.returns?.tsType !== "void") {
+    if (!sig.returns?.description && extractReturnType(sig.returns?.schema) !== "void") {
       missing.push("`@returns`");
     }
   }
@@ -2190,11 +2206,11 @@ var detectRepoInfo = (cwd, fileExists2, readFileSync4) => {
 // src/commands/spec.ts
 import * as fs5 from "node:fs";
 import * as path7 from "node:path";
-import { DocCov as DocCov3, NodeFileSystem as NodeFileSystem3, renderApiSurface, resolveTarget as resolveTarget3 } from "@doccov/sdk";
+import { detectPackageManager, DocCov as DocCov3, NodeFileSystem as NodeFileSystem3, renderApiSurface, resolveTarget as resolveTarget3 } from "@doccov/sdk";
 import { normalize, validateSpec } from "@openpkg-ts/spec";
 import chalk8 from "chalk";
 // package.json
-var version = "0.20.0";
+var version = "0.21.0";
 
 // src/commands/spec.ts
 var defaultDependencies4 = {
@@ -2303,6 +2319,14 @@ function registerSpecCommand(program, dependencies = {}) {
       }
       log(chalk8.gray(`  ${getArrayLength(normalized.exports)} exports`));
       log(chalk8.gray(`  ${getArrayLength(normalized.types)} types`));
+      const schemaExtraction = normalized.generation?.analysis?.schemaExtraction;
+      if (options.runtime && (!schemaExtraction?.runtimeCount || schemaExtraction.runtimeCount === 0)) {
+        const pm = await detectPackageManager(fileSystem);
+        const buildCmd = pm.name === "npm" ? "npm run build" : `${pm.name} run build`;
+        log("");
+        log(chalk8.yellow("⚠ Runtime extraction requested but no schemas extracted."));
+        log(chalk8.yellow(`  Ensure project is built (${buildCmd}) and dist/ exists.`));
+      }
       if (options.verbose && normalized.generation) {
         const gen = normalized.generation;
         log("");

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@doccov/cli",
-  "version": "0.21.0",
+  "version": "0.22.0",
   "description": "DocCov CLI - Documentation coverage and drift detection for TypeScript",
   "keywords": [
     "typescript",
@@ -48,9 +48,9 @@
   "dependencies": {
     "@ai-sdk/anthropic": "^1.0.0",
     "@ai-sdk/openai": "^1.0.0",
-    "@doccov/sdk": "^0.21.0",
+    "@doccov/sdk": "^0.22.0",
     "@inquirer/prompts": "^7.8.0",
-    "@openpkg-ts/spec": "^0.10.0",
+    "@openpkg-ts/spec": "^0.11.0",
     "ai": "^4.0.0",
     "chalk": "^5.4.1",
     "commander": "^14.0.0",