mcp-adr-analysis-server 2.1.9 → 2.1.20

package/dist/src/resources/research-index-resource.js

@@ -0,0 +1,200 @@
+/**
+ * Research Index Resource
+ * Provides access to research documents and findings
+ */
+import * as fs from 'fs/promises';
+import * as path from 'path';
+import { McpAdrError } from '../types/index.js';
+import { resourceCache, generateETag } from './resource-cache.js';
+/**
+ * Extract title from markdown content
+ */
+function extractTitle(content) {
+    const lines = content.split('\n');
+    for (const line of lines) {
+        const trimmed = line.trim();
+        if (trimmed.startsWith('# ')) {
+            return trimmed.substring(2).trim();
+        }
+    }
+    return 'Untitled';
+}
+/**
+ * Extract topic from filename
+ */
+function extractTopic(filename) {
+    // Remove extension and parse filename
+    // Example: perform_research_test_research_001.md -> research
+    const baseName = filename.replace(/\.md$/, '');
+    const parts = baseName.split('_');
+    // Try to find meaningful topic
+    if (parts.includes('research')) {
+        const researchIndex = parts.indexOf('research');
+        if (researchIndex > 0) {
+            return parts.slice(0, researchIndex + 1).join('_');
+        }
+        return 'research';
+    }
+    return parts[0] || 'general';
+}
+/**
+ * Group documents by topic
+ */
+function groupByTopic(docs) {
+    const grouped = {};
+    for (const doc of docs) {
+        grouped[doc.topic] = (grouped[doc.topic] || 0) + 1;
+    }
+    return grouped;
+}
+/**
+ * Generate comprehensive research document index resource with metadata and categorization.
+ *
+ * Scans project research directories and builds an index of all research documents with
+ * metadata including titles, topics, word counts, file sizes, and last modified dates.
+ * Supports multiple research directories for organizational flexibility.
+ *
+ * **Scanned Directories:**
+ * - `docs/research/` - Primary research documentation
+ * - `custom/research/` - Custom user research notes
+ *
+ * **Document Extraction:**
+ * - Title: Extracted from first H1 heading or filename
+ * - Topic: Derived from filename prefix or directory structure
+ * - Metadata: Word count, file size, last modified timestamp
+ *
+ * @returns Promise resolving to resource generation result containing:
+ *   - data: Complete research index with documents array and summary statistics
+ *   - contentType: "application/json"
+ *   - lastModified: ISO timestamp of generation
+ *   - cacheKey: "research-index:current"
+ *   - ttl: Cache duration (300 seconds / 5 minutes)
+ *   - etag: Entity tag for cache validation
+ *
+ * @throws {McpAdrError} When research index generation fails due to:
+ *   - RESOURCE_GENERATION_ERROR: File system access errors or markdown parsing failures
+ *   - Cache operation failures
+ *
+ * @example
+ * ```typescript
+ * const researchIndex = await generateResearchIndexResource();
+ *
+ * console.log(`Total research documents: ${researchIndex.data.summary.total}`);
+ * console.log(`Topics covered: ${researchIndex.data.summary.byTopic.length}`);
+ * console.log(`Total words: ${researchIndex.data.summary.totalWords}`);
+ *
+ * // Find research by topic
+ * const architectureDocs = researchIndex.data.documents.filter(
+ *   doc => doc.topic === 'architecture'
+ * );
+ * console.log(`Architecture research docs: ${architectureDocs.length}`);
+ *
+ * // Sort by recency
+ * const recentDocs = researchIndex.data.documents
+ *   .sort((a, b) => new Date(b.lastModified).getTime() - new Date(a.lastModified).getTime())
+ *   .slice(0, 5);
+ *
+ * // Expected output structure:
+ * {
+ *   data: {
+ *     version: "1.0.0",
+ *     timestamp: "2025-10-12T17:00:00.000Z",
+ *     summary: {
+ *       total: 55,
+ *       byTopic: {
+ *         "performance": 12,
+ *         "security": 8,
+ *         "architecture": 15
+ *       },
+ *       totalWords: 45000,
+ *       averageWordCount: 818
+ *     },
+ *     documents: [
+ *       {
+ *         id: "perform_research_research_001",
+ *         title: "TypeScript Performance Optimization",
+ *         topic: "performance",
+ *         path: "docs/research/perform_research_research_001.md",
+ *         lastModified: "2025-10-10T12:00:00.000Z",
+ *         wordCount: 1250,
+ *         size: 8192
+ *       }
+ *     ]
+ *   },
+ *   contentType: "application/json",
+ *   cacheKey: "research-index:current",
+ *   ttl: 300
+ * }
+ * ```
+ *
+ * @since v2.0.0
+ * @see {@link extractTitle} for title extraction logic
+ * @see {@link extractTopic} for topic categorization
+ */
+export async function generateResearchIndexResource() {
+    try {
+        const cacheKey = 'research-index:current';
+        // Check cache
+        const cached = await resourceCache.get(cacheKey);
+        if (cached) {
+            return cached;
+        }
+        const researchDirs = ['docs/research', 'custom/research'];
+        const researchDocs = [];
+        for (const dir of researchDirs) {
+            const fullPath = path.resolve(process.cwd(), dir);
+            try {
+                await fs.access(fullPath);
+                const files = await fs.readdir(fullPath);
+                for (const file of files) {
+                    if (file.endsWith('.md')) {
+                        const filePath = path.join(fullPath, file);
+                        const content = await fs.readFile(filePath, 'utf-8');
+                        const stats = await fs.stat(filePath);
+                        researchDocs.push({
+                            id: file.replace(/\.md$/, ''),
+                            title: extractTitle(content),
+                            topic: extractTopic(file),
+                            path: path.join(dir, file),
+                            lastModified: stats.mtime.toISOString(),
+                            wordCount: content.split(/\s+/).filter(w => w.length > 0).length,
+                            size: stats.size,
+                        });
+                    }
+                }
+            }
+            catch {
+                // Directory doesn't exist or can't be accessed, skip
+                console.warn(`[ResearchIndexResource] Cannot access directory: ${fullPath}`);
+            }
+        }
+        // Sort by last modified (newest first)
+        researchDocs.sort((a, b) => new Date(b.lastModified).getTime() - new Date(a.lastModified).getTime());
+        const researchIndexData = {
+            version: '1.0.0',
+            timestamp: new Date().toISOString(),
+            summary: {
+                total: researchDocs.length,
+                byTopic: groupByTopic(researchDocs),
+                totalWordCount: researchDocs.reduce((sum, doc) => sum + doc.wordCount, 0),
+                totalSize: researchDocs.reduce((sum, doc) => sum + doc.size, 0),
+            },
+            documents: researchDocs,
+        };
+        const result = {
+            data: researchIndexData,
+            contentType: 'application/json',
+            lastModified: new Date().toISOString(),
+            cacheKey,
+            ttl: 300, // 5 minutes cache
+            etag: generateETag(researchIndexData),
+        };
+        // Cache result
+        resourceCache.set(cacheKey, result, result.ttl);
+        return result;
+    }
+    catch (error) {
+        throw new McpAdrError(`Failed to generate research index resource: ${error instanceof Error ? error.message : String(error)}`, 'RESOURCE_GENERATION_ERROR');
+    }
+}
+//# sourceMappingURL=research-index-resource.js.map

package/dist/src/resources/research-index-resource.js.map

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

package/dist/src/resources/resource-cache.d.ts

@@ -0,0 +1,144 @@
+/**
+ * Resource-level caching infrastructure for MCP resources
+ * Provides efficient caching with TTL support, cache management,
+ * and conditional request support (ETags, Last-Modified)
+ */
+import type { ResourceMetadata } from '../utils/resource-versioning.js';
+export interface CacheEntry {
+    data: any;
+    expiry: number;
+    createdAt: number;
+    accessCount: number;
+    lastAccessed: number;
+    etag?: string;
+    lastModified?: string;
+    version?: string;
+    metadata?: ResourceMetadata;
+}
+export interface CacheStats {
+    totalEntries: number;
+    validEntries: number;
+    expiredEntries: number;
+    cacheSize: number;
+    hitRate: number;
+    totalHits: number;
+    totalMisses: number;
+}
+/**
+ * Resource cache with TTL support and statistics tracking
+ */
+export declare class ResourceCache {
+    private cache;
+    private hits;
+    private misses;
+    /**
+     * Get cached resource by key
+     * @param key Cache key
+     * @returns Cached data or null if not found/expired
+     */
+    get<T>(key: string): Promise<T | null>;
+    /**
+     * Get cached resource with conditional request support
+     * @param key Cache key
+     * @param conditionalHeaders Optional conditional headers
+     * @returns Result with data, metadata, and notModified flag
+     */
+    getWithConditional<T>(key: string, conditionalHeaders?: {
+        ifNoneMatch?: string;
+        ifModifiedSince?: string;
+    }): Promise<{
+        data: T | null;
+        notModified: boolean;
+        etag?: string;
+        lastModified?: string;
+        version?: string;
+        metadata?: ResourceMetadata;
+    }>;
+    /**
+     * Set cached resource with TTL
+     * @param key Cache key
+     * @param data Data to cache
+     * @param ttl Time to live in seconds
+     * @param metadata Optional metadata (etag, lastModified, version, resourceMetadata)
+     */
+    set(key: string, data: any, ttl: number, metadata?: {
+        etag?: string;
+        lastModified?: string;
+        version?: string;
+        resourceMetadata?: ResourceMetadata;
+    }): void;
+    /**
+     * Check if key exists and is valid
+     * @param key Cache key
+     * @returns True if key exists and is not expired
+     */
+    has(key: string): boolean;
+    /**
+     * Delete cached resource
+     * @param key Cache key
+     * @returns True if key was deleted
+     */
+    delete(key: string): boolean;
+    /**
+     * Clear cache entries matching pattern
+     * @param pattern Optional pattern to match keys (substring match)
+     */
+    clear(pattern?: string): void;
+    /**
+     * Clean up expired entries
+     * @returns Number of entries removed
+     */
+    cleanup(): number;
+    /**
+     * Get cache statistics
+     * @returns Cache statistics object
+     */
+    getStats(): CacheStats;
+    /**
+     * Get all cache keys
+     * @returns Array of all cache keys
+     */
+    keys(): string[];
+    /**
+     * Get cache entries sorted by access count
+     * @param limit Maximum number of entries to return
+     * @returns Top entries by access count
+     */
+    getTopEntries(limit?: number): Array<{
+        key: string;
+        accessCount: number;
+    }>;
+    /**
+     * Get least recently used entries
+     * @param limit Maximum number of entries to return
+     * @returns Least recently used entries
+     */
+    getLRUEntries(limit?: number): Array<{
+        key: string;
+        lastAccessed: number;
+    }>;
+    /**
+     * Evict least recently used entries to reduce cache size
+     * @param targetSize Target number of entries
+     * @returns Number of entries evicted
+     */
+    evictLRU(targetSize: number): number;
+    /**
+     * Reset cache statistics
+     */
+    resetStats(): void;
+}
+/**
+ * Singleton resource cache instance
+ */
+export declare const resourceCache: ResourceCache;
+export declare function startAutomaticCleanup(intervalMs?: number): void;
+export declare function stopAutomaticCleanup(): void;
+/**
+ * Generate ETag for resource data
+ * @deprecated Use generateStrongETag from conditional-request.ts instead
+ * @param data Resource data
+ * @returns ETag string
+ */
+export declare function generateETag(data: any): string;
+//# sourceMappingURL=resource-cache.d.ts.map

package/dist/src/resources/resource-cache.d.ts.map

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

package/dist/src/resources/resource-cache.js

@@ -0,0 +1,316 @@
+/**
+ * Resource-level caching infrastructure for MCP resources
+ * Provides efficient caching with TTL support, cache management,
+ * and conditional request support (ETags, Last-Modified)
+ */
+import { generateStrongETag } from '../utils/conditional-request.js';
+/**
+ * Resource cache with TTL support and statistics tracking
+ */
+export class ResourceCache {
+    cache = new Map();
+    hits = 0;
+    misses = 0;
+    /**
+     * Get cached resource by key
+     * @param key Cache key
+     * @returns Cached data or null if not found/expired
+     */
+    async get(key) {
+        const entry = this.cache.get(key);
+        if (!entry) {
+            this.misses++;
+            return null;
+        }
+        // Check if expired
+        if (entry.expiry <= Date.now()) {
+            this.cache.delete(key);
+            this.misses++;
+            return null;
+        }
+        // Update access stats
+        entry.accessCount++;
+        entry.lastAccessed = Date.now();
+        this.hits++;
+        return entry.data;
+    }
+    /**
+     * Get cached resource with conditional request support
+     * @param key Cache key
+     * @param conditionalHeaders Optional conditional headers
+     * @returns Result with data, metadata, and notModified flag
+     */
+    async getWithConditional(key, conditionalHeaders) {
+        const entry = this.cache.get(key);
+        if (!entry) {
+            this.misses++;
+            return { data: null, notModified: false };
+        }
+        // Check if expired
+        if (entry.expiry <= Date.now()) {
+            this.cache.delete(key);
+            this.misses++;
+            return { data: null, notModified: false };
+        }
+        // Check conditional request headers
+        if (conditionalHeaders && entry.etag && entry.lastModified) {
+            const { ifNoneMatch, ifModifiedSince } = conditionalHeaders;
+            // Import conditional request utilities
+            const { evaluateConditionalRequest } = await import('../utils/conditional-request.js');
+            // Build params object without undefined values
+            const params = {
+                currentETag: entry.etag,
+                lastModified: entry.lastModified,
+            };
+            if (ifNoneMatch) {
+                params.ifNoneMatch = ifNoneMatch;
+            }
+            if (ifModifiedSince) {
+                params.ifModifiedSince = ifModifiedSince;
+            }
+            const result = evaluateConditionalRequest(params);
+            if (result.notModified) {
+                // Resource not modified, don't return data
+                entry.accessCount++;
+                entry.lastAccessed = Date.now();
+                this.hits++;
+                const response = {
+                    data: null,
+                    notModified: true,
+                    etag: entry.etag,
+                    lastModified: entry.lastModified,
+                };
+                if (entry.version) {
+                    response.version = entry.version;
+                }
+                if (entry.metadata) {
+                    response.metadata = entry.metadata;
+                }
+                return response;
+            }
+        }
+        // Update access stats
+        entry.accessCount++;
+        entry.lastAccessed = Date.now();
+        this.hits++;
+        // Build return object without undefined values
+        const result = {
+            data: entry.data,
+            notModified: false,
+        };
+        if (entry.etag) {
+            result.etag = entry.etag;
+        }
+        if (entry.lastModified) {
+            result.lastModified = entry.lastModified;
+        }
+        if (entry.version) {
+            result.version = entry.version;
+        }
+        if (entry.metadata) {
+            result.metadata = entry.metadata;
+        }
+        return result;
+    }
+    /**
+     * Set cached resource with TTL
+     * @param key Cache key
+     * @param data Data to cache
+     * @param ttl Time to live in seconds
+     * @param metadata Optional metadata (etag, lastModified, version, resourceMetadata)
+     */
+    set(key, data, ttl, metadata) {
+        const now = Date.now();
+        const lastModified = metadata?.lastModified || new Date(now).toISOString();
+        const etag = metadata?.etag || generateStrongETag(data);
+        const version = metadata?.version;
+        const resourceMetadata = metadata?.resourceMetadata;
+        const entry = {
+            data,
+            expiry: now + ttl * 1000,
+            createdAt: now,
+            accessCount: 0,
+            lastAccessed: now,
+            etag,
+            lastModified,
+        };
+        if (version) {
+            entry.version = version;
+        }
+        if (resourceMetadata) {
+            entry.metadata = resourceMetadata;
+        }
+        this.cache.set(key, entry);
+    }
+    /**
+     * Check if key exists and is valid
+     * @param key Cache key
+     * @returns True if key exists and is not expired
+     */
+    has(key) {
+        const entry = this.cache.get(key);
+        if (!entry)
+            return false;
+        if (entry.expiry <= Date.now()) {
+            this.cache.delete(key);
+            return false;
+        }
+        return true;
+    }
+    /**
+     * Delete cached resource
+     * @param key Cache key
+     * @returns True if key was deleted
+     */
+    delete(key) {
+        return this.cache.delete(key);
+    }
+    /**
+     * Clear cache entries matching pattern
+     * @param pattern Optional pattern to match keys (substring match)
+     */
+    clear(pattern) {
+        if (!pattern) {
+            this.cache.clear();
+            this.hits = 0;
+            this.misses = 0;
+            return;
+        }
+        const keysToDelete = [];
+        for (const key of this.cache.keys()) {
+            if (key.includes(pattern)) {
+                keysToDelete.push(key);
+            }
+        }
+        keysToDelete.forEach(key => this.cache.delete(key));
+    }
+    /**
+     * Clean up expired entries
+     * @returns Number of entries removed
+     */
+    cleanup() {
+        const now = Date.now();
+        let removed = 0;
+        for (const [key, entry] of this.cache.entries()) {
+            if (entry.expiry <= now) {
+                this.cache.delete(key);
+                removed++;
+            }
+        }
+        return removed;
+    }
+    /**
+     * Get cache statistics
+     * @returns Cache statistics object
+     */
+    getStats() {
+        const entries = Array.from(this.cache.values());
+        const now = Date.now();
+        const validEntries = entries.filter(e => e.expiry > now);
+        const expiredEntries = entries.filter(e => e.expiry <= now);
+        const totalRequests = this.hits + this.misses;
+        const hitRate = totalRequests > 0 ? this.hits / totalRequests : 0;
+        return {
+            totalEntries: this.cache.size,
+            validEntries: validEntries.length,
+            expiredEntries: expiredEntries.length,
+            cacheSize: JSON.stringify(entries).length,
+            hitRate,
+            totalHits: this.hits,
+            totalMisses: this.misses,
+        };
+    }
+    /**
+     * Get all cache keys
+     * @returns Array of all cache keys
+     */
+    keys() {
+        return Array.from(this.cache.keys());
+    }
+    /**
+     * Get cache entries sorted by access count
+     * @param limit Maximum number of entries to return
+     * @returns Top entries by access count
+     */
+    getTopEntries(limit = 10) {
+        const entries = Array.from(this.cache.entries())
+            .map(([key, entry]) => ({
+            key,
+            accessCount: entry.accessCount,
+        }))
+            .sort((a, b) => b.accessCount - a.accessCount)
+            .slice(0, limit);
+        return entries;
+    }
+    /**
+     * Get least recently used entries
+     * @param limit Maximum number of entries to return
+     * @returns Least recently used entries
+     */
+    getLRUEntries(limit = 10) {
+        const entries = Array.from(this.cache.entries())
+            .map(([key, entry]) => ({
+            key,
+            lastAccessed: entry.lastAccessed,
+        }))
+            .sort((a, b) => a.lastAccessed - b.lastAccessed)
+            .slice(0, limit);
+        return entries;
+    }
+    /**
+     * Evict least recently used entries to reduce cache size
+     * @param targetSize Target number of entries
+     * @returns Number of entries evicted
+     */
+    evictLRU(targetSize) {
+        if (this.cache.size <= targetSize)
+            return 0;
+        const entriesToEvict = this.cache.size - targetSize;
+        const lruEntries = this.getLRUEntries(entriesToEvict);
+        lruEntries.forEach(({ key }) => this.cache.delete(key));
+        return entriesToEvict;
+    }
+    /**
+     * Reset cache statistics
+     */
+    resetStats() {
+        this.hits = 0;
+        this.misses = 0;
+    }
+}
+/**
+ * Singleton resource cache instance
+ */
+export const resourceCache = new ResourceCache();
+/**
+ * Start automatic cleanup interval
+ * Cleans up expired entries every 5 minutes
+ */
+let cleanupInterval = null;
+export function startAutomaticCleanup(intervalMs = 5 * 60 * 1000) {
+    if (cleanupInterval) {
+        clearInterval(cleanupInterval);
+    }
+    cleanupInterval = setInterval(() => {
+        const removed = resourceCache.cleanup();
+        if (removed > 0) {
+            console.log(`[ResourceCache] Cleaned up ${removed} expired entries`);
+        }
+    }, intervalMs);
+}
+export function stopAutomaticCleanup() {
+    if (cleanupInterval) {
+        clearInterval(cleanupInterval);
+        cleanupInterval = null;
+    }
+}
+/**
+ * Generate ETag for resource data
+ * @deprecated Use generateStrongETag from conditional-request.ts instead
+ * @param data Resource data
+ * @returns ETag string
+ */
+export function generateETag(data) {
+    return generateStrongETag(data);
+}
+//# sourceMappingURL=resource-cache.js.map

package/dist/src/resources/resource-cache.js.map

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