@pkgseer/cli 0.5.1 → 0.5.3

package/dist/cli.js

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 import {
   version
-} from "./shared/chunk-x6hqsn93.js";
+} from "./shared/chunk-dzjh13qr.js";
 
 // src/cli.ts
 import { Command } from "commander";
@@ -2863,6 +2863,14 @@ function handleErrors(errors, json) {
   const hint = CLI_HINTS[classifyError(combined)];
   outputError(`${combined}${hint}`, json);
 }
+function handleIndexingInProgress(data, json) {
+  if (data.indexingStatus === "INDEXING") {
+    const refInfo = data.indexingRef ? ` (ref: ${data.indexingRef})` : "";
+    outputError(`Target is being indexed${refInfo}. Retry with a longer --wait value or try again later.`, json);
+    return true;
+  }
+  return false;
+}
 function formatNumber(num) {
   if (num == null)
     return "N/A";
@@ -3077,7 +3085,8 @@ function formatDependencyEntry(entry) {
 // src/commands/code/callees.ts
 function formatCalleesResult(data) {
   const lines = [];
-  lines.push(`Callees of ${data.root.qualifiedPath ?? data.root.name} (ref:${data.root.symbolRef})`);
+  const rootLabel = data.root ? `${data.root.qualifiedPath ?? data.root.name} (ref:${data.root.symbolRef})` : "unknown";
+  lines.push(`Callees of ${rootLabel}`);
   lines.push(`${data.total} callee(s)${data.hasMore ? " (more available)" : ""}`);
   if (data.externalPackages && data.externalPackages.length > 0) {
     lines.push(`External packages: ${data.externalPackages.join(", ")}`);
@@ -3108,10 +3117,13 @@ async function codeCalleesAction(symbolArg, options, deps) {
     waitTimeoutMs: parseWaitTimeout(options.wait)
   });
   handleErrors(result.errors, options.json ?? false);
+  const data = result.data.symbolDependencies;
+  if (handleIndexingInProgress(data, options.json ?? false))
+    return;
   if (options.json) {
-    output(result.data.symbolDependencies, true);
+    output(data, true);
   } else {
-    console.log(formatCalleesResult(result.data.symbolDependencies));
+    console.log(formatCalleesResult(data));
   }
 }
 var CALLEES_DESCRIPTION = `Find what a symbol calls.
@@ -3134,7 +3146,8 @@ function registerCodeCalleesCommand(program) {
 // src/commands/code/callers.ts
 function formatCallersResult(data) {
   const lines = [];
-  lines.push(`Callers of ${data.target.qualifiedPath ?? data.target.name} (ref:${data.target.symbolRef})`);
+  const targetLabel = data.target ? `${data.target.qualifiedPath ?? data.target.name} (ref:${data.target.symbolRef})` : "unknown";
+  lines.push(`Callers of ${targetLabel}`);
   lines.push(`${data.total} caller(s)${data.hasMore ? " (more available)" : ""}`);
   lines.push("");
   for (const dep of data.dependents) {
@@ -3155,10 +3168,13 @@ async function codeCallersAction(symbolArg, options, deps) {
     waitTimeoutMs: parseWaitTimeout(options.wait)
   });
   handleErrors(result.errors, options.json ?? false);
+  const data = result.data.symbolDependents;
+  if (handleIndexingInProgress(data, options.json ?? false))
+    return;
   if (options.json) {
-    output(result.data.symbolDependents, true);
+    output(data, true);
   } else {
-    console.log(formatCallersResult(result.data.symbolDependents));
+    console.log(formatCallersResult(data));
   }
 }
 var CALLERS_DESCRIPTION = `Find what calls a symbol.
@@ -3181,12 +3197,14 @@ function registerCodeCallersCommand(program) {
 // src/commands/code/diff.ts
 function formatDiffResult(data) {
   const lines = [];
-  lines.push(`Version diff: ${data.fromVersion} → ${data.toVersion}`);
+  lines.push(`Version diff: ${data.fromVersion ?? "unknown"} → ${data.toVersion ?? "unknown"}`);
   lines.push("");
-  const s = data.summary;
-  lines.push("Summary:");
-  lines.push(`  Added: ${s.added}  Removed: ${s.removed}  Modified: ${s.modified}  Moved: ${s.moved}`);
-  lines.push(`  Breaking: ${s.breaking}  Behavior changes: ${s.behaviorChange}`);
+  if (data.summary) {
+    const s = data.summary;
+    lines.push("Summary:");
+    lines.push(`  Added: ${s.added}  Removed: ${s.removed}  Modified: ${s.modified}  Moved: ${s.moved}`);
+    lines.push(`  Breaking: ${s.breaking}  Behavior changes: ${s.behaviorChange}`);
+  }
   if (data.hasMore) {
     lines.push("  (more changes available, increase --limit)");
   }
@@ -3223,10 +3241,13 @@ async function codeDiffAction(packageArg, fromVersion, toVersion, options, deps)
     waitTimeoutMs: parseWaitTimeout(options.wait)
   });
   handleErrors(result.errors, options.json ?? false);
+  const data = result.data.versionDiff;
+  if (handleIndexingInProgress(data, options.json ?? false))
+    return;
   if (options.json) {
-    output(result.data.versionDiff, true);
+    output(data, true);
   } else {
-    console.log(formatDiffResult(result.data.versionDiff));
+    console.log(formatDiffResult(data));
   }
 }
 var DIFF_DESCRIPTION = `Compare symbols between two package versions.
@@ -3280,6 +3301,8 @@ async function codeFilesAction(packageArg, options, deps) {
   });
   handleErrors(result.errors, options.json ?? false);
   const data = result.data.listRepoFiles;
+  if (handleIndexingInProgress(data, options.json ?? false))
+    return;
   if (options.json) {
     output(data, true);
   } else {
@@ -3341,6 +3364,8 @@ async function codeFindAction(packageArg, nameArg, options, deps) {
   });
   handleErrors(result.errors, options.json ?? false);
   const data = result.data.findSymbol;
+  if (handleIndexingInProgress(data, options.json ?? false))
+    return;
   if (options.json) {
     output(data, true);
   } else {
@@ -3411,6 +3436,8 @@ async function codeGrepAction(packageArg, filePath, pattern, options, deps) {
   });
   handleErrors(result.errors, options.json ?? false);
   const data = result.data.grepRepoFile;
+  if (handleIndexingInProgress(data, options.json ?? false))
+    return;
   if (options.json) {
     output(data, true);
   } else {
@@ -3493,10 +3520,13 @@ async function codeImportsAction(packageArg, options, deps) {
     waitTimeoutMs: parseWaitTimeout(options.wait)
   });
   handleErrors(result.errors, options.json ?? false);
+  const data = result.data.packageImports;
+  if (handleIndexingInProgress(data, options.json ?? false))
+    return;
   if (options.json) {
-    output(result.data.packageImports, true);
+    output(data, true);
   } else {
-    console.log(formatImportsResult(result.data.packageImports));
+    console.log(formatImportsResult(data));
   }
 }
 var IMPORTS_DESCRIPTION = `List import statements in a package.
@@ -3558,10 +3588,13 @@ async function codeListAction(packageArg, options, deps) {
     waitTimeoutMs: parseWaitTimeout(options.wait)
   });
   handleErrors(result.errors, options.json ?? false);
+  const data = result.data.listSymbols;
+  if (handleIndexingInProgress(data, options.json ?? false))
+    return;
   if (options.json) {
-    output(result.data.listSymbols, true);
+    output(data, true);
   } else {
-    console.log(formatListResult(result.data.listSymbols));
+    console.log(formatListResult(data));
   }
 }
 var LIST_DESCRIPTION = `Browse symbols in a package.
@@ -3585,8 +3618,8 @@ function registerCodeListCommand(program) {
 // src/commands/code/path.ts
 function formatPathResult(data) {
   const lines = [];
-  const fromName = data.fromSymbol.qualifiedPath ?? data.fromSymbol.name;
-  const toName = data.toSymbol.qualifiedPath ?? data.toSymbol.name;
+  const fromName = data.fromSymbol ? data.fromSymbol.qualifiedPath ?? data.fromSymbol.name : "unknown";
+  const toName = data.toSymbol ? data.toSymbol.qualifiedPath ?? data.toSymbol.name : "unknown";
   lines.push(`Call path: ${fromName} -> ${toName}`);
   if (!data.pathFound) {
     lines.push("No path found between these symbols.");
@@ -3619,10 +3652,13 @@ async function codePathAction(fromArg, toArg, options, deps) {
     waitTimeoutMs: parseWaitTimeout(options.wait)
   });
   handleErrors(result.errors, options.json ?? false);
+  const data = result.data.callPath;
+  if (handleIndexingInProgress(data, options.json ?? false))
+    return;
   if (options.json) {
-    output(result.data.callPath, true);
+    output(data, true);
   } else {
-    console.log(formatPathResult(result.data.callPath));
+    console.log(formatPathResult(data));
   }
 }
 var PATH_DESCRIPTION = `Find call path between two symbols.
@@ -3696,6 +3732,8 @@ async function codeSearchAction(packageArg, query, options, deps) {
   });
   handleErrors(result.errors, options.json ?? false);
   const data = result.data.searchSymbols;
+  if (handleIndexingInProgress(data, options.json ?? false))
+    return;
   if (options.json) {
     output(data, true);
   } else {
@@ -6845,7 +6883,7 @@ var schemas = {
   packageName: z2.string().max(255).describe("Name of the package"),
   version: z2.string().max(100).optional().describe("Specific version, e.g. '4.18.2' (defaults to latest)"),
   navigationMode: z2.enum(["summary", "detailed"]).optional().describe("Response detail level. summary (default) returns core fields; detailed adds all optional fields."),
-  waitTimeoutMs: z2.coerce.number().int().min(0).max(60000).optional().describe("Max milliseconds to wait for indexing (0-60000, default 10000). Set 0 to error immediately if not indexed."),
+  waitTimeoutMs: z2.coerce.number().int().min(0).max(60000).optional().describe("Max milliseconds to wait for repository indexing (0-60000, default 10000). " + "On first access, unindexed code is auto-indexed — small packages complete within the default 10s. " + "If indexing exceeds this timeout, the response includes an indexingRef — " + "poll progress with indexing_status(ref), then retry when status is INDEXED. " + "Set 0 to skip waiting."),
   symbolReference: z2.object({
     symbol_ref: z2.string().optional().describe("Compound symbol reference (registry:package:version:id) from find_symbol or list_symbols results. Self-contained — no additional fields needed."),
     registry: z2.enum(["npm", "pypi", "hex", "crates", "nuget", "maven", "zig", "vcpkg"]).optional().describe("Package registry. For package-scoped lookup (with package_name + symbol_name)."),
@@ -6934,7 +6972,7 @@ function buildCodeTargetVars(resolved) {
 }
 var DEFAULT_WAIT_TIMEOUT_MS2 = 1e4;
 var MCP_HINTS = {
-  being_indexed: "Hint: target is being indexed. Retry with a longer wait_timeout_ms (e.g., 30000) or use indexing_status to poll progress.",
+  being_indexed: "Hint: use indexing_status to poll progress, then retry when status is INDEXED.",
   timeout: "Hint: this may be transient — retry the same query. If the issue persists, try simplifying the query."
 };
 function buildHintedMessage(operation, message) {
@@ -6964,7 +7002,7 @@ function buildHintedMessage(operation, message) {
 }
 var MCP_GRAPHQL_HINTS = {
   not_found: "Hint: verify the package name, registry, or repository URL are correct.",
-  being_indexed: "Hint: target is being indexed. Retry with a longer wait_timeout_ms (e.g., 30000) or use indexing_status to poll progress.",
+  being_indexed: "Hint: use indexing_status to poll progress, then retry when status is INDEXED.",
   timeout: "Hint: this may be transient — retry the same query. If the issue persists, try simplifying the query."
 };
 function getExtensionCode(errors) {
@@ -6987,7 +7025,7 @@ function getExtensionIndexingRef(errors) {
   return;
 }
 var EXTENSION_CODE_HINTS = {
-  PACKAGE_INDEXING: "Hint: target is being indexed. Use indexing_status to poll progress, or retry with a longer wait_timeout_ms.",
+  PACKAGE_INDEXING: "Hint: use indexing_status to poll progress, then retry when status is INDEXED.",
   NOT_FOUND: "Hint: verify the package name, registry, or repository URL are correct."
 };
 function handleGraphQLErrors(errors) {
@@ -7000,7 +7038,7 @@ function handleGraphQLErrors(errors) {
         error: combined,
         indexingStatus: "INDEXING",
         indexingRef,
-        message: "Target is being indexed. Use indexing_status tool with this indexingRef to poll progress, " + "or retry the original query after indexing completes."
+        message: `Target is being indexed. Poll with indexing_status(ref: "${indexingRef}"), then retry this query when status is INDEXED.`
       }));
     }
     if (extensionCode === "PACKAGE_INDEXING") {
@@ -7020,6 +7058,22 @@ async function withErrorHandling(operation, fn) {
     return errorResult(buildHintedMessage(operation, message));
   }
 }
+function handleIndexingStatus(data) {
+  if (data.indexingStatus === "INDEXING") {
+    const ref = data.indexingRef;
+    const response = {
+      indexingStatus: "INDEXING"
+    };
+    if (ref) {
+      response.indexingRef = ref;
+      response.message = `Target is being indexed. Poll with indexing_status(ref: "${ref}"), then retry this query when status is INDEXED.`;
+    } else {
+      response.message = "Target is being indexed. Retry this query in a few seconds, or with a longer wait_timeout_ms.";
+    }
+    return errorResult(JSON.stringify(response));
+  }
+  return null;
+}
 function notFoundError(packageName, registry) {
   return errorResult(`Package not found: ${packageName} in ${registry}. Verify the package name and registry are correct.`);
 }
@@ -7056,7 +7110,11 @@ function createCallPathTool(pkgseerService) {
         const graphqlError = handleGraphQLErrors(result.errors);
         if (graphqlError)
           return graphqlError;
-        return textResult(JSON.stringify(result.data.callPath, null, 2));
+        const data = result.data.callPath;
+        const indexingError = handleIndexingStatus(data);
+        if (indexingError)
+          return indexingError;
+        return textResult(JSON.stringify(data, null, 2));
       });
     }
   };
@@ -7171,6 +7229,9 @@ function createFindSymbolTool(pkgseerService) {
         if (graphqlError)
           return graphqlError;
         const data = result.data.findSymbol;
+        const indexingError = handleIndexingStatus(data);
+        if (indexingError)
+          return indexingError;
         if (data.symbols.length === 0 && data.diagnostics?.hint) {
           return textResult(JSON.stringify({ ...data, _hint: data.diagnostics.hint }, null, 2));
         }
@@ -7213,6 +7274,9 @@ function createGrepFileTool(pkgseerService) {
         if (graphqlError)
           return graphqlError;
         const data = result.data.grepRepoFile;
+        const indexingError = handleIndexingStatus(data);
+        if (indexingError)
+          return indexingError;
         if (data.matches.length === 0 && data.diagnostics?.hint) {
           return textResult(JSON.stringify({ ...data, _hint: data.diagnostics.hint }, null, 2));
         }
@@ -7256,11 +7320,11 @@ function createIndexingStatusTool(pkgseerService) {
           response.elapsedMs = progress.elapsedMs;
         }
         if (progress.status === "INDEXED") {
-          response.message = "Indexing is complete. Retry your original query to get results.";
+          response.message = "Indexing complete. Retry your original query to get results.";
         } else if (progress.status === "INDEXING" || progress.status === "PENDING") {
-          response.message = "Indexing is in progress. Poll again to check status.";
+          response.message = `Still indexing. Call indexing_status(ref: "${ref}") again to check progress.`;
         } else if (progress.status === "FAILED") {
-          response.message = "Indexing failed.";
+          response.message = "Indexing failed. The package may not exist or the repository may be inaccessible.";
         } else if (progress.status === "NOT_FOUND") {
           response.message = "Indexing reference not found. The ref may be invalid or the session may have expired.";
         }
@@ -7301,6 +7365,9 @@ function createListFilesTool(pkgseerService) {
         if (graphqlError)
           return graphqlError;
         const data = result.data.listRepoFiles;
+        const indexingError = handleIndexingStatus(data);
+        if (indexingError)
+          return indexingError;
         if (data.files.length === 0 && data.diagnostics?.hint) {
           return textResult(JSON.stringify({ ...data, _hint: data.diagnostics.hint }, null, 2));
         }
@@ -7344,7 +7411,11 @@ function createListImportsTool(pkgseerService) {
         const graphqlError = handleGraphQLErrors(result.errors);
         if (graphqlError)
           return graphqlError;
-        return textResult(JSON.stringify(result.data.packageImports, null, 2));
+        const data = result.data.packageImports;
+        const indexingError = handleIndexingStatus(data);
+        if (indexingError)
+          return indexingError;
+        return textResult(JSON.stringify(data, null, 2));
       });
     }
   };
@@ -7427,7 +7498,11 @@ function createListSymbolsTool(pkgseerService) {
         const graphqlError = handleGraphQLErrors(result.errors);
         if (graphqlError)
           return graphqlError;
-        return textResult(JSON.stringify(result.data.listSymbols, null, 2));
+        const data = result.data.listSymbols;
+        const indexingError = handleIndexingStatus(data);
+        if (indexingError)
+          return indexingError;
+        return textResult(JSON.stringify(data, null, 2));
       });
     }
   };
@@ -7666,10 +7741,16 @@ function createReadFileTool(pkgseerService) {
         const graphqlError = handleGraphQLErrors(result.errors);
         if (graphqlError)
           return graphqlError;
-        if (!result.data?.fetchCodeContext) {
+        const codeContext = result.data?.fetchCodeContext;
+        if (codeContext) {
+          const indexingError = handleIndexingStatus(codeContext);
+          if (indexingError)
+            return indexingError;
+        }
+        if (!codeContext) {
           return errorResult(`File not found: ${args.file_path}. ` + "Check that the file path and target are correct. " + "Use list_files to discover available files.");
         }
-        return textResult(JSON.stringify(result.data.fetchCodeContext, null, 2));
+        return textResult(JSON.stringify(codeContext, null, 2));
       });
     }
   };
@@ -7986,6 +8067,9 @@ function createSearchSymbolsTool(pkgseerService) {
         if (graphqlError)
           return graphqlError;
         const data = result.data.searchSymbols;
+        const indexingError = handleIndexingStatus(data);
+        if (indexingError)
+          return indexingError;
         const extra = {};
         if (data.results.length === 0 && data.diagnostics?.hint) {
           extra._hint = data.diagnostics.hint;
@@ -8035,7 +8119,11 @@ function createSymbolCalleesTool(pkgseerService) {
         const graphqlError = handleGraphQLErrors(result.errors);
         if (graphqlError)
           return graphqlError;
-        return textResult(JSON.stringify(result.data.symbolDependencies, null, 2));
+        const data = result.data.symbolDependencies;
+        const indexingError = handleIndexingStatus(data);
+        if (indexingError)
+          return indexingError;
+        return textResult(JSON.stringify(data, null, 2));
       });
     }
   };
@@ -8072,7 +8160,11 @@ function createSymbolCallersTool(pkgseerService) {
         const graphqlError = handleGraphQLErrors(result.errors);
         if (graphqlError)
           return graphqlError;
-        return textResult(JSON.stringify(result.data.symbolDependents, null, 2));
+        const data = result.data.symbolDependents;
+        const indexingError = handleIndexingStatus(data);
+        if (indexingError)
+          return indexingError;
+        return textResult(JSON.stringify(data, null, 2));
       });
     }
   };
@@ -8176,7 +8268,11 @@ function createVersionDiffTool(pkgseerService) {
         const graphqlError = handleGraphQLErrors(result.errors);
         if (graphqlError)
           return graphqlError;
-        return textResult(JSON.stringify(result.data.versionDiff, null, 2));
+        const data = result.data.versionDiff;
+        const indexingError = handleIndexingStatus(data);
+        if (indexingError)
+          return indexingError;
+        return textResult(JSON.stringify(data, null, 2));
       });
     }
   };

package/dist/index.js

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

package/dist/shared/{chunk-x6hqsn93.js → chunk-dzjh13qr.js}

@@ -1,4 +1,4 @@
 // package.json
-var version = "0.5.1";
+var version = "0.5.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.5.1",
+  "version": "0.5.3",
   "type": "module",
   "files": [
     "dist",