mcp-adr-analysis-server 2.1.11 → 2.1.19

package/dist/src/utils/context-document-manager.js

@@ -0,0 +1,351 @@
+import { promises as fs } from 'fs';
+import * as path from 'path';
+import { EnhancedLogger } from './enhanced-logging.js';
+/**
+ * Manages creation, storage, and retrieval of tool context documents
+ */
+export class ToolContextManager {
+    contextDir;
+    logger;
+    constructor(projectPath) {
+        this.contextDir = path.join(projectPath, 'docs', 'context');
+        this.logger = new EnhancedLogger();
+    }
+    /**
+     * Initialize context directory structure
+     */
+    async initialize() {
+        const categories = [
+            'bootstrap',
+            'deployment',
+            'environment',
+            'research',
+            'planning',
+            'validation',
+            'git',
+        ];
+        try {
+            // Create main context directory
+            await fs.mkdir(this.contextDir, { recursive: true });
+            // Create category subdirectories
+            for (const category of categories) {
+                const categoryDir = path.join(this.contextDir, category);
+                await fs.mkdir(categoryDir, { recursive: true });
+            }
+            this.logger.info('Context directory structure initialized', 'ToolContextManager');
+        }
+        catch (error) {
+            this.logger.error('Failed to initialize context directories', 'ToolContextManager', error);
+            throw error;
+        }
+    }
+    /**
+     * Save a context document to the appropriate category
+     * @param category - Category subdirectory (bootstrap, deployment, etc.)
+     * @param document - Context document to save
+     * @returns Path to the saved document
+     */
+    async saveContext(category, document) {
+        try {
+            const categoryDir = path.join(this.contextDir, category);
+            await fs.mkdir(categoryDir, { recursive: true });
+            // Generate filename with timestamp
+            const timestamp = new Date().toISOString().replace(/[:.]/g, '-').split('.')[0];
+            const filename = `${document.metadata.toolName.toLowerCase().replace(/_/g, '-')}-${timestamp}.md`;
+            const filePath = path.join(categoryDir, filename);
+            // Generate markdown content
+            const markdown = this.generateMarkdown(document);
+            // Write the file
+            await fs.writeFile(filePath, markdown, 'utf-8');
+            // Update latest.md symlink
+            await this.updateLatestSymlink(category, filePath);
+            this.logger.info(`Context document saved: ${filePath}`, 'ToolContextManager');
+            return filePath;
+        }
+        catch (error) {
+            this.logger.error('Failed to save context document', 'ToolContextManager', error);
+            throw error;
+        }
+    }
+    /**
+     * Load the latest context document for a category
+     * @param category - Category to load from
+     * @returns Context document or null if not found
+     */
+    async loadLatestContext(category) {
+        try {
+            const latestPath = path.join(this.contextDir, category, 'latest.md');
+            // Check if latest.md exists
+            try {
+                await fs.access(latestPath);
+            }
+            catch {
+                this.logger.warn(`No latest context found for category: ${category}`, 'ToolContextManager');
+                return null;
+            }
+            // Read the file (for future parsing implementation)
+            await fs.readFile(latestPath, 'utf-8');
+            // Parse markdown back to context document (simplified - would need full parser)
+            // For now, return null and log that parsing is not yet implemented
+            this.logger.info(`Latest context found for ${category}, but parsing not yet implemented`, 'ToolContextManager');
+            return null;
+        }
+        catch (error) {
+            this.logger.error('Failed to load latest context', 'ToolContextManager', error);
+            return null;
+        }
+    }
+    /**
+     * Load a specific context document by timestamp
+     * @param category - Category to search in
+     * @param timestamp - Timestamp identifier
+     * @returns Context document or null if not found
+     */
+    async loadContextByTimestamp(category, timestamp) {
+        try {
+            const categoryDir = path.join(this.contextDir, category);
+            const files = await fs.readdir(categoryDir);
+            // Find file matching timestamp
+            const matchingFile = files.find(f => f.includes(timestamp));
+            if (!matchingFile) {
+                this.logger.warn(`No context found for timestamp: ${timestamp}`, 'ToolContextManager');
+                return null;
+            }
+            const filePath = path.join(categoryDir, matchingFile);
+            await fs.readFile(filePath, 'utf-8');
+            // Parsing not yet implemented
+            this.logger.info(`Context found for timestamp ${timestamp}, but parsing not yet implemented`, 'ToolContextManager');
+            return null;
+        }
+        catch (error) {
+            this.logger.error('Failed to load context by timestamp', 'ToolContextManager', error);
+            return null;
+        }
+    }
+    /**
+     * List all context documents in a category
+     * @param category - Category to list
+     * @returns Array of filenames
+     */
+    async listContexts(category) {
+        try {
+            const categoryDir = path.join(this.contextDir, category);
+            const files = await fs.readdir(categoryDir);
+            // Filter out latest.md and only return timestamped files
+            return files
+                .filter(f => f.endsWith('.md') && f !== 'latest.md')
+                .sort()
+                .reverse();
+        }
+        catch (error) {
+            this.logger.error('Failed to list contexts', 'ToolContextManager', error);
+            return [];
+        }
+    }
+    /**
+     * Update the latest.md symlink or copy for a category
+     * @param category - Category directory
+     * @param filePath - Path to the latest context document
+     */
+    async updateLatestSymlink(category, filePath) {
+        try {
+            const latestPath = path.join(this.contextDir, category, 'latest.md');
+            // Remove existing latest.md
+            try {
+                await fs.unlink(latestPath);
+            }
+            catch {
+                // File doesn't exist, that's fine
+            }
+            // Copy file to latest.md (symlinks can be problematic on some systems)
+            const content = await fs.readFile(filePath, 'utf-8');
+            await fs.writeFile(latestPath, content, 'utf-8');
+            this.logger.info(`Updated latest.md for category: ${category}`, 'ToolContextManager');
+        }
+        catch (error) {
+            this.logger.error('Failed to update latest symlink', 'ToolContextManager', error);
+        }
+    }
+    /**
+     * Clean up old context documents, keeping only the most recent N
+     * @param category - Category to clean up
+     * @param keepCount - Number of recent contexts to keep (default: 10)
+     */
+    async cleanupOldContexts(category, keepCount = 10) {
+        try {
+            const contexts = await this.listContexts(category);
+            if (contexts.length <= keepCount) {
+                this.logger.info(`No cleanup needed for ${category} (${contexts.length} contexts)`, 'ToolContextManager');
+                return;
+            }
+            // Delete oldest contexts
+            const toDelete = contexts.slice(keepCount);
+            const categoryDir = path.join(this.contextDir, category);
+            for (const filename of toDelete) {
+                const filePath = path.join(categoryDir, filename);
+                await fs.unlink(filePath);
+                this.logger.info(`Deleted old context: ${filename}`, 'ToolContextManager');
+            }
+            this.logger.info(`Cleaned up ${toDelete.length} old contexts from ${category}`, 'ToolContextManager');
+        }
+        catch (error) {
+            this.logger.error('Failed to cleanup old contexts', 'ToolContextManager', error);
+        }
+    }
+    /**
+     * Generate markdown content from a context document
+     * @param document - Context document to convert
+     * @returns Markdown string
+     */
+    generateMarkdown(document) {
+        const lines = [];
+        // Title and metadata
+        lines.push(`# Tool Context: ${document.metadata.toolName}`);
+        lines.push('');
+        lines.push(`> **Generated**: ${document.metadata.generated}`);
+        lines.push(`> **Tool Version**: ${document.metadata.toolVersion}`);
+        lines.push(`> **Project**: ${document.metadata.projectName}`);
+        lines.push('');
+        // Quick Reference
+        lines.push('## Quick Reference');
+        lines.push('');
+        lines.push(document.quickReference.trim());
+        lines.push('');
+        // Execution Summary
+        lines.push('## Execution Summary');
+        lines.push('');
+        lines.push(`- **Status**: ${document.executionSummary.status}`);
+        if (document.executionSummary.confidence !== undefined) {
+            lines.push(`- **Confidence**: ${document.executionSummary.confidence.toFixed(0)}%`);
+        }
+        lines.push('- **Key Findings**:');
+        for (const finding of document.executionSummary.keyFindings) {
+            lines.push(`  - ${finding}`);
+        }
+        lines.push('');
+        // Detected Context
+        lines.push('## Detected Context');
+        lines.push('');
+        lines.push('```json');
+        lines.push(JSON.stringify(document.detectedContext, null, 2));
+        lines.push('```');
+        lines.push('');
+        // Generated Artifacts
+        if (document.generatedArtifacts && document.generatedArtifacts.length > 0) {
+            lines.push('## Generated Artifacts');
+            lines.push('');
+            for (const artifact of document.generatedArtifacts) {
+                lines.push(`- \`${artifact}\``);
+            }
+            lines.push('');
+        }
+        // Key Decisions
+        if (document.keyDecisions && document.keyDecisions.length > 0) {
+            lines.push('## Key Decisions');
+            lines.push('');
+            for (let i = 0; i < document.keyDecisions.length; i++) {
+                const decision = document.keyDecisions[i];
+                if (decision) {
+                    lines.push(`### ${i + 1}. ${decision.decision}`);
+                    lines.push(`- **Rationale**: ${decision.rationale}`);
+                    if (decision.alternatives && decision.alternatives.length > 0) {
+                        lines.push('- **Alternatives Considered**:');
+                        for (const alt of decision.alternatives) {
+                            lines.push(`  - ${alt}`);
+                        }
+                    }
+                    lines.push('');
+                }
+            }
+        }
+        // Learnings & Recommendations
+        if (document.learnings) {
+            lines.push('## Learnings & Recommendations');
+            lines.push('');
+            if (document.learnings.successes.length > 0) {
+                lines.push('### Successes ✅');
+                for (const success of document.learnings.successes) {
+                    lines.push(`- ${success}`);
+                }
+                lines.push('');
+            }
+            if (document.learnings.failures.length > 0) {
+                lines.push('### Failures ⚠️');
+                for (const failure of document.learnings.failures) {
+                    lines.push(`- ${failure}`);
+                }
+                lines.push('');
+            }
+            if (document.learnings.recommendations.length > 0) {
+                lines.push('### Recommendations');
+                for (const rec of document.learnings.recommendations) {
+                    lines.push(`- ${rec}`);
+                }
+                lines.push('');
+            }
+            if (document.learnings.environmentSpecific.length > 0) {
+                lines.push('### Environment-Specific Notes');
+                for (const note of document.learnings.environmentSpecific) {
+                    lines.push(`- ${note}`);
+                }
+                lines.push('');
+            }
+        }
+        // Usage in Future Sessions
+        lines.push('## Usage in Future Sessions');
+        lines.push('');
+        lines.push('### How to Reference This Context');
+        lines.push('');
+        lines.push('```text');
+        lines.push('Example prompt:');
+        lines.push(`"Using the context from docs/context/${document.metadata.toolName}/latest.md,`);
+        lines.push('continue the work from the previous session"');
+        lines.push('```');
+        lines.push('');
+        // Related Documents
+        if (document.relatedDocuments) {
+            lines.push('### Related Documents');
+            lines.push('');
+            if (document.relatedDocuments.adrs.length > 0) {
+                lines.push('**ADRs**:');
+                for (const adr of document.relatedDocuments.adrs) {
+                    lines.push(`- \`${adr}\``);
+                }
+                lines.push('');
+            }
+            if (document.relatedDocuments.configs.length > 0) {
+                lines.push('**Configuration Files**:');
+                for (const config of document.relatedDocuments.configs) {
+                    lines.push(`- \`${config}\``);
+                }
+                lines.push('');
+            }
+            if (document.relatedDocuments.otherContexts.length > 0) {
+                lines.push('**Other Context Documents**:');
+                for (const ctx of document.relatedDocuments.otherContexts) {
+                    lines.push(`- \`${ctx}\``);
+                }
+                lines.push('');
+            }
+        }
+        // Raw Data (Optional)
+        if (document.rawData) {
+            lines.push('## Raw Data');
+            lines.push('');
+            lines.push('<details>');
+            lines.push('<summary>Full execution output</summary>');
+            lines.push('');
+            lines.push('```json');
+            lines.push(JSON.stringify(document.rawData, null, 2));
+            lines.push('```');
+            lines.push('</details>');
+            lines.push('');
+        }
+        // Footer
+        lines.push('---');
+        lines.push('');
+        lines.push(`*Auto-generated by ${document.metadata.toolName} v${document.metadata.toolVersion}*`);
+        return lines.join('\n');
+    }
+}
+//# sourceMappingURL=context-document-manager.js.map

package/dist/src/utils/context-document-manager.js.map

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

package/dist/src/utils/conversation-memory-manager.d.ts

@@ -0,0 +1,86 @@
+/**
+ * Conversation Memory Manager
+ *
+ * Phase 3 of context decay mitigation: Structured external memory.
+ * Handles conversation persistence, expandable content storage, and resumption.
+ */
+import { ConversationSession, ConversationTurn, ConversationMemoryConfig, ConversationContextSnapshot, MemoryExpansionRequest, MemoryExpansionResponse, SessionQuery, ConversationMemoryStats } from '../types/conversation-memory.js';
+import type { ExpandableContent } from '../types/tiered-response.js';
+import { KnowledgeGraphManager } from './knowledge-graph-manager.js';
+export declare class ConversationMemoryManager {
+    private memoryDir;
+    private sessionsDir;
+    private expandableContentDir;
+    private archiveDir;
+    private config;
+    private kgManager;
+    private logger;
+    private activeSession;
+    private expandableContentCache;
+    constructor(kgManager: KnowledgeGraphManager, config?: Partial<ConversationMemoryConfig>);
+    /**
+     * Initialize the conversation memory system
+     */
+    initialize(): Promise<void>;
+    /**
+     * Start a new conversation session
+     */
+    startNewSession(projectPath: string): Promise<string>;
+    /**
+     * Record a conversation turn
+     */
+    recordTurn(request: ConversationTurn['request'], response: ConversationTurn['response'], metadata?: Partial<ConversationTurn['metadata']>): Promise<string>;
+    /**
+     * Store expandable content from tiered response
+     */
+    storeExpandableContent(expandableId: string, content: ExpandableContent): Promise<void>;
+    /**
+     * Retrieve and expand stored content
+     */
+    expandContent(request: MemoryExpansionRequest): Promise<MemoryExpansionResponse>;
+    /**
+     * Get conversation context snapshot for resumption
+     */
+    getContextSnapshot(recentTurnCount?: number): Promise<ConversationContextSnapshot | null>;
+    /**
+     * Query conversation sessions
+     */
+    querySessions(query: SessionQuery): Promise<ConversationSession[]>;
+    /**
+     * Get conversation memory statistics
+     */
+    getStats(): Promise<ConversationMemoryStats>;
+    /**
+     * Persist current session to disk
+     */
+    private persistSession;
+    /**
+     * Load most recent session
+     */
+    private loadMostRecentSession;
+    /**
+     * Schedule periodic cleanup of old sessions
+     */
+    private scheduleCleanup;
+    /**
+     * Archive old sessions and cleanup expired archives
+     */
+    private cleanupOldSessions;
+    /**
+     * Generate unique session ID
+     */
+    private generateSessionId;
+    /**
+     * Generate unique turn ID
+     */
+    private generateTurnId;
+    /**
+     * Get current session ID
+     */
+    getCurrentSessionId(): string | null;
+    /**
+     * Get current session
+     */
+    getCurrentSession(): ConversationSession | null;
+}
+//# sourceMappingURL=conversation-memory-manager.d.ts.map

package/dist/src/utils/conversation-memory-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"conversation-memory-manager.d.ts","sourceRoot":"","sources":["../../../src/utils/conversation-memory-manager.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAOH,OAAO,EACL,mBAAmB,EACnB,gBAAgB,EAChB,wBAAwB,EACxB,2BAA2B,EAC3B,sBAAsB,EACtB,uBAAuB,EACvB,YAAY,EACZ,uBAAuB,EACxB,MAAM,iCAAiC,CAAC;AACzC,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,6BAA6B,CAAC;AACrE,OAAO,EAAE,qBAAqB,EAAE,MAAM,8BAA8B,CAAC;AAcrE,qBAAa,yBAAyB;IACpC,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,oBAAoB,CAAS;IACrC,OAAO,CAAC,UAAU,CAAS;IAE3B,OAAO,CAAC,MAAM,CAA2B;IACzC,OAAO,CAAC,SAAS,CAAwB;IACzC,OAAO,CAAC,MAAM,CAAkC;IAGhD,OAAO,CAAC,aAAa,CAAoC;IACzD,OAAO,CAAC,sBAAsB,CAA6C;gBAE/D,SAAS,EAAE,qBAAqB,EAAE,MAAM,GAAE,OAAO,CAAC,wBAAwB,CAAM;IAgB5F;;OAEG;IACG,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IA6BjC;;OAEG;IACG,eAAe,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAyB3D;;OAEG;IACG,UAAU,CACd,OAAO,EAAE,gBAAgB,CAAC,SAAS,CAAC,EACpC,QAAQ,EAAE,gBAAgB,CAAC,UAAU,CAAC,EACtC,QAAQ,GAAE,OAAO,CAAC,gBAAgB,CAAC,UAAU,CAAC,CAAM,GACnD,OAAO,CAAC,MAAM,CAAC;IA6ClB;;OAEG;IACG,sBAAsB,CAAC,YAAY,EAAE,MAAM,EAAE,OAAO,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC;IAmB7F;;OAEG;IACG,aAAa,CAAC,OAAO,EAAE,sBAAsB,GAAG,OAAO,CAAC,uBAAuB,CAAC;IAgDtF;;OAEG;IACG,kBAAkB,CACtB,eAAe,GAAE,MAAU,GAC1B,OAAO,CAAC,2BAA2B,GAAG,IAAI,CAAC;IA4B9C;;OAEG;IACG,aAAa,CAAC,KAAK,EAAE,YAAY,GAAG,OAAO,CAAC,mBAAmB,EAAE,CAAC;IA0CxE;;OAEG;IACG,QAAQ,IAAI,OAAO,CAAC,uBAAuB,CAAC;IAsElD;;OAEG;YACW,cAAc;IAoB5B;;OAEG;YACW,qBAAqB;IA0CnC;;OAEG;IACH,OAAO,CAAC,eAAe;IAgBvB;;OAEG;YACW,kBAAkB;IA+ChC;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAMzB;;OAEG;IACH,OAAO,CAAC,cAAc;IAMtB;;OAEG;IACH,mBAAmB,IAAI,MAAM,GAAG,IAAI;IAIpC;;OAEG;IACH,iBAAiB,IAAI,mBAAmB,GAAG,IAAI;CAGhD"}