ctxman 3.1.1 → 3.2.7

package/lib/rag/ask.js

@@ -1,21 +1,24 @@
 /**
  * Semantic search over a project (`ctxman ask` and the MCP `ask_codebase` tool): an
  * embedding index under .ctxman/self-knowledge, built on first use, then the snippets
- * closest to the question. Needs the optional @xenova/transformers and @lancedb/lancedb
- * packages; the embedding model is downloaded on first use.
+ * closest to the question. By default uses the built-in zero-native-binary SqliteVectorStore
+ * and AutoEmbeddingProvider (100% offline, zero optional dependencies). Optional LanceDB
+ * and @xenova/transformers can also be used if configured.
  *
  * Files left out by .gitignore, .contextignore, .contextinclude or the export policy are
  * not indexed, and results from an older index are checked against the policy again.
  */
 
+import fsSync from 'fs';
 import fs from 'fs/promises';
 import path from 'path';
 import { Scanner } from '../core/Scanner.js';
 import { redactSecrets } from '../utils/secret-redactor.js';
 import { VectorStoreFactory } from './VectorStoreFactory.js';
-import { TransformersEmbeddingProvider } from './EmbeddingProvider.js';
+import { AutoEmbeddingProvider } from './EmbeddingProvider.js';
 import { Indexer } from './Indexer.js';
 import { FileDataSource } from './sources/FileDataSource.js';
+import { resolveWorkspaceRepos, enforceWorkspacePolicies } from '../workspace/index.js';
 
 export const ASK_STORE_DIR = path.join('.ctxman', 'self-knowledge');
 export const DEFAULT_ASK_LIMIT = 5;
@@ -25,9 +28,16 @@ const EXCLUDE = ['node_modules', '.git', 'dist', 'coverage', '.ctxman'];
 // Extra rows asked of the store, so results the policy removes still leave `limit`
 const OVERFETCH = 10;
 
-async function hasIndex(storePath) {
+async function hasIndex(storePath, store) {
   try {
-    return (await fs.readdir(storePath)).length > 0;
+    if ((await fs.readdir(storePath)).length === 0) return false;
+    if (store && typeof store.count === 'function') {
+      if (typeof store.init === 'function' && !store.initialized) {
+        await store.init();
+      }
+      return store.count() > 0;
+    }
+    return true;
   } catch {
     return false;
   }
@@ -35,6 +45,20 @@ async function hasIndex(storePath) {
 
 const toPosix = (p) => p.split(path.sep).join('/');
 
+function buildWorkspaceRepoInputs(primaryRoot, extraRepos) {
+  const realPrimary = fsSync.existsSync(primaryRoot)
+    ? fsSync.realpathSync(primaryRoot)
+    : path.resolve(primaryRoot);
+  const isContainerOfExtra = extraRepos.some((item) => {
+    const raw = typeof item === 'string' ? item : item?.path;
+    if (typeof raw !== 'string' || !raw.trim()) return false;
+    const resolved = path.resolve(raw);
+    const real = fsSync.existsSync(resolved) ? fsSync.realpathSync(resolved) : resolved;
+    return real !== realPrimary && real.startsWith(realPrimary + path.sep);
+  });
+  return isContainerOfExtra ? [...extraRepos] : [primaryRoot, ...extraRepos];
+}
+
 /**
  * @param {string} root - Project directory
  * @param {string} query - The question
@@ -42,14 +66,14 @@ const toPosix = (p) => p.split(path.sep).join('/');
  * @param {number} [options.limit=5] - Snippets to return
  * @param {boolean} [options.redact=true] - Redact secrets in the snippets
  * @param {number} [options.maxChars] - Cut each snippet to this many characters
+ * @param {Array<string|{path: string, alias?: string}>} [options.repos] - Additional repository roots for multi-repo semantic search
  * @param {(event: 'indexing'|'indexed') => void} [options.onProgress]
- * @param {(storePath: string) => object} [options.createStore] - Vector store factory
- *   (tests); default: LanceDB with the local embedding model
- * @returns {Promise<{query: string, indexed: boolean, results: Array<{file: string,
- *   score: number|null, text: string, truncated: boolean}>, removedByPolicy: number,
- *   redactions: number}>}
- * @throws {Error} When the question is empty, the policy is invalid, the optional packages
- *   are missing or indexing fails
+ * @param {(storePath: string, repo?: object) => object} [options.createStore] - Vector store factory
+ *   (tests); default: SqliteVectorStore with AutoEmbeddingProvider
+ * @returns {Promise<{query: string, indexed: boolean, repos?: Array<{alias: string, root: string}>,
+ *   results: Array<{repo?: string, file: string, score: number|null, text: string, truncated: boolean}>,
+ *   removedByPolicy: number, redactions: number}>}
+ * @throws {Error} When the question is empty, the policy is invalid, or indexing fails
  */
 export async function askCodebase(root, query, options = {}) {
   const question = typeof query === 'string' ? query.trim() : '';
@@ -57,9 +81,152 @@ export async function askCodebase(root, query, options = {}) {
   const limit =
     Number.isInteger(options.limit) && options.limit > 0 ? options.limit : DEFAULT_ASK_LIMIT;
   const projectRoot = path.resolve(root);
-  const storePath = path.join(projectRoot, ASK_STORE_DIR);
   const onProgress = options.onProgress || (() => {});
+  const isWorkspace = Array.isArray(options.repos) && options.repos.length > 0;
+
+  if (isWorkspace) {
+    const resolvedRepos = resolveWorkspaceRepos(
+      buildWorkspaceRepoInputs(projectRoot, options.repos)
+    );
+    enforceWorkspacePolicies(resolvedRepos, {
+      filesByRepo: new Map(),
+      tokens: 0,
+      redact: options.redact !== false,
+    });
+
+    const scannersByAlias = new Map();
+    const repoByAlias = new Map();
+    for (const repo of resolvedRepos) {
+      const scanner = new Scanner(repo.root);
+      scanner.getPolicy();
+      scannersByAlias.set(repo.alias, scanner);
+      repoByAlias.set(repo.alias, repo);
+    }
+
+    let indexedAny = false;
+    let startedIndexing = false;
+    let removedByPolicy = 0;
+    const candidatesByFile = new Map();
+
+    for (const repo of resolvedRepos) {
+      const repoStorePath = path.join(repo.root, ASK_STORE_DIR);
+      const repoScanner = scannersByAlias.get(repo.alias);
+      const relativeToRepo = (targetRepo, fullPath) =>
+        toPosix(path.relative(targetRepo.root, fullPath));
+      const leftOfRepo = (targetRepo, fullPath) => {
+        const rel = relativeToRepo(targetRepo, fullPath);
+        return rel.startsWith('../') || path.isAbsolute(rel);
+      };
+
+      const store = options.createStore
+        ? options.createStore(repoStorePath, repo)
+        : VectorStoreFactory.create('sqlite', new AutoEmbeddingProvider(), {
+            path: repoStorePath,
+          });
+
+      if (!(await hasIndex(repoStorePath, store))) {
+        if (!startedIndexing) {
+          onProgress('indexing');
+          startedIndexing = true;
+        }
+        const indexer = new Indexer(store);
+        indexer.registerSource(new FileDataSource());
+        await indexer.index('local-files', {
+          targetDir: repo.root,
+          include: INCLUDE,
+          exclude: EXCLUDE,
+          skip: (fullPath) =>
+            repoScanner.shouldIgnore(path.relative(repo.root, fullPath), fullPath) ||
+            repoScanner.isDenied(relativeToRepo(repo, fullPath)),
+        });
+        indexedAny = true;
+      }
+
+      const rows = await store.search(question, limit + OVERFETCH);
+      for (const row of rows) {
+        const rawPath = row.metadata?.path ?? row.metadata?.relativePath;
+        if (typeof rawPath !== 'string') continue;
+
+        let targetRepo = repo;
+        let resolvedFullPath;
+        const posixRaw = toPosix(rawPath);
+        const slashIdx = posixRaw.indexOf('/');
+        const maybeAlias =
+          row.metadata?.repo || (slashIdx > 0 ? posixRaw.slice(0, slashIdx) : null);
 
+        if (
+          maybeAlias &&
+          repoByAlias.has(maybeAlias) &&
+          !path.isAbsolute(rawPath) &&
+          posixRaw.startsWith(`${maybeAlias}/`)
+        ) {
+          targetRepo = repoByAlias.get(maybeAlias);
+          resolvedFullPath = path.resolve(targetRepo.root, posixRaw.slice(maybeAlias.length + 1));
+        } else {
+          resolvedFullPath = path.isAbsolute(rawPath) ? rawPath : path.resolve(repo.root, rawPath);
+        }
+
+        if (leftOfRepo(targetRepo, resolvedFullPath)) continue;
+        const relFile = relativeToRepo(targetRepo, resolvedFullPath);
+        const targetScanner = scannersByAlias.get(targetRepo.alias);
+        if (targetScanner.isDenied(relFile)) {
+          removedByPolicy++;
+          continue;
+        }
+
+        const prefixedFile = `${targetRepo.alias}/${relFile}`;
+        const existing = candidatesByFile.get(prefixedFile);
+        const score = row.score ?? null;
+        if (!existing || (score ?? -Infinity) > (existing.score ?? -Infinity)) {
+          candidatesByFile.set(prefixedFile, {
+            repo: targetRepo.alias,
+            file: prefixedFile,
+            score,
+            rawText: String(row.text ?? ''),
+          });
+        }
+      }
+    }
+
+    if (startedIndexing) {
+      onProgress('indexed');
+    }
+
+    const sortedCandidates = [...candidatesByFile.values()].sort(
+      (a, b) => (b.score ?? -Infinity) - (a.score ?? -Infinity) || a.file.localeCompare(b.file)
+    );
+
+    const results = [];
+    let redactions = 0;
+    for (const cand of sortedCandidates.slice(0, limit)) {
+      let text = cand.rawText;
+      if (options.redact !== false) {
+        const redacted = redactSecrets(text);
+        text = redacted.text;
+        redactions += redacted.findings.length;
+      }
+      const truncated = Boolean(options.maxChars) && text.length > options.maxChars;
+      if (truncated) text = text.slice(0, options.maxChars);
+      results.push({
+        repo: cand.repo,
+        file: cand.file,
+        score: cand.score,
+        text,
+        truncated,
+      });
+    }
+
+    return {
+      query: question,
+      indexed: indexedAny,
+      repos: resolvedRepos.map(({ alias, root: r }) => ({ alias, root: r })),
+      results,
+      removedByPolicy,
+      redactions,
+    };
+  }
+
+  const storePath = path.join(projectRoot, ASK_STORE_DIR);
   const scanner = new Scanner(projectRoot);
   // Load now: an invalid policy fails the command instead of being skipped
   scanner.getPolicy();
@@ -71,12 +238,12 @@ export async function askCodebase(root, query, options = {}) {
 
   const store = options.createStore
     ? options.createStore(storePath)
-    : VectorStoreFactory.create('lancedb', new TransformersEmbeddingProvider(), {
+    : VectorStoreFactory.create('sqlite', new AutoEmbeddingProvider(), {
         path: storePath,
       });
 
   let indexed = false;
-  if (!(await hasIndex(storePath))) {
+  if (!(await hasIndex(storePath, store))) {
     onProgress('indexing');
     const indexer = new Indexer(store);
     indexer.registerSource(new FileDataSource());
@@ -97,8 +264,10 @@ export async function askCodebase(root, query, options = {}) {
   let removedByPolicy = 0;
   let redactions = 0;
   for (const row of rows) {
-    const fullPath = row.metadata?.path;
-    if (typeof fullPath !== 'string' || left(fullPath)) continue;
+    const rawPath = row.metadata?.path ?? row.metadata?.relativePath;
+    if (typeof rawPath !== 'string') continue;
+    const fullPath = path.isAbsolute(rawPath) ? rawPath : path.resolve(projectRoot, rawPath);
+    if (left(fullPath)) continue;
     const file = relative(fullPath);
     if (scanner.isDenied(file)) {
       removedByPolicy++;