@noyrax/5d-database-plugin 0.1.0

package/out/mcp/tools/architecture-mining.js

@@ -0,0 +1,272 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ArchitectureMiningTool = void 0;
+const cross_dimension_api_1 = require("../../api/cross-dimension-api");
+const module_api_1 = require("../../api/module-api");
+const symbol_api_1 = require("../../api/symbol-api");
+const dependency_api_1 = require("../../api/dependency-api");
+const adr_api_1 = require("../../api/adr-api");
+/**
+ * MCP Tool: architecture_mining
+ * Mines architectural decisions from code structure and patterns.
+ * Compares with existing ADRs to identify undocumented decisions.
+ */
+class ArchitectureMiningTool {
+    constructor(dbManager, idMapper) {
+        this.crossDimensionApi = new cross_dimension_api_1.CrossDimensionApi(dbManager, idMapper);
+        this.moduleApi = new module_api_1.ModuleApi(dbManager);
+        this.symbolApi = new symbol_api_1.SymbolApi(dbManager);
+        this.dependencyApi = new dependency_api_1.DependencyApi(dbManager);
+        this.adrApi = new adr_api_1.AdrApi(dbManager);
+    }
+    /**
+     * Executes the architecture_mining tool.
+     *
+     * @param args Arguments: pluginId, filePath (optional - specific file to analyze)
+     * @returns JSON string with mined architectural decisions
+     */
+    async execute(args) {
+        const decisions = [];
+        if (args.filePath) {
+            // Analyze specific file
+            const module = await this.moduleApi.getModuleByPath(args.filePath, args.pluginId);
+            if (module) {
+                const symbols = await this.symbolApi.getSymbolsByPath(args.filePath, args.pluginId);
+                const dependencies = await this.dependencyApi.getDependenciesByFromModule(args.filePath, args.pluginId);
+                const existingAdrs = await this.adrApi.getAdrsByFilePath(args.filePath, args.pluginId);
+                decisions.push(...this.analyzeModule(module, symbols, dependencies, existingAdrs));
+            }
+        }
+        else {
+            // Analyze entire system
+            const modules = await this.moduleApi.getAllModules(args.pluginId);
+            const allAdrs = await this.adrApi.getAllAdrs(args.pluginId);
+            // Pattern recognition across all modules
+            decisions.push(...this.recognizeSystemPatterns(modules, allAdrs));
+        }
+        return JSON.stringify({
+            analysis_date: new Date().toISOString(),
+            file_path: args.filePath || 'entire_system',
+            decisions: decisions.sort((a, b) => {
+                const confidenceOrder = { high: 3, medium: 2, low: 1 };
+                return confidenceOrder[b.confidence] - confidenceOrder[a.confidence];
+            }),
+            summary: {
+                total_decisions: decisions.length,
+                high_confidence: decisions.filter(d => d.confidence === 'high').length,
+                medium_confidence: decisions.filter(d => d.confidence === 'medium').length,
+                low_confidence: decisions.filter(d => d.confidence === 'low').length,
+                undocumented: decisions.filter(d => d.existing_adrs.length === 0).length
+            }
+        }, null, 2);
+    }
+    /**
+     * Analyzes a single module for architectural patterns.
+     */
+    analyzeModule(module, symbols, dependencies, existingAdrs) {
+        const decisions = [];
+        const filePath = module.file_path;
+        const fileName = filePath.split('/').pop() || '';
+        const existingAdrNumbers = existingAdrs.map(adr => adr.adr_number);
+        // Pattern: Repository Pattern
+        if (fileName.includes('repository') || fileName.includes('Repository')) {
+            decisions.push({
+                pattern: 'Repository Pattern',
+                evidence: [
+                    `File name contains "repository": ${fileName}`,
+                    `Module path: ${filePath}`,
+                    `Symbols: ${symbols.length} symbols found`
+                ],
+                confidence: 'high',
+                suggested_adr_title: `Repository Pattern Implementation: ${filePath}`,
+                existing_adrs: existingAdrNumbers
+            });
+        }
+        // Pattern: API Layer
+        if (filePath.includes('/api/') || fileName.includes('api') || fileName.includes('Api')) {
+            decisions.push({
+                pattern: 'API Layer Pattern',
+                evidence: [
+                    `File in /api/ directory or contains "api": ${filePath}`,
+                    `Dependencies: ${dependencies.length} dependencies`,
+                    `Symbols: ${symbols.length} symbols`
+                ],
+                confidence: 'high',
+                suggested_adr_title: `API Layer: ${filePath}`,
+                existing_adrs: existingAdrNumbers
+            });
+        }
+        // Pattern: Builder Pattern
+        if (fileName.includes('builder') || fileName.includes('Builder')) {
+            decisions.push({
+                pattern: 'Builder Pattern',
+                evidence: [
+                    `File name contains "builder": ${fileName}`,
+                    `Module path: ${filePath}`
+                ],
+                confidence: 'high',
+                suggested_adr_title: `Builder Pattern: ${filePath}`,
+                existing_adrs: existingAdrNumbers
+            });
+        }
+        // Pattern: Factory Pattern
+        if (fileName.includes('factory') || fileName.includes('Factory')) {
+            decisions.push({
+                pattern: 'Factory Pattern',
+                evidence: [
+                    `File name contains "factory": ${fileName}`,
+                    `Module path: ${filePath}`
+                ],
+                confidence: 'high',
+                suggested_adr_title: `Factory Pattern: ${filePath}`,
+                existing_adrs: existingAdrNumbers
+            });
+        }
+        // Pattern: Service Layer
+        if (filePath.includes('/services/')) {
+            decisions.push({
+                pattern: 'Service Layer Pattern',
+                evidence: [
+                    `File in /services/ directory: ${filePath}`,
+                    `Dependencies: ${dependencies.length} dependencies`
+                ],
+                confidence: 'medium',
+                suggested_adr_title: `Service Layer: ${filePath}`,
+                existing_adrs: existingAdrNumbers
+            });
+        }
+        // Pattern: Layered Architecture (based on directory structure)
+        const layers = this.detectLayers(filePath);
+        if (layers.length > 0) {
+            decisions.push({
+                pattern: 'Layered Architecture',
+                evidence: [
+                    `Directory structure suggests layers: ${layers.join(' → ')}`,
+                    `File path: ${filePath}`
+                ],
+                confidence: 'medium',
+                suggested_adr_title: `Layered Architecture: ${layers.join(' → ')}`,
+                existing_adrs: existingAdrNumbers
+            });
+        }
+        return decisions;
+    }
+    /**
+     * Recognizes system-wide patterns.
+     */
+    recognizeSystemPatterns(modules, allAdrs) {
+        const decisions = [];
+        // Count patterns across all modules
+        const repositoryCount = modules.filter(m => m.file_path.includes('repository') || m.file_path.includes('Repository')).length;
+        const apiCount = modules.filter(m => m.file_path.includes('/api/')).length;
+        const serviceCount = modules.filter(m => m.file_path.includes('/services/')).length;
+        // System-wide: Repository Pattern
+        if (repositoryCount > 0) {
+            decisions.push({
+                pattern: 'Repository Pattern (System-wide)',
+                evidence: [
+                    `${repositoryCount} modules with "repository" in name/path`,
+                    `Pattern used consistently across system`
+                ],
+                confidence: repositoryCount >= 3 ? 'high' : 'medium',
+                suggested_adr_title: 'Repository Pattern - System-wide Implementation',
+                existing_adrs: this.findRelevantAdrs(allAdrs, 'repository')
+            });
+        }
+        // System-wide: API Layer
+        if (apiCount > 0) {
+            decisions.push({
+                pattern: 'API Layer Pattern (System-wide)',
+                evidence: [
+                    `${apiCount} modules in /api/ directory`,
+                    `Clear separation of API layer`
+                ],
+                confidence: apiCount >= 3 ? 'high' : 'medium',
+                suggested_adr_title: 'API Layer - System-wide Architecture',
+                existing_adrs: this.findRelevantAdrs(allAdrs, 'api')
+            });
+        }
+        // System-wide: Service Layer
+        if (serviceCount > 0) {
+            decisions.push({
+                pattern: 'Service Layer Pattern (System-wide)',
+                evidence: [
+                    `${serviceCount} modules in /services/ directory`,
+                    `Business logic separated from API layer`
+                ],
+                confidence: serviceCount >= 3 ? 'high' : 'medium',
+                suggested_adr_title: 'Service Layer - System-wide Architecture',
+                existing_adrs: this.findRelevantAdrs(allAdrs, 'service')
+            });
+        }
+        // Detect layered architecture
+        const layerStructure = this.detectSystemLayers(modules);
+        if (layerStructure.layers.length > 0) {
+            decisions.push({
+                pattern: 'Layered Architecture (System-wide)',
+                evidence: [
+                    `Detected layers: ${layerStructure.layers.join(' → ')}`,
+                    `${layerStructure.moduleCount} modules follow this structure`
+                ],
+                confidence: layerStructure.moduleCount >= 10 ? 'high' : 'medium',
+                suggested_adr_title: 'Layered Architecture - System Structure',
+                existing_adrs: this.findRelevantAdrs(allAdrs, 'layer')
+            });
+        }
+        return decisions;
+    }
+    /**
+     * Detects layers from file path.
+     */
+    detectLayers(filePath) {
+        const layers = [];
+        const pathParts = filePath.split('/');
+        // Common layer patterns
+        if (pathParts.includes('core'))
+            layers.push('Core');
+        if (pathParts.includes('api'))
+            layers.push('API');
+        if (pathParts.includes('services'))
+            layers.push('Services');
+        if (pathParts.includes('repositories'))
+            layers.push('Repositories');
+        if (pathParts.includes('models'))
+            layers.push('Models');
+        if (pathParts.includes('ui'))
+            layers.push('UI');
+        if (pathParts.includes('mcp'))
+            layers.push('MCP');
+        return layers;
+    }
+    /**
+     * Detects system-wide layer structure.
+     */
+    detectSystemLayers(modules) {
+        const layerCounts = new Map();
+        for (const module of modules) {
+            const layers = this.detectLayers(module.file_path);
+            for (const layer of layers) {
+                layerCounts.set(layer, (layerCounts.get(layer) || 0) + 1);
+            }
+        }
+        // Sort by count and return top layers
+        const sortedLayers = Array.from(layerCounts.entries())
+            .sort((a, b) => b[1] - a[1])
+            .map(([layer]) => layer);
+        return {
+            layers: sortedLayers,
+            moduleCount: modules.length
+        };
+    }
+    /**
+     * Finds relevant ADRs by searching titles and content.
+     */
+    findRelevantAdrs(allAdrs, keyword) {
+        return allAdrs
+            .filter(adr => adr.title.toLowerCase().includes(keyword.toLowerCase()) ||
+            adr.content_markdown.toLowerCase().includes(keyword.toLowerCase()))
+            .map(adr => adr.adr_number);
+    }
+}
+exports.ArchitectureMiningTool = ArchitectureMiningTool;
+//# sourceMappingURL=architecture-mining.js.map

package/out/mcp/tools/architecture-mining.js.map

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

package/out/mcp/tools/bootstrap.d.ts

@@ -0,0 +1,9 @@
+import { MultiDbManager } from '../../core/multi-db-manager';
+/**
+ * Executes bootstrap tool.
+ * Returns bootstrap information for first-time system understanding.
+ */
+export declare function executeBootstrap(args: {
+    pluginId: string;
+}, dbManager: MultiDbManager): Promise<string>;
+//# sourceMappingURL=bootstrap.d.ts.map

package/out/mcp/tools/bootstrap.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bootstrap.d.ts","sourceRoot":"","sources":["../../../src/mcp/tools/bootstrap.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAG7D;;;GAGG;AACH,wBAAsB,gBAAgB,CAClC,IAAI,EAAE;IAAE,QAAQ,EAAE,MAAM,CAAA;CAAE,EAC1B,SAAS,EAAE,cAAc,GAC1B,OAAO,CAAC,MAAM,CAAC,CAIjB"}

package/out/mcp/tools/bootstrap.js

@@ -0,0 +1,14 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.executeBootstrap = executeBootstrap;
+const bootstrap_api_1 = require("../../api/bootstrap-api");
+/**
+ * Executes bootstrap tool.
+ * Returns bootstrap information for first-time system understanding.
+ */
+async function executeBootstrap(args, dbManager) {
+    const bootstrapApi = new bootstrap_api_1.BootstrapApi(dbManager);
+    const bootstrap = await bootstrapApi.getBootstrapInfo(args.pluginId);
+    return JSON.stringify(bootstrap, null, 2);
+}
+//# sourceMappingURL=bootstrap.js.map

package/out/mcp/tools/bootstrap.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bootstrap.js","sourceRoot":"","sources":["../../../src/mcp/tools/bootstrap.ts"],"names":[],"mappings":";;AAOA,4CAOC;AAbD,2DAAuD;AAEvD;;;GAGG;AACI,KAAK,UAAU,gBAAgB,CAClC,IAA0B,EAC1B,SAAyB;IAEzB,MAAM,YAAY,GAAG,IAAI,4BAAY,CAAC,SAAS,CAAC,CAAC;IACjD,MAAM,SAAS,GAAG,MAAM,YAAY,CAAC,gBAAgB,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IACrE,OAAO,IAAI,CAAC,SAAS,CAAC,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;AAC9C,CAAC"}

package/out/mcp/tools/cross-analysis.d.ts

@@ -0,0 +1,18 @@
+import { MultiDbManager } from '../../core/multi-db-manager';
+import { IdMapper } from '../../core/id-mapper';
+/**
+ * MCP Tool: cross_analysis
+ * Performs cross-dimension analysis
+ */
+export declare class CrossAnalysisTool {
+    private crossDimensionApi;
+    constructor(dbManager: MultiDbManager, idMapper: IdMapper);
+    /**
+     * Executes the cross_analysis tool.
+     */
+    execute(args: {
+        filePath: string;
+        pluginId: string;
+    }): Promise<string>;
+}
+//# sourceMappingURL=cross-analysis.d.ts.map

package/out/mcp/tools/cross-analysis.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cross-analysis.d.ts","sourceRoot":"","sources":["../../../src/mcp/tools/cross-analysis.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAC7D,OAAO,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAEhD;;;GAGG;AACH,qBAAa,iBAAiB;IAC1B,OAAO,CAAC,iBAAiB,CAAoB;gBAEjC,SAAS,EAAE,cAAc,EAAE,QAAQ,EAAE,QAAQ;IAIzD;;OAEG;IACU,OAAO,CAAC,IAAI,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,MAAM,CAAC;CAKtF"}

package/out/mcp/tools/cross-analysis.js

@@ -0,0 +1,23 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CrossAnalysisTool = void 0;
+const cross_dimension_api_1 = require("../../api/cross-dimension-api");
+/**
+ * MCP Tool: cross_analysis
+ * Performs cross-dimension analysis
+ */
+class CrossAnalysisTool {
+    constructor(dbManager, idMapper) {
+        this.crossDimensionApi = new cross_dimension_api_1.CrossDimensionApi(dbManager, idMapper);
+    }
+    /**
+     * Executes the cross_analysis tool.
+     */
+    async execute(args) {
+        const adrs = await this.crossDimensionApi.getAdrsForFilePath(args.filePath, args.pluginId);
+        const symbols = await this.crossDimensionApi.getSymbolsForModule(args.filePath, args.pluginId);
+        return JSON.stringify({ adrs, symbols }, null, 2);
+    }
+}
+exports.CrossAnalysisTool = CrossAnalysisTool;
+//# sourceMappingURL=cross-analysis.js.map

package/out/mcp/tools/cross-analysis.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cross-analysis.js","sourceRoot":"","sources":["../../../src/mcp/tools/cross-analysis.ts"],"names":[],"mappings":";;;AAAA,uEAAkE;AAIlE;;;GAGG;AACH,MAAa,iBAAiB;IAG1B,YAAY,SAAyB,EAAE,QAAkB;QACrD,IAAI,CAAC,iBAAiB,GAAG,IAAI,uCAAiB,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;IACxE,CAAC;IAED;;OAEG;IACI,KAAK,CAAC,OAAO,CAAC,IAA4C;QAC7D,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,iBAAiB,CAAC,kBAAkB,CAAC,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC,QAAQ,CAAC,CAAC;QAC3F,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,iBAAiB,CAAC,mBAAmB,CAAC,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC,QAAQ,CAAC,CAAC;QAC/F,OAAO,IAAI,CAAC,SAAS,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;IACtD,CAAC;CACJ;AAfD,8CAeC"}

package/out/mcp/tools/gap-analysis.d.ts

@@ -0,0 +1,34 @@
+import { MultiDbManager } from '../../core/multi-db-manager';
+import { IdMapper } from '../../core/id-mapper';
+/**
+ * MCP Tool: gap_analysis
+ * Finds documentation gaps by analyzing modules with many dependencies but few/no ADRs.
+ */
+export declare class GapAnalysisTool {
+    private crossDimensionApi;
+    constructor(dbManager: MultiDbManager, idMapper: IdMapper);
+    /**
+     * Executes the gap_analysis tool.
+     *
+     * @param args Arguments: minDependencies (default: 5), pluginId
+     * @returns JSON string with gap analysis results
+     */
+    execute(args: {
+        minDependencies?: number;
+        pluginId: string;
+        limit?: number;
+    }): Promise<string>;
+    /**
+     * Calculates a gap score for prioritization.
+     * Higher score = more urgent to document.
+     *
+     * Formula: (dependency_count * 2) - (adr_count * 10)
+     * This prioritizes modules with many dependencies but few ADRs.
+     */
+    private calculateGapScore;
+    /**
+     * Generates recommendations based on gaps.
+     */
+    private generateRecommendations;
+}
+//# sourceMappingURL=gap-analysis.d.ts.map

package/out/mcp/tools/gap-analysis.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gap-analysis.d.ts","sourceRoot":"","sources":["../../../src/mcp/tools/gap-analysis.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAE7D,OAAO,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAEhD;;;GAGG;AACH,qBAAa,eAAe;IACxB,OAAO,CAAC,iBAAiB,CAAoB;gBAEjC,SAAS,EAAE,cAAc,EAAE,QAAQ,EAAE,QAAQ;IAIzD;;;;;OAKG;IACU,OAAO,CAAC,IAAI,EAAE;QACvB,eAAe,CAAC,EAAE,MAAM,CAAC;QACzB,QAAQ,EAAE,MAAM,CAAC;QACjB,KAAK,CAAC,EAAE,MAAM,CAAC;KAClB,GAAG,OAAO,CAAC,MAAM,CAAC;IA2DnB;;;;;;OAMG;IACH,OAAO,CAAC,iBAAiB;IAIzB;;OAEG;IACH,OAAO,CAAC,uBAAuB;CAkClC"}

package/out/mcp/tools/gap-analysis.js

@@ -0,0 +1,106 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.GapAnalysisTool = void 0;
+const cross_dimension_api_1 = require("../../api/cross-dimension-api");
+/**
+ * MCP Tool: gap_analysis
+ * Finds documentation gaps by analyzing modules with many dependencies but few/no ADRs.
+ */
+class GapAnalysisTool {
+    constructor(dbManager, idMapper) {
+        this.crossDimensionApi = new cross_dimension_api_1.CrossDimensionApi(dbManager, idMapper);
+    }
+    /**
+     * Executes the gap_analysis tool.
+     *
+     * @param args Arguments: minDependencies (default: 5), pluginId
+     * @returns JSON string with gap analysis results
+     */
+    async execute(args) {
+        const minDeps = args.minDependencies || 5;
+        const limit = args.limit || 50;
+        // Build architectural view (combines X, W, Z dimensions)
+        const architecturalView = await this.crossDimensionApi.buildArchitecturalView(args.pluginId);
+        // Analyze gaps
+        const gaps = architecturalView
+            .filter(view => view.dependencies.length >= minDeps)
+            .map(view => ({
+            module: {
+                file_path: view.module.file_path,
+                content_hash: view.module.content_hash
+            },
+            dependency_count: view.dependencies.length,
+            adr_count: view.adrs.length,
+            adr_numbers: view.adrs.map(adr => adr.adr_number),
+            gap_score: this.calculateGapScore(view.dependencies.length, view.adrs.length),
+            has_adrs: view.adrs.length > 0
+        }))
+            .sort((a, b) => b.gap_score - a.gap_score) // Highest gap score first
+            .slice(0, limit);
+        // Separate into categories
+        const withoutAdrs = gaps.filter(g => !g.has_adrs);
+        const withFewAdrs = gaps.filter(g => g.has_adrs && g.adr_count < 2);
+        const wellDocumented = gaps.filter(g => g.has_adrs && g.adr_count >= 2);
+        // Calculate statistics
+        const stats = {
+            total_modules_analyzed: architecturalView.length,
+            modules_with_many_deps: gaps.length,
+            modules_without_adrs: withoutAdrs.length,
+            modules_with_few_adrs: withFewAdrs.length,
+            well_documented_modules: wellDocumented.length,
+            avg_dependencies: gaps.length > 0
+                ? Math.round(gaps.reduce((sum, g) => sum + g.dependency_count, 0) / gaps.length)
+                : 0,
+            avg_adrs: gaps.length > 0 && gaps.filter(g => g.has_adrs).length > 0
+                ? Math.round(gaps.filter(g => g.has_adrs).reduce((sum, g) => sum + g.adr_count, 0) / gaps.filter(g => g.has_adrs).length)
+                : 0
+        };
+        return JSON.stringify({
+            summary: {
+                min_dependencies_threshold: minDeps,
+                analysis_date: new Date().toISOString(),
+                statistics: stats
+            },
+            gaps: {
+                without_adrs: withoutAdrs,
+                with_few_adrs: withFewAdrs,
+                well_documented: wellDocumented
+            },
+            recommendations: this.generateRecommendations(withoutAdrs, withFewAdrs)
+        }, null, 2);
+    }
+    /**
+     * Calculates a gap score for prioritization.
+     * Higher score = more urgent to document.
+     *
+     * Formula: (dependency_count * 2) - (adr_count * 10)
+     * This prioritizes modules with many dependencies but few ADRs.
+     */
+    calculateGapScore(dependencyCount, adrCount) {
+        return (dependencyCount * 2) - (adrCount * 10);
+    }
+    /**
+     * Generates recommendations based on gaps.
+     */
+    generateRecommendations(withoutAdrs, withFewAdrs) {
+        const recommendations = [];
+        if (withoutAdrs.length > 0) {
+            recommendations.push(`🚨 ${withoutAdrs.length} Module ohne ADRs identifiziert. Diese sollten priorisiert werden:`);
+            withoutAdrs.slice(0, 5).forEach((gap, index) => {
+                recommendations.push(`   ${index + 1}. ${gap.module.file_path} (${gap.dependency_count} Dependencies, Gap-Score: ${gap.gap_score})`);
+            });
+        }
+        if (withFewAdrs.length > 0) {
+            recommendations.push(`⚠️  ${withFewAdrs.length} Module mit nur wenigen ADRs. Erwägen Sie zusätzliche Dokumentation:`);
+            withFewAdrs.slice(0, 3).forEach((gap, index) => {
+                recommendations.push(`   ${index + 1}. ${gap.module.file_path} (${gap.dependency_count} Dependencies, ${gap.adr_count} ADR(s))`);
+            });
+        }
+        if (recommendations.length === 0) {
+            recommendations.push('✅ Alle Module mit vielen Dependencies sind gut dokumentiert!');
+        }
+        return recommendations;
+    }
+}
+exports.GapAnalysisTool = GapAnalysisTool;
+//# sourceMappingURL=gap-analysis.js.map

package/out/mcp/tools/gap-analysis.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"gap-analysis.js","sourceRoot":"","sources":["../../../src/mcp/tools/gap-analysis.ts"],"names":[],"mappings":"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"}

package/out/mcp/tools/learning-path.d.ts

@@ -0,0 +1,10 @@
+import { MultiDbManager } from '../../core/multi-db-manager';
+/**
+ * Executes learning path tool.
+ * Generates guided learning path for understanding a topic.
+ */
+export declare function executeLearningPath(args: {
+    topic: string;
+    pluginId: string;
+}, dbManager: MultiDbManager): Promise<string>;
+//# sourceMappingURL=learning-path.d.ts.map

package/out/mcp/tools/learning-path.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"learning-path.d.ts","sourceRoot":"","sources":["../../../src/mcp/tools/learning-path.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAK7D;;;GAGG;AACH,wBAAsB,mBAAmB,CACrC,IAAI,EAAE;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,EACzC,SAAS,EAAE,cAAc,GAC1B,OAAO,CAAC,MAAM,CAAC,CAOjB"}

package/out/mcp/tools/learning-path.js

@@ -0,0 +1,18 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.executeLearningPath = executeLearningPath;
+const semantic_search_api_1 = require("../../api/semantic-search-api");
+const learning_path_api_1 = require("../../api/learning-path-api");
+const embedding_generator_1 = require("../../embedding/embedding-generator");
+/**
+ * Executes learning path tool.
+ * Generates guided learning path for understanding a topic.
+ */
+async function executeLearningPath(args, dbManager) {
+    const embeddingGenerator = new embedding_generator_1.EmbeddingGenerator();
+    const semanticSearchApi = new semantic_search_api_1.SemanticSearchApi(dbManager, embeddingGenerator);
+    const learningPathApi = new learning_path_api_1.LearningPathApi(dbManager, semanticSearchApi);
+    const path = await learningPathApi.generateLearningPath(args.topic, args.pluginId);
+    return JSON.stringify(path, null, 2);
+}
+//# sourceMappingURL=learning-path.js.map

package/out/mcp/tools/learning-path.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"learning-path.js","sourceRoot":"","sources":["../../../src/mcp/tools/learning-path.ts"],"names":[],"mappings":";;AASA,kDAUC;AAlBD,uEAAkE;AAClE,mEAA8D;AAC9D,6EAAyE;AAEzE;;;GAGG;AACI,KAAK,UAAU,mBAAmB,CACrC,IAAyC,EACzC,SAAyB;IAEzB,MAAM,kBAAkB,GAAG,IAAI,wCAAkB,EAAE,CAAC;IACpD,MAAM,iBAAiB,GAAG,IAAI,uCAAiB,CAAC,SAAS,EAAE,kBAAkB,CAAC,CAAC;IAC/E,MAAM,eAAe,GAAG,IAAI,mCAAe,CAAC,SAAS,EAAE,iBAAiB,CAAC,CAAC;IAE1E,MAAM,IAAI,GAAG,MAAM,eAAe,CAAC,oBAAoB,CAAC,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC,QAAQ,CAAC,CAAC;IACnF,OAAO,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;AACzC,CAAC"}

package/out/mcp/tools/query-dependencies.d.ts

@@ -0,0 +1,18 @@
+import { MultiDbManager } from '../../core/multi-db-manager';
+/**
+ * MCP Tool: query_dependencies
+ * Queries dependencies by module
+ */
+export declare class QueryDependenciesTool {
+    private dependencyApi;
+    constructor(dbManager: MultiDbManager);
+    /**
+     * Executes the query_dependencies tool.
+     */
+    execute(args: {
+        fromModule?: string;
+        toModule?: string;
+        pluginId: string;
+    }): Promise<string>;
+}
+//# sourceMappingURL=query-dependencies.d.ts.map

package/out/mcp/tools/query-dependencies.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"query-dependencies.d.ts","sourceRoot":"","sources":["../../../src/mcp/tools/query-dependencies.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAE7D;;;GAGG;AACH,qBAAa,qBAAqB;IAC9B,OAAO,CAAC,aAAa,CAAgB;gBAEzB,SAAS,EAAE,cAAc;IAIrC;;OAEG;IACU,OAAO,CAAC,IAAI,EAAE;QAAE,UAAU,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,MAAM,CAAC;CAW5G"}

package/out/mcp/tools/query-dependencies.js

@@ -0,0 +1,31 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.QueryDependenciesTool = void 0;
+const dependency_api_1 = require("../../api/dependency-api");
+/**
+ * MCP Tool: query_dependencies
+ * Queries dependencies by module
+ */
+class QueryDependenciesTool {
+    constructor(dbManager) {
+        this.dependencyApi = new dependency_api_1.DependencyApi(dbManager);
+    }
+    /**
+     * Executes the query_dependencies tool.
+     */
+    async execute(args) {
+        let dependencies;
+        if (args.fromModule) {
+            dependencies = await this.dependencyApi.getDependenciesByFromModule(args.fromModule, args.pluginId);
+        }
+        else if (args.toModule) {
+            dependencies = await this.dependencyApi.getDependenciesByToModule(args.toModule, args.pluginId);
+        }
+        else {
+            dependencies = await this.dependencyApi.getAllDependencies(args.pluginId);
+        }
+        return JSON.stringify(dependencies, null, 2);
+    }
+}
+exports.QueryDependenciesTool = QueryDependenciesTool;
+//# sourceMappingURL=query-dependencies.js.map

package/out/mcp/tools/query-dependencies.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"query-dependencies.js","sourceRoot":"","sources":["../../../src/mcp/tools/query-dependencies.ts"],"names":[],"mappings":";;;AAAA,6DAAyD;AAGzD;;;GAGG;AACH,MAAa,qBAAqB;IAG9B,YAAY,SAAyB;QACjC,IAAI,CAAC,aAAa,GAAG,IAAI,8BAAa,CAAC,SAAS,CAAC,CAAC;IACtD,CAAC;IAED;;OAEG;IACI,KAAK,CAAC,OAAO,CAAC,IAAkE;QACnF,IAAI,YAAY,CAAC;QACjB,IAAI,IAAI,CAAC,UAAU,EAAE,CAAC;YAClB,YAAY,GAAG,MAAM,IAAI,CAAC,aAAa,CAAC,2BAA2B,CAAC,IAAI,CAAC,UAAU,EAAE,IAAI,CAAC,QAAQ,CAAC,CAAC;QACxG,CAAC;aAAM,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;YACvB,YAAY,GAAG,MAAM,IAAI,CAAC,aAAa,CAAC,yBAAyB,CAAC,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC,QAAQ,CAAC,CAAC;QACpG,CAAC;aAAM,CAAC;YACJ,YAAY,GAAG,MAAM,IAAI,CAAC,aAAa,CAAC,kBAAkB,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QAC9E,CAAC;QACD,OAAO,IAAI,CAAC,SAAS,CAAC,YAAY,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;IACjD,CAAC;CACJ;AArBD,sDAqBC"}

package/out/mcp/tools/query-modules.d.ts

@@ -0,0 +1,17 @@
+import { MultiDbManager } from '../../core/multi-db-manager';
+/**
+ * MCP Tool: query_modules
+ * Queries modules by file path
+ */
+export declare class QueryModulesTool {
+    private moduleApi;
+    constructor(dbManager: MultiDbManager);
+    /**
+     * Executes the query_modules tool.
+     */
+    execute(args: {
+        filePath: string;
+        pluginId: string;
+    }): Promise<string>;
+}
+//# sourceMappingURL=query-modules.d.ts.map