codehere 0.1.1

package/dist/domain/services/knowledge-access.d.ts

@@ -0,0 +1,63 @@
+/**
+ * Domain Service: Knowledge Access
+ * Provides access to preserved knowledge
+ *
+ * Clean Architecture: Domain Layer
+ *
+ * Responsibilities:
+ * - Query preserved knowledge
+ * - Provide knowledge summaries
+ * - Link knowledge to patterns and decisions
+ */
+import type { IKnowledgePreservationRepository } from '../interfaces/knowledge-preservation-repository.interface.js';
+import type { IPatternRepository } from '../interfaces/pattern-repository.interface.js';
+import type { IDecisionRepository } from '../interfaces/decision-repository.interface.js';
+import type { KnowledgePreservation, KnowledgeType } from '../entities/knowledge-preservation.js';
+export interface KnowledgeSummary {
+    totalKnowledge: number;
+    byType: {
+        [key: string]: number;
+    };
+    mostAccessed: KnowledgePreservation[];
+    recent: KnowledgePreservation[];
+    summary: string;
+}
+/**
+ * Knowledge Access Service
+ * Provides query and summary capabilities for preserved knowledge
+ */
+export declare class KnowledgeAccess {
+    private knowledgeRepository;
+    private patternRepository;
+    private decisionRepository;
+    constructor(knowledgeRepository: IKnowledgePreservationRepository, patternRepository: IPatternRepository, decisionRepository: IDecisionRepository);
+    /**
+     * Query knowledge by context
+     */
+    query(codebaseId: string, query: string, limit?: number): Promise<KnowledgePreservation[]>;
+    /**
+     * Get knowledge by type
+     */
+    getByType(codebaseId: string, type: KnowledgeType, limit?: number): Promise<KnowledgePreservation[]>;
+    /**
+     * Get knowledge by tags
+     */
+    getByTags(codebaseId: string, tags: string[], limit?: number): Promise<KnowledgePreservation[]>;
+    /**
+     * Get knowledge summary for a codebase
+     */
+    getSummary(codebaseId: string): Promise<KnowledgeSummary>;
+    /**
+     * Get relevant knowledge for planning/query
+     */
+    getRelevantKnowledge(codebaseId: string, context: string, limit?: number): Promise<KnowledgePreservation[]>;
+    /**
+     * Generate summary text
+     */
+    private generateSummary;
+    /**
+     * Infer knowledge type from context query
+     */
+    private inferKnowledgeType;
+}
+//# sourceMappingURL=knowledge-access.d.ts.map

package/dist/domain/services/knowledge-access.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"knowledge-access.d.ts","sourceRoot":"","sources":["../../../src/domain/services/knowledge-access.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EAAE,gCAAgC,EAAE,MAAM,8DAA8D,CAAC;AACrH,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,+CAA+C,CAAC;AACxF,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,gDAAgD,CAAC;AAC1F,OAAO,KAAK,EAAE,qBAAqB,EAAE,aAAa,EAAE,MAAM,uCAAuC,CAAC;AAElG,MAAM,WAAW,gBAAgB;IAC/B,cAAc,EAAE,MAAM,CAAC;IACvB,MAAM,EAAE;QAAE,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAAA;KAAE,CAAC;IAClC,YAAY,EAAE,qBAAqB,EAAE,CAAC;IACtC,MAAM,EAAE,qBAAqB,EAAE,CAAC;IAChC,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;;GAGG;AACH,qBAAa,eAAe;IAExB,OAAO,CAAC,mBAAmB;IAC3B,OAAO,CAAC,iBAAiB;IACzB,OAAO,CAAC,kBAAkB;gBAFlB,mBAAmB,EAAE,gCAAgC,EACrD,iBAAiB,EAAE,kBAAkB,EACrC,kBAAkB,EAAE,mBAAmB;IAGjD;;OAEG;IACG,KAAK,CACT,UAAU,EAAE,MAAM,EAClB,KAAK,EAAE,MAAM,EACb,KAAK,GAAE,MAAW,GACjB,OAAO,CAAC,qBAAqB,EAAE,CAAC;IAInC;;OAEG;IACG,SAAS,CACb,UAAU,EAAE,MAAM,EAClB,IAAI,EAAE,aAAa,EACnB,KAAK,GAAE,MAAW,GACjB,OAAO,CAAC,qBAAqB,EAAE,CAAC;IAInC;;OAEG;IACG,SAAS,CACb,UAAU,EAAE,MAAM,EAClB,IAAI,EAAE,MAAM,EAAE,EACd,KAAK,GAAE,MAAW,GACjB,OAAO,CAAC,qBAAqB,EAAE,CAAC;IAInC;;OAEG;IACG,UAAU,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC;IA2B/D;;OAEG;IACG,oBAAoB,CACxB,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,MAAM,EACf,KAAK,GAAE,MAAU,GAChB,OAAO,CAAC,qBAAqB,EAAE,CAAC;IA4BnC;;OAEG;IACH,OAAO,CAAC,eAAe;IAevB;;OAEG;IACH,OAAO,CAAC,kBAAkB;CAyB3B"}

package/dist/domain/services/knowledge-access.js

@@ -0,0 +1,132 @@
+/**
+ * Domain Service: Knowledge Access
+ * Provides access to preserved knowledge
+ *
+ * Clean Architecture: Domain Layer
+ *
+ * Responsibilities:
+ * - Query preserved knowledge
+ * - Provide knowledge summaries
+ * - Link knowledge to patterns and decisions
+ */
+/**
+ * Knowledge Access Service
+ * Provides query and summary capabilities for preserved knowledge
+ */
+export class KnowledgeAccess {
+    knowledgeRepository;
+    patternRepository;
+    decisionRepository;
+    constructor(knowledgeRepository, patternRepository, decisionRepository) {
+        this.knowledgeRepository = knowledgeRepository;
+        this.patternRepository = patternRepository;
+        this.decisionRepository = decisionRepository;
+    }
+    /**
+     * Query knowledge by context
+     */
+    async query(codebaseId, query, limit = 10) {
+        return await this.knowledgeRepository.search(codebaseId, query, limit);
+    }
+    /**
+     * Get knowledge by type
+     */
+    async getByType(codebaseId, type, limit = 20) {
+        return await this.knowledgeRepository.findByType(codebaseId, type, limit);
+    }
+    /**
+     * Get knowledge by tags
+     */
+    async getByTags(codebaseId, tags, limit = 20) {
+        return await this.knowledgeRepository.findByTags(codebaseId, tags, limit);
+    }
+    /**
+     * Get knowledge summary for a codebase
+     */
+    async getSummary(codebaseId) {
+        const allKnowledge = await this.knowledgeRepository.findByCodebase(codebaseId, 1000);
+        // Count by type
+        const byType = {};
+        for (const knowledge of allKnowledge) {
+            byType[knowledge.type] = (byType[knowledge.type] || 0) + 1;
+        }
+        // Get most accessed
+        const mostAccessed = await this.knowledgeRepository.getMostAccessed(codebaseId, 5);
+        // Get recent
+        const recent = await this.knowledgeRepository.getRecent(codebaseId, 5);
+        // Generate summary
+        const summary = this.generateSummary(allKnowledge, byType);
+        return {
+            totalKnowledge: allKnowledge.length,
+            byType,
+            mostAccessed,
+            recent,
+            summary,
+        };
+    }
+    /**
+     * Get relevant knowledge for planning/query
+     */
+    async getRelevantKnowledge(codebaseId, context, limit = 5) {
+        // Search for relevant knowledge
+        const searchResults = await this.knowledgeRepository.search(codebaseId, context, limit);
+        // Also get by type if context suggests specific type
+        const typeMatches = this.inferKnowledgeType(context);
+        if (typeMatches.length > 0) {
+            const typeResults = [];
+            for (const type of typeMatches.slice(0, 2)) {
+                const results = await this.knowledgeRepository.findByType(codebaseId, type, 3);
+                typeResults.push(...results);
+            }
+            // Combine and deduplicate
+            const allResults = [...searchResults, ...typeResults];
+            const unique = new Map();
+            for (const knowledge of allResults) {
+                if (knowledge.id && !unique.has(knowledge.id)) {
+                    unique.set(knowledge.id, knowledge);
+                }
+            }
+            return Array.from(unique.values()).slice(0, limit);
+        }
+        return searchResults;
+    }
+    /**
+     * Generate summary text
+     */
+    generateSummary(knowledge, byType) {
+        if (knowledge.length === 0) {
+            return 'No knowledge preserved yet.';
+        }
+        const typeSummary = Object.entries(byType)
+            .map(([type, count]) => `${count} ${type}`)
+            .join(', ');
+        return `Preserved ${knowledge.length} knowledge items: ${typeSummary}.`;
+    }
+    /**
+     * Infer knowledge type from context query
+     */
+    inferKnowledgeType(context) {
+        const contextLower = context.toLowerCase();
+        const types = [];
+        if (/architecture|structure|design|system/.test(contextLower)) {
+            types.push('architectural');
+        }
+        if (/domain|business|logic|concept/.test(contextLower)) {
+            types.push('domain-knowledge');
+        }
+        if (/pattern|convention|style/.test(contextLower)) {
+            types.push('convention');
+        }
+        if (/documentation|comment|doc/.test(contextLower)) {
+            types.push('documentation');
+        }
+        if (/best.practice|guideline|recommendation/.test(contextLower)) {
+            types.push('best-practice');
+        }
+        if (/gotcha|warning|pitfall|trap/.test(contextLower)) {
+            types.push('gotcha');
+        }
+        return types;
+    }
+}
+//# sourceMappingURL=knowledge-access.js.map

package/dist/domain/services/knowledge-access.js.map

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

package/dist/domain/services/knowledge-extractor.d.ts

@@ -0,0 +1,54 @@
+/**
+ * Domain Service: Knowledge Extractor
+ * Extracts knowledge from code, comments, and structure
+ *
+ * Clean Architecture: Domain Layer
+ *
+ * Responsibilities:
+ * - Extract domain knowledge from code comments
+ * - Extract architectural knowledge from code structure
+ * - Extract conventions from patterns
+ * - Extract best practices from codebase
+ */
+import type { IAIService } from '../interfaces/ai-service.interface.js';
+import type { IKnowledgePreservationRepository } from '../interfaces/knowledge-preservation-repository.interface.js';
+import type { IPatternRepository } from '../interfaces/pattern-repository.interface.js';
+import type { KnowledgePreservation } from '../entities/knowledge-preservation.js';
+export interface KnowledgeExtractionRequest {
+    codebaseId: string;
+    codebasePath: string;
+    filepath?: string;
+    content?: string;
+    sourceType: 'code-comment' | 'code-structure' | 'pattern' | 'ai-extraction';
+}
+/**
+ * Knowledge Extractor Service
+ * Extracts various types of knowledge from codebases
+ */
+export declare class KnowledgeExtractor {
+    private knowledgeRepository;
+    private patternRepository;
+    private aiService;
+    constructor(knowledgeRepository: IKnowledgePreservationRepository, patternRepository: IPatternRepository, aiService: IAIService);
+    /**
+     * Extract knowledge from code comments
+     */
+    extractFromComments(filepath: string, codebaseId: string, codebasePath: string): Promise<KnowledgePreservation[]>;
+    /**
+     * Extract architectural knowledge from code structure
+     */
+    extractFromStructure(filepath: string, codebaseId: string, codebasePath: string): Promise<KnowledgePreservation[]>;
+    /**
+     * Extract knowledge from existing patterns
+     */
+    extractFromPatterns(codebaseId: string, codebasePath: string): Promise<KnowledgePreservation[]>;
+    /**
+     * Extract knowledge using AI analysis
+     */
+    extractWithAI(request: KnowledgeExtractionRequest): Promise<KnowledgePreservation[]>;
+    /**
+     * Extract all knowledge from a file
+     */
+    extractFromFile(filepath: string, codebaseId: string, codebasePath: string): Promise<void>;
+}
+//# sourceMappingURL=knowledge-extractor.d.ts.map

package/dist/domain/services/knowledge-extractor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"knowledge-extractor.d.ts","sourceRoot":"","sources":["../../../src/domain/services/knowledge-extractor.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,uCAAuC,CAAC;AACxE,OAAO,KAAK,EAAE,gCAAgC,EAAE,MAAM,8DAA8D,CAAC;AACrH,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,+CAA+C,CAAC;AACxF,OAAO,KAAK,EAAE,qBAAqB,EAAiB,MAAM,uCAAuC,CAAC;AAIlG,MAAM,WAAW,0BAA0B;IACzC,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,cAAc,GAAG,gBAAgB,GAAG,SAAS,GAAG,eAAe,CAAC;CAC7E;AAED;;;GAGG;AACH,qBAAa,kBAAkB;IAE3B,OAAO,CAAC,mBAAmB;IAC3B,OAAO,CAAC,iBAAiB;IACzB,OAAO,CAAC,SAAS;gBAFT,mBAAmB,EAAE,gCAAgC,EACrD,iBAAiB,EAAE,kBAAkB,EACrC,SAAS,EAAE,UAAU;IAG/B;;OAEG;IACG,mBAAmB,CACvB,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE,MAAM,EAClB,YAAY,EAAE,MAAM,GACnB,OAAO,CAAC,qBAAqB,EAAE,CAAC;IAiFnC;;OAEG;IACG,oBAAoB,CACxB,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE,MAAM,EAClB,YAAY,EAAE,MAAM,GACnB,OAAO,CAAC,qBAAqB,EAAE,CAAC;IAuCnC;;OAEG;IACG,mBAAmB,CACvB,UAAU,EAAE,MAAM,EAClB,YAAY,EAAE,MAAM,GACnB,OAAO,CAAC,qBAAqB,EAAE,CAAC;IA6BnC;;OAEG;IACG,aAAa,CACjB,OAAO,EAAE,0BAA0B,GAClC,OAAO,CAAC,qBAAqB,EAAE,CAAC;IAoEnC;;OAEG;IACG,eAAe,CACnB,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE,MAAM,EAClB,YAAY,EAAE,MAAM,GACnB,OAAO,CAAC,IAAI,CAAC;CAgBjB"}

package/dist/domain/services/knowledge-extractor.js

@@ -0,0 +1,247 @@
+/**
+ * Domain Service: Knowledge Extractor
+ * Extracts knowledge from code, comments, and structure
+ *
+ * Clean Architecture: Domain Layer
+ *
+ * Responsibilities:
+ * - Extract domain knowledge from code comments
+ * - Extract architectural knowledge from code structure
+ * - Extract conventions from patterns
+ * - Extract best practices from codebase
+ */
+import { readFileSync, existsSync } from 'fs';
+import { randomUUID } from 'crypto';
+/**
+ * Knowledge Extractor Service
+ * Extracts various types of knowledge from codebases
+ */
+export class KnowledgeExtractor {
+    knowledgeRepository;
+    patternRepository;
+    aiService;
+    constructor(knowledgeRepository, patternRepository, aiService) {
+        this.knowledgeRepository = knowledgeRepository;
+        this.patternRepository = patternRepository;
+        this.aiService = aiService;
+    }
+    /**
+     * Extract knowledge from code comments
+     */
+    async extractFromComments(filepath, codebaseId, codebasePath) {
+        if (!existsSync(filepath)) {
+            return [];
+        }
+        const content = readFileSync(filepath, 'utf-8');
+        const knowledge = [];
+        // Extract JSDoc/TSDoc comments
+        const docCommentPattern = /\/\*\*([\s\S]*?)\*\//g;
+        const docMatches = [...content.matchAll(docCommentPattern)];
+        for (const match of docMatches) {
+            const comment = match[1];
+            const lines = comment.split('\n').map(l => l.replace(/^\s*\*\s?/, '').trim()).filter(Boolean);
+            if (lines.length > 0) {
+                // Extract description, params, returns, examples
+                const description = lines.filter(l => !l.startsWith('@')).join(' ').trim();
+                if (description && description.length > 20) {
+                    const lineNumber = content.substring(0, match.index).split('\n').length;
+                    knowledge.push({
+                        id: randomUUID(),
+                        codebaseId,
+                        type: 'documentation',
+                        title: `Documentation: ${filepath}:${lineNumber}`,
+                        content: description,
+                        source: {
+                            type: 'code-comment',
+                            filepath,
+                            lineNumbers: { start: lineNumber, end: lineNumber + lines.length },
+                            context: `Extracted from JSDoc comment in ${filepath}`,
+                        },
+                        extractedAt: new Date(),
+                        relevanceScore: 0.7,
+                    });
+                }
+            }
+        }
+        // Extract inline comments with keywords (TODO, NOTE, FIXME, etc.)
+        const inlineCommentPattern = /\/\/\s*(TODO|NOTE|FIXME|HACK|XXX|IMPORTANT|WARNING):\s*(.+)/gi;
+        const inlineMatches = [...content.matchAll(inlineCommentPattern)];
+        for (const match of inlineMatches) {
+            const keyword = match[1];
+            const comment = match[2].trim();
+            if (comment && comment.length > 10) {
+                const lineNumber = content.substring(0, match.index).split('\n').length;
+                let knowledgeType = 'domain-knowledge';
+                if (keyword === 'TODO' || keyword === 'FIXME') {
+                    knowledgeType = 'gotcha';
+                }
+                else if (keyword === 'NOTE' || keyword === 'IMPORTANT') {
+                    knowledgeType = 'documentation';
+                }
+                knowledge.push({
+                    id: randomUUID(),
+                    codebaseId,
+                    type: knowledgeType,
+                    title: `${keyword}: ${comment.substring(0, 50)}`,
+                    content: comment,
+                    source: {
+                        type: 'code-comment',
+                        filepath,
+                        lineNumbers: { start: lineNumber, end: lineNumber },
+                        context: `Extracted from ${keyword} comment in ${filepath}`,
+                    },
+                    extractedAt: new Date(),
+                    relevanceScore: keyword === 'IMPORTANT' || keyword === 'WARNING' ? 0.9 : 0.6,
+                });
+            }
+        }
+        return knowledge;
+    }
+    /**
+     * Extract architectural knowledge from code structure
+     */
+    async extractFromStructure(filepath, codebaseId, codebasePath) {
+        if (!existsSync(filepath)) {
+            return [];
+        }
+        const content = readFileSync(filepath, 'utf-8');
+        const knowledge = [];
+        // Extract architectural patterns (e.g., directory structure, naming conventions)
+        const isInDomainLayer = filepath.includes('/domain/');
+        const isInInfrastructureLayer = filepath.includes('/infrastructure/');
+        const isInApplicationLayer = filepath.includes('/application/');
+        if (isInDomainLayer || isInInfrastructureLayer || isInApplicationLayer) {
+            // This file follows Clean Architecture
+            const layerName = isInDomainLayer ? 'Domain' : isInInfrastructureLayer ? 'Infrastructure' : 'Application';
+            knowledge.push({
+                id: randomUUID(),
+                codebaseId,
+                type: 'architectural',
+                title: `Clean Architecture: ${layerName} Layer`,
+                content: `This codebase follows Clean Architecture principles. Files in the ${layerName.toLowerCase()} layer follow specific responsibilities.`,
+                source: {
+                    type: 'code-structure',
+                    filepath,
+                    context: `Detected Clean Architecture structure from file path`,
+                },
+                extractedAt: new Date(),
+                relevanceScore: 0.8,
+                metadata: {
+                    tags: ['clean-architecture', 'architecture', layerName.toLowerCase()],
+                },
+            });
+        }
+        return knowledge;
+    }
+    /**
+     * Extract knowledge from existing patterns
+     */
+    async extractFromPatterns(codebaseId, codebasePath) {
+        const patterns = await this.patternRepository.findByCodebase(codebaseId);
+        const knowledge = [];
+        for (const pattern of patterns.slice(0, 20)) { // Limit to most used patterns
+            knowledge.push({
+                id: randomUUID(),
+                codebaseId,
+                type: 'convention',
+                title: `Pattern: ${pattern.name}`,
+                content: pattern.description,
+                source: {
+                    type: 'pattern',
+                    filepath: pattern.filepath,
+                    lineNumbers: pattern.lineNumbers,
+                    context: `Extracted from pattern library`,
+                },
+                extractedAt: new Date(),
+                relevanceScore: (pattern.usageCount || 0) > 0 ? 0.8 : 0.6,
+                metadata: {
+                    tags: pattern.metadata?.tags || [],
+                    relatedPatterns: [pattern.id],
+                },
+            });
+        }
+        return knowledge;
+    }
+    /**
+     * Extract knowledge using AI analysis
+     */
+    async extractWithAI(request) {
+        if (!request.content && !request.filepath) {
+            return [];
+        }
+        const content = request.content || (request.filepath && existsSync(request.filepath)
+            ? readFileSync(request.filepath, 'utf-8')
+            : '');
+        if (!content || content.length < 50) {
+            return [];
+        }
+        try {
+            const prompt = `Analyze this code and extract key knowledge:
+
+${request.filepath ? `File: ${request.filepath}` : 'Code snippet'}
+\`\`\`
+${content.substring(0, 2000)} // Truncated for AI analysis
+\`\`\`
+
+Extract:
+1. Domain knowledge (business logic, concepts)
+2. Architectural insights
+3. Best practices
+4. Gotchas or warnings
+
+Respond with JSON array:
+[
+  {
+    "type": "domain-knowledge|architectural|best-practice|gotcha",
+    "title": "Short title",
+    "content": "Detailed knowledge",
+    "relevanceScore": 0.0-1.0
+  }
+]`;
+            const response = await this.aiService.chat(prompt, []);
+            const jsonMatch = response.match(/\[[\s\S]*\]/);
+            if (jsonMatch) {
+                const extracted = JSON.parse(jsonMatch[0]);
+                return extracted.map(item => ({
+                    id: randomUUID(),
+                    codebaseId: request.codebaseId,
+                    type: item.type || 'domain-knowledge',
+                    title: item.title,
+                    content: item.content,
+                    source: {
+                        type: 'ai-extraction',
+                        filepath: request.filepath,
+                        context: `AI-extracted knowledge from ${request.filepath || 'code snippet'}`,
+                    },
+                    extractedAt: new Date(),
+                    relevanceScore: item.relevanceScore || 0.7,
+                    metadata: {
+                        confidence: item.relevanceScore || 0.7,
+                    },
+                }));
+            }
+        }
+        catch (error) {
+            console.warn('AI knowledge extraction failed:', error);
+        }
+        return [];
+    }
+    /**
+     * Extract all knowledge from a file
+     */
+    async extractFromFile(filepath, codebaseId, codebasePath) {
+        // Extract from comments
+        const commentKnowledge = await this.extractFromComments(filepath, codebaseId, codebasePath);
+        for (const knowledge of commentKnowledge) {
+            await this.knowledgeRepository.store(knowledge);
+        }
+        // Extract from structure
+        const structureKnowledge = await this.extractFromStructure(filepath, codebaseId, codebasePath);
+        for (const knowledge of structureKnowledge) {
+            await this.knowledgeRepository.store(knowledge);
+        }
+        // Extract with AI (optional, can be expensive)
+        // Only do this for important files or on-demand
+    }
+}
+//# sourceMappingURL=knowledge-extractor.js.map

package/dist/domain/services/knowledge-extractor.js.map

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

package/dist/domain/services/knowledge-graph-builder.d.ts

@@ -0,0 +1,70 @@
+/**
+ * Domain Service: KnowledgeGraphBuilder
+ * Builds knowledge graph from code, patterns, and memories
+ *
+ * Clean Architecture: Domain Layer
+ * Pattern: Builder Pattern
+ *
+ * Responsibilities:
+ * - Extract relationships from code (AST-based)
+ * - Extract relationships from patterns
+ * - Extract relationships from memories
+ * - Build graph incrementally
+ */
+import type { IKnowledgeGraphRepository } from '../interfaces/knowledge-graph-repository.interface.js';
+import type { IPatternRepository } from '../interfaces/pattern-repository.interface.js';
+import type { IMemoryRepository } from '../interfaces/memory-repository.interface.js';
+import type { KnowledgeNode, KnowledgeEdge } from '../entities/knowledge-node.js';
+export interface GraphBuildRequest {
+    codebaseId: string;
+    codebasePath: string;
+    sources?: {
+        patterns?: boolean;
+        memories?: boolean;
+        code?: boolean;
+    };
+}
+export interface GraphBuildResult {
+    nodesCreated: number;
+    edgesCreated: number;
+    buildTime: number;
+}
+/**
+ * Knowledge Graph Builder Service
+ * Builds knowledge graph incrementally from various sources
+ */
+export declare class KnowledgeGraphBuilder {
+    private graphRepository;
+    private patternRepository;
+    private memoryRepository;
+    constructor(graphRepository: IKnowledgeGraphRepository, patternRepository: IPatternRepository, memoryRepository: IMemoryRepository);
+    /**
+     * Build knowledge graph from patterns, memories, and code
+     */
+    buildGraph(request: GraphBuildRequest): Promise<GraphBuildResult>;
+    /**
+     * Build graph nodes and edges from patterns
+     */
+    private buildFromPatterns;
+    /**
+     * Build graph nodes and edges from memories
+     */
+    private buildFromMemories;
+    /**
+     * Build relationships between patterns and memories
+     */
+    private buildPatternMemoryRelationships;
+    /**
+     * Add a node to the graph
+     */
+    addNode(node: KnowledgeNode): Promise<void>;
+    /**
+     * Add an edge to the graph
+     */
+    addEdge(edge: KnowledgeEdge): Promise<void>;
+    /**
+     * Update graph incrementally (add new patterns/memories)
+     */
+    updateGraphIncremental(codebaseId: string): Promise<GraphBuildResult>;
+}
+//# sourceMappingURL=knowledge-graph-builder.d.ts.map

package/dist/domain/services/knowledge-graph-builder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"knowledge-graph-builder.d.ts","sourceRoot":"","sources":["../../../src/domain/services/knowledge-graph-builder.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,uDAAuD,CAAC;AACvG,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,+CAA+C,CAAC;AACxF,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,8CAA8C,CAAC;AACtF,OAAO,KAAK,EACV,aAAa,EACb,aAAa,EAGd,MAAM,+BAA+B,CAAC;AAKvC,MAAM,WAAW,iBAAiB;IAChC,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE;QACR,QAAQ,CAAC,EAAE,OAAO,CAAC;QACnB,QAAQ,CAAC,EAAE,OAAO,CAAC;QACnB,IAAI,CAAC,EAAE,OAAO,CAAC;KAChB,CAAC;CACH;AAED,MAAM,WAAW,gBAAgB;IAC/B,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;;GAGG;AACH,qBAAa,qBAAqB;IAE9B,OAAO,CAAC,eAAe;IACvB,OAAO,CAAC,iBAAiB;IACzB,OAAO,CAAC,gBAAgB;gBAFhB,eAAe,EAAE,yBAAyB,EAC1C,iBAAiB,EAAE,kBAAkB,EACrC,gBAAgB,EAAE,iBAAiB;IAG7C;;OAEG;IACG,UAAU,CAAC,OAAO,EAAE,iBAAiB,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAsCvE;;OAEG;YACW,iBAAiB;IAmG/B;;OAEG;YACW,iBAAiB;IA6D/B;;OAEG;YACW,+BAA+B;IAkC7C;;OAEG;IACG,OAAO,CAAC,IAAI,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC;IAIjD;;OAEG;IACG,OAAO,CAAC,IAAI,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC;IAIjD;;OAEG;IACG,sBAAsB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC;CAY5E"}