codeseeker 1.4.0

package/dist/cli/commands/services/context-builder.js

@@ -0,0 +1,330 @@
+"use strict";
+/**
+ * Context Builder Service
+ * Single Responsibility: Build enhanced context for Claude Code prompts
+ * Combines semantic search results, graph analysis, and user clarifications
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ContextBuilder = void 0;
+class ContextBuilder {
+    /**
+     * Build enhanced context from all analysis results
+     */
+    buildEnhancedContext(originalQuery, queryAnalysis, userClarifications, semanticResults, graphContext) {
+        const intent = queryAnalysis.intent;
+        // Map relevant files and find their line numbers from graphContext classes
+        const relevantFiles = semanticResults.map(result => {
+            // Try to find corresponding class info with line numbers
+            const classInfo = graphContext.classes?.find(c => c.filePath === result.file ||
+                result.file.includes(c.name.toLowerCase().replace(/([A-Z])/g, '-$1').toLowerCase()));
+            return {
+                path: result.file,
+                type: result.type,
+                similarity: result.similarity,
+                preview: this.createFilePreview(result, intent),
+                startLine: classInfo?.filePath ? this.extractLineFromMetadata(classInfo) : undefined,
+                endLine: classInfo?.filePath ? this.extractEndLineFromMetadata(classInfo) : undefined
+            };
+        });
+        // Build relationships with file:line format and method names
+        const codeRelationships = graphContext.relationshipDetails.map(rel => ({
+            from: rel.from,
+            to: rel.to,
+            type: rel.type,
+            fromLocation: this.formatLocation(rel.fromPath, graphContext.classes?.find(c => c.name === rel.from)),
+            toLocation: this.formatLocation(rel.toPath, graphContext.classes?.find(c => c.name === rel.to)),
+            fromMethod: rel.fromMethod,
+            toMethod: rel.toMethod,
+            line: rel.line
+        }));
+        const enhancedPrompt = this.createEnhancedPrompt(originalQuery, queryAnalysis, userClarifications, relevantFiles, graphContext);
+        return {
+            originalQuery,
+            clarifications: userClarifications,
+            assumptions: queryAnalysis.assumptions,
+            relevantFiles,
+            codeRelationships,
+            packageStructure: graphContext.packageStructure,
+            enhancedPrompt
+        };
+    }
+    /**
+     * Extract start line number from class metadata
+     */
+    extractLineFromMetadata(classInfo) {
+        // Check various locations where line number might be stored
+        if (classInfo.metadata?.startLine)
+            return classInfo.metadata.startLine;
+        if (classInfo.sourceLocation?.startLine)
+            return classInfo.sourceLocation.startLine;
+        return undefined;
+    }
+    /**
+     * Extract end line number from class metadata
+     */
+    extractEndLineFromMetadata(classInfo) {
+        if (classInfo.metadata?.endLine)
+            return classInfo.metadata.endLine;
+        if (classInfo.sourceLocation?.endLine)
+            return classInfo.sourceLocation.endLine;
+        return undefined;
+    }
+    /**
+     * Format location as file:line for Claude Code navigation
+     */
+    formatLocation(filePath, classInfo) {
+        if (!filePath)
+            return undefined;
+        const startLine = classInfo ?
+            (classInfo.metadata?.startLine || classInfo.sourceLocation?.startLine) :
+            undefined;
+        if (startLine) {
+            return `${filePath}:${startLine}`;
+        }
+        return filePath;
+    }
+    /**
+     * Create enhanced prompt for Claude Code
+     * Uses structured prompt engineering: Pre-Search Info → Role → Context → Task → Format → Constraints
+     */
+    createEnhancedPrompt(originalQuery, queryAnalysis, userClarifications, relevantFiles, graphContext) {
+        const sections = [];
+        // ===========================================
+        // PRE-SEARCH METHODOLOGY: Explain how we found the context
+        // ===========================================
+        const fileCount = relevantFiles.length;
+        const componentCount = graphContext.classes?.length || 0;
+        const relationshipCount = graphContext.relationshipDetails?.length || 0;
+        sections.push(`# Enhanced Context from CodeSeeker Pre-Search
+
+**IMPORTANT**: This prompt has been enhanced by CodeSeeker, a codebase analysis tool. The context below was gathered BEFORE this request reached you using:
+
+1. **Semantic Vector Search** (PostgreSQL + pgvector): Found ${fileCount} relevant files by analyzing code embeddings for semantic similarity to the query
+2. **Knowledge Graph Analysis** (Neo4j): Discovered ${componentCount} components and ${relationshipCount} relationships by traversing the project's dependency graph
+
+**How to use this context**:
+- The files and components listed below are the MOST RELEVANT to the user's query based on our analysis
+- You can trust this as a reliable starting point - no need to re-search for the same information
+- Code snippets are sized based on task complexity - they show key patterns and signatures
+- **When to use Read tool**: Use Read when you need to see implementation details, understand full context, or work with code not shown in snippets
+- **Why snippets help**: They provide enough context to understand structure and patterns without bloating token usage
+- Focus on analyzing and working with the discovered files rather than searching from scratch`);
+        // ===========================================
+        // ROLE: Task-specific role based on intent
+        // ===========================================
+        const role = this.getRoleForIntent(queryAnalysis.intent);
+        sections.push(`# Role\n${role}`);
+        // ===========================================
+        // FILE READING GUIDANCE: Intent-specific pitch
+        // ===========================================
+        const readGuidance = this.getReadGuidanceForIntent(queryAnalysis.intent);
+        if (readGuidance) {
+            sections.push(`# When to Read Files\n${readGuidance}`);
+        }
+        // ===========================================
+        // TASK: The user's request with clarifications
+        // ===========================================
+        sections.push(`# Task\n${originalQuery}`);
+        if (userClarifications.length > 0) {
+            sections.push(`## Clarifications\n${userClarifications.map(c => `- ${c}`).join('\n')}`);
+        }
+        if (queryAnalysis.assumptions.length > 0) {
+            sections.push(`## Assumptions (validate before proceeding)\n${queryAnalysis.assumptions.map(a => `- ${a}`).join('\n')}`);
+        }
+        // ===========================================
+        // CONTEXT: Discovered files and relationships
+        // ===========================================
+        if (relevantFiles.length > 0 || (graphContext.classes && graphContext.classes.length > 0)) {
+            sections.push(`# Pre-Discovered Context (Use This First)
+The following files, components, and relationships were discovered through automated analysis. **Start here** rather than searching from scratch.`);
+            // Files with intent-based previews
+            if (relevantFiles.length > 0) {
+                const fileEntries = relevantFiles
+                    .slice(0, 5)
+                    .map(file => {
+                    const location = file.startLine
+                        ? `${file.path}:${file.startLine}${file.endLine ? `-${file.endLine}` : ''}`
+                        : file.path;
+                    let entry = `**${location}** (${file.type}, ${(file.similarity * 100).toFixed(0)}% match)`;
+                    // Include intent-based code snippet if available
+                    if (file.preview && file.preview.trim()) {
+                        entry += `\n\`\`\`\n${file.preview}\n\`\`\``;
+                    }
+                    return entry;
+                });
+                sections.push(`## Relevant Files\n${fileEntries.join('\n\n')}`);
+            }
+            // Components
+            if (graphContext.classes && graphContext.classes.length > 0) {
+                const classEntries = graphContext.classes
+                    .slice(0, 8)
+                    .map(c => {
+                    const startLine = c.metadata?.startLine || c.sourceLocation?.startLine;
+                    const location = c.filePath
+                        ? `${c.filePath}${startLine ? `:${startLine}` : ''}`
+                        : '';
+                    return `- **${c.name}** (${c.type})${location ? ` at ${location}` : ''}`;
+                })
+                    .join('\n');
+                sections.push(`## Components\n${classEntries}`);
+            }
+            // Relationships
+            if (graphContext.relationshipDetails.length > 0) {
+                const relationshipList = graphContext.relationshipDetails
+                    .slice(0, 8)
+                    .map(rel => {
+                    const fromDisplay = rel.fromMethod ? `${rel.from}.${rel.fromMethod}()` : rel.from;
+                    const toDisplay = rel.toMethod ? `${rel.to}.${rel.toMethod}()` : rel.to;
+                    return `- ${fromDisplay} → ${toDisplay} [${rel.type}]`;
+                })
+                    .join('\n');
+                sections.push(`## Dependencies\n${relationshipList}`);
+            }
+        }
+        // ===========================================
+        // FORMAT: Expected response structure
+        // ===========================================
+        const format = this.getFormatForIntent(queryAnalysis.intent);
+        sections.push(`# Response Format\n${format}`);
+        // ===========================================
+        // QUALITY: Reference project standards
+        // ===========================================
+        sections.push(`# Quality Standards
+Follow CLAUDE.md project guidelines:
+- Apply SOLID principles (project enforces strict compliance)
+- Match existing patterns in the relevant files above
+- Maintain the project's layered architecture (CLI/Orchestrator/Shared)`);
+        // ===========================================
+        // EXECUTION MINDSET: Act decisively
+        // ===========================================
+        sections.push(`# Execution Mindset
+- If the task is clear, execute it directly without asking questions
+- If something is ambiguous, state your interpretation briefly then PROCEED
+- Point out concerns or risks IN YOUR RESPONSE while still delivering the solution
+- After ONE clarification (if any was asked earlier), assume reasonable defaults and execute
+- Provide working code, not questions about what the user wants`);
+        // ===========================================
+        // CONSTRAINTS: What NOT to do
+        // ===========================================
+        sections.push(`# Constraints
+- Do NOT mention permissions or approval - CodeSeeker handles this separately
+- Do NOT create new files unless explicitly required - prefer editing existing
+- Do NOT add comments to unchanged code
+- Do NOT over-engineer - implement only what's requested`);
+        return sections.join('\n\n');
+    }
+    /**
+     * Get intent-specific guidance on when Claude should read files
+     * This "pitches" Claude on why and when to use the Read tool
+     */
+    getReadGuidanceForIntent(intent) {
+        const guidance = {
+            'fix': `**Read files when**: You need to trace the bug through the full call stack or see error handling logic not shown in snippets. The snippets show the relevant code area, but bugs often span multiple functions.`,
+            'analyze': `**Read files when**: You need to understand implementation details, measure complexity, or trace data flow. The snippets provide structure overview - use Read for deep analysis.`,
+            'explain': `**Read files when**: The user asks about specific implementation details or you need to trace execution flow. Snippets show signatures and patterns, but full explanation may require seeing the logic.`,
+            'modify': `**Read files when**: You need to understand the current implementation before making changes. The snippets show signatures - read full code to ensure your changes integrate properly.`,
+            'create': `**Read files when**: You need to see complete examples of similar functionality to match the project's patterns. Snippets show structure, but you may need full implementations as templates.`,
+            'refactor': `**Read files when**: You need to understand the full scope of what you're refactoring. Snippets show structure, but refactoring requires seeing all usages and dependencies.`,
+            'test': `**Read files when**: You need to understand the full behavior you're testing. The snippets show what to test, but you need implementation details to write comprehensive tests.`
+        };
+        return guidance[intent] || null;
+    }
+    /**
+     * Get role description based on detected intent
+     */
+    getRoleForIntent(intent) {
+        const roles = {
+            'create': 'You are implementing new functionality. Focus on following existing patterns from the discovered files.',
+            'modify': 'You are modifying existing code. Preserve the current architecture while making targeted changes.',
+            'refactor': 'You are refactoring code for better structure. Maintain behavior while improving design.',
+            'fix': 'You are debugging and fixing issues. Identify root cause before applying minimal fixes.',
+            'analyze': 'You are analyzing code to provide insights. Focus on patterns, quality, and architecture.',
+            'explain': 'You are explaining code behavior. Trace through the discovered relationships.',
+            'test': 'You are creating or improving tests. Follow existing test patterns in the project.',
+            'document': 'You are improving documentation. Keep it concise and actionable.',
+            'delete': 'You are removing code. Verify no dependencies before removal.',
+            'general': 'You are assisting with a development task. Use the discovered context to inform your approach.'
+        };
+        return roles[intent] || roles['general'];
+    }
+    /**
+     * Get expected response format based on intent
+     */
+    getFormatForIntent(intent) {
+        const formats = {
+            'create': `1. **Plan**: Which files to create/modify and why
+2. **Implementation**: The actual code changes
+3. **Integration**: How it connects to existing code`,
+            'modify': `1. **Changes**: List specific modifications
+2. **Impact**: Files affected by the change
+3. **Implementation**: The code edits`,
+            'refactor': `1. **Current Issues**: What's being improved
+2. **Approach**: Refactoring strategy
+3. **Changes**: Step-by-step modifications`,
+            'fix': `1. **Root Cause**: What's causing the issue
+2. **Fix**: Minimal change to resolve it
+3. **Verification**: How to confirm the fix`,
+            'analyze': `1. **Findings**: Key observations
+2. **Patterns**: Architectural patterns found
+3. **Recommendations**: Suggested improvements`,
+            'explain': `1. **Overview**: High-level explanation
+2. **Flow**: How components interact
+3. **Key Points**: Important implementation details`,
+            'test': `1. **Coverage**: What's being tested
+2. **Approach**: Testing strategy
+3. **Tests**: The actual test code`,
+            'general': `1. **Approach**: How you'll address the request
+2. **Implementation**: The code or changes
+3. **Summary**: What was accomplished`
+        };
+        return formats[intent] || formats['general'];
+    }
+    /**
+     * Create intent-based file preview optimized for GraphRAG
+     * Adaptive chunk sizing based on task complexity and file size
+     *
+     * Strategy:
+     * - Complex tasks (fix, analyze, explain) need more context
+     * - Simple tasks (create, modify) need pattern examples only
+     * - Large files (>1000 lines) get no preview to avoid token bloat
+     */
+    createFilePreview(result, intent) {
+        const lines = result.content.split('\n');
+        // Adaptive chunk sizing based on intent (following RAG best practices)
+        const CHUNK_SIZES = {
+            'fix': 80, // Bug fixes need more context (512-1024 tokens ≈ 80 lines)
+            'analyze': 40, // Analysis needs decent context (256-512 tokens ≈ 40 lines)
+            'explain': 40, // Explanation needs decent context (256-512 tokens ≈ 40 lines)
+            'refactor': 30, // Refactoring needs structure (256 tokens ≈ 30 lines)
+            'modify': 20, // Modifications need signatures (128-256 tokens ≈ 20 lines)
+            'create': 20, // Creation needs pattern examples (128-256 tokens ≈ 20 lines)
+            'test': 25, // Tests need example patterns (256 tokens ≈ 25 lines)
+            'document': 15, // Documentation needs minimal context (128 tokens ≈ 15 lines)
+            'general': 0 // General queries: no snippets (Claude decides what to read)
+        };
+        const chunkLines = CHUNK_SIZES[intent] || 0;
+        // Large files or general queries: no preview to save tokens
+        if (chunkLines === 0 || lines.length > 1000) {
+            return '';
+        }
+        const previewLines = lines.slice(0, chunkLines);
+        const suffix = lines.length > chunkLines
+            ? `\n... (${lines.length - chunkLines} more lines - use Read tool for full content)`
+            : '';
+        return previewLines.join('\n') + suffix;
+    }
+    /**
+     * Generate context statistics for logging
+     */
+    getContextStats(context) {
+        return {
+            filesFound: context.relevantFiles.length,
+            relationshipsFound: context.codeRelationships.length,
+            assumptionsDetected: context.assumptions.length,
+            clarificationsProvided: context.clarifications.length,
+            promptLength: context.enhancedPrompt.length
+        };
+    }
+}
+exports.ContextBuilder = ContextBuilder;
+//# sourceMappingURL=context-builder.js.map

package/dist/cli/commands/services/context-builder.js.map

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

package/dist/cli/commands/services/graph-analysis-service.d.ts

@@ -0,0 +1,157 @@
+/**
+ * Graph Analysis Service - Queries Persisted Knowledge Graph
+ * Single Responsibility: Query existing knowledge graph to find relationships between semantic search results
+ *
+ * Strategy: "Seed + Expand"
+ * 1. Take top N files from semantic search (seeds)
+ * 2. Look up corresponding ENTITY nodes in graph by filePath
+ * 3. Get direct relationships between seed nodes
+ * 4. Optionally expand 1-hop to include important dependencies
+ *
+ * Storage Mode Support:
+ * - Embedded mode: Uses Graphology graph store (no Docker required)
+ * - Server mode: Uses Neo4j (for production)
+ */
+export interface GraphContext {
+    classes: Array<{
+        name: string;
+        filePath: string;
+        type: string;
+        description: string;
+        confidence: number;
+        startLine?: number;
+        endLine?: number;
+        relationships: Array<{
+            target: string;
+            relation: string;
+            confidence: number;
+        }>;
+    }>;
+    relationships: Array<{
+        from: string;
+        to: string;
+        type: string;
+        strength: number;
+        fromPath?: string;
+        toPath?: string;
+        fromMethod?: string;
+        toMethod?: string;
+        line?: number;
+    }>;
+    relationshipDetails: Array<{
+        from: string;
+        to: string;
+        type: string;
+        fromPath?: string;
+        toPath?: string;
+        fromMethod?: string;
+        toMethod?: string;
+        line?: number;
+    }>;
+    packageStructure: string[];
+    graphInsights: {
+        totalNodes: number;
+        totalRelationships: number;
+        architecturalPatterns: string[];
+        qualityMetrics: {
+            coupling: number;
+            cohesion: number;
+            complexity: number;
+        };
+    };
+}
+export declare class GraphAnalysisService {
+    private dbConnections;
+    private logger;
+    private projectPath;
+    private projectId?;
+    private graphStore?;
+    private useEmbedded;
+    constructor(projectPath: string, projectId?: string);
+    /**
+     * Initialize the graph store (for embedded mode)
+     */
+    private initializeGraphStore;
+    /**
+     * Set project ID for scoped queries
+     */
+    setProjectId(projectId: string): void;
+    /**
+     * Main entry point: Perform graph analysis using persisted Neo4j graph
+     * Uses "Seed + Expand" strategy
+     */
+    performGraphAnalysis(_query: string, semanticResults: any[]): Promise<GraphContext>;
+    /**
+     * Resolve project ID from database by project path
+     * Uses storage abstraction - embedded mode uses SQLite project store, server mode uses Neo4j
+     */
+    private resolveProjectId;
+    /**
+     * Step 1: Look up nodes by file path from knowledge graph
+     * Uses storage abstraction - embedded mode uses Graphology, server mode uses Neo4j
+     */
+    private lookupNodesFromFiles;
+    /**
+     * Embedded mode: Look up nodes using Graphology graph store
+     */
+    private lookupNodesEmbedded;
+    /**
+     * Server mode: Look up nodes using Neo4j
+     */
+    private lookupNodesNeo4j;
+    /**
+     * Step 2: Get relationships between seed nodes
+     * Uses storage abstraction - embedded mode uses Graphology, server mode uses Neo4j
+     */
+    private getRelationshipsBetweenNodes;
+    /**
+     * Embedded mode: Get relationships using Graphology graph store
+     */
+    private getRelationshipsEmbedded;
+    /**
+     * Server mode: Get relationships using Neo4j
+     */
+    private getRelationshipsNeo4j;
+    /**
+     * Step 3: One-hop expansion - find important neighbors not in seed set
+     * Uses storage abstraction - embedded mode uses Graphology, server mode uses Neo4j
+     */
+    private expandOneHop;
+    /**
+     * Embedded mode: One-hop expansion using Graphology graph store
+     */
+    private expandOneHopEmbedded;
+    /**
+     * Server mode: One-hop expansion using Neo4j
+     */
+    private expandOneHopNeo4j;
+    /**
+     * Convert Neo4j entities to GraphContext classes format
+     */
+    private convertToClasses;
+    /**
+     * Generate description for a node
+     */
+    private generateDescription;
+    /**
+     * Extract package names from nodes
+     */
+    private extractPackages;
+    /**
+     * Calculate graph insights
+     */
+    private calculateInsights;
+    /**
+     * Parse metadata JSON safely
+     */
+    private parseMetadata;
+    /**
+     * Fallback: Create basic analysis from semantic results when graph unavailable
+     */
+    private createBasicAnalysis;
+    /**
+     * Extract class name from file path
+     */
+    private extractClassNameFromFile;
+}
+//# sourceMappingURL=graph-analysis-service.d.ts.map

package/dist/cli/commands/services/graph-analysis-service.d.ts.map

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