modestbench 0.0.3 → 0.2.0

package/dist/formatters/history/trends.cjs

@@ -0,0 +1,194 @@
+"use strict";
+/**
+ * Trends Formatter
+ *
+ * Formats performance trend analysis with visualizations in human and JSON
+ * formats.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.HistoryTrendsFormatter = void 0;
+const node_util_1 = require("node:util");
+const ansi_js_1 = require("../../utils/ansi.cjs");
+const visualization_js_1 = require("./visualization.cjs");
+/**
+ * Nanoseconds per millisecond conversion constant
+ */
+const NS_PER_MS = 1_000_000;
+/**
+ * Nanoseconds per microsecond conversion constant
+ */
+const NS_PER_US = 1_000;
+/**
+ * Intelligently format a time range with appropriate precision Displays
+ * microseconds for small values (< 1ms) for better clarity
+ */
+const formatTimeRange = (minNs, maxNs) => {
+    // If both values are below 1ms, show in microseconds for better precision
+    if (maxNs < NS_PER_MS) {
+        const minUs = minNs / NS_PER_US;
+        const maxUs = maxNs / NS_PER_US;
+        return `${minUs.toFixed(2)}-${maxUs.toFixed(2)}µs`;
+    }
+    // Otherwise show in milliseconds
+    const minMs = minNs / NS_PER_MS;
+    const maxMs = maxNs / NS_PER_MS;
+    return `${minMs.toFixed(3)}-${maxMs.toFixed(3)}ms`;
+};
+/**
+ * Calculate visible string length, stripping ANSI escape codes
+ */
+const getVisualLength = (str) => (0, node_util_1.stripVTControlCharacters)(str).length;
+/**
+ * Formatter for history trends command
+ */
+class HistoryTrendsFormatter {
+    /**
+     * Format as human-readable trends with visualizations
+     */
+    formatHuman(data) {
+        const lines = [];
+        lines.push((0, ansi_js_1.colorize)('brightMagenta', (0, ansi_js_1.colorize)('bold', `\nPerformance Trends (${data.runs} runs)`)));
+        if (data.timespan.start && data.timespan.end) {
+            lines.push((0, ansi_js_1.colorize)('dim', `Time range: ${data.timespan.start.toLocaleDateString()} to ${data.timespan.end.toLocaleDateString()}`));
+        }
+        lines.push('');
+        // Summary statistics
+        lines.push((0, ansi_js_1.colorize)('brightBlue', 'Summary:'));
+        lines.push(`  ${(0, ansi_js_1.colorize)('brightCyan', '▲')} ${data.summary.improvingTasks} improving  ${(0, ansi_js_1.colorize)('brightRed', '▼')} ${data.summary.degradingTasks} degrading  ${(0, ansi_js_1.colorize)('dim', '→')} ${data.summary.stableTasks} stable`);
+        lines.push('');
+        // Task Performance Summary Table
+        lines.push((0, ansi_js_1.colorize)('brightMagenta', 'Task Performance Summary:'));
+        lines.push('');
+        for (const trendData of data.trends) {
+            // Show top 20
+            const trendIcon = trendData.trend === 'improving'
+                ? (0, ansi_js_1.colorize)('brightCyan', '▲')
+                : trendData.trend === 'degrading'
+                    ? (0, ansi_js_1.colorize)('brightRed', '▼')
+                    : (0, ansi_js_1.colorize)('dim', '→');
+            const changeColor = trendData.percentChange < -5
+                ? 'brightCyan'
+                : trendData.percentChange > 5
+                    ? 'brightRed'
+                    : 'dim';
+            const changeSign = trendData.percentChange >= 0 ? '+' : '';
+            const changeStr = `${changeSign}${trendData.percentChange.toFixed(1)}%`;
+            // Generate sparkline - scale with number of data points (min 12, max 20)
+            const values = trendData.dataPoints.map((dp) => dp.mean);
+            const sparklineWidth = Math.min(20, Math.max(12, trendData.runs));
+            const sparkline = (0, visualization_js_1.generateSparkline)(values, sparklineWidth);
+            const sparklineColor = trendData.trend === 'improving'
+                ? 'brightCyan'
+                : trendData.trend === 'degrading'
+                    ? 'brightRed'
+                    : 'cyan';
+            const taskName = (0, ansi_js_1.colorize)('white', trendData.task);
+            const percentDisplay = (0, ansi_js_1.colorize)(changeColor, changeStr.padStart(8));
+            const sparklineDisplay = (0, ansi_js_1.colorize)(sparklineColor, sparkline);
+            // Layout: icon (2) + task name + padding + percent (8) + spaces (2) + sparkline
+            // Position percent+graph at visual column 60 for consistent alignment
+            const prefix = `  ${trendIcon} ${taskName}`;
+            const prefixVisualLength = getVisualLength(prefix);
+            const targetColumn = 60;
+            if (prefixVisualLength > targetColumn) {
+                // Task name is too long, wrap to next line
+                lines.push(prefix);
+                lines.push(`${' '.repeat(targetColumn)}${percentDisplay}  ${sparklineDisplay}`);
+            }
+            else {
+                // Fit on one line with padding
+                const padding = Math.max(1, targetColumn - prefixVisualLength);
+                const paddingStr = ' '.repeat(padding);
+                lines.push(`${prefix}${paddingStr}${percentDisplay}  ${sparklineDisplay}`);
+            }
+        }
+        // Show all trends (no limit)
+        lines.push('');
+        // Show regressions if any
+        if (data.regressions.length > 0) {
+            lines.push((0, ansi_js_1.colorize)('brightRed', (0, ansi_js_1.colorize)('bold', 'Regressions Detected:')));
+            lines.push('');
+            for (const regression of data.regressions) {
+                lines.push(`  ${(0, ansi_js_1.colorize)('brightRed', '▼')} ${(0, ansi_js_1.colorize)('white', regression.task)}: ${(0, ansi_js_1.colorize)('brightRed', `${regression.percentChange.toFixed(1)}% slower`)} (${regression.runs} runs)`);
+            }
+            lines.push('');
+        }
+        // Show low-confidence regressions (insufficient data)
+        if (data.lowConfidenceRegressions.length > 0) {
+            lines.push((0, ansi_js_1.colorize)('brightYellow', (0, ansi_js_1.colorize)('bold', '! Potential Regressions (insufficient data):')));
+            lines.push('');
+            for (const regression of data.lowConfidenceRegressions) {
+                lines.push(`  ${(0, ansi_js_1.colorize)('brightYellow', '!')} ${(0, ansi_js_1.colorize)('white', regression.task)}: ${(0, ansi_js_1.colorize)('brightYellow', `${regression.percentChange.toFixed(1)}% slower`)} (${regression.runs} run${regression.runs !== 1 ? 's' : ''})`);
+            }
+            lines.push('');
+        }
+        // Show performance distribution for most important task (highest RME) if we have enough data
+        // Find task with highest relative margin of error - the most variable/unreliable one
+        const mostImportantTrend = data.trends
+            .filter((t) => t.runs >= 5)
+            .sort((a, b) => {
+            const rmeA = (a.statistics.stdDeviation / a.statistics.mean) * 100;
+            const rmeB = (b.statistics.stdDeviation / b.statistics.mean) * 100;
+            return rmeB - rmeA; // Descending order (highest RME first)
+        })[0];
+        if (mostImportantTrend) {
+            lines.push((0, ansi_js_1.colorize)('brightMagenta', 'Performance Distribution (most variable task):'));
+            lines.push((0, ansi_js_1.colorize)('white', mostImportantTrend.task));
+            const cv = ((mostImportantTrend.statistics.stdDeviation /
+                mostImportantTrend.statistics.mean) *
+                100).toFixed(1);
+            lines.push((0, ansi_js_1.colorize)('dim', `  Variability: ${cv}%`));
+            lines.push('');
+            // Create distribution buckets
+            const values = mostImportantTrend.dataPoints.map((dp) => dp.mean);
+            const min = Math.min(...values);
+            const max = Math.max(...values);
+            const range = max - min;
+            const numBuckets = Math.min(5, mostImportantTrend.runs);
+            const bucketSize = range / numBuckets;
+            const buckets = [];
+            for (let i = 0; i < numBuckets; i++) {
+                const bucketMin = min + i * bucketSize;
+                const bucketMax = min + (i + 1) * bucketSize;
+                const count = values.filter((v) => v >= bucketMin &&
+                    (i === numBuckets - 1 ? v <= bucketMax : v < bucketMax)).length;
+                const label = formatTimeRange(bucketMin, bucketMax);
+                buckets.push({
+                    count,
+                    label,
+                    max: bucketMax,
+                    min: bucketMin,
+                });
+            }
+            // Filter out empty buckets for cleaner display
+            const nonEmptyBuckets = buckets.filter((b) => b.count > 0);
+            const chart = (0, visualization_js_1.generateBarChart)(nonEmptyBuckets, 25);
+            for (const line of chart) {
+                lines.push((0, ansi_js_1.colorize)('brightCyan', line));
+            }
+            lines.push('');
+            lines.push((0, ansi_js_1.colorize)('dim', `  Mean: ${(mostImportantTrend.statistics.mean / NS_PER_MS).toFixed(3)}ms  Median: ${(mostImportantTrend.statistics.median / NS_PER_MS).toFixed(3)}ms  StdDev: ${(mostImportantTrend.statistics.stdDeviation / NS_PER_MS).toFixed(3)}ms`));
+            lines.push('');
+        }
+        return lines.join('\n');
+    }
+    /**
+     * Format as JSON
+     */
+    formatJson(data) {
+        return JSON.stringify({
+            regressions: data.regressions,
+            summary: {
+                degradingTasks: data.summary.degradingTasks,
+                improvingTasks: data.summary.improvingTasks,
+                runs: data.runs,
+                stableTasks: data.summary.stableTasks,
+                timespan: data.timespan,
+                totalTasks: data.summary.totalTasks,
+            },
+            trends: data.trends,
+        }, null, 2);
+    }
+}
+exports.HistoryTrendsFormatter = HistoryTrendsFormatter;
+//# sourceMappingURL=trends.js.map

package/dist/formatters/history/trends.cjs.map

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

package/dist/formatters/history/trends.d.cts

@@ -0,0 +1,22 @@
+/**
+ * Trends Formatter
+ *
+ * Formats performance trend analysis with visualizations in human and JSON
+ * formats.
+ */
+import type { TrendsResult } from "../../services/history/models.cjs";
+import type { HistoryFormatter } from "./base.cjs";
+/**
+ * Formatter for history trends command
+ */
+export declare class HistoryTrendsFormatter implements HistoryFormatter<TrendsResult> {
+    /**
+     * Format as human-readable trends with visualizations
+     */
+    formatHuman(data: TrendsResult): string;
+    /**
+     * Format as JSON
+     */
+    formatJson(data: TrendsResult): string;
+}
+//# sourceMappingURL=trends.d.ts.map

package/dist/formatters/history/trends.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"trends.d.ts","sourceRoot":"","sources":["../../../src/formatters/history/trends.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,KAAK,EAEV,YAAY,EACb,0CAAyC;AAC1C,OAAO,KAAK,EAAE,gBAAgB,EAAE,mBAAkB;AAuClD;;GAEG;AACH,qBAAa,sBAAuB,YAAW,gBAAgB,CAAC,YAAY,CAAC;IAC3E;;OAEG;IACH,WAAW,CAAC,IAAI,EAAE,YAAY,GAAG,MAAM;IAwMvC;;OAEG;IACH,UAAU,CAAC,IAAI,EAAE,YAAY,GAAG,MAAM;CAkBvC"}

package/dist/formatters/history/trends.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Trends Formatter
+ *
+ * Formats performance trend analysis with visualizations in human and JSON
+ * formats.
+ */
+import type { TrendsResult } from "../../services/history/models.js";
+import type { HistoryFormatter } from "./base.js";
+/**
+ * Formatter for history trends command
+ */
+export declare class HistoryTrendsFormatter implements HistoryFormatter<TrendsResult> {
+    /**
+     * Format as human-readable trends with visualizations
+     */
+    formatHuman(data: TrendsResult): string;
+    /**
+     * Format as JSON
+     */
+    formatJson(data: TrendsResult): string;
+}
+//# sourceMappingURL=trends.d.ts.map

package/dist/formatters/history/trends.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"trends.d.ts","sourceRoot":"","sources":["../../../src/formatters/history/trends.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,KAAK,EAEV,YAAY,EACb,yCAAyC;AAC1C,OAAO,KAAK,EAAE,gBAAgB,EAAE,kBAAkB;AAuClD;;GAEG;AACH,qBAAa,sBAAuB,YAAW,gBAAgB,CAAC,YAAY,CAAC;IAC3E;;OAEG;IACH,WAAW,CAAC,IAAI,EAAE,YAAY,GAAG,MAAM;IAwMvC;;OAEG;IACH,UAAU,CAAC,IAAI,EAAE,YAAY,GAAG,MAAM;CAkBvC"}

package/dist/formatters/history/trends.js

@@ -0,0 +1,190 @@
+/**
+ * Trends Formatter
+ *
+ * Formats performance trend analysis with visualizations in human and JSON
+ * formats.
+ */
+import { stripVTControlCharacters } from 'node:util';
+import { colorize } from "../../utils/ansi.js";
+import { generateBarChart, generateSparkline } from "./visualization.js";
+/**
+ * Nanoseconds per millisecond conversion constant
+ */
+const NS_PER_MS = 1_000_000;
+/**
+ * Nanoseconds per microsecond conversion constant
+ */
+const NS_PER_US = 1_000;
+/**
+ * Intelligently format a time range with appropriate precision Displays
+ * microseconds for small values (< 1ms) for better clarity
+ */
+const formatTimeRange = (minNs, maxNs) => {
+    // If both values are below 1ms, show in microseconds for better precision
+    if (maxNs < NS_PER_MS) {
+        const minUs = minNs / NS_PER_US;
+        const maxUs = maxNs / NS_PER_US;
+        return `${minUs.toFixed(2)}-${maxUs.toFixed(2)}µs`;
+    }
+    // Otherwise show in milliseconds
+    const minMs = minNs / NS_PER_MS;
+    const maxMs = maxNs / NS_PER_MS;
+    return `${minMs.toFixed(3)}-${maxMs.toFixed(3)}ms`;
+};
+/**
+ * Calculate visible string length, stripping ANSI escape codes
+ */
+const getVisualLength = (str) => stripVTControlCharacters(str).length;
+/**
+ * Formatter for history trends command
+ */
+export class HistoryTrendsFormatter {
+    /**
+     * Format as human-readable trends with visualizations
+     */
+    formatHuman(data) {
+        const lines = [];
+        lines.push(colorize('brightMagenta', colorize('bold', `\nPerformance Trends (${data.runs} runs)`)));
+        if (data.timespan.start && data.timespan.end) {
+            lines.push(colorize('dim', `Time range: ${data.timespan.start.toLocaleDateString()} to ${data.timespan.end.toLocaleDateString()}`));
+        }
+        lines.push('');
+        // Summary statistics
+        lines.push(colorize('brightBlue', 'Summary:'));
+        lines.push(`  ${colorize('brightCyan', '▲')} ${data.summary.improvingTasks} improving  ${colorize('brightRed', '▼')} ${data.summary.degradingTasks} degrading  ${colorize('dim', '→')} ${data.summary.stableTasks} stable`);
+        lines.push('');
+        // Task Performance Summary Table
+        lines.push(colorize('brightMagenta', 'Task Performance Summary:'));
+        lines.push('');
+        for (const trendData of data.trends) {
+            // Show top 20
+            const trendIcon = trendData.trend === 'improving'
+                ? colorize('brightCyan', '▲')
+                : trendData.trend === 'degrading'
+                    ? colorize('brightRed', '▼')
+                    : colorize('dim', '→');
+            const changeColor = trendData.percentChange < -5
+                ? 'brightCyan'
+                : trendData.percentChange > 5
+                    ? 'brightRed'
+                    : 'dim';
+            const changeSign = trendData.percentChange >= 0 ? '+' : '';
+            const changeStr = `${changeSign}${trendData.percentChange.toFixed(1)}%`;
+            // Generate sparkline - scale with number of data points (min 12, max 20)
+            const values = trendData.dataPoints.map((dp) => dp.mean);
+            const sparklineWidth = Math.min(20, Math.max(12, trendData.runs));
+            const sparkline = generateSparkline(values, sparklineWidth);
+            const sparklineColor = trendData.trend === 'improving'
+                ? 'brightCyan'
+                : trendData.trend === 'degrading'
+                    ? 'brightRed'
+                    : 'cyan';
+            const taskName = colorize('white', trendData.task);
+            const percentDisplay = colorize(changeColor, changeStr.padStart(8));
+            const sparklineDisplay = colorize(sparklineColor, sparkline);
+            // Layout: icon (2) + task name + padding + percent (8) + spaces (2) + sparkline
+            // Position percent+graph at visual column 60 for consistent alignment
+            const prefix = `  ${trendIcon} ${taskName}`;
+            const prefixVisualLength = getVisualLength(prefix);
+            const targetColumn = 60;
+            if (prefixVisualLength > targetColumn) {
+                // Task name is too long, wrap to next line
+                lines.push(prefix);
+                lines.push(`${' '.repeat(targetColumn)}${percentDisplay}  ${sparklineDisplay}`);
+            }
+            else {
+                // Fit on one line with padding
+                const padding = Math.max(1, targetColumn - prefixVisualLength);
+                const paddingStr = ' '.repeat(padding);
+                lines.push(`${prefix}${paddingStr}${percentDisplay}  ${sparklineDisplay}`);
+            }
+        }
+        // Show all trends (no limit)
+        lines.push('');
+        // Show regressions if any
+        if (data.regressions.length > 0) {
+            lines.push(colorize('brightRed', colorize('bold', 'Regressions Detected:')));
+            lines.push('');
+            for (const regression of data.regressions) {
+                lines.push(`  ${colorize('brightRed', '▼')} ${colorize('white', regression.task)}: ${colorize('brightRed', `${regression.percentChange.toFixed(1)}% slower`)} (${regression.runs} runs)`);
+            }
+            lines.push('');
+        }
+        // Show low-confidence regressions (insufficient data)
+        if (data.lowConfidenceRegressions.length > 0) {
+            lines.push(colorize('brightYellow', colorize('bold', '! Potential Regressions (insufficient data):')));
+            lines.push('');
+            for (const regression of data.lowConfidenceRegressions) {
+                lines.push(`  ${colorize('brightYellow', '!')} ${colorize('white', regression.task)}: ${colorize('brightYellow', `${regression.percentChange.toFixed(1)}% slower`)} (${regression.runs} run${regression.runs !== 1 ? 's' : ''})`);
+            }
+            lines.push('');
+        }
+        // Show performance distribution for most important task (highest RME) if we have enough data
+        // Find task with highest relative margin of error - the most variable/unreliable one
+        const mostImportantTrend = data.trends
+            .filter((t) => t.runs >= 5)
+            .sort((a, b) => {
+            const rmeA = (a.statistics.stdDeviation / a.statistics.mean) * 100;
+            const rmeB = (b.statistics.stdDeviation / b.statistics.mean) * 100;
+            return rmeB - rmeA; // Descending order (highest RME first)
+        })[0];
+        if (mostImportantTrend) {
+            lines.push(colorize('brightMagenta', 'Performance Distribution (most variable task):'));
+            lines.push(colorize('white', mostImportantTrend.task));
+            const cv = ((mostImportantTrend.statistics.stdDeviation /
+                mostImportantTrend.statistics.mean) *
+                100).toFixed(1);
+            lines.push(colorize('dim', `  Variability: ${cv}%`));
+            lines.push('');
+            // Create distribution buckets
+            const values = mostImportantTrend.dataPoints.map((dp) => dp.mean);
+            const min = Math.min(...values);
+            const max = Math.max(...values);
+            const range = max - min;
+            const numBuckets = Math.min(5, mostImportantTrend.runs);
+            const bucketSize = range / numBuckets;
+            const buckets = [];
+            for (let i = 0; i < numBuckets; i++) {
+                const bucketMin = min + i * bucketSize;
+                const bucketMax = min + (i + 1) * bucketSize;
+                const count = values.filter((v) => v >= bucketMin &&
+                    (i === numBuckets - 1 ? v <= bucketMax : v < bucketMax)).length;
+                const label = formatTimeRange(bucketMin, bucketMax);
+                buckets.push({
+                    count,
+                    label,
+                    max: bucketMax,
+                    min: bucketMin,
+                });
+            }
+            // Filter out empty buckets for cleaner display
+            const nonEmptyBuckets = buckets.filter((b) => b.count > 0);
+            const chart = generateBarChart(nonEmptyBuckets, 25);
+            for (const line of chart) {
+                lines.push(colorize('brightCyan', line));
+            }
+            lines.push('');
+            lines.push(colorize('dim', `  Mean: ${(mostImportantTrend.statistics.mean / NS_PER_MS).toFixed(3)}ms  Median: ${(mostImportantTrend.statistics.median / NS_PER_MS).toFixed(3)}ms  StdDev: ${(mostImportantTrend.statistics.stdDeviation / NS_PER_MS).toFixed(3)}ms`));
+            lines.push('');
+        }
+        return lines.join('\n');
+    }
+    /**
+     * Format as JSON
+     */
+    formatJson(data) {
+        return JSON.stringify({
+            regressions: data.regressions,
+            summary: {
+                degradingTasks: data.summary.degradingTasks,
+                improvingTasks: data.summary.improvingTasks,
+                runs: data.runs,
+                stableTasks: data.summary.stableTasks,
+                timespan: data.timespan,
+                totalTasks: data.summary.totalTasks,
+            },
+            trends: data.trends,
+        }, null, 2);
+    }
+}
+//# sourceMappingURL=trends.js.map

package/dist/formatters/history/trends.js.map

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

package/dist/formatters/history/visualization.cjs

@@ -0,0 +1,79 @@
+"use strict";
+/**
+ * Visualization Utilities for History Formatters
+ *
+ * Pure functions for generating ASCII visualizations (sparklines, bar charts)
+ * for trend analysis and performance distribution displays.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.generateSparkline = exports.generateBarChart = void 0;
+/**
+ * Generate bar chart histogram from distribution buckets
+ *
+ * @param distribution - Array of distribution buckets with counts
+ * @param maxWidth - Maximum width of bars (default 20)
+ * @returns Array of formatted bar chart lines
+ */
+const generateBarChart = (distribution, maxWidth = 20) => {
+    if (distribution.length === 0) {
+        return [];
+    }
+    // Find maximum count for scaling
+    const maxCount = Math.max(...distribution.map((b) => b.count));
+    if (maxCount === 0) {
+        return distribution.map((bucket) => `  ${bucket.label} (0 runs)`);
+    }
+    // Block characters for bar visualization
+    const fullBlock = '█';
+    const lightBlock = '░';
+    return distribution.map((bucket) => {
+        const ratio = bucket.count / maxCount;
+        const barLength = Math.round(ratio * maxWidth);
+        const fullBlocks = fullBlock.repeat(barLength);
+        const emptyBlocks = lightBlock.repeat(maxWidth - barLength);
+        return `  ${fullBlocks}${emptyBlocks} ${bucket.label} (${bucket.count} run${bucket.count !== 1 ? 's' : ''})`;
+    });
+};
+exports.generateBarChart = generateBarChart;
+/**
+ * Generate ASCII sparkline from values
+ *
+ * @param values - Array of numeric values to visualize
+ * @param width - Maximum width of sparkline (downsamples if needed)
+ * @returns ASCII sparkline string using block characters
+ */
+const generateSparkline = (values, width) => {
+    if (values.length === 0) {
+        return '';
+    }
+    // Sparkline characters from lowest to highest
+    const sparkChars = ['▁', '▂', '▃', '▄', '▅', '▆', '▇', '█'];
+    // Downsample if width is specified and values exceed it
+    let processedValues = values;
+    if (width && values.length > width) {
+        const step = values.length / width;
+        processedValues = [];
+        for (let i = 0; i < width; i++) {
+            const idx = Math.floor(i * step);
+            processedValues.push(values[idx] ?? 0);
+        }
+    }
+    // Find min and max for scaling
+    const min = Math.min(...processedValues);
+    const max = Math.max(...processedValues);
+    const range = max - min;
+    // Handle case where all values are the same
+    if (range === 0) {
+        return (sparkChars[4] ?? '▄').repeat(processedValues.length); // Use middle character
+    }
+    // Map each value to a sparkline character
+    return processedValues
+        .map((value) => {
+        const normalized = (value - min) / range;
+        const index = Math.min(Math.floor(normalized * sparkChars.length), sparkChars.length - 1);
+        return sparkChars[index] ?? '▄';
+    })
+        .join('');
+};
+exports.generateSparkline = generateSparkline;
+//# sourceMappingURL=visualization.js.map

package/dist/formatters/history/visualization.cjs.map

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

package/dist/formatters/history/visualization.d.cts

@@ -0,0 +1,24 @@
+/**
+ * Visualization Utilities for History Formatters
+ *
+ * Pure functions for generating ASCII visualizations (sparklines, bar charts)
+ * for trend analysis and performance distribution displays.
+ */
+import type { DistributionBucket } from "../../services/history/models.cjs";
+/**
+ * Generate bar chart histogram from distribution buckets
+ *
+ * @param distribution - Array of distribution buckets with counts
+ * @param maxWidth - Maximum width of bars (default 20)
+ * @returns Array of formatted bar chart lines
+ */
+export declare const generateBarChart: (distribution: DistributionBucket[], maxWidth?: number) => string[];
+/**
+ * Generate ASCII sparkline from values
+ *
+ * @param values - Array of numeric values to visualize
+ * @param width - Maximum width of sparkline (downsamples if needed)
+ * @returns ASCII sparkline string using block characters
+ */
+export declare const generateSparkline: (values: number[], width?: number) => string;
+//# sourceMappingURL=visualization.d.ts.map

package/dist/formatters/history/visualization.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"visualization.d.ts","sourceRoot":"","sources":["../../../src/formatters/history/visualization.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,kBAAkB,EAAE,0CAAyC;AAE3E;;;;;;GAMG;AACH,eAAO,MAAM,gBAAgB,GAC3B,cAAc,kBAAkB,EAAE,EAClC,iBAAa,KACZ,MAAM,EAwBR,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,iBAAiB,GAAI,QAAQ,MAAM,EAAE,EAAE,QAAQ,MAAM,KAAG,MAwCpE,CAAC"}

package/dist/formatters/history/visualization.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Visualization Utilities for History Formatters
+ *
+ * Pure functions for generating ASCII visualizations (sparklines, bar charts)
+ * for trend analysis and performance distribution displays.
+ */
+import type { DistributionBucket } from "../../services/history/models.js";
+/**
+ * Generate bar chart histogram from distribution buckets
+ *
+ * @param distribution - Array of distribution buckets with counts
+ * @param maxWidth - Maximum width of bars (default 20)
+ * @returns Array of formatted bar chart lines
+ */
+export declare const generateBarChart: (distribution: DistributionBucket[], maxWidth?: number) => string[];
+/**
+ * Generate ASCII sparkline from values
+ *
+ * @param values - Array of numeric values to visualize
+ * @param width - Maximum width of sparkline (downsamples if needed)
+ * @returns ASCII sparkline string using block characters
+ */
+export declare const generateSparkline: (values: number[], width?: number) => string;
+//# sourceMappingURL=visualization.d.ts.map

package/dist/formatters/history/visualization.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"visualization.d.ts","sourceRoot":"","sources":["../../../src/formatters/history/visualization.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,kBAAkB,EAAE,yCAAyC;AAE3E;;;;;;GAMG;AACH,eAAO,MAAM,gBAAgB,GAC3B,cAAc,kBAAkB,EAAE,EAClC,iBAAa,KACZ,MAAM,EAwBR,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,iBAAiB,GAAI,QAAQ,MAAM,EAAE,EAAE,QAAQ,MAAM,KAAG,MAwCpE,CAAC"}