rag-lite-ts 2.0.3 → 2.0.4

package/dist/index-manager.js

@@ -1,5 +1,5 @@
 import { VectorIndex } from './core/vector-index.js';
-import { openDatabase, getModelVersion, setModelVersion, getStoredModelInfo, setStoredModelInfo } from './core/db.js';
+import { openDatabase, getSystemInfo, setSystemInfo } from './core/db.js';
 import { config, getModelDefaults } from './core/config.js';
 export class IndexManager {
     modelName;
@@ -71,15 +71,15 @@ export class IndexManager {
         }
         try {
             // Get stored model information
-            const storedModel = await getStoredModelInfo(this.db);
+            const systemInfo = await getSystemInfo(this.db);
             const currentModel = this.modelName || config.embedding_model;
             const currentDefaults = getModelDefaults(currentModel);
-            if (storedModel) {
+            if (systemInfo && systemInfo.modelName && systemInfo.modelDimensions) {
                 // Check if models match
-                if (storedModel.modelName !== currentModel) {
+                if (systemInfo.modelName !== currentModel) {
                     throw new Error(`Model mismatch detected!\n` +
                         `Current model: ${currentModel} (${currentDefaults.dimensions} dimensions)\n` +
-                        `Index model: ${storedModel.modelName} (${storedModel.dimensions} dimensions)\n` +
+                        `Index model: ${systemInfo.modelName} (${systemInfo.modelDimensions} dimensions)\n` +
                         `\n` +
                         `The embedding model has changed since the index was created.\n` +
                         `This requires a full index rebuild to maintain consistency.\n` +
@@ -91,10 +91,10 @@ export class IndexManager {
                         `This will regenerate all embeddings with the new model.`);
                 }
                 // Check if dimensions match (additional safety check)
-                if (storedModel.dimensions !== currentDefaults.dimensions) {
+                if (systemInfo.modelDimensions !== currentDefaults.dimensions) {
                     throw new Error(`Model dimension mismatch detected!\n` +
                         `Current model dimensions: ${currentDefaults.dimensions}\n` +
-                        `Index model dimensions: ${storedModel.dimensions}\n` +
+                        `Index model dimensions: ${systemInfo.modelDimensions}\n` +
                         `\n` +
                         `This indicates a configuration inconsistency.\n` +
                         `Please run: npm run rebuild`);
@@ -104,7 +104,10 @@ export class IndexManager {
             else {
                 // First run - store the model info
                 console.log(`No model info stored yet - storing current model info: ${currentModel}`);
-                await setStoredModelInfo(this.db, currentModel, currentDefaults.dimensions);
+                await setSystemInfo(this.db, {
+                    modelName: currentModel,
+                    modelDimensions: currentDefaults.dimensions
+                });
             }
         }
         catch (error) {
@@ -228,7 +231,10 @@ export class IndexManager {
                 // Store model info for the new model
                 const currentModel = this.modelName || config.embedding_model;
                 const currentDefaults = getModelDefaults(currentModel);
-                await setStoredModelInfo(this.db, currentModel, currentDefaults.dimensions);
+                await setSystemInfo(this.db, {
+                    modelName: currentModel,
+                    modelDimensions: currentDefaults.dimensions
+                });
                 await this.saveIndex();
                 return;
             }
@@ -260,7 +266,10 @@ export class IndexManager {
             // Store model info for the new model
             const currentModel = this.modelName || config.embedding_model;
             const currentDefaults = getModelDefaults(currentModel);
-            await setStoredModelInfo(this.db, currentModel, currentDefaults.dimensions);
+            await setSystemInfo(this.db, {
+                modelName: currentModel,
+                modelDimensions: currentDefaults.dimensions
+            });
             // Save the rebuilt index
             await this.saveIndex();
             console.log(`Index rebuild complete: ${vectors.length} vectors with new model version`);
@@ -278,10 +287,11 @@ export class IndexManager {
             throw new Error('Database not initialized');
         }
         try {
-            const storedVersion = await getModelVersion(this.db);
+            const systemInfo = await getSystemInfo(this.db);
+            const storedVersion = systemInfo?.modelVersion;
             if (!storedVersion || storedVersion === "") {
                 // No version stored yet, this is first run - store current version
-                await setModelVersion(this.db, currentVersion);
+                await setSystemInfo(this.db, { modelVersion: currentVersion });
                 console.log(`Stored initial model version: ${currentVersion}`);
                 return true;
             }
@@ -307,7 +317,7 @@ export class IndexManager {
             throw new Error('Database not initialized');
         }
         try {
-            await setModelVersion(this.db, version);
+            await setSystemInfo(this.db, { modelVersion: version });
             console.log(`Updated model version to: ${version}`);
         }
         catch (error) {
@@ -365,7 +375,8 @@ export class IndexManager {
         }
         const totalVectors = this.vectorIndex.getCurrentCount();
         try {
-            const modelVersion = await getModelVersion(this.db);
+            const systemInfo = await getSystemInfo(this.db);
+            const modelVersion = systemInfo?.modelVersion || null;
             return {
                 totalVectors,
                 modelVersion: modelVersion || 'unknown',

package/dist/index.d.ts

@@ -40,33 +40,8 @@
  * const search = new CoreSearchEngine(embedFn, indexManager, db);
  * ```
  */
-export { TextSearchFactory, TextIngestionFactory, TextRAGFactory, TextFactoryHelpers } from './factories/index.js';
-/**
- * @deprecated PolymorphicSearchFactory is no longer needed - SearchEngine now automatically
- * detects mode from database and adapts accordingly (Chameleon Architecture).
- *
- * Migration Guide:
- * ```typescript
- * // Old way (deprecated):
- * const search = await PolymorphicSearchFactory.create('./index.bin', './db.sqlite');
- *
- * // New way (recommended):
- * const search = new SearchEngine('./index.bin', './db.sqlite');
- * await search.search('query'); // Mode automatically detected
- * ```
- *
- * The SearchEngine constructor now uses the polymorphic factory internally,
- * providing the same automatic mode detection without requiring explicit factory usage.
- */
-export { PolymorphicSearchFactory } from './factories/index.js';
-export { TextSearchFactory as SearchFactory, TextIngestionFactory as IngestionFactory, TextRAGFactory as RAGFactory } from './factories/index.js';
-export type { TextSearchOptions, TextIngestionOptions } from './factories/index.js';
-/**
- * @deprecated PolymorphicSearchOptions is no longer needed - use SearchEngineOptions instead.
- * SearchEngine now automatically detects mode and adapts (Chameleon Architecture).
- */
-export type { PolymorphicSearchOptions } from './factories/index.js';
-export type { TextSearchOptions as SearchEngineOptions, TextIngestionOptions as IngestionPipelineOptions } from './factories/index.js';
+export { IngestionFactory, SearchFactory } from './factories/index.js';
+export type { IngestionFactoryOptions } from './factories/index.js';
 export { SearchEngine as CoreSearchEngine } from './core/search.js';
 export { IngestionPipeline as CoreIngestionPipeline } from './core/ingestion.js';
 export { SearchEngine } from './search.js';
@@ -76,15 +51,15 @@ export type { EmbedFunction, RerankFunction, EmbeddingQueryInterface, RerankingI
 export { InterfaceValidator } from './core/interfaces.js';
 export { validateModeModelCompatibility, validateModeModelCompatibilityOrThrow, getRecommendedModelsForMode, isModeModelCompatible, getCompatibleModelsForMode, type ModeModelValidationResult } from './core/mode-model-validator.js';
 export { createMissingFileError, createInvalidPathError, createModelLoadingError, createDimensionMismatchError, createModeMismatchError, createInvalidContentError, createMissingDependencyError, createFactoryCreationError, enhanceError, createContextualError, type ActionableErrorConfig } from './core/actionable-error-messages.js';
-export { EmbeddingEngine, getEmbeddingEngine, initializeEmbeddingEngine, createTextEmbedFunction, createTextEmbedder } from './text/embedder.js';
+export { EmbeddingEngine, getEmbeddingEngine, initializeEmbeddingEngine, createTextEmbedFunction } from './text/embedder.js';
 export type { UniversalEmbedder } from './core/universal-embedder.js';
 export { CLIPEmbedder } from './multimodal/clip-embedder.js';
 export { createEmbedder } from './core/embedder-factory.js';
-export { CrossEncoderReranker, createTextRerankFunction, createTextReranker } from './text/reranker.js';
+export { CrossEncoderReranker, createTextRerankFunction } from './text/reranker.js';
 export { countTokens } from './text/tokenizer.js';
 export type { RerankingStrategyType, RerankingConfig } from './core/reranking-config.js';
 export { validateRerankingStrategy, validateRerankingConfig, getDefaultRerankingConfig, isStrategySupported, getSupportedStrategies, RerankingConfigBuilder, DEFAULT_TEXT_RERANKING_CONFIG, DEFAULT_MULTIMODAL_RERANKING_CONFIG } from './core/reranking-config.js';
-export { openDatabase, initializeSchema, insertDocument, insertChunk, upsertDocument, getChunksByEmbeddingIds, getModelVersion, setModelVersion, getStoredModelInfo, setStoredModelInfo, type DatabaseConnection } from './core/db.js';
+export { openDatabase, initializeSchema, insertDocument, insertChunk, upsertDocument, getChunksByEmbeddingIds, type DatabaseConnection } from './core/db.js';
 export { IndexManager } from './index-manager.js';
 export { VectorIndex } from './core/vector-index.js';
 export { config, getModelDefaults, type CoreConfig, type ExtensibleConfig, type ModelDefaults, EXIT_CODES, ConfigurationError, getDefaultModelCachePath, handleUnrecoverableError, logError } from './core/config.js';

package/dist/index.js

@@ -44,27 +44,12 @@
 // PRIMARY API (FACTORY PATTERN)
 // =============================================================================
 // Main factory classes for simple usage
-export { TextSearchFactory, TextIngestionFactory, TextRAGFactory, TextFactoryHelpers } from './factories/index.js';
-/**
- * @deprecated PolymorphicSearchFactory is no longer needed - SearchEngine now automatically
- * detects mode from database and adapts accordingly (Chameleon Architecture).
- *
- * Migration Guide:
- * ```typescript
- * // Old way (deprecated):
- * const search = await PolymorphicSearchFactory.create('./index.bin', './db.sqlite');
- *
- * // New way (recommended):
- * const search = new SearchEngine('./index.bin', './db.sqlite');
- * await search.search('query'); // Mode automatically detected
- * ```
- *
- * The SearchEngine constructor now uses the polymorphic factory internally,
- * providing the same automatic mode detection without requiring explicit factory usage.
- */
-export { PolymorphicSearchFactory } from './factories/index.js';
-// Convenience aliases for common usage
-export { TextSearchFactory as SearchFactory, TextIngestionFactory as IngestionFactory, TextRAGFactory as RAGFactory } from './factories/index.js';
+export { IngestionFactory, SearchFactory } from './factories/index.js';
+// =============================================================================
+// REMOVED IN v3.0.0: Type aliases
+// =============================================================================
+// IngestionPipelineOptions has been removed. Use IngestionFactoryOptions directly.
+// Migration: Replace IngestionPipelineOptions with IngestionFactoryOptions
 // =============================================================================
 // CORE ARCHITECTURE (FOR LIBRARY AUTHORS)
 // =============================================================================
@@ -86,11 +71,11 @@ export { createMissingFileError, createInvalidPathError, createModelLoadingError
 // TEXT IMPLEMENTATIONS (FOR CUSTOM DEPENDENCY INJECTION)
 // =============================================================================
 // Text-specific embedding implementations
-export { EmbeddingEngine, getEmbeddingEngine, initializeEmbeddingEngine, createTextEmbedFunction, createTextEmbedder } from './text/embedder.js';
+export { EmbeddingEngine, getEmbeddingEngine, initializeEmbeddingEngine, createTextEmbedFunction } from './text/embedder.js';
 export { CLIPEmbedder } from './multimodal/clip-embedder.js';
 export { createEmbedder } from './core/embedder-factory.js';
 // Text-specific reranking implementations
-export { CrossEncoderReranker, createTextRerankFunction, createTextReranker } from './text/reranker.js';
+export { CrossEncoderReranker, createTextRerankFunction } from './text/reranker.js';
 // Text tokenization utilities
 export { countTokens } from './text/tokenizer.js';
 export { validateRerankingStrategy, validateRerankingConfig, getDefaultRerankingConfig, isStrategySupported, getSupportedStrategies, RerankingConfigBuilder, DEFAULT_TEXT_RERANKING_CONFIG, DEFAULT_MULTIMODAL_RERANKING_CONFIG } from './core/reranking-config.js';
@@ -98,7 +83,7 @@ export { validateRerankingStrategy, validateRerankingConfig, getDefaultReranking
 // CORE INFRASTRUCTURE (FOR ADVANCED USERS)
 // =============================================================================
 // Database operations
-export { openDatabase, initializeSchema, insertDocument, insertChunk, upsertDocument, getChunksByEmbeddingIds, getModelVersion, setModelVersion, getStoredModelInfo, setStoredModelInfo } from './core/db.js';
+export { openDatabase, initializeSchema, insertDocument, insertChunk, upsertDocument, getChunksByEmbeddingIds } from './core/db.js';
 // Vector index management
 export { IndexManager } from './index-manager.js';
 export { VectorIndex } from './core/vector-index.js';

package/dist/ingestion.d.ts

@@ -17,11 +17,9 @@
  * });
  * ```
  */
-import { type TextIngestionOptions } from './factories/index.js';
+import { type IngestionFactoryOptions } from './factories/index.js';
 import type { IngestionOptions, IngestionResult } from './core/ingestion.js';
 import type { MemoryContentMetadata } from './core/content-manager.js';
-export interface IngestionPipelineOptions extends TextIngestionOptions {
-}
 export declare class IngestionPipeline {
     private dbPath;
     private indexPath;
@@ -29,7 +27,7 @@ export declare class IngestionPipeline {
     private corePipeline;
     private initPromise;
     private defaultChunkConfig;
-    constructor(dbPath: string, indexPath: string, options?: IngestionPipelineOptions);
+    constructor(dbPath: string, indexPath: string, options?: IngestionFactoryOptions);
     /**
      * Initialize the ingestion pipeline using the factory
      */

package/dist/ingestion.js

@@ -17,7 +17,7 @@
  * });
  * ```
  */
-import { TextIngestionFactory } from './factories/index.js';
+import { IngestionFactory } from './factories/index.js';
 export class IngestionPipeline {
     dbPath;
     indexPath;
@@ -52,7 +52,7 @@ export class IngestionPipeline {
             return this.initPromise; // Initialization in progress
         }
         this.initPromise = (async () => {
-            this.corePipeline = await TextIngestionFactory.create(this.dbPath, this.indexPath, this.options);
+            this.corePipeline = await IngestionFactory.create(this.dbPath, this.indexPath, this.options);
         })();
         return this.initPromise;
     }

package/dist/mcp-server.js

@@ -26,9 +26,9 @@ import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js'
 import { CallToolRequestSchema, ListToolsRequestSchema, } from '@modelcontextprotocol/sdk/types.js';
 import { existsSync, statSync } from 'fs';
 import { resolve } from 'path';
-import { PolymorphicSearchFactory } from './core/polymorphic-search-factory.js';
-import { TextIngestionFactory } from './factories/text-factory.js';
-import { openDatabase } from './core/db.js';
+import { SearchFactory } from './factories/search-factory.js';
+import { IngestionFactory } from './factories/ingestion-factory.js';
+import { openDatabase, getSystemInfo } from './core/db.js';
 import { DatabaseConnectionManager } from './core/database-connection-manager.js';
 import { config, validateCoreConfig, ConfigurationError } from './core/config.js';
 /**
@@ -568,8 +568,8 @@ class RagLiteMCPServer {
                 factoryOptions.forceRebuild = true;
             }
             // Create and run ingestion pipeline using text factory
-            // The TextIngestionFactory already supports mode and reranking strategy parameters
-            const pipeline = await TextIngestionFactory.create(config.db_file, config.index_file, factoryOptions);
+            // The IngestionFactory already supports mode and reranking strategy parameters
+            const pipeline = await IngestionFactory.create(config.db_file, config.index_file, factoryOptions);
             try {
                 const result = await pipeline.ingestPath(resolvedPath);
                 // Reset search engine initialization flag since index may have changed
@@ -827,7 +827,7 @@ class RagLiteMCPServer {
                 factoryOptions.rerankingStrategy = 'text-derived'; // Default for multimodal
             }
             // Create and run ingestion pipeline
-            const pipeline = await TextIngestionFactory.create(config.db_file, config.index_file, factoryOptions);
+            const pipeline = await IngestionFactory.create(config.db_file, config.index_file, factoryOptions);
             try {
                 const result = await pipeline.ingestFile(resolvedPath);
                 // Reset search engine initialization flag since index may have changed
@@ -914,7 +914,7 @@ class RagLiteMCPServer {
     async handleRebuildIndex(_args) {
         try {
             // Create ingestion pipeline with force rebuild using factory
-            const pipeline = await TextIngestionFactory.create(config.db_file, config.index_file, { forceRebuild: true });
+            const pipeline = await IngestionFactory.create(config.db_file, config.index_file, { forceRebuild: true });
             try {
                 // Get all documents from database and re-ingest them
                 const db = await openDatabase(config.db_file);
@@ -995,7 +995,6 @@ class RagLiteMCPServer {
             };
             // Get model information and compatibility status
             const { getModelDefaults } = await import('./config.js');
-            const { getStoredModelInfo } = await import('./core/db.js');
             const currentModel = config.embedding_model;
             const currentDefaults = getModelDefaults(currentModel);
             stats.model_info = {
@@ -1012,13 +1011,13 @@ class RagLiteMCPServer {
                 try {
                     const db = await openDatabase(config.db_file);
                     try {
-                        const storedModel = await getStoredModelInfo(db);
-                        if (storedModel) {
-                            stats.model_info.stored_model = storedModel.modelName;
-                            stats.model_info.stored_dimensions = storedModel.dimensions;
+                        const systemInfo = await getSystemInfo(db);
+                        if (systemInfo && systemInfo.modelName && systemInfo.modelDimensions) {
+                            stats.model_info.stored_model = systemInfo.modelName;
+                            stats.model_info.stored_dimensions = systemInfo.modelDimensions;
                             // Check for compatibility issues
-                            const modelMatch = storedModel.modelName === currentModel;
-                            const dimensionMatch = storedModel.dimensions === currentDefaults.dimensions;
+                            const modelMatch = systemInfo.modelName === currentModel;
+                            const dimensionMatch = systemInfo.modelDimensions === currentDefaults.dimensions;
                             stats.model_info.compatibility = {
                                 model_matches: modelMatch,
                                 dimensions_match: dimensionMatch,
@@ -1572,10 +1571,10 @@ class RagLiteMCPServer {
         try {
             // Validate configuration
             validateCoreConfig(config);
-            // Create search engine using PolymorphicSearchFactory (auto-detects mode)
+            // Create search engine using SearchFactory (auto-detects mode)
             // This will automatically detect the mode from the database and create the appropriate engine
             console.error('🎭 MCP Server: Initializing search engine with automatic mode detection...');
-            this.searchEngine = await PolymorphicSearchFactory.create(config.index_file, config.db_file);
+            this.searchEngine = await SearchFactory.create(config.index_file, config.db_file);
             // Log successful initialization with mode information
             const stats = await this.searchEngine.getStats();
             // Try to get mode information for enhanced logging

package/dist/search.js

@@ -99,8 +99,8 @@ export class SearchEngine {
                 // Use core polymorphic factory for automatic mode detection (Chameleon Architecture)
                 // This enables SearchEngine to automatically adapt to text or multimodal mode
                 // based on the configuration stored in the database during ingestion
-                const { PolymorphicSearchFactory } = await import('./core/polymorphic-search-factory.js');
-                this.coreEngine = await PolymorphicSearchFactory.create(this.indexPath, this.dbPath);
+                const { SearchFactory } = await import('./factories/search-factory.js');
+                this.coreEngine = await SearchFactory.create(this.indexPath, this.dbPath);
             }
         })();
         return this.initPromise;

package/dist/text/embedder.d.ts

@@ -108,15 +108,4 @@ export declare function initializeEmbeddingEngine(modelName?: string, batchSize?
  * @returns EmbedFunction that can be injected into core components
  */
 export declare function createTextEmbedFunction(modelName?: string, batchSize?: number): EmbedFunction;
-/**
- * Create a text embedding engine factory function
- * @param modelName - Optional model name override
- * @param batchSize - Optional batch size override
- * @returns Factory function that creates initialized embedding engines
- */
-export declare function createTextEmbedder(modelName?: string, batchSize?: number): {
-    embedSingle(text: string): Promise<EmbeddingResult>;
-    embedBatch(texts: string[]): Promise<EmbeddingResult[]>;
-    embedDocumentBatch(chunks: string[]): Promise<EmbeddingResult[]>;
-};
 //# sourceMappingURL=embedder.d.ts.map

package/dist/text/embedder.js

@@ -372,26 +372,15 @@ export function createTextEmbedFunction(modelName, batchSize) {
     };
     return embedFunction;
 }
-/**
- * Create a text embedding engine factory function
- * @param modelName - Optional model name override
- * @param batchSize - Optional batch size override
- * @returns Factory function that creates initialized embedding engines
- */
-export function createTextEmbedder(modelName, batchSize) {
-    return {
-        async embedSingle(text) {
-            const engine = await initializeEmbeddingEngine(modelName, batchSize);
-            return engine.embedSingle(text);
-        },
-        async embedBatch(texts) {
-            const engine = await initializeEmbeddingEngine(modelName, batchSize);
-            return engine.embedBatch(texts);
-        },
-        async embedDocumentBatch(chunks) {
-            const engine = await initializeEmbeddingEngine(modelName, batchSize);
-            return engine.embedDocumentBatch(chunks);
-        }
-    };
-}
+// =============================================================================
+// REMOVED: createTextEmbedder() factory object
+// =============================================================================
+// The createTextEmbedder() function has been removed as it was redundant.
+// It was just a wrapper around initializeEmbeddingEngine() that provided no
+// additional value over using the engine directly or using createEmbedder().
+//
+// Migration guide:
+// - For public API: Use createEmbedder() from core/embedder-factory.ts
+// - For dependency injection: Use createTextEmbedFunction()
+// - For direct access: Use initializeEmbeddingEngine() or new EmbeddingEngine()
 //# sourceMappingURL=embedder.js.map

package/dist/text/index.d.ts

@@ -1,5 +1,5 @@
-export { EmbeddingEngine, getEmbeddingEngine, initializeEmbeddingEngine, createTextEmbedFunction, createTextEmbedder } from './embedder.js';
-export { CrossEncoderReranker, createTextRerankFunction, createTextReranker } from './reranker.js';
+export { EmbeddingEngine, getEmbeddingEngine, initializeEmbeddingEngine, createTextEmbedFunction } from './embedder.js';
+export { CrossEncoderReranker, createTextRerankFunction } from './reranker.js';
 export { countTokens, getTokenizer, resetTokenizer } from './tokenizer.js';
 export { chunkDocument, type Chunk, type Document } from '../core/chunker.js';
 export { type ChunkConfig } from '../core/chunker.js';

package/dist/text/index.js

@@ -1,6 +1,6 @@
 // Text implementation layer exports
-export { EmbeddingEngine, getEmbeddingEngine, initializeEmbeddingEngine, createTextEmbedFunction, createTextEmbedder } from './embedder.js';
-export { CrossEncoderReranker, createTextRerankFunction, createTextReranker } from './reranker.js';
+export { EmbeddingEngine, getEmbeddingEngine, initializeEmbeddingEngine, createTextEmbedFunction } from './embedder.js';
+export { CrossEncoderReranker, createTextRerankFunction } from './reranker.js';
 export { countTokens, getTokenizer, resetTokenizer } from './tokenizer.js';
 export { chunkDocument } from '../core/chunker.js';
 export { SentenceTransformerEmbedder } from './sentence-transformer-embedder.js';

package/dist/text/reranker.d.ts

@@ -46,14 +46,4 @@ export declare class CrossEncoderReranker {
     private simpleTextReranking;
 }
 export declare function createTextRerankFunction(modelName?: string): RerankFunction;
-/**
- * Create a text reranker factory function
- * @param modelName - Optional model name override
- * @returns Factory function that creates initialized rerankers
- */
-export declare function createTextReranker(modelName?: string): {
-    rerank(query: string, results: SearchResult[]): Promise<SearchResult[]>;
-    loadModel(): Promise<void>;
-    isLoaded(): boolean;
-};
 //# sourceMappingURL=reranker.d.ts.map

package/dist/text/reranker.js

@@ -261,37 +261,14 @@ export function createTextRerankFunction(modelName) {
     };
     return rerankFunction;
 }
-/**
- * Create a text reranker factory function
- * @param modelName - Optional model name override
- * @returns Factory function that creates initialized rerankers
- */
-export function createTextReranker(modelName) {
-    return {
-        async rerank(query, results) {
-            const reranker = new CrossEncoderReranker();
-            if (modelName) {
-                reranker.modelName = modelName;
-            }
-            await reranker.loadModel();
-            if (!reranker.isLoaded()) {
-                console.warn('Text reranker not loaded, returning results unchanged');
-                return results;
-            }
-            return reranker.rerank(query, results);
-        },
-        async loadModel() {
-            const reranker = new CrossEncoderReranker();
-            if (modelName) {
-                reranker.modelName = modelName;
-            }
-            await reranker.loadModel();
-        },
-        isLoaded() {
-            // For the factory version, we create new instances each time
-            // so we can't track loaded state
-            return true;
-        }
-    };
-}
+// =============================================================================
+// REMOVED IN v3.0.0: createTextReranker() factory object
+// =============================================================================
+// The createTextReranker() function has been removed as it was redundant.
+// It was just a wrapper that created new CrossEncoderReranker instances.
+//
+// Migration guide:
+// - For public API: Use createReranker() from core/reranking-factory.ts
+// - For dependency injection: Use createTextRerankFunction()
+// - For direct access: Use new CrossEncoderReranker() directly
 //# sourceMappingURL=reranker.js.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "rag-lite-ts",
-  "version": "2.0.3",
+  "version": "2.0.4",
   "description": "Local-first TypeScript retrieval engine with Chameleon Multimodal Architecture for semantic search over text and image content",
   "type": "module",
   "main": "./dist/index.js",
@@ -31,12 +31,16 @@
     "build:test": "tsc --project tsconfig.test.json",
     "clean": "rimraf dist",
     "dev": "tsc --watch",
-    "test": "npm run build:test && node --expose-gc --test --test-concurrency=1 dist/__tests__/core dist/__tests__/text dist/__tests__/preprocessors",
-    "test:verbose": "npm run build:test && node --expose-gc --test --test-concurrency=1 --test-reporter=tap dist/__tests__/core dist/__tests__/text dist/__tests__/preprocessors",
+    "test": "npm run build:test && node --expose-gc --test --test-concurrency=1 dist/__tests__/core dist/__tests__/text dist/__tests__/preprocessors dist/__tests__/cli dist/__tests__/factories",
+    "test:verbose": "npm run build:test && node --expose-gc --test --test-concurrency=1 --test-reporter=tap dist/__tests__/core dist/__tests__/text dist/__tests__/preprocessors dist/__tests__/cli dist/__tests__/factories",
     "test:core": "npm run build:test && node --expose-gc --test --test-concurrency=1 dist/__tests__/core",
     "test:core:verbose": "npm run build:test && node --expose-gc --test --test-concurrency=1 --test-reporter=tap dist/__tests__/core",
     "test:text": "npm run build:test && node --expose-gc --test --test-concurrency=1 dist/__tests__/text",
     "test:preprocessors": "npm run build:test && node --expose-gc --test --test-concurrency=1 dist/__tests__/preprocessors",
+    "test:cli": "npm run build:test && node --expose-gc --test --test-concurrency=1 dist/__tests__/cli",
+    "test:factories": "npm run build:test && node --expose-gc --test --test-concurrency=1 dist/__tests__/factories",
+    "test:datasets": "npm run build:test && node --expose-gc --test --test-concurrency=1 dist/__tests__/datasets",
+    "test:unit": "npm run build:test && node --expose-gc --test --test-concurrency=1 dist/__tests__/core dist/__tests__/text dist/__tests__/preprocessors dist/__tests__/cli dist/__tests__/factories",
     "test:integration": "npm run build && npm run build:test && node --expose-gc --test --test-concurrency=1 dist/__tests__/integration",
     "test:integration:verbose": "npm run build && npm run build:test && node --expose-gc --test --test-concurrency=1 --test-reporter=tap dist/__tests__/integration",
     "test:all": "npm run build:test && node --expose-gc --test --test-concurrency=1 dist/__tests__",

package/dist/factories/polymorphic-factory.d.ts

@@ -1,50 +0,0 @@
-/**
- * Polymorphic factory for creating mode-aware search engines
- * Automatically detects mode from database and uses appropriate embedder
- *
- * This factory implements the Chameleon Architecture principle:
- * - Detects mode (text/multimodal) from database configuration
- * - Uses appropriate embedder based on detected mode
- * - Provides seamless polymorphic behavior without user intervention
- *
- * @example
- * ```typescript
- * // Automatically detects mode and creates appropriate search engine
- * const search = await PolymorphicSearchFactory.create('./index.bin', './db.sqlite');
- *
- * // Works for both text and multimodal modes
- * const results = await search.search('query');
- * ```
- */
-import { SearchEngine } from '../core/search.js';
-export interface PolymorphicSearchOptions {
-    /** Whether to enable reranking (default: true) */
-    enableReranking?: boolean;
-    /** Top-k results to return (default: from config) */
-    topK?: number;
-}
-/**
- * Factory for creating mode-aware search engines
- * Automatically detects mode from database and uses appropriate embedder
- */
-export declare class PolymorphicSearchFactory {
-    /**
-     * Create a SearchEngine that automatically adapts to the mode stored in the database
-     *
-     * This method:
-     * 1. Validates that required files exist
-     * 2. Opens database and reads system configuration
-     * 3. Detects mode (text/multimodal) from database
-     * 4. Creates appropriate embedder based on mode
-     * 5. Optionally creates reranker based on configuration
-     * 6. Returns fully configured SearchEngine
-     *
-     * @param indexPath - Path to the vector index file (must exist)
-     * @param dbPath - Path to the SQLite database file (must exist)
-     * @param options - Optional configuration overrides
-     * @returns Promise resolving to configured SearchEngine
-     * @throws {Error} If required files don't exist or initialization fails
-     */
-    static create(indexPath: string, dbPath: string, options?: PolymorphicSearchOptions): Promise<SearchEngine>;
-}
-//# sourceMappingURL=polymorphic-factory.d.ts.map