@noyrax/5d-database-plugin 0.1.7 → 0.1.8-beta.1

package/out/services/adr-pattern-analyzer.js

@@ -0,0 +1,339 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AdrPatternAnalyzer = void 0;
+const adr_repository_1 = require("../repositories/adr-repository");
+const module_repository_1 = require("../repositories/module-repository");
+const path = __importStar(require("path"));
+/**
+ * Analyzes existing ADRs to extract patterns and create structure templates.
+ * Used for deterministic ADR reconstruction.
+ */
+class AdrPatternAnalyzer {
+    constructor(dbManager) {
+        this.dbManager = dbManager;
+    }
+    /**
+     * Analyzes all ADRs and extracts patterns.
+     */
+    async analyzeAdrPatterns(pluginId) {
+        const adrDb = await this.dbManager.getDatabase('W');
+        const moduleDb = await this.dbManager.getDatabase('X');
+        const adrRepo = new adr_repository_1.AdrRepository(adrDb);
+        const moduleRepo = new module_repository_1.ModuleRepository(moduleDb);
+        const allAdrs = await adrRepo.getAll(pluginId);
+        const allModules = await moduleRepo.getAll(pluginId);
+        const patterns = [];
+        // Extract patterns from each ADR
+        for (const adr of allAdrs) {
+            const fileMappings = await adrRepo.getAdrFileMappings(adr.id);
+            // Find modules referenced by this ADR
+            for (const mapping of fileMappings) {
+                const module = allModules.find(m => m.file_path === mapping.file_path);
+                if (module) {
+                    const pattern = this.extractPatternsFromAdr(adr, module);
+                    patterns.push(pattern);
+                }
+            }
+        }
+        // Group patterns by type
+        const patternMap = new Map();
+        for (const pattern of patterns) {
+            if (!patternMap.has(pattern.patternType)) {
+                patternMap.set(pattern.patternType, []);
+            }
+            patternMap.get(pattern.patternType).push(pattern);
+        }
+        // Build structure templates for each pattern type
+        const structureTemplates = new Map();
+        for (const [patternType, patternList] of patternMap.entries()) {
+            const structure = this.buildPatternTemplate(patternList);
+            structureTemplates.set(patternType, structure);
+        }
+        return {
+            patterns: patternMap,
+            structureTemplates
+        };
+    }
+    /**
+     * Extracts patterns from an ADR and its associated module.
+     */
+    extractPatternsFromAdr(adr, module) {
+        const patternType = this.detectPatternType(module.file_path);
+        const sections = this.extractSections(adr.content_markdown);
+        const structure = this.analyzeStructure(adr.content_markdown);
+        return {
+            patternType,
+            modulePath: module.file_path,
+            adrNumber: adr.adr_number,
+            adrTitle: adr.title,
+            sections,
+            structure
+        };
+    }
+    /**
+     * Finds similar ADR patterns for a target module.
+     */
+    async findSimilarAdrPatterns(targetModule, pluginId) {
+        const patternMap = await this.analyzeAdrPatterns(pluginId);
+        const targetPatternType = this.detectPatternType(targetModule.file_path);
+        // Find patterns of the same type
+        const sameTypePatterns = patternMap.patterns.get(targetPatternType) || [];
+        // Also include similar pattern types
+        const similarPatterns = [];
+        // Repository patterns are similar to each other
+        if (targetPatternType === 'Repository') {
+            const repoPatterns = patternMap.patterns.get('Repository') || [];
+            similarPatterns.push(...repoPatterns);
+        }
+        // API patterns are similar to each other
+        if (targetPatternType === 'API Layer') {
+            const apiPatterns = patternMap.patterns.get('API Layer') || [];
+            similarPatterns.push(...apiPatterns);
+        }
+        // Service patterns are similar to each other
+        if (targetPatternType === 'Service Layer') {
+            const servicePatterns = patternMap.patterns.get('Service Layer') || [];
+            similarPatterns.push(...servicePatterns);
+        }
+        // Combine and deduplicate
+        const allPatterns = [...sameTypePatterns, ...similarPatterns];
+        const uniquePatterns = Array.from(new Map(allPatterns.map(p => [p.adrNumber, p])).values());
+        return uniquePatterns;
+    }
+    /**
+     * Builds a structure template from a list of patterns.
+     */
+    buildPatternTemplate(patterns) {
+        if (patterns.length === 0) {
+            return {
+                requiredSections: ['Status', 'Kontext', 'Entscheidung', 'Konsequenzen'],
+                optionalSections: ['Alternativen', 'Verweise', 'Implementierung'],
+                sectionOrder: ['Status', 'Kontext', 'Entscheidung', 'Konsequenzen', 'Verweise'],
+                commonPatterns: []
+            };
+        }
+        // Collect all sections from all patterns
+        const allSections = new Set();
+        const sectionFrequency = new Map();
+        for (const pattern of patterns) {
+            for (const sectionName of pattern.structure.requiredSections) {
+                allSections.add(sectionName);
+                sectionFrequency.set(sectionName, (sectionFrequency.get(sectionName) || 0) + 1);
+            }
+            for (const sectionName of pattern.structure.optionalSections) {
+                allSections.add(sectionName);
+                sectionFrequency.set(sectionName, (sectionFrequency.get(sectionName) || 0) + 1);
+            }
+        }
+        // Required sections appear in >80% of patterns
+        const requiredSections = [];
+        const optionalSections = [];
+        const threshold = patterns.length * 0.8;
+        for (const section of allSections) {
+            const frequency = sectionFrequency.get(section) || 0;
+            if (frequency >= threshold) {
+                requiredSections.push(section);
+            }
+            else {
+                optionalSections.push(section);
+            }
+        }
+        // Determine section order (most common order)
+        const sectionOrder = this.determineSectionOrder(patterns);
+        // Extract common patterns from section content
+        const commonPatterns = this.extractCommonPatterns(patterns);
+        return {
+            requiredSections,
+            optionalSections,
+            sectionOrder,
+            commonPatterns
+        };
+    }
+    /**
+     * Detects pattern type from file path.
+     */
+    detectPatternType(filePath) {
+        const fileName = path.basename(filePath, path.extname(filePath)).toLowerCase();
+        const dirName = path.dirname(filePath).toLowerCase();
+        // Repository Pattern
+        if (fileName.includes('repository') || dirName.includes('repositories')) {
+            return 'Repository';
+        }
+        // API Layer Pattern
+        if (fileName.includes('api') || dirName.includes('/api/')) {
+            return 'API Layer';
+        }
+        // Service Layer Pattern
+        if (dirName.includes('/services/')) {
+            return 'Service Layer';
+        }
+        // Builder Pattern
+        if (fileName.includes('builder') || fileName.includes('build')) {
+            return 'Builder';
+        }
+        // Ingestor Pattern
+        if (fileName.includes('ingestor') || dirName.includes('ingestors')) {
+            return 'Ingestor';
+        }
+        // CLI Pattern
+        if (fileName.includes('cli') || dirName.includes('/cli/')) {
+            return 'CLI';
+        }
+        // Core Pattern
+        if (dirName.includes('/core/')) {
+            return 'Core';
+        }
+        // Default: Generic
+        return 'Generic';
+    }
+    /**
+     * Extracts sections from ADR markdown content.
+     */
+    extractSections(content) {
+        const sections = new Map();
+        const lines = content.split('\n');
+        let currentSection = null;
+        let currentContent = [];
+        for (const line of lines) {
+            // Check for section headers (## or ###)
+            const sectionMatch = line.match(/^##+\s+(.+)$/);
+            if (sectionMatch) {
+                // Save previous section
+                if (currentSection) {
+                    sections.set(currentSection, currentContent.join('\n').trim());
+                }
+                // Start new section
+                currentSection = sectionMatch[1].trim();
+                currentContent = [];
+            }
+            else if (currentSection) {
+                currentContent.push(line);
+            }
+        }
+        // Save last section
+        if (currentSection) {
+            sections.set(currentSection, currentContent.join('\n').trim());
+        }
+        return sections;
+    }
+    /**
+     * Analyzes ADR structure from markdown content.
+     */
+    analyzeStructure(content) {
+        const sections = this.extractSections(content);
+        const sectionNames = Array.from(sections.keys());
+        // Common required sections
+        const commonRequired = ['Status', 'Kontext', 'Context', 'Entscheidung', 'Decision', 'Konsequenzen', 'Consequences'];
+        const requiredSections = sectionNames.filter(name => commonRequired.some(req => name.toLowerCase().includes(req.toLowerCase())));
+        // Optional sections are the rest
+        const optionalSections = sectionNames.filter(name => !requiredSections.includes(name));
+        // Section order is the order they appear in the document
+        const sectionOrder = sectionNames;
+        return {
+            requiredSections,
+            optionalSections,
+            sectionOrder,
+            commonPatterns: []
+        };
+    }
+    /**
+     * Determines the most common section order from patterns.
+     */
+    determineSectionOrder(patterns) {
+        if (patterns.length === 0) {
+            return ['Status', 'Kontext', 'Entscheidung', 'Konsequenzen'];
+        }
+        // Count section positions
+        const positionCounts = new Map();
+        for (const pattern of patterns) {
+            pattern.structure.sectionOrder.forEach((section, index) => {
+                if (!positionCounts.has(section)) {
+                    positionCounts.set(section, new Map());
+                }
+                const counts = positionCounts.get(section);
+                counts.set(index, (counts.get(index) || 0) + 1);
+            });
+        }
+        // Find most common position for each section
+        const sectionPositions = new Map();
+        for (const [section, positions] of positionCounts.entries()) {
+            let maxCount = 0;
+            let bestPosition = 0;
+            for (const [position, count] of positions.entries()) {
+                if (count > maxCount) {
+                    maxCount = count;
+                    bestPosition = position;
+                }
+            }
+            sectionPositions.set(section, bestPosition);
+        }
+        // Sort sections by their most common position
+        const sortedSections = Array.from(sectionPositions.entries())
+            .sort((a, b) => a[1] - b[1])
+            .map(([section]) => section);
+        return sortedSections.length > 0 ? sortedSections : ['Status', 'Kontext', 'Entscheidung', 'Konsequenzen'];
+    }
+    /**
+     * Extracts common patterns from pattern content.
+     */
+    extractCommonPatterns(patterns) {
+        const commonPatterns = [];
+        // Analyze section content for common phrases
+        const phraseFrequency = new Map();
+        for (const pattern of patterns) {
+            for (const [sectionName, content] of pattern.sections.entries()) {
+                // Extract key phrases (simple heuristic: words in quotes or code blocks)
+                const phrases = content.match(/`([^`]+)`|"([^"]+)"/g) || [];
+                for (const phrase of phrases) {
+                    const cleanPhrase = phrase.replace(/[`"]/g, '').trim();
+                    if (cleanPhrase.length > 5) {
+                        phraseFrequency.set(cleanPhrase, (phraseFrequency.get(cleanPhrase) || 0) + 1);
+                    }
+                }
+            }
+        }
+        // Find phrases that appear in >50% of patterns
+        const threshold = patterns.length * 0.5;
+        for (const [phrase, count] of phraseFrequency.entries()) {
+            if (count >= threshold) {
+                commonPatterns.push(phrase);
+            }
+        }
+        return commonPatterns;
+    }
+}
+exports.AdrPatternAnalyzer = AdrPatternAnalyzer;
+//# sourceMappingURL=adr-pattern-analyzer.js.map

package/out/services/adr-pattern-analyzer.js.map

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

package/out/services/adr-reasoning-service.d.ts

@@ -0,0 +1,63 @@
+import { ModuleContext } from './adr-context-builder';
+import { Adr } from '../models/adr';
+import { ArchitecturalPattern } from './semantic-pattern-matcher';
+/**
+ * ADR Reasoning result from LLM
+ */
+export interface AdrReasoning {
+    problems: string[];
+    decision: string;
+    rationale: string;
+    alternatives: string[];
+    tradeoffs: {
+        positive: string[];
+        negative: string[];
+    };
+    refactoring_recommendations?: string[];
+}
+/**
+ * Service for reconstructing "Why" (rationale) from module context using LLM.
+ * Uses OpenAI API to generate structured reasoning about architectural decisions.
+ */
+export declare class AdrReasoningService {
+    private openai;
+    private readonly defaultModel;
+    private readonly temperature;
+    constructor(apiKey?: string);
+    /**
+     * Checks if LLM is available.
+     */
+    isAvailable(): boolean;
+    /**
+     * Reconstructs complete reasoning (problems, decision, rationale, alternatives, trade-offs).
+     */
+    reconstructWhy(context: ModuleContext, similarAdrs: Adr[], patterns: ArchitecturalPattern[], complexity?: 'simple' | 'medium' | 'complex'): Promise<AdrReasoning>;
+    /**
+     * Reconstructs problems that this module solves.
+     */
+    reconstructProblems(context: ModuleContext, similarAdrs: Adr[]): Promise<string[]>;
+    /**
+     * Reconstructs decision with rationale.
+     */
+    reconstructDecision(context: ModuleContext, similarAdrs: Adr[], patterns: ArchitecturalPattern[]): Promise<{
+        decision: string;
+        rationale: string;
+    }>;
+    /**
+     * Reconstructs alternatives that were considered.
+     */
+    reconstructAlternatives(context: ModuleContext, similarAdrs: Adr[]): Promise<string[]>;
+    /**
+     * Builds structured prompt for reasoning.
+     */
+    private buildReasoningPrompt;
+    /**
+     * Parses module documentation markdown to extract structured information.
+     */
+    private parseModuleDocumentation;
+    /**
+     * Validates reasoning structure and checks for generic phrases.
+     */
+    private validateReasoning;
+}
+//# sourceMappingURL=adr-reasoning-service.d.ts.map

package/out/services/adr-reasoning-service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"adr-reasoning-service.d.ts","sourceRoot":"","sources":["../../src/services/adr-reasoning-service.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AACtD,OAAO,EAAE,GAAG,EAAE,MAAM,eAAe,CAAC;AACpC,OAAO,EAAE,oBAAoB,EAAE,MAAM,4BAA4B,CAAC;AAGlE;;GAEG;AACH,MAAM,WAAW,YAAY;IACzB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,SAAS,EAAE;QACP,QAAQ,EAAE,MAAM,EAAE,CAAC;QACnB,QAAQ,EAAE,MAAM,EAAE,CAAC;KACtB,CAAC;IACF,2BAA2B,CAAC,EAAE,MAAM,EAAE,CAAC;CAC1C;AAED;;;GAGG;AACH,qBAAa,mBAAmB;IAC5B,OAAO,CAAC,MAAM,CAAuB;IACrC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAyB;IACtD,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAa;gBAE7B,MAAM,CAAC,EAAE,MAAM;IAc3B;;OAEG;IACI,WAAW,IAAI,OAAO;IAI7B;;OAEG;IACU,cAAc,CACvB,OAAO,EAAE,aAAa,EACtB,WAAW,EAAE,GAAG,EAAE,EAClB,QAAQ,EAAE,oBAAoB,EAAE,EAChC,UAAU,GAAE,QAAQ,GAAG,QAAQ,GAAG,SAAqB,GACxD,OAAO,CAAC,YAAY,CAAC;IA2DxB;;OAEG;IACU,mBAAmB,CAC5B,OAAO,EAAE,aAAa,EACtB,WAAW,EAAE,GAAG,EAAE,GACnB,OAAO,CAAC,MAAM,EAAE,CAAC;IAKpB;;OAEG;IACU,mBAAmB,CAC5B,OAAO,EAAE,aAAa,EACtB,WAAW,EAAE,GAAG,EAAE,EAClB,QAAQ,EAAE,oBAAoB,EAAE,GACjC,OAAO,CAAC;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,CAAC;IAQnD;;OAEG;IACU,uBAAuB,CAChC,OAAO,EAAE,aAAa,EACtB,WAAW,EAAE,GAAG,EAAE,GACnB,OAAO,CAAC,MAAM,EAAE,CAAC;IAKpB;;OAEG;IACH,OAAO,CAAC,oBAAoB;IAmf5B;;OAEG;IACH,OAAO,CAAC,wBAAwB;IA+DhC;;OAEG;IACH,OAAO,CAAC,iBAAiB;CAuF5B"}