@lzehrung/codegraph 2.3.3 → 2.3.5

package/codegraph-skill/codegraph/SKILL.md

@@ -45,20 +45,17 @@ Use `--root` to define the boundary for config lookup, path confinement, and out
 - `languages.extensions` maps literal suffixes such as `.tpl` to supported language IDs; longest suffix wins, while `.vue` and `.svelte` cannot be remapped.
 - CLI `--include-glob` and `--ignore-glob` values are one-off filters relative to each active scan root.
 - Use `--no-gitignore` only when ignored files are intentionally in scope.
-- Index-backed commands stay quiet for their first second, then write progress and a heartbeat to stderr. Use `--progress` for immediate logs or `--no-progress` to suppress feedback; JSON stdout remains unchanged.
+- Index-backed commands stay quiet for their first second, then write progress and a heartbeat to stderr. Cold or incompatible rebuilds report source and metadata discovery before build progress; path checks include completed and total counts when known. Use `--progress` for immediate logs or `--no-progress` to suppress feedback; JSON stdout remains unchanged.
 
 ## Choose the Smallest Follow-up
 
 ### Understand
 
-- answer a question with bounded evidence: `codegraph explore "how does auth reach db?" --root .`
-- find a ranked anchor: `codegraph search "auth user" --json`
-- resolve a known symbol identity: `codegraph symbols "CodeReviewSession" --root .`
-- explain a known target: `codegraph explain <file|symbol|sql-object|handle>`
-- retrieve bounded indexed context: `codegraph packet get <file|symbol|sql-object|handle>`
-- read current disk content: `codegraph file <path> --offset 1 --limit 200`
-
-`explore` returns ranked anchors, bounded packets, dependency paths, blast radius, candidate tests, explicit limits, omission counts, and copyable follow-ups. CLI `explore` includes source packets and exact-path `fileView` by default because people read its inline output; use `--no-source` when anchors, paths, and follow-up commands are enough. JSON keeps the stable `schemaVersion: 1` fields and `followUps` array as tool-call descriptors (`{tool, arguments, label?}`), not CLI strings. Hybrid search is code-first by default, and search, explain, explore, and review preserve analysis labels so reduced or mixed runs remain visible.
+- map a repo: `codegraph orient --root . --budget small`
+- find a target: `codegraph symbols "CodeReviewSession"` / `codegraph search "auth user"` / `codegraph grep "spawn|timeout"`
+- navigate a symbol: `codegraph refs <handle>` -> `codegraph callers <handle>` -> `codegraph rdeps <file|handle>`
+- explain or retrieve a target: `codegraph explain <handle>` or `codegraph packet get <handle>`
+- use `codegraph explore` only for one hybrid search plus context from top results
 
 Use `search --no-snippets` when handles and paths are sufficient and source text will be fetched separately with `file`. Use `explain --changed-context` for bounded source context around changed ranges in changed-file or review workflows.
 

package/dist/bin/cli.js

@@ -1179,6 +1179,7 @@ function createInteractiveProgressDisplay(write, delayMs = 0) {
   let current = 0;
   let total = 0;
   let mode = "build";
+  let activity = progressAction(mode);
   let interval;
   let delay;
   const clear = () => {
@@ -1190,11 +1191,10 @@ function createInteractiveProgressDisplay(write, delayMs = 0) {
   const render = () => {
     if (!active)
       return;
-    const action = progressAction(mode);
     const frame = SPINNER_FRAMES[frameIndex % SPINNER_FRAMES.length];
     frameIndex += 1;
-    const count = formatProgressCount(current, total);
-    write(`${CLEAR_LINE}${action} project index... ${frame}${count}`);
+    const count = hasProgressCount(mode, current, total) ? formatProgressCount(current, total) : "";
+    write(`${CLEAR_LINE}${activity}... ${frame}${count}`);
     rendered = true;
   };
   const stopInterval = () => {
@@ -1216,6 +1216,7 @@ function createInteractiveProgressDisplay(write, delayMs = 0) {
     current = update.current;
     total = update.total;
     mode = update.mode ?? "build";
+    activity = update.activity ?? `${progressAction(mode)} project index`;
     const beginRendering = () => {
       if (!active)
         return;
@@ -1262,6 +1263,8 @@ function createInteractiveProgressDisplay(write, delayMs = 0) {
       current = update.current;
       total = update.total;
       mode = update.mode ?? mode;
+      if (update.activity !== void 0)
+        activity = update.activity;
     },
     clear,
     dispose: () => {
@@ -1281,12 +1284,16 @@ function formatProgressCount(current, total) {
     return ` ${current}/${formatFileCount(total)}`;
   return ` ${formatFileCount(current)} processed`;
 }
+function hasProgressCount(mode, current, total) {
+  return mode !== "check" || current > 0 || total > 0;
+}
 function createLogProgressDisplay(write, delayMs = 0) {
   let active = false;
   let rendered = false;
   let current = 0;
   let total = 0;
   let mode = "build";
+  let activity = progressAction(mode);
   let delay;
   let heartbeat;
   const stopTimers = () => {
@@ -1303,12 +1310,13 @@ function createLogProgressDisplay(write, delayMs = 0) {
     if (!active || rendered)
       return;
     rendered = true;
-    write(`[Progress] ${progressAction(mode)} project index.
+    write(`[Progress] ${activity}.
 `);
     heartbeat = setInterval(() => {
       if (!active)
         return;
-      write(`[Progress] ${progressAction(mode)} project index:${formatProgressCount(current, total)}.
+      const count = hasProgressCount(mode, current, total) ? `:${formatProgressCount(current, total)}` : "";
+      write(`[Progress] ${activity}${count}.
 `);
     }, 1e3);
     heartbeat.unref();
@@ -1320,6 +1328,7 @@ function createLogProgressDisplay(write, delayMs = 0) {
     current = update.current;
     total = update.total;
     mode = update.mode ?? "build";
+    activity = update.activity ?? `${progressAction(mode)} project index`;
     if (delayMs) {
       delay = setTimeout(renderStart, delayMs);
       delay.unref();
@@ -1351,13 +1360,25 @@ function createLogProgressDisplay(write, delayMs = 0) {
           return;
         start(update);
       }
+      const previousActivity = activity;
       current = update.current;
       total = update.total;
       mode = update.mode ?? mode;
+      if (update.activity !== void 0)
+        activity = update.activity;
+      if (rendered && activity !== previousActivity) {
+        write(`[Progress] ${activity}.
+`);
+      }
       const isComplete = update.total > 0 && update.current >= update.total;
-      if (rendered && (update.current === 1 || isComplete || update.current % 100 === 0)) {
-        write(`[Progress] ${formatFileCount(update.current)} processed.
+      if (rendered && (update.current === 1 || isComplete || update.current > 0 && update.current % 100 === 0)) {
+        if (update.activity !== void 0) {
+          write(`[Progress] ${activity}:${formatProgressCount(update.current, update.total)}.
 `);
+        } else {
+          write(`[Progress] ${formatFileCount(update.current)} processed.
+`);
+        }
       }
     },
     clear: () => {
@@ -14125,6 +14146,15 @@ __export(projectFiles_exports, {
 import fs6 from "node:fs";
 import fsp5 from "node:fs/promises";
 import path9 from "node:path";
+function createPathCheckProgressReporter(total, onProgress) {
+  onProgress?.(0, total);
+  let completed = 0;
+  return () => {
+    completed += 1;
+    if (completed === total || completed % 100 === 0)
+      onProgress?.(completed, total);
+  };
+}
 function isPresent(value) {
   return value !== void 0;
 }
@@ -14476,11 +14506,14 @@ async function listProjectFilesInternal(projectRoot, patterns = DEFAULT_PROJECT_
       followSymbolicLinks: false,
       ignore: translatedUserIgnoreGlobs
     }) : [];
+    const reportSourceSymlinkChecks = options?.onDiscoveryProgress ? (current, total) => options.onDiscoveryProgress?.({ activity: "Checking source symlinks", current, total }) : void 0;
+    const reportSourcePathChecks = options?.onDiscoveryProgress ? (current, total) => options.onDiscoveryProgress?.({ activity: "Checking source file paths", current, total }) : void 0;
     const symlinkOptions = {
       globRoot,
       ...gitCandidates ? { candidatePaths: gitCandidates.files } : {},
       ...options?.knownSymlinkDirectories !== void 0 ? { knownSymlinkDirectories: options.knownSymlinkDirectories } : {},
-      ...options?.onSymlinkDirectoriesDiscovered ? { onSymlinkDirectoriesDiscovered: options.onSymlinkDirectoriesDiscovered } : {}
+      ...options?.onSymlinkDirectoriesDiscovered ? { onSymlinkDirectoriesDiscovered: options.onSymlinkDirectoriesDiscovered } : {},
+      ...reportSourceSymlinkChecks ? { onPathCheckProgress: reportSourceSymlinkChecks } : {}
     };
     const safeSymlinkDirectories = await resolveSafeSymlinkDirectories(root, realRoot, symlinkProbeIgnoreGlobs, symlinkOptions);
     const linkedFiles = await listEntriesFromSafeSymlinkDirectories(root, realRoot, patterns, fastGlobIgnoreGlobs, {
@@ -14493,7 +14526,7 @@ async function listProjectFilesInternal(projectRoot, patterns = DEFAULT_PROJECT_
       filterIgnoreGlobs: userIgnoreGlobs,
       resolvedSafeSymlinkDirectories: safeSymlinkDirectories
     });
-    const rootSafeFiles = await filterRealPathsWithinRootEntries([...files, ...includedOverrideFiles, ...linkedFiles, ...linkedOverrideFiles], realRoot);
+    const rootSafeFiles = await filterRealPathsWithinRootEntries([...files, ...includedOverrideFiles, ...linkedFiles, ...linkedOverrideFiles], realRoot, reportSourcePathChecks);
     const seen = /* @__PURE__ */ new Set();
     return rootSafeFiles.map(({ path: filePath, realPath }) => ({ filePath: normalizePath(filePath), realPath })).filter(({ filePath, realPath }) => {
       if (seen.has(filePath))
@@ -14561,10 +14594,20 @@ async function isSafeSymlinkDirectory(root, linkPath, realRoot) {
     return false;
   }
 }
+async function verifySafeSymlinkDirectories(root, realRoot, paths, onPathCheckProgress) {
+  const reportPathCheck = createPathCheckProgressReporter(paths.length, onPathCheckProgress);
+  const verified = await mapLimitSemaphore(Array.from(paths), REALPATH_FILTER_CONCURRENCY, async (linkPath) => {
+    try {
+      return await isSafeSymlinkDirectory(root, linkPath, realRoot) ? linkPath : null;
+    } finally {
+      reportPathCheck();
+    }
+  });
+  return verified.filter((entry) => entry !== null);
+}
 async function resolveSafeSymlinkDirectories(root, realRoot, ignore, options) {
   if (options.knownSymlinkDirectories !== void 0) {
-    const verified = await mapLimitSemaphore(Array.from(new Set(options.knownSymlinkDirectories)), REALPATH_FILTER_CONCURRENCY, async (linkPath) => await isSafeSymlinkDirectory(root, linkPath, realRoot) ? linkPath : null);
-    const resolved = verified.filter((entry) => entry !== null);
+    const resolved = await verifySafeSymlinkDirectories(root, realRoot, Array.from(new Set(options.knownSymlinkDirectories)), options.onPathCheckProgress);
     options.onSymlinkDirectoriesDiscovered?.(resolved, "known");
     return resolved;
   }
@@ -14576,8 +14619,7 @@ async function resolveSafeSymlinkDirectories(root, realRoot, ignore, options) {
         return false;
       return !ignoreMatchers.some((matcher) => matcher(relativePath3));
     });
-    const verified = await mapLimitSemaphore(candidatePaths, REALPATH_FILTER_CONCURRENCY, async (linkPath) => await isSafeSymlinkDirectory(root, linkPath, realRoot) ? linkPath : null);
-    const discovered2 = verified.filter((entry) => entry !== null);
+    const discovered2 = await verifySafeSymlinkDirectories(root, realRoot, candidatePaths, options.onPathCheckProgress);
     options.onSymlinkDirectoriesDiscovered?.(discovered2, "git-candidates");
     return discovered2;
   }
@@ -14590,8 +14632,7 @@ async function resolveSafeSymlinkDirectories(root, realRoot, ignore, options) {
     objectMode: true,
     ignore
   });
-  const candidates = await mapLimitSemaphore(entries.filter((entry) => entry.dirent.isSymbolicLink()).map((entry) => entry.path), REALPATH_FILTER_CONCURRENCY, async (linkPath) => await isSafeSymlinkDirectory(root, linkPath, realRoot) ? linkPath : null);
-  const discovered = candidates.filter((entry) => entry !== null);
+  const discovered = await verifySafeSymlinkDirectories(root, realRoot, entries.filter((entry) => entry.dirent.isSymbolicLink()).map((entry) => entry.path), options.onPathCheckProgress);
   options.onSymlinkDirectoriesDiscovered?.(discovered, "filesystem");
   return discovered;
 }
@@ -14623,19 +14664,22 @@ async function listEntriesFromSafeSymlinkDirectories(root, realRoot, patterns, i
   }
   return [...filesByPath.values()];
 }
-async function filterRealPathsWithinRootEntries(paths, realRoot) {
+async function filterRealPathsWithinRootEntries(paths, realRoot, onPathCheckProgress) {
+  const reportPathCheck = createPathCheckProgressReporter(paths.length, onPathCheckProgress);
   const filtered = await mapLimitSemaphore(paths, REALPATH_FILTER_CONCURRENCY, async (filePath) => {
     try {
       const realPath = await fsp5.realpath(filePath);
       return isFilePathWithinRoot(realRoot, realPath) ? { path: filePath, realPath } : null;
     } catch {
       return null;
+    } finally {
+      reportPathCheck();
     }
   });
   return filtered.filter((entry) => entry !== null);
 }
-async function filterRealPathsWithinRoot(paths, realRoot) {
-  const entries = await filterRealPathsWithinRootEntries(paths, realRoot);
+async function filterRealPathsWithinRoot(paths, realRoot, onPathCheckProgress) {
+  const entries = await filterRealPathsWithinRootEntries(paths, realRoot, onPathCheckProgress);
   return entries.map((entry) => entry.path);
 }
 function toProjectGlob(pattern) {
@@ -14694,6 +14738,9 @@ async function discoverProjectFilesInternal(projectRoot, options) {
       gitCandidates = await listGitCandidateFiles(root, options?.logLevel);
     }
     options?.onGitCandidatesDiscovered?.(gitCandidates);
+    const reportMetadataSymlinkChecks = options?.onDiscoveryProgress ? (current, total) => options.onDiscoveryProgress?.({ activity: "Checking project metadata symlinks", current, total }) : void 0;
+    const reportMetadataFileChecks = options?.onDiscoveryProgress ? (current, total) => options.onDiscoveryProgress?.({ activity: "Checking project metadata files", current, total }) : void 0;
+    const reportMetadataDirectoryChecks = options?.onDiscoveryProgress ? (current, total) => options.onDiscoveryProgress?.({ activity: "Checking project metadata directories", current, total }) : void 0;
     let rootSafeMatches;
     if (gitCandidates) {
       const gitignoreIndex = await buildGitignoreIndex(gitCandidates.gitignoreFiles, gitCandidates.gitignoreRoots, gitCandidates.gitignoreAliases);
@@ -14712,7 +14759,8 @@ async function discoverProjectFilesInternal(projectRoot, options) {
       const symlinkOptions = {
         candidatePaths: gitCandidates.files,
         ...options?.knownSymlinkDirectories !== void 0 ? { knownSymlinkDirectories: options.knownSymlinkDirectories } : {},
-        ...options?.onSymlinkDirectoriesDiscovered ? { onSymlinkDirectoriesDiscovered: options.onSymlinkDirectoriesDiscovered } : {}
+        ...options?.onSymlinkDirectoriesDiscovered ? { onSymlinkDirectoriesDiscovered: options.onSymlinkDirectoriesDiscovered } : {},
+        ...reportMetadataSymlinkChecks ? { onPathCheckProgress: reportMetadataSymlinkChecks } : {}
       };
       const safeSymlinkDirectories = await resolveSafeSymlinkDirectories(root, realRoot, DEFAULT_PROJECT_FILE_IGNORES, symlinkOptions);
       const allPatterns = PROJECT_FILE_DEFINITIONS.flatMap((definition) => definition.patterns.map(toProjectGlob));
@@ -14721,18 +14769,18 @@ async function discoverProjectFilesInternal(projectRoot, options) {
         onlyFiles: false,
         resolvedSafeSymlinkDirectories: safeSymlinkDirectories
       });
-      const rootSafeCandidateEntries = await filterRealPathsWithinRootEntries(gitCandidates.files, realRoot);
+      const rootSafeCandidateEntries = await filterRealPathsWithinRootEntries(gitCandidates.files, realRoot, reportMetadataFileChecks);
       const filteredFiles = filterGitIgnoredEntries(rootSafeCandidateEntries);
       const fileMatches = filteredFiles.filter((file2) => PROJECT_FILE_DEFINITIONS.some((definition, definitionIndex) => definition.kind === "file" && matchesDefinition(path9.basename(file2), definitionIndex)));
       const rawCandidateDirectories = collectCandidateAncestorDirectories(root, rootSafeCandidateEntries.map(({ path: filePath }) => filePath));
       const candidateDirectoryKeys = new Set(rawCandidateDirectories.map(fileIdentityKey));
       const safeSymlinkDirectoryKeys = new Set(safeSymlinkDirectories.map(fileIdentityKey));
       const directoryMatches = [
-        ...filterGitIgnoredEntries(await filterRealPathsWithinRootEntries(rawCandidateDirectories, realRoot), candidateDirectoryKeys),
-        ...filterGitIgnoredEntries(await filterRealPathsWithinRootEntries(safeSymlinkDirectories, realRoot), safeSymlinkDirectoryKeys)
+        ...filterGitIgnoredEntries(await filterRealPathsWithinRootEntries(rawCandidateDirectories, realRoot, reportMetadataDirectoryChecks), candidateDirectoryKeys),
+        ...filterGitIgnoredEntries(await filterRealPathsWithinRootEntries(safeSymlinkDirectories, realRoot, reportMetadataDirectoryChecks), safeSymlinkDirectoryKeys)
       ].filter((directory) => PROJECT_FILE_DEFINITIONS.some((definition, definitionIndex) => definition.kind === "dir" && matchesDefinition(path9.basename(directory), definitionIndex)));
       const linkedDirectoryKeys = new Set(linkedMatches.filter((match) => match.endsWith("/")).map((match) => fileIdentityKey(match.slice(0, -1))));
-      const rootSafeLinked = filterGitIgnoredEntries(await filterRealPathsWithinRootEntries(linkedMatches.map((match) => match.endsWith("/") ? match.slice(0, -1) : match), realRoot), linkedDirectoryKeys);
+      const rootSafeLinked = filterGitIgnoredEntries(await filterRealPathsWithinRootEntries(linkedMatches.map((match) => match.endsWith("/") ? match.slice(0, -1) : match), realRoot, reportMetadataFileChecks), linkedDirectoryKeys);
       rootSafeMatches = [...fileMatches, ...directoryMatches, ...rootSafeLinked];
     } else {
       const allPatterns = PROJECT_FILE_DEFINITIONS.flatMap((definition) => definition.patterns.map(toProjectGlob));
@@ -14749,9 +14797,10 @@ async function discoverProjectFilesInternal(projectRoot, options) {
         markDirectories: true,
         onlyFiles: false,
         ...options?.knownSymlinkDirectories !== void 0 ? { knownSymlinkDirectories: options.knownSymlinkDirectories } : {},
-        ...options?.onSymlinkDirectoriesDiscovered ? { onSymlinkDirectoriesDiscovered: options.onSymlinkDirectoriesDiscovered } : {}
+        ...options?.onSymlinkDirectoriesDiscovered ? { onSymlinkDirectoriesDiscovered: options.onSymlinkDirectoriesDiscovered } : {},
+        ...reportMetadataSymlinkChecks ? { onPathCheckProgress: reportMetadataSymlinkChecks } : {}
       });
-      rootSafeMatches = await filterRealPathsWithinRoot([...matches, ...linkedMatches].map((match) => match.endsWith("/") ? match.slice(0, -1) : match), realRoot);
+      rootSafeMatches = await filterRealPathsWithinRoot([...matches, ...linkedMatches].map((match) => match.endsWith("/") ? match.slice(0, -1) : match), realRoot, reportMetadataFileChecks);
     }
     const entries = [];
     const matchTasks = rootSafeMatches.map(async (cleanMatch) => {
@@ -55234,6 +55283,17 @@ function emitIndexLifecycleProgress(opts, phase, mode, total, elapsedMs2) {
     ...elapsedMs2 !== void 0 ? { elapsedMs: elapsedMs2 } : {}
   });
 }
+function emitIndexCheckActivity(opts, activity, current = 0, total = 0) {
+  opts?.onProgress?.({
+    type: "progress",
+    phase: "update",
+    mode: "check",
+    message: activity,
+    activity,
+    current,
+    total
+  });
+}
 function buildConcurrency(opts) {
   return resolveWorkerThreadCount({ requested: Number(opts?.threads || 0), defaultCount: 8, max: 64 });
 }
@@ -55654,12 +55714,16 @@ async function buildProjectIndexWithManifestOptions(projectRoot, opts, helperOpt
     const onGitCandidatesDiscovered = (candidates) => {
       discoveredGitCandidates = candidates;
     };
+    const onDiscoveryProgress = helperOpts?.reportDiscoveryProgress ? (progress) => emitIndexCheckActivity(opts, progress.activity, progress.current, progress.total) : void 0;
+    if (helperOpts?.reportDiscoveryProgress)
+      emitIndexCheckActivity(opts, "Discovering source files");
     const discoveredFiles = await listProjectFilesWithGitCandidates(projectRoot, projectPatternsForLanguageExtensions(opts), {
       ...opts?.discovery,
       ...opts?.logLevel ? { logLevel: opts.logLevel } : {},
       ...knownSymlinkDirectories !== void 0 ? { knownSymlinkDirectories } : {},
       onSymlinkDirectoriesDiscovered,
-      onGitCandidatesDiscovered
+      onGitCandidatesDiscovered,
+      ...onDiscoveryProgress ? { onDiscoveryProgress } : {}
     });
     const additionalFileCandidates = await normalizeIndexedFileInputsWithinRoot(projectRoot, opts?.additionalFiles ?? [], "Additional index file");
     const additionalFileExistence = await probePathExistence(additionalFileCandidates, buildConcurrency(opts));
@@ -55667,10 +55731,13 @@ async function buildProjectIndexWithManifestOptions(projectRoot, opts, helperOpt
     const discoveredFileSet = new Set(discoveredFiles);
     const files = Array.from(/* @__PURE__ */ new Set([...discoveredFiles, ...additionalFiles]));
     const transientFiles = additionalFiles.filter((file2) => !discoveredFileSet.has(file2));
+    if (helperOpts?.reportDiscoveryProgress)
+      emitIndexCheckActivity(opts, "Discovering project metadata");
     const projectFiles = await discoverProjectFilesWithGitCandidates(projectRoot, {
       ...opts?.logLevel ? { logLevel: opts.logLevel } : {},
       ...discoveredSymlinkDirectories !== void 0 ? { knownSymlinkDirectories: discoveredSymlinkDirectories } : {},
-      ...discoveredGitCandidates !== void 0 ? { knownGitCandidates: discoveredGitCandidates } : {}
+      ...discoveredGitCandidates !== void 0 ? { knownGitCandidates: discoveredGitCandidates } : {},
+      ...onDiscoveryProgress ? { onDiscoveryProgress } : {}
     });
     return await buildIndexFromFileListShared(projectRoot, files, opts, {
       manifestMode: useDiskCache ? "read-write" : "off",
@@ -55810,7 +55877,10 @@ async function buildProjectIndexIncremental(projectRoot, opts) {
         manifestReport.reason = reason;
         manifestReport.reused = false;
       }
-      return await buildProjectIndexFromExport(projectRoot, opts, { ignoreExistingManifest: true });
+      return await buildProjectIndexFromExport(projectRoot, opts, {
+        ignoreExistingManifest: true,
+        reportDiscoveryProgress: true
+      });
     }
     const gitAvailable = await isGitRepo(projectRoot);
     const hasExplicitGitRange = !!opts?.gitBase || !!opts?.gitHead;
@@ -55831,7 +55901,10 @@ async function buildProjectIndexIncremental(projectRoot, opts) {
           manifestReport.reused = false;
         }
         logWithLevel(opts?.logLevel, "warn", "Warning: Manifest commit is no longer available; rebuilding full index.");
-        const rebuiltIndex = await buildProjectIndexFromExport(projectRoot, opts, { ignoreExistingManifest: true });
+        const rebuiltIndex = await buildProjectIndexFromExport(projectRoot, opts, {
+          ignoreExistingManifest: true,
+          reportDiscoveryProgress: true
+        });
         if (manifestReport) {
           manifestReport.reason = "staleGitCommit";
           manifestReport.reused = false;
@@ -55849,7 +55922,10 @@ async function buildProjectIndexIncremental(projectRoot, opts) {
       }
       if (mismatches > 0 || missing > 0) {
         logWithLevel(opts?.logLevel, "warn", `Warning: Manifest verification failed (mismatches: ${mismatches}, missing: ${missing}). Rebuilding full index.`);
-        return await buildProjectIndexFromExport(projectRoot, opts, { ignoreExistingManifest: true });
+        return await buildProjectIndexFromExport(projectRoot, opts, {
+          ignoreExistingManifest: true,
+          reportDiscoveryProgress: true
+        });
       }
     }
     const trackedEntries = sanitizeManifestEntriesForRoot(projectRoot, manifest.files);
@@ -55874,7 +55950,10 @@ async function buildProjectIndexIncremental(projectRoot, opts) {
           manifestReport.reused = false;
         }
         logWithLevel(opts?.logLevel, "warn", "Warning: Failed to list untracked project files via Git; rebuilding full index.", error51);
-        return await buildProjectIndexFromExport(projectRoot, opts, { ignoreExistingManifest: true });
+        return await buildProjectIndexFromExport(projectRoot, opts, {
+          ignoreExistingManifest: true,
+          reportDiscoveryProgress: true
+        });
       }
     } else if (!opts?.filesAreProjectScope) {
       rediscoveredFiles = await listProjectFilesWithGitCandidates(projectRoot, projectPatternsForLanguageExtensions(opts), {
@@ -76764,11 +76843,7 @@ var init_commandCatalog = __esm({
     "use strict";
     CLI_COMMAND_CATALOG = [
       { name: "orient", summary: "Build a compact first-turn packet for agent repo context", family: "start" },
-      {
-        name: "explore",
-        summary: "Answer a broad repo question with search, packets, paths, and blast radius",
-        family: "start"
-      },
+      { name: "explore", summary: "Derive context from one hybrid search", family: "search" },
       { name: "file", summary: "Read a live project file with bounded line pagination", family: "navigate" },
       { name: "review", summary: "Generate code review report", family: "review" },
       { name: "packet", summary: "Retrieve bounded evidence packets by file path or stable target", family: "navigate" },
@@ -77130,13 +77205,14 @@ Safety:
   Supports shared --cache, --cache-dir, --cache-strict, --cache-verify, --threads, --native, --workers, --include-glob, --ignore-glob, and --no-gitignore options.
   Cache precedence is --cache-dir, then CODEGRAPH_CACHE_DIR, then cache.location from project/user config, then repository metadata, then the project root. Use cache.location "project", "repo", "user", or an absolute path. A configured anchor that resolves to the home directory or a filesystem root is rejected with an error.
   Index builds report progress automatically on an interactive stderr terminal. Use --progress to force redirected progress logs or --no-progress to suppress feedback.`;
-    EXPLORE_HELP_TEXT = `codegraph explore - Answer a broad repo question with bounded repo context
+    EXPLORE_HELP_TEXT = `codegraph explore - Derive context from one hybrid search
 
 Usage: codegraph explore "<query>" [--root <path>] [--limit <n>] [--max-packets <n>] [--max-paths <n>] [--no-source] [--include-graph-context] [--allow-sensitive] [--json | --pretty]
 
 Output:
-  Explore orchestrates search, packet retrieval, dependency paths, reverse dependencies, candidate tests, and follow-up commands. An exact file-path query also includes the live bounded file view.
-  Pretty model-readable sections are the default. Use --json for structured fields. Graph context and raw sensitive values require explicit flags.
+  One hybrid search plus context from top results.
+  Not a first step: \`codegraph orient\`, \`codegraph search\`/\`codegraph grep\`, then \`codegraph refs\`/\`codegraph callers\`. Use explore only for context from a narrow query.
+  \`analysis\` is parser backend quality, not query reasoning.
 
 ${SHARED_INDEX_OPTIONS_HELP}
 `;
@@ -100407,7 +100483,7 @@ var init_tools = __esm({
       },
       {
         name: "explore",
-        description: "Recommended first tool for broad repo questions; returns bounded anchors, source packets, paths, blast radius, tests, and follow-ups.",
+        description: "One hybrid search plus context from top results. Not a first step; use refs or calls for known symbols.",
         inputSchema: objectSchema({
           query: stringProperty,
           limit: { type: "integer", minimum: 0, maximum: 50, default: 5 },

package/dist/cli/commandCatalog.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"commandCatalog.d.ts","sourceRoot":"","sources":["../../src/cli/commandCatalog.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,gBAAgB,GAAG,OAAO,GAAG,QAAQ,GAAG,UAAU,GAAG,QAAQ,GAAG,OAAO,GAAG,QAAQ,CAAC;AAE/F,MAAM,MAAM,kBAAkB,GAAG;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,gBAAgB,CAAC;IACzB,OAAO,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CAC7B,CAAC;AAEF,eAAO,MAAM,mBAAmB,EAAE,SAAS,kBAAkB,EA2D5D,CAAC;AAOF,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAGrE;AAED,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAE1D;AAgBD,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,GAAE,MAAU,GAAG,MAAM,EAAE,CAW7E;AASD,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAEnE;AAYD,wBAAgB,oBAAoB,CAAC,QAAQ,GAAE,OAAe,GAAG,MAAM,CAMtE"}
+{"version":3,"file":"commandCatalog.d.ts","sourceRoot":"","sources":["../../src/cli/commandCatalog.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,gBAAgB,GAAG,OAAO,GAAG,QAAQ,GAAG,UAAU,GAAG,QAAQ,GAAG,OAAO,GAAG,QAAQ,CAAC;AAE/F,MAAM,MAAM,kBAAkB,GAAG;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,gBAAgB,CAAC;IACzB,OAAO,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CAC7B,CAAC;AAEF,eAAO,MAAM,mBAAmB,EAAE,SAAS,kBAAkB,EAuD5D,CAAC;AAOF,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAGrE;AAED,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAE1D;AAgBD,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,GAAE,MAAU,GAAG,MAAM,EAAE,CAW7E;AASD,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAEnE;AAYD,wBAAgB,oBAAoB,CAAC,QAAQ,GAAE,OAAe,GAAG,MAAM,CAMtE"}

package/dist/cli/commandCatalog.js

@@ -1,10 +1,6 @@
 export const CLI_COMMAND_CATALOG = [
     { name: "orient", summary: "Build a compact first-turn packet for agent repo context", family: "start" },
-    {
-        name: "explore",
-        summary: "Answer a broad repo question with search, packets, paths, and blast radius",
-        family: "start",
-    },
+    { name: "explore", summary: "Derive context from one hybrid search", family: "search" },
     { name: "file", summary: "Read a live project file with bounded line pagination", family: "navigate" },
     { name: "review", summary: "Generate code review report", family: "review" },
     { name: "packet", summary: "Retrieve bounded evidence packets by file path or stable target", family: "navigate" },

package/dist/cli/commandCatalog.js.map

@@ -1 +1 @@
-{"version":3,"file":"commandCatalog.js","sourceRoot":"","sources":["../../src/cli/commandCatalog.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"commandCatalog.js","sourceRoot":"","sources":["../../src/cli/commandCatalog.ts"],"names":[],"mappings":"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"}

package/dist/cli/help.d.ts

@@ -6,7 +6,7 @@ export declare const LIFECYCLE_HELP_TEXT = "codegraph init/status/sync/uninit -
 export declare const AFFECTED_HELP_TEXT = "codegraph affected - List tests likely affected by changed files\n\nUsage:\n  codegraph affected [file...] [--stdin] [--base <ref> --head <ref>] [--root <path>] [--depth <n>] [--filter <glob>] [--json | --quiet]\n\nOptions:\n  --depth <n>       Reverse dependency traversal depth (default: 1)\n  --filter <glob>   Restrict returned test files by project-root-relative glob\n  --stdin           Read newline-delimited changed files from stdin\n  --quiet           Print affected test paths only\n";
 export declare const INSTALL_HELP_TEXT = "codegraph install - Configure Codegraph for supported agent clients\n\nUsage: codegraph install [target] [--target <codex,claude,cursor,gemini,opencode,omp,kilo,agents> | --all] [--yes | --dry-run] [--force] [--json | --pretty] [--print-config <target>] [--detect]\n\nTargets:\n  codex, claude, cursor, gemini, opencode, omp, kilo, agents\n  --all selects the full catalog in the listed order without detection.\n\nSafety:\n  Interactive terminals preview changes and ask for confirmation. Noninteractive writes require --yes; use --dry-run to preview changed files or --print-config <target> to print the MCP snippet.\n  --force overwrites conflicting skill or config files the installer refuses to clobber by default; collision errors tell you to re-run with --force.\n  --all cannot be combined with a target, --detect, or --print-config.\n";
 export declare const UNINSTALL_HELP_TEXT = "codegraph uninstall - Remove Codegraph-owned installer configuration\n\nUsage: codegraph uninstall [target] [--target <codex,claude,cursor,gemini,opencode,omp,kilo,agents>] [--yes | --dry-run] [--json | --pretty] [--detect]\n\nSafety:\n  Removes only Codegraph-owned marker blocks, marker files, exact bundled skill payloads, or exact installer-owned MCP entries.\n";
-export declare const EXPLORE_HELP_TEXT = "codegraph explore - Answer a broad repo question with bounded repo context\n\nUsage: codegraph explore \"<query>\" [--root <path>] [--limit <n>] [--max-packets <n>] [--max-paths <n>] [--no-source] [--include-graph-context] [--allow-sensitive] [--json | --pretty]\n\nOutput:\n  Explore orchestrates search, packet retrieval, dependency paths, reverse dependencies, candidate tests, and follow-up commands. An exact file-path query also includes the live bounded file view.\n  Pretty model-readable sections are the default. Use --json for structured fields. Graph context and raw sensitive values require explicit flags.\n\nIndex options:\n  Supports shared --cache, --cache-dir, --cache-strict, --cache-verify, --threads, --native, --workers, --include-glob, --ignore-glob, and --no-gitignore options.\n  Cache precedence is --cache-dir, then CODEGRAPH_CACHE_DIR, then cache.location from project/user config, then repository metadata, then the project root. Use cache.location \"project\", \"repo\", \"user\", or an absolute path. A configured anchor that resolves to the home directory or a filesystem root is rejected with an error.\n  Index builds report progress automatically on an interactive stderr terminal. Use --progress to force redirected progress logs or --no-progress to suppress feedback.\n";
+export declare const EXPLORE_HELP_TEXT = "codegraph explore - Derive context from one hybrid search\n\nUsage: codegraph explore \"<query>\" [--root <path>] [--limit <n>] [--max-packets <n>] [--max-paths <n>] [--no-source] [--include-graph-context] [--allow-sensitive] [--json | --pretty]\n\nOutput:\n  One hybrid search plus context from top results.\n  Not a first step: `codegraph orient`, `codegraph search`/`codegraph grep`, then `codegraph refs`/`codegraph callers`. Use explore only for context from a narrow query.\n  `analysis` is parser backend quality, not query reasoning.\n\nIndex options:\n  Supports shared --cache, --cache-dir, --cache-strict, --cache-verify, --threads, --native, --workers, --include-glob, --ignore-glob, and --no-gitignore options.\n  Cache precedence is --cache-dir, then CODEGRAPH_CACHE_DIR, then cache.location from project/user config, then repository metadata, then the project root. Use cache.location \"project\", \"repo\", \"user\", or an absolute path. A configured anchor that resolves to the home directory or a filesystem root is rejected with an error.\n  Index builds report progress automatically on an interactive stderr terminal. Use --progress to force redirected progress logs or --no-progress to suppress feedback.\n";
 export declare const FILE_HELP_TEXT = "codegraph file - Read a live project file with bounded line pagination\n\nUsage: codegraph file <path> [--root <path>] [--offset <line>] [--limit <lines>] [--max-bytes <bytes>] [--include-graph-context] [--allow-sensitive] [--json | --pretty]\n\nOutput:\n  Pretty output is the default and uses exact number<TAB>line source lines plus bounded graph context when requested. Use --json for structured fields.\n  A file-ending newline is represented as a final numbered empty line. Follow page.nextOffset or the pretty next-page command for more lines.\n\nSafety:\n  Paths are confined to --root after realpath resolution. Binary files are rejected. Known sensitive text configs return structural key summaries; key material returns metadata only. Use --allow-sensitive for raw access subject to binary and UTF-8 guards.\n";
 export declare const SEARCH_HELP_TEXT = "codegraph search - Ranked agent search across project context\n\nUsage: codegraph search \"<query>\" [--root <path>] [--mode hybrid|symbol|path|text|graph|sql] [--limit <n>] [--from <file|handle>] [--depth <n>] [--no-snippets] [--report [--report-file <path>]] [--json | --pretty]\n\nSearch Modes:\n  hybrid   Rank across files, symbols, chunks, SQL, and graph context\n  symbol   Prefer indexed symbols and stable symbol handles\n  path     Prefer file paths\n  text     Prefer text/snippet matches\n  graph    Prefer graph neighborhoods\n  sql      Prefer SQL object context\n\nOutput:\n  Results include top-level analysis metadata plus stable handles, rank reasons, provenance, evidence, graph neighbors, follow-up commands, limits, and omission counts.\n  Hybrid search is code-first by default: source files and symbols outrank docs unless you use text mode or the docs are the strongest remaining evidence.\n  --report writes command and index timings to stderr; --report-file writes the same JSON report to a file without changing search output.\n\nIndex options:\n  Supports shared --cache, --cache-dir, --cache-strict, --cache-verify, --threads, --native, --workers, --include-glob, --ignore-glob, and --no-gitignore options.\n  Cache precedence is --cache-dir, then CODEGRAPH_CACHE_DIR, then cache.location from project/user config, then repository metadata, then the project root. Use cache.location \"project\", \"repo\", \"user\", or an absolute path. A configured anchor that resolves to the home directory or a filesystem root is rejected with an error.\n  Index builds report progress automatically on an interactive stderr terminal. Use --progress to force redirected progress logs or --no-progress to suppress feedback.\n";
 export declare const GOTO_HELP_TEXT = "codegraph goto - Go to a definition\n\nUsage: codegraph goto <file|file::symbol|symbol:...> [--root <path>] [--json | --pretty]\n       codegraph goto <file>[:line[:column]] [line] [column] [--root <path>] [--json | --pretty]\n\nA qualified symbol path or portable symbol handle resolves one definition without a location. A file-only target succeeds when the file defines one symbol; otherwise JSON returns bounded candidates. Search-result locations and portable symbol handles can be pasted directly.\n\nIndex options:\n  Supports shared --cache, --cache-dir, --cache-strict, --cache-verify, --threads, --native, --workers, --include-glob, --ignore-glob, and --no-gitignore options.\n  Cache precedence is --cache-dir, then CODEGRAPH_CACHE_DIR, then cache.location from project/user config, then repository metadata, then the project root. Use cache.location \"project\", \"repo\", \"user\", or an absolute path. A configured anchor that resolves to the home directory or a filesystem root is rejected with an error.\n  Index builds report progress automatically on an interactive stderr terminal. Use --progress to force redirected progress logs or --no-progress to suppress feedback.\n";

package/dist/cli/help.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"help.d.ts","sourceRoot":"","sources":["../../src/cli/help.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAExD,eAAO,MAAM,kBAAkB,ydASQ,CAAC;AAExC,eAAO,MAAM,aAAa,QAkHzB,CAAC;AACF,eAAO,MAAM,kBAAkB,QAI9B,CAAC;AAEF,eAAO,MAAM,mBAAmB,miDAiB/B,CAAC;AAEF,eAAO,MAAM,kBAAkB,ofAU9B,CAAC;AAEF,eAAO,MAAM,iBAAiB,g1BAY7B,CAAC;AAEF,eAAO,MAAM,mBAAmB,kXAM/B,CAAC;AAMF,eAAO,MAAM,iBAAiB,+xCAS7B,CAAC;AAEF,eAAO,MAAM,cAAc,wzBAU1B,CAAC;AAEF,eAAO,MAAM,gBAAgB,itDAkB5B,CAAC;AAEF,eAAO,MAAM,cAAc,2qCAQ1B,CAAC;AAEF,eAAO,MAAM,cAAc,usCAS1B,CAAC;AAEF,eAAO,MAAM,cAAc,4yBAO1B,CAAC;AAEF,eAAO,MAAM,aAAa,yNAIzB,CAAC;AAEF,eAAO,MAAM,iBAAiB,y6CAY7B,CAAC;AAEF,eAAO,MAAM,iBAAiB,skCAO7B,CAAC;AAEF,eAAO,MAAM,iBAAiB,skCAO7B,CAAC;AAEF,eAAO,MAAM,oBAAoB,q/BAOhC,CAAC;AAEF,eAAO,MAAM,kBAAkB,++BAO9B,CAAC;AAEF,eAAO,MAAM,yBAAyB,oiCAOrC,CAAC;AAEF,eAAO,MAAM,wBAAwB,qyCASpC,CAAC;AAEF,eAAO,MAAM,uBAAuB,+4CASnC,CAAC;AAEF,eAAO,MAAM,gBAAgB,i2CAS5B,CAAC;AAEF,eAAO,MAAM,gBAAgB,y8CAgB5B,CAAC;AAEF,eAAO,MAAM,iBAAiB,g/CAW7B,CAAC;AAEF,eAAO,MAAM,kBAAkB,+3CAgB9B,CAAC;AAEF,eAAO,MAAM,gBAAgB,2jDAkB5B,CAAC;AAEF,eAAO,MAAM,aAAa,g2CAwBzB,CAAC;AAEF,eAAO,MAAM,mBAAmB,i4EAwC/B,CAAC;AAEF,eAAO,MAAM,oBAAoB,k8FAwChC,CAAC;AAEF,eAAO,MAAM,eAAe,qrCAe3B,CAAC;AAEF,eAAO,MAAM,gBAAgB,qgCAc5B,CAAC;AAEF,eAAO,MAAM,eAAe,2jCAQ3B,CAAC;AAEF,eAAO,MAAM,eAAe,mmCAQ3B,CAAC;AAEF,eAAO,MAAM,gBAAgB,qnDAiB5B,CAAC;AAEF,eAAO,MAAM,gBAAgB,o9BAQ5B,CAAC;AAEF,eAAO,MAAM,iBAAiB,o2BAK7B,CAAC;AAEF,eAAO,MAAM,cAAc,wmCAS1B,CAAC;AAEF,eAAO,MAAM,eAAe,0nCAS3B,CAAC;AAEF,eAAO,MAAM,cAAc,u0BAK1B,CAAC;AAEF,eAAO,MAAM,gBAAgB,s0BAK5B,CAAC;AAEF,eAAO,MAAM,kBAAkB,6zBAK9B,CAAC;AAEF,eAAO,MAAM,oBAAoB,4zBAKhC,CAAC;AAEF,eAAO,MAAM,eAAe,2mBAY3B,CAAC;AAEF,eAAO,MAAM,oBAAoB,2zBAKhC,CAAC;AAEF,eAAO,MAAM,qBAAqB,y2BAKjC,CAAC;AAEF,eAAO,MAAM,gBAAgB,wPAM5B,CAAC;AAEF,eAAO,MAAM,eAAe,+KAG3B,CAAC;AAEF,eAAO,MAAM,eAAe,4UAM3B,CAAC;AAEF,eAAO,MAAM,iBAAiB,syBAK7B,CAAC;AAEF,eAAO,MAAM,iBAAiB,gHAG7B,CAAC;AAEF,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,SAAS,MAAM,EAAE,GAAG,MAAM,GAAG,SAAS,CAoDtG"}
+{"version":3,"file":"help.d.ts","sourceRoot":"","sources":["../../src/cli/help.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAExD,eAAO,MAAM,kBAAkB,ydASQ,CAAC;AAExC,eAAO,MAAM,aAAa,QAkHzB,CAAC;AACF,eAAO,MAAM,kBAAkB,QAI9B,CAAC;AAEF,eAAO,MAAM,mBAAmB,miDAiB/B,CAAC;AAEF,eAAO,MAAM,kBAAkB,ofAU9B,CAAC;AAEF,eAAO,MAAM,iBAAiB,g1BAY7B,CAAC;AAEF,eAAO,MAAM,mBAAmB,kXAM/B,CAAC;AAMF,eAAO,MAAM,iBAAiB,itCAU7B,CAAC;AAEF,eAAO,MAAM,cAAc,wzBAU1B,CAAC;AAEF,eAAO,MAAM,gBAAgB,itDAkB5B,CAAC;AAEF,eAAO,MAAM,cAAc,2qCAQ1B,CAAC;AAEF,eAAO,MAAM,cAAc,usCAS1B,CAAC;AAEF,eAAO,MAAM,cAAc,4yBAO1B,CAAC;AAEF,eAAO,MAAM,aAAa,yNAIzB,CAAC;AAEF,eAAO,MAAM,iBAAiB,y6CAY7B,CAAC;AAEF,eAAO,MAAM,iBAAiB,skCAO7B,CAAC;AAEF,eAAO,MAAM,iBAAiB,skCAO7B,CAAC;AAEF,eAAO,MAAM,oBAAoB,q/BAOhC,CAAC;AAEF,eAAO,MAAM,kBAAkB,++BAO9B,CAAC;AAEF,eAAO,MAAM,yBAAyB,oiCAOrC,CAAC;AAEF,eAAO,MAAM,wBAAwB,qyCASpC,CAAC;AAEF,eAAO,MAAM,uBAAuB,+4CASnC,CAAC;AAEF,eAAO,MAAM,gBAAgB,i2CAS5B,CAAC;AAEF,eAAO,MAAM,gBAAgB,y8CAgB5B,CAAC;AAEF,eAAO,MAAM,iBAAiB,g/CAW7B,CAAC;AAEF,eAAO,MAAM,kBAAkB,+3CAgB9B,CAAC;AAEF,eAAO,MAAM,gBAAgB,2jDAkB5B,CAAC;AAEF,eAAO,MAAM,aAAa,g2CAwBzB,CAAC;AAEF,eAAO,MAAM,mBAAmB,i4EAwC/B,CAAC;AAEF,eAAO,MAAM,oBAAoB,k8FAwChC,CAAC;AAEF,eAAO,MAAM,eAAe,qrCAe3B,CAAC;AAEF,eAAO,MAAM,gBAAgB,qgCAc5B,CAAC;AAEF,eAAO,MAAM,eAAe,2jCAQ3B,CAAC;AAEF,eAAO,MAAM,eAAe,mmCAQ3B,CAAC;AAEF,eAAO,MAAM,gBAAgB,qnDAiB5B,CAAC;AAEF,eAAO,MAAM,gBAAgB,o9BAQ5B,CAAC;AAEF,eAAO,MAAM,iBAAiB,o2BAK7B,CAAC;AAEF,eAAO,MAAM,cAAc,wmCAS1B,CAAC;AAEF,eAAO,MAAM,eAAe,0nCAS3B,CAAC;AAEF,eAAO,MAAM,cAAc,u0BAK1B,CAAC;AAEF,eAAO,MAAM,gBAAgB,s0BAK5B,CAAC;AAEF,eAAO,MAAM,kBAAkB,6zBAK9B,CAAC;AAEF,eAAO,MAAM,oBAAoB,4zBAKhC,CAAC;AAEF,eAAO,MAAM,eAAe,2mBAY3B,CAAC;AAEF,eAAO,MAAM,oBAAoB,2zBAKhC,CAAC;AAEF,eAAO,MAAM,qBAAqB,y2BAKjC,CAAC;AAEF,eAAO,MAAM,gBAAgB,wPAM5B,CAAC;AAEF,eAAO,MAAM,eAAe,+KAG3B,CAAC;AAEF,eAAO,MAAM,eAAe,4UAM3B,CAAC;AAEF,eAAO,MAAM,iBAAiB,syBAK7B,CAAC;AAEF,eAAO,MAAM,iBAAiB,gHAG7B,CAAC;AAEF,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,SAAS,MAAM,EAAE,GAAG,MAAM,GAAG,SAAS,CAoDtG"}

package/dist/cli/help.js

@@ -183,13 +183,14 @@ const SHARED_INDEX_OPTIONS_HELP = `Index options:
   Supports shared --cache, --cache-dir, --cache-strict, --cache-verify, --threads, --native, --workers, --include-glob, --ignore-glob, and --no-gitignore options.
   Cache precedence is --cache-dir, then CODEGRAPH_CACHE_DIR, then cache.location from project/user config, then repository metadata, then the project root. Use cache.location "project", "repo", "user", or an absolute path. A configured anchor that resolves to the home directory or a filesystem root is rejected with an error.
   Index builds report progress automatically on an interactive stderr terminal. Use --progress to force redirected progress logs or --no-progress to suppress feedback.`;
-export const EXPLORE_HELP_TEXT = `codegraph explore - Answer a broad repo question with bounded repo context
+export const EXPLORE_HELP_TEXT = `codegraph explore - Derive context from one hybrid search
 
 Usage: codegraph explore "<query>" [--root <path>] [--limit <n>] [--max-packets <n>] [--max-paths <n>] [--no-source] [--include-graph-context] [--allow-sensitive] [--json | --pretty]
 
 Output:
-  Explore orchestrates search, packet retrieval, dependency paths, reverse dependencies, candidate tests, and follow-up commands. An exact file-path query also includes the live bounded file view.
-  Pretty model-readable sections are the default. Use --json for structured fields. Graph context and raw sensitive values require explicit flags.
+  One hybrid search plus context from top results.
+  Not a first step: \`codegraph orient\`, \`codegraph search\`/\`codegraph grep\`, then \`codegraph refs\`/\`codegraph callers\`. Use explore only for context from a narrow query.
+  \`analysis\` is parser backend quality, not query reasoning.
 
 ${SHARED_INDEX_OPTIONS_HELP}
 `;

package/dist/cli/help.js.map

@@ -1 +1 @@
-{"version":3,"file":"help.js","sourceRoot":"","sources":["../../src/cli/help.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"help.js","sourceRoot":"","sources":["../../src/cli/help.ts"],"names":[],"mappings":"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"}