mcp-adr-analysis-server 2.0.9 → 2.0.10

package/dist/src/utils/knowledge-graph-manager.d.ts

@@ -0,0 +1,28 @@
+import { IntentSnapshot, TodoSyncState, KnowledgeGraphSnapshot } from '../types/knowledge-graph-schemas.js';
+export declare class KnowledgeGraphManager {
+    private cacheDir;
+    private snapshotsFile;
+    private syncStateFile;
+    constructor();
+    ensureCacheDirectory(): Promise<void>;
+    loadKnowledgeGraph(): Promise<KnowledgeGraphSnapshot>;
+    saveKnowledgeGraph(snapshot: KnowledgeGraphSnapshot): Promise<void>;
+    createIntent(humanRequest: string, parsedGoals: string[], priority?: 'high' | 'medium' | 'low'): Promise<string>;
+    addToolExecution(intentId: string, toolName: string, parameters: Record<string, any>, result: Record<string, any>, success: boolean, todoTasksCreated?: string[], todoTasksModified?: string[], error?: string): Promise<void>;
+    updateIntentStatus(intentId: string, status: 'planning' | 'executing' | 'completed' | 'failed'): Promise<void>;
+    updateTodoSnapshot(intentId: string, todoContent: string): Promise<void>;
+    getSyncState(): Promise<TodoSyncState>;
+    updateSyncState(updates: Partial<TodoSyncState>): Promise<void>;
+    getIntentById(intentId: string): Promise<IntentSnapshot | null>;
+    getActiveIntents(): Promise<IntentSnapshot[]>;
+    getIntentsByStatus(status: 'planning' | 'executing' | 'completed' | 'failed'): Promise<IntentSnapshot[]>;
+    private getDefaultSyncState;
+    private updateAnalytics;
+    calculateTodoMdHash(todoPath: string): Promise<string>;
+    detectTodoChanges(todoPath: string): Promise<{
+        hasChanges: boolean;
+        currentHash: string;
+        lastHash: string;
+    }>;
+}
+//# sourceMappingURL=knowledge-graph-manager.d.ts.map

package/dist/src/utils/knowledge-graph-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"knowledge-graph-manager.d.ts","sourceRoot":"","sources":["../../../src/utils/knowledge-graph-manager.ts"],"names":[],"mappings":"AAGA,OAAO,EACL,cAAc,EAEd,aAAa,EACb,sBAAsB,EAGvB,MAAM,qCAAqC,CAAC;AAG7C,qBAAa,qBAAqB;IAChC,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,aAAa,CAAS;IAC9B,OAAO,CAAC,aAAa,CAAS;;IASxB,oBAAoB,IAAI,OAAO,CAAC,IAAI,CAAC;IAQrC,kBAAkB,IAAI,OAAO,CAAC,sBAAsB,CAAC;IA2BrD,kBAAkB,CAAC,QAAQ,EAAE,sBAAsB,GAAG,OAAO,CAAC,IAAI,CAAC;IAKnE,YAAY,CAChB,YAAY,EAAE,MAAM,EACpB,WAAW,EAAE,MAAM,EAAE,EACrB,QAAQ,GAAE,MAAM,GAAG,QAAQ,GAAG,KAAgB,GAC7C,OAAO,CAAC,MAAM,CAAC;IAwBZ,gBAAgB,CACpB,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAC/B,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAC3B,OAAO,EAAE,OAAO,EAChB,gBAAgB,GAAE,MAAM,EAAO,EAC/B,iBAAiB,GAAE,MAAM,EAAO,EAChC,KAAK,CAAC,EAAE,MAAM,GACb,OAAO,CAAC,IAAI,CAAC;IA0BV,kBAAkB,CACtB,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,UAAU,GAAG,WAAW,GAAG,WAAW,GAAG,QAAQ,GACxD,OAAO,CAAC,IAAI,CAAC;IAaV,kBAAkB,CAAC,QAAQ,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAYxE,YAAY,IAAI,OAAO,CAAC,aAAa,CAAC;IAUtC,eAAe,CAAC,OAAO,EAAE,OAAO,CAAC,aAAa,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAU/D,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC;IAK/D,gBAAgB,IAAI,OAAO,CAAC,cAAc,EAAE,CAAC;IAK7C,kBAAkB,CAAC,MAAM,EAAE,UAAU,GAAG,WAAW,GAAG,WAAW,GAAG,QAAQ,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC;YAKhG,mBAAmB;IAWjC,OAAO,CAAC,eAAe;IAwBjB,mBAAmB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAStD,iBAAiB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC;QACjD,UAAU,EAAE,OAAO,CAAC;QACpB,WAAW,EAAE,MAAM,CAAC;QACpB,QAAQ,EAAE,MAAM,CAAC;KAClB,CAAC;CAUH"}

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

@@ -0,0 +1,192 @@
+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';
+export class KnowledgeGraphManager {
+    cacheDir;
+    snapshotsFile;
+    syncStateFile;
+    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');
+    }
+    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 defaultSnapshot = {
+                version: '1.0.0',
+                timestamp: new Date().toISOString(),
+                intents: [],
+                todoSyncState: await this.getDefaultSyncState(),
+                analytics: {
+                    totalIntents: 0,
+                    completedIntents: 0,
+                    activeIntents: 0,
+                    averageGoalCompletion: 0,
+                    mostUsedTools: [],
+                    successfulPatterns: []
+                }
+            };
+            await this.saveKnowledgeGraph(defaultSnapshot);
+            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();
+        const intent = {
+            intentId,
+            humanRequest,
+            parsedGoals,
+            priority,
+            timestamp,
+            toolChain: [],
+            currentStatus: 'planning',
+            todoMdSnapshot: ''
+        };
+        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;
+        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`);
+        }
+        const execution = {
+            toolName,
+            parameters,
+            result,
+            todoTasksCreated,
+            todoTasksModified,
+            executionTime: new Date().toISOString(),
+            success,
+            error
+        };
+        intent.toolChain.push(execution);
+        intent.currentStatus = success ? 'executing' : 'failed';
+        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
+        };
+    }
+}
+//# 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":"AAAA,OAAO,KAAK,EAAE,MAAM,aAAa,CAAC;AAClC,OAAO,IAAI,MAAM,MAAM,CAAC;AACxB,OAAO,MAAM,MAAM,QAAQ,CAAC;AAC5B,OAAO,EAKL,mBAAmB,EACnB,4BAA4B,EAC7B,MAAM,qCAAqC,CAAC;AAC7C,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAEzC,MAAM,OAAO,qBAAqB;IACxB,QAAQ,CAAS;IACjB,aAAa,CAAS;IACtB,aAAa,CAAS;IAE9B;QACE,MAAM,MAAM,GAAG,UAAU,EAAE,CAAC;QAC5B,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,WAAW,EAAE,gBAAgB,CAAC,CAAC;QAChE,IAAI,CAAC,aAAa,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,gCAAgC,CAAC,CAAC;QAChF,IAAI,CAAC,aAAa,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,sBAAsB,CAAC,CAAC;IACxE,CAAC;IAED,KAAK,CAAC,oBAAoB;QACxB,IAAI,CAAC;YACH,MAAM,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QACjC,CAAC;QAAC,MAAM,CAAC;YACP,MAAM,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,QAAQ,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QACrD,CAAC;IACH,CAAC;IAED,KAAK,CAAC,kBAAkB;QACtB,MAAM,IAAI,CAAC,oBAAoB,EAAE,CAAC;QAElC,IAAI,CAAC;YACH,MAAM,IAAI,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,aAAa,EAAE,OAAO,CAAC,CAAC;YAC5D,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;YAChC,OAAO,4BAA4B,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;QACpD,CAAC;QAAC,MAAM,CAAC;YACP,MAAM,eAAe,GAA2B;gBAC9C,OAAO,EAAE,OAAO;gBAChB,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;gBACnC,OAAO,EAAE,EAAE;gBACX,aAAa,EAAE,MAAM,IAAI,CAAC,mBAAmB,EAAE;gBAC/C,SAAS,EAAE;oBACT,YAAY,EAAE,CAAC;oBACf,gBAAgB,EAAE,CAAC;oBACnB,aAAa,EAAE,CAAC;oBAChB,qBAAqB,EAAE,CAAC;oBACxB,aAAa,EAAE,EAAE;oBACjB,kBAAkB,EAAE,EAAE;iBACvB;aACF,CAAC;YACF,MAAM,IAAI,CAAC,kBAAkB,CAAC,eAAe,CAAC,CAAC;YAC/C,OAAO,eAAe,CAAC;QACzB,CAAC;IACH,CAAC;IAED,KAAK,CAAC,kBAAkB,CAAC,QAAgC;QACvD,MAAM,IAAI,CAAC,oBAAoB,EAAE,CAAC;QAClC,MAAM,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,aAAa,EAAE,IAAI,CAAC,SAAS,CAAC,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;IAC5E,CAAC;IAED,KAAK,CAAC,YAAY,CAChB,YAAoB,EACpB,WAAqB,EACrB,WAAsC,QAAQ;QAE9C,MAAM,QAAQ,GAAG,MAAM,CAAC,UAAU,EAAE,CAAC;QACrC,MAAM,SAAS,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;QAE3C,MAAM,MAAM,GAAmB;YAC7B,QAAQ;YACR,YAAY;YACZ,WAAW;YACX,QAAQ;YACR,SAAS;YACT,SAAS,EAAE,EAAE;YACb,aAAa,EAAE,UAAU;YACzB,cAAc,EAAE,EAAE;SACnB,CAAC;QAEF,MAAM,EAAE,GAAG,MAAM,IAAI,CAAC,kBAAkB,EAAE,CAAC;QAC3C,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QACxB,EAAE,CAAC,SAAS,CAAC,YAAY,GAAG,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC;QAC9C,EAAE,CAAC,SAAS,CAAC,aAAa,GAAG,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,aAAa,KAAK,WAAW,CAAC,CAAC,MAAM,CAAC;QAE5F,MAAM,IAAI,CAAC,kBAAkB,CAAC,EAAE,CAAC,CAAC;QAClC,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED,KAAK,CAAC,gBAAgB,CACpB,QAAgB,EAChB,QAAgB,EAChB,UAA+B,EAC/B,MAA2B,EAC3B,OAAgB,EAChB,mBAA6B,EAAE,EAC/B,oBAA8B,EAAE,EAChC,KAAc;QAEd,MAAM,EAAE,GAAG,MAAM,IAAI,CAAC,kBAAkB,EAAE,CAAC;QAC3C,MAAM,MAAM,GAAG,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,QAAQ,KAAK,QAAQ,CAAC,CAAC;QAE7D,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,MAAM,IAAI,KAAK,CAAC,UAAU,QAAQ,YAAY,CAAC,CAAC;QAClD,CAAC;QAED,MAAM,SAAS,GAA0B;YACvC,QAAQ;YACR,UAAU;YACV,MAAM;YACN,gBAAgB;YAChB,iBAAiB;YACjB,aAAa,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;YACvC,OAAO;YACP,KAAK;SACN,CAAC;QAEF,MAAM,CAAC,SAAS,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QACjC,MAAM,CAAC,aAAa,GAAG,OAAO,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,QAAQ,CAAC;QAExD,IAAI,CAAC,eAAe,CAAC,EAAE,CAAC,CAAC;QACzB,MAAM,IAAI,CAAC,kBAAkB,CAAC,EAAE,CAAC,CAAC;IACpC,CAAC;IAED,KAAK,CAAC,kBAAkB,CACtB,QAAgB,EAChB,MAAyD;QAEzD,MAAM,EAAE,GAAG,MAAM,IAAI,CAAC,kBAAkB,EAAE,CAAC;QAC3C,MAAM,MAAM,GAAG,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,QAAQ,KAAK,QAAQ,CAAC,CAAC;QAE7D,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,MAAM,IAAI,KAAK,CAAC,UAAU,QAAQ,YAAY,CAAC,CAAC;QAClD,CAAC;QAED,MAAM,CAAC,aAAa,GAAG,MAAM,CAAC;QAC9B,IAAI,CAAC,eAAe,CAAC,EAAE,CAAC,CAAC;QACzB,MAAM,IAAI,CAAC,kBAAkB,CAAC,EAAE,CAAC,CAAC;IACpC,CAAC;IAED,KAAK,CAAC,kBAAkB,CAAC,QAAgB,EAAE,WAAmB;QAC5D,MAAM,EAAE,GAAG,MAAM,IAAI,CAAC,kBAAkB,EAAE,CAAC;QAC3C,MAAM,MAAM,GAAG,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,QAAQ,KAAK,QAAQ,CAAC,CAAC;QAE7D,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,MAAM,IAAI,KAAK,CAAC,UAAU,QAAQ,YAAY,CAAC,CAAC;QAClD,CAAC;QAED,MAAM,CAAC,cAAc,GAAG,WAAW,CAAC;QACpC,MAAM,IAAI,CAAC,kBAAkB,CAAC,EAAE,CAAC,CAAC;IACpC,CAAC;IAED,KAAK,CAAC,YAAY;QAChB,IAAI,CAAC;YACH,MAAM,IAAI,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,aAAa,EAAE,OAAO,CAAC,CAAC;YAC5D,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;YAChC,OAAO,mBAAmB,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;QAC3C,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,IAAI,CAAC,mBAAmB,EAAE,CAAC;QACpC,CAAC;IACH,CAAC;IAED,KAAK,CAAC,eAAe,CAAC,OAA+B;QACnD,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,YAAY,EAAE,CAAC;QAC1C,MAAM,OAAO,GAAG,EAAE,GAAG,OAAO,EAAE,GAAG,OAAO,EAAE,CAAC;QAC3C,MAAM,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,aAAa,EAAE,IAAI,CAAC,SAAS,CAAC,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;QAEzE,MAAM,EAAE,GAAG,MAAM,IAAI,CAAC,kBAAkB,EAAE,CAAC;QAC3C,EAAE,CAAC,aAAa,GAAG,OAAO,CAAC;QAC3B,MAAM,IAAI,CAAC,kBAAkB,CAAC,EAAE,CAAC,CAAC;IACpC,CAAC;IAED,KAAK,CAAC,aAAa,CAAC,QAAgB;QAClC,MAAM,EAAE,GAAG,MAAM,IAAI,CAAC,kBAAkB,EAAE,CAAC;QAC3C,OAAO,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,QAAQ,KAAK,QAAQ,CAAC,IAAI,IAAI,CAAC;IAC/D,CAAC;IAED,KAAK,CAAC,gBAAgB;QACpB,MAAM,EAAE,GAAG,MAAM,IAAI,CAAC,kBAAkB,EAAE,CAAC;QAC3C,OAAO,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,aAAa,KAAK,WAAW,IAAI,CAAC,CAAC,aAAa,KAAK,QAAQ,CAAC,CAAC;IACjG,CAAC;IAED,KAAK,CAAC,kBAAkB,CAAC,MAAyD;QAChF,MAAM,EAAE,GAAG,MAAM,IAAI,CAAC,kBAAkB,EAAE,CAAC;QAC3C,OAAO,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,aAAa,KAAK,MAAM,CAAC,CAAC;IAC5D,CAAC;IAEO,KAAK,CAAC,mBAAmB;QAC/B,OAAO;YACL,iBAAiB,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;YAC3C,UAAU,EAAE,EAAE;YACd,kBAAkB,EAAE,EAAE;YACtB,UAAU,EAAE,QAAQ;YACpB,cAAc,EAAE,MAAM;YACtB,OAAO,EAAE,CAAC;SACX,CAAC;IACJ,CAAC;IAEO,eAAe,CAAC,EAA0B;QAChD,MAAM,OAAO,GAAG,EAAE,CAAC,OAAO,CAAC;QAE3B,EAAE,CAAC,SAAS,CAAC,YAAY,GAAG,OAAO,CAAC,MAAM,CAAC;QAC3C,EAAE,CAAC,SAAS,CAAC,gBAAgB,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,aAAa,KAAK,WAAW,CAAC,CAAC,MAAM,CAAC;QAC5F,EAAE,CAAC,SAAS,CAAC,aAAa,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,aAAa,KAAK,WAAW,IAAI,CAAC,CAAC,aAAa,KAAK,QAAQ,CAAC,CAAC,MAAM,CAAC;QAEzH,IAAI,EAAE,CAAC,SAAS,CAAC,YAAY,GAAG,CAAC,EAAE,CAAC;YAClC,EAAE,CAAC,SAAS,CAAC,qBAAqB,GAAG,EAAE,CAAC,SAAS,CAAC,gBAAgB,GAAG,EAAE,CAAC,SAAS,CAAC,YAAY,CAAC;QACjG,CAAC;QAED,MAAM,SAAS,GAAG,IAAI,GAAG,EAAkB,CAAC;QAC5C,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE;YACvB,MAAM,CAAC,SAAS,CAAC,OAAO,CAAC,SAAS,CAAC,EAAE;gBACnC,SAAS,CAAC,GAAG,CAAC,SAAS,CAAC,QAAQ,EAAE,CAAC,SAAS,CAAC,GAAG,CAAC,SAAS,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;YAClF,CAAC,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,SAAS,CAAC,aAAa,GAAG,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,OAAO,EAAE,CAAC;aACzD,GAAG,CAAC,CAAC,CAAC,QAAQ,EAAE,UAAU,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,QAAQ,EAAE,UAAU,EAAE,CAAC,CAAC;aAC3D,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,UAAU,GAAG,CAAC,CAAC,UAAU,CAAC;aAC3C,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IAClB,CAAC;IAED,KAAK,CAAC,mBAAmB,CAAC,QAAgB;QACxC,IAAI,CAAC;YACH,MAAM,OAAO,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;YACrD,OAAO,MAAM,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QACnE,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,EAAE,CAAC;QACZ,CAAC;IACH,CAAC;IAED,KAAK,CAAC,iBAAiB,CAAC,QAAgB;QAKtC,MAAM,SAAS,GAAG,MAAM,IAAI,CAAC,YAAY,EAAE,CAAC;QAC5C,MAAM,WAAW,GAAG,MAAM,IAAI,CAAC,mBAAmB,CAAC,QAAQ,CAAC,CAAC;QAE7D,OAAO;YACL,UAAU,EAAE,WAAW,KAAK,SAAS,CAAC,UAAU;YAChD,WAAW;YACX,QAAQ,EAAE,SAAS,CAAC,UAAU;SAC/B,CAAC;IACJ,CAAC;CACF"}

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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"}

package/dist/src/utils/project-health-scoring.d.ts

@@ -0,0 +1,177 @@
+/**
+ * Dynamic Project Health Scoring System
+ * Aggregates scores from multiple MCP tools to provide real-time project health assessment
+ */
+export interface ProjectHealthScore {
+    overall: number;
+    taskCompletion: number;
+    deploymentReadiness: number;
+    architectureCompliance: number;
+    securityPosture: number;
+    codeQuality: number;
+    confidence: number;
+    lastUpdated: string;
+    influencingTools: string[];
+    breakdown: ScoreBreakdown;
+}
+export interface ScoreBreakdown {
+    taskCompletion: TaskCompletionScore;
+    deploymentReadiness: DeploymentReadinessScore;
+    architectureCompliance: ArchitectureComplianceScore;
+    securityPosture: SecurityPostureScore;
+    codeQuality: CodeQualityScore;
+}
+export interface TaskCompletionScore {
+    completed: number;
+    total: number;
+    percentage: number;
+    priorityWeightedScore: number;
+    criticalTasksRemaining: number;
+    lastUpdated: string;
+}
+export interface DeploymentReadinessScore {
+    releaseScore: number;
+    milestoneCompletion: number;
+    criticalBlockers: number;
+    warningBlockers: number;
+    gitHealthScore: number;
+    lastUpdated: string;
+}
+export interface ArchitectureComplianceScore {
+    adrImplementationScore: number;
+    mockVsProductionScore: number;
+    environmentAlignmentScore: number;
+    lastUpdated: string;
+}
+export interface SecurityPostureScore {
+    secretExposureRisk: number;
+    contentMaskingEffectiveness: number;
+    vulnerabilityCount: number;
+    lastUpdated: string;
+}
+export interface CodeQualityScore {
+    ruleViolations: number;
+    patternAdherence: number;
+    technicalDebtScore: number;
+    lastUpdated: string;
+}
+export interface ScoringWeights {
+    taskCompletion: number;
+    deploymentReadiness: number;
+    architectureCompliance: number;
+    securityPosture: number;
+    codeQuality: number;
+}
+export declare class ProjectHealthScoring {
+    private scoringCachePath;
+    private weights;
+    constructor(projectPath: string, weights?: Partial<ScoringWeights>);
+    /**
+     * Get current project health score
+     */
+    getProjectHealthScore(): Promise<ProjectHealthScore>;
+    /**
+     * Update task completion score (called by TODO management tools)
+     */
+    updateTaskCompletionScore(taskData: {
+        completed: number;
+        total: number;
+        criticalTasksRemaining: number;
+        priorityWeightedScore: number;
+    }): Promise<void>;
+    /**
+     * Update deployment readiness score (called by smart_git_push)
+     */
+    updateDeploymentReadinessScore(deploymentData: {
+        releaseScore: number;
+        milestoneCompletion: number;
+        criticalBlockers: number;
+        warningBlockers: number;
+        gitHealthScore: number;
+    }): Promise<void>;
+    /**
+     * Update architecture compliance score (called by compare_adr_progress)
+     */
+    updateArchitectureComplianceScore(architectureData: {
+        adrImplementationScore: number;
+        mockVsProductionScore: number;
+        environmentAlignmentScore: number;
+    }): Promise<void>;
+    /**
+     * Update security posture score (called by content security tools)
+     */
+    updateSecurityPostureScore(securityData: {
+        secretExposureRisk: number;
+        contentMaskingEffectiveness: number;
+        vulnerabilityCount: number;
+    }): Promise<void>;
+    /**
+     * Update code quality score (called by rule validation tools)
+     */
+    updateCodeQualityScore(codeQualityData: {
+        ruleViolations: number;
+        patternAdherence: number;
+        technicalDebtScore: number;
+    }): Promise<void>;
+    /**
+     * Calculate overall weighted score
+     */
+    private calculateOverallScore;
+    /**
+     * Calculate task completion score with priority weighting
+     */
+    private calculateTaskCompletionScore;
+    /**
+     * Calculate deployment readiness score
+     */
+    private calculateDeploymentReadinessScore;
+    /**
+     * Calculate architecture compliance score
+     */
+    private calculateArchitectureComplianceScore;
+    /**
+     * Calculate security posture score
+     */
+    private calculateSecurityPostureScore;
+    /**
+     * Calculate code quality score
+     */
+    private calculateCodeQualityScore;
+    /**
+     * Calculate confidence in overall score
+     */
+    private calculateConfidence;
+    /**
+     * Initialize default score structure
+     */
+    private initializeScore;
+    /**
+     * Update overall score and save
+     */
+    private updateOverallScore;
+    /**
+     * Add tool to influencing tools list
+     */
+    private addInfluencingTool;
+    /**
+     * Load cached score from file
+     */
+    private loadCachedScore;
+    /**
+     * Save score to cache
+     */
+    private saveCachedScore;
+    /**
+     * Generate formatted score display for TODO.md header
+     */
+    generateScoreDisplay(): Promise<string>;
+    /**
+     * Get emoji for score level
+     */
+    private getScoreEmoji;
+    /**
+     * Get emoji for confidence level
+     */
+    private getConfidenceEmoji;
+}
+//# sourceMappingURL=project-health-scoring.d.ts.map

package/dist/src/utils/project-health-scoring.d.ts.map

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