codeseeker 1.4.0

package/dist/cli/commands/services/claude-intent-analyzer.js

@@ -0,0 +1,405 @@
+"use strict";
+/**
+ * Claude Intent Analyzer Service
+ * Single Responsibility: Use Claude Code CLI to analyze user queries and detect intent
+ *
+ * This service replaces all hardcoded keyword-based intent detection with actual
+ * Claude AI analysis, providing accurate and context-aware query understanding.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ClaudeIntentAnalyzer = void 0;
+const claude_code_executor_1 = require("../../services/claude/claude-code-executor");
+const logger_1 = require("../../../utils/logger");
+class ClaudeIntentAnalyzer {
+    logger = logger_1.Logger.getInstance();
+    static instance;
+    /**
+     * Get singleton instance
+     */
+    static getInstance() {
+        if (!ClaudeIntentAnalyzer.instance) {
+            ClaudeIntentAnalyzer.instance = new ClaudeIntentAnalyzer();
+        }
+        return ClaudeIntentAnalyzer.instance;
+    }
+    /**
+     * Analyze a user query using Claude Code CLI
+     * This is the main method that replaces all hardcoded intent detection
+     */
+    async analyzeQuery(query, projectContext) {
+        try {
+            const prompt = this.buildAnalysisPrompt(query, projectContext);
+            this.logger.debug('🧠 Analyzing query intent with Claude...');
+            const result = await claude_code_executor_1.ClaudeCodeExecutor.execute(prompt, {
+                outputFormat: 'json',
+                maxTokens: 2000,
+                timeout: 30000 // 30 second timeout for intent analysis
+            });
+            if (!result.success || !result.data) {
+                this.logger.warn('Claude intent analysis failed, using fallback');
+                return {
+                    success: true,
+                    analysis: this.fallbackAnalysis(query),
+                    fallbackUsed: true
+                };
+            }
+            // Parse Claude's response
+            const analysis = this.parseClaudeResponse(result.data, query);
+            return {
+                success: true,
+                analysis,
+                fallbackUsed: false
+            };
+        }
+        catch (error) {
+            this.logger.error(`Intent analysis error: ${error instanceof Error ? error.message : error}`);
+            return {
+                success: true,
+                analysis: this.fallbackAnalysis(query),
+                fallbackUsed: true,
+                error: error instanceof Error ? error.message : 'Unknown error'
+            };
+        }
+    }
+    /**
+     * Build the prompt for Claude to analyze the query
+     */
+    buildAnalysisPrompt(query, projectContext) {
+        const contextSection = projectContext
+            ? `\n\nProject Context:\n${projectContext}`
+            : '';
+        return `You are an intent analyzer for a code assistant CLI tool. Analyze the following user query and provide a structured JSON response.
+
+User Query: "${query}"${contextSection}
+
+Analyze this query and respond with ONLY a JSON object (no markdown, no explanation) in this exact format:
+{
+  "intent": "create|modify|fix|delete|understand|analyze|search|general",
+  "confidence": 0.0-1.0,
+  "reasoning": "Brief explanation of why this intent was detected",
+  "requiresModifications": true|false,
+  "assumptions": ["List of assumptions the user might be making"],
+  "ambiguities": ["List of unclear or ambiguous aspects that might need clarification"],
+  "suggestedClarifications": ["Questions to ask the user for better understanding"],
+  "targetEntities": ["Classes, functions, or files the query seems to target"],
+  "actionVerbs": ["Key action verbs from the query"]
+}
+
+Intent Definitions:
+- "create": User wants to ADD new code, features, files, or functionality
+- "modify": User wants to CHANGE/UPDATE/REFACTOR existing code
+- "fix": User wants to FIX bugs, errors, or issues
+- "delete": User wants to REMOVE code or features
+- "understand": User wants to LEARN about/EXPLAIN how code works
+- "analyze": User wants to ANALYZE code quality, patterns, or structure
+- "search": User wants to FIND specific code, files, or patterns
+- "general": Other requests that don't fit above categories
+
+Important:
+- Be precise with intent detection
+- List any assumptions the user might be making
+- Identify ambiguities that could lead to misunderstanding
+- Suggest clarifying questions if the query is vague
+- Extract specific entities (class names, file names) if mentioned
+
+Respond with ONLY the JSON object, no other text.`;
+    }
+    /**
+     * Parse Claude's JSON response
+     */
+    parseClaudeResponse(response, originalQuery) {
+        try {
+            // Try to extract JSON from response (Claude might wrap it in markdown)
+            let jsonStr = response.trim();
+            // Remove markdown code blocks if present
+            if (jsonStr.startsWith('```json')) {
+                jsonStr = jsonStr.replace(/^```json\n?/, '').replace(/\n?```$/, '');
+            }
+            else if (jsonStr.startsWith('```')) {
+                jsonStr = jsonStr.replace(/^```\n?/, '').replace(/\n?```$/, '');
+            }
+            const parsed = JSON.parse(jsonStr);
+            // Validate and normalize the response
+            return {
+                intent: this.normalizeIntent(parsed.intent),
+                confidence: Math.min(1, Math.max(0, Number(parsed.confidence) || 0.5)),
+                reasoning: String(parsed.reasoning || ''),
+                requiresModifications: Boolean(parsed.requiresModifications),
+                assumptions: Array.isArray(parsed.assumptions) ? parsed.assumptions.map(String) : [],
+                ambiguities: Array.isArray(parsed.ambiguities) ? parsed.ambiguities.map(String) : [],
+                suggestedClarifications: Array.isArray(parsed.suggestedClarifications) ? parsed.suggestedClarifications.map(String) : [],
+                targetEntities: Array.isArray(parsed.targetEntities) ? parsed.targetEntities.map(String) : [],
+                actionVerbs: Array.isArray(parsed.actionVerbs) ? parsed.actionVerbs.map(String) : []
+            };
+        }
+        catch (parseError) {
+            this.logger.warn('Failed to parse Claude response, using fallback analysis');
+            return this.fallbackAnalysis(originalQuery);
+        }
+    }
+    /**
+     * Normalize intent string to valid enum value
+     */
+    normalizeIntent(intent) {
+        const normalized = String(intent || '').toLowerCase().trim();
+        const validIntents = [
+            'create', 'modify', 'fix', 'delete', 'understand', 'analyze', 'search', 'general'
+        ];
+        if (validIntents.includes(normalized)) {
+            return normalized;
+        }
+        // Map common variations
+        const mappings = {
+            'add': 'create',
+            'new': 'create',
+            'implement': 'create',
+            'build': 'create',
+            'change': 'modify',
+            'update': 'modify',
+            'refactor': 'modify',
+            'edit': 'modify',
+            'bug': 'fix',
+            'error': 'fix',
+            'debug': 'fix',
+            'repair': 'fix',
+            'remove': 'delete',
+            'explain': 'understand',
+            'what': 'understand',
+            'how': 'understand',
+            'why': 'understand',
+            'find': 'search',
+            'locate': 'search',
+            'where': 'search'
+        };
+        return mappings[normalized] || 'general';
+    }
+    /**
+     * Fallback analysis when Claude is unavailable
+     * This is minimal and should rarely be used
+     */
+    fallbackAnalysis(query) {
+        this.logger.debug('Using fallback intent analysis');
+        return {
+            intent: 'general',
+            confidence: 0.5,
+            reasoning: 'Fallback analysis - Claude unavailable',
+            requiresModifications: false,
+            assumptions: [],
+            ambiguities: ['Query intent could not be determined automatically'],
+            suggestedClarifications: ['What specifically would you like me to do with this request?'],
+            targetEntities: [],
+            actionVerbs: []
+        };
+    }
+    /**
+     * Quick check if query is a natural language request (vs a command)
+     * This is a simple heuristic check, not AI-based
+     */
+    isNaturalLanguageQuery(input) {
+        const trimmed = input.trim();
+        // Known commands start with these
+        const knownCommands = new Set([
+            'help', 'exit', 'quit', 'status', 'setup', 'init', 'project', 'sync',
+            'search', 'analyze', 'dedup', 'solid', 'docs', 'instructions', 'watch', 'watcher'
+        ]);
+        const firstWord = trimmed.split(' ')[0].toLowerCase();
+        if (knownCommands.has(firstWord)) {
+            return false;
+        }
+        // If it's longer than a typical command, assume it's natural language
+        return trimmed.length > 2;
+    }
+    /**
+     * Decompose a complex query into sub-tasks using Claude
+     * This replaces all hardcoded keyword matching for task decomposition
+     */
+    async decomposeQuery(query, intentAnalysis) {
+        try {
+            const prompt = this.buildDecompositionPrompt(query, intentAnalysis);
+            this.logger.debug('🔀 Decomposing query with Claude...');
+            const result = await claude_code_executor_1.ClaudeCodeExecutor.execute(prompt, {
+                outputFormat: 'json',
+                maxTokens: 3000,
+                timeout: 45000 // 45 second timeout for decomposition
+            });
+            if (!result.success || !result.data) {
+                this.logger.warn('Claude task decomposition failed, using fallback');
+                return {
+                    success: true,
+                    decomposition: this.fallbackDecomposition(query, intentAnalysis),
+                    fallbackUsed: true
+                };
+            }
+            const decomposition = this.parseDecompositionResponse(result.data, query, intentAnalysis);
+            return {
+                success: true,
+                decomposition,
+                fallbackUsed: false
+            };
+        }
+        catch (error) {
+            this.logger.error(`Task decomposition error: ${error instanceof Error ? error.message : error}`);
+            return {
+                success: true,
+                decomposition: this.fallbackDecomposition(query, intentAnalysis),
+                fallbackUsed: true,
+                error: error instanceof Error ? error.message : 'Unknown error'
+            };
+        }
+    }
+    /**
+     * Build the prompt for Claude to decompose the query into sub-tasks
+     */
+    buildDecompositionPrompt(query, intentAnalysis) {
+        return `You are a task decomposition expert for a code assistant. Analyze the following user query and determine if it should be split into multiple sub-tasks.
+
+User Query: "${query}"
+
+Detected Intent: ${intentAnalysis.intent}
+Target Entities: ${intentAnalysis.targetEntities.join(', ') || 'none detected'}
+Action Verbs: ${intentAnalysis.actionVerbs.join(', ') || 'none detected'}
+
+Analyze this query and respond with ONLY a JSON object (no markdown, no explanation) in this exact format:
+{
+  "isComplex": true|false,
+  "reasoning": "Brief explanation of why this is/isn't complex",
+  "subTasks": [
+    {
+      "id": 1,
+      "type": "analyze|create|modify|refactor|test|fix|document|configure|general",
+      "description": "Clear description of what this sub-task should accomplish",
+      "searchTerms": ["terms", "to", "search", "for"],
+      "priority": 1,
+      "dependencies": [],
+      "complexity": "low|medium|high"
+    }
+  ]
+}
+
+Task Type Definitions:
+- "analyze": Understanding, reviewing, or explaining code
+- "create": Adding new files, classes, functions, or features
+- "modify": Changing existing code without restructuring
+- "refactor": Restructuring code for better design (e.g., SOLID compliance)
+- "test": Writing or updating tests
+- "fix": Bug fixes or error resolution
+- "document": Documentation updates
+- "configure": Configuration or setup changes
+- "general": Other tasks
+
+Guidelines for decomposition:
+1. A query is "complex" if it contains MULTIPLE DISTINCT ACTIONS or MULTI-PART CONCEPTS
+2. Domain concepts should be expanded:
+   - "SOLID principles" = 5 separate sub-tasks (S, O, L, I, D)
+   - "CRUD operations" = 4 separate sub-tasks (Create, Read, Update, Delete)
+   - "authentication flow" = login, logout, registration, password reset
+3. Each sub-task should be FOCUSED on ONE thing
+4. Dependencies: later tasks may depend on earlier ones (e.g., tests depend on implementation)
+5. Priority: 1 = do first, higher numbers = do later
+6. If query is simple (single action, single target), set isComplex: false with ONE sub-task
+
+Examples:
+- "add a button" → isComplex: false, 1 sub-task
+- "add a button and write tests" → isComplex: true, 2 sub-tasks
+- "make this SOLID compliant" → isComplex: true, 5 sub-tasks (one per principle)
+- "implement user auth" → isComplex: true, multiple sub-tasks (register, login, logout, etc.)
+
+Respond with ONLY the JSON object, no other text.`;
+    }
+    /**
+     * Parse Claude's decomposition response
+     */
+    parseDecompositionResponse(response, originalQuery, intentAnalysis) {
+        try {
+            let jsonStr = response.trim();
+            // Remove markdown code blocks if present
+            if (jsonStr.startsWith('```json')) {
+                jsonStr = jsonStr.replace(/^```json\n?/, '').replace(/\n?```$/, '');
+            }
+            else if (jsonStr.startsWith('```')) {
+                jsonStr = jsonStr.replace(/^```\n?/, '').replace(/\n?```$/, '');
+            }
+            const parsed = JSON.parse(jsonStr);
+            // Validate and normalize
+            const subTasks = (parsed.subTasks || []).map((task, index) => ({
+                id: task.id || index + 1,
+                type: this.normalizeTaskType(task.type),
+                description: String(task.description || ''),
+                searchTerms: Array.isArray(task.searchTerms) ? task.searchTerms.map(String) : [],
+                priority: Number(task.priority) || index + 1,
+                dependencies: Array.isArray(task.dependencies) ? task.dependencies.map(Number) : [],
+                complexity: this.normalizeComplexity(task.complexity)
+            }));
+            return {
+                isComplex: Boolean(parsed.isComplex),
+                reasoning: String(parsed.reasoning || ''),
+                subTasks: subTasks.length > 0 ? subTasks : [this.createSingleTask(originalQuery, intentAnalysis)]
+            };
+        }
+        catch (parseError) {
+            this.logger.warn('Failed to parse decomposition response, using fallback');
+            return this.fallbackDecomposition(originalQuery, intentAnalysis);
+        }
+    }
+    /**
+     * Normalize task type to valid enum value
+     */
+    normalizeTaskType(type) {
+        const normalized = String(type || '').toLowerCase().trim();
+        const validTypes = [
+            'analyze', 'create', 'modify', 'refactor', 'test', 'fix', 'document', 'configure', 'general'
+        ];
+        if (validTypes.includes(normalized)) {
+            return normalized;
+        }
+        return 'general';
+    }
+    /**
+     * Normalize complexity level
+     */
+    normalizeComplexity(complexity) {
+        const normalized = String(complexity || '').toLowerCase().trim();
+        if (['low', 'medium', 'high'].includes(normalized)) {
+            return normalized;
+        }
+        return 'medium';
+    }
+    /**
+     * Create a single task from the original query
+     */
+    createSingleTask(query, intentAnalysis) {
+        // Map intent to task type
+        const intentToType = {
+            'create': 'create',
+            'modify': 'modify',
+            'fix': 'fix',
+            'delete': 'modify',
+            'understand': 'analyze',
+            'analyze': 'analyze',
+            'search': 'analyze',
+            'general': 'general'
+        };
+        return {
+            id: 1,
+            type: intentToType[intentAnalysis.intent] || 'general',
+            description: query,
+            searchTerms: intentAnalysis.targetEntities,
+            priority: 1,
+            dependencies: [],
+            complexity: 'medium'
+        };
+    }
+    /**
+     * Fallback decomposition when Claude is unavailable
+     */
+    fallbackDecomposition(query, intentAnalysis) {
+        this.logger.debug('Using fallback task decomposition');
+        return {
+            isComplex: false,
+            reasoning: 'Fallback decomposition - Claude unavailable',
+            subTasks: [this.createSingleTask(query, intentAnalysis)]
+        };
+    }
+}
+exports.ClaudeIntentAnalyzer = ClaudeIntentAnalyzer;
+//# sourceMappingURL=claude-intent-analyzer.js.map

package/dist/cli/commands/services/claude-intent-analyzer.js.map

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

package/dist/cli/commands/services/context-aware-clarification-service.d.ts

@@ -0,0 +1,99 @@
+/**
+ * Context-Aware Clarification Service
+ * Single Responsibility: Generate intelligent clarification questions AFTER research phase
+ *
+ * This service analyzes the semantic search results and code relationships to generate
+ * specific, actionable questions that help clarify user intent before Claude Code executes.
+ *
+ * Key Principle: Ask questions based on ACTUAL codebase state, not generic patterns.
+ */
+import * as readline from 'readline';
+import { SemanticResult } from './semantic-search-orchestrator';
+import { GraphContext } from './graph-analysis-service';
+import { QueryAnalysis } from './natural-language-processor';
+export interface ClarificationQuestion {
+    id: string;
+    question: string;
+    type: 'choice' | 'confirm' | 'input';
+    choices?: string[];
+    context: string;
+    impact: 'high' | 'medium' | 'low';
+}
+export interface ClarificationResult {
+    questionsAsked: number;
+    questionsAnswered: number;
+    clarifications: Map<string, string>;
+    enhancedQuery: string;
+    skipped: boolean;
+    skipReason?: string;
+}
+export interface AmbiguityDetection {
+    type: 'multiple_implementations' | 'unclear_target' | 'missing_pattern' | 'conflicting_approaches' | 'scope_unclear';
+    description: string;
+    relatedFiles: string[];
+    suggestedQuestion: ClarificationQuestion;
+}
+export declare class ContextAwareClarificationService {
+    private rl?;
+    /**
+     * Set readline interface for pausing during prompts
+     */
+    setReadlineInterface(rl: readline.Interface): void;
+    /**
+     * Analyze context and generate clarification questions if needed
+     * This runs AFTER semantic search and relationship analysis
+     */
+    analyzeAndClarify(query: string, queryAnalysis: QueryAnalysis, semanticResults: SemanticResult[], graphContext: GraphContext, options?: {
+        skipClarification?: boolean;
+        maxQuestions?: number;
+    }): Promise<ClarificationResult>;
+    /**
+     * Detect ambiguities based on actual codebase context
+     */
+    private detectAmbiguities;
+    /**
+     * Find similar implementations in the codebase
+     */
+    private findSimilarImplementations;
+    /**
+     * Find existing patterns that might overlap with the request
+     */
+    private findExistingPatterns;
+    /**
+     * Check if query is too broad
+     */
+    private isBroadQuery;
+    /**
+     * Detect test framework from file patterns
+     */
+    private detectTestFramework;
+    /**
+     * Ask clarification questions interactively
+     */
+    private askQuestions;
+    /**
+     * Ask a single question based on type
+     */
+    private askSingleQuestion;
+    /**
+     * Build enhanced query incorporating clarifications
+     */
+    private buildEnhancedQuery;
+    /**
+     * Format a clarification for the enhanced query
+     */
+    private formatClarification;
+    /**
+     * Get impact score for sorting
+     */
+    private impactScore;
+    /**
+     * Build a human-readable reason explaining why clarification was skipped
+     */
+    private buildSkipReason;
+    /**
+     * Create a skipped result
+     */
+    private createSkippedResult;
+}
+//# sourceMappingURL=context-aware-clarification-service.d.ts.map

package/dist/cli/commands/services/context-aware-clarification-service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context-aware-clarification-service.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/services/context-aware-clarification-service.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,OAAO,KAAK,QAAQ,MAAM,UAAU,CAAC;AACrC,OAAO,EAAE,cAAc,EAAE,MAAM,gCAAgC,CAAC;AAChE,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AACxD,OAAO,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAC;AAG7D,MAAM,WAAW,qBAAqB;IACpC,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,QAAQ,GAAG,SAAS,GAAG,OAAO,CAAC;IACrC,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,GAAG,QAAQ,GAAG,KAAK,CAAC;CACnC;AAED,MAAM,WAAW,mBAAmB;IAClC,cAAc,EAAE,MAAM,CAAC;IACvB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,cAAc,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACpC,aAAa,EAAE,MAAM,CAAC;IACtB,OAAO,EAAE,OAAO,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,0BAA0B,GAAG,gBAAgB,GAAG,iBAAiB,GAAG,wBAAwB,GAAG,eAAe,CAAC;IACrH,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,iBAAiB,EAAE,qBAAqB,CAAC;CAC1C;AAED,qBAAa,gCAAgC;IAC3C,OAAO,CAAC,EAAE,CAAC,CAAqB;IAEhC;;OAEG;IACH,oBAAoB,CAAC,EAAE,EAAE,QAAQ,CAAC,SAAS,GAAG,IAAI;IAIlD;;;OAGG;IACG,iBAAiB,CACrB,KAAK,EAAE,MAAM,EACb,aAAa,EAAE,aAAa,EAC5B,eAAe,EAAE,cAAc,EAAE,EACjC,YAAY,EAAE,YAAY,EAC1B,OAAO,GAAE;QAAE,iBAAiB,CAAC,EAAE,OAAO,CAAC;QAAC,YAAY,CAAC,EAAE,MAAM,CAAA;KAAO,GACnE,OAAO,CAAC,mBAAmB,CAAC;IAwC/B;;OAEG;IACH,OAAO,CAAC,iBAAiB;IA4IzB;;OAEG;IACH,OAAO,CAAC,0BAA0B;IAiClC;;OAEG;IACH,OAAO,CAAC,oBAAoB;IAuB5B;;OAEG;IACH,OAAO,CAAC,YAAY;IASpB;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAQ3B;;OAEG;YACW,YAAY;IAyB1B;;OAEG;YACW,iBAAiB;IAsC/B;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAe1B;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAW3B;;OAEG;IACH,OAAO,CAAC,WAAW;IAInB;;OAEG;IACH,OAAO,CAAC,eAAe;IAmDvB;;OAEG;IACH,OAAO,CAAC,mBAAmB;CAU5B"}