modestbench 0.1.0 → 0.2.0

package/dist/services/history/comparison.js

@@ -0,0 +1,120 @@
+/**
+ * Benchmark Comparison Service
+ *
+ * Handles comparison logic between two benchmark runs, calculating performance
+ * differences and categorizing tasks.
+ */
+/**
+ * Service for comparing benchmark runs
+ */
+export class ComparisonService {
+    /**
+     * Compare two benchmark runs and produce detailed comparison result
+     */
+    compareRuns(run1, run2) {
+        // Build task maps for comparison
+        const tasksMap1 = new Map();
+        const tasksMap2 = new Map();
+        // Extract tasks from run1
+        for (const file of run1.files) {
+            for (const suite of file.suites) {
+                for (const task of suite.tasks) {
+                    if (!task.error) {
+                        const key = `${file.filePath}::${suite.name}::${task.name}`;
+                        tasksMap1.set(key, {
+                            file: file.filePath,
+                            inBoth: false,
+                            percentChange: 0,
+                            run1: {
+                                cv: task.cv,
+                                iterations: task.iterations,
+                                max: task.max,
+                                mean: task.mean,
+                                min: task.min,
+                            },
+                            suite: suite.name,
+                            task: task.name,
+                        });
+                    }
+                }
+            }
+        }
+        // Extract tasks from run2 and merge
+        for (const file of run2.files) {
+            for (const suite of file.suites) {
+                for (const task of suite.tasks) {
+                    if (!task.error) {
+                        const key = `${file.filePath}::${suite.name}::${task.name}`;
+                        const existing = tasksMap1.get(key);
+                        if (existing && existing.run1) {
+                            // Task exists in both runs - calculate comparison
+                            const percentChange = ((task.mean - existing.run1.mean) / existing.run1.mean) * 100;
+                            tasksMap1.set(key, {
+                                ...existing,
+                                inBoth: true,
+                                percentChange,
+                                run2: {
+                                    cv: task.cv,
+                                    iterations: task.iterations,
+                                    max: task.max,
+                                    mean: task.mean,
+                                    min: task.min,
+                                },
+                            });
+                        }
+                        else {
+                            // Task only in run2
+                            tasksMap2.set(key, {
+                                file: file.filePath,
+                                inBoth: false,
+                                percentChange: 0,
+                                run2: {
+                                    cv: task.cv,
+                                    iterations: task.iterations,
+                                    max: task.max,
+                                    mean: task.mean,
+                                    min: task.min,
+                                },
+                                suite: suite.name,
+                                task: task.name,
+                            });
+                        }
+                    }
+                }
+            }
+        }
+        // Separate tasks into categories
+        const tasksInBoth = [];
+        const tasksOnlyIn1 = [];
+        const tasksOnlyIn2 = [];
+        for (const task of tasksMap1.values()) {
+            if (task.inBoth) {
+                tasksInBoth.push(task);
+            }
+            else {
+                tasksOnlyIn1.push(task);
+            }
+        }
+        for (const task of tasksMap2.values()) {
+            tasksOnlyIn2.push(task);
+        }
+        return {
+            run1: {
+                endTime: run1.endTime,
+                id: run1.id,
+                startTime: run1.startTime,
+                summary: run1.summary,
+            },
+            run2: {
+                endTime: run2.endTime,
+                id: run2.id,
+                startTime: run2.startTime,
+                summary: run2.summary,
+            },
+            tasksInBoth,
+            tasksOnlyInRun1: tasksOnlyIn1,
+            tasksOnlyInRun2: tasksOnlyIn2,
+        };
+    }
+}
+//# sourceMappingURL=comparison.js.map

package/dist/services/history/comparison.js.map

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

package/dist/services/history/models.cjs

@@ -0,0 +1,9 @@
+"use strict";
+/**
+ * Data Models for History Services
+ *
+ * Type definitions for history command data structures, shared between
+ * services, formatters, and CLI handlers.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=models.js.map

package/dist/services/history/models.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"models.js","sourceRoot":"","sources":["../../../src/services/history/models.ts"],"names":[],"mappings":";AAAA;;;;;GAKG"}

package/dist/services/history/models.d.cts

@@ -0,0 +1,139 @@
+/**
+ * Data Models for History Services
+ *
+ * Type definitions for history command data structures, shared between
+ * services, formatters, and CLI handlers.
+ */
+import type { BenchmarkRun } from "../../types/index.cjs";
+/**
+ * Result from comparing two benchmark runs
+ */
+export interface CompareResult {
+    run1: {
+        endTime: Date;
+        id: string;
+        startTime: Date;
+        summary: {
+            failedTasks: number;
+            passedTasks: number;
+            totalFiles: number;
+            totalTasks: number;
+        };
+    };
+    run2: {
+        endTime: Date;
+        id: string;
+        startTime: Date;
+        summary: {
+            failedTasks: number;
+            passedTasks: number;
+            totalFiles: number;
+            totalTasks: number;
+        };
+    };
+    tasksInBoth: TaskComparison[];
+    tasksOnlyInRun1: TaskComparison[];
+    tasksOnlyInRun2: TaskComparison[];
+}
+/**
+ * Distribution bucket for histogram visualization
+ */
+export interface DistributionBucket {
+    count: number;
+    label: string;
+    max: number;
+    min: number;
+}
+/**
+ * Result from listing historical runs
+ */
+export interface HistoryListResult {
+    runs: Array<{
+        duration: number;
+        id: string;
+        startTime: Date;
+        summary: {
+            failedTasks: number;
+            passedTasks: number;
+            totalFiles: number;
+            totalTasks: number;
+        };
+    }>;
+    totalCount: number;
+}
+/**
+ * Show command result (just wraps BenchmarkRun for consistency)
+ */
+export type ShowResult = BenchmarkRun;
+/**
+ * Task comparison result between two runs
+ */
+export interface TaskComparison {
+    file: string;
+    inBoth: boolean;
+    percentChange: number;
+    run1?: {
+        cv: number;
+        iterations: number;
+        max: number;
+        mean: number;
+        min: number;
+    };
+    run2?: {
+        cv: number;
+        iterations: number;
+        max: number;
+        mean: number;
+        min: number;
+    };
+    suite: string;
+    task: string;
+}
+/**
+ * Complete trend analysis for a single task
+ */
+export interface TrendData {
+    confidence: number;
+    dataPoints: TrendDataPoint[];
+    percentChange: number;
+    runs: number;
+    statistics: TrendStatistics;
+    task: string;
+    trend: 'degrading' | 'improving' | 'stable';
+}
+/**
+ * Single data point in a trend series
+ */
+export interface TrendDataPoint {
+    date: Date;
+    mean: number;
+}
+/**
+ * Result from analyzing performance trends
+ */
+export interface TrendsResult {
+    lowConfidenceRegressions: TrendData[];
+    regressions: TrendData[];
+    runs: number;
+    summary: {
+        degradingTasks: number;
+        improvingTasks: number;
+        stableTasks: number;
+        totalTasks: number;
+    };
+    timespan: {
+        end: Date;
+        start: Date;
+    };
+    trends: TrendData[];
+}
+/**
+ * Statistical metrics for trend analysis
+ */
+export interface TrendStatistics {
+    mean: number;
+    median: number;
+    stdDeviation: number;
+    variance: number;
+}
+//# sourceMappingURL=models.d.ts.map

package/dist/services/history/models.d.cts.map

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

package/dist/services/history/models.d.ts

@@ -0,0 +1,139 @@
+/**
+ * Data Models for History Services
+ *
+ * Type definitions for history command data structures, shared between
+ * services, formatters, and CLI handlers.
+ */
+import type { BenchmarkRun } from "../../types/index.js";
+/**
+ * Result from comparing two benchmark runs
+ */
+export interface CompareResult {
+    run1: {
+        endTime: Date;
+        id: string;
+        startTime: Date;
+        summary: {
+            failedTasks: number;
+            passedTasks: number;
+            totalFiles: number;
+            totalTasks: number;
+        };
+    };
+    run2: {
+        endTime: Date;
+        id: string;
+        startTime: Date;
+        summary: {
+            failedTasks: number;
+            passedTasks: number;
+            totalFiles: number;
+            totalTasks: number;
+        };
+    };
+    tasksInBoth: TaskComparison[];
+    tasksOnlyInRun1: TaskComparison[];
+    tasksOnlyInRun2: TaskComparison[];
+}
+/**
+ * Distribution bucket for histogram visualization
+ */
+export interface DistributionBucket {
+    count: number;
+    label: string;
+    max: number;
+    min: number;
+}
+/**
+ * Result from listing historical runs
+ */
+export interface HistoryListResult {
+    runs: Array<{
+        duration: number;
+        id: string;
+        startTime: Date;
+        summary: {
+            failedTasks: number;
+            passedTasks: number;
+            totalFiles: number;
+            totalTasks: number;
+        };
+    }>;
+    totalCount: number;
+}
+/**
+ * Show command result (just wraps BenchmarkRun for consistency)
+ */
+export type ShowResult = BenchmarkRun;
+/**
+ * Task comparison result between two runs
+ */
+export interface TaskComparison {
+    file: string;
+    inBoth: boolean;
+    percentChange: number;
+    run1?: {
+        cv: number;
+        iterations: number;
+        max: number;
+        mean: number;
+        min: number;
+    };
+    run2?: {
+        cv: number;
+        iterations: number;
+        max: number;
+        mean: number;
+        min: number;
+    };
+    suite: string;
+    task: string;
+}
+/**
+ * Complete trend analysis for a single task
+ */
+export interface TrendData {
+    confidence: number;
+    dataPoints: TrendDataPoint[];
+    percentChange: number;
+    runs: number;
+    statistics: TrendStatistics;
+    task: string;
+    trend: 'degrading' | 'improving' | 'stable';
+}
+/**
+ * Single data point in a trend series
+ */
+export interface TrendDataPoint {
+    date: Date;
+    mean: number;
+}
+/**
+ * Result from analyzing performance trends
+ */
+export interface TrendsResult {
+    lowConfidenceRegressions: TrendData[];
+    regressions: TrendData[];
+    runs: number;
+    summary: {
+        degradingTasks: number;
+        improvingTasks: number;
+        stableTasks: number;
+        totalTasks: number;
+    };
+    timespan: {
+        end: Date;
+        start: Date;
+    };
+    trends: TrendData[];
+}
+/**
+ * Statistical metrics for trend analysis
+ */
+export interface TrendStatistics {
+    mean: number;
+    median: number;
+    stdDeviation: number;
+    variance: number;
+}
+//# sourceMappingURL=models.d.ts.map

package/dist/services/history/models.d.ts.map

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

package/dist/services/history/models.js

@@ -0,0 +1,8 @@
+/**
+ * Data Models for History Services
+ *
+ * Type definitions for history command data structures, shared between
+ * services, formatters, and CLI handlers.
+ */
+export {};
+//# sourceMappingURL=models.js.map

package/dist/services/history/models.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"models.js","sourceRoot":"","sources":["../../../src/services/history/models.ts"],"names":[],"mappings":"AAAA;;;;;GAKG"}

package/dist/services/history/query.cjs

@@ -0,0 +1,97 @@
+"use strict";
+/**
+ * History Query Service
+ *
+ * Handles querying benchmark run history with date parsing and filtering.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.parseDate = exports.HistoryQueryService = void 0;
+/**
+ * Service for querying historical benchmark runs
+ */
+class HistoryQueryService {
+    storage;
+    constructor(storage) {
+        this.storage = storage;
+    }
+    /**
+     * Query runs with automatic date string parsing
+     */
+    async queryWithDateParsing(options) {
+        // Build query object all at once
+        const query = {
+            ...(options.since && { since: (0, exports.parseDate)(options.since) }),
+            ...(options.until && { until: (0, exports.parseDate)(options.until) }),
+            ...(options.pattern && { pattern: options.pattern }),
+            ...(options.tags && options.tags.length > 0 && { tags: options.tags }),
+            ...(options.limit && { limit: options.limit }),
+        };
+        return await this.storage.queryRuns(query);
+    }
+}
+exports.HistoryQueryService = HistoryQueryService;
+/**
+ * Parse date string (ISO 8601 or relative)
+ *
+ * Supports:
+ *
+ * - ISO 8601: "2025-10-24T12:00:00Z", "2025-10-24"
+ * - Relative: "1 day ago", "3 weeks ago", "2 hours ago"
+ * - Shorthand: "1d", "2w", "3m", "6h"
+ *
+ * @param dateStr - Date string to parse
+ * @returns Parsed Date object
+ * @throws Error if date format is invalid
+ */
+const parseDate = (dateStr) => {
+    if (!dateStr || dateStr.trim() === '') {
+        throw new Error(`Invalid date format: "${dateStr}"`);
+    }
+    // Try parsing as ISO 8601 first
+    const isoDate = new Date(dateStr);
+    if (!isNaN(isoDate.getTime())) {
+        return isoDate;
+    }
+    // Parse relative dates like "1 week ago", "3 days ago"
+    const relativePattern = /^(\d+)\s+(hour|day|week|month)s?\s+ago$/i;
+    const relativeMatch = dateStr.trim().match(relativePattern);
+    if (relativeMatch && relativeMatch[1] && relativeMatch[2]) {
+        const amount = parseInt(relativeMatch[1], 10);
+        const unit = relativeMatch[2].toLowerCase();
+        if (amount <= 0) {
+            throw new Error(`Invalid date format: "${dateStr}"`);
+        }
+        const now = new Date();
+        const msPerUnit = {
+            day: 24 * 60 * 60 * 1000,
+            hour: 60 * 60 * 1000,
+            month: 30 * 24 * 60 * 60 * 1000, // Approximate
+            week: 7 * 24 * 60 * 60 * 1000,
+        };
+        const offset = amount * (msPerUnit[unit] || 0);
+        return new Date(now.getTime() - offset);
+    }
+    // Parse shorthand formats like "1d", "2w", "3m", "6h"
+    // cspell:ignore hdwm
+    const shorthandPattern = /^(\d+)([hdwm])$/i;
+    const shorthandMatch = dateStr.trim().match(shorthandPattern);
+    if (shorthandMatch && shorthandMatch[1] && shorthandMatch[2]) {
+        const amount = parseInt(shorthandMatch[1], 10);
+        const unit = shorthandMatch[2].toLowerCase();
+        if (amount <= 0) {
+            throw new Error(`Invalid date format: "${dateStr}"`);
+        }
+        const now = new Date();
+        const msPerUnit = {
+            d: 24 * 60 * 60 * 1000,
+            h: 60 * 60 * 1000,
+            m: 30 * 24 * 60 * 60 * 1000, // Approximate month
+            w: 7 * 24 * 60 * 60 * 1000,
+        };
+        const offset = amount * (msPerUnit[unit] || 0);
+        return new Date(now.getTime() - offset);
+    }
+    throw new Error(`Invalid date format: "${dateStr}"`);
+};
+exports.parseDate = parseDate;
+//# sourceMappingURL=query.js.map

package/dist/services/history/query.cjs.map

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

package/dist/services/history/query.d.cts

@@ -0,0 +1,38 @@
+/**
+ * History Query Service
+ *
+ * Handles querying benchmark run history with date parsing and filtering.
+ */
+import type { BenchmarkRun, HistoryStorage } from "../../types/index.cjs";
+/**
+ * Service for querying historical benchmark runs
+ */
+export declare class HistoryQueryService {
+    private readonly storage;
+    constructor(storage: HistoryStorage);
+    /**
+     * Query runs with automatic date string parsing
+     */
+    queryWithDateParsing(options: {
+        limit?: number;
+        pattern?: string;
+        since?: string;
+        tags?: string[];
+        until?: string;
+    }): Promise<BenchmarkRun[]>;
+}
+/**
+ * Parse date string (ISO 8601 or relative)
+ *
+ * Supports:
+ *
+ * - ISO 8601: "2025-10-24T12:00:00Z", "2025-10-24"
+ * - Relative: "1 day ago", "3 weeks ago", "2 hours ago"
+ * - Shorthand: "1d", "2w", "3m", "6h"
+ *
+ * @param dateStr - Date string to parse
+ * @returns Parsed Date object
+ * @throws Error if date format is invalid
+ */
+export declare const parseDate: (dateStr: string) => Date;
+//# sourceMappingURL=query.d.ts.map

package/dist/services/history/query.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"query.d.ts","sourceRoot":"","sources":["../../../src/services/history/query.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EACV,YAAY,EAEZ,cAAc,EACf,8BAA6B;AAE9B;;GAEG;AACH,qBAAa,mBAAmB;IAClB,OAAO,CAAC,QAAQ,CAAC,OAAO;gBAAP,OAAO,EAAE,cAAc;IAEpD;;OAEG;IACG,oBAAoB,CAAC,OAAO,EAAE;QAClC,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;QAChB,KAAK,CAAC,EAAE,MAAM,CAAC;KAChB,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC;CAY5B;AAED;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,SAAS,GAAI,SAAS,MAAM,KAAG,IA6D3C,CAAC"}

package/dist/services/history/query.d.ts

@@ -0,0 +1,38 @@
+/**
+ * History Query Service
+ *
+ * Handles querying benchmark run history with date parsing and filtering.
+ */
+import type { BenchmarkRun, HistoryStorage } from "../../types/index.js";
+/**
+ * Service for querying historical benchmark runs
+ */
+export declare class HistoryQueryService {
+    private readonly storage;
+    constructor(storage: HistoryStorage);
+    /**
+     * Query runs with automatic date string parsing
+     */
+    queryWithDateParsing(options: {
+        limit?: number;
+        pattern?: string;
+        since?: string;
+        tags?: string[];
+        until?: string;
+    }): Promise<BenchmarkRun[]>;
+}
+/**
+ * Parse date string (ISO 8601 or relative)
+ *
+ * Supports:
+ *
+ * - ISO 8601: "2025-10-24T12:00:00Z", "2025-10-24"
+ * - Relative: "1 day ago", "3 weeks ago", "2 hours ago"
+ * - Shorthand: "1d", "2w", "3m", "6h"
+ *
+ * @param dateStr - Date string to parse
+ * @returns Parsed Date object
+ * @throws Error if date format is invalid
+ */
+export declare const parseDate: (dateStr: string) => Date;
+//# sourceMappingURL=query.d.ts.map

package/dist/services/history/query.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"query.d.ts","sourceRoot":"","sources":["../../../src/services/history/query.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EACV,YAAY,EAEZ,cAAc,EACf,6BAA6B;AAE9B;;GAEG;AACH,qBAAa,mBAAmB;IAClB,OAAO,CAAC,QAAQ,CAAC,OAAO;gBAAP,OAAO,EAAE,cAAc;IAEpD;;OAEG;IACG,oBAAoB,CAAC,OAAO,EAAE;QAClC,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;QAChB,KAAK,CAAC,EAAE,MAAM,CAAC;KAChB,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC;CAY5B;AAED;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,SAAS,GAAI,SAAS,MAAM,KAAG,IA6D3C,CAAC"}