@liendev/core 0.20.1 → 0.22.0

package/dist/vectordb/factory.js

@@ -0,0 +1,117 @@
+import { VectorDB } from './lancedb.js';
+import { QdrantDB } from './qdrant.js';
+import { loadGlobalConfig, extractOrgIdFromGit } from '../config/global-config.js';
+import { getCurrentBranch, getCurrentCommit } from '../git/utils.js';
+/**
+ * Validate that a VectorDB instance has the required methods.
+ */
+function validateVectorDBInterface(db) {
+    if (typeof db.initialize !== 'function') {
+        throw new Error('VectorDB instance missing initialize method');
+    }
+}
+/**
+ * Create a LanceDB instance.
+ */
+async function createLanceDB(projectRoot) {
+    const db = new VectorDB(projectRoot);
+    validateVectorDBInterface(db);
+    return db;
+}
+/**
+ * Create a QdrantDB instance.
+ * Extracts orgId, branch, and commit from git repository.
+ */
+async function createQdrantDB(projectRoot, config) {
+    if (!config.url) {
+        throw new Error('Qdrant backend requires qdrant.url in global config');
+    }
+    // Auto-detect orgId from git remote
+    const orgId = await extractOrgIdFromGit(projectRoot);
+    if (!orgId) {
+        throw new Error('Qdrant backend requires a git repository with a remote URL. ' +
+            'Could not extract organization ID from git remote. ' +
+            'Make sure your project is a git repo with a remote configured (e.g., origin).');
+    }
+    // Extract branch and commit from git (both are required for Qdrant isolation)
+    // Fail fast if git commands fail - branch/commit tracking is essential for data isolation
+    let branch;
+    let commitSha;
+    try {
+        [branch, commitSha] = await Promise.all([
+            getCurrentBranch(projectRoot),
+            getCurrentCommit(projectRoot),
+        ]);
+    }
+    catch (error) {
+        throw new Error('Qdrant backend requires a valid git branch and commit SHA for proper data isolation. ' +
+            'Failed to detect current branch and/or commit from git. ' +
+            'Ensure the repository is initialized, has at least one commit, and HEAD is not detached. ' +
+            `Original error: ${error instanceof Error ? error.message : String(error)}`);
+    }
+    // Validate that branch and commitSha are non-empty (fail-fast for invalid git state)
+    if (!branch || branch.trim().length === 0) {
+        throw new Error('Qdrant backend requires a valid git branch for proper data isolation. ' +
+            'Current branch is empty or whitespace. ' +
+            'Ensure the repository is on a valid branch (not in detached HEAD state).');
+    }
+    if (!commitSha || commitSha.trim().length === 0) {
+        throw new Error('Qdrant backend requires a valid git commit SHA for proper data isolation. ' +
+            'Current commit SHA is empty or whitespace. ' +
+            'Ensure the repository has at least one commit.');
+    }
+    const db = new QdrantDB(config.url, config.apiKey, orgId, projectRoot, branch, commitSha);
+    validateVectorDBInterface(db);
+    return db;
+}
+/**
+ * Factory function to create a VectorDB instance based on global configuration.
+ *
+ * Selects the backend (LanceDB or Qdrant) based on global config.
+ * Defaults to LanceDB if no config is provided.
+ *
+ * For Qdrant backend, automatically detects orgId from git remote URL.
+ *
+ * @param projectRoot - Root directory of the project
+ * @returns VectorDBInterface instance (LanceDB or QdrantDB)
+ * @throws Error if Qdrant config is invalid or orgId cannot be detected
+ */
+export async function createVectorDB(projectRoot) {
+    let globalConfig = null;
+    try {
+        globalConfig = await loadGlobalConfig();
+    }
+    catch (error) {
+        const errorMessage = error instanceof Error ? error.message : String(error);
+        // Check if this is a "file not found" error (expected) vs other errors (unexpected)
+        const isFileNotFound = errorMessage.includes('ENOENT') ||
+            errorMessage.includes('not found') ||
+            errorMessage.includes('does not exist');
+        if (isFileNotFound) {
+            // Expected: No config file exists, use default LanceDB (normal for CLI usage)
+            return await createLanceDB(projectRoot);
+        }
+        else {
+            // Unexpected: Config file exists but failed to load (syntax error, permissions, etc.)
+            // Fail hard - don't silently fall back to LanceDB
+            throw new Error('Failed to load global config file. Please check your config file for errors. ' +
+                `Error: ${errorMessage}`);
+        }
+    }
+    // Config loaded successfully - respect the backend choice
+    switch (globalConfig.backend) {
+        case 'qdrant':
+            if (!globalConfig.qdrant) {
+                throw new Error('Qdrant backend requires qdrant configuration in global config');
+            }
+            // Don't catch errors here - let Qdrant-specific errors propagate
+            // User explicitly configured Qdrant, so they should see configuration errors
+            return await createQdrantDB(projectRoot, globalConfig.qdrant);
+        case 'lancedb':
+        case undefined:
+            return await createLanceDB(projectRoot);
+        default:
+            throw new Error(`Unknown storage backend: ${globalConfig.backend}. Supported backends: 'lancedb', 'qdrant'`);
+    }
+}
+//# sourceMappingURL=factory.js.map

package/dist/vectordb/factory.js.map

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

package/dist/vectordb/qdrant-payload-mapper.d.ts

@@ -0,0 +1,80 @@
+import { ChunkMetadata } from '../indexer/types.js';
+/**
+ * Qdrant payload structure for storing chunk metadata.
+ *
+ * Note: Metrics (complexity, halstead) are always present as numbers.
+ * If missing in source metadata, they are stored as 0.
+ */
+export interface QdrantPayload {
+    content: string;
+    file: string;
+    startLine: number;
+    endLine: number;
+    type: string;
+    language: string;
+    functionNames: string[];
+    classNames: string[];
+    interfaceNames: string[];
+    symbolName: string;
+    symbolType: string;
+    parentClass: string;
+    complexity: number;
+    cognitiveComplexity: number;
+    parameters: string[];
+    signature: string;
+    imports: string[];
+    halsteadVolume: number;
+    halsteadDifficulty: number;
+    halsteadEffort: number;
+    halsteadBugs: number;
+    orgId: string;
+    repoId: string;
+    branch: string;
+    commitSha: string;
+}
+/**
+ * Maps between ChunkMetadata and Qdrant payload format.
+ * Encapsulates the transformation logic for multi-tenant Qdrant storage.
+ */
+export declare class QdrantPayloadMapper {
+    private orgId;
+    private repoId;
+    private branch;
+    private commitSha;
+    constructor(orgId: string, repoId: string, branch: string, commitSha: string);
+    /**
+     * Map metrics from metadata to payload format.
+     */
+    private mapMetrics;
+    /**
+     * Map symbols from metadata to payload format.
+     */
+    private mapSymbols;
+    /**
+     * Transform chunk metadata to Qdrant payload format.
+     */
+    toPayload(metadata: ChunkMetadata, content?: string): QdrantPayload;
+    /**
+     * Extract symbols from payload.
+     */
+    private extractSymbols;
+    /**
+     * Extract metrics from payload.
+     */
+    private extractMetrics;
+    /**
+     * Extract tracking info from payload.
+     *
+     * For legacy points indexed before branch/commit tracking was added, these
+     * fields may be missing. In that case they are returned as undefined and
+     * the points will not match branch/commitSha-based filters. Such data
+     * effectively becomes \"orphaned\" until it is re-indexed with tracking
+     * metadata, which is the expected migration path for old Qdrant data.
+     */
+    private extractTrackingInfo;
+    /**
+     * Transform Qdrant payload back to ChunkMetadata.
+     */
+    fromPayload(payload: Record<string, any>): ChunkMetadata;
+}
+//# sourceMappingURL=qdrant-payload-mapper.d.ts.map

package/dist/vectordb/qdrant-payload-mapper.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"qdrant-payload-mapper.d.ts","sourceRoot":"","sources":["../../src/vectordb/qdrant-payload-mapper.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAEpD;;;;;GAKG;AACH,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IAEjB,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,cAAc,EAAE,MAAM,EAAE,CAAC;IAEzB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,mBAAmB,EAAE,MAAM,CAAC;IAC5B,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,EAAE,CAAC;IAElB,cAAc,EAAE,MAAM,CAAC;IACvB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,cAAc,EAAE,MAAM,CAAC;IACvB,YAAY,EAAE,MAAM,CAAC;IAErB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IAEf,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;;GAGG;AACH,qBAAa,mBAAmB;IAE5B,OAAO,CAAC,KAAK;IACb,OAAO,CAAC,MAAM;IACd,OAAO,CAAC,MAAM;IACd,OAAO,CAAC,SAAS;gBAHT,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,MAAM;IAG3B;;OAEG;IACH,OAAO,CAAC,UAAU;IAWlB;;OAEG;IACH,OAAO,CAAC,UAAU;IAclB;;OAEG;IACH,SAAS,CAAC,QAAQ,EAAE,aAAa,EAAE,OAAO,GAAE,MAAW,GAAG,aAAa;IAqBvE;;OAEG;IACH,OAAO,CAAC,cAAc;IAQtB;;OAEG;IACH,OAAO,CAAC,cAAc;IAWtB;;;;;;;;OAQG;IACH,OAAO,CAAC,mBAAmB;IAS3B;;OAEG;IACH,WAAW,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,aAAa;CAkBzD"}

package/dist/vectordb/qdrant-payload-mapper.js

@@ -0,0 +1,129 @@
+/**
+ * Maps between ChunkMetadata and Qdrant payload format.
+ * Encapsulates the transformation logic for multi-tenant Qdrant storage.
+ */
+export class QdrantPayloadMapper {
+    orgId;
+    repoId;
+    branch;
+    commitSha;
+    constructor(orgId, repoId, branch, commitSha) {
+        this.orgId = orgId;
+        this.repoId = repoId;
+        this.branch = branch;
+        this.commitSha = commitSha;
+    }
+    /**
+     * Map metrics from metadata to payload format.
+     */
+    mapMetrics(metadata) {
+        return {
+            complexity: metadata.complexity ?? 0,
+            cognitiveComplexity: metadata.cognitiveComplexity ?? 0,
+            halsteadVolume: metadata.halsteadVolume ?? 0,
+            halsteadDifficulty: metadata.halsteadDifficulty ?? 0,
+            halsteadEffort: metadata.halsteadEffort ?? 0,
+            halsteadBugs: metadata.halsteadBugs ?? 0,
+        };
+    }
+    /**
+     * Map symbols from metadata to payload format.
+     */
+    mapSymbols(metadata) {
+        return {
+            functionNames: metadata.symbols?.functions ?? [],
+            classNames: metadata.symbols?.classes ?? [],
+            interfaceNames: metadata.symbols?.interfaces ?? [],
+            symbolName: metadata.symbolName ?? '',
+            symbolType: metadata.symbolType ?? '',
+            parentClass: metadata.parentClass ?? '',
+            parameters: metadata.parameters ?? [],
+            signature: metadata.signature ?? '',
+            imports: metadata.imports ?? [],
+        };
+    }
+    /**
+     * Transform chunk metadata to Qdrant payload format.
+     */
+    toPayload(metadata, content = '') {
+        const trackingInfo = {
+            orgId: this.orgId,
+            repoId: this.repoId,
+            branch: this.branch,
+            commitSha: this.commitSha,
+        };
+        return {
+            content,
+            file: metadata.file,
+            startLine: metadata.startLine,
+            endLine: metadata.endLine,
+            type: metadata.type,
+            language: metadata.language,
+            ...this.mapSymbols(metadata),
+            ...this.mapMetrics(metadata),
+            ...trackingInfo,
+        };
+    }
+    /**
+     * Extract symbols from payload.
+     */
+    extractSymbols(payload) {
+        return {
+            functions: payload.functionNames ?? [],
+            classes: payload.classNames ?? [],
+            interfaces: payload.interfaceNames ?? [],
+        };
+    }
+    /**
+     * Extract metrics from payload.
+     */
+    extractMetrics(payload) {
+        return {
+            complexity: payload.complexity ?? undefined,
+            cognitiveComplexity: payload.cognitiveComplexity ?? undefined,
+            halsteadVolume: payload.halsteadVolume ?? undefined,
+            halsteadDifficulty: payload.halsteadDifficulty ?? undefined,
+            halsteadEffort: payload.halsteadEffort ?? undefined,
+            halsteadBugs: payload.halsteadBugs ?? undefined,
+        };
+    }
+    /**
+     * Extract tracking info from payload.
+     *
+     * For legacy points indexed before branch/commit tracking was added, these
+     * fields may be missing. In that case they are returned as undefined and
+     * the points will not match branch/commitSha-based filters. Such data
+     * effectively becomes \"orphaned\" until it is re-indexed with tracking
+     * metadata, which is the expected migration path for old Qdrant data.
+     */
+    extractTrackingInfo(payload) {
+        return {
+            repoId: payload.repoId ?? undefined,
+            orgId: payload.orgId ?? undefined,
+            branch: payload.branch ?? undefined,
+            commitSha: payload.commitSha ?? undefined,
+        };
+    }
+    /**
+     * Transform Qdrant payload back to ChunkMetadata.
+     */
+    fromPayload(payload) {
+        return {
+            file: payload.file,
+            startLine: payload.startLine,
+            endLine: payload.endLine,
+            type: payload.type,
+            language: payload.language,
+            symbols: this.extractSymbols(payload),
+            symbolName: payload.symbolName ?? undefined,
+            symbolType: payload.symbolType ?? undefined,
+            parentClass: payload.parentClass ?? undefined,
+            parameters: payload.parameters ?? undefined,
+            signature: payload.signature ?? undefined,
+            imports: payload.imports ?? undefined,
+            ...this.extractMetrics(payload),
+            ...this.extractTrackingInfo(payload),
+        };
+    }
+}
+//# sourceMappingURL=qdrant-payload-mapper.js.map

package/dist/vectordb/qdrant-payload-mapper.js.map

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

package/dist/vectordb/qdrant.d.ts

@@ -0,0 +1,201 @@
+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, branch: string, commitSha: string);
+    /**
+     * Extract repository identifier from project root.
+     * Uses project name + path hash for stable, unique identification.
+     */
+    private extractRepoId;
+    /**
+     * Generate a unique point ID from chunk metadata.
+     * 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 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, options?: {
+        repoIds?: string[];
+        branch?: string;
+    }): Promise<SearchResult[]>;
+    scanWithFilter(options: {
+        language?: string;
+        pattern?: string;
+        limit?: number;
+    }): Promise<SearchResult[]>;
+    scanAll(options?: {
+        language?: string;
+        pattern?: string;
+    }): Promise<SearchResult[]>;
+    /**
+     * Scan with filter across all repos in the organization (cross-repo).
+     *
+     * - 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;
+        pattern?: string;
+        symbolType?: 'function' | 'class' | 'interface';
+        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>;
+    /**
+     * Get the collection name (useful for debugging).
+     */
+    getCollectionName(): string;
+    /**
+     * Get the organization ID.
+     */
+    getOrgId(): string;
+    /**
+     * Get the repository ID.
+     */
+    getRepoId(): string;
+    checkVersion(): Promise<boolean>;
+    reconnect(): Promise<void>;
+    getCurrentVersion(): number;
+    getVersionDate(): string;
+}
+//# sourceMappingURL=qdrant.d.ts.map

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

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