@pkgseer/cli 0.2.5 → 0.3.0

package/README.md

@@ -96,8 +96,14 @@ pkgseer search "json parsing" -P hex:jason,hex:poison
 # Search modes
 pkgseer search "auth" -P lodash --mode code   # Code only
 pkgseer search "auth" -P lodash --mode docs   # Docs only
+
+# Wait options (for packages that need indexing)
+pkgseer search "api" -P new-package --wait 60000  # Wait up to 60s
+pkgseer search "api" -P new-package --no-wait     # Return immediately
 ```
 
+If packages haven't been indexed yet, the search will wait up to 30 seconds by default. Use `--wait <ms>` to customize or `--no-wait` to return immediately with progress info.
+
 ### Package Commands
 
 ```bash

package/dist/cli.js

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 import {
   version
-} from "./shared/chunk-drz16bhv.js";
+} from "./shared/chunk-9yar14cw.js";
 
 // src/cli.ts
 import { Command } from "commander";
@@ -211,36 +211,52 @@ var CliDocsListDocument = gql`
 }
     `;
 var CombinedSearchDocument = gql`
-    query CombinedSearch($packages: [SearchPackageInput!]!, $query: String!, $mode: SearchMode, $limit: Int) {
-  combinedSearch(packages: $packages, query: $query, mode: $mode, limit: $limit) {
-    query
-    mode
-    totalResults
-    entries {
-      id
-      type
-      title
-      subtitle
-      packageName
-      registry
-      score
-      snippet
-      filePath
-      startLine
-      endLine
-      language
-      chunkType
-      repoUrl
-      gitRef
-      pageId
-      sourceUrl
+    query CombinedSearch($packages: [SearchPackageInput!]!, $query: String!, $mode: SearchMode, $limit: Int, $waitTimeoutMs: Int) {
+  combinedSearch(
+    packages: $packages
+    query: $query
+    mode: $mode
+    limit: $limit
+    waitTimeoutMs: $waitTimeoutMs
+  ) {
+    completed
+    searchRef
+    result {
+      query
+      mode
+      totalResults
+      entries {
+        id
+        type
+        title
+        subtitle
+        packageName
+        registry
+        score
+        snippet
+        filePath
+        startLine
+        endLine
+        language
+        chunkType
+        repoUrl
+        gitRef
+        pageId
+        sourceUrl
+      }
+      indexingStatus {
+        registry
+        packageName
+        version
+        codeStatus
+        docsStatus
+      }
     }
-    indexingStatus {
-      registry
-      packageName
-      version
-      codeStatus
-      docsStatus
+    progress {
+      status
+      packagesTotal
+      packagesReady
+      elapsedMs
     }
   }
 }
@@ -1419,7 +1435,8 @@ class PkgseerServiceImpl {
       packages,
       query,
       mode: options?.mode,
-      limit: options?.limit
+      limit: options?.limit,
+      waitTimeoutMs: options?.waitTimeoutMs
     });
     return { data: result.data, errors: result.errors };
   }
@@ -2342,6 +2359,7 @@ function registerDocsListCommand(program) {
   });
 }
 // src/commands/search.ts
+var DEFAULT_WAIT_TIMEOUT_MS = 30000;
 var colors = {
   reset: "\x1B[0m",
   bold: "\x1B[1m",
@@ -2562,6 +2580,36 @@ function truncate(text, maxLen) {
     return text;
   return `${text.slice(0, maxLen - 3)}...`;
 }
+function isSubstantiveLine(line) {
+  const trimmed = line.trim();
+  if (trimmed.length === 0)
+    return false;
+  if (/^[(){}[\];,]+$/.test(trimmed))
+    return false;
+  if (trimmed.length <= 3 && /^[^a-zA-Z0-9]*$/.test(trimmed))
+    return false;
+  return true;
+}
+function findBestSnippetLine(snippet) {
+  const lines = snippet.split(`
+`).map((l) => l.trim());
+  if (lines.length === 0)
+    return null;
+  const middleIndex = Math.floor((lines.length - 1) / 2);
+  for (let offset = 0;offset <= lines.length; offset++) {
+    const beforeIdx = middleIndex - offset;
+    if (beforeIdx >= 0 && isSubstantiveLine(lines[beforeIdx])) {
+      return lines[beforeIdx];
+    }
+    if (offset > 0) {
+      const afterIdx = middleIndex + offset;
+      if (afterIdx < lines.length && isSubstantiveLine(lines[afterIdx])) {
+        return lines[afterIdx];
+      }
+    }
+  }
+  return null;
+}
 function formatEntryCompact(entry, useColors) {
   if (!entry)
     return "";
@@ -2579,12 +2627,11 @@ function formatEntryCompact(entry, useColors) {
   }
   let snippet = "";
   if (entry.snippet) {
-    const firstLine = entry.snippet.split(`
-`).map((l) => l.trim()).find((l) => l.length > 0);
-    if (firstLine) {
-      snippet = `  ${truncate(firstLine, 80)}`;
+    const bestLine = findBestSnippetLine(entry.snippet);
+    if (bestLine) {
+      snippet = `  ${truncate(bestLine, 80)}`;
       if (useColors) {
-        snippet = `  ${colors.dim}${truncate(firstLine, 80)}${colors.reset}`;
+        snippet = `  ${colors.dim}${truncate(bestLine, 80)}${colors.reset}`;
       }
     }
   }
@@ -2662,6 +2709,50 @@ function summarizeSearchResults(results) {
   return lines.join(`
 `);
 }
+function formatSearchProgress(progress, searchRef, useColors) {
+  const lines = [];
+  if (useColors) {
+    lines.push(`${colors.yellow}Search in progress...${colors.reset}`);
+  } else {
+    lines.push("Search in progress...");
+  }
+  if (progress) {
+    const statusText = progress.status?.toLowerCase() ?? "unknown";
+    lines.push(`Status: ${statusText}`);
+    if (progress.packagesTotal != null && progress.packagesReady != null) {
+      lines.push(`Packages: ${progress.packagesReady}/${progress.packagesTotal} ready`);
+    }
+    if (progress.elapsedMs != null) {
+      lines.push(`Elapsed: ${(progress.elapsedMs / 1000).toFixed(1)}s`);
+    }
+  }
+  lines.push("");
+  lines.push("Some packages may still be indexing.");
+  lines.push("Run again in a moment for complete results.");
+  if (searchRef) {
+    lines.push("");
+    if (useColors) {
+      lines.push(`${colors.dim}Search ref: ${searchRef}${colors.reset}`);
+    } else {
+      lines.push(`Search ref: ${searchRef}`);
+    }
+  }
+  return lines.join(`
+`);
+}
+function getWaitTimeoutMs(options) {
+  if (options.noWait) {
+    return 0;
+  }
+  if (options.wait) {
+    const parsed = Number.parseInt(options.wait, 10);
+    if (!Number.isNaN(parsed) && parsed >= 0) {
+      return parsed;
+    }
+    console.warn(`Warning: Invalid --wait value "${options.wait}". Using default (${DEFAULT_WAIT_TIMEOUT_MS}ms).`);
+  }
+  return DEFAULT_WAIT_TIMEOUT_MS;
+}
 async function searchAction(queryArg, options, deps, defaultMode = "ALL") {
   const { pkgseerService } = deps;
   const query = Array.isArray(queryArg) ? queryArg.join(" ") : queryArg ?? "";
@@ -2681,16 +2772,37 @@ async function searchAction(queryArg, options, deps, defaultMode = "ALL") {
   const limit = options.limit ? Number.parseInt(options.limit, 10) : 25;
   const mode = options.mode ? toSearchMode(options.mode) : defaultMode;
   const useColors = shouldUseColors(options.noColor);
+  const waitTimeoutMs = getWaitTimeoutMs(options);
   const result = await pkgseerService.combinedSearch(packages, query, {
     mode,
-    limit
+    limit,
+    waitTimeoutMs
   });
   handleErrors(result.errors, options.json ?? false);
-  if (!result.data.combinedSearch) {
+  const asyncResult = result.data.combinedSearch;
+  if (!asyncResult) {
     outputError("No results returned. Check package names and registries.", options.json ?? false);
     return;
   }
-  outputResults(result.data.combinedSearch, options, useColors);
+  if (!asyncResult.completed) {
+    if (options.json) {
+      output({
+        completed: false,
+        searchRef: asyncResult.searchRef,
+        progress: asyncResult.progress,
+        message: "Search is still indexing. Retry for complete results."
+      }, true);
+    } else {
+      console.log(formatSearchProgress(asyncResult.progress, asyncResult.searchRef, useColors));
+    }
+    return;
+  }
+  const searchResults = asyncResult.result;
+  if (!searchResults) {
+    outputError("Search completed but no results returned.", options.json ?? false);
+    return;
+  }
+  outputResults(searchResults, options, useColors);
 }
 function outputResults(results, options, useColors) {
   const format = options.json ? "json" : options.format ?? "human";
@@ -2741,7 +2853,7 @@ Examples:
   # JSON output
   pkgseer search "error" -P express --json`;
 function addSearchOptions(cmd) {
-  return cmd.option("-P, --packages <packages>", "Packages to search (comma-separated). Format: name or registry/name[@version]. Examples: express | express,lodash | pypi/django@4.2").option("-m, --mode <mode>", "Search mode: all (default), code, docs").option("-l, --limit <n>", "Max results (default: 25)").option("-v, --verbose", "Expanded output with more details").option("--refs-only", "Output only references (for piping)").option("--count", "Output result counts by package").option("--format <format>", "Output format: human|summary|json", "human").option("--no-color", "Disable colored output").option("--json", "Output as JSON");
+  return cmd.option("-P, --packages <packages>", "Packages to search (comma-separated). Format: name or registry/name[@version]. Examples: express | express,lodash | pypi/django@4.2").option("-m, --mode <mode>", "Search mode: all (default), code, docs").option("-l, --limit <n>", "Max results (default: 25)").option("-v, --verbose", "Expanded output with more details").option("--refs-only", "Output only references (for piping)").option("--count", "Output result counts by package").option("--format <format>", "Output format: human|summary|json", "human").option("--no-color", "Disable colored output").option("--json", "Output as JSON").option("--wait <ms>", "Max milliseconds to wait for indexing (default: 30000)").option("--no-wait", "Return immediately without waiting for indexing");
 }
 function registerSearchCommand(program) {
   const cmd = program.command("search [query...]").summary("Search code and documentation across packages").description(SEARCH_DESCRIPTION);
@@ -2782,7 +2894,7 @@ Examples:
 
 Note: For code search, use 'pkgseer search --mode code' instead.`;
 function addDocsSearchOptions(cmd) {
-  return cmd.option("-P, --packages <packages>", "Packages to search (comma-separated). Format: [registry:]name[@version]. Examples: express | express,lodash | pypi:django@4.2").option("-l, --limit <n>", "Max results (default: 25)").option("-v, --verbose", "Expanded output with more details").option("--refs-only", "Output only references (for piping)").option("--count", "Output result counts by package").option("--format <format>", "Output format: human|summary|json", "human").option("--no-color", "Disable colored output").option("--json", "Output as JSON");
+  return cmd.option("-P, --packages <packages>", "Packages to search (comma-separated). Format: [registry:]name[@version]. Examples: express | express,lodash | pypi:django@4.2").option("-l, --limit <n>", "Max results (default: 25)").option("-v, --verbose", "Expanded output with more details").option("--refs-only", "Output only references (for piping)").option("--count", "Output result counts by package").option("--format <format>", "Output format: human|summary|json", "human").option("--no-color", "Disable colored output").option("--json", "Output as JSON").option("--wait <ms>", "Max milliseconds to wait for indexing (default: 30000)").option("--no-wait", "Return immediately without waiting for indexing");
 }
 function registerDocsSearchCommand(program) {
   const cmd = program.command("search [query...]").summary("Search documentation").description(DOCS_SEARCH_DESCRIPTION);
@@ -4951,11 +5063,13 @@ var packageInputSchema2 = z7.object({
   name: z7.string().min(1).describe("Package name"),
   version: z7.string().optional().describe("Specific version (defaults to latest)")
 });
+var DEFAULT_AGENT_WAIT_TIMEOUT_MS = 1e4;
 var argsSchema9 = {
   packages: z7.array(packageInputSchema2).min(1).max(20).describe("Packages to search (1-20). Each package needs registry and name."),
   query: z7.string().min(1).describe("Search query - natural language or keywords"),
   mode: z7.enum(["all", "code", "docs"]).optional().describe('Search mode: "all" (default), "code" only, or "docs" only'),
-  limit: z7.number().int().min(1).max(100).optional().describe("Maximum results (default: 20)")
+  limit: z7.number().int().min(1).max(100).optional().describe("Maximum results (default: 20)"),
+  waitTimeoutMs: z7.number().int().min(0).max(60000).optional().describe("Max milliseconds to wait for indexing (default: 10000, 0=immediate)")
 };
 function toSearchMode2(mode) {
   if (!mode)
@@ -4993,9 +5107,9 @@ Results may be incomplete. Retry later for more complete results.`;
 function createSearchTool(pkgseerService) {
   return {
     name: "search",
-    description: "Search code and documentation across packages. Returns functions, classes, and documentation pages " + "matching your query. Use mode='code' for code only, mode='docs' for documentation only, or " + "mode='all' (default) for both. Provide 1-20 packages to search. Results include relevance scores " + "and snippets showing matches.",
+    description: "Search code and documentation across packages. Returns functions, classes, and documentation pages " + "matching your query. Use mode='code' for code only, mode='docs' for documentation only, or " + "mode='all' (default) for both. Provide 1-20 packages to search. Results include relevance scores " + "and snippets showing matches. If packages need indexing, the search will wait up to waitTimeoutMs " + "(default 10s). If not complete, returns progress info with searchRef for follow-up.",
     schema: argsSchema9,
-    handler: async ({ packages, query, mode, limit }, _extra) => {
+    handler: async ({ packages, query, mode, limit, waitTimeoutMs }, _extra) => {
       return withErrorHandling("search packages", async () => {
         const normalizedQuery = query.trim();
         if (normalizedQuery.length === 0) {
@@ -5008,15 +5122,29 @@ function createSearchTool(pkgseerService) {
         }));
         const result = await pkgseerService.combinedSearch(graphqlPackages, normalizedQuery, {
           mode: toSearchMode2(mode),
-          limit
+          limit,
+          waitTimeoutMs: waitTimeoutMs ?? DEFAULT_AGENT_WAIT_TIMEOUT_MS
         });
         const graphqlError = handleGraphQLErrors(result.errors);
         if (graphqlError)
           return graphqlError;
-        if (!result.data.combinedSearch) {
+        const asyncResult = result.data.combinedSearch;
+        if (!asyncResult) {
           return errorResult("No search results returned. Check package names and registries.");
         }
-        const searchResult = result.data.combinedSearch;
+        if (!asyncResult.completed) {
+          const progressInfo = {
+            completed: false,
+            searchRef: asyncResult.searchRef,
+            progress: asyncResult.progress,
+            message: "Search is still indexing. Retry with same query for results, " + "or increase waitTimeoutMs to wait longer."
+          };
+          return textResult(JSON.stringify(progressInfo, null, 2));
+        }
+        const searchResult = asyncResult.result;
+        if (!searchResult) {
+          return errorResult("Search completed but no results returned.");
+        }
         const entries = searchResult.entries ?? [];
         if (entries.length === 0) {
           return errorResult(`No results found for "${normalizedQuery}". ` + "Try broader terms or different packages.");

package/dist/index.js

@@ -1,6 +1,6 @@
 import {
   version
-} from "./shared/chunk-drz16bhv.js";
+} from "./shared/chunk-9yar14cw.js";
 export {
   version
 };

package/dist/shared/{chunk-drz16bhv.js → chunk-9yar14cw.js}

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