mcp-adr-analysis-server 2.0.9 → 2.0.11

package/dist/src/utils/knowledge-graph-manager.js

@@ -0,0 +1,358 @@
+import * as fs from 'fs/promises';
+import path from 'path';
+import crypto from 'crypto';
+import { TodoSyncStateSchema, KnowledgeGraphSnapshotSchema } from '../types/knowledge-graph-schemas.js';
+import { loadConfig } from './config.js';
+import { ProjectHealthScoring } from './project-health-scoring.js';
+export class KnowledgeGraphManager {
+    cacheDir;
+    snapshotsFile;
+    syncStateFile;
+    healthScoring;
+    constructor() {
+        const config = loadConfig();
+        this.cacheDir = path.join(config.projectPath, '.mcp-adr-cache');
+        this.snapshotsFile = path.join(this.cacheDir, 'knowledge-graph-snapshots.json');
+        this.syncStateFile = path.join(this.cacheDir, 'todo-sync-state.json');
+        this.healthScoring = new ProjectHealthScoring(config.projectPath);
+    }
+    async ensureCacheDirectory() {
+        try {
+            await fs.access(this.cacheDir);
+        }
+        catch {
+            await fs.mkdir(this.cacheDir, { recursive: true });
+        }
+    }
+    async loadKnowledgeGraph() {
+        await this.ensureCacheDirectory();
+        try {
+            const data = await fs.readFile(this.snapshotsFile, 'utf-8');
+            const parsed = JSON.parse(data);
+            return KnowledgeGraphSnapshotSchema.parse(parsed);
+        }
+        catch {
+            const defaultSyncState = await this.getDefaultSyncState();
+            const defaultSnapshot = {
+                version: '1.0.0',
+                timestamp: new Date().toISOString(),
+                intents: [],
+                todoSyncState: defaultSyncState,
+                analytics: {
+                    totalIntents: 0,
+                    completedIntents: 0,
+                    activeIntents: 0,
+                    averageGoalCompletion: 0,
+                    mostUsedTools: [],
+                    successfulPatterns: []
+                },
+                scoreHistory: []
+            };
+            await this.saveKnowledgeGraph(defaultSnapshot);
+            // Also create the separate sync state file
+            await fs.writeFile(this.syncStateFile, JSON.stringify(defaultSyncState, null, 2));
+            return defaultSnapshot;
+        }
+    }
+    async saveKnowledgeGraph(snapshot) {
+        await this.ensureCacheDirectory();
+        await fs.writeFile(this.snapshotsFile, JSON.stringify(snapshot, null, 2));
+    }
+    async createIntent(humanRequest, parsedGoals, priority = 'medium') {
+        const intentId = crypto.randomUUID();
+        const timestamp = new Date().toISOString();
+        // Get current score as baseline
+        const currentScore = await this.healthScoring.getProjectHealthScore();
+        const intent = {
+            intentId,
+            humanRequest,
+            parsedGoals,
+            priority,
+            timestamp,
+            toolChain: [],
+            currentStatus: 'planning',
+            todoMdSnapshot: '',
+            scoreTracking: {
+                initialScore: currentScore.overall,
+                currentScore: currentScore.overall,
+                componentScores: {
+                    taskCompletion: currentScore.taskCompletion,
+                    deploymentReadiness: currentScore.deploymentReadiness,
+                    architectureCompliance: currentScore.architectureCompliance,
+                    securityPosture: currentScore.securityPosture,
+                    codeQuality: currentScore.codeQuality
+                },
+                lastScoreUpdate: timestamp
+            }
+        };
+        const kg = await this.loadKnowledgeGraph();
+        kg.intents.push(intent);
+        kg.analytics.totalIntents = kg.intents.length;
+        kg.analytics.activeIntents = kg.intents.filter(i => i.currentStatus !== 'completed').length;
+        // Add score history entry
+        if (!kg.scoreHistory)
+            kg.scoreHistory = [];
+        kg.scoreHistory.push({
+            timestamp,
+            intentId,
+            overallScore: currentScore.overall,
+            componentScores: {
+                taskCompletion: currentScore.taskCompletion,
+                deploymentReadiness: currentScore.deploymentReadiness,
+                architectureCompliance: currentScore.architectureCompliance,
+                securityPosture: currentScore.securityPosture,
+                codeQuality: currentScore.codeQuality
+            },
+            triggerEvent: `Intent created: ${humanRequest.substring(0, 100)}...`,
+            confidence: currentScore.confidence
+        });
+        await this.saveKnowledgeGraph(kg);
+        return intentId;
+    }
+    async addToolExecution(intentId, toolName, parameters, result, success, todoTasksCreated = [], todoTasksModified = [], error) {
+        const kg = await this.loadKnowledgeGraph();
+        const intent = kg.intents.find(i => i.intentId === intentId);
+        if (!intent) {
+            throw new Error(`Intent ${intentId} not found`);
+        }
+        // Capture before score
+        const beforeScore = await this.healthScoring.getProjectHealthScore();
+        const execution = {
+            toolName,
+            parameters,
+            result,
+            todoTasksCreated,
+            todoTasksModified,
+            executionTime: new Date().toISOString(),
+            success,
+            error
+        };
+        intent.toolChain.push(execution);
+        intent.currentStatus = success ? 'executing' : 'failed';
+        // Update scores after tool execution and capture impact
+        await this.updateScoreTracking(intentId, toolName, beforeScore, execution);
+        this.updateAnalytics(kg);
+        await this.saveKnowledgeGraph(kg);
+    }
+    async updateIntentStatus(intentId, status) {
+        const kg = await this.loadKnowledgeGraph();
+        const intent = kg.intents.find(i => i.intentId === intentId);
+        if (!intent) {
+            throw new Error(`Intent ${intentId} not found`);
+        }
+        intent.currentStatus = status;
+        this.updateAnalytics(kg);
+        await this.saveKnowledgeGraph(kg);
+    }
+    async updateTodoSnapshot(intentId, todoContent) {
+        const kg = await this.loadKnowledgeGraph();
+        const intent = kg.intents.find(i => i.intentId === intentId);
+        if (!intent) {
+            throw new Error(`Intent ${intentId} not found`);
+        }
+        intent.todoMdSnapshot = todoContent;
+        await this.saveKnowledgeGraph(kg);
+    }
+    async getSyncState() {
+        try {
+            const data = await fs.readFile(this.syncStateFile, 'utf-8');
+            const parsed = JSON.parse(data);
+            return TodoSyncStateSchema.parse(parsed);
+        }
+        catch {
+            return this.getDefaultSyncState();
+        }
+    }
+    async updateSyncState(updates) {
+        const current = await this.getSyncState();
+        const updated = { ...current, ...updates };
+        await fs.writeFile(this.syncStateFile, JSON.stringify(updated, null, 2));
+        const kg = await this.loadKnowledgeGraph();
+        kg.todoSyncState = updated;
+        await this.saveKnowledgeGraph(kg);
+    }
+    async getIntentById(intentId) {
+        const kg = await this.loadKnowledgeGraph();
+        return kg.intents.find(i => i.intentId === intentId) || null;
+    }
+    async getActiveIntents() {
+        const kg = await this.loadKnowledgeGraph();
+        return kg.intents.filter(i => i.currentStatus !== 'completed' && i.currentStatus !== 'failed');
+    }
+    async getIntentsByStatus(status) {
+        const kg = await this.loadKnowledgeGraph();
+        return kg.intents.filter(i => i.currentStatus === status);
+    }
+    async getDefaultSyncState() {
+        return {
+            lastSyncTimestamp: new Date().toISOString(),
+            todoMdHash: '',
+            knowledgeGraphHash: '',
+            syncStatus: 'synced',
+            lastModifiedBy: 'tool',
+            version: 1
+        };
+    }
+    updateAnalytics(kg) {
+        const intents = kg.intents;
+        kg.analytics.totalIntents = intents.length;
+        kg.analytics.completedIntents = intents.filter(i => i.currentStatus === 'completed').length;
+        kg.analytics.activeIntents = intents.filter(i => i.currentStatus !== 'completed' && i.currentStatus !== 'failed').length;
+        if (kg.analytics.totalIntents > 0) {
+            kg.analytics.averageGoalCompletion = kg.analytics.completedIntents / kg.analytics.totalIntents;
+        }
+        const toolUsage = new Map();
+        intents.forEach(intent => {
+            intent.toolChain.forEach(execution => {
+                toolUsage.set(execution.toolName, (toolUsage.get(execution.toolName) || 0) + 1);
+            });
+        });
+        kg.analytics.mostUsedTools = Array.from(toolUsage.entries())
+            .map(([toolName, usageCount]) => ({ toolName, usageCount }))
+            .sort((a, b) => b.usageCount - a.usageCount)
+            .slice(0, 10);
+    }
+    async calculateTodoMdHash(todoPath) {
+        try {
+            const content = await fs.readFile(todoPath, 'utf-8');
+            return crypto.createHash('sha256').update(content).digest('hex');
+        }
+        catch {
+            return '';
+        }
+    }
+    async detectTodoChanges(todoPath) {
+        const syncState = await this.getSyncState();
+        const currentHash = await this.calculateTodoMdHash(todoPath);
+        return {
+            hasChanges: currentHash !== syncState.todoMdHash,
+            currentHash,
+            lastHash: syncState.todoMdHash
+        };
+    }
+    /**
+     * Update score tracking for an intent after tool execution
+     */
+    async updateScoreTracking(intentId, toolName, beforeScore, execution) {
+        const kg = await this.loadKnowledgeGraph();
+        const intent = kg.intents.find(i => i.intentId === intentId);
+        if (!intent)
+            return;
+        // Get current score after tool execution
+        const afterScore = await this.healthScoring.getProjectHealthScore();
+        // Calculate score impact
+        const scoreImpact = {
+            beforeScore: beforeScore.overall,
+            afterScore: afterScore.overall,
+            componentImpacts: {
+                taskCompletion: afterScore.taskCompletion - beforeScore.taskCompletion,
+                deploymentReadiness: afterScore.deploymentReadiness - beforeScore.deploymentReadiness,
+                architectureCompliance: afterScore.architectureCompliance - beforeScore.architectureCompliance,
+                securityPosture: afterScore.securityPosture - beforeScore.securityPosture,
+                codeQuality: afterScore.codeQuality - beforeScore.codeQuality
+            },
+            scoreConfidence: afterScore.confidence
+        };
+        // Update execution with score impact
+        execution.scoreImpact = scoreImpact;
+        // Update intent score tracking
+        if (intent.scoreTracking) {
+            intent.scoreTracking.currentScore = afterScore.overall;
+            intent.scoreTracking.componentScores = {
+                taskCompletion: afterScore.taskCompletion,
+                deploymentReadiness: afterScore.deploymentReadiness,
+                architectureCompliance: afterScore.architectureCompliance,
+                securityPosture: afterScore.securityPosture,
+                codeQuality: afterScore.codeQuality
+            };
+            intent.scoreTracking.lastScoreUpdate = new Date().toISOString();
+            // Calculate progress if we have initial score
+            if (intent.scoreTracking.initialScore !== undefined) {
+                const initialScore = intent.scoreTracking.initialScore;
+                const targetScore = intent.scoreTracking.targetScore || 100;
+                const currentScore = afterScore.overall;
+                // Calculate progress as percentage of improvement toward target
+                const totalPossibleImprovement = targetScore - initialScore;
+                const actualImprovement = currentScore - initialScore;
+                intent.scoreTracking.scoreProgress = totalPossibleImprovement > 0
+                    ? Math.min(100, (actualImprovement / totalPossibleImprovement) * 100)
+                    : 0;
+            }
+        }
+        // Add to score history
+        if (!kg.scoreHistory)
+            kg.scoreHistory = [];
+        kg.scoreHistory.push({
+            timestamp: new Date().toISOString(),
+            intentId,
+            overallScore: afterScore.overall,
+            componentScores: {
+                taskCompletion: afterScore.taskCompletion,
+                deploymentReadiness: afterScore.deploymentReadiness,
+                architectureCompliance: afterScore.architectureCompliance,
+                securityPosture: afterScore.securityPosture,
+                codeQuality: afterScore.codeQuality
+            },
+            triggerEvent: `Tool executed: ${toolName}`,
+            confidence: afterScore.confidence
+        });
+        // Keep only last 100 score history entries
+        if (kg.scoreHistory.length > 100) {
+            kg.scoreHistory = kg.scoreHistory.slice(-100);
+        }
+    }
+    /**
+     * Get score trends for an intent
+     */
+    async getIntentScoreTrends(intentId) {
+        const kg = await this.loadKnowledgeGraph();
+        const intent = kg.intents.find(i => i.intentId === intentId);
+        if (!intent?.scoreTracking) {
+            throw new Error(`Intent ${intentId} not found or has no score tracking`);
+        }
+        const scoreHistory = kg.scoreHistory?.filter(h => h.intentId === intentId) || [];
+        return {
+            initialScore: intent.scoreTracking.initialScore || 0,
+            currentScore: intent.scoreTracking.currentScore || 0,
+            progress: intent.scoreTracking.scoreProgress || 0,
+            componentTrends: intent.scoreTracking.componentScores || {},
+            scoreHistory: scoreHistory.map(h => ({
+                timestamp: h.timestamp,
+                score: h.overallScore,
+                triggerEvent: h.triggerEvent
+            }))
+        };
+    }
+    /**
+     * Get overall project score trends
+     */
+    async getProjectScoreTrends() {
+        const kg = await this.loadKnowledgeGraph();
+        const currentScore = await this.healthScoring.getProjectHealthScore();
+        const scoreHistory = kg.scoreHistory || [];
+        const intentImpacts = kg.intents
+            .filter(i => i.scoreTracking?.initialScore !== undefined && i.scoreTracking?.currentScore !== undefined)
+            .map(i => ({
+            intentId: i.intentId,
+            humanRequest: i.humanRequest,
+            scoreImprovement: (i.scoreTracking.currentScore - i.scoreTracking.initialScore)
+        }))
+            .sort((a, b) => b.scoreImprovement - a.scoreImprovement)
+            .slice(0, 5);
+        const averageImprovement = intentImpacts.length > 0
+            ? intentImpacts.reduce((sum, i) => sum + i.scoreImprovement, 0) / intentImpacts.length
+            : 0;
+        return {
+            currentScore: currentScore.overall,
+            scoreHistory: scoreHistory.map(h => ({
+                timestamp: h.timestamp,
+                score: h.overallScore,
+                triggerEvent: h.triggerEvent,
+                ...(h.intentId && { intentId: h.intentId })
+            })),
+            averageImprovement,
+            topImpactingIntents: intentImpacts
+        };
+    }
+}
+//# sourceMappingURL=knowledge-graph-manager.js.map

package/dist/src/utils/knowledge-graph-manager.js.map

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

package/dist/src/utils/mcp-response-validator.d.ts

@@ -0,0 +1,30 @@
+/**
+ * MCP Response Validator
+ *
+ * Validates and sanitizes MCP tool responses to prevent JSON-RPC 2.0 parse errors
+ */
+export interface McpToolResponse {
+    content: Array<{
+        type: 'text' | 'image' | 'resource';
+        text?: string;
+        data?: string;
+        mimeType?: string;
+    }>;
+    isError?: boolean;
+}
+/**
+ * Validate and sanitize an MCP tool response
+ */
+export declare function validateMcpResponse(response: any): McpToolResponse;
+/**
+ * Validate that a response can be safely serialized as JSON-RPC 2.0
+ */
+export declare function validateJsonRpcSerialization(response: any): {
+    valid: boolean;
+    error?: string;
+};
+/**
+ * Safe wrapper for MCP tool functions
+ */
+export declare function safeMcpToolWrapper<T extends any[], R>(toolFunction: (...args: T) => Promise<R>, toolName: string): (...args: T) => Promise<McpToolResponse>;
+//# sourceMappingURL=mcp-response-validator.d.ts.map

package/dist/src/utils/mcp-response-validator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-response-validator.d.ts","sourceRoot":"","sources":["../../../src/utils/mcp-response-validator.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,KAAK,CAAC;QACb,IAAI,EAAE,MAAM,GAAG,OAAO,GAAG,UAAU,CAAC;QACpC,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,QAAQ,CAAC,EAAE,MAAM,CAAC;KACnB,CAAC,CAAC;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,GAAG,GAAG,eAAe,CAuClE;AAsHD;;GAEG;AACH,wBAAgB,4BAA4B,CAAC,QAAQ,EAAE,GAAG,GAAG;IAAE,KAAK,EAAE,OAAO,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,CA0B9F;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,CAAC,SAAS,GAAG,EAAE,EAAE,CAAC,EACnD,YAAY,EAAE,CAAC,GAAG,IAAI,EAAE,CAAC,KAAK,OAAO,CAAC,CAAC,CAAC,EACxC,QAAQ,EAAE,MAAM,IAEF,GAAG,MAAM,CAAC,KAAG,OAAO,CAAC,eAAe,CAAC,CAkBpD"}

package/dist/src/utils/mcp-response-validator.js

@@ -0,0 +1,197 @@
+/**
+ * MCP Response Validator
+ *
+ * Validates and sanitizes MCP tool responses to prevent JSON-RPC 2.0 parse errors
+ */
+/**
+ * Validate and sanitize an MCP tool response
+ */
+export function validateMcpResponse(response) {
+    try {
+        // Ensure response has the correct structure
+        if (!response || typeof response !== 'object') {
+            return createErrorResponse('Invalid response structure');
+        }
+        // Ensure content array exists
+        if (!Array.isArray(response.content)) {
+            return createErrorResponse('Response must have content array');
+        }
+        // Validate and sanitize each content item
+        const sanitizedContent = response.content.map((item, index) => {
+            try {
+                return sanitizeContentItem(item, index);
+            }
+            catch (error) {
+                console.error(`Error sanitizing content item ${index}:`, error);
+                return {
+                    type: 'text',
+                    text: `[Error: Could not render content item ${index}]`
+                };
+            }
+        });
+        // Test JSON serialization
+        const testSerialization = JSON.stringify({ content: sanitizedContent });
+        // Verify it can be parsed back
+        JSON.parse(testSerialization);
+        return {
+            content: sanitizedContent,
+            isError: response.isError || false
+        };
+    }
+    catch (error) {
+        console.error('Response validation failed:', error);
+        return createErrorResponse(`Response validation failed: ${error instanceof Error ? error.message : String(error)}`);
+    }
+}
+/**
+ * Sanitize a single content item
+ */
+function sanitizeContentItem(item, index) {
+    if (!item || typeof item !== 'object') {
+        throw new Error(`Content item ${index} is not an object`);
+    }
+    const type = item.type;
+    if (!type || !['text', 'image', 'resource'].includes(type)) {
+        throw new Error(`Content item ${index} has invalid type: ${type}`);
+    }
+    switch (type) {
+        case 'text':
+            return {
+                type: 'text',
+                text: sanitizeTextContent(item.text || '')
+            };
+        case 'image':
+            return {
+                type: 'image',
+                data: sanitizeBase64Content(item.data || ''),
+                mimeType: sanitizeMimeType(item.mimeType || 'image/png')
+            };
+        case 'resource':
+            return {
+                type: 'resource',
+                data: sanitizeTextContent(item.data || ''),
+                mimeType: sanitizeMimeType(item.mimeType || 'text/plain')
+            };
+        default:
+            throw new Error(`Unsupported content type: ${type}`);
+    }
+}
+/**
+ * Sanitize text content for JSON-RPC safety
+ */
+function sanitizeTextContent(text) {
+    if (typeof text !== 'string') {
+        text = String(text);
+    }
+    // Remove or escape problematic characters
+    return text
+        // Escape backslashes first
+        .replace(/\\/g, '\\\\')
+        // Escape double quotes
+        .replace(/"/g, '\\"')
+        // Handle control characters
+        .replace(/\n/g, '\\n')
+        .replace(/\r/g, '\\r')
+        .replace(/\t/g, '\\t')
+        // Remove or escape other control characters
+        .replace(/[\u0000-\u0008\u000B\u000C\u000E-\u001F\u007F-\u009F]/g, (char) => {
+        const code = char.charCodeAt(0);
+        switch (code) {
+            case 0x08: return '\\b';
+            case 0x0C: return '\\f';
+            default:
+                // Replace with safe placeholder for other control chars
+                return `[CTRL:${code.toString(16).padStart(2, '0')}]`;
+        }
+    })
+        // Limit length to prevent oversized responses
+        .slice(0, 1000000); // 1MB limit
+}
+/**
+ * Sanitize base64 content
+ */
+function sanitizeBase64Content(data) {
+    if (typeof data !== 'string') {
+        return '';
+    }
+    // Validate base64 format and remove invalid characters
+    return data.replace(/[^A-Za-z0-9+/=]/g, '').slice(0, 10000000); // 10MB limit
+}
+/**
+ * Sanitize MIME type
+ */
+function sanitizeMimeType(mimeType) {
+    if (typeof mimeType !== 'string') {
+        return 'text/plain';
+    }
+    // Only allow safe MIME types
+    const allowedMimeTypes = [
+        'text/plain', 'text/html', 'text/markdown', 'text/css', 'text/javascript',
+        'application/json', 'application/xml', 'application/yaml',
+        'image/png', 'image/jpeg', 'image/gif', 'image/svg+xml', 'image/webp'
+    ];
+    const sanitized = mimeType.toLowerCase().trim();
+    return allowedMimeTypes.includes(sanitized) ? sanitized : 'text/plain';
+}
+/**
+ * Create a safe error response
+ */
+function createErrorResponse(message) {
+    return {
+        content: [{
+                type: 'text',
+                text: sanitizeTextContent(`Error: ${message}`)
+            }],
+        isError: true
+    };
+}
+/**
+ * Validate that a response can be safely serialized as JSON-RPC 2.0
+ */
+export function validateJsonRpcSerialization(response) {
+    try {
+        // Test full JSON-RPC 2.0 structure
+        const jsonRpcResponse = {
+            jsonrpc: '2.0',
+            id: 1,
+            result: response
+        };
+        const serialized = JSON.stringify(jsonRpcResponse);
+        // Verify it can be parsed back
+        const parsed = JSON.parse(serialized);
+        // Verify structure is preserved
+        if (!parsed.result || !Array.isArray(parsed.result.content)) {
+            return { valid: false, error: 'Structure not preserved after serialization' };
+        }
+        return { valid: true };
+    }
+    catch (error) {
+        return {
+            valid: false,
+            error: `JSON-RPC serialization failed: ${error instanceof Error ? error.message : String(error)}`
+        };
+    }
+}
+/**
+ * Safe wrapper for MCP tool functions
+ */
+export function safeMcpToolWrapper(toolFunction, toolName) {
+    return async (...args) => {
+        try {
+            const result = await toolFunction(...args);
+            const validated = validateMcpResponse(result);
+            // Double-check JSON-RPC compatibility
+            const jsonRpcCheck = validateJsonRpcSerialization(validated);
+            if (!jsonRpcCheck.valid) {
+                console.error(`JSON-RPC validation failed for ${toolName}:`, jsonRpcCheck.error);
+                return createErrorResponse(`Tool response not JSON-RPC compatible: ${jsonRpcCheck.error}`);
+            }
+            return validated;
+        }
+        catch (error) {
+            console.error(`Error in ${toolName}:`, error);
+            return createErrorResponse(`Tool execution failed: ${error instanceof Error ? error.message : String(error)}`);
+        }
+    };
+}
+//# sourceMappingURL=mcp-response-validator.js.map

package/dist/src/utils/mcp-response-validator.js.map

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