@ngockhoale/ukit 2.4.2 → 2.4.3

package/templates/.claude/ukit/index/refresh-index.mjs

@@ -14,39 +14,64 @@ const changedFiles = changedArg ? changedArg.split(',').map((x) => x.trim()).fil
 const force = args.includes('--force');
 
 const lastRefreshMs = await getIndexArtifactGeneratedAt({ rootDir });
-const staleness = force
-  ? null
-  : await inspectIndexStaleness({ rootDir, maxAgeMs: DEFAULT_INDEX_CACHE_MAX_AGE_MS, generatedAtMs: lastRefreshMs });
-const stale = force || staleness.stale;
 
-if (!stale) {
-  console.log('[ukit:index:refresh] skipped (cache fresh)');
-  if (lastRefreshMs !== null) {
-    console.log(`lastRefresh: ${new Date(lastRefreshMs).toISOString()}`);
-  }
-  if (changedFiles.length > 0) {
-    console.log(`changed-files-hint: ${changedFiles.join(', ')}`);
-  }
-  console.log(`root: ${rootDir}`);
-} else {
-  // Reuse the staleness check's discovery snapshot: one enumeration per refresh.
-  const summary = await buildCodeIndex({
-    rootDir,
-    discoverySnapshot: staleness ? staleness.snapshot : null,
-  });
+if (changedFiles.length > 0 && !force) {
+  // Hints carry the change set, so no staleness enumeration is needed:
+  // buildCodeIndex merges the hinted paths into the existing artifacts and
+  // falls back to the bounded full discovery path on its own when the hints
+  // are unsafe or the previous artifacts cannot be merged (TASK-023).
+  const summary = await buildCodeIndex({ rootDir, changedFiles });
 
   console.log('[ukit:index:refresh] completed');
+  console.log(`mode: ${summary.mode}`);
   if (lastRefreshMs !== null) {
     console.log(`lastRefreshBefore: ${new Date(lastRefreshMs).toISOString()}`);
   }
-  if (changedFiles.length > 0) {
-    console.log(`changed-files-hint: ${changedFiles.join(', ')}`);
-  }
+  console.log(`changed-files-hint: ${changedFiles.join(', ')}`);
   console.log(`root: ${rootDir}`);
   console.log(`files: ${summary.fileCount}`);
   console.log(`parsed: ${summary.parsedCodeFileCount}`);
   console.log(`reused: ${summary.reusedCodeFileCount}`);
+  if (summary.removedFiles.length > 0) {
+    console.log(`removed: ${summary.removedFiles.length}`);
+  }
   console.log(`indexDir: ${summary.indexDir}`);
+} else {
+  const staleness = force
+    ? null
+    : await inspectIndexStaleness({ rootDir, maxAgeMs: DEFAULT_INDEX_CACHE_MAX_AGE_MS, generatedAtMs: lastRefreshMs });
+  const stale = force || staleness.stale;
+
+  if (!stale) {
+    console.log('[ukit:index:refresh] skipped (cache fresh)');
+    if (lastRefreshMs !== null) {
+      console.log(`lastRefresh: ${new Date(lastRefreshMs).toISOString()}`);
+    }
+    if (changedFiles.length > 0) {
+      console.log(`changed-files-hint: ${changedFiles.join(', ')}`);
+    }
+    console.log(`root: ${rootDir}`);
+  } else {
+    // Reuse the staleness check's discovery snapshot: one enumeration per refresh.
+    const summary = await buildCodeIndex({
+      rootDir,
+      discoverySnapshot: staleness ? staleness.snapshot : null,
+    });
+
+    console.log('[ukit:index:refresh] completed');
+    console.log(`mode: ${summary.mode}`);
+    if (lastRefreshMs !== null) {
+      console.log(`lastRefreshBefore: ${new Date(lastRefreshMs).toISOString()}`);
+    }
+    if (changedFiles.length > 0) {
+      console.log(`changed-files-hint: ${changedFiles.join(', ')}`);
+    }
+    console.log(`root: ${rootDir}`);
+    console.log(`files: ${summary.fileCount}`);
+    console.log(`parsed: ${summary.parsedCodeFileCount}`);
+    console.log(`reused: ${summary.reusedCodeFileCount}`);
+    console.log(`indexDir: ${summary.indexDir}`);
+  }
 }
 
 function getRootDir(argv) {