@lbruton/spec-workflow-mcp 2.2.4

package/dist/dashboard/execution-history-manager.js

@@ -0,0 +1,161 @@
+import { join } from 'path';
+import { promises as fs } from 'fs';
+import { getGlobalDir, getPermissionErrorHelp } from '../core/global-dir.js';
+export class ExecutionHistoryManager {
+    historyPath;
+    historyDir;
+    maxHistoryEntries = 1000; // Keep last 1000 executions
+    constructor() {
+        this.historyDir = getGlobalDir();
+        this.historyPath = join(this.historyDir, 'job-execution-history.json');
+    }
+    /**
+     * Ensure the history directory exists
+     */
+    async ensureHistoryDir() {
+        try {
+            await fs.mkdir(this.historyDir, { recursive: true });
+        }
+        catch (error) {
+            // Directory might already exist, ignore EEXIST errors
+            if (error.code === 'EEXIST') {
+                return;
+            }
+            // For permission errors, provide helpful guidance
+            if (error.code === 'EACCES' || error.code === 'EPERM') {
+                console.error(getPermissionErrorHelp('create directory', this.historyDir));
+                throw error;
+            }
+            // Re-throw other errors
+            throw error;
+        }
+    }
+    /**
+     * Load execution history from file
+     */
+    async loadHistory() {
+        await this.ensureHistoryDir();
+        try {
+            const content = await fs.readFile(this.historyPath, 'utf-8');
+            // Handle empty or whitespace-only files
+            const trimmedContent = content.trim();
+            if (!trimmedContent) {
+                console.error(`[ExecutionHistoryManager] Warning: ${this.historyPath} is empty, using default history`);
+                const defaultHistory = {
+                    executions: [],
+                    lastUpdated: new Date().toISOString()
+                };
+                // Write default history to file
+                await this.saveHistory(defaultHistory);
+                return defaultHistory;
+            }
+            return JSON.parse(trimmedContent);
+        }
+        catch (error) {
+            if (error.code === 'ENOENT') {
+                // File doesn't exist yet, create it with default history
+                const defaultHistory = {
+                    executions: [],
+                    lastUpdated: new Date().toISOString()
+                };
+                await this.saveHistory(defaultHistory);
+                return defaultHistory;
+            }
+            if (error instanceof SyntaxError) {
+                // JSON parsing error - file is corrupted or invalid
+                console.error(`[ExecutionHistoryManager] Error: Failed to parse ${this.historyPath}: ${error.message}`);
+                console.error(`[ExecutionHistoryManager] The file may be corrupted. Using default history.`);
+                // Back up the corrupted file
+                try {
+                    const backupPath = `${this.historyPath}.corrupted.${Date.now()}`;
+                    await fs.copyFile(this.historyPath, backupPath);
+                    console.error(`[ExecutionHistoryManager] Corrupted file backed up to: ${backupPath}`);
+                }
+                catch (backupError) {
+                    // Ignore backup errors
+                }
+                const defaultHistory = {
+                    executions: [],
+                    lastUpdated: new Date().toISOString()
+                };
+                // Write default history to file
+                await this.saveHistory(defaultHistory);
+                return defaultHistory;
+            }
+            throw error;
+        }
+    }
+    /**
+     * Save execution history to file atomically
+     */
+    async saveHistory(log) {
+        await this.ensureHistoryDir();
+        log.lastUpdated = new Date().toISOString();
+        const content = JSON.stringify(log, null, 2);
+        // Write to temporary file first, then rename for atomic operation
+        const tempPath = `${this.historyPath}.tmp`;
+        await fs.writeFile(tempPath, content, 'utf-8');
+        await fs.rename(tempPath, this.historyPath);
+    }
+    /**
+     * Record a job execution
+     */
+    async recordExecution(execution) {
+        const log = await this.loadHistory();
+        // Add new execution at the beginning
+        log.executions.unshift(execution);
+        // Keep only the most recent entries
+        if (log.executions.length > this.maxHistoryEntries) {
+            log.executions = log.executions.slice(0, this.maxHistoryEntries);
+        }
+        await this.saveHistory(log);
+    }
+    /**
+     * Get execution history for a specific job
+     */
+    async getJobHistory(jobId, limit = 50) {
+        const log = await this.loadHistory();
+        return log.executions.filter(e => e.jobId === jobId).slice(0, limit);
+    }
+    /**
+     * Get recent executions across all jobs
+     */
+    async getRecentExecutions(limit = 100) {
+        const log = await this.loadHistory();
+        return log.executions.slice(0, limit);
+    }
+    /**
+     * Get execution statistics for a job
+     */
+    async getJobStats(jobId) {
+        const history = await this.getJobHistory(jobId, 100);
+        const successful = history.filter(e => e.success);
+        const failed = history.filter(e => !e.success);
+        return {
+            totalExecutions: history.length,
+            successfulExecutions: successful.length,
+            failedExecutions: failed.length,
+            successRate: history.length > 0 ? (successful.length / history.length) * 100 : 0,
+            totalItemsDeleted: successful.reduce((sum, e) => sum + e.itemsDeleted, 0),
+            avgDuration: successful.length > 0 ? successful.reduce((sum, e) => sum + e.duration, 0) / successful.length : 0,
+            lastExecution: history[0] || null
+        };
+    }
+    /**
+     * Clear old history (keep last N days)
+     */
+    async clearOldHistory(daysToKeep = 30) {
+        const log = await this.loadHistory();
+        const cutoffTime = new Date();
+        cutoffTime.setDate(cutoffTime.getDate() - daysToKeep);
+        log.executions = log.executions.filter(e => new Date(e.executedAt) > cutoffTime);
+        await this.saveHistory(log);
+    }
+    /**
+     * Get the history file path
+     */
+    getHistoryPath() {
+        return this.historyPath;
+    }
+}
+//# sourceMappingURL=execution-history-manager.js.map

package/dist/dashboard/execution-history-manager.js.map

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

package/dist/dashboard/implementation-log-manager.d.ts

@@ -0,0 +1,97 @@
+import { ImplementationLog, ImplementationLogEntry } from '../types.js';
+/**
+ * Manager for implementation logs using markdown file format
+ * Each implementation log entry is stored as an individual markdown file
+ * in the spec's "Implementation Logs" directory
+ */
+export declare class ImplementationLogManager {
+    private specPath;
+    private logsDir;
+    constructor(specPath: string);
+    /**
+     * Ensure the Implementation Logs directory exists
+     */
+    private ensureLogsDir;
+    /**
+     * Parse markdown filename to extract taskId and entry ID
+     * Expected format: task-{sanitized-taskId}_{timestamp}_{id-prefix}.md
+     */
+    private parseFileName;
+    /**
+     * Parse markdown content to extract metadata and artifacts
+     */
+    private parseMarkdownContent;
+    /**
+     * Load all implementation logs from markdown files (new format)
+     * Also checks for legacy JSON file and returns empty if found (migration handled separately)
+     */
+    loadLog(): Promise<ImplementationLog>;
+    /**
+     * Generate markdown filename for a log entry
+     */
+    private generateFileName;
+    /**
+     * Convert an implementation log entry to markdown format
+     */
+    private entryToMarkdown;
+    /**
+     * Add a new implementation log entry
+     */
+    addLogEntry(entry: Omit<ImplementationLogEntry, 'id'>): Promise<ImplementationLogEntry>;
+    /**
+     * Get all implementation logs
+     */
+    getAllLogs(): Promise<ImplementationLogEntry[]>;
+    /**
+     * Get logs for a specific task
+     */
+    getTaskLogs(taskId: string): Promise<ImplementationLogEntry[]>;
+    /**
+     * Get logs within a date range
+     */
+    getLogsByDateRange(startDate: Date, endDate: Date): Promise<ImplementationLogEntry[]>;
+    /**
+     * Search logs by summary, task ID, files, and artifacts
+     * Supports space-separated keywords with AND logic (all keywords must match)
+     */
+    searchLogs(query: string): Promise<ImplementationLogEntry[]>;
+    /**
+     * Get statistics for a task
+     */
+    getTaskStats(taskId: string): Promise<{
+        totalImplementations: number;
+        totalFilesModified: number;
+        totalFilesCreated: number;
+        totalLinesAdded: number;
+        totalLinesRemoved: number;
+        lastImplementation: null;
+    } | {
+        totalImplementations: number;
+        totalFilesModified: number;
+        totalFilesCreated: number;
+        totalLinesAdded: number;
+        totalLinesRemoved: number;
+        lastImplementation: ImplementationLogEntry;
+    }>;
+    /**
+     * Get all logs that contain a specific artifact type
+     */
+    getLogsByArtifactType(artifactType: 'apiEndpoints' | 'components' | 'functions' | 'classes' | 'integrations'): Promise<ImplementationLogEntry[]>;
+    /**
+     * Search for specific artifacts across all logs
+     * Returns logs that contain artifacts matching the search term
+     */
+    findArtifact(artifactType: string, searchTerm: string): Promise<Array<{
+        log: ImplementationLogEntry;
+        artifact: any;
+    }>>;
+    /**
+     * Get the logs directory path
+     */
+    getLogsDir(): string;
+    /**
+     * Get the log file path (for backwards compatibility, now returns the logs directory)
+     */
+    getLogPath(): string;
+}
+//# sourceMappingURL=implementation-log-manager.d.ts.map

package/dist/dashboard/implementation-log-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"implementation-log-manager.d.ts","sourceRoot":"","sources":["../../src/dashboard/implementation-log-manager.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,iBAAiB,EAAE,sBAAsB,EAAE,MAAM,aAAa,CAAC;AAGxE;;;;GAIG;AACH,qBAAa,wBAAwB;IACnC,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,OAAO,CAAS;gBAEZ,QAAQ,EAAE,MAAM;IAK5B;;OAEG;YACW,aAAa;IAQ3B;;;OAGG;IACH,OAAO,CAAC,aAAa;IAerB;;OAEG;IACH,OAAO,CAAC,oBAAoB;IA+M5B;;;OAGG;IACG,OAAO,IAAI,OAAO,CAAC,iBAAiB,CAAC;IAyC3C;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAOxB;;OAEG;IACH,OAAO,CAAC,eAAe;IAgHvB;;OAEG;IACG,WAAW,CAAC,KAAK,EAAE,IAAI,CAAC,sBAAsB,EAAE,IAAI,CAAC,GAAG,OAAO,CAAC,sBAAsB,CAAC;IAiB7F;;OAEG;IACG,UAAU,IAAI,OAAO,CAAC,sBAAsB,EAAE,CAAC;IAKrD;;OAEG;IACG,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,sBAAsB,EAAE,CAAC;IAKpE;;OAEG;IACG,kBAAkB,CAAC,SAAS,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,GAAG,OAAO,CAAC,sBAAsB,EAAE,CAAC;IAQ3F;;;OAGG;IACG,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,sBAAsB,EAAE,CAAC;IAkFlE;;OAEG;IACG,YAAY,CAAC,MAAM,EAAE,MAAM;;;;;;;;;;;;;;;IAwBjC;;OAEG;IACG,qBAAqB,CAAC,YAAY,EAAE,cAAc,GAAG,YAAY,GAAG,WAAW,GAAG,SAAS,GAAG,cAAc,GAAG,OAAO,CAAC,sBAAsB,EAAE,CAAC;IAStJ;;;OAGG;IACG,YAAY,CAAC,YAAY,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,CAAC;QAAE,GAAG,EAAE,sBAAsB,CAAC;QAAC,QAAQ,EAAE,GAAG,CAAA;KAAE,CAAC,CAAC;IAuB5H;;OAEG;IACH,UAAU,IAAI,MAAM;IAIpB;;OAEG;IACH,UAAU,IAAI,MAAM;CAGrB"}