@ac-bench/lib 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,41 @@
+# @ac-bench/lib
+
+The programmatic benchmark API: child-process fork orchestration and protocol,
+the environment monitor and cooldown gate, and the escalation decision.
+
+`runBench` is the way in. It takes fully-resolved parameters only — the files to
+run, the measure plugins to register, the reporter plugins to report through, a
+`MeasurementPlan`, a seed, a signal. No config file, no CLI flags, no profile
+name, no string parsing, and no mixed list something downstream has to sort out.
+
+```ts
+import { runBench } from "@ac-bench/lib";
+import { walkPaths } from "@ac-kit/node";
+import durationPlugin from "@ac-bench/measure-duration/plugin";
+import tableReporter from "@ac-bench/reporter-table";
+
+await runBench({
+  files: await Array.fromAsync(
+    walkPaths({ include: "**/*.bench.ts", exclude: "**/node_modules" }),
+    (walked) => walked.path,
+  ),
+  measures: [durationPlugin],
+  reporters: [tableReporter],
+  output: "bench-results",
+  plan: {
+    replicates: 2,
+    maxReplicates: 5,
+    isolatedRuns: 0,
+    rounds: 16,
+    cooldown: false,
+    retryOnInstability: 0,
+  },
+  orderSeed: 1,
+  signal: AbortSignal.timeout(600_000),
+});
+```
+
+Turning an intent into those parameters — what `--mode rigorous` stands for,
+which reporters a config file selected, where output files go — is
+`@ac-bench/cli`'s job, not this package's. A caller that wants to run benchmarks
+from its own code depends on this package directly and decides those itself.

package/dist/child/channel.d.ts

@@ -0,0 +1,28 @@
+import { ChildMessage, DiscoveredCondition } from "@ac-bench/core/runner";
+import { ReportScopeStatus } from "@ac-kit/app-report";
+export type ChildMessagePoster = (message: ChildMessage) => Promise<void> | void;
+/**
+ * The child's end of the protocol: assigns the sequence numbers the parent
+ * asserts on, and stops sending once it has run too far ahead of the last
+ * acknowledgement.
+ */
+export declare class ChildChannel {
+    private readonly post;
+    private readonly ackWindow;
+    private seq;
+    private lastAck;
+    private credit;
+    private released;
+    constructor(post: ChildMessagePoster, ackWindow?: number);
+    acknowledge(seq: number): void;
+    /** Unblocks anything waiting on credit, so an abort cannot hang the child. */
+    release(): void;
+    hello(): Promise<void> | void;
+    conditions(conditions: DiscoveredCondition[]): Promise<void> | void;
+    event(event: unknown): Promise<void>;
+    dropped(count: number, kinds: string[]): Promise<void> | void;
+    done(status: ReportScopeStatus): Promise<void> | void;
+    fatal(error: unknown): Promise<void> | void;
+    private waitForCredit;
+}
+//# sourceMappingURL=channel.d.ts.map

package/dist/child/channel.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"channel.d.ts","sourceRoot":"","sources":["../../src/child/channel.ts"],"names":[],"mappings":"AAAA,OAAO,EAEN,YAAY,EACZ,mBAAmB,EACnB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAKvD,MAAM,MAAM,kBAAkB,GAAG,CAChC,OAAO,EAAE,YAAY,KACjB,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;AAE1B;;;;GAIG;AACH,qBAAa,YAAY;IAOvB,OAAO,CAAC,QAAQ,CAAC,IAAI;IACrB,OAAO,CAAC,QAAQ,CAAC,SAAS;IAP3B,OAAO,CAAC,GAAG,CAAK;IAChB,OAAO,CAAC,OAAO,CAAK;IACpB,OAAO,CAAC,MAAM,CAA2C;IACzD,OAAO,CAAC,QAAQ,CAAS;IAEzB,YACkB,IAAI,EAAE,kBAAkB,EACxB,SAAS,GAAE,MAAmB,EAC5C;IAEJ,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAO7B;IAED,8EAA8E;IAC9E,OAAO,IAAI,IAAI,CAId;IAED,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAM5B;IAED,UAAU,CAAC,UAAU,EAAE,mBAAmB,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAElE;IAEK,KAAK,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAKzC;IAED,OAAO,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAG5D;IAED,IAAI,CAAC,MAAM,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAGpD;IAED,KAAK,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAG1C;IAED,OAAO,CAAC,aAAa;CASrB"}

package/dist/child/channel.js

@@ -0,0 +1,68 @@
+import { BENCH_PROTOCOL_VERSION, } from "@ac-bench/core/runner";
+/** How far the child may run ahead of the parent's acknowledgements. */
+const ACK_WINDOW = 256;
+/**
+ * The child's end of the protocol: assigns the sequence numbers the parent
+ * asserts on, and stops sending once it has run too far ahead of the last
+ * acknowledgement.
+ */
+export class ChildChannel {
+    post;
+    ackWindow;
+    seq = 0;
+    lastAck = 0;
+    credit = null;
+    released = false;
+    constructor(post, ackWindow = ACK_WINDOW) {
+        this.post = post;
+        this.ackWindow = ackWindow;
+    }
+    acknowledge(seq) {
+        this.lastAck = Math.max(this.lastAck, seq);
+        if (this.credit !== null && this.seq - this.lastAck <= this.ackWindow) {
+            this.credit.resolve();
+            this.credit = null;
+        }
+    }
+    /** Unblocks anything waiting on credit, so an abort cannot hang the child. */
+    release() {
+        this.released = true;
+        this.credit?.resolve();
+        this.credit = null;
+    }
+    hello() {
+        return this.post({
+            t: "hello",
+            version: BENCH_PROTOCOL_VERSION,
+            pid: process.pid,
+        });
+    }
+    conditions(conditions) {
+        return this.post({ t: "conditions", conditions });
+    }
+    async event(event) {
+        await this.waitForCredit();
+        this.seq += 1;
+        await this.post({ t: "event", seq: this.seq, event });
+    }
+    dropped(count, kinds) {
+        this.seq += 1;
+        return this.post({ t: "dropped", seq: this.seq, count, kinds });
+    }
+    done(status) {
+        this.seq += 1;
+        return this.post({ t: "done", seq: this.seq, status });
+    }
+    fatal(error) {
+        this.seq += 1;
+        return this.post({ t: "fatal", seq: this.seq, error });
+    }
+    waitForCredit() {
+        if (this.released || this.seq - this.lastAck <= this.ackWindow) {
+            return Promise.resolve();
+        }
+        this.credit ??= Promise.withResolvers();
+        return this.credit.promise;
+    }
+}
+//# sourceMappingURL=channel.js.map

package/dist/child/channel.js.map

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

package/dist/child/event-sink.d.ts

@@ -0,0 +1,13 @@
+import { MeasureData } from "@ac-bench/core/runner";
+import { ISink } from "@ac-kit/app-report";
+import { ChildChannel } from "./channel.js";
+/**
+ * The child's sink chain: coalesce the only high-frequency events, then queue
+ * with backpressure, then serialize onto the IPC channel.
+ *
+ * Coalescing first is what makes `overflow: "block"` safe — blocking can then
+ * only ever be triggered by a result, which is rare and emitted outside the
+ * timed region.
+ */
+export declare function createChildEventSink(channel: ChildChannel): ISink<MeasureData>;
+//# sourceMappingURL=event-sink.d.ts.map

package/dist/child/event-sink.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"event-sink.d.ts","sourceRoot":"","sources":["../../src/child/event-sink.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AACpD,OAAO,EAGN,KAAK,EAGL,MAAM,oBAAoB,CAAC;AAE5B,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAI5C;;;;;;;GAOG;AACH,wBAAgB,oBAAoB,CACnC,OAAO,EAAE,YAAY,GACnB,KAAK,CAAC,WAAW,CAAC,CAuBpB"}

package/dist/child/event-sink.js

@@ -0,0 +1,34 @@
+import { AsyncQueueSink, createCoalesceProxy, serializeReportEvent, } from "@ac-kit/app-report";
+const MAX_QUEUE = 1024;
+/**
+ * The child's sink chain: coalesce the only high-frequency events, then queue
+ * with backpressure, then serialize onto the IPC channel.
+ *
+ * Coalescing first is what makes `overflow: "block"` safe — blocking can then
+ * only ever be triggered by a result, which is rare and emitted outside the
+ * timed region.
+ */
+export function createChildEventSink(channel) {
+    const transport = {
+        write: (event) => channel.event(serializeReportEvent(event, { mode: "structured-clone" })),
+        flush: () => { },
+        close: () => { },
+    };
+    const queue = new AsyncQueueSink(transport, {
+        maxQueue: MAX_QUEUE,
+        overflow: "block",
+        onOverflow: (dropped) => {
+            void channel.dropped(dropped.length, dropped.map((event) => event.kind));
+        },
+        onSinkError: (error) => {
+            void channel.fatal(error);
+        },
+    });
+    return createCoalesceProxy(queue, { keyOf: coalesceKey_ });
+}
+function coalesceKey_(event) {
+    return event.kind === "scope-progress" || event.kind === "scope-heartbeat"
+        ? `${event.kind}:${event.scopeId}`
+        : null;
+}
+//# sourceMappingURL=event-sink.js.map

package/dist/child/event-sink.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"event-sink.js","sourceRoot":"","sources":["../../src/child/event-sink.ts"],"names":[],"mappings":"AACA,OAAO,EACN,cAAc,EACd,mBAAmB,EAGnB,oBAAoB,GACpB,MAAM,oBAAoB,CAAC;AAI5B,MAAM,SAAS,GAAG,IAAI,CAAC;AAEvB;;;;;;;GAOG;AACH,MAAM,UAAU,oBAAoB,CACnC,OAAqB;IAErB,MAAM,SAAS,GAAuB;QACrC,KAAK,EAAE,CAAC,KAAK,EAAE,EAAE,CAChB,OAAO,CAAC,KAAK,CAAC,oBAAoB,CAAC,KAAK,EAAE,EAAE,IAAI,EAAE,kBAAkB,EAAE,CAAC,CAAC;QACzE,KAAK,EAAE,GAAG,EAAE,GAAE,CAAC;QACf,KAAK,EAAE,GAAG,EAAE,GAAE,CAAC;KACf,CAAC;IAEF,MAAM,KAAK,GAAG,IAAI,cAAc,CAAC,SAAS,EAAE;QAC3C,QAAQ,EAAE,SAAS;QACnB,QAAQ,EAAE,OAAO;QACjB,UAAU,EAAE,CAAC,OAAO,EAAE,EAAE;YACvB,KAAK,OAAO,CAAC,OAAO,CACnB,OAAO,CAAC,MAAM,EACd,OAAO,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,CAClC,CAAC;QACH,CAAC;QACD,WAAW,EAAE,CAAC,KAAK,EAAE,EAAE;YACtB,KAAK,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;QAC3B,CAAC;KACD,CAAC,CAAC;IAEH,OAAO,mBAAmB,CAAC,KAAK,EAAE,EAAE,KAAK,EAAE,YAAY,EAAE,CAAC,CAAC;AAC5D,CAAC;AAED,SAAS,YAAY,CAAC,KAA+B;IACpD,OAAO,KAAK,CAAC,IAAI,KAAK,gBAAgB,IAAI,KAAK,CAAC,IAAI,KAAK,iBAAiB;QACzE,CAAC,CAAC,GAAG,KAAK,CAAC,IAAI,IAAI,KAAK,CAAC,OAAO,EAAE;QAClC,CAAC,CAAC,IAAI,CAAC;AACT,CAAC"}

package/dist/child/main.d.ts

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

package/dist/child/main.d.ts.map

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

package/dist/child/main.js

@@ -0,0 +1,157 @@
+/**
+ * Bench child entry point, forked as `@ac-bench/lib/child`.
+ *
+ * Imports `@ac-bench/core/runner` only — never `/plugin`: plugins are the
+ * reporting side's concern and must never be loaded into a measuring process.
+ */
+import { pathToFileURL } from "node:url";
+import { BENCH_PROTOCOL_VERSION, describeConditions, drainConditions, parseParentMessage, ProtocolVersionMismatchError, resolveForkUnit, runForkUnit, } from "@ac-bench/core/runner";
+import { ChildChannel } from "./channel.js";
+import { createChildEventSink } from "./event-sink.js";
+const send = process.send?.bind(process);
+if (send === undefined) {
+    throw new Error("@ac-bench/lib/child must be forked with an IPC channel");
+}
+const channel = new ChildChannel((message) => new Promise((resolve, reject) => {
+    send(message, (error) => {
+        if (error) {
+            reject(error);
+            return;
+        }
+        resolve();
+    });
+}));
+const controller = new AbortController();
+const commands = [];
+let draining = false;
+process.on("message", (raw) => {
+    let message;
+    try {
+        message = parseParentMessage(raw);
+    }
+    catch (error) {
+        void channel.fatal(error);
+        return;
+    }
+    switch (message.t) {
+        case "ack":
+            channel.acknowledge(message.seq);
+            return;
+        case "abort":
+            controller.abort(new Error(message.reason));
+            channel.release();
+            return;
+        default:
+            commands.push(message);
+            void drainCommands();
+    }
+});
+async function drainCommands() {
+    if (draining) {
+        return;
+    }
+    draining = true;
+    try {
+        for (let message = commands.shift(); message !== undefined; message = commands.shift()) {
+            await handleCommand(message);
+        }
+    }
+    finally {
+        draining = false;
+    }
+}
+async function handleCommand(message) {
+    switch (message.t) {
+        case "hello":
+            await handleHello(message);
+            return;
+        case "list":
+            await handleList(message.file);
+            return;
+        case "start":
+            await handleStart(message);
+            return;
+        default:
+            return;
+    }
+}
+async function handleHello(message) {
+    if (message.version !== BENCH_PROTOCOL_VERSION) {
+        await channel.fatal(new ProtocolVersionMismatchError(BENCH_PROTOCOL_VERSION, message.version));
+        finish(1);
+        return;
+    }
+    // The only channel a bench file loaded later can read these from.
+    process.env.AC_BENCH_RUN_ID = message.runId;
+    process.env.AC_BENCH_ARTIFACT_CACHE_ROOT = message.artifactCacheRoot;
+    for (const setupFile of message.setupFiles ?? []) {
+        try {
+            await import(pathToFileURL(setupFile).href);
+        }
+        catch (error) {
+            await channel.fatal(error);
+            finish(1);
+            return;
+        }
+    }
+    await channel.hello();
+}
+async function handleList(file) {
+    try {
+        await import(pathToFileURL(file).href);
+    }
+    catch (error) {
+        await channel.fatal(error);
+        finish(1);
+        return;
+    }
+    await channel.conditions(describeConditions(drainConditions()));
+    finish(0);
+}
+async function handleStart(message) {
+    try {
+        await import(pathToFileURL(message.file).href);
+    }
+    catch (error) {
+        await channel.fatal(error);
+        finish(1);
+        return;
+    }
+    const sink = createChildEventSink(channel);
+    try {
+        const unit = resolveForkUnit(drainConditions(), message.conditionPath, message.conditionTitles);
+        const outcome = await runForkUnit(unit, controller.signal, {
+            sink,
+            file: message.file,
+            parentScopeId: message.parentScopeId,
+            orderSeed: message.orderSeed,
+            arm: message.arm,
+            replicate: message.replicate,
+            rounds: message.rounds,
+            ...(message.caseFilter ? { caseFilter: message.caseFilter } : {}),
+            // The measure has no other channel for a run-level switch.
+            measureOptions: {
+                ...message.measureOptions,
+                emitSamples: message.emitSamples,
+            },
+        });
+        await sink.close();
+        await channel.done(outcome.status);
+        finish(0);
+    }
+    catch (error) {
+        await sink.close();
+        await channel.fatal(error);
+        finish(1);
+    }
+}
+/**
+ * Closes the channel and lets the process end on its own, so a benchmark that
+ * leaked a handle shows up as the parent's heartbeat timeout instead of being
+ * hidden by a hard exit.
+ */
+function finish(code) {
+    process.exitCode = code;
+    process.disconnect?.();
+}
+//# sourceMappingURL=main.js.map

package/dist/child/main.js.map

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

package/dist/cooldown.d.ts

@@ -0,0 +1,51 @@
+import { ReportDiagnostic } from "@ac-kit/app-report";
+import { EnvironmentProbe } from "./environment-monitor.js";
+/** What the machine looked like before any measurement ran. */
+export type EnvironmentBaseline = {
+    loadRatio: number;
+    frequencyRatio: number | null;
+    temperatureC: number | null;
+};
+export type CooldownOptions = {
+    /** Per gate. `0` disables cooling entirely. */
+    readonly maxCooldownMs: number;
+    /** Across the whole run. Exhausting it proceeds rather than hangs. */
+    readonly totalBudgetMs: number;
+    /** Degrees above baseline that still count as settled. Default 2. */
+    readonly temperatureToleranceC?: number;
+    /**
+     * Fraction of the baseline frequency that still counts as settled. Default
+     * 0.98.
+     */
+    readonly frequencyTolerance?: number;
+    /** Default 500. */
+    readonly intervalMs?: number;
+};
+export type CooldownResult = {
+    /** Time spent waiting. Not measurement time, so it is reported separately. */
+    cooldownMs: number;
+    diagnostics: ReportDiagnostic[];
+};
+/** Samples over `windowMs` are the reference every later gate compares against. */
+export declare function captureEnvironmentBaseline(probe: EnvironmentProbe, windowMs: number, intervalMs?: number, signal?: AbortSignal): Promise<EnvironmentBaseline>;
+/**
+ * Waits between fork units until the machine stops recovering, never inside a
+ * timed case.
+ *
+ * Waiting is preventive where retrying is corrective: it avoids paying for a
+ * bad measurement rather than noticing one afterwards. The stopping rule is the
+ * _derivative_, not the baseline — ambient conditions may simply have changed,
+ * so waiting for the exact starting temperature would never terminate.
+ */
+export declare class CooldownGate {
+    private readonly probe;
+    private readonly baseline;
+    private readonly options;
+    private spentMs;
+    constructor(probe: EnvironmentProbe, baseline: EnvironmentBaseline, options: CooldownOptions);
+    /** Time already spent cooling across every gate so far. */
+    get totalCooldownMs(): number;
+    settle(signal?: AbortSignal): Promise<CooldownResult>;
+    private isSettled_;
+}
+//# sourceMappingURL=cooldown.d.ts.map

package/dist/cooldown.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cooldown.d.ts","sourceRoot":"","sources":["../src/cooldown.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAGtD,OAAO,EAAE,gBAAgB,EAAqB,MAAM,0BAA0B,CAAC;AAE/E,+DAA+D;AAC/D,MAAM,MAAM,mBAAmB,GAAG;IACjC,SAAS,EAAE,MAAM,CAAC;IAClB,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;CAC5B,CAAC;AAEF,MAAM,MAAM,eAAe,GAAG;IAC7B,+CAA+C;IAC/C,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,sEAAsE;IACtE,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,qEAAqE;IACrE,QAAQ,CAAC,qBAAqB,CAAC,EAAE,MAAM,CAAC;IACxC;;;OAGG;IACH,QAAQ,CAAC,kBAAkB,CAAC,EAAE,MAAM,CAAC;IACrC,mBAAmB;IACnB,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;CAC7B,CAAC;AAEF,MAAM,MAAM,cAAc,GAAG;IAC5B,8EAA8E;IAC9E,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,gBAAgB,EAAE,CAAC;CAChC,CAAC;AAEF,mFAAmF;AACnF,wBAAsB,0BAA0B,CAC/C,KAAK,EAAE,gBAAgB,EACvB,QAAQ,EAAE,MAAM,EAChB,UAAU,SAAM,EAChB,MAAM,CAAC,EAAE,WAAW,GAClB,OAAO,CAAC,mBAAmB,CAAC,CA2B9B;AAED;;;;;;;;GAQG;AACH,qBAAa,YAAY;IAIvB,OAAO,CAAC,QAAQ,CAAC,KAAK;IACtB,OAAO,CAAC,QAAQ,CAAC,QAAQ;IACzB,OAAO,CAAC,QAAQ,CAAC,OAAO;IALzB,OAAO,CAAC,OAAO,CAAK;IAEpB,YACkB,KAAK,EAAE,gBAAgB,EACvB,QAAQ,EAAE,mBAAmB,EAC7B,OAAO,EAAE,eAAe,EACtC;IAEJ,2DAA2D;IAC3D,IAAI,eAAe,IAAI,MAAM,CAE5B;IAEK,MAAM,CAAC,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,cAAc,CAAC,CA0D1D;IAED,OAAO,CAAC,UAAU;CAgBlB"}

package/dist/cooldown.js

@@ -0,0 +1,118 @@
+import { setTimeout as delay } from "node:timers/promises";
+import { mannKendallTrend } from "@ac-kit/math-stats";
+/** Samples over `windowMs` are the reference every later gate compares against. */
+export async function captureEnvironmentBaseline(probe, windowMs, intervalMs = 500, signal) {
+    const samples = [];
+    const until = Date.now() + windowMs;
+    while (Date.now() < until && signal?.aborted !== true) {
+        samples.push(await probe());
+        try {
+            await delay(intervalMs, undefined, signal ? { signal } : undefined);
+        }
+        catch {
+            break;
+        }
+    }
+    return {
+        loadRatio: median_(samples.map((sample) => sample.loadRatio)) ?? 0,
+        frequencyRatio: median_(samples
+            .map((sample) => sample.frequencyRatio)
+            .filter((value) => value !== null)),
+        temperatureC: median_(samples
+            .map((sample) => sample.temperatureC)
+            .filter((value) => value !== null)),
+    };
+}
+/**
+ * Waits between fork units until the machine stops recovering, never inside a
+ * timed case.
+ *
+ * Waiting is preventive where retrying is corrective: it avoids paying for a
+ * bad measurement rather than noticing one afterwards. The stopping rule is the
+ * _derivative_, not the baseline — ambient conditions may simply have changed,
+ * so waiting for the exact starting temperature would never terminate.
+ */
+export class CooldownGate {
+    probe;
+    baseline;
+    options;
+    spentMs = 0;
+    constructor(probe, baseline, options) {
+        this.probe = probe;
+        this.baseline = baseline;
+        this.options = options;
+    }
+    /** Time already spent cooling across every gate so far. */
+    get totalCooldownMs() {
+        return this.spentMs;
+    }
+    async settle(signal) {
+        const budget = Math.min(this.options.maxCooldownMs, Math.max(0, this.options.totalBudgetMs - this.spentMs));
+        if (budget === 0) {
+            return { cooldownMs: 0, diagnostics: [] };
+        }
+        const intervalMs = this.options.intervalMs ?? 500;
+        const startedAt = Date.now();
+        const recent = [];
+        let settled = false;
+        while (Date.now() - startedAt < budget && signal?.aborted !== true) {
+            const sample = await this.probe();
+            if (this.isSettled_(sample)) {
+                settled = true;
+                break;
+            }
+            recent.push(sample.temperatureC ?? sample.loadRatio);
+            // Stop once the recovery has flattened: the trend, not the level.
+            if (recent.length >= 5) {
+                const { normalised } = mannKendallTrend(recent.slice(-5));
+                if (normalised > -1.96) {
+                    settled = true;
+                    break;
+                }
+            }
+            try {
+                await delay(intervalMs, undefined, signal ? { signal } : undefined);
+            }
+            catch {
+                break;
+            }
+        }
+        const cooldownMs = Date.now() - startedAt;
+        this.spentMs += cooldownMs;
+        return {
+            cooldownMs,
+            diagnostics: settled
+                ? []
+                : [
+                    {
+                        severity: "info",
+                        code: "cooldown-budget-exhausted",
+                        message: `waited ${cooldownMs}ms without the machine settling; measuring anyway`,
+                        attributes: { cooldownMs },
+                    },
+                ],
+        };
+    }
+    isSettled_(sample) {
+        const temperatureTolerance = this.options.temperatureToleranceC ?? 2;
+        const frequencyTolerance = this.options.frequencyTolerance ?? 0.98;
+        const hot = this.baseline.temperatureC !== null &&
+            sample.temperatureC !== null &&
+            sample.temperatureC > this.baseline.temperatureC + temperatureTolerance;
+        const throttled = this.baseline.frequencyRatio !== null &&
+            sample.frequencyRatio !== null &&
+            sample.frequencyRatio < this.baseline.frequencyRatio * frequencyTolerance;
+        return !hot && !throttled;
+    }
+}
+function median_(values) {
+    if (values.length === 0) {
+        return null;
+    }
+    const sorted = [...values].toSorted((a, b) => a - b);
+    const middle = Math.floor(sorted.length / 2);
+    return sorted.length % 2 === 0
+        ? ((sorted[middle - 1] ?? 0) + (sorted[middle] ?? 0)) / 2
+        : (sorted[middle] ?? 0);
+}
+//# sourceMappingURL=cooldown.js.map

package/dist/cooldown.js.map

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

package/dist/current-environment.d.ts

@@ -0,0 +1,8 @@
+/** Environment captured at run time, carried into live tables and exports. */
+export declare function currentEnvironment(): {
+    runtime: string;
+    platform: string;
+    arch: string;
+    timestamp: string;
+};
+//# sourceMappingURL=current-environment.d.ts.map

package/dist/current-environment.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"current-environment.d.ts","sourceRoot":"","sources":["../src/current-environment.ts"],"names":[],"mappings":"AAAA,8EAA8E;AAC9E,wBAAgB,kBAAkB,IAAI;IACrC,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;CAClB,CAOA"}

package/dist/current-environment.js

@@ -0,0 +1,10 @@
+/** Environment captured at run time, carried into live tables and exports. */
+export function currentEnvironment() {
+    return {
+        runtime: `node ${process.version}`,
+        platform: process.platform,
+        arch: process.arch,
+        timestamp: new Date().toISOString(),
+    };
+}
+//# sourceMappingURL=current-environment.js.map

package/dist/current-environment.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"current-environment.js","sourceRoot":"","sources":["../src/current-environment.ts"],"names":[],"mappings":"AAAA,8EAA8E;AAC9E,MAAM,UAAU,kBAAkB;IAMjC,OAAO;QACN,OAAO,EAAE,QAAQ,OAAO,CAAC,OAAO,EAAE;QAClC,QAAQ,EAAE,OAAO,CAAC,QAAQ;QAC1B,IAAI,EAAE,OAAO,CAAC,IAAI;QAClB,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;KACnC,CAAC;AACH,CAAC"}