mcp-adr-analysis-server 2.0.9 → 2.0.11

package/dist/src/utils/todo-file-watcher.d.ts

@@ -0,0 +1,26 @@
+export declare class TodoFileWatcher {
+    private kgManager;
+    private todoPath;
+    private watcherActive;
+    private lastKnownHash;
+    private pollInterval;
+    constructor(todoPath?: string);
+    startWatching(intervalMs?: number): Promise<void>;
+    stopWatching(): Promise<void>;
+    private checkForChanges;
+    private parseChanges;
+    private notifyActiveIntents;
+    manualSync(): Promise<{
+        changesDetected: boolean;
+        syncStatus: string;
+        activeIntentsNotified: number;
+    }>;
+    getWatcherStatus(): Promise<{
+        isActive: boolean;
+        todoPath: string;
+        lastKnownHash: string;
+        lastSyncTime: string;
+        syncStatus: string;
+    }>;
+}
+//# sourceMappingURL=todo-file-watcher.d.ts.map

package/dist/src/utils/todo-file-watcher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"todo-file-watcher.d.ts","sourceRoot":"","sources":["../../../src/utils/todo-file-watcher.ts"],"names":[],"mappings":"AAKA,qBAAa,eAAe;IAC1B,OAAO,CAAC,SAAS,CAAwB;IACzC,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,aAAa,CAAkB;IACvC,OAAO,CAAC,aAAa,CAAc;IACnC,OAAO,CAAC,YAAY,CAA+B;gBAEvC,QAAQ,CAAC,EAAE,MAAM;IAMvB,aAAa,CAAC,UAAU,GAAE,MAAa,GAAG,OAAO,CAAC,IAAI,CAAC;IAsBvD,YAAY,IAAI,OAAO,CAAC,IAAI,CAAC;YAerB,eAAe;YAsCf,YAAY;YA2CZ,mBAAmB;IAoC3B,UAAU,IAAI,OAAO,CAAC;QAC1B,eAAe,EAAE,OAAO,CAAC;QACzB,UAAU,EAAE,MAAM,CAAC;QACnB,qBAAqB,EAAE,MAAM,CAAC;KAC/B,CAAC;IA4CI,gBAAgB,IAAI,OAAO,CAAC;QAChC,QAAQ,EAAE,OAAO,CAAC;QAClB,QAAQ,EAAE,MAAM,CAAC;QACjB,aAAa,EAAE,MAAM,CAAC;QACtB,YAAY,EAAE,MAAM,CAAC;QACrB,UAAU,EAAE,MAAM,CAAC;KACpB,CAAC;CAaH"}

package/dist/src/utils/todo-file-watcher.js

@@ -0,0 +1,163 @@
+import * as fs from 'fs/promises';
+import path from 'path';
+import { KnowledgeGraphManager } from './knowledge-graph-manager.js';
+import { loadConfig } from './config.js';
+export class TodoFileWatcher {
+    kgManager;
+    todoPath;
+    watcherActive = false;
+    lastKnownHash = '';
+    pollInterval = null;
+    constructor(todoPath) {
+        this.kgManager = new KnowledgeGraphManager();
+        const config = loadConfig();
+        this.todoPath = todoPath || path.join(config.projectPath, 'TODO.md');
+    }
+    async startWatching(intervalMs = 2000) {
+        if (this.watcherActive) {
+            return;
+        }
+        this.watcherActive = true;
+        // Initialize with current hash
+        this.lastKnownHash = await this.kgManager.calculateTodoMdHash(this.todoPath);
+        // Start polling for changes
+        this.pollInterval = setInterval(async () => {
+            try {
+                await this.checkForChanges();
+            }
+            catch (error) {
+                console.error('Error checking TODO.md changes:', error);
+            }
+        }, intervalMs);
+        console.error(`[TodoFileWatcher] Started watching ${this.todoPath}`);
+    }
+    async stopWatching() {
+        if (!this.watcherActive) {
+            return;
+        }
+        this.watcherActive = false;
+        if (this.pollInterval) {
+            clearInterval(this.pollInterval);
+            this.pollInterval = null;
+        }
+        console.error(`[TodoFileWatcher] Stopped watching ${this.todoPath}`);
+    }
+    async checkForChanges() {
+        if (!this.watcherActive) {
+            return;
+        }
+        const detection = await this.kgManager.detectTodoChanges(this.todoPath);
+        if (detection.hasChanges) {
+            console.error(`[TodoFileWatcher] TODO.md changes detected`);
+            // Read the new content
+            let todoContent = '';
+            try {
+                todoContent = await fs.readFile(this.todoPath, 'utf-8');
+            }
+            catch (error) {
+                console.error(`[TodoFileWatcher] Error reading TODO.md:`, error);
+                return;
+            }
+            // Parse changes and extract task modifications
+            const changes = await this.parseChanges(this.lastKnownHash, detection.currentHash, todoContent);
+            // Update sync state
+            await this.kgManager.updateSyncState({
+                lastSyncTimestamp: new Date().toISOString(),
+                todoMdHash: detection.currentHash,
+                syncStatus: changes.length > 0 ? 'pending' : 'synced',
+                lastModifiedBy: 'human',
+                version: (await this.kgManager.getSyncState()).version + 1
+            });
+            // Notify active intents about TODO changes
+            await this.notifyActiveIntents(todoContent, changes);
+            this.lastKnownHash = detection.currentHash;
+        }
+    }
+    async parseChanges(oldHash, newHash, todoContent) {
+        const changes = [];
+        // Simple change detection by analyzing the TODO content
+        // In a more sophisticated implementation, this would diff the actual content
+        const lines = todoContent.split('\n');
+        const taskLines = lines.filter(line => line.trim().match(/^-\s*\[[\sx]\]/) ||
+            line.trim().match(/^\d+\.\s*\[[\sx]\]/) ||
+            line.trim().match(/^##\s+/) // Section headers
+        );
+        // For now, we'll create a generic change record
+        if (oldHash !== newHash && taskLines.length > 0) {
+            changes.push({
+                type: 'modified',
+                taskId: `todo-change-${Date.now()}`,
+                description: 'TODO.md content modified externally',
+                details: {
+                    taskCount: taskLines.length,
+                    timestamp: new Date().toISOString(),
+                    contentLength: todoContent.length
+                }
+            });
+        }
+        return changes;
+    }
+    async notifyActiveIntents(todoContent, changes) {
+        const activeIntents = await this.kgManager.getActiveIntents();
+        for (const intent of activeIntents) {
+            // Update TODO snapshot for each active intent
+            await this.kgManager.updateTodoSnapshot(intent.intentId, todoContent);
+            // Add a tool execution record for the TODO change
+            const changeDetails = changes.map(c => `${c.type}: ${c.description}`).join('; ');
+            await this.kgManager.addToolExecution(intent.intentId, 'todo_file_watcher_change_detected', { todoPath: this.todoPath }, {
+                changes: changes.length,
+                changeDetails,
+                todoContentLength: todoContent.length,
+                detectedAt: new Date().toISOString()
+            }, true, [], changes.map(c => c.taskId), undefined);
+        }
+    }
+    async manualSync() {
+        const detection = await this.kgManager.detectTodoChanges(this.todoPath);
+        if (!detection.hasChanges) {
+            return {
+                changesDetected: false,
+                syncStatus: 'no_changes',
+                activeIntentsNotified: 0
+            };
+        }
+        let todoContent = '';
+        try {
+            todoContent = await fs.readFile(this.todoPath, 'utf-8');
+        }
+        catch (error) {
+            return {
+                changesDetected: true,
+                syncStatus: 'error_reading_file',
+                activeIntentsNotified: 0
+            };
+        }
+        const changes = await this.parseChanges(this.lastKnownHash, detection.currentHash, todoContent);
+        await this.notifyActiveIntents(todoContent, changes);
+        await this.kgManager.updateSyncState({
+            lastSyncTimestamp: new Date().toISOString(),
+            todoMdHash: detection.currentHash,
+            syncStatus: 'synced',
+            lastModifiedBy: 'sync',
+            version: (await this.kgManager.getSyncState()).version + 1
+        });
+        this.lastKnownHash = detection.currentHash;
+        const activeIntents = await this.kgManager.getActiveIntents();
+        return {
+            changesDetected: true,
+            syncStatus: 'synced',
+            activeIntentsNotified: activeIntents.length
+        };
+    }
+    async getWatcherStatus() {
+        const syncState = await this.kgManager.getSyncState();
+        return {
+            isActive: this.watcherActive,
+            todoPath: this.todoPath,
+            lastKnownHash: this.lastKnownHash,
+            lastSyncTime: syncState.lastSyncTimestamp,
+            syncStatus: syncState.syncStatus
+        };
+    }
+}
+//# sourceMappingURL=todo-file-watcher.js.map

package/dist/src/utils/todo-file-watcher.js.map

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

package/dist/src/utils/todo-json-manager.d.ts

@@ -0,0 +1,71 @@
+/**
+ * JSON-First TODO Management System
+ *
+ * Provides consistent, structured TODO management with automatic scoring sync,
+ * knowledge graph integration, and intelligent task automation.
+ */
+import { TodoJsonData, TodoTask, TaskUpdateOperation, TodoScoreMetrics } from '../types/todo-json-schemas.js';
+export declare class TodoJsonManager {
+    private todoJsonPath;
+    private todoMdPath;
+    private cacheDir;
+    private kgManager;
+    private healthScoring;
+    constructor(projectPath?: string);
+    /**
+     * Load TODO data from JSON, creating default structure if needed
+     */
+    loadTodoData(): Promise<TodoJsonData>;
+    /**
+     * Save TODO data to JSON and optionally sync to markdown
+     */
+    saveTodoData(data: TodoJsonData, syncToMarkdown?: boolean): Promise<void>;
+    /**
+     * Create a new task with automatic ID generation and scoring integration
+     */
+    createTask(taskData: Partial<TodoTask> & {
+        title: string;
+    }): Promise<string>;
+    /**
+     * Update task with automatic changelog and scoring sync
+     */
+    updateTask(operation: TaskUpdateOperation): Promise<void>;
+    /**
+     * Move task between sections automatically
+     */
+    private moveTaskBetweenSections;
+    /**
+     * Process auto-completion rules
+     */
+    private processAutoCompletionRules;
+    /**
+     * Update scoring system with current task data
+     */
+    private updateScoring;
+    /**
+     * Calculate comprehensive score metrics
+     */
+    private calculateScoreMetrics;
+    /**
+     * Link task to knowledge graph
+     */
+    private linkToKnowledgeGraph;
+    /**
+     * Convert JSON data to markdown format
+     */
+    convertToMarkdown(data?: TodoJsonData): Promise<void>;
+    /**
+     * Import existing TODO.md into JSON format
+     */
+    importFromMarkdown(): Promise<void>;
+    /**
+     * Get analytics and metrics
+     */
+    getAnalytics(): Promise<{
+        metrics: TodoScoreMetrics;
+        trends: any[];
+        recommendations: string[];
+    }>;
+    private ensureCacheDirectory;
+}
+//# sourceMappingURL=todo-json-manager.d.ts.map

package/dist/src/utils/todo-json-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"todo-json-manager.d.ts","sourceRoot":"","sources":["../../../src/utils/todo-json-manager.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAKH,OAAO,EACL,YAAY,EACZ,QAAQ,EAER,mBAAmB,EACnB,gBAAgB,EAEjB,MAAM,+BAA+B,CAAC;AAKvC,qBAAa,eAAe;IAC1B,OAAO,CAAC,YAAY,CAAS;IAC7B,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,SAAS,CAAwB;IACzC,OAAO,CAAC,aAAa,CAAuB;gBAEhC,WAAW,CAAC,EAAE,MAAM;IAYhC;;OAEG;IACG,YAAY,IAAI,OAAO,CAAC,YAAY,CAAC;IA6D3C;;OAEG;IACG,YAAY,CAAC,IAAI,EAAE,YAAY,EAAE,cAAc,GAAE,OAAc,GAAG,OAAO,CAAC,IAAI,CAAC;IAmBrF;;OAEG;IACG,UAAU,CAAC,QAAQ,EAAE,OAAO,CAAC,QAAQ,CAAC,GAAG;QAAE,KAAK,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,MAAM,CAAC;IAiElF;;OAEG;IACG,UAAU,CAAC,SAAS,EAAE,mBAAmB,GAAG,OAAO,CAAC,IAAI,CAAC;IA+C/D;;OAEG;YACW,uBAAuB;IAkBrC;;OAEG;YACW,0BAA0B;IAsBxC;;OAEG;YACW,aAAa;IA4B3B;;OAEG;IACH,OAAO,CAAC,qBAAqB;IA6D7B;;OAEG;YACW,oBAAoB;IAkBlC;;OAEG;IACG,iBAAiB,CAAC,IAAI,CAAC,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC;IAW3D;;OAEG;IACG,kBAAkB,IAAI,OAAO,CAAC,IAAI,CAAC;IAazC;;OAEG;IACG,YAAY,IAAI,OAAO,CAAC;QAC5B,OAAO,EAAE,gBAAgB,CAAC;QAC1B,MAAM,EAAE,GAAG,EAAE,CAAC;QACd,eAAe,EAAE,MAAM,EAAE,CAAC;KAC3B,CAAC;YAsBY,oBAAoB;CAOnC"}

package/dist/src/utils/todo-json-manager.js

@@ -0,0 +1,394 @@
+/**
+ * JSON-First TODO Management System
+ *
+ * Provides consistent, structured TODO management with automatic scoring sync,
+ * knowledge graph integration, and intelligent task automation.
+ */
+import * as fs from 'fs/promises';
+import path from 'path';
+import crypto from 'crypto';
+import { TodoJsonDataSchema } from '../types/todo-json-schemas.js';
+import { loadConfig } from './config.js';
+import { KnowledgeGraphManager } from './knowledge-graph-manager.js';
+import { ProjectHealthScoring } from './project-health-scoring.js';
+export class TodoJsonManager {
+    todoJsonPath;
+    todoMdPath;
+    cacheDir;
+    kgManager;
+    healthScoring;
+    constructor(projectPath) {
+        const config = loadConfig();
+        const basePath = projectPath || config.projectPath;
+        this.cacheDir = path.join(basePath, '.mcp-adr-cache');
+        this.todoJsonPath = path.join(this.cacheDir, 'todo-data.json');
+        this.todoMdPath = path.join(basePath, 'TODO.md');
+        this.kgManager = new KnowledgeGraphManager();
+        this.healthScoring = new ProjectHealthScoring(basePath);
+    }
+    /**
+     * Load TODO data from JSON, creating default structure if needed
+     */
+    async loadTodoData() {
+        await this.ensureCacheDirectory();
+        try {
+            const data = await fs.readFile(this.todoJsonPath, 'utf-8');
+            const parsed = JSON.parse(data);
+            return TodoJsonDataSchema.parse(parsed);
+        }
+        catch (error) {
+            // Create default structure
+            const defaultData = {
+                version: '1.0.0',
+                metadata: {
+                    lastUpdated: new Date().toISOString(),
+                    totalTasks: 0,
+                    completedTasks: 0,
+                    autoSyncEnabled: true
+                },
+                tasks: {},
+                sections: [
+                    {
+                        id: 'pending',
+                        title: 'Pending Tasks',
+                        order: 1,
+                        collapsed: false,
+                        tasks: []
+                    },
+                    {
+                        id: 'in_progress',
+                        title: 'In Progress',
+                        order: 2,
+                        collapsed: false,
+                        tasks: []
+                    },
+                    {
+                        id: 'completed',
+                        title: 'Completed',
+                        order: 3,
+                        collapsed: false,
+                        tasks: []
+                    }
+                ],
+                scoringSync: {
+                    lastScoreUpdate: new Date().toISOString(),
+                    taskCompletionScore: 0,
+                    priorityWeightedScore: 0,
+                    criticalTasksRemaining: 0,
+                    scoreHistory: []
+                },
+                knowledgeGraphSync: {
+                    lastSync: new Date().toISOString(),
+                    linkedIntents: [],
+                    pendingUpdates: []
+                },
+                automationRules: []
+            };
+            await this.saveTodoData(defaultData);
+            return defaultData;
+        }
+    }
+    /**
+     * Save TODO data to JSON and optionally sync to markdown
+     */
+    async saveTodoData(data, syncToMarkdown = true) {
+        await this.ensureCacheDirectory();
+        // Update metadata
+        data.metadata.lastUpdated = new Date().toISOString();
+        data.metadata.totalTasks = Object.keys(data.tasks).length;
+        data.metadata.completedTasks = Object.values(data.tasks).filter(t => t.status === 'completed').length;
+        // Save JSON
+        await fs.writeFile(this.todoJsonPath, JSON.stringify(data, null, 2));
+        // Auto-sync to markdown if enabled
+        if (syncToMarkdown && data.metadata.autoSyncEnabled) {
+            await this.convertToMarkdown(data);
+            data.metadata.lastSyncToMarkdown = new Date().toISOString();
+            await fs.writeFile(this.todoJsonPath, JSON.stringify(data, null, 2));
+        }
+    }
+    /**
+     * Create a new task with automatic ID generation and scoring integration
+     */
+    async createTask(taskData) {
+        const data = await this.loadTodoData();
+        const taskId = crypto.randomUUID();
+        const now = new Date().toISOString();
+        const task = {
+            id: taskId,
+            title: taskData.title,
+            description: taskData.description || '',
+            status: taskData.status || 'pending',
+            priority: taskData.priority || 'medium',
+            category: taskData.category,
+            assignee: taskData.assignee,
+            createdAt: now,
+            updatedAt: now,
+            completedAt: undefined,
+            dueDate: taskData.dueDate,
+            parentTaskId: taskData.parentTaskId,
+            subtasks: taskData.subtasks || [],
+            dependencies: taskData.dependencies || [],
+            blockedBy: taskData.blockedBy || [],
+            linkedAdrs: taskData.linkedAdrs || [],
+            adrGeneratedTask: taskData.adrGeneratedTask || false,
+            intentId: taskData.intentId,
+            toolExecutions: taskData.toolExecutions || [],
+            scoreWeight: taskData.scoreWeight || 1,
+            scoreCategory: taskData.scoreCategory || 'task_completion',
+            estimatedHours: taskData.estimatedHours,
+            actualHours: taskData.actualHours,
+            progressPercentage: taskData.progressPercentage || 0,
+            tags: taskData.tags || [],
+            notes: taskData.notes,
+            lastModifiedBy: taskData.lastModifiedBy || 'tool',
+            autoComplete: taskData.autoComplete || false,
+            completionCriteria: taskData.completionCriteria,
+            version: 1,
+            changeLog: [{
+                    timestamp: now,
+                    action: 'created',
+                    details: `Task created: ${taskData.title}`,
+                    modifiedBy: taskData.lastModifiedBy || 'tool'
+                }]
+        };
+        // Add to tasks
+        data.tasks[taskId] = task;
+        // Add to appropriate section
+        const targetSection = data.sections.find(s => s.id === task.status) || data.sections[0];
+        if (targetSection) {
+            targetSection.tasks.push(taskId);
+        }
+        // Update knowledge graph if intentId provided
+        if (task.intentId) {
+            await this.linkToKnowledgeGraph(taskId, task.intentId, 'generated_from');
+        }
+        await this.saveTodoData(data);
+        await this.updateScoring(data);
+        return taskId;
+    }
+    /**
+     * Update task with automatic changelog and scoring sync
+     */
+    async updateTask(operation) {
+        const data = await this.loadTodoData();
+        const task = data.tasks[operation.taskId];
+        if (!task) {
+            throw new Error(`Task ${operation.taskId} not found`);
+        }
+        const now = new Date().toISOString();
+        const oldStatus = task.status;
+        // Apply updates
+        Object.assign(task, operation.updates);
+        task.updatedAt = now;
+        task.version += 1;
+        // Add changelog entry
+        task.changeLog.push({
+            timestamp: now,
+            action: 'updated',
+            details: operation.reason,
+            modifiedBy: operation.triggeredBy
+        });
+        // Handle status changes
+        if (operation.updates.status && operation.updates.status !== oldStatus) {
+            await this.moveTaskBetweenSections(data, operation.taskId, oldStatus, operation.updates.status);
+            // Handle completion
+            if (operation.updates.status === 'completed') {
+                task.completedAt = now;
+                task.progressPercentage = 100;
+                // Update knowledge graph
+                if (task.intentId) {
+                    await this.kgManager.updateTodoSnapshot(task.intentId, `Task completed: ${task.title}`);
+                }
+                // Check for auto-completion rules
+                await this.processAutoCompletionRules(data, operation.taskId);
+            }
+        }
+        await this.saveTodoData(data);
+        await this.updateScoring(data);
+    }
+    /**
+     * Move task between sections automatically
+     */
+    async moveTaskBetweenSections(data, taskId, fromStatus, toStatus) {
+        const fromSection = data.sections.find(s => s.id === fromStatus);
+        const toSection = data.sections.find(s => s.id === toStatus);
+        if (fromSection) {
+            fromSection.tasks = fromSection.tasks.filter(id => id !== taskId);
+        }
+        if (toSection) {
+            toSection.tasks.push(taskId);
+        }
+    }
+    /**
+     * Process auto-completion rules
+     */
+    async processAutoCompletionRules(data, completedTaskId) {
+        // Check for dependent tasks that can now be auto-completed
+        for (const [taskId, task] of Object.entries(data.tasks)) {
+            if (task.autoComplete && task.dependencies.includes(completedTaskId)) {
+                const allDependenciesCompleted = task.dependencies.every(depId => {
+                    const depTask = data.tasks[depId];
+                    return depTask && depTask.status === 'completed';
+                });
+                if (allDependenciesCompleted) {
+                    await this.updateTask({
+                        taskId,
+                        updates: { status: 'completed' },
+                        reason: `Auto-completed: all dependencies satisfied`,
+                        triggeredBy: 'automation'
+                    });
+                }
+            }
+        }
+    }
+    /**
+     * Update scoring system with current task data
+     */
+    async updateScoring(data) {
+        const metrics = this.calculateScoreMetrics(data);
+        // Update scoring sync
+        data.scoringSync = {
+            lastScoreUpdate: new Date().toISOString(),
+            taskCompletionScore: metrics.completionPercentage,
+            priorityWeightedScore: metrics.priorityWeightedScore,
+            criticalTasksRemaining: metrics.criticalTasksRemaining,
+            scoreHistory: [
+                ...data.scoringSync.scoreHistory,
+                {
+                    timestamp: new Date().toISOString(),
+                    score: metrics.completionPercentage,
+                    trigger: 'task_update'
+                }
+            ].slice(-50) // Keep last 50 entries
+        };
+        // Update project health scoring
+        await this.healthScoring.updateTaskCompletionScore({
+            completed: metrics.completedTasks,
+            total: metrics.totalTasks,
+            criticalTasksRemaining: metrics.criticalTasksRemaining,
+            priorityWeightedScore: metrics.priorityWeightedScore
+        });
+    }
+    /**
+     * Calculate comprehensive score metrics
+     */
+    calculateScoreMetrics(data) {
+        const tasks = Object.values(data.tasks);
+        const totalTasks = tasks.length;
+        const completedTasks = tasks.filter(t => t.status === 'completed').length;
+        const completionPercentage = totalTasks > 0 ? (completedTasks / totalTasks) * 100 : 100;
+        // Priority-weighted scoring
+        const priorityWeights = { low: 1, medium: 2, high: 3, critical: 4 };
+        const totalWeight = tasks.reduce((sum, t) => sum + priorityWeights[t.priority], 0);
+        const completedWeight = tasks
+            .filter(t => t.status === 'completed')
+            .reduce((sum, t) => sum + priorityWeights[t.priority], 0);
+        const priorityWeightedScore = totalWeight > 0 ? (completedWeight / totalWeight) * 100 : 100;
+        // Critical tasks remaining
+        const criticalTasksRemaining = tasks.filter(t => t.priority === 'critical' && t.status !== 'completed').length;
+        // Other metrics
+        const blockedTasksCount = tasks.filter(t => t.status === 'blocked').length;
+        const now = new Date();
+        const averageTaskAge = tasks.reduce((sum, t) => {
+            const age = (now.getTime() - new Date(t.createdAt).getTime()) / (1000 * 60 * 60 * 24);
+            return sum + age;
+        }, 0) / totalTasks;
+        // Velocity metrics (last 7 days)
+        const weekAgo = new Date(now.getTime() - 7 * 24 * 60 * 60 * 1000);
+        const tasksCompletedLastWeek = tasks.filter(t => t.status === 'completed' &&
+            t.completedAt &&
+            new Date(t.completedAt) > weekAgo).length;
+        const completedTasksWithDuration = tasks.filter(t => t.status === 'completed' &&
+            t.completedAt);
+        const averageCompletionTime = completedTasksWithDuration.length > 0
+            ? completedTasksWithDuration.reduce((sum, t) => {
+                const duration = (new Date(t.completedAt).getTime() - new Date(t.createdAt).getTime()) / (1000 * 60 * 60);
+                return sum + duration;
+            }, 0) / completedTasksWithDuration.length
+            : 0;
+        return {
+            totalTasks,
+            completedTasks,
+            completionPercentage,
+            priorityWeightedScore,
+            criticalTasksRemaining,
+            blockedTasksCount,
+            averageTaskAge,
+            velocityMetrics: {
+                tasksCompletedLastWeek,
+                averageCompletionTime
+            }
+        };
+    }
+    /**
+     * Link task to knowledge graph
+     */
+    async linkToKnowledgeGraph(taskId, intentId, _linkType) {
+        const data = await this.loadTodoData();
+        // Update knowledge graph sync
+        data.knowledgeGraphSync.linkedIntents.push(intentId);
+        data.knowledgeGraphSync.pendingUpdates.push({
+            taskId,
+            updateType: 'status',
+            timestamp: new Date().toISOString()
+        });
+        await this.saveTodoData(data, false); // Don't sync to markdown yet
+    }
+    /**
+     * Convert JSON data to markdown format
+     */
+    async convertToMarkdown(data) {
+        if (!data) {
+            data = await this.loadTodoData();
+        }
+        const { generateTodoMarkdown } = await import('./todo-markdown-converter.js');
+        const markdown = await generateTodoMarkdown(data);
+        await fs.writeFile(this.todoMdPath, markdown);
+    }
+    /**
+     * Import existing TODO.md into JSON format
+     */
+    async importFromMarkdown() {
+        try {
+            const markdownContent = await fs.readFile(this.todoMdPath, 'utf-8');
+            const { parseMarkdownToJson } = await import('./todo-markdown-converter.js');
+            const jsonData = await parseMarkdownToJson(markdownContent);
+            await this.saveTodoData(jsonData, false);
+        }
+        catch (error) {
+            // If TODO.md doesn't exist, create fresh JSON
+            await this.loadTodoData();
+        }
+    }
+    /**
+     * Get analytics and metrics
+     */
+    async getAnalytics() {
+        const data = await this.loadTodoData();
+        const metrics = this.calculateScoreMetrics(data);
+        const recommendations = [];
+        if (metrics.criticalTasksRemaining > 0) {
+            recommendations.push(`Address ${metrics.criticalTasksRemaining} critical tasks`);
+        }
+        if (metrics.blockedTasksCount > 0) {
+            recommendations.push(`Resolve ${metrics.blockedTasksCount} blocked tasks`);
+        }
+        if (metrics.averageTaskAge > 30) {
+            recommendations.push('Consider breaking down old tasks or removing stale ones');
+        }
+        return {
+            metrics,
+            trends: data.scoringSync.scoreHistory,
+            recommendations
+        };
+    }
+    async ensureCacheDirectory() {
+        try {
+            await fs.access(this.cacheDir);
+        }
+        catch {
+            await fs.mkdir(this.cacheDir, { recursive: true });
+        }
+    }
+}
+//# sourceMappingURL=todo-json-manager.js.map