@liendev/core 0.21.0 → 0.23.0

package/dist/vectordb/qdrant.d.ts

@@ -1,25 +1,49 @@
 import { SearchResult, VectorDBInterface } from './types.js';
 import { ChunkMetadata } from '../indexer/types.js';
+/**
+ * Validate filter options for buildBaseFilter.
+ *
+ * This is a separate function to enable unit testing of validation logic.
+ * The validations ensure that conflicting options are not used together.
+ *
+ * @param options - Filter options to validate
+ * @throws Error if conflicting options are detected
+ */
+export declare function validateFilterOptions(options: {
+    repoIds?: string[];
+    branch?: string;
+    includeCurrentRepo?: boolean;
+}): void;
 /**
  * QdrantDB implements VectorDBInterface using Qdrant vector database.
  *
  * Features:
  * - Multi-tenant support via payload filtering (orgId/repoId)
+ * - Branch and commit isolation for PR workflows
  * - Collection naming: `lien_org_{orgId}`
  * - Cross-repo search by omitting repoId filter
  * - Tenant isolation via orgId filtering
+ * - Point ID generation includes branch/commit to prevent collisions
+ *
+ * Data Isolation:
+ * All queries are filtered by orgId, repoId, branch, and commitSha by default.
+ * This ensures that different branches and commits have isolated data, preventing
+ * PRs from overwriting each other's indices. Use cross-repo methods (searchCrossRepo,
+ * scanCrossRepo) to query across repositories within an organization.
  */
 export declare class QdrantDB implements VectorDBInterface {
     private client;
     private collectionName;
     private orgId;
     private repoId;
+    private branch;
+    private commitSha;
     private initialized;
     readonly dbPath: string;
     private lastVersionCheck;
     private currentVersion;
     private payloadMapper;
-    constructor(url: string, apiKey: string | undefined, orgId: string, projectRoot: string);
+    constructor(url: string, apiKey: string | undefined, orgId: string, projectRoot: string, branch: string, commitSha: string);
     /**
      * Extract repository identifier from project root.
      * Uses project name + path hash for stable, unique identification.
@@ -27,17 +51,87 @@ export declare class QdrantDB implements VectorDBInterface {
     private extractRepoId;
     /**
      * Generate a unique point ID from chunk metadata.
-     * Uses hash of file path + line range for stable identification.
+     * Uses hash of file path + line range + branch + commitSha for stable identification.
+     * Includes branch/commit to prevent ID collisions across branches.
+     *
+     * **Hash Algorithm Choice:**
+     * Uses MD5 for performance and collision likelihood acceptable for this use case.
+     * - MD5 is deprecated for cryptographic purposes but suitable for non-security ID generation
+     * - Collision probability is extremely low: ~1 in 2^64 for random inputs
+     * - Input includes file path, line range, branch, and commit SHA, making collisions
+     *   even less likely in practice
+     * - For typical codebases (thousands to hundreds of thousands of chunks), collision risk
+     *   is negligible
+     * - If scaling to millions of chunks across many repos, consider upgrading to SHA-256
+     *   for additional collision resistance (at ~10% performance cost)
      */
     private generatePointId;
+    /**
+     * Build base filter for Qdrant queries.
+     * Uses builder pattern to simplify filter construction.
+     *
+     * **Important constraints:**
+     * - `includeCurrentRepo` and `repoIds` are mutually exclusive.
+     * - `includeCurrentRepo` defaults to `true` when `undefined` (treats `undefined` as "enabled").
+     * - To use `repoIds` for cross-repo queries, you must explicitly pass `includeCurrentRepo: false`.
+     * - The `branch` parameter can only be used when `includeCurrentRepo` is explicitly `false`.
+     *   When `includeCurrentRepo` is enabled (default), branch is automatically included via
+     *   the current repo context (`addRepoContext`).
+     *
+     * @param options - Filter options
+     * @param options.includeCurrentRepo - Whether to filter by current repo context (default: true when undefined).
+     *   Must be explicitly `false` to use `repoIds` or `branch` parameters.
+     * @param options.repoIds - Repository IDs to filter by (requires `includeCurrentRepo: false`).
+     * @param options.branch - Branch name to filter by (requires `includeCurrentRepo: false`).
+     * @returns Qdrant filter object
+     */
+    private buildBaseFilter;
+    /**
+     * Map Qdrant scroll results to SearchResult format.
+     *
+     * Note: Scroll/scan operations do not compute semantic similarity scores.
+     * For these results, score is always 0 and relevance is set to 'not_relevant'
+     * to indicate that the results are unscored (not that they are useless).
+     */
+    private mapScrollResults;
+    /**
+     * Execute a scroll query with error handling.
+     */
+    private executeScrollQuery;
     initialize(): Promise<void>;
+    /**
+     * Validate batch input arrays have matching lengths.
+     */
+    private validateBatchInputs;
+    /**
+     * Prepare Qdrant points from vectors, metadatas, and contents.
+     */
+    private preparePoints;
     insertBatch(vectors: Float32Array[], metadatas: ChunkMetadata[], contents: string[]): Promise<void>;
     search(queryVector: Float32Array, limit?: number, _query?: string): Promise<SearchResult[]>;
     /**
      * Search across all repos in the organization (cross-repo search).
-     * Omits repoId filter to enable cross-repo queries.
+     *
+     * - Omits repoId filter by default to enable true cross-repo queries.
+     * - When repoIds are provided, restricts results to those repositories only.
+     * - When branch is omitted, returns chunks from all branches and commits
+     *   (including historical PR branches and stale commits).
+     * - When branch is provided, filters by branch name only and still returns
+     *   chunks from all commits on that branch across the selected repos.
+     *
+     * This is a low-level primitive for cross-repo augmentation. Higher-level
+     * workflows (e.g. \"latest commit only\") should be built on top of this API.
+     *
+     * @param queryVector - Query vector for semantic search
+     * @param limit - Maximum number of results to return (default: 5)
+     * @param options - Optional search options
+     * @param options.repoIds - Repository IDs to filter by (optional)
+     * @param options.branch - Branch name to filter by (optional)
      */
-    searchCrossRepo(queryVector: Float32Array, limit?: number, repoIds?: string[]): Promise<SearchResult[]>;
+    searchCrossRepo(queryVector: Float32Array, limit?: number, options?: {
+        repoIds?: string[];
+        branch?: string;
+    }): Promise<SearchResult[]>;
     scanWithFilter(options: {
         language?: string;
         pattern?: string;
@@ -49,13 +143,23 @@ export declare class QdrantDB implements VectorDBInterface {
     }): Promise<SearchResult[]>;
     /**
      * Scan with filter across all repos in the organization (cross-repo).
-     * Omits repoId filter to enable cross-repo queries.
+     *
+     * - Omits repoId filter by default to enable true cross-repo scans.
+     * - When repoIds are provided, restricts results to those repositories only.
+     * - When branch is omitted, returns chunks from all branches and commits
+     *   (including historical PR branches and stale commits).
+     * - When branch is provided, filters by branch name only and still returns
+     *   chunks from all commits on that branch across the selected repos.
+     *
+     * Like searchCrossRepo, this is a low-level primitive. Higher-level behavior
+     * such as \"latest commit only\" should be implemented in orchestrating code.
      */
     scanCrossRepo(options: {
         language?: string;
         pattern?: string;
         limit?: number;
         repoIds?: string[];
+        branch?: string;
     }): Promise<SearchResult[]>;
     querySymbols(options: {
         language?: string;
@@ -64,6 +168,16 @@ export declare class QdrantDB implements VectorDBInterface {
         limit?: number;
     }): Promise<SearchResult[]>;
     clear(): Promise<void>;
+    /**
+     * Clear all data for a specific branch (all commits).
+     *
+     * Qdrant-only helper: this is not part of the generic VectorDBInterface and
+     * is intended for cloud/PR workflows where multiple commits exist per branch.
+     * LanceDB and other backends do not implement this method.
+     *
+     * @param branch - Branch name to clear (defaults to current branch)
+     */
+    clearBranch(branch?: string): Promise<void>;
     deleteByFile(filepath: string): Promise<void>;
     updateFile(filepath: string, vectors: Float32Array[], metadatas: ChunkMetadata[], contents: string[]): Promise<void>;
     hasData(): Promise<boolean>;

package/dist/vectordb/qdrant.d.ts.map

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