modestbench 0.0.1

package/dist/types/interfaces.d.ts

@@ -0,0 +1,381 @@
+/**
+ * ModestBench Interface Types
+ *
+ * Defines the contract interfaces for all major components in the ModestBench
+ * system. These interfaces establish the public APIs that implementations must
+ * satisfy.
+ */
+import type { BenchmarkFile, BenchmarkRun, ErrorContext, ErrorStats, ExecutionError, FileResult, ModestBenchConfig, SuiteResult, TaskResult } from "./core.js";
+/**
+ * Main benchmark engine interface
+ */
+export interface BenchmarkEngine {
+    /**
+     * Discover benchmark files matching patterns
+     */
+    discover(pattern: string | string[], exclude?: string[]): Promise<string[]>;
+    /**
+     * Execute benchmarks with the given configuration
+     */
+    execute(config: RunConfiguration, reporters?: Reporter[], signal?: AbortSignal): Promise<BenchmarkRun>;
+    /**
+     * Get all registered reporters
+     */
+    getReporters(): Record<string, Reporter>;
+    /**
+     * Register a reporter for benchmark output
+     */
+    registerReporter(name: string, reporter: Reporter): void;
+    /**
+     * Validate benchmark files
+     */
+    validate(files: string[]): Promise<ValidationResult>;
+}
+/**
+ * Result of a cleanup operation
+ */
+export interface CleanupResult {
+    /** Amount of disk space freed in bytes */
+    readonly freedBytes: number;
+    /** Files that were removed */
+    readonly removedFiles: string[];
+    /** Number of runs removed */
+    readonly removedRuns: number;
+}
+/**
+ * Configuration management interface
+ */
+export interface ConfigurationManager {
+    /**
+     * Get default configuration values
+     */
+    getDefaults(): ModestBenchConfig;
+    /**
+     * Load configuration from various sources
+     */
+    load(configPath?: string, cliArgs?: Record<string, unknown>): Promise<ModestBenchConfig>;
+    /**
+     * Merge multiple configuration objects with precedence
+     */
+    merge(...configs: Partial<ModestBenchConfig>[]): ModestBenchConfig;
+    /**
+     * Validate a configuration object
+     */
+    validate(config: Partial<ModestBenchConfig>): ValidationResult;
+}
+/**
+ * CSV output reporter interface
+ */
+export interface CsvReporter extends Reporter {
+    /** CSV delimiter character */
+    readonly delimiter: string;
+    /** Include CSV headers */
+    readonly includeHeaders: boolean;
+}
+/**
+ * Error management interface for handling execution errors
+ */
+export interface ErrorManager {
+    /**
+     * Clear error history
+     */
+    clearStats(): void;
+    /**
+     * Format error for display
+     */
+    formatError(error: ExecutionError): string;
+    /**
+     * Get error code for a given error
+     */
+    getErrorCode(error: Error, context: ErrorContext): string;
+    /**
+     * Get error statistics
+     */
+    getStats(): ErrorStats;
+    /**
+     * Handle an execution error
+     */
+    handleError(error: Error, context: ErrorContext): ExecutionError;
+    /**
+     * Check if an error is recoverable
+     */
+    isRecoverable(error: ExecutionError): boolean;
+    /**
+     * Register error handler callback
+     */
+    onError(handler: (error: ExecutionError) => void): void;
+}
+/**
+ * File loader interface for benchmark discovery and loading
+ */
+export interface FileLoader {
+    /**
+     * Discover benchmark files matching patterns
+     */
+    discover(pattern: string | string[], exclude?: string[]): Promise<string[]>;
+    /**
+     * Load a benchmark file
+     */
+    load(filePath: string): Promise<BenchmarkFile>;
+    /**
+     * Validate a benchmark file
+     */
+    validate(filePath: string): Promise<ValidationResult>;
+}
+/**
+ * Query interface for historical benchmark data
+ */
+export interface HistoryQuery {
+    /** Maximum number of results */
+    readonly limit?: number;
+    /** Results offset for pagination */
+    readonly offset?: number;
+    /** Pattern to match benchmark names */
+    readonly pattern?: string;
+    /** Start date for filtering */
+    readonly since?: Date;
+    /** Sort order */
+    readonly sort?: 'asc' | 'desc';
+    /** Field to sort by */
+    readonly sortBy?: 'date' | 'duration' | 'name';
+    /** Tags to filter by */
+    readonly tags?: string[];
+    /** End date for filtering */
+    readonly until?: Date;
+}
+/**
+ * Historical data storage interface
+ */
+export interface HistoryStorage {
+    /**
+     * Clean up old data according to retention policy
+     */
+    cleanup(policy: RetentionPolicy): Promise<CleanupResult>;
+    /**
+     * Export historical data
+     */
+    export(format: 'csv' | 'json', query?: HistoryQuery): Promise<string>;
+    /**
+     * Get index of all stored runs
+     */
+    getIndex(): Promise<Array<{
+        date: Date;
+        id: string;
+        summary: string;
+    }>>;
+    /**
+     * Load a specific benchmark run
+     */
+    loadRun(id: string): Promise<BenchmarkRun | null>;
+    /**
+     * Query historical runs
+     */
+    queryRuns(query: HistoryQuery): Promise<BenchmarkRun[]>;
+    /**
+     * Save a benchmark run to storage
+     */
+    saveRun(run: BenchmarkRun): Promise<void>;
+}
+/**
+ * Human-readable reporter interface
+ */
+export interface HumanReporter extends Reporter {
+    /** Displays progress bars */
+    readonly showProgress: boolean;
+    /** Uses colors and formatting for terminal output */
+    readonly supportsColor: boolean;
+}
+/**
+ * JSON output reporter interface
+ */
+export interface JsonReporter extends Reporter {
+    /** Pretty-print JSON output */
+    readonly prettyPrint: boolean;
+    /** Supports streaming output */
+    readonly streaming: boolean;
+}
+/**
+ * Progress management interface
+ */
+export interface ProgressManager {
+    /**
+     * Clean up progress tracking resources
+     */
+    cleanup(): void;
+    /**
+     * Estimate completion time
+     */
+    estimateCompletion(): Date | null;
+    /**
+     * Force an immediate progress update (bypassing throttling)
+     */
+    forceUpdate(): void;
+    /**
+     * Get current progress state
+     */
+    getState(): ProgressState;
+    /**
+     * Initialize progress tracking for a benchmark run
+     */
+    initialize(run: BenchmarkRun): void;
+    /**
+     * Register a callback for progress updates
+     */
+    onProgress(callback: (state: ProgressState) => void): void;
+    /**
+     * Update progress state
+     */
+    update(state: Partial<ProgressState>): void;
+}
+/**
+ * Progress tracking state
+ */
+export interface ProgressState {
+    /** Current file being processed */
+    readonly currentFile?: string;
+    /** Current suite being processed */
+    readonly currentSuite?: string;
+    /** Current task being processed */
+    readonly currentTask?: string;
+    /** Elapsed time in milliseconds */
+    readonly elapsed: number;
+    /** Number of files completed */
+    readonly filesCompleted: number;
+    /** Progress percentage (0-100) */
+    readonly percentage: number;
+    /** Number of suites completed */
+    readonly suitesCompleted: number;
+    /** Number of tasks completed */
+    readonly tasksCompleted: number;
+    /** Total number of files */
+    readonly totalFiles: number;
+    /** Total number of suites */
+    readonly totalSuites: number;
+    /** Total number of tasks */
+    readonly totalTasks: number;
+}
+/**
+ * Base reporter interface for benchmark output
+ */
+export interface Reporter {
+    /**
+     * Called when benchmark run completes
+     */
+    onEnd(run: BenchmarkRun): Promise<void> | void;
+    /**
+     * Called when an error occurs
+     */
+    onError(error: Error): Promise<void> | void;
+    /**
+     * Called when a file completes
+     */
+    onFileEnd(result: FileResult): Promise<void> | void;
+    /**
+     * Called when a file starts execution
+     */
+    onFileStart(file: string): Promise<void> | void;
+    /**
+     * Called for progress updates
+     */
+    onProgress(state: ProgressState): Promise<void> | void;
+    /**
+     * Called when benchmark run starts
+     */
+    onStart(run: BenchmarkRun): Promise<void> | void;
+    /**
+     * Called when a suite completes
+     */
+    onSuiteEnd(result: SuiteResult): Promise<void> | void;
+    /**
+     * Called when a suite starts execution
+     */
+    onSuiteStart(suite: string): Promise<void> | void;
+    /**
+     * Called when a task completes
+     */
+    onTaskResult(result: TaskResult): Promise<void> | void;
+    /**
+     * Called when a task starts execution
+     */
+    onTaskStart(task: string): Promise<void> | void;
+}
+/**
+ * Reporter registry interface
+ */
+export interface ReporterRegistry {
+    /**
+     * Get a reporter by name
+     */
+    get(name: string): Reporter | undefined;
+    /**
+     * Get all registered reporters
+     */
+    getAll(): Record<string, Reporter>;
+    /**
+     * Get reporters by multiple names
+     */
+    getByNames(names: string[]): Reporter[];
+    /**
+     * Register a reporter
+     */
+    register(name: string, reporter: Reporter): void;
+}
+/**
+ * Retention policy for historical data
+ */
+export interface RetentionPolicy {
+    /** Maximum age of data to keep */
+    readonly maxAge?: number;
+    /** Maximum number of runs to keep */
+    readonly maxRuns?: number;
+    /** Maximum size of history data in bytes */
+    readonly maxSize?: number;
+}
+/**
+ * Configuration for a benchmark run execution
+ */
+export interface RunConfiguration extends Partial<ModestBenchConfig> {
+    /** Working directory for execution */
+    readonly cwd?: string;
+    /** Environment variables to set */
+    readonly env?: Record<string, string>;
+    /** Files to execute (overrides pattern discovery) */
+    readonly files?: string[];
+}
+/**
+ * A validation error
+ */
+export interface ValidationError {
+    /** Error code for programmatic handling */
+    readonly code: string;
+    /** Column number where error occurred */
+    readonly column?: number;
+    /** File where error occurred */
+    readonly file: string;
+    /** Line number where error occurred */
+    readonly line?: number;
+    /** Error message */
+    readonly message: string;
+    /** Severity level */
+    readonly severity: 'error' | 'warning';
+}
+/**
+ * Result of a validation operation
+ */
+export interface ValidationResult {
+    /** Validation errors found */
+    readonly errors: ValidationError[];
+    /** Files that were validated */
+    readonly files: string[];
+    /** Whether validation passed */
+    readonly valid: boolean;
+    /** Validation warnings */
+    readonly warnings: ValidationWarning[];
+}
+/**
+ * A validation warning
+ */
+export interface ValidationWarning extends ValidationError {
+    readonly severity: 'warning';
+}
+//# sourceMappingURL=interfaces.d.ts.map

package/dist/types/interfaces.d.ts.map

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

package/dist/types/interfaces.js

@@ -0,0 +1,9 @@
+/**
+ * ModestBench Interface Types
+ *
+ * Defines the contract interfaces for all major components in the ModestBench
+ * system. These interfaces establish the public APIs that implementations must
+ * satisfy.
+ */
+export {};
+//# sourceMappingURL=interfaces.js.map

package/dist/types/interfaces.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"interfaces.js","sourceRoot":"","sources":["../../src/types/interfaces.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG"}

package/dist/types/utility.cjs

@@ -0,0 +1,92 @@
+"use strict";
+/**
+ * ModestBench Utility Types
+ *
+ * Defines utility types, helper functions, and common type transformations used
+ * throughout the ModestBench system.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.unbrand = exports.brand = exports.assertDefined = exports.failure = exports.success = exports.isNonEmptyArray = exports.isInteger = exports.isNonNegativeNumber = exports.isPositiveNumber = exports.isNonEmptyString = exports.isDefined = void 0;
+/**
+ * Type predicate for checking if value is not null or undefined
+ */
+const isDefined = (value) => {
+    return value !== null && value !== undefined;
+};
+exports.isDefined = isDefined;
+/**
+ * Type predicate for checking if value is a non-empty string
+ */
+const isNonEmptyString = (value) => {
+    return typeof value === 'string' && value.length > 0;
+};
+exports.isNonEmptyString = isNonEmptyString;
+/**
+ * Type predicate for checking if value is a positive number
+ */
+const isPositiveNumber = (value) => {
+    return typeof value === 'number' && value > 0 && !Number.isNaN(value);
+};
+exports.isPositiveNumber = isPositiveNumber;
+/**
+ * Type predicate for checking if value is a non-negative number
+ */
+const isNonNegativeNumber = (value) => {
+    return typeof value === 'number' && value >= 0 && !Number.isNaN(value);
+};
+exports.isNonNegativeNumber = isNonNegativeNumber;
+/**
+ * Type predicate for checking if value is an integer
+ */
+const isInteger = (value) => {
+    return typeof value === 'number' && Number.isInteger(value);
+};
+exports.isInteger = isInteger;
+/**
+ * Type predicate for checking if array is non-empty
+ */
+const isNonEmptyArray = (value) => {
+    return value.length > 0;
+};
+exports.isNonEmptyArray = isNonEmptyArray;
+/**
+ * Creates a Result success value
+ */
+const success = (data) => ({
+    data,
+    success: true,
+});
+exports.success = success;
+/**
+ * Creates a Result error value
+ */
+const failure = (error) => ({
+    error,
+    success: false,
+});
+exports.failure = failure;
+/**
+ * Type assertion that a value is defined (throws if not)
+ */
+const assertDefined = (value, message) => {
+    if (!(0, exports.isDefined)(value)) {
+        throw new Error(message ?? 'Value is null or undefined');
+    }
+    return value;
+};
+exports.assertDefined = assertDefined;
+/**
+ * Creates a branded type value
+ */
+const brand = (value) => {
+    return value;
+};
+exports.brand = brand;
+/**
+ * Removes brand from a branded type
+ */
+const unbrand = (value) => {
+    return value;
+};
+exports.unbrand = unbrand;
+//# sourceMappingURL=utility.js.map

package/dist/types/utility.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"utility.js","sourceRoot":"","sources":["../../src/types/utility.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;;AAiWH;;GAEG;AACI,MAAM,SAAS,GAAG,CAAI,KAA2B,EAAc,EAAE;IACtE,OAAO,KAAK,KAAK,IAAI,IAAI,KAAK,KAAK,SAAS,CAAC;AAC/C,CAAC,CAAC;AAFW,QAAA,SAAS,aAEpB;AAEF;;GAEG;AACI,MAAM,gBAAgB,GAAG,CAAC,KAAc,EAA2B,EAAE;IAC1E,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC;AACvD,CAAC,CAAC;AAFW,QAAA,gBAAgB,oBAE3B;AAEF;;GAEG;AACI,MAAM,gBAAgB,GAAG,CAAC,KAAc,EAA2B,EAAE;IAC1E,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;AACxE,CAAC,CAAC;AAFW,QAAA,gBAAgB,oBAE3B;AAEF;;GAEG;AACI,MAAM,mBAAmB,GAAG,CACjC,KAAc,EACc,EAAE;IAC9B,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;AACzE,CAAC,CAAC;AAJW,QAAA,mBAAmB,uBAI9B;AAEF;;GAEG;AACI,MAAM,SAAS,GAAG,CAAC,KAAc,EAAoB,EAAE;IAC5D,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,MAAM,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;AAC9D,CAAC,CAAC;AAFW,QAAA,SAAS,aAEpB;AAEF;;GAEG;AACI,MAAM,eAAe,GAAG,CAAI,KAAU,EAA6B,EAAE;IAC1E,OAAO,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC;AAC1B,CAAC,CAAC;AAFW,QAAA,eAAe,mBAE1B;AAEF;;GAEG;AACI,MAAM,OAAO,GAAG,CAAI,IAAO,EAAoB,EAAE,CAAC,CAAC;IACxD,IAAI;IACJ,OAAO,EAAE,IAAI;CACd,CAAC,CAAC;AAHU,QAAA,OAAO,WAGjB;AAEH;;GAEG;AACI,MAAM,OAAO,GAAG,CAAI,KAAQ,EAAoB,EAAE,CAAC,CAAC;IACzD,KAAK;IACL,OAAO,EAAE,KAAK;CACf,CAAC,CAAC;AAHU,QAAA,OAAO,WAGjB;AAEH;;GAEG;AACI,MAAM,aAAa,GAAG,CAC3B,KAA2B,EAC3B,OAAgB,EACb,EAAE;IACL,IAAI,CAAC,IAAA,iBAAS,EAAC,KAAK,CAAC,EAAE,CAAC;QACtB,MAAM,IAAI,KAAK,CAAC,OAAO,IAAI,4BAA4B,CAAC,CAAC;IAC3D,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC,CAAC;AARW,QAAA,aAAa,iBAQxB;AAEF;;GAEG;AACI,MAAM,KAAK,GAAG,CAA2B,KAAQ,EAAoB,EAAE;IAC5E,OAAO,KAAyB,CAAC;AACnC,CAAC,CAAC;AAFW,QAAA,KAAK,SAEhB;AAEF;;GAEG;AACI,MAAM,OAAO,GAAG,CACrB,KAAuB,EACpB,EAAE;IACL,OAAO,KAAU,CAAC;AACpB,CAAC,CAAC;AAJW,QAAA,OAAO,WAIlB"}