@lzehrung/codegraph 2.3.3 → 2.3.4

package/codegraph-skill/codegraph/SKILL.md

@@ -45,7 +45,7 @@ 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
 

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), {

package/dist/cli/progress.js

@@ -21,6 +21,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 = () => {
@@ -32,11 +33,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 = () => {
@@ -58,6 +58,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;
@@ -104,6 +105,8 @@ function createInteractiveProgressDisplay(write, delayMs = 0) {
             current = update.current;
             total = update.total;
             mode = update.mode ?? mode;
+            if (update.activity !== undefined)
+                activity = update.activity;
         },
         clear,
         dispose: () => {
@@ -123,12 +126,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 = () => {
@@ -145,11 +152,12 @@ function createLogProgressDisplay(write, delayMs = 0) {
         if (!active || rendered)
             return;
         rendered = true;
-        write(`[Progress] ${progressAction(mode)} project index.\n`);
+        write(`[Progress] ${activity}.\n`);
         heartbeat = setInterval(() => {
             if (!active)
                 return;
-            write(`[Progress] ${progressAction(mode)} project index:${formatProgressCount(current, total)}.\n`);
+            const count = hasProgressCount(mode, current, total) ? `:${formatProgressCount(current, total)}` : "";
+            write(`[Progress] ${activity}${count}.\n`);
         }, 1_000);
         heartbeat.unref();
     };
@@ -160,6 +168,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();
@@ -191,12 +200,23 @@ function createLogProgressDisplay(write, delayMs = 0) {
                     return;
                 start(update);
             }
+            const previousActivity = activity;
             current = update.current;
             total = update.total;
             mode = update.mode ?? mode;
+            if (update.activity !== undefined)
+                activity = update.activity;
+            if (rendered && activity !== previousActivity) {
+                write(`[Progress] ${activity}.\n`);
+            }
             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.\n`);
+            if (rendered && (update.current === 1 || isComplete || (update.current > 0 && update.current % 100 === 0))) {
+                if (update.activity !== undefined) {
+                    write(`[Progress] ${activity}:${formatProgressCount(update.current, update.total)}.\n`);
+                }
+                else {
+                    write(`[Progress] ${formatFileCount(update.current)} processed.\n`);
+                }
             }
         },
         clear: () => { },

package/dist/cli/progress.js.map

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

package/dist/indexer/build-index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"build-index.d.ts","sourceRoot":"","sources":["../../src/indexer/build-index.ts"],"names":[],"mappings":"AAuFA,OAAO,EACL,KAAK,YAAY,EAEjB,KAAK,gBAAgB,EAErB,KAAK,uBAAuB,EAI5B,KAAK,YAAY,EAIlB,MAAM,YAAY,CAAC;AA+iCpB;;;;;;;GAOG;AACH,wBAAsB,iBAAiB,CAAC,WAAW,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,YAAY,GAAG,OAAO,CAAC,YAAY,CAAC,CAEvG;AAED;;;;;;GAMG;AACH,wBAAsB,0BAA0B,CAC9C,WAAW,EAAE,MAAM,EACnB,UAAU,EAAE,MAAM,EAAE,EACpB,IAAI,CAAC,EAAE,YAAY,GAClB,OAAO,CAAC,YAAY,CAAC,CAgBvB;AA4BD;;;;;;GAMG;AACH,wBAAsB,4BAA4B,CAChD,WAAW,EAAE,MAAM,EACnB,IAAI,CAAC,EAAE,uBAAuB,GAC7B,OAAO,CAAC,YAAY,CAAC,CAksBvB;AAED,wBAAsB,eAAe,CAAC,WAAW,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,uBAAuB,GAAG,OAAO,CAAC,gBAAgB,CAAC,CA8IpH"}
+{"version":3,"file":"build-index.d.ts","sourceRoot":"","sources":["../../src/indexer/build-index.ts"],"names":[],"mappings":"AAuFA,OAAO,EACL,KAAK,YAAY,EAEjB,KAAK,gBAAgB,EAErB,KAAK,uBAAuB,EAI5B,KAAK,YAAY,EAIlB,MAAM,YAAY,CAAC;AAykCpB;;;;;;;GAOG;AACH,wBAAsB,iBAAiB,CAAC,WAAW,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,YAAY,GAAG,OAAO,CAAC,YAAY,CAAC,CAEvG;AAED;;;;;;GAMG;AACH,wBAAsB,0BAA0B,CAC9C,WAAW,EAAE,MAAM,EACnB,UAAU,EAAE,MAAM,EAAE,EACpB,IAAI,CAAC,EAAE,YAAY,GAClB,OAAO,CAAC,YAAY,CAAC,CAgBvB;AA4BD;;;;;;GAMG;AACH,wBAAsB,4BAA4B,CAChD,WAAW,EAAE,MAAM,EACnB,IAAI,CAAC,EAAE,uBAAuB,GAC7B,OAAO,CAAC,YAAY,CAAC,CA8sBvB;AAED,wBAAsB,eAAe,CAAC,WAAW,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,uBAAuB,GAAG,OAAO,CAAC,gBAAgB,CAAC,CA8IpH"}

package/dist/indexer/build-index.js

@@ -392,6 +392,17 @@ function emitIndexLifecycleProgress(opts, phase, mode, total, elapsedMs) {
         ...(elapsedMs !== undefined ? { elapsedMs } : {}),
     });
 }
+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 });
 }
@@ -868,16 +879,22 @@ async function buildProjectIndexWithManifestOptions(projectRoot, opts, helperOpt
         const onGitCandidatesDiscovered = (candidates) => {
             discoveredGitCandidates = candidates;
         };
+        const onDiscoveryProgress = helperOpts?.reportDiscoveryProgress
+            ? (progress) => emitIndexCheckActivity(opts, progress.activity, progress.current, progress.total)
+            : undefined;
         // When the hint is unknown, listProjectFiles() and discoverProjectFiles() must run
         // sequentially rather than in Promise.all to avoid duplicate full-tree probes. The Git
         // candidate callback below reuses that same listing so metadata discovery does not spawn
         // Git a second time.
+        if (helperOpts?.reportDiscoveryProgress)
+            emitIndexCheckActivity(opts, "Discovering source files");
         const discoveredFiles = await listProjectFilesWithGitCandidates(projectRoot, projectPatternsForLanguageExtensions(opts), {
             ...opts?.discovery,
             ...(opts?.logLevel ? { logLevel: opts.logLevel } : {}),
             ...(knownSymlinkDirectories !== undefined ? { knownSymlinkDirectories } : {}),
             onSymlinkDirectoriesDiscovered,
             onGitCandidatesDiscovered,
+            ...(onDiscoveryProgress ? { onDiscoveryProgress } : {}),
         });
         const additionalFileCandidates = await normalizeIndexedFileInputsWithinRoot(projectRoot, opts?.additionalFiles ?? [], "Additional index file");
         const additionalFileExistence = await probePathExistence(additionalFileCandidates, buildConcurrency(opts));
@@ -885,10 +902,13 @@ async function buildProjectIndexWithManifestOptions(projectRoot, opts, helperOpt
         const discoveredFileSet = new Set(discoveredFiles);
         const files = Array.from(new Set([...discoveredFiles, ...additionalFiles]));
         const transientFiles = additionalFiles.filter((file) => !discoveredFileSet.has(file));
+        if (helperOpts?.reportDiscoveryProgress)
+            emitIndexCheckActivity(opts, "Discovering project metadata");
         const projectFiles = await discoverProjectFilesWithGitCandidates(projectRoot, {
             ...(opts?.logLevel ? { logLevel: opts.logLevel } : {}),
             ...(discoveredSymlinkDirectories !== undefined ? { knownSymlinkDirectories: discoveredSymlinkDirectories } : {}),
             ...(discoveredGitCandidates !== undefined ? { knownGitCandidates: discoveredGitCandidates } : {}),
+            ...(onDiscoveryProgress ? { onDiscoveryProgress } : {}),
         });
         return await buildIndexFromFileListShared(projectRoot, files, opts, {
             manifestMode: useDiskCache ? "read-write" : "off",
@@ -1073,7 +1093,10 @@ export 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;
@@ -1103,7 +1126,10 @@ export 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;
@@ -1121,7 +1147,10 @@ export 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);
@@ -1164,7 +1193,10 @@ export async function buildProjectIndexIncremental(projectRoot, opts) {
                     manifestReport.reused = false;
                 }
                 logWithLevel(opts?.logLevel, "warn", "Warning: Failed to list untracked project files via Git; rebuilding full index.", error);
-                return await buildProjectIndexFromExport(projectRoot, opts, { ignoreExistingManifest: true });
+                return await buildProjectIndexFromExport(projectRoot, opts, {
+                    ignoreExistingManifest: true,
+                    reportDiscoveryProgress: true,
+                });
             }
         }
         else if (!opts?.filesAreProjectScope) {