@liendev/core 0.19.5

package/dist/vectordb/boosting/strategies.js

@@ -0,0 +1,174 @@
+import path from 'path';
+import { QueryIntent } from '../intent-classifier.js';
+/**
+ * File type detection helpers
+ */
+function isDocumentationFile(filepath) {
+    const lower = filepath.toLowerCase();
+    const filename = path.basename(filepath).toLowerCase();
+    if (filename.startsWith('readme'))
+        return true;
+    if (filename.startsWith('changelog'))
+        return true;
+    if (filename.endsWith('.md') || filename.endsWith('.mdx') || filename.endsWith('.markdown')) {
+        return true;
+    }
+    if (lower.includes('/docs/') ||
+        lower.includes('/documentation/') ||
+        lower.includes('/wiki/') ||
+        lower.includes('/.github/')) {
+        return true;
+    }
+    if (lower.includes('architecture') ||
+        lower.includes('workflow') ||
+        lower.includes('/flow/')) {
+        return true;
+    }
+    return false;
+}
+function isTestFile(filepath) {
+    const lower = filepath.toLowerCase();
+    if (lower.includes('/test/') ||
+        lower.includes('/tests/') ||
+        lower.includes('/__tests__/')) {
+        return true;
+    }
+    if (lower.includes('.test.') ||
+        lower.includes('.spec.') ||
+        lower.includes('_test.') ||
+        lower.includes('_spec.')) {
+        return true;
+    }
+    return false;
+}
+function isUtilityFile(filepath) {
+    const lower = filepath.toLowerCase();
+    if (lower.includes('/utils/') ||
+        lower.includes('/utilities/') ||
+        lower.includes('/helpers/') ||
+        lower.includes('/lib/')) {
+        return true;
+    }
+    if (lower.includes('.util.') ||
+        lower.includes('.helper.') ||
+        lower.includes('-util.') ||
+        lower.includes('-helper.')) {
+        return true;
+    }
+    return false;
+}
+/**
+ * Boosting Strategies
+ */
+/**
+ * Boosts relevance based on path segment matching.
+ * Files with query tokens in their path are boosted.
+ */
+export class PathBoostingStrategy {
+    name = 'path-matching';
+    apply(query, filepath, baseScore) {
+        const queryTokens = query.toLowerCase().split(/\s+/);
+        const pathSegments = filepath.toLowerCase().split('/');
+        let boostFactor = 1.0;
+        for (const token of queryTokens) {
+            if (token.length <= 2)
+                continue;
+            if (pathSegments.some(seg => seg.includes(token))) {
+                boostFactor *= 0.9; // Reduce distance = increase relevance
+            }
+        }
+        return baseScore * boostFactor;
+    }
+}
+/**
+ * Boosts relevance based on filename matching.
+ * Files with query tokens in their filename are strongly boosted.
+ */
+export class FilenameBoostingStrategy {
+    name = 'filename-matching';
+    apply(query, filepath, baseScore) {
+        const filename = path.basename(filepath, path.extname(filepath)).toLowerCase();
+        const queryTokens = query.toLowerCase().split(/\s+/);
+        let boostFactor = 1.0;
+        for (const token of queryTokens) {
+            if (token.length <= 2)
+                continue;
+            if (filename === token) {
+                boostFactor *= 0.70; // Strong boost for exact match
+            }
+            else if (filename.includes(token)) {
+                boostFactor *= 0.80; // Moderate boost for partial match
+            }
+        }
+        return baseScore * boostFactor;
+    }
+}
+/**
+ * Boosts relevance based on file type and query intent.
+ * Different file types are boosted for different query intents.
+ *
+ * Note: This strategy focuses on file-type-specific boosting (test files,
+ * documentation files, utility files, etc.). Path and filename boosting
+ * are handled separately by PathBoostingStrategy and FilenameBoostingStrategy
+ * in the BoostingComposer to avoid double-boosting.
+ */
+export class FileTypeBoostingStrategy {
+    intent;
+    name = 'file-type';
+    constructor(intent) {
+        this.intent = intent;
+    }
+    apply(query, filepath, baseScore) {
+        switch (this.intent) {
+            case QueryIntent.LOCATION:
+                return this.applyLocationBoosting(query, filepath, baseScore);
+            case QueryIntent.CONCEPTUAL:
+                return this.applyConceptualBoosting(query, filepath, baseScore);
+            case QueryIntent.IMPLEMENTATION:
+                return this.applyImplementationBoosting(query, filepath, baseScore);
+            default:
+                return baseScore;
+        }
+    }
+    applyLocationBoosting(_query, filepath, score) {
+        // Note: Path and filename boosting are handled by PathBoostingStrategy and
+        // FilenameBoostingStrategy in the composer. This method only handles
+        // file-type-specific boosting for location queries.
+        // Slightly deprioritize test files (users want implementation location, not tests)
+        if (isTestFile(filepath)) {
+            score *= 1.10;
+        }
+        return score;
+    }
+    applyConceptualBoosting(_query, filepath, score) {
+        // Note: Path and filename boosting are handled by PathBoostingStrategy and
+        // FilenameBoostingStrategy in the composer. This method only handles
+        // file-type-specific boosting for conceptual queries.
+        // Strong boost for documentation files
+        if (isDocumentationFile(filepath)) {
+            score *= 0.65;
+            const lower = filepath.toLowerCase();
+            if (lower.includes('architecture') ||
+                lower.includes('workflow') ||
+                lower.includes('flow')) {
+                score *= 0.90; // Extra boost for architectural docs
+            }
+        }
+        // Slight boost for utility files (often contain reusable logic)
+        if (isUtilityFile(filepath)) {
+            score *= 0.95;
+        }
+        return score;
+    }
+    applyImplementationBoosting(_query, filepath, score) {
+        // Note: Path and filename boosting are handled by PathBoostingStrategy and
+        // FilenameBoostingStrategy in the composer. This method only handles
+        // file-type-specific boosting for implementation queries.
+        // Slightly deprioritize test files (user wants implementation, not tests)
+        if (isTestFile(filepath)) {
+            score *= 1.10;
+        }
+        return score;
+    }
+}
+//# sourceMappingURL=strategies.js.map

package/dist/vectordb/boosting/strategies.js.map

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

package/dist/vectordb/boosting/types.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Boosting strategy interface.
+ *
+ * Each strategy applies a specific relevance boosting technique
+ * to search results based on file characteristics.
+ */
+export interface BoostingStrategy {
+    /** Name of the strategy (for debugging/logging) */
+    name: string;
+    /**
+     * Apply the boosting strategy to a score.
+     *
+     * @param query - The search query string
+     * @param filepath - The file path being scored
+     * @param baseScore - The base relevance score from vector similarity
+     * @returns The boosted score (lower is better, following LanceDB distance metric)
+     */
+    apply(query: string, filepath: string, baseScore: number): number;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/vectordb/boosting/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/vectordb/boosting/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,MAAM,WAAW,gBAAgB;IAC/B,mDAAmD;IACnD,IAAI,EAAE,MAAM,CAAC;IAEb;;;;;;;OAOG;IACH,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAAC;CACnE"}

package/dist/vectordb/boosting/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/vectordb/boosting/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/vectordb/boosting/types.ts"],"names":[],"mappings":""}

package/dist/vectordb/intent-classifier.d.ts

@@ -0,0 +1,99 @@
+/**
+ * Query Intent Classification
+ *
+ * Classifies user search queries into three categories to apply
+ * appropriate relevance boosting strategies:
+ *
+ * - LOCATION: "Where is X?" - User wants to find specific files/code
+ * - CONCEPTUAL: "How does X work?" - User wants to understand concepts
+ * - IMPLEMENTATION: "How is X implemented?" - User wants implementation details
+ *
+ * Examples:
+ * - "where is the auth handler" → LOCATION
+ * - "how does authentication work" → CONCEPTUAL
+ * - "how is authentication implemented" → IMPLEMENTATION
+ */
+/**
+ * Query intent types for semantic search
+ */
+export declare enum QueryIntent {
+    /** User wants to locate specific files or code (e.g., "where is X") */
+    LOCATION = "location",
+    /** User wants to understand concepts/processes (e.g., "how does X work") */
+    CONCEPTUAL = "conceptual",
+    /** User wants implementation details (e.g., "how is X implemented") */
+    IMPLEMENTATION = "implementation"
+}
+/**
+ * Intent classification rule with patterns and priority
+ */
+export interface IntentRule {
+    intent: QueryIntent;
+    patterns: RegExp[];
+    priority: number;
+}
+/**
+ * Classifies a search query into one of three intent categories.
+ *
+ * Uses data-driven pattern matching to detect query intent.
+ * Rules are checked in priority order, with the first match winning.
+ *
+ * @param query - The search query string
+ * @returns The detected query intent (defaults to IMPLEMENTATION)
+ *
+ * @example
+ * classifyQueryIntent("where is the user controller") // → LOCATION
+ * classifyQueryIntent("how does authentication work") // → CONCEPTUAL
+ * classifyQueryIntent("how is the API implemented") // → IMPLEMENTATION
+ */
+export declare function classifyQueryIntent(query: string): QueryIntent;
+/**
+ * Add a custom intent rule (useful for testing or extensions).
+ *
+ * Returns a cleanup function that removes the added rule.
+ * This prevents test pollution and allows proper cleanup.
+ *
+ * @param rule - The intent rule to add
+ * @returns A cleanup function that removes the added rule
+ *
+ * @example
+ * const cleanup = addIntentRule({
+ *   intent: QueryIntent.LOCATION,
+ *   priority: 4,
+ *   patterns: [/custom pattern/]
+ * });
+ * // ... use the rule ...
+ * cleanup(); // removes the rule
+ */
+export declare function addIntentRule(rule: IntentRule): () => void;
+/**
+ * Get all patterns for a specific intent (useful for debugging).
+ *
+ * @param intent - The intent to get patterns for
+ * @returns Array of regex patterns for the intent
+ *
+ * @example
+ * const locationPatterns = getPatternsForIntent(QueryIntent.LOCATION);
+ */
+export declare function getPatternsForIntent(intent: QueryIntent): RegExp[];
+/**
+ * Get all intent rules (useful for testing/debugging).
+ *
+ * @returns A copy of the current intent rules
+ */
+export declare function getIntentRules(): IntentRule[];
+/**
+ * Reset intent rules to initial state.
+ *
+ * WARNING: This function is intended for testing only.
+ * It removes all custom rules added via addIntentRule().
+ * The original built-in rules are preserved.
+ *
+ * @example
+ * // In test cleanup
+ * afterEach(() => {
+ *   resetIntentRules();
+ * });
+ */
+export declare function resetIntentRules(): void;
+//# sourceMappingURL=intent-classifier.d.ts.map

package/dist/vectordb/intent-classifier.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"intent-classifier.d.ts","sourceRoot":"","sources":["../../src/vectordb/intent-classifier.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH;;GAEG;AACH,oBAAY,WAAW;IACrB,uEAAuE;IACvE,QAAQ,aAAa;IAErB,4EAA4E;IAC5E,UAAU,eAAe;IAEzB,uEAAuE;IACvE,cAAc,mBAAmB;CAClC;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,MAAM,EAAE,WAAW,CAAC;IACpB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;CAClB;AA0ED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM,GAAG,WAAW,CAe9D;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,UAAU,GAAG,MAAM,IAAI,CAe1D;AAED;;;;;;;;GAQG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,WAAW,GAAG,MAAM,EAAE,CAIlE;AAED;;;;GAIG;AACH,wBAAgB,cAAc,IAAI,UAAU,EAAE,CAE7C;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,gBAAgB,IAAI,IAAI,CAMvC"}

package/dist/vectordb/intent-classifier.js

@@ -0,0 +1,193 @@
+/**
+ * Query Intent Classification
+ *
+ * Classifies user search queries into three categories to apply
+ * appropriate relevance boosting strategies:
+ *
+ * - LOCATION: "Where is X?" - User wants to find specific files/code
+ * - CONCEPTUAL: "How does X work?" - User wants to understand concepts
+ * - IMPLEMENTATION: "How is X implemented?" - User wants implementation details
+ *
+ * Examples:
+ * - "where is the auth handler" → LOCATION
+ * - "how does authentication work" → CONCEPTUAL
+ * - "how is authentication implemented" → IMPLEMENTATION
+ */
+/**
+ * Query intent types for semantic search
+ */
+export var QueryIntent;
+(function (QueryIntent) {
+    /** User wants to locate specific files or code (e.g., "where is X") */
+    QueryIntent["LOCATION"] = "location";
+    /** User wants to understand concepts/processes (e.g., "how does X work") */
+    QueryIntent["CONCEPTUAL"] = "conceptual";
+    /** User wants implementation details (e.g., "how is X implemented") */
+    QueryIntent["IMPLEMENTATION"] = "implementation";
+})(QueryIntent || (QueryIntent = {}));
+/**
+ * Intent classification rules.
+ * Rules are checked in priority order (higher priority first).
+ */
+const INTENT_RULES = [
+    // LOCATION intent (highest priority - most specific)
+    {
+        intent: QueryIntent.LOCATION,
+        priority: 3,
+        patterns: [
+            /where\s+(is|are|does|can\s+i\s+find)/,
+            /find\s+the\s+/,
+            /locate\s+/,
+        ],
+    },
+    // CONCEPTUAL intent (medium priority)
+    {
+        intent: QueryIntent.CONCEPTUAL,
+        priority: 2,
+        patterns: [
+            /how\s+does\s+.*\s+work/,
+            /what\s+(is|are|does)/,
+            /explain\s+/,
+            /understand\s+/,
+            /\b(process|workflow|architecture)\b/,
+        ],
+    },
+    // IMPLEMENTATION intent (low priority - catches "how is X implemented")
+    {
+        intent: QueryIntent.IMPLEMENTATION,
+        priority: 1,
+        patterns: [
+            /how\s+(is|are)\s+.*\s+(implemented|built|coded)/,
+            /implementation\s+of/,
+            /source\s+code\s+for/,
+        ],
+    },
+];
+/**
+ * Capture the initial number of built-in rules.
+ * This is used by resetIntentRules() to distinguish built-in rules from custom rules.
+ */
+const INITIAL_RULE_COUNT = INTENT_RULES.length;
+/**
+ * Cached sorted rules to avoid re-sorting on every query.
+ * Invalidated when rules are modified via addIntentRule() or resetIntentRules().
+ */
+let cachedSortedRules = null;
+/**
+ * Get sorted rules (cached).
+ * Lazy-computes and caches the sorted array on first access.
+ */
+function getSortedRules() {
+    if (cachedSortedRules === null) {
+        cachedSortedRules = [...INTENT_RULES].sort((a, b) => b.priority - a.priority);
+    }
+    return cachedSortedRules;
+}
+/**
+ * Invalidate the sorted rules cache.
+ * Called when rules are modified.
+ */
+function invalidateSortedRulesCache() {
+    cachedSortedRules = null;
+}
+/**
+ * Classifies a search query into one of three intent categories.
+ *
+ * Uses data-driven pattern matching to detect query intent.
+ * Rules are checked in priority order, with the first match winning.
+ *
+ * @param query - The search query string
+ * @returns The detected query intent (defaults to IMPLEMENTATION)
+ *
+ * @example
+ * classifyQueryIntent("where is the user controller") // → LOCATION
+ * classifyQueryIntent("how does authentication work") // → CONCEPTUAL
+ * classifyQueryIntent("how is the API implemented") // → IMPLEMENTATION
+ */
+export function classifyQueryIntent(query) {
+    const lower = query.toLowerCase().trim();
+    // Use cached sorted rules to avoid re-sorting on every query
+    const sortedRules = getSortedRules();
+    for (const rule of sortedRules) {
+        if (rule.patterns.some(pattern => pattern.test(lower))) {
+            return rule.intent;
+        }
+    }
+    // Default to IMPLEMENTATION for ambiguous queries
+    // This is the most common use case for code search
+    return QueryIntent.IMPLEMENTATION;
+}
+/**
+ * Add a custom intent rule (useful for testing or extensions).
+ *
+ * Returns a cleanup function that removes the added rule.
+ * This prevents test pollution and allows proper cleanup.
+ *
+ * @param rule - The intent rule to add
+ * @returns A cleanup function that removes the added rule
+ *
+ * @example
+ * const cleanup = addIntentRule({
+ *   intent: QueryIntent.LOCATION,
+ *   priority: 4,
+ *   patterns: [/custom pattern/]
+ * });
+ * // ... use the rule ...
+ * cleanup(); // removes the rule
+ */
+export function addIntentRule(rule) {
+    INTENT_RULES.push(rule);
+    // Invalidate cache since rules have changed
+    invalidateSortedRulesCache();
+    // Return cleanup function to remove the rule
+    return () => {
+        const idx = INTENT_RULES.indexOf(rule);
+        if (idx !== -1) {
+            INTENT_RULES.splice(idx, 1);
+            // Invalidate cache since rules have changed
+            invalidateSortedRulesCache();
+        }
+    };
+}
+/**
+ * Get all patterns for a specific intent (useful for debugging).
+ *
+ * @param intent - The intent to get patterns for
+ * @returns Array of regex patterns for the intent
+ *
+ * @example
+ * const locationPatterns = getPatternsForIntent(QueryIntent.LOCATION);
+ */
+export function getPatternsForIntent(intent) {
+    return INTENT_RULES
+        .filter(rule => rule.intent === intent)
+        .flatMap(rule => rule.patterns);
+}
+/**
+ * Get all intent rules (useful for testing/debugging).
+ *
+ * @returns A copy of the current intent rules
+ */
+export function getIntentRules() {
+    return [...INTENT_RULES];
+}
+/**
+ * Reset intent rules to initial state.
+ *
+ * WARNING: This function is intended for testing only.
+ * It removes all custom rules added via addIntentRule().
+ * The original built-in rules are preserved.
+ *
+ * @example
+ * // In test cleanup
+ * afterEach(() => {
+ *   resetIntentRules();
+ * });
+ */
+export function resetIntentRules() {
+    // Remove all custom rules, preserving only the original built-in rules
+    INTENT_RULES.splice(INITIAL_RULE_COUNT);
+    // Invalidate cache since rules have changed
+    invalidateSortedRulesCache();
+}
+//# sourceMappingURL=intent-classifier.js.map

package/dist/vectordb/intent-classifier.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"intent-classifier.js","sourceRoot":"","sources":["../../src/vectordb/intent-classifier.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH;;GAEG;AACH,MAAM,CAAN,IAAY,WASX;AATD,WAAY,WAAW;IACrB,uEAAuE;IACvE,oCAAqB,CAAA;IAErB,4EAA4E;IAC5E,wCAAyB,CAAA;IAEzB,uEAAuE;IACvE,gDAAiC,CAAA;AACnC,CAAC,EATW,WAAW,KAAX,WAAW,QAStB;AAWD;;;GAGG;AACH,MAAM,YAAY,GAAiB;IACjC,qDAAqD;IACrD;QACE,MAAM,EAAE,WAAW,CAAC,QAAQ;QAC5B,QAAQ,EAAE,CAAC;QACX,QAAQ,EAAE;YACR,sCAAsC;YACtC,eAAe;YACf,WAAW;SACZ;KACF;IAED,sCAAsC;IACtC;QACE,MAAM,EAAE,WAAW,CAAC,UAAU;QAC9B,QAAQ,EAAE,CAAC;QACX,QAAQ,EAAE;YACR,wBAAwB;YACxB,sBAAsB;YACtB,YAAY;YACZ,eAAe;YACf,qCAAqC;SACtC;KACF;IAED,wEAAwE;IACxE;QACE,MAAM,EAAE,WAAW,CAAC,cAAc;QAClC,QAAQ,EAAE,CAAC;QACX,QAAQ,EAAE;YACR,iDAAiD;YACjD,qBAAqB;YACrB,qBAAqB;SACtB;KACF;CACF,CAAC;AAEF;;;GAGG;AACH,MAAM,kBAAkB,GAAG,YAAY,CAAC,MAAM,CAAC;AAE/C;;;GAGG;AACH,IAAI,iBAAiB,GAAwB,IAAI,CAAC;AAElD;;;GAGG;AACH,SAAS,cAAc;IACrB,IAAI,iBAAiB,KAAK,IAAI,EAAE,CAAC;QAC/B,iBAAiB,GAAG,CAAC,GAAG,YAAY,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,GAAG,CAAC,CAAC,QAAQ,CAAC,CAAC;IAChF,CAAC;IACD,OAAO,iBAAiB,CAAC;AAC3B,CAAC;AAED;;;GAGG;AACH,SAAS,0BAA0B;IACjC,iBAAiB,GAAG,IAAI,CAAC;AAC3B,CAAC;AAED;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,mBAAmB,CAAC,KAAa;IAC/C,MAAM,KAAK,GAAG,KAAK,CAAC,WAAW,EAAE,CAAC,IAAI,EAAE,CAAC;IAEzC,6DAA6D;IAC7D,MAAM,WAAW,GAAG,cAAc,EAAE,CAAC;IAErC,KAAK,MAAM,IAAI,IAAI,WAAW,EAAE,CAAC;QAC/B,IAAI,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC;YACvD,OAAO,IAAI,CAAC,MAAM,CAAC;QACrB,CAAC;IACH,CAAC;IAED,kDAAkD;IAClD,mDAAmD;IACnD,OAAO,WAAW,CAAC,cAAc,CAAC;AACpC,CAAC;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,UAAU,aAAa,CAAC,IAAgB;IAC5C,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAExB,4CAA4C;IAC5C,0BAA0B,EAAE,CAAC;IAE7B,6CAA6C;IAC7C,OAAO,GAAG,EAAE;QACV,MAAM,GAAG,GAAG,YAAY,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;QACvC,IAAI,GAAG,KAAK,CAAC,CAAC,EAAE,CAAC;YACf,YAAY,CAAC,MAAM,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC;YAC5B,4CAA4C;YAC5C,0BAA0B,EAAE,CAAC;QAC/B,CAAC;IACH,CAAC,CAAC;AACJ,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,oBAAoB,CAAC,MAAmB;IACtD,OAAO,YAAY;SAChB,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,MAAM,KAAK,MAAM,CAAC;SACtC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;AACpC,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,cAAc;IAC5B,OAAO,CAAC,GAAG,YAAY,CAAC,CAAC;AAC3B,CAAC;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,gBAAgB;IAC9B,uEAAuE;IACvE,YAAY,CAAC,MAAM,CAAC,kBAAkB,CAAC,CAAC;IAExC,4CAA4C;IAC5C,0BAA0B,EAAE,CAAC;AAC/B,CAAC"}

package/dist/vectordb/lancedb.d.ts

@@ -0,0 +1,45 @@
+import { SearchResult, VectorDBInterface } from './types.js';
+import { ChunkMetadata } from '../indexer/types.js';
+export declare class VectorDB implements VectorDBInterface {
+    private db;
+    private table;
+    readonly dbPath: string;
+    private readonly tableName;
+    private lastVersionCheck;
+    private currentVersion;
+    constructor(projectRoot: string);
+    initialize(): Promise<void>;
+    insertBatch(vectors: Float32Array[], metadatas: ChunkMetadata[], contents: string[]): Promise<void>;
+    search(queryVector: Float32Array, limit?: number, query?: string): Promise<SearchResult[]>;
+    scanWithFilter(options: {
+        language?: string;
+        pattern?: string;
+        limit?: number;
+    }): Promise<SearchResult[]>;
+    /**
+     * Scan all chunks in the database
+     * Fetches total count first, then retrieves all chunks in a single optimized query
+     * @param options - Filter options (language, pattern)
+     * @returns All matching chunks
+     */
+    scanAll(options?: {
+        language?: string;
+        pattern?: string;
+    }): Promise<SearchResult[]>;
+    querySymbols(options: {
+        language?: string;
+        pattern?: string;
+        symbolType?: 'function' | 'class' | 'interface';
+        limit?: number;
+    }): Promise<SearchResult[]>;
+    clear(): Promise<void>;
+    deleteByFile(filepath: string): Promise<void>;
+    updateFile(filepath: string, vectors: Float32Array[], metadatas: ChunkMetadata[], contents: string[]): Promise<void>;
+    checkVersion(): Promise<boolean>;
+    reconnect(): Promise<void>;
+    getCurrentVersion(): number;
+    getVersionDate(): string;
+    hasData(): Promise<boolean>;
+    static load(projectRoot: string): Promise<VectorDB>;
+}
+//# sourceMappingURL=lancedb.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"lancedb.d.ts","sourceRoot":"","sources":["../../src/vectordb/lancedb.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,YAAY,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAC7D,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAWpD,qBAAa,QAAS,YAAW,iBAAiB;IAChD,OAAO,CAAC,EAAE,CAAkC;IAC5C,OAAO,CAAC,KAAK,CAA6B;IAC1C,SAAgB,MAAM,EAAE,MAAM,CAAC;IAC/B,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAiB;IAC3C,OAAO,CAAC,gBAAgB,CAAa;IACrC,OAAO,CAAC,cAAc,CAAa;gBAEvB,WAAW,EAAE,MAAM;IAmBzB,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAuB3B,WAAW,CACf,OAAO,EAAE,YAAY,EAAE,EACvB,SAAS,EAAE,aAAa,EAAE,EAC1B,QAAQ,EAAE,MAAM,EAAE,GACjB,OAAO,CAAC,IAAI,CAAC;IAgBV,MAAM,CACV,WAAW,EAAE,YAAY,EACzB,KAAK,GAAE,MAAU,EACjB,KAAK,CAAC,EAAE,MAAM,GACb,OAAO,CAAC,YAAY,EAAE,CAAC;IA+BpB,cAAc,CAAC,OAAO,EAAE;QAC5B,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,KAAK,CAAC,EAAE,MAAM,CAAC;KAChB,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC;IAO3B;;;;;OAKG;IACG,OAAO,CAAC,OAAO,GAAE;QACrB,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,OAAO,CAAC,EAAE,MAAM,CAAC;KACb,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC;IAO1B,YAAY,CAAC,OAAO,EAAE;QAC1B,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,UAAU,CAAC,EAAE,UAAU,GAAG,OAAO,GAAG,WAAW,CAAC;QAChD,KAAK,CAAC,EAAE,MAAM,CAAC;KAChB,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC;IAOrB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAStB,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAO7C,UAAU,CACd,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,YAAY,EAAE,EACvB,SAAS,EAAE,aAAa,EAAE,EAC1B,QAAQ,EAAE,MAAM,EAAE,GACjB,OAAO,CAAC,IAAI,CAAC;IAmBV,YAAY,IAAI,OAAO,CAAC,OAAO,CAAC;IAyBhC,SAAS,IAAI,OAAO,CAAC,IAAI,CAAC;IAahC,iBAAiB,IAAI,MAAM;IAI3B,cAAc,IAAI,MAAM;IAOlB,OAAO,IAAI,OAAO,CAAC,OAAO,CAAC;WA8BpB,IAAI,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC;CAK1D"}