mcp-adr-analysis-server 2.7.30 → 2.7.31

package/dist/src/resources/architectural-context-resource.js

@@ -1,428 +0,0 @@
-/**
- * Architectural Context Resource - Current architectural state and decisions
- * URI Pattern: adr://architecture/context
- */
-import { McpAdrError } from '../types/index.js';
-import { resourceCache, generateETag } from './resource-cache.js';
-import { resourceRouter } from './resource-router.js';
-/**
- * Generate architectural context resource showing current state and decisions.
- *
- * Returns a comprehensive view of the project's architectural state:
- * - Summary of all ADRs by status
- * - Technology stack analysis
- * - Architectural patterns in use
- * - Recommendations for improvements
- *
- * **URI Pattern:** `adr://architecture/context`
- *
- * **Query Parameters:**
- * - `projectPath`: Override project root path (default: process.cwd())
- * - `includeDeprecated`: Include deprecated decisions (default: true)
- * - `includeProposed`: Include proposed decisions (default: true)
- * - `maxDecisions`: Maximum decisions to return (default: 50)
- *
- * @param params - URL path parameters (none for this resource)
- * @param searchParams - URL query parameters for customization
- * @param kgManager - Optional knowledge graph manager instance
- *
- * @returns Promise resolving to resource generation result containing:
- *   - data: Complete architectural context data
- *   - contentType: "application/json"
- *   - lastModified: ISO timestamp of generation
- *   - cacheKey: Unique identifier "architectural-context"
- *   - ttl: Cache duration (300 seconds / 5 minutes)
- *   - etag: Entity tag for cache validation
- *
- * @throws {McpAdrError} When context generation fails
- *
- * @example
- * ```typescript
- * // Get full architectural context
- * const context = await generateArchitecturalContextResource(
- *   {},
- *   new URLSearchParams()
- * );
- *
- * console.log(`Total ADRs: ${context.data.summary.totalAdrs}`);
- * console.log(`Technologies: ${context.data.summary.technologiesUsed.join(', ')}`);
- *
- * // Exclude deprecated decisions
- * const active = await generateArchitecturalContextResource(
- *   {},
- *   new URLSearchParams('includeDeprecated=false')
- * );
- * ```
- *
- * @since v2.2.0
- * @see {@link KnowledgeGraphManager} for knowledge graph queries
- */
-export async function generateArchitecturalContextResource(_params, searchParams, kgManager) {
-    const projectPath = searchParams.get('projectPath') || process.cwd();
-    const includeDeprecated = searchParams.get('includeDeprecated') !== 'false';
-    const includeProposed = searchParams.get('includeProposed') !== 'false';
-    const maxDecisions = parseInt(searchParams.get('maxDecisions') || '50', 10);
-    const cacheKey = 'architectural-context';
-    // Check cache
-    const cached = await resourceCache.get(cacheKey);
-    if (cached) {
-        return cached;
-    }
-    try {
-        // Discover ADRs to build context
-        const { discoverAdrsInDirectory } = await import('../utils/adr-discovery.js');
-        const pathModule = await import('path');
-        const adrDirectory = pathModule.resolve(projectPath, process.env['ADR_DIRECTORY'] || 'docs/adrs');
-        const discoveryResult = await discoverAdrsInDirectory(adrDirectory, projectPath, {
-            includeContent: true,
-            includeTimeline: false,
-        });
-        // Categorize ADRs by status
-        const statusCounts = {
-            accepted: 0,
-            deprecated: 0,
-            proposed: 0,
-            superseded: 0,
-            unknown: 0,
-        };
-        const technologies = new Set();
-        const patterns = new Set();
-        const decisions = [];
-        for (const adr of discoveryResult.adrs) {
-            const status = (adr.status || 'unknown').toLowerCase();
-            if (status in statusCounts) {
-                statusCounts[status]++;
-            }
-            else {
-                statusCounts.unknown++;
-            }
-            // Skip deprecated if not requested
-            if (!includeDeprecated && status === 'deprecated')
-                continue;
-            if (!includeProposed && status === 'proposed')
-                continue;
-            // Extract technologies from content
-            const content = `${adr.context || ''} ${adr.decision || ''} ${adr.consequences || ''}`;
-            extractTechnologies(content, technologies);
-            extractPatterns(content, patterns);
-            // Add to decisions list
-            if (decisions.length < maxDecisions) {
-                decisions.push({
-                    id: adr.filename.replace(/\.md$/, ''),
-                    title: adr.title || 'Untitled',
-                    status: adr.status || 'unknown',
-                    category: categorizeAdr(adr.title || '', content),
-                    impact: determineImpact(content),
-                    dependencies: extractDependencies(content),
-                });
-            }
-        }
-        // Build technology stack
-        const technologyStack = categorizeTechnologies([...technologies]);
-        // Build patterns list
-        const patternsList = [...patterns].map(pattern => ({
-            name: pattern,
-            description: getPatternDescription(pattern),
-            usedIn: findPatternUsage(pattern, discoveryResult.adrs),
-            relatedAdrs: findRelatedAdrs(pattern, discoveryResult.adrs),
-        }));
-        // Generate recommendations
-        const recommendations = generateRecommendations(discoveryResult.adrs, statusCounts, [
-            ...technologies,
-        ]);
-        // Get additional context from knowledge graph if available
-        if (kgManager) {
-            try {
-                const kg = await kgManager.loadKnowledgeGraph();
-                if (kg && kg.intents) {
-                    // Extract technologies and patterns from intent goals
-                    kg.intents.forEach((intent) => {
-                        if (intent.parsedGoals) {
-                            intent.parsedGoals.forEach((goal) => {
-                                // Simple heuristic to extract tech/pattern mentions
-                                const lowerGoal = goal.toLowerCase();
-                                if (lowerGoal.includes('technology') || lowerGoal.includes('framework')) {
-                                    // Could extract specific technologies here
-                                }
-                            });
-                        }
-                    });
-                }
-            }
-            catch {
-                // Knowledge graph not available
-            }
-        }
-        const contextData = {
-            summary: {
-                totalAdrs: discoveryResult.totalAdrs,
-                activeDecisions: statusCounts.accepted,
-                deprecatedDecisions: statusCounts.deprecated,
-                proposedDecisions: statusCounts.proposed,
-                technologiesUsed: [...technologies].sort(),
-                architecturalPatterns: [...patterns].sort(),
-            },
-            decisions,
-            technologyStack,
-            patterns: patternsList,
-            recommendations,
-            timestamp: new Date().toISOString(),
-            projectPath,
-        };
-        const result = {
-            data: contextData,
-            contentType: 'application/json',
-            lastModified: new Date().toISOString(),
-            cacheKey,
-            ttl: 300, // 5 minutes cache
-            etag: generateETag(contextData),
-        };
-        // Cache result
-        resourceCache.set(cacheKey, result, result.ttl);
-        return result;
-    }
-    catch (error) {
-        throw new McpAdrError(`Failed to generate architectural context: ${error instanceof Error ? error.message : String(error)}`, 'RESOURCE_GENERATION_ERROR');
-    }
-}
-/**
- * Extract technologies from content
- */
-function extractTechnologies(content, technologies) {
-    const techPatterns = [
-        /\b(React|Vue|Angular|Svelte|Next\.js|Nuxt|Gatsby)\b/gi,
-        /\b(Node\.js|Express|Fastify|NestJS|Koa)\b/gi,
-        /\b(Python|Django|Flask|FastAPI)\b/gi,
-        /\b(PostgreSQL|MySQL|MongoDB|Redis|Elasticsearch)\b/gi,
-        /\b(Docker|Kubernetes|AWS|Azure|GCP)\b/gi,
-        /\b(Terraform|Ansible|Jenkins|GitHub Actions)\b/gi,
-        /\b(GraphQL|REST|gRPC|WebSocket)\b/gi,
-        /\b(TypeScript|JavaScript|Java|Go|Rust)\b/gi,
-    ];
-    techPatterns.forEach(pattern => {
-        const matches = content.match(pattern);
-        if (matches) {
-            matches.forEach(match => technologies.add(match));
-        }
-    });
-}
-/**
- * Extract architectural patterns from content
- */
-function extractPatterns(content, patterns) {
-    const patternKeywords = [
-        'microservices',
-        'monolith',
-        'event-driven',
-        'cqrs',
-        'event sourcing',
-        'hexagonal',
-        'clean architecture',
-        'mvc',
-        'mvvm',
-        'repository pattern',
-        'service layer',
-        'domain-driven',
-        'api gateway',
-        'saga pattern',
-        'circuit breaker',
-    ];
-    const lowerContent = content.toLowerCase();
-    patternKeywords.forEach(pattern => {
-        if (lowerContent.includes(pattern)) {
-            patterns.add(pattern
-                .split(' ')
-                .map(w => w.charAt(0).toUpperCase() + w.slice(1))
-                .join(' '));
-        }
-    });
-}
-/**
- * Categorize an ADR based on its title and content
- */
-function categorizeAdr(title, content) {
-    const lowerTitle = title.toLowerCase();
-    const lowerContent = content.toLowerCase();
-    if (lowerTitle.includes('database') || lowerContent.includes('database'))
-        return 'data';
-    if (lowerTitle.includes('api') || lowerContent.includes('api endpoint'))
-        return 'api';
-    if (lowerTitle.includes('auth') || lowerContent.includes('authentication'))
-        return 'security';
-    if (lowerTitle.includes('deploy') || lowerContent.includes('deployment'))
-        return 'infrastructure';
-    if (lowerTitle.includes('test') || lowerContent.includes('testing'))
-        return 'testing';
-    if (lowerTitle.includes('ui') || lowerTitle.includes('frontend'))
-        return 'frontend';
-    if (lowerTitle.includes('backend') || lowerTitle.includes('service'))
-        return 'backend';
-    return 'general';
-}
-/**
- * Determine impact level of an ADR
- */
-function determineImpact(content) {
-    const lowerContent = content.toLowerCase();
-    // High impact indicators
-    if (lowerContent.includes('critical') ||
-        lowerContent.includes('breaking change') ||
-        lowerContent.includes('major refactor') ||
-        lowerContent.includes('security vulnerability')) {
-        return 'high';
-    }
-    // Low impact indicators
-    if (lowerContent.includes('minor') ||
-        lowerContent.includes('small change') ||
-        lowerContent.includes('optimization')) {
-        return 'low';
-    }
-    return 'medium';
-}
-/**
- * Extract dependencies from content
- */
-function extractDependencies(content) {
-    const deps = [];
-    const depMatch = content.match(/ADR[-\s]?(\d+)/gi);
-    if (depMatch) {
-        depMatch.forEach(match => {
-            const id = match.replace(/ADR[-\s]?/i, '');
-            deps.push(`adr-${id.padStart(3, '0')}`);
-        });
-    }
-    return [...new Set(deps)];
-}
-/**
- * Categorize technologies into stack layers
- */
-function categorizeTechnologies(techs) {
-    const stack = {
-        frontend: [],
-        backend: [],
-        database: [],
-        infrastructure: [],
-        devops: [],
-    };
-    const categories = {
-        React: 'frontend',
-        Vue: 'frontend',
-        Angular: 'frontend',
-        Svelte: 'frontend',
-        'Next.js': 'frontend',
-        Nuxt: 'frontend',
-        TypeScript: 'frontend',
-        JavaScript: 'frontend',
-        'Node.js': 'backend',
-        Express: 'backend',
-        Fastify: 'backend',
-        NestJS: 'backend',
-        Python: 'backend',
-        Django: 'backend',
-        Flask: 'backend',
-        FastAPI: 'backend',
-        Java: 'backend',
-        Go: 'backend',
-        Rust: 'backend',
-        PostgreSQL: 'database',
-        MySQL: 'database',
-        MongoDB: 'database',
-        Redis: 'database',
-        Elasticsearch: 'database',
-        Docker: 'infrastructure',
-        Kubernetes: 'infrastructure',
-        AWS: 'infrastructure',
-        Azure: 'infrastructure',
-        GCP: 'infrastructure',
-        Terraform: 'devops',
-        Ansible: 'devops',
-        Jenkins: 'devops',
-        'GitHub Actions': 'devops',
-    };
-    techs.forEach(tech => {
-        const category = categories[tech];
-        if (category && !stack[category].includes(tech)) {
-            stack[category].push(tech);
-        }
-    });
-    return stack;
-}
-/**
- * Get description for a pattern
- */
-function getPatternDescription(pattern) {
-    const descriptions = {
-        Microservices: 'Distributed architecture with independently deployable services',
-        Monolith: 'Single deployable unit containing all functionality',
-        'Event-driven': 'Asynchronous communication through events',
-        CQRS: 'Command Query Responsibility Segregation',
-        'Event Sourcing': 'Storing state as sequence of events',
-        Hexagonal: 'Ports and adapters architecture',
-        'Clean Architecture': 'Dependency rule with concentric layers',
-        MVC: 'Model-View-Controller pattern',
-        MVVM: 'Model-View-ViewModel pattern',
-        'Repository Pattern': 'Abstraction layer for data access',
-        'Service Layer': 'Business logic encapsulation',
-        'Domain-driven': 'Design based on domain model',
-        'Api Gateway': 'Single entry point for microservices',
-        'Saga Pattern': 'Distributed transaction management',
-        'Circuit Breaker': 'Fault tolerance pattern',
-    };
-    return descriptions[pattern] || 'Architectural pattern';
-}
-/**
- * Find ADRs that use a pattern
- */
-function findPatternUsage(pattern, adrs) {
-    const lowerPattern = pattern.toLowerCase();
-    return adrs
-        .filter(adr => {
-        const content = `${adr.title || ''} ${adr.context || ''} ${adr.decision || ''}`.toLowerCase();
-        return content.includes(lowerPattern);
-    })
-        .map(adr => adr.filename.replace(/\.md$/, ''))
-        .slice(0, 5);
-}
-/**
- * Find ADRs related to a pattern
- */
-function findRelatedAdrs(pattern, adrs) {
-    return findPatternUsage(pattern, adrs);
-}
-/**
- * Generate recommendations based on analysis
- */
-function generateRecommendations(adrs, statusCounts, technologies) {
-    const recommendations = [];
-    // Check for proposed ADRs that need review
-    const proposedCount = statusCounts['proposed'] || 0;
-    if (proposedCount > 3) {
-        recommendations.push(`Review ${proposedCount} proposed ADRs for acceptance`);
-    }
-    // Check for missing documentation areas
-    const hasSecurityAdr = adrs.some(adr => (adr.title || '').toLowerCase().includes('security') ||
-        (adr.title || '').toLowerCase().includes('auth'));
-    if (!hasSecurityAdr) {
-        recommendations.push('Consider documenting security decisions in an ADR');
-    }
-    // Check for deprecated decisions
-    const deprecatedCount = statusCounts['deprecated'] || 0;
-    if (deprecatedCount > 0) {
-        recommendations.push(`Review ${deprecatedCount} deprecated ADRs for removal or updates`);
-    }
-    // Technology recommendations
-    if (technologies.length < 5) {
-        recommendations.push('Consider documenting technology choices in ADRs');
-    }
-    // General recommendation
-    if (adrs.length < 3) {
-        recommendations.push('Consider creating ADRs for key architectural decisions');
-    }
-    if (recommendations.length === 0) {
-        recommendations.push('Architectural documentation appears up-to-date');
-    }
-    return recommendations;
-}
-// Register route
-resourceRouter.register('/architecture/context', generateArchitecturalContextResource, 'Current architectural state and decisions');
-//# sourceMappingURL=architectural-context-resource.js.map

package/dist/src/resources/architectural-context-resource.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"architectural-context-resource.js","sourceRoot":"","sources":["../../../src/resources/architectural-context-resource.ts"],"names":[],"mappings":"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"}

package/dist/src/resources/memory-expand-resource.d.ts

@@ -1,90 +0,0 @@
-/**
- * Memory Expand Resource - Detailed view of a specific memory entity
- * URI Pattern: adr://memory/{key}
- */
-import { URLSearchParams } from 'url';
-import { ResourceGenerationResult } from './index.js';
-import type { MemoryEntityManager } from '../utils/memory-entity-manager.js';
-export interface MemoryExpandData {
-    key: string;
-    entity: {
-        id: string;
-        type: string;
-        name: string;
-        content: any;
-        metadata: Record<string, any>;
-        tags: string[];
-        confidence: number;
-        lastModified: string;
-        created: string;
-        accessCount: number;
-    } | null;
-    relationships: Array<{
-        targetId: string;
-        targetName: string;
-        relationshipType: string;
-        strength: number;
-    }>;
-    relatedEntities: Array<{
-        id: string;
-        name: string;
-        type: string;
-        relevance: number;
-    }>;
-    timestamp: string;
-    found: boolean;
-}
-/**
- * Generate memory expand resource showing detailed entity information.
- *
- * Returns complete details about a specific memory entity including:
- * - Full entity content and metadata
- * - All relationships to other entities
- * - Related entities by relevance
- * - Access statistics
- *
- * **URI Pattern:** `adr://memory/{key}`
- *
- * **Query Parameters:**
- * - `includeRelated`: Include related entities (default: true)
- * - `relationshipDepth`: Depth of relationships to traverse (default: 2)
- * - `maxRelated`: Maximum related entities to return (default: 10)
- *
- * @param params - URL path parameters containing:
- *   - key: Memory entity key/ID
- * @param searchParams - URL query parameters for customization
- * @param memoryManager - Optional memory entity manager instance
- *
- * @returns Promise resolving to resource generation result containing:
- *   - data: Complete memory entity data with relationships
- *   - contentType: "application/json"
- *   - lastModified: ISO timestamp of generation
- *   - cacheKey: Unique identifier "memory-expand:{key}"
- *   - ttl: Cache duration (60 seconds / 1 minute)
- *   - etag: Entity tag for cache validation
- *
- * @throws {McpAdrError} When memory expansion fails
- *
- * @example
- * ```typescript
- * // Get expanded memory entity
- * const memory = await generateMemoryExpandResource(
- *   { key: 'adr-001' },
- *   new URLSearchParams()
- * );
- *
- * console.log(`Entity type: ${memory.data.entity?.type}`);
- * console.log(`Relationships: ${memory.data.relationships.length}`);
- *
- * // With custom depth
- * const deep = await generateMemoryExpandResource(
- *   { key: 'architecture-context' },
- *   new URLSearchParams('relationshipDepth=3&maxRelated=20')
- * );
- * ```
- *
- * @since v2.2.0
- * @see {@link MemoryEntityManager} for memory management
- */
-export declare function generateMemoryExpandResource(params: Record<string, string>, searchParams: URLSearchParams, memoryManager?: MemoryEntityManager): Promise<ResourceGenerationResult>;
-//# sourceMappingURL=memory-expand-resource.d.ts.map

package/dist/src/resources/memory-expand-resource.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"memory-expand-resource.d.ts","sourceRoot":"","sources":["../../../src/resources/memory-expand-resource.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,eAAe,EAAE,MAAM,KAAK,CAAC;AAGtC,OAAO,EAAE,wBAAwB,EAAE,MAAM,YAAY,CAAC;AAEtD,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,mCAAmC,CAAC;AAE7E,MAAM,WAAW,gBAAgB;IAC/B,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE;QACN,EAAE,EAAE,MAAM,CAAC;QACX,IAAI,EAAE,MAAM,CAAC;QACb,IAAI,EAAE,MAAM,CAAC;QACb,OAAO,EAAE,GAAG,CAAC;QACb,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;QAC9B,IAAI,EAAE,MAAM,EAAE,CAAC;QACf,UAAU,EAAE,MAAM,CAAC;QACnB,YAAY,EAAE,MAAM,CAAC;QACrB,OAAO,EAAE,MAAM,CAAC;QAChB,WAAW,EAAE,MAAM,CAAC;KACrB,GAAG,IAAI,CAAC;IACT,aAAa,EAAE,KAAK,CAAC;QACnB,QAAQ,EAAE,MAAM,CAAC;QACjB,UAAU,EAAE,MAAM,CAAC;QACnB,gBAAgB,EAAE,MAAM,CAAC;QACzB,QAAQ,EAAE,MAAM,CAAC;KAClB,CAAC,CAAC;IACH,eAAe,EAAE,KAAK,CAAC;QACrB,EAAE,EAAE,MAAM,CAAC;QACX,IAAI,EAAE,MAAM,CAAC;QACb,IAAI,EAAE,MAAM,CAAC;QACb,SAAS,EAAE,MAAM,CAAC;KACnB,CAAC,CAAC;IACH,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,OAAO,CAAC;CAChB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmDG;AACH,wBAAsB,4BAA4B,CAChD,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAC9B,YAAY,EAAE,eAAe,EAC7B,aAAa,CAAC,EAAE,mBAAmB,GAClC,OAAO,CAAC,wBAAwB,CAAC,CAwInC"}