@ethlete/cli 3.0.0-next.26 → 3.0.0-next.28

package/src/lib/design/resident/resident-process.js

@@ -0,0 +1,189 @@
+"use strict";
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.serveResident = exports.createWarmRuns = void 0;
+const crypto_1 = require("crypto");
+const check_1 = require("../check");
+const design_config_1 = require("../design-config");
+const stamp_1 = require("../stamp");
+const serve_1 = require("../serve");
+const thumb_1 = require("../thumb");
+const sketch_command_1 = require("../sketch-command");
+const compare_command_1 = require("../system/compare-command");
+const harness_server_1 = require("../system/harness-server");
+const harness_watch_1 = require("../system/harness-watch");
+const stale_design_mocks_1 = require("../system/stale-design-mocks");
+const stale_dist_1 = require("../system/stale-dist");
+const run_abort_1 = require("../run-abort");
+const run_yield_1 = require("../run-yield");
+const timings_1 = require("../timings");
+const client_1 = require("./client");
+const discovery_1 = require("./discovery");
+const server_1 = require("./server");
+/**
+ * Runs `compare`, `check --product`/`--part`, `sketch check` and `sketch ready` with a design server, Chromium and a watch-built harness app that stay up
+ * between requests. Each request reads the lib build under the lib-build lock only while it runs, a changed lib build or
+ * design config restarts the design server and Chromium before it draws, and every request draws the design files as
+ * they are when it starts.
+ */
+const createWarmRuns = (options) => {
+    const { target } = options;
+    let stamp = null;
+    let server = null;
+    let queue = null;
+    let active = 0;
+    const harness = (0, harness_watch_1.createHarnessWatch)({ target });
+    const closeDraw = () => __awaiter(void 0, void 0, void 0, function* () {
+        var _a;
+        const [closingServer, closingQueue] = [server, queue];
+        server = null;
+        queue = null;
+        yield (closingQueue === null || closingQueue === void 0 ? void 0 : closingQueue.close());
+        yield ((_a = (yield (closingServer === null || closingServer === void 0 ? void 0 : closingServer.catch(() => null)))) === null || _a === void 0 ? void 0 : _a.close());
+    });
+    const startServer = (config) => __awaiter(void 0, void 0, void 0, function* () {
+        const started = yield (0, serve_1.createDesignServer)({ target, config, listen: true, port: 0 });
+        try {
+            yield started.listen();
+        }
+        catch (error) {
+            yield started.close();
+            throw error;
+        }
+        return started;
+    });
+    const warm = {
+        server: (config) => {
+            server !== null && server !== void 0 ? server : (server = startServer(config).catch((error) => {
+                server = null;
+                throw error;
+            }));
+            return server;
+        },
+        queue: () => (queue !== null && queue !== void 0 ? queue : (queue = (0, thumb_1.createDrawQueue)({ target }))),
+    };
+    const start = (_a) => __awaiter(void 0, [_a], void 0, function* ({ product }) {
+        const served = yield (0, run_abort_1.unlessAborted)((0, run_abort_1.runSignal)(), harness.current(product));
+        if (served === null)
+            return (0, harness_server_1.startHarnessServer)({ target, product });
+        return typeof served === 'string' ? served : { url: served.url, root: served.root, stop: () => __awaiter(void 0, void 0, void 0, function* () { return undefined; }) };
+    });
+    const stampOf = (config) => `${(0, stale_dist_1.libBuildStampOf)({ target, config })}#${JSON.stringify(config)}`;
+    const refresh = (config) => __awaiter(void 0, void 0, void 0, function* () {
+        var _a;
+        const next = stampOf(config);
+        if (stamp !== null && stamp !== next && (server || queue)) {
+            console.error('the lib build or the design config changed - restarting the warm design server and Chromium');
+            yield closeDraw();
+        }
+        stamp = next;
+        (_a = (yield (server === null || server === void 0 ? void 0 : server.catch(() => null)))) === null || _a === void 0 ? void 0 : _a.forgetDrawn();
+    });
+    const runIn = (_a) => __awaiter(void 0, [_a], void 0, function* ({ argv, invocation }) {
+        var _b;
+        if (!(0, client_1.runsInResident)(argv)) {
+            console.error(`the resident design process runs compare, check --product/--part, sketch check and sketch ready only, not ${argv.join(' ')}`);
+            return 2;
+        }
+        if ((0, stale_design_mocks_1.guardsDesignMocks)(argv) && !(0, stale_design_mocks_1.designMocksFresh)({ target }))
+            return 1;
+        const config = (0, design_config_1.readConfig)(target);
+        const inside = active > 0;
+        const read = inside ? { ok: true, release: () => undefined } : yield (0, stale_dist_1.readFreshDist)({ target, config });
+        if (!read.ok)
+            return 1;
+        active++;
+        try {
+            if (inside)
+                (_b = (yield (server === null || server === void 0 ? void 0 : server.catch(() => null)))) === null || _b === void 0 ? void 0 : _b.forgetDrawn();
+            else
+                yield refresh(config);
+            const rest = argv.slice(1);
+            if (argv[0] === 'sketch')
+                return yield (0, sketch_command_1.designSketch)({ target, argv: rest, invocation, warm });
+            if (argv[0] === 'check')
+                return yield (0, check_1.checkDesign)({ target, argv: rest, invocation, warm });
+            return yield (0, compare_command_1.designCompare)(Object.assign({ target, argv: rest, invocation,
+                start }, (rest.includes('--live') ? {} : { shoot: (0, compare_command_1.shootStatesWith)(warm) })));
+        }
+        finally {
+            active--;
+            read.release();
+        }
+    });
+    const jumps = ({ argv }) => {
+        if (argv[0] !== 'compare' || active === 0)
+            return false;
+        const config = (0, design_config_1.readConfig)(target);
+        return stampOf(config) === stamp && (0, stale_dist_1.staleLibsOf)({ target, config }).length === 0;
+    };
+    const run = ({ argv, invocation, waitedMs, signal, yieldTurn }) => (0, timings_1.recordRun)({ file: (0, timings_1.timingsFileOf)(target), argv, resident: true }, () => {
+        if (waitedMs !== undefined)
+            (0, timings_1.recordPhase)('resident-queue-wait', waitedMs);
+        return (0, run_abort_1.withRunSignal)(signal, () => (0, run_yield_1.withRunYield)(yieldTurn, () => runIn({ argv, invocation }))).then((code) => (signal === null || signal === void 0 ? void 0 : signal.aborted) ? server_1.ABORTED_EXIT : code);
+    });
+    const warmUp = () => __awaiter(void 0, void 0, void 0, function* () {
+        const config = (0, design_config_1.readConfig)(target);
+        if (!config)
+            return;
+        yield refresh(config);
+        yield warm.server(config);
+        yield warm.queue().run(() => __awaiter(void 0, void 0, void 0, function* () { return undefined; }));
+    });
+    const close = () => __awaiter(void 0, void 0, void 0, function* () {
+        yield closeDraw();
+        yield harness.stop();
+    });
+    return { run, jumps, warmUp, close };
+};
+exports.createWarmRuns = createWarmRuns;
+/** `et design __resident`: the resident design process of the checkout, until it idles out or is stopped. */
+const serveResident = (options) => __awaiter(void 0, void 0, void 0, function* () {
+    const { target } = options;
+    const build = (0, stamp_1.buildStampOf)().build;
+    const token = (0, crypto_1.randomUUID)();
+    const runs = (0, exports.createWarmRuns)({ target });
+    let exiting = false;
+    let close = () => __awaiter(void 0, void 0, void 0, function* () { return undefined; });
+    const exit = (reason) => __awaiter(void 0, void 0, void 0, function* () {
+        if (exiting)
+            return;
+        exiting = true;
+        console.error(`resident design process exits: ${reason}`);
+        (0, discovery_1.removeDiscovery)(target, process.pid);
+        yield close();
+        yield runs.close();
+        process.exit(0);
+    });
+    process.once('SIGTERM', () => void exit('SIGTERM'));
+    process.once('SIGINT', () => void exit('SIGINT'));
+    const server = yield (0, server_1.startResidentServer)({
+        token,
+        identity: { pid: process.pid, build, checkout: target },
+        run: runs.run,
+        jumps: runs.jumps,
+        onExit: (reason) => void exit(reason === 'idle' ? 'idle for 30 min' : 'stopped'),
+    });
+    close = server.close;
+    yield runs.warmUp().catch((error) => console.error(`warm-up failed: ${String(error)}`));
+    (0, discovery_1.writeDiscovery)(target, {
+        pid: process.pid,
+        port: server.port,
+        checkout: target,
+        build,
+        token,
+        startedAt: new Date().toISOString(),
+    });
+    console.error(`resident design process ${process.pid} serves on 127.0.0.1:${server.port}`);
+    return new Promise(() => undefined);
+});
+exports.serveResident = serveResident;
+//# sourceMappingURL=resident-process.js.map

package/src/lib/design/resident/resident-process.js.map

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

package/src/lib/design/resident/server.d.ts

@@ -0,0 +1,52 @@
+export declare const RESIDENT_IDLE_MS: number;
+export declare const RESIDENT_BEAT_MS = 10000;
+export declare const TOKEN_HEADER = "x-et-design-token";
+/** The environment variables of the calling CLI a request carries into the resident process. */
+export declare const FORWARDED_ENV: readonly ["ETHLETE_DESIGN_PHASES", "CLAUDE_CODE_SESSION_ID", "TMUX_PANE", "ETHLETE_AGENT_ROLE"];
+export type ResidentRequest = {
+    argv: string[];
+    invocation: string;
+    env: Partial<Record<(typeof FORWARDED_ENV)[number], string>>;
+};
+/**
+ * The run gets `signal`, which aborts when the client closes its connection before the answer ends, and `yieldTurn`,
+ * which runs the waiting requests `jumps` lets go first and settles when they are done.
+ */
+export type ResidentRun = (request: ResidentRequest & {
+    waitedMs?: number;
+    signal?: AbortSignal;
+    yieldTurn?: () => Promise<void>;
+}) => Promise<number>;
+export declare const ABORTED_EXIT = 130;
+/** One line of the newline-delimited JSON answer to a run request. */
+export type ResidentFrame = {
+    o: string;
+} | {
+    e: string;
+} | {
+    beat: true;
+} | {
+    exit: number;
+};
+type Write = (stream: 'o' | 'e', text: string) => void;
+/** Sends what the process writes to stdout and stderr to `write` until the returned function restores them. */
+export declare const captureOutput: (write: Write) => () => void;
+/**
+ * Serves run requests on 127.0.0.1, one at a time, streaming what each run writes back as `ResidentFrame` lines. A
+ * waiting request that `jumps` accepts runs inside a running one when that one calls its `yieldTurn`.
+ * Calls `onExit('idle')` after `idleMs` without a request and `onExit('stop')` on a stop request.
+ */
+export declare const startResidentServer: (options: {
+    token: string;
+    identity: Record<string, unknown>;
+    run: ResidentRun;
+    onExit: (reason: "idle" | "stop") => void;
+    idleMs?: number;
+    beatMs?: number;
+    capture?: typeof captureOutput;
+    jumps?: (request: ResidentRequest) => boolean;
+}) => Promise<{
+    port: number;
+    close: () => Promise<void>;
+}>;
+export {};

package/src/lib/design/resident/server.js

@@ -0,0 +1,212 @@
+"use strict";
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.startResidentServer = exports.captureOutput = exports.ABORTED_EXIT = exports.FORWARDED_ENV = exports.TOKEN_HEADER = exports.RESIDENT_BEAT_MS = exports.RESIDENT_IDLE_MS = void 0;
+const events_1 = require("events");
+const http_1 = require("http");
+const perf_hooks_1 = require("perf_hooks");
+const rxjs_1 = require("rxjs");
+exports.RESIDENT_IDLE_MS = 30 * 60000;
+exports.RESIDENT_BEAT_MS = 10000;
+exports.TOKEN_HEADER = 'x-et-design-token';
+/** The environment variables of the calling CLI a request carries into the resident process. */
+exports.FORWARDED_ENV = [
+    'ETHLETE_DESIGN_PHASES',
+    'CLAUDE_CODE_SESSION_ID',
+    'TMUX_PANE',
+    'ETHLETE_AGENT_ROLE',
+];
+exports.ABORTED_EXIT = 130;
+/** Sends what the process writes to stdout and stderr to `write` until the returned function restores them. */
+const captureOutput = (write) => {
+    const out = process.stdout.write;
+    const err = process.stderr.write;
+    const into = (stream) => ((chunk, ...rest) => {
+        write(stream, typeof chunk === 'string' ? chunk : Buffer.from(chunk).toString());
+        const done = rest.find((arg) => typeof arg === 'function');
+        done === null || done === void 0 ? void 0 : done();
+        return true;
+    });
+    process.stdout.write = into('o');
+    process.stderr.write = into('e');
+    return () => {
+        process.stdout.write = out;
+        process.stderr.write = err;
+    };
+};
+exports.captureOutput = captureOutput;
+const withEnv = (env, run) => __awaiter(void 0, void 0, void 0, function* () {
+    const before = exports.FORWARDED_ENV.map((key) => [key, process.env[key]]);
+    const apply = (entries) => {
+        for (const [key, value] of entries) {
+            if (value === undefined)
+                delete process.env[key];
+            else
+                process.env[key] = value;
+        }
+    };
+    apply(exports.FORWARDED_ENV.map((key) => [key, env[key]]));
+    try {
+        return yield run();
+    }
+    finally {
+        apply(before);
+    }
+});
+const bodyOf = (request) => new Promise((done, fail) => {
+    let body = '';
+    request.setEncoding('utf8');
+    request.on('data', (chunk) => (body += chunk));
+    request.once('end', () => done(body));
+    request.once('error', fail);
+});
+const messageOf = (error) => { var _a; return (error instanceof Error ? ((_a = error.stack) !== null && _a !== void 0 ? _a : error.message) : String(error)); };
+/**
+ * Serves run requests on 127.0.0.1, one at a time, streaming what each run writes back as `ResidentFrame` lines. A
+ * waiting request that `jumps` accepts runs inside a running one when that one calls its `yieldTurn`.
+ * Calls `onExit('idle')` after `idleMs` without a request and `onExit('stop')` on a stop request.
+ */
+const startResidentServer = (options) => __awaiter(void 0, void 0, void 0, function* () {
+    var _a, _b;
+    const { token, identity, run, onExit, idleMs = exports.RESIDENT_IDLE_MS, beatMs = exports.RESIDENT_BEAT_MS } = options;
+    const capture = (_a = options.capture) !== null && _a !== void 0 ? _a : exports.captureOutput;
+    const jumps = (_b = options.jumps) !== null && _b !== void 0 ? _b : (() => false);
+    const waiting = [];
+    let running = false;
+    let pending = 0;
+    let idle;
+    const arm = () => {
+        idle === null || idle === void 0 ? void 0 : idle.unsubscribe();
+        idle = (0, rxjs_1.timer)(idleMs)
+            .pipe((0, rxjs_1.tap)(() => onExit('idle')))
+            .subscribe();
+    };
+    const pump = () => __awaiter(void 0, void 0, void 0, function* () {
+        if (running)
+            return;
+        running = true;
+        try {
+            for (let turn = waiting.shift(); turn; turn = waiting.shift())
+                yield turn.go();
+        }
+        finally {
+            running = false;
+        }
+    });
+    const yieldTurn = () => __awaiter(void 0, void 0, void 0, function* () {
+        const jumping = waiting.filter((turn) => jumps(turn.request));
+        for (const turn of jumping) {
+            const at = waiting.indexOf(turn);
+            if (at === -1)
+                continue;
+            waiting.splice(at, 1);
+            yield turn.go();
+        }
+    });
+    const runRequest = (request, response) => __awaiter(void 0, void 0, void 0, function* () {
+        const asked = JSON.parse(yield bodyOf(request));
+        const send = (frame) => {
+            if (!response.writableEnded && !response.destroyed)
+                response.write(`${JSON.stringify(frame)}\n`);
+        };
+        const gone = new AbortController();
+        (0, events_1.setMaxListeners)(0, gone.signal);
+        response.once('close', () => {
+            if (!response.writableEnded)
+                gone.abort();
+        });
+        response.writeHead(200, { 'content-type': 'application/x-ndjson' });
+        if (pending > 1)
+            send({ e: 'waiting for an earlier request to the resident design process\n' });
+        const asking = perf_hooks_1.performance.now();
+        const beat = (0, rxjs_1.interval)(beatMs)
+            .pipe((0, rxjs_1.tap)(() => send({ beat: true })))
+            .subscribe();
+        const runTurn = () => __awaiter(void 0, void 0, void 0, function* () {
+            if (gone.signal.aborted)
+                return exports.ABORTED_EXIT;
+            try {
+                return yield withEnv(asked.env, () => __awaiter(void 0, void 0, void 0, function* () {
+                    const restore = capture((stream, text) => send(stream === 'o' ? { o: text } : { e: text }));
+                    try {
+                        return yield run(Object.assign(Object.assign({}, asked), { waitedMs: perf_hooks_1.performance.now() - asking, signal: gone.signal, yieldTurn }));
+                    }
+                    finally {
+                        restore();
+                    }
+                }));
+            }
+            catch (error) {
+                send({ e: `${messageOf(error)}\n` });
+                return 1;
+            }
+        });
+        const turn = new Promise((done) => {
+            waiting.push({ request: asked, go: () => __awaiter(void 0, void 0, void 0, function* () { return done(yield runTurn()); }) });
+            void pump();
+        });
+        try {
+            send({ exit: yield turn });
+        }
+        finally {
+            beat.unsubscribe();
+            response.end();
+        }
+    });
+    const server = (0, http_1.createServer)((request, response) => {
+        if (request.headers[exports.TOKEN_HEADER] !== token) {
+            response.writeHead(403).end();
+            return;
+        }
+        if (request.method === 'GET' && request.url === '/ping') {
+            response.writeHead(200, { 'content-type': 'application/json' }).end(JSON.stringify(Object.assign(Object.assign({}, identity), { pending })));
+            return;
+        }
+        if (request.method === 'POST' && request.url === '/stop') {
+            response.writeHead(200).end();
+            setImmediate(() => onExit('stop'));
+            return;
+        }
+        if (request.method === 'POST' && request.url === '/run') {
+            idle === null || idle === void 0 ? void 0 : idle.unsubscribe();
+            pending++;
+            void runRequest(request, response)
+                .catch((error) => {
+                if (!response.headersSent)
+                    response.writeHead(400);
+                response.end(messageOf(error));
+            })
+                .finally(() => {
+                pending--;
+                if (pending === 0)
+                    arm();
+            });
+            return;
+        }
+        response.writeHead(404).end();
+    });
+    yield new Promise((done, fail) => {
+        server.once('error', fail);
+        server.listen(0, '127.0.0.1', () => done());
+    });
+    arm();
+    return {
+        port: server.address().port,
+        close: () => __awaiter(void 0, void 0, void 0, function* () {
+            idle === null || idle === void 0 ? void 0 : idle.unsubscribe();
+            const closed = new Promise((done) => server.close(done));
+            server.closeAllConnections();
+            yield closed;
+        }),
+    };
+});
+exports.startResidentServer = startResidentServer;
+//# sourceMappingURL=server.js.map

package/src/lib/design/resident/server.js.map

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

package/src/lib/design/run-abort.d.ts

@@ -0,0 +1,9 @@
+export declare class RunAbortedError extends Error {
+    constructor();
+}
+/** Runs `run` as the design run `signal` aborts; draws asked during it stop when it does. Runs never overlap. */
+export declare const withRunSignal: <T>(signal: AbortSignal | undefined, run: () => Promise<T>) => Promise<T>;
+/** The abort signal of the design run in progress, or `null`. */
+export declare const runSignal: () => AbortSignal | null;
+/** Settles like `work`, or rejects with a `RunAbortedError` as soon as `signal` aborts. */
+export declare const unlessAborted: <T>(signal: AbortSignal | null, work: Promise<T>) => Promise<T>;

package/src/lib/design/run-abort.js

@@ -0,0 +1,45 @@
+"use strict";
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.unlessAborted = exports.runSignal = exports.withRunSignal = exports.RunAbortedError = void 0;
+const rxjs_1 = require("rxjs");
+class RunAbortedError extends Error {
+    constructor() {
+        super('design-explore: the run was aborted, its client closed the connection');
+    }
+}
+exports.RunAbortedError = RunAbortedError;
+let current = null;
+/** Runs `run` as the design run `signal` aborts; draws asked during it stop when it does. Runs never overlap. */
+const withRunSignal = (signal, run) => __awaiter(void 0, void 0, void 0, function* () {
+    const outer = current;
+    current = signal !== null && signal !== void 0 ? signal : null;
+    try {
+        return yield run();
+    }
+    finally {
+        current = outer;
+    }
+});
+exports.withRunSignal = withRunSignal;
+/** The abort signal of the design run in progress, or `null`. */
+const runSignal = () => current;
+exports.runSignal = runSignal;
+/** Settles like `work`, or rejects with a `RunAbortedError` as soon as `signal` aborts. */
+const unlessAborted = (signal, work) => {
+    if (!signal)
+        return work;
+    if (signal.aborted)
+        return Promise.reject(new RunAbortedError());
+    return (0, rxjs_1.firstValueFrom)((0, rxjs_1.race)((0, rxjs_1.from)(work), (0, rxjs_1.fromEvent)(signal, 'abort').pipe((0, rxjs_1.switchMap)(() => (0, rxjs_1.throwError)(() => new RunAbortedError())))));
+};
+exports.unlessAborted = unlessAborted;
+//# sourceMappingURL=run-abort.js.map

package/src/lib/design/run-abort.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-abort.js","sourceRoot":"","sources":["../../../../../libs/cli/src/lib/design/run-abort.ts"],"names":[],"mappings":";;;;;;;;;;;;AAAA,+BAAoF;AAEpF,MAAa,eAAgB,SAAQ,KAAK;IACxC;QACE,KAAK,CAAC,uEAAuE,CAAC,CAAC;IACjF,CAAC;CACF;AAJD,0CAIC;AAED,IAAI,OAAO,GAAuB,IAAI,CAAC;AAEvC,iHAAiH;AAC1G,MAAM,aAAa,GAAG,CAAU,MAA+B,EAAE,GAAqB,EAAE,EAAE;IAC/F,MAAM,KAAK,GAAG,OAAO,CAAC;IAEtB,OAAO,GAAG,MAAM,aAAN,MAAM,cAAN,MAAM,GAAI,IAAI,CAAC;IAEzB,IAAI,CAAC;QACH,OAAO,MAAM,GAAG,EAAE,CAAC;IACrB,CAAC;YAAS,CAAC;QACT,OAAO,GAAG,KAAK,CAAC;IAClB,CAAC;AACH,CAAC,CAAA,CAAC;AAVW,QAAA,aAAa,iBAUxB;AAEF,iEAAiE;AAC1D,MAAM,SAAS,GAAG,GAAG,EAAE,CAAC,OAAO,CAAC;AAA1B,QAAA,SAAS,aAAiB;AAEvC,2FAA2F;AACpF,MAAM,aAAa,GAAG,CAAI,MAA0B,EAAE,IAAgB,EAAE,EAAE;IAC/E,IAAI,CAAC,MAAM;QAAE,OAAO,IAAI,CAAC;IACzB,IAAI,MAAM,CAAC,OAAO;QAAE,OAAO,OAAO,CAAC,MAAM,CAAC,IAAI,eAAe,EAAE,CAAC,CAAC;IAEjE,OAAO,IAAA,qBAAc,EACnB,IAAA,WAAI,EAAC,IAAA,WAAI,EAAC,IAAI,CAAC,EAAE,IAAA,gBAAS,EAAC,MAAM,EAAE,OAAO,CAAC,CAAC,IAAI,CAAC,IAAA,gBAAS,EAAC,GAAG,EAAE,CAAC,IAAA,iBAAU,EAAC,GAAG,EAAE,CAAC,IAAI,eAAe,EAAE,CAAC,CAAC,CAAC,CAAC,CAC5G,CAAC;AACJ,CAAC,CAAC;AAPW,QAAA,aAAa,iBAOxB"}

package/src/lib/design/run-deadline.d.ts

@@ -0,0 +1,19 @@
+/** The hard deadline of each design command that drives a browser. */
+export declare const RUN_DEADLINES_MS: Readonly<Record<string, number>>;
+export declare const DEADLINE_EXIT_CODE = 124;
+/** Names what the run in progress does now; a run that passes its deadline writes it into its log. */
+export declare const noteStep: (text: string) => void;
+/** The deadline of `command` in ms, or null when it has none. `ETHLETE_DESIGN_DEADLINE_MS` overrides it. */
+export declare const deadlineMsOf: (command: string, env?: NodeJS.ProcessEnv) => number | null;
+/** Where deadline logs go: `$ETHLETE_DESIGN_STATE_DIR/deadline`, else `<tmpdir>/et-design/deadline`. */
+export declare const deadlineLogDirOf: (env?: NodeJS.ProcessEnv) => string;
+/**
+ * Runs `run` and ends the process with `DEADLINE_EXIT_CODE` when it is still running after `ms`, with a log of the
+ * last noted step, the phases it ended and its last output; the log's path goes to stderr. A null `ms` runs without one.
+ */
+export declare const withRunDeadline: (options: {
+    argv: string[];
+    ms: number | null;
+    logDir?: string;
+    exit?: (code: number) => void;
+}, run: () => Promise<number>) => Promise<number>;