@ac-bench/lib 0.1.0

package/dist/measure-diagnostic-proxy.js

@@ -0,0 +1,50 @@
+import { formatError } from "@ac-kit/core";
+/**
+ * Derives the generic `diagnostic` events from a measure's typed warnings, in
+ * the parent.
+ *
+ * Warnings live in the typed result, where the plugin renders them inline per
+ * row; generic sinks need them as severity-carrying events. Emitting both from
+ * the child would give one fact two sources of truth, so the translation
+ * happens here instead — right after the `data` event that carries the result
+ * and before the case's `scope-end`.
+ */
+export function createMeasureDiagnosticProxy(inner, registry) {
+    return {
+        enabled: (probe) => inner.enabled?.(probe) ?? true,
+        async write(event, signal) {
+            await inner.write(event, signal);
+            if (event.kind !== "data" || event.data.kind !== "case-result") {
+                return;
+            }
+            const { measure, caseTitle, result } = event.data;
+            for (const diagnostic of resolveWarnings_(registry, measure, result)) {
+                await inner.write({
+                    kind: "diagnostic",
+                    timestamp: event.timestamp,
+                    scopeId: event.scopeId,
+                    ...diagnostic,
+                    // The scope this lands on is the condition's, not the case's.
+                    attributes: { ...diagnostic.attributes, "bench.case": caseTitle },
+                }, signal);
+            }
+        },
+        flush: (signal) => inner.flush(signal),
+        close: (signal) => inner.close(signal),
+    };
+}
+function resolveWarnings_(registry, measure, result) {
+    try {
+        return registry.resolve(measure).warnings(result);
+    }
+    catch (error) {
+        return [
+            {
+                severity: "error",
+                code: "invalid-case-result",
+                message: `measure "${measure}" rejected its own case result: ${formatError(error)}`,
+            },
+        ];
+    }
+}
+//# sourceMappingURL=measure-diagnostic-proxy.js.map

package/dist/measure-diagnostic-proxy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"measure-diagnostic-proxy.js","sourceRoot":"","sources":["../src/measure-diagnostic-proxy.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAE3C;;;;;;;;;GASG;AACH,MAAM,UAAU,4BAA4B,CAC3C,KAAyB,EACzB,QAAyB;IAEzB,OAAO;QACN,OAAO,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC,KAAK,CAAC,IAAI,IAAI;QAElD,KAAK,CAAC,KAAK,CAAC,KAAK,EAAE,MAAM;YACxB,MAAM,KAAK,CAAC,KAAK,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;YAEjC,IAAI,KAAK,CAAC,IAAI,KAAK,MAAM,IAAI,KAAK,CAAC,IAAI,CAAC,IAAI,KAAK,aAAa,EAAE,CAAC;gBAChE,OAAO;YACR,CAAC;YAED,MAAM,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,GAAG,KAAK,CAAC,IAAI,CAAC;YAElD,KAAK,MAAM,UAAU,IAAI,gBAAgB,CAAC,QAAQ,EAAE,OAAO,EAAE,MAAM,CAAC,EAAE,CAAC;gBACtE,MAAM,KAAK,CAAC,KAAK,CAChB;oBACC,IAAI,EAAE,YAAY;oBAClB,SAAS,EAAE,KAAK,CAAC,SAAS;oBAC1B,OAAO,EAAE,KAAK,CAAC,OAAO;oBACtB,GAAG,UAAU;oBACb,8DAA8D;oBAC9D,UAAU,EAAE,EAAE,GAAG,UAAU,CAAC,UAAU,EAAE,YAAY,EAAE,SAAS,EAAE;iBACjE,EACD,MAAM,CACN,CAAC;YACH,CAAC;QACF,CAAC;QAED,KAAK,EAAE,CAAC,MAAM,EAAE,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,MAAM,CAAC;QACtC,KAAK,EAAE,CAAC,MAAM,EAAE,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,MAAM,CAAC;KACtC,CAAC;AACH,CAAC;AAED,SAAS,gBAAgB,CACxB,QAAyB,EACzB,OAAe,EACf,MAAe;IAEf,IAAI,CAAC;QACJ,OAAO,QAAQ,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;IACnD,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QAChB,OAAO;YACN;gBACC,QAAQ,EAAE,OAAO;gBACjB,IAAI,EAAE,qBAAqB;gBAC3B,OAAO,EAAE,YAAY,OAAO,mCAAmC,WAAW,CAAC,KAAK,CAAC,EAAE;aACnF;SACD,CAAC;IACH,CAAC;AACF,CAAC"}

package/dist/measurement-plan.d.ts

@@ -0,0 +1,50 @@
+/**
+ * How many contexts a condition is measured in, and under what conditions.
+ *
+ * Sampling (how many samples one case needs in one process) is the layer below
+ * and is decided per case by the sampler. This is the layer above: how many
+ * processes there are and what runs in each.
+ *
+ * Parameters, not an intent: naming an intent (`quick`, `rigorous`) and turning
+ * it into these numbers is configuration, and lives in `@ac-bench/cli`.
+ */
+export type MeasurementPlan = {
+    /**
+     * `P`: independent processes running the whole condition, cases together.
+     *
+     * Differences between cases measured in the same process are paired, so the
+     * process-level offset cancels. Replicating gives that offset a distribution
+     * instead of one unknown draw.
+     */
+    readonly replicates: number;
+    /**
+     * Ceiling on `P` when the run escalates.
+     *
+     * A plan that starts cheap buys more processes only for a comparison its
+     * intervals have not settled, and only up to here.
+     */
+    readonly maxReplicates: number;
+    /**
+     * `Q`: additional processes running one case alone, with the full ancestor
+     * hook chain.
+     *
+     * The only way to tell "this case is slow" from "this case is slow after the
+     * one before it". Costs an execution of every ancestor hook per case, so it
+     * stays small and off by default.
+     */
+    readonly isolatedRuns: number;
+    /**
+     * `R`: how many turns each case takes within one process.
+     *
+     * Above 1 the cases interleave, one measured slice each in turn, so none of
+     * them owns a single stretch of the process's life. At 1 they run to
+     * completion one after another, and the first case measured gets the cold
+     * interpreter while the last gets the warm one.
+     */
+    readonly rounds: number;
+    /** Wait for the machine to settle before each attempt. */
+    readonly cooldown: boolean;
+    /** Re-runs of a condition whose environment verdict was `"unstable"`. */
+    readonly retryOnInstability: number;
+};
+//# sourceMappingURL=measurement-plan.d.ts.map

package/dist/measurement-plan.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"measurement-plan.d.ts","sourceRoot":"","sources":["../src/measurement-plan.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,MAAM,MAAM,eAAe,GAAG;IAC7B;;;;;;OAMG;IACH,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAE5B;;;;;OAKG;IACH,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAE/B;;;;;;;OAOG;IACH,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAE9B;;;;;;;OAOG;IACH,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IAExB,0DAA0D;IAC1D,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;IAE3B,yEAAyE;IACzE,QAAQ,CAAC,kBAAkB,EAAE,MAAM,CAAC;CACpC,CAAC"}

package/dist/measurement-plan.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=measurement-plan.js.map

package/dist/measurement-plan.js.map

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

package/dist/reporter-context.d.ts

@@ -0,0 +1,19 @@
+import type { MeasureRegistry, ReporterContext } from "@ac-bench/core/plugin";
+import type { Terminal } from "@ac-kit/app-terminal";
+export type ReporterContextOptions = {
+    readonly registry: MeasureRegistry;
+    /** Base name for output files, for a reporter given no explicit one. */
+    readonly defaultOutput: string;
+    /** Defaults to `process.stdout`, wrapped so a sink cannot close it. */
+    readonly stdout?: WritableStream<string>;
+    /** Defaults to whatever `process.stdout` reports. */
+    readonly terminal?: Terminal;
+    /** Show what a run normally hides: child output, full stack traces. */
+    readonly verbose?: boolean;
+};
+/**
+ * Assembles the host-bound half of reporting, so a reporter package needs no
+ * `node:` import of its own.
+ */
+export declare function createReporterContext(options: ReporterContextOptions): ReporterContext;
+//# sourceMappingURL=reporter-context.d.ts.map

package/dist/reporter-context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reporter-context.d.ts","sourceRoot":"","sources":["../src/reporter-context.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAE9E,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAGrD,MAAM,MAAM,sBAAsB,GAAG;IACpC,QAAQ,CAAC,QAAQ,EAAE,eAAe,CAAC;IACnC,wEAAwE;IACxE,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,uEAAuE;IACvE,QAAQ,CAAC,MAAM,CAAC,EAAE,cAAc,CAAC,MAAM,CAAC,CAAC;IACzC,qDAAqD;IACrD,QAAQ,CAAC,QAAQ,CAAC,EAAE,QAAQ,CAAC;IAE7B,uEAAuE;IACvE,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC;CAC3B,CAAC;AAEF;;;GAGG;AACH,wBAAgB,qBAAqB,CACpC,OAAO,EAAE,sBAAsB,GAC7B,eAAe,CAYjB"}

package/dist/reporter-context.js

@@ -0,0 +1,21 @@
+import { createWriteStream } from "node:fs";
+import { Writable } from "node:stream";
+import { nodeTerminal } from "@ac-kit/app-system";
+import { nonClosingWritableStream } from "@ac-kit/node";
+/**
+ * Assembles the host-bound half of reporting, so a reporter package needs no
+ * `node:` import of its own.
+ */
+export function createReporterContext(options) {
+    return {
+        registry: options.registry,
+        terminal: options.terminal ?? nodeTerminal(process.stdout),
+        defaultOutput: options.defaultOutput,
+        verbose: options.verbose === true,
+        // Never closes process.stdout — closing a TTY-backed WHATWG writable never
+        // resolves.
+        stdout: options.stdout ?? nonClosingWritableStream(process.stdout),
+        openOutput: (fileName) => Writable.toWeb(createWriteStream(fileName)),
+    };
+}
+//# sourceMappingURL=reporter-context.js.map

package/dist/reporter-context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"reporter-context.js","sourceRoot":"","sources":["../src/reporter-context.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAC;AAC5C,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAGvC,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAElD,OAAO,EAAE,wBAAwB,EAAE,MAAM,cAAc,CAAC;AAexD;;;GAGG;AACH,MAAM,UAAU,qBAAqB,CACpC,OAA+B;IAE/B,OAAO;QACN,QAAQ,EAAE,OAAO,CAAC,QAAQ;QAC1B,QAAQ,EAAE,OAAO,CAAC,QAAQ,IAAI,YAAY,CAAC,OAAO,CAAC,MAAM,CAAC;QAC1D,aAAa,EAAE,OAAO,CAAC,aAAa;QACpC,OAAO,EAAE,OAAO,CAAC,OAAO,KAAK,IAAI;QACjC,2EAA2E;QAC3E,YAAY;QACZ,MAAM,EAAE,OAAO,CAAC,MAAM,IAAI,wBAAwB,CAAC,OAAO,CAAC,MAAM,CAAC;QAClE,UAAU,EAAE,CAAC,QAAQ,EAAE,EAAE,CACxB,QAAQ,CAAC,KAAK,CAAC,iBAAiB,CAAC,QAAQ,CAAC,CAA2B;KACtE,CAAC;AACH,CAAC"}

package/dist/run-bench.d.ts

@@ -0,0 +1,61 @@
+import type { MeasurePlugin, ReporterPlugin } from "@ac-bench/core/plugin";
+import type { Terminal } from "@ac-kit/app-terminal";
+import { MeasurementPlan } from "./measurement-plan.js";
+/**
+ * Everything a run needs, already resolved.
+ *
+ * Nothing here is an intent: naming one (`--mode rigorous`, a reporter id, a
+ * glob) and turning it into these values is configuration, and belongs to
+ * whoever parses it.
+ */
+export type BenchRunOptions = {
+    /** Bench files to run, already discovered. */
+    readonly files: readonly string[];
+    /** Registered for the measures `files` declare conditions for. */
+    readonly measures: readonly MeasurePlugin[];
+    /** Every reporter the run reports to; each sink is closed when it ends. */
+    readonly reporters: readonly ReporterPlugin[];
+    /** Base name for output files, for a reporter given no explicit one. */
+    readonly output: string;
+    /** How many contexts each condition is measured in. */
+    readonly plan: MeasurementPlan;
+    /** Seeds the replicate and case orderings. */
+    readonly orderSeed: number;
+    readonly signal: AbortSignal;
+    /** Case-insensitive substring patterns, matched on a case or condition title. */
+    readonly filter?: readonly string[];
+    /** Print each file's condition tree instead of measuring anything. */
+    readonly list?: boolean;
+    /** Imported by every child before the bench file, in order. */
+    readonly setupFiles?: readonly string[];
+    /** Attach each case's raw samples, which are copied across the boundary. */
+    readonly emitSamples?: boolean;
+    /**
+     * Report every child's output as it happens. Off, a child's output reaches
+     * the reporters only for a scope that ended badly.
+     */
+    readonly verbose?: boolean;
+    readonly heartbeatTimeoutMs?: number;
+    /** Wall-clock cap on one fork unit. `0` disables it. */
+    readonly conditionTimeoutMs?: number;
+    /** Wall-clock cap on the whole run, cooldown included. `0` disables it. */
+    readonly maxTotalTimeMs?: number;
+    /** Defaults to `process.stdout`; an override exists for tests. */
+    readonly stdout?: WritableStream<string>;
+    /** Defaults to whatever `process.stdout` reports. */
+    readonly terminal?: Terminal;
+};
+/**
+ * Discovers every bench file's condition tree in a child of its own, then runs
+ * each fork unit in a child of its own, closing every sink once the last one
+ * finishes.
+ *
+ * When `signal` aborts, the in-flight child is terminated, every condition not
+ * yet started is skipped, and the sinks are still closed.
+ *
+ * A file that fails to load is reported to `stderr` as a `load-error` and
+ * skipped — the run continues with the next file rather than crashing over one
+ * broken bench file.
+ */
+export declare function runBench(options: BenchRunOptions): Promise<void>;
+//# sourceMappingURL=run-bench.d.ts.map

package/dist/run-bench.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-bench.d.ts","sourceRoot":"","sources":["../src/run-bench.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAI3E,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAgBrD,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAUxD;;;;;;GAMG;AACH,MAAM,MAAM,eAAe,GAAG;IAC7B,8CAA8C;IAC9C,QAAQ,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,CAAC;IAClC,kEAAkE;IAClE,QAAQ,CAAC,QAAQ,EAAE,SAAS,aAAa,EAAE,CAAC;IAC5C,2EAA2E;IAC3E,QAAQ,CAAC,SAAS,EAAE,SAAS,cAAc,EAAE,CAAC;IAC9C,wEAAwE;IACxE,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,uDAAuD;IACvD,QAAQ,CAAC,IAAI,EAAE,eAAe,CAAC;IAC/B,8CAA8C;IAC9C,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC;IAC7B,iFAAiF;IACjF,QAAQ,CAAC,MAAM,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACpC,sEAAsE;IACtE,QAAQ,CAAC,IAAI,CAAC,EAAE,OAAO,CAAC;IACxB,+DAA+D;IAC/D,QAAQ,CAAC,UAAU,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACxC,4EAA4E;IAC5E,QAAQ,CAAC,WAAW,CAAC,EAAE,OAAO,CAAC;IAC/B;;;OAGG;IACH,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC;IAC3B,QAAQ,CAAC,kBAAkB,CAAC,EAAE,MAAM,CAAC;IACrC,wDAAwD;IACxD,QAAQ,CAAC,kBAAkB,CAAC,EAAE,MAAM,CAAC;IACrC,2EAA2E;IAC3E,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAC;IACjC,kEAAkE;IAClE,QAAQ,CAAC,MAAM,CAAC,EAAE,cAAc,CAAC,MAAM,CAAC,CAAC;IACzC,qDAAqD;IACrD,QAAQ,CAAC,QAAQ,CAAC,EAAE,QAAQ,CAAC;CAC7B,CAAC;AAEF;;;;;;;;;;;GAWG;AACH,wBAAsB,QAAQ,CAAC,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC,CAyHtE"}

package/dist/run-bench.js

@@ -0,0 +1,151 @@
+import { randomUUID } from "node:crypto";
+import { MeasureRegistry } from "@ac-bench/core/plugin";
+import { createFanOutSink, TailWindowProxy } from "@ac-kit/app-report";
+import { formatError } from "@ac-kit/core";
+import { captureEnvironmentBaseline, CooldownGate } from "./cooldown.js";
+import { EnvironmentMonitor, nodeEnvironmentProbe, } from "./environment-monitor.js";
+import { discoverConditionsInFile } from "./fork-runner.js";
+import { defaultArtifactCacheRoot, runFileIsolated, toForkOptions, } from "./isolated-runner.js";
+import { createMeasureDiagnosticProxy } from "./measure-diagnostic-proxy.js";
+import { createReporterContext } from "./reporter-context.js";
+/** Settle window before the first measurement, when cooling is on. */
+const BASELINE_WINDOW_MS = 3000;
+/** Per gate, and across the whole run. Exhausting either proceeds anyway. */
+const MAX_COOLDOWN_MS = 30000;
+const TOTAL_COOLDOWN_BUDGET_MS = 300000;
+/**
+ * Discovers every bench file's condition tree in a child of its own, then runs
+ * each fork unit in a child of its own, closing every sink once the last one
+ * finishes.
+ *
+ * When `signal` aborts, the in-flight child is terminated, every condition not
+ * yet started is skipped, and the sinks are still closed.
+ *
+ * A file that fails to load is reported to `stderr` as a `load-error` and
+ * skipped — the run continues with the next file rather than crashing over one
+ * broken bench file.
+ */
+export async function runBench(options) {
+    const registry = new MeasureRegistry();
+    for (const plugin of options.measures) {
+        registry.register(plugin);
+    }
+    const reporterContext = createReporterContext({
+        registry,
+        defaultOutput: options.output,
+        ...(options.verbose ? { verbose: true } : {}),
+        ...(options.stdout ? { stdout: options.stdout } : {}),
+        ...(options.terminal ? { terminal: options.terminal } : {}),
+    });
+    const reported = createFanOutSink(options.reporters.map((reporter) => reporter.createSink(reporterContext)));
+    const sink = createMeasureDiagnosticProxy(
+    // A healthy child's chatter is noise; the same chatter from a child that
+    // died is the only account of what it was doing. Only `output` is held
+    // back — every other kind is the report itself.
+    options.verbose
+        ? reported
+        : new TailWindowProxy(reported, {
+            alwaysForwardKinds: [
+                "scope-start",
+                "scope-attributes",
+                "scope-progress",
+                "scope-heartbeat",
+                "scope-end",
+                "diagnostic",
+                "attachment",
+                "data",
+            ],
+        }), registry);
+    // One measuring child exists at a time, so one slot is enough to point the
+    // probe at whichever one is currently running.
+    const measuringChild = { pid: undefined };
+    const probe = nodeEnvironmentProbe({ pidOf: () => measuringChild.pid });
+    const maxTotalTimeMs = options.maxTotalTimeMs ?? 0;
+    const { plan } = options;
+    // One signal for both reasons, so every existing abort check honours the
+    // budget too; the two are told apart afterwards for the exit code.
+    const budget = maxTotalTimeMs > 0 ? AbortSignal.timeout(maxTotalTimeMs) : null;
+    const runSignal = budget === null
+        ? options.signal
+        : AbortSignal.any([options.signal, budget]);
+    const runOptions = {
+        sink,
+        registry,
+        signal: runSignal,
+        runId: randomUUID(),
+        artifactCacheRoot: defaultArtifactCacheRoot(),
+        monitor: new EnvironmentMonitor(probe),
+        plan,
+        orderSeed: options.orderSeed,
+        retryOnInstability: plan.retryOnInstability,
+        onChildPid: (pid) => {
+            measuringChild.pid = pid;
+        },
+        ...(options.filter ? { filter: options.filter } : {}),
+        ...(options.emitSamples ? { emitSamples: true } : {}),
+        ...(options.setupFiles ? { setupFiles: options.setupFiles } : {}),
+        ...(options.heartbeatTimeoutMs !== undefined
+            ? { heartbeatTimeoutMs: options.heartbeatTimeoutMs }
+            : {}),
+        ...(options.conditionTimeoutMs !== undefined
+            ? { conditionTimeoutMs: options.conditionTimeoutMs }
+            : {}),
+        ...(plan.cooldown
+            ? {
+                cooldown: new CooldownGate(probe, await captureEnvironmentBaseline(probe, BASELINE_WINDOW_MS, 500, runSignal), {
+                    maxCooldownMs: MAX_COOLDOWN_MS,
+                    totalBudgetMs: TOTAL_COOLDOWN_BUDGET_MS,
+                }),
+            }
+            : {}),
+    };
+    for (const file of options.files) {
+        if (runSignal.aborted) {
+            break;
+        }
+        if (options.list === true) {
+            await listFile_(file, runOptions);
+            continue;
+        }
+        await runFileIsolated(file, runOptions);
+    }
+    if (budget?.aborted === true && !options.signal.aborted) {
+        await sink.write({
+            kind: "diagnostic",
+            timestamp: Date.now(),
+            scopeId: null,
+            severity: "warning",
+            code: "max-total-time-exhausted",
+            message: `the run was stopped after its ${maxTotalTimeMs}ms budget; some conditions were never measured`,
+        });
+    }
+    await sink.close();
+}
+/** Prints a discovered condition tree in declaration order, running nothing. */
+function listCondition_(condition, registry, depth) {
+    const indent = "  ".repeat(depth);
+    const { label } = registry.resolve(condition.measure);
+    process.stdout.write(`${indent}${condition.title} (${label})\n`);
+    for (const entry of condition.entries) {
+        if (entry.kind === "case") {
+            process.stdout.write(`${indent}  ${entry.title}\n`);
+        }
+        else {
+            listCondition_(entry.condition, registry, depth + 1);
+        }
+    }
+}
+async function listFile_(file, options) {
+    let conditions;
+    try {
+        conditions = await discoverConditionsInFile(file, toForkOptions(options));
+    }
+    catch (error) {
+        process.stderr.write(`measure: failed to load ${file}: ${formatError(error)}\n`);
+        return;
+    }
+    for (const condition of conditions) {
+        listCondition_(condition, options.registry, 0);
+    }
+}
+//# sourceMappingURL=run-bench.js.map

package/dist/run-bench.js.map

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

package/package.json

@@ -0,0 +1,79 @@
+{
+  "name": "@ac-bench/lib",
+  "version": "0.1.0",
+  "description": "Programmatic benchmark API for @ac-bench: fork orchestration and protocol, the environment monitor and cooldown gate, and the escalation decision.",
+  "keywords": [
+    "benchmark",
+    "fork",
+    "measurement",
+    "performance"
+  ],
+  "homepage": "https://github.com/anthochamp/node-essentials/tree/main/bench/lib#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/lib"
+  },
+  "files": [
+    "dist"
+  ],
+  "type": "module",
+  "sideEffects": false,
+  "main": "./dist/index.js",
+  "exports": {
+    ".": "./dist/index.js",
+    "./child": "./dist/child/main.js"
+  },
+  "publishConfig": {
+    "main": "./dist/index.js",
+    "exports": {
+      ".": "./dist/index.js",
+      "./child": "./dist/child/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-kit/algo": "^0.1.0",
+    "@ac-kit/app-report": "^0.1.0",
+    "@ac-kit/app-system": "^0.1.0",
+    "@ac-kit/app-terminal": "^0.1.0",
+    "@ac-kit/core": "^0.1.0",
+    "@ac-kit/format-ansi": "^0.1.0",
+    "@ac-kit/format-monospace": "^0.1.0",
+    "@ac-kit/math-random": "^0.1.0",
+    "@ac-kit/math-stats": "^0.1.0",
+    "@ac-kit/model-dataset": "^0.1.0",
+    "@ac-kit/node": "^0.1.0",
+    "tsx": "4.23.12"
+  },
+  "devDependencies": {
+    "@ac-kit/async": "0.1.0",
+    "@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",
+    "typedoc": "0.28.20",
+    "typescript": "@typescript/typescript6@6.0.2",
+    "vite": "8.3.0",
+    "vitest": "5.0.0"
+  },
+  "engines": {
+    "node": ">=24"
+  }
+}