codeseeker 1.4.0

package/dist/cli/commands/services/semantic-search-orchestrator.js

@@ -0,0 +1,331 @@
+"use strict";
+/**
+ * Semantic Search Orchestrator Service
+ * Single Responsibility: Coordinate semantic search operations
+ *
+ * STORAGE MODES:
+ * - Embedded (default): Uses SQLite for vectors + MiniSearch for text search
+ * - Server: Uses PostgreSQL with pgvector for production deployments
+ *
+ * HYBRID SEARCH STRATEGY:
+ * Combines multiple search methods and fuses results using Reciprocal Rank Fusion (RRF):
+ *
+ * 1. Vector Similarity - Semantic understanding of concepts
+ * 2. MiniSearch Text Search - BM25 scoring with synonym expansion and CamelCase tokenization
+ * 3. File Path Matching - Directory/filename pattern matching
+ *
+ * The hybrid approach solves the problem where:
+ * - "command handler" doesn't match "controller" semantically
+ * - But text search with synonym expansion (handler → controller) catches it
+ *
+ * NO FILE FALLBACK: If storage is unavailable or has no results, returns empty array.
+ * Claude handles file discovery natively - we don't duplicate that functionality.
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SemanticSearchOrchestrator = void 0;
+const path = __importStar(require("path"));
+const logger_1 = require("../../../utils/logger");
+const embedding_generator_adapter_1 = require("../../services/search/embedding-generator-adapter");
+const storage_1 = require("../../../storage");
+class SemanticSearchOrchestrator {
+    logger = logger_1.Logger.getInstance();
+    projectId;
+    embeddingGenerator;
+    storageManager = null;
+    useEmbedded = false;
+    vectorStore;
+    projectStore;
+    constructor() {
+        this.embeddingGenerator = new embedding_generator_adapter_1.EmbeddingGeneratorAdapter();
+    }
+    /**
+     * Initialize storage - checks if we should use embedded or server mode
+     */
+    async initStorage() {
+        if (this.storageManager !== null)
+            return; // Already initialized
+        try {
+            this.storageManager = await (0, storage_1.getStorageManager)();
+            this.useEmbedded = (0, storage_1.isUsingEmbeddedStorage)();
+            this.vectorStore = this.storageManager.getVectorStore();
+            this.projectStore = this.storageManager.getProjectStore();
+            this.logger.debug(`Semantic search using ${this.useEmbedded ? 'embedded' : 'server'} storage`);
+        }
+        catch (error) {
+            this.logger.debug(`Storage manager init failed: ${error}`);
+            this.useEmbedded = false;
+        }
+    }
+    /**
+     * Set project ID for scoped searches
+     */
+    setProjectId(projectId) {
+        this.projectId = projectId;
+    }
+    /**
+     * Resolve project ID from storage by project path
+     */
+    async resolveProjectId(projectPath) {
+        try {
+            if (!this.projectStore)
+                return undefined;
+            // Get all projects and find matching one
+            const projects = await this.projectStore.list();
+            const absolutePath = path.resolve(projectPath);
+            // Try to match by various path formats
+            const project = projects.find(p => {
+                const projectAbsolute = path.resolve(p.path);
+                return p.path === projectPath ||
+                    p.path === absolutePath ||
+                    projectAbsolute === absolutePath ||
+                    path.basename(p.path) === path.basename(projectPath);
+            });
+            if (project) {
+                return project.id;
+            }
+        }
+        catch (error) {
+            this.logger.debug(`Could not resolve project ID: ${error instanceof Error ? error.message : error}`);
+        }
+        return undefined;
+    }
+    /**
+     * Perform HYBRID semantic search
+     * Uses storage interface abstraction for both embedded and server modes
+     * Combines vector similarity with keyword/synonym matching for better recall
+     * Returns empty array if storage unavailable or no results - Claude handles file discovery natively
+     */
+    async performSemanticSearch(query, projectPath) {
+        try {
+            // Initialize storage mode detection
+            await this.initStorage();
+            if (!this.vectorStore || !this.projectStore) {
+                this.logger.debug('Storage not initialized');
+                return [];
+            }
+            // Resolve project ID from storage if not already set or if set to non-UUID value
+            if (!this.projectId || this.projectId === 'default' || !this.isValidUUID(this.projectId)) {
+                const resolvedId = await this.resolveProjectId(projectPath);
+                if (resolvedId) {
+                    this.projectId = resolvedId;
+                    this.logger.debug(`Resolved project ID: ${resolvedId}`);
+                }
+                else {
+                    this.logger.debug('No project ID resolved - returning empty results');
+                    return [];
+                }
+            }
+            // Perform HYBRID search using storage interface
+            return await this.performHybridSearchViaInterface(query, projectPath);
+        }
+        catch (error) {
+            // Log at debug level - Claude handles file discovery anyway
+            this.logger.debug(`Semantic search unavailable: ${error instanceof Error ? error.message : error}`);
+            return [];
+        }
+    }
+    /**
+     * Perform hybrid search using the storage interface abstraction
+     * Works for both embedded (SQLite + MiniSearch) and server (PostgreSQL + pgvector) modes
+     * The IVectorStore implementation handles the specific search logic internally
+     */
+    async performHybridSearchViaInterface(query, projectPath) {
+        if (!this.vectorStore || !this.projectId)
+            return [];
+        try {
+            this.logger.debug(`Performing hybrid search for project: ${this.projectId}`);
+            // Generate query embedding for vector search
+            let queryEmbedding = [];
+            try {
+                queryEmbedding = await this.embeddingGenerator.generateQueryEmbedding(query);
+            }
+            catch (error) {
+                this.logger.debug(`Query embedding generation failed, using text search only: ${error}`);
+            }
+            // Use the storage interface's hybrid search
+            // The implementation handles vector similarity, text search (MiniSearch), and path matching internally
+            // Request more results to allow for deduplication by file path
+            const results = await this.vectorStore.searchHybrid(query, queryEmbedding, this.projectId, 30);
+            this.logger.debug(`Hybrid search found ${results.length} results (before dedup)`);
+            // Deduplicate by file path with multi-chunk boost
+            // If multiple chunks from the same file match, that file is more relevant
+            // We keep the best chunk's content but boost the score based on chunk count
+            const fileMap = new Map();
+            for (const r of results) {
+                const filePath = path.isAbsolute(r.document.filePath)
+                    ? path.relative(projectPath, r.document.filePath)
+                    : r.document.filePath;
+                const existing = fileMap.get(filePath);
+                if (existing) {
+                    // File already seen - increment count and accumulate score
+                    existing.chunkCount++;
+                    existing.totalScore += r.score;
+                    // Keep the highest scoring chunk's content
+                    if (r.score > existing.result.score) {
+                        existing.result = r;
+                    }
+                }
+                else {
+                    fileMap.set(filePath, { result: r, chunkCount: 1, totalScore: r.score });
+                }
+            }
+            // Calculate boosted scores:
+            // - Base: best chunk score
+            // - Boost: +10% per additional matching chunk (capped at 50% boost)
+            // - Final score ALWAYS capped at 1.0 (100%)
+            const boostedResults = Array.from(fileMap.values()).map(entry => {
+                const chunkBoost = Math.min((entry.chunkCount - 1) * 0.10, 0.50);
+                const boostedScore = Math.min(1.0, entry.result.score * (1 + chunkBoost));
+                return {
+                    ...entry.result,
+                    score: boostedScore,
+                    _chunkCount: entry.chunkCount // For debugging
+                };
+            });
+            // Sort by boosted score and limit to 15 unique files
+            const uniqueResults = boostedResults
+                .sort((a, b) => b.score - a.score)
+                .slice(0, 15);
+            this.logger.debug(`Returning ${uniqueResults.length} unique files`);
+            return uniqueResults.map(r => ({
+                file: path.isAbsolute(r.document.filePath)
+                    ? path.relative(projectPath, r.document.filePath)
+                    : r.document.filePath,
+                type: this.determineFileType(r.document.filePath),
+                similarity: r.score,
+                content: this.formatContent(r.document.content, r.document.metadata),
+                lineStart: 1,
+                lineEnd: 20,
+                // Pass through debug info for verbose mode
+                debug: r.debug
+            }));
+        }
+        catch (error) {
+            this.logger.debug(`Hybrid search error: ${error instanceof Error ? error.message : error}`);
+            return [];
+        }
+    }
+    /**
+     * Check if string is valid UUID
+     */
+    isValidUUID(str) {
+        const uuidRegex = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;
+        return uuidRegex.test(str);
+    }
+    /**
+     * Format content from database with metadata
+     */
+    formatContent(content, metadata) {
+        let formatted = content;
+        if (metadata) {
+            try {
+                const meta = typeof metadata === 'string' ? JSON.parse(metadata) : metadata;
+                if (meta.classes) {
+                    formatted = `Classes: ${meta.classes.join(', ')}\n\n${formatted}`;
+                }
+                if (meta.functions) {
+                    formatted = `Functions: ${meta.functions.slice(0, 5).join(', ')}\n\n${formatted}`;
+                }
+            }
+            catch {
+                // Ignore metadata parse errors
+            }
+        }
+        // Allow ~50 lines of content (~2500 chars) to support meaningful file previews
+        // This reduces Claude's need to Read files, saving tool call tokens
+        if (formatted.length > 2500) {
+            formatted = formatted.substring(0, 2500) + '...';
+        }
+        return formatted;
+    }
+    /**
+     * Determine file type based on path and name
+     */
+    determineFileType(filePath) {
+        const fileName = path.basename(filePath).toLowerCase();
+        const dirPath = path.dirname(filePath).toLowerCase();
+        if (fileName.includes('controller'))
+            return 'controller';
+        if (fileName.includes('service'))
+            return 'service';
+        if (fileName.includes('manager'))
+            return 'manager';
+        if (fileName.includes('handler'))
+            return 'handler';
+        if (fileName.includes('middleware'))
+            return 'middleware';
+        if (fileName.includes('auth') || fileName.includes('login'))
+            return 'authentication';
+        if (fileName.includes('api') || fileName.includes('route'))
+            return 'api';
+        if (fileName.includes('model') || fileName.includes('entity'))
+            return 'model';
+        if (fileName.includes('test') || fileName.includes('spec'))
+            return 'test';
+        if (fileName.includes('config'))
+            return 'configuration';
+        if (fileName.includes('util') || fileName.includes('helper'))
+            return 'utility';
+        if (fileName.includes('interface') || fileName.includes('types'))
+            return 'interface';
+        if (fileName.includes('repository') || fileName.includes('dao'))
+            return 'repository';
+        if (dirPath.includes('controller'))
+            return 'controller';
+        if (dirPath.includes('service'))
+            return 'service';
+        if (dirPath.includes('auth'))
+            return 'authentication';
+        if (dirPath.includes('api') || dirPath.includes('route'))
+            return 'api';
+        if (dirPath.includes('model') || dirPath.includes('entity'))
+            return 'model';
+        if (dirPath.includes('test'))
+            return 'test';
+        if (dirPath.includes('config'))
+            return 'configuration';
+        const ext = path.extname(filePath);
+        if (['.ts', '.js'].includes(ext))
+            return 'module';
+        if (['.json', '.yaml', '.yml'].includes(ext))
+            return 'configuration';
+        if (['.md', '.txt', '.rst'].includes(ext))
+            return 'documentation';
+        return 'module';
+    }
+}
+exports.SemanticSearchOrchestrator = SemanticSearchOrchestrator;
+//# sourceMappingURL=semantic-search-orchestrator.js.map

package/dist/cli/commands/services/semantic-search-orchestrator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"semantic-search-orchestrator.js","sourceRoot":"","sources":["../../../../src/cli/commands/services/semantic-search-orchestrator.ts"],"names":[],"mappings":"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"}

package/dist/cli/commands/services/task-decomposition-service.d.ts

@@ -0,0 +1,114 @@
+/**
+ * Task Decomposition Service
+ * Single Responsibility: Delegate query decomposition to Claude for intelligent task splitting
+ *
+ * This service enables the "Task Split" capability where complex multi-part requests
+ * are broken down into smaller, focused tasks. Each sub-task gets its own tailored
+ * context from the semantic search and graph analysis.
+ *
+ * All decomposition logic is now delegated to ClaudeIntentAnalyzer, which uses
+ * actual Claude AI to analyze and decompose queries instead of hardcoded patterns.
+ *
+ * Benefits:
+ * - Better Focus: Claude concentrates on one thing at a time
+ * - Optimized Context: Each sub-task gets precisely relevant files
+ * - Reduced Token Usage: No wasted tokens on irrelevant context
+ * - Improved Accuracy: AI-powered decomposition understands domain concepts
+ */
+import { QueryAnalysis } from './natural-language-processor';
+import { SemanticResult } from './semantic-search-orchestrator';
+import { GraphContext } from './graph-analysis-service';
+export interface SubTask {
+    id: number;
+    type: SubTaskType;
+    description: string;
+    searchTerms: string[];
+    priority: number;
+    dependencies: number[];
+    contextFilter?: ContextFilter;
+    estimatedComplexity: 'low' | 'medium' | 'high';
+}
+export type SubTaskType = 'analyze' | 'create' | 'modify' | 'refactor' | 'test' | 'fix' | 'document' | 'configure' | 'general';
+export interface ContextFilter {
+    filePatterns?: string[];
+    fileTypes?: string[];
+    relationshipTypes?: string[];
+    maxFiles?: number;
+}
+export interface DecompositionResult {
+    isComplex: boolean;
+    originalQuery: string;
+    subTasks: SubTask[];
+    executionPlan: ExecutionPlan;
+    reasoning?: string;
+}
+export interface ExecutionPlan {
+    phases: ExecutionPhase[];
+    totalEstimatedSteps: number;
+}
+export interface ExecutionPhase {
+    phaseNumber: number;
+    taskIds: number[];
+    description: string;
+}
+export interface SubTaskContext {
+    subTask: SubTask;
+    semanticResults: SemanticResult[];
+    graphContext: GraphContext;
+    enhancedPrompt: string;
+}
+export declare class TaskDecompositionService {
+    private claudeAnalyzer;
+    constructor();
+    /**
+     * Analyze a query and decompose it into sub-tasks using Claude
+     * This is the async version that uses AI for intelligent decomposition
+     */
+    decomposeQueryAsync(query: string, queryAnalysis: QueryAnalysis): Promise<DecompositionResult>;
+    /**
+     * Synchronous version for backward compatibility
+     * Returns single task - callers should migrate to decomposeQueryAsync
+     */
+    decomposeQuery(query: string, queryAnalysis: QueryAnalysis): DecompositionResult;
+    /**
+     * Convert Claude's DecomposedTask format to our SubTask format
+     */
+    private convertToSubTasks;
+    /**
+     * Create a single task result for simple queries
+     */
+    private createSingleTaskResult;
+    /**
+     * Map intent to task type
+     */
+    private mapIntentToTaskType;
+    /**
+     * Create context filter based on task type
+     */
+    private createContextFilter;
+    /**
+     * Create execution plan from sub-tasks
+     */
+    private createExecutionPlan;
+    /**
+     * Generate human-readable phase description
+     */
+    private describePhase;
+    /**
+     * Filter semantic results for a specific sub-task
+     */
+    filterContextForSubTask(subTask: SubTask, allSemanticResults: SemanticResult[], allGraphContext: GraphContext): SubTaskContext;
+    /**
+     * Build an enhanced prompt for a specific sub-task
+     */
+    private buildSubTaskPrompt;
+    /**
+     * Get specific instructions based on task type
+     */
+    private getTaskTypeInstructions;
+    /**
+     * Format decomposition result for display
+     */
+    formatDecompositionSummary(result: DecompositionResult): string;
+}
+//# sourceMappingURL=task-decomposition-service.d.ts.map

package/dist/cli/commands/services/task-decomposition-service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"task-decomposition-service.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/services/task-decomposition-service.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAC;AAC7D,OAAO,EAAE,cAAc,EAAE,MAAM,gCAAgC,CAAC;AAChE,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAGxD,MAAM,WAAW,OAAO;IACtB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,WAAW,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,aAAa,CAAC,EAAE,aAAa,CAAC;IAC9B,mBAAmB,EAAE,KAAK,GAAG,QAAQ,GAAG,MAAM,CAAC;CAChD;AAED,MAAM,MAAM,WAAW,GACnB,SAAS,GACT,QAAQ,GACR,QAAQ,GACR,UAAU,GACV,MAAM,GACN,KAAK,GACL,UAAU,GACV,WAAW,GACX,SAAS,CAAC;AAEd,MAAM,WAAW,aAAa;IAC5B,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IACrB,iBAAiB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC7B,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,mBAAmB;IAClC,SAAS,EAAE,OAAO,CAAC;IACnB,aAAa,EAAE,MAAM,CAAC;IACtB,QAAQ,EAAE,OAAO,EAAE,CAAC;IACpB,aAAa,EAAE,aAAa,CAAC;IAC7B,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,cAAc,EAAE,CAAC;IACzB,mBAAmB,EAAE,MAAM,CAAC;CAC7B;AAED,MAAM,WAAW,cAAc;IAC7B,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,OAAO,CAAC;IACjB,eAAe,EAAE,cAAc,EAAE,CAAC;IAClC,YAAY,EAAE,YAAY,CAAC;IAC3B,cAAc,EAAE,MAAM,CAAC;CACxB;AAED,qBAAa,wBAAwB;IACnC,OAAO,CAAC,cAAc,CAAuB;;IAM7C;;;OAGG;IACG,mBAAmB,CAAC,KAAK,EAAE,MAAM,EAAE,aAAa,EAAE,aAAa,GAAG,OAAO,CAAC,mBAAmB,CAAC;IAkCpG;;;OAGG;IACH,cAAc,CAAC,KAAK,EAAE,MAAM,EAAE,aAAa,EAAE,aAAa,GAAG,mBAAmB;IAMhF;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAazB;;OAEG;IACH,OAAO,CAAC,sBAAsB;IAyB9B;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAe3B;;OAEG;IACH,OAAO,CAAC,mBAAmB;IA4C3B;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAsC3B;;OAEG;IACH,OAAO,CAAC,aAAa;IAarB;;OAEG;IACH,uBAAuB,CACrB,OAAO,EAAE,OAAO,EAChB,kBAAkB,EAAE,cAAc,EAAE,EACpC,eAAe,EAAE,YAAY,GAC5B,cAAc;IA0EjB;;OAEG;IACH,OAAO,CAAC,kBAAkB;IA+C1B;;OAEG;IACH,OAAO,CAAC,uBAAuB;IAuB/B;;OAEG;IACH,0BAA0B,CAAC,MAAM,EAAE,mBAAmB,GAAG,MAAM;CAsBhE"}