@pkgseer/cli 0.4.2 → 0.4.3

package/dist/cli.js

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 import {
   version
-} from "./shared/chunk-w4ht5me5.js";
+} from "./shared/chunk-d3mfgdr9.js";
 
 // src/cli.ts
 import { Command } from "commander";
@@ -685,6 +685,13 @@ var FindSymbolDocument = gql`
     totalMatches
     hasMore
     indexedVersion
+    diagnostics {
+      indexed
+      chunkCount
+      fileCount
+      indexedAt
+      hint
+    }
   }
 }
     `;
@@ -730,6 +737,7 @@ var SearchSymbolsDocument = gql`
       indexedAt
       hint
     }
+    warning
   }
 }
     `;
@@ -767,7 +775,6 @@ var ListSymbolsDocument = gql`
       path
       language
     }
-    error
   }
 }
     `;
@@ -950,6 +957,13 @@ var ListRepoFilesDocument = gql`
     total
     hasMore
     indexedVersion
+    diagnostics {
+      indexed
+      chunkCount
+      fileCount
+      indexedAt
+      hint
+    }
   }
 }
     `;
@@ -977,6 +991,13 @@ var GrepRepoFileDocument = gql`
     language
     totalLines
     indexedVersion
+    diagnostics {
+      indexed
+      chunkCount
+      fileCount
+      indexedAt
+      hint
+    }
   }
 }
     `;
@@ -2441,8 +2462,11 @@ function handleErrors(errors, json) {
   const isNotFound = lower.includes("not found") || lower.includes("does not exist") || lower.includes("unknown");
   const isAuth = lower.includes("unauthorized") || lower.includes("forbidden") || lower.includes("token") || lower.includes("authentication") || lower.includes("permission");
   const isRateLimit = lower.includes("rate limit") || lower.includes("too many requests");
+  const isBeingIndexed = lower.includes("being indexed") || lower.includes("retry with waittimeoutms");
   let hint = "";
-  if (isTimeout) {
+  if (isBeingIndexed) {
+    hint = " Hint: package is being indexed. Try again with a longer --wait value (e.g., --wait 30000).";
+  } else if (isTimeout) {
     hint = " Hint: lower the limit or narrow the scope, then retry.";
   } else if (isNotFound) {
     hint = " Hint: verify the name/registry and that the resource exists.";
@@ -2480,14 +2504,20 @@ function formatSeverity(severity) {
   return indicators[severity] || severity;
 }
 function extractGraphQLError(error) {
-  if (error && typeof error === "object" && "response" in error && error.response && typeof error.response === "object" && "errors" in error.response && Array.isArray(error.response.errors)) {
-    const errors = error.response.errors;
-    if (errors.length > 0) {
-      const messages = errors.map((e) => e.message).filter((m) => typeof m === "string");
+  if (error && typeof error === "object" && "response" in error && error.response && typeof error.response === "object" && "errors" in error.response) {
+    const respErrors = error.response.errors;
+    if (Array.isArray(respErrors)) {
+      const messages = respErrors.map((e) => e.message).filter((m) => typeof m === "string");
       if (messages.length > 0) {
         return messages.join("; ");
       }
     }
+    if (respErrors && typeof respErrors === "object" && !Array.isArray(respErrors) && "detail" in respErrors) {
+      const detail = respErrors.detail;
+      if (typeof detail === "string") {
+        return detail;
+      }
+    }
   }
   if (error && typeof error === "object" && "errors" in error && Array.isArray(error.errors)) {
     const errors = error.errors;
@@ -2536,6 +2566,10 @@ async function withCliErrorHandling(json, fn) {
     }
     const message = error instanceof Error ? error.message : "Unknown error";
     const lower = message.toLowerCase();
+    if (lower.includes("being indexed") || lower.includes("retry with waittimeoutms")) {
+      outputError(`${message}. Hint: package is being indexed. Try again with a longer --wait value (e.g., --wait 30000).`, json);
+      return;
+    }
     if (lower.includes("-32001") || lower.includes("timeout")) {
       outputError(`${message}. Hint: lower the limit or narrow the scope, then retry.`, json);
       return;
@@ -2886,10 +2920,17 @@ async function codeFilesAction(packageArg, options, deps) {
     outputError(`Package not found: ${parsed.name} in ${parsed.registry}`, options.json ?? false);
     return;
   }
+  const data = result.data.listRepoFiles;
   if (options.json) {
-    output(result.data.listRepoFiles, true);
+    output(data, true);
   } else {
-    console.log(formatFilesResult(result.data.listRepoFiles));
+    const formatted = formatFilesResult(data);
+    if (data.files.length === 0 && data.diagnostics?.hint) {
+      console.log(`${formatted}
+Note: ${data.diagnostics.hint}`);
+    } else {
+      console.log(formatted);
+    }
   }
 }
 var FILES_DESCRIPTION = `List files in a package's indexed repository.
@@ -2944,10 +2985,17 @@ async function codeFindAction(packageArg, nameArg, options, deps) {
     outputError(`Package not found: ${parsed.name} in ${parsed.registry}`, options.json ?? false);
     return;
   }
+  const data = result.data.findSymbol;
   if (options.json) {
-    output(result.data.findSymbol, true);
+    output(data, true);
   } else {
-    console.log(formatFindResult(result.data.findSymbol));
+    const formatted = formatFindResult(data);
+    if (data.symbols.length === 0 && data.diagnostics?.hint) {
+      console.log(`${formatted}
+Note: ${data.diagnostics.hint}`);
+    } else {
+      console.log(formatted);
+    }
   }
 }
 var FIND_DESCRIPTION = `Find symbols (functions, classes, modules) by name.
@@ -3011,10 +3059,17 @@ async function codeGrepAction(packageArg, filePath, pattern, options, deps) {
     outputError(`Package not found: ${parsed.name} in ${parsed.registry}`, options.json ?? false);
     return;
   }
+  const data = result.data.grepRepoFile;
   if (options.json) {
-    output(result.data.grepRepoFile, true);
+    output(data, true);
   } else {
-    console.log(formatGrepResult(result.data.grepRepoFile));
+    const formatted = formatGrepResult(data);
+    if (data.matches.length === 0 && data.diagnostics?.hint) {
+      console.log(`${formatted}
+Note: ${data.diagnostics.hint}`);
+    } else {
+      console.log(formatted);
+    }
   }
 }
 var GREP_DESCRIPTION = `Search for a pattern within a file in a package's repository.
@@ -3124,9 +3179,6 @@ function formatListResult(data) {
   if (data.file) {
     lines.push(`File: ${data.file.path}${data.file.language ? ` (${data.file.language})` : ""}`);
   }
-  if (data.error) {
-    lines.push(`Warning: ${data.error}`);
-  }
   lines.push("");
   for (const symbol of data.symbols) {
     lines.push(formatSymbol(symbol));
@@ -3308,10 +3360,21 @@ async function codeSearchAction(packageArg, query, options, deps) {
     outputError(`Package not found: ${parsed.name} in ${parsed.registry}`, options.json ?? false);
     return;
   }
+  const data = result.data.searchSymbols;
   if (options.json) {
-    output(result.data.searchSymbols, true);
+    output(data, true);
   } else {
-    console.log(formatSearchResult(result.data.searchSymbols));
+    let formatted = formatSearchResult(data);
+    if (data.warning) {
+      formatted = `Warning: ${data.warning}
+
+${formatted}`;
+    }
+    if (data.results.length === 0 && data.diagnostics?.hint) {
+      formatted = `${formatted}
+Note: ${data.diagnostics.hint}`;
+    }
+    console.log(formatted);
   }
 }
 var SEARCH_DESCRIPTION = `Full-text search within package code.
@@ -6440,10 +6503,30 @@ function toSymbolReferenceInput(ref) {
 }
 function buildHintedMessage(operation, message) {
   const lower = message.toLowerCase();
+  const isBeingIndexed = lower.includes("being indexed") || lower.includes("retry with waittimeoutms");
+  if (isBeingIndexed) {
+    return `Failed to ${operation}: ${message}. ` + "Hint: package is being indexed. Try again with a longer wait_timeout_ms (e.g., 30000).";
+  }
   const isTimeout = lower.includes("-32001") || lower.includes("timeout") || lower.includes("timed out");
   if (isTimeout) {
     return `Failed to ${operation}: ${message}. ` + "Hint: try lowering the limit or narrowing the scope, then retry.";
   }
+  if (lower.includes("graphql error (code: 500)")) {
+    try {
+      const jsonMatch = message.match(/\{.*\}/s);
+      if (jsonMatch) {
+        const parsed = JSON.parse(jsonMatch[0]);
+        const detail = parsed.errors?.detail ?? parsed.detail;
+        if (typeof detail === "string") {
+          return `Failed to ${operation}: ${detail}`;
+        }
+      }
+    } catch {}
+    const detailMatch = message.match(/"detail"\s*:\s*"([^"]+)"/);
+    if (detailMatch?.[1]) {
+      return `Failed to ${operation}: ${detailMatch[1]}`;
+    }
+  }
   return `Failed to ${operation}: ${message}`;
 }
 function handleGraphQLErrors(errors) {
@@ -6452,10 +6535,14 @@ function handleGraphQLErrors(errors) {
     const combined = messages.join(", ");
     const lower = combined.toLowerCase();
     const hasNotFound = lower.includes("not found") || lower.includes("does not exist");
+    const hasBeingIndexed = lower.includes("being indexed") || lower.includes("retry with waittimeoutms");
     const hasTimeout = lower.includes("-32001") || lower.includes("timeout") || lower.includes("timed out");
     if (hasNotFound) {
       return errorResult(`Error: ${combined}. Hint: verify the name/registry and that the resource exists.`);
     }
+    if (hasBeingIndexed) {
+      return errorResult(`Error: ${combined}. Hint: package is being indexed. Try again with a longer wait_timeout_ms (e.g., 30000).`);
+    }
     if (hasTimeout) {
       return errorResult(`Error: ${combined}. Hint: try lowering the limit or narrowing the scope, then retry.`);
     }
@@ -6650,7 +6737,11 @@ function createFindSymbolTool(pkgseerService) {
         if (!result.data.findSymbol) {
           return notFoundError(args.package_name, args.registry);
         }
-        return textResult(JSON.stringify(result.data.findSymbol, null, 2));
+        const data = result.data.findSymbol;
+        if (data.symbols.length === 0 && data.diagnostics?.hint) {
+          return textResult(JSON.stringify({ ...data, _hint: data.diagnostics.hint }, null, 2));
+        }
+        return textResult(JSON.stringify(data, null, 2));
       });
     }
   };
@@ -6686,7 +6777,11 @@ function createGrepRepoFileTool(pkgseerService) {
         if (!result.data.grepRepoFile) {
           return notFoundError(args.package_name, args.registry);
         }
-        return textResult(JSON.stringify(result.data.grepRepoFile, null, 2));
+        const data = result.data.grepRepoFile;
+        if (data.matches.length === 0 && data.diagnostics?.hint) {
+          return textResult(JSON.stringify({ ...data, _hint: data.diagnostics.hint }, null, 2));
+        }
+        return textResult(JSON.stringify(data, null, 2));
       });
     }
   };
@@ -6745,7 +6840,11 @@ function createListRepoFilesTool(pkgseerService) {
         if (!result.data.listRepoFiles) {
           return notFoundError(args.package_name, args.registry);
         }
-        return textResult(JSON.stringify(result.data.listRepoFiles, null, 2));
+        const data = result.data.listRepoFiles;
+        if (data.files.length === 0 && data.diagnostics?.hint) {
+          return textResult(JSON.stringify({ ...data, _hint: data.diagnostics.hint }, null, 2));
+        }
+        return textResult(JSON.stringify(data, null, 2));
       });
     }
   };
@@ -7298,7 +7397,18 @@ function createSearchSymbolsTool(pkgseerService) {
         if (!result.data.searchSymbols) {
           return notFoundError(args.package_name, args.registry);
         }
-        return textResult(JSON.stringify(result.data.searchSymbols, null, 2));
+        const data = result.data.searchSymbols;
+        const extra = {};
+        if (data.results.length === 0 && data.diagnostics?.hint) {
+          extra._hint = data.diagnostics.hint;
+        }
+        if (data.warning) {
+          extra._warning = data.warning;
+        }
+        if (Object.keys(extra).length > 0) {
+          return textResult(JSON.stringify({ ...data, ...extra }, null, 2));
+        }
+        return textResult(JSON.stringify(data, null, 2));
       });
     }
   };

package/dist/index.js

@@ -1,6 +1,6 @@
 import {
   version
-} from "./shared/chunk-w4ht5me5.js";
+} from "./shared/chunk-d3mfgdr9.js";
 export {
   version
 };

package/dist/shared/{chunk-w4ht5me5.js → chunk-d3mfgdr9.js}

@@ -1,4 +1,4 @@
 // package.json
-var version = "0.4.2";
+var version = "0.4.3";
 
 export { version };

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@pkgseer/cli",
   "description": "CLI companion for PkgSeer - package intelligence for developers and AI assistants",
-  "version": "0.4.2",
+  "version": "0.4.3",
   "type": "module",
   "files": [
     "dist",