cursor-recursive-rag 0.2.0-alpha.2 → 0.2.0

package/dist/adapters/vector/index.js

@@ -3,6 +3,7 @@ import { QdrantAdapter } from './qdrant.js';
 import { VectorizeAdapter } from './vectorize.js';
 import { MemoryAdapter } from './memory.js';
 import { RedisAdapter } from './redis.js';
+import { RedisNativeAdapter } from './redis-native.js';
 export function createVectorStore(type, config) {
     switch (type) {
         case 'memory':
@@ -12,6 +13,13 @@ export function createVectorStore(type, config) {
         case 'qdrant':
             return new QdrantAdapter(config);
         case 'redis':
+            // Use native Redis 8.x adapter by default, fall back to RediSearch if specified
+            if (config.vectorStoreConfig?.useRediSearch) {
+                return new RedisAdapter(config);
+            }
+            return new RedisNativeAdapter(config);
+        case 'redis-stack':
+            // Explicit Redis Stack/RediSearch adapter
             return new RedisAdapter(config);
         case 'vectorize':
             return new VectorizeAdapter(config);

package/dist/adapters/vector/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/adapters/vector/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAClD,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAK1C,MAAM,UAAU,iBAAiB,CAAC,IAAY,EAAE,MAAiB;IAC/D,QAAQ,IAAI,EAAE,CAAC;QACb,KAAK,QAAQ;YACX,OAAO,IAAI,aAAa,CAAC,MAAM,CAAC,CAAC;QACnC,KAAK,QAAQ;YACX,OAAO,IAAI,aAAa,CAAC,MAAM,CAAC,CAAC;QACnC,KAAK,QAAQ;YACX,OAAO,IAAI,aAAa,CAAC,MAAM,CAAC,CAAC;QACnC,KAAK,OAAO;YACV,OAAO,IAAI,YAAY,CAAC,MAAM,CAAC,CAAC;QAClC,KAAK,WAAW;YACd,OAAO,IAAI,gBAAgB,CAAC,MAAM,CAAC,CAAC;QACtC;YACE,MAAM,IAAI,KAAK,CAAC,yBAAyB,IAAI,EAAE,CAAC,CAAC;IACrD,CAAC;AACH,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/adapters/vector/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAClD,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAC1C,OAAO,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAKvD,MAAM,UAAU,iBAAiB,CAAC,IAAY,EAAE,MAAiB;IAC/D,QAAQ,IAAI,EAAE,CAAC;QACb,KAAK,QAAQ;YACX,OAAO,IAAI,aAAa,CAAC,MAAM,CAAC,CAAC;QACnC,KAAK,QAAQ;YACX,OAAO,IAAI,aAAa,CAAC,MAAM,CAAC,CAAC;QACnC,KAAK,QAAQ;YACX,OAAO,IAAI,aAAa,CAAC,MAAM,CAAC,CAAC;QACnC,KAAK,OAAO;YACV,gFAAgF;YAChF,IAAI,MAAM,CAAC,iBAAiB,EAAE,aAAa,EAAE,CAAC;gBAC5C,OAAO,IAAI,YAAY,CAAC,MAAM,CAAC,CAAC;YAClC,CAAC;YACD,OAAO,IAAI,kBAAkB,CAAC,MAAM,CAAC,CAAC;QACxC,KAAK,aAAa;YAChB,0CAA0C;YAC1C,OAAO,IAAI,YAAY,CAAC,MAAM,CAAC,CAAC;QAClC,KAAK,WAAW;YACd,OAAO,IAAI,gBAAgB,CAAC,MAAM,CAAC,CAAC;QACtC;YACE,MAAM,IAAI,KAAK,CAAC,yBAAyB,IAAI,EAAE,CAAC,CAAC;IACrD,CAAC;AACH,CAAC"}

package/dist/adapters/vector/redis-native.d.ts

@@ -0,0 +1,35 @@
+import type { VectorStore, VectorDocument, SearchResult, SearchOptions } from '../../types/index.js';
+import type { RAGConfig } from '../../types/index.js';
+/**
+ * Redis 8.x Native Vector Adapter
+ *
+ * Uses Redis 8.x native vector commands (VADD, VSIM, VREM, VCARD).
+ * Works with standard Redis 8.x installed via Homebrew or other methods.
+ *
+ * Command syntax (Redis 8.x):
+ * - VADD key VALUES dim v1 v2 ... vN element [CAS] [NOQUANT|BIN|Q8]
+ * - VSIM key VALUES dim v1 v2 ... vN [WITHSCORES] [COUNT count]
+ * - VREM key element [element ...]
+ * - VCARD key
+ *
+ * Features:
+ * - Persistent storage
+ * - HNSW index for approximate nearest neighbor search
+ * - No additional modules required (uses native Redis 8.x vector support)
+ */
+export declare class RedisNativeAdapter implements VectorStore {
+    private client;
+    private setName;
+    private metadataPrefix;
+    private vectorDim;
+    private isConnected;
+    private redisUrl;
+    constructor(config: RAGConfig);
+    private initialize;
+    add(docs: VectorDocument[]): Promise<void>;
+    search(embedding: number[], options: SearchOptions): Promise<SearchResult[]>;
+    delete(ids: string[]): Promise<void>;
+    count(): Promise<number>;
+    disconnect(): Promise<void>;
+}
+//# sourceMappingURL=redis-native.d.ts.map

package/dist/adapters/vector/redis-native.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"redis-native.d.ts","sourceRoot":"","sources":["../../../src/adapters/vector/redis-native.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,cAAc,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrG,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AAItD;;;;;;;;;;;;;;;;GAgBG;AACH,qBAAa,kBAAmB,YAAW,WAAW;IACpD,OAAO,CAAC,MAAM,CAAkB;IAChC,OAAO,CAAC,OAAO,CAAwB;IACvC,OAAO,CAAC,cAAc,CAAsB;IAC5C,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,QAAQ,CAAS;gBAEb,MAAM,EAAE,SAAS;YAUf,UAAU;IAgBlB,GAAG,CAAC,IAAI,EAAE,cAAc,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAuC1C,MAAM,CAAC,SAAS,EAAE,MAAM,EAAE,EAAE,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC;IAqE5E,MAAM,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAapC,KAAK,IAAI,OAAO,CAAC,MAAM,CAAC;IAWxB,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;CAMlC"}

package/dist/adapters/vector/redis-native.js

@@ -0,0 +1,170 @@
+import { createClient } from 'redis';
+/**
+ * Redis 8.x Native Vector Adapter
+ *
+ * Uses Redis 8.x native vector commands (VADD, VSIM, VREM, VCARD).
+ * Works with standard Redis 8.x installed via Homebrew or other methods.
+ *
+ * Command syntax (Redis 8.x):
+ * - VADD key VALUES dim v1 v2 ... vN element [CAS] [NOQUANT|BIN|Q8]
+ * - VSIM key VALUES dim v1 v2 ... vN [WITHSCORES] [COUNT count]
+ * - VREM key element [element ...]
+ * - VCARD key
+ *
+ * Features:
+ * - Persistent storage
+ * - HNSW index for approximate nearest neighbor search
+ * - No additional modules required (uses native Redis 8.x vector support)
+ */
+export class RedisNativeAdapter {
+    client;
+    setName = 'cursor-rag-vectors';
+    metadataPrefix = 'cursor-rag:meta:';
+    vectorDim;
+    isConnected = false;
+    redisUrl;
+    constructor(config) {
+        this.redisUrl = config.apiKeys?.redis?.url || config.vectorStoreConfig?.redisUrl || 'redis://localhost:6379';
+        this.vectorDim = config.vectorStoreConfig?.vectorDim || 384;
+        this.client = createClient({ url: this.redisUrl });
+        this.client.on('error', (err) => {
+            console.error('Redis Client Error:', err.message);
+        });
+    }
+    async initialize() {
+        if (!this.isConnected) {
+            try {
+                await this.client.connect();
+                this.isConnected = true;
+            }
+            catch (error) {
+                const err = error;
+                throw new Error(`Failed to connect to Redis at ${this.redisUrl}. ` +
+                    `Ensure Redis 8.x is running.\n` +
+                    `Error: ${err.message}`);
+            }
+        }
+    }
+    async add(docs) {
+        await this.initialize();
+        for (const doc of docs) {
+            // VADD key VALUES dim v1 v2 ... vN element
+            // Build command: VADD cursor-rag-vectors VALUES 384 0.1 0.2 ... element_id
+            const cmd = [
+                'VADD',
+                this.setName,
+                'VALUES',
+                doc.embedding.length.toString(),
+                ...doc.embedding.map(v => v.toString()),
+                doc.id
+            ];
+            try {
+                await this.client.sendCommand(cmd);
+            }
+            catch (error) {
+                const err = error;
+                if (err.message?.includes('unknown command')) {
+                    throw new Error('Redis native vector commands not available. ' +
+                        'Ensure you have Redis 8.x with vector support or use Redis Stack.');
+                }
+                throw error;
+            }
+            // Store metadata separately
+            const metadataKey = `${this.metadataPrefix}${doc.id}`;
+            await this.client.hSet(metadataKey, {
+                id: doc.id,
+                content: doc.content,
+                source: doc.metadata?.source || 'unknown',
+                metadata: JSON.stringify(doc.metadata || {})
+            });
+        }
+    }
+    async search(embedding, options) {
+        await this.initialize();
+        const topK = options.topK || 10;
+        try {
+            // VSIM key VALUES dim v1 v2 ... vN COUNT count WITHSCORES
+            const cmd = [
+                'VSIM',
+                this.setName,
+                'VALUES',
+                embedding.length.toString(),
+                ...embedding.map(v => v.toString()),
+                'COUNT', topK.toString(),
+                'WITHSCORES'
+            ];
+            const results = await this.client.sendCommand(cmd);
+            if (!results || results.length === 0) {
+                return [];
+            }
+            // Results come as [id1, score1, id2, score2, ...]
+            const searchResults = [];
+            for (let i = 0; i < results.length; i += 2) {
+                const id = results[i];
+                const score = parseFloat(results[i + 1]);
+                // Get metadata
+                const metadataKey = `${this.metadataPrefix}${id}`;
+                const metadataRaw = await this.client.hGetAll(metadataKey);
+                if (metadataRaw && metadataRaw.content) {
+                    let metadata = { source: metadataRaw.source || 'unknown' };
+                    try {
+                        metadata = JSON.parse(metadataRaw.metadata || '{}');
+                    }
+                    catch {
+                        // Keep default
+                    }
+                    // Apply source filter if specified
+                    if (options.filter?.source) {
+                        const allowedSources = Array.isArray(options.filter.source.$in)
+                            ? options.filter.source.$in
+                            : [options.filter.source];
+                        if (!allowedSources.includes(metadata.source)) {
+                            continue;
+                        }
+                    }
+                    searchResults.push({
+                        id,
+                        content: metadataRaw.content,
+                        metadata,
+                        score // Redis 8 VSIM returns similarity score directly (1 = identical)
+                    });
+                }
+            }
+            return searchResults;
+        }
+        catch (error) {
+            const err = error;
+            console.error('Redis native search error:', err.message);
+            return [];
+        }
+    }
+    async delete(ids) {
+        await this.initialize();
+        for (const id of ids) {
+            try {
+                await this.client.sendCommand(['VREM', this.setName, id]);
+                await this.client.del(`${this.metadataPrefix}${id}`);
+            }
+            catch (error) {
+                // Ignore errors for non-existent keys
+            }
+        }
+    }
+    async count() {
+        await this.initialize();
+        try {
+            const result = await this.client.sendCommand(['VCARD', this.setName]);
+            return result || 0;
+        }
+        catch {
+            return 0;
+        }
+    }
+    async disconnect() {
+        if (this.isConnected) {
+            await this.client.quit();
+            this.isConnected = false;
+        }
+    }
+}
+//# sourceMappingURL=redis-native.js.map

package/dist/adapters/vector/redis-native.js.map

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

package/dist/cli/commands/chat.d.ts

@@ -0,0 +1,4 @@
+import { Command } from 'commander';
+declare const chatCommand: Command;
+export { chatCommand };
+//# sourceMappingURL=chat.d.ts.map

package/dist/cli/commands/chat.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chat.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/chat.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAqBpC,QAAA,MAAM,WAAW,SACuC,CAAC;AA8czD,OAAO,EAAE,WAAW,EAAE,CAAC"}

package/dist/cli/commands/chat.js

@@ -0,0 +1,374 @@
+import { Command } from 'commander';
+import chalk from 'chalk';
+import ora from 'ora';
+import { loadConfig } from '../../services/config.js';
+import { createVectorStore } from '../../adapters/vector/index.js';
+import { createEmbedder } from '../../adapters/embeddings/index.js';
+import { createCursorChatReader } from '../../services/cursorChatReader.js';
+import { createConversationProcessor } from '../../services/conversationProcessor.js';
+import { getMemoryMetadataStore } from '../../services/memoryMetadataStore.js';
+import { createEnhancedVectorStore } from '../../services/enhancedVectorStore.js';
+import { createKnowledgeExtractor } from '../../services/knowledgeExtractor.js';
+import { createKnowledgeStorageService } from '../../services/knowledgeStorage.js';
+import { countExtractedItems } from '../../types/extractedKnowledge.js';
+const chatCommand = new Command('chat')
+    .description('Manage Cursor chat history integration');
+chatCommand
+    .command('list')
+    .description('List available Cursor conversations')
+    .option('-n, --limit <n>', 'Maximum conversations to show', '20')
+    .option('--since <date>', 'Only show conversations since date (YYYY-MM-DD)')
+    .option('--code-only', 'Only show conversations with code blocks')
+    .option('--json', 'Output as JSON')
+    .action(async (options) => {
+    try {
+        const reader = createCursorChatReader();
+        if (!reader.isDatabaseAvailable()) {
+            console.error(chalk.red('Cursor database not found at: ' + reader.getDatabasePath()));
+            console.log(chalk.yellow('\nMake sure Cursor is installed and has been used at least once.'));
+            process.exit(1);
+        }
+        const filterOptions = {
+            limit: parseInt(options.limit, 10),
+        };
+        if (options.since) {
+            filterOptions.since = new Date(options.since);
+        }
+        if (options.codeOnly) {
+            filterOptions.hasCode = true;
+        }
+        const conversations = reader.listConversations(filterOptions);
+        if (options.json) {
+            console.log(JSON.stringify(conversations, null, 2));
+            return;
+        }
+        console.log(chalk.cyan(`\n📝 Found ${conversations.length} conversations\n`));
+        if (conversations.length === 0) {
+            console.log(chalk.yellow('No conversations found matching your criteria.'));
+            return;
+        }
+        const metadataStore = getMemoryMetadataStore();
+        for (const conv of conversations) {
+            const isProcessed = metadataStore.isConversationProcessed(conv.id);
+            const statusIcon = isProcessed ? chalk.green('✓') : chalk.gray('○');
+            const dateStr = conv.updatedAt
+                ? conv.updatedAt.toLocaleDateString() + ' ' + conv.updatedAt.toLocaleTimeString()
+                : 'Unknown date';
+            console.log(`${statusIcon} ${chalk.bold(conv.id.substring(0, 8))}  ${chalk.gray(dateStr)}`);
+            console.log(`   Messages: ${conv.messageCount}  ${conv.hasCodeBlocks ? chalk.blue('📦 Has code') : ''}`);
+            if (conv.preview) {
+                const preview = conv.preview.substring(0, 80).replace(/\n/g, ' ');
+                console.log(`   ${chalk.gray(preview)}${conv.preview.length > 80 ? '...' : ''}`);
+            }
+            console.log('');
+        }
+        const processedCount = conversations.filter(c => metadataStore.isConversationProcessed(c.id)).length;
+        console.log(chalk.gray(`\nProcessed: ${processedCount}/${conversations.length}`));
+        console.log(chalk.gray(`Legend: ${chalk.green('✓')} processed  ${chalk.gray('○')} not processed`));
+    }
+    catch (error) {
+        console.error(chalk.red(`Error: ${error instanceof Error ? error.message : 'Unknown error'}`));
+        process.exit(1);
+    }
+});
+chatCommand
+    .command('ingest')
+    .description('Ingest Cursor chat history into RAG knowledge base')
+    .option('-n, --limit <n>', 'Maximum conversations to process')
+    .option('--since <date>', 'Only process conversations since date (YYYY-MM-DD)')
+    .option('--code-only', 'Only process conversations with code blocks')
+    .option('--force', 'Re-process already processed conversations')
+    .option('--dry-run', 'Show what would be processed without actually doing it')
+    .option('--extract', 'Extract knowledge (solutions, patterns, decisions) using LLM')
+    .action(async (options) => {
+    const spinner = ora('Loading configuration...').start();
+    try {
+        const config = loadConfig();
+        const vectorStore = createVectorStore(config.vectorStore, config);
+        const embedder = await createEmbedder(config.embeddings, config);
+        const metadataStore = getMemoryMetadataStore();
+        const enhancedStore = createEnhancedVectorStore(vectorStore);
+        spinner.succeed('Configuration loaded');
+        const reader = createCursorChatReader();
+        if (!reader.isDatabaseAvailable()) {
+            console.error(chalk.red('Cursor database not found at: ' + reader.getDatabasePath()));
+            console.log(chalk.yellow('\nMake sure Cursor is installed and has been used at least once.'));
+            process.exit(1);
+        }
+        spinner.start('Scanning conversations...');
+        const filterOptions = {};
+        if (options.limit) {
+            filterOptions.limit = parseInt(options.limit, 10);
+        }
+        if (options.since) {
+            filterOptions.since = new Date(options.since);
+        }
+        if (options.codeOnly) {
+            filterOptions.hasCode = true;
+        }
+        const conversations = reader.listConversations(filterOptions);
+        const toProcess = options.force
+            ? conversations
+            : conversations.filter(c => !metadataStore.isConversationProcessed(c.id));
+        spinner.succeed(`Found ${conversations.length} conversations, ${toProcess.length} to process`);
+        if (toProcess.length === 0) {
+            console.log(chalk.yellow('\nNo new conversations to process.'));
+            console.log(chalk.gray('Use --force to re-process already processed conversations.'));
+            return;
+        }
+        if (options.dryRun) {
+            console.log(chalk.cyan('\n📋 Dry run - would process:\n'));
+            for (const conv of toProcess) {
+                console.log(`  ${conv.id.substring(0, 8)} - ${conv.messageCount} messages`);
+            }
+            return;
+        }
+        const processor = createConversationProcessor({
+            includeCodeChunks: true,
+            minExchangeLength: 50,
+            maxChunkSize: 2000,
+            extractEntities: true,
+        });
+        const knowledgeExtractor = options.extract ? createKnowledgeExtractor(config) : null;
+        const knowledgeStorage = options.extract
+            ? createKnowledgeStorageService(enhancedStore, embedder)
+            : null;
+        if (options.extract) {
+            if (knowledgeExtractor?.isLLMAvailable()) {
+                console.log(chalk.blue('📚 Knowledge extraction enabled (LLM mode)'));
+            }
+            else {
+                console.log(chalk.yellow('📚 Knowledge extraction enabled (heuristic mode - set OpenAI API key for better results)'));
+            }
+        }
+        let totalChunks = 0;
+        let totalKnowledge = 0;
+        let processedCount = 0;
+        console.log(chalk.cyan('\n🔄 Processing conversations...\n'));
+        for (const summary of toProcess) {
+            const convSpinner = ora(`Processing ${summary.id.substring(0, 8)}...`).start();
+            try {
+                const conversation = reader.getConversation(summary.id);
+                if (!conversation) {
+                    convSpinner.warn(`Skipped ${summary.id.substring(0, 8)}: Could not read conversation`);
+                    continue;
+                }
+                const result = processor.processConversation(conversation);
+                if (result.chunks.length === 0) {
+                    convSpinner.info(`Skipped ${summary.id.substring(0, 8)}: No meaningful content`);
+                    continue;
+                }
+                const documents = await Promise.all(result.chunks.map(async (chunk) => {
+                    const embedding = await embedder.embed(chunk.content);
+                    return {
+                        id: chunk.id,
+                        content: chunk.content,
+                        embedding,
+                        metadata: {
+                            ...chunk.metadata,
+                            source: chunk.source,
+                            chunkType: chunk.chunkType,
+                            importance: chunk.importance,
+                            sourceConversationId: chunk.sourceConversationId,
+                            sourceMessageIndex: chunk.sourceMessageIndex,
+                        },
+                    };
+                }));
+                await enhancedStore.add(documents);
+                let knowledgeCount = 0;
+                if (knowledgeExtractor && knowledgeStorage) {
+                    try {
+                        const extracted = await knowledgeExtractor.extract(conversation);
+                        knowledgeCount = countExtractedItems(extracted);
+                        if (knowledgeCount > 0) {
+                            await knowledgeStorage.store(extracted);
+                            totalKnowledge += knowledgeCount;
+                        }
+                    }
+                    catch (extractError) {
+                        console.warn(chalk.yellow(`  Warning: Knowledge extraction failed for ${summary.id.substring(0, 8)}`));
+                    }
+                }
+                metadataStore.markConversationProcessed(summary.id, summary.messageCount, result.chunks.length, knowledgeCount);
+                totalChunks += result.chunks.length;
+                processedCount++;
+                const knowledgeInfo = knowledgeCount > 0 ? `, ${knowledgeCount} knowledge items` : '';
+                convSpinner.succeed(`Processed ${summary.id.substring(0, 8)}: ` +
+                    `${result.chunks.length} chunks, ` +
+                    `${result.metadata.codeBlockCount} code blocks${knowledgeInfo}`);
+            }
+            catch (error) {
+                convSpinner.fail(`Failed ${summary.id.substring(0, 8)}: ${error instanceof Error ? error.message : 'Unknown error'}`);
+            }
+        }
+        console.log(chalk.green(`\n✅ Ingestion complete!`));
+        console.log(chalk.cyan(`   Conversations processed: ${processedCount}`));
+        console.log(chalk.cyan(`   Total chunks created: ${totalChunks}`));
+        if (options.extract) {
+            console.log(chalk.cyan(`   Knowledge items extracted: ${totalKnowledge}`));
+        }
+    }
+    catch (error) {
+        spinner.fail('Ingestion failed');
+        console.error(chalk.red(`Error: ${error instanceof Error ? error.message : 'Unknown error'}`));
+        process.exit(1);
+    }
+});
+chatCommand
+    .command('watch')
+    .description('Watch for new Cursor conversations and ingest automatically')
+    .option('--interval <seconds>', 'Check interval in seconds', '60')
+    .option('--code-only', 'Only process conversations with code blocks')
+    .action(async (options) => {
+    console.log(chalk.cyan('\n👀 Watching for new Cursor conversations...\n'));
+    console.log(chalk.gray(`Check interval: ${options.interval} seconds`));
+    console.log(chalk.gray('Press Ctrl+C to stop\n'));
+    const config = loadConfig();
+    const vectorStore = createVectorStore(config.vectorStore, config);
+    const embedder = await createEmbedder(config.embeddings, config);
+    const metadataStore = getMemoryMetadataStore();
+    const enhancedStore = createEnhancedVectorStore(vectorStore);
+    const reader = createCursorChatReader();
+    const processor = createConversationProcessor();
+    if (!reader.isDatabaseAvailable()) {
+        console.error(chalk.red('Cursor database not found at: ' + reader.getDatabasePath()));
+        process.exit(1);
+    }
+    let lastCheck = new Date();
+    let totalIngested = 0;
+    const checkForNewConversations = async () => {
+        try {
+            const filterOptions = {
+                since: lastCheck,
+            };
+            if (options.codeOnly) {
+                filterOptions.hasCode = true;
+            }
+            const conversations = reader.listConversations(filterOptions);
+            const newConversations = conversations.filter(c => !metadataStore.isConversationProcessed(c.id));
+            if (newConversations.length > 0) {
+                console.log(chalk.cyan(`\n📥 Found ${newConversations.length} new conversation(s)`));
+                for (const summary of newConversations) {
+                    const conversation = reader.getConversation(summary.id);
+                    if (!conversation)
+                        continue;
+                    const result = processor.processConversation(conversation);
+                    if (result.chunks.length === 0)
+                        continue;
+                    const documents = await Promise.all(result.chunks.map(async (chunk) => {
+                        const embedding = await embedder.embed(chunk.content);
+                        return {
+                            id: chunk.id,
+                            content: chunk.content,
+                            embedding,
+                            metadata: {
+                                ...chunk.metadata,
+                                source: chunk.source,
+                                chunkType: chunk.chunkType,
+                                importance: chunk.importance,
+                                sourceConversationId: chunk.sourceConversationId,
+                            },
+                        };
+                    }));
+                    await enhancedStore.add(documents);
+                    metadataStore.markConversationProcessed(summary.id, summary.messageCount, result.chunks.length, 0);
+                    totalIngested++;
+                    console.log(chalk.green(`  ✓ Ingested ${summary.id.substring(0, 8)}: ${result.chunks.length} chunks`));
+                }
+            }
+            lastCheck = new Date();
+        }
+        catch (error) {
+            console.error(chalk.red(`Watch error: ${error instanceof Error ? error.message : 'Unknown error'}`));
+        }
+    };
+    await checkForNewConversations();
+    const intervalMs = parseInt(options.interval, 10) * 1000;
+    const intervalId = setInterval(checkForNewConversations, intervalMs);
+    process.on('SIGINT', () => {
+        clearInterval(intervalId);
+        console.log(chalk.yellow(`\n\n👋 Stopped watching. Total ingested: ${totalIngested} conversations`));
+        process.exit(0);
+    });
+});
+chatCommand
+    .command('stats')
+    .description('Show chat history ingestion statistics')
+    .action(async () => {
+    try {
+        const reader = createCursorChatReader();
+        const metadataStore = getMemoryMetadataStore();
+        if (!reader.isDatabaseAvailable()) {
+            console.error(chalk.red('Cursor database not found.'));
+            process.exit(1);
+        }
+        const totalConversations = reader.getConversationCount();
+        const allConversations = reader.listConversations({ limit: 10000 });
+        let processedCount = 0;
+        let totalMessages = 0;
+        let conversationsWithCode = 0;
+        for (const conv of allConversations) {
+            if (metadataStore.isConversationProcessed(conv.id)) {
+                processedCount++;
+            }
+            totalMessages += conv.messageCount;
+            if (conv.hasCodeBlocks) {
+                conversationsWithCode++;
+            }
+        }
+        const memoryStats = metadataStore.getMemoryStats();
+        console.log(chalk.cyan('\n📊 Chat History Statistics\n'));
+        console.log(chalk.bold('Cursor Database:'));
+        console.log(`  Total conversations: ${totalConversations}`);
+        console.log(`  Total messages: ${totalMessages}`);
+        console.log(`  Conversations with code: ${conversationsWithCode}`);
+        console.log(chalk.bold('\nIngestion Status:'));
+        console.log(`  Processed: ${processedCount}/${totalConversations} (${Math.round(processedCount / totalConversations * 100)}%)`);
+        console.log(`  Pending: ${totalConversations - processedCount}`);
+        console.log(chalk.bold('\nMemory Store:'));
+        console.log(`  Total chunks: ${memoryStats.totalChunks}`);
+        console.log(`  Active chunks: ${memoryStats.activeChunks}`);
+        console.log(`  Archived chunks: ${memoryStats.archivedChunks}`);
+        console.log(`  Avg decay score: ${memoryStats.avgDecayScore.toFixed(3)}`);
+        if (Object.keys(memoryStats.chunksByType).length > 0) {
+            console.log(chalk.bold('\nChunks by Type:'));
+            for (const [type, count] of Object.entries(memoryStats.chunksByType)) {
+                console.log(`  ${type}: ${count}`);
+            }
+        }
+        console.log('');
+    }
+    catch (error) {
+        console.error(chalk.red(`Error: ${error instanceof Error ? error.message : 'Unknown error'}`));
+        process.exit(1);
+    }
+});
+chatCommand
+    .command('reset')
+    .description('Reset chat history processing status (does not delete ingested data)')
+    .option('--confirm', 'Confirm reset operation')
+    .action(async (options) => {
+    if (!options.confirm) {
+        console.log(chalk.yellow('\n⚠️  This will reset the processing status for all conversations.'));
+        console.log(chalk.yellow('   Ingested data will NOT be deleted, but conversations will be'));
+        console.log(chalk.yellow('   marked as unprocessed and can be re-ingested.\n'));
+        console.log(chalk.gray('Run with --confirm to proceed.\n'));
+        return;
+    }
+    const spinner = ora('Resetting processing status...').start();
+    try {
+        const metadataStore = getMemoryMetadataStore();
+        const db = metadataStore.db;
+        db.prepare('DELETE FROM processed_conversations').run();
+        spinner.succeed('Processing status reset');
+        console.log(chalk.green('\nAll conversations marked as unprocessed.'));
+        console.log(chalk.gray('Run `cursor-rag chat ingest` to re-process them.\n'));
+    }
+    catch (error) {
+        spinner.fail('Reset failed');
+        console.error(chalk.red(`Error: ${error instanceof Error ? error.message : 'Unknown error'}`));
+        process.exit(1);
+    }
+});
+export { chatCommand };
+//# sourceMappingURL=chat.js.map