mcp-adr-analysis-server 2.1.19 → 2.1.22

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

@@ -0,0 +1,428 @@
+/**
+ * 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

@@ -0,0 +1 @@
+{"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/conversation-snapshot-resource.d.ts

@@ -0,0 +1,92 @@
+/**
+ * Conversation Snapshot Resource - Current conversation context
+ * URI Pattern: adr://conversation/snapshot
+ */
+import { URLSearchParams } from 'url';
+import { ResourceGenerationResult } from './index.js';
+import type { ConversationMemoryManager } from '../utils/conversation-memory-manager.js';
+import type { ConversationContextSnapshot } from '../types/conversation-memory.js';
+export interface ConversationSnapshotData {
+    snapshot: ConversationContextSnapshot | null;
+    timestamp: string;
+    recentTurnCount: number;
+}
+/**
+ * Generate conversation snapshot resource showing current session context.
+ *
+ * Returns a snapshot of the active conversation session including:
+ * - Recent conversation turns
+ * - Active knowledge graph intents
+ * - Recorded architectural decisions
+ * - Current conversation focus and next steps
+ *
+ * **URI Pattern:** `adr://conversation/snapshot`
+ *
+ * **Query Parameters:**
+ * - `recentTurnCount`: Number of recent turns to include (default: 5)
+ *
+ * @param params - URL path parameters (none for this resource)
+ * @param searchParams - URL query parameters for customization
+ * @param memoryManager - ConversationMemoryManager instance (injected by MCP server)
+ *
+ * @returns Promise resolving to resource generation result containing:
+ *   - data: Conversation snapshot with session context (null if no active session)
+ *   - contentType: "application/json"
+ *   - lastModified: ISO timestamp of generation
+ *   - cacheKey: Unique identifier "conversation-snapshot"
+ *   - ttl: Cache duration (10 seconds)
+ *   - etag: Entity tag for cache validation
+ *
+ * @throws {McpAdrError} When:
+ *   - RESOURCE_GENERATION_ERROR: Memory manager not provided or snapshot retrieval fails
+ *
+ * @example
+ * ```typescript
+ * // Get conversation snapshot with default settings
+ * const snapshot = await generateConversationSnapshotResource(
+ *   {},
+ *   new URLSearchParams(),
+ *   memoryManager
+ * );
+ *
+ * if (snapshot.data.snapshot) {
+ *   console.log(`Session: ${snapshot.data.snapshot.sessionId}`);
+ *   console.log(`Recent turns: ${snapshot.data.snapshot.recentTurns.length}`);
+ *   console.log(`Active intents: ${snapshot.data.snapshot.activeIntents.length}`);
+ * }
+ *
+ * // Get snapshot with more recent turns
+ * const detailed = await generateConversationSnapshotResource(
+ *   {},
+ *   new URLSearchParams('recentTurnCount=10'),
+ *   memoryManager
+ * );
+ *
+ * // Expected output structure:
+ * {
+ *   data: {
+ *     snapshot: {
+ *       sessionId: "session-123",
+ *       recentTurns: [...],
+ *       activeIntents: [...],
+ *       decisionsRecorded: [...],
+ *       conversationFocus: {
+ *         topic: "Database architecture",
+ *         phase: "Decision making",
+ *         nextSteps: ["Review options", "Make decision"]
+ *       }
+ *     },
+ *     timestamp: "2025-12-16T04:30:00.000Z",
+ *     recentTurnCount: 5
+ *   },
+ *   contentType: "application/json",
+ *   cacheKey: "conversation-snapshot",
+ *   ttl: 10
+ * }
+ * ```
+ *
+ * @since v2.2.0
+ * @see {@link ConversationMemoryManager.getContextSnapshot} for snapshot generation logic
+ */
+export declare function generateConversationSnapshotResource(_params: Record<string, string>, searchParams: URLSearchParams, memoryManager?: ConversationMemoryManager): Promise<ResourceGenerationResult>;
+//# sourceMappingURL=conversation-snapshot-resource.d.ts.map

package/dist/src/resources/conversation-snapshot-resource.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"conversation-snapshot-resource.d.ts","sourceRoot":"","sources":["../../../src/resources/conversation-snapshot-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,yBAAyB,EAAE,MAAM,yCAAyC,CAAC;AACzF,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,iCAAiC,CAAC;AAEnF,MAAM,WAAW,wBAAwB;IACvC,QAAQ,EAAE,2BAA2B,GAAG,IAAI,CAAC;IAC7C,SAAS,EAAE,MAAM,CAAC;IAClB,eAAe,EAAE,MAAM,CAAC;CACzB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4EG;AACH,wBAAsB,oCAAoC,CACxD,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAC/B,YAAY,EAAE,eAAe,EAC7B,aAAa,CAAC,EAAE,yBAAyB,GACxC,OAAO,CAAC,wBAAwB,CAAC,CA+CnC"}

package/dist/src/resources/conversation-snapshot-resource.js

@@ -0,0 +1,122 @@
+/**
+ * Conversation Snapshot Resource - Current conversation context
+ * URI Pattern: adr://conversation/snapshot
+ */
+import { McpAdrError } from '../types/index.js';
+import { resourceCache, generateETag } from './resource-cache.js';
+import { resourceRouter } from './resource-router.js';
+/**
+ * Generate conversation snapshot resource showing current session context.
+ *
+ * Returns a snapshot of the active conversation session including:
+ * - Recent conversation turns
+ * - Active knowledge graph intents
+ * - Recorded architectural decisions
+ * - Current conversation focus and next steps
+ *
+ * **URI Pattern:** `adr://conversation/snapshot`
+ *
+ * **Query Parameters:**
+ * - `recentTurnCount`: Number of recent turns to include (default: 5)
+ *
+ * @param params - URL path parameters (none for this resource)
+ * @param searchParams - URL query parameters for customization
+ * @param memoryManager - ConversationMemoryManager instance (injected by MCP server)
+ *
+ * @returns Promise resolving to resource generation result containing:
+ *   - data: Conversation snapshot with session context (null if no active session)
+ *   - contentType: "application/json"
+ *   - lastModified: ISO timestamp of generation
+ *   - cacheKey: Unique identifier "conversation-snapshot"
+ *   - ttl: Cache duration (10 seconds)
+ *   - etag: Entity tag for cache validation
+ *
+ * @throws {McpAdrError} When:
+ *   - RESOURCE_GENERATION_ERROR: Memory manager not provided or snapshot retrieval fails
+ *
+ * @example
+ * ```typescript
+ * // Get conversation snapshot with default settings
+ * const snapshot = await generateConversationSnapshotResource(
+ *   {},
+ *   new URLSearchParams(),
+ *   memoryManager
+ * );
+ *
+ * if (snapshot.data.snapshot) {
+ *   console.log(`Session: ${snapshot.data.snapshot.sessionId}`);
+ *   console.log(`Recent turns: ${snapshot.data.snapshot.recentTurns.length}`);
+ *   console.log(`Active intents: ${snapshot.data.snapshot.activeIntents.length}`);
+ * }
+ *
+ * // Get snapshot with more recent turns
+ * const detailed = await generateConversationSnapshotResource(
+ *   {},
+ *   new URLSearchParams('recentTurnCount=10'),
+ *   memoryManager
+ * );
+ *
+ * // Expected output structure:
+ * {
+ *   data: {
+ *     snapshot: {
+ *       sessionId: "session-123",
+ *       recentTurns: [...],
+ *       activeIntents: [...],
+ *       decisionsRecorded: [...],
+ *       conversationFocus: {
+ *         topic: "Database architecture",
+ *         phase: "Decision making",
+ *         nextSteps: ["Review options", "Make decision"]
+ *       }
+ *     },
+ *     timestamp: "2025-12-16T04:30:00.000Z",
+ *     recentTurnCount: 5
+ *   },
+ *   contentType: "application/json",
+ *   cacheKey: "conversation-snapshot",
+ *   ttl: 10
+ * }
+ * ```
+ *
+ * @since v2.2.0
+ * @see {@link ConversationMemoryManager.getContextSnapshot} for snapshot generation logic
+ */
+export async function generateConversationSnapshotResource(_params, searchParams, memoryManager) {
+    const cacheKey = 'conversation-snapshot';
+    // Check cache
+    const cached = await resourceCache.get(cacheKey);
+    if (cached) {
+        return cached;
+    }
+    try {
+        if (!memoryManager) {
+            throw new McpAdrError('Conversation snapshot requires initialized memory manager. Access this resource through the MCP server.', 'RESOURCE_GENERATION_ERROR');
+        }
+        const recentTurnCount = parseInt(searchParams.get('recentTurnCount') || '5', 10);
+        // Get snapshot from memory manager
+        const snapshot = await memoryManager.getContextSnapshot(recentTurnCount);
+        const snapshotData = {
+            snapshot,
+            timestamp: new Date().toISOString(),
+            recentTurnCount,
+        };
+        const result = {
+            data: snapshotData,
+            contentType: 'application/json',
+            lastModified: new Date().toISOString(),
+            cacheKey,
+            ttl: 10, // 10 seconds cache (conversation context changes very frequently)
+            etag: generateETag(snapshotData),
+        };
+        // Cache result
+        resourceCache.set(cacheKey, result, result.ttl);
+        return result;
+    }
+    catch (error) {
+        throw new McpAdrError(`Failed to generate conversation snapshot: ${error instanceof Error ? error.message : String(error)}`, 'RESOURCE_GENERATION_ERROR');
+    }
+}
+// Register route
+resourceRouter.register('/conversation/snapshot', generateConversationSnapshotResource, 'Current conversation context snapshot');
+//# sourceMappingURL=conversation-snapshot-resource.js.map

package/dist/src/resources/conversation-snapshot-resource.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"conversation-snapshot-resource.js","sourceRoot":"","sources":["../../../src/resources/conversation-snapshot-resource.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAElE,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAUtD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4EG;AACH,MAAM,CAAC,KAAK,UAAU,oCAAoC,CACxD,OAA+B,EAC/B,YAA6B,EAC7B,aAAyC;IAEzC,MAAM,QAAQ,GAAG,uBAAuB,CAAC;IAEzC,cAAc;IACd,MAAM,MAAM,GAAG,MAAM,aAAa,CAAC,GAAG,CAA2B,QAAQ,CAAC,CAAC;IAC3E,IAAI,MAAM,EAAE,CAAC;QACX,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,IAAI,CAAC;QACH,IAAI,CAAC,aAAa,EAAE,CAAC;YACnB,MAAM,IAAI,WAAW,CACnB,yGAAyG,EACzG,2BAA2B,CAC5B,CAAC;QACJ,CAAC;QAED,MAAM,eAAe,GAAG,QAAQ,CAAC,YAAY,CAAC,GAAG,CAAC,iBAAiB,CAAC,IAAI,GAAG,EAAE,EAAE,CAAC,CAAC;QAEjF,mCAAmC;QACnC,MAAM,QAAQ,GAAG,MAAM,aAAa,CAAC,kBAAkB,CAAC,eAAe,CAAC,CAAC;QAEzE,MAAM,YAAY,GAA6B;YAC7C,QAAQ;YACR,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;YACnC,eAAe;SAChB,CAAC;QAEF,MAAM,MAAM,GAA6B;YACvC,IAAI,EAAE,YAAY;YAClB,WAAW,EAAE,kBAAkB;YAC/B,YAAY,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;YACtC,QAAQ;YACR,GAAG,EAAE,EAAE,EAAE,kEAAkE;YAC3E,IAAI,EAAE,YAAY,CAAC,YAAY,CAAC;SACjC,CAAC;QAEF,eAAe;QACf,aAAa,CAAC,GAAG,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,CAAC,GAAG,CAAC,CAAC;QAEhD,OAAO,MAAM,CAAC;IAChB,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,IAAI,WAAW,CACnB,6CAA6C,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,EACrG,2BAA2B,CAC5B,CAAC;IACJ,CAAC;AACH,CAAC;AAED,iBAAiB;AACjB,cAAc,CAAC,QAAQ,CACrB,wBAAwB,EACxB,oCAAoC,EACpC,uCAAuC,CACxC,CAAC"}