@liendev/core 0.19.5

package/dist/utils/result.d.ts

@@ -0,0 +1,65 @@
+/**
+ * Result type for explicit error handling.
+ *
+ * Provides a type-safe alternative to throwing exceptions, making error
+ * handling explicit in function signatures.
+ *
+ * @example
+ * ```typescript
+ * function divide(a: number, b: number): Result<number, string> {
+ *   if (b === 0) {
+ *     return Err('Division by zero');
+ *   }
+ *   return Ok(a / b);
+ * }
+ *
+ * const result = divide(10, 2);
+ * if (isOk(result)) {
+ *   console.log(result.value); // 5
+ * } else {
+ *   console.error(result.error);
+ * }
+ * ```
+ */
+/**
+ * Result type representing either success (Ok) or failure (Err)
+ */
+export type Result<T, E = Error> = {
+    ok: true;
+    value: T;
+} | {
+    ok: false;
+    error: E;
+};
+/**
+ * Creates a successful Result containing a value
+ */
+export declare function Ok<T>(value: T): Result<T, never>;
+/**
+ * Creates a failed Result containing an error
+ */
+export declare function Err<E>(error: E): Result<never, E>;
+/**
+ * Type guard to check if a Result is Ok
+ */
+export declare function isOk<T, E>(result: Result<T, E>): result is {
+    ok: true;
+    value: T;
+};
+/**
+ * Type guard to check if a Result is Err
+ */
+export declare function isErr<T, E>(result: Result<T, E>): result is {
+    ok: false;
+    error: E;
+};
+/**
+ * Unwraps a Result, throwing if it's an error
+ * @throws {E} The error if Result is Err
+ */
+export declare function unwrap<T, E>(result: Result<T, E>): T;
+/**
+ * Unwraps a Result or returns a default value if it's an error
+ */
+export declare function unwrapOr<T, E>(result: Result<T, E>, defaultValue: T): T;
+//# sourceMappingURL=result.d.ts.map

package/dist/utils/result.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"result.d.ts","sourceRoot":"","sources":["../../src/utils/result.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH;;GAEG;AACH,MAAM,MAAM,MAAM,CAAC,CAAC,EAAE,CAAC,GAAG,KAAK,IAC3B;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,KAAK,EAAE,CAAC,CAAA;CAAE,GACtB;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,CAAC,CAAA;CAAE,CAAC;AAE5B;;GAEG;AACH,wBAAgB,EAAE,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,GAAG,MAAM,CAAC,CAAC,EAAE,KAAK,CAAC,CAEhD;AAED;;GAEG;AACH,wBAAgB,GAAG,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,GAAG,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC,CAEjD;AAED;;GAEG;AACH,wBAAgB,IAAI,CAAC,CAAC,EAAE,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,MAAM,IAAI;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,KAAK,EAAE,CAAC,CAAA;CAAE,CAEjF;AAED;;GAEG;AACH,wBAAgB,KAAK,CAAC,CAAC,EAAE,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,MAAM,IAAI;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,CAAC,CAAA;CAAE,CAEnF;AAED;;;GAGG;AACH,wBAAgB,MAAM,CAAC,CAAC,EAAE,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,CAAC,CAKpD;AAED;;GAEG;AACH,wBAAgB,QAAQ,CAAC,CAAC,EAAE,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,YAAY,EAAE,CAAC,GAAG,CAAC,CAKvE"}

package/dist/utils/result.js

@@ -0,0 +1,67 @@
+/**
+ * Result type for explicit error handling.
+ *
+ * Provides a type-safe alternative to throwing exceptions, making error
+ * handling explicit in function signatures.
+ *
+ * @example
+ * ```typescript
+ * function divide(a: number, b: number): Result<number, string> {
+ *   if (b === 0) {
+ *     return Err('Division by zero');
+ *   }
+ *   return Ok(a / b);
+ * }
+ *
+ * const result = divide(10, 2);
+ * if (isOk(result)) {
+ *   console.log(result.value); // 5
+ * } else {
+ *   console.error(result.error);
+ * }
+ * ```
+ */
+/**
+ * Creates a successful Result containing a value
+ */
+export function Ok(value) {
+    return { ok: true, value };
+}
+/**
+ * Creates a failed Result containing an error
+ */
+export function Err(error) {
+    return { ok: false, error };
+}
+/**
+ * Type guard to check if a Result is Ok
+ */
+export function isOk(result) {
+    return result.ok;
+}
+/**
+ * Type guard to check if a Result is Err
+ */
+export function isErr(result) {
+    return !result.ok;
+}
+/**
+ * Unwraps a Result, throwing if it's an error
+ * @throws {E} The error if Result is Err
+ */
+export function unwrap(result) {
+    if (isOk(result)) {
+        return result.value;
+    }
+    throw result.error;
+}
+/**
+ * Unwraps a Result or returns a default value if it's an error
+ */
+export function unwrapOr(result, defaultValue) {
+    if (isOk(result)) {
+        return result.value;
+    }
+    return defaultValue;
+}
+//# sourceMappingURL=result.js.map

package/dist/utils/result.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"result.js","sourceRoot":"","sources":["../../src/utils/result.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AASH;;GAEG;AACH,MAAM,UAAU,EAAE,CAAI,KAAQ;IAC5B,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC;AAC7B,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,GAAG,CAAI,KAAQ;IAC7B,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC;AAC9B,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,IAAI,CAAO,MAAoB;IAC7C,OAAO,MAAM,CAAC,EAAE,CAAC;AACnB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,KAAK,CAAO,MAAoB;IAC9C,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;AACpB,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,MAAM,CAAO,MAAoB;IAC/C,IAAI,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC;QACjB,OAAO,MAAM,CAAC,KAAK,CAAC;IACtB,CAAC;IACD,MAAM,MAAM,CAAC,KAAK,CAAC;AACrB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,QAAQ,CAAO,MAAoB,EAAE,YAAe;IAClE,IAAI,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC;QACjB,OAAO,MAAM,CAAC,KAAK,CAAC;IACtB,CAAC;IACD,OAAO,YAAY,CAAC;AACtB,CAAC"}

package/dist/utils/version.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Version utilities for @liendev/core
+ *
+ * Core package has its own version. When CLI uses core,
+ * it can override this with its own package version.
+ */
+/**
+ * Get the current package version
+ */
+export declare function getPackageVersion(): string;
+/**
+ * Set the package version (used by CLI to override with its version)
+ */
+export declare function setPackageVersion(version: string): void;
+/**
+ * Get the full package info (for compatibility)
+ */
+export declare function getPackageInfo(): {
+    version: string;
+    name: string;
+};
+//# sourceMappingURL=version.d.ts.map

package/dist/utils/version.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.d.ts","sourceRoot":"","sources":["../../src/utils/version.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAMH;;GAEG;AACH,wBAAgB,iBAAiB,IAAI,MAAM,CAE1C;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAEvD;AAED;;GAEG;AACH,wBAAgB,cAAc,IAAI;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAElE"}

package/dist/utils/version.js

@@ -0,0 +1,28 @@
+/**
+ * Version utilities for @liendev/core
+ *
+ * Core package has its own version. When CLI uses core,
+ * it can override this with its own package version.
+ */
+// Default version for core
+// In a real build, this would be injected or read from package.json
+let coreVersion = '0.1.0';
+/**
+ * Get the current package version
+ */
+export function getPackageVersion() {
+    return coreVersion;
+}
+/**
+ * Set the package version (used by CLI to override with its version)
+ */
+export function setPackageVersion(version) {
+    coreVersion = version;
+}
+/**
+ * Get the full package info (for compatibility)
+ */
+export function getPackageInfo() {
+    return { version: coreVersion, name: '@liendev/core' };
+}
+//# sourceMappingURL=version.js.map

package/dist/utils/version.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.js","sourceRoot":"","sources":["../../src/utils/version.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,2BAA2B;AAC3B,oEAAoE;AACpE,IAAI,WAAW,GAAG,OAAO,CAAC;AAE1B;;GAEG;AACH,MAAM,UAAU,iBAAiB;IAC/B,OAAO,WAAW,CAAC;AACrB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,iBAAiB,CAAC,OAAe;IAC/C,WAAW,GAAG,OAAO,CAAC;AACxB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,cAAc;IAC5B,OAAO,EAAE,OAAO,EAAE,WAAW,EAAE,IAAI,EAAE,eAAe,EAAE,CAAC;AACzD,CAAC"}

package/dist/vectordb/batch-insert.d.ts

@@ -0,0 +1,14 @@
+import { ChunkMetadata } from '../indexer/types.js';
+type LanceDBConnection = any;
+type LanceDBTable = any;
+/**
+ * Insert a batch of vectors into the database
+ *
+ * @returns The table instance after insertion, or null only when:
+ *          - vectors.length === 0 AND table === null (no-op case)
+ *          For non-empty batches, always returns a valid table or throws.
+ * @throws {DatabaseError} If database not initialized or insertion fails
+ */
+export declare function insertBatch(db: LanceDBConnection, table: LanceDBTable | null, tableName: string, vectors: Float32Array[], metadatas: ChunkMetadata[], contents: string[]): Promise<LanceDBTable | null>;
+export {};
+//# sourceMappingURL=batch-insert.d.ts.map

package/dist/vectordb/batch-insert.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"batch-insert.d.ts","sourceRoot":"","sources":["../../src/vectordb/batch-insert.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAOpD,KAAK,iBAAiB,GAAG,GAAG,CAAC;AAC7B,KAAK,YAAY,GAAG,GAAG,CAAC;AAiHxB;;;;;;;GAOG;AACH,wBAAsB,WAAW,CAC/B,EAAE,EAAE,iBAAiB,EACrB,KAAK,EAAE,YAAY,GAAG,IAAI,EAC1B,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,YAAY,EAAE,EACvB,SAAS,EAAE,aAAa,EAAE,EAC1B,QAAQ,EAAE,MAAM,EAAE,GACjB,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC,CAmC9B"}

package/dist/vectordb/batch-insert.js

@@ -0,0 +1,185 @@
+import { DatabaseError } from '../errors/index.js';
+import { VECTOR_DB_MAX_BATCH_SIZE, VECTOR_DB_MIN_BATCH_SIZE } from '../constants.js';
+/**
+ * Transform a chunk's data into a database record.
+ * Handles missing/empty metadata by providing defaults for Arrow type inference.
+ */
+function transformChunkToRecord(vector, content, metadata) {
+    return {
+        vector: Array.from(vector),
+        content,
+        file: metadata.file,
+        startLine: metadata.startLine,
+        endLine: metadata.endLine,
+        type: metadata.type,
+        language: metadata.language,
+        // Ensure arrays have at least empty string for Arrow type inference
+        functionNames: getNonEmptyArray(metadata.symbols?.functions),
+        classNames: getNonEmptyArray(metadata.symbols?.classes),
+        interfaceNames: getNonEmptyArray(metadata.symbols?.interfaces),
+        // AST-derived metadata (v0.13.0)
+        symbolName: metadata.symbolName || '',
+        symbolType: metadata.symbolType || '',
+        parentClass: metadata.parentClass || '',
+        complexity: metadata.complexity || 0,
+        cognitiveComplexity: metadata.cognitiveComplexity || 0,
+        parameters: getNonEmptyArray(metadata.parameters),
+        signature: metadata.signature || '',
+        imports: getNonEmptyArray(metadata.imports),
+        // Halstead metrics (v0.19.0)
+        halsteadVolume: metadata.halsteadVolume || 0,
+        halsteadDifficulty: metadata.halsteadDifficulty || 0,
+        halsteadEffort: metadata.halsteadEffort || 0,
+        halsteadBugs: metadata.halsteadBugs || 0,
+    };
+}
+/**
+ * Returns the array if non-empty, otherwise returns [''] for Arrow type inference
+ */
+function getNonEmptyArray(arr) {
+    return arr && arr.length > 0 ? arr : [''];
+}
+/**
+ * Split a batch in half for retry logic
+ */
+function splitBatchInHalf(batch) {
+    const half = Math.floor(batch.vectors.length / 2);
+    return [
+        {
+            vectors: batch.vectors.slice(0, half),
+            metadatas: batch.metadatas.slice(0, half),
+            contents: batch.contents.slice(0, half),
+        },
+        {
+            vectors: batch.vectors.slice(half),
+            metadatas: batch.metadatas.slice(half),
+            contents: batch.contents.slice(half),
+        },
+    ];
+}
+/**
+ * Transform all chunks in a batch to database records
+ */
+function transformBatchToRecords(batch) {
+    return batch.vectors.map((vector, i) => transformChunkToRecord(vector, batch.contents[i], batch.metadatas[i]));
+}
+/**
+ * Insert a batch of vectors into the database
+ *
+ * @returns The table instance after insertion, or null only when:
+ *          - vectors.length === 0 AND table === null (no-op case)
+ *          For non-empty batches, always returns a valid table or throws.
+ * @throws {DatabaseError} If database not initialized or insertion fails
+ */
+export async function insertBatch(db, table, tableName, vectors, metadatas, contents) {
+    if (!db) {
+        throw new DatabaseError('Vector database not initialized');
+    }
+    if (vectors.length !== metadatas.length || vectors.length !== contents.length) {
+        throw new DatabaseError('Vectors, metadatas, and contents arrays must have the same length', {
+            vectorsLength: vectors.length,
+            metadatasLength: metadatas.length,
+            contentsLength: contents.length,
+        });
+    }
+    // Handle empty batch gracefully - return table as-is (could be null)
+    if (vectors.length === 0) {
+        return table;
+    }
+    // Split large batches into smaller chunks
+    if (vectors.length > VECTOR_DB_MAX_BATCH_SIZE) {
+        let currentTable = table;
+        for (let i = 0; i < vectors.length; i += VECTOR_DB_MAX_BATCH_SIZE) {
+            const batchVectors = vectors.slice(i, Math.min(i + VECTOR_DB_MAX_BATCH_SIZE, vectors.length));
+            const batchMetadata = metadatas.slice(i, Math.min(i + VECTOR_DB_MAX_BATCH_SIZE, vectors.length));
+            const batchContents = contents.slice(i, Math.min(i + VECTOR_DB_MAX_BATCH_SIZE, vectors.length));
+            currentTable = await insertBatchInternal(db, currentTable, tableName, batchVectors, batchMetadata, batchContents);
+        }
+        if (!currentTable) {
+            throw new DatabaseError('Failed to create table during batch insert');
+        }
+        return currentTable;
+    }
+    else {
+        return insertBatchInternal(db, table, tableName, vectors, metadatas, contents);
+    }
+}
+/**
+ * Internal method to insert a single batch with iterative retry logic.
+ * Uses a queue-based approach to handle batch splitting on failure.
+ *
+ * @returns Always returns a valid LanceDBTable or throws DatabaseError
+ */
+async function insertBatchInternal(db, table, tableName, vectors, metadatas, contents) {
+    const queue = [{ vectors, metadatas, contents }];
+    const failedBatches = [];
+    let currentTable = table;
+    let lastError;
+    while (queue.length > 0) {
+        const batch = queue.shift();
+        const insertResult = await tryInsertBatch(db, currentTable, tableName, batch);
+        if (insertResult.success) {
+            currentTable = insertResult.table;
+        }
+        else {
+            lastError = insertResult.error;
+            handleBatchFailure(batch, queue, failedBatches);
+        }
+    }
+    throwIfBatchesFailed(failedBatches, lastError);
+    if (!currentTable) {
+        throw new DatabaseError('Failed to create table during batch insert');
+    }
+    return currentTable;
+}
+/**
+ * Attempt to insert a batch of records into the database.
+ * Errors are captured and returned (not thrown) to support retry logic.
+ */
+async function tryInsertBatch(db, currentTable, tableName, batch) {
+    try {
+        const records = transformBatchToRecords(batch);
+        if (!currentTable) {
+            const newTable = await db.createTable(tableName, records);
+            return { success: true, table: newTable };
+        }
+        else {
+            await currentTable.add(records);
+            return { success: true, table: currentTable };
+        }
+    }
+    catch (error) {
+        // Error is captured for retry logic - will be included in final error if all retries fail
+        return { success: false, table: currentTable, error: error };
+    }
+}
+/**
+ * Handle a failed batch insertion by either splitting and retrying or marking as failed
+ */
+function handleBatchFailure(batch, queue, failedBatches) {
+    if (batch.vectors.length > VECTOR_DB_MIN_BATCH_SIZE) {
+        // Split and retry
+        const [firstHalf, secondHalf] = splitBatchInHalf(batch);
+        queue.push(firstHalf, secondHalf);
+    }
+    else {
+        // Can't split further, mark as failed
+        failedBatches.push(batch);
+    }
+}
+/**
+ * Throw an error if any batches failed after all retry attempts.
+ * Includes the last error encountered for debugging.
+ */
+function throwIfBatchesFailed(failedBatches, lastError) {
+    if (failedBatches.length === 0)
+        return;
+    const totalFailed = failedBatches.reduce((sum, batch) => sum + batch.vectors.length, 0);
+    throw new DatabaseError(`Failed to insert ${totalFailed} record(s) after retry attempts`, {
+        failedBatches: failedBatches.length,
+        totalRecords: totalFailed,
+        sampleFile: failedBatches[0].metadatas[0].file,
+        lastError: lastError?.message,
+    });
+}
+//# sourceMappingURL=batch-insert.js.map

package/dist/vectordb/batch-insert.js.map

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

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

@@ -0,0 +1,51 @@
+import type { BoostingStrategy } from './types.js';
+/**
+ * Composes multiple boosting strategies into a single pipeline.
+ *
+ * Strategies are applied sequentially, with each strategy
+ * receiving the output of the previous strategy as input.
+ *
+ * @example
+ * ```typescript
+ * const composer = new BoostingComposer()
+ *   .addStrategy(new PathBoostingStrategy())
+ *   .addStrategy(new FilenameBoostingStrategy())
+ *   .addStrategy(new FileTypeBoostingStrategy(intent));
+ *
+ * const boostedScore = composer.apply(query, filepath, baseScore);
+ * ```
+ */
+export declare class BoostingComposer {
+    private strategies;
+    /**
+     * Add a boosting strategy to the pipeline.
+     * Strategies are applied in the order they are added.
+     *
+     * @param strategy - The strategy to add
+     * @returns This composer for chaining
+     */
+    addStrategy(strategy: BoostingStrategy): this;
+    /**
+     * Apply all strategies to a base score.
+     *
+     * @param query - The search query
+     * @param filepath - The file path being scored
+     * @param baseScore - The initial score from vector similarity
+     * @returns The final boosted score after all strategies
+     */
+    apply(query: string, filepath: string, baseScore: number): number;
+    /**
+     * Get the names of all strategies in this composer.
+     * Useful for debugging and logging.
+     */
+    getStrategyNames(): string[];
+    /**
+     * Get the number of strategies in this composer.
+     */
+    getStrategyCount(): number;
+    /**
+     * Clear all strategies from this composer.
+     */
+    clear(): void;
+}
+//# sourceMappingURL=composer.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"composer.d.ts","sourceRoot":"","sources":["../../../src/vectordb/boosting/composer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAEnD;;;;;;;;;;;;;;;GAeG;AACH,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,UAAU,CAA0B;IAE5C;;;;;;OAMG;IACH,WAAW,CAAC,QAAQ,EAAE,gBAAgB,GAAG,IAAI;IAK7C;;;;;;;OAOG;IACH,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM;IAUjE;;;OAGG;IACH,gBAAgB,IAAI,MAAM,EAAE;IAI5B;;OAEG;IACH,gBAAgB,IAAI,MAAM;IAI1B;;OAEG;IACH,KAAK,IAAI,IAAI;CAGd"}

package/dist/vectordb/boosting/composer.js

@@ -0,0 +1,65 @@
+/**
+ * Composes multiple boosting strategies into a single pipeline.
+ *
+ * Strategies are applied sequentially, with each strategy
+ * receiving the output of the previous strategy as input.
+ *
+ * @example
+ * ```typescript
+ * const composer = new BoostingComposer()
+ *   .addStrategy(new PathBoostingStrategy())
+ *   .addStrategy(new FilenameBoostingStrategy())
+ *   .addStrategy(new FileTypeBoostingStrategy(intent));
+ *
+ * const boostedScore = composer.apply(query, filepath, baseScore);
+ * ```
+ */
+export class BoostingComposer {
+    strategies = [];
+    /**
+     * Add a boosting strategy to the pipeline.
+     * Strategies are applied in the order they are added.
+     *
+     * @param strategy - The strategy to add
+     * @returns This composer for chaining
+     */
+    addStrategy(strategy) {
+        this.strategies.push(strategy);
+        return this;
+    }
+    /**
+     * Apply all strategies to a base score.
+     *
+     * @param query - The search query
+     * @param filepath - The file path being scored
+     * @param baseScore - The initial score from vector similarity
+     * @returns The final boosted score after all strategies
+     */
+    apply(query, filepath, baseScore) {
+        let score = baseScore;
+        for (const strategy of this.strategies) {
+            score = strategy.apply(query, filepath, score);
+        }
+        return score;
+    }
+    /**
+     * Get the names of all strategies in this composer.
+     * Useful for debugging and logging.
+     */
+    getStrategyNames() {
+        return this.strategies.map(s => s.name);
+    }
+    /**
+     * Get the number of strategies in this composer.
+     */
+    getStrategyCount() {
+        return this.strategies.length;
+    }
+    /**
+     * Clear all strategies from this composer.
+     */
+    clear() {
+        this.strategies = [];
+    }
+}
+//# sourceMappingURL=composer.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"composer.js","sourceRoot":"","sources":["../../../src/vectordb/boosting/composer.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;GAeG;AACH,MAAM,OAAO,gBAAgB;IACnB,UAAU,GAAuB,EAAE,CAAC;IAE5C;;;;;;OAMG;IACH,WAAW,CAAC,QAA0B;QACpC,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QAC/B,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;;;;;;OAOG;IACH,KAAK,CAAC,KAAa,EAAE,QAAgB,EAAE,SAAiB;QACtD,IAAI,KAAK,GAAG,SAAS,CAAC;QAEtB,KAAK,MAAM,QAAQ,IAAI,IAAI,CAAC,UAAU,EAAE,CAAC;YACvC,KAAK,GAAG,QAAQ,CAAC,KAAK,CAAC,KAAK,EAAE,QAAQ,EAAE,KAAK,CAAC,CAAC;QACjD,CAAC;QAED,OAAO,KAAK,CAAC;IACf,CAAC;IAED;;;OAGG;IACH,gBAAgB;QACd,OAAO,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;IAC1C,CAAC;IAED;;OAEG;IACH,gBAAgB;QACd,OAAO,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC;IAChC,CAAC;IAED;;OAEG;IACH,KAAK;QACH,IAAI,CAAC,UAAU,GAAG,EAAE,CAAC;IACvB,CAAC;CACF"}

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

@@ -0,0 +1,22 @@
+/**
+ * Composable boosting strategies for semantic search relevance.
+ *
+ * This module provides a strategy pattern implementation for applying
+ * relevance boosting to search results. Strategies can be composed
+ * together to create complex boosting pipelines.
+ *
+ * @example
+ * ```typescript
+ * import { BoostingComposer, PathBoostingStrategy, FilenameBoostingStrategy } from './boosting';
+ *
+ * const composer = new BoostingComposer()
+ *   .addStrategy(new PathBoostingStrategy())
+ *   .addStrategy(new FilenameBoostingStrategy());
+ *
+ * const boostedScore = composer.apply(query, filepath, baseScore);
+ * ```
+ */
+export * from './types.js';
+export * from './strategies.js';
+export * from './composer.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/vectordb/boosting/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,cAAc,YAAY,CAAC;AAC3B,cAAc,iBAAiB,CAAC;AAChC,cAAc,eAAe,CAAC"}

package/dist/vectordb/boosting/index.js

@@ -0,0 +1,22 @@
+/**
+ * Composable boosting strategies for semantic search relevance.
+ *
+ * This module provides a strategy pattern implementation for applying
+ * relevance boosting to search results. Strategies can be composed
+ * together to create complex boosting pipelines.
+ *
+ * @example
+ * ```typescript
+ * import { BoostingComposer, PathBoostingStrategy, FilenameBoostingStrategy } from './boosting';
+ *
+ * const composer = new BoostingComposer()
+ *   .addStrategy(new PathBoostingStrategy())
+ *   .addStrategy(new FilenameBoostingStrategy());
+ *
+ * const boostedScore = composer.apply(query, filepath, baseScore);
+ * ```
+ */
+export * from './types.js';
+export * from './strategies.js';
+export * from './composer.js';
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/vectordb/boosting/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,cAAc,YAAY,CAAC;AAC3B,cAAc,iBAAiB,CAAC;AAChC,cAAc,eAAe,CAAC"}

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

@@ -0,0 +1,40 @@
+import type { BoostingStrategy } from './types.js';
+import { QueryIntent } from '../intent-classifier.js';
+/**
+ * Boosting Strategies
+ */
+/**
+ * Boosts relevance based on path segment matching.
+ * Files with query tokens in their path are boosted.
+ */
+export declare class PathBoostingStrategy implements BoostingStrategy {
+    name: string;
+    apply(query: string, filepath: string, baseScore: number): number;
+}
+/**
+ * Boosts relevance based on filename matching.
+ * Files with query tokens in their filename are strongly boosted.
+ */
+export declare class FilenameBoostingStrategy implements BoostingStrategy {
+    name: string;
+    apply(query: string, filepath: string, baseScore: number): number;
+}
+/**
+ * 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 declare class FileTypeBoostingStrategy implements BoostingStrategy {
+    private intent;
+    name: string;
+    constructor(intent: QueryIntent);
+    apply(query: string, filepath: string, baseScore: number): number;
+    private applyLocationBoosting;
+    private applyConceptualBoosting;
+    private applyImplementationBoosting;
+}
+//# sourceMappingURL=strategies.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"strategies.d.ts","sourceRoot":"","sources":["../../../src/vectordb/boosting/strategies.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAEnD,OAAO,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAiFtD;;GAEG;AAEH;;;GAGG;AACH,qBAAa,oBAAqB,YAAW,gBAAgB;IAC3D,IAAI,SAAmB;IAEvB,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM;CAelE;AAED;;;GAGG;AACH,qBAAa,wBAAyB,YAAW,gBAAgB;IAC/D,IAAI,SAAuB;IAE3B,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM;CAkBlE;AAED;;;;;;;;GAQG;AACH,qBAAa,wBAAyB,YAAW,gBAAgB;IAGnD,OAAO,CAAC,MAAM;IAF1B,IAAI,SAAe;gBAEC,MAAM,EAAE,WAAW;IAEvC,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM;IAgBjE,OAAO,CAAC,qBAAqB;IAa7B,OAAO,CAAC,uBAAuB;IA2B/B,OAAO,CAAC,2BAA2B;CAYpC"}