@ac-bench/cli 0.1.0

package/LICENSE

@@ -0,0 +1,28 @@
+BSD 3-Clause License
+
+Copyright (c) 2024-2026 Anthony Champagne and contributors
+
+Redistribution and use in source and binary forms, with or without
+modification, are permitted provided that the following conditions are met:
+
+1. Redistributions of source code must retain the above copyright notice, this
+   list of conditions and the following disclaimer.
+
+2. Redistributions in binary form must reproduce the above copyright notice,
+   this list of conditions and the following disclaimer in the documentation
+   and/or other materials provided with the distribution.
+
+3. Neither the name of the copyright holder nor the names of its
+   contributors may be used to endorse or promote products derived from
+   this software without specific prior written permission.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
+AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
+DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE
+FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
+SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
+CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
+OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
+OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

package/README.md

@@ -0,0 +1,50 @@
+# @ac-bench/cli
+
+The benchmark CLI: argument parsing, config-file loading, and the resolution of
+everything a run needs — which reporters to use, what `--mode` stands for, where
+output files go.
+
+The engine underneath is `@ac-bench/lib`, which takes those already resolved.
+Use it directly to run benchmarks from your own code instead of a config file.
+
+## Configuration
+
+```ts
+// bench.config.ts
+import { defineConfig } from "@ac-bench/cli";
+import durationPlugin from "@ac-bench/measure-duration/plugin";
+import jsonReporter from "@ac-bench/reporter-json";
+
+export default defineConfig({
+  plugins: [durationPlugin, jsonReporter({ output: "artifacts/bench.json" })],
+  reporters: ["table", "json"],
+});
+```
+
+`plugins` holds measure and reporter plugins together — import each package and
+list what it exports. A package that takes options default-exports a factory
+(`jsonReporter({ … })`); one that does not default-exports the plugin
+(`durationPlugin`).
+
+`reporters` selects which reporters run, by id. `"table"`, `"json"`,
+`"markdown"` and `"csv"` resolve to the reporters this CLI ships, with their
+default options; any other id must name a reporter listed in `plugins`.
+
+Listing a reporter in `plugins` **configures** it, it does not select it. That
+separation is what lets `--reporter csv` turn on a reporter the config file has
+already configured, without naming it twice.
+
+Every option resolves in the same order: **command-line flag, then config file,
+then default**.
+
+## Configuring a built-in reporter
+
+Construct it yourself in `plugins` and keep selecting it by name — the
+configured instance wins over the built-in of the same id:
+
+```ts
+export default defineConfig({
+  plugins: [jsonReporter({ output: "artifacts/bench.json" })],
+  reporters: ["json"],
+});
+```

package/bin/measure.js

@@ -0,0 +1,15 @@
+#!/usr/bin/env node
+
+import path from "node:path";
+
+import packageJson from "../package.json" with { type: "json" };
+
+const entryPath = packageJson.exports["./cli"];
+
+if (path.extname(entryPath) === ".ts") {
+	await import("tsx/esm");
+}
+
+const entryUrl = new URL(entryPath, new URL("../", import.meta.url));
+
+await import(entryUrl.href);

package/dist/config.d.ts

@@ -0,0 +1,80 @@
+import type { BenchPlugin } from "@ac-bench/core/plugin";
+import { BenchConditionOptions } from "@ac-bench/core/runner";
+import { MeasurementPlan } from "@ac-bench/lib";
+import { BenchMode } from "./mode.js";
+export interface BenchConfig {
+    /** Glob patterns for bench files. Default: `["**\/*.bench.ts"]` */
+    include?: string[];
+    /** Glob patterns to exclude. Default: `["node_modules/**"]` */
+    exclude?: string[];
+    /**
+     * Ids of the reporters to run, in output order. Default: `["table"]`. Also
+     * settable with `--reporter`.
+     *
+     * `"table"`, `"json"`, `"markdown"` and `"csv"` resolve to the reporters this
+     * CLI ships, with their default options; any other id must name a reporter
+     * plugin listed in `plugins`. Listing a reporter in `plugins` configures it,
+     * it does not select it — that way `--reporter csv` can turn on a reporter
+     * this file has already configured.
+     */
+    reporters?: string[];
+    /** Default output base name (without extension) for file reporters. */
+    output?: string;
+    /**
+     * Default sampling options applied to all conditions (overridden per
+     * condition).
+     */
+    sampling?: Omit<BenchConditionOptions, "spawnBaselines">;
+    /**
+     * Measure and reporter plugins available to this run.
+     *
+     * Import each package directly and list what it exports: a package that takes
+     * options default-exports a factory (`jsonReporter({ output })`), one that
+     * does not default-exports the plugin (`durationPlugin`). The CLI never
+     * imports a measure package itself.
+     */
+    plugins?: readonly BenchPlugin[];
+    /**
+     * Modules imported inside every child before the bench file, in order.
+     *
+     * `beforeAll`/`afterAll` are condition-scoped and nothing wider exists, so
+     * this is the only per-child setup mechanism. Its cost is paid once per fork
+     * unit rather than once per run — which is what asking for it means when no
+     * state crosses a process boundary.
+     */
+    setupFiles?: string[];
+    /**
+     * Time without any message from a child before it is considered stuck.
+     * Default 30_000. Reset by every message it sends.
+     */
+    heartbeatTimeoutMs?: number;
+    /** Wall-clock cap on one fork unit. Default `0`, meaning no cap. */
+    conditionTimeoutMs?: number;
+    /**
+     * Wall-clock cap on the whole run, retries and cooldown included. Default
+     * `0`, meaning no cap. Also settable with `--max-total-time`.
+     */
+    maxTotalTimeMs?: number;
+    /**
+     * How much rigour to apply. Default `"standard"`. Also settable with
+     * `--mode`, which is the intended way in.
+     */
+    mode?: BenchMode;
+    /**
+     * Pins individual measurement-plan parameters, overriding what `mode`
+     * derives.
+     *
+     * For a run that must reproduce an exact plan rather than express an intent —
+     * a published comparison, or a CI job that has to stay comparable with last
+     * month's. Everyone else should use `mode`.
+     */
+    measurementPlan?: Partial<MeasurementPlan>;
+    /**
+     * Seeds replicate and case ordering. Default: derived from the clock, so each
+     * run randomises differently. Pin it to reproduce a run exactly.
+     */
+    orderSeed?: number;
+}
+/** Returns a typed config object. Use in `bench.config.ts`. */
+export declare function defineConfig(config: BenchConfig): BenchConfig;
+//# sourceMappingURL=config.d.ts.map

package/dist/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AAC9D,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAEhD,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAEtC,MAAM,WAAW,WAAW;IAC3B,mEAAmE;IACnE,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,+DAA+D;IAC/D,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB;;;;;;;;;OASG;IACH,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IACrB,uEAAuE;IACvE,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB;;;OAGG;IACH,QAAQ,CAAC,EAAE,IAAI,CAAC,qBAAqB,EAAE,gBAAgB,CAAC,CAAC;IACzD;;;;;;;OAOG;IACH,OAAO,CAAC,EAAE,SAAS,WAAW,EAAE,CAAC;IACjC;;;;;;;OAOG;IACH,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IACtB;;;OAGG;IACH,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,oEAAoE;IACpE,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B;;;OAGG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB;;;OAGG;IACH,IAAI,CAAC,EAAE,SAAS,CAAC;IACjB;;;;;;;OAOG;IACH,eAAe,CAAC,EAAE,OAAO,CAAC,eAAe,CAAC,CAAC;IAC3C;;;OAGG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,+DAA+D;AAC/D,wBAAgB,YAAY,CAAC,MAAM,EAAE,WAAW,GAAG,WAAW,CAE7D"}

package/dist/config.js

@@ -0,0 +1,5 @@
+/** Returns a typed config object. Use in `bench.config.ts`. */
+export function defineConfig(config) {
+    return config;
+}
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAgFA,+DAA+D;AAC/D,MAAM,UAAU,YAAY,CAAC,MAAmB;IAC/C,OAAO,MAAM,CAAC;AACf,CAAC"}

package/dist/main.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=main.d.ts.map

package/dist/main.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"main.d.ts","sourceRoot":"","sources":["../src/main.ts"],"names":[],"mappings":""}

package/dist/main.js

@@ -0,0 +1,71 @@
+/**
+ * Measure CLI entry point.
+ *
+ * Invoked via `bin/measure.js`, which registers tsx before importing this
+ * module.
+ */
+import { Command, InvalidArgumentError } from "commander";
+import packageJson from "../package.json" with { type: "json" };
+import { benchModeSchema } from "./mode.js";
+import { loadConfig, runAll } from "./runner.js";
+const program = new Command("measure")
+    .description("Discover and run TypeScript benchmark, latency, and timing files")
+    .version(packageJson.version)
+    .option("-c, --config <path>", "Path to bench config file")
+    .option("--include <pattern>", "Glob pattern for bench files (repeatable)", collect, [])
+    .option("--exclude <pattern>", "Glob pattern to exclude (repeatable)", collect, [])
+    .option("--filter <pattern>", "Only run conditions/cases whose title/name contains this substring (repeatable)", collect, [])
+    .option("--list", "List discovered conditions and cases without running them")
+    .option("--dry-run", "Alias for --list")
+    .option("--reporter <type>", "Reporter to use: table, json, markdown, csv (repeatable)", collect, [])
+    .option("--output <path>", "Output base name for file reporters")
+    .option("--mode <mode>", "How much rigour to apply: quick, standard or rigorous", parseMode)
+    .option("--order-seed <n>", "Reproduce a run's replicate and case ordering exactly", parseIntArg)
+    .option("--max-total-time <ms>", "Stop the run after this many milliseconds, retries and cooldown included", parseIntArg)
+    .option("--emit-samples", "Attach every case's raw samples; they are copied across the process boundary")
+    .option("--verbose", "Show every benchmark child's output as it happens, and full stack traces");
+program.action(async () => {
+    const opts = program.opts();
+    const config = opts.config ? await loadConfig(opts.config) : {};
+    const cli = {
+        ...(opts.include.length > 0 ? { include: opts.include } : {}),
+        ...(opts.exclude.length > 0 ? { exclude: opts.exclude } : {}),
+        ...(opts.filter.length > 0 ? { filter: opts.filter } : {}),
+        ...(opts.reporter.length > 0 ? { reporters: opts.reporter } : {}),
+        ...(opts.output !== undefined ? { output: opts.output } : {}),
+        ...(opts.list || opts.dryRun ? { list: true } : {}),
+        ...(opts.mode !== undefined ? { mode: opts.mode } : {}),
+        ...(opts.orderSeed !== undefined ? { orderSeed: opts.orderSeed } : {}),
+        ...(opts.maxTotalTime !== undefined
+            ? { maxTotalTime: opts.maxTotalTime }
+            : {}),
+        ...(opts.emitSamples ? { emitSamples: true } : {}),
+        ...(opts.verbose ? { verbose: true } : {}),
+    };
+    const controller = new AbortController();
+    process.once("SIGINT", () => {
+        process.stderr.write("\nmeasure: interrupted, finishing in-flight condition…\n");
+        controller.abort();
+    });
+    await runAll(config, cli, controller.signal);
+    if (controller.signal.aborted) {
+        process.exitCode = 130;
+    }
+});
+await program.parseAsync(process.argv);
+function collect(value, previous) {
+    return [...previous, value];
+}
+function parseIntArg(value) {
+    const parsed = Number.parseInt(value, 10);
+    if (Number.isNaN(parsed)) {
+        // Commander turns this one into a usage message; a plain Error would reach
+        // the user as a stack trace over a typo.
+        throw new InvalidArgumentError(`Expected an integer, got: ${value}`);
+    }
+    return parsed;
+}
+function parseMode(value) {
+    return benchModeSchema.parse(value);
+}
+//# sourceMappingURL=main.js.map

package/dist/main.js.map

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

package/dist/mode.d.ts

@@ -0,0 +1,27 @@
+import type { MeasurementPlan } from "@ac-bench/lib";
+import { z } from "zod/mini";
+/**
+ * What the user wants to know, not how to find it out.
+ *
+ * None of the measurement plan's parameters is a flag. A user asking for a
+ * trustworthy comparison should not also have to know how many processes that
+ * takes on their machine — the same move the sampler already makes for sample
+ * counts with `relativeError: "auto"`.
+ */
+export declare const benchModeSchema: z.ZodMiniEnum<{
+    quick: "quick";
+    rigorous: "rigorous";
+    standard: "standard";
+}>;
+export type BenchMode = z.infer<typeof benchModeSchema>;
+export declare const DEFAULT_BENCH_MODE: BenchMode;
+/**
+ * Derives the measurement plan a mode stands for.
+ *
+ * @param mode Defaults to {@link DEFAULT_BENCH_MODE}.
+ * @param overrides Mechanism the config file may pin, for a run that needs an
+ *   exact plan rather than an intent.
+ * @returns The plan, frozen so a later stage cannot quietly retune it.
+ */
+export declare function resolveMeasurementPlan(mode?: BenchMode, overrides?: Partial<MeasurementPlan>): MeasurementPlan;
+//# sourceMappingURL=mode.d.ts.map

package/dist/mode.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mode.d.ts","sourceRoot":"","sources":["../src/mode.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AACrD,OAAO,EAAE,CAAC,EAAE,MAAM,UAAU,CAAC;AAE7B;;;;;;;GAOG;AACH,eAAO,MAAM,eAAe;;;;EAA4C,CAAC;AACzE,MAAM,MAAM,SAAS,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,CAAC;AAqCxD,eAAO,MAAM,kBAAkB,EAAE,SAAsB,CAAC;AAExD;;;;;;;GAOG;AACH,wBAAgB,sBAAsB,CACrC,IAAI,GAAE,SAA8B,EACpC,SAAS,CAAC,EAAE,OAAO,CAAC,eAAe,CAAC,GAClC,eAAe,CAejB"}

package/dist/mode.js

@@ -0,0 +1,65 @@
+import { z } from "zod/mini";
+/**
+ * What the user wants to know, not how to find it out.
+ *
+ * None of the measurement plan's parameters is a flag. A user asking for a
+ * trustworthy comparison should not also have to know how many processes that
+ * takes on their machine — the same move the sampler already makes for sample
+ * counts with `relativeError: "auto"`.
+ */
+export const benchModeSchema = z.enum(["quick", "standard", "rigorous"]);
+const PROFILES_ = {
+    // One process, no replication: the process-level offset is unmeasured and
+    // the answer is a rough one. Says so by being called `quick`.
+    quick: {
+        replicates: 1,
+        maxReplicates: 1,
+        isolatedRuns: 0,
+        rounds: 1,
+        cooldown: false,
+        retryOnInstability: 0,
+    },
+    // Two processes is the cheapest plan that can see the process lottery at
+    // all: with one, the only interval available is the within-process one,
+    // which is exactly the number that says nothing about it. `standard` starts
+    // there and buys more only for a comparison those intervals leave open.
+    standard: {
+        replicates: 2,
+        maxReplicates: 5,
+        isolatedRuns: 0,
+        rounds: 16,
+        cooldown: false,
+        retryOnInstability: 0,
+    },
+    // Everything on: replicates for the process lottery, isolated runs for
+    // order sensitivity, and a machine that has been made to sit still first.
+    rigorous: {
+        replicates: 5,
+        maxReplicates: 9,
+        isolatedRuns: 3,
+        rounds: 16,
+        cooldown: true,
+        retryOnInstability: 1,
+    },
+};
+export const DEFAULT_BENCH_MODE = "standard";
+/**
+ * Derives the measurement plan a mode stands for.
+ *
+ * @param mode Defaults to {@link DEFAULT_BENCH_MODE}.
+ * @param overrides Mechanism the config file may pin, for a run that needs an
+ *   exact plan rather than an intent.
+ * @returns The plan, frozen so a later stage cannot quietly retune it.
+ */
+export function resolveMeasurementPlan(mode = DEFAULT_BENCH_MODE, overrides) {
+    const profile = PROFILES_[mode];
+    return {
+        replicates: overrides?.replicates ?? profile.replicates,
+        maxReplicates: Math.max(overrides?.maxReplicates ?? profile.maxReplicates, overrides?.replicates ?? profile.replicates),
+        isolatedRuns: overrides?.isolatedRuns ?? profile.isolatedRuns,
+        rounds: overrides?.rounds ?? profile.rounds,
+        cooldown: overrides?.cooldown ?? profile.cooldown,
+        retryOnInstability: overrides?.retryOnInstability ?? profile.retryOnInstability,
+    };
+}
+//# sourceMappingURL=mode.js.map

package/dist/mode.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mode.js","sourceRoot":"","sources":["../src/mode.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,UAAU,CAAC;AAE7B;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,UAAU,EAAE,UAAU,CAAC,CAAC,CAAC;AAGzE,MAAM,SAAS,GAAiD;IAC/D,0EAA0E;IAC1E,8DAA8D;IAC9D,KAAK,EAAE;QACN,UAAU,EAAE,CAAC;QACb,aAAa,EAAE,CAAC;QAChB,YAAY,EAAE,CAAC;QACf,MAAM,EAAE,CAAC;QACT,QAAQ,EAAE,KAAK;QACf,kBAAkB,EAAE,CAAC;KACrB;IACD,yEAAyE;IACzE,wEAAwE;IACxE,4EAA4E;IAC5E,wEAAwE;IACxE,QAAQ,EAAE;QACT,UAAU,EAAE,CAAC;QACb,aAAa,EAAE,CAAC;QAChB,YAAY,EAAE,CAAC;QACf,MAAM,EAAE,EAAE;QACV,QAAQ,EAAE,KAAK;QACf,kBAAkB,EAAE,CAAC;KACrB;IACD,uEAAuE;IACvE,0EAA0E;IAC1E,QAAQ,EAAE;QACT,UAAU,EAAE,CAAC;QACb,aAAa,EAAE,CAAC;QAChB,YAAY,EAAE,CAAC;QACf,MAAM,EAAE,EAAE;QACV,QAAQ,EAAE,IAAI;QACd,kBAAkB,EAAE,CAAC;KACrB;CACD,CAAC;AAEF,MAAM,CAAC,MAAM,kBAAkB,GAAc,UAAU,CAAC;AAExD;;;;;;;GAOG;AACH,MAAM,UAAU,sBAAsB,CACrC,IAAI,GAAc,kBAAkB,EACpC,SAAoC;IAEpC,MAAM,OAAO,GAAG,SAAS,CAAC,IAAI,CAAC,CAAC;IAEhC,OAAO;QACN,UAAU,EAAE,SAAS,EAAE,UAAU,IAAI,OAAO,CAAC,UAAU;QACvD,aAAa,EAAE,IAAI,CAAC,GAAG,CACtB,SAAS,EAAE,aAAa,IAAI,OAAO,CAAC,aAAa,EACjD,SAAS,EAAE,UAAU,IAAI,OAAO,CAAC,UAAU,CAC3C;QACD,YAAY,EAAE,SAAS,EAAE,YAAY,IAAI,OAAO,CAAC,YAAY;QAC7D,MAAM,EAAE,SAAS,EAAE,MAAM,IAAI,OAAO,CAAC,MAAM;QAC3C,QAAQ,EAAE,SAAS,EAAE,QAAQ,IAAI,OAAO,CAAC,QAAQ;QACjD,kBAAkB,EACjB,SAAS,EAAE,kBAAkB,IAAI,OAAO,CAAC,kBAAkB;KAC5D,CAAC;AACH,CAAC"}

package/dist/resolve-reporter-plugins.d.ts

@@ -0,0 +1,13 @@
+import type { ReporterPlugin } from "@ac-bench/core/plugin";
+/**
+ * Resolves reporter ids into the plugins that will run.
+ *
+ * A configured instance wins over the built-in of the same id, so a config file
+ * that lists `jsonReporter({ output: … })` in `plugins` gets its options
+ * honoured while still selecting the reporter by name.
+ *
+ * @throws {Error} An id names neither a configured plugin nor a built-in, or
+ *   two configured plugins claim the same id.
+ */
+export declare function resolveReporterPlugins(ids: readonly string[], configured: readonly ReporterPlugin[]): ReporterPlugin[];
+//# sourceMappingURL=resolve-reporter-plugins.d.ts.map

package/dist/resolve-reporter-plugins.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve-reporter-plugins.d.ts","sourceRoot":"","sources":["../src/resolve-reporter-plugins.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAmB5D;;;;;;;;;GASG;AACH,wBAAgB,sBAAsB,CACrC,GAAG,EAAE,SAAS,MAAM,EAAE,EACtB,UAAU,EAAE,SAAS,cAAc,EAAE,GACnC,cAAc,EAAE,CA0BlB"}

package/dist/resolve-reporter-plugins.js

@@ -0,0 +1,48 @@
+import csvReporter from "@ac-bench/reporter-csv";
+import jsonReporter from "@ac-bench/reporter-json";
+import markdownReporter from "@ac-bench/reporter-markdown";
+import tableReporter from "@ac-bench/reporter-table";
+/**
+ * The reporters this CLI ships, each with its own default options.
+ *
+ * Uniformly a thunk because a reporter package default-exports a factory only
+ * when it has options: `table` has none and exports the plugin itself.
+ */
+const BUILT_INS_ = {
+    table: () => tableReporter,
+    json: () => jsonReporter(),
+    markdown: () => markdownReporter(),
+    csv: () => csvReporter(),
+};
+/**
+ * Resolves reporter ids into the plugins that will run.
+ *
+ * A configured instance wins over the built-in of the same id, so a config file
+ * that lists `jsonReporter({ output: … })` in `plugins` gets its options
+ * honoured while still selecting the reporter by name.
+ *
+ * @throws {Error} An id names neither a configured plugin nor a built-in, or
+ *   two configured plugins claim the same id.
+ */
+export function resolveReporterPlugins(ids, configured) {
+    const byId = new Map();
+    for (const plugin of configured) {
+        if (byId.has(plugin.id)) {
+            throw new Error(`Duplicate reporter plugin id: ${plugin.id}`);
+        }
+        byId.set(plugin.id, plugin);
+    }
+    return ids.map((id) => {
+        const configuredPlugin = byId.get(id);
+        if (configuredPlugin) {
+            return configuredPlugin;
+        }
+        const builtIn = BUILT_INS_[id];
+        if (builtIn) {
+            return builtIn();
+        }
+        const known = [...new Set([...Object.keys(BUILT_INS_), ...byId.keys()])];
+        throw new Error(`Unknown reporter type: ${id}. Known reporters: ${known.join(", ")}`);
+    });
+}
+//# sourceMappingURL=resolve-reporter-plugins.js.map

package/dist/resolve-reporter-plugins.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve-reporter-plugins.js","sourceRoot":"","sources":["../src/resolve-reporter-plugins.ts"],"names":[],"mappings":"AACA,OAAO,WAAW,MAAM,wBAAwB,CAAC;AACjD,OAAO,YAAY,MAAM,yBAAyB,CAAC;AACnD,OAAO,gBAAgB,MAAM,6BAA6B,CAAC;AAC3D,OAAO,aAAa,MAAM,0BAA0B,CAAC;AAErD;;;;;GAKG;AACH,MAAM,UAAU,GAAmD;IAClE,KAAK,EAAE,GAAG,EAAE,CAAC,aAAa;IAC1B,IAAI,EAAE,GAAG,EAAE,CAAC,YAAY,EAAE;IAC1B,QAAQ,EAAE,GAAG,EAAE,CAAC,gBAAgB,EAAE;IAClC,GAAG,EAAE,GAAG,EAAE,CAAC,WAAW,EAAE;CACxB,CAAC;AAEF;;;;;;;;;GASG;AACH,MAAM,UAAU,sBAAsB,CACrC,GAAsB,EACtB,UAAqC;IAErC,MAAM,IAAI,GAAG,IAAI,GAAG,EAA0B,CAAC;IAE/C,KAAK,MAAM,MAAM,IAAI,UAAU,EAAE,CAAC;QACjC,IAAI,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,EAAE,CAAC;YACzB,MAAM,IAAI,KAAK,CAAC,iCAAiC,MAAM,CAAC,EAAE,EAAE,CAAC,CAAC;QAC/D,CAAC;QACD,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,EAAE,MAAM,CAAC,CAAC;IAC7B,CAAC;IAED,OAAO,GAAG,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE;QACrB,MAAM,gBAAgB,GAAG,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QACtC,IAAI,gBAAgB,EAAE,CAAC;YACtB,OAAO,gBAAgB,CAAC;QACzB,CAAC;QAED,MAAM,OAAO,GAAG,UAAU,CAAC,EAAE,CAAC,CAAC;QAC/B,IAAI,OAAO,EAAE,CAAC;YACb,OAAO,OAAO,EAAE,CAAC;QAClB,CAAC;QAED,MAAM,KAAK,GAAG,CAAC,GAAG,IAAI,GAAG,CAAC,CAAC,GAAG,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC,EAAE,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;QACzE,MAAM,IAAI,KAAK,CACd,0BAA0B,EAAE,sBAAsB,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CACpE,CAAC;IACH,CAAC,CAAC,CAAC;AACJ,CAAC"}

package/dist/runner.d.ts

@@ -0,0 +1,45 @@
+import { BenchConfig } from "./config.js";
+import { BenchMode } from "./mode.js";
+/** Load a config file by path (must default-export a BenchConfig). */
+export declare function loadConfig(configPath: string): Promise<BenchConfig>;
+/** CLI overrides from Commander flags. */
+export interface CliOverrides {
+    include?: string[];
+    exclude?: string[];
+    /**
+     * Case-insensitive substring patterns matched against a condition's title or
+     * a case's name.
+     */
+    filter?: string[];
+    /** Ids of the reporters to run, overriding the config file's list. */
+    reporters?: string[];
+    /** Output base name (without extension) for file reporters. */
+    output?: string;
+    /** Print discovered conditions/cases without running them. */
+    list?: boolean;
+    /**
+     * How much rigour the run should apply.
+     *
+     * The only rigour control on the CLI: replicate counts, isolated runs,
+     * cooldown gating and retries are all mechanism, and live in the config file
+     * for the rare run that needs to pin them exactly.
+     */
+    mode?: BenchMode;
+    /** Reproduces one run's replicate and case orderings exactly. */
+    orderSeed?: number;
+    /** Wall-clock cap on the whole run, in milliseconds. */
+    maxTotalTime?: number;
+    /** Attach each case's raw samples to its scope. */
+    emitSamples?: boolean;
+    /** Show every child's output as it happens, and full stack traces. */
+    verbose?: boolean;
+}
+/**
+ * Resolves flags and config into run parameters, then hands them to the
+ * programmatic API.
+ *
+ * Exits with status 1 when the include patterns match nothing: a run that
+ * measured nothing is a mistake to report, not an empty result to hand back.
+ */
+export declare function runAll(config: BenchConfig, cli: CliOverrides, signal: AbortSignal): Promise<void>;
+//# sourceMappingURL=runner.d.ts.map

package/dist/runner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runner.d.ts","sourceRoot":"","sources":["../src/runner.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC1C,OAAO,EAAE,SAAS,EAA0B,MAAM,WAAW,CAAC;AAU9D,sEAAsE;AACtE,wBAAsB,UAAU,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,CAIzE;AAED,0CAA0C;AAC1C,MAAM,WAAW,YAAY;IAC5B,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB;;;OAGG;IACH,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAClB,sEAAsE;IACtE,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IACrB,+DAA+D;IAC/D,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,8DAA8D;IAC9D,IAAI,CAAC,EAAE,OAAO,CAAC;IACf;;;;;;OAMG;IACH,IAAI,CAAC,EAAE,SAAS,CAAC;IACjB,iEAAiE;IACjE,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,wDAAwD;IACxD,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,mDAAmD;IACnD,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,sEAAsE;IACtE,OAAO,CAAC,EAAE,OAAO,CAAC;CAClB;AAED;;;;;;GAMG;AACH,wBAAsB,MAAM,CAC3B,MAAM,EAAE,WAAW,EACnB,GAAG,EAAE,YAAY,EACjB,MAAM,EAAE,WAAW,GACjB,OAAO,CAAC,IAAI,CAAC,CA4Df"}

package/dist/runner.js

@@ -0,0 +1,70 @@
+import { pathToFileURL } from "node:url";
+import { partitionPlugins } from "@ac-bench/core/plugin";
+import { runBench } from "@ac-bench/lib";
+import { formatError } from "@ac-kit/core";
+import { walkPaths } from "@ac-kit/node";
+import { resolveMeasurementPlan } from "./mode.js";
+import { resolveReporterPlugins } from "./resolve-reporter-plugins.js";
+/** Applied when neither the command line nor the config file names any. */
+const DEFAULT_INCLUDE = ["**/*.bench.ts"];
+// Matches the directory itself, at any depth, so the walk never enters it.
+const DEFAULT_EXCLUDE = ["**/node_modules"];
+const DEFAULT_REPORTERS = ["table"];
+const DEFAULT_OUTPUT = "bench-results";
+/** Load a config file by path (must default-export a BenchConfig). */
+export async function loadConfig(configPath) {
+    const url = pathToFileURL(configPath).href;
+    const mod = (await import(url));
+    return mod.default ?? {};
+}
+/**
+ * Resolves flags and config into run parameters, then hands them to the
+ * programmatic API.
+ *
+ * Exits with status 1 when the include patterns match nothing: a run that
+ * measured nothing is a mistake to report, not an empty result to hand back.
+ */
+export async function runAll(config, cli, signal) {
+    const include = cli.include ?? config.include ?? DEFAULT_INCLUDE;
+    const exclude = cli.exclude ?? config.exclude ?? DEFAULT_EXCLUDE;
+    if (cli.verbose === true) {
+        // Set once rather than threaded through every `formatError` call site: the
+        // switch is run-wide, and nothing in a bench run wants the short form while
+        // the user is asking to see everything.
+        formatError.defaultOptions.stackTrace = true;
+    }
+    const files = await Array.fromAsync(walkPaths({
+        include: include.length > 0 ? include : DEFAULT_INCLUDE,
+        exclude: exclude.length > 0 ? exclude : DEFAULT_EXCLUDE,
+        root: process.cwd(),
+        descend: true,
+        signal,
+    }), (walked) => walked.path);
+    if (files.length === 0) {
+        process.stderr.write("measure: no files found. Use --include to specify patterns.\n");
+        process.exit(1);
+    }
+    const { measures, reporters: configuredReporters } = partitionPlugins(config.plugins ?? []);
+    await runBench({
+        files,
+        measures,
+        reporters: resolveReporterPlugins(cli.reporters ?? config.reporters ?? DEFAULT_REPORTERS, configuredReporters),
+        output: cli.output ?? config.output ?? DEFAULT_OUTPUT,
+        plan: resolveMeasurementPlan(cli.mode ?? config.mode, config.measurementPlan),
+        orderSeed: cli.orderSeed ?? config.orderSeed ?? Date.now() | 0,
+        signal,
+        maxTotalTimeMs: cli.maxTotalTime ?? config.maxTotalTimeMs ?? 0,
+        ...(cli.filter ? { filter: cli.filter } : {}),
+        ...(cli.list === true ? { list: true } : {}),
+        ...(cli.emitSamples ? { emitSamples: true } : {}),
+        ...(cli.verbose ? { verbose: true } : {}),
+        ...(config.setupFiles ? { setupFiles: config.setupFiles } : {}),
+        ...(config.heartbeatTimeoutMs !== undefined
+            ? { heartbeatTimeoutMs: config.heartbeatTimeoutMs }
+            : {}),
+        ...(config.conditionTimeoutMs !== undefined
+            ? { conditionTimeoutMs: config.conditionTimeoutMs }
+            : {}),
+    });
+}
+//# sourceMappingURL=runner.js.map

package/dist/runner.js.map

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

package/package.json

@@ -0,0 +1,83 @@
+{
+  "name": "@ac-bench/cli",
+  "version": "0.1.0",
+  "description": "Command-line runner for @ac-bench benchmark suites: argument parsing, config-file loading and run resolution.",
+  "keywords": [
+    "benchmark",
+    "cli",
+    "measurement",
+    "performance"
+  ],
+  "homepage": "https://github.com/anthochamp/node-essentials/tree/main/bench/cli#readme",
+  "bugs": {
+    "url": "https://github.com/anthochamp/node-essentials/issues"
+  },
+  "license": "BSD-3-Clause",
+  "author": "Anthony Champagne <dev@anthonychampagne.fr>",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/anthochamp/node-essentials.git",
+    "directory": "bench/cli"
+  },
+  "bin": {
+    "measure": "./bin/measure.js"
+  },
+  "files": [
+    "dist",
+    "bin"
+  ],
+  "type": "module",
+  "sideEffects": false,
+  "main": "./dist/config.js",
+  "exports": {
+    ".": "./dist/config.js",
+    "./cli": "./dist/main.js"
+  },
+  "publishConfig": {
+    "main": "./dist/config.js",
+    "exports": {
+      ".": "./dist/config.js",
+      "./cli": "./dist/main.js"
+    },
+    "access": "public"
+  },
+  "scripts": {
+    "compile": "tsc -p ./tsconfig.build.json --outDir dist",
+    "compile:check": "tsc -noEmit -p ./tsconfig.json",
+    "clean": "rimraf dist",
+    "build": "yarn clean && yarn compile",
+    "test": "yarn run -T vitest run",
+    "prepack": "yarn build"
+  },
+  "dependencies": {
+    "@ac-bench/core": "^0.1.0",
+    "@ac-bench/lib": "^0.1.0",
+    "@ac-bench/reporter-csv": "^0.1.0",
+    "@ac-bench/reporter-json": "^0.1.0",
+    "@ac-bench/reporter-markdown": "^0.1.0",
+    "@ac-bench/reporter-table": "^0.1.0",
+    "@ac-kit/algo": "^0.1.0",
+    "@ac-kit/app-report": "^0.1.0",
+    "@ac-kit/app-system": "^0.1.0",
+    "@ac-kit/core": "^0.1.0",
+    "@ac-kit/node": "^0.1.0",
+    "commander": "^15.0.0",
+    "zod": "^4.5.4"
+  },
+  "devDependencies": {
+    "@ac-kit/tsconfig": "0.1.0",
+    "@ac-kit/typedoc-config": "0.1.0",
+    "@ac-kit/vitest-config": "0.1.0",
+    "@types/node": "26.5.1",
+    "@typescript/native": "typescript@7.0.2",
+    "rimraf": "6.1.3",
+    "tsx": "4.23.12",
+    "typedoc": "0.28.20",
+    "typescript": "@typescript/typescript6@6.0.2",
+    "vite": "8.3.0",
+    "vitest": "5.0.0"
+  },
+  "engines": {
+    "node": ">=24"
+  }
+}