codeseeker 1.4.0

package/dist/shared/database-responsibility-guide.d.ts

@@ -0,0 +1,183 @@
+/**
+ * Database Responsibility Guide
+ *
+ * This file clearly defines the responsibilities of each database in CodeSeeker
+ * to ensure complete database disjointness and eliminate overlapping concerns.
+ *
+ * Updated: 2025-09-24
+ * Purpose: Maintain database separation of concerns
+ */
+/**
+ * POSTGRESQL - PERSISTENT APPLICATION DATA
+ *
+ * Responsibility: Primary persistent application data and long-term storage
+ * Use Cases:
+ * - Project configurations and metadata
+ * - User settings and preferences
+ * - Tool configurations and definitions
+ * - Analysis results and historical data
+ * - Performance metrics and analytics (centralized from DuckDB)
+ * - File metadata and change tracking
+ * - Workflow execution history and audit logs
+ * - Persistent workflow state for recovery (checkpoints, completed workflows)
+ * - Session management (persistent sessions)
+ * - Database schemas and migrations
+ */
+export declare const POSTGRESQL_RESPONSIBILITIES: {
+    readonly projects: "Project metadata, configurations, paths";
+    readonly tool_configs: "Tool definitions, settings, capabilities";
+    readonly analysis_results: "Historical analysis data, reports";
+    readonly performance_metrics: "Centralized analytics and performance data";
+    readonly file_metadata: "File hashes, sizes, modification times";
+    readonly workflow_execution_log: "Completed workflow runs, execution history";
+    readonly workflow_checkpoints: "Persistent recovery points for long-running workflows";
+    readonly session_management: "Long-term session storage and user authentication";
+    readonly system_configuration: "Application-wide settings and configuration";
+};
+/**
+ * REDIS - REAL-TIME STATE AND MESSAGING
+ *
+ * Responsibility: Ephemeral state, real-time communication, and caching
+ * Use Cases:
+ * - Active workflow state (currently running workflows)
+ * - Real-time messaging between components
+ * - Temporary session state (active sessions)
+ * - Live system monitoring and health checks
+ * - Event queues and job processing
+ * - Distributed locks and coordination
+ * - All caching operations (consolidated from PostgreSQL)
+ * - Temporary computation results
+ */
+export declare const REDIS_RESPONSIBILITIES: {
+    readonly active_workflows: "Currently executing workflow state, progress, live status";
+    readonly messaging_queues: "Inter-service communication, event propagation";
+    readonly active_sessions: "Real-time session state, temporary user data";
+    readonly system_health: "Live monitoring, component status, heartbeats";
+    readonly distributed_locks: "Coordination locks, mutual exclusion";
+    readonly cache_all: "All caching operations: embeddings, search results, computations";
+    readonly temp_results: "Short-lived computation results and intermediate data";
+};
+/**
+ * NEO4J - SEMANTIC RELATIONSHIPS AND GRAPHS
+ *
+ * Responsibility: Code relationships, knowledge graphs, and semantic connections
+ * Use Cases:
+ * - Code dependency graphs
+ * - Semantic relationships between files/functions
+ * - Knowledge graphs for code understanding
+ * - Cross-reference mappings
+ * - Architectural relationship modeling
+ * - Code similarity and clustering
+ */
+export declare const NEO4J_RESPONSIBILITIES: {
+    readonly code_dependencies: "File-to-file, function-to-function dependencies";
+    readonly semantic_relationships: "Semantic connections and similarity graphs";
+    readonly knowledge_graphs: "Code understanding and relationship modeling";
+    readonly architectural_maps: "High-level system architecture relationships";
+    readonly cross_references: "Symbol usage, import/export relationships";
+};
+/**
+ * WORKFLOW STATE OWNERSHIP CLARIFICATION
+ *
+ * CLEAR SEPARATION:
+ * - Redis: Active, live workflow state (status=running/paused/executing)
+ * - PostgreSQL: Historical workflow data (status=completed/failed/cancelled)
+ *
+ * MIGRATION POINTS:
+ * - When workflow completes -> Move from Redis to PostgreSQL
+ * - When workflow fails -> Log to PostgreSQL, clear from Redis
+ * - When workflow is cancelled -> Log to PostgreSQL, clear from Redis
+ *
+ * NO OVERLAP:
+ * - Never store the same workflow instance in both databases
+ * - Use workflowId to ensure single source of truth
+ * - Active workflows exist ONLY in Redis
+ * - Historical workflows exist ONLY in PostgreSQL
+ */
+export declare const WORKFLOW_STATE_OWNERSHIP: {
+    readonly redis_active: "status IN (running, paused, executing, queued)";
+    readonly postgresql_historical: "status IN (completed, failed, cancelled, archived)";
+    readonly migration_trigger: "status change from active to terminal state";
+    readonly no_duplication: "Same workflowId cannot exist in both systems simultaneously";
+};
+/**
+ * CACHING OWNERSHIP CLARIFICATION
+ *
+ * COMPLETE CONSOLIDATION TO REDIS:
+ * - All L1 cache (memory) operations via Redis
+ * - All L2 cache (file) with Redis backup
+ * - All L3 cache (database) moved to Redis
+ * - NO caching operations in PostgreSQL
+ *
+ * MIGRATION COMPLETE:
+ * - Removed PostgreSQL cache tables
+ * - Updated MultiLevelCache to use Redis adapter
+ * - All semantic search caching via Redis
+ */
+export declare const CACHING_OWNERSHIP: {
+    readonly redis_all_cache: "All caching operations consolidated to Redis";
+    readonly no_postgresql_cache: "Zero caching responsibility in PostgreSQL";
+    readonly unified_cache_layer: "Single Redis-based caching system";
+};
+/**
+ * ANALYTICS OWNERSHIP CLARIFICATION
+ *
+ * COMPLETE CONSOLIDATION TO POSTGRESQL:
+ * - All performance metrics in PostgreSQL
+ * - All code quality analytics in PostgreSQL
+ * - All file change analytics in PostgreSQL
+ * - NO DuckDB analytics operations
+ *
+ * MIGRATION COMPLETE:
+ * - Replaced DuckDB with PostgreSQL analytics
+ * - Updated all analytics consumers
+ * - Centralized analytics reporting
+ */
+export declare const ANALYTICS_OWNERSHIP: {
+    readonly postgresql_all_analytics: "All analytics consolidated to PostgreSQL";
+    readonly no_duckdb_analytics: "Zero analytics responsibility in DuckDB";
+    readonly unified_analytics_layer: "Single PostgreSQL-based analytics system";
+};
+/**
+ * Patterns that indicate database responsibility violations:
+ *
+ * 1. Same data type in multiple databases
+ * 2. Duplicate foreign keys across databases
+ * 3. Cross-database transactions or joins
+ * 4. Inconsistent data models for same entity
+ * 5. Manual data synchronization between databases
+ */
+export declare const VIOLATION_PATTERNS: {
+    readonly duplicate_entities: "Same entity/concept stored in multiple databases";
+    readonly cross_database_joins: "Queries that require data from multiple databases";
+    readonly manual_sync: "Code that manually keeps databases in sync";
+    readonly inconsistent_schemas: "Different schemas for same conceptual data";
+    readonly shared_foreign_keys: "Foreign key references across database boundaries";
+};
+/**
+ * Mechanisms to maintain database separation:
+ *
+ * 1. Clear interface boundaries - each database has dedicated service layer
+ * 2. No direct cross-database queries or transactions
+ * 3. Event-driven communication between database domains
+ * 4. Regular audits of database responsibilities
+ * 5. Documentation updates with any architectural changes
+ */
+export declare const ENFORCEMENT_MECHANISMS: {
+    readonly service_layer_isolation: "Each database accessed only through its service layer";
+    readonly event_driven_communication: "Databases communicate via events, not direct calls";
+    readonly regular_audits: "Periodic review of database responsibilities and usage";
+    readonly documentation_updates: "This file updated with any architectural changes";
+    readonly interface_boundaries: "Clear API boundaries prevent accidental cross-database access";
+};
+/**
+ * Current migration status (as of 2025-09-24):
+ */
+export declare const MIGRATION_STATUS: {
+    readonly caching_consolidation: "COMPLETED - All caching moved to Redis";
+    readonly analytics_consolidation: "COMPLETED - All analytics moved to PostgreSQL";
+    readonly workflow_state_clarification: "COMPLETED - Clear boundaries established with documentation";
+    readonly file_state_consolidation: "COMPLETED - PostgreSQL as single source of truth via FileSynchronizationSystem";
+    readonly mongodb_cleanup: "COMPLETED - MongoDB references removed, episodic memory moved to PostgreSQL";
+};
+//# sourceMappingURL=database-responsibility-guide.d.ts.map

package/dist/shared/database-responsibility-guide.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"database-responsibility-guide.d.ts","sourceRoot":"","sources":["../../src/shared/database-responsibility-guide.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAMH;;;;;;;;;;;;;;;GAeG;AACH,eAAO,MAAM,2BAA2B;;;;;;;;;;CAU9B,CAAC;AAEX;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,sBAAsB;;;;;;;;CAQzB,CAAC;AAEX;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,sBAAsB;;;;;;CAMzB,CAAC;AAMX;;;;;;;;;;;;;;;;;GAiBG;AACH,eAAO,MAAM,wBAAwB;;;;;CAK3B,CAAC;AAEX;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,iBAAiB;;;;CAIpB,CAAC;AAEX;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,mBAAmB;;;;CAItB,CAAC;AAMX;;;;;;;;GAQG;AACH,eAAO,MAAM,kBAAkB;;;;;;CAMrB,CAAC;AAMX;;;;;;;;GAQG;AACH,eAAO,MAAM,sBAAsB;;;;;;CAMzB,CAAC;AAMX;;GAEG;AACH,eAAO,MAAM,gBAAgB;;;;;;CAMnB,CAAC"}

package/dist/shared/database-responsibility-guide.js

@@ -0,0 +1,201 @@
+"use strict";
+/**
+ * Database Responsibility Guide
+ *
+ * This file clearly defines the responsibilities of each database in CodeSeeker
+ * to ensure complete database disjointness and eliminate overlapping concerns.
+ *
+ * Updated: 2025-09-24
+ * Purpose: Maintain database separation of concerns
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MIGRATION_STATUS = exports.ENFORCEMENT_MECHANISMS = exports.VIOLATION_PATTERNS = exports.ANALYTICS_OWNERSHIP = exports.CACHING_OWNERSHIP = exports.WORKFLOW_STATE_OWNERSHIP = exports.NEO4J_RESPONSIBILITIES = exports.REDIS_RESPONSIBILITIES = exports.POSTGRESQL_RESPONSIBILITIES = void 0;
+// ============================================================================
+// DATABASE RESPONSIBILITY MATRIX
+// ============================================================================
+/**
+ * POSTGRESQL - PERSISTENT APPLICATION DATA
+ *
+ * Responsibility: Primary persistent application data and long-term storage
+ * Use Cases:
+ * - Project configurations and metadata
+ * - User settings and preferences
+ * - Tool configurations and definitions
+ * - Analysis results and historical data
+ * - Performance metrics and analytics (centralized from DuckDB)
+ * - File metadata and change tracking
+ * - Workflow execution history and audit logs
+ * - Persistent workflow state for recovery (checkpoints, completed workflows)
+ * - Session management (persistent sessions)
+ * - Database schemas and migrations
+ */
+exports.POSTGRESQL_RESPONSIBILITIES = {
+    projects: 'Project metadata, configurations, paths',
+    tool_configs: 'Tool definitions, settings, capabilities',
+    analysis_results: 'Historical analysis data, reports',
+    performance_metrics: 'Centralized analytics and performance data',
+    file_metadata: 'File hashes, sizes, modification times',
+    workflow_execution_log: 'Completed workflow runs, execution history',
+    workflow_checkpoints: 'Persistent recovery points for long-running workflows',
+    session_management: 'Long-term session storage and user authentication',
+    system_configuration: 'Application-wide settings and configuration'
+};
+/**
+ * REDIS - REAL-TIME STATE AND MESSAGING
+ *
+ * Responsibility: Ephemeral state, real-time communication, and caching
+ * Use Cases:
+ * - Active workflow state (currently running workflows)
+ * - Real-time messaging between components
+ * - Temporary session state (active sessions)
+ * - Live system monitoring and health checks
+ * - Event queues and job processing
+ * - Distributed locks and coordination
+ * - All caching operations (consolidated from PostgreSQL)
+ * - Temporary computation results
+ */
+exports.REDIS_RESPONSIBILITIES = {
+    active_workflows: 'Currently executing workflow state, progress, live status',
+    messaging_queues: 'Inter-service communication, event propagation',
+    active_sessions: 'Real-time session state, temporary user data',
+    system_health: 'Live monitoring, component status, heartbeats',
+    distributed_locks: 'Coordination locks, mutual exclusion',
+    cache_all: 'All caching operations: embeddings, search results, computations',
+    temp_results: 'Short-lived computation results and intermediate data'
+};
+/**
+ * NEO4J - SEMANTIC RELATIONSHIPS AND GRAPHS
+ *
+ * Responsibility: Code relationships, knowledge graphs, and semantic connections
+ * Use Cases:
+ * - Code dependency graphs
+ * - Semantic relationships between files/functions
+ * - Knowledge graphs for code understanding
+ * - Cross-reference mappings
+ * - Architectural relationship modeling
+ * - Code similarity and clustering
+ */
+exports.NEO4J_RESPONSIBILITIES = {
+    code_dependencies: 'File-to-file, function-to-function dependencies',
+    semantic_relationships: 'Semantic connections and similarity graphs',
+    knowledge_graphs: 'Code understanding and relationship modeling',
+    architectural_maps: 'High-level system architecture relationships',
+    cross_references: 'Symbol usage, import/export relationships'
+};
+// ============================================================================
+// OWNERSHIP BOUNDARIES AND RULES
+// ============================================================================
+/**
+ * WORKFLOW STATE OWNERSHIP CLARIFICATION
+ *
+ * CLEAR SEPARATION:
+ * - Redis: Active, live workflow state (status=running/paused/executing)
+ * - PostgreSQL: Historical workflow data (status=completed/failed/cancelled)
+ *
+ * MIGRATION POINTS:
+ * - When workflow completes -> Move from Redis to PostgreSQL
+ * - When workflow fails -> Log to PostgreSQL, clear from Redis
+ * - When workflow is cancelled -> Log to PostgreSQL, clear from Redis
+ *
+ * NO OVERLAP:
+ * - Never store the same workflow instance in both databases
+ * - Use workflowId to ensure single source of truth
+ * - Active workflows exist ONLY in Redis
+ * - Historical workflows exist ONLY in PostgreSQL
+ */
+exports.WORKFLOW_STATE_OWNERSHIP = {
+    redis_active: 'status IN (running, paused, executing, queued)',
+    postgresql_historical: 'status IN (completed, failed, cancelled, archived)',
+    migration_trigger: 'status change from active to terminal state',
+    no_duplication: 'Same workflowId cannot exist in both systems simultaneously'
+};
+/**
+ * CACHING OWNERSHIP CLARIFICATION
+ *
+ * COMPLETE CONSOLIDATION TO REDIS:
+ * - All L1 cache (memory) operations via Redis
+ * - All L2 cache (file) with Redis backup
+ * - All L3 cache (database) moved to Redis
+ * - NO caching operations in PostgreSQL
+ *
+ * MIGRATION COMPLETE:
+ * - Removed PostgreSQL cache tables
+ * - Updated MultiLevelCache to use Redis adapter
+ * - All semantic search caching via Redis
+ */
+exports.CACHING_OWNERSHIP = {
+    redis_all_cache: 'All caching operations consolidated to Redis',
+    no_postgresql_cache: 'Zero caching responsibility in PostgreSQL',
+    unified_cache_layer: 'Single Redis-based caching system'
+};
+/**
+ * ANALYTICS OWNERSHIP CLARIFICATION
+ *
+ * COMPLETE CONSOLIDATION TO POSTGRESQL:
+ * - All performance metrics in PostgreSQL
+ * - All code quality analytics in PostgreSQL
+ * - All file change analytics in PostgreSQL
+ * - NO DuckDB analytics operations
+ *
+ * MIGRATION COMPLETE:
+ * - Replaced DuckDB with PostgreSQL analytics
+ * - Updated all analytics consumers
+ * - Centralized analytics reporting
+ */
+exports.ANALYTICS_OWNERSHIP = {
+    postgresql_all_analytics: 'All analytics consolidated to PostgreSQL',
+    no_duckdb_analytics: 'Zero analytics responsibility in DuckDB',
+    unified_analytics_layer: 'Single PostgreSQL-based analytics system'
+};
+// ============================================================================
+// VIOLATION DETECTION
+// ============================================================================
+/**
+ * Patterns that indicate database responsibility violations:
+ *
+ * 1. Same data type in multiple databases
+ * 2. Duplicate foreign keys across databases
+ * 3. Cross-database transactions or joins
+ * 4. Inconsistent data models for same entity
+ * 5. Manual data synchronization between databases
+ */
+exports.VIOLATION_PATTERNS = {
+    duplicate_entities: 'Same entity/concept stored in multiple databases',
+    cross_database_joins: 'Queries that require data from multiple databases',
+    manual_sync: 'Code that manually keeps databases in sync',
+    inconsistent_schemas: 'Different schemas for same conceptual data',
+    shared_foreign_keys: 'Foreign key references across database boundaries'
+};
+// ============================================================================
+// ENFORCEMENT MECHANISMS
+// ============================================================================
+/**
+ * Mechanisms to maintain database separation:
+ *
+ * 1. Clear interface boundaries - each database has dedicated service layer
+ * 2. No direct cross-database queries or transactions
+ * 3. Event-driven communication between database domains
+ * 4. Regular audits of database responsibilities
+ * 5. Documentation updates with any architectural changes
+ */
+exports.ENFORCEMENT_MECHANISMS = {
+    service_layer_isolation: 'Each database accessed only through its service layer',
+    event_driven_communication: 'Databases communicate via events, not direct calls',
+    regular_audits: 'Periodic review of database responsibilities and usage',
+    documentation_updates: 'This file updated with any architectural changes',
+    interface_boundaries: 'Clear API boundaries prevent accidental cross-database access'
+};
+// ============================================================================
+// MIGRATION STATUS
+// ============================================================================
+/**
+ * Current migration status (as of 2025-09-24):
+ */
+exports.MIGRATION_STATUS = {
+    caching_consolidation: 'COMPLETED - All caching moved to Redis',
+    analytics_consolidation: 'COMPLETED - All analytics moved to PostgreSQL',
+    workflow_state_clarification: 'COMPLETED - Clear boundaries established with documentation',
+    file_state_consolidation: 'COMPLETED - PostgreSQL as single source of truth via FileSynchronizationSystem',
+    mongodb_cleanup: 'COMPLETED - MongoDB references removed, episodic memory moved to PostgreSQL'
+};
+//# sourceMappingURL=database-responsibility-guide.js.map

package/dist/shared/database-responsibility-guide.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"database-responsibility-guide.js","sourceRoot":"","sources":["../../src/shared/database-responsibility-guide.ts"],"names":[],"mappings":";AAAA;;;;;;;;GAQG;;;AAEH,+EAA+E;AAC/E,iCAAiC;AACjC,+EAA+E;AAE/E;;;;;;;;;;;;;;;GAeG;AACU,QAAA,2BAA2B,GAAG;IACzC,QAAQ,EAAE,yCAAyC;IACnD,YAAY,EAAE,0CAA0C;IACxD,gBAAgB,EAAE,mCAAmC;IACrD,mBAAmB,EAAE,4CAA4C;IACjE,aAAa,EAAE,wCAAwC;IACvD,sBAAsB,EAAE,4CAA4C;IACpE,oBAAoB,EAAE,uDAAuD;IAC7E,kBAAkB,EAAE,mDAAmD;IACvE,oBAAoB,EAAE,6CAA6C;CAC3D,CAAC;AAEX;;;;;;;;;;;;;GAaG;AACU,QAAA,sBAAsB,GAAG;IACpC,gBAAgB,EAAE,2DAA2D;IAC7E,gBAAgB,EAAE,gDAAgD;IAClE,eAAe,EAAE,8CAA8C;IAC/D,aAAa,EAAE,+CAA+C;IAC9D,iBAAiB,EAAE,sCAAsC;IACzD,SAAS,EAAE,kEAAkE;IAC7E,YAAY,EAAE,uDAAuD;CAC7D,CAAC;AAEX;;;;;;;;;;;GAWG;AACU,QAAA,sBAAsB,GAAG;IACpC,iBAAiB,EAAE,iDAAiD;IACpE,sBAAsB,EAAE,4CAA4C;IACpE,gBAAgB,EAAE,8CAA8C;IAChE,kBAAkB,EAAE,8CAA8C;IAClE,gBAAgB,EAAE,2CAA2C;CACrD,CAAC;AAEX,+EAA+E;AAC/E,iCAAiC;AACjC,+EAA+E;AAE/E;;;;;;;;;;;;;;;;;GAiBG;AACU,QAAA,wBAAwB,GAAG;IACtC,YAAY,EAAE,gDAAgD;IAC9D,qBAAqB,EAAE,oDAAoD;IAC3E,iBAAiB,EAAE,6CAA6C;IAChE,cAAc,EAAE,6DAA6D;CACrE,CAAC;AAEX;;;;;;;;;;;;;GAaG;AACU,QAAA,iBAAiB,GAAG;IAC/B,eAAe,EAAE,8CAA8C;IAC/D,mBAAmB,EAAE,2CAA2C;IAChE,mBAAmB,EAAE,mCAAmC;CAChD,CAAC;AAEX;;;;;;;;;;;;;GAaG;AACU,QAAA,mBAAmB,GAAG;IACjC,wBAAwB,EAAE,0CAA0C;IACpE,mBAAmB,EAAE,yCAAyC;IAC9D,uBAAuB,EAAE,0CAA0C;CAC3D,CAAC;AAEX,+EAA+E;AAC/E,sBAAsB;AACtB,+EAA+E;AAE/E;;;;;;;;GAQG;AACU,QAAA,kBAAkB,GAAG;IAChC,kBAAkB,EAAE,kDAAkD;IACtE,oBAAoB,EAAE,mDAAmD;IACzE,WAAW,EAAE,4CAA4C;IACzD,oBAAoB,EAAE,4CAA4C;IAClE,mBAAmB,EAAE,mDAAmD;CAChE,CAAC;AAEX,+EAA+E;AAC/E,yBAAyB;AACzB,+EAA+E;AAE/E;;;;;;;;GAQG;AACU,QAAA,sBAAsB,GAAG;IACpC,uBAAuB,EAAE,uDAAuD;IAChF,0BAA0B,EAAE,oDAAoD;IAChF,cAAc,EAAE,wDAAwD;IACxE,qBAAqB,EAAE,kDAAkD;IACzE,oBAAoB,EAAE,+DAA+D;CAC7E,CAAC;AAEX,+EAA+E;AAC/E,mBAAmB;AACnB,+EAA+E;AAE/E;;GAEG;AACU,QAAA,gBAAgB,GAAG;IAC9B,qBAAqB,EAAE,wCAAwC;IAC/D,uBAAuB,EAAE,+CAA+C;IACxE,4BAA4B,EAAE,6DAA6D;IAC3F,wBAAwB,EAAE,gFAAgF;IAC1G,eAAe,EAAE,6EAA6E;CACtF,CAAC"}

package/dist/shared/documentation-rag-service.d.ts

@@ -0,0 +1,149 @@
+/**
+ * Documentation RAG Service
+ * Specialized RAG system for documentation with different chunking strategies than code
+ * Handles technical documentation, README files, and internet-sourced technical info
+ */
+export interface DocumentationChunk {
+    id: string;
+    filePath: string;
+    title: string;
+    content: string;
+    chunkIndex: number;
+    hash: string;
+    documentType: 'readme' | 'manual' | 'api-doc' | 'tutorial' | 'reference' | 'changelog' | 'internet-doc';
+    metadata: {
+        language: string;
+        size: number;
+        headings: string[];
+        codeBlocks: string[];
+        links: string[];
+        techStack: string[];
+        version?: string;
+        source: 'local' | 'internet';
+        sourceUrl?: string;
+        lastUpdated: number;
+        significance: 'critical' | 'high' | 'medium' | 'low';
+    };
+}
+export interface DocumentationSearchResult {
+    chunk: DocumentationChunk;
+    relevanceScore: number;
+    matchReason: string;
+    contextSnippet: string;
+    relatedChunks?: DocumentationChunk[];
+}
+export interface TechnicalContext {
+    query: string;
+    documentationResults: DocumentationSearchResult[];
+    techStackInfo: Array<{
+        technology: string;
+        version?: string;
+        officialDocs: string[];
+        bestPractices: string[];
+        commonPatterns: string[];
+    }>;
+    totalDocuments: number;
+    searchTime: number;
+    cacheHitRate: number;
+    generatedAt: number;
+}
+/**
+ * Documentation RAG Service
+ * Separate collection for documentation with specialized chunking and search
+ */
+export declare class DocumentationRAGService {
+    private logger;
+    private dbConnections;
+    private embeddingService;
+    private semanticSearchService;
+    private initialized;
+    private cacheHits;
+    private cacheRequests;
+    private readonly DOC_CHUNK_SIZE;
+    private readonly DOC_OVERLAP_SIZE;
+    private readonly MIN_DOC_CHUNK_SIZE;
+    private readonly MAX_HEADING_LEVELS;
+    constructor(projectId: string);
+    initialize(): Promise<void>;
+    /**
+     * Ingest documentation from specified paths
+     */
+    ingestDocumentationPaths(paths: string[]): Promise<{
+        processed: number;
+        chunksCreated: number;
+        errors: string[];
+    }>;
+    /**
+     * Ingest documentation directory recursively
+     */
+    private ingestDocumentationDirectory;
+    /**
+     * Ingest single documentation file
+     */
+    private ingestDocumentationFile;
+    /**
+     * Chunk documentation with heading-aware strategy
+     */
+    private chunkDocumentation;
+    /**
+     * Parse heading structure from markdown/text
+     */
+    private parseHeadingStructure;
+    /**
+     * Chunk by heading sections
+     */
+    private chunkByHeadings;
+    /**
+     * Fallback content-based chunking
+     */
+    private chunkByContent;
+    /**
+     * Create documentation chunk with metadata
+     */
+    private createDocumentationChunk;
+    /**
+     * Search documentation with specialized ranking
+     */
+    searchDocumentation(query: string, options?: {
+        maxResults?: number;
+        minSimilarity?: number;
+        documentTypes?: DocumentationChunk['documentType'][];
+        techStack?: string[];
+        includeRelated?: boolean;
+    }): Promise<DocumentationSearchResult[]>;
+    /**
+     * Get technical context for Claude Code integration
+     */
+    getTechnicalContext(query: string, maxTokens?: number): Promise<TechnicalContext>;
+    /**
+     * Fetch and ingest documentation from internet sources
+     */
+    fetchInternetDocumentation(techStack: string[], options?: {
+        includeOfficialDocs?: boolean;
+        includeGuides?: boolean;
+        maxDocumentsPerTech?: number;
+    }): Promise<{
+        fetched: number;
+        ingested: number;
+        errors: string[];
+    }>;
+    private calculateCacheHitRate;
+    private isDocumentationFile;
+    private detectDocumentType;
+    private detectLanguage;
+    private extractTitleFromChunk;
+    private extractHeadings;
+    private extractCodeBlocks;
+    private extractLinks;
+    private detectTechStack;
+    private calculateSignificance;
+    private createDocumentationTables;
+    private storeDocumentationChunk;
+    private searchDocumentationChunks;
+    private findRelatedDocumentationChunks;
+    private extractTechStackInfo;
+    private generateMatchReason;
+    private generateContextSnippet;
+}
+export default DocumentationRAGService;
+//# sourceMappingURL=documentation-rag-service.d.ts.map

package/dist/shared/documentation-rag-service.d.ts.map

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