codeseeker 1.4.0

package/dist/shared/four-layer-memory-architecture.js

@@ -0,0 +1,353 @@
+"use strict";
+/**
+ * Three-Database Memory Architecture for CodeSeeker
+ *
+ * Complete memory system mapping to three disjoint storage types:
+ * 1. SHORT TERM: Live task execution (Redis) - Active working memory
+ * 2. LONG TERM: Persistent information, knowledge retention, episodic records (PostgreSQL + pgvector) - Facts, patterns, and experiences
+ * 3. SEMANTIC: Factual knowledge and concepts for agents (Neo4j) - Relationships and understanding
+ *
+ * Note: Episodic memory consolidated into PostgreSQL to maintain database disjointness
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SemanticMemoryManager = exports.EpisodicMemoryManager = exports.LongTermMemoryManager = exports.ShortTermMemoryManager = exports.FourLayerMemoryManager = void 0;
+const logger_1 = require("./logger");
+// Temporary stubs for missing services
+class RedisService {
+    async get(key) { return null; }
+    async set(key, value) { return 'OK'; }
+    async del(key) { return 1; }
+    async exists(key) { return false; }
+    async setex(key, ttl, value) { return 'OK'; }
+    async ttl(key) { return -1; }
+    async lpush(key, value) { return 1; }
+    async lrange(key, start, end) { return []; }
+    async expire(key, ttl) { return 1; }
+}
+class PostgreSQLService {
+    async query() { return []; }
+    async insert() { return 'id'; }
+    // Handles both long-term and episodic memory in single database
+    async insertEpisodicRecord() { return 'id'; }
+    async queryEpisodicRecords() { return []; }
+}
+class Neo4jService {
+    async createNode() { return 'id'; }
+    async query() { return []; }
+}
+// ============================================
+// FOUR-LAYER MEMORY MANAGER
+// ============================================
+class FourLayerMemoryManager {
+    logger;
+    // Storage services for each layer
+    redis; // Short term memory
+    postgresql; // Long term memory + episodic memory
+    neo4j; // Semantic memory
+    // Layer-specific managers
+    shortTermManager;
+    longTermManager;
+    episodicManager;
+    semanticManager;
+    constructor() {
+        this.logger = logger_1.Logger.getInstance();
+        // Initialize storage services
+        this.redis = new RedisService();
+        this.postgresql = new PostgreSQLService(); // Handles both long-term and episodic memory
+        this.neo4j = new Neo4jService();
+        // Initialize layer managers
+        this.shortTermManager = new ShortTermMemoryManager(this.redis);
+        this.longTermManager = new LongTermMemoryManager(this.postgresql);
+        this.episodicManager = new EpisodicMemoryManager(this.postgresql);
+        this.semanticManager = new SemanticMemoryManager(this.neo4j);
+    }
+    async initialize() {
+        this.logger.info('🧠 Initializing Four-Layer Memory Architecture');
+        await Promise.all([
+            this.shortTermManager.initialize(),
+            this.longTermManager.initialize(),
+            this.episodicManager.initialize(),
+            this.semanticManager.initialize()
+        ]);
+        this.logger.info('✅ All memory layers initialized');
+    }
+    /**
+     * ORCHESTRATED MEMORY OPERATIONS
+     * These methods coordinate across all memory layers
+     */
+    /**
+     * Start new request - initialize across all layers
+     */
+    async startRequest(requestId, sessionId, projectId, userRequest) {
+        this.logger.info(`🎬 Starting request memory: ${requestId}`);
+        // 1. Initialize short term working memory
+        const shortTermContext = await this.shortTermManager.createWorkingContext(requestId, sessionId, userRequest);
+        // 2. Retrieve relevant long term patterns  
+        const longTermPatterns = await this.longTermManager.findRelevantPatterns(userRequest, projectId);
+        // 3. Get episodic insights from similar experiences
+        const episodicInsights = await this.episodicManager.findSimilarExperiences(userRequest, projectId);
+        // 4. Build semantic context from knowledge graph
+        const semanticContext = await this.semanticManager.buildSemanticContext(userRequest, projectId);
+        this.logger.info('🔄 Cross-layer memory context assembled');
+        return {
+            shortTermContext,
+            longTermPatterns,
+            episodicInsights,
+            semanticContext
+        };
+    }
+    /**
+     * Record interaction - distribute to appropriate layers
+     */
+    async recordInteraction(requestId, interaction) {
+        // 1. Short term: Buffer interaction for immediate access
+        await this.shortTermManager.bufferInteraction(requestId, interaction);
+        // 2. Long term: Extract patterns if significant
+        if (this.isSignificantInteraction(interaction)) {
+            await this.longTermManager.extractPattern(interaction);
+        }
+        // 3. Episodic: Add to current episode sequence
+        await this.episodicManager.addEventToEpisode(requestId, {
+            timestamp: new Date(),
+            type: 'action',
+            actor: 'codeseeker',
+            description: interaction.type,
+            data: interaction,
+            effectiveness: interaction.outcome.effectiveness
+        });
+        // 4. Semantic: Update knowledge graph if new concepts learned
+        if (this.hasNewConcepts(interaction)) {
+            await this.semanticManager.updateKnowledgeGraph(interaction);
+        }
+    }
+    /**
+     * Complete request - finalize across all layers
+     */
+    async completeRequest(requestId, outcome) {
+        this.logger.info(`🎯 Completing request memory: ${requestId}`);
+        // 1. Short term: Move to persistent storage and cleanup
+        const bufferedInteractions = await this.shortTermManager.flushAndCleanup(requestId);
+        // 2. Long term: Store successful patterns and performance data
+        const longTermUpdates = await this.longTermManager.storePatterns(requestId, bufferedInteractions, outcome);
+        // 3. Episodic: Finalize episode with outcome and learnings  
+        const episodeFinalized = await this.episodicManager.finalizeEpisode(requestId, outcome);
+        // 4. Semantic: Enhance knowledge graph with new understanding
+        const semanticEnhancements = await this.semanticManager.enhanceKnowledge(requestId, outcome);
+        this.logger.info('✅ Request memory completed across all layers');
+        return {
+            shortTermCleanup: true,
+            longTermUpdates,
+            episodeFinalized,
+            semanticEnhancements
+        };
+    }
+    /**
+     * MEMORY LAYER ACCESS METHODS
+     */
+    getShortTermManager() {
+        return this.shortTermManager;
+    }
+    getLongTermManager() {
+        return this.longTermManager;
+    }
+    getEpisodicManager() {
+        return this.episodicManager;
+    }
+    getSemanticManager() {
+        return this.semanticManager;
+    }
+    /**
+     * MEMORY STATISTICS AND HEALTH
+     */
+    async getMemoryStats() {
+        return {
+            shortTerm: await this.shortTermManager.getStats(),
+            longTerm: await this.longTermManager.getStats(),
+            episodic: await this.episodicManager.getStats(),
+            semantic: await this.semanticManager.getStats()
+        };
+    }
+    // Private helper methods
+    isSignificantInteraction(interaction) {
+        return interaction.outcome.effectiveness < 0.7 || // Failed or low effectiveness
+            interaction.type === 'critical' || // Critical interactions
+            interaction.codeseekerAction.novel; // Novel approaches
+    }
+    hasNewConcepts(interaction) {
+        return interaction.outcome.conceptsLearned?.length > 0 ||
+            interaction.codeseekerAction.newPatterns?.length > 0;
+    }
+}
+exports.FourLayerMemoryManager = FourLayerMemoryManager;
+// ============================================
+// LAYER-SPECIFIC MANAGERS
+// ============================================
+/**
+ * SHORT TERM MEMORY MANAGER - Redis
+ * Manages active working memory, task execution state, immediate context
+ */
+class ShortTermMemoryManager {
+    redis;
+    logger;
+    constructor(redis) {
+        this.redis = redis;
+        this.logger = logger_1.Logger.getInstance();
+    }
+    async initialize() {
+        // Set up Redis key patterns and expiration policies
+        this.logger.info('🔥 Short term memory (Redis) initialized');
+    }
+    async createWorkingContext(requestId, sessionId, userRequest) {
+        const context = {
+            id: `stm_${requestId}`,
+            requestId,
+            sessionId,
+            timestamp: new Date(),
+            ttl: 3600, // 1 hour TTL
+            type: 'context_cache',
+            data: {
+                activeContext: {
+                    files: [],
+                    changes: {},
+                    workingDirectory: process.cwd(),
+                    gitBranch: 'main',
+                    lastSnapshot: ''
+                }
+            }
+        };
+        await this.redis.setex(`context:${requestId}`, context.ttl, JSON.stringify(context));
+        return context;
+    }
+    async bufferInteraction(requestId, interaction) {
+        await this.redis.lpush(`interactions:${requestId}`, JSON.stringify(interaction));
+        await this.redis.expire(`interactions:${requestId}`, 3600); // 1 hour expiry
+    }
+    async flushAndCleanup(requestId) {
+        const interactions = await this.redis.lrange(`interactions:${requestId}`, 0, -1);
+        await this.redis.del(`interactions:${requestId}`);
+        await this.redis.del(`context:${requestId}`);
+        return interactions.map(i => JSON.parse(i));
+    }
+    async getStats() {
+        return {
+            activeContexts: 0, // Would count active context keys
+            bufferSize: 0, // Would sum buffer sizes
+            ttlRemaining: 0 // Would get average TTL
+        };
+    }
+}
+exports.ShortTermMemoryManager = ShortTermMemoryManager;
+/**
+ * LONG TERM MEMORY MANAGER - PostgreSQL + pgvector
+ * Manages persistent patterns, solutions, performance data, knowledge base
+ */
+class LongTermMemoryManager {
+    postgresql;
+    logger;
+    constructor(postgresql) {
+        this.postgresql = postgresql;
+        this.logger = logger_1.Logger.getInstance();
+    }
+    async initialize() {
+        // Set up pgvector tables and indices
+        this.logger.info('🏗️ Long term memory (PostgreSQL + pgvector) initialized');
+    }
+    async findRelevantPatterns(userRequest, projectId) {
+        // Use pgvector similarity search to find relevant patterns
+        // Implementation would query long_term_memory table with vector similarity
+        return [];
+    }
+    async extractPattern(interaction) {
+        // Extract and store significant patterns from interaction
+        // Use OpenAI to generate embedding for pattern
+        // Store in PostgreSQL with pgvector embedding
+    }
+    async storePatterns(requestId, interactions, outcome) {
+        // Store successful patterns and performance data
+        return 0;
+    }
+    async getStats() {
+        return {
+            patterns: 0, // Count from patterns table
+            solutions: 0, // Count from solutions table  
+            avgConfidence: 0 // Average confidence score
+        };
+    }
+}
+exports.LongTermMemoryManager = LongTermMemoryManager;
+/**
+ * EPISODIC MEMORY MANAGER - MongoDB
+ * Manages experiential records, event sequences, improvement insights
+ */
+class EpisodicMemoryManager {
+    postgresql;
+    logger;
+    constructor(postgresql) {
+        this.postgresql = postgresql;
+        this.logger = logger_1.Logger.getInstance();
+    }
+    async initialize() {
+        // Set up MongoDB collections and indexes
+        this.logger.info('📚 Episodic memory (MongoDB) initialized');
+    }
+    async findSimilarExperiences(userRequest, projectId) {
+        // Find similar episodes from MongoDB
+        // Use text search and content similarity
+        return {};
+    }
+    async addEventToEpisode(requestId, event) {
+        // Add event to current episode sequence
+        // Use MongoDB document updates
+    }
+    async finalizeEpisode(requestId, outcome) {
+        // Complete episode with outcome and extract learnings
+        return true;
+    }
+    async getStats() {
+        return {
+            episodes: 0, // Count from episodes collection
+            avgDuration: 0, // Average episode duration
+            learningRate: 0 // Rate of learning extraction
+        };
+    }
+}
+exports.EpisodicMemoryManager = EpisodicMemoryManager;
+/**
+ * SEMANTIC MEMORY MANAGER - Neo4j
+ * Manages factual knowledge, concepts, relationships, understanding
+ */
+class SemanticMemoryManager {
+    neo4j;
+    logger;
+    constructor(neo4j) {
+        this.neo4j = neo4j;
+        this.logger = logger_1.Logger.getInstance();
+    }
+    async initialize() {
+        // Set up Neo4j schema and constraints
+        this.logger.info('🌐 Semantic memory (Neo4j) initialized');
+    }
+    async buildSemanticContext(userRequest, projectId) {
+        // Build semantic context from knowledge graph
+        // Query related concepts and relationships
+        return {};
+    }
+    async updateKnowledgeGraph(interaction) {
+        // Update knowledge graph with new concepts and relationships
+        // Create or update nodes and relationships in Neo4j
+    }
+    async enhanceKnowledge(requestId, outcome) {
+        // Enhance knowledge graph based on request outcome
+        return 0;
+    }
+    async getStats() {
+        return {
+            concepts: 0, // Count of concept nodes
+            relationships: 0, // Count of relationships
+            knowledgeDepth: 0 // Average depth of knowledge
+        };
+    }
+}
+exports.SemanticMemoryManager = SemanticMemoryManager;
+exports.default = FourLayerMemoryManager;
+//# sourceMappingURL=four-layer-memory-architecture.js.map

package/dist/shared/four-layer-memory-architecture.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"four-layer-memory-architecture.js","sourceRoot":"","sources":["../../src/shared/four-layer-memory-architecture.ts"],"names":[],"mappings":"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"}

package/dist/shared/hybrid-file-discovery.d.ts

@@ -0,0 +1,86 @@
+/**
+ * Hybrid File Discovery System
+ * Combines vector search (intent-based) + semantic graph (structure-based) for intelligent file discovery
+ */
+export interface FileDiscoveryRequest {
+    query: string;
+    projectPath: string;
+    projectId: string;
+    intent?: 'search' | 'refactor' | 'test' | 'debug' | 'security' | 'optimize';
+    maxFiles?: number;
+    includeRelated?: boolean;
+}
+export interface DiscoveredFile {
+    filePath: string;
+    contentType: 'code' | 'config' | 'documentation' | 'test' | 'schema';
+    language?: string;
+    relevanceScore: number;
+    discoveryPhase: 'vector' | 'graph' | 'both';
+    relationships?: string[];
+}
+export interface FileDiscoveryResult {
+    primaryFiles: DiscoveredFile[];
+    relatedFiles: DiscoveredFile[];
+    totalFiles: number;
+    phases: {
+        vectorResults: number;
+        graphExpansions: number;
+    };
+    graphContext?: {
+        relationshipTypes: string[];
+        impactLevel: 'low' | 'medium' | 'high';
+    };
+}
+export declare class HybridFileDiscovery {
+    private vectorSearch;
+    private semanticGraph;
+    private logger;
+    constructor();
+    initialize(): Promise<void>;
+    /**
+     * Two-phase file discovery: Vector search + Graph expansion
+     */
+    discoverFiles(request: FileDiscoveryRequest): Promise<FileDiscoveryResult>;
+    /**
+     * Phase 1: Vector-based file discovery using semantic embeddings
+     */
+    private vectorBasedDiscovery;
+    /**
+     * Phase 2: Graph-based relationship expansion
+     */
+    private graphBasedExpansion;
+    /**
+     * Find semantic graph nodes that correspond to a file path
+     */
+    private findGraphNodesForFile;
+    /**
+     * Get related nodes based on user intent
+     */
+    private getRelatedNodesByIntent;
+    /**
+     * Map intent to relevant relationship types for graph traversal
+     */
+    private getRelationshipTypesForIntent;
+    /**
+     * Map intent to graph traversal depth
+     */
+    private getTraversalDepthForIntent;
+    /**
+     * Convert graph node back to file information
+     */
+    private convertGraphNodeToFile;
+    /**
+     * Merge vector and graph results, removing duplicates
+     */
+    private mergeAndDeduplicate;
+    /**
+     * Infer content type from file path
+     */
+    private inferContentType;
+    /**
+     * Generate query embedding for vector search
+     */
+    private generateQueryEmbedding;
+    close(): Promise<void>;
+}
+//# sourceMappingURL=hybrid-file-discovery.d.ts.map

package/dist/shared/hybrid-file-discovery.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hybrid-file-discovery.d.ts","sourceRoot":"","sources":["../../src/shared/hybrid-file-discovery.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAMH,MAAM,WAAW,oBAAoB;IACnC,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,QAAQ,GAAG,UAAU,GAAG,MAAM,GAAG,OAAO,GAAG,UAAU,GAAG,UAAU,CAAC;IAC5E,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,cAAc,CAAC,EAAE,OAAO,CAAC;CAC1B;AAED,MAAM,WAAW,cAAc;IAC7B,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,GAAG,QAAQ,GAAG,eAAe,GAAG,MAAM,GAAG,QAAQ,CAAC;IACrE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,cAAc,EAAE,MAAM,CAAC;IACvB,cAAc,EAAE,QAAQ,GAAG,OAAO,GAAG,MAAM,CAAC;IAC5C,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;CAC1B;AAED,MAAM,WAAW,mBAAmB;IAClC,YAAY,EAAE,cAAc,EAAE,CAAC;IAC/B,YAAY,EAAE,cAAc,EAAE,CAAC;IAC/B,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE;QACN,aAAa,EAAE,MAAM,CAAC;QACtB,eAAe,EAAE,MAAM,CAAC;KACzB,CAAC;IACF,YAAY,CAAC,EAAE;QACb,iBAAiB,EAAE,MAAM,EAAE,CAAC;QAC5B,WAAW,EAAE,KAAK,GAAG,QAAQ,GAAG,MAAM,CAAC;KACxC,CAAC;CACH;AAED,qBAAa,mBAAmB;IAC9B,OAAO,CAAC,YAAY,CAAwB;IAC5C,OAAO,CAAC,aAAa,CAAuB;IAC5C,OAAO,CAAC,MAAM,CAAwB;;IAQhC,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAKjC;;OAEG;IACG,aAAa,CAAC,OAAO,EAAE,oBAAoB,GAAG,OAAO,CAAC,mBAAmB,CAAC;IA+ChF;;OAEG;YACW,oBAAoB;IAkClC;;OAEG;YACW,mBAAmB;IA0CjC;;OAEG;YACW,qBAAqB;IAMnC;;OAEG;YACW,uBAAuB;IAOrC;;OAEG;IACH,OAAO,CAAC,6BAA6B;IAerC;;OAEG;IACH,OAAO,CAAC,0BAA0B;IASlC;;OAEG;IACH,OAAO,CAAC,sBAAsB;IAc9B;;OAEG;IACH,OAAO,CAAC,mBAAmB;IA6B3B;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAUxB;;OAEG;YACW,sBAAsB;IA0B9B,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAG7B"}